@shrkcrft/inspector 0.1.0-alpha.2

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

@@ -0,0 +1,47 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const SELF_CONFIG_DOCTOR_SCHEMA = "sharkcraft.self-config-doctor/v1";
+export declare enum SelfConfigSeverity {
+    Info = "info",
+    Warning = "warning",
+    Error = "error"
+}
+export interface ISelfConfigFinding {
+    readonly severity: SelfConfigSeverity;
+    readonly code: string;
+    readonly message: string;
+    readonly sourceFile?: string;
+    readonly referencingId?: string;
+    readonly referencedId?: string;
+    readonly referencedKind?: string;
+    readonly nextCommand?: string;
+}
+export interface ISelfConfigDoctorReport {
+    readonly schema: typeof SELF_CONFIG_DOCTOR_SCHEMA;
+    readonly generatedAt: string;
+    readonly projectRoot: string;
+    readonly findings: readonly ISelfConfigFinding[];
+    readonly totals: Readonly<Record<string, number>>;
+    readonly verdict: 'ok' | 'warnings' | 'errors';
+    readonly nextCommands: readonly string[];
+}
+export interface ISelfConfigGraphNode {
+    readonly id: string;
+    readonly kind: string;
+    readonly source?: string;
+}
+export interface ISelfConfigGraphEdge {
+    readonly from: ISelfConfigGraphNode;
+    readonly to: ISelfConfigGraphNode;
+    readonly relation: string;
+}
+export interface ISelfConfigGraph {
+    readonly schema: 'sharkcraft.self-config-graph/v1';
+    readonly nodes: readonly ISelfConfigGraphNode[];
+    readonly edges: readonly ISelfConfigGraphEdge[];
+    readonly brokenEdges: readonly ISelfConfigGraphEdge[];
+}
+export declare function buildSelfConfigDoctorReport(inspection: ISharkcraftInspection): Promise<ISelfConfigDoctorReport>;
+export declare function buildSelfConfigGraph(inspection: ISharkcraftInspection): Promise<ISelfConfigGraph>;
+export declare function renderSelfConfigDoctorText(report: ISelfConfigDoctorReport): string;
+export declare function renderSelfConfigDoctorMarkdown(report: ISelfConfigDoctorReport): string;
+//# sourceMappingURL=self-config-doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"self-config-doctor.d.ts","sourceRoot":"","sources":["../src/self-config-doctor.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,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;AAgXD,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,CAwC3B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAyBlF;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAoBtF"}

package/dist/self-config-doctor.js

@@ -0,0 +1,432 @@
+/**
+ * Self-config doctor.
+ *
+ * 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.
+ *
+ * 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 { listConventions } from "./convention-registry.js";
+import { listPluginLifecycleProfiles } from "./plugin-lifecycle-profile-registry.js";
+import { loadAllContractTemplates } from "./contract-template-registry.js";
+import { listMigrationProfilesFromPacks } from "./migration-profile-registry.js";
+import { listPackHelpers } from "./pack-helper-registry.js";
+import { listTaskRoutingHints } from "./task-routing-hint-registry.js";
+import { listRegistrationHints } from "./registration-hint-registry.js";
+export const SELF_CONFIG_DOCTOR_SCHEMA = 'sharkcraft.self-config-doctor/v1';
+export var SelfConfigSeverity;
+(function (SelfConfigSeverity) {
+    SelfConfigSeverity["Info"] = "info";
+    SelfConfigSeverity["Warning"] = "warning";
+    SelfConfigSeverity["Error"] = "error";
+})(SelfConfigSeverity || (SelfConfigSeverity = {}));
+async function buildLookups(inspection) {
+    const knowledge = new Set(inspection.knowledgeEntries.map((k) => k.id));
+    const rules = new Set((inspection.ruleService?.list?.() ?? []).map((r) => r.id));
+    const paths = new Set((inspection.pathService?.list?.() ?? []).map((p) => p.id));
+    const templates = new Set(inspection.templateRegistry?.list?.().map((t) => t.id) ?? []);
+    const pipelines = new Set(inspection.pipelineRegistry?.list?.().map((p) => p.id) ?? []);
+    // Convention/profile/contract registries return entries asynchronously.
+    const conventions = new Set((await listConventions(inspection)).map((e) => e.convention.id));
+    const lifecycleProfiles = new Set((await listPluginLifecycleProfiles(inspection)).map((e) => e.profile.id));
+    const contractTemplatesPair = await loadAllContractTemplates(inspection);
+    const contractTemplates = new Set(contractTemplatesPair.entries.map((e) => e.template.id));
+    const migrationProfiles = new Set((await listMigrationProfilesFromPacks(inspection)).map((p) => p.id));
+    const helpers = new Set((await listPackHelpers(inspection)).map((e) => e.helper.id));
+    const routingHints = new Set((await listTaskRoutingHints(inspection)).map((e) => e.hint.id));
+    const registrationHints = new Set((await listRegistrationHints(inspection)).map((e) => e.hint.id));
+    return {
+        knowledge,
+        rules,
+        paths,
+        pathConventions: new Set(), // alias of paths for cross-ref readability
+        templates,
+        pipelines,
+        policies: new Set(),
+        playbooks: new Set(),
+        constructs: new Set(),
+        scaffoldPatterns: new Set(),
+        conventions,
+        contractTemplates,
+        migrationProfiles,
+        pluginLifecycleProfiles: lifecycleProfiles,
+        helpers,
+        routingHints,
+        registrationHints,
+        commands: new Set(),
+        mcpTools: new Set(),
+        files: new Set(),
+    };
+}
+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.pluginLifecycleProfiles.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,
+                    });
+                }
+            }
+        }
+    }
+}
+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 } : {}),
+        });
+    }
+}
+/**
+ * Verify template metadata cross-references resolve:
+ *   - `metadata.requiredConventionIds` → conventions registry
+ *   - `metadata.requiredHelperIds` → helpers registry
+ *   - `metadata.registrationHintIds` → registration-hints registry
+ *   - `metadata.requiredProfileIds` → plugin-lifecycle-profiles 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.pluginLifecycleProfiles.has(id)) {
+                findings.push({
+                    severity: SelfConfigSeverity.Warning,
+                    code: 'template-profile-missing',
+                    message: `Template "${t.id}" requires plugin-lifecycle profile "${id}" but it is not registered.`,
+                    referencingId: t.id,
+                    referencedId: id,
+                    referencedKind: 'plugin-lifecycle-profile',
+                    nextCommand: `shrk plugin lifecycle profiles`,
+                });
+            }
+        }
+        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`,
+                });
+            }
+        }
+    }
+}
+/**
+ * Verify routing hint targets resolve to commands/templates/playbooks/helpers/profiles/conventions/knowledge.
+ */
+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.pluginLifecycleProfiles.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: 'plugin-lifecycle-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,
+    };
+}
+export async function buildSelfConfigGraph(inspection) {
+    const nodes = [];
+    const edges = [];
+    const brokenEdges = [];
+    const lookups = await buildLookups(inspection);
+    // Nodes: collect ids per kind
+    for (const id of lookups.knowledge)
+        nodes.push({ id, kind: 'knowledge' });
+    for (const id of lookups.rules)
+        nodes.push({ id, kind: 'rule' });
+    for (const id of lookups.templates)
+        nodes.push({ id, kind: 'template' });
+    for (const id of lookups.pipelines)
+        nodes.push({ id, kind: 'pipeline' });
+    for (const id of lookups.conventions)
+        nodes.push({ id, kind: 'convention' });
+    for (const id of lookups.contractTemplates)
+        nodes.push({ id, kind: 'contract-template' });
+    for (const id of lookups.pluginLifecycleProfiles)
+        nodes.push({ id, kind: 'plugin-lifecycle-profile' });
+    for (const id of lookups.migrationProfiles)
+        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 ?? []) {
+            const refId = ref.path ?? '';
+            if (!refId)
+                continue;
+            const from = { id: k.id, kind: 'knowledge' };
+            const to = { id: refId, kind: ref.kind ?? 'file' };
+            const edge = { from, to, relation: 'references' };
+            edges.push(edge);
+            if (ref.kind === 'file') {
+                const abs = nodePath.isAbsolute(refId)
+                    ? refId
+                    : nodePath.join(inspection.projectRoot, refId);
+                if (!existsSync(abs))
+                    brokenEdges.push(edge);
+            }
+        }
+    }
+    return {
+        schema: 'sharkcraft.self-config-graph/v1',
+        nodes,
+        edges,
+        brokenEdges,
+    };
+}
+export function renderSelfConfigDoctorText(report) {
+    const lines = [];
+    lines.push(`=== Self-config doctor ===`);
+    lines.push(`  generatedAt   ${report.generatedAt}`);
+    lines.push(`  verdict       ${report.verdict.toUpperCase()}`);
+    lines.push(`  errors        ${report.totals['error'] ?? 0}`);
+    lines.push(`  warnings      ${report.totals['warning'] ?? 0}`);
+    lines.push(`  info          ${report.totals['info'] ?? 0}`);
+    lines.push('');
+    if (report.findings.length === 0) {
+        lines.push('  No cross-reference issues. ✓');
+        return lines.join('\n') + '\n';
+    }
+    for (const f of report.findings.slice(0, 100)) {
+        lines.push(`  ${f.severity.padEnd(7)} [${f.code}] ${f.message}`);
+        if (f.nextCommand)
+            lines.push(`           next: ${f.nextCommand}`);
+    }
+    if (report.findings.length > 100) {
+        lines.push(`  … (${report.findings.length - 100} more)`);
+    }
+    if (report.nextCommands.length > 0) {
+        lines.push('\nNext:');
+        for (const c of report.nextCommands)
+            lines.push(`  • ${c}`);
+    }
+    return lines.join('\n') + '\n';
+}
+export function renderSelfConfigDoctorMarkdown(report) {
+    const lines = ['# Self-config doctor', ''];
+    lines.push(`- generatedAt: ${report.generatedAt}`);
+    lines.push(`- verdict: **${report.verdict.toUpperCase()}**`);
+    lines.push(`- errors: ${report.totals['error'] ?? 0}`);
+    lines.push(`- warnings: ${report.totals['warning'] ?? 0}`);
+    lines.push(`- info: ${report.totals['info'] ?? 0}`);
+    lines.push('');
+    if (report.findings.length === 0) {
+        lines.push('No cross-reference issues. ✓');
+        return lines.join('\n') + '\n';
+    }
+    lines.push('| Severity | Code | Message | Next |');
+    lines.push('| --- | --- | --- | --- |');
+    for (const f of report.findings) {
+        lines.push(`| ${f.severity} | \`${f.code}\` | ${f.message} | ${f.nextCommand ?? ''} |`);
+    }
+    return lines.join('\n') + '\n';
+}

package/dist/sharkcraft-inspector.d.ts

@@ -0,0 +1,73 @@
+import { type IWorkspaceSummary } from '@shrkcrft/workspace';
+import { type ISharkCraftConfig } from '@shrkcrft/config';
+import { type IKnowledgeEntry, type IKnowledgeValidationIssue, KnowledgeIndex } from '@shrkcrft/knowledge';
+import { RuleService } from '@shrkcrft/rules';
+import { PathService } from '@shrkcrft/paths';
+import { type ITemplateDefinition, TemplateRegistry } from '@shrkcrft/templates';
+import { type IPipelineDefinition, PipelineRegistry } from '@shrkcrft/pipelines';
+import { type IPackDiscoveryResult } from '@shrkcrft/packs';
+import { PresetRegistry } from '@shrkcrft/presets';
+import { BoundaryRegistry } from '@shrkcrft/boundaries';
+import { type IDoctorResult } from './doctor-result.js';
+import { type ILoaderDiagnostic } from './loader-diagnostics.js';
+export interface ISharkcraftInspection {
+    projectRoot: string;
+    workspace: IWorkspaceSummary;
+    hasSharkcraftFolder: boolean;
+    sharkcraftDir: string | null;
+    config: ISharkCraftConfig | null;
+    configFile: string | null;
+    knowledgeEntries: IKnowledgeEntry[];
+    templates: ITemplateDefinition[];
+    pipelines: IPipelineDefinition[];
+    warnings: string[];
+    sourceFiles: string[];
+    validationIssues: IKnowledgeValidationIssue[];
+    packs: IPackDiscoveryResult;
+    entrySources: ReadonlyMap<string, ISourceInfo>;
+    templateSources: ReadonlyMap<string, ISourceInfo>;
+    pipelineSources: ReadonlyMap<string, ISourceInfo>;
+    index: KnowledgeIndex;
+    ruleService: RuleService;
+    pathService: PathService;
+    templateRegistry: TemplateRegistry;
+    pipelineRegistry: PipelineRegistry;
+    presetRegistry: PresetRegistry;
+    presetSources: ReadonlyMap<string, ISourceInfo>;
+    boundaryRegistry: BoundaryRegistry;
+    boundarySources: ReadonlyMap<string, ISourceInfo>;
+    /** Per-loader timing + status diagnostics. */
+    loaderDiagnostics: readonly ILoaderDiagnostic[];
+    /** Total wall-clock ms spent in inspectSharkcraft. */
+    inspectionElapsedMs: number;
+    /** Whether the inspector cache was enabled for this run. */
+    cacheEnabled: boolean;
+    /** Directory where the persistent inspector cache lives. */
+    cacheDir: string;
+}
+export interface ISourceInfo {
+    type: 'local' | 'pack';
+    packageName?: string;
+    packageVersion?: string;
+    file?: string;
+}
+export interface InspectOptions {
+    cwd?: string;
+    /** When true, pack discovery also runs HMAC signature verification. */
+    verifyPackSignatures?: boolean;
+    /** Override for the pack signing secret used during verification. */
+    packSecret?: string;
+    /** Per-asset import timeout. Default 8000ms. */
+    loaderTimeoutMs?: number;
+    /**
+     * Enables the persistent inspector cache under
+     * `.sharkcraft/cache/inspector/v1/`. Default `false` so MCP tools
+     * stay strictly read-only — CLI commands opt in by passing `true`.
+     */
+    useCache?: boolean;
+    /** When provided, callers can observe loader diagnostics as they happen. */
+    onLoaderDiagnostic?: (d: ILoaderDiagnostic) => void;
+}
+export declare function inspectSharkcraft(options?: InspectOptions): Promise<ISharkcraftInspection>;
+export declare function runDoctor(inspection: ISharkcraftInspection): IDoctorResult;
+//# sourceMappingURL=sharkcraft-inspector.d.ts.map

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

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