Extracted from ../entities/resource.md.


  • v0.5 — Catalog entry consolidation (Batch C2 — gap fill):
    • §4 Flags — added “Flag Definition — catalog entry attributes” subsection with the formal data-model attribute table (id, name, description, scope, value_type, allowed_options, default_value, is_built_in, archived_at, audit fields) and a soft-delete / built-in-protection lifecycle note.
    • §4b Modifiers — added “Modifier Definition — catalog entry attributes” subsection with the formal attribute table (id, name, description, scope, math_operation, value_unit, default_value, is_built_in, archived_at, audit fields), a soft-delete / built-in-protection lifecycle note, and a stacking-semantics note for same-operation Modifiers.
    • §8 Validation — fixed duplicate numbering (was 1, 2, 3, 4, 5, 6, 7, 6, 7, 8); reorganised into three groups: Resource-level (1–10), Flag Definition catalog entry (11–16), Modifier Definition catalog entry (17–22).
    • Resource entity spec is now the single source of truth for Flag Definition and Modifier Definition; no separate entity specs exist (catalog entries are documented within the entity that consumes them).
    • Phase: Alpha. Status: 🟡 Working.
  • v0.4 — Fork mechanic (BR-049):
    • Added “How new Resources are created” subsection in §5 (Lifecycle states) to document the three pathways: manual creation, Subcontract Package Adjudication, and fork from Worksheet Resource.
    • BR-049 added to Business Rules references (§7) — fork action creates new Resource in Project-Specific Price Book with inherited Flags, Modifiers, Unit, Resource Type, and Categorization.
    • Phase: Alpha. Status: 🟡 Working.
  • v0.3 — Flag + Modifier catalog model (per Resource spec BR-review):
    • §4 Flags refactored — admin-managed Flag Catalog with scope per flag (Resource-Type-filtered). Flags are descriptive (boolean or enum), no math impact. Narrow curated list.
    • §4b Modifiers added — admin-managed Modifier Catalog with numeric values + math operations (quantity_multiplier, rate_adder, lump_sum_add, total_multiplier). Default values flow from Resource to Worksheet Resource; per-instance overrides allowed.
    • Math application order locked: quantity → rate → lump-sum-add → total-multiplier.
    • Worked math example added in §4b (Concrete with wastage + cartage + minimum charge).
    • BR-023 reframed (Flag catalog admin-defined, scope per entry); BR-026 moved from 🔴 to 🟡 (catalog seeding details); BR-027 + BR-028 added (Modifier catalog + inheritance).
    • BR-040 snapshot semantic extended to include Modifier default values.
    • §8 Validation: 3 new invariants (flag scope, modifier scope, modifier value required).
    • Phase: Alpha. Status: 🟡 Working.
  • v0.2 — clarified Plug Rate (Resource flag) distinct from Plugged (Item status, BR-019d). Added §4a cross-refs to Item entity spec and BR-019d. Updated BR references in §7. Phase: Alpha (core). Status: 🟡 Working.
  • v0.1 — initial draft (Batch B). Consolidates rules from business-rules.md §3.3 (Resources), glossary §6 (Resources in detail), domain-model Resource entry, and migration-benchmark.md §3.6 (resource_library mapping) + §3.9 (activity/cost code mapping). Adds validation invariants, snapshot semantics, four construction-industry worked examples. Flag taxonomy deferred to future lock (BR-026). Phase: Alpha (core). Status: 🟡 Working.