@agent-ix/quoin 0.21.2 → 0.21.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 (107) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codex-plugin/plugin.json +1 -1
  3. package/bin/quoin.js +9 -2
  4. package/default-modules.yaml +4 -4
  5. package/dist/advisor/advise.d.ts +91 -5
  6. package/dist/advisor/advise.d.ts.map +1 -1
  7. package/dist/advisor/index.d.ts +1 -1
  8. package/dist/advisor/index.d.ts.map +1 -1
  9. package/dist/{advisor-x8vSvzWl.js → advisor-COB2SuIj.js} +1 -1
  10. package/dist/assurance/graph.d.ts +8 -0
  11. package/dist/assurance/graph.d.ts.map +1 -1
  12. package/dist/auditor/audit.d.ts +51 -17
  13. package/dist/auditor/audit.d.ts.map +1 -1
  14. package/dist/auditor/index.d.ts +1 -1
  15. package/dist/auditor/index.d.ts.map +1 -1
  16. package/dist/{auditor-B6Hs00oH.js → auditor-ww0MC62a.js} +127 -73
  17. package/dist/{base-DVl7skpc.js → base-DNieRzIg.js} +1 -1
  18. package/dist/cli.d.ts +28 -0
  19. package/dist/cli.d.ts.map +1 -1
  20. package/dist/cli.js +20 -10
  21. package/dist/commands/advise.d.ts.map +1 -1
  22. package/dist/commands/advise.js +65 -42
  23. package/dist/commands/assurance.d.ts.map +1 -1
  24. package/dist/commands/assurance.js +21 -19
  25. package/dist/commands/catalog/list.js +2 -2
  26. package/dist/commands/catalog/methods.js +3 -3
  27. package/dist/commands/catalog/show.js +2 -2
  28. package/dist/commands/catalog/validate.js +2 -2
  29. package/dist/commands/completeness.js +2 -2
  30. package/dist/commands/config/doctor.js +1 -1
  31. package/dist/commands/config/edit.js +1 -1
  32. package/dist/commands/config/get.js +1 -1
  33. package/dist/commands/config/set.js +1 -1
  34. package/dist/commands/evidence/affirm.d.ts.map +1 -1
  35. package/dist/commands/evidence/affirm.js +4 -7
  36. package/dist/commands/evidence/audit.d.ts +8 -0
  37. package/dist/commands/evidence/audit.d.ts.map +1 -1
  38. package/dist/commands/evidence/audit.js +39 -36
  39. package/dist/commands/evidence/baseline.js +5 -5
  40. package/dist/commands/evidence/gc.d.ts.map +1 -1
  41. package/dist/commands/evidence/gc.js +3 -3
  42. package/dist/commands/evidence/index.js +1 -1
  43. package/dist/commands/evidence/record.js +3 -3
  44. package/dist/commands/matrix.js +1 -1
  45. package/dist/commands/module/ensure-defaults.js +3 -3
  46. package/dist/commands/module/install.js +2 -2
  47. package/dist/commands/module/list.js +2 -2
  48. package/dist/commands/module/remove.js +2 -2
  49. package/dist/commands/review.js +1 -1
  50. package/dist/commands/to-plan.js +1 -1
  51. package/dist/commands/update.js +2 -2
  52. package/dist/commands/write.js +3 -3
  53. package/dist/{completeness-Bl40nk02.js → completeness-F657dxMp.js} +1 -1
  54. package/dist/evidence/adapters/cargo-mutants.d.ts.map +1 -1
  55. package/dist/evidence/index.d.ts +1 -1
  56. package/dist/evidence/index.d.ts.map +1 -1
  57. package/dist/evidence/record.d.ts.map +1 -1
  58. package/dist/evidence/types.d.ts +23 -0
  59. package/dist/evidence/types.d.ts.map +1 -1
  60. package/dist/{evidence-DopNnj0E.js → evidence-BA5vyZJk.js} +134 -136
  61. package/dist/{flow-command-zfisQlK7.js → flow-command-D1vJU-7a.js} +14 -14
  62. package/dist/index.js +6 -6
  63. package/dist/modules-BWyZ7kVN.js +23 -0
  64. package/dist/{plugins-7DX6rIfX.js → plugins-Czi2OyDB.js} +1 -1
  65. package/dist/quire/contract.d.ts +8 -2
  66. package/dist/quire/contract.d.ts.map +1 -1
  67. package/dist/quire/exec.d.ts +12 -0
  68. package/dist/quire/exec.d.ts.map +1 -1
  69. package/dist/quire/index.d.ts +2 -2
  70. package/dist/quire/index.d.ts.map +1 -1
  71. package/dist/quire/types.d.ts +131 -0
  72. package/dist/quire/types.d.ts.map +1 -1
  73. package/dist/{quire-VZjWaHph.js → quire-UzoK3Azf.js} +281 -273
  74. package/dist/schemas/coverage-v1.schema.json +89 -5
  75. package/dist/{version-DxqfsO8n.js → version-G_RI6TD4.js} +5 -5
  76. package/dist/{write-Dkpd6XwW.js → write-BJ9rTVAS.js} +1 -1
  77. package/package.json +6 -4
  78. package/skills/gap-analysis/references/step-3-matrix-verification.md +1 -1
  79. package/skills/spec-dependency-analysis/SKILL.md +15 -0
  80. package/skills/spec-failure-domain-analysis/SKILL.md +15 -0
  81. package/skills/spec-fuzz/SKILL.md +8 -0
  82. package/skills/spec-integrity-analysis/SKILL.md +15 -0
  83. package/skills/spec-matrix/SKILL.md +9 -4
  84. package/skills/spec-matrix/assets/test-matrix-example.md +2 -2
  85. package/skills/spec-matrix/assets/test-matrix-template.md +3 -3
  86. package/skills/spec-matrix/workflow-assets/dist/index.d.ts +146 -0
  87. package/skills/spec-matrix/workflow-assets/dist/index.d.ts.map +1 -0
  88. package/skills/spec-matrix/workflow-assets/dist/index.js +7525 -0
  89. package/skills/spec-matrix/workflow-assets/dist/invariants.d.ts +6 -0
  90. package/skills/spec-matrix/workflow-assets/dist/invariants.d.ts.map +1 -0
  91. package/skills/spec-review/SKILL.md +8 -0
  92. package/skills/spec-review/workflow-assets/dist/index.d.ts +146 -0
  93. package/skills/spec-review/workflow-assets/dist/index.d.ts.map +1 -0
  94. package/skills/spec-review/workflow-assets/dist/index.js +7525 -0
  95. package/skills/spec-review/workflow-assets/dist/invariants.d.ts +6 -0
  96. package/skills/spec-review/workflow-assets/dist/invariants.d.ts.map +1 -0
  97. package/skills/spec-review/workflow-assets/skills/review/SKILL.md +4 -4
  98. package/skills/spec-review/workflow-assets/skills/review/scripts/invariants.js +3 -2
  99. package/skills/spec-review/workflow-assets/skills/review/workflows/review/def.yaml +3 -3
  100. package/skills/spec-risk-complexity-analysis/SKILL.md +15 -0
  101. package/skills/spec-scope-boundary-analysis/SKILL.md +15 -0
  102. package/skills/spec-to-plan/workflow-assets/dist/index.d.ts +146 -0
  103. package/skills/spec-to-plan/workflow-assets/dist/index.d.ts.map +1 -0
  104. package/skills/spec-to-plan/workflow-assets/dist/index.js +7525 -0
  105. package/skills/spec-to-plan/workflow-assets/dist/invariants.d.ts +6 -0
  106. package/skills/spec-to-plan/workflow-assets/dist/invariants.d.ts.map +1 -0
  107. package/dist/modules-BEWi5WeN.js +0 -23
@@ -28,11 +28,21 @@
28
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
29
  "items": { "$ref": "#/$defs/NoSymbolRow" }
30
30
  },
31
+ "undeclared_statuses": {
32
+ "type": "array",
33
+ "description": "FR-050-AC-21 (CR-083): rows whose authored status value the module's `traceability.status` vocabulary classes as nothing. ABSENT — not empty — for a corpus whose every status value is declared, which is what keeps FR-050-AC-7 byte-identity. Additive under FR-055-CON-3: no existing key changes meaning, no required key is added, and a consumer written against this schema before the key existed reads an unchanged payload from a conformant corpus.",
34
+ "items": { "$ref": "#/$defs/UndeclaredStatus" }
35
+ },
31
36
  "untracked_symbols": {
32
37
  "type": "array",
33
38
  "description": "FR-050-AC-5: source symbols whose trace tag resolves to no declared target or reference row.",
34
39
  "items": { "$ref": "#/$defs/UntrackedSymbol" }
35
40
  },
41
+ "shared_trace_ids": {
42
+ "type": "array",
43
+ "description": "FR-050-AC-23 (CR-087): trace ids bound by more than one distinct source symbol. One id names one symbol; a row backed by N symbols stays green while N-1 of its tests rot. ABSENT — not empty — for a corpus whose every id is uniquely bound, which is what keeps FR-050-AC-7 byte-identity. Carries no weight in `totals`, and `--strict` does not gate on it in this revision. Additive under FR-055-CON-3.",
44
+ "items": { "$ref": "#/$defs/SharedTraceId" }
45
+ },
36
46
  "groups": {
37
47
  "type": "array",
38
48
  "description": "FR-050-AC-6: backed/total counts per minting document and target kind.",
@@ -58,6 +68,16 @@
58
68
  "description": "FR-062: requirement -> production-code edges. Absent for a module declaring no `implements` marker forms. Carries no weight in `totals` — scope is not evidence.",
59
69
  "items": { "$ref": "#/$defs/ImplementsRecord" }
60
70
  },
71
+ "vocabulary_coverage": {
72
+ "type": "array",
73
+ "description": "FR-059-AC-9 (CR-091, #179): one record per declared coverage-vocabulary value, classified owned / excused / unowned with the deciding documents. The `quire validate` warning stream reports only the unowned residue; these records let a consumer tell an owned value from an excused one without opening bundle frontmatter. ABSENT — not empty — for a module declaring no `vocabulary_coverage`, which is what keeps FR-050-AC-7 byte-identity. Additive under FR-055-CON-3.",
74
+ "items": { "$ref": "#/$defs/VocabularyValueRecord" }
75
+ },
76
+ "excluded_source_files": {
77
+ "type": "integer",
78
+ "minimum": 1,
79
+ "description": "FR-050-AC-24 (#215): source files a declared `source_exclude` glob removed from the symbol walk. ABSENT — never 0 — for a model declaring no `source_exclude` or one whose globs match nothing, which is what keeps FR-050-AC-7 byte-identity. Additive under FR-055-CON-3. Without it an over-broad glob silently drops legitimate backing and the report reads as a coverage regression."
80
+ },
61
81
  "totals": { "$ref": "#/$defs/CoverageTotals" }
62
82
  },
63
83
  "$defs": {
@@ -76,7 +96,8 @@
76
96
  "type": "array",
77
97
  "items": { "type": "string" },
78
98
  "description": "Trace ids the row is answerable for — its own plus the ids it references — none of which any symbol backs."
79
- }
99
+ },
100
+ "line": { "type": "integer", "minimum": 1, "description": "1-based document line of the matrix row (#210). Additive under FR-055-CON-3: absent on a payload from an engine predating the field." }
80
101
  }
81
102
  },
82
103
  "StatusLie": {
@@ -88,7 +109,20 @@
88
109
  "document": { "type": "string" },
89
110
  "row_id": { "type": ["string", "null"] },
90
111
  "status": { "type": "string", "description": "The authored status value, verbatim." },
91
- "target_ids": { "type": "array", "items": { "type": "string" } }
112
+ "target_ids": { "type": "array", "items": { "type": "string" } },
113
+ "line": { "type": "integer", "minimum": 1, "description": "1-based document line of the matrix row (#210). Additive under FR-055-CON-3." }
114
+ }
115
+ },
116
+ "UndeclaredStatus": {
117
+ "type": "object",
118
+ "additionalProperties": false,
119
+ "required": ["reference", "document", "status"],
120
+ "properties": {
121
+ "reference": { "type": "string", "description": "The declaration that produced the row." },
122
+ "document": { "type": "string", "description": "Scope-relative path, `/`-separated on every platform." },
123
+ "row_id": { "type": ["string", "null"] },
124
+ "status": { "type": "string", "description": "The authored status value, verbatim. No class is carried: having none is the finding." },
125
+ "line": { "type": "integer", "minimum": 1, "description": "1-based document line of the matrix row (#210). Duplicate byte-identical rows still collapse to one record (CR-086), which carries the first duplicate's line. Additive under FR-055-CON-3." }
92
126
  }
93
127
  },
94
128
  "NoSymbolRow": {
@@ -100,7 +134,8 @@
100
134
  "document": { "type": "string" },
101
135
  "row_id": { "type": ["string", "null"] },
102
136
  "test_type": { "type": "string", "description": "The declared test-type value that exempts the row." },
103
- "target_ids": { "type": "array", "items": { "type": "string" } }
137
+ "target_ids": { "type": "array", "items": { "type": "string" } },
138
+ "line": { "type": "integer", "minimum": 1, "description": "1-based document line of the matrix row (#210). Additive under FR-055-CON-3." }
104
139
  }
105
140
  },
106
141
  "UntrackedSymbol": {
@@ -110,7 +145,31 @@
110
145
  "properties": {
111
146
  "path": { "type": "string" },
112
147
  "symbol": { "type": "string" },
113
- "trace_id": { "type": "string" }
148
+ "trace_id": { "type": "string" },
149
+ "line": { "type": "integer", "minimum": 1, "description": "1-based declaration line of the tagged symbol (#210). Additive under FR-055-CON-3." }
150
+ }
151
+ },
152
+ "SharedTraceId": {
153
+ "type": "object",
154
+ "additionalProperties": false,
155
+ "required": ["trace_id", "symbols"],
156
+ "properties": {
157
+ "trace_id": { "type": "string", "minLength": 1, "description": "The trace id, exactly as the binding forms yield it." },
158
+ "symbols": {
159
+ "type": "array",
160
+ "minItems": 2,
161
+ "items": { "$ref": "#/$defs/SharedTraceSymbol" },
162
+ "description": "The distinct binding symbols, ordered by (path, symbol). Always at least two — a uniquely bound id mints no record."
163
+ }
164
+ }
165
+ },
166
+ "SharedTraceSymbol": {
167
+ "type": "object",
168
+ "additionalProperties": false,
169
+ "required": ["path", "symbol"],
170
+ "properties": {
171
+ "path": { "type": "string", "minLength": 1 },
172
+ "symbol": { "type": "string", "minLength": 1 }
114
173
  }
115
174
  },
116
175
  "GroupCounts": {
@@ -151,7 +210,32 @@
151
210
  "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."
152
211
  },
153
212
  "message": { "type": "string" },
154
- "path": { "type": ["string", "null"] }
213
+ "path": { "type": ["string", "null"] },
214
+ "value": {
215
+ "type": "string",
216
+ "description": "FR-054-AC-12 (CR-091, #179): the vocabulary or catalog value the diagnostic is about, verbatim, when it is about exactly one. `uncatalogued-verification-method` carries the authored method here — the identical string the Obligation records carry in `method` — so a consumer distinguishes an uncatalogued value from a genuine method disagreement by an equality join instead of parsing the message (quoin#168). Absent when the diagnostic is not about one value. Additive under FR-055-CON-3."
217
+ }
218
+ }
219
+ },
220
+ "VocabularyValueRecord": {
221
+ "type": "object",
222
+ "additionalProperties": false,
223
+ "required": ["vocabulary", "archetype", "field", "check", "value", "state", "documents"],
224
+ "properties": {
225
+ "vocabulary": { "type": "string", "minLength": 1, "description": "The `vocabulary_coverage` declaration's name." },
226
+ "archetype": { "type": "string", "minLength": 1, "description": "The projected archetype (the declaration's `from`)." },
227
+ "field": { "type": "string", "minLength": 1, "description": "The frontmatter field whose schema `enum` is the vocabulary." },
228
+ "check": { "type": "string", "minLength": 1, "description": "The declared `<check>` severity token, joining the record to the warning stream's findings." },
229
+ "value": { "type": "string", "minLength": 1, "description": "The vocabulary value, verbatim from the schema enum." },
230
+ "state": {
231
+ "enum": ["owned", "excused", "unowned"],
232
+ "description": "owned: a projected document claims it (wins when a value is both claimed and recorded absent). excused: the declared justified-absence field records it; whether the excuse is justified is verdict policy and deliberately not stated here (FR-059-CON-2). unowned: neither. Closed deliberately, unlike CoverageDiagnostic.reason — the states are the check's own semantics, not a growing vocabulary."
233
+ },
234
+ "documents": {
235
+ "type": "array",
236
+ "items": { "type": "string", "minLength": 1 },
237
+ "description": "Scope-relative documents (`/`-separated on every platform) that decide the state: the claimants for owned, the justified-absence recorders for excused, empty for unowned."
238
+ }
155
239
  }
156
240
  },
157
241
  "Obligation": {
@@ -1,9 +1,9 @@
1
- import { readFileSync as e } from "node:fs";
2
- import { dirname as t, join as n } from "node:path";
3
- import { fileURLToPath as r } from "node:url";
1
+ import { fileURLToPath as e } from "node:url";
2
+ import { readFileSync as t } from "node:fs";
3
+ import { dirname as n, join as r } from "node:path";
4
4
  //#region src/version.ts
5
5
  function i() {
6
- let i = t(t(r(import.meta.url))), a = JSON.parse(e(n(i, "package.json"), "utf8"));
6
+ let i = n(n(e(import.meta.url))), a = JSON.parse(t(r(i, "package.json"), "utf8"));
7
7
  if (typeof a.version != "string") throw Error("package.json version is missing");
8
8
  return a.version;
9
9
  }
@@ -11,7 +11,7 @@ function a(e) {
11
11
  return e || i();
12
12
  }
13
13
  function o() {
14
- return a("0.21.2");
14
+ return a("0.21.8");
15
15
  }
16
16
  //#endregion
17
17
  export { a as n, o as t };
@@ -1,4 +1,4 @@
1
- import { i as e } from "./base-DVl7skpc.js";
1
+ import { i as e } from "./base-DNieRzIg.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.21.2",
4
+ "version": "0.21.8",
5
5
  "license": "AGPL-3.0-or-later",
6
6
  "type": "module",
7
7
  "files": [
@@ -57,7 +57,8 @@
57
57
  "test:coverage": "vitest run --coverage",
58
58
  "test:json": "vitest run --reporter=json --outputFile=report.json || true",
59
59
  "test:evals": "node evals/run.mjs",
60
- "lint": "eslint \"src/**/*.{ts,tsx,js,jsx}\" \"tests/**/*.{ts,tsx,js,jsx}\" && pnpm run format:check",
60
+ "lint": "pnpm run typecheck && eslint \"src/**/*.{ts,tsx,js,jsx}\" \"tests/**/*.{ts,tsx,js,jsx}\" && pnpm run format:check",
61
+ "validate": "quire validate \"spec/**/*.md\" \"plan/**/*.md\" \"reviews/*.md\"",
61
62
  "format": "prettier --write .",
62
63
  "format:check": "prettier --check .",
63
64
  "build": "vite build && node scripts/copy-quire-schemas.mjs",
@@ -85,7 +86,8 @@
85
86
  "test-results:find": "./node_modules/.bin/jest-results find",
86
87
  "test-results:failed": "./node_modules/.bin/jest-results failed",
87
88
  "test-results:errors": "./node_modules/.bin/jest-results errors",
88
- "test-results:warnings": "./node_modules/.bin/jest-results warnings"
89
+ "test-results:warnings": "./node_modules/.bin/jest-results warnings",
90
+ "typecheck": "tsc --noEmit -p tsconfig.json"
89
91
  },
90
92
  "dependencies": {
91
93
  "@agent-ix/filament-plan-sync": ">=0.1.0",
@@ -97,7 +99,7 @@
97
99
  "zod": ">=4.4.3"
98
100
  },
99
101
  "devDependencies": {
100
- "@agent-ix/quire-cli": "^0.26.0",
102
+ "@agent-ix/quire-cli": "^0.29.0",
101
103
  "@types/node": "26.1.2",
102
104
  "@typescript-eslint/eslint-plugin": "8.66.0",
103
105
  "@typescript-eslint/parser": "8.66.0",
@@ -13,7 +13,7 @@ stay here — the command reports and does not judge (quire-rs FR-050-CON-1).
13
13
  Built by `spec-matrix` (`quoin/skills/spec-matrix/SKILL.md`). Key tables:
14
14
 
15
15
  - **Test Case Summary** — `Test ID | Title | Type | Priority | Traces To | Status`, where
16
- `Test ID` = `TC-xxx`, `Traces To` = `FR-XXX-AC-X` etc., `Status` ∈ `✅ ⚠️ ❌ 🚧 ⛔`.
16
+ `Test ID` = `TC-xxx`, `Traces To` = `FR-XXX-AC-X` etc., `Status` ∈ `✅ ❌ 🚧 ⛔` (`⚠️` retired — partial work is `🚧`).
17
17
  - **Per-requirement coverage** — StR/US/FR/NFR → AC → TC → Status tables.
18
18
 
19
19
  What each column *means* is not this skill's knowledge either: the active module declares it
@@ -73,3 +73,18 @@ None detected.
73
73
  - Every edge in the graph corresponds to an explicit prerequisite — no "soft" dependencies.
74
74
  - No cycles.
75
75
  - Topological order respects: all enablement before any feature that depends on it.
76
+
77
+ ## Output contract
78
+
79
+ This skill emits one **`SpecReview`** under `reviews/YY-MM-DD-<slug>.md` with
80
+ `analysis: dependency` in its frontmatter.
81
+
82
+ Stated here because nothing checked it. The module declares an `analysis`
83
+ vocabulary of eleven values; five of them named a skill that never said it
84
+ emitted under them, so a skill and its declared output were unlinked and drift
85
+ between the two was invisible. `tests/skill-contracts.test.ts` now asserts the
86
+ pairing in both directions.
87
+
88
+ The document must carry a `## Summary` and a `## Findings` table — the two
89
+ sections `SpecReview`'s `body_extraction` requires — and must pass
90
+ `quire validate`.
@@ -42,3 +42,18 @@ Document any missing constraints as proposed additions:
42
42
  - **NFR**: Non-functional (resilience, performance)
43
43
  - **StR**: Structural (integrity, purity)
44
44
  - **FR**: Functional (if behavior is undefined)
45
+
46
+ ## Output contract
47
+
48
+ This skill emits one **`SpecReview`** under `reviews/YY-MM-DD-<slug>.md` with
49
+ `analysis: failure-domain` in its frontmatter.
50
+
51
+ Stated here because nothing checked it. The module declares an `analysis`
52
+ vocabulary of eleven values; five of them named a skill that never said it
53
+ emitted under them, so a skill and its declared output were unlinked and drift
54
+ between the two was invisible. `tests/skill-contracts.test.ts` now asserts the
55
+ pairing in both directions.
56
+
57
+ The document must carry a `## Summary` and a `## Findings` table — the two
58
+ sections `SpecReview`'s `body_extraction` requires — and must pass
59
+ `quire validate`.
@@ -122,3 +122,11 @@ that guessed would produce targets that do not compile.
122
122
 
123
123
  `quoin advise` supplies the mechanical half as JSON. This skill is the judgement half, and
124
124
  it records which is which in the provenance line so a reviewer can tell them apart.
125
+
126
+ ## Output contract
127
+
128
+ The `SpecReview` this skill emits carries `analysis: evidence` — the fuzz report records what a harness could and could not serve, which is an evidence claim.
129
+
130
+ Stated here because nothing checked it (quoin#202): a skill and its declared
131
+ output were unlinked, so drift between them was invisible until a document
132
+ failed validation in an unrelated session.
@@ -45,3 +45,18 @@ This skill performs a quality gate analysis on specifications (User Stories, FR/
45
45
  ## Failure Domain Check
46
46
  Before finalizing, verify against `spec-failure-domain-analysis`:
47
47
  - Extension failures, Identity keys, Evaluation purity, Topological robustness.
48
+
49
+ ## Output contract
50
+
51
+ This skill emits one **`SpecReview`** under `reviews/YY-MM-DD-<slug>.md` with
52
+ `analysis: integrity` in its frontmatter.
53
+
54
+ Stated here because nothing checked it. The module declares an `analysis`
55
+ vocabulary of eleven values; five of them named a skill that never said it
56
+ emitted under them, so a skill and its declared output were unlinked and drift
57
+ between the two was invisible. `tests/skill-contracts.test.ts` now asserts the
58
+ pairing in both directions.
59
+
60
+ The document must carry a `## Summary` and a `## Findings` table — the two
61
+ sections `SpecReview`'s `body_extraction` requires — and must pass
62
+ `quire validate`.
@@ -129,8 +129,14 @@ missing generator show up as a gap.
129
129
 
130
130
  ### `Status`
131
131
 
132
- `✅` complete · `⚠️` partial · `❌` failed · `🚧` in progress · `⛔` retired.
133
- A marker may be followed by text (`✅ Complete`); the marker must come first.
132
+ `✅` complete · `❌` failed · `🚧` in progress/pending · `⛔` retired.
133
+ A marker may be followed by text (`🚧 scale evidence deferred`); the marker
134
+ must come first — the note carries information the bare marker cannot.
135
+
136
+ `⚠️` is **retired** and no longer validates. It was admitted by the contract
137
+ and classed by the traceability model as nothing, so every row carrying it was
138
+ exempt from the status-lie check by construction. Partial work is `🚧`; a
139
+ second form for one meaning enforces nothing.
134
140
 
135
141
  ### `Traces To`
136
142
 
@@ -175,7 +181,6 @@ Use template section `## Integration Test Matrix` with:
175
181
  ## Markers
176
182
 
177
183
  - ✅ Complete
178
- - ⚠️ Partial
179
184
  - ❌ Missing
180
- - 🚧 In Progress
185
+ - 🚧 In Progress / Partial / Pending
181
186
  - ⛔ Retired
@@ -50,8 +50,8 @@ This is an example test matrix demonstrating comprehensive test coverage for the
50
50
  | TC-012 | Full Clone Option | Integration | P2 | FR-001-OPT-B | 🚧 In Progress |
51
51
  | TC-013 | Repository at Size Limit | Integration | P2 | FR-001-CON-1 | 🚧 In Progress |
52
52
  | TC-014 | Clone at Timeout Boundary | Integration | P2 | FR-001-CON-2 | 🚧 In Progress |
53
- | TC-015 | Monorepo with Multiple K8s Projects | Integration | P2 | EC-001 | ⚠️ Partial |
54
- | TC-016 | Mixed K8s and Non-K8s YAML Files | Integration | P2 | EC-002 | ⚠️ Partial |
53
+ | TC-015 | Monorepo with Multiple K8s Projects | Integration | P2 | EC-001 | 🚧 In Progress |
54
+ | TC-016 | Mixed K8s and Non-K8s YAML Files | Integration | P2 | EC-002 | 🚧 In Progress |
55
55
  | TC-017 | Malformed YAML Handling | Integration | P1 | EC-003 | ❌ Missing |
56
56
  | TC-018 | Symlinks to K8s Configs | Integration | P2 | EC-004 | ❌ Missing |
57
57
  | TC-019 | Repository Changes During Clone | Integration | P2 | EC-005 | ❌ Missing |
@@ -38,8 +38,8 @@ This matrix ensures comprehensive test coverage by transforming requirements int
38
38
 
39
39
  | Test ID | Title | Type | Priority | Traces To | Status |
40
40
  |---------|-------|------|----------|-----------|--------|
41
- | TC-001 | [Test Title] | [Unit/Integration/E2E/Property] | [P0/P1/P2/P3/P4] | [US-XXX-AC-X] | [✅/⚠️/❌/🚧/⛔] |
42
- | TC-002 | [Test Title] | [Unit/Integration/E2E/Property] | [P0/P1/P2/P3/P4] | [FR-XXX-AC-X] | [✅/⚠️/❌/🚧/⛔] |
41
+ | TC-001 | [Test Title] | [Unit/Integration/E2E/Property] | [P0/P1/P2/P3/P4] | [US-XXX-AC-X] | [✅/❌/🚧/⛔] |
42
+ | TC-002 | [Test Title] | [Unit/Integration/E2E/Property] | [P0/P1/P2/P3/P4] | [FR-XXX-AC-X] | [✅/❌/🚧/⛔] |
43
43
 
44
44
  **Note**: Detailed test case definitions should be in separate files in `test-cases/` directory.
45
45
 
@@ -82,7 +82,7 @@ is validated, so `Unit / pg_test` and other compounds are rejected.
82
82
  | Integration ID | Purpose | Service | Type | Test Cases | Status |
83
83
  |----------------|---------|---------|------|------------|--------|
84
84
  | INT-010 | Data persistence | postgres.ix | database | TC-INT-010a, TC-INT-010b, TC-INT-010c | ✅ |
85
- | INT-011 | Cache operations | redis.ix | service | TC-INT-011, TC-INT-012 | ⚠️ |
85
+ | INT-011 | Cache operations | redis.ix | service | TC-INT-011, TC-INT-012 | 🚧 |
86
86
  | INT-012 | Message publishing | event-bus | event | TC-INT-013, TC-INT-014, TC-INT-015 | ❌ |
87
87
 
88
88
  ### Browser/UI Integrations
@@ -0,0 +1,146 @@
1
+ export interface SpecSkill {
2
+ readonly id: string;
3
+ readonly path: string;
4
+ readonly workflows: readonly string[];
5
+ readonly category: "create-edit" | "write" | "derive" | "review" | "analysis" | "planning" | "graph";
6
+ }
7
+ export declare const specSkills: readonly [{
8
+ readonly id: "spec-create";
9
+ readonly path: "skills/create";
10
+ readonly workflows: readonly ["spec-create", "spec-edit", "spec-batch"];
11
+ readonly category: "create-edit";
12
+ }, {
13
+ readonly id: "spec-write-str";
14
+ readonly path: "skills/write-str";
15
+ readonly workflows: readonly ["write-str"];
16
+ readonly category: "write";
17
+ }, {
18
+ readonly id: "spec-write-us";
19
+ readonly path: "skills/write-us";
20
+ readonly workflows: readonly ["write-us"];
21
+ readonly category: "write";
22
+ }, {
23
+ readonly id: "spec-write-fr";
24
+ readonly path: "skills/write-fr";
25
+ readonly workflows: readonly ["write-fr"];
26
+ readonly category: "write";
27
+ }, {
28
+ readonly id: "spec-write-nfr";
29
+ readonly path: "skills/write-nfr";
30
+ readonly workflows: readonly ["write-nfr"];
31
+ readonly category: "write";
32
+ }, {
33
+ readonly id: "spec-write-it";
34
+ readonly path: "skills/write-it";
35
+ readonly workflows: readonly ["write-it"];
36
+ readonly category: "write";
37
+ }, {
38
+ readonly id: "spec-us-to-fr";
39
+ readonly path: "skills/us-to-fr";
40
+ readonly workflows: readonly ["us-to-fr"];
41
+ readonly category: "derive";
42
+ }, {
43
+ readonly id: "spec-convert-objects";
44
+ readonly path: "skills/convert-objects";
45
+ readonly workflows: readonly ["convert-objects"];
46
+ readonly category: "derive";
47
+ }, {
48
+ readonly id: "spec-matrix";
49
+ readonly path: "skills/matrix";
50
+ readonly workflows: readonly ["matrix"];
51
+ readonly category: "review";
52
+ }, {
53
+ readonly id: "spec-review";
54
+ readonly path: "skills/review";
55
+ readonly workflows: readonly ["review"];
56
+ readonly category: "review";
57
+ }, {
58
+ readonly id: "spec-analysis-integrity";
59
+ readonly path: "skills/analysis-integrity";
60
+ readonly workflows: readonly ["analysis-integrity"];
61
+ readonly category: "analysis";
62
+ }, {
63
+ readonly id: "spec-analysis-failure-domain";
64
+ readonly path: "skills/analysis-failure-domain";
65
+ readonly workflows: readonly ["analysis-failure-domain"];
66
+ readonly category: "analysis";
67
+ }, {
68
+ readonly id: "spec-analysis-dependency";
69
+ readonly path: "skills/analysis-dependency";
70
+ readonly workflows: readonly ["analysis-dependency"];
71
+ readonly category: "analysis";
72
+ }, {
73
+ readonly id: "spec-analysis-evidence";
74
+ readonly path: "skills/analysis-evidence";
75
+ readonly workflows: readonly ["analysis-evidence"];
76
+ readonly category: "analysis";
77
+ }, {
78
+ readonly id: "spec-analysis-risk-complexity";
79
+ readonly path: "skills/analysis-risk-complexity";
80
+ readonly workflows: readonly ["analysis-risk-complexity"];
81
+ readonly category: "analysis";
82
+ }, {
83
+ readonly id: "spec-analysis-scope-boundary";
84
+ readonly path: "skills/analysis-scope-boundary";
85
+ readonly workflows: readonly ["analysis-scope-boundary"];
86
+ readonly category: "analysis";
87
+ }, {
88
+ readonly id: "spec-object-review";
89
+ readonly path: "skills/object-review";
90
+ readonly workflows: readonly ["object-review"];
91
+ readonly category: "review";
92
+ }, {
93
+ readonly id: "spec-app-review";
94
+ readonly path: "skills/app-review";
95
+ readonly workflows: readonly ["app-review"];
96
+ readonly category: "review";
97
+ }, {
98
+ readonly id: "spec-security-analysis";
99
+ readonly path: "skills/security-analysis";
100
+ readonly workflows: readonly ["security-analysis"];
101
+ readonly category: "analysis";
102
+ }, {
103
+ readonly id: "spec-blueprint";
104
+ readonly path: "skills/blueprint";
105
+ readonly workflows: readonly ["blueprint"];
106
+ readonly category: "planning";
107
+ }, {
108
+ readonly id: "spec-task-generation-readiness";
109
+ readonly path: "skills/task-generation-readiness";
110
+ readonly workflows: readonly ["task-generation-readiness"];
111
+ readonly category: "planning";
112
+ }, {
113
+ readonly id: "spec-to-plan";
114
+ readonly path: "skills/to-plan";
115
+ readonly workflows: readonly ["to-plan"];
116
+ readonly category: "planning";
117
+ }, {
118
+ readonly id: "spec-implementation-gap-analysis";
119
+ readonly path: "skills/implementation-gap-analysis";
120
+ readonly workflows: readonly ["implementation-gap-analysis"];
121
+ readonly category: "analysis";
122
+ }, {
123
+ readonly id: "spec-core-search";
124
+ readonly path: "skills/core-search";
125
+ readonly workflows: readonly ["core-search"];
126
+ readonly category: "graph";
127
+ }, {
128
+ readonly id: "spec-core-explore-objects";
129
+ readonly path: "skills/core-explore-objects";
130
+ readonly workflows: readonly ["core-explore-objects"];
131
+ readonly category: "graph";
132
+ }, {
133
+ readonly id: "spec-core-trace-analysis";
134
+ readonly path: "skills/core-trace-analysis";
135
+ readonly workflows: readonly ["core-trace-analysis"];
136
+ readonly category: "graph";
137
+ }, {
138
+ readonly id: "spec-core-review";
139
+ readonly path: "skills/core-review";
140
+ readonly workflows: readonly ["core-review"];
141
+ readonly category: "graph";
142
+ }];
143
+ export declare function skillById(id: string): SpecSkill | undefined;
144
+ export declare function workflowSkillPath(workflowName: string): string | undefined;
145
+ export { artifactFrontmatterValid, artifactRelationshipsResolve, clearProjectRegistryCache, specInvariants, } from './invariants.js';
146
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EACb,aAAa,GACb,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,UAAU,GACV,OAAO,CAAC;CACb;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmKkB,CAAC;AAE1C,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,cAAc,GACf,MAAM,iBAAiB,CAAC"}