@agent-ix/quoin 0.13.0 → 0.15.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/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/dist/advisor/advise.d.ts +57 -0
- package/dist/advisor/advise.d.ts.map +1 -0
- package/dist/advisor/index.d.ts +10 -0
- package/dist/advisor/index.d.ts.map +1 -0
- package/dist/advisor/methods.d.ts +50 -0
- package/dist/advisor/methods.d.ts.map +1 -0
- package/dist/advisor-D35K3_iI.js +50 -0
- package/dist/auditor/audit.d.ts +52 -0
- package/dist/auditor/audit.d.ts.map +1 -0
- package/dist/auditor/index.d.ts +8 -0
- package/dist/auditor/index.d.ts.map +1 -0
- package/dist/{base-D-_JMqkO.js → base-CtpwIg4M.js} +2 -2
- package/dist/catalog.d.ts +1 -0
- package/dist/catalog.d.ts.map +1 -1
- package/dist/cli.js +1 -1
- package/dist/commands/catalog/list.js +2 -2
- package/dist/commands/catalog/methods.d.ts +12 -0
- package/dist/commands/catalog/methods.d.ts.map +1 -0
- package/dist/commands/catalog/methods.js +43 -0
- package/dist/commands/catalog/show.js +2 -2
- package/dist/commands/catalog/validate.js +2 -2
- package/dist/commands/config/doctor.js +1 -1
- package/dist/commands/config/edit.js +1 -1
- package/dist/commands/config/get.js +1 -1
- package/dist/commands/config/set.js +1 -1
- package/dist/commands/evidence/affirm.d.ts +17 -0
- package/dist/commands/evidence/affirm.d.ts.map +1 -0
- package/dist/commands/evidence/affirm.js +81 -0
- package/dist/commands/evidence/audit.d.ts +15 -0
- package/dist/commands/evidence/audit.d.ts.map +1 -0
- package/dist/commands/evidence/audit.js +192 -0
- package/dist/commands/evidence/gc.d.ts +13 -0
- package/dist/commands/evidence/gc.d.ts.map +1 -0
- package/dist/commands/evidence/gc.js +34 -0
- package/dist/commands/evidence/index.d.ts +8 -0
- package/dist/commands/evidence/index.d.ts.map +1 -0
- package/dist/commands/evidence/index.js +16 -0
- package/dist/commands/evidence/record.d.ts +18 -0
- package/dist/commands/evidence/record.d.ts.map +1 -0
- package/dist/commands/evidence/record.js +85 -0
- package/dist/commands/matrix.js +1 -1
- package/dist/commands/module/ensure-defaults.js +3 -3
- package/dist/commands/module/install.js +2 -2
- package/dist/commands/module/list.js +2 -2
- package/dist/commands/module/remove.js +2 -2
- package/dist/commands/review.js +1 -1
- package/dist/commands/to-plan.js +1 -1
- package/dist/commands/update.js +2 -2
- package/dist/commands/write.js +3 -3
- package/dist/evidence/index.d.ts +13 -0
- package/dist/evidence/index.d.ts.map +1 -0
- package/dist/evidence/record.d.ts +52 -0
- package/dist/evidence/record.d.ts.map +1 -0
- package/dist/evidence/store.d.ts +77 -0
- package/dist/evidence/store.d.ts.map +1 -0
- package/dist/evidence/types.d.ts +122 -0
- package/dist/evidence/types.d.ts.map +1 -0
- package/dist/evidence-BvUyw-Yv.js +171 -0
- package/dist/{flow-command-BPwQwyEV.js → flow-command-BSMqxass.js} +1 -1
- package/dist/index.js +6 -6
- package/dist/{modules-Dn6ac8th.js → modules-Ckfaq5p4.js} +2 -2
- package/dist/{plugins-BCCcBgCW.js → plugins-CLuXx2Jr.js} +1 -1
- package/dist/quire/contract.d.ts +82 -0
- package/dist/quire/contract.d.ts.map +1 -0
- package/dist/quire/index.d.ts +11 -0
- package/dist/quire/index.d.ts.map +1 -0
- package/dist/quire/types.d.ts +155 -0
- package/dist/quire/types.d.ts.map +1 -0
- package/dist/quire/validate.d.ts +34 -0
- package/dist/quire/validate.d.ts.map +1 -0
- package/dist/quire-MbMdffPh.js +4872 -0
- package/dist/schemas/coverage-v1.schema.json +191 -0
- package/dist/schemas/properties-v1.schema.json +134 -0
- package/dist/{version-BGJINLrJ.js → version-By2YFRZQ.js} +1 -1
- package/dist/{write-FTRN1yh6.js → write-8JJ8Dumo.js} +1 -1
- package/package.json +6 -2
- package/skills/gap-analysis/SKILL.md +12 -0
- package/skills/gap-analysis/references/step-3-matrix-verification.md +24 -1
- package/skills/gap-analysis/references/step-6-specreview-artifact.md +7 -0
- package/skills/spec-correctness/references/step-6-review-artifact.md +13 -0
- package/skills/spec-correctness/references/step-7-report-and-handoff.md +21 -3
- package/skills/spec-ears-analysis/SKILL.md +13 -0
- package/skills/spec-evidence-analysis/SKILL.md +64 -52
- package/skills/spec-matrix/SKILL.md +13 -0
- package/skills/spec-review/SKILL.md +13 -0
- package/skills/spec-to-plan/SKILL.md +13 -0
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "https://agent-ix.dev/quire/schemas/output/coverage-v1.schema.json",
|
|
4
|
+
"title": "quire coverage --json payload (v1)",
|
|
5
|
+
"description": "The FR-050 coverage rollup as emitted on stdout by `quire coverage --json` and by `CoverageReport::to_json`. Hand-authored: `schemars` is banned in this crate (FR-003-AC-4) precisely so this artifact is a decision rather than a derivation, and so a payload change cannot silently rewrite its own contract. FR-008-AC-5 bans a version key in the payload, so the version lives here in the `$id` and the filename.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"required": [
|
|
9
|
+
"unbacked_rows",
|
|
10
|
+
"status_lies",
|
|
11
|
+
"untracked_symbols",
|
|
12
|
+
"groups",
|
|
13
|
+
"totals"
|
|
14
|
+
],
|
|
15
|
+
"properties": {
|
|
16
|
+
"unbacked_rows": {
|
|
17
|
+
"type": "array",
|
|
18
|
+
"description": "FR-050-AC-3: reference rows answerable for trace ids no symbol backs.",
|
|
19
|
+
"items": { "$ref": "#/$defs/UnbackedRow" }
|
|
20
|
+
},
|
|
21
|
+
"status_lies": {
|
|
22
|
+
"type": "array",
|
|
23
|
+
"description": "FR-050-AC-4: rows whose status classes as complete while nothing backs them.",
|
|
24
|
+
"items": { "$ref": "#/$defs/StatusLie" }
|
|
25
|
+
},
|
|
26
|
+
"no_symbol_rows": {
|
|
27
|
+
"type": "array",
|
|
28
|
+
"description": "FR-050-AC-16 (CR-041): unbacked rows exempted from status_lies by a declared method that mints no source symbol. ABSENT — not empty — for a module declaring no `no_source_symbol` vocabulary, which is what keeps FR-050-AC-7 byte-identity.",
|
|
29
|
+
"items": { "$ref": "#/$defs/NoSymbolRow" }
|
|
30
|
+
},
|
|
31
|
+
"untracked_symbols": {
|
|
32
|
+
"type": "array",
|
|
33
|
+
"description": "FR-050-AC-5: source symbols whose trace tag resolves to no declared target or reference row.",
|
|
34
|
+
"items": { "$ref": "#/$defs/UntrackedSymbol" }
|
|
35
|
+
},
|
|
36
|
+
"groups": {
|
|
37
|
+
"type": "array",
|
|
38
|
+
"description": "FR-050-AC-6: backed/total counts per minting document and target kind.",
|
|
39
|
+
"items": { "$ref": "#/$defs/GroupCounts" }
|
|
40
|
+
},
|
|
41
|
+
"criteria": {
|
|
42
|
+
"type": "array",
|
|
43
|
+
"description": "FR-050-AC-13 (CR-028): per-document property-shape counts. Absent for a corpus binding no criteria.",
|
|
44
|
+
"items": { "$ref": "#/$defs/CriteriaCounts" }
|
|
45
|
+
},
|
|
46
|
+
"diagnostics": {
|
|
47
|
+
"type": "array",
|
|
48
|
+
"description": "CR-054: declarations that selected nothing, and why. Absent when every declaration selected something.",
|
|
49
|
+
"items": { "$ref": "#/$defs/CoverageDiagnostic" }
|
|
50
|
+
},
|
|
51
|
+
"obligations": {
|
|
52
|
+
"type": "array",
|
|
53
|
+
"description": "FR-053: derived obligation records, ordered by source then document then row. Absent for a model declaring no `obligations:` sources.",
|
|
54
|
+
"items": { "$ref": "#/$defs/Obligation" }
|
|
55
|
+
},
|
|
56
|
+
"totals": { "$ref": "#/$defs/CoverageTotals" }
|
|
57
|
+
},
|
|
58
|
+
"$defs": {
|
|
59
|
+
"UnbackedRow": {
|
|
60
|
+
"type": "object",
|
|
61
|
+
"additionalProperties": false,
|
|
62
|
+
"required": ["reference", "document", "target_ids"],
|
|
63
|
+
"properties": {
|
|
64
|
+
"reference": { "type": "string", "description": "The declaration that produced the row." },
|
|
65
|
+
"document": { "type": "string", "description": "Scope-relative path, `/`-separated on every platform." },
|
|
66
|
+
"row_id": {
|
|
67
|
+
"type": ["string", "null"],
|
|
68
|
+
"description": "The row's own id, when the declaration names a `row_id_column`."
|
|
69
|
+
},
|
|
70
|
+
"target_ids": {
|
|
71
|
+
"type": "array",
|
|
72
|
+
"items": { "type": "string" },
|
|
73
|
+
"description": "Trace ids the row is answerable for — its own plus the ids it references — none of which any symbol backs."
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
},
|
|
77
|
+
"StatusLie": {
|
|
78
|
+
"type": "object",
|
|
79
|
+
"additionalProperties": false,
|
|
80
|
+
"required": ["reference", "document", "status", "target_ids"],
|
|
81
|
+
"properties": {
|
|
82
|
+
"reference": { "type": "string" },
|
|
83
|
+
"document": { "type": "string" },
|
|
84
|
+
"row_id": { "type": ["string", "null"] },
|
|
85
|
+
"status": { "type": "string", "description": "The authored status value, verbatim." },
|
|
86
|
+
"target_ids": { "type": "array", "items": { "type": "string" } }
|
|
87
|
+
}
|
|
88
|
+
},
|
|
89
|
+
"NoSymbolRow": {
|
|
90
|
+
"type": "object",
|
|
91
|
+
"additionalProperties": false,
|
|
92
|
+
"required": ["reference", "document", "test_type", "target_ids"],
|
|
93
|
+
"properties": {
|
|
94
|
+
"reference": { "type": "string" },
|
|
95
|
+
"document": { "type": "string" },
|
|
96
|
+
"row_id": { "type": ["string", "null"] },
|
|
97
|
+
"test_type": { "type": "string", "description": "The declared test-type value that exempts the row." },
|
|
98
|
+
"target_ids": { "type": "array", "items": { "type": "string" } }
|
|
99
|
+
}
|
|
100
|
+
},
|
|
101
|
+
"UntrackedSymbol": {
|
|
102
|
+
"type": "object",
|
|
103
|
+
"additionalProperties": false,
|
|
104
|
+
"required": ["path", "symbol", "trace_id"],
|
|
105
|
+
"properties": {
|
|
106
|
+
"path": { "type": "string" },
|
|
107
|
+
"symbol": { "type": "string" },
|
|
108
|
+
"trace_id": { "type": "string" }
|
|
109
|
+
}
|
|
110
|
+
},
|
|
111
|
+
"GroupCounts": {
|
|
112
|
+
"type": "object",
|
|
113
|
+
"additionalProperties": false,
|
|
114
|
+
"required": ["document", "target", "backed", "total"],
|
|
115
|
+
"properties": {
|
|
116
|
+
"document": { "type": "string" },
|
|
117
|
+
"target": { "type": "string", "description": "Declared target kind the ids belong to." },
|
|
118
|
+
"backed": { "type": "integer", "minimum": 0 },
|
|
119
|
+
"total": { "type": "integer", "minimum": 0 }
|
|
120
|
+
}
|
|
121
|
+
},
|
|
122
|
+
"CriteriaCounts": {
|
|
123
|
+
"type": "object",
|
|
124
|
+
"additionalProperties": false,
|
|
125
|
+
"required": ["document", "archetype", "criteria", "property_shaped", "by_property"],
|
|
126
|
+
"properties": {
|
|
127
|
+
"document": { "type": "string" },
|
|
128
|
+
"archetype": { "type": "string" },
|
|
129
|
+
"criteria": { "type": "integer", "minimum": 0 },
|
|
130
|
+
"property_shaped": { "type": "integer", "minimum": 0 },
|
|
131
|
+
"by_property": {
|
|
132
|
+
"type": "object",
|
|
133
|
+
"additionalProperties": { "type": "integer", "minimum": 0 },
|
|
134
|
+
"description": "Criteria per property-shape label. Key order is deterministic (NFR-006)."
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
},
|
|
138
|
+
"CoverageDiagnostic": {
|
|
139
|
+
"type": "object",
|
|
140
|
+
"additionalProperties": false,
|
|
141
|
+
"required": ["declaration", "reason", "message"],
|
|
142
|
+
"properties": {
|
|
143
|
+
"declaration": { "type": "string", "description": "The declaration's name, as the model authored it." },
|
|
144
|
+
"reason": {
|
|
145
|
+
"type": "string",
|
|
146
|
+
"description": "Stable machine token, shared with `quire validate`'s bundle warnings. Deliberately NOT an enum here: the reason vocabulary is engine data that grows, and a schema that closed it would reject a payload from a newer engine that a consumer could otherwise read."
|
|
147
|
+
},
|
|
148
|
+
"message": { "type": "string" },
|
|
149
|
+
"path": { "type": ["string", "null"] }
|
|
150
|
+
}
|
|
151
|
+
},
|
|
152
|
+
"Obligation": {
|
|
153
|
+
"type": "object",
|
|
154
|
+
"additionalProperties": false,
|
|
155
|
+
"required": ["source", "id", "document", "statement", "statement_hash"],
|
|
156
|
+
"properties": {
|
|
157
|
+
"source": { "type": "string", "description": "The obligation source declaration that minted this record." },
|
|
158
|
+
"id": { "type": "string", "description": "The row's own id, or one rendered from `id_format`." },
|
|
159
|
+
"document": { "type": "string" },
|
|
160
|
+
"statement": { "type": "string", "description": "The normative statement, verbatim and untruncated." },
|
|
161
|
+
"statement_hash": {
|
|
162
|
+
"type": "string",
|
|
163
|
+
"pattern": "^[0-9a-f]{64}$",
|
|
164
|
+
"description": "SHA-256 of the NFC/trim/whitespace-collapsed statement. Suspect-link detection is `current != hash_at_binding` and nothing more."
|
|
165
|
+
},
|
|
166
|
+
"method": { "type": ["string", "null"], "description": "Declared verification method, trailing annotation stripped." },
|
|
167
|
+
"parameters": {
|
|
168
|
+
"type": "object",
|
|
169
|
+
"additionalProperties": { "type": "string" },
|
|
170
|
+
"description": "Declared parameters. An absent key means the cell was empty — never defaulted."
|
|
171
|
+
},
|
|
172
|
+
"criticality": { "type": ["string", "null"] }
|
|
173
|
+
}
|
|
174
|
+
},
|
|
175
|
+
"CoverageTotals": {
|
|
176
|
+
"type": "object",
|
|
177
|
+
"additionalProperties": false,
|
|
178
|
+
"required": ["backed", "total"],
|
|
179
|
+
"properties": {
|
|
180
|
+
"backed": { "type": "integer", "minimum": 0 },
|
|
181
|
+
"total": { "type": "integer", "minimum": 0 },
|
|
182
|
+
"criteria": {
|
|
183
|
+
"type": ["integer", "null"],
|
|
184
|
+
"minimum": 0,
|
|
185
|
+
"description": "All-or-nothing pair with `property_shaped`: both present for a corpus binding criteria, both absent otherwise. Zero is a real value; absent is not zero."
|
|
186
|
+
},
|
|
187
|
+
"property_shaped": { "type": ["integer", "null"], "minimum": 0 }
|
|
188
|
+
}
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "https://agent-ix.dev/quire/schemas/output/properties-v1.schema.json",
|
|
4
|
+
"title": "quire properties --json payload (v1)",
|
|
5
|
+
"description": "The FR-052 per-criterion property-shape classification as emitted on stdout by `quire properties --json`. The envelope is assembled by `quire-cli`; every field inside a criterion comes from `AcClassification`, which this crate owns — so the contract is published here, in one place, and both sides conform to it rather than to each other. Hand-authored (`schemars` is banned, FR-003-AC-4). FR-008-AC-5 bans a version key in the payload, so the version lives in the `$id` and the filename.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"required": ["documents"],
|
|
9
|
+
"properties": {
|
|
10
|
+
"documents": {
|
|
11
|
+
"type": "array",
|
|
12
|
+
"items": { "$ref": "#/$defs/Document" }
|
|
13
|
+
}
|
|
14
|
+
},
|
|
15
|
+
"$defs": {
|
|
16
|
+
"Document": {
|
|
17
|
+
"type": "object",
|
|
18
|
+
"additionalProperties": false,
|
|
19
|
+
"required": ["document", "archetype", "criteria"],
|
|
20
|
+
"properties": {
|
|
21
|
+
"document": {
|
|
22
|
+
"type": "string",
|
|
23
|
+
"description": "The input label as the caller named it — a path, a glob expansion, or `-` for stdin."
|
|
24
|
+
},
|
|
25
|
+
"archetype": { "type": "string" },
|
|
26
|
+
"criteria": {
|
|
27
|
+
"type": "array",
|
|
28
|
+
"description": "Empty for a non-binding archetype (US, IT, …), which is data rather than an error.",
|
|
29
|
+
"items": { "$ref": "#/$defs/Criterion" }
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
},
|
|
33
|
+
"Criterion": {
|
|
34
|
+
"type": "object",
|
|
35
|
+
"additionalProperties": false,
|
|
36
|
+
"required": [
|
|
37
|
+
"row_id",
|
|
38
|
+
"statement",
|
|
39
|
+
"line",
|
|
40
|
+
"shape",
|
|
41
|
+
"property",
|
|
42
|
+
"extractable",
|
|
43
|
+
"extraction",
|
|
44
|
+
"domain",
|
|
45
|
+
"precondition",
|
|
46
|
+
"oracle",
|
|
47
|
+
"signals",
|
|
48
|
+
"obligation"
|
|
49
|
+
],
|
|
50
|
+
"properties": {
|
|
51
|
+
"row_id": {
|
|
52
|
+
"type": ["string", "null"],
|
|
53
|
+
"description": "The criterion's own id. Null when the binding form carries none; a downstream generator cannot emit a tracking tag without it."
|
|
54
|
+
},
|
|
55
|
+
"statement": {
|
|
56
|
+
"type": "string",
|
|
57
|
+
"description": "The UNTRUNCATED statement. Every span offset indexes this field."
|
|
58
|
+
},
|
|
59
|
+
"line": { "type": ["integer", "null"], "minimum": 1 },
|
|
60
|
+
"shape": {
|
|
61
|
+
"type": "string",
|
|
62
|
+
"description": "The FR-047 shape axis.",
|
|
63
|
+
"enum": ["assertion", "obligation", "given-when-then", "unstructured"]
|
|
64
|
+
},
|
|
65
|
+
"property": {
|
|
66
|
+
"type": "string",
|
|
67
|
+
"description": "The FR-052 property-shape axis. Closed in the engine by FR-052-CON-3: a shape with no downstream generator silently drops criteria, so extension happens by declaring idiom phrases, never by adding a shape.",
|
|
68
|
+
"enum": [
|
|
69
|
+
"round-trip",
|
|
70
|
+
"idempotence",
|
|
71
|
+
"ordering",
|
|
72
|
+
"invariant",
|
|
73
|
+
"error-case",
|
|
74
|
+
"lifecycle",
|
|
75
|
+
"concurrency",
|
|
76
|
+
"universal",
|
|
77
|
+
"example",
|
|
78
|
+
"unclassified"
|
|
79
|
+
]
|
|
80
|
+
},
|
|
81
|
+
"extractable": { "type": "boolean" },
|
|
82
|
+
"extraction": {
|
|
83
|
+
"type": "string",
|
|
84
|
+
"description": "CR-033: what a generator may do with this criterion. Derived from `property` and `extractable` alone.",
|
|
85
|
+
"enum": ["extractable", "candidate", "not-extractable"]
|
|
86
|
+
},
|
|
87
|
+
"domain": { "$ref": "#/$defs/SpanOrNull" },
|
|
88
|
+
"precondition": { "$ref": "#/$defs/SpanOrNull" },
|
|
89
|
+
"oracle": { "$ref": "#/$defs/SpanOrNull" },
|
|
90
|
+
"signals": {
|
|
91
|
+
"type": "array",
|
|
92
|
+
"items": { "type": "string" },
|
|
93
|
+
"description": "Stable ids of the signals that fired, in evaluation order. There is no confidence float — a float is unreviewable and invites threshold tuning; this trail is what makes every record re-derivable from its own output."
|
|
94
|
+
},
|
|
95
|
+
"obligation": {
|
|
96
|
+
"description": "FR-053. Null for a module declaring no `obligations:` source. Carries no id, statement or document: the criterion record and its enclosing document object already have all three.",
|
|
97
|
+
"oneOf": [{ "type": "null" }, { "$ref": "#/$defs/CriterionObligation" }]
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
},
|
|
101
|
+
"SpanOrNull": {
|
|
102
|
+
"description": "A span carries both byte offsets and its own text: offsets so a consumer can assert the decomposition partitions the statement, text because handing a UTF-16 consumer raw UTF-8 byte offsets is a defect generator.",
|
|
103
|
+
"oneOf": [
|
|
104
|
+
{ "type": "null" },
|
|
105
|
+
{
|
|
106
|
+
"type": "object",
|
|
107
|
+
"additionalProperties": false,
|
|
108
|
+
"required": ["start", "end", "text"],
|
|
109
|
+
"properties": {
|
|
110
|
+
"start": { "type": "integer", "minimum": 0 },
|
|
111
|
+
"end": { "type": "integer", "minimum": 0 },
|
|
112
|
+
"text": { "type": "string" }
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
]
|
|
116
|
+
},
|
|
117
|
+
"CriterionObligation": {
|
|
118
|
+
"type": "object",
|
|
119
|
+
"additionalProperties": false,
|
|
120
|
+
"required": ["source", "statement_hash", "method", "criticality"],
|
|
121
|
+
"properties": {
|
|
122
|
+
"source": { "type": "string" },
|
|
123
|
+
"statement_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
|
|
124
|
+
"method": { "type": ["string", "null"] },
|
|
125
|
+
"parameters": {
|
|
126
|
+
"type": "object",
|
|
127
|
+
"additionalProperties": { "type": "string" },
|
|
128
|
+
"description": "Omitted entirely when the source declares no parameters or every declared cell is empty."
|
|
129
|
+
},
|
|
130
|
+
"criticality": { "type": ["string", "null"] }
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { i as e } from "./base-
|
|
1
|
+
import { i as e } from "./base-CtpwIg4M.js";
|
|
2
2
|
import { n as t, r as n, t as r } from "./config-schema-Dp-vlxuR.js";
|
|
3
3
|
import { ConfigService as i } from "@agent-ix/ix-cli-core";
|
|
4
4
|
import { existsSync as a, readFileSync as o, statSync as s } from "node:fs";
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agent-ix/quoin",
|
|
3
3
|
"description": "Spec-driven development for Claude Code — author validated, ISO/IEC/IEEE 29148-aligned specs, then plan and build against them.",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.15.1",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"files": [
|
|
@@ -33,6 +33,9 @@
|
|
|
33
33
|
"config": {
|
|
34
34
|
"description": "Read and store quoin configuration (get, set, edit, doctor)."
|
|
35
35
|
},
|
|
36
|
+
"evidence": {
|
|
37
|
+
"description": "The evidence store — what actually ran, and against which statement (record, affirm, gc)."
|
|
38
|
+
},
|
|
36
39
|
"module": {
|
|
37
40
|
"description": "Install and manage user/community spec modules (list, install, remove, ensure-defaults)."
|
|
38
41
|
},
|
|
@@ -57,7 +60,7 @@
|
|
|
57
60
|
"lint": "eslint \"src/**/*.{ts,tsx,js,jsx}\" \"tests/**/*.{ts,tsx,js,jsx}\" && pnpm run format:check",
|
|
58
61
|
"format": "prettier --write .",
|
|
59
62
|
"format:check": "prettier --check .",
|
|
60
|
-
"build": "vite build",
|
|
63
|
+
"build": "vite build && node scripts/copy-quire-schemas.mjs",
|
|
61
64
|
"clean": "rm -rf node_modules dist coverage .pnpm-store",
|
|
62
65
|
"install:frozen": "pnpm install --frozen-lockfile",
|
|
63
66
|
"update-lock": "pnpm install --lockfile-only",
|
|
@@ -89,6 +92,7 @@
|
|
|
89
92
|
"@agent-ix/ix-cli-core": ">=0.12.0",
|
|
90
93
|
"@agent-ix/ts-plugin-kit": ">=0.2.0",
|
|
91
94
|
"@oclif/core": ">=4.13.3",
|
|
95
|
+
"ajv": "^8.20.0",
|
|
92
96
|
"yaml": "^2.9.0",
|
|
93
97
|
"zod": ">=4.4.3"
|
|
94
98
|
},
|
|
@@ -62,6 +62,18 @@ code, edit the plan, or change the matrix. Its only write is the SpecReview arti
|
|
|
62
62
|
|
|
63
63
|
All steps required except Step 4, which is gated on user choice.
|
|
64
64
|
|
|
65
|
+
> **`--scope` is the repository root, and must be passed explicitly.** Since quire-cli
|
|
66
|
+
> v0.16.0 (quire-rs CR-045) the command derives **two roots** from it and never
|
|
67
|
+
> interchanges them: spec documents are read from `<repo>/spec` only, trace tags from
|
|
68
|
+
> the source tree at `<repo>` excluding `spec/`. A repo with no `spec/` exits with a
|
|
69
|
+
> diagnostic naming the missing document root rather than scanning the whole tree, and a
|
|
70
|
+
> matrix outside `spec/` (a fixture, a `plan/` copy) mints nothing. A relative glob
|
|
71
|
+
> resolves under `--scope` only in scoped mode (no `--module`); with `--module` it
|
|
72
|
+
> resolves against the process working directory, and an omitted `--scope` defaults to
|
|
73
|
+
> `.` — so a run launched from a parent directory validates the **wrong tree** and exits
|
|
74
|
+
> 0 for whatever it matched. Check `quire --version` ≥ 0.16.0 before relying on any of
|
|
75
|
+
> this; ≤ 0.15.0 has the pre-split traversal semantics.
|
|
76
|
+
|
|
65
77
|
## The optional semantic review
|
|
66
78
|
|
|
67
79
|
Steps 1–3 are mechanical and cheap. Step 4 is an expensive, judgment-heavy LLM pass.
|
|
@@ -26,6 +26,26 @@ validated against, so the two cannot drift.
|
|
|
26
26
|
quire coverage --scope <project_root> --json
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
+
`--scope` is the repository root, and stays so. Since quire-cli v0.16.0 (quire-rs CR-045)
|
|
30
|
+
the command derives **two roots** from it and never interchanges them: spec documents are
|
|
31
|
+
read from `<project_root>/spec` only, and trace tags from the source tree at
|
|
32
|
+
`<project_root>` excluding `spec/`. This invocation needs no second flag — but a project
|
|
33
|
+
whose `spec/` directory is missing now exits with a diagnostic naming the missing document
|
|
34
|
+
root instead of silently scanning the whole repository, and a matrix outside `spec/` (a
|
|
35
|
+
fixture, a `plan/` copy) mints nothing.
|
|
36
|
+
|
|
37
|
+
**Check the version before relying on any of that.** The "since v0.16.0" premise is not
|
|
38
|
+
enforced anywhere — nothing probes it, and a user on ≤ 0.15.0 silently gets the pre-split
|
|
39
|
+
traversal semantics, where the walk covers the whole repository and a matrix outside
|
|
40
|
+
`spec/` mints. One line, before the first invocation:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
quire --version # expect >= 0.16.0; on an older build the roots are not split
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
If it is older, say so in `## Coverage` rather than reading the report as if the split
|
|
47
|
+
applied.
|
|
48
|
+
|
|
29
49
|
Do **not** pass `--strict`. Whether a gap blocks is this skill's verdict rule (Step 6), not
|
|
30
50
|
the command's exit code.
|
|
31
51
|
|
|
@@ -36,8 +56,11 @@ The report carries exactly the findings this step produces:
|
|
|
36
56
|
| `unbacked_rows` | A declared reference row whose trace targets have no backing `verifies` relation. Each carries `reference`, `document`, `row_id`, `target_ids`. |
|
|
37
57
|
| `status_lies` | A row whose status classes as `complete` while nothing backs it. Adds the authored `status` string. |
|
|
38
58
|
| `untracked_symbols` | A test carrying a trace tag that resolves to no declared row. Carries `path`, `symbol`, `trace_id`. |
|
|
59
|
+
| `no_symbol_rows` | An unbacked row whose **declared verification method mints no source symbol** — an eval, an inspection, a demonstration (quire-rs FR-050-AC-16 / CR-041). Carries `reference`, `document`, `row_id`, `test_type`, `target_ids`. **Read this before triaging `unbacked_rows`**: a row listed here is exempt from `status_lies` by its own method, and reporting it as an unbacked-row finding asserts something impossible. Absent from the JSON entirely when the module declares no `no_source_symbol` vocabulary. |
|
|
60
|
+
| `criteria` | Per-document acceptance-criteria property counts (quire-rs FR-050-AC-13 / CR-028): `document`, `archetype`, `criteria`, `property_shaped`, `by_property`. Data for the `spec-correctness` handoff, never a verdict — a low property-shaped share describes a corpus, it does not fail one. Absent when the corpus binds no criteria. |
|
|
39
61
|
| `groups` | Per minting document: `document`, `target`, `backed`, `total`. |
|
|
40
|
-
| `
|
|
62
|
+
| `diagnostics` | Declarations that selected nothing and why (quire-rs FR-050-AC-19 / CR-054): an unreadable declared `document:`, an archetype no document has when the model minted nothing, or a model with no trace targets. Absent when every declaration selected. A non-empty list means the numbers below it are measuring less than you think. |
|
|
63
|
+
| `totals` | `backed` / `total` across the bundle, plus `criteria` / `property_shaped` when the corpus binds criteria. |
|
|
41
64
|
|
|
42
65
|
## Reconcile, producing findings
|
|
43
66
|
|
|
@@ -88,6 +88,13 @@ will not bind it — and a reader cannot tell which they are looking at unless i
|
|
|
88
88
|
quire validate --scope <project_root> "reviews/**/*.md"
|
|
89
89
|
```
|
|
90
90
|
|
|
91
|
+
**Always pass `--scope <project_root>` explicitly, as above.** A relative glob resolves
|
|
92
|
+
under `--scope` only in scoped mode (no `--module`); with `--module` it resolves against
|
|
93
|
+
the process working directory, and an omitted `--scope` defaults to `.`. A sweep launched
|
|
94
|
+
from a parent directory therefore validates the **wrong tree** and exits 0 for whatever
|
|
95
|
+
it did match — that is the trap. (A glob matching *nothing* is not silent: the CLI exits
|
|
96
|
+
1 with `document glob matched no files`. Only the wrong-tree half is quiet.)
|
|
97
|
+
|
|
91
98
|
Fix any validation error (frontmatter pattern, `analysis` enum, findings headers/ids/severity)
|
|
92
99
|
before reporting completion. Then tell the user the artifact path and the Verdict.
|
|
93
100
|
|
|
@@ -110,6 +110,19 @@ real run — not this skill's to pre-empt with a marker.
|
|
|
110
110
|
quire validate --scope <project_root> "reviews/**/*.md"
|
|
111
111
|
```
|
|
112
112
|
|
|
113
|
+
> **`--scope` is the repository root, and must be passed explicitly.** Since quire-cli
|
|
114
|
+
> v0.16.0 (quire-rs CR-045) the command derives **two roots** from it and never
|
|
115
|
+
> interchanges them: spec documents are read from `<repo>/spec` only, trace tags from
|
|
116
|
+
> the source tree at `<repo>` excluding `spec/`. A repo with no `spec/` exits with a
|
|
117
|
+
> diagnostic naming the missing document root rather than scanning the whole tree, and a
|
|
118
|
+
> matrix outside `spec/` (a fixture, a `plan/` copy) mints nothing. A relative glob
|
|
119
|
+
> resolves under `--scope` only in scoped mode (no `--module`); with `--module` it
|
|
120
|
+
> resolves against the process working directory, and an omitted `--scope` defaults to
|
|
121
|
+
> `.` — so a run launched from a parent directory validates the **wrong tree** and exits
|
|
122
|
+
> 0 for whatever it matched. Check `quire --version` ≥ 0.16.0 before relying on any of
|
|
123
|
+
> this; ≤ 0.15.0 has the pre-split traversal semantics.
|
|
124
|
+
|
|
125
|
+
|
|
113
126
|
Fix any validation error — frontmatter pattern, the `analysis` enum, findings
|
|
114
127
|
headers/ids/severity — before reporting completion. Then tell the user the artifact path.
|
|
115
128
|
|
|
@@ -48,6 +48,11 @@ Before finishing, prove every emitted tag actually **binds** — not that it exi
|
|
|
48
48
|
quire coverage --scope <repo> --json
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
+
`--scope` is the repository root. Since quire-cli v0.16.0 (quire-rs CR-045) the command
|
|
52
|
+
derives two roots from it: documents from `<repo>/spec` only, trace tags from the source
|
|
53
|
+
tree excluding `spec/`. A repo with no `spec/` directory exits with a diagnostic naming
|
|
54
|
+
the missing document root, and a matrix outside `spec/` mints nothing.
|
|
55
|
+
|
|
51
56
|
For each `row_id` this run emitted, confirm the id appears among the backed ids: its
|
|
52
57
|
minting document's group must count it, and it must not appear in `untracked_symbols`.
|
|
53
58
|
|
|
@@ -70,9 +75,22 @@ Then confirm, as before:
|
|
|
70
75
|
- no matrix row this run added is `✅` while its test is skipped;
|
|
71
76
|
- no emitted tag names a `row_id` absent from the `quire properties` output.
|
|
72
77
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
78
|
+
Check `quire --version` ≥ 0.16.0 first: the two-root semantics this step assumes are
|
|
79
|
+
unenforced, and an older build silently walks the whole repository instead.
|
|
80
|
+
|
|
81
|
+
Two distinct states get conflated here; keep them apart (they have different causes and
|
|
82
|
+
different fixes — `gap-analysis` step 3 has the same reading):
|
|
83
|
+
|
|
84
|
+
- **A zero denominator.** Under the `--json` invocation this step prescribes the signal is
|
|
85
|
+
`"totals": {"total": 0}`. `no rows matched` is a **human-format-only** marker and never
|
|
86
|
+
appears in the JSON, so do not look for it there. It means the declared model matched
|
|
87
|
+
nothing in this scope — no minting document was found. Not full coverage, not a clean
|
|
88
|
+
run: report it as **no data**.
|
|
89
|
+
- **No model at all.** `quire coverage` exits **non-zero** with a distinct diagnostic when
|
|
90
|
+
no active module declares a `traceability:` model (quire-rs FR-050-AC-9). That is an
|
|
91
|
+
environment gap — the module set, not the repo's rows.
|
|
92
|
+
|
|
93
|
+
Say which one happened rather than reporting the run as reconciled.
|
|
76
94
|
|
|
77
95
|
A mismatch here is a bug in this run, not in `gap-analysis`.
|
|
78
96
|
|
|
@@ -22,6 +22,19 @@ form the lens.
|
|
|
22
22
|
quire validate --scope . "spec/**/*.md" --summary
|
|
23
23
|
```
|
|
24
24
|
|
|
25
|
+
> **`--scope` is the repository root, and must be passed explicitly.** Since quire-cli
|
|
26
|
+
> v0.16.0 (quire-rs CR-045) the command derives **two roots** from it and never
|
|
27
|
+
> interchanges them: spec documents are read from `<repo>/spec` only, trace tags from
|
|
28
|
+
> the source tree at `<repo>` excluding `spec/`. A repo with no `spec/` exits with a
|
|
29
|
+
> diagnostic naming the missing document root rather than scanning the whole tree, and a
|
|
30
|
+
> matrix outside `spec/` (a fixture, a `plan/` copy) mints nothing. A relative glob
|
|
31
|
+
> resolves under `--scope` only in scoped mode (no `--module`); with `--module` it
|
|
32
|
+
> resolves against the process working directory, and an omitted `--scope` defaults to
|
|
33
|
+
> `.` — so a run launched from a parent directory validates the **wrong tree** and exits
|
|
34
|
+
> 0 for whatever it matched. Check `quire --version` ≥ 0.16.0 before relying on any of
|
|
35
|
+
> this; ≤ 0.15.0 has the pre-split traversal semantics.
|
|
36
|
+
|
|
37
|
+
|
|
25
38
|
Read the `[ears:<check>]` warnings and the `GrammarSummary` line. The engine
|
|
26
39
|
flags, per statement:
|
|
27
40
|
- `non-singular` — more than one `shall` (can't map cleanly to one AC).
|