@oscaner-skills/cdd-engine 3.0.0 → 3.1.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 (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 +149 -0
  15. package/dist/face/cli.js +893 -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 +702 -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 +504 -0
  25. package/dist/face/words.js +258 -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 +453 -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,94 +0,0 @@
1
- // packages/cdd-engine/src-next/__tests__/zero-dep.test.ts
2
- // P3.2 zero-dependency guard (T1 → cutover): during the two-tree coexistence window the
3
- // old tree (src) and the new tree (src-next) had to stay mutually import-free. The
4
- // cutover (T15) deleted the old tree — the guard now pins the post-cutover terminal
5
- // state: the retired planes of this package (the src and config planes) are absent from
6
- // disk, and no src-next module specifier may address them (a dangling reference into a
7
- // deleted plane is a hard violation of the plan's zero-residue constraint). The two-way
8
- // scan becomes one-way: src-next is the only live plane left.
9
-
10
- import { readdirSync, readFileSync } from "node:fs";
11
- import { dirname, join, relative, resolve, sep } from "node:path";
12
- import { fileURLToPath } from "node:url";
13
- import { expect, it } from "vitest";
14
- import { stripComments } from "./support/strip-comments.ts";
15
-
16
- const SRC_NEXT = fileURLToPath(new URL("../", import.meta.url));
17
- const PKG_ROOT = fileURLToPath(new URL("../../", import.meta.url)); // packages/cdd-engine/
18
-
19
- // The retired-plane discriminant: which deleted plane a module specifier addresses.
20
- // The bare dirnames (no trailing slash — a slash-prefixed form would itself trip the
21
- // cutover's zero-residue grep) are the only retired-plane tokens the guard names.
22
- type RetiredPlane = "src" | "config";
23
- const RETIRED_PLANES: readonly RetiredPlane[] = ["src", "config"];
24
-
25
- /** Which retired plane a first path segment names, or null. */
26
- const retiredBySegment = (head: string | undefined): RetiredPlane | null =>
27
- head === "src" || head === "config" ? head : null;
28
-
29
- /** The retired plane a resolved path falls into (by the package-root-relative first
30
- * segment), or null when the path lives in a live plane or outside the package. */
31
- const retiredByResolved = (resolved: string): RetiredPlane | null => {
32
- return retiredBySegment(relative(PKG_ROOT, resolved).split(sep)[0]);
33
- };
34
-
35
- // Module specifier patterns: `from "..."` (static import + re-export), dynamic
36
- // `import("...")`, and side-effect `import "..."`.
37
- const SPECIFIER_PATTERN = /(?:from\s+|import\s*\(\s*)(['"])([^'"]+)\1/g;
38
- const SIDE_EFFECT_PATTERN = /^\s*import\s+(['"])([^'"]+)\1/gm;
39
-
40
- // Comment elision (line + block) with string literals kept verbatim — the shared
41
- // length-preserving stripper (P9 branch-review-1 F4: one stripper for both source
42
- // guards, `./support/strip-comments.ts`), so prose that quotes a `from "../src/x"`
43
- // idiom never trips the guard and its heuristic boundary can never drift apart from
44
- // the structural pin's copy.
45
-
46
- const listTsFiles = (dir: string, files: string[]): string[] => {
47
- for (const entry of readdirSync(dir, { withFileTypes: true })) {
48
- const full = join(dir, entry.name);
49
- if (entry.isDirectory()) listTsFiles(full, files);
50
- else if (entry.name.endsWith(".ts") || entry.name.endsWith(".tsx")) files.push(full);
51
- }
52
- return files;
53
- };
54
-
55
- const extractSpecifiers = (text: string): string[] => {
56
- const specifiers = new Set<string>();
57
- const cleaned = stripComments(text);
58
- for (const match of cleaned.matchAll(SPECIFIER_PATTERN)) specifiers.add(match[2]);
59
- for (const match of cleaned.matchAll(SIDE_EFFECT_PATTERN)) specifiers.add(match[2]);
60
- return [...specifiers];
61
- };
62
-
63
- // Result: the retired plane a module specifier addresses, or null when it addresses
64
- // neither (a live plane, a bare package, a node: builtin, or an external module).
65
- const addressedRetiredPlane = (specifier: string, importer: string): RetiredPlane | null => {
66
- if (!specifier.startsWith("./") && !specifier.startsWith("../") && !specifier.startsWith("/")) {
67
- return retiredBySegment(specifier.split("/")[0]);
68
- }
69
- const resolved = specifier.startsWith("/") ? specifier : resolve(dirname(importer), specifier);
70
- return retiredByResolved(resolved);
71
- };
72
-
73
- it("the retired src and config planes are deleted from the package (the cutover terminal pin)", () => {
74
- const entries = readdirSync(PKG_ROOT);
75
- for (const name of RETIRED_PLANES) {
76
- expect(entries, `deleted plane ${name} must be absent from the package root`).not.toContain(
77
- name,
78
- );
79
- }
80
- });
81
-
82
- it("src-next carries zero module specifiers addressing the retired src or config planes", () => {
83
- const files = listTsFiles(SRC_NEXT, []);
84
- const violations: string[] = [];
85
- for (const file of files) {
86
- for (const specifier of extractSpecifiers(readFileSync(file, "utf8"))) {
87
- const target = addressedRetiredPlane(specifier, file);
88
- if (target !== null) violations.push(`${file} imports "${specifier}"`);
89
- }
90
- }
91
- const message =
92
- violations.length > 0 ? violations.join("\n") : "src-next has no retired-plane references";
93
- expect(violations, message).toEqual([]);
94
- });
@@ -1,256 +0,0 @@
1
- {
2
- "docType": "overall-spec",
3
- "$schema": "https://json-schema.org/draft/2020-12/schema",
4
- "title": "overall-spec document structure",
5
- "description": "Derived JSON Schema — 42 declared elements · 35 required",
6
- "type": "object",
7
- "properties": {
8
- "title": {
9
- "type": "string",
10
- "pattern": "^.+$",
11
- "description": "presence: required · home: frontmatter · ref: none"
12
- },
13
- "doc-type": {
14
- "type": "string",
15
- "pattern": "^(overall-spec|plan|phase-spec|single-spec)$",
16
- "description": "presence: required · home: frontmatter · ref: none"
17
- },
18
- "version": {
19
- "type": "string",
20
- "pattern": "^v\\d+\\.\\d+$",
21
- "description": "presence: required · home: frontmatter · ref: version-lineage"
22
- },
23
- "date": {
24
- "type": "string",
25
- "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
26
- "description": "presence: required · home: frontmatter · ref: none"
27
- },
28
- "status": {
29
- "type": "string",
30
- "pattern": "^(Draft|Approved|In progress|Complete)$",
31
- "description": "presence: required · home: frontmatter · ref: none"
32
- },
33
- "author": {
34
- "type": "string",
35
- "pattern": "^.+$",
36
- "description": "presence: required · home: frontmatter · ref: none"
37
- },
38
- "## Document scope": {
39
- "type": "string",
40
- "pattern": "^## Document scope$",
41
- "description": "presence: required · home: section · ref: none"
42
- },
43
- "## File paths": {
44
- "type": "string",
45
- "pattern": "^## File paths$",
46
- "description": "presence: required · home: section · ref: none"
47
- },
48
- "## Program charter": {
49
- "type": "string",
50
- "pattern": "^## Program charter$",
51
- "description": "presence: required · home: section · ref: none"
52
- },
53
- "## Issue inventory": {
54
- "type": "string",
55
- "pattern": "^## Issue inventory$",
56
- "description": "presence: required · home: section · ref: none"
57
- },
58
- "## Phase inventory": {
59
- "type": "string",
60
- "pattern": "^## Phase inventory$",
61
- "description": "presence: required · home: section · ref: none"
62
- },
63
- "## Dependency graph": {
64
- "type": "string",
65
- "pattern": "^## Dependency graph( \\(ASCII\\))?$",
66
- "description": "presence: required · home: section · ref: none"
67
- },
68
- "## Boundary rules": {
69
- "type": "string",
70
- "pattern": "^## Boundary rules$",
71
- "description": "presence: required · home: section · ref: none"
72
- },
73
- "## Constraints": {
74
- "type": "string",
75
- "pattern": "^## Constraints$",
76
- "description": "presence: required · home: section · ref: none"
77
- },
78
- "Constraint delta bullet": {
79
- "type": "string",
80
- "pattern": "^- ",
81
- "description": "presence: required · home: section · ref: none"
82
- },
83
- "## Maintenance": {
84
- "type": "string",
85
- "pattern": "^## Maintenance$",
86
- "description": "presence: required · home: section · ref: none"
87
- },
88
- "## Change history": {
89
- "type": "string",
90
- "pattern": "^## Change history$",
91
- "description": "presence: required · home: section · ref: none"
92
- },
93
- "### Goal": {
94
- "type": "string",
95
- "pattern": "^### Goal",
96
- "description": "presence: required · home: facet · ref: none"
97
- },
98
- "### Non-goals": {
99
- "type": "string",
100
- "pattern": "^### Non-goals",
101
- "description": "presence: required · home: facet · ref: none"
102
- },
103
- "### Cross-cutting": {
104
- "type": "string",
105
- "pattern": "^### Cross-cutting",
106
- "description": "presence: required · home: facet · ref: none"
107
- },
108
- "#### [MFRBEN] group": {
109
- "type": "string",
110
- "pattern": "^#### [MFRBEN] group",
111
- "description": "presence: optional · home: facet · ref: none"
112
- },
113
- "#### Upstream Endorsements": {
114
- "type": "string",
115
- "pattern": "^#### Upstream Endorsements$",
116
- "description": "presence: optional · home: facet · ref: none"
117
- },
118
- "Issue inventory columns": {
119
- "type": "string",
120
- "pattern": "^\\| Phase \\| Issue \\(ref\\) \\| Title summary \\|$",
121
- "description": "presence: required · home: table · ref: none"
122
- },
123
- "Issue row": {
124
- "type": "string",
125
- "pattern": "^\\|\\s*P\\d+(\\.\\d+)*\\s*\\|",
126
- "description": "presence: required · home: table · ref: issue-ref"
127
- },
128
- "Issue ref cell": {
129
- "type": "string",
130
- "pattern": "^(none|#\\d+|\\[#\\d+\\]|#\\d+#issuecomment-\\d+|([^)]*)|\\([^)]*\\))$",
131
- "description": "presence: required · home: table · ref: issue-ref"
132
- },
133
- "issuecomment anchor": {
134
- "type": "string",
135
- "pattern": "^#\\d+#issuecomment-\\d+$",
136
- "description": "presence: conditional · home: table · ref: issue-ref"
137
- },
138
- "Phase inventory columns": {
139
- "type": "string",
140
- "pattern": "^\\| # \\| Phase \\| Scope \\| Design spec \\| Implementation plan \\| Acceptance criteria \\| Dependency \\|$",
141
- "description": "presence: required · home: table · ref: none"
142
- },
143
- "Phase row": {
144
- "type": "string",
145
- "pattern": "^\\|\\s*P\\d+(\\.\\d+)*\\s*\\|",
146
- "description": "presence: required · home: table · ref: phase-id"
147
- },
148
- "Phase id token": {
149
- "type": "string",
150
- "pattern": "^P\\d+(\\.\\d+)*$",
151
- "description": "presence: required · home: table · ref: phase-id"
152
- },
153
- "Implementation plan cell": {
154
- "type": "string",
155
- "pattern": "^(Pending|\\[Pending\\]|In-flight|\\[In-flight\\]|Done|\\[[^\\]]+\\]\\([^)]+\\))$",
156
- "description": "presence: required · home: table · ref: markdown-link"
157
- },
158
- "Design spec cell": {
159
- "type": "string",
160
- "pattern": "^(\\[[^\\]]+\\]\\([^)]+\\)|P\\d+(\\.\\d+)*-design|Done|\\[Pending\\])$",
161
- "description": "presence: required · home: table · ref: spec-ref"
162
- },
163
- "Dependency cell": {
164
- "type": "string",
165
- "pattern": "^P\\d+(\\.\\d+)*\\s*->",
166
- "description": "presence: required · home: table · ref: phase-id"
167
- },
168
- "Hard edge": {
169
- "type": "string",
170
- "pattern": "^P\\d+(\\.\\d+)*\\s*->\\s*P\\d+(\\.\\d+)*",
171
- "description": "presence: required · home: graph · ref: phase-id"
172
- },
173
- "Soft edge": {
174
- "type": "string",
175
- "pattern": "^P\\d+(\\.\\d+)*\\s*->\\s*\\(?\\s*soft\\s*\\)?",
176
- "description": "presence: optional · home: graph · ref: phase-id"
177
- },
178
- "Graph legend": {
179
- "type": "string",
180
- "pattern": "^(?:- )?`?->\\s*(?:\\(soft\\))?\\s*`? = hard block|^(?:- )?`?->\\s*\\(soft\\)\\s*`? = suggestion only",
181
- "description": "presence: required · home: graph · ref: none"
182
- },
183
- "File path row": {
184
- "type": "string",
185
- "pattern": "^\\| [^|]+ \\| `[^`]+` \\|$",
186
- "description": "presence: required · home: table · ref: none"
187
- },
188
- "Change history row": {
189
- "type": "string",
190
- "pattern": "^\\|\\s*v\\d+\\.\\d+\\s*\\|",
191
- "description": "presence: required · home: table · ref: version-lineage"
192
- },
193
- "Version token": {
194
- "type": "string",
195
- "pattern": "^v\\d+\\.\\d+$",
196
- "description": "presence: required · home: table · ref: version-lineage"
197
- },
198
- "Change history date": {
199
- "type": "string",
200
- "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
201
- "description": "presence: required · home: table · ref: none"
202
- },
203
- "Backfill clause": {
204
- "type": "string",
205
- "pattern": "(Pending|\\[Pending\\])\\s*(→|->)\\s*\\S+",
206
- "description": "presence: conditional · home: table · ref: version-lineage"
207
- },
208
- "Design claim token": {
209
- "type": "string",
210
- "pattern": "^P\\d+(\\.\\d+)*-design$",
211
- "description": "presence: conditional · home: table · ref: spec-ref"
212
- },
213
- "Phase range ref": {
214
- "type": "string",
215
- "pattern": "^P\\d+(\\.\\d+)*\\s*[-–—]\\s*P\\d+(\\.\\d+)*$",
216
- "description": "presence: optional · home: table · ref: phase-id"
217
- }
218
- },
219
- "required": [
220
- "title",
221
- "doc-type",
222
- "version",
223
- "date",
224
- "status",
225
- "author",
226
- "## Document scope",
227
- "## File paths",
228
- "## Program charter",
229
- "## Issue inventory",
230
- "## Phase inventory",
231
- "## Dependency graph",
232
- "## Boundary rules",
233
- "## Constraints",
234
- "Constraint delta bullet",
235
- "## Maintenance",
236
- "## Change history",
237
- "### Goal",
238
- "### Non-goals",
239
- "### Cross-cutting",
240
- "Issue inventory columns",
241
- "Issue row",
242
- "Issue ref cell",
243
- "Phase inventory columns",
244
- "Phase row",
245
- "Phase id token",
246
- "Implementation plan cell",
247
- "Design spec cell",
248
- "Dependency cell",
249
- "Hard edge",
250
- "Graph legend",
251
- "File path row",
252
- "Change history row",
253
- "Version token",
254
- "Change history date"
255
- ]
256
- }
@@ -1,165 +0,0 @@
1
- {
2
- "docType": "phase-spec",
3
- "$schema": "https://json-schema.org/draft/2020-12/schema",
4
- "title": "phase-spec document structure",
5
- "description": "Derived JSON Schema — 27 declared elements · 19 required",
6
- "type": "object",
7
- "properties": {
8
- "title": {
9
- "type": "string",
10
- "pattern": "^.+$",
11
- "description": "presence: required · home: frontmatter · ref: none"
12
- },
13
- "doc-type": {
14
- "type": "string",
15
- "pattern": "^(overall-spec|plan|phase-spec|single-spec)$",
16
- "description": "presence: required · home: frontmatter · ref: none"
17
- },
18
- "version": {
19
- "type": "string",
20
- "pattern": "^v\\d+\\.\\d+$",
21
- "description": "presence: required · home: frontmatter · ref: version-lineage"
22
- },
23
- "date": {
24
- "type": "string",
25
- "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
26
- "description": "presence: required · home: frontmatter · ref: none"
27
- },
28
- "status": {
29
- "type": "string",
30
- "pattern": "^(Draft|Approved|Plan pending|Shipped)$",
31
- "description": "presence: required · home: frontmatter · ref: none"
32
- },
33
- "author": {
34
- "type": "string",
35
- "pattern": "^.+$",
36
- "description": "presence: required · home: frontmatter · ref: none"
37
- },
38
- "parent-program": {
39
- "type": "string",
40
- "pattern": "^.+$",
41
- "description": "presence: required · home: frontmatter · ref: parent-program"
42
- },
43
- "parent-version": {
44
- "type": "string",
45
- "pattern": "^v\\d+\\.\\d+$",
46
- "description": "presence: optional · home: frontmatter · ref: version-lineage"
47
- },
48
- "depends-on": {
49
- "type": "string",
50
- "pattern": "^.+$",
51
- "description": "presence: required · home: frontmatter · ref: none"
52
- },
53
- "## Design": {
54
- "type": "string",
55
- "pattern": "^## Design$",
56
- "description": "presence: required · home: design-body · ref: none"
57
- },
58
- "### N. group heading": {
59
- "type": "string",
60
- "pattern": "^### \\d+\\. ",
61
- "description": "presence: required · home: design-body · ref: none"
62
- },
63
- "#### N.M item heading": {
64
- "type": "string",
65
- "pattern": "^#### \\d+\\.\\d+ ",
66
- "description": "presence: required · home: design-body · ref: none"
67
- },
68
- "### Acceptance criteria": {
69
- "type": "string",
70
- "pattern": "^### Acceptance criteria$",
71
- "description": "presence: required · home: design-body · ref: none"
72
- },
73
- "Acceptance entry": {
74
- "type": "string",
75
- "pattern": "^- `",
76
- "description": "presence: required · home: design-body · ref: none"
77
- },
78
- "## Constraints": {
79
- "type": "string",
80
- "pattern": "^## Constraints$",
81
- "description": "presence: required · home: section · ref: none"
82
- },
83
- "Constraint delta bullet": {
84
- "type": "string",
85
- "pattern": "^- ",
86
- "description": "presence: required · home: section · ref: none"
87
- },
88
- "## Deviations": {
89
- "type": "string",
90
- "pattern": "^## Deviations$",
91
- "description": "presence: conditional · home: conditional · ref: none"
92
- },
93
- "Deviations columns": {
94
- "type": "string",
95
- "pattern": "^\\| Overall assumption \\| Phase decision \\| Overall updated\\? \\|$",
96
- "description": "presence: conditional · home: conditional · ref: none"
97
- },
98
- "Deviations row": {
99
- "type": "string",
100
- "pattern": "^\\|\\s*[^|]+\\s*\\|\\s*[^|]+\\s*\\|\\s*(Yes|No)\\b",
101
- "description": "presence: conditional · home: conditional · ref: none"
102
- },
103
- "Overall updated answer": {
104
- "type": "string",
105
- "pattern": "^Yes",
106
- "description": "presence: conditional · home: conditional · ref: none"
107
- },
108
- "## Incremental warning": {
109
- "type": "string",
110
- "pattern": "^## Incremental warning$",
111
- "description": "presence: conditional · home: conditional · ref: none"
112
- },
113
- "## Notes for downstream": {
114
- "type": "string",
115
- "pattern": "^## Notes for downstream$",
116
- "description": "presence: conditional · home: conditional · ref: none"
117
- },
118
- "## Review record": {
119
- "type": "string",
120
- "pattern": "^## Review record$",
121
- "description": "presence: conditional · home: conditional · ref: none"
122
- },
123
- "## Change history": {
124
- "type": "string",
125
- "pattern": "^## Change history$",
126
- "description": "presence: required · home: section · ref: none"
127
- },
128
- "Change history row": {
129
- "type": "string",
130
- "pattern": "^\\|\\s*v\\d+\\.\\d+\\s*\\|",
131
- "description": "presence: required · home: table · ref: version-lineage"
132
- },
133
- "Version token": {
134
- "type": "string",
135
- "pattern": "^v\\d+\\.\\d+$",
136
- "description": "presence: required · home: table · ref: version-lineage"
137
- },
138
- "Change history date": {
139
- "type": "string",
140
- "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
141
- "description": "presence: required · home: table · ref: none"
142
- }
143
- },
144
- "required": [
145
- "title",
146
- "doc-type",
147
- "version",
148
- "date",
149
- "status",
150
- "author",
151
- "parent-program",
152
- "depends-on",
153
- "## Design",
154
- "### N. group heading",
155
- "#### N.M item heading",
156
- "### Acceptance criteria",
157
- "Acceptance entry",
158
- "## Constraints",
159
- "Constraint delta bullet",
160
- "## Change history",
161
- "Change history row",
162
- "Version token",
163
- "Change history date"
164
- ]
165
- }