| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
1 parent 2843c9d commit 7930af6
5 files changed
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -0,0 +1,309 @@ | |||
| 1 | + # COMPONENT_REALIZATION_MAP.md | ||
| 2 | + | ||
| 3 | + **Derived From** | ||
| 4 | + `01_GENESIS/PROJECT_SEED.md` | ||
| 5 | + `01_GENESIS/REQUIREMENTS_LEDGER.md` | ||
| 6 | + | ||
| 7 | + **Schema Version** | ||
| 8 | + v1 | ||
| 9 | + | ||
| 10 | + ## Realization Inventory | ||
| 11 | + | ||
| 12 | + ### REAL-1 - Intake Registry Workflow | ||
| 13 | + | ||
| 14 | + **Source Component ID** | ||
| 15 | + `COMP-1` | ||
| 16 | + | ||
| 17 | + **Source Requirement IDs** | ||
| 18 | + - `REQ-1` | ||
| 19 | + - `REQ-3` | ||
| 20 | + | ||
| 21 | + **Primary Artifact Paths** | ||
| 22 | + - `02_EXODUS/runtime/intake/register_sources.ps1` | ||
| 23 | + - `02_EXODUS/runtime/intake/source_registration.schema.json` | ||
| 24 | + | ||
| 25 | + **Supporting Artifact Paths** | ||
| 26 | + - `02_EXODUS/runtime/intake/supported_types.json` | ||
| 27 | + | ||
| 28 | + **Dependency Components** | ||
| 29 | + - `None` | ||
| 30 | + | ||
| 31 | + **Boundary Rules** | ||
| 32 | + - Intake ownership is limited to source discovery, supported-type classification, and source registration; it must not absorb canonicalization behavior. | ||
| 33 | + - Rejected-input handling remains owned by intake artifacts and must not be silently folded into downstream canonicalization outputs. | ||
| 34 | + | ||
| 35 | + **Validation Artifact Paths** | ||
| 36 | + - `02_EXODUS/tests/intake_smoke.ps1` | ||
| 37 | + | ||
| 38 | + **Realization Objective** | ||
| 39 | + Materialize the intake workflow as a repository-owned registration boundary that scans a controlled folder, records supported and rejected inputs, and emits deterministic source-registration records without crossing into canonical text generation responsibilities. | ||
| 40 | + | ||
| 41 | + ### REAL-2 - Canonicalization Module | ||
| 42 | + | ||
| 43 | + **Source Component ID** | ||
| 44 | + `COMP-2` | ||
| 45 | + | ||
| 46 | + **Source Requirement IDs** | ||
| 47 | + - `REQ-2` | ||
| 48 | + - `REQ-12` | ||
| 49 | + | ||
| 50 | + **Primary Artifact Paths** | ||
| 51 | + - `02_EXODUS/runtime/canonicalize/canonicalize_sources.ps1` | ||
| 52 | + - `02_EXODUS/runtime/canonicalize/canonical_meta.schema.json` | ||
| 53 | + | ||
| 54 | + **Supporting Artifact Paths** | ||
| 55 | + - `02_EXODUS/runtime/canonicalize/addressing_rules.json` | ||
| 56 | + | ||
| 57 | + **Dependency Components** | ||
| 58 | + - `COMP-1` | ||
| 59 | + | ||
| 60 | + **Boundary Rules** | ||
| 61 | + - Canonicalization owns canonical text and metadata emission beneath the project artifact root and must not absorb extraction logic. | ||
| 62 | + - Canonicalization must preserve canonical path and fan-out rules without repurposing `04_DEUTERONOMY/canonical_schemas/trace_identity.schema.json`. | ||
| 63 | + | ||
| 64 | + **Validation Artifact Paths** | ||
| 65 | + - `02_EXODUS/tests/canonicalization_smoke.ps1` | ||
| 66 | + | ||
| 67 | + **Realization Objective** | ||
| 68 | + Materialize canonicalization as a distinct runtime boundary that converts accepted inputs into canonical text and provenance-bearing metadata under the project-scoped artifact tree while preserving immutable evidence identity and address-rule enforcement. | ||
| 69 | + | ||
| 70 | + ### REAL-3 - Extraction Module | ||
| 71 | + | ||
| 72 | + **Source Component ID** | ||
| 73 | + `COMP-3` | ||
| 74 | + | ||
| 75 | + **Source Requirement IDs** | ||
| 76 | + - `REQ-4` | ||
| 77 | + | ||
| 78 | + **Primary Artifact Paths** | ||
| 79 | + - `02_EXODUS/runtime/extract/extract_statements.ps1` | ||
| 80 | + - `02_EXODUS/runtime/extract/extraction_record.schema.json` | ||
| 81 | + | ||
| 82 | + **Supporting Artifact Paths** | ||
| 83 | + - `02_EXODUS/runtime/extract/extraction_types.json` | ||
| 84 | + | ||
| 85 | + **Dependency Components** | ||
| 86 | + - `COMP-2` | ||
| 87 | + | ||
| 88 | + **Boundary Rules** | ||
| 89 | + - Extraction owns typed statement derivation only and must not absorb trace-identity or discrepancy classification logic. | ||
| 90 | + - Extraction outputs must remain separately attributable from canonical artifacts and downstream trace artifacts. | ||
| 91 | + | ||
| 92 | + **Validation Artifact Paths** | ||
| 93 | + - `02_EXODUS/tests/extraction_smoke.ps1` | ||
| 94 | + | ||
| 95 | + **Realization Objective** | ||
| 96 | + Materialize extraction as a separate runtime layer that reads canonical artifacts and emits machine-readable claim, date, entity, and commitment records with preserved parent linkage for later trace construction. | ||
| 97 | + | ||
| 98 | + ### REAL-4 - Trace Linking Module | ||
| 99 | + | ||
| 100 | + **Source Component ID** | ||
| 101 | + `COMP-4` | ||
| 102 | + | ||
| 103 | + **Source Requirement IDs** | ||
| 104 | + - `REQ-5` | ||
| 105 | + - `REQ-11` | ||
| 106 | + | ||
| 107 | + **Primary Artifact Paths** | ||
| 108 | + - `02_EXODUS/runtime/trace/build_trace_links.ps1` | ||
| 109 | + - `02_EXODUS/runtime/trace/trace_record.schema.json` | ||
| 110 | + | ||
| 111 | + **Supporting Artifact Paths** | ||
| 112 | + - `02_EXODUS/runtime/trace/proposal_state_rules.json` | ||
| 113 | + | ||
| 114 | + **Dependency Components** | ||
| 115 | + - `COMP-3` | ||
| 116 | + | ||
| 117 | + **Boundary Rules** | ||
| 118 | + - Trace linking owns trace identity and trace edge materialization and must not collapse into discrepancy detection. | ||
| 119 | + - Machine-proposed versus accepted trace state must remain explicit within trace-owned artifacts and must not be hidden inside review-surface-only state. | ||
| 120 | + | ||
| 121 | + **Validation Artifact Paths** | ||
| 122 | + - `02_EXODUS/tests/trace_smoke.ps1` | ||
| 123 | + | ||
| 124 | + **Realization Objective** | ||
| 125 | + Materialize trace linking as a component that constructs explicit trace identities and cross-artifact trace edges from extraction outputs while preserving merge visibility and proposal-state boundaries in repository-owned artifacts. | ||
| 126 | + | ||
| 127 | + ### REAL-5 - Discrepancy Detection Module | ||
| 128 | + | ||
| 129 | + **Source Component ID** | ||
| 130 | + `COMP-5` | ||
| 131 | + | ||
| 132 | + **Source Requirement IDs** | ||
| 133 | + - `REQ-6` | ||
| 134 | + - `REQ-11` | ||
| 135 | + | ||
| 136 | + **Primary Artifact Paths** | ||
| 137 | + - `02_EXODUS/runtime/discrepancy/detect_discrepancies.ps1` | ||
| 138 | + - `02_EXODUS/runtime/discrepancy/discrepancy_record.schema.json` | ||
| 139 | + | ||
| 140 | + **Supporting Artifact Paths** | ||
| 141 | + - `02_EXODUS/runtime/discrepancy/discrepancy_taxonomy.json` | ||
| 142 | + | ||
| 143 | + **Dependency Components** | ||
| 144 | + - `COMP-4` | ||
| 145 | + | ||
| 146 | + **Boundary Rules** | ||
| 147 | + - Discrepancy detection owns contradiction, omission, unsupported-summary, and drift record generation and must not absorb queue rebuilding or packet export ownership. | ||
| 148 | + - Discrepancy artifacts must preserve cited evidence references and unresolved state rather than silently resolving against source authority. | ||
| 149 | + | ||
| 150 | + **Validation Artifact Paths** | ||
| 151 | + - `02_EXODUS/tests/discrepancy_smoke.ps1` | ||
| 152 | + | ||
| 153 | + **Realization Objective** | ||
| 154 | + Materialize discrepancy detection as a dedicated runtime boundary that evaluates trace-linked statements, emits machine-readable discrepancy records, and preserves cited evidence and unresolved review status for downstream workflows. | ||
| 155 | + | ||
| 156 | + ### REAL-6 - Review Queue Workflow | ||
| 157 | + | ||
| 158 | + **Source Component ID** | ||
| 159 | + `COMP-6` | ||
| 160 | + | ||
| 161 | + **Source Requirement IDs** | ||
| 162 | + - `REQ-7` | ||
| 163 | + - `REQ-9` | ||
| 164 | + | ||
| 165 | + **Primary Artifact Paths** | ||
| 166 | + - `02_EXODUS/runtime/review/rebuild_review_queue.ps1` | ||
| 167 | + - `02_EXODUS/runtime/review/review_queue_index.schema.json` | ||
| 168 | + | ||
| 169 | + **Supporting Artifact Paths** | ||
| 170 | + - `02_EXODUS/runtime/state/project_state_index.schema.json` | ||
| 171 | + | ||
| 172 | + **Dependency Components** | ||
| 173 | + - `COMP-5` | ||
| 174 | + | ||
| 175 | + **Boundary Rules** | ||
| 176 | + - Review-queue rebuilding owns filesystem reconstruction of open review state and must not collapse into the review surface. | ||
| 177 | + - Queue and state reconstruction must remain valid without any cache database and must not depend on UI-layer persistence. | ||
| 178 | + | ||
| 179 | + **Validation Artifact Paths** | ||
| 180 | + - `02_EXODUS/tests/review_queue_smoke.ps1` | ||
| 181 | + | ||
| 182 | + **Realization Objective** | ||
| 183 | + Materialize the review-queue workflow as a repository-owned reconstruction boundary that derives open review state, queue ordering, and resumable project state directly from stored discrepancy and state artifacts. | ||
| 184 | + | ||
| 185 | + ### REAL-7 - Review Packet Export Module | ||
| 186 | + | ||
| 187 | + **Source Component ID** | ||
| 188 | + `COMP-7` | ||
| 189 | + | ||
| 190 | + **Source Requirement IDs** | ||
| 191 | + - `REQ-8` | ||
| 192 | + | ||
| 193 | + **Primary Artifact Paths** | ||
| 194 | + - `02_EXODUS/runtime/export/export_review_packet.ps1` | ||
| 195 | + - `02_EXODUS/runtime/export/packet_manifest.schema.json` | ||
| 196 | + | ||
| 197 | + **Supporting Artifact Paths** | ||
| 198 | + - `02_EXODUS/runtime/export/packet_layout_rules.json` | ||
| 199 | + | ||
| 200 | + **Dependency Components** | ||
| 201 | + - `COMP-5` | ||
| 202 | + | ||
| 203 | + **Boundary Rules** | ||
| 204 | + - Packet export owns packet bundle assembly and must remain separate from queue rebuilding and review-surface launch. | ||
| 205 | + - Packet export must preserve packet-level structure obligations instead of delegating manifest and evidence-count enforcement to the UI. | ||
| 206 | + | ||
| 207 | + **Validation Artifact Paths** | ||
| 208 | + - `02_EXODUS/tests/packet_export_smoke.ps1` | ||
| 209 | + | ||
| 210 | + **Realization Objective** | ||
| 211 | + Materialize packet export as a component that assembles discrepancy-centered review bundles with deterministic packet manifests, cited evidence excerpts, and machine-readable discrepancy payloads for external human review. | ||
| 212 | + | ||
| 213 | + ### REAL-8 - Local Review Surface | ||
| 214 | + | ||
| 215 | + **Source Component ID** | ||
| 216 | + `COMP-8` | ||
| 217 | + | ||
| 218 | + **Source Requirement IDs** | ||
| 219 | + - `REQ-10` | ||
| 220 | + - `REQ-11` | ||
| 221 | + | ||
| 222 | + **Primary Artifact Paths** | ||
| 223 | + - `02_EXODUS/runtime/review/start_review_surface.ps1` | ||
| 224 | + - `02_EXODUS/runtime/review/review_surface_contract.json` | ||
| 225 | + | ||
| 226 | + **Supporting Artifact Paths** | ||
| 227 | + - `02_EXODUS/runtime/review/review_surface_state.schema.json` | ||
| 228 | + | ||
| 229 | + **Dependency Components** | ||
| 230 | + - `COMP-6` | ||
| 231 | + - `COMP-7` | ||
| 232 | + | ||
| 233 | + **Boundary Rules** | ||
| 234 | + - The local review surface must remain a distinct user-facing surface and must not be collapsed into queue-rebuild or packet-export artifact ownership. | ||
| 235 | + - Review-surface realization must preserve explicit separation between machine-proposed and human-accepted states in user-visible artifacts. | ||
| 236 | + | ||
| 237 | + **Validation Artifact Paths** | ||
| 238 | + - `02_EXODUS/tests/review_surface_smoke.ps1` | ||
| 239 | + | ||
| 240 | + **Realization Objective** | ||
| 241 | + Materialize the local review surface as a user-facing artifact boundary that launches a minimal local review workflow over discrepancy records and evidence packets while preserving proposal-state disclosure and non-chat-first behavior. | ||
| 242 | + | ||
| 243 | + ### REAL-9 - Run Manifest And Project State Module | ||
| 244 | + | ||
| 245 | + **Source Component ID** | ||
| 246 | + `COMP-9` | ||
| 247 | + | ||
| 248 | + **Source Requirement IDs** | ||
| 249 | + - `REQ-9` | ||
| 250 | + - `REQ-12` | ||
| 251 | + | ||
| 252 | + **Primary Artifact Paths** | ||
| 253 | + - `02_EXODUS/runtime/state/write_run_manifest.ps1` | ||
| 254 | + - `02_EXODUS/runtime/state/run_manifest.schema.json` | ||
| 255 | + | ||
| 256 | + **Supporting Artifact Paths** | ||
| 257 | + - `02_EXODUS/runtime/state/project_scope_rules.json` | ||
| 258 | + | ||
| 259 | + **Dependency Components** | ||
| 260 | + - `COMP-1` | ||
| 261 | + | ||
| 262 | + **Boundary Rules** | ||
| 263 | + - Run-manifest ownership remains separate from queue rebuilding even though both support deterministic re-entry. | ||
| 264 | + - Project state artifacts must preserve project-slug isolation and canonical path rules and must not be folded into generic runtime logs. | ||
| 265 | + | ||
| 266 | + **Validation Artifact Paths** | ||
| 267 | + - `02_EXODUS/tests/run_manifest_smoke.ps1` | ||
| 268 | + | ||
| 269 | + **Realization Objective** | ||
| 270 | + Materialize run-manifest and project-state ownership as a distinct data boundary that writes time-sortable run manifests and project-scoped state artifacts needed for deterministic continuation and project isolation. | ||
| 271 | + | ||
| 272 | + ### REAL-10 - Validation Harness | ||
| 273 | + | ||
| 274 | + **Source Component ID** | ||
| 275 | + `COMP-10` | ||
| 276 | + | ||
| 277 | + **Source Requirement IDs** | ||
| 278 | + - `REQ-13` | ||
| 279 | + - `REQ-7` | ||
| 280 | + - `REQ-8` | ||
| 281 | + - `REQ-10` | ||
| 282 | + - `REQ-12` | ||
| 283 | + | ||
| 284 | + **Primary Artifact Paths** | ||
| 285 | + - `02_EXODUS/tests/validation_harness.ps1` | ||
| 286 | + - `02_EXODUS/tests/sample_project_fixture.json` | ||
| 287 | + | ||
| 288 | + **Supporting Artifact Paths** | ||
| 289 | + - `02_EXODUS/tests/stage_anchor_contract.json` | ||
| 290 | + | ||
| 291 | + **Dependency Components** | ||
| 292 | + - `COMP-2` | ||
| 293 | + - `COMP-3` | ||
| 294 | + - `COMP-4` | ||
| 295 | + - `COMP-5` | ||
| 296 | + - `COMP-6` | ||
| 297 | + - `COMP-7` | ||
| 298 | + - `COMP-8` | ||
| 299 | + - `COMP-9` | ||
| 300 | + | ||
| 301 | + **Boundary Rules** | ||
| 302 | + - The validation harness may exercise all realized components but must not replace their primary runtime ownership. | ||
| 303 | + - End-to-end validation ownership remains distinct from implementation-layer component ownership even when it reuses their scripts and outputs. | ||
| 304 | + | ||
| 305 | + **Validation Artifact Paths** | ||
| 306 | + - `02_EXODUS/tests/validation_harness.ps1` | ||
| 307 | + | ||
| 308 | + **Realization Objective** | ||
| 309 | + Materialize the validation harness as an end-to-end executable boundary that drives bounded sample validation across the realized runtime components and emits deterministic stage anchors and overall pass output without collapsing implementation ownership. | ||
| Back | FazBrowse Home | New Git URL |
0 commit comments