onto-mcp 0.3.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (300) hide show
  1. package/.onto/processes/reconstruct/actionable-ontology-seed-recomposition-design.md +447 -0
  2. package/.onto/processes/reconstruct/foundry-style-ontology-seed-contract.md +934 -0
  3. package/.onto/processes/reconstruct/reconstruct-boundary-contract.md +303 -725
  4. package/.onto/processes/reconstruct/reconstruct-contract-registry.yaml +1645 -0
  5. package/.onto/processes/reconstruct/reconstruct-execution-ux-contract.md +26 -22
  6. package/.onto/processes/reconstruct/source-profile-contract.md +49 -23
  7. package/.onto/processes/reconstruct/source-profiles/code.md +6 -3
  8. package/.onto/processes/reconstruct/source-profiles/database.md +5 -2
  9. package/.onto/processes/reconstruct/source-profiles/document.md +5 -2
  10. package/.onto/processes/reconstruct/source-profiles/spreadsheet.md +5 -4
  11. package/.onto/processes/review/review-execution-ux-contract.md +40 -0
  12. package/.onto/processes/shared/pipeline-execution-ledger-contract.md +26 -10
  13. package/.onto/processes/shared/target-material-kind-contract.md +29 -16
  14. package/AGENTS.md +6 -4
  15. package/README.md +135 -76
  16. package/dist/cli.js +8 -8
  17. package/dist/core-api/reconstruct-api.js +117 -31
  18. package/dist/core-api/review-api.js +47 -0
  19. package/dist/core-runtime/cli/codex-review-unit-executor.js +39 -2
  20. package/dist/core-runtime/cli/complete-review-session.js +2 -2
  21. package/dist/core-runtime/cli/mock-review-unit-executor.js +1 -1
  22. package/dist/core-runtime/cli/review-invoke.js +9 -9
  23. package/dist/core-runtime/cli/run-review-prompt-execution.js +39 -5
  24. package/dist/core-runtime/cli/spawn-watcher.js +266 -47
  25. package/dist/core-runtime/cli/start-review-session.js +3 -3
  26. package/dist/core-runtime/llm/llm-caller.js +11 -0
  27. package/dist/core-runtime/llm/llm-tool-loop.js +2 -0
  28. package/dist/core-runtime/observability/runtime-stream-observation.js +118 -0
  29. package/dist/core-runtime/onboard/cli-host.js +149 -0
  30. package/dist/core-runtime/onboard/host-target.js +22 -0
  31. package/dist/core-runtime/onboard/json-config-host.js +122 -0
  32. package/dist/core-runtime/onboard/path-scan.js +26 -0
  33. package/dist/core-runtime/onboard/prompt.js +51 -0
  34. package/dist/core-runtime/onboard/register.js +207 -0
  35. package/dist/core-runtime/onboard/types.js +27 -0
  36. package/dist/core-runtime/reconstruct/actionable-seed-validation.js +1777 -0
  37. package/dist/core-runtime/reconstruct/artifact-types.js +10 -4
  38. package/dist/core-runtime/reconstruct/contract-registry.js +623 -0
  39. package/dist/core-runtime/reconstruct/domain-id.js +10 -0
  40. package/dist/core-runtime/reconstruct/governing-snapshot.js +716 -0
  41. package/dist/core-runtime/reconstruct/material-profile-validation.js +191 -0
  42. package/dist/core-runtime/reconstruct/materialize-preparation.js +49 -11
  43. package/dist/core-runtime/reconstruct/pipeline-execution-ledger.js +269 -79
  44. package/dist/core-runtime/reconstruct/post-seed-validation.js +1194 -51
  45. package/dist/core-runtime/reconstruct/record.js +104 -20
  46. package/dist/core-runtime/reconstruct/run.js +2107 -413
  47. package/dist/core-runtime/reconstruct/seed-claim-projections.js +268 -0
  48. package/dist/core-runtime/reconstruct/source-profiles.js +93 -4
  49. package/dist/core-runtime/reconstruct/terminal-validation.js +807 -0
  50. package/dist/core-runtime/review/review-invocation-runner.js +4 -4
  51. package/dist/mcp/server.js +110 -38
  52. package/dist/mcp/tool-schemas.js +20 -6
  53. package/package.json +8 -17
  54. package/scripts/onto-review-watch.sh +486 -0
  55. package/scripts/onto-runtime-watch.sh +122 -0
  56. package/scripts/postinstall-hint.js +22 -0
  57. package/.onto/processes/reconstruct/top-level-concept-discovery-contract.md +0 -387
  58. package/dist/core-runtime/cli/bootstrap-review-binding.js +0 -186
  59. package/dist/core-runtime/cli/codex-nested-dispatch.test.js +0 -390
  60. package/dist/core-runtime/cli/codex-nested-teamlead-executor.test.js +0 -335
  61. package/dist/core-runtime/cli/coordinator-helpers.js +0 -583
  62. package/dist/core-runtime/cli/coordinator-state-machine-deliberation.test.js +0 -167
  63. package/dist/core-runtime/cli/coordinator-state-machine.js +0 -794
  64. package/dist/core-runtime/cli/e2e-codex-multi-agent-fixes.test.js +0 -615
  65. package/dist/core-runtime/cli/e2e-start-review-session.test.js +0 -312
  66. package/dist/core-runtime/cli/health.js +0 -44
  67. package/dist/core-runtime/cli/inline-http-review-unit-executor.test.js +0 -567
  68. package/dist/core-runtime/cli/materialize-review-execution-preparation.js +0 -104
  69. package/dist/core-runtime/cli/migrate-session-roots.js +0 -118
  70. package/dist/core-runtime/cli/repo-layout-migration-replace.smoke.test.js +0 -106
  71. package/dist/core-runtime/cli/review-invoke-auto-resolution.test.js +0 -268
  72. package/dist/core-runtime/cli/review-invoke-coordinator-topology.test.js +0 -136
  73. package/dist/core-runtime/cli/review-invoke-resolver-caching.test.js +0 -201
  74. package/dist/core-runtime/cli/review-invoke-topology-dispatch.test.js +0 -192
  75. package/dist/core-runtime/cli/session-root-guard.js +0 -168
  76. package/dist/core-runtime/cli/spawn-watcher.test.js +0 -457
  77. package/dist/core-runtime/cli/strip-wrapping-code-fence.test.js +0 -79
  78. package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.js +0 -412
  79. package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.test.js +0 -351
  80. package/dist/core-runtime/cli/topology-executor-mapping.js +0 -139
  81. package/dist/core-runtime/cli/topology-executor-mapping.test.js +0 -173
  82. package/dist/core-runtime/cli/write-review-interpretation.js +0 -81
  83. package/dist/core-runtime/config/onto-config-cli.js +0 -278
  84. package/dist/core-runtime/config/onto-config-key-path.js +0 -288
  85. package/dist/core-runtime/config/onto-config-key-path.test.js +0 -195
  86. package/dist/core-runtime/config/onto-config-preview.js +0 -108
  87. package/dist/core-runtime/config/onto-config-preview.test.js +0 -132
  88. package/dist/core-runtime/discovery/config-chain.js +0 -118
  89. package/dist/core-runtime/discovery/config-chain.test.js +0 -103
  90. package/dist/core-runtime/discovery/config-profile.js +0 -199
  91. package/dist/core-runtime/discovery/config-profile.test.js +0 -233
  92. package/dist/core-runtime/discovery/host-detection.test.js +0 -186
  93. package/dist/core-runtime/discovery/installation-paths.test.js +0 -65
  94. package/dist/core-runtime/discovery/lens-registry.test.js +0 -81
  95. package/dist/core-runtime/discovery/path-normalization.test.js +0 -22
  96. package/dist/core-runtime/discovery/plugin-path.js +0 -72
  97. package/dist/core-runtime/discovery/plugin-path.test.js +0 -95
  98. package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.js +0 -344
  99. package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.test.js +0 -915
  100. package/dist/core-runtime/evolve/adapters/code-product/compile/compile.js +0 -564
  101. package/dist/core-runtime/evolve/adapters/code-product/compile/compile.test.js +0 -708
  102. package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.js +0 -165
  103. package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.test.js +0 -227
  104. package/dist/core-runtime/evolve/adapters/code-product/validators/validate.js +0 -59
  105. package/dist/core-runtime/evolve/adapters/code-product/validators/validate.test.js +0 -205
  106. package/dist/core-runtime/evolve/adapters/methodology/adapter.js +0 -16
  107. package/dist/core-runtime/evolve/adapters/methodology/adapter.test.js +0 -9
  108. package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.js +0 -298
  109. package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.test.js +0 -70
  110. package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.js +0 -46
  111. package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.test.js +0 -73
  112. package/dist/core-runtime/evolve/adapters/registry.js +0 -47
  113. package/dist/core-runtime/evolve/adapters/registry.test.js +0 -67
  114. package/dist/core-runtime/evolve/cli.js +0 -256
  115. package/dist/core-runtime/evolve/commands/align.js +0 -194
  116. package/dist/core-runtime/evolve/commands/align.test.js +0 -82
  117. package/dist/core-runtime/evolve/commands/apply.js +0 -161
  118. package/dist/core-runtime/evolve/commands/apply.test.js +0 -138
  119. package/dist/core-runtime/evolve/commands/close.js +0 -39
  120. package/dist/core-runtime/evolve/commands/close.test.js +0 -99
  121. package/dist/core-runtime/evolve/commands/defer.js +0 -40
  122. package/dist/core-runtime/evolve/commands/defer.test.js +0 -134
  123. package/dist/core-runtime/evolve/commands/draft.js +0 -323
  124. package/dist/core-runtime/evolve/commands/draft.test.js +0 -178
  125. package/dist/core-runtime/evolve/commands/e2e-evolve-full-cycle.test.js +0 -208
  126. package/dist/core-runtime/evolve/commands/error-messages.js +0 -125
  127. package/dist/core-runtime/evolve/commands/error-messages.test.js +0 -167
  128. package/dist/core-runtime/evolve/commands/propose-align.js +0 -222
  129. package/dist/core-runtime/evolve/commands/propose-align.test.js +0 -136
  130. package/dist/core-runtime/evolve/commands/reconstruct.js +0 -330
  131. package/dist/core-runtime/evolve/commands/reconstruct.test.js +0 -278
  132. package/dist/core-runtime/evolve/commands/shared.js +0 -22
  133. package/dist/core-runtime/evolve/commands/stale-check.js +0 -103
  134. package/dist/core-runtime/evolve/commands/stale-check.test.js +0 -84
  135. package/dist/core-runtime/evolve/commands/start.js +0 -887
  136. package/dist/core-runtime/evolve/commands/start.test.js +0 -396
  137. package/dist/core-runtime/evolve/config/project-config.js +0 -99
  138. package/dist/core-runtime/evolve/config/project-config.test.js +0 -170
  139. package/dist/core-runtime/evolve/renderers/align-packet.js +0 -280
  140. package/dist/core-runtime/evolve/renderers/align-packet.test.js +0 -332
  141. package/dist/core-runtime/evolve/renderers/draft-packet.js +0 -303
  142. package/dist/core-runtime/evolve/renderers/draft-packet.test.js +0 -377
  143. package/dist/core-runtime/evolve/renderers/format.js +0 -5
  144. package/dist/core-runtime/evolve/renderers/scope-md.js +0 -237
  145. package/dist/core-runtime/evolve/renderers/scope-md.test.js +0 -306
  146. package/dist/core-runtime/govern/cli.js +0 -369
  147. package/dist/core-runtime/govern/cli.test.js +0 -314
  148. package/dist/core-runtime/govern/drift-engine.js +0 -103
  149. package/dist/core-runtime/govern/drift-engine.test.js +0 -319
  150. package/dist/core-runtime/govern/promote-principle.js +0 -206
  151. package/dist/core-runtime/govern/promote-principle.test.js +0 -368
  152. package/dist/core-runtime/govern/queue.js +0 -81
  153. package/dist/core-runtime/govern/types.js +0 -16
  154. package/dist/core-runtime/install/cli.js +0 -530
  155. package/dist/core-runtime/install/detect.js +0 -128
  156. package/dist/core-runtime/install/detect.test.js +0 -155
  157. package/dist/core-runtime/install/gitignore-update.js +0 -74
  158. package/dist/core-runtime/install/gitignore-update.test.js +0 -64
  159. package/dist/core-runtime/install/install-integration.test.js +0 -373
  160. package/dist/core-runtime/install/prompts.js +0 -389
  161. package/dist/core-runtime/install/prompts.test.js +0 -293
  162. package/dist/core-runtime/install/types.js +0 -26
  163. package/dist/core-runtime/install/validation.js +0 -295
  164. package/dist/core-runtime/install/validation.test.js +0 -313
  165. package/dist/core-runtime/install/writer.js +0 -254
  166. package/dist/core-runtime/install/writer.test.js +0 -218
  167. package/dist/core-runtime/learning/extractor.js +0 -461
  168. package/dist/core-runtime/learning/feedback.js +0 -179
  169. package/dist/core-runtime/learning/health-report.js +0 -165
  170. package/dist/core-runtime/learning/health-report.test.js +0 -169
  171. package/dist/core-runtime/learning/loader.js +0 -388
  172. package/dist/core-runtime/learning/loader.test.js +0 -102
  173. package/dist/core-runtime/learning/promote/apply-state.js +0 -240
  174. package/dist/core-runtime/learning/promote/audit-obligation.js +0 -195
  175. package/dist/core-runtime/learning/promote/collector.js +0 -432
  176. package/dist/core-runtime/learning/promote/degraded-state.js +0 -125
  177. package/dist/core-runtime/learning/promote/domain-doc-proposer.js +0 -166
  178. package/dist/core-runtime/learning/promote/e2e-promote.test.js +0 -6385
  179. package/dist/core-runtime/learning/promote/health-snapshot.js +0 -150
  180. package/dist/core-runtime/learning/promote/insight-reclassifier.js +0 -544
  181. package/dist/core-runtime/learning/promote/judgment-auditor.js +0 -517
  182. package/dist/core-runtime/learning/promote/panel-reviewer.js +0 -1158
  183. package/dist/core-runtime/learning/promote/promote-executor.js +0 -1675
  184. package/dist/core-runtime/learning/promote/promoter.js +0 -307
  185. package/dist/core-runtime/learning/promote/retirement.js +0 -122
  186. package/dist/core-runtime/learning/promote/types.js +0 -23
  187. package/dist/core-runtime/learning/prompt-sections.js +0 -51
  188. package/dist/core-runtime/learning/shared/artifact-registry-init.js +0 -45
  189. package/dist/core-runtime/learning/shared/artifact-registry.js +0 -254
  190. package/dist/core-runtime/learning/shared/audit-obligation-kernel.js +0 -73
  191. package/dist/core-runtime/learning/shared/audit-state.js +0 -99
  192. package/dist/core-runtime/learning/shared/duplicate-check.js +0 -28
  193. package/dist/core-runtime/learning/shared/llm-caller.js +0 -831
  194. package/dist/core-runtime/learning/shared/llm-caller.test.js +0 -601
  195. package/dist/core-runtime/learning/shared/llm-tool-loop.js +0 -393
  196. package/dist/core-runtime/learning/shared/mode.js +0 -25
  197. package/dist/core-runtime/learning/shared/paths.js +0 -84
  198. package/dist/core-runtime/learning/shared/paths.test.js +0 -79
  199. package/dist/core-runtime/learning/shared/patterns.js +0 -37
  200. package/dist/core-runtime/learning/shared/recoverability.js +0 -355
  201. package/dist/core-runtime/learning/shared/recovery-context.js +0 -374
  202. package/dist/core-runtime/learning/shared/scope.js +0 -1
  203. package/dist/core-runtime/learning/shared/semantic-classifier.js +0 -94
  204. package/dist/core-runtime/learning/shared/specs/apply-execution-state-spec.js +0 -42
  205. package/dist/core-runtime/learning/shared/specs/audit-state-spec.js +0 -37
  206. package/dist/core-runtime/learning/shared/specs/backup-metadata-spec.js +0 -39
  207. package/dist/core-runtime/learning/shared/specs/emergency-log-spec.js +0 -41
  208. package/dist/core-runtime/learning/shared/specs/layout-version-spec.js +0 -38
  209. package/dist/core-runtime/learning/shared/specs/promote-decisions-spec.js +0 -43
  210. package/dist/core-runtime/learning/shared/specs/promote-report-spec.js +0 -113
  211. package/dist/core-runtime/learning/shared/specs/prune-log-spec.js +0 -36
  212. package/dist/core-runtime/learning/shared/specs/recovery-resolution-spec.js +0 -48
  213. package/dist/core-runtime/learning/shared/specs/restore-manifest-spec.js +0 -43
  214. package/dist/core-runtime/learning/shared/specs/spec-helpers.js +0 -64
  215. package/dist/core-runtime/learning/usage-tracker.js +0 -190
  216. package/dist/core-runtime/learning/usage-tracker.test.js +0 -176
  217. package/dist/core-runtime/onboard/detect-review-axes.js +0 -122
  218. package/dist/core-runtime/onboard/detect-review-axes.test.js +0 -127
  219. package/dist/core-runtime/onboard/write-review-block.js +0 -188
  220. package/dist/core-runtime/onboard/write-review-block.test.js +0 -240
  221. package/dist/core-runtime/readers/brownfield-builder.js +0 -150
  222. package/dist/core-runtime/readers/brownfield-builder.test.js +0 -136
  223. package/dist/core-runtime/readers/code-chunk-collector.js +0 -53
  224. package/dist/core-runtime/readers/code-chunk-collector.test.js +0 -136
  225. package/dist/core-runtime/readers/file-utils.js +0 -240
  226. package/dist/core-runtime/readers/file-utils.test.js +0 -146
  227. package/dist/core-runtime/readers/lexicon-citation-check.js +0 -93
  228. package/dist/core-runtime/readers/lexicon-citation-check.test.js +0 -77
  229. package/dist/core-runtime/readers/mcp-figma.js +0 -30
  230. package/dist/core-runtime/readers/mcp-figma.test.js +0 -82
  231. package/dist/core-runtime/readers/mcp-generic.js +0 -31
  232. package/dist/core-runtime/readers/mcp-generic.test.js +0 -76
  233. package/dist/core-runtime/readers/ontology-index.js +0 -148
  234. package/dist/core-runtime/readers/ontology-index.test.js +0 -245
  235. package/dist/core-runtime/readers/ontology-query.js +0 -168
  236. package/dist/core-runtime/readers/ontology-query.test.js +0 -311
  237. package/dist/core-runtime/readers/ontology-resolve.js +0 -48
  238. package/dist/core-runtime/readers/ontology-resolve.test.js +0 -48
  239. package/dist/core-runtime/readers/patterns/index.js +0 -7
  240. package/dist/core-runtime/readers/review-log.js +0 -213
  241. package/dist/core-runtime/readers/review-log.test.js +0 -313
  242. package/dist/core-runtime/readers/scan-local.js +0 -102
  243. package/dist/core-runtime/readers/scan-local.test.js +0 -102
  244. package/dist/core-runtime/readers/scan-tarball.js +0 -121
  245. package/dist/core-runtime/readers/scan-tarball.test.js +0 -283
  246. package/dist/core-runtime/readers/scan-vault.js +0 -34
  247. package/dist/core-runtime/readers/scan-vault.test.js +0 -81
  248. package/dist/core-runtime/readers/types.js +0 -42
  249. package/dist/core-runtime/readers/types.test.js +0 -94
  250. package/dist/core-runtime/readers/viewpoint-collectors.js +0 -229
  251. package/dist/core-runtime/reconstruct/seed-candidate-validation.js +0 -385
  252. package/dist/core-runtime/review/citation-audit.test.js +0 -165
  253. package/dist/core-runtime/review/execution-plan-resolver.js +0 -247
  254. package/dist/core-runtime/review/execution-plan-resolver.test.js +0 -243
  255. package/dist/core-runtime/review/execution-topology-resolver-axis-first.test.js +0 -246
  256. package/dist/core-runtime/review/execution-topology-resolver.js +0 -401
  257. package/dist/core-runtime/review/execution-topology-resolver.test.js +0 -315
  258. package/dist/core-runtime/review/inline-context-embedder.test.js +0 -154
  259. package/dist/core-runtime/review/legacy-mode-policy.js +0 -88
  260. package/dist/core-runtime/review/materializers-effort-persist.test.js +0 -79
  261. package/dist/core-runtime/review/ontology-path-classifier.js +0 -179
  262. package/dist/core-runtime/review/ontology-path-classifier.test.js +0 -216
  263. package/dist/core-runtime/review/packet-boundary-policy.test.js +0 -107
  264. package/dist/core-runtime/review/participating-lens-paths.test.js +0 -73
  265. package/dist/core-runtime/review/review-config-legacy-translate.js +0 -244
  266. package/dist/core-runtime/review/review-config-legacy-translate.test.js +0 -161
  267. package/dist/core-runtime/review/review-config-validator.js +0 -289
  268. package/dist/core-runtime/review/review-config-validator.test.js +0 -236
  269. package/dist/core-runtime/review/shape-pipeline-audit.test.js +0 -311
  270. package/dist/core-runtime/review/shape-to-topology-id.js +0 -117
  271. package/dist/core-runtime/review/shape-to-topology-id.test.js +0 -132
  272. package/dist/core-runtime/review/topology-shape-derivation.js +0 -155
  273. package/dist/core-runtime/review/topology-shape-derivation.test.js +0 -195
  274. package/dist/core-runtime/scope-runtime/constants.js +0 -12
  275. package/dist/core-runtime/scope-runtime/constraint-pool.js +0 -166
  276. package/dist/core-runtime/scope-runtime/constraint-pool.test.js +0 -674
  277. package/dist/core-runtime/scope-runtime/domain-validation-log.js +0 -135
  278. package/dist/core-runtime/scope-runtime/domain-validation-log.test.js +0 -156
  279. package/dist/core-runtime/scope-runtime/eval-persistence.js +0 -65
  280. package/dist/core-runtime/scope-runtime/eval-persistence.test.js +0 -84
  281. package/dist/core-runtime/scope-runtime/event-pipeline.js +0 -64
  282. package/dist/core-runtime/scope-runtime/event-pipeline.test.js +0 -450
  283. package/dist/core-runtime/scope-runtime/event-store.js +0 -39
  284. package/dist/core-runtime/scope-runtime/event-store.test.js +0 -95
  285. package/dist/core-runtime/scope-runtime/gate-guard.js +0 -348
  286. package/dist/core-runtime/scope-runtime/gate-guard.test.js +0 -1047
  287. package/dist/core-runtime/scope-runtime/hash.js +0 -4
  288. package/dist/core-runtime/scope-runtime/hash.test.js +0 -33
  289. package/dist/core-runtime/scope-runtime/id.js +0 -4
  290. package/dist/core-runtime/scope-runtime/id.test.js +0 -17
  291. package/dist/core-runtime/scope-runtime/reducer.js +0 -297
  292. package/dist/core-runtime/scope-runtime/reducer.test.js +0 -759
  293. package/dist/core-runtime/scope-runtime/scope-manager.js +0 -161
  294. package/dist/core-runtime/scope-runtime/state-machine.js +0 -309
  295. package/dist/core-runtime/scope-runtime/state-machine.test.js +0 -704
  296. package/dist/core-runtime/scope-runtime/types.js +0 -116
  297. package/dist/core-runtime/scope-runtime/types.test.js +0 -69
  298. package/dist/core-runtime/translate/render-for-user.js +0 -169
  299. package/dist/core-runtime/translate/render-for-user.test.js +0 -122
  300. package/dist/providers/capability-contract.js +0 -1
@@ -3,6 +3,7 @@ import path from "node:path";
3
3
  import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
4
4
  const RECORD_ARTIFACT_KEYS = [
5
5
  "target_material_profile",
6
+ "target_material_profile_validation",
6
7
  "source_inventory",
7
8
  "initial_source_frontier",
8
9
  "source_observations",
@@ -12,10 +13,11 @@ const RECORD_ARTIFACT_KEYS = [
12
13
  "exploration_synthesis",
13
14
  "source_frontier",
14
15
  "source_frontier_validation",
15
- "domain_context_selection",
16
- "domain_context_selection_validation",
17
- "seed_candidate",
18
- "seed_candidate_validation",
16
+ "candidate_inventory",
17
+ "candidate_disposition",
18
+ "candidate_disposition_validation",
19
+ "ontology_seed",
20
+ "ontology_seed_validation",
19
21
  "claim_realization_map",
20
22
  "claim_realization_map_validation",
21
23
  "seed_confirmation",
@@ -30,11 +32,16 @@ const RECORD_ARTIFACT_KEYS = [
30
32
  "revision_proposal_validation",
31
33
  "reconstruct_metrics",
32
34
  "stop_decision",
35
+ "pre_handoff_run_manifest_validation",
36
+ "post_publication_run_manifest_validation",
37
+ "handoff_decision_validation",
33
38
  "final_output",
39
+ "final_output_provenance_validation",
34
40
  "reconstruct_run_manifest",
35
41
  ];
36
42
  const PREPARATION_REQUIRED_KEYS = [
37
43
  "target_material_profile",
44
+ "target_material_profile_validation",
38
45
  "source_inventory",
39
46
  "initial_source_frontier",
40
47
  "source_observations",
@@ -81,15 +88,27 @@ function deriveRecordStage(args) {
81
88
  if (args.finalOutputPresent &&
82
89
  args.stopDecisionPresent &&
83
90
  args.metricsPresent &&
84
- args.seedCandidateStatus === "valid" &&
91
+ args.targetMaterialProfileStatus === "valid" &&
92
+ args.candidateDispositionStatus === "valid" &&
93
+ args.ontologySeedStatus === "valid" &&
85
94
  args.claimRealizationStatus === "valid" &&
86
95
  args.seedConfirmationValidationStatus === "valid" &&
87
96
  args.competencyQuestionsValidationStatus === "valid" &&
88
97
  args.competencyQuestionAssessmentValidationStatus === "valid" &&
89
98
  args.failureClassificationValidationStatus === "valid" &&
90
- args.revisionProposalValidationStatus === "valid") {
99
+ args.revisionProposalValidationStatus === "valid" &&
100
+ args.preHandoffRunManifestValidationStatus === "valid" &&
101
+ args.postPublicationRunManifestValidationStatus === "valid" &&
102
+ args.handoffDecisionValidationStatus === "valid" &&
103
+ args.finalOutputProvenanceValidationStatus === "valid") {
91
104
  return "completed";
92
105
  }
106
+ if (args.handoffDecisionValidationStatus === "valid") {
107
+ return "handoff_decision_validated";
108
+ }
109
+ if (args.preHandoffRunManifestValidationStatus === "valid") {
110
+ return "pre_handoff_run_manifest_validated";
111
+ }
93
112
  if (args.stopDecisionPresent) {
94
113
  return "stop_decision_written";
95
114
  }
@@ -123,12 +142,18 @@ function deriveRecordStage(args) {
123
142
  if (args.claimRealizationStatus === "valid") {
124
143
  return "claim_realization_validated";
125
144
  }
126
- if (args.seedCandidateStatus === "valid") {
127
- return "seed_candidate_validated";
145
+ if (args.ontologySeedStatus === "valid") {
146
+ return "ontology_seed_validated";
147
+ }
148
+ if (args.candidateDispositionStatus === "valid") {
149
+ return "candidate_disposition_validated";
128
150
  }
129
151
  if (args.sourceObservationDirectiveStatus === "valid") {
130
152
  return "source_observation_directive_validated";
131
153
  }
154
+ if (args.targetMaterialProfileStatus === "valid") {
155
+ return "preparation_artifacts_written";
156
+ }
132
157
  return "preparation_artifacts_written";
133
158
  }
134
159
  function buildWarnings(args) {
@@ -139,8 +164,26 @@ function buildWarnings(args) {
139
164
  if (args.sourceObservationDirectiveStatus === "invalid") {
140
165
  warnings.push("source observation directive validation is invalid");
141
166
  }
142
- if (args.seedCandidateStatus === "invalid") {
143
- warnings.push("seed candidate validation is invalid");
167
+ if (args.targetMaterialProfileStatus === "invalid") {
168
+ warnings.push("target material profile validation is invalid");
169
+ }
170
+ if (args.candidateDispositionStatus === "invalid") {
171
+ warnings.push("candidate disposition validation is invalid");
172
+ }
173
+ if (args.ontologySeedStatus === "invalid") {
174
+ warnings.push("ontology seed validation is invalid");
175
+ }
176
+ if (args.preHandoffRunManifestValidationStatus === "invalid") {
177
+ warnings.push("pre-handoff run manifest validation is invalid");
178
+ }
179
+ if (args.postPublicationRunManifestValidationStatus === "invalid") {
180
+ warnings.push("post-publication run manifest validation is invalid");
181
+ }
182
+ if (args.handoffDecisionValidationStatus === "invalid") {
183
+ warnings.push("handoff readiness validation is invalid");
184
+ }
185
+ if (args.finalOutputProvenanceValidationStatus === "invalid") {
186
+ warnings.push("final output provenance validation is invalid");
144
187
  }
145
188
  return warnings;
146
189
  }
@@ -156,8 +199,10 @@ export async function assembleReconstructRecord(params) {
156
199
  : !isPresent)
157
200
  .map(([key]) => key);
158
201
  const targetMaterialProfile = await readYamlIfPresent(artifactRefs.target_material_profile);
202
+ const targetMaterialProfileValidation = await readYamlIfPresent(artifactRefs.target_material_profile_validation);
159
203
  const sourceObservationDirectiveValidation = await readYamlIfPresent(artifactRefs.source_observation_directive_validation);
160
- const seedCandidateValidation = await readYamlIfPresent(artifactRefs.seed_candidate_validation);
204
+ const candidateDispositionValidation = await readYamlIfPresent(artifactRefs.candidate_disposition_validation);
205
+ const ontologySeedValidation = await readYamlIfPresent(artifactRefs.ontology_seed_validation);
161
206
  const claimRealizationMapValidation = await readYamlIfPresent(artifactRefs.claim_realization_map_validation);
162
207
  const seedConfirmation = await readYamlIfPresent(artifactRefs.seed_confirmation);
163
208
  const seedConfirmationValidation = await readYamlIfPresent(artifactRefs.seed_confirmation_validation);
@@ -170,24 +215,40 @@ export async function assembleReconstructRecord(params) {
170
215
  const revisionProposal = await readYamlIfPresent(artifactRefs.revision_proposal);
171
216
  const revisionProposalValidation = await readYamlIfPresent(artifactRefs.revision_proposal_validation);
172
217
  const reconstructMetrics = await readYamlIfPresent(artifactRefs.reconstruct_metrics);
218
+ const preHandoffRunManifestValidation = await readYamlIfPresent(artifactRefs.pre_handoff_run_manifest_validation);
219
+ const postPublicationRunManifestValidation = await readYamlIfPresent(artifactRefs.post_publication_run_manifest_validation);
220
+ const handoffDecisionValidation = await readYamlIfPresent(artifactRefs.handoff_decision_validation);
221
+ const finalOutputProvenanceValidation = await readYamlIfPresent(artifactRefs.final_output_provenance_validation);
222
+ const targetMaterialProfileStatus = projectValidationStatus(targetMaterialProfileValidation);
173
223
  const sourceObservationDirectiveStatus = projectValidationStatus(sourceObservationDirectiveValidation);
174
- const seedCandidateStatus = projectValidationStatus(seedCandidateValidation);
224
+ const candidateDispositionStatus = projectValidationStatus(candidateDispositionValidation);
225
+ const ontologySeedStatus = projectValidationStatus(ontologySeedValidation);
175
226
  const claimRealizationStatus = projectValidationStatus(claimRealizationMapValidation);
176
227
  const seedConfirmationValidationStatus = projectValidationStatus(seedConfirmationValidation);
177
228
  const competencyQuestionsValidationStatus = projectValidationStatus(competencyQuestionsValidation);
178
229
  const competencyQuestionAssessmentValidationStatus = projectValidationStatus(competencyQuestionAssessmentValidation);
179
230
  const failureClassificationValidationStatus = projectValidationStatus(failureClassificationValidation);
180
231
  const revisionProposalValidationStatus = projectValidationStatus(revisionProposalValidation);
232
+ const preHandoffRunManifestValidationStatus = projectValidationStatus(preHandoffRunManifestValidation);
233
+ const postPublicationRunManifestValidationStatus = projectValidationStatus(postPublicationRunManifestValidation);
234
+ const handoffDecisionValidationStatus = projectValidationStatus(handoffDecisionValidation);
235
+ const finalOutputProvenanceValidationStatus = projectValidationStatus(finalOutputProvenanceValidation);
181
236
  const recordStage = deriveRecordStage({
182
237
  missingArtifacts,
238
+ targetMaterialProfileStatus,
183
239
  sourceObservationDirectiveStatus,
184
- seedCandidateStatus,
240
+ candidateDispositionStatus,
241
+ ontologySeedStatus,
185
242
  claimRealizationStatus,
186
243
  seedConfirmationValidationStatus,
187
244
  competencyQuestionsValidationStatus,
188
245
  competencyQuestionAssessmentValidationStatus,
189
246
  failureClassificationValidationStatus,
190
247
  revisionProposalValidationStatus,
248
+ preHandoffRunManifestValidationStatus,
249
+ postPublicationRunManifestValidationStatus,
250
+ handoffDecisionValidationStatus,
251
+ finalOutputProvenanceValidationStatus,
191
252
  seedConfirmationPresent: await exists(artifactRefs.seed_confirmation),
192
253
  competencyQuestionsPresent: await exists(artifactRefs.competency_questions),
193
254
  competencyQuestionAssessmentPresent: await exists(artifactRefs.competency_question_assessment),
@@ -209,11 +270,22 @@ export async function assembleReconstructRecord(params) {
209
270
  support_status: targetMaterialProfile?.support_status ?? null,
210
271
  artifact_refs: artifactRefs,
211
272
  validation_summary: {
273
+ target_material_profile_status: targetMaterialProfileStatus,
212
274
  source_observation_directive_status: sourceObservationDirectiveStatus,
213
- seed_candidate_status: seedCandidateStatus,
275
+ candidate_disposition_status: candidateDispositionStatus,
276
+ ontology_seed_status: ontologySeedStatus,
277
+ claim_realization_status: claimRealizationStatus,
214
278
  seed_confirmation_status: seedConfirmation?.confirmation_status ?? "not_available",
215
- semantic_claim_count: seedCandidateValidation?.semantic_claim_count ?? null,
216
- evidence_ref_count: seedCandidateValidation?.evidence_ref_count ?? null,
279
+ pre_handoff_run_manifest_status: preHandoffRunManifestValidationStatus,
280
+ post_publication_run_manifest_status: postPublicationRunManifestValidationStatus,
281
+ handoff_decision_status: handoffDecisionValidationStatus,
282
+ final_output_provenance_status: finalOutputProvenanceValidationStatus,
283
+ semantic_claim_count: reconstructMetrics?.semantic_claim_count ??
284
+ ontologySeedValidation?.seed_ref_count ??
285
+ null,
286
+ evidence_ref_count: reconstructMetrics?.evidence_ref_count ??
287
+ ontologySeedValidation?.evidence_ref_count ??
288
+ null,
217
289
  confirmed_claim_count: reconstructMetrics?.confirmed_claim_count ??
218
290
  seedConfirmationValidation?.accepted_claim_ids.length ??
219
291
  seedConfirmation?.confirmed_claim_ids.length ??
@@ -251,12 +323,14 @@ export async function assembleReconstructRecord(params) {
251
323
  semantic_generation: "not_performed",
252
324
  runtime_owned_gates: [
253
325
  "target_material_profiling",
326
+ "target_material_profile_validation",
254
327
  "source_inventory",
255
328
  "initial_source_frontier",
256
329
  "source_observation",
257
330
  "source_frontier_validation",
258
331
  "source_observation_directive_validation",
259
- "seed_candidate_validation",
332
+ "candidate_disposition_validation",
333
+ "ontology_seed_validation",
260
334
  "claim_realization_validation",
261
335
  "seed_confirmation_validation",
262
336
  "competency_questions_validation",
@@ -264,6 +338,9 @@ export async function assembleReconstructRecord(params) {
264
338
  "failure_classification_validation",
265
339
  "revision_proposal_validation",
266
340
  "final_output_provenance_validation",
341
+ "pre_handoff_run_manifest_validation",
342
+ "post_publication_run_manifest_validation",
343
+ "handoff_decision_validation",
267
344
  "reconstruct_metrics",
268
345
  "record_assembly",
269
346
  "run_manifest_assembly",
@@ -276,8 +353,9 @@ export async function assembleReconstructRecord(params) {
276
353
  "lens_judgment",
277
354
  "exploration_synthesis",
278
355
  "source_frontier",
279
- "domain_context_selection",
280
- "seed_candidate",
356
+ "candidate_inventory",
357
+ "candidate_disposition",
358
+ "ontology_seed",
281
359
  "claim_realization_map",
282
360
  "competency_questions",
283
361
  "competency_question_assessment",
@@ -289,8 +367,14 @@ export async function assembleReconstructRecord(params) {
289
367
  },
290
368
  warnings: buildWarnings({
291
369
  missingArtifacts,
370
+ targetMaterialProfileStatus,
292
371
  sourceObservationDirectiveStatus,
293
- seedCandidateStatus,
372
+ candidateDispositionStatus,
373
+ ontologySeedStatus,
374
+ preHandoffRunManifestValidationStatus,
375
+ postPublicationRunManifestValidationStatus,
376
+ handoffDecisionValidationStatus,
377
+ finalOutputProvenanceValidationStatus,
294
378
  }),
295
379
  };
296
380
  const outputPath = params.outputPath