onto-mcp 0.3.2 → 0.4.1
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.
- package/.onto/processes/reconstruct/actionable-ontology-seed-recomposition-design.md +447 -0
- package/.onto/processes/reconstruct/foundry-style-ontology-seed-contract.md +934 -0
- package/.onto/processes/reconstruct/reconstruct-boundary-contract.md +303 -725
- package/.onto/processes/reconstruct/reconstruct-contract-registry.yaml +1645 -0
- package/.onto/processes/reconstruct/reconstruct-execution-ux-contract.md +26 -22
- package/.onto/processes/reconstruct/source-profile-contract.md +49 -23
- package/.onto/processes/reconstruct/source-profiles/code.md +6 -3
- package/.onto/processes/reconstruct/source-profiles/database.md +5 -2
- package/.onto/processes/reconstruct/source-profiles/document.md +5 -2
- package/.onto/processes/reconstruct/source-profiles/spreadsheet.md +5 -4
- package/.onto/processes/review/review-execution-ux-contract.md +40 -0
- package/.onto/processes/shared/pipeline-execution-ledger-contract.md +26 -10
- package/.onto/processes/shared/target-material-kind-contract.md +29 -16
- package/AGENTS.md +6 -4
- package/README.md +149 -76
- package/dist/cli.js +8 -8
- package/dist/core-api/reconstruct-api.js +117 -31
- package/dist/core-api/review-api.js +47 -0
- package/dist/core-runtime/cli/codex-review-unit-executor.js +39 -2
- package/dist/core-runtime/cli/complete-review-session.js +2 -2
- package/dist/core-runtime/cli/mock-review-unit-executor.js +1 -1
- package/dist/core-runtime/cli/review-invoke.js +9 -9
- package/dist/core-runtime/cli/run-review-prompt-execution.js +39 -5
- package/dist/core-runtime/cli/spawn-watcher.js +266 -47
- package/dist/core-runtime/cli/start-review-session.js +3 -3
- package/dist/core-runtime/llm/llm-caller.js +11 -0
- package/dist/core-runtime/llm/llm-tool-loop.js +2 -0
- package/dist/core-runtime/observability/runtime-stream-observation.js +118 -0
- package/dist/core-runtime/onboard/cli-host.js +174 -0
- package/dist/core-runtime/onboard/host-target.js +22 -0
- package/dist/core-runtime/onboard/json-config-host.js +122 -0
- package/dist/core-runtime/onboard/path-scan.js +26 -0
- package/dist/core-runtime/onboard/prompt.js +51 -0
- package/dist/core-runtime/onboard/register.js +214 -0
- package/dist/core-runtime/onboard/types.js +27 -0
- package/dist/core-runtime/reconstruct/actionable-seed-validation.js +1777 -0
- package/dist/core-runtime/reconstruct/artifact-types.js +10 -4
- package/dist/core-runtime/reconstruct/contract-registry.js +623 -0
- package/dist/core-runtime/reconstruct/domain-id.js +10 -0
- package/dist/core-runtime/reconstruct/governing-snapshot.js +716 -0
- package/dist/core-runtime/reconstruct/material-profile-validation.js +191 -0
- package/dist/core-runtime/reconstruct/materialize-preparation.js +49 -11
- package/dist/core-runtime/reconstruct/pipeline-execution-ledger.js +269 -79
- package/dist/core-runtime/reconstruct/post-seed-validation.js +1194 -51
- package/dist/core-runtime/reconstruct/record.js +104 -20
- package/dist/core-runtime/reconstruct/run.js +2107 -413
- package/dist/core-runtime/reconstruct/seed-claim-projections.js +268 -0
- package/dist/core-runtime/reconstruct/source-profiles.js +93 -4
- package/dist/core-runtime/reconstruct/terminal-validation.js +807 -0
- package/dist/core-runtime/review/review-invocation-runner.js +4 -4
- package/dist/mcp/server.js +110 -38
- package/dist/mcp/tool-schemas.js +20 -6
- package/package.json +8 -17
- package/scripts/onto-review-watch.sh +486 -0
- package/scripts/onto-runtime-watch.sh +122 -0
- package/scripts/postinstall-hint.js +22 -0
- package/.onto/processes/reconstruct/top-level-concept-discovery-contract.md +0 -387
- package/dist/core-runtime/cli/bootstrap-review-binding.js +0 -186
- package/dist/core-runtime/cli/codex-nested-dispatch.test.js +0 -390
- package/dist/core-runtime/cli/codex-nested-teamlead-executor.test.js +0 -335
- package/dist/core-runtime/cli/coordinator-helpers.js +0 -583
- package/dist/core-runtime/cli/coordinator-state-machine-deliberation.test.js +0 -167
- package/dist/core-runtime/cli/coordinator-state-machine.js +0 -794
- package/dist/core-runtime/cli/e2e-codex-multi-agent-fixes.test.js +0 -615
- package/dist/core-runtime/cli/e2e-start-review-session.test.js +0 -312
- package/dist/core-runtime/cli/health.js +0 -44
- package/dist/core-runtime/cli/inline-http-review-unit-executor.test.js +0 -567
- package/dist/core-runtime/cli/materialize-review-execution-preparation.js +0 -104
- package/dist/core-runtime/cli/migrate-session-roots.js +0 -118
- package/dist/core-runtime/cli/repo-layout-migration-replace.smoke.test.js +0 -106
- package/dist/core-runtime/cli/review-invoke-auto-resolution.test.js +0 -268
- package/dist/core-runtime/cli/review-invoke-coordinator-topology.test.js +0 -136
- package/dist/core-runtime/cli/review-invoke-resolver-caching.test.js +0 -201
- package/dist/core-runtime/cli/review-invoke-topology-dispatch.test.js +0 -192
- package/dist/core-runtime/cli/session-root-guard.js +0 -168
- package/dist/core-runtime/cli/spawn-watcher.test.js +0 -457
- package/dist/core-runtime/cli/strip-wrapping-code-fence.test.js +0 -79
- package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.js +0 -412
- package/dist/core-runtime/cli/teamcreate-lens-deliberation-executor.test.js +0 -351
- package/dist/core-runtime/cli/topology-executor-mapping.js +0 -139
- package/dist/core-runtime/cli/topology-executor-mapping.test.js +0 -173
- package/dist/core-runtime/cli/write-review-interpretation.js +0 -81
- package/dist/core-runtime/config/onto-config-cli.js +0 -278
- package/dist/core-runtime/config/onto-config-key-path.js +0 -288
- package/dist/core-runtime/config/onto-config-key-path.test.js +0 -195
- package/dist/core-runtime/config/onto-config-preview.js +0 -108
- package/dist/core-runtime/config/onto-config-preview.test.js +0 -132
- package/dist/core-runtime/discovery/config-chain.js +0 -118
- package/dist/core-runtime/discovery/config-chain.test.js +0 -103
- package/dist/core-runtime/discovery/config-profile.js +0 -199
- package/dist/core-runtime/discovery/config-profile.test.js +0 -233
- package/dist/core-runtime/discovery/host-detection.test.js +0 -186
- package/dist/core-runtime/discovery/installation-paths.test.js +0 -65
- package/dist/core-runtime/discovery/lens-registry.test.js +0 -81
- package/dist/core-runtime/discovery/path-normalization.test.js +0 -22
- package/dist/core-runtime/discovery/plugin-path.js +0 -72
- package/dist/core-runtime/discovery/plugin-path.test.js +0 -95
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.js +0 -344
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile-defense.test.js +0 -915
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile.js +0 -564
- package/dist/core-runtime/evolve/adapters/code-product/compile/compile.test.js +0 -708
- package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.js +0 -165
- package/dist/core-runtime/evolve/adapters/code-product/parsers/brief-parser.test.js +0 -227
- package/dist/core-runtime/evolve/adapters/code-product/validators/validate.js +0 -59
- package/dist/core-runtime/evolve/adapters/code-product/validators/validate.test.js +0 -205
- package/dist/core-runtime/evolve/adapters/methodology/adapter.js +0 -16
- package/dist/core-runtime/evolve/adapters/methodology/adapter.test.js +0 -9
- package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.js +0 -298
- package/dist/core-runtime/evolve/adapters/methodology/perspectives/authority-consistency.test.js +0 -70
- package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.js +0 -46
- package/dist/core-runtime/evolve/adapters/methodology/scope-types/process.test.js +0 -73
- package/dist/core-runtime/evolve/adapters/registry.js +0 -47
- package/dist/core-runtime/evolve/adapters/registry.test.js +0 -67
- package/dist/core-runtime/evolve/cli.js +0 -256
- package/dist/core-runtime/evolve/commands/align.js +0 -194
- package/dist/core-runtime/evolve/commands/align.test.js +0 -82
- package/dist/core-runtime/evolve/commands/apply.js +0 -161
- package/dist/core-runtime/evolve/commands/apply.test.js +0 -138
- package/dist/core-runtime/evolve/commands/close.js +0 -39
- package/dist/core-runtime/evolve/commands/close.test.js +0 -99
- package/dist/core-runtime/evolve/commands/defer.js +0 -40
- package/dist/core-runtime/evolve/commands/defer.test.js +0 -134
- package/dist/core-runtime/evolve/commands/draft.js +0 -323
- package/dist/core-runtime/evolve/commands/draft.test.js +0 -178
- package/dist/core-runtime/evolve/commands/e2e-evolve-full-cycle.test.js +0 -208
- package/dist/core-runtime/evolve/commands/error-messages.js +0 -125
- package/dist/core-runtime/evolve/commands/error-messages.test.js +0 -167
- package/dist/core-runtime/evolve/commands/propose-align.js +0 -222
- package/dist/core-runtime/evolve/commands/propose-align.test.js +0 -136
- package/dist/core-runtime/evolve/commands/reconstruct.js +0 -330
- package/dist/core-runtime/evolve/commands/reconstruct.test.js +0 -278
- package/dist/core-runtime/evolve/commands/shared.js +0 -22
- package/dist/core-runtime/evolve/commands/stale-check.js +0 -103
- package/dist/core-runtime/evolve/commands/stale-check.test.js +0 -84
- package/dist/core-runtime/evolve/commands/start.js +0 -887
- package/dist/core-runtime/evolve/commands/start.test.js +0 -396
- package/dist/core-runtime/evolve/config/project-config.js +0 -99
- package/dist/core-runtime/evolve/config/project-config.test.js +0 -170
- package/dist/core-runtime/evolve/renderers/align-packet.js +0 -280
- package/dist/core-runtime/evolve/renderers/align-packet.test.js +0 -332
- package/dist/core-runtime/evolve/renderers/draft-packet.js +0 -303
- package/dist/core-runtime/evolve/renderers/draft-packet.test.js +0 -377
- package/dist/core-runtime/evolve/renderers/format.js +0 -5
- package/dist/core-runtime/evolve/renderers/scope-md.js +0 -237
- package/dist/core-runtime/evolve/renderers/scope-md.test.js +0 -306
- package/dist/core-runtime/govern/cli.js +0 -369
- package/dist/core-runtime/govern/cli.test.js +0 -314
- package/dist/core-runtime/govern/drift-engine.js +0 -103
- package/dist/core-runtime/govern/drift-engine.test.js +0 -319
- package/dist/core-runtime/govern/promote-principle.js +0 -206
- package/dist/core-runtime/govern/promote-principle.test.js +0 -368
- package/dist/core-runtime/govern/queue.js +0 -81
- package/dist/core-runtime/govern/types.js +0 -16
- package/dist/core-runtime/install/cli.js +0 -530
- package/dist/core-runtime/install/detect.js +0 -128
- package/dist/core-runtime/install/detect.test.js +0 -155
- package/dist/core-runtime/install/gitignore-update.js +0 -74
- package/dist/core-runtime/install/gitignore-update.test.js +0 -64
- package/dist/core-runtime/install/install-integration.test.js +0 -373
- package/dist/core-runtime/install/prompts.js +0 -389
- package/dist/core-runtime/install/prompts.test.js +0 -293
- package/dist/core-runtime/install/types.js +0 -26
- package/dist/core-runtime/install/validation.js +0 -295
- package/dist/core-runtime/install/validation.test.js +0 -313
- package/dist/core-runtime/install/writer.js +0 -254
- package/dist/core-runtime/install/writer.test.js +0 -218
- package/dist/core-runtime/learning/extractor.js +0 -461
- package/dist/core-runtime/learning/feedback.js +0 -179
- package/dist/core-runtime/learning/health-report.js +0 -165
- package/dist/core-runtime/learning/health-report.test.js +0 -169
- package/dist/core-runtime/learning/loader.js +0 -388
- package/dist/core-runtime/learning/loader.test.js +0 -102
- package/dist/core-runtime/learning/promote/apply-state.js +0 -240
- package/dist/core-runtime/learning/promote/audit-obligation.js +0 -195
- package/dist/core-runtime/learning/promote/collector.js +0 -432
- package/dist/core-runtime/learning/promote/degraded-state.js +0 -125
- package/dist/core-runtime/learning/promote/domain-doc-proposer.js +0 -166
- package/dist/core-runtime/learning/promote/e2e-promote.test.js +0 -6385
- package/dist/core-runtime/learning/promote/health-snapshot.js +0 -150
- package/dist/core-runtime/learning/promote/insight-reclassifier.js +0 -544
- package/dist/core-runtime/learning/promote/judgment-auditor.js +0 -517
- package/dist/core-runtime/learning/promote/panel-reviewer.js +0 -1158
- package/dist/core-runtime/learning/promote/promote-executor.js +0 -1675
- package/dist/core-runtime/learning/promote/promoter.js +0 -307
- package/dist/core-runtime/learning/promote/retirement.js +0 -122
- package/dist/core-runtime/learning/promote/types.js +0 -23
- package/dist/core-runtime/learning/prompt-sections.js +0 -51
- package/dist/core-runtime/learning/shared/artifact-registry-init.js +0 -45
- package/dist/core-runtime/learning/shared/artifact-registry.js +0 -254
- package/dist/core-runtime/learning/shared/audit-obligation-kernel.js +0 -73
- package/dist/core-runtime/learning/shared/audit-state.js +0 -99
- package/dist/core-runtime/learning/shared/duplicate-check.js +0 -28
- package/dist/core-runtime/learning/shared/llm-caller.js +0 -831
- package/dist/core-runtime/learning/shared/llm-caller.test.js +0 -601
- package/dist/core-runtime/learning/shared/llm-tool-loop.js +0 -393
- package/dist/core-runtime/learning/shared/mode.js +0 -25
- package/dist/core-runtime/learning/shared/paths.js +0 -84
- package/dist/core-runtime/learning/shared/paths.test.js +0 -79
- package/dist/core-runtime/learning/shared/patterns.js +0 -37
- package/dist/core-runtime/learning/shared/recoverability.js +0 -355
- package/dist/core-runtime/learning/shared/recovery-context.js +0 -374
- package/dist/core-runtime/learning/shared/scope.js +0 -1
- package/dist/core-runtime/learning/shared/semantic-classifier.js +0 -94
- package/dist/core-runtime/learning/shared/specs/apply-execution-state-spec.js +0 -42
- package/dist/core-runtime/learning/shared/specs/audit-state-spec.js +0 -37
- package/dist/core-runtime/learning/shared/specs/backup-metadata-spec.js +0 -39
- package/dist/core-runtime/learning/shared/specs/emergency-log-spec.js +0 -41
- package/dist/core-runtime/learning/shared/specs/layout-version-spec.js +0 -38
- package/dist/core-runtime/learning/shared/specs/promote-decisions-spec.js +0 -43
- package/dist/core-runtime/learning/shared/specs/promote-report-spec.js +0 -113
- package/dist/core-runtime/learning/shared/specs/prune-log-spec.js +0 -36
- package/dist/core-runtime/learning/shared/specs/recovery-resolution-spec.js +0 -48
- package/dist/core-runtime/learning/shared/specs/restore-manifest-spec.js +0 -43
- package/dist/core-runtime/learning/shared/specs/spec-helpers.js +0 -64
- package/dist/core-runtime/learning/usage-tracker.js +0 -190
- package/dist/core-runtime/learning/usage-tracker.test.js +0 -176
- package/dist/core-runtime/onboard/detect-review-axes.js +0 -122
- package/dist/core-runtime/onboard/detect-review-axes.test.js +0 -127
- package/dist/core-runtime/onboard/write-review-block.js +0 -188
- package/dist/core-runtime/onboard/write-review-block.test.js +0 -240
- package/dist/core-runtime/readers/brownfield-builder.js +0 -150
- package/dist/core-runtime/readers/brownfield-builder.test.js +0 -136
- package/dist/core-runtime/readers/code-chunk-collector.js +0 -53
- package/dist/core-runtime/readers/code-chunk-collector.test.js +0 -136
- package/dist/core-runtime/readers/file-utils.js +0 -240
- package/dist/core-runtime/readers/file-utils.test.js +0 -146
- package/dist/core-runtime/readers/lexicon-citation-check.js +0 -93
- package/dist/core-runtime/readers/lexicon-citation-check.test.js +0 -77
- package/dist/core-runtime/readers/mcp-figma.js +0 -30
- package/dist/core-runtime/readers/mcp-figma.test.js +0 -82
- package/dist/core-runtime/readers/mcp-generic.js +0 -31
- package/dist/core-runtime/readers/mcp-generic.test.js +0 -76
- package/dist/core-runtime/readers/ontology-index.js +0 -148
- package/dist/core-runtime/readers/ontology-index.test.js +0 -245
- package/dist/core-runtime/readers/ontology-query.js +0 -168
- package/dist/core-runtime/readers/ontology-query.test.js +0 -311
- package/dist/core-runtime/readers/ontology-resolve.js +0 -48
- package/dist/core-runtime/readers/ontology-resolve.test.js +0 -48
- package/dist/core-runtime/readers/patterns/index.js +0 -7
- package/dist/core-runtime/readers/review-log.js +0 -213
- package/dist/core-runtime/readers/review-log.test.js +0 -313
- package/dist/core-runtime/readers/scan-local.js +0 -102
- package/dist/core-runtime/readers/scan-local.test.js +0 -102
- package/dist/core-runtime/readers/scan-tarball.js +0 -121
- package/dist/core-runtime/readers/scan-tarball.test.js +0 -283
- package/dist/core-runtime/readers/scan-vault.js +0 -34
- package/dist/core-runtime/readers/scan-vault.test.js +0 -81
- package/dist/core-runtime/readers/types.js +0 -42
- package/dist/core-runtime/readers/types.test.js +0 -94
- package/dist/core-runtime/readers/viewpoint-collectors.js +0 -229
- package/dist/core-runtime/reconstruct/seed-candidate-validation.js +0 -385
- package/dist/core-runtime/review/citation-audit.test.js +0 -165
- package/dist/core-runtime/review/execution-plan-resolver.js +0 -247
- package/dist/core-runtime/review/execution-plan-resolver.test.js +0 -243
- package/dist/core-runtime/review/execution-topology-resolver-axis-first.test.js +0 -246
- package/dist/core-runtime/review/execution-topology-resolver.js +0 -401
- package/dist/core-runtime/review/execution-topology-resolver.test.js +0 -315
- package/dist/core-runtime/review/inline-context-embedder.test.js +0 -154
- package/dist/core-runtime/review/legacy-mode-policy.js +0 -88
- package/dist/core-runtime/review/materializers-effort-persist.test.js +0 -79
- package/dist/core-runtime/review/ontology-path-classifier.js +0 -179
- package/dist/core-runtime/review/ontology-path-classifier.test.js +0 -216
- package/dist/core-runtime/review/packet-boundary-policy.test.js +0 -107
- package/dist/core-runtime/review/participating-lens-paths.test.js +0 -73
- package/dist/core-runtime/review/review-config-legacy-translate.js +0 -244
- package/dist/core-runtime/review/review-config-legacy-translate.test.js +0 -161
- package/dist/core-runtime/review/review-config-validator.js +0 -289
- package/dist/core-runtime/review/review-config-validator.test.js +0 -236
- package/dist/core-runtime/review/shape-pipeline-audit.test.js +0 -311
- package/dist/core-runtime/review/shape-to-topology-id.js +0 -117
- package/dist/core-runtime/review/shape-to-topology-id.test.js +0 -132
- package/dist/core-runtime/review/topology-shape-derivation.js +0 -155
- package/dist/core-runtime/review/topology-shape-derivation.test.js +0 -195
- package/dist/core-runtime/scope-runtime/constants.js +0 -12
- package/dist/core-runtime/scope-runtime/constraint-pool.js +0 -166
- package/dist/core-runtime/scope-runtime/constraint-pool.test.js +0 -674
- package/dist/core-runtime/scope-runtime/domain-validation-log.js +0 -135
- package/dist/core-runtime/scope-runtime/domain-validation-log.test.js +0 -156
- package/dist/core-runtime/scope-runtime/eval-persistence.js +0 -65
- package/dist/core-runtime/scope-runtime/eval-persistence.test.js +0 -84
- package/dist/core-runtime/scope-runtime/event-pipeline.js +0 -64
- package/dist/core-runtime/scope-runtime/event-pipeline.test.js +0 -450
- package/dist/core-runtime/scope-runtime/event-store.js +0 -39
- package/dist/core-runtime/scope-runtime/event-store.test.js +0 -95
- package/dist/core-runtime/scope-runtime/gate-guard.js +0 -348
- package/dist/core-runtime/scope-runtime/gate-guard.test.js +0 -1047
- package/dist/core-runtime/scope-runtime/hash.js +0 -4
- package/dist/core-runtime/scope-runtime/hash.test.js +0 -33
- package/dist/core-runtime/scope-runtime/id.js +0 -4
- package/dist/core-runtime/scope-runtime/id.test.js +0 -17
- package/dist/core-runtime/scope-runtime/reducer.js +0 -297
- package/dist/core-runtime/scope-runtime/reducer.test.js +0 -759
- package/dist/core-runtime/scope-runtime/scope-manager.js +0 -161
- package/dist/core-runtime/scope-runtime/state-machine.js +0 -309
- package/dist/core-runtime/scope-runtime/state-machine.test.js +0 -704
- package/dist/core-runtime/scope-runtime/types.js +0 -116
- package/dist/core-runtime/scope-runtime/types.test.js +0 -69
- package/dist/core-runtime/translate/render-for-user.js +0 -169
- package/dist/core-runtime/translate/render-for-user.test.js +0 -122
- 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
|
-
});
|