@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,164 +0,0 @@
1
- // packages/cdd-engine/src-next/contract/__tests__/frontmatter.test.ts
2
- // T1 test suite for the front-matter head extraction chain (contract/frontmatter.ts):
3
- // · the `---` fence split — the head/body boundary, the no-fence fallback;
4
- // · the non-scalar downgrade — a list value reads null through the accessor;
5
- // · the RAW channel — the extracted value equals the source string verbatim;
6
- // · the twelve declared getters map the §2.3 key set.
7
-
8
- import { describe, expect, it } from "vitest";
9
- import { FrontMatterExtractor, FrontMatterHead } from "../frontmatter.ts";
10
-
11
- /** The full §2.1 plan-shaped front matter — every one of the twelve declared keys. */
12
- const FULL_HEAD = [
13
- "---",
14
- "title: 引擎文档工具(Engine Doc-Tooling)— 测试 Plan",
15
- "doc-type: plan",
16
- "version: v0.9",
17
- "date: 2026-10-17",
18
- "spec: docs/kairos/specs/2026-10-10-engine-doc-tooling-p10-design.md",
19
- "parent-program: docs/kairos/specs/2026-10-10-engine-doc-tooling-overall.md",
20
- "parent-version: v2.46",
21
- "depends-on: P9",
22
- "base: develop",
23
- "status: Draft",
24
- 'author: "[human] · Claude Opus 5(…)"',
25
- "issues: close all issues",
26
- "---",
27
- "## Design",
28
- "body prose",
29
- ].join("\n");
30
-
31
- describe("FrontMatterExtractor.split — the fence split", () => {
32
- it("splits a fenced head from the body at the second `---` fence", () => {
33
- const { head, body } = FrontMatterExtractor.split(FULL_HEAD);
34
- expect(body).toBe("## Design\nbody prose");
35
- expect(head.title).toBe("引擎文档工具(Engine Doc-Tooling)— 测试 Plan");
36
- expect(head.docType).toBe("plan");
37
- });
38
-
39
- it("returns a null head and the original content when no opening fence is on line zero", () => {
40
- const content = "no fence here\nbody line";
41
- const { head, body } = FrontMatterExtractor.split(content);
42
- expect(body).toBe(content);
43
- expect(head.title).toBeNull();
44
- for (const key of [
45
- "title",
46
- "doc-type",
47
- "version",
48
- "date",
49
- "status",
50
- "author",
51
- "spec",
52
- "parent-program",
53
- "parent-version",
54
- "depends-on",
55
- "base",
56
- "issues",
57
- ])
58
- expect(head.value(key)).toBeNull();
59
- });
60
-
61
- it("returns a null head and the original content when the closing fence is missing", () => {
62
- const content = "---\ntitle: dangling\nbody line";
63
- const { head, body } = FrontMatterExtractor.split(content);
64
- expect(body).toBe(content);
65
- expect(head.value("title")).toBeNull();
66
- });
67
-
68
- it("returns a null head and the original content when the fenced block is not a YAML record", () => {
69
- const content = "---\n- a\n- b\n---\nbody line";
70
- const { head, body } = FrontMatterExtractor.split(content);
71
- expect(body).toBe(content);
72
- expect(head.value("title")).toBeNull();
73
- });
74
-
75
- it("returns a null head and the original content when the fenced YAML fails to parse", () => {
76
- const content = "---\n: bad : yaml\n---\nbody line";
77
- const { head, body } = FrontMatterExtractor.split(content);
78
- expect(body).toBe(content);
79
- expect(head.value("title")).toBeNull();
80
- });
81
-
82
- it("carries the typed parse error with its position for the fill-class failure (D1 · #341 — a `[`-led value is a YAML flow sequence)", () => {
83
- const content = "---\nauthor: [human] · Claude Opus 5\ndoc-type: phase-spec\n---\nbody";
84
- const { head, body } = FrontMatterExtractor.split(content);
85
- // the failure never collapses into a bare null head — the error rides along
86
- expect(body).toBe(content);
87
- expect(head.value("doc-type")).toBeNull();
88
- const err = head.parseError;
89
- expect(err).not.toBeNull();
90
- expect(err?.line).toBe(1);
91
- expect(err?.column).toBeGreaterThan(0);
92
- expect(err?.reason).toContain("Unexpected scalar");
93
- // the source excerpt is the offending front-matter line itself
94
- expect(err?.source).toBe("author: [human] · Claude Opus 5");
95
- });
96
- });
97
-
98
- describe("FrontMatterHead.value — the typed accessor", () => {
99
- const { head } = FrontMatterExtractor.split(FULL_HEAD);
100
-
101
- it("reads every declared scalar key through value(key)", () => {
102
- expect(head.value("title")).toBe("引擎文档工具(Engine Doc-Tooling)— 测试 Plan");
103
- expect(head.value("version")).toBe("v0.9");
104
- expect(head.value("depends-on")).toBe("P9");
105
- expect(head.value("base")).toBe("develop");
106
- expect(head.value("issues")).toBe("close all issues");
107
- });
108
-
109
- it("downgrades a non-scalar YAML value to null (a list is not a head fact)", () => {
110
- const { head: listHead } = FrontMatterExtractor.split(
111
- "---\ntitle: test\nissues:\n - a\n - b\n---\nbody",
112
- );
113
- expect(listHead.value("issues")).toBeNull();
114
- expect(listHead.value("title")).toBe("test");
115
- });
116
-
117
- it("downgrades a non-string scalar (a bare number) to null", () => {
118
- const { head: numberHead } = FrontMatterExtractor.split("---\nversion: 2.46\n---\nbody");
119
- expect(numberHead.value("version")).toBeNull();
120
- });
121
- });
122
-
123
- describe("the RAW channel — extraction matches the source verbatim", () => {
124
- it("reads a bracket-led author value byte-for-byte from the source string", () => {
125
- const { head } = FrontMatterExtractor.split(FULL_HEAD);
126
- expect(head.author).toBe("[human] · Claude Opus 5(…)");
127
- expect(head.value("author")).toBe(head.author);
128
- });
129
- });
130
-
131
- describe("the twelve declared getters (§2.3 key set)", () => {
132
- const { head } = FrontMatterExtractor.split(FULL_HEAD);
133
-
134
- it("exposes the kebab keys through the getter surface", () => {
135
- expect(head.title).toBe("引擎文档工具(Engine Doc-Tooling)— 测试 Plan");
136
- expect(head.docType).toBe("plan");
137
- expect(head.version).toBe("v0.9");
138
- expect(head.date).toBe("2026-10-17");
139
- expect(head.status).toBe("Draft");
140
- expect(head.author).toBe("[human] · Claude Opus 5(…)");
141
- expect(head.spec).toBe("docs/kairos/specs/2026-10-10-engine-doc-tooling-p10-design.md");
142
- expect(head.parentProgram).toBe("docs/kairos/specs/2026-10-10-engine-doc-tooling-overall.md");
143
- expect(head.parentVersion).toBe("v2.46");
144
- expect(head.dependsOn).toBe("P9");
145
- expect(head.base).toBe("develop");
146
- expect(head.issues).toBe("close all issues");
147
- });
148
-
149
- it("reads null for every getter on an empty head", () => {
150
- const empty = new FrontMatterHead(null);
151
- expect(empty.title).toBeNull();
152
- expect(empty.docType).toBeNull();
153
- expect(empty.version).toBeNull();
154
- expect(empty.date).toBeNull();
155
- expect(empty.status).toBeNull();
156
- expect(empty.author).toBeNull();
157
- expect(empty.spec).toBeNull();
158
- expect(empty.parentProgram).toBeNull();
159
- expect(empty.parentVersion).toBeNull();
160
- expect(empty.dependsOn).toBeNull();
161
- expect(empty.base).toBeNull();
162
- expect(empty.issues).toBeNull();
163
- });
164
- });