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

package/dist/contributions-report.js

@@ -0,0 +1,242 @@
+/**
+ * THE contributions report (round 12, ONE-CHANGE) — `shrk packs contributions`'
+ * `By file:` section and MCP `get_pack_contributions`' `report`.
+ *
+ * "Did what I wrote take effect?" has three columns per contributed file:
+ * entries ACCEPTED (the inventory's structural entries — every loader-backed
+ * kind is structural since 12.1e), entries REJECTED with every reason (THE
+ * rejection channel, carried by the inventory), and references that could not
+ * be checked because their kind's registry is empty or undeclarable (the
+ * self-config doctor's own reference probes, `collectUnresolvableReferences`).
+ * Nothing here resolves or loads anything itself.
+ */
+import { existsSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { CONTRIBUTION_FILE_KEYS } from '@shrkcrft/plugin-api';
+import { ContributionKind } from "./contribution-kind.js";
+import { contributionFileLabel, contributionKindOfLoader, formatEntryRejection } from "./contribution-load-failures.js";
+import { buildPackContributionsInventoryAsync, contributionKindForSlot, } from "./pack-contributions-inventory.js";
+import { collectUnresolvableReferences } from "./self-config-doctor-v2.js";
+/** A reference-declaring asset kind → the contribution kind its file is, for a file no other evidence named. */
+const SOURCE_KIND = {
+    'registration-hint': ContributionKind.RegistrationHint,
+    'routing-hint': ContributionKind.TaskRoutingHint,
+    convention: ContributionKind.Convention,
+    template: ContributionKind.Template,
+    knowledge: ContributionKind.Knowledge,
+    rule: ContributionKind.Rule,
+    'path-convention': ContributionKind.Path,
+    construct: ContributionKind.Construct,
+    'boundary-rule': ContributionKind.Boundary,
+    // Round 13: the scan covers search-tuning boost keys, as `search tuning doctor` does.
+    'search-tuning': ContributionKind.SearchTuning,
+};
+/** A load failure's loader `kind` → its contribution kind, through THE table (`contributionKindOfLoader`). */
+function asKind(kind, fallback) {
+    return contributionKindOfLoader(kind) ?? fallback;
+}
+/**
+ * The report from an already-built inventory and reference scan — the pure
+ * half; {@link buildContributionsReport} gathers both.
+ */
+export function contributionsReportOf(inspection, inventory, references) {
+    const rows = new Map();
+    const rel = (abs) => contributionFileLabel(inspection.projectRoot, abs);
+    const posix = (file) => file.split(nodePath.sep).join('/');
+    const rowFor = (file, kind, packageName) => {
+        const key = posix(file);
+        let row = rows.get(key);
+        if (!row) {
+            row = {
+                file: key,
+                kind,
+                ...(packageName ? { packageName } : {}),
+                status: 'loaded',
+                acceptedIds: new Set(),
+                rejected: [],
+                unresolvable: new Map(),
+            };
+            rows.set(key, row);
+        }
+        if (!row.packageName && packageName)
+            row.packageName = packageName;
+        return row;
+    };
+    // 1) Every file a pack manifest declares (a missing one is a `missing` row).
+    for (const pack of inspection.packs.validPacks ?? []) {
+        const contributions = (pack.manifest?.contributions ?? {});
+        for (const slot of CONTRIBUTION_FILE_KEYS) {
+            const kind = contributionKindForSlot(slot);
+            if (!kind)
+                continue;
+            for (const r of contributions[slot] ?? []) {
+                const abs = nodePath.resolve(pack.packageRoot, r);
+                const row = rowFor(rel(abs), kind, pack.packageName);
+                if (!existsSync(abs))
+                    row.status = 'missing';
+            }
+        }
+    }
+    // 2) Accepted entries (structural) — and every file the inventory saw.
+    for (const e of inventory.entries) {
+        if (!e.sourceFile)
+            continue;
+        const row = rowFor(e.sourceFile, e.kind, e.packageName);
+        if (e.extractionMode === 'structural')
+            row.acceptedIds.add(e.id);
+    }
+    // 3) Rejected entries — THE rejection channel.
+    for (const r of inventory.rejections) {
+        rowFor(r.file, r.kind, r.packageName).rejected.push({
+            index: r.index,
+            ...(r.exportName ? { exportName: r.exportName } : {}),
+            ...(r.entryId !== undefined ? { entryId: r.entryId } : {}),
+            reasons: r.reasons,
+            cause: r.cause,
+        });
+    }
+    // 4) Files that failed to load.
+    for (const f of inventory.loadFailures) {
+        const row = rowFor(f.file, asKind(f.kind, ContributionKind.Knowledge), f.packageName);
+        row.status = 'failed';
+        row.loadError = f.message;
+    }
+    // 5) References that could not be checked, grouped per (source, field, kind, reason).
+    let unattributed = 0;
+    for (const u of references.references) {
+        if (!u.file) {
+            unattributed += 1;
+            continue;
+        }
+        const row = rowFor(rel(u.file), SOURCE_KIND[u.sourceKind] ?? ContributionKind.Knowledge, u.packageName);
+        const key = `${u.sourceId}|${u.field}|${u.kind}|${u.reason}`;
+        const g = row.unresolvable.get(key) ?? { sourceId: u.sourceId, field: u.field, kind: u.kind, ids: [], reason: u.reason };
+        g.ids.push(u.id);
+        row.unresolvable.set(key, g);
+    }
+    const files = [...rows.values()]
+        .map((r) => {
+        const accepted = r.acceptedIds.size;
+        return {
+            file: r.file,
+            kind: r.kind,
+            ...(r.packageName ? { packageName: r.packageName } : {}),
+            source: r.packageName ? 'pack' : 'local',
+            status: r.status,
+            declared: accepted + r.rejected.length,
+            accepted,
+            acceptedIds: [...r.acceptedIds].sort(),
+            rejected: [...r.rejected].sort((a, b) => a.index - b.index),
+            ...(r.loadError !== undefined ? { loadError: r.loadError } : {}),
+            unresolvableReferences: [...r.unresolvable.values()].map((g) => ({ ...g, ids: [...g.ids] })),
+        };
+    })
+        .sort((a, b) => a.file.localeCompare(b.file) || a.kind.localeCompare(b.kind));
+    return summarise(files, references.expected, unattributed);
+}
+/** Totals + THE reference coverage over `files` (`probed` = every reference probed in view). */
+function summarise(files, probed, unattributed) {
+    const unresolvable = files.reduce((n, f) => n + f.unresolvableReferences.reduce((m, g) => m + g.ids.length, 0), 0) + unattributed;
+    const labels = files.flatMap((f) => f.unresolvableReferences.flatMap((g) => g.ids.map((id) => `${f.file}: ${g.sourceId} ${g.field} → ${g.kind} ${id}`)));
+    const referenceCoverage = probed > 0
+        ? {
+            subject: 'contributed references',
+            unit: 'references',
+            expected: probed,
+            examined: Math.max(0, probed - unresolvable),
+            ...(unresolvable > 0 ? { unexamined: labels.slice(0, 20), unexaminedTotal: unresolvable } : {}),
+            reason: "could not be checked — their kind's registry is empty in this workspace, or nothing can declare it",
+        }
+        : undefined;
+    return {
+        files,
+        totals: {
+            files: files.length,
+            declared: files.reduce((n, f) => n + f.declared, 0),
+            accepted: files.reduce((n, f) => n + f.accepted, 0),
+            rejected: files.reduce((n, f) => n + f.rejected.length, 0),
+            loadFailed: files.filter((f) => f.status === 'failed').length,
+            missing: files.filter((f) => f.status === 'missing').length,
+            unresolvable,
+        },
+        ...(referenceCoverage ? { referenceCoverage } : {}),
+    };
+}
+/**
+ * The report narrowed to `--pack` / `--kind`. A narrowed view settles on the
+ * references IN VIEW: its coverage is the view's unresolvable references
+ * (examined 0 of them), so a filter can never borrow another file's pass.
+ */
+export function filterContributionsReport(report, filter) {
+    if (!filter.pack && !filter.kind)
+        return report;
+    const files = report.files.filter((f) => (!filter.pack || f.packageName === filter.pack) && (!filter.kind || f.kind === filter.kind));
+    const inView = files.reduce((n, f) => n + f.unresolvableReferences.reduce((m, g) => m + g.ids.length, 0), 0);
+    return summarise(files, inView, 0);
+}
+/** Every contributed file, accepted vs rejected vs unresolvable. */
+export async function buildContributionsReport(inspection, options = {}) {
+    const inventory = options.inventory ?? (await buildPackContributionsInventoryAsync(inspection));
+    const references = options.references ?? (await collectUnresolvableReferences(inspection));
+    return contributionsReportOf(inspection, inventory, references);
+}
+function fileMark(f) {
+    if (f.status !== 'loaded' || f.rejected.length > 0)
+        return '✗';
+    return f.unresolvableReferences.length > 0 ? '~' : '✓';
+}
+function fileSummary(f) {
+    if (f.status === 'failed')
+        return `FAILED TO LOAD — ${f.loadError ?? 'import error'}`;
+    if (f.status === 'missing')
+        return 'MISSING on disk — nothing in it takes effect';
+    const parts = [`${f.declared} declared`, `${f.accepted} accepted`];
+    if (f.rejected.length > 0)
+        parts.push(`${f.rejected.length} rejected`);
+    const u = f.unresolvableReferences.reduce((n, g) => n + g.ids.length, 0);
+    if (u > 0)
+        parts.push(`${u} unresolvable reference(s)`);
+    return parts.join(' · ');
+}
+/** The `By file:` text section (after `By kind:`). */
+export function renderContributionsByFileText(report) {
+    const lines = [];
+    const t = report.totals;
+    lines.push(`By file (${t.files}): ${t.declared} declared · ${t.accepted} accepted · ${t.rejected} rejected${t.loadFailed > 0 ? ` · ${t.loadFailed} failed to load` : ''}${t.missing > 0 ? ` · ${t.missing} missing` : ''}${t.unresolvable > 0 ? ` · ${t.unresolvable} unresolvable reference(s)` : ''}`);
+    for (const f of report.files) {
+        lines.push(`  ${fileMark(f)} ${f.file}  ${f.kind}${f.packageName ? ` [${f.packageName}]` : ''}  ${fileSummary(f)}`);
+        for (const r of f.rejected)
+            lines.push(`      rejected      ${formatEntryRejection(r)}`);
+        for (const g of f.unresolvableReferences) {
+            lines.push(`      unresolvable  ${g.sourceId} ${g.field} → ${g.kind} ${g.ids.map((id) => `'${id}'`).join(', ')} — ${g.reason === 'undeclarable-kind' ? 'no registry can ever hold this kind' : "this kind's registry is empty here"}`);
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+/** The `## By file` markdown section. */
+export function renderContributionsByFileMarkdown(report) {
+    const lines = ['## By file', ''];
+    if (report.files.length === 0) {
+        lines.push('None.');
+        return lines.join('\n') + '\n';
+    }
+    lines.push('| File | Kind | Pack | Status | Declared | Accepted | Rejected | Unresolvable |');
+    lines.push('| --- | --- | --- | --- | --- | --- | --- | --- |');
+    for (const f of report.files) {
+        const u = f.unresolvableReferences.reduce((n, g) => n + g.ids.length, 0);
+        lines.push(`| \`${f.file}\` | ${f.kind} | ${f.packageName ?? ''} | ${f.status} | ${f.declared} | ${f.accepted} | ${f.rejected.length} | ${u} |`);
+    }
+    const detail = report.files.filter((f) => f.rejected.length > 0 || f.unresolvableReferences.length > 0);
+    if (detail.length > 0) {
+        lines.push('');
+        for (const f of detail) {
+            lines.push(`- \`${f.file}\``);
+            for (const r of f.rejected)
+                lines.push(`  - rejected: ${formatEntryRejection(r)}`);
+            for (const g of f.unresolvableReferences) {
+                lines.push(`  - unresolvable: ${g.sourceId} ${g.field} → ${g.kind} ${g.ids.join(', ')} (${g.reason})`);
+            }
+        }
+    }
+    return lines.join('\n') + '\n';
+}

package/dist/convention-registry.d.ts

@@ -1,5 +1,6 @@
 import { type IConvention } from '@shrkcrft/plugin-api';
 import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import { type IRejectedEntry } from '@shrkcrft/core';
 export declare const CONVENTION_REGISTRY_SCHEMA = "sharkcraft.convention-registry/v1";
 export declare enum ConventionSource {
     Local = "local",
@@ -19,9 +20,30 @@ export interface IConventionDoctorIssue {
     readonly conventionId?: string;
     readonly source?: string;
 }
+/** The convention FILES a load discovered, and the ones it could not read — the doctor's coverage. */
+export interface IConventionFileScan {
+    /** Every convention file the load tried (local defaults, `conventionFiles`, pack `conventionFiles`). */
+    readonly discovered: number;
+    /** Discovered but never read (missing, or failed to import) — `file — reason`, project-relative. */
+    readonly unread: readonly string[];
+}
+/**
+ * THE convention acceptance predicate (round 12, 12.1): every error of
+ * `validateConvention`, `<field>: <message>` — `[]` means accepted. The
+ * loader and `packs test --load` refuse exactly the same entries.
+ */
+export declare function conventionRejectionReasons(raw: unknown): readonly string[];
 export declare function loadConventions(inspection: ISharkcraftInspection): Promise<{
     entries: readonly IConventionEntry[];
     issues: readonly IConventionDoctorIssue[];
+    files: IConventionFileScan;
+    /**
+     * Every declared convention the loader refused (round 12, 12.1) — invalid
+     * or a duplicate id — with its position and every reason. The `issues`
+     * above still carry the per-field `invalid-convention` lines `conventions
+     * doctor` prints; this is the record THE rejection channel lifts.
+     */
+    rejected: readonly IRejectedEntry[];
 }>;
 export declare function listConventions(inspection: ISharkcraftInspection): Promise<readonly IConventionEntry[]>;
 export declare function findConvention(inspection: ISharkcraftInspection, id: string): Promise<IConventionEntry | null>;

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

@@ -1 +1 @@
-{"version":3,"file":"convention-registry.d.ts","sourceRoot":"","sources":["../src/convention-registry.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAE9E,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4BD,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAAE,CAAC,CAoF9F;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAGtC;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGlC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAG5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,gCAAgC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAC9C;AAiBD,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAqCjC"}
+{"version":3,"file":"convention-registry.d.ts","sourceRoot":"","sources":["../src/convention-registry.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAE9E,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,sGAAsG;AACtG,MAAM,WAAW,mBAAmB;IAClC,wGAAwG;IACxG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oGAAoG;IACpG,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAMD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAK1E;AAyBD,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IACT,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC1C,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CACrC,CAAC,CA0HD;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAGtC;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,qBAAqB,EACjC,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGlC;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAG5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,gCAAgC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAC9C;AAiBD,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAqCjC"}

package/dist/convention-registry.js

@@ -6,7 +6,7 @@
 import { existsSync } from 'node:fs';
 import * as nodePath from 'node:path';
 import { validateConvention, } from '@shrkcrft/plugin-api';
-import { importModuleViaLoader } from '@shrkcrft/core';
+import { importModuleViaLoader, readContributionExport, RejectionCause, } from '@shrkcrft/core';
 export const CONVENTION_REGISTRY_SCHEMA = 'sharkcraft.convention-registry/v1';
 export var ConventionSource;
 (function (ConventionSource) {
@@ -14,15 +14,26 @@ export var ConventionSource;
     ConventionSource["Pack"] = "pack";
     ConventionSource["Fixture"] = "fixture";
 })(ConventionSource || (ConventionSource = {}));
-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.conventions))
-        return mod.conventions;
-    return [];
+async function importConventions(file) {
+    return readContributionExport(await importModuleViaLoader(file), { namedKeys: ['conventions'] });
+}
+/**
+ * THE convention acceptance predicate (round 12, 12.1): every error of
+ * `validateConvention`, `<field>: <message>` — `[]` means accepted. The
+ * loader and `packs test --load` refuse exactly the same entries.
+ */
+export function conventionRejectionReasons(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return ['(entry): must be an object'];
+    const v = validateConvention(raw);
+    if (v.valid)
+        return [];
+    return v.issues.length > 0 ? v.issues.map((i) => `${i.field}: ${i.message}`) : ['(entry): failed validation'];
+}
+/** A declared entry's string `id`, when it has one. */
+function entryIdOf(raw) {
+    const id = raw && typeof raw === 'object' ? raw.id : undefined;
+    return typeof id === 'string' ? id : undefined;
 }
 function localFiles(inspection) {
     const out = [];
@@ -34,56 +45,84 @@ function localFiles(inspection) {
         if (existsSync(abs))
             out.push(abs);
     }
-    const cfg = inspection.config;
-    for (const rel of cfg?.conventionFiles ?? []) {
+    // `conventionFiles` is a declared config key (typed, schema-validated).
+    for (const rel of inspection.config?.conventionFiles ?? []) {
         out.push(nodePath.isAbsolute(rel) ? rel : nodePath.join(dir, rel));
     }
-    return out;
+    // One scan per DISTINCT file: `conventionFiles: ['conventions.ts']` names the
+    // default file again, and loading it twice listed every doctor issue twice.
+    return [...new Set(out.map((f) => nodePath.resolve(f)))];
 }
 export async function loadConventions(inspection) {
     const entries = [];
     const issues = [];
-    const seen = new Set();
-    const ingest = (raw, source, packageName, sourceFile) => {
-        const v = validateConvention(raw);
-        if (!v.valid) {
-            for (const i of v.issues) {
+    const rejected = [];
+    const seen = new Map();
+    let discovered = 0;
+    const unread = [];
+    const rel = (file) => nodePath.relative(inspection.projectRoot, file) || file;
+    const ingest = (raw, source, packageName, sourceFile, at) => {
+        const id = entryIdOf(raw);
+        // Shape warnings never drop the convention; they are said out loud.
+        if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+            for (const w of validateConvention(raw).warnings) {
                 issues.push({
-                    severity: 'error',
-                    code: 'invalid-convention',
-                    message: `${i.field}: ${i.message}`,
-                    conventionId: typeof raw.id === 'string' ? raw.id : undefined,
+                    severity: 'warning',
+                    code: 'convention-shape',
+                    message: `${w.field}: ${w.message}`,
+                    conventionId: id,
                     source: sourceFile,
                 });
             }
+        }
+        const reasons = conventionRejectionReasons(raw);
+        if (reasons.length > 0) {
+            for (const r of reasons) {
+                issues.push({ severity: 'error', code: 'invalid-convention', message: r, conventionId: id, source: sourceFile });
+            }
+            rejected.push({ ...at, ...(id !== undefined ? { entryId: id } : {}), reasons, cause: RejectionCause.Invalid });
             return;
         }
-        if (seen.has(raw.id)) {
+        const conv = raw;
+        const prev = seen.get(conv.id);
+        if (prev !== undefined) {
             issues.push({
                 severity: 'error',
                 code: 'duplicate-id',
-                message: `Convention "${raw.id}" already loaded; skipping ${sourceFile}.`,
-                conventionId: raw.id,
+                message: `Convention "${conv.id}" already loaded; skipping ${sourceFile}.`,
+                conventionId: conv.id,
                 source: sourceFile,
             });
+            rejected.push({
+                ...at,
+                entryId: conv.id,
+                reasons: [`id: "${conv.id}" is already declared in ${prev}`],
+                cause: RejectionCause.DuplicateId,
+            });
             return;
         }
-        seen.add(raw.id);
+        seen.set(conv.id, sourceFile);
         entries.push({
-            convention: raw,
+            convention: conv,
             source,
             ...(packageName ? { packageName } : {}),
             sourceFile,
         });
     };
+    const ingestAll = (exp, file, source, packageName, sourceFile) => {
+        exp.items.forEach((c, i) => ingest(c, source, packageName, sourceFile, {
+            file,
+            index: exp.single ? -1 : i,
+            ...(exp.exportName ? { exportName: exp.exportName } : {}),
+        }));
+    };
     for (const file of localFiles(inspection)) {
+        discovered += 1;
         try {
-            const list = await importDefault(file);
-            const rel = nodePath.relative(inspection.projectRoot, file) || file;
-            for (const c of list)
-                ingest(c, ConventionSource.Local, undefined, rel);
+            ingestAll(await importConventions(file), file, ConventionSource.Local, undefined, rel(file));
         }
         catch (e) {
+            unread.push(`${rel(file)} — failed to load`);
             issues.push({
                 severity: 'warning',
                 code: 'load-failed',
@@ -94,33 +133,34 @@ export async function loadConventions(inspection) {
     }
     for (const pack of inspection.packs.validPacks ?? []) {
         const contributions = (pack.manifest?.contributions ?? {});
-        for (const rel of contributions.conventionFiles ?? []) {
-            const file = nodePath.resolve(pack.packageRoot, rel);
+        for (const packRel of contributions.conventionFiles ?? []) {
+            discovered += 1;
+            const file = nodePath.resolve(pack.packageRoot, packRel);
             if (!existsSync(file)) {
+                unread.push(`${rel(file)} — missing (declared by ${pack.packageName})`);
                 issues.push({
                     severity: 'warning',
                     code: 'missing-file',
-                    message: `Pack ${pack.packageName} declares ${rel} but file is missing.`,
+                    message: `Pack ${pack.packageName} declares ${packRel} but file is missing.`,
                     source: file,
                 });
                 continue;
             }
             try {
-                const list = await importDefault(file);
-                for (const c of list)
-                    ingest(c, ConventionSource.Pack, pack.packageName, rel);
+                ingestAll(await importConventions(file), file, ConventionSource.Pack, pack.packageName, packRel);
             }
             catch (e) {
+                unread.push(`${rel(file)} — failed to load (${pack.packageName})`);
                 issues.push({
                     severity: 'warning',
                     code: 'load-failed',
-                    message: `Pack ${pack.packageName} (${rel}): ${e.message}`,
+                    message: `Pack ${pack.packageName} (${packRel}): ${e.message}`,
                     source: file,
                 });
             }
         }
     }
-    return { entries, issues };
+    return { entries, issues, files: { discovered, unread }, rejected };
 }
 export async function listConventions(inspection) {
     const { entries } = await loadConventions(inspection);

package/dist/coverage-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coverage-report.d.ts","sourceRoot":"","sources":["../src/coverage-report.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAOD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,eAAe,CA2NtF"}
+{"version":3,"file":"coverage-report.d.ts","sourceRoot":"","sources":["../src/coverage-report.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAOD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,eAAe,CA0NtF"}

package/dist/coverage-report.js

@@ -1,6 +1,7 @@
 import { hasActionHints, hasMeaningfulActionHints, KNOWLEDGE_TYPES_NO_ACTION, } from '@shrkcrft/knowledge';
 import { resolvePreset, resolvePresetReferences } from '@shrkcrft/presets';
 import { inspectionReferenceLookup } from "./reference-lookup.js";
+import { referenceIdExists } from "./reference-registry.js";
 function pct(covered, total) {
     if (total === 0)
         return 100;
@@ -72,8 +73,6 @@ export function buildCoverageReport(inspection) {
         });
         const actionable = eligible.filter((e) => e.noAction !== true && !KNOWLEDGE_TYPES_NO_ACTION.has(e.type));
         const total = actionable.length;
-        const knowledgeIds = new Set(inspection.knowledgeEntries.map((x) => x.id));
-        const templateIds = new Set(inspection.templates.map((t) => t.id));
         const missing = [];
         let covered = 0;
         for (const e of actionable) {
@@ -83,10 +82,11 @@ export function buildCoverageReport(inspection) {
             }
             // Reward RESOLVED cross-references: a hint whose related ids actually
             // point at real entries/templates is substantive even without a command.
+            // Resolved through THE reference registry, not private id sets.
             const a = e.actionHints;
             const resolvedXref = !!a &&
-                ((a.relatedKnowledge?.some((id) => knowledgeIds.has(id)) ?? false) ||
-                    (a.relatedTemplates?.some((id) => templateIds.has(id)) ?? false));
+                ((a.relatedKnowledge?.some((id) => referenceIdExists(inspection, 'knowledge', id)) ?? false) ||
+                    (a.relatedTemplates?.some((id) => referenceIdExists(inspection, 'template', id)) ?? false));
             if (resolvedXref) {
                 covered += 1;
                 continue;
@@ -119,8 +119,8 @@ export function buildCoverageReport(inspection) {
                 missing.push(`${p.id} — no step references`);
                 continue;
             }
-            const allResolve = refs.every((id) => inspection.templates.some((t) => t.id === id) ||
-                inspection.knowledgeEntries.some((e) => e.id === id));
+            const allResolve = refs.every((id) => referenceIdExists(inspection, 'template', id) ||
+                referenceIdExists(inspection, 'knowledge', id));
             if (allResolve)
                 covered += 1;
             else

package/dist/custom-checks.d.ts

@@ -1,4 +1,5 @@
 import { type IKnowledgeEntry } from '@shrkcrft/knowledge';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
 export declare const CUSTOM_CHECK_REPORT_SCHEMA = "sharkcraft.custom-check/v1";
 export declare const CUSTOM_CHECKS_REGISTRY_SCHEMA = "sharkcraft.custom-checks-registry/v1";
 export declare enum CustomCheckScope {
@@ -70,6 +71,19 @@ export interface ICustomCheckRegistryEntry {
     /** Validation findings about the descriptor itself. */
     warnings: readonly string[];
 }
+/** A `metadata.checks` declaration the registry found but does not register — it can never run. */
+export interface ICustomCheckIgnoredDeclaration {
+    /** The entry that declared it. */
+    entryId: string;
+    /** Its knowledge `type` (`'rule'` only for a Markdown rule whose metadata the loader dropped). */
+    entryType: string;
+    /** The declaring file, project-relative when the root is known. */
+    source?: string;
+    /** Why it is not registered, and what to do instead. */
+    reason: string;
+    /** The check ids it declared, when readable — `checks run <id>` names where they went. */
+    checkIds: readonly string[];
+}
 export interface ICustomCheckRegistry {
     schema: typeof CUSTOM_CHECKS_REGISTRY_SCHEMA;
     generatedAt: string;
@@ -78,25 +92,70 @@ export interface ICustomCheckRegistry {
         id: string;
         ruleIds: readonly string[];
     }[];
+    /** Declared on a rule, but unusable (no id, no command, a non-array `metadata.checks`). */
     invalid: readonly {
         ruleId: string;
         reason: string;
+        source?: string;
+        checkId?: string;
     }[];
+    /** Declared where the registry does not read (a non-rule entry, a Markdown rule). */
+    ignored: readonly ICustomCheckIgnoredDeclaration[];
+    /** `type: 'rule'` entries scanned — via {@link isRuleEntry}, the set `shrk rules list` shows. */
+    scannedRules: number;
+}
+/** The inspection-free inputs of {@link buildCustomChecksRegistry}. */
+export interface IBuildCustomChecksOptions {
+    /** Makes each declaration's `source` project-relative. */
+    readonly projectRoot?: string;
 }
 /** Read the descriptors a rule declares under `metadata.checks`. */
 export declare function readDescriptorsFromRule(rule: IKnowledgeEntry): readonly ICustomCheckDescriptor[];
-export declare function buildCustomChecksRegistry(entries: readonly IKnowledgeEntry[]): ICustomCheckRegistry;
+export declare function buildCustomChecksRegistry(entries: readonly IKnowledgeEntry[], options?: IBuildCustomChecksOptions): ICustomCheckRegistry;
+/**
+ * Every declaration the registry saw: registered + invalid + ignored (an
+ * ignored entry whose ids are unreadable still counts as one). The `expected`
+ * of the doctor's coverage — 0 means nothing was declared at all.
+ */
+export declare function declaredCustomCheckCount(registry: ICustomCheckRegistry): number;
+/** Where `metadata.checks[]` is read from — what the empty state names instead of "add it to a rule". */
+export interface ICustomCheckScanSurface {
+    /** Project-relative TypeScript files (that exist — what the loader reads) whose `type: 'rule'` entries are scanned. */
+    readonly files: readonly {
+        readonly file: string;
+        readonly via: string;
+    }[];
+    /** Existing Markdown files listed as knowledge / rule sources — their entries cannot carry metadata. */
+    readonly markdownFiles: readonly string[];
+    /** `type: 'rule'` entries that came from Markdown. */
+    readonly markdownRules: number;
+}
+/**
+ * The concrete surface the custom-checks registry scans: local `ruleFiles` /
+ * `knowledgeFiles` / `docsFiles` and every valid pack's `ruleFiles` /
+ * `knowledgeFiles` — split into TypeScript (scanned) and Markdown (cannot
+ * carry metadata).
+ */
+export declare function customCheckScanSurface(inspection: ISharkcraftInspection): ICustomCheckScanSurface;
 export interface ICustomCheckDoctorReport {
     schema: 'sharkcraft.custom-checks-doctor/v1';
     generatedAt: string;
     totalChecks: number;
     warnings: number;
     errors: number;
+    /** Declarations seen (registered + invalid + ignored) — 0 means nothing was declared. */
+    declaredChecks: number;
+    /** Declarations that can never run because the registry does not read them. */
+    ignored: number;
+    /** `type: 'rule'` entries scanned. */
+    scannedRules: number;
     details: readonly {
         ruleId: string;
         checkId: string;
         severity: 'error' | 'warning' | 'info';
         message: string;
+        /** The declaring file, when known. */
+        source?: string;
     }[];
 }
 export declare function doctorCustomChecks(registry: ICustomCheckRegistry): ICustomCheckDoctorReport;

package/dist/custom-checks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-checks.d.ts","sourceRoot":"","sources":["../src/custom-checks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"custom-checks.d.ts","sourceRoot":"","sources":["../src/custom-checks.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,KAAK,eAAe,EAA8B,MAAM,qBAAqB,CAAC;AAEvF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,6BAA6B,yCAAyC,CAAC;AAEpF,oBAAY,gBAAgB;IAC1B,WAAW,iBAAiB;IAC5B,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED,oBAAY,eAAe;IACzB,WAAW,iBAAiB;IAC5B,QAAQ,cAAc;IACtB,SAAS,eAAe;IACxB,aAAa,mBAAmB;IAChC,YAAY,kBAAkB;CAC/B;AAED,oBAAY,iBAAiB;IAC3B,QAAQ,cAAc;IACtB,YAAY,kBAAkB;IAC9B,aAAa,mBAAmB;CACjC;AAED,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,QAAQ,cAAc;CACvB;AAED,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,0BAA0B;IAC1B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,0BAA0B,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,sBAAsB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,mGAAmG;AACnG,MAAM,WAAW,8BAA8B;IAC7C,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,kGAAkG;IAClG,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,6BAA6B,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC9C,UAAU,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IAClE,2FAA2F;IAC3F,OAAO,EAAE,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1F,qFAAqF;IACrF,OAAO,EAAE,SAAS,8BAA8B,EAAE,CAAC;IACnD,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAKD,oEAAoE;AACpE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,sBAAsB,EAAE,CAKhG;AAwCD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,GAAE,yBAA8B,GACtC,oBAAoB,CAmFtB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAM/E;AAED,yGAAyG;AACzG,MAAM,WAAW,uBAAuB;IACtC,uHAAuH;IACvH,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3E,wGAAwG;IACxG,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,sDAAsD;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,qBAAqB,GAAG,uBAAuB,CA2BjG;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,oCAAoC,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,cAAc,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,SAAS;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QACvC,OAAO,EAAE,MAAM,CAAC;QAChB,sCAAsC;QACtC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;CACL;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,oBAAoB,GAC7B,wBAAwB,CAkD1B;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAM1E;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgE1E;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gCAAgC,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,sBAAsB,EAClC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAiCvB"}