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

package/dist/knowledge-rename.js

@@ -6,6 +6,7 @@
  *
  * Schema: sharkcraft.knowledge-rename/v2.
  */
+import { knowledgeAnchors, knowledgeReferences, } from '@shrkcrft/knowledge';
 export const KNOWLEDGE_RENAME_SCHEMA = 'sharkcraft.knowledge-rename/v2';
 function clone(v) {
     return JSON.parse(JSON.stringify(v));
@@ -13,14 +14,14 @@ function clone(v) {
 export function buildRenameSymbolPlan(inspection, opts) {
     const matches = [];
     for (const entry of inspection.knowledgeEntries) {
-        for (const ref of entry.references ?? []) {
+        for (const ref of knowledgeReferences(entry)) {
             if (ref.kind === 'symbol' && ref.symbol === opts.from) {
                 const after = clone(ref);
                 after.symbol = opts.to;
                 matches.push({ entryId: entry.id, field: 'reference', before: ref, after });
             }
         }
-        for (const anchor of entry.anchors ?? []) {
+        for (const anchor of knowledgeAnchors(entry)) {
             if (anchor.kind === 'symbol' && anchor.symbol === opts.from) {
                 const after = clone(anchor);
                 after.symbol = opts.to;
@@ -39,14 +40,14 @@ export function buildRenameSymbolPlan(inspection, opts) {
 export function buildRenameFilePlan(inspection, opts) {
     const matches = [];
     for (const entry of inspection.knowledgeEntries) {
-        for (const ref of entry.references ?? []) {
+        for (const ref of knowledgeReferences(entry)) {
             if (ref.path === opts.from) {
                 const after = clone(ref);
                 after.path = opts.to;
                 matches.push({ entryId: entry.id, field: 'reference', before: ref, after });
             }
         }
-        for (const anchor of entry.anchors ?? []) {
+        for (const anchor of knowledgeAnchors(entry)) {
             if (anchor.path === opts.from) {
                 const after = clone(anchor);
                 after.path = opts.to;
@@ -65,7 +66,7 @@ export function buildRenameFilePlan(inspection, opts) {
 export function buildAnchorUpdatePlan(inspection, opts) {
     const matches = [];
     for (const entry of inspection.knowledgeEntries) {
-        for (const anchor of entry.anchors ?? []) {
+        for (const anchor of knowledgeAnchors(entry)) {
             if (anchor.id !== opts.anchorId)
                 continue;
             const after = clone(anchor);

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

@@ -26,6 +26,8 @@ import { type IKnowledgeStaleReport } from './knowledge-stale.js';
 import type { IKnowledgeStaleGateFlags } from './knowledge-stale-gate-flags.js';
 import type { IKnowledgeStaleGateInput } from './knowledge-stale-gate-input.js';
 import type { IKnowledgeStaleGate } from './knowledge-stale-gate-result.js';
+/** The stale-check rule of the knowledge entries the loader refused (round 15 follow-up, F3). */
+export declare const KNOWLEDGE_REJECTED_RULE_ID = "knowledge-rejected-entries";
 /**
  * Every `--fail-on` category. `all` keeps its historical meaning (any stale or
  * missing reference); the round-11 categories are opt-in BY NAME, so no

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge-stale-gate.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAqC,KAAK,eAAe,EAAyB,MAAM,gBAAgB,CAAC;AAGhH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAU5E;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAazD,CAAC;AAKF,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7D;AAED,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AA6CD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CA4RrB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,cAAc,EAAE,OAAO,EACvB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CASpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IACzC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAC7D,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GAAG,wBAAwB,CA8B3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CASnF"}
+{"version":3,"file":"knowledge-stale-gate.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAqC,KAAK,eAAe,EAAyB,MAAM,gBAAgB,CAAC;AAGhH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAQ5E,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAOvE;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAazD,CAAC;AAKF,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7D;AAED,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAiDD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CA8VrB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,cAAc,EAAE,OAAO,EACvB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CASpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IACzC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAC7D,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GAAG,wBAAwB,CA8B3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CASnF"}

package/dist/knowledge-stale-gate.js

@@ -3,7 +3,12 @@ import { formatKnowledgeReference } from '@shrkcrft/knowledge';
 import { declaredReferenceCoverage } from "./declared-reference-coverage.js";
 import { KnowledgeEntryVerdict } from "./knowledge-entry-verdict.js";
 import { ReferenceCheckOutcome } from "./knowledge-stale.js";
+import { KnowledgeMinReferencedValve } from "./knowledge-min-referenced-valve.js";
+import { REJECTED_AT_LOAD } from "./knowledge-entry-rejections.js";
+import { unverifiableEntryRemedy, unverifiableRemedy } from "./knowledge-unverifiable-remedy.js";
 import { ReferenceFailure } from "./reference-failure.js";
+/** The stale-check rule of the knowledge entries the loader refused (round 15 follow-up, F3). */
+export const KNOWLEDGE_REJECTED_RULE_ID = 'knowledge-rejected-entries';
 /** The proposed exits (the CLI's `ExitCode` values; the inspector cannot import the CLI). */
 const VERIFIED_PASS = 0;
 const FAILURE = 1;
@@ -75,6 +80,10 @@ function emptyScopeReason(report, input) {
     if (report.entries === 0 && failed.length > 0) {
         return `${plural(failed.length, 'knowledge file', 'knowledge files')} never loaded — ${loadFailureList(failed)} — so no knowledge was loaded`;
     }
+    // Round 15 follow-up (F3): entries WERE declared — the loader refused them all.
+    if (report.entries === 0 && report.rejectedEntries.length > 0) {
+        return `every declared knowledge entry (${report.rejectedEntries.length}) was rejected at load, so none was checked`;
+    }
     if (report.entries === 0)
         return 'no knowledge entries are declared';
     const alsoFailed = failed.length > 0 ? `, and ${plural(failed.length, 'knowledge file', 'knowledge files')} never loaded (${loadFailureList(failed)})` : '';
@@ -110,6 +119,12 @@ export function evaluateKnowledgeStaleGate(report, input) {
     const invalidRefs = declaredRefs.filter((c) => c.outcome === ReferenceCheckOutcome.Invalid);
     const invalidAnchors = report.anchorChecks.filter((a) => a.outcome === ReferenceCheckOutcome.Invalid);
     const invalidCount = invalidRefs.length + invalidAnchors.length;
+    // Round 15 follow-up (F3): entries the LOADER refused. INVALID-class: never
+    // in scope, never checked — a coverage shortfall of their own rule (exit 2),
+    // a failure under `--fail-on invalid` (exit 1). No valve accepts them:
+    // `--min-referenced` accepts the run's unverifiable remainder and
+    // `--allow-empty` an empty scope, never this rule.
+    const rejected = report.rejectedEntries;
     const reasons = [];
     // The historical modes, unchanged (they are mutually exclusive by design).
     if (input.ci) {
@@ -162,6 +177,9 @@ export function evaluateKnowledgeStaleGate(report, input) {
     if (failOn.has('invalid') && invalidCount > 0) {
         reasons.push(`${plural(invalidCount, 'malformed reference', 'malformed references')} (--fail-on=invalid)`);
     }
+    if (failOn.has('invalid') && rejected.length > 0) {
+        reasons.push(`${plural(rejected.length, 'knowledge entry', 'knowledge entries')} rejected at load (--fail-on=invalid)`);
+    }
     const requireRefs = input.requireReferences || failOn.has('unverifiable');
     if (requireRefs && cov.unverifiable > 0) {
         reasons.push(`${plural(cov.unverifiable, 'entry declares', 'entries declare')} no checkable reference (--require-references)`);
@@ -243,11 +261,16 @@ export function evaluateKnowledgeStaleGate(report, input) {
     const rules = [];
     if (cov.entriesInScope > 0) {
         const violations = [];
+        // The file declaring each knowledge entry — a violation names the file to
+        // edit (round 15: a Markdown entry's, its .md).
+        const declaredIn = new Map(report.entryVerdicts.map((v) => [v.entryId, v.source]));
         for (const c of [...report.referenceChecks, ...assetFailing, ...(failOn.has('implicit') ? implicitFailing : [])]) {
             if (!isFailing(c.outcome))
                 continue;
+            const file = c.assetKind ? undefined : declaredIn.get(c.entryId);
             violations.push({
                 id: c.entryId,
+                ...(file !== undefined ? { file } : {}),
                 message: `${formatKnowledgeReference(c.reference)} — ${c.message}`,
                 ...(c.suggestion ? { hint: c.suggestion } : {}),
             });
@@ -272,7 +295,9 @@ export function evaluateKnowledgeStaleGate(report, input) {
                 violations.push({
                     id: v.entryId,
                     file: v.source,
-                    message: `UNVERIFIABLE (${v.reason ?? 'no checkable reference'}) — declare references[]`,
+                    // THE per-entry remedy (round 15 closing, A4): an entry whose
+                    // references exist but are malformed read "declare references[]".
+                    message: `UNVERIFIABLE (${v.reason ?? 'no checkable reference'}) — ${unverifiableEntryRemedy(v)}`,
                 });
             }
         }
@@ -303,6 +328,40 @@ export function evaluateKnowledgeStaleGate(report, input) {
             ...(waiver !== undefined ? { unitAcceptance: waiver } : {}),
         });
     }
+    // Round 15 follow-up (F3): knowledge entries the loader REFUSED — their own
+    // rule, pushed at ANY scope and corpus size (a clean sweep of the rest, a
+    // changeset, `--allow-empty` or `--min-referenced` never covers them). By
+    // default `skipped` — nothing was checked, the shortfall settles the run to
+    // 2 — and `failed` under `--fail-on invalid`, the INVALID-class contract of a
+    // malformed reference.
+    if (rejected.length > 0) {
+        const failing = failOn.has('invalid');
+        rules.push({
+            id: KNOWLEDGE_REJECTED_RULE_ID,
+            type: 'knowledge',
+            status: failing ? 'failed' : 'skipped',
+            severity: 'error',
+            counts: { rejected: rejected.length },
+            violations: failing
+                ? rejected.map((r) => ({
+                    id: r.label,
+                    file: r.source,
+                    message: `REJECTED AT LOAD${r.pack !== undefined ? ` (pack ${r.pack})` : ''} — ${r.message}`,
+                }))
+                : [],
+            ...(failing
+                ? {}
+                : { skipReason: `${plural(rejected.length, 'knowledge entry was', 'knowledge entries were')} rejected at load — never checked` }),
+            coverage: {
+                unit: 'knowledge entries',
+                expected: rejected.length,
+                examined: 0,
+                unexamined: rejected.slice(0, COVERAGE_LABEL_CAP).map((r) => r.label),
+                unexaminedTotal: rejected.length,
+                reason: `${REJECTED_AT_LOAD} — the loader refused them (\`shrk self-config doctor\` names why); no valve accepts them`,
+            },
+        });
+    }
     // Knowledge-bearing files that never loaded: their own rule, so the envelope
     // names each one and the shortfall rides into the settled verdict whatever
     // the rest of the corpus proved. `error` — a source that could not be read is
@@ -331,15 +390,28 @@ export function evaluateKnowledgeStaleGate(report, input) {
             },
         });
     }
-    const notVerifiedLead = loadFailures.length > 0
+    // A refused entry's sentence rides next to whichever lead the run has — it is
+    // never the whole story, and never dropped from it (round 15 follow-up, F3).
+    const rejectedLead = rejected.length > 0
+        ? `${plural(rejected.length, 'knowledge entry was', 'knowledge entries were')} rejected at load and never checked (listed above as INVALID): ${rejected
+            .slice(0, LOAD_FAILURES_NAMED)
+            .map((r) => r.label)
+            .join(', ')}${rejected.length > LOAD_FAILURES_NAMED ? ` (+${rejected.length - LOAD_FAILURES_NAMED} more)` : ''} — fix each (\`shrk self-config doctor\` names why); \`--fail-on invalid\` makes this a failure, and no valve accepts it.`
+        : undefined;
+    const loadLead = loadFailures.length > 0
         ? `${plural(loadFailures.length, 'knowledge file', 'knowledge files')} never loaded, so ${loadFailures.length === 1 ? 'its entries were' : 'their entries were'} never checked: ${loadFailureList(loadFailures)}. Fix the file (\`shrk doctor\` names the error) — --allow-empty never accepts a load failure.`
+        : undefined;
+    const restLead = loadFailures.length > 0
+        ? undefined
         : discoveryFailed
             ? `Loaded 0 knowledge entries from ${d.resolvedRoot} — nothing was checked.`
             : cov.entriesInScope > 0 && cov.unverifiable > 0
-                ? `${plural(cov.unverifiable, 'entry', 'entries')} of ${cov.entriesInScope} (${formatPct(cov.unverifiable / cov.entriesInScope)}) ${cov.unverifiable === 1 ? 'declares' : 'declare'} no checkable reference, so ${cov.unverifiable === 1 ? 'it was' : 'they were'} never checked. Declare references[] (ids listed above), or accept a floor explicitly with --min-referenced <ratio>.`
+                ? `${plural(cov.unverifiable, 'entry', 'entries')} of ${cov.entriesInScope} (${formatPct(cov.unverifiable / cov.entriesInScope)}) ${cov.unverifiable === 1 ? 'declares' : 'declare'} no checkable reference, so ${cov.unverifiable === 1 ? 'it was' : 'they were'} never checked. ${unverifiableRemedy(report.entryVerdicts, KnowledgeMinReferencedValve.Flag)}`
                 : invalidCount > 0
                     ? `${plural(invalidCount, 'reference is', 'references are')} MALFORMED (listed above as INVALID) and ${invalidCount === 1 ? 'was' : 'were'} never checked — fix the kind or the missing field; \`--fail-on invalid\` makes this a failure.`
                     : undefined;
+    const leads = [loadLead, rejectedLead, restLead].filter((l) => l !== undefined);
+    const notVerifiedLead = leads.length > 0 ? leads.join(' ') : undefined;
     return {
         proposed,
         reasons,

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

@@ -1 +1 @@
-{"version":3,"file":"knowledge-stale-quality-gate.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-quality-gate.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAKzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,qBAAqB,EACjC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAgF7B"}
+{"version":3,"file":"knowledge-stale-quality-gate.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-quality-gate.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AAQzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,qBAAqB,EACjC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CA2G7B"}

package/dist/knowledge-stale-quality-gate.js

@@ -1,11 +1,16 @@
 import { describeInspectionDiscovery } from "./inspection-discovery.js";
+import { knowledgeRejectedEntries } from "./knowledge-entry-rejections.js";
 import { buildKnowledgeStaleReport } from "./knowledge-stale.js";
 import { evaluateKnowledgeStaleGate, formatPct, knowledgeStaleGateInput, settleKnowledgeStaleGate, } from "./knowledge-stale-gate.js";
+import { KnowledgeMinReferencedValve } from "./knowledge-min-referenced-valve.js";
+import { unverifiableFileRemedies, unverifiableRemedy } from "./knowledge-unverifiable-remedy.js";
 import { warmReferenceRegistries } from "./reference-registry.js";
 /** The quality-bundle gate id of the knowledge stale-check. */
 export const KNOWLEDGE_STALE_GATE_ID = 'knowledge-stale';
 /** Unverifiable entry ids carried in the gate's data (the verb's JSON has all of them). */
 const UNVERIFIABLE_IDS_SHOWN = 20;
+/** Refused entries named in the notes before the rest are summarised. */
+const REJECTED_NOTES_SHOWN = 5;
 /**
  * The knowledge stale-check as ONE quality gate — decided by THE gate the verb
  * settles (`evaluateKnowledgeStaleGate` + `settleKnowledgeStaleGate`), with the
@@ -30,9 +35,12 @@ export async function knowledgeStaleQualityGate(inspection, changedFiles) {
     const base = { id: KNOWLEDGE_STALE_GATE_ID, label: 'Knowledge stale-check', runsShell: false };
     const discovery = describeInspectionDiscovery(inspection);
     // A knowledge file that failed to load is never a deliberate skip — the
-    // corpus is partial (or gone), and the gate says so.
+    // corpus is partial (or gone), and the gate says so. Neither is a corpus
+    // whose entries the loader REFUSED (round 15 follow-up, F3): they were
+    // declared, and nothing they claim was checked.
     const loadFailed = discovery.knowledgeLoadFailures.length > 0;
-    if (inspection.knowledgeEntries.length === 0 && !loadFailed) {
+    const refused = knowledgeRejectedEntries(inspection).length > 0;
+    if (inspection.knowledgeEntries.length === 0 && !loadFailed && !refused) {
         return {
             ...base,
             passed: true,
@@ -46,7 +54,7 @@ export async function knowledgeStaleQualityGate(inspection, changedFiles) {
         // A bare warm keeps any command resolver a CLI caller already injected.
         await warmReferenceRegistries(inspection);
         const report = buildKnowledgeStaleReport(inspection, changedFiles ? { changedFiles } : {});
-        if (changedFiles && report.entriesInScope === 0 && !loadFailed) {
+        if (changedFiles && report.entriesInScope === 0 && !loadFailed && report.rejectedEntries.length === 0) {
             return {
                 ...base,
                 passed: true,
@@ -75,6 +83,7 @@ export async function knowledgeStaleQualityGate(inspection, changedFiles) {
         const settled = settleKnowledgeStaleGate(gate);
         const c = report.coverage;
         const share = c.entriesInScope > 0 ? formatPct(c.unverifiable / c.entriesInScope) : '0%';
+        const rejected = report.rejectedEntries;
         return {
             ...base,
             // 1 fails; 2 "passed" over PART of its scope (`partial`), which the one
@@ -83,17 +92,38 @@ export async function knowledgeStaleQualityGate(inspection, changedFiles) {
             blocking: true,
             executed: true,
             notes: [
-                `entries in scope ${c.entriesInScope} · verified ${c.verified} · stale ${c.stale} · unverifiable ${c.unverifiable} (${share})`,
+                `entries in scope ${c.entriesInScope} · verified ${c.verified} · stale ${c.stale} · unverifiable ${c.unverifiable} (${share})${rejected.length > 0 ? ` · rejected at load ${rejected.length}` : ''}`,
                 ...gate.reasons,
                 ...settled.shortfalls.map((s) => `NOT VERIFIED — ${s}`),
+                // Round 15 follow-up (F3): each entry the loader refused, named with the
+                // file to fix — the same wording as the stale-check's INVALID row.
+                ...rejected
+                    .slice(0, REJECTED_NOTES_SHOWN)
+                    .map((r) => `${r.label} (${r.source}${r.pack !== undefined ? `, pack ${r.pack}` : ''}) — ${r.message}`),
+                ...(rejected.length > REJECTED_NOTES_SHOWN
+                    ? [`… ${rejected.length - REJECTED_NOTES_SHOWN} more rejected at load (\`shrk knowledge stale-check\` lists all)`]
+                    : []),
+                // Round 15: the fix, in THIS surface's terms — quality refuses
+                // `--min-referenced`, so the valve it names is the config key.
+                ...(settled.exit === 2 && c.unverifiable > 0
+                    ? [
+                        `remedy: ${unverifiableRemedy(report.entryVerdicts, KnowledgeMinReferencedValve.Config)}`,
+                        ...unverifiableFileRemedies(report.entryVerdicts),
+                    ]
+                    : []),
                 ...settled.accepted,
             ],
             data: {
                 coverage: c,
                 unverifiableIds: report.unverifiableIds.slice(0, UNVERIFIABLE_IDS_SHOWN),
+                // Round 15 follow-up (F3): refused entries, capped like the ids above.
+                rejectedEntries: rejected.slice(0, UNVERIFIABLE_IDS_SHOWN),
                 failureCounts: report.failureCounts,
                 settledExit: settled.exit,
                 shortfalls: settled.shortfalls,
+                // What an explicit valve accepted (`knowledgeCheck.minReferenced`, a
+                // waiver) — `shrk quality` hoists it into the run's `accepted`.
+                accepted: settled.accepted,
                 ...(settled.exit === 2 ? { partial: true } : {}),
             },
         };

package/dist/knowledge-stale.d.ts

@@ -30,6 +30,7 @@ import type { IKnowledgeKindBucket } from './knowledge-kind-bucket.js';
 import type { IKnowledgeReferenceKindBucket } from './knowledge-reference-kind-bucket.js';
 import type { IKnowledgeStaleAdvisory } from './knowledge-stale-advisory.js';
 import type { IKnowledgeAgedEntry } from './knowledge-aged-entry.js';
+import type { IKnowledgeRejectedEntry } from './knowledge-rejected-entry.js';
 import { ReferenceAssetKind } from './reference-asset-kind.js';
 export declare const KNOWLEDGE_STALE_SCHEMA = "sharkcraft.knowledge-stale/v1";
 export declare enum ReferenceCheckOutcome {
@@ -165,6 +166,15 @@ export interface IKnowledgeStaleReport {
     entryVerdicts: ReadonlyArray<IKnowledgeEntryVerdictRecord>;
     /** Every unverifiable entry id in scope (renderers cap; this never does). */
     unverifiableIds: ReadonlyArray<string>;
+    /**
+     * Round 15 follow-up (F3): knowledge-family entries the LOADER REFUSED (THE
+     * rejection channel, `knowledgeRejectedEntries`). Never in {@link entries} or
+     * {@link entryVerdicts} — nothing they claim was read, let alone checked — so
+     * the verdict counts each one UNEXAMINED (an INVALID-class row; `--fail-on
+     * invalid` makes it a failure). Never narrowed by `changedFiles`: a refused
+     * entry's references were never read, so no changeset can prove it untouched.
+     */
+    rejectedEntries: ReadonlyArray<IKnowledgeRejectedEntry>;
     /** Non-ok checks per {@link ReferenceFailure} — knowledge references, anchors and other assets. */
     failureCounts: Readonly<Record<ReferenceFailure, number>>;
     /** Per asset kind. `scanned: 0` means NOT IN SWEEP — say so, never render it as clean zeros. */

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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"}