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

package/dist/reuse/reuse-curated-resolution.d.ts

@@ -0,0 +1,36 @@
+import type { ReuseImportStyle } from '@shrkcrft/core';
+/**
+ * One curated `reusePrimitives[]` entry resolved against the code — THE record
+ * `shrk reuse` prints a curated row from and `shrk reuse coverage` judges it
+ * by (`resolveCuratedReuse`), so the two can never disagree about which
+ * construct an entry names or whether its import compiles.
+ */
+export interface IReuseCuratedResolution {
+    /**
+     * The declaration the entry names: the construct its `importPath` resolves
+     * to, else (among the name's declarations) one on the public surface, then an
+     * exported one, then the first by path. Absent when nothing declares it (or
+     * there is no graph to ask).
+     */
+    readonly declaration?: {
+        readonly path: string;
+        readonly symbolId: string;
+        readonly isExported: boolean;
+        readonly line?: number;
+        readonly declKind?: string;
+    };
+    /** Other files declaring the same name (exported ones when any are). */
+    readonly alternates: readonly string[];
+    /** How the printed import binds the symbol (set whenever `importPath` is). */
+    readonly importStyle?: ReuseImportStyle;
+    /** The copy-paste import line (set whenever `importPath` is). */
+    readonly importLine?: string;
+    /**
+     * `true` / `false` when `importPath` was checked: does the module it names
+     * export the symbol, so `importLine` compiles? Absent when it could not be
+     * checked (see `importPathNote`) or there is no graph.
+     */
+    readonly importPathAgrees?: boolean;
+    readonly importPathNote?: string;
+}
+//# sourceMappingURL=reuse-curated-resolution.d.ts.map

package/dist/reuse/reuse-curated-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reuse-curated-resolution.d.ts","sourceRoot":"","sources":["../../src/reuse/reuse-curated-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC"}

package/dist/reuse/reuse-curated-resolution.js

@@ -0,0 +1 @@
+export {};

package/dist/reuse/reuse-curated-status.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Where a curated `reusePrimitives[]` entry stands against the code.
+ *
+ * - `public`              — on a workspace package's public export surface.
+ * - `exported-not-public` — exported from its file, but no package entry
+ *   reaches it (a consumer cannot import it from a package root).
+ * - `not-exported`        — declared, never exported.
+ * - `not-found`           — no declaration of that name anywhere in the index:
+ *   a dead entry (a rename, a typo) that every `shrk reuse` answer would
+ *   still recommend. Fails `shrk reuse coverage`.
+ * - `ambiguous`           — several exported declarations and none public,
+ *   so which one the entry means is unknowable.
+ */
+export declare enum ReuseCuratedStatus {
+    Public = "public",
+    ExportedNotPublic = "exported-not-public",
+    NotExported = "not-exported",
+    NotFound = "not-found",
+    Ambiguous = "ambiguous"
+}
+//# sourceMappingURL=reuse-curated-status.d.ts.map

package/dist/reuse/reuse-curated-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reuse-curated-status.d.ts","sourceRoot":"","sources":["../../src/reuse/reuse-curated-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,iBAAiB,wBAAwB;IACzC,WAAW,iBAAiB;IAC5B,QAAQ,cAAc;IACtB,SAAS,cAAc;CACxB"}

package/dist/reuse/reuse-curated-status.js

@@ -0,0 +1,21 @@
+/**
+ * Where a curated `reusePrimitives[]` entry stands against the code.
+ *
+ * - `public`              — on a workspace package's public export surface.
+ * - `exported-not-public` — exported from its file, but no package entry
+ *   reaches it (a consumer cannot import it from a package root).
+ * - `not-exported`        — declared, never exported.
+ * - `not-found`           — no declaration of that name anywhere in the index:
+ *   a dead entry (a rename, a typo) that every `shrk reuse` answer would
+ *   still recommend. Fails `shrk reuse coverage`.
+ * - `ambiguous`           — several exported declarations and none public,
+ *   so which one the entry means is unknowable.
+ */
+export var ReuseCuratedStatus;
+(function (ReuseCuratedStatus) {
+    ReuseCuratedStatus["Public"] = "public";
+    ReuseCuratedStatus["ExportedNotPublic"] = "exported-not-public";
+    ReuseCuratedStatus["NotExported"] = "not-exported";
+    ReuseCuratedStatus["NotFound"] = "not-found";
+    ReuseCuratedStatus["Ambiguous"] = "ambiguous";
+})(ReuseCuratedStatus || (ReuseCuratedStatus = {}));

package/dist/reuse/reuse-match-detail.d.ts

@@ -0,0 +1,15 @@
+import type { ReuseMatchSource, ReuseNameMatch } from '@shrkcrft/core';
+/** How one curated reuse primitive matched an intent — the evidence behind its score. */
+export interface IReuseMatchDetail {
+    /** +1 per distinct intent token that hit any field, +0.5 per role an intent token hit. */
+    readonly score: number;
+    /** The distinct intent tokens that hit — the evidence behind the score. */
+    readonly matched: readonly string[];
+    /** An intent token equals one of the symbol NAME's tokens (the strongest signal). */
+    readonly symbolHit: boolean;
+    /** Which fields the tokens hit, in fixed order symbol → role → keyword → description. */
+    readonly matchedVia: readonly ReuseMatchSource[];
+    /** The name-level match, by token equality. */
+    readonly nameMatch: ReuseNameMatch;
+}
+//# sourceMappingURL=reuse-match-detail.d.ts.map

package/dist/reuse/reuse-match-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reuse-match-detail.d.ts","sourceRoot":"","sources":["../../src/reuse/reuse-match-detail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEvE,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC"}

package/dist/reuse/reuse-match-detail.js

@@ -0,0 +1 @@
+export {};

package/dist/reuse/reuse-ranking.d.ts

@@ -0,0 +1,37 @@
+import type { MatchConfidenceVerdict } from '@shrkcrft/core';
+import type { IReuseCandidate } from './reuse-candidate.js';
+import type { IReuseSuggestion } from './reuse-suggestion.js';
+/** The reuse engine's answer to one intent. */
+export interface IReuseRanking {
+    /** The normalised intent tokens every score is computed over. */
+    readonly tokens: readonly string[];
+    /** Shared confidence vocabulary: at least one candidate cleared the floor. */
+    readonly confident: boolean;
+    readonly verdict: MatchConfidenceVerdict;
+    /** Distinct intent tokens a metadata-only match must hit (a name match always clears it). */
+    readonly floor: number;
+    /** Best score among results and suggestions; 0 when nothing shares a term. */
+    readonly bestScore: number;
+    /** Confident answers, tier-ordered, capped at the limit. */
+    readonly results: readonly IReuseCandidate[];
+    /** Weak did-you-mean rows — only when `results` is empty. */
+    readonly suggestions: readonly IReuseSuggestion[];
+    /** Exports that matched by name but a curated entry's `supersedes` steers away from. */
+    readonly superseded: readonly {
+        readonly symbol: string;
+        readonly package: string;
+        readonly supersededBy: readonly string[];
+    }[];
+    /**
+     * An uncurated export answers by name (exact / covers) while the best curated
+     * candidate names it only in part, or matched only through metadata — the
+     * curated index does not cover this intent. `isReuseCurationGap`, the same
+     * predicate `shrk reuse coverage` lists `shadowed` by.
+     */
+    readonly curationGap: boolean;
+    /** Some candidate matched by NAME (tiers 1–3). False is the miss path. */
+    readonly nameAnswered: boolean;
+    /** The export surface was searched (a surface was given and not curated-only). */
+    readonly surfaceSearched: boolean;
+}
+//# sourceMappingURL=reuse-ranking.d.ts.map

package/dist/reuse/reuse-ranking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reuse-ranking.d.ts","sourceRoot":"","sources":["../../src/reuse/reuse-ranking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,wFAAwF;IACxF,QAAQ,CAAC,UAAU,EAAE,SAAS;QAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;KAC1C,EAAE,CAAC;IACJ;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC"}

package/dist/reuse/reuse-ranking.js

@@ -0,0 +1 @@
+export {};

package/dist/reuse/reuse-suggestion.d.ts

@@ -0,0 +1,19 @@
+import type { ReuseCandidateSource, ReuseMatchSource, ReuseNameMatch } from '@shrkcrft/core';
+/** A weak (below-confidence) candidate offered as a did-you-mean, never as an answer. */
+export interface IReuseSuggestion {
+    readonly symbol: string;
+    readonly score: number;
+    /** Fraction of distinct intent tokens that hit (0..1). */
+    readonly confidence: number;
+    readonly matched: readonly string[];
+    /** Curated roles; `[]` for an uncurated export-surface suggestion. */
+    readonly roles: readonly string[];
+    readonly source: ReuseCandidateSource;
+    readonly nameMatch: ReuseNameMatch;
+    readonly matchedVia: readonly ReuseMatchSource[];
+    /** Export-surface suggestions: the package that exposes it. */
+    readonly package?: string;
+    /** Export-surface suggestions: the declaring file. */
+    readonly declaredIn?: string;
+}
+//# sourceMappingURL=reuse-suggestion.d.ts.map

package/dist/reuse/reuse-suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reuse-suggestion.d.ts","sourceRoot":"","sources":["../../src/reuse/reuse-suggestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7F,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/reuse/reuse-suggestion.js

@@ -0,0 +1 @@
+export {};

package/dist/reuse/reuse-symbol-lookup.d.ts

@@ -0,0 +1,28 @@
+import type { IPublicExport } from '@shrkcrft/core';
+/**
+ * The code-graph questions the reuse engine asks, INJECTED by the caller (the
+ * CLI answers them from `GraphQueryApi`) — the inspector never imports the
+ * graph, so the engine stays pure and MCP-callable.
+ */
+export interface IReuseSymbolLookup {
+    /** Every indexed declaration of exactly `name`. */
+    declarationsOf(name: string): readonly {
+        readonly path: string;
+        readonly symbolId: string;
+        readonly isExported: boolean;
+        readonly line?: number;
+        readonly declKind?: string;
+    }[];
+    /** Real consumer files of a declaration. Optional. */
+    consumerCount?(symbolId: string): number;
+    /**
+     * What `import … from '<specifier>'` binds under the name `symbol`: the
+     * specifier resolved the way consumers' imports of it resolved, then walked
+     * with the SAME ESM export walk as the public surface — so a default export
+     * reads as one (`isDefault`), and a name `export *` does not forward reads as
+     * absent. `null` = the module does not export it. `undefined` = no indexed
+     * import resolves the specifier, so it could not be checked.
+     */
+    specifierExport?(specifier: string, symbol: string): Pick<IPublicExport, 'symbolId' | 'declaredIn' | 'line' | 'declKind' | 'isDefault'> | null | undefined;
+}
+//# sourceMappingURL=reuse-symbol-lookup.d.ts.map

package/dist/reuse/reuse-symbol-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reuse-symbol-lookup.d.ts","sourceRoot":"","sources":["../../src/reuse/reuse-symbol-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;QACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC5B,EAAE,CAAC;IACJ,sDAAsD;IACtD,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IACzC;;;;;;;OAOG;IACH,eAAe,CAAC,CACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1G"}

package/dist/reuse/reuse-symbol-lookup.js

@@ -0,0 +1 @@
+export {};

package/dist/reuse/reuse-tokenize.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The distinct tokens a reuse lookup matches on — for the INTENT and for a
+ * construct's NAME alike, so the two sides are normalised identically.
+ *
+ * Words are split by THE identifier tokenizer (`splitIdentifierTokens`), so
+ * an intent typed as an identifier (`DateRangePicker`) and the same words
+ * typed apart (`date range picker`) are the same query. Stop words and
+ * fragments under {@link MIN_TOKEN_LENGTH} are dropped; order is kept.
+ */
+export declare function tokenizeReuseIntent(text: string): string[];
+//# sourceMappingURL=reuse-tokenize.d.ts.map

package/dist/reuse/reuse-tokenize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reuse-tokenize.d.ts","sourceRoot":"","sources":["../../src/reuse/reuse-tokenize.ts"],"names":[],"mappings":"AAeA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM1D"}

package/dist/reuse/reuse-tokenize.js

@@ -0,0 +1,26 @@
+import { splitIdentifierTokens } from "../split-identifier.js";
+/** Words that name no construct in a reuse intent ("I want to add a …"). */
+const STOP = new Set([
+    'the', 'a', 'an', 'to', 'for', 'of', 'and', 'or', 'with', 'in', 'on', 'into', 'my',
+    'add', 'use', 'using', 'create', 'make', 'new', 'build', 'want', 'need', 'how', 'do',
+]);
+/**
+ * Minimum token length. 2-char tokens (`ui`, `id`) substring-match unrelated
+ * text (`guidance`, `valid`) in the curated metadata fields, which are still
+ * matched by containment.
+ */
+const MIN_TOKEN_LENGTH = 3;
+/**
+ * The distinct tokens a reuse lookup matches on — for the INTENT and for a
+ * construct's NAME alike, so the two sides are normalised identically.
+ *
+ * Words are split by THE identifier tokenizer (`splitIdentifierTokens`), so
+ * an intent typed as an identifier (`DateRangePicker`) and the same words
+ * typed apart (`date range picker`) are the same query. Stop words and
+ * fragments under {@link MIN_TOKEN_LENGTH} are dropped; order is kept.
+ */
+export function tokenizeReuseIntent(text) {
+    return [
+        ...new Set(splitIdentifierTokens(text).filter((t) => t.length >= MIN_TOKEN_LENGTH && !STOP.has(t))),
+    ];
+}

package/dist/reuse/score-reuse-name.d.ts

@@ -0,0 +1,16 @@
+import { ReuseNameMatch } from '@shrkcrft/core';
+/**
+ * How `symbol`'s NAME matches the intent `tokens` — by token EQUALITY on the
+ * split identifier, never substring: `ran` does not match `DateRange`.
+ *
+ * The name goes through the same normaliser as the intent
+ * ({@link tokenizeReuseIntent}), so a prefix the intent can never carry (the
+ * `I` of `IDateRangePickerOptions`, a `use` of `useDebounce`) does not stop
+ * an exact match.
+ */
+export declare function scoreReuseName(symbol: string, tokens: readonly string[]): ReuseNameMatch;
+/** The intent tokens (in intent order) that equal one of `symbol`'s name tokens. */
+export declare function reuseNameHits(symbol: string, tokens: readonly string[]): string[];
+/** How many of `symbol`'s name tokens the intent did NOT name — 0 is the closest name. */
+export declare function reuseNameExtraTokens(symbol: string, tokens: readonly string[]): number;
+//# sourceMappingURL=score-reuse-name.d.ts.map

package/dist/reuse/score-reuse-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-reuse-name.d.ts","sourceRoot":"","sources":["../../src/reuse/score-reuse-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CASxF;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAGjF;AAED,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEtF"}

package/dist/reuse/score-reuse-name.js

@@ -0,0 +1,35 @@
+import { ReuseNameMatch } from '@shrkcrft/core';
+import { tokenizeReuseIntent } from "./reuse-tokenize.js";
+/**
+ * How `symbol`'s NAME matches the intent `tokens` — by token EQUALITY on the
+ * split identifier, never substring: `ran` does not match `DateRange`.
+ *
+ * The name goes through the same normaliser as the intent
+ * ({@link tokenizeReuseIntent}), so a prefix the intent can never carry (the
+ * `I` of `IDateRangePickerOptions`, a `use` of `useDebounce`) does not stop
+ * an exact match.
+ */
+export function scoreReuseName(symbol, tokens) {
+    const intent = new Set(tokens);
+    if (intent.size === 0)
+        return ReuseNameMatch.None;
+    const name = new Set(tokenizeReuseIntent(symbol));
+    let hits = 0;
+    for (const t of intent)
+        if (name.has(t))
+            hits += 1;
+    if (hits === 0)
+        return ReuseNameMatch.None;
+    if (hits < intent.size)
+        return ReuseNameMatch.Partial;
+    return name.size === intent.size ? ReuseNameMatch.Exact : ReuseNameMatch.Covers;
+}
+/** The intent tokens (in intent order) that equal one of `symbol`'s name tokens. */
+export function reuseNameHits(symbol, tokens) {
+    const name = new Set(tokenizeReuseIntent(symbol));
+    return [...new Set(tokens)].filter((t) => name.has(t));
+}
+/** How many of `symbol`'s name tokens the intent did NOT name — 0 is the closest name. */
+export function reuseNameExtraTokens(symbol, tokens) {
+    return new Set(tokenizeReuseIntent(symbol)).size - reuseNameHits(symbol, tokens).length;
+}

package/dist/reuse/score-reuse-primitive.d.ts

@@ -0,0 +1,33 @@
+import { type IReusePrimitive } from '@shrkcrft/core';
+import type { IReuseMatchDetail } from './reuse-match-detail.js';
+/**
+ * Score one curated primitive against the intent tokens, keeping WHICH field
+ * each token hit — so a match through `keywords`/`description` alone is never
+ * reported the same way as a match on the symbol's name.
+ *
+ * - symbol: token EQUALITY on the split name (`debounce` hits `useDebounce`;
+ *   `ran` does not hit `DateRange`).
+ * - roles / keywords / description: substring containment, as before. Moving
+ *   those to token overlap belongs to the shared normaliser (round 11 §2.5), so
+ *   reuse and the recommender switch together.
+ *
+ * The numeric score keeps its historical meaning: +1 per distinct intent token
+ * that hit any field, +0.5 per role an intent token hit.
+ */
+export declare function scoreReusePrimitive(p: IReusePrimitive, tokens: readonly string[]): IReuseMatchDetail;
+/**
+ * Confidence floor: a keyword collision is not a match. A hit is only
+ * "confident" when it matched the symbol NAME, OR matched ≥2 distinct intent
+ * tokens, OR the intent was a single token and that token hit. A single
+ * generic keyword hit on a multi-token intent is a weak match — surfaced as a
+ * did-you-mean, never as a confident answer.
+ */
+export declare function isConfidentReuseMatch(detail: IReuseMatchDetail, queryTokenCount: number): boolean;
+/**
+ * The confidence floor, in distinct intent tokens a METADATA-only (non-name)
+ * match must hit: 2, or 1 for a single-token intent. A name match always
+ * clears it. This is the `floor` reuse reports in the shared confidence
+ * vocabulary.
+ */
+export declare function reuseConfidenceFloor(queryTokenCount: number): number;
+//# sourceMappingURL=score-reuse-primitive.d.ts.map

package/dist/reuse/score-reuse-primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score-reuse-primitive.d.ts","sourceRoot":"","sources":["../../src/reuse/score-reuse-primitive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAWjE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA0CpG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAKjG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/reuse/score-reuse-primitive.js

@@ -0,0 +1,92 @@
+import { ReuseMatchSource } from '@shrkcrft/core';
+import { scoreReuseName } from "./score-reuse-name.js";
+import { tokenizeReuseIntent } from "./reuse-tokenize.js";
+const SOURCE_ORDER = [
+    ReuseMatchSource.Symbol,
+    ReuseMatchSource.Role,
+    ReuseMatchSource.Keyword,
+    ReuseMatchSource.Description,
+];
+/**
+ * Score one curated primitive against the intent tokens, keeping WHICH field
+ * each token hit — so a match through `keywords`/`description` alone is never
+ * reported the same way as a match on the symbol's name.
+ *
+ * - symbol: token EQUALITY on the split name (`debounce` hits `useDebounce`;
+ *   `ran` does not hit `DateRange`).
+ * - roles / keywords / description: substring containment, as before. Moving
+ *   those to token overlap belongs to the shared normaliser (round 11 §2.5), so
+ *   reuse and the recommender switch together.
+ *
+ * The numeric score keeps its historical meaning: +1 per distinct intent token
+ * that hit any field, +0.5 per role an intent token hit.
+ */
+export function scoreReusePrimitive(p, tokens) {
+    const nameTokens = new Set(tokenizeReuseIntent(p.symbol));
+    const roles = (p.roles ?? []).map((r) => r.toLowerCase());
+    const keywords = (p.keywords ?? []).map((k) => k.toLowerCase());
+    const description = (p.description ?? '').toLowerCase();
+    const via = new Set();
+    const matched = [];
+    let score = 0;
+    for (const t of tokens) {
+        let hit = false;
+        if (nameTokens.has(t)) {
+            via.add(ReuseMatchSource.Symbol);
+            hit = true;
+        }
+        if (roles.some((r) => r.includes(t))) {
+            via.add(ReuseMatchSource.Role);
+            hit = true;
+        }
+        if (keywords.some((k) => k.includes(t))) {
+            via.add(ReuseMatchSource.Keyword);
+            hit = true;
+        }
+        if (description.includes(t)) {
+            via.add(ReuseMatchSource.Description);
+            hit = true;
+        }
+        if (hit) {
+            score += 1;
+            matched.push(t);
+        }
+    }
+    // A role the intent mentions is a strong signal; re-weight role hits.
+    for (const role of roles) {
+        if (role.length >= 3 && tokens.some((t) => role.includes(t)))
+            score += 0.5;
+    }
+    return {
+        score,
+        matched,
+        symbolHit: via.has(ReuseMatchSource.Symbol),
+        matchedVia: SOURCE_ORDER.filter((s) => via.has(s)),
+        nameMatch: scoreReuseName(p.symbol, tokens),
+    };
+}
+/**
+ * Confidence floor: a keyword collision is not a match. A hit is only
+ * "confident" when it matched the symbol NAME, OR matched ≥2 distinct intent
+ * tokens, OR the intent was a single token and that token hit. A single
+ * generic keyword hit on a multi-token intent is a weak match — surfaced as a
+ * did-you-mean, never as a confident answer.
+ */
+export function isConfidentReuseMatch(detail, queryTokenCount) {
+    if (detail.matched.length === 0)
+        return false;
+    if (detail.symbolHit)
+        return true;
+    if (detail.matched.length >= reuseConfidenceFloor(queryTokenCount))
+        return true;
+    return false;
+}
+/**
+ * The confidence floor, in distinct intent tokens a METADATA-only (non-name)
+ * match must hit: 2, or 1 for a single-token intent. A name match always
+ * clears it. This is the `floor` reuse reports in the shared confidence
+ * vocabulary.
+ */
+export function reuseConfidenceFloor(queryTokenCount) {
+    return Math.max(1, Math.min(2, queryTokenCount));
+}

package/dist/review-packet.d.ts

@@ -27,6 +27,8 @@ export interface IReviewPacket {
         severity: string;
         message: string;
     }[];
+    /** Why `boundaryViolations` is not the full answer for the changed files (THE boundary verdict's shortfalls). */
+    boundaryShortfalls?: readonly string[];
     /** Heuristic: missing tests for any changed `src/**` files. */
     missingTestsHeuristic: readonly string[];
     /** Verification commands recommended for the change set. */

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;AAKvE,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;IAC1B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAwCD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,yBAA8B,GACtC,aAAa,CA+Ef"}
+{"version":3,"file":"review-packet.d.ts","sourceRoot":"","sources":["../src/review-packet.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAKvE,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,iHAAiH;IACjH,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,+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;IAC1B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAwCD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,yBAA8B,GACtC,aAAa,CAqFf"}

package/dist/review-packet.js

@@ -1,4 +1,5 @@
-import { evaluateBoundaries, loadTsconfigPaths, scanImports } from '@shrkcrft/boundaries';
+import { ChangedScopeMode } from "./boundaries-changed-only.js";
+import { runBoundaryCheck } from "./run-boundary-check.js";
 import { matchAffectedConventions } from '@shrkcrft/paths';
 import { resolveVerificationCommands } from "./resolve-verification-commands.js";
 import { rankAll } from "./task-ranker.js";
@@ -55,14 +56,19 @@ export function buildReviewPacket(inspection, options = {}) {
     // (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.
+    // Boundary violations restricted to changed files — through THE boundary
+    // orchestrator in changed-scope mode, the call `check boundaries
+    // --changed-only` makes (round 11 review R11-GAP-3): a governed changed file
+    // it could not read is named in `boundaryShortfalls`, never a silent 0.
     let boundaryViolations = [];
+    let boundaryShortfalls = [];
     if (inspection.boundaryRegistry.size() > 0 && changedFiles.length > 0) {
-        const scan = scanImports({ projectRoot: inspection.projectRoot });
-        const tsconfigPaths = loadTsconfigPaths(inspection.projectRoot);
-        const evalResult = evaluateBoundaries(scan, inspection.boundaryRegistry.list(), {
-            ...(tsconfigPaths.aliases.size > 0 ? { tsconfigPaths } : {}),
+        const evalResult = runBoundaryCheck(inspection, {
+            changed: { mode: ChangedScopeMode.Files, files: changedFiles },
         });
+        if (evalResult.verdict === 'not-verified' && evalResult.selectedRuleIds.length > 0) {
+            boundaryShortfalls = evalResult.shortfalls;
+        }
         const changedSet = new Set(changedFiles);
         boundaryViolations = evalResult.violations
             .filter((v) => changedSet.has(v.file))
@@ -115,6 +121,7 @@ export function buildReviewPacket(inspection, options = {}) {
             title: p.item.title,
         })),
         boundaryViolations,
+        ...(boundaryShortfalls.length > 0 ? { boundaryShortfalls } : {}),
         missingTestsHeuristic: missingTestsHeuristic(changedFiles),
         verificationCommands,
         reviewerInstructions,

package/dist/role-views.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"role-views.d.ts","sourceRoot":"","sources":["../src/role-views.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAwB,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAuB,aAAa,EAAwB,MAAM,gBAAgB,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAE1D,oBAAY,MAAM;IAChB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,cAAc,oBAAoB;IAClC,QAAQ,aAAa;IACrB,OAAO,aAAa;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,gBAAgB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,gBAAgB,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAuGD,wBAAgB,aAAa,IAAI,SAAS,SAAS,EAAE,CAEpD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE/D;AA4ID,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CA8BzC;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAqCzE"}
+{"version":3,"file":"role-views.d.ts","sourceRoot":"","sources":["../src/role-views.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAwB,gBAAgB,EAAsB,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAuB,aAAa,EAAwB,MAAM,gBAAgB,CAAC;AAC1F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AAE1D,oBAAY,MAAM;IAChB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,cAAc,oBAAoB;IAClC,QAAQ,aAAa;IACrB,OAAO,aAAa;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,OAAO,gBAAgB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,gBAAgB,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAsGD,wBAAgB,aAAa,IAAI,SAAS,SAAS,EAAE,CAEpD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE/D;AA6ID,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CA8BzC;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAqCzE"}