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

package/dist/self-config-doctor.d.ts

@@ -1,4 +1,6 @@
+import type { IVerdictCoverage } from '@shrkcrft/core';
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import { type ISelfConfigDoctorReportV2 } from './self-config-doctor-v2.js';
 export declare const SELF_CONFIG_DOCTOR_SCHEMA = "sharkcraft.self-config-doctor/v1";
 export declare enum SelfConfigSeverity {
     Info = "info",
@@ -14,6 +16,8 @@ export interface ISelfConfigFinding {
     readonly referencedId?: string;
     readonly referencedKind?: string;
     readonly nextCommand?: string;
+    /** How many times v2 found this same finding (omitted when once). */
+    readonly occurrences?: number;
 }
 export interface ISelfConfigDoctorReport {
     readonly schema: typeof SELF_CONFIG_DOCTOR_SCHEMA;
@@ -21,8 +25,17 @@ export interface ISelfConfigDoctorReport {
     readonly projectRoot: string;
     readonly findings: readonly ISelfConfigFinding[];
     readonly totals: Readonly<Record<string, number>>;
-    readonly verdict: 'ok' | 'warnings' | 'errors';
+    /**
+     * v2's verdict. `unverified` (round 11): no errors, but a coverage record has
+     * a shortfall — a dead or unverifiable unit, e.g. command strings over MCP,
+     * which cannot inject the CLI's command index. See `coverage`.
+     */
+    readonly verdict: 'ok' | 'warnings' | 'errors' | 'unverified';
     readonly nextCommands: readonly string[];
+    /** v2's per-unit coverage — what each probe family examined. */
+    readonly coverage?: readonly IVerdictCoverage[];
+    /** v2's dead units (selectors that match nothing, boosts that never fire). */
+    readonly deadUnits?: readonly string[];
 }
 export interface ISelfConfigGraphNode {
     readonly id: string;
@@ -40,6 +53,12 @@ export interface ISelfConfigGraph {
     readonly edges: readonly ISelfConfigGraphEdge[];
     readonly brokenEdges: readonly ISelfConfigGraphEdge[];
 }
+/** The v1 shape of a v2 report — field renames only; no check of its own. */
+export declare function projectSelfConfigDoctorV2ToV1(report: ISelfConfigDoctorReportV2): ISelfConfigDoctorReport;
+/**
+ * The v1 report: {@link projectSelfConfigDoctorV2ToV1} of THE doctor. Kept
+ * for the MCP `get_self_config_doctor` default and v1 JSON consumers.
+ */
 export declare function buildSelfConfigDoctorReport(inspection: ISharkcraftInspection): Promise<ISelfConfigDoctorReport>;
 export declare function buildSelfConfigGraph(inspection: ISharkcraftInspection): Promise<ISelfConfigGraph>;
 export declare function renderSelfConfigDoctorText(report: ISelfConfigDoctorReport): string;

package/dist/self-config-doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"self-config-doctor.d.ts","sourceRoot":"","sources":["../src/self-config-doctor.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAOvE,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAE5E,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,OAAO,yBAAyB,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,iCAAiC,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACvD;AA2TD,wBAAsB,2BAA2B,CAC/C,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAsClC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAuC3B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAyBlF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAoBtF"}
+{"version":3,"file":"self-config-doctor.d.ts","sourceRoot":"","sources":["../src/self-config-doctor.ts"],"names":[],"mappings":"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"}

package/dist/self-config-doctor.js

@@ -1,20 +1,26 @@
 /**
- * Self-config doctor.
+ * Self-config doctor — the v1 schema (`sharkcraft.self-config-doctor/v1`).
  *
- * Cross-reference walker over the workspace's loaded contributions. Validates
- * the *graph* of references between knowledge, rules, paths, conventions,
- * templates, playbooks, helpers, profiles, agent-tests, search tuning,
- * feedback rules, decisions, contract templates, migration profiles, plugin
- * lifecycle profiles, MCP tool names, and CLI command catalog entries.
+ * v1 is a PROJECTION of v2 (`buildSelfConfigDoctorReportV2`). It used to be a
+ * second doctor with its own private checks: the CLI (v2) and the MCP tool /
+ * `fix preview --self-config` (v1) answered "is my config healthy?" with
+ * different check sets, and v1 still carried the hand-written `lookups.x.has`
+ * chain that reported correct ids as unknown. Now there is one set of checks;
+ * v1 only renames fields for back-compat (`sourceId` → `referencingId`,
+ * `targetId` → `referencedId`, `targetKind` → `referencedKind`, `file` →
+ * `sourceFile`) and maps the v2 `pack-signature-stale` code back to its v1
+ * spelling `pack-conflict:stale-signature`.
+ *
+ * `buildSelfConfigGraph` keeps its own lookup (a node list, not a check).
  *
  * Read-only. Never imports executable pack code beyond the loaders that
  * already do.
  */
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
-import { buildPackContributionsInventory } from "./pack-contributions-inventory.js";
-import { listTaskRoutingHints } from "./task-routing-hint-registry.js";
+import { knowledgeReferences } from '@shrkcrft/knowledge';
 import { referenceIdsFor, warmReferenceRegistries, } from "./reference-registry.js";
+import { buildSelfConfigDoctorReportV2, } from "./self-config-doctor-v2.js";
 export const SELF_CONFIG_DOCTOR_SCHEMA = 'sharkcraft.self-config-doctor/v1';
 export var SelfConfigSeverity;
 (function (SelfConfigSeverity) {
@@ -23,12 +29,8 @@ export var SelfConfigSeverity;
     SelfConfigSeverity["Error"] = "error";
 })(SelfConfigSeverity || (SelfConfigSeverity = {}));
 /**
- * Every set is a projection of the SHARED reference registry.
- *
- * This used to build its own sets from its own sources, and carried eleven more
- * fields that nothing read — nine of them hardcoded `new Set()`, so any check
- * that had started using one would have reported every correct id as unknown.
- * The v2 doctor made exactly that mistake with `policies` and `commands`.
+ * The graph's node sets — every set a projection of the SHARED reference
+ * registry (no check reads them; the checks are v2's).
  */
 async function buildLookups(inspection) {
     await warmReferenceRegistries(inspection);
@@ -41,278 +43,49 @@ async function buildLookups(inspection) {
         conventions: ids('convention'),
         contractTemplates: ids('contract-template'),
         migrationProfiles: ids('migration-profile'),
-        helpers: ids('helper'),
-        registrationHints: ids('registration-hint'),
     };
 }
-function addFinding(out, finding) {
-    out.push(finding);
-}
-async function checkKnowledgeReferences(inspection, lookups, findings) {
-    for (const k of inspection.knowledgeEntries) {
-        for (const ref of k.references ?? []) {
-            if (ref.kind === 'file' && ref.path) {
-                const abs = nodePath.isAbsolute(ref.path)
-                    ? ref.path
-                    : nodePath.join(inspection.projectRoot, ref.path);
-                if (!existsSync(abs)) {
-                    findings.push({
-                        severity: ref.required ? SelfConfigSeverity.Error : SelfConfigSeverity.Warning,
-                        code: 'knowledge-ref-missing-file',
-                        message: `Knowledge "${k.id}" references missing file "${ref.path}".`,
-                        referencingId: k.id,
-                        referencedId: ref.path,
-                        referencedKind: 'file',
-                        sourceFile: k.source?.origin ?? undefined,
-                        nextCommand: 'shrk knowledge stale-check --ci',
-                    });
-                }
-            }
-            // Anchors / symbols / commands left to dedicated checkers
-            // (existing `shrk knowledge stale-check`).
-        }
-    }
-    // Touch lookups so the param isn't unused — future expansions may reference it.
-    void lookups;
-}
-async function checkSearchTuningTargets(inspection, lookups, findings) {
-    const { listSearchTuning } = await import("./search-tuning-registry.js");
-    const entries = listSearchTuning(inspection);
-    for (const entry of entries) {
-        for (const idMap of [entry.boostIds, ...(entry.taskHints ?? []).map((h) => h.boostIds)]) {
-            if (!idMap)
-                continue;
-            for (const targetId of Object.keys(idMap)) {
-                const exists = lookups.knowledge.has(targetId) ||
-                    lookups.rules.has(targetId) ||
-                    lookups.templates.has(targetId) ||
-                    lookups.pipelines.has(targetId) ||
-                    lookups.contractTemplates.has(targetId) ||
-                    lookups.conventions.has(targetId);
-                if (!exists) {
-                    findings.push({
-                        severity: SelfConfigSeverity.Warning,
-                        code: 'search-tuning-target-missing',
-                        message: `Search tuning "${entry.id}" boosts unknown id "${targetId}".`,
-                        referencingId: entry.id,
-                        referencedId: targetId,
-                        referencedKind: 'unknown',
-                        sourceFile: entry.sourceFile,
-                    });
-                }
-            }
-        }
-    }
+/** v2's `pack-signature-stale` is v1's `pack-conflict:stale-signature`. */
+function v1Code(code) {
+    return code === 'pack-signature-stale' ? 'pack-conflict:stale-signature' : code;
 }
-async function checkAgentTestExpectations(inspection, lookups, findings) {
-    let agentTests = [];
-    try {
-        const { loadAgentContractTests } = await import("./test-runner.js");
-        agentTests = (await loadAgentContractTests(inspection));
-    }
-    catch {
-        return;
-    }
-    for (const t of agentTests) {
-        for (const id of t.expectedKnowledge ?? []) {
-            if (!lookups.knowledge.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Error,
-                    code: 'agent-test-knowledge-missing',
-                    message: `Agent test "${t.id}" expects unknown knowledge id "${id}".`,
-                    referencingId: t.id,
-                    referencedId: id,
-                    referencedKind: 'knowledge',
-                });
-            }
-        }
-        for (const id of t.expectedTemplates ?? []) {
-            if (!lookups.templates.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Error,
-                    code: 'agent-test-template-missing',
-                    message: `Agent test "${t.id}" expects unknown template id "${id}".`,
-                    referencingId: t.id,
-                    referencedId: id,
-                    referencedKind: 'template',
-                });
-            }
-        }
-    }
-}
-async function checkPackContributionConflicts(inspection, findings) {
-    const inv = buildPackContributionsInventory(inspection);
-    for (const c of inv.conflicts) {
-        findings.push({
-            severity: c.severity === 'error'
-                ? SelfConfigSeverity.Error
-                : c.severity === 'warning'
-                    ? SelfConfigSeverity.Warning
-                    : SelfConfigSeverity.Info,
-            code: `pack-conflict:${c.kind}`,
-            message: c.message,
-            referencingId: c.id,
-            referencedKind: c.contributionKind,
-            ...(c.nextCommand ? { nextCommand: c.nextCommand } : {}),
-        });
-    }
+function projectFinding(f) {
+    return {
+        severity: f.severity === 'error'
+            ? SelfConfigSeverity.Error
+            : f.severity === 'warning'
+                ? SelfConfigSeverity.Warning
+                : SelfConfigSeverity.Info,
+        code: v1Code(f.code),
+        message: f.message,
+        ...(f.file !== undefined ? { sourceFile: f.file } : {}),
+        referencingId: f.sourceId,
+        referencedId: f.targetId,
+        referencedKind: f.targetKind,
+        ...(f.nextCommand !== undefined ? { nextCommand: f.nextCommand } : {}),
+        ...(f.occurrences !== undefined ? { occurrences: f.occurrences } : {}),
+    };
 }
-/**
- * Verify template metadata cross-references resolve:
- *   - `metadata.requiredConventionIds` → conventions registry
- *   - `metadata.requiredHelperIds` → helpers registry
- *   - `metadata.registrationHintIds` → registration-hints registry
- *   - `metadata.requiredProfileIds` → profile registry
- */
-async function checkTemplateMetadataReferences(inspection, lookups, findings) {
-    const templates = (inspection.templates ?? []);
-    for (const t of templates) {
-        const m = t.metadata;
-        if (!m)
-            continue;
-        for (const id of m.requiredConventionIds ?? []) {
-            if (!lookups.conventions.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Warning,
-                    code: 'template-convention-missing',
-                    message: `Template "${t.id}" requires convention "${id}" but it is not registered.`,
-                    referencingId: t.id,
-                    referencedId: id,
-                    referencedKind: 'convention',
-                    nextCommand: `shrk conventions list --source pack`,
-                });
-            }
-        }
-        for (const id of m.requiredHelperIds ?? []) {
-            if (!lookups.helpers.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Warning,
-                    code: 'template-helper-missing',
-                    message: `Template "${t.id}" requires helper "${id}" but it is not registered.`,
-                    referencingId: t.id,
-                    referencedId: id,
-                    referencedKind: 'helper',
-                    nextCommand: `shrk helper list --source pack`,
-                });
-            }
-        }
-        for (const id of m.requiredProfileIds ?? []) {
-            if (!lookups.migrationProfiles.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Warning,
-                    code: 'template-profile-missing',
-                    message: `Template "${t.id}" requires profile "${id}" but it is not registered.`,
-                    referencingId: t.id,
-                    referencedId: id,
-                    referencedKind: 'profile',
-                    nextCommand: `shrk profiles list`,
-                });
-            }
-        }
-        for (const id of m.registrationHintIds ?? []) {
-            if (!lookups.registrationHints.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Warning,
-                    code: 'template-registration-hint-missing',
-                    message: `Template "${t.id}" references registration hint "${id}" but it is not registered.`,
-                    referencingId: t.id,
-                    referencedId: id,
-                    referencedKind: 'registration-hint',
-                    nextCommand: `shrk registrations list`,
-                });
-            }
-        }
-    }
+/** The v1 shape of a v2 report — field renames only; no check of its own. */
+export function projectSelfConfigDoctorV2ToV1(report) {
+    return {
+        schema: SELF_CONFIG_DOCTOR_SCHEMA,
+        generatedAt: report.generatedAt,
+        projectRoot: report.projectRoot,
+        findings: report.findings.map(projectFinding),
+        totals: { error: report.totals.error, warning: report.totals.warning, info: report.totals.info },
+        verdict: report.verdict,
+        nextCommands: report.nextCommands,
+        coverage: report.coverage,
+        deadUnits: report.deadUnits,
+    };
 }
 /**
- * Verify routing hint targets resolve to commands/templates/playbooks/helpers/profiles/conventions/knowledge.
+ * The v1 report: {@link projectSelfConfigDoctorV2ToV1} of THE doctor. Kept
+ * for the MCP `get_self_config_doctor` default and v1 JSON consumers.
  */
-async function checkRoutingHintTargets(inspection, lookups, findings) {
-    const entries = await listTaskRoutingHints(inspection);
-    for (const e of entries) {
-        const rec = e.hint.recommends;
-        for (const id of rec.templates ?? []) {
-            if (!lookups.templates.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Info,
-                    code: 'routing-hint-template-missing',
-                    message: `Routing hint "${e.hint.id}" recommends template "${id}" but it is not registered.`,
-                    referencingId: e.hint.id,
-                    referencedId: id,
-                    referencedKind: 'template',
-                });
-            }
-        }
-        for (const id of rec.helpers ?? []) {
-            if (!lookups.helpers.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Info,
-                    code: 'routing-hint-helper-missing',
-                    message: `Routing hint "${e.hint.id}" recommends helper "${id}" but it is not registered.`,
-                    referencingId: e.hint.id,
-                    referencedId: id,
-                    referencedKind: 'helper',
-                });
-            }
-        }
-        for (const id of rec.conventions ?? []) {
-            if (!lookups.conventions.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Info,
-                    code: 'routing-hint-convention-missing',
-                    message: `Routing hint "${e.hint.id}" recommends convention "${id}" but it is not registered.`,
-                    referencingId: e.hint.id,
-                    referencedId: id,
-                    referencedKind: 'convention',
-                });
-            }
-        }
-        for (const id of rec.profiles ?? []) {
-            if (!lookups.migrationProfiles.has(id)) {
-                findings.push({
-                    severity: SelfConfigSeverity.Info,
-                    code: 'routing-hint-profile-missing',
-                    message: `Routing hint "${e.hint.id}" recommends profile "${id}" but it is not registered.`,
-                    referencingId: e.hint.id,
-                    referencedId: id,
-                    referencedKind: 'profile',
-                });
-            }
-        }
-    }
-}
 export async function buildSelfConfigDoctorReport(inspection) {
-    const findings = [];
-    const lookups = await buildLookups(inspection);
-    await checkKnowledgeReferences(inspection, lookups, findings);
-    await checkSearchTuningTargets(inspection, lookups, findings);
-    await checkAgentTestExpectations(inspection, lookups, findings);
-    await checkPackContributionConflicts(inspection, findings);
-    // Template metadata + routing hint cross-references.
-    await checkTemplateMetadataReferences(inspection, lookups, findings);
-    await checkRoutingHintTargets(inspection, lookups, findings);
-    const totals = {
-        error: findings.filter((f) => f.severity === 'error').length,
-        warning: findings.filter((f) => f.severity === 'warning').length,
-        info: findings.filter((f) => f.severity === 'info').length,
-    };
-    const verdict = totals.error > 0 ? 'errors' : totals.warning > 0 ? 'warnings' : 'ok';
-    const nextCommands = [];
-    if (totals.error > 0) {
-        nextCommands.push('Fix the listed errors — start with the most-referenced ids first.', 'shrk packs conflicts', 'shrk knowledge stale-check --ci');
-    }
-    else if (totals.warning > 0) {
-        nextCommands.push('Review warnings — most can be resolved by adding the referenced id or removing the stale reference.');
-    }
-    return {
-        schema: SELF_CONFIG_DOCTOR_SCHEMA,
-        generatedAt: new Date().toISOString(),
-        projectRoot: inspection.projectRoot,
-        findings,
-        totals,
-        verdict,
-        nextCommands,
-    };
+    return projectSelfConfigDoctorV2ToV1(await buildSelfConfigDoctorReportV2(inspection));
 }
 export async function buildSelfConfigGraph(inspection) {
     const nodes = [];
@@ -336,7 +109,7 @@ export async function buildSelfConfigGraph(inspection) {
         nodes.push({ id, kind: 'migration-profile' });
     // Edges from knowledge → referenced ids (best-effort).
     for (const k of inspection.knowledgeEntries) {
-        for (const ref of k.references ?? []) {
+        for (const ref of knowledgeReferences(k)) {
             const refId = ref.path ?? '';
             if (!refId)
                 continue;
@@ -370,7 +143,8 @@ export function renderSelfConfigDoctorText(report) {
     lines.push(`  info          ${report.totals['info'] ?? 0}`);
     lines.push('');
     if (report.findings.length === 0) {
-        lines.push('  No cross-reference issues. ✓');
+        // No ✓: whether this is a pass is the settled verdict's call.
+        lines.push('  No findings.');
         return lines.join('\n') + '\n';
     }
     for (const f of report.findings.slice(0, 100)) {
@@ -397,7 +171,7 @@ export function renderSelfConfigDoctorMarkdown(report) {
     lines.push(`- info: ${report.totals['info'] ?? 0}`);
     lines.push('');
     if (report.findings.length === 0) {
-        lines.push('No cross-reference issues. ✓');
+        lines.push('No findings.');
         return lines.join('\n') + '\n';
     }
     lines.push('| Severity | Code | Message | Next |');

package/dist/settled-unit-states.d.ts

@@ -0,0 +1,9 @@
+import { type ISettledUnitLiveness, type IUnitStateLists } from '@shrkcrft/core';
+/**
+ * The printed unit lines (`dead` / `intendedEmpty` / `wentLive`, each THE one
+ * `formatUnitLiveness` line) of several settles at once — an asset doctor
+ * settles more than one list (scaffold globs and patterns; search-tuning keys
+ * and task hints) and its `--json` carries one `units` object (round 13).
+ */
+export declare function settledUnitStates(settles: readonly Pick<ISettledUnitLiveness, 'dead' | 'intendedEmpty' | 'wentLive'>[]): IUnitStateLists;
+//# sourceMappingURL=settled-unit-states.d.ts.map

package/dist/settled-unit-states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settled-unit-states.d.ts","sourceRoot":"","sources":["../src/settled-unit-states.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,eAAe,GAAG,UAAU,CAAC,EAAE,GACpF,eAAe,CAMjB"}

package/dist/settled-unit-states.js

@@ -0,0 +1,14 @@
+import { unitStateLists } from '@shrkcrft/core';
+/**
+ * The printed unit lines (`dead` / `intendedEmpty` / `wentLive`, each THE one
+ * `formatUnitLiveness` line) of several settles at once — an asset doctor
+ * settles more than one list (scaffold globs and patterns; search-tuning keys
+ * and task hints) and its `--json` carries one `units` object (round 13).
+ */
+export function settledUnitStates(settles) {
+    return unitStateLists({
+        dead: settles.flatMap((s) => s.dead),
+        intendedEmpty: settles.flatMap((s) => s.intendedEmpty),
+        wentLive: settles.flatMap((s) => s.wentLive),
+    });
+}

package/dist/sharkcraft-inspector.d.ts

@@ -11,6 +11,8 @@ import { BoundaryRegistry } from '@shrkcrft/boundaries';
 import { type IDoctorResult } from './doctor-result.js';
 import { type IGraphDivergence } from './code-intelligence-doctor.js';
 import { type ILoaderDiagnostic } from './loader-diagnostics.js';
+import type { IBoundaryLoadIssue } from './boundary-load-issue.model.js';
+import { type IPackAssetFreshness } from './pack-asset-freshness.js';
 /**
  * Find SharkCraft packs that live IN the repo but are not discovered (i.e.
  * not linked into node_modules). Discovery scans node_modules; an unlinked
@@ -32,6 +34,21 @@ export interface ISharkcraftInspection {
     sharkcraftDir: string | null;
     config: ISharkCraftConfig | null;
     configFile: string | null;
+    /**
+     * Set when a config file EXISTS but could not be loaded — a schema violation
+     * (e.g. an unrecognized key), an unresolved `$use`, or an import failure.
+     * `config` / `configFile` are then null and every config-declared setting
+     * and plane is dropped, so `runDoctor` reports it as an ERROR — never as
+     * "no config file".
+     */
+    configLoadError?: {
+        /** Absolute path of the config file that failed, when known. */
+        readonly file: string | null;
+        /** The loader's own message. */
+        readonly message: string;
+        /** One line per schema issue (`<path>: <message>`), or the import error. */
+        readonly issues: readonly string[];
+    };
     knowledgeEntries: IKnowledgeEntry[];
     templates: ITemplateDefinition[];
     pipelines: IPipelineDefinition[];
@@ -51,6 +68,15 @@ export interface ISharkcraftInspection {
     presetSources: ReadonlyMap<string, ISourceInfo>;
     boundaryRegistry: BoundaryRegistry;
     boundarySources: ReadonlyMap<string, ISourceInfo>;
+    /**
+     * Boundary rules / rule files that were configured but could NOT be
+     * evaluated (round 11): an invalid rule, a file that failed to load or
+     * exported no array, a `boundaryFiles` entry that does not exist. They used
+     * to be warning strings no boundary surface rendered — a fence vanished and
+     * `check boundaries` stayed green. Every boundary surface reports each one as
+     * an ERRORED rule. Optional so hand-built inspections keep type-checking.
+     */
+    boundaryLoadIssues?: readonly IBoundaryLoadIssue[];
     /** Per-loader timing + status diagnostics. */
     loaderDiagnostics: readonly ILoaderDiagnostic[];
     /** Total wall-clock ms spent in inspectSharkcraft. */
@@ -59,6 +85,14 @@ export interface ISharkcraftInspection {
     cacheEnabled: boolean;
     /** Directory where the persistent inspector cache lives. */
     cacheDir: string;
+    /**
+     * Freshness of every valid pack that serves COMPILED contributions
+     * (`.js`/`.mjs`/`.cjs`), from THE pack-asset freshness authority — content
+     * digests, never mtimes. Packs whose contributions are all TS sources are
+     * absent (nothing compiled to go stale). Optional: hand-built inspections
+     * omit it.
+     */
+    packAssetFreshness?: readonly IPackAssetFreshness[];
 }
 export interface ISourceInfo {
     type: 'local' | 'pack';

package/dist/sharkcraft-inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sharkcraft-inspector.d.ts","sourceRoot":"","sources":["../src/sharkcraft-inspector.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,KAAK,iBAAiB,EAAqB,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,KAAK,mBAAmB,EAAyB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EAAE,KAAK,mBAAmB,EAAyB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAwC,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAA6B,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE3F,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AASvC,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,GACvC,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqDjD;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,yBAAyB,EAAE,CAAC;IAC9C,KAAK,EAAE,oBAAoB,CAAC;IAC5B,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/C,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAChD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD,8CAA8C;IAC9C,iBAAiB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,sDAAsD;IACtD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,YAAY,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACrD;AAoJD,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAwZpG;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAED,wBAAgB,SAAS,CACvB,UAAU,EAAE,qBAAqB,EACjC,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CAmQf"}
+{"version":3,"file":"sharkcraft-inspector.d.ts","sourceRoot":"","sources":["../src/sharkcraft-inspector.ts"],"names":[],"mappings":"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"}