@shrkcrft/inspector 0.1.0-alpha.29 → 0.1.0-alpha.30

package/dist/code-intelligence-doctor.d.ts

@@ -10,6 +10,40 @@ export interface ICodeIntelligenceDoctorOptions {
      * to flip a fresh fixture into "stale" without changing mtime.
      */
     staleThresholdDays?: number;
+    /**
+     * How far the graph index has diverged from the working tree.
+     *
+     * THE freshness verdict. Age is a display detail: an index built five days
+     * ago with nothing changed since is current, and one built a minute ago with
+     * a file changed since is not. Judging by age alone produced the exact
+     * contradiction this input exists to end — `graph status` reporting `stale`
+     * while this digest reported `fresh (1m ago)` on the same index in the same
+     * second, and every arch/cycle count derived from it inheriting the staleness
+     * unmarked.
+     *
+     * Injected because `detectGraphFreshness` lives in `@shrkcrft/graph`, which
+     * sits ABOVE inspector in the layer order. Callers that can see the graph
+     * (cli, mcp-server) pass it; when it is absent the checks report
+     * "not verified" rather than guessing from a timestamp.
+     */
+    graphDivergence?: IGraphDivergence;
+}
+/**
+ * The working-tree divergence of a stored index.
+ *
+ * Structurally identical to `@shrkcrft/graph`'s `IGraphFreshness` so a caller
+ * can pass that value straight through — declared here because this layer
+ * cannot import that package.
+ */
+export interface IGraphDivergence {
+    /** False when no index has been built at all. */
+    readonly hasIndex: boolean;
+    /** Indexed files whose content changed since. */
+    readonly modified: readonly string[];
+    /** Files on disk the index has never seen. */
+    readonly added: readonly string[];
+    /** Indexed files that no longer exist. */
+    readonly deleted: readonly string[];
 }
 /**
  * Read every code-intelligence package's persisted state and produce a

package/dist/code-intelligence-doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-intelligence-doctor.d.ts","sourceRoot":"","sources":["../src/code-intelligence-doctor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoKvE,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,8BAAmC,GAC3C,YAAY,EAAE,CAkBhB"}
+{"version":3,"file":"code-intelligence-doctor.d.ts","sourceRoot":"","sources":["../src/code-intelligence-doctor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoKvE,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAiBD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,8BAAmC,GAC3C,YAAY,EAAE,CAkBhB"}

package/dist/code-intelligence-doctor.js

@@ -43,6 +43,23 @@ function sumValues(rec) {
     }
     return total;
 }
+/** Files the index is behind by, or `undefined` when divergence was not measured. */
+function behindCount(d) {
+    if (!d || !d.hasIndex)
+        return undefined;
+    return d.modified.length + d.added.length + d.deleted.length;
+}
+/** A human summary of what diverged, for the stale message. */
+function divergenceSummary(d) {
+    const parts = [];
+    if (d.modified.length > 0)
+        parts.push(`${d.modified.length} modified`);
+    if (d.added.length > 0)
+        parts.push(`${d.added.length} new`);
+    if (d.deleted.length > 0)
+        parts.push(`${d.deleted.length} deleted`);
+    return parts.join(', ');
+}
 /**
  * Read every code-intelligence package's persisted state and produce a
  * compact set of doctor findings. The function is sync (matches the
@@ -53,12 +70,12 @@ export function buildCodeIntelligenceChecks(projectRoot, options = {}) {
     const nowMs = options.nowMs ?? Date.now();
     const staleDays = options.staleThresholdDays ?? STALE_THRESHOLD_DAYS;
     const checks = [];
-    checks.push(...graphChecks(projectRoot, nowMs, staleDays));
+    checks.push(...graphChecks(projectRoot, nowMs, options.graphDivergence));
     checks.push(...ruleGraphChecks(projectRoot, nowMs, staleDays));
     checks.push(...apiSurfaceChecks(projectRoot, nowMs, staleDays));
     checks.push(...qualityGateChecks(projectRoot, nowMs, staleDays));
     checks.push(...migrationChecks(projectRoot));
-    checks.push(...architectureChecks(projectRoot, nowMs, staleDays));
+    checks.push(...architectureChecks(projectRoot, nowMs, staleDays, options.graphDivergence));
     checks.push(...impactRunChecks(projectRoot, nowMs, staleDays));
     checks.push(...frameworkChecks(projectRoot, nowMs, staleDays));
     checks.push(...structuralRegistryChecks(projectRoot));
@@ -87,7 +104,7 @@ const EXPECTED_SCHEMAS = [
     { rel: 'structural/patterns.json', expected: 'sharkcraft.structural-pattern-registry/v1', package: '@shrkcrft/structural-search' },
     { rel: 'context-planner/intent-benchmark.json', expected: 'sharkcraft.intent-benchmark/v1', package: '@shrkcrft/context-planner' },
 ];
-function graphChecks(projectRoot, nowMs, staleDays) {
+function graphChecks(projectRoot, nowMs, divergence) {
     const metaPath = nodePath.join(projectRoot, '.sharkcraft', 'graph', 'meta.json');
     if (!existsSync(metaPath)) {
         return [
@@ -116,8 +133,11 @@ function graphChecks(projectRoot, nowMs, staleDays) {
         ];
     }
     const days = ageDays(manifest.lastIndexedAt, nowMs);
-    const stale = days !== undefined && days > staleDays;
-    const ageStr = days !== undefined ? ` (${fmtAge(days)})` : '';
+    // Divergence is the verdict; age is a display detail. `behind === undefined`
+    // means nobody measured it — which is NOT a pass, so the check says so
+    // instead of falling back to the timestamp that caused the contradiction.
+    const behind = behindCount(divergence);
+    const ageStr = days !== undefined ? ` (indexed ${fmtAge(days)})` : '';
     const counts = `${manifest.filesIndexed ?? 0} files, ${sumValues(manifest.nodesByKind)} nodes, ${sumValues(manifest.edgesByKind)} edges`;
     const cycleTag = typeof manifest.cycleCount === 'number' && manifest.cycleCount > 0
         ? `, ${manifest.cycleCount} cycle${manifest.cycleCount === 1 ? '' : 's'}` +
@@ -126,14 +146,30 @@ function graphChecks(projectRoot, nowMs, staleDays) {
                 : '')
         : '';
     const out = [];
-    if (stale) {
+    if (behind === undefined) {
+        // Nothing measured the divergence, so "current" would be a guess. The
+        // loud-skip contract the six rule planes honour says an unverified result
+        // is neither a pass nor a failure — it is "nothing was verified".
+        out.push({
+            id: 'code-intelligence-graph',
+            title: 'Code-intelligence graph index',
+            severity: DoctorSeverity.Info,
+            advisory: true,
+            category: CATEGORY,
+            message: `Graph index freshness NOT VERIFIED${ageStr} — ${counts}${cycleTag}.`,
+            fix: 'Run `shrk graph status` for the divergence-checked verdict.',
+            whyThisMatters: 'Age is not freshness: an index built days ago with nothing changed since is current, and one built a minute ago with a file changed since is not. Reporting the timestamp as a verdict is how a stale index gets read as authoritative.',
+        });
+    }
+    else if (behind > 0) {
         out.push({
             id: 'code-intelligence-graph',
             title: 'Code-intelligence graph index',
             severity: DoctorSeverity.Warning,
             advisory: true,
             category: CATEGORY,
-            message: `Graph index is stale${ageStr} — ${counts}${cycleTag}.`,
+            message: `Graph index STALE — ${behind} file(s) changed since index ` +
+                `(${divergenceSummary(divergence)})${ageStr}; ${counts}${cycleTag}.`,
             fix: 'Re-index with `shrk graph index --changed` (or `--full`).',
             whyThisMatters: 'Stale code graph makes `shrk impact`, `shrk graph callers`, and context packs return outdated answers.',
         });
@@ -144,7 +180,7 @@ function graphChecks(projectRoot, nowMs, staleDays) {
             title: 'Code-intelligence graph index',
             severity: DoctorSeverity.Ok,
             category: CATEGORY,
-            message: `Graph index fresh${ageStr} — ${counts}${cycleTag}.`,
+            message: `Graph index current${ageStr} — ${counts}${cycleTag}.`,
         });
     }
     // Cycles ≥ a heuristic threshold of 5 (or any 3+-file cycle) become
@@ -400,7 +436,7 @@ function qualityGateChecks(projectRoot, nowMs, staleDays) {
         },
     ];
 }
-function architectureChecks(projectRoot, nowMs, staleDays) {
+function architectureChecks(projectRoot, nowMs, staleDays, divergence) {
     const archDir = nodePath.join(projectRoot, '.sharkcraft', 'architecture');
     const baselinePath = nodePath.join(archDir, 'baseline.json');
     const lastPath = nodePath.join(archDir, 'last.json');
@@ -477,6 +513,29 @@ function architectureChecks(projectRoot, nowMs, staleDays) {
         (baseline.countsBySeverity?.['error'] ?? 0);
     const warnDelta = (last.countsBySeverity?.['warning'] ?? 0) -
         (baseline.countsBySeverity?.['warning'] ?? 0);
+    // A delta computed from an index the working tree has moved past is neither
+    // a green nor a red — it is "nothing was verified". This is the loud-skip
+    // contract the six data-defined rule planes already honour, extended to the
+    // graph-derived findings. It failed in both directions before: a digest
+    // under-reported real architecture debt 5-of-6 while displaying "fresh", and
+    // the same stale snapshot can just as easily report a violation that has
+    // already been fixed.
+    const behind = behindCount(divergence);
+    if (behind !== undefined && behind > 0) {
+        return [
+            {
+                id: 'code-intelligence-architecture',
+                title: 'Architecture baseline',
+                severity: DoctorSeverity.Info,
+                advisory: true,
+                category: CATEGORY,
+                message: `Architecture delta NOT VERIFIED — the graph index is ${behind} file(s) behind ` +
+                    `(${divergenceSummary(divergence)}), so any count derived from it is out of date.`,
+                fix: 'Re-index with `shrk graph index --changed`, then `shrk arch check`.',
+                whyThisMatters: 'A count from a stale index misses violations in files it never saw AND reports ones already fixed. Presenting it as a number invites acting on both.',
+            },
+        ];
+    }
     if (newCount === 0 && errDelta <= 0 && warnDelta <= 0) {
         return [
             {

package/dist/doc-references.d.ts

@@ -0,0 +1,59 @@
+import type { IDocReferenceRule } from '@shrkcrft/core';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+/**
+ * The prose-reference linter.
+ *
+ * Scans configured docs for id-shaped tokens and asserts each resolves to a
+ * real registered id. The failure it exists to catch is silent: a table of
+ * template ids in a README or an agent skill file drifts from the registry and
+ * nothing — no build, no type-check, no existing gate — notices until someone
+ * runs the command and it fails.
+ *
+ * Everything here is deterministic text work plus a registry lookup. No model,
+ * no network, no guessing what a doc "meant".
+ */
+/** One token the rule considered. */
+export interface IDocReferenceToken {
+    readonly token: string;
+    /** Project-relative path of the document. */
+    readonly file: string;
+    /** 1-based line. */
+    readonly line: number;
+    /** The registry that accepted it, when it resolved. */
+    readonly resolvedAs?: string;
+    /** Why it was not treated as a reference, when it was skipped. */
+    readonly skipped?: 'context' | 'exempt' | 'exempt-marker';
+}
+/** An id-shaped token that resolved to nothing. */
+export interface IDocReferenceFinding {
+    readonly ruleId: string;
+    readonly token: string;
+    readonly file: string;
+    readonly line: number;
+    readonly severity: 'error' | 'warning';
+    readonly message: string;
+    /** Closest registered ids, nearest first. Empty when nothing is close. */
+    readonly didYouMean: readonly string[];
+    readonly hint?: string;
+}
+/** One rule's outcome. */
+export interface IDocReferenceResult {
+    readonly ruleId: string;
+    readonly description?: string;
+    readonly severity: 'error' | 'warning';
+    readonly status: 'passed' | 'failed' | 'skipped' | 'error';
+    /** Documents the globs matched. */
+    readonly filesScanned: number;
+    /** Tokens that counted as references (context-gated, non-exempt). */
+    readonly tokensChecked: number;
+    /** Tokens matched but deliberately not treated as references. */
+    readonly tokensSkipped: number;
+    readonly findings: readonly IDocReferenceFinding[];
+    /** Every token considered — the `explain` view. */
+    readonly tokens: readonly IDocReferenceToken[];
+    readonly skipReason?: string;
+    readonly error?: string;
+}
+/** Evaluate one doc-reference rule against the tree. */
+export declare function checkDocReferences(projectRoot: string, rule: IDocReferenceRule, inspection: ISharkcraftInspection, excludeDirs?: readonly string[]): IDocReferenceResult;
+//# sourceMappingURL=doc-references.d.ts.map

package/dist/doc-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-references.d.ts","sourceRoot":"","sources":["../src/doc-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAUxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;;;;;;;GAWG;AAEH,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,eAAe,CAAC;CAC3D;AAED,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAC3D,mCAAmC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iEAAiE;IACjE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACnD,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAmDD,wDAAwD;AACxD,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,qBAAqB,EACjC,WAAW,GAAE,SAAS,MAAM,EAAO,GAClC,mBAAmB,CA6JrB"}

package/dist/doc-references.js

@@ -0,0 +1,190 @@
+import { dotDirsNamedBy, matchesAny, readMatchingFiles, safeCompile } from '@shrkcrft/boundaries';
+import { nearestIds } from "./nearest-id.js";
+import { emptyReferenceKinds, isCacheBackedKind, referenceIdExists, referenceIdPool, } from "./reference-registry.js";
+/** Matches `<!-- marker -->`, with or without a trailing `: reason`. */
+function markerRe(marker) {
+    const escaped = marker.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`<!--\\s*${escaped}\\s*(?::[^>]*)?-->`);
+}
+/** Character ranges of a line that sit inside a `code span`. */
+function backtickRanges(line) {
+    const ranges = [];
+    const re = /(`+)([^`]*?)\1/g;
+    let m;
+    while ((m = re.exec(line)) !== null) {
+        ranges.push({ start: m.index, end: m.index + m[0].length });
+    }
+    return ranges;
+}
+/**
+ * Whether a match at `index` counts as a reference under the rule's context
+ * gate.
+ *
+ * `insideFence` is passed separately because a fenced block spans lines: its
+ * contents are code regardless of backticks on the line itself.
+ */
+function passesContext(rule, line, index, insideFence) {
+    const mode = rule.requireContext ?? 'backtick';
+    if (mode === 'off')
+        return true;
+    if (mode === 'after') {
+        // "Follows a cue word" has to mean IMMEDIATELY follows. A plain
+        // `includes` would qualify every later token on the line too, because the
+        // cue still appears somewhere before it — so `shrk gen nge.a — and nge.b`
+        // would lint `nge.b` as well. Only whitespace may separate the two.
+        const before = line.slice(0, index).toLowerCase();
+        return (rule.afterWords ?? []).some((w) => {
+            const cue = w.toLowerCase();
+            const at = before.lastIndexOf(cue);
+            if (at === -1)
+                return false;
+            return before.slice(at + cue.length).trim() === '';
+        });
+    }
+    if (insideFence)
+        return true;
+    return backtickRanges(line).some((r) => index >= r.start && index < r.end);
+}
+/** Evaluate one doc-reference rule against the tree. */
+export function checkDocReferences(projectRoot, rule, inspection, excludeDirs = []) {
+    const severity = rule.severity ?? 'error';
+    const base = {
+        ruleId: rule.id,
+        ...(rule.description ? { description: rule.description } : {}),
+        severity,
+    };
+    const compiled = safeCompile(rule.tokenPattern, `${rule.tokenPatternFlags ?? ''}g`);
+    if (compiled.error || !compiled.re) {
+        return {
+            ...base,
+            status: 'error',
+            filesScanned: 0,
+            tokensChecked: 0,
+            tokensSkipped: 0,
+            findings: [],
+            tokens: [],
+            error: `tokenPattern ${compiled.error}`,
+        };
+    }
+    const kinds = rule.resolvesAs;
+    // Resolving against an EMPTY registry cannot succeed, so every id checked
+    // against it is reported unresolved — a gate confidently flagging CORRECT
+    // usage. That is worse than no gate at all (it is the fastest way to get one
+    // switched off), so refuse loudly instead of emitting a page of false
+    // findings.
+    const empty = emptyReferenceKinds(inspection, kinds);
+    if (empty.length === kinds.length && kinds.length > 0) {
+        const warmable = empty.filter(isCacheBackedKind);
+        return {
+            ...base,
+            status: 'error',
+            filesScanned: 0,
+            tokensChecked: 0,
+            tokensSkipped: 0,
+            findings: [],
+            tokens: [],
+            error: `no ids are registered for ${empty.join(' / ')} — nothing could resolve, ` +
+                `so every reference would be reported wrong` +
+                (warmable.length > 0
+                    ? ` (call warmReferenceRegistries() before checking, or this repo has no ${warmable.join(' / ')})`
+                    : ''),
+        };
+    }
+    // Prose lives in places the code walkers deliberately avoid — an agent skill
+    // file sits in `.claude/skills`. The rule's own globs say which dot-dirs it
+    // means, and it gets exactly those.
+    const cache = readMatchingFiles(projectRoot, rule.files, new Set(excludeDirs), dotDirsNamedBy(rule.files));
+    const docs = [...cache.entries()]
+        .filter(([path]) => matchesAny(path, rule.files))
+        .sort(([a], [b]) => a.localeCompare(b));
+    const pool = referenceIdPool(inspection, kinds);
+    const exempt = new Set(rule.exempt ?? []);
+    const marker = rule.exemptMarker;
+    const tokens = [];
+    const findings = [];
+    for (const [file, content] of docs) {
+        const lines = content.split('\n');
+        let insideFence = false;
+        for (const [i, rawLine] of lines.entries()) {
+            // A ``` toggles the fenced-code state for every FOLLOWING line; the fence
+            // line itself carries no tokens worth checking.
+            if (/^\s*```/.test(rawLine)) {
+                insideFence = !insideFence;
+                continue;
+            }
+            // `<!-- ref-allow -->` and `<!-- ref-allow: why this is not a reference -->`
+            // both count. An exemption whose whole justification is that it was
+            // reviewed in a diff needs somewhere to say WHY, and a marker that must
+            // be byte-exact leaves the reason to a comment on another line — where
+            // this gate cannot see it, so the exemption silently stops applying.
+            const markerHit = marker !== undefined && markerRe(marker).test(rawLine);
+            compiled.re.lastIndex = 0;
+            let m;
+            while ((m = compiled.re.exec(rawLine)) !== null) {
+                const token = m[0];
+                const site = { token, file, line: i + 1 };
+                if (markerHit) {
+                    tokens.push({ ...site, skipped: 'exempt-marker' });
+                    continue;
+                }
+                if (exempt.has(token)) {
+                    tokens.push({ ...site, skipped: 'exempt' });
+                    continue;
+                }
+                if (!passesContext(rule, rawLine, m.index, insideFence)) {
+                    tokens.push({ ...site, skipped: 'context' });
+                    continue;
+                }
+                const resolvedAs = kinds.find((kind) => referenceIdExists(inspection, kind, token));
+                if (resolvedAs !== undefined) {
+                    tokens.push({ ...site, resolvedAs });
+                    continue;
+                }
+                tokens.push(site);
+                const suggestions = nearestIds(token, pool).map((n) => n.id);
+                findings.push({
+                    ruleId: rule.id,
+                    ...site,
+                    severity,
+                    message: `"${token}" is not a registered ${kinds.join(' / ')}`,
+                    didYouMean: suggestions,
+                    ...(rule.hint ? { hint: rule.hint } : {}),
+                });
+                // A zero-width match would loop forever; nudge past it.
+                if (m[0].length === 0)
+                    compiled.re.lastIndex += 1;
+            }
+        }
+    }
+    const tokensChecked = tokens.filter((t) => t.skipped === undefined).length;
+    const tokensSkipped = tokens.length - tokensChecked;
+    // A rule that CHECKED nothing enforced nothing. Which of "0 docs" or "0
+    // tokens" happened matters to whoever has to fix it, so the reason says.
+    if (tokensChecked === 0) {
+        const failed = rule.failOnEmpty ?? severity === 'error';
+        return {
+            ...base,
+            status: failed ? 'failed' : 'skipped',
+            filesScanned: docs.length,
+            tokensChecked,
+            tokensSkipped,
+            findings: [],
+            tokens,
+            skipReason: docs.length === 0
+                ? `0 documents matched (${rule.files.join(', ')})`
+                : `${docs.length} document(s) scanned but no token counted as a reference` +
+                    (tokensSkipped > 0
+                        ? ` (${tokensSkipped} matched and were skipped — check \`requireContext\`)`
+                        : ''),
+        };
+    }
+    return {
+        ...base,
+        status: findings.length > 0 && severity === 'error' ? 'failed' : findings.length > 0 ? 'failed' : 'passed',
+        filesScanned: docs.length,
+        tokensChecked,
+        tokensSkipped,
+        findings,
+        tokens,
+    };
+}

package/dist/fuzzy-impact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fuzzy-impact.d.ts","sourceRoot":"","sources":["../src/fuzzy-impact.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,cAAc,EAEd,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,eAAO,MAAM,8BAA8B,0CAA0C,CAAC;AAEtF,oBAAY,qBAAqB;IAC/B,SAAS,eAAe;IACxB,SAAS,cAAc;IACvB,SAAS,eAAe;IACxB,UAAU,gBAAgB;IAC1B,OAAO,aAAa;IACpB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,8BAA8B,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,sEAAsE;IACtE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,2EAA2E;IAC3E,eAAe,EAAE,OAAO,CAAC;IACzB,oEAAoE;IACpE,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kCAAkC;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA+aD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,0BAA+B,GACvC,sBAAsB,CA+BxB"}
+{"version":3,"file":"fuzzy-impact.d.ts","sourceRoot":"","sources":["../src/fuzzy-impact.ts"],"names":[],"mappings":"AA2BA,OAAO,EACL,cAAc,EAEd,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAKvE,eAAO,MAAM,8BAA8B,0CAA0C,CAAC;AAEtF,oBAAY,qBAAqB;IAC/B,SAAS,eAAe;IACxB,SAAS,cAAc;IACvB,SAAS,eAAe;IACxB,UAAU,gBAAgB;IAC1B,OAAO,aAAa;IACpB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,8BAA8B,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,sEAAsE;IACtE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,2EAA2E;IAC3E,eAAe,EAAE,OAAO,CAAC;IACzB,oEAAoE;IACpE,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kCAAkC;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAqaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,0BAA+B,GACvC,sBAAsB,CA+BxB"}

package/dist/fuzzy-impact.js

@@ -27,6 +27,8 @@ import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { QueryMatchKind, resolveQuery, } from "./query-resolver.js";
 import { HELPERS } from "./helper-registry.js";
+import { listConstructs } from "./construct-registry.js";
+import { listPlaybooks } from "./playbook-registry.js";
 export const FUZZY_IMPACT_RESOLUTION_SCHEMA = 'sharkcraft.fuzzy-impact-resolution/v1';
 export var FuzzyImpactSourceKind;
 (function (FuzzyImpactSourceKind) {
@@ -45,22 +47,11 @@ export var FuzzyImpactSourceKind;
     FuzzyImpactSourceKind["Unresolved"] = "unresolved";
 })(FuzzyImpactSourceKind || (FuzzyImpactSourceKind = {}));
 function listConstructsFrom(inspection) {
-    // 1) Pre-warmed sync cache.
-    const direct = inspection.constructs;
-    if (direct && direct.length > 0)
-        return direct;
-    // 2) Registry with list() — duck-typed.
-    const reg = inspection
-        .constructRegistry;
-    if (reg && typeof reg.list === 'function') {
-        try {
-            return reg.list();
-        }
-        catch {
-            return [];
-        }
-    }
-    return [];
+    // One source. The two structural casts that used to precede this
+    // (`inspection.constructs`, then `inspection.constructRegistry.list()`) read
+    // properties nothing assigns, so this function returned [] in production
+    // while tests that faked those properties passed.
+    return listConstructs(inspection);
 }
 function constructFor(inspection, id) {
     return listConstructsFrom(inspection).find((c) => c.id === id);
@@ -145,10 +136,10 @@ function knowledgeFileReferences(inspection, knowledgeId) {
     return out;
 }
 function playbookFiles(inspection, playbookId) {
-    const reg = inspection.playbookRegistry;
-    if (!reg || typeof reg.get !== 'function')
-        return [];
-    const playbook = reg.get(playbookId);
+    // `listPlaybooks` is the same source `shrk playbooks list` reads. The
+    // previous `inspection.playbookRegistry?.get()` cast pointed at a property
+    // nothing ever assigned, so every playbook expanded to zero files.
+    const playbook = listPlaybooks(inspection).find((p) => p.id === playbookId);
     if (!playbook)
         return [];
     const out = [];

package/dist/index.d.ts

@@ -95,6 +95,7 @@ export * from './demo-package.js';
 export * from './release-readiness.js';
 export * from './pack-release-check.js';
 export * from './playbook-registry.js';
+export * from './policy-registry.js';
 export * from './playbook-script.js';
 export * from './search-index.js';
 export * from './search-tuning-registry.js';
@@ -229,4 +230,7 @@ export * from './grounding/validate-extracted-plan.js';
 export * from './grounding/build-grounding.js';
 export * from './grounding/nx-projects.js';
 export * from './why-file.js';
+export * from './nearest-id.js';
+export * from './reference-registry.js';
+export * from './doc-references.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -95,6 +95,7 @@ export * from "./demo-package.js";
 export * from "./release-readiness.js";
 export * from "./pack-release-check.js";
 export * from "./playbook-registry.js";
+export * from "./policy-registry.js";
 export * from "./playbook-script.js";
 export * from "./search-index.js";
 export * from "./search-tuning-registry.js";
@@ -240,3 +241,6 @@ export * from "./grounding/build-grounding.js";
 export * from "./grounding/nx-projects.js";
 // DX/feedback3 — `shrk why <file>` report builder.
 export * from "./why-file.js";
+export * from "./nearest-id.js";
+export * from "./reference-registry.js";
+export * from "./doc-references.js";

package/dist/knowledge-stale.d.ts.map

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