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

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

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

package/dist/plan-simulation.js

@@ -11,7 +11,9 @@
  */
 import { existsSync, readFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { evaluateBoundaries, loadTsconfigPaths, scanImports, } from '@shrkcrft/boundaries';
+import { evaluateBoundaries, loadTsconfigPaths, } from '@shrkcrft/boundaries';
+import { ChangedScopeMode } from "./boundaries-changed-only.js";
+import { runBoundaryCheck } from "./run-boundary-check.js";
 import { planGeneration, verifyPlan, } from '@shrkcrft/generator';
 import { reviewSavedPlan } from "./plan-review.js";
 import { resolveVerificationCommands } from "./resolve-verification-commands.js";
@@ -400,9 +402,15 @@ export async function simulatePlan(inspection, planPath, options = {}) {
         const tsconfigPaths = loadTsconfigPaths(inspection.projectRoot);
         const aliasOpts = tsconfigPaths.aliases.size > 0 ? { tsconfigPaths } : {};
         try {
-            const scan = scanImports({ projectRoot: inspection.projectRoot });
-            const evalResult = evaluateBoundaries(scan, inspection.boundaryRegistry.list(), aliasOpts);
-            const targetSet = new Set(files.map((f) => f.relativePath));
+            // Current state through THE boundary orchestrator, scoped to the planned
+            // paths (round 11 review R11-GAP-3): a governed target it could not read
+            // is a named limitation, never a silent "no concerns".
+            const targets = files.map((f) => f.relativePath);
+            const evalResult = runBoundaryCheck(inspection, { changed: { mode: ChangedScopeMode.Files, files: targets } });
+            if (evalResult.verdict === 'not-verified' && evalResult.selectedRuleIds.length > 0) {
+                limitations.push(`Boundary scan NOT VERIFIED: ${evalResult.shortfalls.join('; ')}`);
+            }
+            const targetSet = new Set(targets);
             for (const v of evalResult.violations) {
                 if (!targetSet.has(v.file))
                     continue;
@@ -421,6 +429,9 @@ export async function simulatePlan(inspection, planPath, options = {}) {
         }
         if (liveChanges.length > 0) {
             try {
+                // PLANNED contents are not on disk, so the orchestrator cannot scan
+                // them: a sanctioned direct `evaluateBoundaries` over planned edges
+                // only (the r75 one-boundary-authority lock names this call site).
                 const plannedEdges = collectPlannedEdges(liveChanges);
                 const evalResult = evaluateBoundaries({ filesScanned: liveChanges.length, edges: plannedEdges, warnings: [] }, inspection.boundaryRegistry.list(), aliasOpts);
                 for (const v of evalResult.violations) {
@@ -514,7 +525,7 @@ export async function simulatePlan(inspection, planPath, options = {}) {
     for (const cmd of resolvedValidations)
         requiredValidations.add(cmd);
     if (publicApiTouched || barrelExportTouched)
-        requiredValidations.add('shrk api report --all --public-only');
+        requiredValidations.add('shrk api-diff .sharkcraft/api-baseline.json --fail-on-breaking');
     if (pluginKeysTouched)
         requiredValidations.add('shrk packs doctor --release');
     if (adapterBoundaryTouched)

package/dist/playbook-load-issue.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A playbook file that did not take effect: it failed to import, or a pack
+ * declares it and it is not on disk. Every playbook it holds is silently
+ * absent, so the self-config doctor surfaces each one (and counts the file as
+ * unexamined) instead of reporting the registry healthy.
+ */
+export interface IPlaybookLoadIssue {
+    readonly severity: 'warning' | 'error';
+    readonly code: 'load-failed' | 'missing-file';
+    readonly message: string;
+    /** Absolute path of the file. */
+    readonly source: string;
+    /** Owning pack, when the file is a pack contribution. */
+    readonly packageName?: string;
+}
+//# sourceMappingURL=playbook-load-issue.d.ts.map

package/dist/playbook-load-issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-load-issue.d.ts","sourceRoot":"","sources":["../src/playbook-load-issue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/playbook-load-issue.js

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

package/dist/playbook-registry.d.ts

@@ -1,11 +1,32 @@
-import type { IPlaybookInput, IPlaybookStep } from '@shrkcrft/plugin-api';
+import { type IPlaybookInput, type IPlaybookStep } from '@shrkcrft/plugin-api';
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import { type IRejectedEntry } from '@shrkcrft/core';
+import type { IPlaybookLoadIssue } from './playbook-load-issue.js';
 export declare const PLAYBOOK_REGISTRY_SCHEMA = "sharkcraft.playbook-registry/v1";
 export interface IPlaybook extends IPlaybookInput {
     source: 'local' | 'pack';
     packageName?: string;
     sourceFile?: string;
 }
+/**
+ * THE playbook acceptance predicate (round 12, 12.1 / 12.1d): a string `id`
+ * and an array `steps` — `[]` means accepted. An id-less playbook used to be
+ * dropped silently (`if (!p?.id) continue`), and one with no `steps` was
+ * ACCEPTED and then crashed the self-config doctor (`p.steps.forEach`).
+ */
+export declare function playbookRejectionReasons(raw: unknown): readonly string[];
+/**
+ * Load every local and pack playbook, and report the files that did not take
+ * effect. Import failures used to be swallowed (`catch { ignore }`), so a
+ * broken `playbooks.ts` reported a healthy, merely smaller registry.
+ */
+export declare function loadPlaybooksWithIssues(inspection: ISharkcraftInspection): Promise<{
+    readonly playbooks: readonly IPlaybook[];
+    readonly issues: readonly IPlaybookLoadIssue[];
+    readonly files: number;
+    /** Every declared playbook the loader refused (round 12, 12.1). */
+    readonly rejected: readonly IRejectedEntry[];
+}>;
 export declare function loadPlaybooks(inspection: ISharkcraftInspection): Promise<readonly IPlaybook[]>;
 export declare function listPlaybooks(inspection: ISharkcraftInspection): readonly IPlaybook[];
 export declare function warmPlaybookCache(inspection: ISharkcraftInspection): Promise<void>;
@@ -21,5 +42,15 @@ export interface IPlaybookRecommendation {
     score: number;
     reasons: readonly string[];
 }
+/**
+ * Rank playbooks for a task through THE term matcher:
+ *   - whole task contained in the title: +10 (unchanged);
+ *   - each tag +3 and each taskKind +4, matched in the playbook's `matchMode`
+ *     (default tokens: tag `capability-pack` matches "add a capability pack");
+ *   - each example +3 when its content terms overlap the task's by ≥ 0.5 (Jaccard);
+ *   - +1 per distinct task content term in the title/description, capped at +3 —
+ *     only with ≥ 2 shared terms or alongside another signal, so a single
+ *     common verb ("add") never recommends a playbook on its own.
+ */
 export declare function recommendPlaybooks(playbooks: readonly IPlaybook[], task: string): readonly IPlaybookRecommendation[];
 //# sourceMappingURL=playbook-registry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"playbook-registry.d.ts","sourceRoot":"","sources":["../src/playbook-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AAE1E,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmCD,wBAAsB,aAAa,CACjC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAiD/B;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,SAAS,EAAE,CAGrF;AAED,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,gBAAgB,CAWlE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,IAAI,EAAE,MAAM,GACX,SAAS,uBAAuB,EAAE,CA+BpC"}
+{"version":3,"file":"playbook-registry.d.ts","sourceRoot":"","sources":["../src/playbook-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,eAAO,MAAM,wBAAwB,oCAAoC,CAAC;AAE1E,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAOxE;AAkBD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IACT,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C,CAAC,CAsGD;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAE/B;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,SAAS,EAAE,CAGrF;AAED,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,GAAG,gBAAgB,CAclE;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAOD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,IAAI,EAAE,MAAM,GACX,SAAS,uBAAuB,EAAE,CAuCpC"}

package/dist/playbook-registry.js

@@ -1,17 +1,29 @@
-import { existsSync, readFileSync } from 'node:fs';
+import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { importModuleViaLoader } from '@shrkcrft/core';
+import { TermMatchMode } from '@shrkcrft/plugin-api';
+import { importModuleViaLoader, readContributionExport, RejectionCause, } from '@shrkcrft/core';
+import { contentTerms, matchedQueryTerms, matchTerm, prepareTermQuery, termJaccard } from "./match-terms.js";
 export const PLAYBOOK_REGISTRY_SCHEMA = 'sharkcraft.playbook-registry/v1';
 const CACHE = new Map();
-async function importDefault(file) {
-    const mod = (await importModuleViaLoader(file));
-    if (Array.isArray(mod.default))
-        return mod.default;
-    if (mod.default && typeof mod.default === 'object')
-        return [mod.default];
-    if (Array.isArray(mod.playbooks))
-        return mod.playbooks;
-    return [];
+async function importPlaybooks(file) {
+    return readContributionExport(await importModuleViaLoader(file), { namedKeys: ['playbooks'] });
+}
+/**
+ * THE playbook acceptance predicate (round 12, 12.1 / 12.1d): a string `id`
+ * and an array `steps` — `[]` means accepted. An id-less playbook used to be
+ * dropped silently (`if (!p?.id) continue`), and one with no `steps` was
+ * ACCEPTED and then crashed the self-config doctor (`p.steps.forEach`).
+ */
+export function playbookRejectionReasons(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return ['(entry): must be an object'];
+    const p = raw;
+    const out = [];
+    if (typeof p.id !== 'string' || p.id.length === 0)
+        out.push('id: must be a non-empty string');
+    if (!Array.isArray(p.steps))
+        out.push('steps: must be an array');
+    return out;
 }
 function localPlaybookFiles(inspection) {
     const out = [];
@@ -23,36 +35,77 @@ function localPlaybookFiles(inspection) {
         if (existsSync(full))
             out.push(full);
     }
-    const cfg = inspection.config;
-    if (cfg?.playbookFiles) {
-        for (const rel of cfg.playbookFiles)
-            out.push(nodePath.join(dir, rel));
-    }
+    for (const rel of inspection.config?.playbookFiles ?? [])
+        out.push(nodePath.join(dir, rel));
     return out;
 }
-export async function loadPlaybooks(inspection) {
+function firstLine(s) {
+    return (s.split('\n')[0] ?? s).trim();
+}
+/**
+ * Load every local and pack playbook, and report the files that did not take
+ * effect. Import failures used to be swallowed (`catch { ignore }`), so a
+ * broken `playbooks.ts` reported a healthy, merely smaller registry.
+ */
+export async function loadPlaybooksWithIssues(inspection) {
     const cacheKey = `${inspection.projectRoot}:${inspection.packs.validPacks
         .map((p) => p.packageName + '@' + p.packageVersion)
         .join(',')}`;
     const cached = CACHE.get(inspection.projectRoot);
-    if (cached && cached.cacheKey === cacheKey)
-        return cached.list;
+    if (cached && cached.cacheKey === cacheKey) {
+        return { playbooks: cached.list, issues: cached.issues, files: cached.files, rejected: cached.rejected };
+    }
     const out = [];
-    for (const file of localPlaybookFiles(inspection)) {
-        try {
-            const list = await importDefault(file);
-            for (const p of list) {
-                if (!p?.id)
-                    continue;
-                out.push({
-                    ...p,
-                    source: 'local',
-                    sourceFile: nodePath.relative(inspection.projectRoot, file),
+    const issues = [];
+    const rejected = [];
+    let files = 0;
+    const ingestAll = (exp, file, origin) => {
+        exp.items.forEach((raw, i) => {
+            const reasons = playbookRejectionReasons(raw);
+            if (reasons.length > 0) {
+                const id = raw && typeof raw === 'object' ? raw.id : undefined;
+                rejected.push({
+                    file,
+                    index: exp.single ? -1 : i,
+                    ...(exp.exportName ? { exportName: exp.exportName } : {}),
+                    ...(typeof id === 'string' && id.length > 0 ? { entryId: id } : {}),
+                    reasons,
+                    cause: RejectionCause.Invalid,
                 });
+                return;
             }
+            out.push({
+                ...raw,
+                source: origin.source,
+                ...(origin.packageName ? { packageName: origin.packageName } : {}),
+                sourceFile: origin.sourceFile,
+            });
+        });
+    };
+    for (const file of localPlaybookFiles(inspection)) {
+        files += 1;
+        if (!existsSync(file)) {
+            issues.push({
+                severity: 'warning',
+                code: 'missing-file',
+                message: `playbookFiles declares ${nodePath.relative(inspection.projectRoot, file) || file} but the file is missing.`,
+                source: file,
+            });
+            continue;
+        }
+        try {
+            ingestAll(await importPlaybooks(file), file, {
+                source: 'local',
+                sourceFile: nodePath.relative(inspection.projectRoot, file),
+            });
         }
-        catch {
-            /* ignore */
+        catch (e) {
+            issues.push({
+                severity: 'warning',
+                code: 'load-failed',
+                message: `Failed to load ${nodePath.relative(inspection.projectRoot, file) || file}: ${firstLine(e.message ?? String(e))}`,
+                source: file,
+            });
         }
     }
     for (const pack of inspection.packs.validPacks ?? []) {
@@ -62,28 +115,40 @@ export async function loadPlaybooks(inspection) {
             continue;
         for (const rel of contributions.playbookFiles ?? []) {
             const file = nodePath.resolve(packRoot, rel);
-            if (!existsSync(file))
+            files += 1;
+            if (!existsSync(file)) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'missing-file',
+                    message: `Pack ${pack.packageName} declares ${rel} but the file is missing.`,
+                    source: file,
+                    packageName: pack.packageName,
+                });
                 continue;
+            }
             try {
-                const list = await importDefault(file);
-                for (const p of list) {
-                    if (!p?.id)
-                        continue;
-                    out.push({
-                        ...p,
-                        source: 'pack',
-                        packageName: pack.packageName,
-                        sourceFile: rel,
-                    });
-                }
+                ingestAll(await importPlaybooks(file), file, {
+                    source: 'pack',
+                    packageName: pack.packageName,
+                    sourceFile: rel,
+                });
             }
-            catch {
-                /* ignore */
+            catch (e) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'load-failed',
+                    message: `Pack ${pack.packageName} (${rel}): ${firstLine(e.message ?? String(e))}`,
+                    source: file,
+                    packageName: pack.packageName,
+                });
             }
         }
     }
-    CACHE.set(inspection.projectRoot, { cacheKey, list: out });
-    return out;
+    CACHE.set(inspection.projectRoot, { cacheKey, list: out, issues, rejected, files });
+    return { playbooks: out, issues, files, rejected };
+}
+export async function loadPlaybooks(inspection) {
+    return (await loadPlaybooksWithIssues(inspection)).playbooks;
 }
 export function listPlaybooks(inspection) {
     const cached = CACHE.get(inspection.projectRoot);
@@ -94,47 +159,71 @@ export async function warmPlaybookCache(inspection) {
 }
 export function buildRunbook(playbook) {
     const notes = [];
-    if (playbook.steps.length === 0) {
+    // The loader refuses a playbook without an array `steps`; guard anyway, so a
+    // hand-built playbook can never crash the runbook.
+    const steps = Array.isArray(playbook.steps) ? playbook.steps : [];
+    if (steps.length === 0) {
         notes.push('Playbook has no steps — add at least one in `definePlaybook`.');
     }
     return {
         playbookId: playbook.id,
         title: playbook.title ?? playbook.id,
-        steps: playbook.steps,
+        steps,
         notes,
     };
 }
+/** An example counts when its content terms and the task's overlap this much (Jaccard). */
+const EXAMPLE_JACCARD_THRESHOLD = 0.5;
+/** Title/description overlap: +1 per distinct shared content term, capped. */
+const TITLE_DESCRIPTION_CAP = 3;
+/**
+ * Rank playbooks for a task through THE term matcher:
+ *   - whole task contained in the title: +10 (unchanged);
+ *   - each tag +3 and each taskKind +4, matched in the playbook's `matchMode`
+ *     (default tokens: tag `capability-pack` matches "add a capability pack");
+ *   - each example +3 when its content terms overlap the task's by ≥ 0.5 (Jaccard);
+ *   - +1 per distinct task content term in the title/description, capped at +3 —
+ *     only with ≥ 2 shared terms or alongside another signal, so a single
+ *     common verb ("add") never recommends a playbook on its own.
+ */
 export function recommendPlaybooks(playbooks, task) {
-    const lower = task.toLowerCase();
+    const lower = task.trim().toLowerCase();
+    const query = prepareTermQuery(task);
+    const taskContent = contentTerms(task);
     const out = [];
     for (const p of playbooks) {
+        const mode = p.matchMode === TermMatchMode.Substring ? TermMatchMode.Substring : TermMatchMode.Tokens;
         let score = 0;
         const reasons = [];
-        if ((p.title ?? p.id).toLowerCase().includes(lower)) {
+        if (lower.length > 0 && (p.title ?? p.id).toLowerCase().includes(lower)) {
             score += 10;
             reasons.push('title matches task');
         }
         for (const t of p.tags ?? []) {
-            if (lower.includes(t.toLowerCase())) {
+            if (matchTerm(query, t, mode)) {
                 score += 3;
                 reasons.push(`tag ${t}`);
             }
         }
         for (const k of p.taskKinds ?? []) {
-            if (lower.includes(k.toLowerCase())) {
+            if (matchTerm(query, k, mode)) {
                 score += 4;
                 reasons.push(`taskKind ${k}`);
             }
         }
         for (const ex of p.examples ?? []) {
-            if (lower.includes(ex.toLowerCase()) || ex.toLowerCase().includes(lower)) {
+            if (termJaccard(taskContent, contentTerms(ex)) >= EXAMPLE_JACCARD_THRESHOLD) {
                 score += 3;
                 reasons.push('example matches');
             }
         }
+        const shared = matchedQueryTerms(taskContent, [p.title, p.description]);
+        if (shared.length >= 2 || (shared.length === 1 && score > 0)) {
+            score += Math.min(TITLE_DESCRIPTION_CAP, shared.length);
+            reasons.push(`title/description terms: ${shared.slice(0, TITLE_DESCRIPTION_CAP).join(', ')}`);
+        }
         if (score > 0)
             out.push({ playbook: p, score, reasons });
     }
     return out.sort((a, b) => b.score - a.score);
 }
-void readFileSync;

package/dist/policy-declaration.d.ts

@@ -0,0 +1,18 @@
+import type { IAssetReference } from '@shrkcrft/core';
+/**
+ * A declared policy check, read WITHOUT running it — the data the reference
+ * resolver and the staleness sweep need. Filled by the same load that lists
+ * policy ids, so there is one reader of the declarations.
+ */
+export interface IPolicyDeclaration {
+    /** The bare id the author declared. */
+    readonly id: string;
+    /** The id `evaluatePolicy` reports at runtime (`local:<id>` / `pack:<pkg>:<id>`). */
+    readonly qualifiedId: string;
+    readonly source: 'local' | 'pack';
+    /** Absolute path of the declaring file. */
+    readonly sourceFile: string;
+    /** Declared references, when the check carries any. */
+    readonly references?: readonly IAssetReference[];
+}
+//# sourceMappingURL=policy-declaration.d.ts.map

package/dist/policy-declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-declaration.d.ts","sourceRoot":"","sources":["../src/policy-declaration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD"}

package/dist/policy-declaration.js

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

package/dist/policy-engine.d.ts

@@ -1,4 +1,5 @@
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import { type IAssetReference } from '@shrkcrft/core';
 export declare const POLICY_REPORT_SCHEMA = "sharkcraft.policy-report/v1";
 export declare enum PolicySeverity {
     Info = "info",
@@ -54,6 +55,13 @@ export interface IPackPolicyCheck {
         suggestedFix?: string;
         context?: Record<string, unknown>;
     };
+    /**
+     * Verifiable pointers to the directories / packages / files this check is
+     * about — swept by `shrk knowledge stale-check` like a knowledge entry's. A
+     * check's real scope lives inside `evaluate()`, which cannot be read without
+     * running it, so declaring references is the only way it can be verified.
+     */
+    references?: readonly IAssetReference[];
 }
 export interface IPolicyCheckRegistration {
     id: string;

package/dist/policy-engine.d.ts.map

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

package/dist/policy-engine.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { evaluateBoundaries, loadTsconfigPaths, scanImports } from '@shrkcrft/boundaries';
+import { boundaryLoadIssueLabel, runBoundaryCheck } from "./run-boundary-check.js";
 import { impactFor, loadOwnershipRules } from "./ownership.js";
 import { importModuleViaLoader } from '@shrkcrft/core';
 export const POLICY_REPORT_SCHEMA = 'sharkcraft.policy-report/v1';
@@ -29,14 +29,31 @@ export async function evaluatePolicy(inspection, input = {}) {
     const cwd = inspection.projectRoot;
     const checks = [];
     const registrations = [];
-    // 1) Boundary violations.
-    if (inspection.boundaryRegistry.size() > 0) {
+    // 1) Boundary violations — through THE boundary orchestrator, the call
+    // `check boundaries` makes (round 11 review R11-GAP-3): an errored rule is an
+    // error check, and a scope it could not fully examine is named, never a
+    // silent "no boundary checks".
+    if (inspection.boundaryRegistry.size() > 0 || (inspection.boundaryLoadIssues ?? []).length > 0) {
         try {
-            const scan = scanImports({ projectRoot: cwd });
-            const tsconfigPaths = loadTsconfigPaths(cwd);
-            const evalResult = evaluateBoundaries(scan, inspection.boundaryRegistry.list(), {
-                ...(tsconfigPaths.aliases.size > 0 ? { tsconfigPaths } : {}),
-            });
+            const evalResult = runBoundaryCheck(inspection);
+            for (const issue of evalResult.loadIssues) {
+                checks.push({
+                    id: `boundary:load-error:${boundaryLoadIssueLabel(issue)}`,
+                    title: `Boundary rule did not load: ${boundaryLoadIssueLabel(issue)}`,
+                    severity: PolicySeverity.Error,
+                    checkType: PolicyCheckType.Import,
+                    message: `${issue.file}: ${issue.issues.join('; ')} — NOT evaluated`,
+                });
+            }
+            if (evalResult.verdict === 'not-verified') {
+                checks.push({
+                    id: 'boundary:not-verified',
+                    title: 'Boundary scan NOT VERIFIED',
+                    severity: PolicySeverity.Warning,
+                    checkType: PolicyCheckType.Import,
+                    message: `${evalResult.shortfalls.join('; ')} (this is not a pass)`,
+                });
+            }
             for (const v of evalResult.violations.slice(0, 200)) {
                 checks.push({
                     id: `boundary:${v.ruleId}:${v.file}:${v.line}`,
@@ -108,7 +125,7 @@ export async function evaluatePolicy(inspection, input = {}) {
                         severity: PolicySeverity.Warning,
                         checkType: PolicyCheckType.Plan,
                         message: `${input.planFile} has no signature.`,
-                        suggestedFix: 'Sign with `shrk plan sign <plan.json>` or generate with --sign.',
+                        suggestedFix: 'Re-save it signed: `shrk gen <templateId> <name> --save-plan <plan.json> --sign`.',
                     });
                 }
             }

package/dist/policy-overrides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy-overrides.d.ts","sourceRoot":"","sources":["../src/policy-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAEL,KAAK,aAAa,EAClB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,uBAAuB,CAAC;IACvC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,OAAO,EAAE,SAAS;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,cAAc,CAAC;QACjC,gBAAgB,CAAC,EAAE,cAAc,CAAC;QAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;CACL;AAiBD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,eAAe,EAAE,CAEjG;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,eAAe,EAAE,GACpC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,CA8D5D"}
+{"version":3,"file":"policy-overrides.d.ts","sourceRoot":"","sources":["../src/policy-overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAEL,KAAK,aAAa,EAClB,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,uBAAuB,CAAC;IACvC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,OAAO,EAAE,SAAS;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,CAAC,EAAE,cAAc,CAAC;QACjC,gBAAgB,CAAC,EAAE,cAAc,CAAC;QAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;CACL;AAkBD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,eAAe,EAAE,CAEjG;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,SAAS,eAAe,EAAE,GACpC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,CA8D5D"}

package/dist/policy-overrides.js

@@ -1,14 +1,14 @@
 import { PolicySeverity, } from "./policy-engine.js";
 export const POLICY_OVERRIDES_SCHEMA = 'sharkcraft.policy-overrides/v1';
 function readOverridesFromConfig(inspection) {
-    const cfg = inspection.config;
-    if (!cfg || !Array.isArray(cfg.policyOverrides))
-        return [];
+    // `policyOverrides` is a declared, schema-validated config key — typed read.
+    const configured = inspection.config?.policyOverrides ?? [];
     const out = [];
-    for (const o of cfg.policyOverrides) {
+    for (const o of configured) {
         if (typeof o.policyId !== 'string' || o.policyId.length === 0)
             continue;
         const override = { policyId: o.policyId };
+        // The schema's severity enum is exactly PolicySeverity's value set.
         if (o.severity)
             override.severity = o.severity;
         if (typeof o.enabled === 'boolean')

package/dist/policy-registry.d.ts

@@ -1,6 +1,33 @@
+import { type IRejectedEntry } from '@shrkcrft/core';
+import type { IContributionFileIssue } from './i-contribution-file-issue.js';
+import type { IPolicyDeclaration } from './policy-declaration.js';
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+/**
+ * THE policy-declaration acceptance predicate (round 12, 12.1): a non-empty
+ * string `id` — `[]` means accepted. An id-less declaration used to be
+ * filtered out with no signal. (A declaration's `evaluate` is the policy
+ * engine's to run; an id alone is enough to be referenced.)
+ */
+export declare function policyCheckRejectionReasons(raw: unknown): readonly string[];
 /** Load every declared policy id — local files first, then pack contributions. */
 export declare function loadPolicyIds(inspection: ISharkcraftInspection): Promise<readonly string[]>;
+/**
+ * The declared policy checks WITH what did not take effect (round 12, 12.1):
+ * files that failed to import and every declaration the loader refused — from
+ * the same one load {@link loadPolicyIds} reads.
+ */
+export declare function loadPolicyDeclarationsWithIssues(inspection: ISharkcraftInspection): Promise<{
+    readonly declarations: readonly IPolicyDeclaration[];
+    readonly issues: readonly IContributionFileIssue[];
+    readonly rejected: readonly IRejectedEntry[];
+}>;
+/**
+ * The declared policy checks (id, source, `references[]`) from the SAME cache
+ * {@link warmPolicyCache} fills — one reader of the declarations. Returns `[]`
+ * until the cache is warm; the staleness sweep reports that as "not in sweep",
+ * never as "no policies".
+ */
+export declare function listPolicyDeclarations(inspection: ISharkcraftInspection): readonly IPolicyDeclaration[];
 /**
  * The cached policy ids.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"policy-registry.d.ts","sourceRoot":"","sources":["../src/policy-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAoDvE,kFAAkF;AAClF,wBAAsB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CA6BjG;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,MAAM,EAAE,CAElF;AAED,wEAAwE;AACxE,wBAAsB,eAAe,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF"}
+{"version":3,"file":"policy-registry.d.ts","sourceRoot":"","sources":["../src/policy-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAuCvE;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAI3E;AAiGD,kFAAkF;AAClF,wBAAsB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAEjG;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACjG,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C,CAAC,CAGD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,qBAAqB,GAChC,SAAS,kBAAkB,EAAE,CAE/B;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,qBAAqB,GAAG,SAAS,MAAM,EAAE,CAElF;AAED,wEAAwE;AACxE,wBAAsB,eAAe,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF"}