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

package/dist/changes-summary.d.ts

@@ -23,6 +23,14 @@ export declare enum ChangeArea {
     Tests = "tests",
     Examples = "examples",
     Scripts = "scripts",
+    /**
+     * Build / CI / tooling directories (`.github/`, `.husky/`, `ci/`, `tooling/`,
+     * `build/`). A generic, project-agnostic bucket so tooling paths stop
+     * falling through to {@link ChangeArea.Unknown}. Distinct from
+     * {@link ChangeArea.Config} (which is for manifest/config *files*) and from
+     * {@link ChangeArea.Scripts} (the dedicated `scripts/` area).
+     */
+    Tooling = "tooling",
     E2E = "e2e",
     Sharkcraft = "sharkcraft-self-config",
     Reports = "reports",
@@ -30,7 +38,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 +62,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":"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"}

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';
@@ -38,6 +39,14 @@ export var ChangeArea;
     ChangeArea["Tests"] = "tests";
     ChangeArea["Examples"] = "examples";
     ChangeArea["Scripts"] = "scripts";
+    /**
+     * Build / CI / tooling directories (`.github/`, `.husky/`, `ci/`, `tooling/`,
+     * `build/`). A generic, project-agnostic bucket so tooling paths stop
+     * falling through to {@link ChangeArea.Unknown}. Distinct from
+     * {@link ChangeArea.Config} (which is for manifest/config *files*) and from
+     * {@link ChangeArea.Scripts} (the dedicated `scripts/` area).
+     */
+    ChangeArea["Tooling"] = "tooling";
     ChangeArea["E2E"] = "e2e";
     ChangeArea["Sharkcraft"] = "sharkcraft-self-config";
     ChangeArea["Reports"] = "reports";
@@ -96,10 +105,112 @@ function classifyArea(file) {
     // doc as `unknown`.
     if (/\.mdx?$/i.test(file))
         return ChangeArea.Docs;
+    // NOTE: generic config / tooling / manifest paths are NOT resolved here. They
+    // are a FALLBACK layer applied by `buildAreaResolver` *after* the declared
+    // taxonomy (see `classifyConfigTooling`), so a project's own area declaration
+    // still wins for config paths it explicitly claims.
     return ChangeArea.Unknown;
 }
-function classifyFile(file) {
-    const area = classifyArea(file);
+/**
+ * Built-in, project-AGNOSTIC config / tooling / manifest classifier.
+ *
+ * This is a FALLBACK layer: `buildAreaResolver` consults it only *after* the
+ * declared taxonomy (boundary `from` globs + monorepo package roots), so a
+ * project that explicitly claims a config path keeps its own area. It exists so
+ * the large slice of a typical changeset that is build / CI / tooling /
+ * manifest / config stops falling through to {@link ChangeArea.Unknown} — which
+ * (with its loud `unknown = taxonomy gap` diagnostic) is now reserved for
+ * *genuinely* unclassifiable paths.
+ *
+ * Ordering is deterministic and most-specific-wins: a recognized manifest /
+ * config *filename* (→ {@link ChangeArea.Config}) is matched before a generic
+ * tooling *directory* (→ {@link ChangeArea.Tooling}). Returns `undefined` when
+ * nothing matches so the caller can fall through to `unknown`.
+ */
+function classifyConfigTooling(file) {
+    const base = file.slice(file.lastIndexOf('/') + 1).toLowerCase();
+    // Manifests / config files (matched by basename, at repo root or anywhere) →
+    // config. Covers: package.json, tsconfig*.json, *.config.{ts,js,mjs,cjs,json},
+    // nx.json, biome.json, .eslintrc*, .prettierrc*, bunfig.toml, lockfiles,
+    // .npmrc, .editorconfig.
+    if (base === 'package.json' ||
+        base === 'nx.json' ||
+        base === 'biome.json' ||
+        base === 'bunfig.toml' ||
+        base === '.npmrc' ||
+        base === '.editorconfig' ||
+        base === 'package-lock.json' ||
+        /^tsconfig(?:\..+)?\.json$/.test(base) ||
+        /\.config\.(?:ts|js|mjs|cjs|json)$/.test(base) ||
+        /^\.eslintrc(?:\..+)?$/.test(base) ||
+        /^\.prettierrc(?:\..+)?$/.test(base) ||
+        // Lockfiles: yarn.lock, pnpm-lock.yaml, bun.lock(b), *.lock / *.lockb.
+        base === 'pnpm-lock.yaml' ||
+        /\.lockb?$/.test(base)) {
+        return ChangeArea.Config;
+    }
+    // CI / build / tooling directories → tooling. (`scripts/` is intentionally
+    // handled earlier by `classifyArea` as its own dedicated area.) `build/` is
+    // treated as build *scripts*; genuine build *output* dirs (e.g. `dist/`) are
+    // not claimed here.
+    if (/(?:^|\/)(?:\.github|\.husky|ci|tooling|build)\//.test(file)) {
+        return ChangeArea.Tooling;
+    }
+    return undefined;
+}
+/** 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`;
+ *   4. built-in, project-agnostic config / tooling / manifest patterns
+ *      ({@link classifyConfigTooling}) — the FALLBACK layer that runs after the
+ *      declared taxonomy so config paths (manifests, lockfiles, CI/build dirs)
+ *      resolve to `config` / `tooling` instead of `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];
+        // Built-in config / tooling fallback — runs last, before `unknown`, so the
+        // declared taxonomy (steps 2–3) still wins where it applies.
+        const configTooling = classifyConfigTooling(file);
+        if (configTooling)
+            return configTooling;
+        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 +357,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 +378,8 @@ export async function buildChangesSummary(inspection, options = {}) {
         ...(options.roundLabel ? { roundLabel: options.roundLabel } : {}),
         totalFiles: classified.length,
         filesByArea,
+        unknownRate,
+        unknownFiles,
         files: classified,
         touchedCommands,
         touchedMcpTools,
@@ -296,6 +412,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/plan-simulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-simulation.d.ts","sourceRoot":"","sources":["../src/plan-simulation.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAK3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAEtE,oBAAY,8BAA8B;IACxC,KAAK,UAAU;IACf,cAAc,oBAAoB;IAClC,QAAQ,aAAa;IACrB,gBAAgB,sBAAsB;IACtC,UAAU,gBAAgB;CAC3B;AAED,oBAAY,kBAAkB;IAC5B,KAAK,UAAU;IACf,eAAe,sBAAsB;IACrC,gBAAgB,sBAAsB;IACtC,aAAa,mBAAmB;IAChC,eAAe,qBAAqB;IACpC,gBAAgB,sBAAsB;IACtC,oBAAoB,2BAA2B;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,8BAA8B,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;qCAEiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;gCAC4B;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;IAChC,uBAAuB,EAAE,OAAO,CAAC;IACjC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,yBAAyB,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACjE,8BAA8B,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACtE,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,cAAc,EAAE,kBAAkB,CAAC;IACnC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAYD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAoG5K;AA+GD,wBAAsB,YAAY,CAChC,UAAU,EAAE,qBAAqB,EACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CA6UhC;AAOD,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAwDzE;AAOD,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAkD7E;AAWD,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAWzE"}
+{"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;AAuOH,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,CA6H3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAwD1F"}

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,13 @@ function isGeneratedFile(file, content) {
         return true;
     return false;
 }
-function walk(dir, projectRoot, out) {
+function walk(dir, projectRoot, out, skipDirs, deadline) {
+    // The wall-clock budget must bound the TREE WALK too, not only the per-file
+    // scan loop — a pathological tree could otherwise eat the whole budget before
+    // the loop's deadline check ever runs (a25 §2.5). Bail the walk on expiry;
+    // partial candidates flow through and the caller flags timedOut.
+    if (deadline !== undefined && Date.now() > deadline)
+        return;
     let entries;
     try {
         entries = readdirSync(dir, { withFileTypes: true });
@@ -40,7 +65,9 @@ function walk(dir, projectRoot, out) {
         return;
     }
     for (const e of entries) {
-        if (SKIP_DIRS.has(e.name))
+        if (deadline !== undefined && Date.now() > deadline)
+            return;
+        if (skipDirs.has(e.name))
             continue;
         if (e.name.startsWith('.') && e.name !== '.sharkcraft') {
             // skip hidden dotfiles
@@ -49,7 +76,7 @@ function walk(dir, projectRoot, out) {
         }
         const abs = join(dir, e.name);
         if (e.isDirectory()) {
-            walk(abs, projectRoot, out);
+            walk(abs, projectRoot, out, skipDirs, deadline);
         }
         else if (e.isFile() && SCAN_EXTENSIONS.has(extname(e.name))) {
             out.push(abs);
@@ -174,7 +201,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 +243,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 +274,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 +287,43 @@ 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, deadline);
+    }
     const scanFiles = files.slice(0, limit);
     const matchedPairs = [];
     const missingRemovers = [];
     const oneShotBootstrap = [];
     const ignored = [];
     let registersFound = 0;
+    // The tree walk itself is now deadline-bounded (a25 §2.5), so an exhausted
+    // budget can leave `scanFiles` empty and the per-file loop below would never
+    // run to set the flag. Seed it from the deadline so a walk-level timeout is
+    // reported (NOT-verified `2`) rather than read as a clean zero-registration pass.
+    let timedOut = Date.now() > deadline;
+    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 +331,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 +363,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 +399,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,13 +418,34 @@ 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}`);
     lines.push(`  one-shot bootstrap ${report.oneShotBootstrap.length}`);
     lines.push(`  ignored           ${report.ignored.length}`);
+    // Zero registrations in scope means nothing was actually checked — say so
+    // loudly so it never reads as the green "all removers present" pass (the exit
+    // code is NOT-verified `2` to match; a25 §1 / §2.5).
+    if (report.registersFound === 0 && !report.timedOut) {
+        lines.push('');
+        lines.push('  ! 0 registrations found in scope — lifecycle NOT verified (this is not a pass).');
+    }
     lines.push('');
     if (report.missingRemovers.length > 0) {
         lines.push('Missing removers:');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/inspector",
-  "version": "0.1.0-alpha.24",
+  "version": "0.1.0-alpha.26",
   "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.24",
-    "@shrkcrft/config": "^0.1.0-alpha.24",
-    "@shrkcrft/workspace": "^0.1.0-alpha.24",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.24",
-    "@shrkcrft/rules": "^0.1.0-alpha.24",
-    "@shrkcrft/paths": "^0.1.0-alpha.24",
-    "@shrkcrft/templates": "^0.1.0-alpha.24",
-    "@shrkcrft/context": "^0.1.0-alpha.24",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.24",
-    "@shrkcrft/packs": "^0.1.0-alpha.24",
-    "@shrkcrft/presets": "^0.1.0-alpha.24",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.24",
-    "@shrkcrft/generator": "^0.1.0-alpha.24",
-    "@shrkcrft/importer": "^0.1.0-alpha.24",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.24",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.24",
+    "@shrkcrft/core": "^0.1.0-alpha.26",
+    "@shrkcrft/config": "^0.1.0-alpha.26",
+    "@shrkcrft/workspace": "^0.1.0-alpha.26",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.26",
+    "@shrkcrft/rules": "^0.1.0-alpha.26",
+    "@shrkcrft/paths": "^0.1.0-alpha.26",
+    "@shrkcrft/templates": "^0.1.0-alpha.26",
+    "@shrkcrft/context": "^0.1.0-alpha.26",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.26",
+    "@shrkcrft/packs": "^0.1.0-alpha.26",
+    "@shrkcrft/presets": "^0.1.0-alpha.26",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.26",
+    "@shrkcrft/generator": "^0.1.0-alpha.26",
+    "@shrkcrft/importer": "^0.1.0-alpha.26",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.26",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.26",
     "typescript": "^5.6.0"
   },
   "publishConfig": {