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
@@ -1,390 +0,0 @@
1
- import fs from "node:fs/promises";
2
- import os from "node:os";
3
- import path from "node:path";
4
- import { afterEach, describe, expect, it } from "vitest";
5
- import { writeYamlDocument } from "../review/review-artifact-utils.js";
6
- import { executeReviewViaCodexNested, } from "./codex-nested-dispatch.js";
7
- async function mkSession(plan) {
8
- const root = await fs.mkdtemp(path.join(os.tmpdir(), "onto-pr-h-"));
9
- const sessionRoot = path.join(root, "session");
10
- await fs.mkdir(sessionRoot, { recursive: true });
11
- await writeYamlDocument(path.join(sessionRoot, "execution-plan.yaml"), plan);
12
- return {
13
- sessionRoot,
14
- cleanup: async () => {
15
- await fs.rm(root, { recursive: true, force: true });
16
- },
17
- };
18
- }
19
- function buildPlan(lenses, sessionRoot) {
20
- return {
21
- session_id: "pr-h-test",
22
- session_root: sessionRoot,
23
- execution_realization: "subagent",
24
- host_runtime: "codex",
25
- review_mode: "core-axis",
26
- interpretation_artifact_path: path.join(sessionRoot, "interpretation.yaml"),
27
- binding_output_path: path.join(sessionRoot, "binding.yaml"),
28
- session_metadata_path: path.join(sessionRoot, "session-metadata.yaml"),
29
- execution_preparation_root: path.join(sessionRoot, "prep"),
30
- round1_root: path.join(sessionRoot, "round1"),
31
- lens_execution_seats: lenses.map((l) => ({
32
- lens_id: l.lens_id,
33
- output_path: l.output_path,
34
- })),
35
- prompt_packets_root: path.join(sessionRoot, "prompt-packets"),
36
- lens_prompt_packet_seats: lenses,
37
- synthesize_prompt_packet_path: path.join(sessionRoot, "synthesize-packet.md"),
38
- synthesis_output_path: path.join(sessionRoot, "synthesis.md"),
39
- deliberation_output_path: path.join(sessionRoot, "deliberation.md"),
40
- execution_result_path: path.join(sessionRoot, "execution-result.yaml"),
41
- error_log_path: path.join(sessionRoot, "error-log.md"),
42
- final_output_path: path.join(sessionRoot, "final.md"),
43
- review_record_path: path.join(sessionRoot, "review-record.yaml"),
44
- boundary_policy: {
45
- web_research_policy: "allowed",
46
- repo_exploration_policy: "allowed",
47
- recursive_reference_expansion_policy: "allowed",
48
- filesystem_scope: { allowed_roots: [], source_mutation_policy: "denied" },
49
- },
50
- boundary_presentation: {
51
- web_research: { requested_policy: "allowed" },
52
- repo_exploration: { requested_policy: "allowed" },
53
- recursive_reference_expansion: { requested_policy: "allowed" },
54
- source_mutation: { requested_policy: "denied" },
55
- filesystem_scope: { requested_allowed_roots: [] },
56
- },
57
- boundary_enforcement_profile: {
58
- web_research: "prompt_declared_only",
59
- repo_exploration: "prompt_declared_only",
60
- recursive_reference_expansion: "prompt_declared_only",
61
- source_mutation: "prompt_declared_only",
62
- filesystem_scope: "prompt_declared_only",
63
- },
64
- effective_boundary_state: {
65
- web_research: {
66
- requested_policy: "allowed",
67
- effective_policy: "allowed",
68
- guarantee_level: "prompt_declared_only",
69
- },
70
- repo_exploration: {
71
- requested_policy: "allowed",
72
- effective_policy: "allowed",
73
- guarantee_level: "prompt_declared_only",
74
- },
75
- recursive_reference_expansion: {
76
- requested_policy: "allowed",
77
- effective_policy: "allowed",
78
- guarantee_level: "prompt_declared_only",
79
- },
80
- source_mutation: {
81
- requested_policy: "denied",
82
- effective_policy: "denied",
83
- guarantee_level: "prompt_declared_only",
84
- },
85
- filesystem_scope: {
86
- requested_allowed_roots: [],
87
- effective_allowed_roots: [],
88
- guarantee_level: "prompt_declared_only",
89
- },
90
- },
91
- };
92
- }
93
- function buildOrchestrator(outcomes, opts = {}) {
94
- const calls = [];
95
- const impl = async (input) => {
96
- calls.push(input);
97
- return {
98
- outcomes,
99
- outer_stdout: opts.outer_stdout ?? "",
100
- outer_stderr: opts.outer_stderr ?? "",
101
- outer_exit_code: opts.outer_exit_code ?? 0,
102
- summary_parsed: opts.summary_parsed ?? true,
103
- };
104
- };
105
- return { impl, calls };
106
- }
107
- function staticInspector(present, sizes = {}) {
108
- return async (p) => ({
109
- exists: present.has(p),
110
- size: sizes[p] ?? (present.has(p) ? 1 : 0),
111
- });
112
- }
113
- // ---------------------------------------------------------------------------
114
- // Forwarding: execution-plan lenses → orchestrator input
115
- // ---------------------------------------------------------------------------
116
- describe("executeReviewViaCodexNested — forwarding", () => {
117
- let fixture;
118
- afterEach(async () => {
119
- if (fixture)
120
- await fixture.cleanup();
121
- });
122
- it("forwards lens packet triples in execution-plan order", async () => {
123
- const plan = buildPlan([
124
- { lens_id: "logic", packet_path: "/pkts/logic.md", output_path: "/out/logic.md" },
125
- { lens_id: "pragmatics", packet_path: "/pkts/pr.md", output_path: "/out/pr.md" },
126
- { lens_id: "axiology", packet_path: "/pkts/ax.md", output_path: "/out/ax.md" },
127
- ], "");
128
- fixture = await mkSession(plan);
129
- const { impl, calls } = buildOrchestrator([
130
- { lens_id: "logic", status: "ok" },
131
- { lens_id: "pragmatics", status: "ok" },
132
- { lens_id: "axiology", status: "ok" },
133
- ]);
134
- await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set(["/out/logic.md", "/out/pr.md", "/out/ax.md"])));
135
- expect(calls).toHaveLength(1);
136
- expect(calls[0].lenses.map((l) => l.lens_id)).toEqual([
137
- "logic",
138
- "pragmatics",
139
- "axiology",
140
- ]);
141
- expect(calls[0].lenses[0].packet_path).toBe("/pkts/logic.md");
142
- expect(calls[0].lenses[0].output_path).toBe("/out/logic.md");
143
- });
144
- it("passes model from ontoConfig.codex.model and reasoning_effort from codex.effort", async () => {
145
- const plan = buildPlan([{ lens_id: "l", packet_path: "/p", output_path: "/o" }], "");
146
- fixture = await mkSession(plan);
147
- const { impl, calls } = buildOrchestrator([{ lens_id: "l", status: "ok" }]);
148
- await executeReviewViaCodexNested({
149
- sessionRoot: fixture.sessionRoot,
150
- ontoConfig: { codex: { model: "gpt-5.4", effort: "high" } },
151
- }, impl, staticInspector(new Set(["/o"])));
152
- expect(calls[0].model).toBe("gpt-5.4");
153
- expect(calls[0].reasoning_effort).toBe("high");
154
- });
155
- it("falls back to top-level model / reasoning_effort when codex.* unset", async () => {
156
- const plan = buildPlan([{ lens_id: "l", packet_path: "/p", output_path: "/o" }], "");
157
- fixture = await mkSession(plan);
158
- const { impl, calls } = buildOrchestrator([{ lens_id: "l", status: "ok" }]);
159
- await executeReviewViaCodexNested({
160
- sessionRoot: fixture.sessionRoot,
161
- ontoConfig: { model: "gpt-top", reasoning_effort: "low" },
162
- }, impl, staticInspector(new Set(["/o"])));
163
- expect(calls[0].model).toBe("gpt-top");
164
- expect(calls[0].reasoning_effort).toBe("low");
165
- });
166
- it("reads model/effort from review.subagent (P2 canonical location)", async () => {
167
- const plan = buildPlan([{ lens_id: "l", packet_path: "/p", output_path: "/o" }], "");
168
- fixture = await mkSession(plan);
169
- const { impl, calls } = buildOrchestrator([{ lens_id: "l", status: "ok" }]);
170
- await executeReviewViaCodexNested({
171
- sessionRoot: fixture.sessionRoot,
172
- ontoConfig: {
173
- review: {
174
- subagent: { provider: "codex", model_id: "gpt-sub", effort: "medium" },
175
- },
176
- },
177
- }, impl, staticInspector(new Set(["/o"])));
178
- expect(calls[0].model).toBe("gpt-sub");
179
- expect(calls[0].reasoning_effort).toBe("medium");
180
- });
181
- it("reads model/effort from review.teamlead.model when external codex teamlead", async () => {
182
- const plan = buildPlan([{ lens_id: "l", packet_path: "/p", output_path: "/o" }], "");
183
- fixture = await mkSession(plan);
184
- const { impl, calls } = buildOrchestrator([{ lens_id: "l", status: "ok" }]);
185
- await executeReviewViaCodexNested({
186
- sessionRoot: fixture.sessionRoot,
187
- ontoConfig: {
188
- review: {
189
- teamlead: { model: { provider: "codex", model_id: "gpt-tl", effort: "high" } },
190
- },
191
- },
192
- }, impl, staticInspector(new Set(["/o"])));
193
- expect(calls[0].model).toBe("gpt-tl");
194
- expect(calls[0].reasoning_effort).toBe("high");
195
- });
196
- it("review.subagent wins over top-level codex.* (P2 canonical > legacy)", async () => {
197
- const plan = buildPlan([{ lens_id: "l", packet_path: "/p", output_path: "/o" }], "");
198
- fixture = await mkSession(plan);
199
- const { impl, calls } = buildOrchestrator([{ lens_id: "l", status: "ok" }]);
200
- await executeReviewViaCodexNested({
201
- sessionRoot: fixture.sessionRoot,
202
- ontoConfig: {
203
- review: {
204
- subagent: { provider: "codex", model_id: "gpt-sub", effort: "medium" },
205
- },
206
- codex: { model: "gpt-legacy", effort: "high" },
207
- },
208
- }, impl, staticInspector(new Set(["/o"])));
209
- expect(calls[0].model).toBe("gpt-sub");
210
- expect(calls[0].reasoning_effort).toBe("medium");
211
- });
212
- it("review.subagent with provider=main-native does NOT claim codex slot (falls through)", async () => {
213
- // main-native subagent is not a codex provider → resolver should move on
214
- // to teamlead → legacy → top-level, not pick up subagent.
215
- const plan = buildPlan([{ lens_id: "l", packet_path: "/p", output_path: "/o" }], "");
216
- fixture = await mkSession(plan);
217
- const { impl, calls } = buildOrchestrator([{ lens_id: "l", status: "ok" }]);
218
- await executeReviewViaCodexNested({
219
- sessionRoot: fixture.sessionRoot,
220
- ontoConfig: {
221
- review: {
222
- subagent: { provider: "main-native" },
223
- },
224
- codex: { model: "gpt-legacy", effort: "high" },
225
- },
226
- }, impl, staticInspector(new Set(["/o"])));
227
- expect(calls[0].model).toBe("gpt-legacy");
228
- expect(calls[0].reasoning_effort).toBe("high");
229
- });
230
- it("passes sessionRoot-based stream_stdout_path/stream_stderr_path to orchestrator (live watcher)", async () => {
231
- // The watcher pane's tail -f target is sessionRoot/nested-outer-*.log.
232
- // The orchestrator must receive those absolute paths so spawn-watcher
233
- // can tee outer codex stdout/stderr there as codex emits chunks. If
234
- // the dispatch stopped plumbing these paths, streaming would silently
235
- // fall back to memory-only capture.
236
- const plan = buildPlan([{ lens_id: "l", packet_path: "/p", output_path: "/o" }], "");
237
- fixture = await mkSession(plan);
238
- const { impl, calls } = buildOrchestrator([{ lens_id: "l", status: "ok" }]);
239
- await executeReviewViaCodexNested({
240
- sessionRoot: fixture.sessionRoot,
241
- ontoConfig: {},
242
- }, impl, staticInspector(new Set(["/o"])));
243
- expect(calls[0].stream_stdout_path).toBe(path.join(fixture.sessionRoot, "nested-outer-stdout.log"));
244
- expect(calls[0].stream_stderr_path).toBe(path.join(fixture.sessionRoot, "nested-outer-stderr.log"));
245
- });
246
- it("archives outer stdout/stderr to nested-outer-*.log under sessionRoot", async () => {
247
- // Regression guard: outer codex diagnostics (ENV-BEFORE / ENV-AFTER /
248
- // LENS_DISPATCH_SUMMARY) and raw stderr are otherwise unreachable
249
- // after dispatch completes, because review-invoke's final JSON drops
250
- // `nested_raw`. The archive step is what makes post-hoc auditing
251
- // possible for the principal.
252
- const plan = buildPlan([{ lens_id: "l", packet_path: "/p", output_path: "/o" }], "");
253
- fixture = await mkSession(plan);
254
- const { impl } = buildOrchestrator([{ lens_id: "l", status: "ok" }], {
255
- outer_stdout: "ENV-BEFORE lens=l packet=/p output=/o\n" +
256
- "ENV-AFTER lens=l exit=0 output_bytes=42\n" +
257
- 'LENS_DISPATCH_SUMMARY:{"lens_results":[{"lens_id":"l","status":"ok"}]}\n',
258
- outer_stderr: "some-warning from outer codex\n",
259
- });
260
- await executeReviewViaCodexNested({
261
- sessionRoot: fixture.sessionRoot,
262
- ontoConfig: {},
263
- }, impl, staticInspector(new Set(["/o"])));
264
- const stdoutArchive = await fs.readFile(path.join(fixture.sessionRoot, "nested-outer-stdout.log"), "utf8");
265
- const stderrArchive = await fs.readFile(path.join(fixture.sessionRoot, "nested-outer-stderr.log"), "utf8");
266
- expect(stdoutArchive).toContain("ENV-BEFORE lens=l");
267
- expect(stdoutArchive).toContain("ENV-AFTER lens=l");
268
- expect(stdoutArchive).toContain("LENS_DISPATCH_SUMMARY:");
269
- expect(stderrArchive).toContain("some-warning from outer codex");
270
- });
271
- });
272
- // ---------------------------------------------------------------------------
273
- // Classification: orchestrator-ok AND file-exists → participating
274
- // ---------------------------------------------------------------------------
275
- describe("executeReviewViaCodexNested — per-lens classification", () => {
276
- let fixture;
277
- afterEach(async () => {
278
- if (fixture)
279
- await fixture.cleanup();
280
- });
281
- it("all ok + all files present → all participating", async () => {
282
- const plan = buildPlan([
283
- { lens_id: "a", packet_path: "/p/a", output_path: "/o/a" },
284
- { lens_id: "b", packet_path: "/p/b", output_path: "/o/b" },
285
- ], "");
286
- fixture = await mkSession(plan);
287
- const { impl } = buildOrchestrator([
288
- { lens_id: "a", status: "ok" },
289
- { lens_id: "b", status: "ok" },
290
- ]);
291
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set(["/o/a", "/o/b"])));
292
- expect(result.participating_lens_ids).toEqual(["a", "b"]);
293
- expect(result.degraded_lens_ids).toEqual([]);
294
- expect(result.executed_lens_count).toBe(2);
295
- });
296
- it("orchestrator fail → degraded (no file probe needed)", async () => {
297
- const plan = buildPlan([
298
- { lens_id: "a", packet_path: "/p/a", output_path: "/o/a" },
299
- { lens_id: "b", packet_path: "/p/b", output_path: "/o/b" },
300
- ], "");
301
- fixture = await mkSession(plan);
302
- const { impl } = buildOrchestrator([
303
- { lens_id: "a", status: "ok" },
304
- { lens_id: "b", status: "fail", error: "inner exit 1" },
305
- ]);
306
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set(["/o/a", "/o/b"])));
307
- expect(result.participating_lens_ids).toEqual(["a"]);
308
- expect(result.degraded_lens_ids).toEqual(["b"]);
309
- });
310
- it("orchestrator ok but output file missing → degraded", async () => {
311
- const plan = buildPlan([
312
- { lens_id: "a", packet_path: "/p/a", output_path: "/o/a" },
313
- { lens_id: "b", packet_path: "/p/b", output_path: "/o/b" },
314
- ], "");
315
- fixture = await mkSession(plan);
316
- const { impl } = buildOrchestrator([
317
- { lens_id: "a", status: "ok" },
318
- { lens_id: "b", status: "ok" },
319
- ]);
320
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set(["/o/a"])));
321
- expect(result.participating_lens_ids).toEqual(["a"]);
322
- expect(result.degraded_lens_ids).toEqual(["b"]);
323
- });
324
- it("orchestrator ok but output file size=0 → degraded", async () => {
325
- const plan = buildPlan([{ lens_id: "a", packet_path: "/p/a", output_path: "/o/a" }], "");
326
- fixture = await mkSession(plan);
327
- const { impl } = buildOrchestrator([{ lens_id: "a", status: "ok" }]);
328
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set(["/o/a"]), { "/o/a": 0 }));
329
- expect(result.participating_lens_ids).toEqual([]);
330
- expect(result.degraded_lens_ids).toEqual(["a"]);
331
- });
332
- });
333
- // ---------------------------------------------------------------------------
334
- // Result shape
335
- // ---------------------------------------------------------------------------
336
- describe("executeReviewViaCodexNested — result shape", () => {
337
- let fixture;
338
- afterEach(async () => {
339
- if (fixture)
340
- await fixture.cleanup();
341
- });
342
- it("synthesis_executed is always false in PR-H (deferred)", async () => {
343
- const plan = buildPlan([{ lens_id: "a", packet_path: "/p/a", output_path: "/o/a" }], "");
344
- fixture = await mkSession(plan);
345
- const { impl } = buildOrchestrator([{ lens_id: "a", status: "ok" }]);
346
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set(["/o/a"])));
347
- expect(result.synthesis_executed).toBe(false);
348
- });
349
- it("synthesis_output_path is sourced from execution-plan for downstream synthesize wire-in", async () => {
350
- const plan = buildPlan([{ lens_id: "a", packet_path: "/p/a", output_path: "/o/a" }], "");
351
- plan.synthesis_output_path = "/tmp/synth-target.md";
352
- fixture = await mkSession(plan);
353
- const { impl } = buildOrchestrator([{ lens_id: "a", status: "ok" }]);
354
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set(["/o/a"])));
355
- expect(result.synthesis_output_path).toBe("/tmp/synth-target.md");
356
- });
357
- it("nested_raw exposes orchestrator result verbatim for debugging", async () => {
358
- const plan = buildPlan([{ lens_id: "a", packet_path: "/p/a", output_path: "/o/a" }], "");
359
- fixture = await mkSession(plan);
360
- const { impl } = buildOrchestrator([{ lens_id: "a", status: "ok" }], { outer_stdout: "outer stdout content", outer_stderr: "outer stderr content" });
361
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set(["/o/a"])));
362
- expect(result.nested_raw.outer_stdout).toBe("outer stdout content");
363
- expect(result.nested_raw.outer_stderr).toBe("outer stderr content");
364
- });
365
- it("halt_reason populated when outer exit non-zero AND summary not parsed", async () => {
366
- const plan = buildPlan([{ lens_id: "a", packet_path: "/p/a", output_path: "/o/a" }], "");
367
- fixture = await mkSession(plan);
368
- const { impl } = buildOrchestrator([{ lens_id: "a", status: "fail", error: "no summary" }], { outer_exit_code: 137, summary_parsed: false });
369
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set()));
370
- expect(result.halt_reason).toBeDefined();
371
- expect(result.halt_reason).toContain("137");
372
- });
373
- it("halt_reason absent when per-lens degraded but teamlead ok", async () => {
374
- const plan = buildPlan([{ lens_id: "a", packet_path: "/p/a", output_path: "/o/a" }], "");
375
- fixture = await mkSession(plan);
376
- const { impl } = buildOrchestrator([{ lens_id: "a", status: "fail", error: "inner 1" }], { outer_exit_code: 0, summary_parsed: true });
377
- const result = await executeReviewViaCodexNested({ sessionRoot: fixture.sessionRoot, ontoConfig: {} }, impl, staticInspector(new Set()));
378
- expect(result.halt_reason).toBeUndefined();
379
- expect(result.degraded_lens_ids).toEqual(["a"]);
380
- });
381
- });
382
- // ---------------------------------------------------------------------------
383
- // Execution-plan missing — bridge surfaces the error
384
- // ---------------------------------------------------------------------------
385
- describe("executeReviewViaCodexNested — missing execution-plan", () => {
386
- it("propagates readYamlDocument error when execution-plan.yaml absent", async () => {
387
- const { impl } = buildOrchestrator([]);
388
- await expect(executeReviewViaCodexNested({ sessionRoot: "/nonexistent/session/path", ontoConfig: {} }, impl, staticInspector(new Set()))).rejects.toThrow(/Failed to read artifact/);
389
- });
390
- });