@oscaner-skills/cdd-engine 1.0.0 → 2.0.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 (99) hide show
  1. package/README.md +9 -8
  2. package/README.zh-CN.md +9 -8
  3. package/package.json +15 -22
  4. package/src-next/__tests__/bin.test.ts +128 -0
  5. package/src-next/__tests__/smoke.integration.test.ts +202 -0
  6. package/src-next/__tests__/zero-dep.test.ts +134 -0
  7. package/src-next/bin.ts +61 -0
  8. package/src-next/contract/__tests__/__snapshots__/project.schema.overall-spec.snap +238 -0
  9. package/src-next/contract/__tests__/__snapshots__/project.schema.phase-spec.snap +153 -0
  10. package/src-next/contract/__tests__/__snapshots__/project.schema.plan.snap +173 -0
  11. package/src-next/contract/__tests__/__snapshots__/project.schema.single-spec.snap +89 -0
  12. package/src-next/contract/__tests__/__snapshots__/project.shape.overall-spec.snap +225 -0
  13. package/src-next/contract/__tests__/__snapshots__/project.shape.phase-spec.snap +155 -0
  14. package/src-next/contract/__tests__/__snapshots__/project.shape.plan.snap +175 -0
  15. package/src-next/contract/__tests__/__snapshots__/project.shape.single-spec.snap +85 -0
  16. package/src-next/contract/__tests__/declare.test.ts +242 -0
  17. package/src-next/contract/__tests__/doc.test.ts +358 -0
  18. package/src-next/contract/__tests__/judge.test.ts +873 -0
  19. package/src-next/contract/__tests__/lint.test.ts +314 -0
  20. package/src-next/contract/__tests__/project.test.ts +419 -0
  21. package/src-next/contract/__tests__/translate.test.ts +96 -0
  22. package/src-next/contract/declare.ts +983 -0
  23. package/src-next/contract/doc.ts +753 -0
  24. package/src-next/contract/invariants.ts +1268 -0
  25. package/src-next/contract/judge.ts +142 -0
  26. package/src-next/contract/lint.ts +275 -0
  27. package/src-next/contract/project.ts +596 -0
  28. package/src-next/contract/skill-anatomy.ts +273 -0
  29. package/src-next/contract/translate.ts +113 -0
  30. package/src-next/face/__tests__/board-view.test.ts +948 -0
  31. package/src-next/face/__tests__/capsule.test.ts +276 -0
  32. package/src-next/face/__tests__/channel-closure.guard.test.ts +102 -0
  33. package/src-next/face/__tests__/cli.test.ts +4643 -0
  34. package/src-next/face/__tests__/face.test.ts +289 -0
  35. package/src-next/face/__tests__/graph-view.test.ts +61 -0
  36. package/src-next/face/__tests__/host.test.ts +24 -0
  37. package/src-next/face/__tests__/negation.ts +6 -0
  38. package/src-next/face/__tests__/projection.test.ts +301 -0
  39. package/src-next/face/__tests__/sync-runner.test.ts +70 -0
  40. package/src-next/face/__tests__/words.guard.test.ts +93 -0
  41. package/src-next/face/artifacts.ts +195 -0
  42. package/src-next/face/board-view.ts +662 -0
  43. package/src-next/face/capsule.ts +149 -0
  44. package/src-next/face/cli.ts +819 -0
  45. package/src-next/face/declare.ts +326 -0
  46. package/src-next/face/gate.ts +170 -0
  47. package/src-next/face/graph-view.ts +74 -0
  48. package/src-next/face/host.ts +326 -0
  49. package/src-next/face/lifecycle.ts +700 -0
  50. package/src-next/face/projection.ts +282 -0
  51. package/src-next/face/route-render.ts +160 -0
  52. package/src-next/face/words.ts +296 -0
  53. package/src-next/infra/__tests__/infra.test.ts +287 -0
  54. package/src-next/infra/config.ts +42 -0
  55. package/src-next/infra/git.ts +39 -0
  56. package/src-next/infra/process.ts +34 -0
  57. package/src-next/infra/runtime.ts +185 -0
  58. package/src-next/infra/workspace.ts +232 -0
  59. package/src-next/render/__tests__/render.test.ts +499 -0
  60. package/src-next/render/__tests__/skeleton.test.ts +466 -0
  61. package/src-next/render/brief.ts +121 -0
  62. package/src-next/render/issue-body.ts +159 -0
  63. package/src-next/render/skeleton.ts +437 -0
  64. package/src-next/render/templates.ts +650 -0
  65. package/src-next/session/__tests__/graph.test.ts +270 -0
  66. package/src-next/session/__tests__/handoff-plane.guard.test.ts +48 -0
  67. package/src-next/session/__tests__/handoff-schema.test.ts +310 -0
  68. package/src-next/session/__tests__/ledger.test.ts +744 -0
  69. package/src-next/session/__tests__/next.test.ts +368 -0
  70. package/src-next/session/__tests__/preflight.test.ts +491 -0
  71. package/src-next/session/__tests__/run.test.ts +1014 -0
  72. package/src-next/session/__tests__/wave-line-phase.guard.test.ts +49 -0
  73. package/src-next/session/__tests__/wave.test.ts +469 -0
  74. package/src-next/session/faces.ts +110 -0
  75. package/src-next/session/graph.ts +411 -0
  76. package/src-next/session/handoff-schema.ts +373 -0
  77. package/src-next/session/ledger.ts +1004 -0
  78. package/src-next/session/next.ts +192 -0
  79. package/src-next/session/preflight.ts +240 -0
  80. package/src-next/session/run.ts +606 -0
  81. package/src-next/session/state.ts +30 -0
  82. package/src-next/session/wave.ts +139 -0
  83. package/templates/report/issue-body.json +18 -20
  84. package/dist/chunks/branch.mjs +0 -480
  85. package/dist/chunks/docs.mjs +0 -253
  86. package/dist/chunks/task.mjs +0 -913
  87. package/dist/cli.mjs +0 -5457
  88. package/dist/documents/schema/add-phase-protocol.json +0 -126
  89. package/dist/documents/schema/overall.json +0 -361
  90. package/dist/documents/schema/phase-spec.json +0 -145
  91. package/dist/documents/schema/plan.json +0 -191
  92. package/dist/documents/schema/skill-anatomy.json +0 -233
  93. package/dist/resources/harness-registry.json +0 -49
  94. package/dist/shared/cdd-engine.liioziig.mjs +0 -184
  95. package/templates/engine-config.json +0 -302
  96. package/templates/schema/cache-profile-schema.json +0 -23
  97. package/templates/schema/docs-handoff-schema.json +0 -129
  98. package/templates/schema/task-handoff-schema.json +0 -332
  99. package/templates/template-contract.json +0 -231
@@ -0,0 +1,89 @@
1
+ {
2
+ "docType": "single-spec",
3
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
4
+ "title": "single-spec document structure",
5
+ "description": "Derived JSON Schema — 13 declared elements · 13 required",
6
+ "type": "object",
7
+ "properties": {
8
+ "# Title": {
9
+ "type": "string",
10
+ "pattern": "^# \\S.*$",
11
+ "description": "presence: required · home: header · ref: none"
12
+ },
13
+ "**Version**": {
14
+ "type": "string",
15
+ "pattern": "^- \\*\\*Version\\*\\*: v\\d+\\.\\d+ · \\d{4}-\\d{2}-\\d{2}$",
16
+ "description": "presence: required · home: header · ref: version-lineage"
17
+ },
18
+ "**Status**": {
19
+ "type": "string",
20
+ "pattern": "^- \\*\\*Status\\*\\*: (Draft|Approved|In progress|Complete)$",
21
+ "description": "presence: required · home: header · ref: none"
22
+ },
23
+ "**Author**": {
24
+ "type": "string",
25
+ "pattern": "^- \\*\\*Author\\*\\*:",
26
+ "description": "presence: required · home: header · ref: none"
27
+ },
28
+ "**Depends on**": {
29
+ "type": "string",
30
+ "pattern": "^- \\*\\*Depends on\\*\\*:",
31
+ "description": "presence: required · home: header · ref: none"
32
+ },
33
+ "## Background & root cause": {
34
+ "type": "string",
35
+ "pattern": "^## Background & root cause$",
36
+ "description": "presence: required · home: section · ref: none"
37
+ },
38
+ "## Design decisions": {
39
+ "type": "string",
40
+ "pattern": "^## Design decisions$",
41
+ "description": "presence: required · home: section · ref: none"
42
+ },
43
+ "## Acceptance": {
44
+ "type": "string",
45
+ "pattern": "^## Acceptance$",
46
+ "description": "presence: required · home: section · ref: none"
47
+ },
48
+ "## Constraints": {
49
+ "type": "string",
50
+ "pattern": "^## Constraints$",
51
+ "description": "presence: required · home: section · ref: none"
52
+ },
53
+ "## Change history": {
54
+ "type": "string",
55
+ "pattern": "^## Change history$",
56
+ "description": "presence: required · home: section · ref: none"
57
+ },
58
+ "Change history row": {
59
+ "type": "string",
60
+ "pattern": "^\\|\\s*v\\d+\\.\\d+\\s*\\|",
61
+ "description": "presence: required · home: table · ref: version-lineage"
62
+ },
63
+ "Version token": {
64
+ "type": "string",
65
+ "pattern": "^v\\d+\\.\\d+$",
66
+ "description": "presence: required · home: table · ref: version-lineage"
67
+ },
68
+ "Change history date": {
69
+ "type": "string",
70
+ "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
71
+ "description": "presence: required · home: table · ref: none"
72
+ }
73
+ },
74
+ "required": [
75
+ "# Title",
76
+ "**Version**",
77
+ "**Status**",
78
+ "**Author**",
79
+ "**Depends on**",
80
+ "## Background & root cause",
81
+ "## Design decisions",
82
+ "## Acceptance",
83
+ "## Constraints",
84
+ "## Change history",
85
+ "Change history row",
86
+ "Version token",
87
+ "Change history date"
88
+ ]
89
+ }
@@ -0,0 +1,225 @@
1
+ {
2
+ "docType": "overall-spec",
3
+ "structure": [
4
+ {
5
+ "home": "header",
6
+ "elements": [
7
+ {
8
+ "anchor": "# Title",
9
+ "presence": "required",
10
+ "refKind": "none"
11
+ },
12
+ {
13
+ "anchor": "**Version**",
14
+ "presence": "required",
15
+ "refKind": "version-lineage"
16
+ },
17
+ {
18
+ "anchor": "**Status**",
19
+ "presence": "required",
20
+ "refKind": "none"
21
+ },
22
+ {
23
+ "anchor": "**Author**",
24
+ "presence": "required",
25
+ "refKind": "none"
26
+ },
27
+ {
28
+ "anchor": "**Constraints**",
29
+ "presence": "required",
30
+ "refKind": "none"
31
+ }
32
+ ]
33
+ },
34
+ {
35
+ "home": "section",
36
+ "elements": [
37
+ {
38
+ "anchor": "## Document scope",
39
+ "presence": "required",
40
+ "refKind": "none"
41
+ },
42
+ {
43
+ "anchor": "## File paths",
44
+ "presence": "required",
45
+ "refKind": "none"
46
+ },
47
+ {
48
+ "anchor": "## Program charter",
49
+ "presence": "required",
50
+ "refKind": "none"
51
+ },
52
+ {
53
+ "anchor": "## Issue inventory",
54
+ "presence": "required",
55
+ "refKind": "none"
56
+ },
57
+ {
58
+ "anchor": "## Phase inventory",
59
+ "presence": "required",
60
+ "refKind": "none"
61
+ },
62
+ {
63
+ "anchor": "## Dependency graph",
64
+ "presence": "required",
65
+ "refKind": "none"
66
+ },
67
+ {
68
+ "anchor": "## Boundary rules",
69
+ "presence": "required",
70
+ "refKind": "none"
71
+ },
72
+ {
73
+ "anchor": "## Maintenance",
74
+ "presence": "required",
75
+ "refKind": "none"
76
+ },
77
+ {
78
+ "anchor": "## Change history",
79
+ "presence": "required",
80
+ "refKind": "none"
81
+ }
82
+ ]
83
+ },
84
+ {
85
+ "home": "facet",
86
+ "elements": [
87
+ {
88
+ "anchor": "### Goal",
89
+ "presence": "required",
90
+ "refKind": "none"
91
+ },
92
+ {
93
+ "anchor": "### Non-goals",
94
+ "presence": "required",
95
+ "refKind": "none"
96
+ },
97
+ {
98
+ "anchor": "### Cross-cutting",
99
+ "presence": "required",
100
+ "refKind": "none"
101
+ },
102
+ {
103
+ "anchor": "#### [MFRBEN] group",
104
+ "presence": "optional",
105
+ "refKind": "none"
106
+ },
107
+ {
108
+ "anchor": "#### Upstream Endorsements",
109
+ "presence": "optional",
110
+ "refKind": "none"
111
+ }
112
+ ]
113
+ },
114
+ {
115
+ "home": "table",
116
+ "elements": [
117
+ {
118
+ "anchor": "Issue inventory columns",
119
+ "presence": "required",
120
+ "refKind": "none"
121
+ },
122
+ {
123
+ "anchor": "Issue row",
124
+ "presence": "required",
125
+ "refKind": "issue-ref"
126
+ },
127
+ {
128
+ "anchor": "Issue ref cell",
129
+ "presence": "required",
130
+ "refKind": "issue-ref"
131
+ },
132
+ {
133
+ "anchor": "issuecomment anchor",
134
+ "presence": "conditional",
135
+ "refKind": "issue-ref"
136
+ },
137
+ {
138
+ "anchor": "Phase inventory columns",
139
+ "presence": "required",
140
+ "refKind": "none"
141
+ },
142
+ {
143
+ "anchor": "Phase row",
144
+ "presence": "required",
145
+ "refKind": "phase-id"
146
+ },
147
+ {
148
+ "anchor": "Phase id token",
149
+ "presence": "required",
150
+ "refKind": "phase-id"
151
+ },
152
+ {
153
+ "anchor": "Implementation plan cell",
154
+ "presence": "required",
155
+ "refKind": "markdown-link"
156
+ },
157
+ {
158
+ "anchor": "Design spec cell",
159
+ "presence": "required",
160
+ "refKind": "spec-ref"
161
+ },
162
+ {
163
+ "anchor": "Dependency cell",
164
+ "presence": "required",
165
+ "refKind": "phase-id"
166
+ },
167
+ {
168
+ "anchor": "File path row",
169
+ "presence": "required",
170
+ "refKind": "none"
171
+ },
172
+ {
173
+ "anchor": "Change history row",
174
+ "presence": "required",
175
+ "refKind": "version-lineage"
176
+ },
177
+ {
178
+ "anchor": "Version token",
179
+ "presence": "required",
180
+ "refKind": "version-lineage"
181
+ },
182
+ {
183
+ "anchor": "Change history date",
184
+ "presence": "required",
185
+ "refKind": "none"
186
+ },
187
+ {
188
+ "anchor": "Backfill clause",
189
+ "presence": "conditional",
190
+ "refKind": "version-lineage"
191
+ },
192
+ {
193
+ "anchor": "Design claim token",
194
+ "presence": "conditional",
195
+ "refKind": "spec-ref"
196
+ },
197
+ {
198
+ "anchor": "Phase range ref",
199
+ "presence": "optional",
200
+ "refKind": "phase-id"
201
+ }
202
+ ]
203
+ },
204
+ {
205
+ "home": "graph",
206
+ "elements": [
207
+ {
208
+ "anchor": "Hard edge",
209
+ "presence": "required",
210
+ "refKind": "phase-id"
211
+ },
212
+ {
213
+ "anchor": "Soft edge",
214
+ "presence": "optional",
215
+ "refKind": "phase-id"
216
+ },
217
+ {
218
+ "anchor": "Graph legend",
219
+ "presence": "required",
220
+ "refKind": "none"
221
+ }
222
+ ]
223
+ }
224
+ ]
225
+ }
@@ -0,0 +1,155 @@
1
+ {
2
+ "docType": "phase-spec",
3
+ "structure": [
4
+ {
5
+ "home": "header",
6
+ "elements": [
7
+ {
8
+ "anchor": "# Title",
9
+ "presence": "required",
10
+ "refKind": "none"
11
+ },
12
+ {
13
+ "anchor": "**Version**",
14
+ "presence": "required",
15
+ "refKind": "version-lineage"
16
+ },
17
+ {
18
+ "anchor": "**Status**",
19
+ "presence": "required",
20
+ "refKind": "none"
21
+ },
22
+ {
23
+ "anchor": "**Author**",
24
+ "presence": "required",
25
+ "refKind": "none"
26
+ },
27
+ {
28
+ "anchor": "**Parent program**",
29
+ "presence": "required",
30
+ "refKind": "parent-program"
31
+ },
32
+ {
33
+ "anchor": "**Depends on**",
34
+ "presence": "required",
35
+ "refKind": "none"
36
+ },
37
+ {
38
+ "anchor": "Depends on ref",
39
+ "presence": "conditional",
40
+ "refKind": "phase-id"
41
+ }
42
+ ]
43
+ },
44
+ {
45
+ "home": "design-body",
46
+ "elements": [
47
+ {
48
+ "anchor": "## Design",
49
+ "presence": "required",
50
+ "refKind": "none"
51
+ },
52
+ {
53
+ "anchor": "### N. group heading",
54
+ "presence": "required",
55
+ "refKind": "none"
56
+ },
57
+ {
58
+ "anchor": "#### N.M item heading",
59
+ "presence": "required",
60
+ "refKind": "none"
61
+ },
62
+ {
63
+ "anchor": "### Acceptance criteria",
64
+ "presence": "required",
65
+ "refKind": "none"
66
+ },
67
+ {
68
+ "anchor": "Acceptance entry",
69
+ "presence": "required",
70
+ "refKind": "none"
71
+ }
72
+ ]
73
+ },
74
+ {
75
+ "home": "section",
76
+ "elements": [
77
+ {
78
+ "anchor": "## Constraints",
79
+ "presence": "required",
80
+ "refKind": "none"
81
+ },
82
+ {
83
+ "anchor": "Constraint delta bullet",
84
+ "presence": "required",
85
+ "refKind": "none"
86
+ },
87
+ {
88
+ "anchor": "## Change history",
89
+ "presence": "required",
90
+ "refKind": "none"
91
+ }
92
+ ]
93
+ },
94
+ {
95
+ "home": "conditional",
96
+ "elements": [
97
+ {
98
+ "anchor": "## Deviations",
99
+ "presence": "conditional",
100
+ "refKind": "none"
101
+ },
102
+ {
103
+ "anchor": "Deviations columns",
104
+ "presence": "conditional",
105
+ "refKind": "none"
106
+ },
107
+ {
108
+ "anchor": "Deviations row",
109
+ "presence": "conditional",
110
+ "refKind": "none"
111
+ },
112
+ {
113
+ "anchor": "Overall updated answer",
114
+ "presence": "conditional",
115
+ "refKind": "none"
116
+ },
117
+ {
118
+ "anchor": "## Incremental warning",
119
+ "presence": "conditional",
120
+ "refKind": "none"
121
+ },
122
+ {
123
+ "anchor": "## Notes for downstream",
124
+ "presence": "conditional",
125
+ "refKind": "none"
126
+ },
127
+ {
128
+ "anchor": "## Review record",
129
+ "presence": "conditional",
130
+ "refKind": "none"
131
+ }
132
+ ]
133
+ },
134
+ {
135
+ "home": "table",
136
+ "elements": [
137
+ {
138
+ "anchor": "Change history row",
139
+ "presence": "required",
140
+ "refKind": "version-lineage"
141
+ },
142
+ {
143
+ "anchor": "Version token",
144
+ "presence": "required",
145
+ "refKind": "version-lineage"
146
+ },
147
+ {
148
+ "anchor": "Change history date",
149
+ "presence": "required",
150
+ "refKind": "none"
151
+ }
152
+ ]
153
+ }
154
+ ]
155
+ }
@@ -0,0 +1,175 @@
1
+ {
2
+ "docType": "plan",
3
+ "structure": [
4
+ {
5
+ "home": "header",
6
+ "elements": [
7
+ {
8
+ "anchor": "# Title",
9
+ "presence": "required",
10
+ "refKind": "none"
11
+ },
12
+ {
13
+ "anchor": "**Spec:**",
14
+ "presence": "required",
15
+ "refKind": "spec-ref"
16
+ },
17
+ {
18
+ "anchor": "**Parent program**",
19
+ "presence": "required",
20
+ "refKind": "parent-program"
21
+ },
22
+ {
23
+ "anchor": "**Version**",
24
+ "presence": "required",
25
+ "refKind": "version-lineage"
26
+ },
27
+ {
28
+ "anchor": "**Depends on**",
29
+ "presence": "optional",
30
+ "refKind": "phase-id"
31
+ },
32
+ {
33
+ "anchor": "**Base**",
34
+ "presence": "optional",
35
+ "refKind": "none"
36
+ }
37
+ ]
38
+ },
39
+ {
40
+ "home": "section",
41
+ "elements": [
42
+ {
43
+ "anchor": "## Constraints",
44
+ "presence": "required",
45
+ "refKind": "none"
46
+ },
47
+ {
48
+ "anchor": "Constraint delta bullet",
49
+ "presence": "required",
50
+ "refKind": "none"
51
+ },
52
+ {
53
+ "anchor": "Constraint delta sub-heading",
54
+ "presence": "optional",
55
+ "refKind": "none"
56
+ },
57
+ {
58
+ "anchor": "## Change history",
59
+ "presence": "required",
60
+ "refKind": "none"
61
+ }
62
+ ]
63
+ },
64
+ {
65
+ "home": "task-block",
66
+ "elements": [
67
+ {
68
+ "anchor": "### Task N:",
69
+ "presence": "required",
70
+ "refKind": "none"
71
+ },
72
+ {
73
+ "anchor": "Task id token",
74
+ "presence": "required",
75
+ "refKind": "task-id"
76
+ }
77
+ ]
78
+ },
79
+ {
80
+ "home": "task-field",
81
+ "elements": [
82
+ {
83
+ "anchor": "**Objective**",
84
+ "presence": "required",
85
+ "refKind": "none"
86
+ },
87
+ {
88
+ "anchor": "**Files**",
89
+ "presence": "required",
90
+ "refKind": "none"
91
+ },
92
+ {
93
+ "anchor": "File path token",
94
+ "presence": "required",
95
+ "refKind": "none"
96
+ },
97
+ {
98
+ "anchor": "**Consumes**",
99
+ "presence": "required",
100
+ "refKind": "none"
101
+ },
102
+ {
103
+ "anchor": "**Produces**",
104
+ "presence": "required",
105
+ "refKind": "none"
106
+ },
107
+ {
108
+ "anchor": "**Steps**",
109
+ "presence": "required",
110
+ "refKind": "none"
111
+ },
112
+ {
113
+ "anchor": "**Acceptance**",
114
+ "presence": "required",
115
+ "refKind": "none"
116
+ },
117
+ {
118
+ "anchor": "**DependsOn**",
119
+ "presence": "required",
120
+ "refKind": "none"
121
+ },
122
+ {
123
+ "anchor": "DependsOn none",
124
+ "presence": "optional",
125
+ "refKind": "none"
126
+ },
127
+ {
128
+ "anchor": "DependsOn id",
129
+ "presence": "optional",
130
+ "refKind": "task-id"
131
+ },
132
+ {
133
+ "anchor": "Task prose reference",
134
+ "presence": "optional",
135
+ "refKind": "task-id"
136
+ }
137
+ ]
138
+ },
139
+ {
140
+ "home": "task-step",
141
+ "elements": [
142
+ {
143
+ "anchor": "Step action",
144
+ "presence": "required",
145
+ "refKind": "none"
146
+ },
147
+ {
148
+ "anchor": "Step checkable",
149
+ "presence": "required",
150
+ "refKind": "none"
151
+ }
152
+ ]
153
+ },
154
+ {
155
+ "home": "table",
156
+ "elements": [
157
+ {
158
+ "anchor": "Change history row",
159
+ "presence": "required",
160
+ "refKind": "version-lineage"
161
+ },
162
+ {
163
+ "anchor": "Version token",
164
+ "presence": "required",
165
+ "refKind": "version-lineage"
166
+ },
167
+ {
168
+ "anchor": "Change history date",
169
+ "presence": "required",
170
+ "refKind": "none"
171
+ }
172
+ ]
173
+ }
174
+ ]
175
+ }