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,335 +0,0 @@
1
- import { describe, it, expect } from "vitest";
2
- import { buildNestedTeamleadPrompt, parseNestedTeamleadSummary, runCodexNestedTeamlead, } from "./codex-nested-teamlead-executor.js";
3
- // ---------------------------------------------------------------------------
4
- // These tests assert the PR-C orchestrator invariants:
5
- //
6
- // (1) The prompt embeds every lens in the same order with packet/output
7
- // paths and the sandbox flag the outer codex needs.
8
- // (2) The summary parser extracts the LENS_DISPATCH_SUMMARY line and
9
- // tolerates surrounding noise; malformed lines are ignored; last-one
10
- // wins when multiple are present.
11
- // (3) `runCodexNestedTeamlead` reconciles inputs with reported outcomes:
12
- // missing lens_ids become `fail` (teamlead noncompliance), reported
13
- // failures carry the reported error, timeouts mark every lens failed.
14
- // ---------------------------------------------------------------------------
15
- const LENSES = [
16
- {
17
- lens_id: "logic",
18
- packet_path: "/tmp/session/round1/logic-packet.md",
19
- output_path: "/tmp/session/round1/logic.md",
20
- },
21
- {
22
- lens_id: "pragmatics",
23
- packet_path: "/tmp/session/round1/pragmatics-packet.md",
24
- output_path: "/tmp/session/round1/pragmatics.md",
25
- },
26
- {
27
- lens_id: "axiology",
28
- packet_path: "/tmp/session/round1/axiology-packet.md",
29
- output_path: "/tmp/session/round1/axiology.md",
30
- },
31
- ];
32
- // ---------------------------------------------------------------------------
33
- // buildNestedTeamleadPrompt
34
- // ---------------------------------------------------------------------------
35
- describe("buildNestedTeamleadPrompt", () => {
36
- it("embeds every lens's id, packet path, and output path", () => {
37
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
38
- for (const lens of LENSES) {
39
- expect(prompt).toContain(lens.lens_id);
40
- expect(prompt).toContain(lens.packet_path);
41
- expect(prompt).toContain(lens.output_path);
42
- }
43
- });
44
- it("includes sandbox danger-full-access and ephemeral flags for inner codex", () => {
45
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
46
- expect(prompt).toContain("--sandbox danger-full-access");
47
- expect(prompt).toContain("--ephemeral");
48
- expect(prompt).toContain("--skip-git-repo-check");
49
- });
50
- it("declares the LENS_DISPATCH_SUMMARY sentinel the parser looks for", () => {
51
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
52
- expect(prompt).toContain("LENS_DISPATCH_SUMMARY:");
53
- });
54
- it("passes through model + reasoning_effort when provided", () => {
55
- const prompt = buildNestedTeamleadPrompt({
56
- lenses: LENSES.slice(0, 1),
57
- model: "gpt-5.4",
58
- reasoning_effort: "high",
59
- });
60
- expect(prompt).toContain("-m gpt-5.4");
61
- expect(prompt).toContain("model_reasoning_effort=high");
62
- });
63
- it("omits the model/effort flags when unset (codex uses its defaults)", () => {
64
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES.slice(0, 1) });
65
- expect(prompt).not.toContain(" -m ");
66
- expect(prompt).not.toContain("model_reasoning_effort=");
67
- });
68
- it("states the number of lenses explicitly (sanity check for the outer codex)", () => {
69
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
70
- expect(prompt).toContain(`${LENSES.length} lenses`);
71
- });
72
- it("surfaces nested model/effort in the diagnostic header for outer log readers", () => {
73
- const prompt = buildNestedTeamleadPrompt({
74
- lenses: LENSES.slice(0, 1),
75
- model: "gpt-5.4",
76
- reasoning_effort: "medium",
77
- });
78
- expect(prompt).toContain("model=gpt-5.4");
79
- expect(prompt).toContain("effort=medium");
80
- });
81
- it("falls back to (codex default) in diagnostic header when unset", () => {
82
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES.slice(0, 1) });
83
- expect(prompt).toContain("model=(codex default)");
84
- expect(prompt).toContain("effort=(codex default)");
85
- });
86
- it("embeds ENV-BEFORE and ENV-AFTER diagnostic emissions in the script body", () => {
87
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
88
- expect(prompt).toContain("ENV-BEFORE lens=");
89
- expect(prompt).toContain("ENV-AFTER lens=");
90
- });
91
- it("delivers instructions as a literal bash script piped to bash -s", () => {
92
- // Regression guard for the descriptive→literal rewrite. Earlier prompts
93
- // asked outer to "invoke nested codex for each lens", which outer
94
- // interpreted as a self-assignment (using its own file-edit tools) and
95
- // never spawned nested subprocesses. The literal-script formulation
96
- // removes that interpretation latitude — outer's only action is to
97
- // pipe the block below to bash.
98
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
99
- expect(prompt).toContain("bash -s");
100
- expect(prompt).toContain("```bash");
101
- expect(prompt).toContain("#!/usr/bin/env bash");
102
- expect(prompt).toContain("LENSES=(");
103
- });
104
- it("dispatches lenses in parallel via background subshells + wait", () => {
105
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
106
- // subshell + background + wait pattern
107
- expect(prompt).toMatch(/\)\s*&\s*\ndone\s*\n\s*wait/);
108
- });
109
- it("persists per-lens running log as nested-stderr.log on failure", () => {
110
- // Regression guard: post-hoc audit needs to answer "what failed
111
- // inside this lens run?" after dispatch exits. Now that the running
112
- // log lives under sessionRoot/round1 for real-time tail -f, the
113
- // failure path simply renames it to .<lens>.nested-stderr.log; the
114
- // success path removes it. Previous `tail -200` bounded copy is no
115
- // longer necessary since the source log is already file-system
116
- // resident at the destination directory.
117
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
118
- expect(prompt).toContain(".nested-stderr.log");
119
- expect(prompt).toContain(".running.log");
120
- });
121
- it("writes per-lens running log under sessionRoot (not TMPDIR) for live tail -f", () => {
122
- // Regression guard for commit 5 streaming: per-lens $LOG must live
123
- // under OUTPUT_DIR (sessionRoot/round1) so the watcher pane can
124
- // tail it as codex emits. Keeping $LOG in TMPDIR would revert to
125
- // post-hoc-only visibility.
126
- const prompt = buildNestedTeamleadPrompt({ lenses: LENSES });
127
- expect(prompt).toContain('LOG="$OUTPUT_DIR/.$LENS_ID.running.log"');
128
- // $STAT remains in TMPDIR (short-lived handoff from lens subshell
129
- // to the summary emitter; no value to the watcher).
130
- expect(prompt).toContain('STAT="$TMPDIR/$LENS_ID.status"');
131
- });
132
- });
133
- // ---------------------------------------------------------------------------
134
- // parseNestedTeamleadSummary
135
- // ---------------------------------------------------------------------------
136
- describe("parseNestedTeamleadSummary", () => {
137
- it("returns null when no summary line is present", () => {
138
- expect(parseNestedTeamleadSummary("just model commentary\nnothing here\n")).toBeNull();
139
- });
140
- it("extracts a valid summary line with all lens results", () => {
141
- const stdout = [
142
- "dispatched lens#1...",
143
- "dispatched lens#2...",
144
- 'LENS_DISPATCH_SUMMARY:{"lens_results":[{"lens_id":"logic","status":"ok"},{"lens_id":"pragmatics","status":"fail","error":"exit 1"}]}',
145
- ].join("\n");
146
- const result = parseNestedTeamleadSummary(stdout);
147
- expect(result).not.toBeNull();
148
- expect(result.lens_results).toHaveLength(2);
149
- expect(result.lens_results[0]).toEqual({ lens_id: "logic", status: "ok" });
150
- expect(result.lens_results[1]).toEqual({
151
- lens_id: "pragmatics",
152
- status: "fail",
153
- error: "exit 1",
154
- });
155
- });
156
- it("ignores malformed summary lines", () => {
157
- const stdout = "LENS_DISPATCH_SUMMARY:not-json-at-all\nno summary visible\n";
158
- expect(parseNestedTeamleadSummary(stdout)).toBeNull();
159
- });
160
- it("takes the last summary line when multiple appear", () => {
161
- const stdout = [
162
- 'LENS_DISPATCH_SUMMARY:{"lens_results":[{"lens_id":"a","status":"fail"}]}',
163
- 'LENS_DISPATCH_SUMMARY:{"lens_results":[{"lens_id":"a","status":"ok"}]}',
164
- ].join("\n");
165
- const result = parseNestedTeamleadSummary(stdout);
166
- expect(result.lens_results[0].status).toBe("ok");
167
- });
168
- it("tolerates leading/trailing whitespace around the summary line", () => {
169
- const stdout = ' LENS_DISPATCH_SUMMARY:{"lens_results":[]} \n';
170
- const result = parseNestedTeamleadSummary(stdout);
171
- expect(result).not.toBeNull();
172
- expect(result.lens_results).toEqual([]);
173
- });
174
- });
175
- function fakeSpawn(stdout, stderr, exit_code, timed_out = false) {
176
- return async () => ({ stdout, stderr, exit_code, timed_out });
177
- }
178
- describe("runCodexNestedTeamlead", () => {
179
- it("returns outcomes in input order with ok statuses on clean exit", async () => {
180
- const input = { lenses: LENSES };
181
- const stdout = `LENS_DISPATCH_SUMMARY:${JSON.stringify({
182
- lens_results: [
183
- { lens_id: "logic", status: "ok" },
184
- { lens_id: "pragmatics", status: "ok" },
185
- { lens_id: "axiology", status: "ok" },
186
- ],
187
- })}`;
188
- const result = await runCodexNestedTeamlead(input, fakeSpawn(stdout, "", 0));
189
- expect(result.summary_parsed).toBe(true);
190
- expect(result.outer_exit_code).toBe(0);
191
- expect(result.outcomes.map((o) => o.lens_id)).toEqual(["logic", "pragmatics", "axiology"]);
192
- expect(result.outcomes.every((o) => o.status === "ok")).toBe(true);
193
- });
194
- it("propagates per-lens failures from the summary", async () => {
195
- const input = { lenses: LENSES };
196
- const stdout = `LENS_DISPATCH_SUMMARY:${JSON.stringify({
197
- lens_results: [
198
- { lens_id: "logic", status: "ok" },
199
- { lens_id: "pragmatics", status: "fail", error: "inner codex exit 1" },
200
- { lens_id: "axiology", status: "ok" },
201
- ],
202
- })}`;
203
- const result = await runCodexNestedTeamlead(input, fakeSpawn(stdout, "", 0));
204
- expect(result.outcomes[0].status).toBe("ok");
205
- expect(result.outcomes[1].status).toBe("fail");
206
- expect(result.outcomes[1].error).toContain("inner codex exit 1");
207
- expect(result.outcomes[2].status).toBe("ok");
208
- });
209
- it("marks missing lens_ids as fail with teamlead-noncompliance reason", async () => {
210
- const input = { lenses: LENSES };
211
- // Summary omits axiology entirely.
212
- const stdout = `LENS_DISPATCH_SUMMARY:${JSON.stringify({
213
- lens_results: [
214
- { lens_id: "logic", status: "ok" },
215
- { lens_id: "pragmatics", status: "ok" },
216
- ],
217
- })}`;
218
- const result = await runCodexNestedTeamlead(input, fakeSpawn(stdout, "", 0));
219
- expect(result.outcomes[2].status).toBe("fail");
220
- expect(result.outcomes[2].error).toContain("axiology");
221
- expect(result.outcomes[2].error).toContain("summary missing");
222
- });
223
- it("marks all lenses fail when outer codex never emits a summary", async () => {
224
- const input = { lenses: LENSES };
225
- const stdout = "just commentary, no summary line\n";
226
- const result = await runCodexNestedTeamlead(input, fakeSpawn(stdout, "something went wrong", 1));
227
- expect(result.summary_parsed).toBe(false);
228
- expect(result.outer_exit_code).toBe(1);
229
- expect(result.outcomes.every((o) => o.status === "fail")).toBe(true);
230
- for (const outcome of result.outcomes) {
231
- expect(outcome.error).toContain("did not emit");
232
- }
233
- });
234
- it("timeout marks all lenses fail with explicit timeout reason", async () => {
235
- const input = { lenses: LENSES, timeout_ms: 1234 };
236
- const result = await runCodexNestedTeamlead(input, fakeSpawn("", "", 137, true));
237
- expect(result.summary_parsed).toBe(false);
238
- expect(result.outcomes.every((o) => o.status === "fail")).toBe(true);
239
- for (const outcome of result.outcomes) {
240
- expect(outcome.error).toContain("1234");
241
- expect(outcome.error).toContain("timed out");
242
- }
243
- });
244
- it("trusts per-lens summary even when outer exit code is non-zero", async () => {
245
- const input = { lenses: LENSES };
246
- const stdout = `LENS_DISPATCH_SUMMARY:${JSON.stringify({
247
- lens_results: [
248
- { lens_id: "logic", status: "ok" },
249
- { lens_id: "pragmatics", status: "ok" },
250
- { lens_id: "axiology", status: "fail", error: "model context length exceeded" },
251
- ],
252
- })}`;
253
- // Outer codex exits 1 (e.g., because one nested lens failed), but
254
- // summary is still reliable.
255
- const result = await runCodexNestedTeamlead(input, fakeSpawn(stdout, "", 1));
256
- expect(result.summary_parsed).toBe(true);
257
- expect(result.outer_exit_code).toBe(1);
258
- expect(result.outcomes[0].status).toBe("ok");
259
- expect(result.outcomes[1].status).toBe("ok");
260
- expect(result.outcomes[2].status).toBe("fail");
261
- expect(result.outcomes[2].error).toContain("context length");
262
- });
263
- it("captures outer stdout/stderr verbatim for debugging", async () => {
264
- const input = { lenses: LENSES.slice(0, 1) };
265
- const stdoutRaw = "outer commentary\nmore details\n";
266
- const stderrRaw = "some warning\n";
267
- const result = await runCodexNestedTeamlead(input, fakeSpawn(stdoutRaw, stderrRaw, 0));
268
- expect(result.outer_stdout).toBe(stdoutRaw);
269
- expect(result.outer_stderr).toBe(stderrRaw);
270
- });
271
- it("forwards model and reasoning_effort to outer codex spawn options", async () => {
272
- // Regression: outer codex previously inherited ~/.codex/config.toml
273
- // defaults (e.g. xhigh effort), ignoring .onto/config.yml overrides and
274
- // causing orchestration timeouts. The input fields must reach the
275
- // spawn callsite so the CLI can add `-c model_reasoning_effort=…` and
276
- // `-m <model>` args.
277
- let captured = null;
278
- const capturingSpawn = async (_prompt, options) => {
279
- captured = options;
280
- return { stdout: "", stderr: "", exit_code: 0, timed_out: false };
281
- };
282
- const input = {
283
- lenses: LENSES.slice(0, 1),
284
- model: "gpt-5.4",
285
- reasoning_effort: "medium",
286
- };
287
- await runCodexNestedTeamlead(input, capturingSpawn);
288
- expect(captured).not.toBeNull();
289
- expect(captured.model).toBe("gpt-5.4");
290
- expect(captured.reasoning_effort).toBe("medium");
291
- });
292
- it("omits model and reasoning_effort from spawn options when unset", async () => {
293
- let captured = null;
294
- const capturingSpawn = async (_prompt, options) => {
295
- captured = options;
296
- return { stdout: "", stderr: "", exit_code: 0, timed_out: false };
297
- };
298
- const input = { lenses: LENSES.slice(0, 1) };
299
- await runCodexNestedTeamlead(input, capturingSpawn);
300
- expect(captured).not.toBeNull();
301
- expect(captured.model).toBeUndefined();
302
- expect(captured.reasoning_effort).toBeUndefined();
303
- });
304
- it("forwards stream_stdout_path and stream_stderr_path to spawn options", async () => {
305
- // Regression guard for real-time watcher streaming: if these fields
306
- // drop, the outer codex stdout/stderr fall back to memory-only
307
- // capture and the watcher pane's tail -f hint loses its target.
308
- let captured = null;
309
- const capturingSpawn = async (_prompt, options) => {
310
- captured = options;
311
- return { stdout: "", stderr: "", exit_code: 0, timed_out: false };
312
- };
313
- const input = {
314
- lenses: LENSES.slice(0, 1),
315
- stream_stdout_path: "/tmp/fake/nested-outer-stdout.log",
316
- stream_stderr_path: "/tmp/fake/nested-outer-stderr.log",
317
- };
318
- await runCodexNestedTeamlead(input, capturingSpawn);
319
- expect(captured).not.toBeNull();
320
- expect(captured.stream_stdout_path).toBe("/tmp/fake/nested-outer-stdout.log");
321
- expect(captured.stream_stderr_path).toBe("/tmp/fake/nested-outer-stderr.log");
322
- });
323
- it("omits stream_*_path from spawn options when unset (memory-only capture)", async () => {
324
- let captured = null;
325
- const capturingSpawn = async (_prompt, options) => {
326
- captured = options;
327
- return { stdout: "", stderr: "", exit_code: 0, timed_out: false };
328
- };
329
- const input = { lenses: LENSES.slice(0, 1) };
330
- await runCodexNestedTeamlead(input, capturingSpawn);
331
- expect(captured).not.toBeNull();
332
- expect(captured.stream_stdout_path).toBeUndefined();
333
- expect(captured.stream_stderr_path).toBeUndefined();
334
- });
335
- });