@agent-ix/quoin 0.12.3 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codex-plugin/plugin.json +1 -1
  3. package/default-modules.yaml +2 -2
  4. package/dist/{base-B329cz7z.js → base-BIELM-Fk.js} +13 -13
  5. package/dist/cli.js +2 -2
  6. package/dist/commands/catalog/list.js +2 -2
  7. package/dist/commands/catalog/show.js +2 -2
  8. package/dist/commands/catalog/validate.js +2 -2
  9. package/dist/commands/config/doctor.js +1 -1
  10. package/dist/commands/config/edit.js +1 -1
  11. package/dist/commands/config/get.js +1 -1
  12. package/dist/commands/config/set.js +1 -1
  13. package/dist/commands/matrix.js +1 -1
  14. package/dist/commands/module/ensure-defaults.js +3 -3
  15. package/dist/commands/module/install.js +2 -2
  16. package/dist/commands/module/list.js +2 -2
  17. package/dist/commands/module/remove.js +2 -2
  18. package/dist/commands/review.js +1 -1
  19. package/dist/commands/to-plan.js +1 -1
  20. package/dist/commands/update.js +2 -2
  21. package/dist/commands/write.js +5 -5
  22. package/dist/{flow-command-D3i7cRHX.js → flow-command-Cu3AeDeV.js} +1 -1
  23. package/dist/index.js +6 -6
  24. package/dist/{modules-B5-Mw8IC.js → modules-BumGtAYj.js} +4 -3
  25. package/dist/{plugins-d-MnIqNv.js → plugins-DkBB_VkF.js} +1 -1
  26. package/dist/{version-D0yl2myP.js → version-4FRTZpv_.js} +1 -1
  27. package/dist/{write-BTZ4GeEH.js → write-UmBcjFtj.js} +3 -2
  28. package/package.json +17 -20
  29. package/skills/gap-analysis/SKILL.md +12 -0
  30. package/skills/gap-analysis/references/step-3-matrix-verification.md +24 -1
  31. package/skills/gap-analysis/references/step-6-specreview-artifact.md +7 -0
  32. package/skills/spec-correctness/references/step-6-review-artifact.md +13 -0
  33. package/skills/spec-correctness/references/step-7-report-and-handoff.md +21 -3
  34. package/skills/spec-ears-analysis/SKILL.md +13 -0
  35. package/skills/spec-matrix/SKILL.md +13 -0
  36. package/skills/spec-review/SKILL.md +13 -0
  37. package/skills/spec-to-plan/SKILL.md +13 -0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "quoin",
3
- "version": "0.1.0",
3
+ "version": "0.14.0",
4
4
  "description": "Spec authoring, review, matrix, and planning skills for Agent IX.",
5
5
  "author": {
6
6
  "name": "Agent IX"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "quoin",
3
- "version": "0.1.0",
3
+ "version": "0.14.0",
4
4
  "description": "Spec authoring, review, matrix, and planning skills for Agent IX.",
5
5
  "author": {
6
6
  "name": "Agent IX",
@@ -28,13 +28,13 @@ entries:
28
28
  ref: v0.5.0
29
29
 
30
30
  - name: spec-artifacts-process
31
- version: "0.11.0"
31
+ version: "0.13.0"
32
32
  defaultEnabled: true
33
33
  source:
34
34
  type: git-subdir
35
35
  url: agent-ix/spec-artifacts-process
36
36
  path: spec_artifacts_process
37
- ref: v0.11.0
37
+ ref: v0.13.0
38
38
 
39
39
  - name: spec-objects-business
40
40
  version: "0.6.0"
@@ -1,4 +1,4 @@
1
- import { t as e } from "./version-D0yl2myP.js";
1
+ import { t as e } from "./version-4FRTZpv_.js";
2
2
  import { BaseCommand as t, maybeOfferUpdate as n } from "@agent-ix/ix-cli-core";
3
3
  import { existsSync as r, readFileSync as i, readdirSync as a, statSync as o } from "node:fs";
4
4
  import { basename as s, join as c, resolve as l } from "node:path";
@@ -24,35 +24,35 @@ function h(e = m()) {
24
24
  let e = v(o);
25
25
  if (!e || r.has(e)) continue;
26
26
  r.add(e);
27
- let l = d(i(c(e, "manifest.yaml"), "utf8")), u = x(l.name) ?? s(e);
28
- if (a.has(u)) continue;
29
- a.add(u);
30
- let f = b(l.artifact_types), p = b(l.object_types);
27
+ let l = c(e, "manifest.yaml"), u = d(i(l, "utf8")), f = x(u.name) ?? s(e);
28
+ if (a.has(f)) continue;
29
+ a.add(f);
30
+ let p = b(u.artifact_types), m = b(u.object_types);
31
31
  t.push({
32
- name: u,
33
- version: x(l.version),
32
+ name: f,
33
+ version: x(u.version),
34
34
  root: e,
35
- artifactTypes: f.map((e) => String(e.name)),
36
- objectTypes: p.map((e) => String(e.name))
35
+ artifactTypes: p.map((e) => String(e.name)),
36
+ objectTypes: m.map((e) => String(e.name))
37
37
  });
38
- for (let t of f) {
38
+ for (let t of p) {
39
39
  let r = String(t.name), i = x(t.frontmatter_schema_ref);
40
40
  n.push({
41
41
  name: r,
42
42
  kind: "artifact",
43
- moduleName: u,
43
+ moduleName: f,
44
44
  moduleRoot: e,
45
45
  schemaRef: i,
46
46
  schemaPath: i ? c(e, i) : void 0,
47
47
  skeletonPath: y(e, r)
48
48
  });
49
49
  }
50
- for (let t of p) {
50
+ for (let t of m) {
51
51
  let r = String(t.name);
52
52
  n.push({
53
53
  name: r,
54
54
  kind: "object",
55
- moduleName: u,
55
+ moduleName: f,
56
56
  moduleRoot: e,
57
57
  skeletonPath: y(e, r)
58
58
  });
package/dist/cli.js CHANGED
@@ -1,11 +1,11 @@
1
- import { n as e, t } from "./version-D0yl2myP.js";
1
+ import { n as e, t } from "./version-4FRTZpv_.js";
2
2
  import { run as n } from "@agent-ix/ix-cli-core";
3
3
  //#region src/cli.ts
4
4
  function r(e) {
5
5
  let t = [...new Set(e.commands.filter((e) => !e.hidden).map((e) => e.id.split(":")[0]))].sort();
6
6
  return `Usage: ${e.bin} <command> [options]\n\nCommands: ${t.join(", ")}\n\nRun \`${e.bin} <command> --help\` for details.`;
7
7
  }
8
- var i = new Set([
8
+ var i = /* @__PURE__ */ new Set([
9
9
  "--version",
10
10
  "-v",
11
11
  "version"
@@ -1,5 +1,5 @@
1
- import { o as e, t } from "../../base-B329cz7z.js";
2
- import { n } from "../../modules-B5-Mw8IC.js";
1
+ import { o as e, t } from "../../base-BIELM-Fk.js";
2
+ import { n } from "../../modules-BumGtAYj.js";
3
3
  import { Flags as r } from "@oclif/core";
4
4
  //#region src/commands/catalog/list.ts
5
5
  var i = class i extends t {
@@ -1,5 +1,5 @@
1
- import { i as e, o as t, t as n } from "../../base-B329cz7z.js";
2
- import { n as r } from "../../modules-B5-Mw8IC.js";
1
+ import { i as e, o as t, t as n } from "../../base-BIELM-Fk.js";
2
+ import { n as r } from "../../modules-BumGtAYj.js";
3
3
  import { Args as i, Flags as a } from "@oclif/core";
4
4
  //#region src/commands/catalog/show.ts
5
5
  var o = class o extends n {
@@ -1,5 +1,5 @@
1
- import { o as e, t } from "../../base-B329cz7z.js";
2
- import { n } from "../../modules-B5-Mw8IC.js";
1
+ import { o as e, t } from "../../base-BIELM-Fk.js";
2
+ import { n } from "../../modules-BumGtAYj.js";
3
3
  import { Flags as r } from "@oclif/core";
4
4
  //#region src/commands/catalog/validate.ts
5
5
  var i = class i extends t {
@@ -1,4 +1,4 @@
1
- import { t as e } from "../../base-B329cz7z.js";
1
+ import { t as e } from "../../base-BIELM-Fk.js";
2
2
  import { a as t } from "../../config-schema-Dp-vlxuR.js";
3
3
  import { runConfigDoctor as n } from "@agent-ix/ix-cli-core";
4
4
  //#region src/commands/config/doctor.ts
@@ -1,4 +1,4 @@
1
- import { t as e } from "../../base-B329cz7z.js";
1
+ import { t as e } from "../../base-BIELM-Fk.js";
2
2
  import { a as t, n } from "../../config-schema-Dp-vlxuR.js";
3
3
  import { runConfigEdit as r } from "@agent-ix/ix-cli-core";
4
4
  //#region src/commands/config/edit.ts
@@ -1,4 +1,4 @@
1
- import { t as e } from "../../base-B329cz7z.js";
1
+ import { t as e } from "../../base-BIELM-Fk.js";
2
2
  import { a as t, n } from "../../config-schema-Dp-vlxuR.js";
3
3
  import { runConfigGet as r } from "@agent-ix/ix-cli-core";
4
4
  import { Args as i } from "@oclif/core";
@@ -1,4 +1,4 @@
1
- import { t as e } from "../../base-B329cz7z.js";
1
+ import { t as e } from "../../base-BIELM-Fk.js";
2
2
  import { a as t, n } from "../../config-schema-Dp-vlxuR.js";
3
3
  import { runConfigSet as r } from "@agent-ix/ix-cli-core";
4
4
  import { Args as i } from "@oclif/core";
@@ -1,4 +1,4 @@
1
- import { t as e } from "../flow-command-D3i7cRHX.js";
1
+ import { t as e } from "../flow-command-Cu3AeDeV.js";
2
2
  //#region src/commands/matrix.ts
3
3
  var t = class t extends e {
4
4
  static summary = "Build or update a requirements test matrix.";
@@ -1,6 +1,6 @@
1
- import { t as e } from "../../base-B329cz7z.js";
2
- import { r as t } from "../../plugins-d-MnIqNv.js";
3
- import { n } from "../../modules-B5-Mw8IC.js";
1
+ import { t as e } from "../../base-BIELM-Fk.js";
2
+ import { r as t } from "../../plugins-DkBB_VkF.js";
3
+ import { n } from "../../modules-BumGtAYj.js";
4
4
  //#region src/commands/module/ensure-defaults.ts
5
5
  var r = class r extends e {
6
6
  static summary = "Idempotently install the default spec module set.";
@@ -1,5 +1,5 @@
1
- import { t as e } from "../../base-B329cz7z.js";
2
- import { n as t } from "../../plugins-d-MnIqNv.js";
1
+ import { t as e } from "../../base-BIELM-Fk.js";
2
+ import { n as t } from "../../plugins-DkBB_VkF.js";
3
3
  import { Args as n } from "@oclif/core";
4
4
  //#region src/commands/module/install.ts
5
5
  var r = class r extends e {
@@ -1,5 +1,5 @@
1
- import { t as e } from "../../base-B329cz7z.js";
2
- import { r as t } from "../../plugins-d-MnIqNv.js";
1
+ import { t as e } from "../../base-BIELM-Fk.js";
2
+ import { r as t } from "../../plugins-DkBB_VkF.js";
3
3
  //#region src/commands/module/list.ts
4
4
  var n = class n extends e {
5
5
  static summary = "List installed spec modules.";
@@ -1,5 +1,5 @@
1
- import { t as e } from "../../base-B329cz7z.js";
2
- import { a as t } from "../../plugins-d-MnIqNv.js";
1
+ import { t as e } from "../../base-BIELM-Fk.js";
2
+ import { a as t } from "../../plugins-DkBB_VkF.js";
3
3
  import { Args as n } from "@oclif/core";
4
4
  //#region src/commands/module/remove.ts
5
5
  var r = class r extends e {
@@ -1,4 +1,4 @@
1
- import { t as e } from "../flow-command-D3i7cRHX.js";
1
+ import { t as e } from "../flow-command-Cu3AeDeV.js";
2
2
  //#region src/commands/review.ts
3
3
  var t = class t extends e {
4
4
  static summary = "Run a composite spec review workflow.";
@@ -1,4 +1,4 @@
1
- import { t as e } from "../flow-command-D3i7cRHX.js";
1
+ import { t as e } from "../flow-command-Cu3AeDeV.js";
2
2
  //#region src/commands/to-plan.ts
3
3
  var t = class t extends e {
4
4
  static summary = "Convert accepted requirements into an implementation plan.";
@@ -1,5 +1,5 @@
1
- import { t as e } from "../version-D0yl2myP.js";
2
- import { t } from "../base-B329cz7z.js";
1
+ import { t as e } from "../version-4FRTZpv_.js";
2
+ import { t } from "../base-BIELM-Fk.js";
3
3
  import { runSelfUpdate as n } from "@agent-ix/ix-cli-core";
4
4
  import { Flags as r } from "@oclif/core";
5
5
  //#region src/commands/update.ts
@@ -1,6 +1,6 @@
1
- import { o as e, t } from "../base-B329cz7z.js";
2
- import { n } from "../modules-B5-Mw8IC.js";
3
- import { n as r, r as i, t as a } from "../write-BTZ4GeEH.js";
1
+ import { o as e, t } from "../base-BIELM-Fk.js";
2
+ import { n } from "../modules-BumGtAYj.js";
3
+ import { n as r, r as i, t as a } from "../write-UmBcjFtj.js";
4
4
  import { Args as o, Flags as s } from "@oclif/core";
5
5
  //#region src/commands/write.ts
6
6
  var c = class c extends t {
@@ -25,8 +25,8 @@ var c = class c extends t {
25
25
  let { args: t, flags: o } = await this.parse(c), s = t.repo_dir;
26
26
  if (!s) throw Error("write requires <repo_dir>");
27
27
  n();
28
- let l = a(e(), s, i(o.types), { org: o.org });
29
- this.log(o.json ? JSON.stringify(l, null, 2) : r(l));
28
+ let l = e(), u = a(l, s, i(o.types), { org: o.org });
29
+ this.log(o.json ? JSON.stringify(u, null, 2) : r(u));
30
30
  }
31
31
  };
32
32
  //#endregion
@@ -1,4 +1,4 @@
1
- import { a as e, t } from "./base-B329cz7z.js";
1
+ import { a as e, t } from "./base-BIELM-Fk.js";
2
2
  import { existsSync as n } from "node:fs";
3
3
  import { dirname as r, join as i, resolve as a } from "node:path";
4
4
  import { fileURLToPath as o } from "node:url";
package/dist/index.js CHANGED
@@ -1,9 +1,9 @@
1
- import { n as e, t } from "./version-D0yl2myP.js";
1
+ import { n as e, t } from "./version-4FRTZpv_.js";
2
2
  import { isVersionRequest as n, main as r } from "./cli.js";
3
- import { i, n as a, o, r as s, t as c } from "./base-B329cz7z.js";
4
- import { a as l, i as u, n as d, r as f } from "./plugins-d-MnIqNv.js";
5
- import { n as p, t as m } from "./modules-B5-Mw8IC.js";
3
+ import { i, n as a, o, r as s, t as c } from "./base-BIELM-Fk.js";
4
+ import { a as l, i as u, n as d, r as f } from "./plugins-DkBB_VkF.js";
5
+ import { n as p, t as m } from "./modules-BumGtAYj.js";
6
6
  import { i as h, n as g, r as _, t as v } from "./config-schema-Dp-vlxuR.js";
7
- import { a as y, i as b, n as x, o as S, r as C, t as w } from "./write-BTZ4GeEH.js";
8
- import { t as T } from "./flow-command-D3i7cRHX.js";
7
+ import { a as y, i as b, n as x, o as S, r as C, t as w } from "./write-UmBcjFtj.js";
8
+ import { t as T } from "./flow-command-Cu3AeDeV.js";
9
9
  export { T as FlowCommand, v as QUOIN_ENV_BINDINGS, g as QUOIN_PLUGIN_ID, c as QuoinCommand, _ as QuoinConfigSchema, b as UNRESOLVED_ORG_MESSAGE, w as createAuthoringPack, a as defaultModuleRoots, m as defaultModulesManifest, p as ensureDefaultModules, s as filamentModulesDir, i as findCatalogEntry, x as formatAuthoringPack, d as installPlugin, n as isVersionRequest, h as ixSchema, f as listPlugins, o as loadCatalog, r as main, y as originOrg, t as packageVersion, u as parseSourceArg, C as parseTypeList, l as removePlugin, S as resolveOrg, e as resolveVersion };
@@ -1,5 +1,5 @@
1
- import { a as e } from "./base-B329cz7z.js";
2
- import { t } from "./plugins-d-MnIqNv.js";
1
+ import { a as e } from "./base-BIELM-Fk.js";
2
+ import { t } from "./plugins-DkBB_VkF.js";
3
3
  import { readFileSync as n } from "node:fs";
4
4
  import { dirname as r, join as i } from "node:path";
5
5
  import { fileURLToPath as a } from "node:url";
@@ -10,7 +10,8 @@ function l() {
10
10
  return r(r(a(import.meta.url)));
11
11
  }
12
12
  function u() {
13
- return c(o(n(i(l(), "default-modules.yaml"), "utf8")));
13
+ let e = i(l(), "default-modules.yaml");
14
+ return c(o(n(e, "utf8")));
14
15
  }
15
16
  function d(n = e(), r = u()) {
16
17
  s(r, {
@@ -1,4 +1,4 @@
1
- import { a as e, r as t } from "./base-B329cz7z.js";
1
+ import { a as e, r as t } from "./base-BIELM-Fk.js";
2
2
  import { existsSync as n, readFileSync as r, rmSync as i } from "node:fs";
3
3
  import { basename as a, join as o } from "node:path";
4
4
  import { parse as s } from "yaml";
@@ -11,7 +11,7 @@ function a(e) {
11
11
  return e || i();
12
12
  }
13
13
  function o() {
14
- return a("0.12.3");
14
+ return a("0.14.0");
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-B329cz7z.js";
1
+ import { i as e } from "./base-BIELM-Fk.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";
@@ -58,7 +58,8 @@ function m(e) {
58
58
  if (!n) return;
59
59
  let r = l(e, n.trim());
60
60
  try {
61
- return l(r, o(c(r, "commondir"), "utf8").trim());
61
+ let e = o(c(r, "commondir"), "utf8").trim();
62
+ return l(r, e);
62
63
  } catch {
63
64
  return r;
64
65
  }
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.12.3",
4
+ "version": "0.14.0",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "files": [
@@ -47,7 +47,7 @@
47
47
  "command_not_found": "./dist/hooks/command-not-found"
48
48
  }
49
49
  },
50
- "packageManager": "pnpm@10.33.4",
50
+ "packageManager": "pnpm@11.20.0",
51
51
  "scripts": {
52
52
  "help": "node scripts/help.js",
53
53
  "test": "vitest run",
@@ -61,6 +61,8 @@
61
61
  "clean": "rm -rf node_modules dist coverage .pnpm-store",
62
62
  "install:frozen": "pnpm install --frozen-lockfile",
63
63
  "update-lock": "pnpm install --lockfile-only",
64
+ "drift": "node scripts/release-drift.js check",
65
+ "drift:pins": "node scripts/release-drift.js pins",
64
66
  "version": "node scripts/build-tools.js version",
65
67
  "info": "node scripts/build-tools.js info",
66
68
  "docker:build": "docker build -t ghcr.io/agent-ix/quoin .",
@@ -85,27 +87,27 @@
85
87
  "dependencies": {
86
88
  "@agent-ix/filament-plan-sync": ">=0.1.0",
87
89
  "@agent-ix/ix-cli-core": ">=0.12.0",
88
- "@agent-ix/ts-plugin-kit": ">=0.1.3",
89
- "@oclif/core": ">=4.11.14",
90
+ "@agent-ix/ts-plugin-kit": ">=0.2.0",
91
+ "@oclif/core": ">=4.13.3",
90
92
  "yaml": "^2.9.0",
91
93
  "zod": ">=4.4.3"
92
94
  },
93
95
  "devDependencies": {
94
- "@types/node": "25.9.2",
95
- "@typescript-eslint/eslint-plugin": "8.60.1",
96
- "@typescript-eslint/parser": "8.60.1",
97
- "@vitest/coverage-v8": "4.1.8",
98
- "add": "^2.0.6",
99
- "eslint": "10.4.1",
96
+ "@types/node": "26.1.2",
97
+ "@typescript-eslint/eslint-plugin": "8.66.0",
98
+ "@typescript-eslint/parser": "8.66.0",
99
+ "@vitest/coverage-v8": "4.1.10",
100
+ "add": "^2.0.9",
101
+ "eslint": "10.8.0",
100
102
  "eslint-plugin-prettier": "5.5.6",
101
103
  "fast-check": "^4.9.0",
102
- "pnpm": "11.5.2",
103
- "prettier": "3.8.3",
104
+ "pnpm": "11.20.0",
105
+ "prettier": "3.9.6",
104
106
  "ts-node": "^10.9.2",
105
107
  "typescript": "6.0.3",
106
- "vite": "8.0.16",
107
- "vite-plugin-dts": "5.0.2",
108
- "vitest": "4.1.8"
108
+ "vite": "8.2.0",
109
+ "vite-plugin-dts": "5.0.3",
110
+ "vitest": "4.1.10"
109
111
  },
110
112
  "publishConfig": {
111
113
  "registry": "https://registry.npmjs.org/",
@@ -114,10 +116,5 @@
114
116
  "repository": {
115
117
  "type": "git",
116
118
  "url": "git+https://github.com/agent-ix/quoin.git"
117
- },
118
- "pnpm": {
119
- "overrides": {
120
- "brace-expansion": ">=5.0.8"
121
- }
122
119
  }
123
120
  }
@@ -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
- | `totals` | `backed` / `total` across the bundle. |
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
- If `quire coverage` reports `no rows matched`, the module in scope declares no traceability
74
- model for this repo's layout — that is an environment gap, not a clean run. Say so rather
75
- than reporting the run as reconciled.
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).
@@ -27,6 +27,19 @@ matrix, run the EARS requirement-grammar check:
27
27
  quire validate --scope . "spec/**/*.md" --summary
28
28
  ```
29
29
 
30
+ > **`--scope` is the repository root, and must be passed explicitly.** Since quire-cli
31
+ > v0.16.0 (quire-rs CR-045) the command derives **two roots** from it and never
32
+ > interchanges them: spec documents are read from `<repo>/spec` only, trace tags from
33
+ > the source tree at `<repo>` excluding `spec/`. A repo with no `spec/` exits with a
34
+ > diagnostic naming the missing document root rather than scanning the whole tree, and a
35
+ > matrix outside `spec/` (a fixture, a `plan/` copy) mints nothing. A relative glob
36
+ > resolves under `--scope` only in scoped mode (no `--module`); with `--module` it
37
+ > resolves against the process working directory, and an omitted `--scope` defaults to
38
+ > `.` — so a run launched from a parent directory validates the **wrong tree** and exits
39
+ > 0 for whatever it matched. Check `quire --version` ≥ 0.16.0 before relying on any of
40
+ > this; ≤ 0.15.0 has the pre-split traversal semantics.
41
+
42
+
30
43
  Treat these `[ears:…]` findings as **un-mappable requirements to fix first**,
31
44
  not coverage you can claim:
32
45
 
@@ -52,6 +52,19 @@ The seven analyses:
52
52
  `low`/`medium`/`high`).
53
53
  4. Validate + record:
54
54
  - Run `quire validate --scope <repo> "spec/**/*.md"` and fix any errors.
55
+
56
+ > **`--scope` is the repository root, and must be passed explicitly.** Since quire-cli
57
+ > v0.16.0 (quire-rs CR-045) the command derives **two roots** from it and never
58
+ > interchanges them: spec documents are read from `<repo>/spec` only, trace tags from
59
+ > the source tree at `<repo>` excluding `spec/`. A repo with no `spec/` exits with a
60
+ > diagnostic naming the missing document root rather than scanning the whole tree, and a
61
+ > matrix outside `spec/` (a fixture, a `plan/` copy) mints nothing. A relative glob
62
+ > resolves under `--scope` only in scoped mode (no `--module`); with `--module` it
63
+ > resolves against the process working directory, and an omitted `--scope` defaults to
64
+ > `.` — so a run launched from a parent directory validates the **wrong tree** and exits
65
+ > 0 for whatever it matched. Check `quire --version` ≥ 0.16.0 before relying on any of
66
+ > this; ≤ 0.15.0 has the pre-split traversal semantics.
67
+
55
68
  - The docs sync into filament-core as `SpecReview` artifacts; do not proceed to
56
69
  implementation until reviewed.
57
70
 
@@ -67,6 +67,19 @@ This skill produces or updates a **plan bundle** at `<project_root>/plan/<Plan-i
67
67
  Validate the bundle with:
68
68
  `quire validate --scope <project_root> "plan/**/*.md"`
69
69
 
70
+ > **`--scope` is the repository root, and must be passed explicitly.** Since quire-cli
71
+ > v0.16.0 (quire-rs CR-045) the command derives **two roots** from it and never
72
+ > interchanges them: spec documents are read from `<repo>/spec` only, trace tags from
73
+ > the source tree at `<repo>` excluding `spec/`. A repo with no `spec/` exits with a
74
+ > diagnostic naming the missing document root rather than scanning the whole tree, and a
75
+ > matrix outside `spec/` (a fixture, a `plan/` copy) mints nothing. A relative glob
76
+ > resolves under `--scope` only in scoped mode (no `--module`); with `--module` it
77
+ > resolves against the process working directory, and an omitted `--scope` defaults to
78
+ > `.` — so a run launched from a parent directory validates the **wrong tree** and exits
79
+ > 0 for whatever it matched. Check `quire --version` ≥ 0.16.0 before relying on any of
80
+ > this; ≤ 0.15.0 has the pre-split traversal semantics.
81
+
82
+
70
83
  ## Open in the review cockpit
71
84
 
72
85
  After the bundle validates, run `filament open <plan-bundle>/plan.md` to open the