@gluecharm-lab/easyspecs-cli 0.3.5 → 0.3.6

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 (25) hide show
  1. package/commands.md +4 -4
  2. package/dist/main.cjs +1655 -513
  3. package/dist/main.cjs.map +4 -4
  4. package/package.json +1 -1
  5. package/resources/opencode-agents/agent-list-infrastructure-components.md +187 -0
  6. package/resources/opencode-agents/agent-list-infrastructure.md +222 -0
  7. package/resources/opencode-agents/agent-list-qa-test-cases.md +187 -0
  8. package/resources/opencode-agents/agent-list-qa.md +222 -0
  9. package/resources/opencode-agents/agent-md-infrastructure-component-detail.md +165 -0
  10. package/resources/opencode-agents/agent-md-infrastructure-detail.md +95 -0
  11. package/resources/opencode-agents/agent-md-qa-detail.md +95 -0
  12. package/resources/opencode-agents/agent-md-qa-test-case-detail.md +165 -0
  13. package/resources/opencode-agents/agent-review-infrastructure-components-list.md +34 -0
  14. package/resources/opencode-agents/agent-review-infrastructure-list.md +60 -0
  15. package/resources/opencode-agents/agent-review-qa-list.md +60 -0
  16. package/resources/opencode-agents/agent-review-qa-test-cases-list.md +34 -0
  17. package/resources/schemas/context-lists/features-list.schema.json +2 -2
  18. package/resources/schemas/context-lists/infrastructure-components-list.schema.json +175 -0
  19. package/resources/schemas/context-lists/infrastructure-list.schema.json +179 -0
  20. package/resources/schemas/context-lists/qa-list.schema.json +187 -0
  21. package/resources/schemas/context-lists/qa-test-cases-list.schema.json +180 -0
  22. package/resources/schemas/context-lists/zero-reference-classifier-record.schema.json +2 -0
  23. package/resources/schemas/context-lists/zero-reference-routing.schema.json +2 -0
  24. package/resources/schemas/context-lists/zero-reference-triage-record.schema.json +4 -4
  25. package/resources/schemas/index-application-context.schema.json +9 -3
package/resources/schemas/context-lists/infrastructure-list.schema.json ADDED
@@ -0,0 +1,179 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://easyspecs.ai/schemas/context-lists/infrastructure-list.schema.json",
4
+ "title": "infrastructure-list",
5
+ "$defs": {
6
+ "sourceReference": {
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "required": [
10
+ "path",
11
+ "startLine",
12
+ "endLine"
13
+ ],
14
+ "properties": {
15
+ "path": {
16
+ "type": "string",
17
+ "minLength": 1,
18
+ "pattern": "^[^/]+(/[^/]+)*$",
19
+ "description": "Repo-relative path to a single file (forward slashes). Not a directory: no trailing slash; list each file in a folder as its own sourceReferences entry."
20
+ },
21
+ "startLine": {
22
+ "type": "integer",
23
+ "minimum": 1,
24
+ "description": "1-based inclusive start line."
25
+ },
26
+ "endLine": {
27
+ "type": "integer",
28
+ "minimum": 1,
29
+ "description": "1-based inclusive end line; should be >= startLine."
30
+ },
31
+ "note": {
32
+ "type": "string",
33
+ "description": "Optional short label for this evidence span."
34
+ }
35
+ }
36
+ },
37
+ "sourceReferenceList": {
38
+ "type": "array",
39
+ "description": "Evidence spans: each item references one file + line range, never a folder path.",
40
+ "items": {
41
+ "$ref": "#/$defs/sourceReference"
42
+ }
43
+ }
44
+ },
45
+ "type": "object",
46
+ "additionalProperties": false,
47
+ "required": [
48
+ "infrastructure"
49
+ ],
50
+ "properties": {
51
+ "kind": {
52
+ "type": "string",
53
+ "const": "easyspecs.infrastructure-list"
54
+ },
55
+ "version": {
56
+ "type": "integer",
57
+ "minimum": 1
58
+ },
59
+ "infrastructure": {
60
+ "type": "array",
61
+ "items": {
62
+ "type": "object",
63
+ "additionalProperties": true,
64
+ "required": [
65
+ "code",
66
+ "name",
67
+ "slug",
68
+ "sourceReferences"
69
+ ],
70
+ "properties": {
71
+ "code": {
72
+ "type": "string",
73
+ "pattern": "^IN-[0-9]+$"
74
+ },
75
+ "name": {
76
+ "type": "string",
77
+ "minLength": 1
78
+ },
79
+ "slug": {
80
+ "type": "string",
81
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
82
+ },
83
+ "description": {
84
+ "type": "string"
85
+ },
86
+ "order": {
87
+ "type": "integer"
88
+ },
89
+ "sourceReferences": {
90
+ "type": "array",
91
+ "minItems": 1,
92
+ "items": {
93
+ "$ref": "#/$defs/sourceReference"
94
+ }
95
+ },
96
+ "kind": {
97
+ "type": "string",
98
+ "enum": [
99
+ "pipeline",
100
+ "iac",
101
+ "container",
102
+ "script",
103
+ "deployment",
104
+ "automation",
105
+ "observability",
106
+ "developer_experience",
107
+ "local_dev",
108
+ "bootstrap",
109
+ "other"
110
+ ]
111
+ }
112
+ }
113
+ }
114
+ },
115
+ "revisionLog": {
116
+ "type": "array",
117
+ "description": "Append-only log of substantive edits; add an entry whenever this pass changes rows, merges, or refines the coordination file.",
118
+ "items": {
119
+ "type": "object",
120
+ "additionalProperties": false,
121
+ "required": [
122
+ "summary"
123
+ ],
124
+ "properties": {
125
+ "at": {
126
+ "type": "string",
127
+ "description": "ISO-8601 timestamp when known."
128
+ },
129
+ "summary": {
130
+ "type": "string",
131
+ "minLength": 1,
132
+ "maxLength": 2000,
133
+ "description": "What was added, changed, or refined in this write."
134
+ },
135
+ "droppedCodes": {
136
+ "type": "array",
137
+ "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
138
+ "items": {
139
+ "type": "string",
140
+ "minLength": 1
141
+ }
142
+ },
143
+ "slugRenames": {
144
+ "type": "array",
145
+ "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
146
+ "items": {
147
+ "type": "object",
148
+ "additionalProperties": false,
149
+ "required": [
150
+ "code",
151
+ "from",
152
+ "to"
153
+ ],
154
+ "properties": {
155
+ "code": {
156
+ "type": "string",
157
+ "minLength": 1
158
+ },
159
+ "from": {
160
+ "type": "string",
161
+ "minLength": 1
162
+ },
163
+ "to": {
164
+ "type": "string",
165
+ "minLength": 1
166
+ }
167
+ }
168
+ }
169
+ },
170
+ "stableWriteDiff": {
171
+ "type": "object",
172
+ "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
173
+ "additionalProperties": true
174
+ }
175
+ }
176
+ }
177
+ }
178
+ }
179
+ }
package/resources/schemas/context-lists/qa-list.schema.json ADDED
@@ -0,0 +1,187 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://easyspecs.ai/schemas/context-lists/qa-list.schema.json",
4
+ "title": "qa-list",
5
+ "$defs": {
6
+ "sourceReference": {
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "required": [
10
+ "path",
11
+ "startLine",
12
+ "endLine"
13
+ ],
14
+ "properties": {
15
+ "path": {
16
+ "type": "string",
17
+ "minLength": 1,
18
+ "pattern": "^[^/]+(/[^/]+)*$",
19
+ "description": "Repo-relative path to a single file (forward slashes). Not a directory: no trailing slash; list each file in a folder as its own sourceReferences entry."
20
+ },
21
+ "startLine": {
22
+ "type": "integer",
23
+ "minimum": 1,
24
+ "description": "1-based inclusive start line."
25
+ },
26
+ "endLine": {
27
+ "type": "integer",
28
+ "minimum": 1,
29
+ "description": "1-based inclusive end line; should be >= startLine."
30
+ },
31
+ "note": {
32
+ "type": "string",
33
+ "description": "Optional short label for this evidence span."
34
+ }
35
+ }
36
+ },
37
+ "sourceReferenceList": {
38
+ "type": "array",
39
+ "description": "Evidence spans: each item references one file + line range, never a folder path.",
40
+ "items": {
41
+ "$ref": "#/$defs/sourceReference"
42
+ }
43
+ }
44
+ },
45
+ "type": "object",
46
+ "additionalProperties": false,
47
+ "required": [
48
+ "qa"
49
+ ],
50
+ "properties": {
51
+ "kind": {
52
+ "type": "string",
53
+ "const": "easyspecs.qa-list"
54
+ },
55
+ "version": {
56
+ "type": "integer",
57
+ "minimum": 1
58
+ },
59
+ "qa": {
60
+ "type": "array",
61
+ "items": {
62
+ "type": "object",
63
+ "additionalProperties": true,
64
+ "required": [
65
+ "code",
66
+ "name",
67
+ "slug",
68
+ "sourceReferences"
69
+ ],
70
+ "properties": {
71
+ "code": {
72
+ "type": "string",
73
+ "pattern": "^QA-[0-9]+$"
74
+ },
75
+ "name": {
76
+ "type": "string",
77
+ "minLength": 1
78
+ },
79
+ "slug": {
80
+ "type": "string",
81
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
82
+ },
83
+ "description": {
84
+ "type": "string"
85
+ },
86
+ "order": {
87
+ "type": "integer"
88
+ },
89
+ "sourceReferences": {
90
+ "type": "array",
91
+ "minItems": 1,
92
+ "items": {
93
+ "$ref": "#/$defs/sourceReference"
94
+ }
95
+ },
96
+ "coversCodes": {
97
+ "type": "array",
98
+ "minItems": 1,
99
+ "items": {
100
+ "type": "string",
101
+ "minLength": 1
102
+ }
103
+ },
104
+ "kind": {
105
+ "type": "string",
106
+ "enum": [
107
+ "e2e",
108
+ "integration",
109
+ "unit_harness",
110
+ "fixture",
111
+ "mock",
112
+ "contract",
113
+ "load",
114
+ "accessibility",
115
+ "security",
116
+ "manual",
117
+ "other"
118
+ ]
119
+ }
120
+ }
121
+ }
122
+ },
123
+ "revisionLog": {
124
+ "type": "array",
125
+ "description": "Append-only log of substantive edits; add an entry whenever this pass changes rows, merges, or refines the coordination file.",
126
+ "items": {
127
+ "type": "object",
128
+ "additionalProperties": false,
129
+ "required": [
130
+ "summary"
131
+ ],
132
+ "properties": {
133
+ "at": {
134
+ "type": "string",
135
+ "description": "ISO-8601 timestamp when known."
136
+ },
137
+ "summary": {
138
+ "type": "string",
139
+ "minLength": 1,
140
+ "maxLength": 2000,
141
+ "description": "What was added, changed, or refined in this write."
142
+ },
143
+ "droppedCodes": {
144
+ "type": "array",
145
+ "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
146
+ "items": {
147
+ "type": "string",
148
+ "minLength": 1
149
+ }
150
+ },
151
+ "slugRenames": {
152
+ "type": "array",
153
+ "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
154
+ "items": {
155
+ "type": "object",
156
+ "additionalProperties": false,
157
+ "required": [
158
+ "code",
159
+ "from",
160
+ "to"
161
+ ],
162
+ "properties": {
163
+ "code": {
164
+ "type": "string",
165
+ "minLength": 1
166
+ },
167
+ "from": {
168
+ "type": "string",
169
+ "minLength": 1
170
+ },
171
+ "to": {
172
+ "type": "string",
173
+ "minLength": 1
174
+ }
175
+ }
176
+ }
177
+ },
178
+ "stableWriteDiff": {
179
+ "type": "object",
180
+ "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
181
+ "additionalProperties": true
182
+ }
183
+ }
184
+ }
185
+ }
186
+ }
187
+ }
package/resources/schemas/context-lists/qa-test-cases-list.schema.json ADDED
@@ -0,0 +1,180 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://easyspecs.ai/schemas/context-lists/qa-test-cases-list.schema.json",
4
+ "title": "qa-test-cases-list",
5
+ "$defs": {
6
+ "sourceReference": {
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "required": [
10
+ "path",
11
+ "startLine",
12
+ "endLine"
13
+ ],
14
+ "properties": {
15
+ "path": {
16
+ "type": "string",
17
+ "minLength": 1,
18
+ "pattern": "^[^/]+(/[^/]+)*$",
19
+ "description": "Repo-relative path to a single file (forward slashes). Not a directory: no trailing slash; list each file in a folder as its own sourceReferences entry."
20
+ },
21
+ "startLine": {
22
+ "type": "integer",
23
+ "minimum": 1,
24
+ "description": "1-based inclusive start line."
25
+ },
26
+ "endLine": {
27
+ "type": "integer",
28
+ "minimum": 1,
29
+ "description": "1-based inclusive end line; should be >= startLine."
30
+ },
31
+ "note": {
32
+ "type": "string",
33
+ "description": "Optional short label for this evidence span."
34
+ }
35
+ }
36
+ }
37
+ },
38
+ "type": "object",
39
+ "additionalProperties": false,
40
+ "required": [
41
+ "qaCode",
42
+ "testCases"
43
+ ],
44
+ "properties": {
45
+ "kind": {
46
+ "type": "string",
47
+ "const": "easyspecs.qa-test-cases-list"
48
+ },
49
+ "version": {
50
+ "type": "integer",
51
+ "minimum": 1
52
+ },
53
+ "qaCode": {
54
+ "type": "string",
55
+ "pattern": "^QA-[0-9]+$"
56
+ },
57
+ "testCases": {
58
+ "type": "array",
59
+ "items": {
60
+ "type": "object",
61
+ "additionalProperties": true,
62
+ "required": [
63
+ "code",
64
+ "name",
65
+ "sourceReferences"
66
+ ],
67
+ "properties": {
68
+ "code": {
69
+ "type": "string",
70
+ "pattern": "^TC-[0-9]+$"
71
+ },
72
+ "name": {
73
+ "type": "string",
74
+ "minLength": 1
75
+ },
76
+ "slug": {
77
+ "type": "string",
78
+ "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
79
+ },
80
+ "description": {
81
+ "type": "string"
82
+ },
83
+ "order": {
84
+ "type": "integer"
85
+ },
86
+ "sourceReferences": {
87
+ "type": "array",
88
+ "minItems": 1,
89
+ "items": {
90
+ "$ref": "#/$defs/sourceReference"
91
+ }
92
+ },
93
+ "coversCodes": {
94
+ "type": "array",
95
+ "minItems": 1,
96
+ "items": {
97
+ "type": "string",
98
+ "minLength": 1
99
+ }
100
+ },
101
+ "kind": {
102
+ "type": "string",
103
+ "enum": [
104
+ "happy_path",
105
+ "edge_case",
106
+ "error_path",
107
+ "negative",
108
+ "regression",
109
+ "smoke",
110
+ "other"
111
+ ]
112
+ }
113
+ }
114
+ }
115
+ },
116
+ "revisionLog": {
117
+ "type": "array",
118
+ "description": "Append-only log of substantive edits; add an entry whenever this pass changes rows, merges, or refines the coordination file.",
119
+ "items": {
120
+ "type": "object",
121
+ "additionalProperties": false,
122
+ "required": [
123
+ "summary"
124
+ ],
125
+ "properties": {
126
+ "at": {
127
+ "type": "string",
128
+ "description": "ISO-8601 timestamp when known."
129
+ },
130
+ "summary": {
131
+ "type": "string",
132
+ "minLength": 1,
133
+ "maxLength": 2000,
134
+ "description": "What was added, changed, or refined in this write."
135
+ },
136
+ "droppedCodes": {
137
+ "type": "array",
138
+ "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
139
+ "items": {
140
+ "type": "string",
141
+ "minLength": 1
142
+ }
143
+ },
144
+ "slugRenames": {
145
+ "type": "array",
146
+ "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
147
+ "items": {
148
+ "type": "object",
149
+ "additionalProperties": false,
150
+ "required": [
151
+ "code",
152
+ "from",
153
+ "to"
154
+ ],
155
+ "properties": {
156
+ "code": {
157
+ "type": "string",
158
+ "minLength": 1
159
+ },
160
+ "from": {
161
+ "type": "string",
162
+ "minLength": 1
163
+ },
164
+ "to": {
165
+ "type": "string",
166
+ "minLength": 1
167
+ }
168
+ }
169
+ }
170
+ },
171
+ "stableWriteDiff": {
172
+ "type": "object",
173
+ "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
174
+ "additionalProperties": true
175
+ }
176
+ }
177
+ }
178
+ }
179
+ }
180
+ }
package/resources/schemas/context-lists/zero-reference-classifier-record.schema.json CHANGED
@@ -39,6 +39,8 @@
39
39
  "experiences",
40
40
  "services",
41
41
  "data_models",
42
+ "infrastructure",
43
+ "qa",
42
44
  "no_action"
43
45
  ],
44
46
  "description": "Top-level remediation bucket (SRS-30 v0.6). ORM/table units → data_models; product overview → project; system structure → architecture."
package/resources/schemas/context-lists/zero-reference-routing.schema.json CHANGED
@@ -53,6 +53,8 @@
53
53
  "experiences",
54
54
  "services",
55
55
  "data_models",
56
+ "infrastructure",
57
+ "qa",
56
58
  "no_action",
57
59
  "document_project_md",
58
60
  "document_architecture_md",
package/resources/schemas/context-lists/zero-reference-triage-record.schema.json CHANGED
@@ -9,8 +9,8 @@
9
9
  "filePath": { "type": "string", "minLength": 1 },
10
10
  "coordinationScope": {
11
11
  "type": "string",
12
- "enum": ["feature", "experience", "service", "data_model"],
13
- "description": "Must match stage-1 routing: feature | experiences | services | data_models → feature | experience | service | data_model."
12
+ "enum": ["feature", "experience", "service", "data_model", "infrastructure", "qa"],
13
+ "description": "Must match stage-1 routing: feature | experiences | services | data_models | infrastructure | qa → triage list kind."
14
14
  },
15
15
  "decision": {
16
16
  "type": "string",
@@ -24,8 +24,8 @@
24
24
  "proposedSummary": { "type": "string", "minLength": 1, "maxLength": 4000 },
25
25
  "proposedCode": {
26
26
  "type": "string",
27
- "pattern": "^(FE|XP|SV|DM)-[0-9]+$",
28
- "description": "Optional explicit list code for new_item (FE/XP/SV/DM prefix matches scope)."
27
+ "pattern": "^(FE|XP|SV|DM|IN|QA)-[0-9]+$",
28
+ "description": "Optional explicit list code for new_item (prefix matches scope)."
29
29
  },
30
30
  "proposedSlug": {
31
31
  "type": "string",
package/resources/schemas/index-application-context.schema.json CHANGED
@@ -56,7 +56,7 @@
56
56
  "type": {
57
57
  "type": "string",
58
58
  "minLength": 1,
59
- "description": "Node kind in the five-scope tree (e.g. Feature, UseCase, Scenario, View, Interaction, Service, Method, Entity, Field, Relationship, Tool)."
59
+ "description": "Node kind in the application-context tree (e.g. Feature, UseCase, Scenario, View, Interaction, Service, Method, Entity, Field, Relationship, Tool, Infrastructure, Component, QA, TestCase)."
60
60
  },
61
61
  "name": {
62
62
  "type": "string",
@@ -64,7 +64,7 @@
64
64
  },
65
65
  "code": {
66
66
  "type": "string",
67
- "description": "Stable id prefix conventions: FE-*, UC-*, SC-*, XP-*, BH-*, SV-*, ME-*, DM-*, FD-*, RL-*, TS-*."
67
+ "description": "Stable id prefix conventions: FE-*, UC-*, SC-*, XP-*, BH-*, SV-*, ME-*, DM-*, FD-*, RL-*, TS-*, IN-*, IC-*, QA-*, TC-*."
68
68
  },
69
69
  "drift": {
70
70
  "type": "boolean",
@@ -179,7 +179,7 @@
179
179
  "scopes": {
180
180
  "type": "object",
181
181
  "additionalProperties": false,
182
- "description": "Five scope keys; each block may be omitted in minimal JSON but this object is required (may be empty object for edge cases — prefer omitting empty scopes in writers).",
182
+ "description": "Scope keys (Feature, Experience, Service, DataModel, TechStack, Infrastructure, QA); each block may be omitted when empty.",
183
183
  "properties": {
184
184
  "Feature": {
185
185
  "$ref": "#/$defs/scopeBlock"
@@ -195,6 +195,12 @@
195
195
  },
196
196
  "TechStack": {
197
197
  "$ref": "#/$defs/scopeBlock"
198
+ },
199
+ "Infrastructure": {
200
+ "$ref": "#/$defs/scopeBlock"
201
+ },
202
+ "QA": {
203
+ "$ref": "#/$defs/scopeBlock"
198
204
  }
199
205
  }
200
206
  }