@springbrand/cli 0.1.0 → 0.1.1-alpha.1

package/dist/lib/doctor-machine.js

@@ -0,0 +1,208 @@
+/**
+ * The phase order is part of the machine contract. A consumer can use
+ * `failed_phase` without interpreting human-facing check text.
+ */
+export const DOCTOR_PHASE_ORDER = [
+    'detection',
+    'mcp_configured',
+    'auth',
+    'skills',
+    'tools',
+    'restart',
+];
+const STATUS_ORDER = ['pass', 'warn', 'fail', 'skip', 'unknown'];
+function phase(status, code) {
+    return { status, code };
+}
+function checkFor(report, harness, id) {
+    return report.checks.find(check => check.harness === harness && check.id === id);
+}
+function statusFromCheck(check, fallback = 'unknown') {
+    return check?.status ?? fallback;
+}
+function registrationPhase(report, harness) {
+    if (!harness.detected)
+        return phase('skip', 'not_detected');
+    const registration = checkFor(report, harness.harness, 'harness-registration');
+    if (registration?.status === 'fail' && registration.detail.includes('points at')) {
+        return phase('fail', 'mcp_misconfigured');
+    }
+    switch (harness.registered) {
+        case 'yes': return phase('pass', 'configured');
+        case 'no': return phase('warn', 'not_configured');
+        default: return phase('unknown', 'registration_unknown');
+    }
+}
+function authPhase(report, harness) {
+    if (!harness.detected || harness.registered === 'no')
+        return phase('skip', 'not_applicable');
+    const registration = checkFor(report, harness.harness, 'harness-registration');
+    if (registration?.detail.includes('points at'))
+        return phase('skip', 'not_applicable');
+    if (registration?.status === 'fail')
+        return phase('fail', 'auth_failed');
+    if (harness.auth_mode === 'unknown')
+        return phase('unknown', 'auth_unknown');
+    if (registration?.status === 'warn')
+        return phase('warn', 'auth_unverified');
+    return phase('pass', 'auth_configured');
+}
+function skillsPhase(report, harness) {
+    if (!harness.detected)
+        return phase('skip', 'not_detected');
+    const check = checkFor(report, harness.harness, 'hermes-plugin') ?? checkFor(report, harness.harness, 'pi-adapter');
+    if (!check)
+        return phase('skip', 'not_applicable');
+    const codes = {
+        pass: 'skills_ready',
+        warn: 'skills_warn',
+        fail: 'skills_fail',
+        skip: 'skills_skip',
+        unknown: 'skills_unknown',
+    };
+    return phase(statusFromCheck(check), codes[check.status]);
+}
+function toolsPhase(report, harness) {
+    if (!harness.detected || harness.registered === 'no')
+        return phase('skip', 'not_applicable');
+    if (harness.proves_harness_reach)
+        return phase('pass', 'harness_reach_verified');
+    if (report.checks.some(check => check.id === 'mcp-connectivity' && check.status === 'fail')) {
+        return phase('fail', 'tools_unreachable');
+    }
+    const registration = checkFor(report, harness.harness, 'harness-registration');
+    if (registration?.status === 'fail')
+        return phase('fail', 'tools_unreachable');
+    if (registration?.status === 'warn')
+        return phase('warn', 'tools_unverified');
+    return phase('unknown', 'tools_unknown');
+}
+function restartPhase(report, harness, skills) {
+    if (!harness.detected)
+        return { ...phase('skip', 'not_detected'), required: false };
+    const restartCheck = checkFor(report, harness.harness, 'restart-required');
+    if (restartCheck?.status === 'fail' || restartCheck?.status === 'warn') {
+        return { ...phase('warn', 'restart_required'), required: true };
+    }
+    if (restartCheck?.status === 'skip')
+        return { ...phase('skip', 'not_applicable'), required: false };
+    // The current checks do not observe a live process reload. Keep this explicit
+    // instead of guessing from a registration result; a future check can add a
+    // stable reason code without changing the field shape.
+    if (skills.status === 'fail')
+        return { ...phase('warn', 'skills_need_attention'), required: false };
+    return { ...phase('pass', 'not_required'), required: false };
+}
+function failedPhase(host) {
+    return DOCTOR_PHASE_ORDER.find(name => {
+        if (name === 'detection')
+            return false;
+        const statuses = {
+            mcp_configured: host.mcp_configured.status,
+            auth: host.auth.status,
+            skills: host.skills.status,
+            tools: host.tools.status,
+            restart: host.restart_required.status,
+        };
+        return statuses[name] === 'fail';
+    }) ?? null;
+}
+function overallVerdict(report, hosts) {
+    if (!report.ok_harnesses || hosts.some(host => host.failed_phase !== null))
+        return 'fail';
+    const phaseStatuses = hosts.flatMap(host => [
+        host.mcp_configured.status,
+        host.auth.status,
+        host.skills.status,
+        host.tools.status,
+        host.restart_required.status,
+    ]);
+    if (phaseStatuses.some(status => status === 'warn' || status === 'unknown'))
+        return 'warn';
+    if (!report.ok_cli || report.checks.some(check => check.status === 'warn'))
+        return 'warn';
+    return 'pass';
+}
+function safeChecks(checks) {
+    return checks.map(check => ({
+        id: check.id,
+        status: check.status,
+        harness: check.harness,
+        scope: check.scope,
+    }));
+}
+function repairCode(outcome) {
+    if (outcome.status === 'repaired')
+        return 'repaired';
+    if (outcome.status === 'skipped') {
+        if (outcome.reason?.includes('no terminal'))
+            return 'no_terminal';
+        if (outcome.reason?.includes('browser'))
+            return 'interactive_auth_required';
+        return 'skipped';
+    }
+    return 'repair_failed';
+}
+function safeRepairs(report, outcomes) {
+    if (outcomes.length > 0) {
+        return outcomes.map(outcome => ({
+            action: outcome.repair.action,
+            harness: outcome.repair.harness,
+            status: outcome.status,
+            code: repairCode(outcome),
+        }));
+    }
+    return report.repairs.map(repair => ({
+        action: repair.action,
+        harness: repair.harness,
+        status: 'offered',
+        code: 'repair_available',
+    }));
+}
+/** Project the legacy report into the explicit, allowlisted machine contract. */
+export function machineReport(report, outcomes = []) {
+    const hosts = report.harnesses.map(harness => {
+        const mcpConfigured = registrationPhase(report, harness);
+        const auth = authPhase(report, harness);
+        const skills = skillsPhase(report, harness);
+        const tools = toolsPhase(report, harness);
+        const host = {
+            harness: harness.harness,
+            detected: harness.detected,
+            mcp_configured: mcpConfigured,
+            auth,
+            skills,
+            tools,
+            restart_required: restartPhase(report, harness, skills),
+            failed_phase: null,
+        };
+        host.failed_phase = failedPhase(host);
+        return host;
+    });
+    const result = {
+        schema_version: 1,
+        outcome: 'completed',
+        cli_version: report.cli_version,
+        verdict: overallVerdict(report, hosts),
+        ok_harnesses: report.ok_harnesses,
+        ok_cli: report.ok_cli,
+        checks: safeChecks(report.checks),
+        hosts,
+        repairs: safeRepairs(report, outcomes),
+    };
+    return result;
+}
+/** Fixed error envelope used when the diagnostic itself cannot complete. */
+export function machineError(phaseName = 'run') {
+    return {
+        schema_version: 1,
+        outcome: 'could_not_run',
+        phase: phaseName,
+        error_code: phaseName === 'input' ? 'invalid_input' : 'doctor_failed',
+        retryable: phaseName !== 'input',
+    };
+}
+// Keep the status list referenced here so additions require updating the
+// machine contract deliberately rather than becoming accidental wire values.
+export const MACHINE_PHASE_STATUSES = STATUS_ORDER;
+//# sourceMappingURL=doctor-machine.js.map

package/dist/lib/doctor-machine.js.map

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

package/dist/lib/doctor-report.d.ts

@@ -167,6 +167,309 @@ export declare const doctorReportSchema: z.ZodObject<{
     hermes_plugin_version: z.ZodOptional<z.ZodString>;
     hermes_plugin_expected_version: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * Explicit machine mode is versioned independently from the legacy default JSON.
+ * Version policy: bump for breaking reads; additive optional fields remain
+ * forward-compatible under the same version.
+ */
+export declare const DOCTOR_MACHINE_SCHEMA_VERSION = 1;
+declare const machinePhaseStatusSchema: z.ZodEnum<{
+    unknown: "unknown";
+    pass: "pass";
+    fail: "fail";
+    warn: "warn";
+    skip: "skip";
+}>;
+declare const machinePhaseNameSchema: z.ZodEnum<{
+    auth: "auth";
+    skills: "skills";
+    detection: "detection";
+    mcp_configured: "mcp_configured";
+    tools: "tools";
+    restart: "restart";
+}>;
+export declare const doctorMachineReportSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    outcome: z.ZodLiteral<"completed">;
+    cli_version: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        warn: "warn";
+    }>;
+    ok_harnesses: z.ZodBoolean;
+    ok_cli: z.ZodBoolean;
+    checks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+            warn: "warn";
+            skip: "skip";
+        }>;
+        harness: z.ZodNullable<z.ZodEnum<{
+            openclaw: "openclaw";
+            omp: "omp";
+            grok: "grok";
+            cursor: "cursor";
+            codex: "codex";
+            hermes: "hermes";
+            "command-code": "command-code";
+            opencode: "opencode";
+            pi: "pi";
+            "claude-code": "claude-code";
+        }>>;
+        scope: z.ZodEnum<{
+            cli: "cli";
+            harness: "harness";
+            info: "info";
+        }>;
+    }, z.core.$strip>>;
+    hosts: z.ZodArray<z.ZodObject<{
+        harness: z.ZodEnum<{
+            openclaw: "openclaw";
+            omp: "omp";
+            grok: "grok";
+            cursor: "cursor";
+            codex: "codex";
+            hermes: "hermes";
+            "command-code": "command-code";
+            opencode: "opencode";
+            pi: "pi";
+            "claude-code": "claude-code";
+        }>;
+        detected: z.ZodBoolean;
+        mcp_configured: z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                pass: "pass";
+                fail: "fail";
+                warn: "warn";
+                skip: "skip";
+            }>;
+            code: z.ZodEnum<{
+                not_detected: "not_detected";
+                configured: "configured";
+                not_configured: "not_configured";
+                mcp_misconfigured: "mcp_misconfigured";
+                registration_unknown: "registration_unknown";
+                not_applicable: "not_applicable";
+                auth_failed: "auth_failed";
+                auth_unknown: "auth_unknown";
+                auth_unverified: "auth_unverified";
+                auth_configured: "auth_configured";
+                skills_ready: "skills_ready";
+                skills_pass: "skills_pass";
+                skills_warn: "skills_warn";
+                skills_fail: "skills_fail";
+                skills_skip: "skills_skip";
+                skills_unknown: "skills_unknown";
+                tools_unreachable: "tools_unreachable";
+                tools_unverified: "tools_unverified";
+                tools_unknown: "tools_unknown";
+                harness_reach_verified: "harness_reach_verified";
+                skills_need_attention: "skills_need_attention";
+                not_required: "not_required";
+                restart_required: "restart_required";
+                restart_unknown: "restart_unknown";
+            }>;
+        }, z.core.$strip>;
+        auth: z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                pass: "pass";
+                fail: "fail";
+                warn: "warn";
+                skip: "skip";
+            }>;
+            code: z.ZodEnum<{
+                not_detected: "not_detected";
+                configured: "configured";
+                not_configured: "not_configured";
+                mcp_misconfigured: "mcp_misconfigured";
+                registration_unknown: "registration_unknown";
+                not_applicable: "not_applicable";
+                auth_failed: "auth_failed";
+                auth_unknown: "auth_unknown";
+                auth_unverified: "auth_unverified";
+                auth_configured: "auth_configured";
+                skills_ready: "skills_ready";
+                skills_pass: "skills_pass";
+                skills_warn: "skills_warn";
+                skills_fail: "skills_fail";
+                skills_skip: "skills_skip";
+                skills_unknown: "skills_unknown";
+                tools_unreachable: "tools_unreachable";
+                tools_unverified: "tools_unverified";
+                tools_unknown: "tools_unknown";
+                harness_reach_verified: "harness_reach_verified";
+                skills_need_attention: "skills_need_attention";
+                not_required: "not_required";
+                restart_required: "restart_required";
+                restart_unknown: "restart_unknown";
+            }>;
+        }, z.core.$strip>;
+        skills: z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                pass: "pass";
+                fail: "fail";
+                warn: "warn";
+                skip: "skip";
+            }>;
+            code: z.ZodEnum<{
+                not_detected: "not_detected";
+                configured: "configured";
+                not_configured: "not_configured";
+                mcp_misconfigured: "mcp_misconfigured";
+                registration_unknown: "registration_unknown";
+                not_applicable: "not_applicable";
+                auth_failed: "auth_failed";
+                auth_unknown: "auth_unknown";
+                auth_unverified: "auth_unverified";
+                auth_configured: "auth_configured";
+                skills_ready: "skills_ready";
+                skills_pass: "skills_pass";
+                skills_warn: "skills_warn";
+                skills_fail: "skills_fail";
+                skills_skip: "skills_skip";
+                skills_unknown: "skills_unknown";
+                tools_unreachable: "tools_unreachable";
+                tools_unverified: "tools_unverified";
+                tools_unknown: "tools_unknown";
+                harness_reach_verified: "harness_reach_verified";
+                skills_need_attention: "skills_need_attention";
+                not_required: "not_required";
+                restart_required: "restart_required";
+                restart_unknown: "restart_unknown";
+            }>;
+        }, z.core.$strip>;
+        tools: z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                pass: "pass";
+                fail: "fail";
+                warn: "warn";
+                skip: "skip";
+            }>;
+            code: z.ZodEnum<{
+                not_detected: "not_detected";
+                configured: "configured";
+                not_configured: "not_configured";
+                mcp_misconfigured: "mcp_misconfigured";
+                registration_unknown: "registration_unknown";
+                not_applicable: "not_applicable";
+                auth_failed: "auth_failed";
+                auth_unknown: "auth_unknown";
+                auth_unverified: "auth_unverified";
+                auth_configured: "auth_configured";
+                skills_ready: "skills_ready";
+                skills_pass: "skills_pass";
+                skills_warn: "skills_warn";
+                skills_fail: "skills_fail";
+                skills_skip: "skills_skip";
+                skills_unknown: "skills_unknown";
+                tools_unreachable: "tools_unreachable";
+                tools_unverified: "tools_unverified";
+                tools_unknown: "tools_unknown";
+                harness_reach_verified: "harness_reach_verified";
+                skills_need_attention: "skills_need_attention";
+                not_required: "not_required";
+                restart_required: "restart_required";
+                restart_unknown: "restart_unknown";
+            }>;
+        }, z.core.$strip>;
+        restart_required: z.ZodObject<{
+            status: z.ZodEnum<{
+                unknown: "unknown";
+                pass: "pass";
+                fail: "fail";
+                warn: "warn";
+                skip: "skip";
+            }>;
+            code: z.ZodEnum<{
+                not_detected: "not_detected";
+                configured: "configured";
+                not_configured: "not_configured";
+                mcp_misconfigured: "mcp_misconfigured";
+                registration_unknown: "registration_unknown";
+                not_applicable: "not_applicable";
+                auth_failed: "auth_failed";
+                auth_unknown: "auth_unknown";
+                auth_unverified: "auth_unverified";
+                auth_configured: "auth_configured";
+                skills_ready: "skills_ready";
+                skills_pass: "skills_pass";
+                skills_warn: "skills_warn";
+                skills_fail: "skills_fail";
+                skills_skip: "skills_skip";
+                skills_unknown: "skills_unknown";
+                tools_unreachable: "tools_unreachable";
+                tools_unverified: "tools_unverified";
+                tools_unknown: "tools_unknown";
+                harness_reach_verified: "harness_reach_verified";
+                skills_need_attention: "skills_need_attention";
+                not_required: "not_required";
+                restart_required: "restart_required";
+                restart_unknown: "restart_unknown";
+            }>;
+            required: z.ZodBoolean;
+        }, z.core.$strip>;
+        failed_phase: z.ZodNullable<z.ZodEnum<{
+            auth: "auth";
+            skills: "skills";
+            detection: "detection";
+            mcp_configured: "mcp_configured";
+            tools: "tools";
+            restart: "restart";
+        }>>;
+    }, z.core.$strip>>;
+    repairs: z.ZodArray<z.ZodObject<{
+        action: z.ZodEnum<{
+            connect: "connect";
+            "auth-login": "auth-login";
+        }>;
+        harness: z.ZodNullable<z.ZodEnum<{
+            openclaw: "openclaw";
+            omp: "omp";
+            grok: "grok";
+            cursor: "cursor";
+            codex: "codex";
+            hermes: "hermes";
+            "command-code": "command-code";
+            opencode: "opencode";
+            pi: "pi";
+            "claude-code": "claude-code";
+        }>>;
+        status: z.ZodEnum<{
+            failed: "failed";
+            offered: "offered";
+            repaired: "repaired";
+            skipped: "skipped";
+        }>;
+        code: z.ZodEnum<{
+            repaired: "repaired";
+            skipped: "skipped";
+            repair_available: "repair_available";
+            no_terminal: "no_terminal";
+            interactive_auth_required: "interactive_auth_required";
+            repair_failed: "repair_failed";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const doctorMachineErrorSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    outcome: z.ZodLiteral<"could_not_run">;
+    phase: z.ZodEnum<{
+        input: "input";
+        run: "run";
+    }>;
+    error_code: z.ZodEnum<{
+        invalid_input: "invalid_input";
+        doctor_failed: "doctor_failed";
+    }>;
+    retryable: z.ZodBoolean;
+}, z.core.$strip>;
 /** Doctor itself broke, which is a different claim from "your setup is broken". */
 export declare const DOCTOR_COULD_NOT_RUN = 2;
 /** The invocation was wrong, not the machine; exit 2 stays "doctor broke". */
@@ -185,6 +488,10 @@ export type DoctorCheck = z.infer<typeof doctorCheckSchema>;
 export type DoctorHarness = z.infer<typeof doctorHarnessSchema>;
 export type DoctorRepair = z.infer<typeof doctorRepairSchema>;
 export type DoctorReport = z.infer<typeof doctorReportSchema>;
+export type MachinePhaseStatus = z.infer<typeof machinePhaseStatusSchema>;
+export type MachinePhase = z.infer<typeof machinePhaseNameSchema>;
+export type DoctorMachineReport = z.infer<typeof doctorMachineReportSchema>;
+export type DoctorMachineError = z.infer<typeof doctorMachineErrorSchema>;
 export interface DoctorOptions {
     mcpUrl: string;
     harness?: Harness;

package/dist/lib/doctor-report.d.ts.map

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

package/dist/lib/doctor-report.js

@@ -60,6 +60,86 @@ export const doctorReportSchema = z
     message: 'ok_cli cannot be true while a CLI check has failed',
     path: ['ok_cli'],
 });
+/**
+ * Explicit machine mode is versioned independently from the legacy default JSON.
+ * Version policy: bump for breaking reads; additive optional fields remain
+ * forward-compatible under the same version.
+ */
+export const DOCTOR_MACHINE_SCHEMA_VERSION = 1;
+const machinePhaseStatusSchema = z.enum(['pass', 'fail', 'warn', 'skip', 'unknown']);
+const machinePhaseSchema = z.object({
+    status: machinePhaseStatusSchema,
+    // Codes are authored by the CLI; free text is deliberately not part of this contract.
+    code: z.enum([
+        'not_detected',
+        'configured',
+        'not_configured',
+        'mcp_misconfigured',
+        'registration_unknown',
+        'not_applicable',
+        'auth_failed',
+        'auth_unknown',
+        'auth_unverified',
+        'auth_configured',
+        'skills_ready',
+        'skills_pass',
+        'skills_warn',
+        'skills_fail',
+        'skills_skip',
+        'skills_unknown',
+        'tools_unreachable',
+        'tools_unverified',
+        'tools_unknown',
+        'harness_reach_verified',
+        'skills_need_attention',
+        'not_required',
+        'restart_required',
+        'restart_unknown',
+    ]),
+});
+const machinePhaseNameSchema = z.enum(['detection', 'mcp_configured', 'auth', 'skills', 'tools', 'restart']);
+const machineCheckSchema = z.object({
+    id: z.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/),
+    status: checkStatusSchema,
+    harness: harnessSchema.nullable(),
+    scope: checkScopeSchema,
+});
+const machineHostSchema = z.object({
+    harness: harnessSchema,
+    detected: z.boolean(),
+    mcp_configured: machinePhaseSchema,
+    auth: machinePhaseSchema,
+    skills: machinePhaseSchema,
+    tools: machinePhaseSchema,
+    restart_required: machinePhaseSchema.extend({ required: z.boolean() }),
+    failed_phase: machinePhaseNameSchema.nullable(),
+});
+const machineRepairSchema = z.object({
+    action: z.enum(['connect', 'auth-login']),
+    harness: harnessSchema.nullable(),
+    status: z.enum(['offered', 'repaired', 'skipped', 'failed']),
+    code: z.enum(['repair_available', 'repaired', 'no_terminal', 'interactive_auth_required', 'skipped', 'repair_failed']),
+});
+export const doctorMachineReportSchema = z.object({
+    schema_version: z.literal(DOCTOR_MACHINE_SCHEMA_VERSION),
+    outcome: z.literal('completed'),
+    cli_version: z.string().max(32),
+    verdict: z.enum(['pass', 'warn', 'fail']),
+    ok_harnesses: z.boolean(),
+    ok_cli: z.boolean(),
+    checks: z.array(machineCheckSchema),
+    hosts: z.array(machineHostSchema),
+    repairs: z.array(machineRepairSchema),
+});
+const machineErrorPhaseSchema = z.enum(['input', 'run']);
+const machineErrorCodeSchema = z.enum(['invalid_input', 'doctor_failed']);
+export const doctorMachineErrorSchema = z.object({
+    schema_version: z.literal(DOCTOR_MACHINE_SCHEMA_VERSION),
+    outcome: z.literal('could_not_run'),
+    phase: machineErrorPhaseSchema,
+    error_code: machineErrorCodeSchema,
+    retryable: z.boolean(),
+});
 const GLYPHS = { pass: '✓', fail: '✗', warn: '⚠', skip: '…' };
 /** Doctor itself broke, which is a different claim from "your setup is broken". */
 export const DOCTOR_COULD_NOT_RUN = 2;