@dsh-cc/command-doctor 0.5.0

package/lib/checks/hooks.js

@@ -0,0 +1,138 @@
+/**
+ * `hooks` checks for `/doctor`: the hook bridge load report, flag defaults,
+ * and the verbose-only `serena-hooks` PATH probe.
+ * @module @dsh-cc/command-doctor/checks/hooks
+ */
+import { existsSync, statSync } from 'node:fs';
+import { delimiter, join } from 'node:path';
+/** Collect the hooks group checks. */
+export function hookChecks(ctx, options) {
+    const status = ctx.get('hookBridgeStatus');
+    const checks = [];
+    if (status === undefined) {
+        checks.push({
+            id: 'hooks.bridge',
+            group: 'hooks',
+            status: 'skip',
+            summary: 'hookBridgeStatus seam not mounted',
+        });
+        checks.push(discoveryCheck());
+        return checks;
+    }
+    checks.push(status.error === undefined
+        ? {
+            id: 'hooks.source',
+            group: 'hooks',
+            status: 'ok',
+            summary: status.sourcePath,
+            evidence: { sourcePath: status.sourcePath },
+        }
+        : {
+            id: 'hooks.source',
+            group: 'hooks',
+            status: 'fail',
+            summary: String(status.error),
+            detail: `no hooks are registered (${status.sourcePath})`,
+            fix: 'fix the hook configuration so it parses',
+            evidence: { sourcePath: status.sourcePath },
+        });
+    checks.push(status.events.length === 0
+        ? { id: 'hooks.events', group: 'hooks', status: 'info', summary: 'no hook events registered' }
+        : {
+            id: 'hooks.events',
+            group: 'hooks',
+            status: 'ok',
+            summary: status.events.map(event => `${event.name}: ${event.groups}/${event.hooks}`).join(', '),
+            evidence: { events: status.events.length },
+        });
+    checks.push(status.skipped.length === 0
+        ? { id: 'hooks.skipped', group: 'hooks', status: 'ok', summary: 'none' }
+        : {
+            id: 'hooks.skipped',
+            group: 'hooks',
+            status: 'warn',
+            summary: `${status.skipped.length} skipped hook entries`,
+            detail: status.skipped
+                .map(skip => `${skip.event ?? '?'}: ${skip.type ?? '?'} — ${skip.reason ?? 'malformed'}`)
+                .join('; '),
+            evidence: { skipped: status.skipped.length },
+        });
+    checks.push(status.enablePromptHooks === false && status.enableAgentHooks === false
+        ? {
+            id: 'hooks.prompt-agent',
+            group: 'hooks',
+            status: 'info',
+            summary: 'prompt/agent hooks are disabled (expected default-off)',
+        }
+        : {
+            id: 'hooks.prompt-agent',
+            group: 'hooks',
+            status: 'ok',
+            summary: `prompt hooks ${status.enablePromptHooks ? 'on' : 'off'}, agent hooks ${status.enableAgentHooks ? 'on' : 'off'}`,
+        });
+    checks.push(serenaHooksCheck(status, options.verbose));
+    checks.push(discoveryCheck());
+    return checks;
+}
+/** The always-present info note on unimplemented CC discovery semantics. */
+function discoveryCheck() {
+    return {
+        id: 'hooks.discovery',
+        group: 'hooks',
+        status: 'info',
+        summary: 'CC layered project/user discovery and live reload are not implemented',
+    };
+}
+/**
+ * `serena-hooks` availability. Default: report "not probed (use --verbose)"
+ * when referenced, skip when not referenced. Verbose: a pure-fs PATH scan
+ * (no `which`).
+ */
+function serenaHooksCheck(status, verbose) {
+    const referenced = (status.commands ?? []).some(command => command.includes('serena-hooks'));
+    if (!referenced) {
+        return { id: 'hooks.serena-hooks', group: 'hooks', status: 'skip', summary: 'not referenced' };
+    }
+    if (!verbose) {
+        return { id: 'hooks.serena-hooks', group: 'hooks', status: 'info', summary: 'not probed (use --verbose)' };
+    }
+    const found = scanPath('serena-hooks');
+    return found === undefined
+        ? {
+            id: 'hooks.serena-hooks',
+            group: 'hooks',
+            status: 'fail',
+            summary: 'serena-hooks is referenced by a loaded hook but not on PATH',
+            fix: 'install serena-hooks or extend PATH',
+        }
+        : {
+            id: 'hooks.serena-hooks',
+            group: 'hooks',
+            status: 'ok',
+            summary: `found at ${found}`,
+            evidence: { path: found },
+        };
+}
+/** Pure-fs PATH scan; appends platform executable suffixes. */
+export function scanPath(binary) {
+    const path = process.env.PATH ?? '';
+    const suffixes = process.platform === 'win32' ? ['', '.cmd', '.exe'] : [''];
+    for (const dir of path.split(delimiter)) {
+        if (dir.length === 0)
+            continue;
+        for (const suffix of suffixes) {
+            const candidate = join(dir, `${binary}${suffix}`);
+            if (existsSync(candidate)) {
+                try {
+                    if (statSync(candidate).isFile())
+                        return candidate;
+                }
+                catch {
+                    // Vanished between existsSync and stat; keep scanning.
+                }
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=hooks.js.map

package/lib/checks/hooks.js.map

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

package/lib/checks/mcp.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `mcp` checks for `/doctor`: per-connection status rows and the Serena
+ * cross-check, duck-typing the `mcpConnections` seam.
+ * @module @dsh-cc/command-doctor/checks/mcp
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Check } from '../report.ts';
+import type { GitInfo } from './git.ts';
+/** Duck-typed `mcpConnections` entry face used here. */
+export interface McpEntry {
+    readonly name: string;
+    readonly state: string;
+    readonly error?: string;
+    readonly toolCount?: number;
+    readonly eagerCount?: number;
+    readonly deferredCount?: number;
+    readonly authRequired?: boolean;
+}
+/** Collect the mcp group checks. */
+export declare function mcpChecks(ctx: Context, options?: {
+    git?: GitInfo;
+    verbose?: boolean;
+}): Check[];
+//# sourceMappingURL=mcp.d.ts.map

package/lib/checks/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/checks/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEvC,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,oCAAoC;AACpC,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,KAAK,EAAE,CAuBnG"}

package/lib/checks/mcp.js

@@ -0,0 +1,107 @@
+/**
+ * `mcp` checks for `/doctor`: per-connection status rows and the Serena
+ * cross-check, duck-typing the `mcpConnections` seam.
+ * @module @dsh-cc/command-doctor/checks/mcp
+ */
+/** Collect the mcp group checks. */
+export function mcpChecks(ctx, options = {}) {
+    const connections = ctx.get('mcpConnections');
+    if (connections?.entries === undefined) {
+        return [{
+                id: 'mcp.registry',
+                group: 'mcp',
+                status: 'skip',
+                summary: 'mcpConnections not mounted',
+            }];
+    }
+    const entries = connections.entries();
+    const checks = [{
+            id: 'mcp.overview',
+            group: 'mcp',
+            status: 'ok',
+            summary: `${entries.length} servers`,
+            evidence: { count: entries.length },
+        }];
+    for (const entry of entries)
+        checks.push(entryCheck(entry));
+    checks.push(serenaCheck(entries, options));
+    return checks;
+}
+/** Map one connection entry to its check row. */
+function entryCheck(entry) {
+    const id = `mcp.server.${entry.name}`;
+    if (entry.authRequired === true) {
+        return warn(id, `${entry.name}: authentication required`);
+    }
+    if (entry.state === 'ready') {
+        if ((entry.toolCount ?? 0) > 0) {
+            return {
+                id,
+                group: 'mcp',
+                status: 'ok',
+                summary: `${entry.name}: ready with ${entry.toolCount} tools`,
+                detail: toolBreakdown(entry),
+                evidence: { state: entry.state, toolCount: entry.toolCount ?? 0 },
+            };
+        }
+        return warn(id, `${entry.name}: ready with 0 tools`);
+    }
+    if (entry.state === 'connecting') {
+        return {
+            id,
+            group: 'mcp',
+            status: 'info',
+            summary: `${entry.name}: connecting`,
+            evidence: { state: entry.state },
+        };
+    }
+    return {
+        id,
+        group: 'mcp',
+        status: 'fail',
+        summary: `${entry.name}: ${entry.state}`,
+        detail: entry.error,
+        fix: 'check the server command/logs or run /mcp reconnect',
+        evidence: { state: entry.state },
+    };
+}
+/** Render eager/deferred breakdown when the entry exposes it. */
+function toolBreakdown(entry) {
+    if (entry.eagerCount === undefined && entry.deferredCount === undefined)
+        return undefined;
+    return `eager ${entry.eagerCount ?? 0}, deferred ${entry.deferredCount ?? 0}`;
+}
+function warn(id, summary) {
+    return { id, group: 'mcp', status: 'warn', summary };
+}
+/** The Serena-specific row: present and not ready is a fail. */
+function serenaCheck(entries, options) {
+    const serena = entries.find(entry => /serena/i.test(entry.name));
+    if (serena === undefined) {
+        return { id: 'mcp.serena', group: 'mcp', status: 'skip', summary: 'no serena server' };
+    }
+    const base = serena.state === 'ready'
+        ? {
+            id: 'mcp.serena',
+            group: 'mcp',
+            status: 'ok',
+            summary: `${serena.name}: ready`,
+            evidence: { state: serena.state },
+        }
+        : {
+            id: 'mcp.serena',
+            group: 'mcp',
+            status: 'fail',
+            summary: `${serena.name}: ${serena.state}`,
+            detail: serena.error,
+            fix: 'run /mcp reconnect or start the Serena server',
+            evidence: { state: serena.state },
+        };
+    const crossNote = options.git?.worktree === true && options.git.hasSerena === false
+        ? 'this cwd looks like a git worktree without a .serena directory; Serena project memory may resolve against the main checkout'
+        : undefined;
+    if (crossNote === undefined)
+        return base;
+    return { ...base, detail: [base.detail, crossNote].filter(part => part !== undefined).join(' — ') };
+}
+//# sourceMappingURL=mcp.js.map

package/lib/checks/mcp.js.map

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

package/lib/checks/models.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `models` checks for `/doctor`: peer-deduped alias routes, the last request,
+ * and (verbose) the LLM catalog validation.
+ * @module @dsh-cc/command-doctor/checks/models
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { CommandInvocation } from '@deepseek-ai/dsh-commands';
+import type { Check } from '../report.ts';
+/** Duck-typed alias inspection, matching `ccModelRoutes.inspect`. */
+export interface AliasInspection {
+    readonly kind: string;
+    readonly route?: {
+        provider?: string;
+        model?: string;
+        reasoningEffort?: string;
+    };
+    readonly via?: string;
+    readonly hop?: string;
+}
+/** Duck-typed ccModelRoutes face used here. */
+export interface ModelRoutesSeam {
+    inspect?(name: string): AliasInspection;
+}
+/** One advertised reasoning effort: a string id, or `{ id }` from the TUI catalog. */
+type EffortEntry = string | {
+    id?: string;
+};
+/** Duck-typed llm catalog face used here. `listModels` / `resolveModelInfo` are async in the TUI. */
+export interface LlmSeam {
+    listProviders?(): {
+        id: string;
+    }[] | Promise<{
+        id: string;
+    }[]>;
+    listModels?(provider: string): {
+        id?: string;
+        name?: string;
+    }[] | Promise<{
+        id?: string;
+        name?: string;
+    }[]>;
+    resolveModelInfo?(provider: string, model: string): {
+        reasoning?: {
+            efforts?: readonly EffortEntry[];
+        };
+    } | Promise<{
+        reasoning?: {
+            efforts?: readonly EffortEntry[];
+        };
+    } | undefined>;
+}
+/** Collect the models group checks. */
+export declare function modelChecks(ctx: Context, invocation: CommandInvocation, options: {
+    verbose: boolean;
+}): Promise<Check[]>;
+export {};
+//# sourceMappingURL=models.d.ts.map

package/lib/checks/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/checks/models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAElE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAEzC,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAA;CACxC;AAED,sFAAsF;AACtF,KAAK,WAAW,GAAG,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3C,qGAAqG;AACrG,MAAM,WAAW,OAAO;IACtB,aAAa,CAAC,IAAI;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;IAC9D,UAAU,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;IAC3G,gBAAgB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAC7C;QAAE,SAAS,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;SAAE,CAAA;KAAE,GACpD,OAAO,CAAC;QAAE,SAAS,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;SAAE,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;CAC9E;AAUD,uCAAuC;AACvC,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,KAAK,EAAE,CAAC,CA2BlB"}

package/lib/checks/models.js

@@ -0,0 +1,190 @@
+/**
+ * `models` checks for `/doctor`: peer-deduped alias routes, the last request,
+ * and (verbose) the LLM catalog validation.
+ * @module @dsh-cc/command-doctor/checks/models
+ */
+import { lastModel } from "../last-model.js";
+/** Canonical peer lanes: `lane → peer alias` (copied from LANE_PEERS). */
+const LANES = [
+    { lane: 'sketch', peer: 'haiku' },
+    { lane: 'draft', peer: 'sonnet' },
+    { lane: 'blueprint', peer: 'opus' },
+    { lane: 'masterplan', peer: 'fable' },
+];
+/** Collect the models group checks. */
+export async function modelChecks(ctx, invocation, options) {
+    const routes = ctx.get('ccModelRoutes');
+    if (routes?.inspect === undefined) {
+        return [{
+                id: 'models.routes',
+                group: 'models',
+                status: 'skip',
+                summary: 'ccModelRoutes not mounted',
+            }];
+    }
+    const inspect = routes.inspect.bind(routes);
+    const checks = [];
+    for (const { lane, peer } of LANES) {
+        checks.push(aliasCheck(inspect, peer, `${peer} (+ ${lane})`));
+    }
+    checks.push(aliasCheck(inspect, 'architect', 'architect'));
+    for (const { lane } of LANES) {
+        const laneInspection = inspect(lane);
+        if (laneInspection.via === 'configured' || laneInspection.via === 'one-hop') {
+            checks.push(aliasCheck(inspect, lane, lane));
+        }
+    }
+    checks.push(lastRequestCheck(invocation));
+    if (options.verbose) {
+        checks.push(...await catalogChecks(ctx, checks));
+    }
+    return checks;
+}
+/** One peer-deduped alias row. */
+function aliasCheck(inspect, name, label) {
+    const inspection = inspect(name);
+    const via = inspection.via === undefined ? '' : ` (via ${inspection.via})`;
+    const hop = inspection.hop === undefined ? '' : ` -> ${inspection.hop}`;
+    const provenance = `${via}${hop}`;
+    if (inspection.kind === 'inherit') {
+        return {
+            id: `models.alias.${name}`,
+            group: 'models',
+            status: 'info',
+            summary: `${label}: inherit${provenance}`,
+            detail: inspection.route === undefined ? undefined : JSON.stringify(inspection.route),
+            evidence: { via: inspection.via ?? null, hop: inspection.hop ?? null },
+        };
+    }
+    const route = inspection.route;
+    const target = route?.model === undefined
+        ? 'no route'
+        : `${route.provider ?? '?'}/${route.model}`;
+    return {
+        id: `models.alias.${name}`,
+        group: 'models',
+        status: 'ok',
+        summary: `${label}: ${target}${provenance}`,
+        detail: route?.reasoningEffort === undefined ? undefined : `effort ${route.reasoningEffort}`,
+        evidence: {
+            provider: route?.provider ?? null,
+            model: route?.model ?? null,
+            via: inspection.via ?? null,
+            hop: inspection.hop ?? null,
+        },
+    };
+}
+/** Fold the last `request/header` into `models.last-request`. */
+function lastRequestCheck(invocation) {
+    const modelRef = lastModel(invocation.agent.session.events);
+    if (modelRef === undefined) {
+        return {
+            id: 'models.last-request',
+            group: 'models',
+            status: 'skip',
+            summary: 'no request/header in this session',
+        };
+    }
+    return {
+        id: 'models.last-request',
+        group: 'models',
+        status: 'ok',
+        summary: `Last request: ${modelRef.provider}/${modelRef.model}`,
+        detail: modelRef.reasoningEffort === undefined ? undefined : `effort ${modelRef.reasoningEffort}`,
+        evidence: {
+            provider: modelRef.provider,
+            model: modelRef.model,
+            reasoningEffort: modelRef.reasoningEffort ?? null,
+        },
+    };
+}
+/** Verbose-only LLM catalog validation over the ok route rows. */
+async function catalogChecks(ctx, checks) {
+    const llm = ctx.get('llm');
+    if (llm?.listProviders === undefined) {
+        return [{
+                id: 'models.catalog',
+                group: 'models',
+                status: 'skip',
+                summary: 'llm seam not mounted',
+            }];
+    }
+    const providerIds = new Set((await Promise.resolve(llm.listProviders())).map(provider => provider.id));
+    const modelCache = new Map();
+    const effortCache = new Map();
+    const rows = checks.filter(check => check.group === 'models'
+        && check.id.startsWith('models.alias.')
+        && check.status === 'ok'
+        && typeof check.evidence?.provider === 'string'
+        && typeof check.evidence?.model === 'string');
+    const results = await Promise.all(rows.map(async (check) => {
+        const provider = check.evidence.provider;
+        const model = check.evidence.model;
+        if (!providerIds.has(provider)) {
+            return { id: catalogId(check.id), status: 'fail', message: `provider ${provider} missing from listProviders` };
+        }
+        let modelIds = modelCache.get(provider);
+        if (modelIds === undefined) {
+            try {
+                const listed = llm.listModels === undefined
+                    ? []
+                    : (await Promise.resolve(llm.listModels(provider))) ?? [];
+                modelIds = new Set(listed.map(entry => entry.id ?? entry.name ?? '').filter(id => id.length > 0));
+            }
+            catch (error) {
+                return { id: catalogId(check.id), status: 'fail', message: `listModels(${provider}) threw: ${String(error)}` };
+            }
+            modelCache.set(provider, modelIds);
+        }
+        if (modelIds.size > 0 && !modelIds.has(model)) {
+            return { id: catalogId(check.id), status: 'warn', message: `model ${model} missing from listModels(${provider}) (custom provider catalogs can be incomplete)` };
+        }
+        const cacheKey = `${provider}/${model}`;
+        if (!effortCache.has(cacheKey)) {
+            try {
+                const info = llm.resolveModelInfo === undefined
+                    ? undefined
+                    : await Promise.resolve(llm.resolveModelInfo(provider, model));
+                effortCache.set(cacheKey, effortIds(info?.reasoning?.efforts));
+            }
+            catch {
+                effortCache.set(cacheKey, undefined);
+            }
+        }
+        const efforts = effortCache.get(cacheKey);
+        if (efforts === undefined || efforts.length === 0) {
+            return { id: catalogId(check.id), status: 'skip', message: 'effort list unavailable (cannot attribute)' };
+        }
+        const routeEffort = readRouteEffort(check);
+        if (routeEffort !== undefined && !efforts.includes(routeEffort)) {
+            return { id: catalogId(check.id), status: 'warn', message: `effort ${routeEffort} not in reasoning.efforts` };
+        }
+        return { id: catalogId(check.id), status: 'ok', message: `${provider}/${model} in catalog` };
+    }));
+    return results.map(result => ({
+        id: result.id,
+        group: 'models',
+        status: result.status,
+        summary: result.message,
+    }));
+}
+/** Catalog check id: the cheap lane gets its own id; others suffix the alias row. */
+function catalogId(aliasId) {
+    return aliasId === 'models.alias.haiku' ? 'models.catalog.haiku' : `${aliasId}.catalog`;
+}
+/** Read the effort recorded on the alias row's detail, if any. */
+function readRouteEffort(check) {
+    const match = /^effort (.+)$/u.exec(check.detail ?? '');
+    return match?.[1];
+}
+/** Normalize string ids and `{ id }` effort entries into a list of ids. */
+function effortIds(efforts) {
+    if (efforts === undefined)
+        return undefined;
+    return efforts.flatMap(entry => {
+        if (typeof entry === 'string')
+            return entry.length > 0 ? [entry] : [];
+        return typeof entry.id === 'string' && entry.id.length > 0 ? [entry.id] : [];
+    });
+}
+//# sourceMappingURL=models.js.map

package/lib/checks/models.js.map

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

package/lib/checks/plugins.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `plugins` checks for `/doctor`: per-plugin component load results,
+ * duck-typing the `ccPlugins` seam (same spirit as `/plugin`).
+ * @module @dsh-cc/command-doctor/checks/plugins
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Check } from '../report.ts';
+/** Duck-typed `ccPlugins` component face used here. */
+export interface PluginComponent {
+    readonly kind: string;
+    readonly loaded: number;
+    readonly skipped: number;
+    readonly failed: number;
+    readonly reasons?: readonly string[];
+}
+/** Duck-typed `ccPlugins` entry face used here. */
+export interface PluginEntry {
+    readonly name: string;
+    readonly root: string;
+    readonly components: readonly PluginComponent[];
+}
+/** Collect the plugins group checks. */
+export declare function pluginChecks(ctx: Context): Check[];
+//# sourceMappingURL=plugins.d.ts.map

package/lib/checks/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/checks/plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAEzC,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAA;CAChD;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,EAAE,CAsBlD"}

package/lib/checks/plugins.js

@@ -0,0 +1,55 @@
+/**
+ * `plugins` checks for `/doctor`: per-plugin component load results,
+ * duck-typing the `ccPlugins` seam (same spirit as `/plugin`).
+ * @module @dsh-cc/command-doctor/checks/plugins
+ */
+/** Collect the plugins group checks. */
+export function pluginChecks(ctx) {
+    const plugins = ctx.get('ccPlugins');
+    if (plugins?.list === undefined) {
+        return [{
+                id: 'plugins.registry',
+                group: 'plugins',
+                status: 'skip',
+                summary: 'cc-shell-glue absent',
+            }];
+    }
+    const entries = plugins.list();
+    const checks = [{
+            id: 'plugins.overview',
+            group: 'plugins',
+            status: 'ok',
+            summary: `${entries.length} plugins`,
+            evidence: { count: entries.length },
+        }];
+    for (const entry of entries)
+        checks.push(entryCheck(entry));
+    return checks;
+}
+/** One plugin row: warn when any component skipped or failed. */
+function entryCheck(entry) {
+    const id = `plugins.${entry.name}`;
+    const bad = entry.components.filter(component => component.skipped > 0 || component.failed > 0);
+    if (bad.length === 0) {
+        return {
+            id,
+            group: 'plugins',
+            status: 'ok',
+            summary: `${entry.name}: all components loaded`,
+            evidence: { root: entry.root },
+        };
+    }
+    const reasons = bad.flatMap(component => component.reasons ?? []);
+    return {
+        id,
+        group: 'plugins',
+        status: 'warn',
+        summary: `${entry.name}: ${bad.length} component kind(s) with skipped/failed entries`,
+        detail: bad
+            .map(component => `${component.kind}: skipped ${component.skipped}, failed ${component.failed}`)
+            .join('; '),
+        fix: reasons.length === 0 ? undefined : `review reasons: ${reasons.join('; ')}`,
+        evidence: { root: entry.root, skipped: bad.reduce((total, c) => total + c.skipped, 0) },
+    };
+}
+//# sourceMappingURL=plugins.js.map

package/lib/checks/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../../src/checks/plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,wCAAwC;AACxC,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,CAEtB,CAAA;IACb,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC;gBACN,EAAE,EAAE,kBAAkB;gBACtB,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,sBAAsB;aAChC,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAC9B,MAAM,MAAM,GAAY,CAAC;YACvB,EAAE,EAAE,kBAAkB;YACtB,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,UAAU;YACpC,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;SACpC,CAAC,CAAA;IACF,KAAK,MAAM,KAAK,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3D,OAAO,MAAM,CAAA;AACf,CAAC;AAED,iEAAiE;AACjE,SAAS,UAAU,CAAC,KAAkB;IACpC,MAAM,EAAE,GAAG,WAAW,KAAK,CAAC,IAAI,EAAE,CAAA;IAClC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC/F,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO;YACL,EAAE;YACF,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,yBAAyB;YAC/C,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;SAC/B,CAAA;IACH,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;IACjE,OAAO;QACL,EAAE;QACF,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM,gDAAgD;QACrF,MAAM,EAAE,GAAG;aACR,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,aAAa,SAAS,CAAC,OAAO,YAAY,SAAS,CAAC,MAAM,EAAE,CAAC;aAC/F,IAAI,CAAC,IAAI,CAAC;QACb,GAAG,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC/E,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE;KACxF,CAAA;AACH,CAAC"}