yaaw-se 0.3.7 → 0.3.8

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 (81) hide show
  1. package/README.md +6 -2
  2. package/dist/installer/migrations/index.d.ts +2 -2
  3. package/dist/installer/migrations/index.js +2 -2
  4. package/dist/installer/migrations/project/index.js +2 -2
  5. package/dist/installer/migrations/project/index.js.map +1 -1
  6. package/dist/installer/migrations/project/v1-to-v2.d.ts +2 -0
  7. package/dist/installer/migrations/project/v1-to-v2.js +64 -0
  8. package/dist/installer/migrations/project/v1-to-v2.js.map +1 -0
  9. package/dist/installer/project-state.js +1 -0
  10. package/dist/installer/project-state.js.map +1 -1
  11. package/dist/installer/transaction.js +5 -0
  12. package/dist/installer/transaction.js.map +1 -1
  13. package/dist/installer/types.d.ts +5 -0
  14. package/dist/payload/bootstrap/claude-code.md +1 -1
  15. package/dist/payload/bootstrap/cline.md +1 -1
  16. package/dist/payload/bootstrap/codex.md +1 -1
  17. package/dist/payload/bootstrap/gemini-cli.md +1 -1
  18. package/dist/payload/integrations/codex/yaaw-runtime.md +1 -1
  19. package/dist/payload/payload-files.json +146 -111
  20. package/dist/payload/payload.json +1 -1
  21. package/dist/payload/skills/yaaw-create-spec/SKILL.md +6 -2
  22. package/dist/payload/skills/yaaw-create-ticket/SKILL.md +6 -2
  23. package/dist/payload/skills/yaaw-create-tickets/SKILL.md +6 -2
  24. package/dist/payload/skills/yaaw-implement/SKILL.md +6 -2
  25. package/dist/payload/skills/yaaw-orchestrator/SKILL.md +6 -2
  26. package/dist/payload/skills/yaaw-planner/SKILL.md +6 -2
  27. package/dist/payload/skills/yaaw-planning-review/SKILL.md +6 -2
  28. package/dist/payload/skills/yaaw-prd/SKILL.md +6 -2
  29. package/dist/payload/skills/yaaw-refine-prd/SKILL.md +6 -2
  30. package/dist/payload/skills/yaaw-repair/SKILL.md +6 -2
  31. package/dist/payload/skills/yaaw-review/SKILL.md +6 -2
  32. package/dist/payload/skills/yaaw-revise-prd/SKILL.md +6 -2
  33. package/dist/payload/yaaw-core/system/core/dispatch-execution.md +16 -53
  34. package/dist/payload/yaaw-core/system/core/invalidation.md +7 -38
  35. package/dist/payload/yaaw-core/system/core/io-contract.md +12 -45
  36. package/dist/payload/yaaw-core/system/core/lifecycle.md +11 -18
  37. package/dist/payload/yaaw-core/system/core/recovery.md +12 -26
  38. package/dist/payload/yaaw-core/system/core/routing.md +16 -31
  39. package/dist/payload/yaaw-core/system/core/state-model.md +7 -27
  40. package/dist/payload/yaaw-core/system/registries/handoff-policy.json +41 -59
  41. package/dist/payload/yaaw-core/system/registries/reconciliation-policy.json +17 -0
  42. package/dist/payload/yaaw-core/system/registries/role-io.json +15 -144
  43. package/dist/payload/yaaw-core/system/registries/skills.json +108 -12
  44. package/dist/payload/yaaw-core/system/roles/implementer.md +10 -13
  45. package/dist/payload/yaaw-core/system/roles/orchestrator.md +12 -17
  46. package/dist/payload/yaaw-core/system/roles/planner.md +9 -18
  47. package/dist/payload/yaaw-core/system/roles/reviewer.md +9 -14
  48. package/dist/payload/yaaw-core/system/schemas/engineering-v1.schema.json +15 -0
  49. package/dist/payload/yaaw-core/system/schemas/engineering-v2.schema.json +59 -0
  50. package/dist/payload/yaaw-core/system/schemas/engineering.schema.json +9 -12
  51. package/dist/payload/yaaw-core/system/schemas/evidence-v3.schema.json +111 -0
  52. package/dist/payload/yaaw-core/system/schemas/evidence.schema.json +3 -0
  53. package/dist/payload/yaaw-core/system/schemas/handoff.schema.json +3 -60
  54. package/dist/payload/yaaw-core/system/schemas/intent.schema.json +63 -8
  55. package/dist/payload/yaaw-core/system/schemas/observed-state.schema.json +55 -61
  56. package/dist/payload/yaaw-core/system/schemas/project-state-v1.schema.json +74 -0
  57. package/dist/payload/yaaw-core/system/schemas/project-state-v2.schema.json +251 -0
  58. package/dist/payload/yaaw-core/system/schemas/project-state.schema.json +9 -71
  59. package/dist/payload/yaaw-core/system/templates/engineering-research.md +2 -2
  60. package/dist/payload/yaaw-core/system/templates/engineering.md +2 -1
  61. package/dist/payload/yaaw-core/system/templates/evidence.json +2 -1
  62. package/dist/payload/yaaw-core/system/templates/handoff.json +7 -8
  63. package/dist/payload/yaaw-core/system/templates/intent.json +4 -3
  64. package/dist/payload/yaaw-core/system/templates/observed-state.json +6 -13
  65. package/dist/payload/yaaw-core/system/templates/project-state.json +2 -2
  66. package/dist/payload/yaaw-core/system/templates/review.md +4 -4
  67. package/dist/payload/yaaw-core/system/templates/spec.md +2 -2
  68. package/dist/payload/yaaw-core/system/templates/ticket.md +3 -3
  69. package/dist/payload/yaaw-core/system/tools/orchestration-engine.mjs +187 -0
  70. package/dist/payload/yaaw-core/system/tools/orchestration-runtime.mjs +46 -688
  71. package/dist/payload/yaaw-core/system/workflows/implementation/implement-ticket.md +9 -17
  72. package/dist/payload/yaaw-core/system/workflows/implementation/repair-ticket.md +7 -12
  73. package/dist/payload/yaaw-core/system/workflows/implementation/verify-ticket.md +9 -10
  74. package/dist/payload/yaaw-core/system/workflows/orchestration/reconcile-state.md +10 -13
  75. package/dist/payload/yaaw-core/system/workflows/orchestration/recover-interruption.md +9 -12
  76. package/dist/payload/yaaw-core/system/workflows/orchestration/route.md +14 -21
  77. package/dist/payload/yaaw-core/system/workflows/planning/create-spec.md +3 -0
  78. package/dist/payload/yaaw-core/system/workflows/planning/create-tickets.md +3 -0
  79. package/dist/payload/yaaw-core/system/workflows/planning/decision-frontier.md +3 -0
  80. package/dist/payload/yaaw-core/system/workflows/planning/replan.md +2 -0
  81. package/package.json +4 -3
@@ -0,0 +1,251 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "yaaw.project-state/v2",
4
+ "type": "object",
5
+ "required": [
6
+ "schema",
7
+ "phase",
8
+ "product",
9
+ "planning",
10
+ "active_ticket",
11
+ "tickets",
12
+ "transition_sequence",
13
+ "last_transition",
14
+ "blocker",
15
+ "last_observed_commit",
16
+ "last_workflow"
17
+ ],
18
+ "properties": {
19
+ "schema": {
20
+ "const": "yaaw.project-state/v2"
21
+ },
22
+ "phase": {
23
+ "enum": [
24
+ "product",
25
+ "planning",
26
+ "implementation",
27
+ "complete",
28
+ "blocked"
29
+ ]
30
+ },
31
+ "product": {
32
+ "type": "object",
33
+ "required": [
34
+ "artifact",
35
+ "status",
36
+ "revision"
37
+ ],
38
+ "properties": {
39
+ "artifact": {
40
+ "type": "string"
41
+ },
42
+ "status": {
43
+ "enum": [
44
+ "missing",
45
+ "draft",
46
+ "ready",
47
+ "blocked"
48
+ ]
49
+ },
50
+ "revision": {
51
+ "type": "integer",
52
+ "minimum": 0
53
+ }
54
+ },
55
+ "additionalProperties": false
56
+ },
57
+ "planning": {
58
+ "type": "object",
59
+ "required": [
60
+ "artifact",
61
+ "status",
62
+ "revision",
63
+ "current_frontier",
64
+ "readiness",
65
+ "active_spec",
66
+ "scope_status"
67
+ ],
68
+ "properties": {
69
+ "artifact": {
70
+ "type": "string"
71
+ },
72
+ "status": {
73
+ "enum": [
74
+ "missing",
75
+ "discovery",
76
+ "questions",
77
+ "ready",
78
+ "blocked"
79
+ ]
80
+ },
81
+ "revision": {
82
+ "type": "integer",
83
+ "minimum": 0
84
+ },
85
+ "current_frontier": {
86
+ "type": [
87
+ "string",
88
+ "null"
89
+ ]
90
+ },
91
+ "readiness": {
92
+ "enum": [
93
+ "pending",
94
+ "PASS",
95
+ "MISSING_DECISIONS",
96
+ "PRODUCT_GAP",
97
+ "REPLAN",
98
+ "BLOCKED"
99
+ ]
100
+ },
101
+ "active_spec": {
102
+ "type": [
103
+ "string",
104
+ "null"
105
+ ]
106
+ },
107
+ "scope_status": {
108
+ "enum": [
109
+ "UNKNOWN",
110
+ "OPEN",
111
+ "COMPLETE"
112
+ ]
113
+ }
114
+ },
115
+ "additionalProperties": false
116
+ },
117
+ "active_ticket": {
118
+ "type": [
119
+ "string",
120
+ "null"
121
+ ],
122
+ "pattern": "^TASK-[0-9]+$"
123
+ },
124
+ "tickets": {
125
+ "type": "object",
126
+ "additionalProperties": {
127
+ "enum": [
128
+ "DRAFT",
129
+ "READY",
130
+ "IN_PROGRESS",
131
+ "REVIEW_REQUIRED",
132
+ "REPAIR_REQUIRED",
133
+ "REPLAN_REQUIRED",
134
+ "BLOCKED",
135
+ "PASS",
136
+ "CANCELLED"
137
+ ]
138
+ }
139
+ },
140
+ "transition_sequence": {
141
+ "type": "integer",
142
+ "minimum": 0
143
+ },
144
+ "last_transition": {
145
+ "anyOf": [
146
+ {
147
+ "type": "null"
148
+ },
149
+ {
150
+ "type": "object",
151
+ "required": [
152
+ "sequence",
153
+ "subject",
154
+ "from",
155
+ "to",
156
+ "workflow",
157
+ "reason",
158
+ "evidence",
159
+ "observed_commit"
160
+ ],
161
+ "properties": {
162
+ "sequence": {
163
+ "type": "integer",
164
+ "minimum": 1
165
+ },
166
+ "subject": {
167
+ "type": "string",
168
+ "minLength": 1
169
+ },
170
+ "from": {
171
+ "type": [
172
+ "string",
173
+ "null"
174
+ ]
175
+ },
176
+ "to": {
177
+ "type": "string",
178
+ "minLength": 1
179
+ },
180
+ "workflow": {
181
+ "type": "string",
182
+ "minLength": 1
183
+ },
184
+ "reason": {
185
+ "type": "string",
186
+ "minLength": 1
187
+ },
188
+ "evidence": {
189
+ "type": "array",
190
+ "items": {
191
+ "type": "string"
192
+ }
193
+ },
194
+ "observed_commit": {
195
+ "type": [
196
+ "string",
197
+ "null"
198
+ ]
199
+ }
200
+ },
201
+ "additionalProperties": false
202
+ }
203
+ ]
204
+ },
205
+ "blocker": {
206
+ "anyOf": [
207
+ {
208
+ "type": "null"
209
+ },
210
+ {
211
+ "type": "object",
212
+ "required": [
213
+ "kind",
214
+ "summary",
215
+ "missing"
216
+ ],
217
+ "properties": {
218
+ "kind": {
219
+ "type": "string",
220
+ "minLength": 1
221
+ },
222
+ "summary": {
223
+ "type": "string",
224
+ "minLength": 1
225
+ },
226
+ "missing": {
227
+ "type": "array",
228
+ "items": {
229
+ "type": "string"
230
+ }
231
+ }
232
+ },
233
+ "additionalProperties": false
234
+ }
235
+ ]
236
+ },
237
+ "last_observed_commit": {
238
+ "type": [
239
+ "string",
240
+ "null"
241
+ ]
242
+ },
243
+ "last_workflow": {
244
+ "type": [
245
+ "string",
246
+ "null"
247
+ ]
248
+ }
249
+ },
250
+ "additionalProperties": false
251
+ }
@@ -1,74 +1,12 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "yaaw.project-state/v1",
4
- "type": "object",
5
- "required": ["schema", "phase", "product", "planning", "active_ticket", "tickets", "transition_sequence", "last_transition", "blocker", "last_observed_commit", "last_workflow"],
6
- "properties": {
7
- "schema": {"const": "yaaw.project-state/v1"},
8
- "phase": {"enum": ["product", "planning", "implementation", "complete", "blocked"]},
9
- "product": {
10
- "type": "object",
11
- "required": ["artifact", "status", "revision"],
12
- "properties": {
13
- "artifact": {"type": "string"},
14
- "status": {"enum": ["missing", "draft", "ready", "blocked"]},
15
- "revision": {"type": "integer", "minimum": 0}
16
- },
17
- "additionalProperties": false
18
- },
19
- "planning": {
20
- "type": "object",
21
- "required": ["artifact", "status", "revision", "current_frontier", "readiness", "active_spec"],
22
- "properties": {
23
- "artifact": {"type": "string"},
24
- "status": {"enum": ["missing", "discovery", "questions", "ready", "blocked"]},
25
- "revision": {"type": "integer", "minimum": 0},
26
- "current_frontier": {"type": ["string", "null"]},
27
- "readiness": {"enum": ["pending", "PASS", "MISSING_DECISIONS", "PRODUCT_GAP", "REPLAN", "BLOCKED"]},
28
- "active_spec": {"type": ["string", "null"]}
29
- },
30
- "additionalProperties": false
31
- },
32
- "active_ticket": {"type": ["string", "null"], "pattern": "^TASK-[0-9]+$"},
33
- "tickets": {"type": "object", "additionalProperties": {"enum": ["DRAFT", "READY", "IN_PROGRESS", "REVIEW_REQUIRED", "REPAIR_REQUIRED", "REPLAN_REQUIRED", "BLOCKED", "PASS", "CANCELLED"]}},
34
- "transition_sequence": {"type": "integer", "minimum": 0},
35
- "last_transition": {
36
- "anyOf": [
37
- {"type": "null"},
38
- {
39
- "type": "object",
40
- "required": ["sequence", "subject", "from", "to", "workflow", "reason", "evidence", "observed_commit"],
41
- "properties": {
42
- "sequence": {"type": "integer", "minimum": 1},
43
- "subject": {"type": "string", "minLength": 1},
44
- "from": {"type": ["string", "null"]},
45
- "to": {"type": "string", "minLength": 1},
46
- "workflow": {"type": "string", "minLength": 1},
47
- "reason": {"type": "string", "minLength": 1},
48
- "evidence": {"type": "array", "items": {"type": "string"}},
49
- "observed_commit": {"type": ["string", "null"]}
50
- },
51
- "additionalProperties": false
52
- }
53
- ]
54
- },
55
- "blocker": {
56
- "anyOf": [
57
- {"type": "null"},
58
- {
59
- "type": "object",
60
- "required": ["kind", "summary", "missing"],
61
- "properties": {
62
- "kind": {"type": "string", "minLength": 1},
63
- "summary": {"type": "string", "minLength": 1},
64
- "missing": {"type": "array", "items": {"type": "string"}}
65
- },
66
- "additionalProperties": false
67
- }
68
- ]
69
- },
70
- "last_observed_commit": {"type": ["string", "null"]},
71
- "last_workflow": {"type": ["string", "null"]}
72
- },
73
- "additionalProperties": false
3
+ "$id": "yaaw.project-state",
4
+ "oneOf": [
5
+ {
6
+ "$ref": "project-state-v1.schema.json"
7
+ },
8
+ {
9
+ "$ref": "project-state-v2.schema.json"
10
+ }
11
+ ]
74
12
  }
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  schema: yaaw.engineering-research/v1
3
- id: RSH-XXX
3
+ id: RSH-000
4
4
  revision: 1
5
5
  status: PENDING
6
6
  product_revision: 1
7
7
  engineering_revision: 1
8
8
  frontier_id: FRONTIER-001
9
9
  ---
10
- # RSH-XXX
10
+ # RSH-000
11
11
 
12
12
  ## Question
13
13
 
@@ -1,10 +1,11 @@
1
1
  ---
2
- schema: yaaw.engineering/v1
2
+ schema: yaaw.engineering/v2
3
3
  revision: 1
4
4
  status: discovery
5
5
  product_revision: 1
6
6
  current_frontier: FRONTIER-001
7
7
  readiness: pending
8
+ scope_status: UNKNOWN
8
9
  ---
9
10
  # Engineering
10
11
 
@@ -1,10 +1,11 @@
1
1
  {
2
- "schema": "yaaw.evidence/v2",
2
+ "schema": "yaaw.evidence/v3",
3
3
  "id": "EVIDENCE-TASK-000-V1",
4
4
  "ticket": "TASK-000",
5
5
  "ticket_revision": 1,
6
6
  "spec_revision": 1,
7
7
  "kind": "implementation_verification",
8
+ "result": "PASS",
8
9
  "repository": {
9
10
  "schema": "yaaw.repository-identity/v2",
10
11
  "algorithm": "yaaw-worktree-v2",
@@ -1,10 +1,10 @@
1
1
  {
2
- "schema": "yaaw.handoff/v2",
2
+ "schema": "yaaw.handoff/v3",
3
3
  "framework": {
4
4
  "yaaw_version": "VERSION",
5
- "system_schema": 2,
6
- "installation_schema": 1,
7
- "project_schema": 1,
5
+ "system_schema": 3,
6
+ "installation_schema": 3,
7
+ "project_schema": 2,
8
8
  "manifest_digest": "sha256:MANIFEST",
9
9
  "integrity_status": "HEALTHY"
10
10
  },
@@ -19,8 +19,8 @@
19
19
  "revisions": {"product": 1, "engineering": 1, "spec": 1, "ticket": 1},
20
20
  "expertise": [],
21
21
  "host_expertise": [],
22
- "expected_output": "implementation_evidence",
23
- "result_vocabulary": ["SUCCESS", "REVIEW_REQUIRED", "REPLAN_REQUIRED", "PRECONDITION_UNSATISFIED", "BLOCKED"],
22
+ "expected_output": "implementation evidence",
23
+ "result_vocabulary": ["VERIFICATION_PASS","VERIFICATION_FAIL","REPLAN_REQUIRED","BLOCKED"],
24
24
  "repository_requirement": "IDENTITY",
25
25
  "repository": {
26
26
  "schema": "yaaw.repository-identity/v2",
@@ -35,6 +35,5 @@
35
35
  "changed_paths": [],
36
36
  "error": null
37
37
  },
38
- "transition_sequence": 0,
39
- "cause": null
38
+ "transition_sequence": 0
40
39
  }
@@ -1,8 +1,9 @@
1
1
  {
2
- "schema": "yaaw.intent/v1",
3
- "source": "yaaw-orchestrator",
2
+ "schema": "yaaw.intent/v2",
3
+ "source_skill": "yaaw-orchestrator",
4
4
  "desired_outcome": "CONTINUE",
5
+ "requested_workflow": "orchestration.route",
5
6
  "target_artifact": null,
6
- "completion_condition": "advance to the next valid durable boundary",
7
+ "completion_kind": "CONTINUE_UNTIL_STOP",
7
8
  "created_from_transition_sequence": 0
8
9
  }
@@ -1,10 +1,10 @@
1
1
  {
2
- "schema": "yaaw.observed-state/v2",
2
+ "schema": "yaaw.observed-state/v3",
3
3
  "framework": {
4
4
  "yaaw_version": "VERSION",
5
- "system_schema": 2,
6
- "installation_schema": 1,
7
- "project_schema": 1,
5
+ "system_schema": 3,
6
+ "installation_schema": 3,
7
+ "project_schema": 2,
8
8
  "manifest_digest": "sha256:MANIFEST",
9
9
  "integrity_status": "HEALTHY",
10
10
  "modified": [],
@@ -25,17 +25,10 @@
25
25
  "changed_paths": [],
26
26
  "error": "workspace is not versioned"
27
27
  },
28
- "acceptance": {
29
- "active_ticket": null,
30
- "source_current": null,
31
- "review_present": null,
32
- "review_repository_current": null,
33
- "verification_repository_current": null,
34
- "stale_reason": null
35
- },
36
28
  "transition_sequence": 0,
37
29
  "claims": {},
38
30
  "artifacts": {},
39
31
  "inconsistencies": [],
40
- "candidate_actions": []
32
+ "candidate_actions": [],
33
+ "reconciliation": null
41
34
  }
@@ -1,8 +1,8 @@
1
1
  {
2
- "schema": "yaaw.project-state/v1",
2
+ "schema": "yaaw.project-state/v2",
3
3
  "phase": "product",
4
4
  "product": {"artifact": ".yaaw-core/project/product.md", "status": "missing", "revision": 0},
5
- "planning": {"artifact": ".yaaw-core/project/engineering.md", "status": "missing", "revision": 0, "current_frontier": null, "readiness": "pending", "active_spec": null},
5
+ "planning": {"artifact": ".yaaw-core/project/engineering.md", "status": "missing", "revision": 0, "current_frontier": null, "readiness": "pending", "active_spec": null, "scope_status": "UNKNOWN"},
6
6
  "active_ticket": null,
7
7
  "tickets": {},
8
8
  "transition_sequence": 0,
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  schema: yaaw.review/v2
3
- ticket: TASK-XXX
3
+ ticket: TASK-000
4
4
  round: 1
5
- result: RESULT
5
+ result: PASS
6
6
  ticket_revision: 1
7
7
  spec_revision: 1
8
8
  repository:
@@ -14,12 +14,12 @@ repository:
14
14
  head_commit: COMMIT
15
15
  dirty: true
16
16
  worktree_digest: sha256:DIGEST
17
- components: {}
17
+ components: null
18
18
  changed_paths: []
19
19
  error: null
20
20
  evidence: []
21
21
  ---
22
- # REVIEW-TASK-XXX-R1
22
+ # REVIEW-TASK-000-R1
23
23
 
24
24
  ## Result rationale
25
25
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  schema: yaaw.spec/v1
3
- id: SPEC-XXX
3
+ id: SPEC-000
4
4
  revision: 1
5
5
  status: DRAFT
6
6
  product_revision: 1
@@ -8,7 +8,7 @@ engineering_revision: 1
8
8
  frontier_id: FRONTIER-001
9
9
  decision_ids: []
10
10
  ---
11
- # SPEC-XXX
11
+ # SPEC-000
12
12
 
13
13
  ## Goal
14
14
  ## Product source
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  schema: yaaw.ticket/v1
3
- id: TASK-XXX
3
+ id: TASK-000
4
4
  revision: 1
5
- spec: SPEC-XXX
5
+ spec: SPEC-000
6
6
  spec_revision: 1
7
7
  product_revision: 1
8
8
  engineering_revision: 1
@@ -11,7 +11,7 @@ dependencies: []
11
11
  decision_ids: []
12
12
  expertise: []
13
13
  ---
14
- # TASK-XXX
14
+ # TASK-000
15
15
 
16
16
  ## Goal
17
17
  ## Source specification