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,280 +0,0 @@
1
- import { isEvidenceUnverified } from "../../scope-runtime/types.js";
2
- import { findConstraint } from "../../scope-runtime/constraint-pool.js";
3
- import { formatPerspective } from "./format.js";
4
- /**
5
- * Render an Align Packet — the document that confronts user intent with
6
- * current reality and surfaces tensions for scope confirmation.
7
- *
8
- * Pure function: (state, content) → string.
9
- *
10
- * - "처리하지 않으면" is sourced from pool.impact_if_ignored (single source).
11
- * - Summary table is built from content.tensions constraint_ids (not full pool).
12
- * - Throws if any tension constraint_id is not in the pool.
13
- * - Throws if entry_mode is "interface" but interface_extras is missing.
14
- */
15
- export function renderAlignPacket(state, content) {
16
- // ── Pre-render validation ──
17
- validate(state, content);
18
- const lines = [];
19
- // ── Header ──
20
- lines.push(`## Align Packet: ${state.title}`);
21
- lines.push("");
22
- // ── Section 1: To-be ──
23
- renderToBe(lines, state, content);
24
- // ── Section 2: As-is ──
25
- renderAsIs(lines, content);
26
- // ── Section 2.5: Unverified assumptions ──
27
- renderUnverifiedAssumptions(lines, state);
28
- // ── Section 3: Tension ──
29
- renderTension(lines, state, content);
30
- // ── Section 4: Decision ──
31
- renderDecision(lines, content);
32
- return lines.join("\n");
33
- }
34
- // ─── Validation ───
35
- function validate(state, content) {
36
- // Check all tension constraint_ids exist in pool
37
- const missingIds = content.tensions
38
- .map((t) => t.constraint_id)
39
- .filter((id) => findConstraint(state.constraint_pool, id) === undefined);
40
- if (missingIds.length > 0) {
41
- throw new Error(`renderAlignPacket: constraint_id not found in pool: ${missingIds.join(", ")}. constraint.discovered 이벤트로 해당 ID를 pool에 먼저 등록하세요.`);
42
- }
43
- // Check interface_extras for interface scope
44
- if (state.entry_mode === "interface" && !content.interface_extras) {
45
- throw new Error("renderAlignPacket: entry_mode is 'interface' but interface_extras is missing. AlignPacketContent에 interface_extras(api_scope, breaking_change, version_policy)를 포함하세요.");
46
- }
47
- }
48
- // ─── Section 1: To-be ───
49
- function renderToBe(lines, state, content) {
50
- lines.push("### 1. 당신이 요청한 것 (To-be)");
51
- lines.push("");
52
- lines.push(`**원문:** "${content.user_original_text}"`);
53
- lines.push("");
54
- lines.push("**시스템이 해석한 방향:**");
55
- lines.push(content.interpreted_direction);
56
- lines.push("");
57
- // Proposed scope — inclusion
58
- lines.push("**제안된 범위:**");
59
- lines.push("");
60
- lines.push("| 포함 | 동의하시나요? |");
61
- lines.push("|------|-------------|");
62
- for (const item of content.proposed_scope.in) {
63
- lines.push(`| ${item} | |`);
64
- }
65
- lines.push("");
66
- // Proposed scope — exclusion
67
- lines.push("| 제외 | 동의하시나요? |");
68
- lines.push("|------|-------------|");
69
- for (const item of content.proposed_scope.out) {
70
- lines.push(`| ${item} | |`);
71
- }
72
- lines.push("");
73
- // Scenarios
74
- lines.push("**시나리오:**");
75
- lines.push("");
76
- for (const scenario of content.scenarios) {
77
- lines.push(`> ${scenario}`);
78
- lines.push(">");
79
- }
80
- lines.push("");
81
- // Interface scope extras
82
- if (state.entry_mode === "interface" && content.interface_extras) {
83
- lines.push("**Interface scope 추가 항목:**");
84
- lines.push("");
85
- lines.push("| 항목 | 값 |");
86
- lines.push("|------|-----|");
87
- lines.push(`| API 공개 범위 | ${content.interface_extras.api_scope} |`);
88
- lines.push(`| 하위 호환 허용 여부 | ${content.interface_extras.breaking_change} |`);
89
- lines.push(`| 버전 정책 | ${content.interface_extras.version_policy} |`);
90
- lines.push("");
91
- }
92
- lines.push("---");
93
- lines.push("");
94
- }
95
- // ─── Section 2: As-is ───
96
- function renderAsIs(lines, content) {
97
- lines.push("### 2. 현재 현실 (As-is)");
98
- lines.push("");
99
- lines.push("#### Experience 관점 — 지금 사용자가 보는 것");
100
- lines.push("");
101
- lines.push(content.as_is.experience);
102
- lines.push("");
103
- lines.push("#### Policy 관점 — 지금 적용되는 규칙");
104
- lines.push("");
105
- lines.push(content.as_is.policy);
106
- lines.push("");
107
- lines.push("#### Code 관점 — 지금 시스템이 할 수 있는 것");
108
- lines.push("");
109
- lines.push(content.as_is.code);
110
- lines.push("");
111
- if (content.as_is.code_details) {
112
- lines.push("<details>");
113
- lines.push("<summary>기술 상세 (Builder 참고용)</summary>");
114
- lines.push("");
115
- lines.push(content.as_is.code_details);
116
- lines.push("</details>");
117
- lines.push("");
118
- }
119
- lines.push("---");
120
- lines.push("");
121
- }
122
- // ─── Section 3: Tension ───
123
- function renderTension(lines, state, content) {
124
- lines.push("### 3. 충돌 지점 (Tension)");
125
- lines.push("");
126
- if (content.tensions.length === 0) {
127
- lines.push("발견된 충돌이 없습니다.");
128
- lines.push("");
129
- lines.push("---");
130
- lines.push("");
131
- return;
132
- }
133
- lines.push(`요청한 것(to-be)과 현재 현실(as-is) 사이에 ${content.tensions.length}건의 충돌이 발견되었습니다.`);
134
- lines.push("");
135
- // Summary table
136
- lines.push("| CST-ID | 관점 | 요약 |");
137
- lines.push("|--------|------|------|");
138
- for (const t of content.tensions) {
139
- const entry = findConstraint(state.constraint_pool, t.constraint_id);
140
- lines.push(`| ${t.constraint_id} | ${formatPerspective(entry.perspective)} | ${entry.summary} |`);
141
- }
142
- lines.push("");
143
- lines.push("---");
144
- lines.push("");
145
- // Individual details
146
- for (const t of content.tensions) {
147
- const entry = findConstraint(state.constraint_pool, t.constraint_id);
148
- lines.push(`#### ${t.constraint_id} | ${formatPerspective(entry.perspective)} | ${entry.summary}`);
149
- lines.push("");
150
- lines.push("**이것이 무엇인가:**");
151
- lines.push(t.what);
152
- lines.push("");
153
- lines.push("**왜 충돌하는가:**");
154
- lines.push(t.why_conflict);
155
- lines.push("");
156
- lines.push("**처리하지 않으면:**");
157
- lines.push(entry.impact_if_ignored);
158
- lines.push("");
159
- lines.push(`**변경 규모:** ${t.scale}`);
160
- lines.push("");
161
- if (t.options && t.options.length > 0) {
162
- lines.push("**선택지:**");
163
- lines.push("");
164
- lines.push("| 선택 | 이점 | 리스크 | 내용 |");
165
- lines.push("|------|------|--------|------|");
166
- for (const opt of t.options) {
167
- const detail = opt.detail ?? "";
168
- lines.push(`| ${opt.choice} | ${opt.pros} | ${opt.risk} | ${detail} |`);
169
- }
170
- lines.push("");
171
- }
172
- if (t.recommendation) {
173
- lines.push(`**추천:** ${t.recommendation}`);
174
- lines.push("");
175
- }
176
- if (t.details) {
177
- lines.push("<details>");
178
- lines.push("<summary>기술 상세 (Builder 참고용)</summary>");
179
- lines.push("");
180
- lines.push(t.details);
181
- lines.push("</details>");
182
- lines.push("");
183
- }
184
- lines.push("---");
185
- lines.push("");
186
- }
187
- }
188
- // ─── Section 4: Decision ───
189
- function renderDecision(lines, content) {
190
- lines.push("### 4. 지금 결정할 것");
191
- lines.push("");
192
- for (let i = 0; i < content.decision_questions.length; i++) {
193
- lines.push(`${i + 1}. ${content.decision_questions[i]}`);
194
- }
195
- lines.push("");
196
- lines.push("다음 중 번호로 선택해 주세요:");
197
- lines.push("");
198
- lines.push("1. **Approve** — 이 방향과 범위에 동의합니다. Surface(화면 설계) 단계로 진행합니다.");
199
- lines.push("2. **Revise** — Align Packet을 수정하고 싶습니다. 피드백을 주시면 수정 후 다시 보여드립니다. 소스는 다시 읽지 않습니다.");
200
- lines.push("3. **Reject** — 이 scope를 거절하고 종료합니다.");
201
- lines.push("4. **Redirect** — 소스를 다시 읽은 뒤 처음부터 재분석합니다. 소스 정보가 오래되었거나 부족한 경우에 선택하세요.");
202
- lines.push("");
203
- lines.push("<details><summary>추가 선택지</summary>");
204
- lines.push("");
205
- lines.push("5. **Review** — 6-Agent Panel Review를 요청합니다. 전문가 6인이 검토 후 보강된 Packet을 다시 제시합니다.");
206
- lines.push("");
207
- lines.push("</details>");
208
- lines.push("");
209
- lines.push("번호(1~4) 또는 자연어로 말씀해 주세요.");
210
- lines.push("");
211
- }
212
- // ─── Section 2.5: Unverified Assumptions ───
213
- function renderUnverifiedAssumptions(lines, state) {
214
- const active = state.constraint_pool.constraints.filter((c) => c.status !== "invalidated");
215
- const unverified = active.filter((c) => isEvidenceUnverified(c.evidence_status));
216
- // §2.6 — Exploration Phase 5에서 발견된 가정 (§2.5와 독립적으로 판단)
217
- const explorationAssumptions = state.exploration_progress?.assumptions?.filter((a) => a.status === "unverified") ?? [];
218
- // §2.5와 §2.6 모두 비어있으면 섹션 전체 생략
219
- if (unverified.length === 0 && explorationAssumptions.length === 0)
220
- return;
221
- // §2.5 — 소스 탐색에서 발견된 미검증 가정
222
- if (unverified.length > 0) {
223
- const ratio = active.length > 0 ? unverified.length / active.length : 0;
224
- lines.push("### 2.5 미검증 가정 — 소스 탐색에서 발견");
225
- lines.push("");
226
- // 80% 이상 미검증이면 단일 경고 문구로 대체
227
- if (ratio >= 0.8) {
228
- lines.push(`> 현재 발견된 ${active.length}건의 제약 조건 중 **${unverified.length}건이 정책 문서에서 확인되지 않았습니다.** Approve 전에 정책 문서와 대조를 권장합니다.`);
229
- lines.push("");
230
- }
231
- else {
232
- lines.push("아래 항목은 정책 문서에서 확인되지 않은 가정입니다. Approve 전에 확인을 권장합니다.");
233
- lines.push("");
234
- lines.push("| CST-ID | 가정 출처 | 요약 | 확인 필요 사항 |");
235
- lines.push("|--------|----------|------|--------------|");
236
- for (const c of unverified) {
237
- const statusLabel = formatEvidenceStatus(c.evidence_status);
238
- const note = c.evidence_note ?? generateFallbackNote(c);
239
- lines.push(`| ${c.constraint_id} | ${statusLabel} | ${c.summary} | ${note} |`);
240
- }
241
- lines.push("");
242
- }
243
- }
244
- // §2.6 — 대화 탐색에서 발견된 미검증 가정 (§2.5 조기 반환과 독립)
245
- if (explorationAssumptions.length > 0) {
246
- lines.push("### 2.6 미검증 가정 — 대화 탐색에서 발견");
247
- lines.push("");
248
- lines.push("아래 항목은 Exploration 대화에서 발견된 PO 결정의 전제입니다. 아직 검증되지 않았습니다.");
249
- lines.push("");
250
- lines.push("| # | 가정 내용 | 발견 Phase | 상태 |");
251
- lines.push("|---|----------|-----------|------|");
252
- explorationAssumptions.forEach((a, i) => {
253
- lines.push(`| ${i + 1} | ${a.content} | Phase ${a.source_phase ?? "?"} | 미검증 |`);
254
- });
255
- lines.push("");
256
- }
257
- lines.push("---");
258
- lines.push("");
259
- }
260
- /** evidence_note가 없을 때 source_refs에서 fallback 텍스트 생성 */
261
- function generateFallbackNote(c) {
262
- if (c.source_refs.length === 0)
263
- return "정책 문서에서 이 규칙의 근거를 확인해 주세요";
264
- const ref = c.source_refs[0];
265
- return `${ref.source}의 ${ref.detail}에서 확인 필요`;
266
- }
267
- function formatEvidenceStatus(status) {
268
- switch (status) {
269
- case "verified":
270
- return "정책 문서 확인됨";
271
- case "code_inferred":
272
- return "현재 작동 중이나 정책 문서에 근거 없음";
273
- case "brief_claimed":
274
- return "요청자 주장, 별도 확인 필요";
275
- case "unverified":
276
- return "미확인";
277
- }
278
- }
279
- // ─── Helpers ───
280
- // formatPerspective is imported from ./format.ts
@@ -1,332 +0,0 @@
1
- import { describe, it, expect } from "vitest";
2
- import { readFileSync } from "node:fs";
3
- import { resolve } from "node:path";
4
- import { renderAlignPacket } from "./align-packet.js";
5
- import { reduce } from "../../scope-runtime/reducer.js";
6
- // ─── Helpers ───
7
- function emptyPool() {
8
- return {
9
- constraints: [],
10
- summary: { total: 0, required: 0, recommended: 0, decided: 0, clarify_pending: 0, invalidated: 0, undecided: 0 },
11
- };
12
- }
13
- function makeEntry(id, overrides = {}) {
14
- return {
15
- constraint_id: id,
16
- perspective: "code",
17
- summary: `test summary for ${id}`,
18
- severity: "recommended",
19
- discovery_stage: "grounding",
20
- decision_owner: "product_owner",
21
- impact_if_ignored: `impact if ${id} ignored`,
22
- source_refs: [{ source: "test.ts", detail: "test detail" }],
23
- evidence_status: "unverified",
24
- status: "undecided",
25
- discovered_at: 1,
26
- ...overrides,
27
- };
28
- }
29
- function makePoolWith(...entries) {
30
- let required = 0, recommended = 0;
31
- for (const e of entries) {
32
- if (e.severity === "required")
33
- required++;
34
- else
35
- recommended++;
36
- }
37
- return {
38
- constraints: entries,
39
- summary: {
40
- total: entries.length, required, recommended,
41
- decided: 0, clarify_pending: 0, invalidated: 0, undecided: entries.length,
42
- },
43
- };
44
- }
45
- function makeState(overrides = {}) {
46
- return {
47
- scope_id: "SC-TEST",
48
- title: "테스트 Scope",
49
- description: "테스트용",
50
- entry_mode: "experience",
51
- current_state: "grounded",
52
- constraint_pool: emptyPool(),
53
- stale: false,
54
- compile_ready: false,
55
- convergence_blocked: false,
56
- revision_count_align: 0,
57
- revision_count_surface: 0,
58
- retry_count_compile: 0,
59
- snapshot_revision: 0,
60
- pre_apply_completed: false,
61
- prd_review_completed: false,
62
- verdict_log: [],
63
- feedback_history: [],
64
- latest_revision: 0,
65
- ...overrides,
66
- };
67
- }
68
- function makeContent(overrides = {}) {
69
- return {
70
- user_original_text: "테스트 기능",
71
- interpreted_direction: "테스트 해석 방향",
72
- proposed_scope: { in: ["기능A", "기능B"], out: ["기능C"] },
73
- scenarios: ["시나리오 1: 사용자가 A를 수행합니다"],
74
- as_is: {
75
- experience: "현재 화면에 해당 기능 없음",
76
- policy: "관련 정책 없음",
77
- code: "관련 코드 없음",
78
- },
79
- tensions: [],
80
- decision_questions: ["이 범위에 동의하십니까?"],
81
- ...overrides,
82
- };
83
- }
84
- // ─── Golden data ───
85
- describe("align-packet — golden data structure", () => {
86
- it("renders Align Packet matching golden structure", () => {
87
- const goldenPath = resolve(import.meta.dirname, "../../scope-runtime/__fixtures__/example-tutor-block/events.ndjson");
88
- const events = readFileSync(goldenPath, "utf-8")
89
- .trimEnd()
90
- .split("\n")
91
- .map((line) => JSON.parse(line));
92
- // Use state at align.proposed point (first 7 events: up to align.proposed)
93
- const alignEvents = events.slice(0, 7);
94
- const state = reduce(alignEvents);
95
- const content = {
96
- user_original_text: "튜터 차단 기능",
97
- interpreted_direction: "학생이 특정 튜터를 차단하면, 향후 매칭에서 해당 튜터가 자동으로 제외됩니다.",
98
- proposed_scope: {
99
- in: ["차단 생성", "차단 해제", "차단 목록 조회", "매칭 시 차단 반영"],
100
- out: ["튜터에게 차단 사실 통보", "차단 사유 수집", "관리자 차단 기능"],
101
- },
102
- scenarios: [
103
- "시나리오 1: 학생 A가 수업 후 튜터 B를 차단합니다. 이후 수업 예약 시 튜터 B는 후보에 나타나지 않습니다.",
104
- "시나리오 2: 학생 A가 차단 관리 화면에서 튜터 B의 차단을 해제합니다. 이후 튜터 B가 다시 매칭 후보에 포함됩니다.",
105
- ],
106
- as_is: {
107
- experience: "튜터 프로필 화면이 존재하지만, 차단 기능은 없습니다.",
108
- policy: "이용약관에 공정 매칭 조항이 있습니다.",
109
- code: "매칭 시스템은 언어, 시간대, 레벨만으로 튜터를 배정합니다.",
110
- code_details: "매칭 엔진: matching-engine.ts의 findAvailableTutors()",
111
- },
112
- tensions: [
113
- { constraint_id: "CST-001", what: "매칭 시스템에 제외 기능 없음", why_conflict: "화면과 시스템이 함께 바뀌어야 함", scale: "매칭 시스템 내부 로직 변경 필요" },
114
- { constraint_id: "CST-002", what: "이용약관 충돌", why_conflict: "차단이 공정 매칭과 양립 불가", scale: "약관 검토 필요", options: [{ choice: "예외 조항 추가", pros: "빠른 적용", risk: "약관 일관성" }, { choice: "사유 수집으로 제한", pros: "데이터 수집", risk: "UX 복잡도" }, { choice: "현재 약관 유지", pros: "변경 없음", risk: "법적 분쟁" }, { choice: "법무 확인", pros: "법적 안정성", risk: "일정 지연" }] },
115
- { constraint_id: "CST-003", what: "버튼 공간 부족", why_conflict: "간격 부족으로 오터치 위험", scale: "레이아웃 재배치", details: "현재 여유 공간 8px, 가이드 기준 16px" },
116
- ],
117
- decision_questions: [
118
- "위 범위(포함/제외)에 동의하십니까?",
119
- "이 3건의 충돌을 인지한 상태에서 이 방향으로 진행하겠습니까?",
120
- "열린 질문은 Draft 단계에서 결정해도 됩니까?",
121
- ],
122
- };
123
- const md = renderAlignPacket(state, content);
124
- // Section existence
125
- expect(md).toContain("### 1. 당신이 요청한 것 (To-be)");
126
- expect(md).toContain("### 2. 현재 현실 (As-is)");
127
- expect(md).toContain("### 3. 충돌 지점 (Tension)");
128
- expect(md).toContain("### 4. 지금 결정할 것");
129
- // Header
130
- expect(md).toContain("## Align Packet: 튜터 차단 기능");
131
- // CST tracking
132
- expect(md).toContain("CST-001");
133
- expect(md).toContain("CST-002");
134
- expect(md).toContain("CST-003");
135
- // Summary table
136
- expect(md).toContain("| CST-ID | 관점 | 요약 |");
137
- // Impact from pool
138
- expect(md).toContain("차단 버튼을 눌러도 실제 매칭에 반영되지 않습니다");
139
- // <details>
140
- expect(md).toContain("<details>");
141
- expect(md).toContain("기술 상세 (Builder 참고용)");
142
- // Decision choices
143
- expect(md).toContain("**Approve**");
144
- expect(md).toContain("자연어로 말씀해 주세요");
145
- });
146
- });
147
- // ─── Section 1: To-be ───
148
- describe("align-packet — Section 1 To-be", () => {
149
- it("renders original text", () => {
150
- const md = renderAlignPacket(makeState(), makeContent({ user_original_text: "My feature" }));
151
- expect(md).toContain('"My feature"');
152
- });
153
- it("renders scope tables with '동의하시나요?' column", () => {
154
- const md = renderAlignPacket(makeState(), makeContent({
155
- proposed_scope: { in: ["X", "Y"], out: ["Z"] },
156
- }));
157
- expect(md).toContain("| 포함 | 동의하시나요? |");
158
- expect(md).toContain("| X | |");
159
- expect(md).toContain("| 제외 | 동의하시나요? |");
160
- expect(md).toContain("| Z | |");
161
- });
162
- it("renders scenarios as blockquotes", () => {
163
- const md = renderAlignPacket(makeState(), makeContent({
164
- scenarios: ["학생이 차단합니다"],
165
- }));
166
- expect(md).toContain("> 학생이 차단합니다");
167
- });
168
- it("renders interface extras when entry_mode is interface", () => {
169
- const md = renderAlignPacket(makeState({ entry_mode: "interface" }), makeContent({
170
- interface_extras: { api_scope: "public", breaking_change: "forbidden", version_policy: "extend" },
171
- }));
172
- expect(md).toContain("API 공개 범위");
173
- expect(md).toContain("public");
174
- });
175
- });
176
- // ─── Section 2: As-is ───
177
- describe("align-packet — Section 2 As-is", () => {
178
- it("renders 3 perspective headers", () => {
179
- const md = renderAlignPacket(makeState(), makeContent());
180
- expect(md).toContain("#### Experience 관점");
181
- expect(md).toContain("#### Policy 관점");
182
- expect(md).toContain("#### Code 관점");
183
- });
184
- it("renders code_details in <details>", () => {
185
- const md = renderAlignPacket(makeState(), makeContent({
186
- as_is: { experience: "e", policy: "p", code: "c", code_details: "technical stuff" },
187
- }));
188
- expect(md).toContain("<details>");
189
- expect(md).toContain("technical stuff");
190
- });
191
- it("omits <details> when no code_details", () => {
192
- const md = renderAlignPacket(makeState(), makeContent({
193
- as_is: { experience: "e", policy: "p", code: "c" },
194
- }));
195
- expect(md).not.toContain("기술 상세 (Builder 참고용)");
196
- });
197
- });
198
- // ─── Section 3: Tension ───
199
- describe("align-packet — Section 3 Tension", () => {
200
- it("renders summary table from tensions", () => {
201
- const entry = makeEntry("CST-001", { perspective: "code", summary: "no exclusion" });
202
- const state = makeState({ constraint_pool: makePoolWith(entry) });
203
- const content = makeContent({
204
- tensions: [{ constraint_id: "CST-001", what: "w", why_conflict: "c", scale: "s" }],
205
- });
206
- const md = renderAlignPacket(state, content);
207
- expect(md).toContain("| CST-001 | Code | no exclusion |");
208
- });
209
- it("renders individual detail with 4 required items", () => {
210
- const entry = makeEntry("CST-001", { impact_if_ignored: "bad things happen" });
211
- const state = makeState({ constraint_pool: makePoolWith(entry) });
212
- const content = makeContent({
213
- tensions: [{ constraint_id: "CST-001", what: "WHAT", why_conflict: "WHY", scale: "BIG" }],
214
- });
215
- const md = renderAlignPacket(state, content);
216
- expect(md).toContain("**이것이 무엇인가:**");
217
- expect(md).toContain("WHAT");
218
- expect(md).toContain("**왜 충돌하는가:**");
219
- expect(md).toContain("WHY");
220
- expect(md).toContain("**처리하지 않으면:**");
221
- expect(md).toContain("bad things happen");
222
- expect(md).toContain("**변경 규모:** BIG");
223
- });
224
- it("renders options as table when present", () => {
225
- const entry = makeEntry("CST-001");
226
- const state = makeState({ constraint_pool: makePoolWith(entry) });
227
- const content = makeContent({
228
- tensions: [{
229
- constraint_id: "CST-001", what: "w", why_conflict: "c", scale: "s",
230
- options: [
231
- { choice: "opt A", pros: "빠름", risk: "낮음", detail: "상세A" },
232
- { choice: "opt B", pros: "안정적", risk: "중간" },
233
- ],
234
- recommendation: "opt A 추천",
235
- }],
236
- });
237
- const md = renderAlignPacket(state, content);
238
- expect(md).toContain("| 선택 | 이점 | 리스크 | 내용 |");
239
- expect(md).toContain("| opt A | 빠름 | 낮음 | 상세A |");
240
- expect(md).toContain("| opt B | 안정적 | 중간 | |");
241
- expect(md).toContain("**추천:** opt A 추천");
242
- });
243
- it("renders tension details in <details>", () => {
244
- const entry = makeEntry("CST-001");
245
- const state = makeState({ constraint_pool: makePoolWith(entry) });
246
- const content = makeContent({
247
- tensions: [{ constraint_id: "CST-001", what: "w", why_conflict: "c", scale: "s", details: "tech detail" }],
248
- });
249
- const md = renderAlignPacket(state, content);
250
- expect(md).toContain("tech detail");
251
- // Multiple <details> blocks (one from as_is if exists, one from tension)
252
- });
253
- it("renders empty tension message when no constraints", () => {
254
- const md = renderAlignPacket(makeState(), makeContent({ tensions: [] }));
255
- expect(md).toContain("발견된 충돌이 없습니다");
256
- });
257
- it("shows tension count", () => {
258
- const entries = [makeEntry("CST-001"), makeEntry("CST-002")];
259
- const state = makeState({ constraint_pool: makePoolWith(...entries) });
260
- const content = makeContent({
261
- tensions: [
262
- { constraint_id: "CST-001", what: "w1", why_conflict: "c1", scale: "s1" },
263
- { constraint_id: "CST-002", what: "w2", why_conflict: "c2", scale: "s2" },
264
- ],
265
- });
266
- const md = renderAlignPacket(state, content);
267
- expect(md).toContain("2건의 충돌");
268
- });
269
- });
270
- // ─── Section 4: Decision ───
271
- describe("align-packet — Section 4 Decision", () => {
272
- it("renders questions and choices", () => {
273
- const md = renderAlignPacket(makeState(), makeContent({
274
- decision_questions: ["Q1?", "Q2?"],
275
- }));
276
- expect(md).toContain("1. Q1?");
277
- expect(md).toContain("2. Q2?");
278
- expect(md).toContain("**Approve**");
279
- });
280
- });
281
- // ─── Edge cases: empty collections ───
282
- describe("align-packet — empty collections edge cases", () => {
283
- it("renders with empty scenarios (no blockquotes)", () => {
284
- const md = renderAlignPacket(makeState(), makeContent({ scenarios: [] }));
285
- expect(md).toContain("**시나리오:**");
286
- expect(md).not.toContain("> ");
287
- });
288
- it("renders with empty proposed_scope.in and out (tables with headers only)", () => {
289
- const md = renderAlignPacket(makeState(), makeContent({
290
- proposed_scope: { in: [], out: [] },
291
- }));
292
- expect(md).toContain("| 포함 | 동의하시나요? |");
293
- expect(md).toContain("| 제외 | 동의하시나요? |");
294
- // No data rows
295
- const lines = md.split("\n");
296
- const inHeaderIdx = lines.findIndex(l => l.includes("| 포함 | 동의하시나요? |"));
297
- const separatorIdx = inHeaderIdx + 1;
298
- const nextLine = lines[separatorIdx + 1];
299
- // Next line should be empty or the exclusion table
300
- expect(nextLine === "" || nextLine.includes("| 제외")).toBe(true);
301
- });
302
- it("interface_extras is ignored when entry_mode is experience", () => {
303
- const md = renderAlignPacket(makeState({ entry_mode: "experience" }), makeContent({
304
- interface_extras: { api_scope: "public", breaking_change: "forbidden", version_policy: "extend" },
305
- }));
306
- expect(md).not.toContain("API 공개 범위");
307
- expect(md).not.toContain("Interface scope 추가 항목");
308
- });
309
- it("renders with empty tensions array", () => {
310
- const md = renderAlignPacket(makeState(), makeContent({ tensions: [] }));
311
- expect(md).toContain("발견된 충돌이 없습니다");
312
- expect(md).not.toContain("| CST-ID |");
313
- });
314
- it("renders with empty decision_questions", () => {
315
- const md = renderAlignPacket(makeState(), makeContent({ decision_questions: [] }));
316
- expect(md).toContain("### 4. 지금 결정할 것");
317
- expect(md).toContain("**Approve**");
318
- });
319
- });
320
- // ─── Validation ───
321
- describe("align-packet — validation", () => {
322
- it("throws when tension constraint_id not in pool", () => {
323
- const content = makeContent({
324
- tensions: [{ constraint_id: "CST-MISSING", what: "w", why_conflict: "c", scale: "s" }],
325
- });
326
- expect(() => renderAlignPacket(makeState(), content)).toThrow("CST-MISSING");
327
- });
328
- it("throws when entry_mode is interface but no interface_extras", () => {
329
- const state = makeState({ entry_mode: "interface" });
330
- expect(() => renderAlignPacket(state, makeContent())).toThrow("interface_extras");
331
- });
332
- });