@dsh-cc/command-doctor 0.5.0

package/lib/index.js

@@ -0,0 +1,71 @@
+/**
+ * Human-facing `/doctor` command: a product-grade session health report with
+ * three renderings of one data object — default text, verbose text, and a
+ * JSON file written under `$DSH_HOME`.
+ * @module @dsh-cc/command-doctor
+ */
+import { collect } from "./collect.js";
+import { formatUsage, parseDoctorFlags } from "./flags.js";
+import { doctorJsonPath, writeDoctorReport } from "./json.js";
+import { redactReport } from "./redact.js";
+import { formatDoctorReport } from "./render.js";
+export { readVersion } from "./version.js";
+export { DOCTOR_USAGE, parseDoctorFlags } from "./flags.js";
+export { redactReport } from "./redact.js";
+export { collect } from "./collect.js";
+export const name = 'command-doctor';
+export const inject = ['commands'];
+/** Execute `/doctor [flags]` against the composed context. */
+async function executeDoctor(ctx, invocation) {
+    const flags = parseDoctorFlags(invocation.rawInput);
+    if (flags.kind === 'usage') {
+        return { kind: 'success', text: formatUsage() };
+    }
+    const t0 = performance.now();
+    const collected = await collect(ctx, invocation, {
+        verbose: flags.verbose || flags.json,
+        now: () => new Date(),
+        ms: () => performance.now() - t0,
+    });
+    const report = redactReport(collected);
+    if (flags.json) {
+        return { kind: 'success', text: await emitJson(report) };
+    }
+    return { kind: 'success', text: formatDoctorReport(report, { verbose: flags.verbose }) };
+}
+/** Write the JSON file and produce the short ack text (never the JSON body). */
+async function emitJson(report) {
+    const path = doctorJsonPath();
+    const summary = `summary: ${report.summary.ok} ok, ${report.summary.warn} warn, ${report.summary.fail} fail, ${report.summary.skip} skip, ${report.summary.info} info`;
+    const ids = statusIds(report);
+    try {
+        await writeDoctorReport(path, report);
+        return [`doctor report written: ${path}`, summary, ...ids].join('\n');
+    }
+    catch (error) {
+        return [`failed to write ${path}: ${String(error)}`, summary, ...ids].join('\n');
+    }
+}
+/** The fail/warn ids appended under the JSON ack. */
+function statusIds(report) {
+    const lines = [];
+    for (const status of ['fail', 'warn']) {
+        const ids = report.checks.filter(check => check.status === status).map(check => check.id);
+        if (ids.length > 0)
+            lines.push(`${status}: ${ids.join(', ')}`);
+    }
+    return lines;
+}
+/**
+ * Register the `/doctor` command for every composed command adapter.
+ * @param ctx - context carrying the command registry.
+ */
+export function apply(ctx) {
+    ctx.commands.register({
+        name: 'doctor',
+        description: 'session health report',
+        input: { hint: '[--verbose|--json]' },
+        handler: (invocation) => executeDoctor(ctx, invocation),
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/command-doctor`.
+ * @module @dsh-cc/command-doctor/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "command-doctor-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,6BAA6B,CAAA;AAC9C,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AASpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/invariant.js

@@ -0,0 +1,23 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/command-doctor`.
+ * @module @dsh-cc/command-doctor/invariant
+ */
+const PACKAGE_NAME = '@dsh-cc/command-doctor';
+/** Cordis companion plugin name. */
+export const name = 'command-doctor-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: this command adapter owns no event stream or state projection; the doctor
+ * report is a pure read over mounted services and version metadata, and the command registry owns
+ * registration and dispatch lifecycle.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,YAAY,GAAG,wBAAwB,CAAA;AAE7C,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,0BAA0B,CAAA;AAC9C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;;GAIG;AACH,MAAM,OAAO,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB"}

package/lib/json.d.ts

@@ -0,0 +1,19 @@
+/**
+ * JSON emission: resolve the `doctor-report.json` path under `$DSH_HOME`
+ * (default `~/.dsh`) and write (mkdir + overwrite) a redacted report.
+ * @module @dsh-cc/command-doctor/json
+ */
+import type { DoctorReport } from './report.ts';
+/**
+ * Resolve the report path: `$DSH_HOME/tui/doctor-report.json`, falling back
+ * to `~/.dsh/tui/doctor-report.json` when `DSH_HOME` is unset.
+ */
+export declare function doctorJsonPath(env?: NodeJS.ProcessEnv): string;
+/**
+ * Write the report, creating parent directories and overwriting any existing
+ * file.
+ * @param path - the resolved target path.
+ * @param report - the redacted report.
+ */
+export declare function writeDoctorReport(path: string, report: DoctorReport): Promise<void>;
+//# sourceMappingURL=json.d.ts.map

package/lib/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG3E;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzF"}

package/lib/json.js

@@ -0,0 +1,27 @@
+/**
+ * JSON emission: resolve the `doctor-report.json` path under `$DSH_HOME`
+ * (default `~/.dsh`) and write (mkdir + overwrite) a redacted report.
+ * @module @dsh-cc/command-doctor/json
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Resolve the report path: `$DSH_HOME/tui/doctor-report.json`, falling back
+ * to `~/.dsh/tui/doctor-report.json` when `DSH_HOME` is unset.
+ */
+export function doctorJsonPath(env = process.env) {
+    const home = env.DSH_HOME ?? join(homedir(), '.dsh');
+    return join(home, 'tui', 'doctor-report.json');
+}
+/**
+ * Write the report, creating parent directories and overwriting any existing
+ * file.
+ * @param path - the resolved target path.
+ * @param report - the redacted report.
+ */
+export async function writeDoctorReport(path, report) {
+    await mkdir(join(path, '..'), { recursive: true });
+    await writeFile(path, `${JSON.stringify(report, null, 2)}\n`, 'utf8');
+}
+//# sourceMappingURL=json.js.map

package/lib/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAA;IACpD,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,MAAoB;IACxE,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAClD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AACvE,CAAC"}

package/lib/last-model.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Last-model fold for `/doctor`, copied from `/status` (do not import
+ * command-status): the most recent `request/header` provider/model, plus an
+ * optional duck-read `reasoningEffort`.
+ * @module @dsh-cc/command-doctor/last-model
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+/** A resolved provider route/model pair from a request header. */
+export interface ModelRef {
+    readonly provider: string;
+    readonly model: string;
+    /** Duck-read effort from the header config, when present. */
+    readonly reasoningEffort?: string;
+}
+/**
+ * Fold the session log for the most recent model route. `request/header`
+ * snapshots record the conversation's call config; the last one wins. This is
+ * *not* necessarily "the main model" — a command can run from a child agent.
+ * @param events - the session's durable event log, in sequence order.
+ * @returns the latest provider/model pair, or undefined when no header was logged.
+ */
+export declare function lastModel(events: readonly SessionEvent[]): ModelRef | undefined;
+//# sourceMappingURL=last-model.d.ts.map

package/lib/last-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"last-model.d.ts","sourceRoot":"","sources":["../src/last-model.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,QAAQ,GAAG,SAAS,CAc/E"}

package/lib/last-model.js

@@ -0,0 +1,30 @@
+/**
+ * Last-model fold for `/doctor`, copied from `/status` (do not import
+ * command-status): the most recent `request/header` provider/model, plus an
+ * optional duck-read `reasoningEffort`.
+ * @module @dsh-cc/command-doctor/last-model
+ */
+/**
+ * Fold the session log for the most recent model route. `request/header`
+ * snapshots record the conversation's call config; the last one wins. This is
+ * *not* necessarily "the main model" — a command can run from a child agent.
+ * @param events - the session's durable event log, in sequence order.
+ * @returns the latest provider/model pair, or undefined when no header was logged.
+ */
+export function lastModel(events) {
+    let result;
+    for (const event of events) {
+        if (event.type !== 'request/header')
+            continue;
+        const config = event.data.header.config;
+        result = {
+            provider: event.data.header.config.provider,
+            model: event.data.header.config.model,
+            ...(typeof config.reasoningEffort === 'string' && config.reasoningEffort.length > 0
+                ? { reasoningEffort: config.reasoningEffort }
+                : {}),
+        };
+    }
+    return result;
+}
+//# sourceMappingURL=last-model.js.map

package/lib/last-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"last-model.js","sourceRoot":"","sources":["../src/last-model.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,MAA+B;IACvD,IAAI,MAA4B,CAAA;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB;YAAE,SAAQ;QAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAuC,CAAA;QACxE,MAAM,GAAG;YACP,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ;YAC3C,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK;YACrC,GAAG,CAAC,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;gBACjF,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE;gBAC7C,CAAC,CAAC,EAAE,CAAC;SACR,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/lib/redact.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pure report redaction: whitelist evidence primitives and scrub secret-like
+ * substrings from every human string in the report. No cordis imports.
+ * @module @dsh-cc/command-doctor/redact
+ */
+import type { DoctorReport } from './report.ts';
+/**
+ * Return a redacted copy of the report. Evidence values must already be
+ * primitives; only string evidence is scrubbed. Called once by the handler;
+ * both the text render and the JSON write consume the redacted report.
+ * @param report - the collected report.
+ */
+export declare function redactReport(report: DoctorReport): DoctorReport;
+//# sourceMappingURL=redact.d.ts.map

package/lib/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAS,YAAY,EAAE,MAAM,aAAa,CAAA;AAoCtD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAW/D"}

package/lib/redact.js

@@ -0,0 +1,53 @@
+/**
+ * Pure report redaction: whitelist evidence primitives and scrub secret-like
+ * substrings from every human string in the report. No cordis imports.
+ * @module @dsh-cc/command-doctor/redact
+ */
+/** Secret-like substrings scrubbed from summary/detail/fix/evidence strings. */
+const SECRET_PATTERNS = [
+    { pattern: /sk-[A-Za-z0-9_-]+/gu, replacement: 'sk-[redacted]' },
+    { pattern: /ghp_[A-Za-z0-9]+/gu, replacement: 'ghp_[redacted]' },
+    { pattern: /xoxb-[A-Za-z0-9-]+/gu, replacement: 'xoxb-[redacted]' },
+    { pattern: /Bearer\s+\S+/gu, replacement: 'Bearer [redacted]' },
+];
+/** Scrub secret-like substrings from one string. */
+function scrub(value) {
+    let result = value;
+    for (const { pattern, replacement } of SECRET_PATTERNS) {
+        result = result.replace(pattern, replacement);
+    }
+    return result;
+}
+/** Scrub one optional human field. */
+function scrubOptional(value) {
+    return value === undefined ? undefined : scrub(value);
+}
+/** Scrub evidence string values; non-string primitives pass through untouched. */
+function scrubEvidence(evidence) {
+    if (evidence === undefined)
+        return undefined;
+    const entries = Object.entries(evidence).map(([key, value]) => [
+        key,
+        typeof value === 'string' ? scrub(value) : value,
+    ]);
+    return Object.fromEntries(entries);
+}
+/**
+ * Return a redacted copy of the report. Evidence values must already be
+ * primitives; only string evidence is scrubbed. Called once by the handler;
+ * both the text render and the JSON write consume the redacted report.
+ * @param report - the collected report.
+ */
+export function redactReport(report) {
+    return {
+        ...report,
+        checks: report.checks.map(check => ({
+            ...check,
+            summary: scrub(check.summary),
+            detail: scrubOptional(check.detail),
+            fix: scrubOptional(check.fix),
+            evidence: scrubEvidence(check.evidence),
+        })),
+    };
+}
+//# sourceMappingURL=redact.js.map

package/lib/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,gFAAgF;AAChF,MAAM,eAAe,GAAwD;IAC3E,EAAE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,eAAe,EAAE;IAChE,EAAE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,gBAAgB,EAAE;IAChE,EAAE,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,iBAAiB,EAAE;IACnE,EAAE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,mBAAmB,EAAE;CAChE,CAAA;AAED,oDAAoD;AACpD,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,KAAK,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,eAAe,EAAE,CAAC;QACvD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAC/C,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,sCAAsC;AACtC,SAAS,aAAa,CAAC,KAAyB;IAC9C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AACvD,CAAC;AAED,kFAAkF;AAClF,SAAS,aAAa,CACpB,QAA2B;IAE3B,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAC7D,GAAG;QACH,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;KACxC,CAAC,CAAA;IACX,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClC,GAAG,KAAK;YACR,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;YACnC,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC;YAC7B,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;SACxC,CAAC,CAAC;KACJ,CAAA;AACH,CAAC"}

package/lib/render.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `/doctor` text rendering: default (ok collapsed) and verbose (everything
+ * expanded) views over one redacted report. ASCII-only, no emoji.
+ * @module @dsh-cc/command-doctor/render
+ */
+import { type DoctorReport } from './report.ts';
+export interface RenderOptions {
+    /** Expand every check and print evidence. */
+    readonly verbose?: boolean;
+}
+/**
+ * Render the report as human shell text.
+ * @param report - the redacted report.
+ * @param options - `{ verbose }` switches to the expanded view.
+ */
+export declare function formatDoctorReport(report: DoctorReport, options?: RenderOptions): string;
+//# sourceMappingURL=render.d.ts.map

package/lib/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAEzE,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAyBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAmB5F"}

package/lib/render.js

@@ -0,0 +1,60 @@
+/**
+ * `/doctor` text rendering: default (ok collapsed) and verbose (everything
+ * expanded) views over one redacted report. ASCII-only, no emoji.
+ * @module @dsh-cc/command-doctor/render
+ */
+import { CHECK_GROUPS } from "./report.js";
+/** Render one status token padded to a stable column width. */
+function statusToken(status) {
+    return status.padEnd(4, ' ');
+}
+/** Render one check's evidence as a compact `k=v` list. */
+function evidenceText(check) {
+    const entries = Object.entries(check.evidence ?? {});
+    if (entries.length === 0)
+        return undefined;
+    return entries.map(([key, value]) => `${key}=${String(value)}`).join(', ');
+}
+/** Render one check, expanding per the mode. */
+function renderCheck(lines, check, verbose) {
+    const expand = verbose || check.status !== 'ok';
+    lines.push(`  ${statusToken(check.status)} ${check.id}: ${check.summary}`);
+    if (!expand)
+        return;
+    if (check.detail !== undefined)
+        lines.push(`    ${check.detail}`);
+    if (check.fix !== undefined)
+        lines.push(`    fix: ${check.fix}`);
+    const evidence = evidenceText(check);
+    if (evidence !== undefined)
+        lines.push(`    evidence: ${evidence}`);
+}
+/**
+ * Render the report as human shell text.
+ * @param report - the redacted report.
+ * @param options - `{ verbose }` switches to the expanded view.
+ */
+export function formatDoctorReport(report, options = {}) {
+    const verbose = options.verbose === true;
+    const lines = [];
+    lines.push(`dsh-cc ${report.env.dshCc}`);
+    if (report.env.harness !== undefined)
+        lines.push(`harness ${report.env.harness}`);
+    lines.push(`node ${report.env.node}`);
+    lines.push(`os ${report.env.os} ${report.env.arch}`);
+    lines.push(`cwd ${report.env.cwd}`);
+    lines.push('');
+    for (const group of CHECK_GROUPS) {
+        const groupChecks = report.checks.filter(check => check.group === group);
+        if (groupChecks.length === 0)
+            continue;
+        lines.push(`${group}:`);
+        for (const check of groupChecks)
+            renderCheck(lines, check, verbose);
+    }
+    const s = report.summary;
+    lines.push('');
+    lines.push(`summary: ${s.ok} ok, ${s.warn} warn, ${s.fail} fail, ${s.skip} skip, ${s.info} info`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=render.js.map

package/lib/render.js.map

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

package/lib/report.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Structured `/doctor` report data model: check types, report shape, and the
+ * summary counter fold. No cordis imports, so the types and fold are
+ * unit-testable in isolation.
+ * @module @dsh-cc/command-doctor/report
+ */
+/** One check's outcome severity. */
+export type CheckStatus = 'ok' | 'warn' | 'fail' | 'skip' | 'info';
+/** The stable group ordering of the report. */
+export type CheckGroup = 'env' | 'session' | 'models' | 'mcp' | 'hooks' | 'web' | 'storage' | 'git' | 'plugins' | 'seams';
+/** Stable render/JSON ordering of the check groups. */
+export declare const CHECK_GROUPS: readonly CheckGroup[];
+/** One named health observation inside the report. */
+export interface Check {
+    /** Kebab, dotted id (e.g. `models.alias.blueprint`). Adding an id is not breaking. */
+    readonly id: string;
+    /** The group the check belongs to. */
+    readonly group: CheckGroup;
+    /** The check's outcome. */
+    readonly status: CheckStatus;
+    /** One-line human summary. */
+    readonly summary: string;
+    /** Optional expanded human detail for non-ok (or verbose) rendering. */
+    readonly detail?: string | undefined;
+    /** Whitelisted primitive evidence; scrubbed by `redactReport` before render/JSON. */
+    readonly evidence?: Readonly<Record<string, string | number | boolean | null>> | undefined;
+    /** Optional suggested fix for warn/fail rows. */
+    readonly fix?: string | undefined;
+}
+/** The structured health report `/doctor` renders and writes as JSON. */
+export interface DoctorReport {
+    /** Bumps only on a breaking schema change; adding check ids is not breaking. */
+    readonly schemaVersion: 1;
+    /** ISO timestamp of report generation. */
+    readonly generatedAt: string;
+    /** Wall-clock duration of the collection, in milliseconds. */
+    readonly durationMs: number;
+    /** Environment header facts. */
+    readonly env: {
+        readonly dshCc: string;
+        readonly harness?: string;
+        readonly node: string;
+        readonly os: string;
+        readonly arch: string;
+        readonly cwd: string;
+    };
+    /** Every collected check, in group order. */
+    readonly checks: readonly Check[];
+    /** Per-status counts. */
+    readonly summary: {
+        ok: number;
+        warn: number;
+        fail: number;
+        skip: number;
+        info: number;
+    };
+}
+/** Fold the checks into per-status counts. */
+export declare function countSummary(checks: readonly Check[]): DoctorReport['summary'];
+//# sourceMappingURL=report.d.ts.map

package/lib/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAElE,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAClB,KAAK,GACL,SAAS,GACT,QAAQ,GACR,KAAK,GACL,OAAO,GACP,KAAK,GACL,SAAS,GACT,KAAK,GACL,SAAS,GACT,OAAO,CAAA;AAEX,uDAAuD;AACvD,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAE7C,CAAA;AAED,sDAAsD;AACtD,MAAM,WAAW,KAAK;IACpB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,SAAS,CAAA;IAC1F,iDAAiD;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAA;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAA;IACjC,yBAAyB;IACzB,QAAQ,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACzF;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,YAAY,CAAC,SAAS,CAAC,CAI9E"}

package/lib/report.js

@@ -0,0 +1,18 @@
+/**
+ * Structured `/doctor` report data model: check types, report shape, and the
+ * summary counter fold. No cordis imports, so the types and fold are
+ * unit-testable in isolation.
+ * @module @dsh-cc/command-doctor/report
+ */
+/** Stable render/JSON ordering of the check groups. */
+export const CHECK_GROUPS = [
+    'env', 'session', 'models', 'mcp', 'hooks', 'web', 'storage', 'git', 'plugins', 'seams',
+];
+/** Fold the checks into per-status counts. */
+export function countSummary(checks) {
+    const summary = { ok: 0, warn: 0, fail: 0, skip: 0, info: 0 };
+    for (const check of checks)
+        summary[check.status] += 1;
+    return summary;
+}
+//# sourceMappingURL=report.js.map

package/lib/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,uDAAuD;AACvD,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO;CACxF,CAAA;AA2CD,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,MAAwB;IACnD,MAAM,OAAO,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IAC7D,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACtD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/lib/version.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Version and Node engines helpers for `/doctor`. Reads this package's own
+ * manifest (mirroring `/version`) and implements the repo's single engines
+ * range without a `semver` dependency.
+ * @module @dsh-cc/command-doctor/version
+ */
+/** Fallback engines range, matching this package's `package.json`. */
+export declare const FALLBACK_ENGINES = "^22.19 || >=24";
+/**
+ * Read this package's manifest version, mirroring `apps/cli`'s self-version
+ * read: every harness package shares `0.1.0-rc.x`, so the command package's
+ * own manifest carries the harness version.
+ * @returns the version string, or `0.0.0` when the manifest is unreadable.
+ */
+export declare function readVersion(): string;
+/**
+ * Read this package's `engines.node` range (same manifest walk as
+ * `readVersion`).
+ * @returns the range string, or the known fallback when unreadable.
+ */
+export declare function readEngines(): string;
+/**
+ * Whether a Node version satisfies this repo's only engines range,
+ * `"^22.19 || >=24"`. Coarse by design: `v`-prefixed versions are accepted,
+ * `22.x` requires `minor >= 19`, anything at or above 24 passes, and 23 fails.
+ * @param version - a Node version string such as `22.19.0` or `v24.1.0`.
+ */
+export declare function nodeSatisfiesEngines(version: string): boolean;
+//# sourceMappingURL=version.d.ts.map

package/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,mBAAmB,CAAA;AAEhD;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAqBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO7D"}

package/lib/version.js

@@ -0,0 +1,62 @@
+/**
+ * Version and Node engines helpers for `/doctor`. Reads this package's own
+ * manifest (mirroring `/version`) and implements the repo's single engines
+ * range without a `semver` dependency.
+ * @module @dsh-cc/command-doctor/version
+ */
+import { readFileSync } from 'node:fs';
+/** Fallback version when the manifest is unreadable. */
+const FALLBACK_VERSION = '0.0.0';
+/** Fallback engines range, matching this package's `package.json`. */
+export const FALLBACK_ENGINES = '^22.19 || >=24';
+/**
+ * Read this package's manifest version, mirroring `apps/cli`'s self-version
+ * read: every harness package shares `0.1.0-rc.x`, so the command package's
+ * own manifest carries the harness version.
+ * @returns the version string, or `0.0.0` when the manifest is unreadable.
+ */
+export function readVersion() {
+    return readManifest().version ?? FALLBACK_VERSION;
+}
+/**
+ * Read this package's `engines.node` range (same manifest walk as
+ * `readVersion`).
+ * @returns the range string, or the known fallback when unreadable.
+ */
+export function readEngines() {
+    return readManifest().engines ?? FALLBACK_ENGINES;
+}
+/** Read the manifest fields this module cares about. */
+function readManifest() {
+    try {
+        const manifest = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+        const version = typeof manifest.version === 'string' ? manifest.version : undefined;
+        const engines = typeof manifest.engines === 'object' && manifest.engines !== null
+            ? manifest.engines
+            : undefined;
+        return {
+            version,
+            engines: typeof engines?.node === 'string' ? engines.node : undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Whether a Node version satisfies this repo's only engines range,
+ * `"^22.19 || >=24"`. Coarse by design: `v`-prefixed versions are accepted,
+ * `22.x` requires `minor >= 19`, anything at or above 24 passes, and 23 fails.
+ * @param version - a Node version string such as `22.19.0` or `v24.1.0`.
+ */
+export function nodeSatisfiesEngines(version) {
+    const parts = version.replace(/^v/u, '').split('.').map(part => Number(part));
+    const major = parts[0] ?? NaN;
+    const minor = parts[1] ?? NaN;
+    if (!Number.isFinite(major) || !Number.isFinite(minor))
+        return false;
+    if (major === 22)
+        return minor >= 19;
+    return major >= 24;
+}
+//# sourceMappingURL=version.js.map

package/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAChC,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,EAAE,CAAC,OAAO,IAAI,gBAAgB,CAAA;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,EAAE,CAAC,OAAO,IAAI,gBAAgB,CAAA;AACnD,CAAC;AAED,wDAAwD;AACxD,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CACtB,CAAA;QAC7C,MAAM,OAAO,GAAG,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;QACnF,MAAM,OAAO,GAAG,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI;YAC/E,CAAC,CAAE,QAAQ,CAAC,OAA8B;YAC1C,CAAC,CAAC,SAAS,CAAA;QACb,OAAO;YACL,OAAO;YACP,OAAO,EAAE,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;SACtE,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;IAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAA;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACpE,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,KAAK,IAAI,EAAE,CAAA;IACpC,OAAO,KAAK,IAAI,EAAE,CAAA;AACpB,CAAC"}