@principles/pd-cli 1.107.0 → 1.108.1

package/dist/commands/__tests__/runtime-probe-config.test.js

@@ -0,0 +1,388 @@
+/**
+ * PRI-402: pd runtime probe reads .pd/config.yaml for pi-ai config.
+ *
+ * Tests cover:
+ *   - probe reads config from .pd/config.yaml when --workspace is provided
+ *   - JSON output includes configSource, runtimeProfileId, runtimeProfileLabel
+ *   - explicit --provider overrides config.yaml
+ *   - fail-loud JSON when config.yaml is missing or incomplete
+ *   - program.parseAsync against real Commander registration (EP-04)
+ *
+ * ERR refs:
+ *   - EP-04 (CLI gate): --json stdout single object, process.exit(1) + return
+ *   - EP-03 (fail loud): structured JSON with reason + nextAction on failure
+ *   - EP-07 (source alignment): probe and doctor read same config source
+ *   - ERR-004 (source alignment): profileId/label must match doctor output
+ *   - ERR-021 (handler-only tests): add program.parseAsync tests
+ *   - ERR-029 (fail-loud JSON): config missing → structured JSON, not bare error
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// ─── Mocks ─────────────────────────────────────────────────────────────────
+// Mock only probeRuntime so we don't need a real LLM provider.
+// All other core functions (validatePdConfig, computeEffectivePdConfig,
+// resolveAgentRuntimeBinding, etc.) use their real implementations.
+const mockProbeRuntime = vi.fn();
+vi.mock('@principles/core/runtime-v2', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        probeRuntime: mockProbeRuntime,
+    };
+});
+const { handleRuntimeProbe } = await import('../runtime.js');
+// ─── Test Setup ─────────────────────────────────────────────────────────────
+const capturedStdout = [];
+const capturedStderr = [];
+let capturedExitCode = null;
+const originalExit = process.exit;
+const originalLog = console.log;
+const originalError = console.error;
+const originalWarn = console.warn;
+const originalEnv = { ...process.env };
+beforeEach(() => {
+    capturedExitCode = null;
+    capturedStdout.length = 0;
+    capturedStderr.length = 0;
+    process.exit = vi.fn(((code) => {
+        capturedExitCode = code ?? 0;
+    }));
+    console.log = vi.fn((...args) => { capturedStdout.push(args.join(' ')); });
+    console.error = vi.fn((...args) => { capturedStderr.push(args.join(' ')); });
+    console.warn = vi.fn(() => { });
+    mockProbeRuntime.mockReset();
+    process.env = { ...originalEnv, LMSTUDIO_API_KEY: 'test-key-for-pri-402' };
+});
+afterEach(() => {
+    process.exit = originalExit;
+    console.log = originalLog;
+    console.error = originalError;
+    console.warn = originalWarn;
+    process.env = originalEnv;
+});
+// ─── Helper: create temp workspace with .pd/config.yaml ────────────────────
+function createTempWorkspace(configYaml) {
+    const tmpDir = path.join(os.tmpdir(), `pd-probe-test-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
+    const pdDir = path.join(tmpDir, '.pd');
+    fs.mkdirSync(pdDir, { recursive: true });
+    // Replace __WORKSPACE_DIR__ placeholder with actual path
+    const resolvedYaml = configYaml.replace(/__WORKSPACE_DIR__/g, tmpDir.replace(/\\/g, '/'));
+    fs.writeFileSync(path.join(pdDir, 'config.yaml'), resolvedYaml, 'utf-8');
+    return tmpDir;
+}
+function cleanupWorkspace(dir) {
+    try {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+    catch {
+        // best effort
+    }
+}
+const PI_AI_CONFIG_YAML = `
+version: 1
+features:
+  prompt: { category: core, enabled: true }
+  code_tool_hook: { category: core, enabled: true }
+  defer_archive: { category: core, enabled: true }
+workspace:
+  default: __WORKSPACE_DIR__
+internalAgents:
+  defaultRuntime: pi-ai.lmstudio
+  agents:
+    diagnostician:
+      enabled: true
+      runtimeProfile: pi-ai.lmstudio
+    dreamer:
+      enabled: true
+    philosopher:
+      enabled: true
+    scribe:
+      enabled: true
+    artificer:
+      enabled: true
+runtimeProfiles:
+  pi-ai.lmstudio:
+    type: pi-ai
+    provider: lmstudio
+    model: qwen3.6-27b-mtp
+    apiKeyEnv: LMSTUDIO_API_KEY
+    baseUrl: http://localhost:1234/v1
+`;
+// ─── Tests: probe reads config from .pd/config.yaml ────────────────────────
+describe('PRI-402: probe reads .pd/config.yaml for pi-ai config', () => {
+    it('reads provider/model from config.yaml when --workspace provided without --provider', async () => {
+        const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+        try {
+            mockProbeRuntime.mockResolvedValue({
+                runtimeKind: 'pi-ai',
+                provider: 'lmstudio',
+                model: 'qwen3.6-27b-mtp',
+                health: { healthy: true, degraded: false, warnings: [], lastCheckedAt: '2026-01-01T00:00:00Z' },
+                capabilities: { streaming: true },
+            });
+            await handleRuntimeProbe({
+                runtime: 'pi-ai',
+                workspace,
+                json: true,
+            });
+            // probeRuntime should be called with config.yaml values
+            expect(mockProbeRuntime).toHaveBeenCalled();
+            const callArgs = mockProbeRuntime.mock.calls[0]?.[0];
+            expect(callArgs?.provider).toBe('lmstudio');
+            expect(callArgs?.model).toBe('qwen3.6-27b-mtp');
+            expect(callArgs?.apiKeyEnv).toBe('LMSTUDIO_API_KEY');
+            // JSON output should contain configSource, runtimeProfileId, runtimeProfileLabel
+            const output = JSON.parse(capturedStdout.join(''));
+            expect(output.configSource).toBe('.pd/config.yaml');
+            expect(output.runtimeProfileId).toBe('pi-ai.lmstudio');
+            expect(output.runtimeProfileLabel).toBe('pi-ai: lmstudio/qwen3.6-27b-mtp');
+            expect(output.ok).toBe(true);
+        }
+        finally {
+            cleanupWorkspace(workspace);
+        }
+    });
+    it('explicit --provider overrides config.yaml value', async () => {
+        const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+        try {
+            mockProbeRuntime.mockResolvedValue({
+                runtimeKind: 'pi-ai',
+                provider: 'openrouter',
+                model: 'qwen3.6-27b-mtp',
+                health: { healthy: true, degraded: false, warnings: [], lastCheckedAt: '2026-01-01T00:00:00Z' },
+                capabilities: { streaming: true },
+            });
+            await handleRuntimeProbe({
+                runtime: 'pi-ai',
+                workspace,
+                provider: 'openrouter',
+                model: 'anthropic/claude-sonnet-4',
+                apiKeyEnv: 'OPENROUTER_API_KEY',
+                json: true,
+            });
+            const callArgs = mockProbeRuntime.mock.calls[0]?.[0];
+            // CLI flags override config.yaml
+            expect(callArgs?.provider).toBe('openrouter');
+            expect(callArgs?.model).toBe('anthropic/claude-sonnet-4');
+            expect(callArgs?.apiKeyEnv).toBe('OPENROUTER_API_KEY');
+            // Profile info still comes from config.yaml (EP-07: source alignment)
+            const output = JSON.parse(capturedStdout.join(''));
+            expect(output.configSource).toBe('.pd/config.yaml');
+            expect(output.runtimeProfileId).toBe('pi-ai.lmstudio');
+        }
+        finally {
+            cleanupWorkspace(workspace);
+        }
+    });
+    it('fail-loud JSON when config.yaml is missing and no --provider', async () => {
+        const workspace = path.join(os.tmpdir(), `pd-probe-test-missing-${Date.now()}`);
+        fs.mkdirSync(workspace, { recursive: true });
+        // No .pd/config.yaml created
+        try {
+            await handleRuntimeProbe({
+                runtime: 'pi-ai',
+                workspace,
+                json: true,
+            });
+            expect(capturedExitCode).toBe(1);
+            const output = JSON.parse(capturedStdout.join(''));
+            expect(output.ok).toBe(false);
+            expect(output.status).toBe('failed');
+            expect(typeof output.reason).toBe('string');
+            expect(typeof output.nextAction).toBe('string');
+            // Single parseable JSON object (EP-04 Rule 1)
+            expect(Array.isArray(output)).toBe(false);
+        }
+        finally {
+            cleanupWorkspace(workspace);
+        }
+    });
+    it('fail-loud JSON when provider missing from config.yaml', async () => {
+        const workspace = createTempWorkspace(`
+version: 1
+features:
+  prompt: { category: core, enabled: true }
+  code_tool_hook: { category: core, enabled: true }
+  defer_archive: { category: core, enabled: true }
+workspace:
+  default: __WORKSPACE_DIR__
+internalAgents:
+  defaultRuntime: pi-ai.broken
+  agents:
+    diagnostician:
+      enabled: true
+      runtimeProfile: pi-ai.broken
+runtimeProfiles:
+  pi-ai.broken:
+    type: pi-ai
+    # Missing provider, model, apiKeyEnv
+`);
+        try {
+            await handleRuntimeProbe({
+                runtime: 'pi-ai',
+                workspace,
+                json: true,
+            });
+            expect(capturedExitCode).toBe(1);
+            const output = JSON.parse(capturedStdout.join(''));
+            expect(output.ok).toBe(false);
+            expect(output.status).toBe('failed');
+            expect(typeof output.reason).toBe('string');
+            expect(typeof output.nextAction).toBe('string');
+        }
+        finally {
+            cleanupWorkspace(workspace);
+        }
+    });
+    it('fail-loud JSON when apiKeyEnv env var is not set', async () => {
+        const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+        try {
+            // Remove the API key env var
+            delete process.env.LMSTUDIO_API_KEY;
+            await handleRuntimeProbe({
+                runtime: 'pi-ai',
+                workspace,
+                json: true,
+            });
+            expect(capturedExitCode).toBe(1);
+            const output = JSON.parse(capturedStdout.join(''));
+            expect(output.ok).toBe(false);
+            // When apiKeyEnv is not set, resolveRuntimeConfigFromPdConfig returns
+            // a config error (not_ready), so the error comes from the config resolution path
+            expect(typeof output.reason).toBe('string');
+            expect(typeof output.nextAction).toBe('string');
+        }
+        finally {
+            cleanupWorkspace(workspace);
+        }
+    });
+    it('human-readable output includes Profile and Config lines', async () => {
+        const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+        try {
+            mockProbeRuntime.mockResolvedValue({
+                runtimeKind: 'pi-ai',
+                provider: 'lmstudio',
+                model: 'qwen3.6-27b-mtp',
+                health: { healthy: true, degraded: false, warnings: [], lastCheckedAt: '2026-01-01T00:00:00Z' },
+                capabilities: { streaming: true },
+            });
+            await handleRuntimeProbe({
+                runtime: 'pi-ai',
+                workspace,
+                json: false,
+            });
+            const output = capturedStdout.join('\n');
+            expect(output).toContain('Profile:');
+            expect(output).toContain('pi-ai: lmstudio/qwen3.6-27b-mtp');
+            expect(output).toContain('Config:');
+            expect(output).toContain('.pd/config.yaml');
+        }
+        finally {
+            cleanupWorkspace(workspace);
+        }
+    });
+});
+// ─── Tests: program.parseAsync against real Commander registration (EP-04) ──
+// Import the real command registration function to test actual production wiring
+const { registerRuntimeProbeCommand } = await import('../runtime.js');
+function attachCapture(cmd, state) {
+    // Override the action handler to capture opts without calling the real handler
+    cmd.action((...args) => {
+        // Find the opts object (last non-Command, non-null object arg)
+        let optsArg = null;
+        for (let i = args.length - 1; i >= 0; i--) {
+            const arg = args[i];
+            if (arg !== null && typeof arg === 'object' && !(arg instanceof Command)) {
+                optsArg = arg;
+                break;
+            }
+        }
+        state.opts = optsArg ?? {};
+        // Do NOT call original action (would call handleRuntimeProbe which needs real runtime)
+    });
+}
+function freshProgram() {
+    const program = new Command();
+    program.name('pd').exitOverride();
+    return program;
+}
+describe('PRI-402: probe command flag wiring (EP-04 real registration)', () => {
+    it('registers --runtime as required option via real registration', () => {
+        const program = freshProgram();
+        const runtimeCmd = program.command('runtime');
+        const probeCmd = registerRuntimeProbeCommand(runtimeCmd);
+        const runtimeOpt = probeCmd.options.find((o) => o.long === '--runtime');
+        expect(runtimeOpt).toBeDefined();
+        expect(runtimeOpt?.required).toBe(true);
+    });
+    it('registers --workspace with -w shorthand via real registration', () => {
+        const program = freshProgram();
+        const runtimeCmd = program.command('runtime');
+        const probeCmd = registerRuntimeProbeCommand(runtimeCmd);
+        const wsOpt = probeCmd.options.find((o) => o.short === '-w');
+        expect(wsOpt).toBeDefined();
+        expect(wsOpt?.long).toBe('--workspace');
+    });
+    it('parses --runtime pi-ai --workspace <dir> --json correctly via real registration', async () => {
+        const program = freshProgram();
+        const runtimeCmd = program.command('runtime');
+        const probeCmd = registerRuntimeProbeCommand(runtimeCmd);
+        const captured = { opts: null };
+        attachCapture(probeCmd, captured);
+        await program.parseAsync(['node', 'pd', 'runtime', 'probe', '--runtime', 'pi-ai', '--workspace', '/tmp/test', '--json']);
+        expect(captured.opts).not.toBeNull();
+        if (!captured.opts)
+            throw new Error('captured.opts is null');
+        expect(captured.opts.runtime).toBe('pi-ai');
+        expect(captured.opts.workspace).toBe('/tmp/test');
+        expect(captured.opts.json).toBe(true);
+    });
+    it('parses --runtime config --workspace <dir> correctly via real registration', async () => {
+        const program = freshProgram();
+        const runtimeCmd = program.command('runtime');
+        const probeCmd = registerRuntimeProbeCommand(runtimeCmd);
+        const captured = { opts: null };
+        attachCapture(probeCmd, captured);
+        await program.parseAsync(['node', 'pd', 'runtime', 'probe', '--runtime', 'config', '--workspace', '/tmp/test']);
+        expect(captured.opts).not.toBeNull();
+        if (!captured.opts)
+            throw new Error('captured.opts is null');
+        expect(captured.opts.runtime).toBe('config');
+        expect(captured.opts.workspace).toBe('/tmp/test');
+    });
+});
+// ─── Tests: resolve-runtime-from-pd-config profile extraction ───────────────
+describe('PRI-402: resolveRuntimeWithOverrides returns profile info', () => {
+    it('returns runtimeProfileId and runtimeProfileLabel from config.yaml', async () => {
+        const workspace = createTempWorkspace(PI_AI_CONFIG_YAML);
+        try {
+            const { resolveRuntimeWithOverrides } = await import('../../services/resolve-runtime-from-pd-config.js');
+            const result = resolveRuntimeWithOverrides(workspace, {});
+            expect(result.configSource).toBe('.pd/config.yaml');
+            expect(result.runtimeProfileId).toBe('pi-ai.lmstudio');
+            expect(result.runtimeProfileLabel).toBe('pi-ai: lmstudio/qwen3.6-27b-mtp');
+        }
+        finally {
+            cleanupWorkspace(workspace);
+        }
+    });
+    it('returns default profile when config.yaml is missing', async () => {
+        const workspace = path.join(os.tmpdir(), `pd-probe-test-noprofile-${Date.now()}`);
+        fs.mkdirSync(workspace, { recursive: true });
+        try {
+            const { resolveRuntimeWithOverrides } = await import('../../services/resolve-runtime-from-pd-config.js');
+            const result = resolveRuntimeWithOverrides(workspace, {});
+            // Missing config → defaults, which use openclaw.default as defaultRuntime
+            expect(result.configSource).toBe('.pd/config.yaml');
+            expect(result.runtimeProfileId).toBe('openclaw.default');
+            expect(typeof result.runtimeProfileLabel).toBe('string');
+        }
+        finally {
+            cleanupWorkspace(workspace);
+        }
+    });
+});
+//# sourceMappingURL=runtime-probe-config.test.js.map

package/dist/commands/__tests__/runtime-probe-config.test.js.map

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

package/dist/commands/command-helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Command registration helpers (PRI-397 / C5 follow-up).
+ *
+ * These helpers are the single source of truth for which options a command
+ * supports. They are called by BOTH:
+ *   - `packages/pd-cli/src/index.ts` (production registration)
+ *   - parser-level tests (mvp-smoke.test.ts)
+ *
+ * Tests reuse the same registration functions so a typo in production
+ * (e.g., a flag mismatch between registration and handler) shows up at
+ * `program.parseAsync(...)` time, not just at handler dispatch (EP-04).
+ */
+import type { Command } from 'commander';
+/**
+ * Add the standard `--workspace <path>` / `--json` flag pair to a command.
+ * Returns the same command for chaining.
+ */
+export declare function withWorkspaceAndJson(cmd: Command): Command;
+//# sourceMappingURL=command-helpers.d.ts.map

package/dist/commands/command-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/command-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAI1D"}

package/dist/commands/command-helpers.js

@@ -0,0 +1,22 @@
+/**
+ * Command registration helpers (PRI-397 / C5 follow-up).
+ *
+ * These helpers are the single source of truth for which options a command
+ * supports. They are called by BOTH:
+ *   - `packages/pd-cli/src/index.ts` (production registration)
+ *   - parser-level tests (mvp-smoke.test.ts)
+ *
+ * Tests reuse the same registration functions so a typo in production
+ * (e.g., a flag mismatch between registration and handler) shows up at
+ * `program.parseAsync(...)` time, not just at handler dispatch (EP-04).
+ */
+/**
+ * Add the standard `--workspace <path>` / `--json` flag pair to a command.
+ * Returns the same command for chaining.
+ */
+export function withWorkspaceAndJson(cmd) {
+    return cmd
+        .option('-w, --workspace <path>', 'Workspace directory')
+        .option('--json', 'Output raw JSON');
+}
+//# sourceMappingURL=command-helpers.js.map

package/dist/commands/command-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-helpers.js","sourceRoot":"","sources":["../../src/commands/command-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,OAAO,GAAG;SACP,MAAM,CAAC,wBAAwB,EAAE,qBAAqB,CAAC;SACvD,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AACzC,CAAC"}

package/dist/commands/mvp-smoke.d.ts

@@ -0,0 +1,30 @@
+/**
+ * pd mvp smoke — MVP mainline readiness check (PRI-397 / C5).
+ *
+ * Assembles a MainlineSnapshot from the shared reader, judges it via the
+ * pure assertMainlineContract, and outputs a single JSON verdict.
+ *
+ * Rules (EP-04, EP-02):
+ *   - Read-only by default. NEVER mutates workspace state.
+ *   - Uses the shared mainline-snapshot-assembler (no new chain logic).
+ *   - --json mode: stdout = exactly one parseable JSON object — even on failure.
+ *     Every degraded/refused path emits a structured `{ok, reason, nextAction}`
+ *     JSON so CI/script consumers can branch on outcome (EP-04 Rule 6).
+ *   - Human mode: formatted output to stdout.
+ *   - Exit code: 0 on overall === 'ok', 1 on overall === 'violation' or failure.
+ */
+import type { Command } from 'commander';
+export interface MvpSmokeOptions {
+    workspace?: string;
+    json?: boolean;
+}
+export declare function handleMvpSmoke(opts: MvpSmokeOptions): Promise<void>;
+/**
+ * Register the `pd mvp` parent command and its `smoke` subcommand.
+ *
+ * Single source of truth for both production (`index.ts`) and parser tests
+ * (`mvp-smoke.test.ts`). If a test passes against this function, the same
+ * registration runs in production — flag typos surface at parseAsync time.
+ */
+export declare function registerMvpCommands(program: Command): Command;
+//# sourceMappingURL=mvp-smoke.d.ts.map

package/dist/commands/mvp-smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvp-smoke.d.ts","sourceRoot":"","sources":["../../src/commands/mvp-smoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAyCD,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEzE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAe7D"}

package/dist/commands/mvp-smoke.js

@@ -0,0 +1,139 @@
+/**
+ * pd mvp smoke — MVP mainline readiness check (PRI-397 / C5).
+ *
+ * Assembles a MainlineSnapshot from the shared reader, judges it via the
+ * pure assertMainlineContract, and outputs a single JSON verdict.
+ *
+ * Rules (EP-04, EP-02):
+ *   - Read-only by default. NEVER mutates workspace state.
+ *   - Uses the shared mainline-snapshot-assembler (no new chain logic).
+ *   - --json mode: stdout = exactly one parseable JSON object — even on failure.
+ *     Every degraded/refused path emits a structured `{ok, reason, nextAction}`
+ *     JSON so CI/script consumers can branch on outcome (EP-04 Rule 6).
+ *   - Human mode: formatted output to stdout.
+ *   - Exit code: 0 on overall === 'ok', 1 on overall === 'violation' or failure.
+ */
+import { assembleMainlineSnapshot, assertMainlineContract, } from '../services/mainline-snapshot-assembler.js';
+import { resolveWorkspaceDir } from '../resolve-workspace.js';
+import { withWorkspaceAndJson } from './command-helpers.js';
+/**
+ * Classify a thrown error so the failure JSON can name a real next action.
+ * EP-03: never silently swallow; emit a structured reason + actionable next step.
+ */
+function classifySmokeError(err) {
+    if (err instanceof Error) {
+        const msg = err.message;
+        const lower = msg.toLowerCase();
+        // No .pd/state.db on disk (fresh / reset workspace) is the post-PRI-398
+        // expected first failure — name the recovery path explicitly.
+        if (msg.includes('SQLITE_CANTOPEN') ||
+            lower.includes('no such file') ||
+            lower.includes('no such table') ||
+            lower.includes('cannot open database') ||
+            lower.includes('directory does not exist')) {
+            return {
+                reason: `Workspace database is missing or unreadable: ${msg}`,
+                nextAction: 'Run "pd runtime internalization integrity-repair --confirm" or restore the workspace; this command requires a bootstrapped .pd/state.db.',
+            };
+        }
+        if (lower.includes('workspace') && lower.includes('not configured')) {
+            return {
+                reason: msg,
+                nextAction: 'Set --workspace <path>, PD_WORKSPACE_DIR, or add workspace.default to .pd/config.yaml.',
+            };
+        }
+        return {
+            reason: msg,
+            nextAction: 'Inspect the workspace state and retry. Run "pd config doctor --json" to validate the workspace.',
+        };
+    }
+    return {
+        reason: `Unknown failure: ${String(err)}`,
+        nextAction: 'Inspect the workspace state and retry. Run "pd config doctor --json" to validate the workspace.',
+    };
+}
+export async function handleMvpSmoke(opts) {
+    // Pass through resolveWorkspaceDir to honor the consistency warning for
+    // --workspace flags that disagree with the config default. The resolver
+    // returns an absolute, normalized path either way.
+    const workspaceDir = resolveWorkspaceDir(opts.workspace);
+    let result;
+    try {
+        result = await assembleMainlineSnapshot({ workspaceDir });
+    }
+    catch (err) {
+        const { reason, nextAction } = classifySmokeError(err);
+        if (opts.json) {
+            // EP-04 Rule 1 + 6: stdout = exactly one parseable JSON object carrying
+            // a structured reason and nextAction, even on the failure path.
+            console.log(JSON.stringify({
+                ok: false,
+                reason,
+                nextAction,
+                workspace: workspaceDir,
+            }, null, 2));
+        }
+        else {
+            console.error(`MVP smoke failed: ${reason}`);
+            console.error(`nextAction: ${nextAction}`);
+        }
+        process.exit(1);
+        return;
+    }
+    const verdict = assertMainlineContract(result.snapshot);
+    if (opts.json) {
+        console.log(JSON.stringify({
+            ok: verdict.overall === 'ok',
+            verdict,
+            warnings: result.warnings,
+            resolvedPainId: result.resolvedPainId,
+        }, null, 2));
+    }
+    else {
+        console.log(`\nMVP Smoke — ${workspaceDir}\n`);
+        console.log(`  Overall:      ${verdict.overall}`);
+        console.log(`  Pain ID:      ${verdict.painId ?? '(none)'}`);
+        console.log(`  Generated At: ${verdict.generatedAt}\n`);
+        console.log('  Stages:');
+        for (const s of verdict.stages) {
+            const icon = s.status === 'ok' ? '  OK' : s.status === 'violation' ? ' VIOLATION' : ' SKIP';
+            console.log(`    [${icon}] ${s.stage}`);
+            console.log(`           ${s.reason}`);
+            if (s.nextAction) {
+                console.log(`           nextAction: ${s.nextAction}`);
+            }
+            console.log('');
+        }
+        if (result.warnings.length > 0) {
+            console.log('  Warnings:');
+            for (const w of result.warnings) {
+                console.log(`    - ${w}`);
+            }
+            console.log('');
+        }
+    }
+    if (verdict.overall === 'violation') {
+        process.exit(1);
+        return;
+    }
+}
+/**
+ * Register the `pd mvp` parent command and its `smoke` subcommand.
+ *
+ * Single source of truth for both production (`index.ts`) and parser tests
+ * (`mvp-smoke.test.ts`). If a test passes against this function, the same
+ * registration runs in production — flag typos surface at parseAsync time.
+ */
+export function registerMvpCommands(program) {
+    const mvpCmd = program
+        .command('mvp')
+        .description('MVP readiness commands');
+    withWorkspaceAndJson(mvpCmd
+        .command('smoke')
+        .description('Check MVP mainline readiness: assemble snapshot → assert contract → structured verdict')
+        .action(async (opts) => {
+        await handleMvpSmoke({ workspace: opts.workspace, json: opts.json });
+    }));
+    return mvpCmd;
+}
+//# sourceMappingURL=mvp-smoke.js.map

package/dist/commands/mvp-smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvp-smoke.js","sourceRoot":"","sources":["../../src/commands/mvp-smoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAO5D;;;GAGG;AACH,SAAS,kBAAkB,CAAC,GAAY;IACtC,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC;QACxB,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,wEAAwE;QACxE,8DAA8D;QAC9D,IACE,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAC/B,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC9B,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;YAC/B,KAAK,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACtC,KAAK,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAC1C,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,gDAAgD,GAAG,EAAE;gBAC7D,UAAU,EAAE,0IAA0I;aACvJ,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACpE,OAAO;gBACL,MAAM,EAAE,GAAG;gBACX,UAAU,EAAE,wFAAwF;aACrG,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,iGAAiG;SAC9G,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,oBAAoB,MAAM,CAAC,GAAG,CAAC,EAAE;QACzC,UAAU,EAAE,iGAAiG;KAC9G,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAqB;IACxD,wEAAwE;IACxE,wEAAwE;IACxE,mDAAmD;IACnD,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEzD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,wBAAwB,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,wEAAwE;YACxE,gEAAgE;YAChE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACzB,EAAE,EAAE,KAAK;gBACT,MAAM;gBACN,UAAU;gBACV,SAAS,EAAE,YAAY;aACxB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAExD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;YACzB,EAAE,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;YAC5B,OAAO;YACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,cAAc,EAAE,MAAM,CAAC,cAAc;SACtC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iBAAiB,YAAY,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;QAExD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5F,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACtC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,wBAAwB,CAAC,CAAC;IAEzC,oBAAoB,CAClB,MAAM;SACH,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,wFAAwF,CAAC;SACrG,MAAM,CAAC,KAAK,EAAE,IAA4C,EAAE,EAAE;QAC7D,MAAM,cAAc,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CACL,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/runtime.d.ts

@@ -1,3 +1,4 @@
+import type { Command } from 'commander';
 interface RuntimeProbeOptions {
     runtime: string;
     openclawLocal?: boolean;
@@ -16,5 +17,10 @@ interface RuntimeProbeOptions {
  * pd runtime probe — dispatches to openclaw-cli, pi-ai, or config branch.
  */
 export declare function handleRuntimeProbe(opts: RuntimeProbeOptions): Promise<void>;
+/**
+ * Register the `pd runtime probe` command on a Commander instance.
+ * Used by index.ts and tests to ensure real command wiring is verified (EP-04).
+ */
+export declare function registerRuntimeProbeCommand(runtimeCmd: Command): Command;
 export {};
 //# sourceMappingURL=runtime.d.ts.map