@shrkcrft/inspector 0.1.0-alpha.19 → 0.1.0-alpha.20

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

@@ -90,6 +90,11 @@ function classifyArea(file) {
     if (/(?:^|\/)[\w-]*sharkcraft-pack\//.test(file)) {
         return ChangeArea.PackContrib;
     }
+    // Extension fallback so the summary stays useful in non-SharkCraft repos
+    // (e.g. a foreign monorepo's `architecture/*.md`) instead of bucketing every
+    // doc as `unknown`.
+    if (/\.mdx?$/i.test(file))
+        return ChangeArea.Docs;
     return ChangeArea.Unknown;
 }
 function classifyFile(file) {
@@ -229,7 +234,11 @@ export async function buildChangesSummary(inspection, options = {}) {
         ref = options.since;
     }
     else {
-        changedFiles = getChangedFiles(cwd, {});
+        // Default working-tree view must include untracked files — otherwise a
+        // brand-new (never-staged) file is invisible to the summary, which made
+        // `totalFiles` undercount whole untracked directories. Mirrors every other
+        // working-tree caller (boundaries / propose-knowledge / architecture).
+        changedFiles = getChangedFiles(cwd, { includeWorktree: true });
         source = 'working-tree';
     }
     const classified = changedFiles.map(classifyFile);

package/dist/contradictions.d.ts

@@ -39,10 +39,17 @@ export interface IContradictionReport {
 }
 export interface IBuildContradictionReportOptions {
     inspection: ISharkcraftInspection;
-    /** Max doc files to scan. Default 80. */
+    /** Max doc files to scan. Default 5000 (effectively the whole docs tree). */
     docScanLimit?: number;
     /** Max bytes per doc. Default 200_000. */
     bytesPerDoc?: number;
+    /**
+     * Authoritative set of CLI command names (top-level verbs) used to flag
+     * `shrk <verb>` references to non-existent commands. Injected by the CLI from
+     * its own command catalogue (inspector must not import cli). When omitted,
+     * missing-command findings are suppressed — the safe failure mode.
+     */
+    cliCommandNames?: ReadonlySet<string>;
 }
 export declare function buildContradictionReport(options: IBuildContradictionReportOptions): IContradictionReport;
 export declare function renderContradictionReportText(report: IContradictionReport): string;

package/dist/contradictions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contradictions.d.ts","sourceRoot":"","sources":["../src/contradictions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,oBAAY,iBAAiB;IAC3B,WAAW,iBAAiB;IAC5B,cAAc,oBAAoB;IAClC,SAAS,eAAe;IACxB,UAAU,iBAAiB;IAC3B,aAAa,mBAAmB;IAChC,mBAAmB,2BAA2B;IAC9C,wBAAwB,8BAA8B;CACvD;AAED,oBAAY,qBAAqB;IAC/B,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,qBAAqB,CAAC;IAClC,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2BD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,gCAAgC,GACxC,oBAAoB,CAqKtB;AA0GD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAgClF;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CA2BtF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAOlF;AAMD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAElF"}
+{"version":3,"file":"contradictions.d.ts","sourceRoot":"","sources":["../src/contradictions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,oBAAY,iBAAiB;IAC3B,WAAW,iBAAiB;IAC5B,cAAc,oBAAoB;IAClC,SAAS,eAAe;IACxB,UAAU,iBAAiB;IAC3B,aAAa,mBAAmB;IAChC,mBAAmB,2BAA2B;IAC9C,wBAAwB,8BAA8B;CACvD;AAED,oBAAY,qBAAqB;IAC/B,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,qBAAqB,CAAC;IAClC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC;AA8BD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,gCAAgC,GACxC,oBAAoB,CA8LtB;AAmFD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAgClF;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CA2BtF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAOlF;AAMD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAElF"}

package/dist/contradictions.js

@@ -17,7 +17,10 @@ export var ContradictionSeverity;
     ContradictionSeverity["Warning"] = "warning";
     ContradictionSeverity["Info"] = "info";
 })(ContradictionSeverity || (ContradictionSeverity = {}));
-const DEFAULT_DOC_SCAN_LIMIT = 80;
+// High ceiling, not a sampling cap: docs are byte-bounded already, so scanning
+// the whole tree is cheap and avoids the silent "scanned an arbitrary 80-file
+// prefix" failure mode.
+const DEFAULT_DOC_SCAN_LIMIT = 5000;
 const DEFAULT_BYTES_PER_DOC = 200_000;
 const DOC_EXTS = new Set(['.md', '.mdx', '.rst', '.txt']);
 const DOC_DIR_NAMES = new Set(['docs', 'documentation', 'doc']);
@@ -50,7 +53,7 @@ export function buildContradictionReport(options) {
     const knownScripts = new Set();
     for (const script of Object.keys(inspection.workspace.scripts ?? {}))
         knownScripts.add(script);
-    const cliCommandNames = collectShrkCommandNames();
+    const cliCommandNames = options.cliCommandNames ?? new Set();
     for (const doc of docs) {
         let body = '';
         try {
@@ -91,20 +94,30 @@ export function buildContradictionReport(options) {
                     continue;
                 if (cleaned.startsWith('http://') || cleaned.startsWith('https://'))
                     continue;
-                const probe = cleaned.startsWith('./') ? cleaned.slice(2) : cleaned;
-                if (seenOnLine.has(probe))
+                // Strip a trailing source-location suffix (`:91`, `:91-125`, `#L91`,
+                // `#L91-L99`) — a `file.ts:91` reference is about file.ts, not a path
+                // literally named "file.ts:91".
+                const bare = (cleaned.startsWith('./') ? cleaned.slice(2) : cleaned).replace(/[:#]L?\d+(?:[-:]L?\d+)?$/i, '');
+                if (!bare)
                     continue;
-                seenOnLine.add(probe);
-                const abs = nodePath.join(projectRoot, probe);
-                if (!existsSync(abs)) {
+                if (seenOnLine.has(bare))
+                    continue;
+                seenOnLine.add(bare);
+                // Resolve against the project root OR — for bare sibling links that
+                // aren't source-tree-prefixed (e.g. a `./a.md` link inside docs/) —
+                // relative to the referencing doc's directory.
+                const resolvesAtRoot = existsSync(nodePath.join(projectRoot, bare));
+                const resolvesDocRelative = !SOURCE_PREFIX_RE.test(bare) &&
+                    existsSync(nodePath.resolve(nodePath.dirname(doc.abs), bare));
+                if (!resolvesAtRoot && !resolvesDocRelative) {
                     findings.push({
-                        id: `missing-path:${doc.rel}:${i + 1}:${probe}`,
+                        id: `missing-path:${doc.rel}:${i + 1}:${bare}`,
                         kind: ContradictionKind.MissingPath,
                         severity: ContradictionSeverity.Warning,
-                        message: `Doc references missing path \`${probe}\`.`,
+                        message: `Doc references missing path \`${bare}\`.`,
                         source: doc.rel,
                         line: i + 1,
-                        reference: probe,
+                        reference: bare,
                         suggestion: 'Update the doc or restore the file.',
                         reason: 'Doc-vs-tree consistency.',
                     });
@@ -153,7 +166,16 @@ export function buildContradictionReport(options) {
                 // npm/bun script references.
                 if ((head === 'bun' || head === 'npm' || head === 'pnpm' || head === 'yarn') && (next === 'run' || next === 'x')) {
                     const script = tokens[2];
-                    if (script && !script.startsWith('-') && next === 'run' && knownScripts.size > 0 && !knownScripts.has(script)) {
+                    // A real `bun run <script>` target is a bare script id, never a path.
+                    // Skip path-shaped candidates (`bun run ../scripts/x.ts`) to avoid the
+                    // false positive of treating a script-path as a missing package script.
+                    const scriptLooksLikePath = !!script && (script.includes('/') || script.startsWith('.') || script.includes('.'));
+                    if (script &&
+                        !script.startsWith('-') &&
+                        !scriptLooksLikePath &&
+                        next === 'run' &&
+                        knownScripts.size > 0 &&
+                        !knownScripts.has(script)) {
                         findings.push({
                             id: `missing-command:${doc.rel}:${i + 1}:${script}`,
                             kind: ContradictionKind.MissingCommand,
@@ -264,6 +286,10 @@ function looksLikePath(s) {
         return false;
     if (s.startsWith('http'))
         return false;
+    if (/^[a-z][\w.+-]*:/i.test(s))
+        return false; // URI scheme (file:, mailto:, …), not a tree path
+    if (/\/:[A-Za-z]/.test(s))
+        return false; // URL route param (`/api/:id/…`)
     if (s.includes(' '))
         return false;
     if (/[<>{}]/.test(s))
@@ -288,30 +314,6 @@ function looksLikePath(s) {
         return false;
     return true;
 }
-function collectShrkCommandNames() {
-    // Hard-coded list of well-known top-level commands. Importing the CLI here
-    // would create a layering violation (inspector → cli) — instead we mirror
-    // the catalogue that `shrk commands` would print. Missing entries simply
-    // suppress contradiction findings for those commands, which is the safe
-    // failure mode.
-    return new Set([
-        'init', 'inspect', 'doctor', 'context', 'gen', 'apply', 'export', 'import',
-        'task', 'next', 'find', 'explain', 'check', 'watch', 'drift', 'graph',
-        'coverage', 'review', 'onboard', 'test', 'plan', 'session', 'dev', 'ask',
-        'mcp', 'version', 'quality', 'ci', 'commands', 'safety', 'infer', 'report',
-        'dashboard', 'bundle', 'impact', 'search', 'brief', 'demo', 'release',
-        'start-here', 'handoff', 'map', 'intent', 'orchestrate', 'simulate', 'view',
-        'recommend', 'risk', 'migration', 'contract', 'languages', 'help',
-        'memory', 'heal', 'agent', 'docs', 'examples', 'self', 'install',
-        'diagnostics', 'intelligence', 'architecture', 'decisions', 'compliance',
-        'policy', 'product', 'reposet', 'packs', 'upgrade', 'api', 'boundaries',
-        'repo', 'owners', 'ownership', 'runtime', 'constructs', 'playbooks',
-        'presets', 'pipelines', 'paths', 'rules', 'templates', 'knowledge',
-        'schemas', 'scaffolds', 'tests',
-        // Additions
-        'ingest', 'understand-task', 'validate-change', 'contradictions', 'generated', 'stability',
-    ]);
-}
 export function renderContradictionReportText(report) {
     const lines = [];
     lines.push('=== Contradictions report ===');

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,CAkBpF;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;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"}

package/dist/git-helpers.js

@@ -41,12 +41,18 @@ export function getChangedFiles(cwd, opts = {}) {
     const set = new Set(parseLines(a.stdout));
     if (opts.includeWorktree && !opts.staged && !opts.since) {
         // Include untracked + working-tree changes via `git status --porcelain`.
-        const s = runGit(cwd, ['status', '--porcelain']);
+        // `-uall` expands untracked directories to individual files (default
+        // `--porcelain` collapses them to a single `dir/` entry, which undercounts);
+        // `.gitignore` is still honored.
+        const s = runGit(cwd, ['status', '--porcelain', '-uall']);
         if (s.ok) {
             for (const line of s.stdout.split('\n')) {
-                const trimmed = line.slice(3).trim();
-                if (trimmed)
-                    set.add(trimmed);
+                // Strip the two-char XY status + leading space, then take the new path
+                // for rename/copy entries (`R  old -> new`).
+                const raw = line.slice(3).trim();
+                const path = raw.includes(' -> ') ? raw.slice(raw.indexOf(' -> ') + 4).trim() : raw;
+                if (path)
+                    set.add(path);
             }
         }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"plan-review.d.ts","sourceRoot":"","sources":["../src/plan-review.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,8FAA8F;IAC9F,IAAI,EACA,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,eAAe,GACf,SAAS,GACT,QAAQ,GACR,MAAM,GACN,UAAU,GACV,SAAS,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,GAAG,eAAe,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,iBAAiB,EAAE,kBAAkB,GAAG,sCAAsC,CAAC;CAChF;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,6CAA6C;IAC7C,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,oDAAoD;IACpD,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,iEAAiE;IACjE,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,8EAA8E;IAC9E,yBAAyB,EAAE,SAAS;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IACJ;;;;OAIG;IACH,8BAA8B,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAC1E,4DAA4D;IAC5D,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,qBAAqB,EACjC,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAsLnB"}
+{"version":3,"file":"plan-review.d.ts","sourceRoot":"","sources":["../src/plan-review.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,8FAA8F;IAC9F,IAAI,EACA,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,cAAc,GACd,eAAe,GACf,SAAS,GACT,QAAQ,GACR,MAAM,GACN,UAAU,GACV,SAAS,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,GAAG,eAAe,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,iBAAiB,EAAE,kBAAkB,GAAG,sCAAsC,CAAC;CAChF;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,6CAA6C;IAC7C,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,oDAAoD;IACpD,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,iEAAiE;IACjE,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,8EAA8E;IAC9E,yBAAyB,EAAE,SAAS;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IACJ;;;;OAIG;IACH,8BAA8B,EAAE,SAAS,8BAA8B,EAAE,CAAC;IAC1E,4DAA4D;IAC5D,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,qBAAqB,EACjC,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAkLnB"}

package/dist/plan-review.js

@@ -1,6 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { evaluateBoundaries, loadTsconfigPaths, scanImports, } from '@shrkcrft/boundaries';
 import { checkFolderOpSafety, FolderOpSafety, planGeneration, verifyPlan, } from '@shrkcrft/generator';
+import { matchAffectedConventions } from '@shrkcrft/paths';
 export function reviewSavedPlan(inspection, planPath) {
     const raw = readFileSync(planPath, 'utf8');
     const plan = JSON.parse(raw);
@@ -64,16 +65,10 @@ export function reviewSavedPlan(inspection, planPath) {
             signatureMessage = 'verified';
         }
     }
-    // Affected paths heuristic.
-    const segments = new Set();
-    for (const f of files) {
-        for (const seg of f.relativePath.split('/'))
-            segments.add(seg.toLowerCase());
-    }
-    const affectedPaths = inspection.pathService
-        .list()
-        .filter((p) => [...segments].some((s) => (p.title + ' ' + p.content).toLowerCase().includes(s)))
-        .map((p) => p.id);
+    // Affected paths: conventions the plan's files structurally fall under
+    // (directory-prefix match against each convention's metadata.path), not a
+    // free-text substring of the description (which matched nearly the whole set).
+    const affectedPaths = matchAffectedConventions(inspection.pathService.list(), files.map((f) => f.relativePath)).map((p) => p.id);
     // Missing-tests heuristic.
     const missingTestsHeuristic = [];
     const allPaths = new Set(files.map((f) => f.relativePath));

package/dist/registry-lifecycle.d.ts

@@ -36,6 +36,12 @@ export interface IRegistryLifecycleReport {
     registersFound: number;
     matchedPairs: ReadonlyArray<IRegistryPair>;
     missingRemovers: ReadonlyArray<IRegistryMissingRemover>;
+    /**
+     * `register*` declarations in a file with NO teardown-shaped API — treated as
+     * one-shot / bootstrap registrations that legitimately need no remover. Kept
+     * out of `missingRemovers` so the check isn't a wall of false positives.
+     */
+    oneShotBootstrap: ReadonlyArray<IRegistryIgnored>;
     ignored: ReadonlyArray<IRegistryIgnored>;
     recommendations: ReadonlyArray<string>;
 }

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,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC3C,eAAe,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACxD,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IACzC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAyHD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,wBAAwB,CAoE3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CA6B1F"}
+{"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,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;AAuLD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,wBAAwB,CAsF3B;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CA8B1F"}

package/dist/registry-lifecycle.js

@@ -59,11 +59,111 @@ function walk(dir, projectRoot, out) {
 const REGISTER_PATTERNS = Object.freeze([
     // export function registerX(
     /(?:export\s+)?(?:async\s+)?function\s+(register[A-Z]\w*)\s*\(/g,
-    // public/private registerX(
-    /(?:public|private|protected)?\s*(?:async\s+)?(register[A-Z]\w*)\s*\(/g,
-    // someRegistry.registerX = (...) =>
-    /\b(register[A-Z]\w*)\s*=\s*\(/g,
+    // class method DECLARATION: requires a body `{` or return-type `:` after the
+    // params, which a bare call site (`registry.registerX(...)`) never has.
+    /(?:^|\n)[\t ]*(?:public|private|protected)?\s*(?:static\s+)?(?:async\s+)?(register[A-Z]\w*)\s*\([^;]*?\)\s*[:{]/g,
+    // assigned arrow / function expression: `registerX = (…) =>` / `registerX = function`
+    /\b(register[A-Z]\w*)\s*=\s*(?:async\s+)?(?:function\b|\([^)]*\)\s*(?::[^=]*)?=>)/g,
 ]);
+// Accumulation of removable per-entry state — a registry that ADDS entries one
+// at a time plausibly needs a way to remove them.
+const ACCUMULATION_RE = /\.(?:set|add|push)\s*\(|\[[^\]]+\]\s*=[^=]/;
+// A teardown-shaped API somewhere in the file — evidence the file is in the
+// business of removing things, so a missing per-register remover is suspicious.
+const TEARDOWN_RE = /\b(?:remove|unregister|clear|dispose|unsubscribe)\w*\s*\(|\boff\s*\(/i;
+/**
+ * Blank out comments and string / template-literal bodies (preserving newlines
+ * so line numbers stay accurate) before scanning for `register*` declarations.
+ * Deterministic char-scan — no TS parser, consistent with this module's no-AST
+ * posture. Stops `register*` mentions inside comments / strings / docs from
+ * being counted as code.
+ */
+function stripCommentsAndLiterals(content) {
+    const out = [];
+    const n = content.length;
+    let state = 'code';
+    const blank = (ch) => (ch === '\n' ? '\n' : ' ');
+    let i = 0;
+    while (i < n) {
+        const ch = content[i];
+        const next = content[i + 1];
+        if (state === 'code') {
+            if (ch === '/' && next === '/') {
+                state = 'line';
+                out.push('  ');
+                i += 2;
+                continue;
+            }
+            if (ch === '/' && next === '*') {
+                state = 'block';
+                out.push('  ');
+                i += 2;
+                continue;
+            }
+            if (ch === "'") {
+                state = 'sq';
+                out.push(' ');
+                i += 1;
+                continue;
+            }
+            if (ch === '"') {
+                state = 'dq';
+                out.push(' ');
+                i += 1;
+                continue;
+            }
+            if (ch === '`') {
+                state = 'tpl';
+                out.push(' ');
+                i += 1;
+                continue;
+            }
+            out.push(ch);
+            i += 1;
+            continue;
+        }
+        if (state === 'line') {
+            if (ch === '\n') {
+                state = 'code';
+                out.push('\n');
+                i += 1;
+                continue;
+            }
+            out.push(blank(ch));
+            i += 1;
+            continue;
+        }
+        if (state === 'block') {
+            if (ch === '*' && next === '/') {
+                state = 'code';
+                out.push('  ');
+                i += 2;
+                continue;
+            }
+            out.push(blank(ch));
+            i += 1;
+            continue;
+        }
+        // string / template literal body
+        const quote = state === 'sq' ? "'" : state === 'dq' ? '"' : '`';
+        if (ch === '\\') {
+            out.push(' ');
+            out.push(next === undefined ? '' : blank(next));
+            i += 2;
+            continue;
+        }
+        if (ch === quote) {
+            state = 'code';
+            out.push(' ');
+            i += 1;
+            continue;
+        }
+        out.push(blank(ch));
+        i += 1;
+        continue;
+    }
+    return out.join('');
+}
 function findRegistersInFile(content) {
     const out = [];
     const seen = new Set();
@@ -95,10 +195,17 @@ function findIgnoreAnnotations(content, registerName) {
     return { ignore: false };
 }
 function expectedRemoverNames(registerName) {
-    // registerX → removeX / unregisterX / clearX
-    // registerXByScope → removeXByScope / unregisterXByScope / clearXByScope
+    // registerX → removeX / unregisterX / clearX / disposeX / unsubscribeX / Xoff
+    // registerXByScope → removeXByScope / … (stem carries the scope suffix)
     const stem = registerName.slice('register'.length);
-    return [`remove${stem}`, `unregister${stem}`, `clear${stem}`];
+    return [
+        `remove${stem}`,
+        `unregister${stem}`,
+        `clear${stem}`,
+        `dispose${stem}`,
+        `unsubscribe${stem}`,
+        `${stem}Off`,
+    ];
 }
 function findRemoverInContent(content, candidates) {
     for (const name of candidates) {
@@ -119,6 +226,7 @@ export function buildRegistryLifecycleReport(input) {
     const scanFiles = files.slice(0, limit);
     const matchedPairs = [];
     const missingRemovers = [];
+    const oneShotBootstrap = [];
     const ignored = [];
     let registersFound = 0;
     for (const file of scanFiles) {
@@ -131,7 +239,15 @@ export function buildRegistryLifecycleReport(input) {
         }
         if (isGeneratedFile(file, content))
             continue;
-        const registers = findRegistersInFile(content);
+        // 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);
+        // 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);
+        const hasTeardown = TEARDOWN_RE.test(code);
+        const ownsLifecycle = hasAccumulation && hasTeardown;
         for (const reg of registers) {
             registersFound += 1;
             const ann = findIgnoreAnnotations(content, reg.name);
@@ -146,7 +262,7 @@ export function buildRegistryLifecycleReport(input) {
                 continue;
             }
             const candidates = expectedRemoverNames(reg.name);
-            const remover = findRemoverInContent(content, candidates);
+            const remover = findRemoverInContent(code, candidates);
             if (remover) {
                 matchedPairs.push({
                     registerName: reg.name,
@@ -156,7 +272,7 @@ export function buildRegistryLifecycleReport(input) {
                     removerLine: remover.line,
                 });
             }
-            else {
+            else if (ownsLifecycle) {
                 missingRemovers.push({
                     registerName: reg.name,
                     expectedRemoverNames: candidates,
@@ -165,6 +281,15 @@ export function buildRegistryLifecycleReport(input) {
                     suggestion: `Add ${candidates[0]}() / ${candidates[1]}() / ${candidates[2]}() — or annotate with \`@shrkcrft lifecycle-ignore <reason>\` / \`@shrkcrft lifecycle-managed-by <name>\` if cleanup is owned elsewhere.`,
                 });
             }
+            else {
+                // No teardown-shaped API in the file → one-shot / bootstrap registration.
+                oneShotBootstrap.push({
+                    registerName: reg.name,
+                    file: relative(projectRoot, file),
+                    line: reg.line,
+                    reason: 'no teardown-shaped API in file — treated as one-shot bootstrap',
+                });
+            }
         }
     }
     const recommendations = [];
@@ -177,6 +302,7 @@ export function buildRegistryLifecycleReport(input) {
         registersFound,
         matchedPairs,
         missingRemovers,
+        oneShotBootstrap,
         ignored,
         recommendations,
     };
@@ -188,6 +314,7 @@ export function renderRegistryLifecycleReportText(report) {
     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}`);
     lines.push('');
     if (report.missingRemovers.length > 0) {

package/dist/review-packet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-packet.d.ts","sourceRoot":"","sources":["../src/review-packet.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,kEAAkE;IAClE,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8CAA8C;IAC9C,aAAa,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxE,2CAA2C;IAC3C,iBAAiB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3D,iBAAiB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,2DAA2D;IAC3D,kBAAkB,EAAE,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IACJ,+DAA+D;IAC/D,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,4DAA4D;IAC5D,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,mEAAmE;IACnE,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAyCD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,yBAA8B,GACtC,aAAa,CAqFf"}
+{"version":3,"file":"review-packet.d.ts","sourceRoot":"","sources":["../src/review-packet.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,kEAAkE;IAClE,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8CAA8C;IAC9C,aAAa,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxE,2CAA2C;IAC3C,iBAAiB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3D,iBAAiB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,2DAA2D;IAC3D,kBAAkB,EAAE,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IACJ,+DAA+D;IAC/D,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,4DAA4D;IAC5D,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,mEAAmE;IACnE,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAyCD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,yBAA8B,GACtC,aAAa,CA+Ef"}

package/dist/review-packet.js

@@ -1,5 +1,7 @@
 import { spawnSync } from 'node:child_process';
 import { evaluateBoundaries, loadTsconfigPaths, scanImports } from '@shrkcrft/boundaries';
+import { matchAffectedConventions } from '@shrkcrft/paths';
+import { resolveVerificationCommands } from "./resolve-verification-commands.js";
 import { rankAll } from "./task-ranker.js";
 function gitDiffFiles(cwd, opts) {
     if (opts.files && opts.files.length > 0)
@@ -50,17 +52,10 @@ export function buildReviewPacket(inspection, options = {}) {
     const changedFiles = gitDiffFiles(inspection.projectRoot, options);
     const pseudoTask = buildPseudoTask(changedFiles);
     const ranking = rankAll(inspection, pseudoTask, 8);
-    // Affected paths: any path-convention whose title or content mentions any
-    // path segment from the changed files.
-    const segments = new Set();
-    for (const f of changedFiles) {
-        for (const seg of f.split('/'))
-            segments.add(seg.toLowerCase());
-    }
-    const affectedPaths = inspection.pathService
-        .list()
-        .filter((p) => [...segments].some((s) => (p.title + ' ' + p.content).toLowerCase().includes(s)))
-        .map((p) => p.id);
+    // Affected paths: conventions the changed files structurally fall under
+    // (directory-prefix match against each convention's metadata.path), not a
+    // free-text substring of the description.
+    const affectedPaths = matchAffectedConventions(inspection.pathService.list(), changedFiles).map((p) => p.id);
     // Boundary violations restricted to changed files.
     let boundaryViolations = [];
     if (inspection.boundaryRegistry.size() > 0 && changedFiles.length > 0) {
@@ -81,12 +76,14 @@ export function buildReviewPacket(inspection, options = {}) {
             message: v.message,
         }));
     }
-    const verificationCommands = unique([
-        'shrk doctor',
-        'shrk check boundaries',
-        'bun x tsc -p tsconfig.base.json --noEmit',
-        'bun test',
-    ]);
+    // Verification: prefer the project's configured verificationCommands (resolved
+    // from config + matched pipelines); fall back to the generic tsc/test pair only
+    // when nothing is configured. SharkCraft's own meta-checks stay as a prefix.
+    const resolvedGates = resolveVerificationCommands(inspection, {
+        pipelineIds: ranking.pipelines.slice(0, 3).map((p) => p.item.id),
+        knowledgeDefaults: ['bun x tsc -p tsconfig.base.json --noEmit', 'bun test'],
+    });
+    const verificationCommands = unique(['shrk doctor', 'shrk check boundaries', ...resolvedGates]);
     const reviewerInstructions = [
         `# AI reviewer instructions`,
         ``,

package/dist/why-file.js

@@ -23,7 +23,7 @@ export function buildWhyReport(input) {
     const inferredPackage = inferPackage(target.relativePath);
     const inferredLayer = inferLayer(target.relativePath);
     const pathConventions = matchPathConventions(input.inspection, target);
-    const rules = matchRules(input.inspection, target, limit);
+    const rules = matchRules(input.inspection, target, limit, inferredPackage, inferredLayer);
     const boundaries = matchBoundaries(input.inspection, target);
     const knowledge = matchKnowledge(input.inspection, target, limit);
     const suggestedNext = buildSuggestions(target, rules, knowledge);
@@ -78,14 +78,20 @@ function inferLayer(relPath) {
         return segments[1];
     return undefined;
 }
+/** Does `targetRel` equal, or live under, the canonical directory/file path? */
+function pathCovers(targetRel, canonical) {
+    const normalized = canonical.replace(/^\.\//, '').replace(/\/+$/, '');
+    if (!normalized)
+        return false;
+    return targetRel === normalized || targetRel.startsWith(`${normalized}/`);
+}
 function matchPathConventions(inspection, target) {
     const out = [];
     for (const p of inspection.pathService.list()) {
         const canonical = p.metadata?.path ?? '';
         if (!canonical)
             continue;
-        const normalized = canonical.replace(/^\.\//, '');
-        if (target.relativePath === normalized || target.relativePath.startsWith(normalized.endsWith('/') ? normalized : `${normalized}/`)) {
+        if (pathCovers(target.relativePath, canonical)) {
             out.push({
                 id: p.id,
                 title: p.title,
@@ -96,30 +102,74 @@ function matchPathConventions(inspection, target) {
     }
     return out;
 }
-function matchRules(inspection, target, limit) {
-    const tokens = pathTokens(target.relativePath);
+/**
+ * Precise PATH evidence that a rule applies to a file — not topical token
+ * overlap (scope/tags/appliesWhen are free-form labels, so the old
+ * intersection attached nearly every rule to every file). Priority order:
+ * explicit file/dir references → path-glob scope/tag → package reference →
+ * scope/tag equal to the inferred package or layer.
+ */
+function ruleReasonForFile(r, target, inferredPackage, inferredLayer) {
+    const rel = target.relativePath;
+    // 1. Explicit file/directory references that cover the target.
+    for (const ref of r.references ?? []) {
+        const p = (ref.path ?? '').replace(/^\.\//, '');
+        if ((ref.kind === 'file' || ref.kind === 'directory') && p && pathCovers(rel, p)) {
+            return ref.kind === 'directory' ? `directory reference ${p}` : `file reference ${p}`;
+        }
+    }
+    // 1b. Anchors that point at a covering path.
+    for (const a of r.anchors ?? []) {
+        const p = (a.path ?? '').replace(/^\.\//, '');
+        if (p && pathCovers(rel, p))
+            return `anchor path ${p}`;
+    }
+    // 2. Scope/tag values that are themselves path globs matching the target.
+    const pathish = [...(r.scope ?? []), ...(r.tags ?? [])].filter((s) => /[/*?[]/.test(s));
+    if (pathish.length > 0) {
+        const hit = pathish.find((g) => matchesAny(rel, [g]));
+        if (hit)
+            return `path pattern ${hit}`;
+    }
+    // 3. Package reference / scope-or-tag equal to the inferred package or layer.
+    const labels = [...(r.scope ?? []), ...(r.tags ?? [])];
+    if (inferredPackage) {
+        for (const ref of r.references ?? []) {
+            if (ref.kind === 'package' && ref.id && samePath(ref.id, inferredPackage)) {
+                return `package reference ${ref.id}`;
+            }
+        }
+        if (labels.some((l) => samePath(l, inferredPackage)))
+            return `scoped to package ${inferredPackage}`;
+    }
+    if (inferredLayer && labels.some((l) => l.toLowerCase() === inferredLayer.toLowerCase())) {
+        return `scoped to layer ${inferredLayer}`;
+    }
+    return undefined;
+}
+function samePath(a, b) {
+    const n = (s) => s.replace(/^\.?\/+/, '').replace(/\/+$/, '').toLowerCase();
+    return n(a) === n(b);
+}
+function matchRules(inspection, target, limit, inferredPackage, inferredLayer) {
     const out = [];
     for (const rule of inspection.ruleService.list()) {
         const r = rule;
-        const scope = r.scope ?? [];
-        const tags = r.tags ?? [];
-        const appliesWhen = r.appliesWhen ?? [];
-        const allTokens = new Set([...scope, ...tags, ...appliesWhen].map((t) => t.toLowerCase()));
-        const hits = tokens.filter((t) => allTokens.has(t.toLowerCase()));
-        if (hits.length === 0)
+        const reason = ruleReasonForFile(r, target, inferredPackage, inferredLayer);
+        if (!reason)
             continue;
         out.push({
             id: r.id,
             title: r.title,
             priority: r.priority ?? 'medium',
-            scope,
-            tags,
-            appliesWhen,
-            reason: `Matches on: ${hits.join(', ')}`,
+            scope: r.scope ?? [],
+            tags: r.tags ?? [],
+            appliesWhen: r.appliesWhen ?? [],
+            reason,
             ...sourceField(inspection, r.id),
         });
     }
-    // Sort by priority weight desc, then by hit count desc.
+    // Sort by priority weight desc (stable for equal weights).
     const weight = { critical: 4, high: 3, medium: 2, low: 1 };
     out.sort((a, b) => (weight[b.priority] ?? 2) - (weight[a.priority] ?? 2));
     return out.slice(0, limit);
@@ -183,12 +233,6 @@ function buildSuggestions(target, rules, knowledge) {
     out.push(`shrk impact "${target.relativePath}"`);
     return out;
 }
-function pathTokens(relPath) {
-    return relPath
-        .replace(/\.[^./]+$/, '') // drop extension
-        .split(/[/\\.\-_]/)
-        .filter((t) => t.length > 0);
-}
 function sourceField(inspection, id) {
     let map;
     if (inspection && 'entrySources' in inspection) {

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@shrkcrft/inspector",
-  "version": "0.1.0-alpha.19",
+  "version": "0.1.0-alpha.20",
   "description": "SharkCraft inspector: project overview, doctor checks, AI-agent instructions.",
   "license": "MIT",
   "author": "SharkCraft contributors",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -42,22 +42,22 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.19",
-    "@shrkcrft/config": "^0.1.0-alpha.19",
-    "@shrkcrft/workspace": "^0.1.0-alpha.19",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.19",
-    "@shrkcrft/rules": "^0.1.0-alpha.19",
-    "@shrkcrft/paths": "^0.1.0-alpha.19",
-    "@shrkcrft/templates": "^0.1.0-alpha.19",
-    "@shrkcrft/context": "^0.1.0-alpha.19",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.19",
-    "@shrkcrft/packs": "^0.1.0-alpha.19",
-    "@shrkcrft/presets": "^0.1.0-alpha.19",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.19",
-    "@shrkcrft/generator": "^0.1.0-alpha.19",
-    "@shrkcrft/importer": "^0.1.0-alpha.19",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.19",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.19",
+    "@shrkcrft/core": "^0.1.0-alpha.20",
+    "@shrkcrft/config": "^0.1.0-alpha.20",
+    "@shrkcrft/workspace": "^0.1.0-alpha.20",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.20",
+    "@shrkcrft/rules": "^0.1.0-alpha.20",
+    "@shrkcrft/paths": "^0.1.0-alpha.20",
+    "@shrkcrft/templates": "^0.1.0-alpha.20",
+    "@shrkcrft/context": "^0.1.0-alpha.20",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.20",
+    "@shrkcrft/packs": "^0.1.0-alpha.20",
+    "@shrkcrft/presets": "^0.1.0-alpha.20",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.20",
+    "@shrkcrft/generator": "^0.1.0-alpha.20",
+    "@shrkcrft/importer": "^0.1.0-alpha.20",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.20",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.20",
     "typescript": "^5.6.0"
   },
   "publishConfig": {