@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.
- package/{src-next/bin.ts → dist/bin.js} +18 -21
- package/dist/contract/declare.js +998 -0
- package/dist/contract/doc.js +565 -0
- package/dist/contract/frontmatter.js +209 -0
- package/dist/contract/home-extractors.js +379 -0
- package/dist/contract/invariants.js +1030 -0
- package/dist/contract/judge.js +109 -0
- package/dist/contract/lint.js +206 -0
- package/dist/contract/project.js +371 -0
- package/dist/contract/skill-anatomy.js +156 -0
- package/dist/contract/translate.js +85 -0
- package/dist/face/artifacts.js +189 -0
- package/dist/face/board-view.js +522 -0
- package/dist/face/capsule.js +141 -0
- package/dist/face/cli.js +891 -0
- package/dist/face/declare.js +241 -0
- package/dist/face/gate.js +158 -0
- package/dist/face/graph-view.js +66 -0
- package/dist/face/host.js +211 -0
- package/dist/face/lifecycle.js +603 -0
- package/dist/face/preview.js +136 -0
- package/dist/face/projection.js +259 -0
- package/dist/face/route-render.js +162 -0
- package/dist/face/termination.js +482 -0
- package/dist/face/words.js +220 -0
- package/{src-next/infra/config.ts → dist/infra/config.js} +19 -24
- package/{src-next/infra/doc-roots.ts → dist/infra/doc-roots.js} +3 -13
- package/dist/infra/git.js +37 -0
- package/dist/infra/process.js +22 -0
- package/{src-next/infra/root.ts → dist/infra/root.js} +25 -36
- package/dist/infra/runtime.js +85 -0
- package/dist/infra/workspace.js +276 -0
- package/dist/render/brief.js +82 -0
- package/dist/render/issue-body.js +129 -0
- package/dist/render/skeleton.js +434 -0
- package/dist/render/templates.js +520 -0
- package/dist/session/faces.js +38 -0
- package/dist/session/graph.js +309 -0
- package/dist/session/handoff-schema.js +295 -0
- package/dist/session/ledger.js +762 -0
- package/dist/session/next.js +211 -0
- package/dist/session/preflight.js +194 -0
- package/dist/session/round-naming.js +73 -0
- package/dist/session/run.js +441 -0
- package/dist/session/state.js +8 -0
- package/dist/session/wave.js +92 -0
- package/package.json +5 -5
- package/src-next/__tests__/bin.test.ts +0 -128
- package/src-next/__tests__/dead-decl.guard.test.ts +0 -39
- package/src-next/__tests__/floor.guard.test.ts +0 -69
- package/src-next/__tests__/issue-body.guard.test.ts +0 -66
- package/src-next/__tests__/phase-suffix.guard.test.ts +0 -72
- package/src-next/__tests__/smoke.integration.test.ts +0 -185
- package/src-next/__tests__/support/strip-comments.ts +0 -99
- package/src-next/__tests__/zero-dep.test.ts +0 -94
- package/src-next/contract/__tests__/__snapshots__/project.schema.overall-spec.snap +0 -256
- package/src-next/contract/__tests__/__snapshots__/project.schema.phase-spec.snap +0 -165
- package/src-next/contract/__tests__/__snapshots__/project.schema.plan.snap +0 -190
- package/src-next/contract/__tests__/__snapshots__/project.schema.single-spec.snap +0 -106
- package/src-next/contract/__tests__/__snapshots__/project.shape.overall-spec.snap +0 -240
- package/src-next/contract/__tests__/__snapshots__/project.shape.phase-spec.snap +0 -165
- package/src-next/contract/__tests__/__snapshots__/project.shape.plan.snap +0 -190
- package/src-next/contract/__tests__/__snapshots__/project.shape.single-spec.snap +0 -100
- package/src-next/contract/__tests__/declare.test.ts +0 -481
- package/src-next/contract/__tests__/doc.test.ts +0 -527
- package/src-next/contract/__tests__/dockey.guard.test.ts +0 -58
- package/src-next/contract/__tests__/edge-conditions.guard.test.ts +0 -81
- package/src-next/contract/__tests__/frontmatter.test.ts +0 -164
- package/src-next/contract/__tests__/judge.test.ts +0 -1111
- package/src-next/contract/__tests__/lint.test.ts +0 -324
- package/src-next/contract/__tests__/project.test.ts +0 -460
- package/src-next/contract/__tests__/structure-pin.test.ts +0 -186
- package/src-next/contract/__tests__/translate.test.ts +0 -96
- package/src-next/contract/declare.ts +0 -1071
- package/src-next/contract/doc.ts +0 -816
- package/src-next/contract/frontmatter.ts +0 -233
- package/src-next/contract/home-extractors.ts +0 -397
- package/src-next/contract/invariants.ts +0 -1413
- package/src-next/contract/judge.ts +0 -151
- package/src-next/contract/lint.ts +0 -239
- package/src-next/contract/project.ts +0 -656
- package/src-next/contract/skill-anatomy.ts +0 -301
- package/src-next/contract/translate.ts +0 -113
- package/src-next/face/__tests__/board-view.test.ts +0 -1151
- package/src-next/face/__tests__/capsule.test.ts +0 -300
- package/src-next/face/__tests__/channel-closure.guard.test.ts +0 -129
- package/src-next/face/__tests__/cli.test.ts +0 -4897
- package/src-next/face/__tests__/face.test.ts +0 -289
- package/src-next/face/__tests__/graph-view.test.ts +0 -61
- package/src-next/face/__tests__/host.test.ts +0 -24
- package/src-next/face/__tests__/install-rows.guard.test.ts +0 -58
- package/src-next/face/__tests__/negation.ts +0 -6
- package/src-next/face/__tests__/preview.test.ts +0 -374
- package/src-next/face/__tests__/projection.test.ts +0 -303
- package/src-next/face/__tests__/repo-root.guard.test.ts +0 -120
- package/src-next/face/__tests__/termination.test.ts +0 -650
- package/src-next/face/__tests__/words.guard.test.ts +0 -93
- package/src-next/face/artifacts.ts +0 -248
- package/src-next/face/board-view.ts +0 -652
- package/src-next/face/capsule.ts +0 -163
- package/src-next/face/cli.ts +0 -1028
- package/src-next/face/declare.ts +0 -323
- package/src-next/face/gate.ts +0 -171
- package/src-next/face/graph-view.ts +0 -74
- package/src-next/face/host.ts +0 -302
- package/src-next/face/lifecycle.ts +0 -725
- package/src-next/face/preview.ts +0 -151
- package/src-next/face/projection.ts +0 -285
- package/src-next/face/route-render.ts +0 -185
- package/src-next/face/termination.ts +0 -573
- package/src-next/face/words.ts +0 -314
- package/src-next/infra/__tests__/infra.test.ts +0 -333
- package/src-next/infra/__tests__/root.test.ts +0 -56
- package/src-next/infra/git.ts +0 -39
- package/src-next/infra/process.ts +0 -34
- package/src-next/infra/runtime.ts +0 -132
- package/src-next/infra/workspace.ts +0 -322
- package/src-next/render/__tests__/render.test.ts +0 -550
- package/src-next/render/__tests__/skeleton.test.ts +0 -684
- package/src-next/render/brief.ts +0 -121
- package/src-next/render/issue-body.ts +0 -162
- package/src-next/render/skeleton.ts +0 -502
- package/src-next/render/templates.ts +0 -645
- package/src-next/session/__tests__/graph.test.ts +0 -277
- package/src-next/session/__tests__/handoff-plane.guard.test.ts +0 -48
- package/src-next/session/__tests__/handoff-schema.test.ts +0 -310
- package/src-next/session/__tests__/ledger.test.ts +0 -745
- package/src-next/session/__tests__/next.test.ts +0 -460
- package/src-next/session/__tests__/preflight.test.ts +0 -545
- package/src-next/session/__tests__/round-naming.test.ts +0 -142
- package/src-next/session/__tests__/run.test.ts +0 -1026
- package/src-next/session/__tests__/wave-line-phase.guard.test.ts +0 -49
- package/src-next/session/__tests__/wave.test.ts +0 -476
- package/src-next/session/faces.ts +0 -110
- package/src-next/session/graph.ts +0 -411
- package/src-next/session/handoff-schema.ts +0 -373
- package/src-next/session/ledger.ts +0 -1076
- package/src-next/session/next.ts +0 -293
- package/src-next/session/preflight.ts +0 -271
- package/src-next/session/round-naming.ts +0 -84
- package/src-next/session/run.ts +0 -610
- package/src-next/session/state.ts +0 -30
- 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
|
-
}
|