@agent-ix/quoin 0.13.0 → 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.
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/dist/{base-D-_JMqkO.js → base-BIELM-Fk.js} +1 -1
- package/dist/cli.js +1 -1
- package/dist/commands/catalog/list.js +2 -2
- 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/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/{flow-command-BPwQwyEV.js → flow-command-Cu3AeDeV.js} +1 -1
- package/dist/index.js +6 -6
- package/dist/{modules-Dn6ac8th.js → modules-BumGtAYj.js} +2 -2
- package/dist/{plugins-BCCcBgCW.js → plugins-DkBB_VkF.js} +1 -1
- package/dist/{version-BGJINLrJ.js → version-4FRTZpv_.js} +1 -1
- package/dist/{write-FTRN1yh6.js → write-UmBcjFtj.js} +1 -1
- package/package.json +1 -1
- 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-matrix/SKILL.md +13 -0
- package/skills/spec-review/SKILL.md +13 -0
- package/skills/spec-to-plan/SKILL.md +13 -0
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { t as e } from "./version-
|
|
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";
|
package/dist/cli.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { o as e, t } from "../../base-
|
|
2
|
-
import { n } from "../../modules-
|
|
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-
|
|
2
|
-
import { n as r } from "../../modules-
|
|
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-
|
|
2
|
-
import { n } from "../../modules-
|
|
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 {
|
package/dist/commands/matrix.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { t as e } from "../../base-
|
|
2
|
-
import { r as t } from "../../plugins-
|
|
3
|
-
import { n } from "../../modules-
|
|
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-
|
|
2
|
-
import { n as t } from "../../plugins-
|
|
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-
|
|
2
|
-
import { r as t } from "../../plugins-
|
|
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-
|
|
2
|
-
import { a as t } from "../../plugins-
|
|
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 {
|
package/dist/commands/review.js
CHANGED
package/dist/commands/to-plan.js
CHANGED
package/dist/commands/update.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { t as e } from "../version-
|
|
2
|
-
import { t } from "../base-
|
|
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
|
package/dist/commands/write.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { o as e, t } from "../base-
|
|
2
|
-
import { n } from "../modules-
|
|
3
|
-
import { n as r, r as i, t as a } from "../write-
|
|
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 {
|
package/dist/index.js
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { n as e, t } from "./version-
|
|
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-
|
|
4
|
-
import { a as l, i as u, n as d, r as f } from "./plugins-
|
|
5
|
-
import { n as p, t as m } from "./modules-
|
|
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-
|
|
8
|
-
import { t as T } from "./flow-command-
|
|
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-
|
|
2
|
-
import { t } from "./plugins-
|
|
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";
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { a as e, r as t } from "./base-
|
|
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";
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { i as e } from "./base-
|
|
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";
|
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.14.0",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"files": [
|
|
@@ -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).
|
|
@@ -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
|