@shrkcrft/cli 0.1.0-alpha.24 → 0.1.0-alpha.26

package/dist/command-registry.d.ts

@@ -191,5 +191,15 @@ export interface IFlagListOptions {
 }
 export declare function flagList(args: ParsedArgs, name: string, options?: IFlagListOptions): string[];
 export declare function flagVars(args: ParsedArgs): Record<string, string>;
+/**
+ * Return the first parsed flag whose name is NOT in `allowed`, or `undefined`
+ * when every flag is recognized. The parser does not reject unknown flags on its
+ * own — without a per-command allow-list a typo'd flag (`--no-such-flag`) parses
+ * as `true`, reads as a confident opt-in, and the verb runs the bare command at
+ * exit `0`. A verb that opts into strict flag handling calls this with its known
+ * set and rejects the result loudly, so a mistyped/renamed flag can never read
+ * as success (see docs/exit-codes.md · a25 §2.1).
+ */
+export declare function firstUnknownFlag(args: ParsedArgs, allowed: ReadonlySet<string>): string | undefined;
 export {};
 //# sourceMappingURL=command-registry.d.ts.map

package/dist/command-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../src/command-registry.ts"],"names":[],"mappings":"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"}

package/dist/command-registry.js

@@ -451,3 +451,19 @@ export function flagVars(args) {
     }
     return out;
 }
+/**
+ * Return the first parsed flag whose name is NOT in `allowed`, or `undefined`
+ * when every flag is recognized. The parser does not reject unknown flags on its
+ * own — without a per-command allow-list a typo'd flag (`--no-such-flag`) parses
+ * as `true`, reads as a confident opt-in, and the verb runs the bare command at
+ * exit `0`. A verb that opts into strict flag handling calls this with its known
+ * set and rejects the result loudly, so a mistyped/renamed flag can never read
+ * as success (see docs/exit-codes.md · a25 §2.1).
+ */
+export function firstUnknownFlag(args, allowed) {
+    for (const key of args.flags.keys()) {
+        if (!allowed.has(key))
+            return key;
+    }
+    return undefined;
+}

package/dist/commands/changelog-data.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Machine-readable command-SURFACE delta, shipped inside the binary so
+ * `shrk changelog` is authoritative for the exact build in use and works
+ * offline. This is NOT the full human CHANGELOG.md — it records only the delta
+ * an agent needs to re-orient after an upgrade: which verbs/flags were added,
+ * which changed behavior, which were removed. Keep it in sync with CHANGELOG.md
+ * when a release lands; the version keys must match `SHARKCRAFT_VERSION`.
+ *
+ * Ordered oldest → newest; the renderer sorts as needed.
+ */
+/** One version's command-surface delta. */
+export interface IReleaseSurfaceDelta {
+    /** Exact release version, e.g. `0.1.0-alpha.24`. */
+    readonly version: string;
+    /** One-line headline for the release. */
+    readonly title: string;
+    /** New verbs / flags this version introduced. */
+    readonly added: readonly string[];
+    /** Verbs / flags whose behavior or defaults changed. */
+    readonly changed: readonly string[];
+    /** Verbs / flags removed or renamed away. */
+    readonly removed: readonly string[];
+}
+export declare const RELEASE_SURFACE_DELTAS: readonly IReleaseSurfaceDelta[];
+//# sourceMappingURL=changelog-data.d.ts.map

package/dist/commands/changelog-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-data.d.ts","sourceRoot":"","sources":["../../src/commands/changelog-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS,oBAAoB,EAmFjE,CAAC"}

package/dist/commands/changelog-data.js

@@ -0,0 +1,94 @@
+/**
+ * Machine-readable command-SURFACE delta, shipped inside the binary so
+ * `shrk changelog` is authoritative for the exact build in use and works
+ * offline. This is NOT the full human CHANGELOG.md — it records only the delta
+ * an agent needs to re-orient after an upgrade: which verbs/flags were added,
+ * which changed behavior, which were removed. Keep it in sync with CHANGELOG.md
+ * when a release lands; the version keys must match `SHARKCRAFT_VERSION`.
+ *
+ * Ordered oldest → newest; the renderer sorts as needed.
+ */
+export const RELEASE_SURFACE_DELTAS = [
+    {
+        version: '0.1.0-alpha.23',
+        title: 'Correctness, gate trust, security & pack-distributable invariants',
+        added: [
+            '`shrk registry <name> list | exists <id> | where <id>` — declarable registry inventory (pack-distributable).',
+            '`shrk policy run --changed-only` / `--since` — finding-diff-scoped policy runs.',
+            '`shrk search tuning explain` — why a query ranked the way it did.',
+        ],
+        changed: [
+            '`graph context`/`search`/`callers`/`impact` report a true `total` + `truncated` instead of a silent per-file cap.',
+            'Incremental reindex no longer drops inbound edges; renamed barrel re-exports (`export { X as Y }`) now resolve.',
+        ],
+        removed: [],
+    },
+    {
+        version: '0.1.0-alpha.24',
+        title: 'Runtime wiring, write-safety & the author loop',
+        added: [
+            '`shrk wiring chain | unprovided | orphans` — the registration/DI graph beside the import graph.',
+            '`shrk wiring test <candidate>` / `shrk check wiring --explain <ruleId>` — declared vs registered set, no config write.',
+            '`shrk trace "<literal>"` — generalize registry tracing to any cross-layer string contract.',
+            '`shrk check orphans [--since <ref>] [--staged]` — first-class diff-robust reverse-closure.',
+            '`shrk finish` (a.k.a. `review --run`) — one changed-only "safe to finish?" verdict.',
+            '`--limit N` (`--limit 0` = all) on graph read commands (default 50).',
+        ],
+        changed: [
+            '`shrk impact --deleted` no longer ENOBUFS — the git diff is streamed via a shared `runGitLines`.',
+            'Pack-health scores quality (resolved cross-refs, runnable verification), not mere presence.',
+            '`compress --type code` is a real strategy (was markdown-only).',
+        ],
+        removed: [],
+    },
+    {
+        version: '0.1.0-alpha.25',
+        title: 'Earned & change-attributable verdicts',
+        added: [
+            '`shrk changelog [--since <version>] [--all] [--json]` — the command-surface delta of the running build.',
+            '`shrk registry <name> exists <id> --fail-if-taken | --fail-if-missing` — guard-mode exit codes for pre-author checks.',
+            '`shrk registry <name> exists <id> --resolve` — map a synonym to the canonical id (registry `aliases`) before the test.',
+            '`shrk check registry-lifecycle --changed-only` — diff-scoped lifecycle check that terminates in seconds.',
+            '`shrk gen --typecheck` — compile the emitted file set against the detected tsconfig as a PRE-WRITE gate (a template bug fails at generation and REFUSES the write; nothing lands on disk).',
+            '`shrk gen --print` — inspect the rendered file bodies in one step (alias of `--show-content`).',
+            '`shrk graph cycles --include-type-edges` — opt back into counting type-only import edges.',
+            '`shrk context` / `shrk task --summary` (`--brief`) — the terse orientation view (now opt-in).',
+        ],
+        changed: [
+            '`shrk check wiring --changed-only` never renders a green verdict over 0 evaluated rules; reports `M of N (K skipped)`.',
+            '`shrk check registry-lifecycle` no longer hangs — bounded scan + wall-clock budget + partial-result flush; skip-dirs are configurable via `registryLifecycle.skipDirs`.',
+            'Cycle detection excludes type-only import edges by default (clears phantom architecture reds).',
+            '`shrk gate` is change-scoped by default — reds only on change-introduced findings; baseline debt is a non-blocking bucket.',
+            '`shrk context` / `shrk task` render the FULL body by default (parity with why/reuse/knowledge get).',
+            '`shrk reuse` applies a confidence floor (weak keyword collisions → did-you-mean, score exposed) and shows the consumer total.',
+            '`compress --type code` labels its lossy fidelity (banner + JSON `fidelity`).',
+            '`changes summary` attributes areas from the declared layer/area taxonomy instead of bucketing to `unknown`.',
+            '`smart-context "<task>"` accepts `--task`, and fails loud (banner) when the local model is degraded instead of returning a stale guide dump.',
+        ],
+        removed: [],
+    },
+    {
+        version: '0.1.0-alpha.26',
+        title: 'Honest exit codes',
+        added: [
+            'A unified exit-code contract across every gate/verify/check verb: `0` verified pass, `1` failure, `2` NOT-verified (empty scope / degraded / timeout). See docs/exit-codes.md.',
+            'Global `--strict` — promote a NOT-verified (`2`) verdict to a failure-class nonzero (`1`) across every gate, for a hard CI gate in one switch.',
+            '`shrk gate baseline --refreeze` — re-freeze the architecture baseline to the current state (operational reset).',
+            '`shrk check wiring --base <ref>` (synonym of `--since`); `check wiring` now shows the rule ids selected by footprint under a scoped run.',
+            '`shrk reuse … --all` — the full candidate catalog (default is now a scored top-K did-you-mean).',
+        ],
+        changed: [
+            '`shrk check wiring` (0 rules evaluated) and `shrk registry lifecycle` / `check registry-lifecycle` (0 registrations, or wall-clock timeout) now exit `2` (NOT verified), not a green `0` a chained `&& next` would march past.',
+            'The graph/query family (`graph cycles|hubs|callers|impact|search|context|…`) rejects an unknown/misspelled flag (`unknown option --x`, exit `2`) instead of silently swallowing it as a confident success.',
+            'Piping any streaming list (`… | head`, `| grep`) no longer crashes with `write EPIPE` — a downstream early-close is swallowed and the real exit code is preserved.',
+            '`shrk check wiring --help` documents its own scoping flags instead of running the bare check.',
+            '`shrk reuse "<intent>"` returns a scored top-K did-you-mean (score per row) on a weak/no-match intent instead of dumping the whole catalog.',
+            '`shrk registry <name> exists <id> --resolve` also normalizes (case-fold, singular/plural, suffix strip/append), not just the declared `aliases` map.',
+            '`shrk compress` prints a `fidelity: lossy|lossless|passthrough` banner on the human text path (parity with `--json`).',
+            '`shrk changes summary` ships a built-in config/tooling area for non-lib paths — only genuinely unclassifiable files stay `unknown`.',
+            '`shrk gen` saved plans persist the rendered file `body` + a per-entry `sha256` digest (reviewable/diffable/re-appliable), not just `sizeBytes`.',
+            '`shrk gate` counts only change-attributable (diff-vs-HEAD) architecture errors as blocking; stale-baseline drift in untouched files is informational.',
+        ],
+        removed: [],
+    },
+];

package/dist/commands/changelog.command.d.ts

@@ -0,0 +1,3 @@
+import { type ICommandHandler } from '../command-registry.js';
+export declare const changelogCommand: ICommandHandler;
+//# sourceMappingURL=changelog.command.d.ts.map

package/dist/commands/changelog.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.command.d.ts","sourceRoot":"","sources":["../../src/commands/changelog.command.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA4ChC,eAAO,MAAM,gBAAgB,EAAE,eA4D9B,CAAC"}

package/dist/commands/changelog.command.js

@@ -0,0 +1,100 @@
+import { SHARKCRAFT_VERSION } from '@shrkcrft/shared';
+import { flagBool, flagString, } from "../command-registry.js";
+import { asJson, header } from "../output/format-output.js";
+import { RELEASE_SURFACE_DELTAS } from "./changelog-data.js";
+/** Parse `X.Y.Z[-alpha.N]` into a comparable tuple. A release outranks its prerelease. */
+function parseVersion(v) {
+    const [coreStr, preStr] = v.replace(/^v/, '').split('-');
+    const parts = (coreStr ?? '').split('.').map((n) => Number(n) || 0);
+    const core = [parts[0] ?? 0, parts[1] ?? 0, parts[2] ?? 0];
+    // No prerelease sorts ABOVE any prerelease of the same core; a prerelease
+    // sorts by its trailing number (alpha.24 < alpha.25).
+    let pre = Number.POSITIVE_INFINITY;
+    if (preStr) {
+        const m = preStr.match(/(\d+)/);
+        pre = m ? Number(m[1]) : 0;
+    }
+    return { core, pre };
+}
+/** -1 / 0 / 1 comparator over version strings. */
+function compareVersions(a, b) {
+    const pa = parseVersion(a);
+    const pb = parseVersion(b);
+    for (let i = 0; i < 3; i += 1) {
+        const d = (pa.core[i] ?? 0) - (pb.core[i] ?? 0);
+        if (d !== 0)
+            return d < 0 ? -1 : 1;
+    }
+    if (pa.pre === pb.pre)
+        return 0;
+    return pa.pre < pb.pre ? -1 : 1;
+}
+function renderDeltaText(d) {
+    const lines = [`\n${d.version} — ${d.title}`];
+    const section = (label, items) => {
+        if (items.length === 0)
+            return;
+        lines.push(`  ${label}:`);
+        for (const it of items)
+            lines.push(`    • ${it}`);
+    };
+    section('Added', d.added);
+    section('Changed', d.changed);
+    section('Removed', d.removed);
+    return lines.join('\n') + '\n';
+}
+export const changelogCommand = {
+    name: 'changelog',
+    description: "The shrk command-surface delta of the running build — which verbs/flags were added, changed, or removed. Sourced from an in-binary release-notes asset (offline, authoritative for this exact build). `--since <version>` shows the cumulative delta since a prior version.",
+    usage: 'shrk changelog [--since <version>] [--all] [--json]',
+    booleanFlags: new Set(['all', 'json']),
+    run(args) {
+        const wantJson = flagBool(args, 'json');
+        const since = flagString(args, 'since');
+        const all = flagBool(args, 'all');
+        const current = SHARKCRAFT_VERSION;
+        // Newest-first for display.
+        const sorted = [...RELEASE_SURFACE_DELTAS].sort((a, b) => compareVersions(b.version, a.version));
+        let selected;
+        let scope;
+        if (all) {
+            selected = sorted;
+            scope = 'all recorded versions';
+        }
+        else if (since) {
+            // Cumulative delta: every recorded version strictly newer than `since`.
+            selected = sorted.filter((d) => compareVersions(d.version, since) > 0);
+            scope = `since ${since}`;
+        }
+        else {
+            // Default: the entry matching the running build, else the newest recorded.
+            const exact = sorted.find((d) => compareVersions(d.version, current) === 0);
+            selected = exact ? [exact] : sorted.slice(0, 1);
+            scope = exact ? `running build (${current})` : `latest recorded (running build ${current} has no recorded surface delta)`;
+        }
+        if (wantJson) {
+            process.stdout.write(asJson({
+                schema: 'sharkcraft.changelog/v1',
+                runningVersion: current,
+                scope,
+                ...(since ? { since } : {}),
+                count: selected.length,
+                versions: selected,
+            }) + '\n');
+            return 0;
+        }
+        process.stdout.write(header(`shrk changelog — ${scope}`));
+        if (selected.length === 0) {
+            process.stdout.write(since
+                ? `  No recorded surface changes since ${since}.\n`
+                : '  No recorded surface changes.\n');
+            return 0;
+        }
+        for (const d of selected)
+            process.stdout.write(renderDeltaText(d));
+        if (!all && !since) {
+            process.stdout.write('\n(pass --since <version> for the cumulative delta, or --all for every recorded version.)\n');
+        }
+        return 0;
+    },
+};

package/dist/commands/changes.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changes.command.d.ts","sourceRoot":"","sources":["../../src/commands/changes.command.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA2HhC,eAAO,MAAM,cAAc,EAAE,eAwB5B,CAAC"}
+{"version":3,"file":"changes.command.d.ts","sourceRoot":"","sources":["../../src/commands/changes.command.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAiIhC,eAAO,MAAM,cAAc,EAAE,eAwB5B,CAAC"}

package/dist/commands/changes.command.js

@@ -59,6 +59,10 @@ async function runChangesSummary(args) {
     for (const [area, list] of Object.entries(report.filesByArea)) {
         process.stdout.write(`  ${area.padEnd(20)} (${list.length})\n`);
     }
+    if (report.unknownFiles > 0) {
+        process.stdout.write(`  ! ${report.unknownFiles}/${report.totalFiles} file(s) (${Math.round(report.unknownRate * 100)}%) matched no declared area — ` +
+            'the layer/area taxonomy may be missing globs (classifier diagnostic, not a low-risk signal).\n');
+    }
     if (report.touchedMcpTools.length > 0) {
         process.stdout.write('\nMCP tools touched (verify read-only invariant):\n');
         for (const m of report.touchedMcpTools)

package/dist/commands/check.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check.command.d.ts","sourceRoot":"","sources":["../../src/commands/check.command.ts"],"names":[],"mappings":"AAoBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAkzBhC,eAAO,MAAM,YAAY,EAAE,eA0E1B,CAAC"}
+{"version":3,"file":"check.command.d.ts","sourceRoot":"","sources":["../../src/commands/check.command.ts"],"names":[],"mappings":"AAoBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAu4BhC,eAAO,MAAM,YAAY,EAAE,eA+G1B,CAAC"}

package/dist/commands/check.command.js

@@ -3,6 +3,7 @@ import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { flagBool, flagNumber, flagString, flagVars, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
+import { ExitCode } from "../exit-codes.js";
 import { maybeRunInWatchMode } from "../output/watch-loop.js";
 import { computeDeletedOrphans } from "../diff/deleted-orphans.js";
 import { renderWiringExplain } from "./wiring.command.js";
@@ -522,11 +523,29 @@ async function checkBoundariesOnce(args) {
 // ────────────────────────────────────────────────────────────────────────
 // Subcommand: wiring — "declared but not wired" completeness checks
 // ────────────────────────────────────────────────────────────────────────
+const WIRING_CHECK_USAGE = 'shrk check wiring [--changed-only] [--since <ref>] [--base <ref>] [--only <ids>] [--explain <ruleId>] [--json] [--strict]\n' +
+    '  Cross-file "declared but not wired" completeness gate. Scope flags select rules by\n' +
+    '  FOOTPRINT — a rule fires when the diff touches EITHER its declared or its registered\n' +
+    '  side (so a registration edited in file B fires a rule declared in file A).\n' +
+    '    --changed-only   run only rules whose footprint intersects the working diff\n' +
+    '    --since <ref>    scope the diff to changes since <ref> (--base is a synonym)\n' +
+    '    --only <ids>     run only these rule ids (comma-separated)\n' +
+    '    --explain <id>   dry-run ONE rule and print the declared/registered sets it extracts\n' +
+    '  Exit: 0 verified pass · 1 violations · 2 not-verified (0 rules evaluated in scope).';
 async function checkWiring(args) {
     const cwd = resolveCwd(args);
+    // `--help`/`-h` on the subverb documents its own scoping flags instead of
+    // silently running the bare check (a25 §3.2). The check dispatcher doesn't
+    // intercept a subverb-level `--help`, so handle it here.
+    if (flagBool(args, 'help') || flagBool(args, 'h')) {
+        process.stdout.write(WIRING_CHECK_USAGE + '\n');
+        return 0;
+    }
     const wantJson = flagBool(args, 'json');
     const changedOnly = flagBool(args, 'changed-only');
-    const since = flagString(args, 'since');
+    // `--base <ref>` is an accepted synonym for `--since <ref>` (a25 §3.2) —
+    // scope the footprint diff to changes since an arbitrary ref.
+    const since = flagString(args, 'since') ?? flagString(args, 'base');
     const only = flagString(args, 'only');
     // Distinguish "config is invalid" from "config valid with no wiring rules":
     // an invalid config (e.g. a malformed wiringRule) must NOT fail open with a
@@ -593,20 +612,70 @@ async function checkWiring(args) {
     const report = planeDiagnostics.length > 0
         ? { ...reportRaw, diagnostics: [...reportRaw.diagnostics, ...planeDiagnostics] }
         : reportRaw;
+    // Truthful evaluation accounting so a subset run never reads as a full green.
+    //   configured      — every wiring rule declared (the honest denominator).
+    //   selected        — rules that survived --changed-only / --only narrowing.
+    //   evaluated        — rules that actually ran a comparison (globs matched >0 files).
+    //   skippedByScope  — configured − selected (dropped by the diff/only narrowing).
+    //   matchedNothing  — selected − evaluated (in scope but matched 0 files).
+    const configured = rules.length;
+    const selected = report.rules.length;
+    const evaluated = report.evaluated;
+    const skippedByScope = Math.max(0, configured - selected);
+    const matchedNothing = Math.max(0, selected - evaluated);
+    const notVerified = Math.max(0, configured - evaluated);
+    const allEvaluated = evaluated === configured;
+    const scopeNote = changedOnly || since ? ' by --changed-only' : '';
+    const parts = [];
+    if (skippedByScope > 0)
+        parts.push(`${skippedByScope} skipped${scopeNote}`);
+    if (matchedNothing > 0)
+        parts.push(`${matchedNothing} matched no files`);
+    const breakdown = parts.length > 0 ? ` (${parts.join(', ')})` : '';
+    // Rule ids selected by footprint (declared OR registered side intersecting the
+    // diff) — positive evidence the gate ran the RIGHT rules for the change's
+    // blast radius, not just the rules whose literal files were edited (a25 §3.2).
+    const selectedRuleIds = report.rules.map((r) => r.ruleId);
+    const scoped = changedOnly || since !== undefined;
     if (wantJson) {
-        process.stdout.write(asJson(report) + '\n');
-        return report.verdict === 'errors' ? 1 : 0;
+        // Carry the honest counts so a machine consumer can tell "0 evaluated" from
+        // a real green, and see how many rules the scope skipped + which fired.
+        process.stdout.write(asJson({
+            ...report,
+            configured,
+            selected,
+            evaluated,
+            skippedByScope,
+            matchedNothing,
+            notVerified,
+            selectedRuleIds,
+            // Distinguish verified-pass / failure / not-verified for a chained gate.
+            exitCode: evaluated === 0 ? ExitCode.NotVerified : report.verdict === 'errors' ? ExitCode.Failure : ExitCode.VerifiedPass,
+        }) + '\n');
+        // `evaluated === 0` = nothing checked in scope → NOT verified (`2`), never a
+        // silent `0` an agent's `&& next` would march past (a25 §1.1).
+        return evaluated === 0
+            ? ExitCode.NotVerified
+            : report.verdict === 'errors'
+                ? ExitCode.Failure
+                : ExitCode.VerifiedPass;
     }
     process.stdout.write(header('Wiring check'));
     // `evaluated` counts rules that actually ran a comparison (globs matched >0
     // files). When 0 rules evaluated but rules ARE configured, say so loudly —
-    // "checked nothing" must never read as the green "every token is wired" pass.
-    if (report.evaluated === 0) {
-        process.stdout.write(`  ! Nothing evaluated — ${report.rules.length} rule(s) configured but none matched files in scope` +
-            (changedOnly || since ? ' (changed-only).\n' : '.\n'));
-        return 0;
+    // "checked nothing" must never read as the green "every token is wired" pass,
+    // and the exit code must say NOT verified (`2`) too, not a lying `0`.
+    if (evaluated === 0) {
+        process.stdout.write(`  ! 0 rules evaluated — NOT verified. ${configured} rule(s) configured${breakdown}; ` +
+            'none ran a comparison in scope. Wiring was not checked — this is not a pass.\n');
+        return ExitCode.NotVerified;
+    }
+    process.stdout.write(kv('rules evaluated', `${evaluated} of ${configured}${breakdown}`) + '\n');
+    if (scoped && selectedRuleIds.length > 0) {
+        // Show WHICH rules the diff's footprint selected so the scoping is provable,
+        // not indistinguishable from plain changed-file scoping.
+        process.stdout.write(kv('selected by footprint', selectedRuleIds.join(', ')) + '\n');
     }
-    process.stdout.write(kv('rules evaluated', `${report.evaluated} of ${report.rules.length}`) + '\n');
     const errors = report.violations.filter((v) => v.severity === 'error').length;
     const warnings = report.violations.filter((v) => v.severity === 'warning').length;
     process.stdout.write(kv('violations', `${errors} error(s), ${warnings} warning(s)`) + '\n');
@@ -618,7 +687,16 @@ async function checkWiring(args) {
             process.stdout.write(`  ! ${d}\n`);
     }
     if (report.violations.length === 0 && report.diagnostics.length === 0) {
-        process.stdout.write('\nNo wiring violations — every declared token is registered. ✓\n');
+        if (allEvaluated) {
+            // Every configured rule ran — the earned full green.
+            process.stdout.write('\nNo wiring violations — every declared token is registered. ✓\n');
+        }
+        else {
+            // A subset ran: no violations AMONG WHAT RAN, but not a full green. Never
+            // print the unqualified "every declared token is wired" success sentence.
+            process.stdout.write(`\nNo wiring violations among the ${evaluated} rule(s) evaluated — ` +
+                `${notVerified} of ${configured} NOT verified${breakdown}. Not a full green.\n`);
+        }
         return 0;
     }
     if (report.violations.length === 0) {
@@ -756,21 +834,58 @@ export const checkCommand = {
             return checkOrphans(args);
         if (sub === 'registry-lifecycle') {
             const cwd = resolveCwd(args);
+            const changedOnly = flagBool(args, 'changed-only');
+            const since = flagString(args, 'since');
+            const scope = flagString(args, 'scope');
             const { buildRegistryLifecycleReport, renderRegistryLifecycleReportText } = await import('@shrkcrft/inspector');
-            // The scan is a single synchronous pass with no streamed output; on a
-            // large repo it can run for tens of seconds. Without a heartbeat that
-            // silence reads as a hang, so announce the work first (human path only —
-            // JSON consumers want a clean stdout).
-            if (!flagBool(args, 'json')) {
-                process.stderr.write('⏳ Scanning source + registries for lifecycle coverage (can take a while on large repos)…\n');
+            // `--changed-only` scopes the scan to the diff (tracked + untracked), so it
+            // runs inline in seconds; the full-tree scan is bounded by a wall-clock
+            // budget and flushes partial results on timeout instead of hanging.
+            let files;
+            if (changedOnly || since) {
+                const changed = resolveChangedFiles({
+                    projectRoot: cwd,
+                    ...(since ? { since } : {}),
+                    ...(changedOnly && !since ? { includeWorktree: true } : {}),
+                });
+                files = changed.files;
+            }
+            // Full-tree walk honors the project's skipDirs override (so a repo that
+            // registers code under tools/ etc. isn't blinded by the default set).
+            let skipDirs;
+            if (files === undefined) {
+                const loaded = await resolveProjectConfig(cwd);
+                if (loaded.ok)
+                    skipDirs = loaded.value.config.registryLifecycle?.skipDirs;
+            }
+            // Only the slow full-tree path needs the heartbeat (JSON keeps stdout clean).
+            if (!flagBool(args, 'json') && files === undefined) {
+                process.stderr.write('⏳ Scanning source + registries for lifecycle coverage (bounded by a wall-clock budget)…\n');
             }
-            const report = buildRegistryLifecycleReport({ projectRoot: cwd });
+            const report = buildRegistryLifecycleReport({
+                projectRoot: cwd,
+                ...(files !== undefined ? { files } : {}),
+                ...(scope ? { scope } : {}),
+                ...(skipDirs ? { skipDirs } : {}),
+            });
+            // Honest exit-code contract (a25 §1 / §2.5):
+            //   timedOut          → NOT verified (2): the budget flushed partial results.
+            //   registersFound=0  → NOT verified (2): nothing to check in scope — a
+            //                       "nothing to verify" run must never read as a green
+            //                       pass (an agent's `&& next` would march past it).
+            //   missingRemovers>0 → failure (1).
+            //   otherwise         → verified pass (0).
+            const exit = report.timedOut || report.registersFound === 0
+                ? ExitCode.NotVerified
+                : report.missingRemovers.length === 0
+                    ? ExitCode.VerifiedPass
+                    : ExitCode.Failure;
             if (flagBool(args, 'json')) {
                 process.stdout.write(asJson(report) + '\n');
-                return report.missingRemovers.length === 0 ? 0 : 1;
+                return exit;
             }
             process.stdout.write(renderRegistryLifecycleReportText(report));
-            return report.missingRemovers.length === 0 ? 0 : 1;
+            return exit;
         }
         const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
         const readiness = buildAiReadinessReport(inspection);

package/dist/commands/command-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../src/commands/command-catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../src/commands/command-catalog.ts"],"names":[],"mappings":"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"}

package/dist/commands/command-catalog.js

@@ -1160,6 +1160,14 @@ export const COMMAND_CATALOG = Object.freeze([
         safetyLevel: SafetyLevel.ReadOnly,
         surface: CommandSurface.Common,
     }),
+    entry({
+        command: 'changelog',
+        description: 'The shrk command-surface delta of the running build (added / changed / removed verbs & flags). `--since <version>` for the cumulative delta; offline, authoritative for this exact build.',
+        category: 'meta',
+        safetyLevel: SafetyLevel.ReadOnly,
+        surface: CommandSurface.Common,
+        intendedAudience: [CommandAudience.Human, CommandAudience.Agent],
+    }),
     entry({
         command: 'completion',
         description: 'Print a sourcable shell-completion script for the `shrk` CLI (bash | zsh | fish). Pipe into your shell rc.',

package/dist/commands/compress.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress.command.d.ts","sourceRoot":"","sources":["../../src/commands/compress.command.ts"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAqEhC,eAAO,MAAM,eAAe,EAAE,eAoG7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,eA4B3B,CAAC"}
+{"version":3,"file":"compress.command.d.ts","sourceRoot":"","sources":["../../src/commands/compress.command.ts"],"names":[],"mappings":"AASA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA8FhC,eAAO,MAAM,eAAe,EAAE,eA0H7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,eA4B3B,CAAC"}