scoutline 0.1.0 → 0.2.0

package/dist/command-invocation.js

@@ -0,0 +1,95 @@
+/**
+ * Command Invocation Seam (DESIGN.md §2).
+ *
+ * This Module defines the pure invocation contract that separates
+ * command behaviour from process effects. `invokeCommand` owns
+ * invocation-local presentation, notice storage, and error conversion.
+ * The Node Adapter is the only Module that touches process streams,
+ * TTY state, and `process.exitCode`.
+ *
+ * Requirements: NFR-002, NFR-003, NFR-007.
+ */
+import { formatSuccessOutput, formatErrorOutput } from "./lib/output.js";
+import { getErrorExitCode } from "./lib/errors.js";
+import { redactSecrets, configuredSecrets } from "./lib/redact.js";
+const TEXT_OUTPUT_MODES = ["compact", "markdown", "refs", "tty"];
+function isTextOutputMode(mode) {
+    return TEXT_OUTPUT_MODES.includes(mode);
+}
+/**
+ * Select the final output string for a successful CommandResult.
+ *
+ * - `TextCommandResult`: the text is used verbatim regardless of mode.
+ * - `DataCommandResult` in a text-oriented mode: a command-supplied
+ *   presentation override is preferred; otherwise the base data is
+ *   formatted through `formatSuccessOutput`.
+ * - `DataCommandResult` in a data-oriented mode: base data formatted
+ *   through `formatSuccessOutput` (data → raw JSON, json/pretty →
+ *   success envelope).
+ */
+function selectOutput(result, outputMode, now) {
+    if (result.kind === "text") {
+        return result.text;
+    }
+    if (isTextOutputMode(outputMode)) {
+        const override = result.presentations?.[outputMode];
+        if (typeof override === "string") {
+            return override;
+        }
+    }
+    return formatSuccessOutput(result.data, outputMode, now);
+}
+/**
+ * Run command behaviour through the invocation seam.
+ *
+ * 1. Create invocation-local context and notice storage.
+ * 2. Run command behaviour through `runQuietly`.
+ * 3. `runQuietly` restores dependency logging before returning.
+ * 4. Flush notices to stderr in encounter order.
+ * 5. Select a presentation override or the base data.
+ * 6. Write one final successful value to stdout.
+ * 7. Convert a thrown error into one structured stderr value.
+ * 8. Return an exit status without terminating the process.
+ *
+ * The trailing newline is appended at the Node Adapter boundary, not
+ * here, so `invokeCommand` itself is process-effect-free.
+ */
+export async function invokeCommand(adapter, behavior, outputMode, now = Date.now, secrets) {
+    const notices = [];
+    const context = {
+        stdinIsTTY: adapter.stdinIsTTY,
+        readStdin: () => adapter.readStdin(),
+        notice: (message) => {
+            notices.push(message);
+        },
+    };
+    let result;
+    try {
+        result = await adapter.runQuietly(() => behavior(context));
+    }
+    catch (error) {
+        for (const notice of notices) {
+            adapter.writeStderr(notice);
+        }
+        // Recursively redact the thrown value at the outward boundary so any
+        // credential-shaped field embedded in the error tree — whether in
+        // `message`, `cause`, or any custom field — is replaced with the
+        // redaction marker before formatting. `formatErrorOutput` then
+        // performs an additional string-level pass on the message/help
+        // fields it actually serialises.
+        //
+        // B3: secrets resolved from an injected env (MainDependencies.env)
+        // are honoured here so a credential that exists only in the injected
+        // env is redacted even when absent from ambient process.env.
+        const resolvedSecrets = secrets ?? configuredSecrets();
+        const redactedError = redactSecrets(error, resolvedSecrets);
+        adapter.writeStderr(formatErrorOutput(redactedError, outputMode, resolvedSecrets));
+        return getErrorExitCode(error);
+    }
+    for (const notice of notices) {
+        adapter.writeStderr(notice);
+    }
+    adapter.writeStdout(selectOutput(result, outputMode, now));
+    return result.exitCode ?? 0;
+}
+//# sourceMappingURL=command-invocation.js.map

package/dist/command-invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-invocation.js","sourceRoot":"","sources":["../src/command-invocation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAsCnE,MAAM,iBAAiB,GAA8B,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAE5F,SAAS,gBAAgB,CAAC,IAAgB;IACxC,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,YAAY,CAAC,MAAqB,EAAE,UAAsB,EAAE,GAAiB;IACpF,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAiC,EACjC,QAA6D,EAC7D,UAAsB,EACtB,GAAG,GAAiB,IAAI,CAAC,GAAG,EAC5B,OAAkB;IAElB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAmB;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE;QACpC,MAAM,EAAE,CAAC,OAAe,EAAE,EAAE;YAC1B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;IAEF,IAAI,MAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,qEAAqE;QACrE,kEAAkE;QAClE,iEAAiE;QACjE,+DAA+D;QAC/D,+DAA+D;QAC/D,iCAAiC;QACjC,EAAE;QACF,mEAAmE;QACnE,qEAAqE;QACrE,6DAA6D;QAC7D,MAAM,eAAe,GAAG,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACvD,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,EAAE,eAAe,CAAY,CAAC;QACvE,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,aAAa,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;QACnF,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAE3D,OAAO,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/commands/code.d.ts

@@ -1,13 +1,20 @@
 /**
  * Code Mode commands for tool chaining
+ *
+ * P1-07: each command returns a CommandResult instead of writing
+ * directly to stdout/stderr. stdin is read through CommandContext rather
+ * than the process stream. No Provider selection is added; Phase 0
+ * Code Mode semantics (run, eval, logs, timeout, interfaces, prompt
+ * template) are preserved.
  */
+import type { CommandContext, CommandResult } from "../command-invocation.js";
 export interface CodeRunOptions {
     timeout?: number;
     includeLogs?: boolean;
 }
-export declare function runCodeFile(filePath: string, options?: CodeRunOptions): Promise<void>;
-export declare function evalCode(code: string, options?: CodeRunOptions): Promise<void>;
-export declare function printInterfaces(): Promise<void>;
-export declare function printPromptTemplate(): void;
+export declare function runCodeFile(filePath: string, options?: CodeRunOptions, context?: CommandContext): Promise<CommandResult>;
+export declare function evalCode(code: string, options?: CodeRunOptions, context?: CommandContext): Promise<CommandResult>;
+export declare function printInterfaces(context?: CommandContext): Promise<CommandResult>;
+export declare function printPromptTemplate(context?: CommandContext): CommandResult;
 export declare const CODE_HELP: string;
 //# sourceMappingURL=code.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB/F;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxF;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrD;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAGD,eAAO,MAAM,SAAS,QAkBd,CAAC"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAWxB;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CASxB;AAED,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAE3E;AAGD,eAAO,MAAM,SAAS,QAkBd,CAAC"}

package/dist/commands/code.js

@@ -1,75 +1,49 @@
 /**
  * Code Mode commands for tool chaining
+ *
+ * P1-07: each command returns a CommandResult instead of writing
+ * directly to stdout/stderr. stdin is read through CommandContext rather
+ * than the process stream. No Provider selection is added; Phase 0
+ * Code Mode semantics (run, eval, logs, timeout, interfaces, prompt
+ * template) are preserved.
  */
 import * as fs from "node:fs/promises";
 import { ZaiCodeModeClient } from "../lib/code-mode.js";
-import { outputSuccess } from "../lib/output.js";
-import { formatErrorOutput } from "../lib/errors.js";
-import { silenceConsole, restoreConsole } from "../lib/silence.js";
-export async function runCodeFile(filePath, options = {}) {
+export async function runCodeFile(filePath, options = {}, context) {
     const code = await fs.readFile(filePath, "utf8");
-    silenceConsole();
     const codeClient = new ZaiCodeModeClient();
     try {
         const result = await codeClient.callToolChain(code, options.timeout);
-        if (options.includeLogs) {
-            outputSuccess(result);
-        }
-        else {
-            outputSuccess(result.result);
-        }
-    }
-    catch (error) {
-        restoreConsole();
-        console.error(formatErrorOutput(error));
-        process.exit(1);
+        const data = options.includeLogs ? result : result.result;
+        return { kind: "data", data };
     }
     finally {
         await codeClient.close().catch(() => { });
-        restoreConsole();
     }
 }
-export async function evalCode(code, options = {}) {
-    silenceConsole();
+export async function evalCode(code, options = {}, context) {
     const codeClient = new ZaiCodeModeClient();
     try {
         const result = await codeClient.callToolChain(code, options.timeout);
-        if (options.includeLogs) {
-            outputSuccess(result);
-        }
-        else {
-            outputSuccess(result.result);
-        }
-    }
-    catch (error) {
-        restoreConsole();
-        console.error(formatErrorOutput(error));
-        process.exit(1);
+        const data = options.includeLogs ? result : result.result;
+        return { kind: "data", data };
     }
     finally {
         await codeClient.close().catch(() => { });
-        restoreConsole();
     }
 }
-export async function printInterfaces() {
-    silenceConsole();
+export async function printInterfaces(context) {
     const codeClient = new ZaiCodeModeClient();
     try {
         const interfaces = await codeClient.getAllInterfaces();
-        outputSuccess(interfaces);
-    }
-    catch (error) {
-        restoreConsole();
-        console.error(formatErrorOutput(error));
-        process.exit(1);
+        return { kind: "data", data: interfaces };
     }
     finally {
         await codeClient.close().catch(() => { });
-        restoreConsole();
     }
 }
-export function printPromptTemplate() {
-    outputSuccess(ZaiCodeModeClient.getPromptTemplate());
+export function printPromptTemplate(context) {
+    return { kind: "data", data: ZaiCodeModeClient.getPromptTemplate() };
 }
 // Help text
 export const CODE_HELP = `

package/dist/commands/code.js.map

@@ -1 +1 @@
-{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"code.js","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQxD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,OAAO,GAAmB,EAAE,EAC5B,OAAwB;IAExB,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,OAAO,GAAmB,EAAE,EAC5B,OAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAwB;IAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,EAAE,CAAC;AACvE,CAAC;AAED,YAAY;AACZ,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;CAkBxB,CAAC,IAAI,EAAE,CAAC"}

package/dist/commands/doctor.d.ts

@@ -1,10 +1,65 @@
 /**
- * Doctor command for environment and MCP diagnostics
+ * Doctor command — Provider-aware diagnostics (P4-04, DESIGN.md §14).
+ *
+ * The command is presentation-only: it receives a report builder through
+ * injected dependencies and wraps the resulting {@link DiagnosticsReport}
+ * as base data with a computed exit code. Provider resolution, capability
+ * probing, settled collection, and failure redaction live in
+ * {@link buildDiagnosticsReport} so the command never imports a Provider
+ * transport (ZaiMcpClient, monitor client, or environment credential
+ * reads) directly.
+ *
+ * Exit semantics (DESIGN.md §14):
+ *   - Missing effective Provider credentials -> exit 1.
+ *   - Any configured probe error -> exit 1 (successful entries preserved).
+ *   - All configured probes succeed, or only tools-disabled skips -> exit 0.
+ *
+ * Under `--no-tools` the command returns after metadata + configured-state
+ * evaluation and constructs no Adapter and no transport (FR-034).
  */
+import type { CommandResult } from "../command-invocation.js";
+import type { DiagnosticsReport } from "../capabilities/diagnostics.js";
+import type { ProviderDescriptor, ProviderId } from "../providers/types.js";
+export interface DoctorDiagnosticsDependencies {
+    readonly noTools: boolean;
+    readonly effectiveProvider: ProviderId;
+    readonly descriptors: readonly ProviderDescriptor[];
+    readonly env: NodeJS.ProcessEnv;
+    readonly sleep: (ms: number) => Promise<void>;
+    readonly random: () => number;
+}
+/**
+ * Build a schema-version-1 {@link DiagnosticsReport}. Report metadata is
+ * built from static descriptors without constructing any Adapter. Under
+ * `--no-tools` the command returns after metadata + configured-state
+ * evaluation. Otherwise each configured Provider is probed through
+ * shared execution with settled collection, preserving registry order
+ * and normalized redacted failures.
+ */
+export declare function buildDiagnosticsReport(deps: DoctorDiagnosticsDependencies): Promise<DiagnosticsReport>;
+/**
+ * Compute the doctor exit code from a finalized report. Exit 1 when the
+ * effective Provider is unconfigured or any configured probe errored;
+ * otherwise exit 0. A tools-disabled or not-configured skip on a
+ * non-effective Provider never fails the report.
+ */
+export declare function doctorExitCode(report: DiagnosticsReport): number;
 export interface DoctorOptions {
     noTools?: boolean;
-    enableVision?: boolean;
 }
-export declare function doctor(options?: DoctorOptions): Promise<void>;
+/**
+ * Injectable dependencies for the doctor command. `buildReport` resolves
+ * the diagnostics report; the command only wraps it for presentation and
+ * exit-code selection.
+ */
+export interface DoctorCommandDependencies {
+    readonly buildReport: () => Promise<DiagnosticsReport>;
+}
+/**
+ * Run the doctor command. Returns the diagnostics report as base data
+ * with a computed exit code (1 when the effective Provider is
+ * unconfigured or any configured probe failed; otherwise 0).
+ */
+export declare function doctor(deps: DoctorCommandDependencies): Promise<CommandResult<DiagnosticsReport>>;
 export declare const DOCTOR_HELP: string;
 //# sourceMappingURL=doctor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAOD,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvE;AAED,eAAO,MAAM,WAAW,QAYhB,CAAC"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AASxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAsB,MAAM,uBAAuB,CAAC;AAMhG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;CAC/B;AA6CD;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA4B5B;AA4CD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAKhE;AAMD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAC1B,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAO3C;AAED,eAAO,MAAM,WAAW,QAqChB,CAAC"}

package/dist/commands/doctor.js

@@ -1,70 +1,172 @@
 /**
- * Doctor command for environment and MCP diagnostics
+ * Doctor command — Provider-aware diagnostics (P4-04, DESIGN.md §14).
+ *
+ * The command is presentation-only: it receives a report builder through
+ * injected dependencies and wraps the resulting {@link DiagnosticsReport}
+ * as base data with a computed exit code. Provider resolution, capability
+ * probing, settled collection, and failure redaction live in
+ * {@link buildDiagnosticsReport} so the command never imports a Provider
+ * transport (ZaiMcpClient, monitor client, or environment credential
+ * reads) directly.
+ *
+ * Exit semantics (DESIGN.md §14):
+ *   - Missing effective Provider credentials -> exit 1.
+ *   - Any configured probe error -> exit 1 (successful entries preserved).
+ *   - All configured probes succeed, or only tools-disabled skips -> exit 0.
+ *
+ * Under `--no-tools` the command returns after metadata + configured-state
+ * evaluation and constructs no Adapter and no transport (FR-034).
  */
-import { ZaiMcpClient } from "../lib/mcp-client.js";
-import { outputSuccess } from "../lib/output.js";
-import { formatErrorOutput } from "../lib/errors.js";
-import { silenceConsole, restoreConsole } from "../lib/silence.js";
-function getNodeMajor() {
+import { SHARED_CAPABILITIES, ZAI_ONLY_CAPABILITIES, diagnosticErrorFromError, } from "../capabilities/diagnostics.js";
+import { executeProviderOperation } from "../lib/execution.js";
+import { UnsupportedCapabilityError } from "../lib/errors.js";
+import { redactSecrets, configuredSecrets } from "../lib/redact.js";
+function nodeMajor() {
     const [major] = process.versions.node.split(".");
     return parseInt(major, 10);
 }
-export async function doctor(options = {}) {
-    const apiKey = process.env.Z_AI_API_KEY || process.env.ZAI_API_KEY;
-    const mode = (process.env.Z_AI_MODE || process.env.PLATFORM_MODE || "ZAI").toUpperCase();
-    const nodeMajor = getNodeMajor();
-    const report = {
-        env: {
-            apiKeyPresent: Boolean(apiKey),
-            mode,
-            baseUrl: process.env.Z_AI_BASE_URL || undefined,
-        },
+/**
+ * Probe one Provider's connectivity through shared execution. The Adapter
+ * transport performs a single attempt (Z.AI tool discovery or MiniMax raw
+ * quota probe); the retry policy lives in
+ * `executeProviderOperation("diagnostics", ...)`.
+ */
+async function probeProvider(descriptor, env, sleep, random) {
+    const adapter = descriptor.create({ env });
+    const capability = adapter.diagnostics;
+    if (!capability) {
+        throw new UnsupportedCapabilityError(descriptor.id, "diagnostics");
+    }
+    return executeProviderOperation("diagnostics", () => capability.invoke({ probe: true }), {
+        sleep,
+        random,
+    });
+}
+/**
+ * Build a schema-version-1 {@link DiagnosticsReport}. Report metadata is
+ * built from static descriptors without constructing any Adapter. Under
+ * `--no-tools` the command returns after metadata + configured-state
+ * evaluation. Otherwise each configured Provider is probed through
+ * shared execution with settled collection, preserving registry order
+ * and normalized redacted failures.
+ */
+export async function buildDiagnosticsReport(deps) {
+    const secrets = configuredSecrets(deps.env);
+    const baseEntries = deps.descriptors.map((descriptor) => ({
+        provider: descriptor.id,
+        configured: descriptor.isConfigured(deps.env),
+        capabilities: [...descriptor.capabilities()],
+    }));
+    const providers = deps.noTools
+        ? baseEntries.map((entry) => ({
+            ...entry,
+            status: "skipped",
+            reason: entry.configured ? "tools-disabled" : "not-configured",
+        }))
+        : await probeEntries(baseEntries, deps, secrets);
+    return {
+        schemaVersion: 1,
+        effectiveProvider: deps.effectiveProvider,
+        sharedCapabilities: SHARED_CAPABILITIES,
+        zaiOnlyCapabilities: ZAI_ONLY_CAPABILITIES,
         node: {
-            version: process.versions.node,
-            visionMcpCompatible: nodeMajor >= 22,
+            version: process.version,
+            visionMcpCompatible: nodeMajor() >= 22,
         },
+        providers,
+    };
+}
+/**
+ * Probe every configured Provider in registry order using settled
+ * collection. Unconfigured entries are skipped (not-configured) and do
+ * NOT fail the report. A configured probe failure is normalized and
+ * recursively redacted before joining the report; successful entries
+ * are preserved alongside it.
+ */
+async function probeEntries(baseEntries, deps, secrets) {
+    const configuredIndexes = baseEntries
+        .map((entry, index) => (entry.configured ? index : -1))
+        .filter((index) => index >= 0);
+    const settled = await Promise.allSettled(configuredIndexes.map((index) => probeProvider(deps.descriptors[index], deps.env, deps.sleep, deps.random)));
+    let settledCursor = 0;
+    return baseEntries.map((entry) => {
+        if (!entry.configured) {
+            return { ...entry, status: "skipped", reason: "not-configured" };
+        }
+        const result = settled[settledCursor++];
+        if (result.status === "fulfilled") {
+            return { ...entry, status: "ok" };
+        }
+        const redacted = redactSecrets(diagnosticErrorFromError(result.reason), secrets);
+        return { ...entry, status: "error", error: redacted };
+    });
+}
+// ---------------------------------------------------------------------------
+// Exit code
+// ---------------------------------------------------------------------------
+/**
+ * Compute the doctor exit code from a finalized report. Exit 1 when the
+ * effective Provider is unconfigured or any configured probe errored;
+ * otherwise exit 0. A tools-disabled or not-configured skip on a
+ * non-effective Provider never fails the report.
+ */
+export function doctorExitCode(report) {
+    const effective = report.providers.find((p) => p.provider === report.effectiveProvider);
+    if (!effective || !effective.configured)
+        return 1;
+    if (report.providers.some((p) => p.status === "error"))
+        return 1;
+    return 0;
+}
+/**
+ * Run the doctor command. Returns the diagnostics report as base data
+ * with a computed exit code (1 when the effective Provider is
+ * unconfigured or any configured probe failed; otherwise 0).
+ */
+export async function doctor(deps) {
+    const report = await deps.buildReport();
+    return {
+        kind: "data",
+        data: report,
+        exitCode: doctorExitCode(report),
     };
-    if (options.noTools || !apiKey) {
-        outputSuccess(report);
-        return;
-    }
-    silenceConsole();
-    const client = new ZaiMcpClient({ enableVision: options.enableVision });
-    try {
-        const tools = await client.listTools();
-        const byServer = tools.reduce((acc, tool) => {
-            const parts = tool.name.split(".");
-            const server = parts.length >= 2 ? parts[1] : "unknown";
-            acc[server] = (acc[server] || 0) + 1;
-            return acc;
-        }, {});
-        report.mcp = {
-            toolCount: tools.length,
-            servers: byServer,
-        };
-        outputSuccess(report);
-    }
-    catch (error) {
-        restoreConsole();
-        console.error(formatErrorOutput(error));
-        process.exit(1);
-    }
-    finally {
-        await client.close().catch(() => { });
-        restoreConsole();
-    }
 }
 export const DOCTOR_HELP = `
-Doctor - Check environment and MCP connectivity
+Doctor - Provider-aware environment and connectivity diagnostics
 
 Usage: scoutline doctor [options]
 
+Reports a schema-version-1 diagnostics report listing every built-in
+Provider (zai, minimax) with its configured state, declared
+Capabilities, and connectivity status. The effective Provider (resolved
+from --provider, SCOUTLINE_PROVIDER, or the default zai) is the
+Provider that serves the shared Capabilities:
+
+  search, vision.interpret-image, quota, diagnostics
+
+Z.AI connectivity is probed through MCP tool discovery; MiniMax
+connectivity through a single raw quota probe that authenticates
+without a generative request.
+
+The following Capabilities are Z.AI-only in the base release and are
+not selected by the effective Provider for other families:
+  reader, repository-exploration, raw-provider-tools, code-mode,
+  image-diff, video-analysis
+
 Options:
-  --no-tools   Skip tool discovery (env-only check)
-  --no-vision  Skip vision MCP server (faster startup)
+  --no-tools   Skip every connectivity probe (metadata-only). Under
+               --no-tools no Provider transport is constructed: a
+               configured Provider is reported as skipped
+               (tools-disabled) and does not fail the report.
+
+Exit codes:
+  0  All configured probes succeeded (or only tools-disabled skips).
+  1  The effective Provider is unconfigured or any configured probe
+     failed; successful entries are still reported.
 
 Examples:
-  scoutline doctor
-  scoutline doctor --no-tools
+  scoutline doctor                 # full diagnostics
+  scoutline doctor --provider minimax
+  scoutline doctor --no-tools      # metadata only, no transport
 `.trim();
 //# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/quota.d.ts

@@ -1,9 +1,51 @@
 /**
- * Quota command — authoritative Z.AI Coding Plan usage from the monitor API.
+ * Quota command — Provider-neutral quota dashboard (P4-03, ADR-0001).
+ *
+ * The command is presentation-only: it receives a dashboard builder
+ * through injected dependencies and wraps the resulting
+ * {@link QuotaDashboard} as base data with a TTY presentation override.
+ * Provider resolution, capability invocation, settled collection, and
+ * failure redaction live in {@link buildQuotaDashboard} so the command
+ * never imports a Provider monitor client or maps a Provider response.
+ *
+ * Default mode (effective Provider) propagates quota failures through
+ * the ordinary error path (thrown → invokeCommand). All-provider mode
+ * (`--all-providers`) uses settled collection, emits successful and
+ * failed entries, and yields exit 1 when any configured Provider fails.
  */
+import type { CommandResult } from "../command-invocation.js";
+import type { QuotaDashboard } from "../capabilities/quota.js";
+import type { ProviderDescriptor, ProviderId } from "../providers/types.js";
+export interface QuotaDashboardDependencies {
+    readonly allProviders: boolean;
+    readonly effectiveProvider: ProviderId;
+    readonly descriptors: readonly ProviderDescriptor[];
+    readonly env: NodeJS.ProcessEnv;
+    readonly sleep: (ms: number) => Promise<void>;
+    readonly random: () => number;
+}
+/**
+ * Build a {@link QuotaDashboard} for the selected mode. The effective
+ * Provider is resolved by the dispatcher (`index.ts`) and passed in as
+ * metadata; config validation happens here.
+ */
+export declare function buildQuotaDashboard(deps: QuotaDashboardDependencies): Promise<QuotaDashboard>;
 export interface QuotaOptions {
-    window?: "current";
+    allProviders?: boolean;
+}
+/**
+ * Injectable dependencies for the quota command. `buildDashboard`
+ * resolves the effective/all-provider dashboard; the command only wraps
+ * it for presentation and exit-code selection.
+ */
+export interface QuotaCommandDependencies {
+    readonly buildDashboard: () => Promise<QuotaDashboard>;
 }
-export declare function quota(_options?: QuotaOptions): Promise<void>;
+/**
+ * Run the quota command. Returns the dashboard as base data with a TTY
+ * presentation override. Exit code is 1 when any dashboard entry failed
+ * (all-provider mode); otherwise 0.
+ */
+export declare function quota(deps: QuotaCommandDependencies): Promise<CommandResult<QuotaDashboard>>;
 export declare const QUOTA_HELP: string;
 //# sourceMappingURL=quota.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../src/commands/quota.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,wBAAsB,KAAK,CAAC,QAAQ,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2CtE;AAED,eAAO,MAAM,UAAU,QAwBf,CAAC"}
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../../src/commands/quota.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAS5E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;CAC/B;AAqFD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,0BAA0B,GAC/B,OAAO,CAAC,cAAc,CAAC,CAEzB;AAMD,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CACxD;AAED;;;;GAIG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CASxC;AAED,eAAO,MAAM,UAAU,QA2Bf,CAAC"}