@oscaner-skills/cdd-engine 3.0.0 → 3.0.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.
Files changed (143) hide show
  1. package/{src-next/bin.ts → dist/bin.js} +18 -21
  2. package/dist/contract/declare.js +998 -0
  3. package/dist/contract/doc.js +565 -0
  4. package/dist/contract/frontmatter.js +209 -0
  5. package/dist/contract/home-extractors.js +379 -0
  6. package/dist/contract/invariants.js +1030 -0
  7. package/dist/contract/judge.js +109 -0
  8. package/dist/contract/lint.js +206 -0
  9. package/dist/contract/project.js +371 -0
  10. package/dist/contract/skill-anatomy.js +156 -0
  11. package/dist/contract/translate.js +85 -0
  12. package/dist/face/artifacts.js +189 -0
  13. package/dist/face/board-view.js +522 -0
  14. package/dist/face/capsule.js +141 -0
  15. package/dist/face/cli.js +891 -0
  16. package/dist/face/declare.js +241 -0
  17. package/dist/face/gate.js +158 -0
  18. package/dist/face/graph-view.js +66 -0
  19. package/dist/face/host.js +211 -0
  20. package/dist/face/lifecycle.js +603 -0
  21. package/dist/face/preview.js +136 -0
  22. package/dist/face/projection.js +259 -0
  23. package/dist/face/route-render.js +162 -0
  24. package/dist/face/termination.js +482 -0
  25. package/dist/face/words.js +220 -0
  26. package/{src-next/infra/config.ts → dist/infra/config.js} +19 -24
  27. package/{src-next/infra/doc-roots.ts → dist/infra/doc-roots.js} +3 -13
  28. package/dist/infra/git.js +37 -0
  29. package/dist/infra/process.js +22 -0
  30. package/{src-next/infra/root.ts → dist/infra/root.js} +25 -36
  31. package/dist/infra/runtime.js +85 -0
  32. package/dist/infra/workspace.js +276 -0
  33. package/dist/render/brief.js +82 -0
  34. package/dist/render/issue-body.js +129 -0
  35. package/dist/render/skeleton.js +434 -0
  36. package/dist/render/templates.js +520 -0
  37. package/dist/session/faces.js +38 -0
  38. package/dist/session/graph.js +309 -0
  39. package/dist/session/handoff-schema.js +295 -0
  40. package/dist/session/ledger.js +762 -0
  41. package/dist/session/next.js +211 -0
  42. package/dist/session/preflight.js +194 -0
  43. package/dist/session/round-naming.js +73 -0
  44. package/dist/session/run.js +441 -0
  45. package/dist/session/state.js +8 -0
  46. package/dist/session/wave.js +92 -0
  47. package/package.json +5 -5
  48. package/src-next/__tests__/bin.test.ts +0 -128
  49. package/src-next/__tests__/dead-decl.guard.test.ts +0 -39
  50. package/src-next/__tests__/floor.guard.test.ts +0 -69
  51. package/src-next/__tests__/issue-body.guard.test.ts +0 -66
  52. package/src-next/__tests__/phase-suffix.guard.test.ts +0 -72
  53. package/src-next/__tests__/smoke.integration.test.ts +0 -185
  54. package/src-next/__tests__/support/strip-comments.ts +0 -99
  55. package/src-next/__tests__/zero-dep.test.ts +0 -94
  56. package/src-next/contract/__tests__/__snapshots__/project.schema.overall-spec.snap +0 -256
  57. package/src-next/contract/__tests__/__snapshots__/project.schema.phase-spec.snap +0 -165
  58. package/src-next/contract/__tests__/__snapshots__/project.schema.plan.snap +0 -190
  59. package/src-next/contract/__tests__/__snapshots__/project.schema.single-spec.snap +0 -106
  60. package/src-next/contract/__tests__/__snapshots__/project.shape.overall-spec.snap +0 -240
  61. package/src-next/contract/__tests__/__snapshots__/project.shape.phase-spec.snap +0 -165
  62. package/src-next/contract/__tests__/__snapshots__/project.shape.plan.snap +0 -190
  63. package/src-next/contract/__tests__/__snapshots__/project.shape.single-spec.snap +0 -100
  64. package/src-next/contract/__tests__/declare.test.ts +0 -481
  65. package/src-next/contract/__tests__/doc.test.ts +0 -527
  66. package/src-next/contract/__tests__/dockey.guard.test.ts +0 -58
  67. package/src-next/contract/__tests__/edge-conditions.guard.test.ts +0 -81
  68. package/src-next/contract/__tests__/frontmatter.test.ts +0 -164
  69. package/src-next/contract/__tests__/judge.test.ts +0 -1111
  70. package/src-next/contract/__tests__/lint.test.ts +0 -324
  71. package/src-next/contract/__tests__/project.test.ts +0 -460
  72. package/src-next/contract/__tests__/structure-pin.test.ts +0 -186
  73. package/src-next/contract/__tests__/translate.test.ts +0 -96
  74. package/src-next/contract/declare.ts +0 -1071
  75. package/src-next/contract/doc.ts +0 -816
  76. package/src-next/contract/frontmatter.ts +0 -233
  77. package/src-next/contract/home-extractors.ts +0 -397
  78. package/src-next/contract/invariants.ts +0 -1413
  79. package/src-next/contract/judge.ts +0 -151
  80. package/src-next/contract/lint.ts +0 -239
  81. package/src-next/contract/project.ts +0 -656
  82. package/src-next/contract/skill-anatomy.ts +0 -301
  83. package/src-next/contract/translate.ts +0 -113
  84. package/src-next/face/__tests__/board-view.test.ts +0 -1151
  85. package/src-next/face/__tests__/capsule.test.ts +0 -300
  86. package/src-next/face/__tests__/channel-closure.guard.test.ts +0 -129
  87. package/src-next/face/__tests__/cli.test.ts +0 -4897
  88. package/src-next/face/__tests__/face.test.ts +0 -289
  89. package/src-next/face/__tests__/graph-view.test.ts +0 -61
  90. package/src-next/face/__tests__/host.test.ts +0 -24
  91. package/src-next/face/__tests__/install-rows.guard.test.ts +0 -58
  92. package/src-next/face/__tests__/negation.ts +0 -6
  93. package/src-next/face/__tests__/preview.test.ts +0 -374
  94. package/src-next/face/__tests__/projection.test.ts +0 -303
  95. package/src-next/face/__tests__/repo-root.guard.test.ts +0 -120
  96. package/src-next/face/__tests__/termination.test.ts +0 -650
  97. package/src-next/face/__tests__/words.guard.test.ts +0 -93
  98. package/src-next/face/artifacts.ts +0 -248
  99. package/src-next/face/board-view.ts +0 -652
  100. package/src-next/face/capsule.ts +0 -163
  101. package/src-next/face/cli.ts +0 -1028
  102. package/src-next/face/declare.ts +0 -323
  103. package/src-next/face/gate.ts +0 -171
  104. package/src-next/face/graph-view.ts +0 -74
  105. package/src-next/face/host.ts +0 -302
  106. package/src-next/face/lifecycle.ts +0 -725
  107. package/src-next/face/preview.ts +0 -151
  108. package/src-next/face/projection.ts +0 -285
  109. package/src-next/face/route-render.ts +0 -185
  110. package/src-next/face/termination.ts +0 -573
  111. package/src-next/face/words.ts +0 -314
  112. package/src-next/infra/__tests__/infra.test.ts +0 -333
  113. package/src-next/infra/__tests__/root.test.ts +0 -56
  114. package/src-next/infra/git.ts +0 -39
  115. package/src-next/infra/process.ts +0 -34
  116. package/src-next/infra/runtime.ts +0 -132
  117. package/src-next/infra/workspace.ts +0 -322
  118. package/src-next/render/__tests__/render.test.ts +0 -550
  119. package/src-next/render/__tests__/skeleton.test.ts +0 -684
  120. package/src-next/render/brief.ts +0 -121
  121. package/src-next/render/issue-body.ts +0 -162
  122. package/src-next/render/skeleton.ts +0 -502
  123. package/src-next/render/templates.ts +0 -645
  124. package/src-next/session/__tests__/graph.test.ts +0 -277
  125. package/src-next/session/__tests__/handoff-plane.guard.test.ts +0 -48
  126. package/src-next/session/__tests__/handoff-schema.test.ts +0 -310
  127. package/src-next/session/__tests__/ledger.test.ts +0 -745
  128. package/src-next/session/__tests__/next.test.ts +0 -460
  129. package/src-next/session/__tests__/preflight.test.ts +0 -545
  130. package/src-next/session/__tests__/round-naming.test.ts +0 -142
  131. package/src-next/session/__tests__/run.test.ts +0 -1026
  132. package/src-next/session/__tests__/wave-line-phase.guard.test.ts +0 -49
  133. package/src-next/session/__tests__/wave.test.ts +0 -476
  134. package/src-next/session/faces.ts +0 -110
  135. package/src-next/session/graph.ts +0 -411
  136. package/src-next/session/handoff-schema.ts +0 -373
  137. package/src-next/session/ledger.ts +0 -1076
  138. package/src-next/session/next.ts +0 -293
  139. package/src-next/session/preflight.ts +0 -271
  140. package/src-next/session/round-naming.ts +0 -84
  141. package/src-next/session/run.ts +0 -610
  142. package/src-next/session/state.ts +0 -30
  143. package/src-next/session/wave.ts +0 -139
@@ -1,139 +0,0 @@
1
- // packages/cdd-engine/src-next/session/wave.ts
2
- // T24 (v1.21 — the three-verb unified wave gate) — the task-face dispatch
3
- // pre-flight as ONE gate method. The retired split check (the implement-only
4
- // strict-wave check + the phase lock) converges into `WaveGate.vet(requested,
5
- // verb)`: implement / review / fix share the same single wave gate — a
6
- // half-wave review or a half-wave fix is structurally blocked exactly like a
7
- // half-wave implement.
8
- //
9
- // The gate's only read face is `open = frontier(closedWaves())` — the derived
10
- // wave over the ledger's C5 closure set (ledger.ts, the same closure predicate as
11
- // the lifecycle's #markTerminal). The two judgments:
12
- // 1. requested ≠ open → the split/subset BLOCK (dispatch the full derived wave,
13
- // with the wave-board hint);
14
- // 2. the open wave's phase ≠ verb → the wrong-phase BLOCK (run the matching phase).
15
- // (v1.28 — the heterogeneous-phase row RETIRED: the wave-unitary ledger has ONE row
16
- // per wave, so mixed per-task phases are structurally impossible — a per-task phase
17
- // read was the T26 regression {16,22,24} exposed (the row key `16` never matched
18
- // `{wave:"16,22,24"}`), not a mixed-phase anomaly.)
19
- // The verdict wording renders the wave-gate vocabulary rows (face/words.ts — the
20
- // gate's prompt wording rides the word table, never a literal restate). BLOCK
21
- // messages and the verdict shape are data here; the CLI face renders them.
22
- //
23
- // Module-level exports are types / the class — zero behavior-carrying bare
24
- // functions (the plan's zero-bare-function discipline).
25
-
26
- import type { Words } from "../face/words.ts";
27
- import type { DispatchPhase } from "./faces.ts";
28
- import type { TaskGraph } from "./graph.ts";
29
- import type { Ledger } from "./ledger.ts";
30
-
31
- /** The verdict kinds — the named gate rows (the BLOCK reason each carries). */
32
- export type WaveGateReason = "split" | "wrong-phase";
33
-
34
- /** One open-wave task's phase row — every member carries the WAVE's single phase
35
- * (the wave-unitary read: one ledger row per wave; a per-task read would miss the
36
- * wave row — `16` ≠ `16,22,24` — the T26 migration regression). */
37
- export interface WavePhaseRow {
38
- /** The task id. */
39
- task: number;
40
- /** The wave's open phase (null = a closed/held wave — no open round on record). */
41
- phase: DispatchPhase | null;
42
- }
43
-
44
- /** The wave-gate verdict — approved or one of the three named BLOCK rows. */
45
- export interface WaveVerdict {
46
- /** Whether the gate approves the dispatch (the requested wave = the open wave,
47
- * the wave's phase = the requested verb). */
48
- ok: boolean;
49
- /** The BLOCK reason kind (present when ok is false). */
50
- reason?: WaveGateReason;
51
- /** The rendered BLOCK message (the vocabulary row, verbatim-filled). */
52
- message?: string;
53
- /** The derived open wave — frontier(closedWaves), ascending (both the split hint
54
- * and the CLI's progress-marking read this). */
55
- open: readonly number[];
56
- /** The open wave's member phases — every task carries the WAVE's single phase
57
- * (the wave-unitary display: one ledger row per wave, never a per-task read). */
58
- phases?: readonly WavePhaseRow[];
59
- }
60
-
61
- /**
62
- * WaveGate — the three-verb unified wave gate (implement / review / fix share the
63
- * single gate). One OOP method: vet(requested, verb) judges the request against
64
- * the derived open wave + the ledger's per-task phases; the CLI calls it before
65
- * ANY task-face dispatch, never a variant gate per verb.
66
- */
67
- export class WaveGate {
68
- /** vet(requested, verb, graph, ledger, words) — the three-verb gate: the verdict
69
- * row the CLI renders (ok → dispatch; a reason + message → the BLOCK face). */
70
- vet(
71
- requested: ReadonlySet<number>,
72
- verb: "implement" | "review" | "fix",
73
- graph: TaskGraph,
74
- ledger: Ledger,
75
- words: Words,
76
- ): WaveVerdict {
77
- const closed = ledger.closedWaves();
78
- const open = [...graph.frontier(closed)].sort((a, b) => a - b);
79
- const asked = [...requested].sort((a, b) => a - b);
80
- const requestedKey = asked.join(",");
81
- const openKey = open.join(",");
82
- const wordsGate = words.waveGateWords();
83
- const exact = asked.length === open.length && asked.every((id, index) => id === open[index]);
84
-
85
- // 1. The split/subset BLOCK — requested ≠ open: a `--tasks` set that splits or
86
- // mismatches the derived wave is refused for ANY verb (a subset never reorders
87
- // the wave, never half-approves it). The full-wave hint rides the message.
88
- if (!exact) {
89
- return {
90
- ok: false,
91
- reason: "split",
92
- message: this.#fill(wordsGate.split, { requested: requestedKey, open: openKey }),
93
- open,
94
- phases: this.#phasesOf(ledger, open),
95
- };
96
- }
97
-
98
- // 2. The open wave's phase — the single phase of the wave's own row (wave-unitary:
99
- // one ledger row per wave, so every member shares the phase; a per-task read
100
- // never matches the wave row — the T26 migration regression).
101
- const phases = this.#phasesOf(ledger, open);
102
- const phase = phases[0]?.phase ?? null;
103
- if (phase !== verb) {
104
- return {
105
- ok: false,
106
- reason: "wrong-phase",
107
- message: this.#fill(wordsGate.wrongPhase, { phase: phase ?? "held" }),
108
- open,
109
- phases,
110
- };
111
- }
112
- return { ok: true, open, phases };
113
- }
114
-
115
- /** The open wave's per-task phases — every member resolves the WAVE row's single
116
- * phase (implement → review → fix → re-review → closure; null = no open round). */
117
- #phasesOf(ledger: Ledger, open: readonly number[]): readonly WavePhaseRow[] {
118
- const waveKey = open.join(",");
119
- const phase = this.#phaseOf(ledger, waveKey);
120
- return open.map((task) => ({ task, phase }));
121
- }
122
-
123
- /** The ledger-derived open phase of ONE wave row — the SINGLE source (D26): the
124
- * wave gate and the lifecycle's frame frontier both read this one method
125
- * (`Ledger#waveLinePhase`), never a per-consumer copy. The wave-unitary read: the
126
- * same C5 round-pair derivation over the wave's own row key (the per-task read
127
- * never matched a `{wave:"16,22,24"}` row — the fix). The D16/T11 revision
128
- * precheck lives in the ledger method (a drifted BRIEF reopens at review; same +
129
- * pending fix stays at fix). */
130
- #phaseOf(ledger: Ledger, waveKey: string): DispatchPhase | null {
131
- return ledger.waveLinePhase(waveKey);
132
- }
133
-
134
- /** The raw fill of one placeholder template — the noun-slot substitution
135
- * ({requested} / {open} / {phase} / {map}); every slot defined, unknown braces kept. */
136
- #fill(template: string, slots: Record<string, string>): string {
137
- return template.replace(/\{(\w+)\}/g, (whole, name: string) => slots[name] ?? whole);
138
- }
139
- }