@vibe-agent-toolkit/cli 0.2.0-rc.11 → 0.2.0-rc.12

package/dist/commands/doctor-render.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `vat doctor`'s human block — the one rendering, for two channels.
+ *
+ * Under `--format yaml|json` the block goes to stderr beside the document; under
+ * `--format text` it IS the stdout rendering (registered as the verb's
+ * `renderText`), so a text run prints it once. A module of its own because the
+ * published-shape registry imports the text renderer, and the registry must not
+ * import the command (the cycle `report-schemas.ts` describes).
+ */
+import type { Report } from '@vibe-agent-toolkit/schema';
+import type { DoctorCheckResult, DoctorData, DoctorOutcome } from './doctor-schema.js';
+/** How many checks landed in each outcome. Published beside the verdict, never folded into it. */
+type DoctorOutcomeCounts = Record<DoctorOutcome, number>;
+/** Tally checks by outcome. The four buckets always sum to `checks.length`. */
+export declare function countByOutcome(checks: readonly DoctorCheckResult[]): DoctorOutcomeCounts;
+/**
+ * Which checks the renderer prints.
+ *
+ * Verbose prints all of them. Concise hides only the checks with nothing to say:
+ * a clean `pass` with no suggestion, and a `skipped` check that does not apply
+ * here. `fail` and `undetermined` are ALWAYS printed — an undetermined check is
+ * the one a concise view must never swallow.
+ *
+ * Whatever this hides, {@link formatDoctorSummary} states the number of hidden
+ * checks, so the printed list and the printed counts cannot disagree.
+ */
+export declare function selectDisplayChecks(checks: readonly DoctorCheckResult[], verbose: boolean): DoctorCheckResult[];
+/**
+ * The summary block: the distribution, how many checks were not rendered, and
+ * the verdict.
+ *
+ * `displayedCount` is required precisely so the block can never claim more
+ * checks than the reader was shown without saying so.
+ */
+export declare function formatDoctorSummary(counts: DoctorOutcomeCounts, displayedCount: number): string[];
+/**
+ * The whole human block: the project context when run below the project root,
+ * the checks the view selects, then the summary.
+ *
+ * @param data - The document's data — `currentDir` says whether doctor ran below the project root
+ * @param verbose - Print every check rather than only those with something to say
+ * @returns The block, newline-terminated
+ */
+export declare function renderDoctorBlock(data: DoctorData, verbose: boolean): string;
+/**
+ * `vat doctor --format text`: the human block, with every check — the text
+ * document is the whole report, which is why no check is filtered from it — or,
+ * for a run that produced no verdict, its refusal line.
+ */
+export declare function renderDoctorText(report: Report<unknown>): string;
+export {};
+//# sourceMappingURL=doctor-render.d.ts.map

package/dist/commands/doctor-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-render.d.ts","sourceRoot":"","sources":["../../src/commands/doctor-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEvF,kGAAkG;AAClG,KAAK,mBAAmB,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AAEzD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG,mBAAmB,CAMxF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,OAAO,EAAE,OAAO,GACf,iBAAiB,EAAE,CAKrB;AASD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,mBAAmB,EAC3B,cAAc,EAAE,MAAM,GACrB,MAAM,EAAE,CA4BV;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAuB5E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAGhE"}

package/dist/commands/doctor-render.js

@@ -0,0 +1,110 @@
+/**
+ * `vat doctor`'s human block — the one rendering, for two channels.
+ *
+ * Under `--format yaml|json` the block goes to stderr beside the document; under
+ * `--format text` it IS the stdout rendering (registered as the verb's
+ * `renderText`), so a text run prints it once. A module of its own because the
+ * published-shape registry imports the text renderer, and the registry must not
+ * import the command (the cycle `report-schemas.ts` describes).
+ */
+/** Tally checks by outcome. The four buckets always sum to `checks.length`. */
+export function countByOutcome(checks) {
+    const counts = { pass: 0, fail: 0, undetermined: 0, skipped: 0 };
+    for (const check of checks) {
+        counts[check.outcome] += 1;
+    }
+    return counts;
+}
+/**
+ * Which checks the renderer prints.
+ *
+ * Verbose prints all of them. Concise hides only the checks with nothing to say:
+ * a clean `pass` with no suggestion, and a `skipped` check that does not apply
+ * here. `fail` and `undetermined` are ALWAYS printed — an undetermined check is
+ * the one a concise view must never swallow.
+ *
+ * Whatever this hides, {@link formatDoctorSummary} states the number of hidden
+ * checks, so the printed list and the printed counts cannot disagree.
+ */
+export function selectDisplayChecks(checks, verbose) {
+    if (verbose)
+        return [...checks];
+    return checks.filter(c => c.suggestion !== undefined || (c.outcome !== 'pass' && c.outcome !== 'skipped'));
+}
+const OUTCOME_ICONS = {
+    pass: '✅',
+    fail: '❌',
+    undetermined: '❓',
+    skipped: '⏭️',
+};
+/**
+ * The summary block: the distribution, how many checks were not rendered, and
+ * the verdict.
+ *
+ * `displayedCount` is required precisely so the block can never claim more
+ * checks than the reader was shown without saying so.
+ */
+export function formatDoctorSummary(counts, displayedCount) {
+    const total = counts.pass + counts.fail + counts.undetermined + counts.skipped;
+    const lines = [
+        `📊 Results: ${total} checks — ${counts.pass} passed, ${counts.fail} failed, ` +
+            `${counts.undetermined} undetermined, ${counts.skipped} skipped`,
+    ];
+    const hidden = total - displayedCount;
+    if (hidden > 0) {
+        lines.push(`   ${hidden} not shown (nothing to report) — re-run with --verbose to see every check.`);
+    }
+    lines.push('');
+    if (counts.fail > 0) {
+        lines.push(`⚠️  ${counts.fail} check(s) failed. See suggestions above to fix.`);
+    }
+    else if (counts.undetermined > 0) {
+        lines.push(`❓ Nothing failed, but ${counts.undetermined} check(s) could not be determined — ` +
+            'that is not the same as healthy.');
+    }
+    else {
+        lines.push('✨ All checks passed! Your vat setup looks healthy.');
+    }
+    return lines;
+}
+/**
+ * The whole human block: the project context when run below the project root,
+ * the checks the view selects, then the summary.
+ *
+ * @param data - The document's data — `currentDir` says whether doctor ran below the project root
+ * @param verbose - Print every check rather than only those with something to say
+ * @returns The block, newline-terminated
+ */
+export function renderDoctorBlock(data, verbose) {
+    const lines = ['🩺 vat doctor', ''];
+    const { currentDir, projectRoot, configPath } = data;
+    if (projectRoot !== null && projectRoot !== currentDir) {
+        lines.push('📍 Project Context', `   Current directory: ${currentDir}`, `   Project root:      ${projectRoot}`);
+        if (configPath !== null)
+            lines.push(`   Configuration:     ${configPath}`);
+        lines.push('');
+    }
+    lines.push('Running diagnostic checks...', '');
+    const displayed = selectDisplayChecks(data.checks, verbose);
+    for (const check of displayed) {
+        lines.push(`${OUTCOME_ICONS[check.outcome]} ${check.name}`, `   ${check.message}`);
+        if (check.suggestion !== undefined)
+            lines.push(`   💡 ${check.suggestion}`);
+        lines.push('');
+    }
+    // The summary states the distribution AND how many checks it did not print,
+    // so the count can never contradict the list above it.
+    lines.push(...formatDoctorSummary(countByOutcome(data.checks), displayed.length));
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * `vat doctor --format text`: the human block, with every check — the text
+ * document is the whole report, which is why no check is filtered from it — or,
+ * for a run that produced no verdict, its refusal line.
+ */
+export function renderDoctorText(report) {
+    if (report.status === 'error')
+        return `error: ${report.error.message} [${report.error.code}]\n`;
+    return renderDoctorBlock(report.data, true);
+}
+//# sourceMappingURL=doctor-render.js.map

package/dist/commands/doctor-render.js.map

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

package/dist/commands/doctor-schema.d.ts

@@ -0,0 +1,191 @@
+/**
+ * The document `vat doctor` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes).
+ *
+ * `examined` counts the checks run. Each check is a row of `data.checks`; a
+ * `fail` is also a `DOCTOR_CHECK_FAILED` finding (error, exit 1) and an
+ * `undetermined` one a `DOCTOR_CHECK_WARNED` finding (warning — nothing was
+ * verified, which is not health, but not a failure either). `pass` and
+ * `skipped` are rows only.
+ */
+import { z } from 'zod';
+import type { ExaminedDeclaration } from '../utils/run-integrity.js';
+/**
+ * What a check can conclude — the one list `DoctorOutcome` is derived from, so
+ * the published enum and the checks' vocabulary cannot drift apart.
+ */
+export declare const DOCTOR_OUTCOMES: readonly ["pass", "fail", "undetermined", "skipped"];
+/**
+ * What a single check concluded.
+ *
+ * Four values, because a check has four possible answers and a boolean has two.
+ * `passed: boolean` forced "I could not tell" and "it does not apply" to be
+ * spelled as `true` — the reassuring value — so a swallowed EACCES and a healthy
+ * build rendered identically, both as `✅`, and both counted toward
+ * "7/7 checks passed".
+ *
+ * - `pass`         — the check ran and the thing is fine.
+ * - `fail`         — the check ran and the thing is wrong: a `DOCTOR_CHECK_FAILED`
+ *                    finding, the only outcome that affects the exit code.
+ * - `undetermined` — the check could not reach an answer (network down, file
+ *                    unreadable). NOT a pass: nothing was verified. A
+ *                    `DOCTOR_CHECK_WARNED` finding.
+ * - `skipped`      — the check does not apply here (e.g. a VAT-source-tree-only
+ *                    check outside the source tree). Determinate, but not a pass.
+ */
+export type DoctorOutcome = (typeof DOCTOR_OUTCOMES)[number];
+/** What `examined` counts for `vat doctor`, and the remedy when it is zero. */
+export declare const DOCTOR_EXAMINED: ExaminedDeclaration;
+declare const DoctorCheckSchema: z.ZodObject<{
+    name: z.ZodString;
+    outcome: z.ZodEnum<["pass", "fail", "undetermined", "skipped"]>;
+    message: z.ZodString;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    message: string;
+    outcome: "undetermined" | "skipped" | "pass" | "fail";
+    suggestion?: string | undefined;
+}, {
+    name: string;
+    message: string;
+    outcome: "undetermined" | "skipped" | "pass" | "fail";
+    suggestion?: string | undefined;
+}>;
+declare const DoctorDataSchema: z.ZodObject<{
+    /** The working directory doctor ran from — what the checks and the project context are relative to. */
+    currentDir: z.ZodString;
+    /** The project root found from the working directory, or `null` outside any project. */
+    projectRoot: z.ZodNullable<z.ZodString>;
+    /** The `vibe-agent-toolkit.config.yaml` found from the working directory, or `null`. */
+    configPath: z.ZodNullable<z.ZodString>;
+    /** Every check that ran, in run order — the concise stderr view's filter never applies here. */
+    checks: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        outcome: z.ZodEnum<["pass", "fail", "undetermined", "skipped"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        message: string;
+        outcome: "undetermined" | "skipped" | "pass" | "fail";
+        suggestion?: string | undefined;
+    }, {
+        name: string;
+        message: string;
+        outcome: "undetermined" | "skipped" | "pass" | "fail";
+        suggestion?: string | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    configPath: string | null;
+    checks: {
+        name: string;
+        message: string;
+        outcome: "undetermined" | "skipped" | "pass" | "fail";
+        suggestion?: string | undefined;
+    }[];
+    currentDir: string;
+    projectRoot: string | null;
+}, {
+    configPath: string | null;
+    checks: {
+        name: string;
+        message: string;
+        outcome: "undetermined" | "skipped" | "pass" | "fail";
+        suggestion?: string | undefined;
+    }[];
+    currentDir: string;
+    projectRoot: string | null;
+}>;
+/** Result of a single doctor check — one row of `data.checks`. */
+export type DoctorCheckResult = z.infer<typeof DoctorCheckSchema>;
+export type DoctorData = z.infer<typeof DoctorDataSchema>;
+/** The document this command publishes. */
+export declare const DOCTOR_REPORT_SCHEMA: import("@vibe-agent-toolkit/schema").ReportZodSchema<z.ZodObject<{
+    /** The working directory doctor ran from — what the checks and the project context are relative to. */
+    currentDir: z.ZodString;
+    /** The project root found from the working directory, or `null` outside any project. */
+    projectRoot: z.ZodNullable<z.ZodString>;
+    /** The `vibe-agent-toolkit.config.yaml` found from the working directory, or `null`. */
+    configPath: z.ZodNullable<z.ZodString>;
+    /** Every check that ran, in run order — the concise stderr view's filter never applies here. */
+    checks: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        outcome: z.ZodEnum<["pass", "fail", "undetermined", "skipped"]>;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        message: string;
+        outcome: "undetermined" | "skipped" | "pass" | "fail";
+        suggestion?: string | undefined;
+    }, {
+        name: string;
+        message: string;
+        outcome: "undetermined" | "skipped" | "pass" | "fail";
+        suggestion?: string | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    configPath: string | null;
+    checks: {
+        name: string;
+        message: string;
+        outcome: "undetermined" | "skipped" | "pass" | "fail";
+        suggestion?: string | undefined;
+    }[];
+    currentDir: string;
+    projectRoot: string | null;
+}, {
+    configPath: string | null;
+    checks: {
+        name: string;
+        message: string;
+        outcome: "undetermined" | "skipped" | "pass" | "fail";
+        suggestion?: string | undefined;
+    }[];
+    currentDir: string;
+    projectRoot: string | null;
+}>, z.ZodObject<Omit<{
+    code: z.ZodString;
+    severity: z.ZodEnum<["error", "warning", "info", "ignore"]>;
+    message: z.ZodString;
+    location: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>>;
+    line: z.ZodOptional<z.ZodNumber>;
+    field: z.ZodOptional<z.ZodString>;
+    link: z.ZodOptional<z.ZodString>;
+    fix: z.ZodOptional<z.ZodString>;
+    reference: z.ZodOptional<z.ZodString>;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, "severity"> & {
+    severity: z.ZodEnum<["error", "warning", "info"]>;
+    column: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "error" | "warning" | "info";
+    fix?: string | undefined;
+    reference?: string | undefined;
+    location?: string | undefined;
+    line?: number | undefined;
+    field?: string | undefined;
+    link?: string | undefined;
+    suggestion?: string | undefined;
+    column?: number | undefined;
+}>>;
+export {};
+//# sourceMappingURL=doctor-schema.d.ts.map

package/dist/commands/doctor-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema.d.ts","sourceRoot":"","sources":["../../src/commands/doctor-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,eAAe,sDAAuD,CAAC;AAEpF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,mBAG7B,CAAC;AAEF,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;EAKZ,CAAC;AAEZ,QAAA,MAAM,gBAAgB;IACpB,uGAAuG;;IAEvG,wFAAwF;;IAExF,wFAAwF;;IAExF,gGAAgG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEvF,CAAC;AAEZ,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB;IAhB/B,uGAAuG;;IAEvG,wFAAwF;;IAExF,wFAAwF;;IAExF,gGAAgG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAUjB,CAAC"}

package/dist/commands/doctor-schema.js

@@ -0,0 +1,44 @@
+/**
+ * The document `vat doctor` publishes, apart from the command.
+ *
+ * A sibling module because the published-shape registry imports it and the
+ * command imports the writer that imports the registry (the cycle
+ * `report-schemas.ts` describes).
+ *
+ * `examined` counts the checks run. Each check is a row of `data.checks`; a
+ * `fail` is also a `DOCTOR_CHECK_FAILED` finding (error, exit 1) and an
+ * `undetermined` one a `DOCTOR_CHECK_WARNED` finding (warning — nothing was
+ * verified, which is not health, but not a failure either). `pass` and
+ * `skipped` are rows only.
+ */
+import { FindingSchema, reportSchema } from '@vibe-agent-toolkit/schema';
+import { z } from 'zod';
+/**
+ * What a check can conclude — the one list `DoctorOutcome` is derived from, so
+ * the published enum and the checks' vocabulary cannot drift apart.
+ */
+export const DOCTOR_OUTCOMES = ['pass', 'fail', 'undetermined', 'skipped'];
+/** What `examined` counts for `vat doctor`, and the remedy when it is zero. */
+export const DOCTOR_EXAMINED = {
+    unit: 'checks',
+    whenZero: 'Doctor ran no check at all, which is a defect in VAT — report it with the output of vat doctor --debug.',
+};
+const DoctorCheckSchema = z.object({
+    name: z.string(),
+    outcome: z.enum(DOCTOR_OUTCOMES),
+    message: z.string(),
+    suggestion: z.string().optional(),
+}).strict();
+const DoctorDataSchema = z.object({
+    /** The working directory doctor ran from — what the checks and the project context are relative to. */
+    currentDir: z.string(),
+    /** The project root found from the working directory, or `null` outside any project. */
+    projectRoot: z.string().nullable(),
+    /** The `vibe-agent-toolkit.config.yaml` found from the working directory, or `null`. */
+    configPath: z.string().nullable(),
+    /** Every check that ran, in run order — the concise stderr view's filter never applies here. */
+    checks: z.array(DoctorCheckSchema),
+}).strict();
+/** The document this command publishes. */
+export const DOCTOR_REPORT_SCHEMA = reportSchema(DoctorDataSchema, FindingSchema);
+//# sourceMappingURL=doctor-schema.js.map

package/dist/commands/doctor-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-schema.js","sourceRoot":"","sources":["../../src/commands/doctor-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,CAAU,CAAC;AAsBpF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAwB;IAClD,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,yGAAyG;CACpH,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,uGAAuG;IACvG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,wFAAwF;IACxF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,wFAAwF;IACxF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,gGAAgG;IAChG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;CACnC,CAAC,CAAC,MAAM,EAAE,CAAC;AAOZ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -6,45 +6,9 @@
  * - Configuration validation
  * - Version checks
  */
-import type { Command } from 'commander';
-/**
- * What a single check concluded.
- *
- * Four values, because a check has four possible answers and a boolean has two.
- * `passed: boolean` forced "I could not tell" and "it does not apply" to be
- * spelled as `true` — the reassuring value — so a swallowed EACCES and a healthy
- * build rendered identically, both as `✅`, and both counted toward
- * "7/7 checks passed".
- *
- * - `pass`         — the check ran and the thing is fine.
- * - `fail`         — the check ran and the thing is wrong. The only outcome that
- *                    affects the exit code.
- * - `undetermined` — the check could not reach an answer (network down, file
- *                    unreadable). NOT a pass: nothing was verified.
- * - `skipped`      — the check does not apply here (e.g. a VAT-source-tree-only
- *                    check outside the source tree). Determinate, but not a pass.
- */
-export type DoctorOutcome = 'pass' | 'fail' | 'undetermined' | 'skipped';
-/**
- * Result of a single doctor check
- */
-export interface DoctorCheckResult {
-    /** Name of the check */
-    name: string;
-    /** What the check concluded */
-    outcome: DoctorOutcome;
-    /** Message describing the result */
-    message: string;
-    /** Optional suggestion for fixing the issue */
-    suggestion?: string;
-}
-/** How many checks landed in each outcome. Published beside the verdict, never folded into it. */
-export interface DoctorOutcomeCounts {
-    pass: number;
-    fail: number;
-    undetermined: number;
-    skipped: number;
-}
+import { type FindingsReport, type OkReport } from '@vibe-agent-toolkit/schema';
+import { type Command } from 'commander';
+import type { DoctorCheckResult, DoctorData } from './doctor-schema.js';
 /**
  * Project context information
  */
@@ -66,10 +30,6 @@ export interface ProjectContext {
 export interface DoctorResult {
     /** Every check that ran, unfiltered */
     checks: DoctorCheckResult[];
-    /** Total number of checks run (always `checks.length`) */
-    totalChecks: number;
-    /** Distribution across outcomes; sums to `totalChecks` */
-    outcomeCounts: DoctorOutcomeCounts;
     /** Project context information */
     projectContext: ProjectContext;
 }
@@ -178,28 +138,13 @@ export declare function checkCliBuildSync(projectRoot: string | null): DoctorChe
  * @returns Doctor result
  */
 export declare function runDoctor(options?: DoctorOptions): Promise<DoctorResult>;
-/** Tally checks by outcome. The four buckets always sum to `checks.length`. */
-export declare function countByOutcome(checks: readonly DoctorCheckResult[]): DoctorOutcomeCounts;
-/**
- * Which checks the renderer prints.
- *
- * Verbose prints all of them. Concise hides only the checks with nothing to say:
- * a clean `pass` with no suggestion, and a `skipped` check that does not apply
- * here. `fail` and `undetermined` are ALWAYS printed — an undetermined check is
- * the one a concise view must never swallow.
- *
- * Whatever this hides, {@link formatDoctorSummary} states the number of hidden
- * checks, so the printed list and the printed counts cannot disagree.
- */
-export declare function selectDisplayChecks(checks: readonly DoctorCheckResult[], verbose: boolean): DoctorCheckResult[];
 /**
- * The summary block: the distribution, how many checks were not rendered, and
- * the verdict.
+ * The document a doctor run publishes: every check a row, every failed or
+ * undetermined one a finding, `examined` the checks run.
  *
- * `displayedCount` is required precisely so the block can never claim more
- * checks than the reader was shown without saying so.
+ * @param result - What {@link runDoctor} returned
  */
-export declare function formatDoctorSummary(counts: DoctorOutcomeCounts, displayedCount: number): string[];
+export declare function doctorReport(result: DoctorResult): OkReport<DoctorData> | FindingsReport<DoctorData>;
 /**
  * Main command handler for Commander.js
  */

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAA2B,KAAK,cAAc,EAAa,KAAK,QAAQ,EAAwB,MAAM,4BAA4B,CAAC;AAkB1I,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAWjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oDAAoD;IACpD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,kCAAkC;IAClC,cAAc,EAAE,cAAc,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAuED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CA8DpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CA2BrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAmCtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CA2BnD;AAyED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAkEpD;AAgBD;;GAEG;AACH,wBAAsB,eAAe,CACnC,cAAc,GAAE,cAAsC,GACrD,OAAO,CAAC,iBAAiB,CAAC,CAkD5B;AA6DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAiCtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAkD/E;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6BlF;AAoBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CASpG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoEpD"}