@shrkcrft/inspector 0.1.0-alpha.23 → 0.1.0-alpha.25

package/dist/changes-summary.d.ts

@@ -30,7 +30,13 @@ export declare enum ChangeArea {
 }
 export interface IChangedFileSummary {
     path: string;
-    area: ChangeArea;
+    /**
+     * Resolved area. One of the built-in {@link ChangeArea} slugs, OR a
+     * project-declared area (a boundary-rule tag/id or a monorepo package name)
+     * when the built-in taxonomy doesn't cover the file. `'unknown'` only when no
+     * declared taxonomy matches either — a high unknown rate is itself a signal.
+     */
+    area: string;
     isTest: boolean;
     isDoc: boolean;
     isMcpTool: boolean;
@@ -48,6 +54,14 @@ export interface IChangesSummaryReport {
     roundLabel?: string;
     totalFiles: number;
     filesByArea: Record<string, readonly string[]>;
+    /**
+     * Fraction (0..1) of changed files that resolved to no declared area. A high
+     * rate is a classifier self-diagnostic — the declared taxonomy is missing
+     * globs, not that the diff is low-risk.
+     */
+    unknownRate: number;
+    /** Count of files bucketed as `unknown` (the numerator behind `unknownRate`). */
+    unknownFiles: number;
     files: readonly IChangedFileSummary[];
     /** Touched CLI command files (relative). */
     touchedCommands: readonly string[];

package/dist/changes-summary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changes-summary.d.ts","sourceRoot":"","sources":["../src/changes-summary.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"changes-summary.d.ts","sourceRoot":"","sources":["../src/changes-summary.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,oBAAY,UAAU;IACpB,GAAG,QAAQ;IACX,SAAS,eAAe;IACxB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,eAAe;IACxB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,WAAW,uBAAuB;IAClC,YAAY,kBAAkB;IAC9B,IAAI,SAAS;IACb,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,GAAG,QAAQ;IACX,UAAU,2BAA2B;IACrC,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,CAAC;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAC/C;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtC,4CAA4C;IAC5C,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,8BAA8B;IAC9B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gDAAgD;IAChD,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0BAA0B;IAC1B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,0BAA0B;IAC1B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,2CAA2C;IAC3C,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,qCAAqC;IACrC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,0CAA0C;IAC1C,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChC,wCAAwC;IACxC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,qCAAqC;IACrC,2BAA2B,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmND,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA2DhC;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAsDlF"}

package/dist/changes-summary.js

@@ -11,6 +11,7 @@
  *
  * Read-only; no AI; deterministic. Schema: sharkcraft.changes-summary/v1.
  */
+import { globToRegex } from '@shrkcrft/boundaries';
 import { getChangedFiles } from "./git-helpers.js";
 import { resolveVerificationCommands } from "./resolve-verification-commands.js";
 export const CHANGES_SUMMARY_SCHEMA = 'sharkcraft.changes-summary/v1';
@@ -98,8 +99,50 @@ function classifyArea(file) {
         return ChangeArea.Docs;
     return ChangeArea.Unknown;
 }
-function classifyFile(file) {
-    const area = classifyArea(file);
+/** Generic monorepo package/app root → area name. */
+const PACKAGE_ROOT_RE = /^(?:packages|apps|libs|modules|services)\/([^/]+)\//;
+/**
+ * Build a resolver that maps a file to a declared area, falling back to the
+ * built-in SharkCraft prefixes. Sources, in priority order:
+ *   1. the built-in {@link classifyArea} slugs (nice names for this repo);
+ *   2. the boundary gate's own `from` globs — the declared layer/area taxonomy;
+ *   3. a generic monorepo package/app root (`packages/<name>/…` → `<name>`), so
+ *      a foreign monorepo's packages resolve instead of bucketing to `unknown`.
+ * A file only stays `unknown` when NONE of these match — and a high unknown rate
+ * is surfaced as a self-diagnostic (`unknownRate`), not a low-risk diff.
+ */
+function buildAreaResolver(inspection) {
+    const boundaryMatchers = [];
+    try {
+        for (const rule of inspection.boundaryRegistry?.list() ?? []) {
+            const from = rule.from ?? [];
+            if (from.length === 0)
+                continue;
+            boundaryMatchers.push({
+                area: rule.tags?.[0] ?? rule.id,
+                matchers: from.map((g) => globToRegex(g)),
+            });
+        }
+    }
+    catch {
+        // Boundary registry unavailable — fall through to built-ins + package roots.
+    }
+    return (file) => {
+        const builtin = classifyArea(file);
+        if (builtin !== ChangeArea.Unknown)
+            return builtin;
+        for (const b of boundaryMatchers) {
+            if (b.matchers.some((re) => re.test(file)))
+                return b.area;
+        }
+        const pkg = PACKAGE_ROOT_RE.exec(file);
+        if (pkg?.[1])
+            return pkg[1];
+        return ChangeArea.Unknown;
+    };
+}
+function classifyFile(file, resolveArea) {
+    const area = resolveArea(file);
     const lower = file.toLowerCase();
     const isTest = lower.includes('__tests__/') ||
         lower.endsWith('.test.ts') ||
@@ -246,8 +289,11 @@ export async function buildChangesSummary(inspection, options = {}) {
         changedFiles = getChangedFiles(cwd, { includeWorktree: true });
         source = 'working-tree';
     }
-    const classified = changedFiles.map(classifyFile);
+    const resolveArea = buildAreaResolver(inspection);
+    const classified = changedFiles.map((f) => classifyFile(f, resolveArea));
     const filesByArea = groupByArea(classified);
+    const unknownFiles = classified.filter((c) => c.area === ChangeArea.Unknown).length;
+    const unknownRate = classified.length > 0 ? unknownFiles / classified.length : 0;
     const touchedCommands = classified.filter((c) => c.isCliCommand).map((c) => c.path);
     const touchedMcpTools = classified.filter((c) => c.isMcpTool).map((c) => c.path);
     const touchedSchemas = classified.filter((c) => c.isSchema).map((c) => c.path);
@@ -264,6 +310,8 @@ export async function buildChangesSummary(inspection, options = {}) {
         ...(options.roundLabel ? { roundLabel: options.roundLabel } : {}),
         totalFiles: classified.length,
         filesByArea,
+        unknownRate,
+        unknownFiles,
         files: classified,
         touchedCommands,
         touchedMcpTools,
@@ -296,6 +344,9 @@ export function renderChangesSummaryMarkdown(report) {
         for (const f of files)
             lines.push(`- ${f}`);
     }
+    if (report.unknownFiles > 0) {
+        lines.push(`> ⚠ ${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).`);
+    }
     if (report.touchedCommands.length > 0) {
         lines.push('');
         lines.push('## Touched CLI commands');

package/dist/coverage-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coverage-report.d.ts","sourceRoot":"","sources":["../src/coverage-report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAOD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,eAAe,CA6LtF"}
+{"version":3,"file":"coverage-report.d.ts","sourceRoot":"","sources":["../src/coverage-report.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAOD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,eAAe,CA2NtF"}

package/dist/coverage-report.js

@@ -1,4 +1,4 @@
-import { hasActionHints } from '@shrkcrft/knowledge';
+import { hasActionHints, hasMeaningfulActionHints, KNOWLEDGE_TYPES_NO_ACTION, } from '@shrkcrft/knowledge';
 import { resolvePreset, resolvePresetReferences } from '@shrkcrft/presets';
 import { inspectionReferenceLookup } from "./reference-lookup.js";
 function pct(covered, total) {
@@ -57,24 +57,47 @@ export function buildCoverageReport(inspection) {
             missing,
         });
     }
-    // 3. Critical/high knowledge entries with action hints.
+    // 3. Critical/high knowledge entries carry a MEANINGFUL action hint.
+    //    Quality, not mere presence: a hollow/templated hint (a `<command>`
+    //    placeholder, a lone requiresHumanReview, an empty object) does NOT count,
+    //    so an agent can't clear the gate with uniform low-value metadata. Entries
+    //    with no actionable next step are exempt from the denominator — a per-entry
+    //    author `noAction: true` (the precise lever) OR a purely-descriptive type
+    //    (business/decision — the conservative floor) — so the target isn't
+    //    artificially 100% and nobody is pushed to bolt a hollow hint on.
     {
         const eligible = inspection.knowledgeEntries.filter((e) => {
             const p = String(e.priority);
             return p === 'critical' || p === 'high';
         });
-        const total = eligible.length;
+        const actionable = eligible.filter((e) => e.noAction !== true && !KNOWLEDGE_TYPES_NO_ACTION.has(e.type));
+        const total = actionable.length;
+        const knowledgeIds = new Set(inspection.knowledgeEntries.map((x) => x.id));
+        const templateIds = new Set(inspection.templates.map((t) => t.id));
         const missing = [];
         let covered = 0;
-        for (const e of eligible) {
-            if (hasActionHints(e))
+        for (const e of actionable) {
+            if (hasMeaningfulActionHints(e)) {
                 covered += 1;
-            else
-                missing.push(`${e.id} — no actionHints`);
+                continue;
+            }
+            // Reward RESOLVED cross-references: a hint whose related ids actually
+            // point at real entries/templates is substantive even without a command.
+            const a = e.actionHints;
+            const resolvedXref = !!a &&
+                ((a.relatedKnowledge?.some((id) => knowledgeIds.has(id)) ?? false) ||
+                    (a.relatedTemplates?.some((id) => templateIds.has(id)) ?? false));
+            if (resolvedXref) {
+                covered += 1;
+                continue;
+            }
+            missing.push(hasActionHints(e)
+                ? `${e.id} — actionHints present but low-value (templated/empty/unresolved cross-refs)`
+                : `${e.id} — no actionHints`);
         }
         categories.push({
             id: 'hint-coverage',
-            title: 'Critical/high entries carry actionHints',
+            title: 'Critical/high entries carry a meaningful actionHint',
             total,
             covered,
             score: pct(covered, total),

package/dist/git-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-helpers.d.ts","sourceRoot":"","sources":["../src/git-helpers.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAWD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,MAAM,EAAE,CAwBpF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAyC/D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,EAAE,CA6BrF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD"}
+{"version":3,"file":"git-helpers.d.ts","sourceRoot":"","sources":["../src/git-helpers.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB;AAqBD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKvD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,MAAM,EAAE,CAwBpF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAyC/D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,EAAE,CA6BrF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjD"}

package/dist/git-helpers.js

@@ -1,8 +1,17 @@
 import { spawnSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
+// 512 MB — the same generous ceiling @shrkcrft/shared's runGitLines uses. A
+// `diff`/`log --name-only` listing on a large changeset overflows Node's 1 MB
+// default `maxBuffer` and dies with ENOBUFS; a name listing never approaches
+// 512 MB, so this is effectively unbounded while still capping a runaway.
+const GIT_MAX_BUFFER = 512 * 1024 * 1024;
 function runGit(cwd, args) {
-    const res = spawnSync('git', args, { cwd, encoding: 'utf8' });
+    const res = spawnSync('git', args, {
+        cwd,
+        encoding: 'utf8',
+        maxBuffer: GIT_MAX_BUFFER,
+    });
     return {
         ok: res.status === 0,
         stdout: (res.stdout ?? '').toString(),

package/dist/pack-quality-score.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-quality-score.d.ts","sourceRoot":"","sources":["../src/pack-quality-score.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,eAAO,MAAM,mBAAmB,qCAAqC,CAAC;AACtE,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9F,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,iBAAiB,GAC1B,gBAAgB,CA2BlB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAMD,wBAAgB,SAAS,CACvB,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAmInB;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,iBAAiB,EAAE,CAEpF"}
+{"version":3,"file":"pack-quality-score.d.ts","sourceRoot":"","sources":["../src/pack-quality-score.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,eAAO,MAAM,mBAAmB,qCAAqC,CAAC;AACtE,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9F,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,iBAAiB,GAC1B,gBAAgB,CA2BlB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,mBAAmB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAMD,wBAAgB,SAAS,CACvB,UAAU,EAAE,qBAAqB,EACjC,IAAI,EAAE,eAAe,GACpB,iBAAiB,CAyInB;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,iBAAiB,EAAE,CAEpF"}

package/dist/pack-quality-score.js

@@ -1,4 +1,5 @@
 import { CONTRIBUTION_FILE_KEYS } from '@shrkcrft/plugin-api';
+import { hasMeaningfulActionHints, KNOWLEDGE_TYPES_NO_ACTION, } from '@shrkcrft/knowledge';
 import { lintTemplates } from "./template-lint.js";
 import { lintPipelines } from "./pipeline-lint.js";
 export const PACK_QUALITY_SCHEMA = 'sharkcraft.pack-quality-score/v1';
@@ -117,15 +118,20 @@ export function scorePack(inspection, pack) {
         weight: 0.7,
         notes: pipFromPack.length === 0 ? ['No pipelines contributed'] : [],
     });
-    // Action hints presence.
+    // Action hints QUALITY (not mere presence): score only entries that carry a
+    // substantive, non-templated hint, and exempt purely-descriptive types
+    // (business/decision) from the denominator so a pack can't game the gate with
+    // hollow metadata on context-only entries.
     const packEntries = inspection.knowledgeEntries.filter((e) => inspection.entrySources.get(e.id)?.packageName === pack.packageName);
-    const entriesWithHints = packEntries.filter((e) => e.actionHints !== undefined).length;
+    const actionable = packEntries.filter((e) => e.noAction !== true && !KNOWLEDGE_TYPES_NO_ACTION.has(e.type));
+    const entriesWithMeaningfulHints = actionable.filter((e) => hasMeaningfulActionHints(e)).length;
+    const hollow = actionable.length - entriesWithMeaningfulHints;
     dims.push({
         id: 'action-hints',
-        label: 'Action hints',
-        score: packEntries.length === 0 ? 70 : Math.round((entriesWithHints / packEntries.length) * 100),
+        label: 'Action hints quality',
+        score: actionable.length === 0 ? 70 : Math.round((entriesWithMeaningfulHints / actionable.length) * 100),
         weight: 0.6,
-        notes: [],
+        notes: hollow > 0 ? [`${hollow} entry(ies) lack a meaningful (non-templated) actionHint`] : [],
     });
     // Duplicate ids guard.
     dims.push({

package/dist/plan-simulation.d.ts.map

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

package/dist/plan-simulation.js

@@ -522,6 +522,15 @@ export async function simulatePlan(inspection, planPath, options = {}) {
     if (potentialBoundaryConcerns.length > 0 || planIntroducedBoundaryConcerns.length > 0) {
         requiredValidations.add('shrk architecture violations');
     }
+    // Scale the required-validation wall to BLAST RADIUS: a one-file scaffold and a
+    // multi-file / multi-package construct shouldn't get the same wall. A broad
+    // change earns the composite changed-only "safe to finish?" verdict (project-
+    // agnostic — always a valid shrk command) on top of the per-file checks.
+    const touchedPackages = new Set(sourceList.map((c) => /^((?:packages|apps|libs|modules|services)\/[^/]+)\//.exec(c.relativePath)?.[1] ?? '(root)'));
+    const blastRadius = { files: sourceList.length, packages: touchedPackages.size };
+    if (blastRadius.files >= 5 || blastRadius.packages >= 2) {
+        requiredValidations.add('shrk finish');
+    }
     // Affected constructs / playbooks (lightweight).
     await loadConstructs(inspection);
     const constructList = listConstructs(inspection) ?? [];

package/dist/registry-lifecycle.d.ts

@@ -37,6 +37,10 @@ export interface IRegistryLifecycleReport {
     totalFiles: number;
     /** True when the scan hit the file cap and did NOT see every candidate file. */
     truncated: boolean;
+    /** True when the scan hit its wall-clock budget and flushed partial results. */
+    timedOut: boolean;
+    /** True when the scan was scoped to the changed file set (`--changed-only`). */
+    changedOnly: boolean;
     /** Project-relative subtree the scan was scoped to, when `--scope` was used. */
     scope?: string;
     registersFound: number;
@@ -51,11 +55,33 @@ export interface IRegistryLifecycleReport {
     ignored: ReadonlyArray<IRegistryIgnored>;
     recommendations: ReadonlyArray<string>;
 }
+/**
+ * Default directories the walk skips — build artefacts + non-source trees that
+ * inflate the scan without owning runtime lifecycle. This is the DEFAULT only;
+ * a repo that genuinely registers code under `tools/`, a non-standard root, etc.
+ * can override the set via config (`registryLifecycle.skipDirs`) / the engine's
+ * `skipDirs` input, so a hardcoded exclusion never silently blinds the check.
+ */
+export declare const DEFAULT_REGISTRY_LIFECYCLE_SKIP_DIRS: readonly string[];
 export declare function buildRegistryLifecycleReport(input: {
     projectRoot: string;
     limit?: number;
     /** Project-relative subtree to scope the scan to (sub-second on a subtree). */
     scope?: string;
+    /**
+     * Changed-only scope: scan JUST these files (project-relative or absolute)
+     * instead of walking the tree. Non-`.ts/.tsx` entries are ignored. When set,
+     * an empty relevant set is reported as a loud skip, never a green pass.
+     */
+    files?: readonly string[];
+    /** Hard wall-clock budget (ms). The scan flushes partial results on timeout. */
+    budgetMs?: number;
+    /**
+     * Directory names the walk skips. Overrides {@link DEFAULT_REGISTRY_LIFECYCLE_SKIP_DIRS}
+     * so a repo that registers code under `tools/` / a non-standard root isn't
+     * silently blinded by a baked-in exclusion. Ignored on the changed-only path.
+     */
+    skipDirs?: readonly string[];
 }): IRegistryLifecycleReport;
 export declare function renderRegistryLifecycleReportText(report: IRegistryLifecycleReport): string;
 //# sourceMappingURL=registry-lifecycle.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry-lifecycle.d.ts","sourceRoot":"","sources":["../src/registry-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,kCAAkC,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC3C,eAAe,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACxD;;;;OAIG;IACH,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACzC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAiMD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,wBAAwB,CA2F3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAkC1F"}
+{"version":3,"file":"registry-lifecycle.d.ts","sourceRoot":"","sources":["../src/registry-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,kCAAkC,CAAC;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC3C,eAAe,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACxD;;;;OAIG;IACH,gBAAgB,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACzC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,EAAE,SAAS,MAAM,EAiBhE,CAAC;AA2NH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,GAAG,wBAAwB,CAyH3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAiD1F"}

package/dist/registry-lifecycle.js

@@ -11,7 +11,14 @@
  */
 import { readdirSync, readFileSync } from 'node:fs';
 import { extname, join, relative } from 'node:path';
-const SKIP_DIRS = new Set([
+/**
+ * Default directories the walk skips — build artefacts + non-source trees that
+ * inflate the scan without owning runtime lifecycle. This is the DEFAULT only;
+ * a repo that genuinely registers code under `tools/`, a non-standard root, etc.
+ * can override the set via config (`registryLifecycle.skipDirs`) / the engine's
+ * `skipDirs` input, so a hardcoded exclusion never silently blinds the check.
+ */
+export const DEFAULT_REGISTRY_LIFECYCLE_SKIP_DIRS = Object.freeze([
     'node_modules',
     'dist',
     '.git',
@@ -20,8 +27,20 @@ const SKIP_DIRS = new Set([
     '.nx',
     'build',
     'out',
+    'examples',
+    'e2e',
+    'fixtures',
+    '__fixtures__',
+    'scripts',
+    'tools',
+    '.agents',
+    '.github',
 ]);
 const SCAN_EXTENSIONS = new Set(['.ts', '.tsx']);
+/** Skip pathological single files — a 200 KB command file has no registry to pair. */
+const MAX_SCAN_FILE_BYTES = 256 * 1024;
+/** Hard wall-clock budget so the scan fails loud (partial flush) instead of hanging. */
+const DEFAULT_BUDGET_MS = 15_000;
 function isGeneratedFile(file, content) {
     if (file.endsWith('.d.ts'))
         return true;
@@ -31,7 +50,7 @@ function isGeneratedFile(file, content) {
         return true;
     return false;
 }
-function walk(dir, projectRoot, out) {
+function walk(dir, projectRoot, out, skipDirs) {
     let entries;
     try {
         entries = readdirSync(dir, { withFileTypes: true });
@@ -40,7 +59,7 @@ function walk(dir, projectRoot, out) {
         return;
     }
     for (const e of entries) {
-        if (SKIP_DIRS.has(e.name))
+        if (skipDirs.has(e.name))
             continue;
         if (e.name.startsWith('.') && e.name !== '.sharkcraft') {
             // skip hidden dotfiles
@@ -49,7 +68,7 @@ function walk(dir, projectRoot, out) {
         }
         const abs = join(dir, e.name);
         if (e.isDirectory()) {
-            walk(abs, projectRoot, out);
+            walk(abs, projectRoot, out, skipDirs);
         }
         else if (e.isFile() && SCAN_EXTENSIONS.has(extname(e.name))) {
             out.push(abs);
@@ -174,7 +193,38 @@ function stripCommentsAndLiterals(content) {
     }
     return out.join('');
 }
-function findRegistersInFile(content) {
+/**
+ * Precompute the byte offset of each line start, so an offset → line lookup is
+ * O(log n) instead of the O(fileLen) `content.slice(0, i).split('\n')` done PER
+ * MATCH (the original quadratic hotspot — a 57 KB file with 200 `register*`
+ * tokens paid ~200 × 57 KB of slicing). Built once per file.
+ */
+function buildLineStarts(content) {
+    const starts = [0];
+    for (let i = 0; i < content.length; i += 1) {
+        if (content.charCodeAt(i) === 10 /* \n */)
+            starts.push(i + 1);
+    }
+    return starts;
+}
+/** 1-based line number for a byte offset, via binary search over line starts. */
+function lineAtOffset(lineStarts, offset) {
+    let lo = 0;
+    let hi = lineStarts.length - 1;
+    let ans = 0;
+    while (lo <= hi) {
+        const mid = (lo + hi) >> 1;
+        if (lineStarts[mid] <= offset) {
+            ans = mid;
+            lo = mid + 1;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    return ans + 1;
+}
+function findRegistersInFile(content, lineStarts) {
     const out = [];
     const seen = new Set();
     for (const re of REGISTER_PATTERNS) {
@@ -185,8 +235,7 @@ function findRegistersInFile(content) {
             if (seen.has(`${name}@${m.index}`))
                 continue;
             seen.add(`${name}@${m.index}`);
-            const line = content.slice(0, m.index).split('\n').length;
-            out.push({ name, line });
+            out.push({ name, line: lineAtOffset(lineStarts, m.index) });
         }
     }
     return out;
@@ -217,13 +266,12 @@ function expectedRemoverNames(registerName) {
         `${stem}Off`,
     ];
 }
-function findRemoverInContent(content, candidates) {
+function findRemoverInContent(content, candidates, lineStarts) {
     for (const name of candidates) {
         const re = new RegExp(`(?:export\\s+)?(?:async\\s+)?function\\s+${name}\\s*\\(|\\b${name}\\s*=\\s*\\(|(?:public|private|protected)?\\s*(?:async\\s+)?${name}\\s*\\(`);
         const m = content.match(re);
         if (m && typeof m.index === 'number') {
-            const line = content.slice(0, m.index).split('\n').length;
-            return { name, line };
+            return { name, line: lineAtOffset(lineStarts, m.index) };
         }
     }
     return null;
@@ -231,17 +279,39 @@ function findRemoverInContent(content, candidates) {
 export function buildRegistryLifecycleReport(input) {
     const { projectRoot } = input;
     const scope = input.scope && input.scope.length > 0 ? input.scope : undefined;
-    const walkRoot = scope ? join(projectRoot, scope) : projectRoot;
-    const files = [];
-    walk(walkRoot, projectRoot, files);
+    const changedOnly = input.files !== undefined;
+    const deadline = Date.now() + (input.budgetMs ?? DEFAULT_BUDGET_MS);
     const limit = input.limit ?? 2000;
+    const skipDirs = new Set(input.skipDirs ?? DEFAULT_REGISTRY_LIFECYCLE_SKIP_DIRS);
+    // Candidate files: either the explicit changed set (bypassing the walk) or a
+    // bounded tree walk. The changed set resolves relative paths under the root
+    // and keeps only scannable extensions.
+    let files;
+    if (input.files !== undefined) {
+        files = input.files
+            .map((f) => (f.startsWith('/') ? f : join(projectRoot, f)))
+            .filter((f) => SCAN_EXTENSIONS.has(extname(f)));
+    }
+    else {
+        const walkRoot = scope ? join(projectRoot, scope) : projectRoot;
+        files = [];
+        walk(walkRoot, projectRoot, files, skipDirs);
+    }
     const scanFiles = files.slice(0, limit);
     const matchedPairs = [];
     const missingRemovers = [];
     const oneShotBootstrap = [];
     const ignored = [];
     let registersFound = 0;
+    let timedOut = false;
+    let filesScanned = 0;
     for (const file of scanFiles) {
+        // Hard wall-clock budget checked between files — the scan is synchronous, so
+        // a Date.now() deadline is the only interruption point. Flush partial results.
+        if (Date.now() > deadline) {
+            timedOut = true;
+            break;
+        }
         let content;
         try {
             content = readFileSync(file, 'utf8');
@@ -249,12 +319,19 @@ export function buildRegistryLifecycleReport(input) {
         catch {
             continue;
         }
+        // Per-file size cap: a huge file (a big command/aggregate module) is a
+        // catastrophic-backtracking / quadratic hazard and never holds a registry
+        // that owes a remover. Skip it rather than let one file wedge the scan.
+        if (content.length > MAX_SCAN_FILE_BYTES)
+            continue;
         if (isGeneratedFile(file, content))
             continue;
+        filesScanned += 1;
         // Scan declarations on code with comments/strings blanked out; keep the raw
         // content only for the comment-based @shrkcrft annotations.
         const code = stripCommentsAndLiterals(content);
-        const registers = findRegistersInFile(code);
+        const lineStarts = buildLineStarts(code);
+        const registers = findRegistersInFile(code, lineStarts);
         // Per-file lifecycle evidence: only a file that BOTH accumulates removable
         // state AND has a teardown-shaped API plausibly owes a per-register remover.
         const hasAccumulation = ACCUMULATION_RE.test(code);
@@ -274,7 +351,7 @@ export function buildRegistryLifecycleReport(input) {
                 continue;
             }
             const candidates = expectedRemoverNames(reg.name);
-            const remover = findRemoverInContent(code, candidates);
+            const remover = findRemoverInContent(code, candidates, lineStarts);
             if (remover) {
                 matchedPairs.push({
                     registerName: reg.name,
@@ -310,9 +387,11 @@ export function buildRegistryLifecycleReport(input) {
     }
     return {
         schema: 'sharkcraft.registry-lifecycle/v1',
-        filesScanned: scanFiles.length,
+        filesScanned,
         totalFiles: files.length,
-        truncated: files.length > scanFiles.length,
+        truncated: files.length > scanFiles.length || timedOut,
+        timedOut,
+        changedOnly,
         ...(scope ? { scope } : {}),
         registersFound,
         matchedPairs,
@@ -327,8 +406,22 @@ export function renderRegistryLifecycleReportText(report) {
     lines.push('=== Registry lifecycle ===');
     if (report.scope)
         lines.push(`  scope             ${report.scope}`);
+    if (report.changedOnly)
+        lines.push('  scope             changed-only');
+    // Loud skip: a changed diff that touches no scannable file was NOT verified —
+    // never let "scanned nothing" read as a clean pass.
+    if (report.changedOnly && report.filesScanned === 0) {
+        lines.push('');
+        lines.push('  ! 0 files in the changed scope — lifecycle NOT verified (this is not a pass).');
+        return lines.join('\n') + '\n';
+    }
+    if (report.timedOut) {
+        lines.push(`  ! wall-clock budget hit — scanned ${report.filesScanned}/${report.totalFiles} before flushing partial results (re-run with --scope <dir> to finish).`);
+    }
     lines.push(`  files scanned     ${report.filesScanned}` +
-        (report.truncated ? ` ! capped (${report.totalFiles} candidates — re-run with --scope <dir> for the rest)` : ''));
+        (report.truncated && !report.timedOut
+            ? ` ! capped (${report.totalFiles} candidates — re-run with --scope <dir> for the rest)`
+            : ''));
     lines.push(`  registers found   ${report.registersFound}`);
     lines.push(`  matched pairs     ${report.matchedPairs.length}`);
     lines.push(`  missing removers  ${report.missingRemovers.length}`);

package/dist/resolve-project-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-project-config.d.ts","sourceRoot":"","sources":["../src/resolve-project-config.ts"],"names":[],"mappings":"AAuBA,OAAO,EAGL,KAAK,QAAQ,EAKb,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AA+GD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC,CAqDnD"}
+{"version":3,"file":"resolve-project-config.d.ts","sourceRoot":"","sources":["../src/resolve-project-config.ts"],"names":[],"mappings":"AAuBA,OAAO,EAGL,KAAK,QAAQ,EAMb,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAOL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAoHD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC,CAoEnD"}

package/dist/resolve-project-config.js

@@ -22,7 +22,7 @@
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { importModuleViaLoader, ok, } from '@shrkcrft/core';
-import { loadProjectConfig, PolicyRuleSchema, RegistryDeclarationSchema, ReusePrimitiveSchema, WiringRuleSchema, } from '@shrkcrft/config';
+import { loadProjectConfig, PolicyRuleSchema, RegistrationIdiomSchema, RegistryDeclarationSchema, ReusePrimitiveSchema, WiringRuleSchema, } from '@shrkcrft/config';
 import { discoverPacks } from '@shrkcrft/packs';
 /**
  * Generic per-plane load + validate + merge. Seeds the merged map from the
@@ -118,11 +118,19 @@ export async function resolveProjectConfig(cwd) {
     }
     const wiringRules = await mergePlane(base.config.wiringRules ?? [], gatherPackContribs(validPacks, 'wiringRuleFiles'), WiringRuleSchema, (r) => r.id, 'wiringRule', diagnostics);
     const registries = await mergePlane(base.config.registries ?? [], gatherPackContribs(validPacks, 'registryFiles'), RegistryDeclarationSchema, (r) => r.name, 'registry', diagnostics);
+    const registrationGraph = await mergePlane(base.config.registrationGraph ?? [], gatherPackContribs(validPacks, 'registrationGraphFiles'), RegistrationIdiomSchema, (r) => r.name, 'registrationIdiom', diagnostics);
     const policyRules = await mergePlane(base.config.policyRules ?? [], gatherPackContribs(validPacks, 'policyRuleFiles'), PolicyRuleSchema, (r) => r.id, 'policyRule', diagnostics);
     const reusePrimitives = await mergePlane(base.config.reusePrimitives ?? [], gatherPackContribs(validPacks, 'reusePrimitiveFiles'), ReusePrimitiveSchema, (r) => r.symbol, 'reusePrimitive', diagnostics);
     return ok({
         ...base,
-        config: { ...base.config, wiringRules, registries, policyRules, reusePrimitives },
+        config: {
+            ...base.config,
+            wiringRules,
+            registries,
+            registrationGraph,
+            policyRules,
+            reusePrimitives,
+        },
         planeDiagnostics: diagnostics,
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/inspector",
-  "version": "0.1.0-alpha.23",
+  "version": "0.1.0-alpha.25",
   "description": "SharkCraft inspector: project overview, doctor checks, AI-agent instructions.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -42,22 +42,22 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.23",
-    "@shrkcrft/config": "^0.1.0-alpha.23",
-    "@shrkcrft/workspace": "^0.1.0-alpha.23",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.23",
-    "@shrkcrft/rules": "^0.1.0-alpha.23",
-    "@shrkcrft/paths": "^0.1.0-alpha.23",
-    "@shrkcrft/templates": "^0.1.0-alpha.23",
-    "@shrkcrft/context": "^0.1.0-alpha.23",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.23",
-    "@shrkcrft/packs": "^0.1.0-alpha.23",
-    "@shrkcrft/presets": "^0.1.0-alpha.23",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.23",
-    "@shrkcrft/generator": "^0.1.0-alpha.23",
-    "@shrkcrft/importer": "^0.1.0-alpha.23",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.23",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.23",
+    "@shrkcrft/core": "^0.1.0-alpha.25",
+    "@shrkcrft/config": "^0.1.0-alpha.25",
+    "@shrkcrft/workspace": "^0.1.0-alpha.25",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.25",
+    "@shrkcrft/rules": "^0.1.0-alpha.25",
+    "@shrkcrft/paths": "^0.1.0-alpha.25",
+    "@shrkcrft/templates": "^0.1.0-alpha.25",
+    "@shrkcrft/context": "^0.1.0-alpha.25",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.25",
+    "@shrkcrft/packs": "^0.1.0-alpha.25",
+    "@shrkcrft/presets": "^0.1.0-alpha.25",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.25",
+    "@shrkcrft/generator": "^0.1.0-alpha.25",
+    "@shrkcrft/importer": "^0.1.0-alpha.25",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.25",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.25",
     "typescript": "^5.6.0"
   },
   "publishConfig": {