@rsaglobaltech/specgate 0.14.6 → 0.16.0

package/dist/scripts/cli/commands/quality/VerifyCommand.js

@@ -0,0 +1,333 @@
+"use strict";
+/**
+ * `specgate verify` — what another tool calls done, gated on evidence
+ * (ADR-0030, docs/specs/verify-foreign-specs.md).
+ *
+ * Reads the other tool's files read-only, runs the rules in `VerifyClaims`,
+ * and writes nothing outside `.specgate/`. The facts the rules need and a
+ * pure module cannot gather — files, git history, the test run, the lock —
+ * are gathered here.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerifyCommand = void 0;
+exports.parseArgs = parseArgs;
+exports.readSpec = readSpec;
+exports.hashCriterion = hashCriterion;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const crypto = __importStar(require("node:crypto"));
+const node_child_process_1 = require("node:child_process");
+const command_1 = require("../../../lib/command");
+const agent_1 = require("../../../lib/agent");
+const diagnostics_1 = require("../../../lib/diagnostics");
+const project_root_1 = require("../../../lib/project-root");
+const DerivedMatrixSources_1 = require("../../../../packages/core/src/infrastructure/DerivedMatrixSources");
+const OpenSpecReader_1 = require("../../../../packages/core/src/domain/OpenSpecReader");
+const VerifyClaims_1 = require("../../../../packages/core/src/domain/VerifyClaims");
+const LOCK = path.join(".specgate", "verify.lock");
+const FORMATS = ["openspec"];
+function usage() {
+    return ("Usage:\n" +
+        '  specgate verify [--from openspec] [--project-dir <dir>] [--run] [--test-cmd "<cmd>"]\n' +
+        "                  [--since <git-ref>] [--record] [--ids] [--json | --format github]\n\n" +
+        "Reads another tool's specification in place and fails while something it\n" +
+        "calls done has no test naming each criterion it covers (ADR-0030).\n\n" +
+        "  --from <format>   openspec. Detected when omitted.\n" +
+        "  --run             Run the test command too; a failing suite fails the check.\n" +
+        "  --test-cmd <cmd>  The suite to run (default: `npm test` when package.json has one).\n" +
+        "  --since <ref>     Gate only claims made after this git ref; older ones are reported.\n" +
+        "  --record          After a green run, record the verified criteria in .specgate/verify.lock.\n" +
+        "  --ids             Print every criterion id, to name in tests.\n" +
+        "  --format github   GitHub Actions annotations on the spec lines.\n");
+}
+function parseArgs(argv) {
+    const o = {
+        projectDir: ".",
+        from: "",
+        run: false,
+        testCmd: "",
+        since: "",
+        record: false,
+        ids: false,
+        json: (0, agent_1.wantsJson)(argv),
+        format: "text",
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const a = argv[i];
+        const value = () => {
+            const v = argv[++i];
+            if (v === undefined)
+                throw new Error(`${a} needs a value`);
+            return v;
+        };
+        if (a === "--project-dir")
+            o.projectDir = value();
+        else if (a === "--from")
+            o.from = value();
+        else if (a === "--run")
+            o.run = true;
+        else if (a === "--test-cmd")
+            o.testCmd = value();
+        else if (a === "--since")
+            o.since = value();
+        else if (a === "--record")
+            o.record = true;
+        else if (a === "--ids")
+            o.ids = true;
+        else if (a === "--json")
+            o.format = "json";
+        else if (a === "--format") {
+            const f = value();
+            if (f !== "text" && f !== "github" && f !== "json")
+                throw new Error(`unknown --format ${f}`);
+            o.format = f;
+        }
+        else if (a === "--help" || a === "-h") {
+            process.stdout.write(usage());
+            process.exit(0);
+        }
+        else
+            throw new Error(`unknown argument ${a}`);
+    }
+    if (o.from && !FORMATS.includes(o.from)) {
+        throw new Error(`--from ${o.from}: supported formats are ${FORMATS.join(", ")}`);
+    }
+    return o;
+}
+function walk(root, rel, out) {
+    let entries;
+    try {
+        entries = fs.readdirSync(path.join(root, rel), { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const e of entries) {
+        const child = rel ? `${rel}/${e.name}` : e.name;
+        if (e.isDirectory())
+            walk(root, child, out);
+        else if (e.isFile() && e.name.endsWith(".md"))
+            out.push(child);
+    }
+}
+function readSpec(projectDir, from) {
+    const paths = [];
+    walk(projectDir, "openspec", paths);
+    if (from === "openspec" || (!from && (0, OpenSpecReader_1.isOpenSpecProject)(paths))) {
+        const files = paths.map((p) => ({
+            path: p,
+            source: fs.readFileSync(path.join(projectDir, p), "utf8"),
+        }));
+        return (0, OpenSpecReader_1.readOpenSpec)(files);
+    }
+    return null;
+}
+function git(projectDir, args) {
+    return (0, node_child_process_1.spawnSync)("git", args, { cwd: projectDir, encoding: "utf8" });
+}
+/** The claims whose dating path did not exist at `ref`. */
+function freshClaims(projectDir, spec, ref) {
+    const ok = git(projectDir, ["rev-parse", "--verify", "--quiet", `${ref}^{commit}`]);
+    if (ok.status !== 0)
+        throw new Error(`--since ${ref}: not a commit in this repository`);
+    const fresh = new Set();
+    for (const c of spec.claims) {
+        const tree = git(projectDir, ["ls-tree", ref, "--", c.datedBy]);
+        if ((tree.stdout || "").trim() === "")
+            fresh.add(c.datedBy);
+    }
+    return fresh;
+}
+function hashCriterion(text) {
+    const normal = text.replace(/\s+/g, " ").trim();
+    return crypto.createHash("sha256").update(normal).digest("hex").slice(0, 16);
+}
+function readLock(projectDir) {
+    try {
+        const doc = JSON.parse(fs.readFileSync(path.join(projectDir, LOCK), "utf8"));
+        return new Map(Object.entries(doc.criteria || {}).map(([k, v]) => [k, String(v.hash)]));
+    }
+    catch {
+        return new Map();
+    }
+}
+function writeLock(projectDir, spec, proved) {
+    const file = path.join(projectDir, LOCK);
+    let doc = { version: 1, criteria: {} };
+    try {
+        doc = JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    catch {
+        // a first record
+    }
+    const head = (git(projectDir, ["rev-parse", "HEAD"]).stdout || "").trim() || null;
+    const texts = new Map(spec.requirements.flatMap((r) => r.criteria.map((c) => [c.id, c.text])));
+    for (const id of [...proved].sort()) {
+        const text = texts.get(id);
+        if (text !== undefined)
+            doc.criteria[id] = { hash: hashCriterion(text), commit: head };
+    }
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, `${JSON.stringify(doc, null, 2)}\n`, "utf8");
+}
+function defaultTestCmd(projectDir) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, "package.json"), "utf8"));
+        if (pkg.scripts && pkg.scripts.test)
+            return "npm test";
+    }
+    catch {
+        // not a node project
+    }
+    return "";
+}
+function renderText(result) {
+    const gated = result.claims.filter((c) => c.gated);
+    const out = process.stdout;
+    out.write(`\n  specgate verify — ${result.format}\n\n`);
+    out.write(`  ${result.claims.length} claim(s) of done, ${gated.length} gated · ` +
+        `${result.coverage.named}/${result.coverage.total} criteria named by a test\n\n`);
+    for (const d of result.status) {
+        const mark = d.severity === "error" ? "✖" : d.severity === "warning" ? "▲" : "ℹ";
+        out.write(`  ${mark}  ${d.message}\n`);
+        if (d.fix && d.severity === "error")
+            out.write(`     fix: ${d.fix}\n`);
+    }
+    const errors = result.status.filter((d) => d.severity === "error").length;
+    if (errors === 0 && gated.length === 0) {
+        out.write(`\n  ✔  Nothing to gate: no finished claim of done${result.claims.length ? " is new" : ""}. ` +
+            `${result.claims.length - gated.length} older or unfinished claim(s) reported above.\n`);
+        return;
+    }
+    out.write(errors === 0
+        ? `\n  ✔  Every gated claim of done is named by a test.\n` +
+            `     A test that names a criterion is evidence it ran, not proof it asserts the right thing.\n`
+        : `\n  ✖  ${errors} problem(s) with what is called done.\n`);
+}
+function renderGithub(status) {
+    for (const d of status) {
+        if (d.severity === "info")
+            continue;
+        const level = d.severity === "error" ? "error" : "warning";
+        const where = d.file ? ` file=${d.file}${d.line ? `,line=${d.line}` : ""}` : "";
+        process.stdout.write(`::${level}${where},title=${d.code}::${d.message.replace(/\n/g, " ")}\n`);
+    }
+}
+class VerifyCommand extends command_1.BaseCommand {
+    execute() {
+        let o;
+        const io0 = (0, agent_1.agentIo)((0, agent_1.wantsJson)(this.args));
+        try {
+            o = parseArgs(this.args);
+        }
+        catch (err) {
+            io0.usage({ verify: null }, [
+                (0, diagnostics_1.error)("verify_usage", err.message, { fix: "specgate verify --help" }),
+            ]);
+        }
+        const io = (0, agent_1.agentIo)(o.format === "json" || o.json);
+        const opts = o;
+        const projectDir = (0, project_root_1.resolveProjectDir)(opts.projectDir);
+        const spec = readSpec(projectDir, opts.from);
+        if (!spec) {
+            io.fail({ verify: null }, [
+                (0, diagnostics_1.error)("verify_no_spec", `No OpenSpec specification found in ${projectDir}.`, {
+                    fix: "Run it at the root of a project with an `openspec/` directory, or pass --project-dir.",
+                }),
+            ]);
+        }
+        if (opts.ids) {
+            if (io.json) {
+                io.emit({ verify: { ids: spec.requirements } });
+                return;
+            }
+            for (const r of spec.requirements) {
+                process.stdout.write(`${r.id}  ${r.title}\n`);
+                for (const c of r.criteria)
+                    process.stdout.write(`  ${c.id}  ${c.title}\n`);
+            }
+            return;
+        }
+        let fresh;
+        try {
+            fresh = opts.since ? freshClaims(projectDir, spec, opts.since) : undefined;
+        }
+        catch (err) {
+            io.usage({ verify: null }, [(0, diagnostics_1.error)("verify_since", err.message)]);
+        }
+        const tests = (0, DerivedMatrixSources_1.readDerivationSources)(projectDir).tests;
+        const result = (0, VerifyClaims_1.verifyClaims)({
+            spec: spec,
+            tests,
+            freshClaims: fresh,
+            lock: readLock(projectDir),
+            hash: hashCriterion,
+        });
+        if (opts.run) {
+            const cmd = opts.testCmd || defaultTestCmd(projectDir);
+            if (!cmd) {
+                result.status.push((0, diagnostics_1.error)("V2_failing_suite", "--run was given and no test command is known.", {
+                    fix: 'Pass --test-cmd "<the command that runs the suite>".',
+                }));
+            }
+            else {
+                const r = (0, node_child_process_1.spawnSync)(cmd, {
+                    cwd: projectDir,
+                    shell: true,
+                    stdio: io.json ? "pipe" : "inherit",
+                });
+                if (r.status !== 0) {
+                    result.status.push((0, diagnostics_1.error)("V2_failing_suite", `\`${cmd}\` failed (exit ${r.status}); a red suite proves nothing done.`));
+                }
+            }
+        }
+        const failed = result.status.some((d) => d.severity === "error");
+        if (opts.record && !failed)
+            writeLock(projectDir, spec, result.proved);
+        if (opts.format === "github") {
+            renderGithub(result.status);
+            process.exitCode = failed ? 1 : 0;
+            return;
+        }
+        // Exit through exitCode, not process.exit: a large JSON document piped to
+        // another process must drain first (golden_app finding #33).
+        const { status, ...payload } = result;
+        io.emit({ verify: payload, status }, () => renderText(result));
+        process.exitCode = failed ? 1 : 0;
+    }
+}
+exports.VerifyCommand = VerifyCommand;
+//# sourceMappingURL=VerifyCommand.js.map

package/dist/scripts/cli/commands/quality/VerifyCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VerifyCommand.js","sourceRoot":"","sources":["../../../../../scripts/cli/commands/quality/VerifyCommand.ts"],"names":[],"mappings":"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"}

package/dist/scripts/cli/commands/spec/DraftCommand.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * `specgate draft --check <change-id>` — is a draft complete enough to
+ * review? (ADR-0029, docs/specs/draft-from-brief.md §4–5)
+ *
+ * Phase 1 of `draft`: the checklist, runnable on a change written by any
+ * agent or person. Drafting it with the project's agent comes later; this is
+ * what holds that draft — and any hand-written change — to the rules.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DraftCommand = void 0;
+exports.parseArgs = parseArgs;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const command_1 = require("../../../lib/command");
+const agent_1 = require("../../../lib/agent");
+const diagnostics_1 = require("../../../lib/diagnostics");
+const project_root_1 = require("../../../lib/project-root");
+const DraftChecklist_1 = require("../../../../packages/core/src/domain/DraftChecklist");
+const CHANGES = path.join("docs", "specs", "changes");
+function usage() {
+    return ("Usage:\n" +
+        "  specgate draft --check <change-id> [--brief <file>] [--max-requirements <n>] [--project-dir <dir>] [--json]\n\n" +
+        "Checks a draft change against the checklist (ADR-0029):\n" +
+        "  D1 every requirement has a scenario          D5 a cited law or standard names its source\n" +
+        "  D2 every requirement has a kind              D6 a stated value is in the brief or an assumption\n" +
+        "  D3 a scenario per surface each actor uses    D7 an open question names what it blocks\n" +
+        "  D4 a non-functional requirement is measured  D8 the draft is small enough to review\n\n" +
+        "  --brief <file>   The brief the draft came from. Without it D3 and D6 cannot\n" +
+        "                   run, and the report says so. Also read from `brief:` in change.yaml.\n");
+}
+function parseArgs(argv) {
+    const o = {
+        check: "",
+        brief: "",
+        maxRequirements: 25,
+        projectDir: ".",
+        json: (0, agent_1.wantsJson)(argv),
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const a = argv[i];
+        const value = () => {
+            const v = argv[++i];
+            if (v === undefined)
+                throw new Error(`${a} needs a value`);
+            return v;
+        };
+        if (a === "--check")
+            o.check = value();
+        else if (a === "--brief")
+            o.brief = value();
+        else if (a === "--max-requirements")
+            o.maxRequirements = Number(value());
+        else if (a === "--project-dir")
+            o.projectDir = value();
+        else if (a === "--json")
+            o.json = true;
+        else if (a === "--help" || a === "-h") {
+            process.stdout.write(usage());
+            process.exit(0);
+        }
+        else
+            throw new Error(`unknown argument ${a}`);
+    }
+    if (!o.check) {
+        throw new Error("--check <change-id> is required (drafting with an agent is not available yet)");
+    }
+    if (!Number.isInteger(o.maxRequirements) || o.maxRequirements < 1) {
+        throw new Error("--max-requirements needs a positive integer");
+    }
+    return o;
+}
+function specFiles(dir, rel = "") {
+    const out = [];
+    let entries = [];
+    try {
+        entries = fs.readdirSync(path.join(dir, rel), { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const e of entries) {
+        const child = rel ? `${rel}/${e.name}` : e.name;
+        if (e.isDirectory())
+            out.push(...specFiles(dir, child));
+        else if (e.name === "spec.md")
+            out.push(child);
+    }
+    return out;
+}
+const readIf = (file) => (fs.existsSync(file) ? fs.readFileSync(file, "utf8") : undefined);
+class DraftCommand extends command_1.BaseCommand {
+    execute() {
+        const io0 = (0, agent_1.agentIo)((0, agent_1.wantsJson)(this.args));
+        let o;
+        try {
+            o = parseArgs(this.args);
+        }
+        catch (err) {
+            io0.usage({ draft: null }, [
+                (0, diagnostics_1.error)("draft_usage", err.message, { fix: "specgate draft --help" }),
+            ]);
+        }
+        const opts = o;
+        const io = (0, agent_1.agentIo)(opts.json);
+        const projectDir = (0, project_root_1.resolveProjectDir)(opts.projectDir);
+        const changeDir = path.join(projectDir, CHANGES, opts.check);
+        if (!fs.existsSync(changeDir)) {
+            io.fail({ draft: null }, [
+                (0, diagnostics_1.error)("draft_no_change", `No change '${opts.check}' under ${CHANGES}/.`, {
+                    fix: "specgate change list — or open one with `specgate change new <id>`.",
+                }),
+            ]);
+        }
+        const specs = path.join(changeDir, "specs");
+        const deltas = specFiles(specs).map((rel) => ({
+            path: path.join(CHANGES, opts.check, "specs", rel).split(path.sep).join("/"),
+            source: fs.readFileSync(path.join(specs, rel), "utf8"),
+        }));
+        if (deltas.length === 0) {
+            io.fail({ draft: null }, [
+                (0, diagnostics_1.error)("draft_no_specs", `Change '${opts.check}' has no specs/<capability>/spec.md to check.`),
+            ]);
+        }
+        // The brief: --brief, else `brief: <path>` in change.yaml.
+        let briefPath = opts.brief;
+        if (!briefPath) {
+            const yaml = readIf(path.join(changeDir, "change.yaml")) || "";
+            const m = /^brief:\s*["']?([^"'\n]+)["']?\s*$/m.exec(yaml);
+            if (m)
+                briefPath = m[1].trim();
+        }
+        let brief;
+        if (briefPath) {
+            brief = readIf(path.resolve(projectDir, briefPath));
+            if (brief === undefined) {
+                io.fail({ draft: null }, [
+                    (0, diagnostics_1.error)("draft_no_brief", `The brief ${briefPath} does not exist.`),
+                ]);
+            }
+        }
+        const report = (0, DraftChecklist_1.checkDraft)({
+            deltas,
+            brief,
+            assumptions: readIf(path.join(changeDir, "assumptions.md")),
+            questions: readIf(path.join(changeDir, "questions.md")),
+            maxRequirements: opts.maxRequirements,
+        });
+        const status = [
+            ...report.status,
+            ...report.skipped.map((s) => (0, diagnostics_1.info)("draft_rule_skipped", `${s.rule} did not run: ${s.why}.`, {
+                fix: "Pass --brief <file>, with actors and their surfaces in its front matter for D3.",
+            })),
+        ];
+        const errors = report.status.length;
+        io.emit({
+            draft: {
+                change: opts.check,
+                requirements: report.requirements,
+                scenarios: report.scenarios,
+                skipped: report.skipped,
+            },
+            status,
+        }, () => {
+            const out = process.stdout;
+            out.write(`\n  specgate draft --check ${opts.check}\n\n`);
+            out.write(`  ${report.requirements} requirement(s), ${report.scenarios} scenario(s)\n\n`);
+            for (const d of status) {
+                out.write(`  ${d.severity === "error" ? "✖" : "ℹ"}  ${d.code}  ${d.message}\n`);
+                if (d.fix && d.severity === "error")
+                    out.write(`     fix: ${d.fix}\n`);
+            }
+            const skipped = report.skipped.length;
+            out.write(errors === 0
+                ? `\n  ✔  Ready to review${skipped ? ` (${skipped} rule(s) did not run — see above)` : ""}.\n`
+                : `\n  ✖  ${errors} finding(s) to fix before review.\n`);
+        });
+        process.exitCode = errors === 0 ? 0 : 1;
+    }
+}
+exports.DraftCommand = DraftCommand;
+//# sourceMappingURL=DraftCommand.js.map

package/dist/scripts/cli/commands/spec/DraftCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DraftCommand.js","sourceRoot":"","sources":["../../../../../scripts/cli/commands/spec/DraftCommand.ts"],"names":[],"mappings":"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"}

package/dist/scripts/cli/commands/spec/StatusCommand.js

@@ -46,6 +46,8 @@ const lock_1 = require("../../../specops/lock");
 const diagnostics_1 = require("../../../lib/diagnostics");
 const command_1 = require("../../../lib/command");
 const monorepo_fanout_1 = require("../../../lib/monorepo-fanout");
+const DraftChecklist_1 = require("../../../../packages/core/src/domain/DraftChecklist");
+const DerivedMatrixSources_1 = require("../../../../packages/core/src/infrastructure/DerivedMatrixSources");
 const MatrixCommand_1 = require("./MatrixCommand");
 const derived_writes_1 = require("../../../lib/derived-writes");
 const COLOR_ENABLED = process.stdout.isTTY && process.env.NO_COLOR === undefined && process.env.TERM !== "dumb";
@@ -197,7 +199,7 @@ function titleOf(item) {
         .trim();
     return t && t !== "-" ? t : "";
 }
-function emitText(projectDir, summary, lock) {
+function emitText(projectDir, summary, lock, notes = []) {
     const { items, counts, pending, orphans } = summary;
     process.stdout.write(`\n  ${c.bold}📊 Project status${c.reset}  ${c.dim}${path.basename(path.resolve(projectDir))}${c.reset}\n\n`);
     process.stdout.write(`  ${c.bold}Requirements${c.reset}  ${c.dim}${counts.total} total · ${counts.DONE} done · ${pending} pending${c.reset}\n`);
@@ -217,6 +219,14 @@ function emitText(projectDir, summary, lock) {
     queue("To do", TODO_CATEGORIES, c.yellow);
     if (orphans.length > 0)
         process.stdout.write(`\n  ${c.red}${orphans.length} orphan feature file(s)${c.reset} ${c.dim}— not in the matrix${c.reset}\n`);
+    if (notes.length > 0) {
+        process.stdout.write(`\n  ${c.bold}Spec notes${c.reset}  ${c.dim}(not failures — ADR-0029)${c.reset}\n`);
+        for (const n of notes.slice(0, 5)) {
+            process.stdout.write(`    ${c.yellow}${n.code}${c.reset} ${n.message}\n`);
+        }
+        if (notes.length > 5)
+            process.stdout.write(`    ${c.dim}… ${notes.length - 5} more in --json${c.reset}\n`);
+    }
     if (lock && lock.packs && lock.packs.length > 0) {
         process.stdout.write(`\n  ${c.bold}Packs${c.reset}  ${c.dim}(.specops.lock)${c.reset}\n`);
         for (const p of lock.packs) {
@@ -225,7 +235,7 @@ function emitText(projectDir, summary, lock) {
     }
     process.stdout.write(`\n  ${c.bold}Next${c.reset}  ${c.green}${nextCommandPlain(summary)}${c.reset}  ${c.dim}— ${nextReason(summary)}${c.reset}\n\n`);
 }
-function emitJson(projectDir, summary, lock) {
+function emitJson(projectDir, summary, lock, notes = []) {
     const { counts, pending, orphans } = summary;
     process.stdout.write(JSON.stringify({
         schemaVersion: 1,
@@ -242,7 +252,7 @@ function emitJson(projectDir, summary, lock) {
             needs: needsOf(it) || null,
         })),
         nextCommand: nextCommandPlain(summary),
-        status: [],
+        status: notes,
     }, null, 2) + "\n");
 }
 class StatusCommand extends command_1.BaseCommand {
@@ -277,10 +287,19 @@ class StatusCommand extends command_1.BaseCommand {
         catch {
             lock = null;
         }
+        // D4 and D5 on the project's own specification: notes, never failures.
+        let notes = [];
+        try {
+            const sources = (0, DerivedMatrixSources_1.readDerivationSources)(projectDir);
+            notes = (0, DraftChecklist_1.specNotes)([{ path: "spec.md", source: sources.spec }, ...(sources.capabilities || [])], sources.features);
+        }
+        catch {
+            notes = [];
+        }
         if (opts.format === "json")
-            emitJson(projectDir, summary, lock);
+            emitJson(projectDir, summary, lock, notes);
         else
-            emitText(projectDir, summary, lock);
+            emitText(projectDir, summary, lock, notes);
         process.exit(0);
     }
 }