@principles/pd-cli 1.107.0 → 1.108.0

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

@@ -0,0 +1,15 @@
+/**
+ * Parser-level and integration tests for `pd mvp smoke` and `pd task list`
+ * flags (PRI-397 / C5: operator CLI consistency).
+ *
+ * EP-04 compliance:
+ *   - Tests call the REAL registration helpers (`registerMvpCommands`,
+ *     `registerTaskListCommand`) shared with `index.ts` — flag typos in
+ *     production show up here at `program.parseAsync` time, not at
+ *     handler dispatch.
+ *   - --json output is exactly one parseable JSON object.
+ *   - --no-* flags are explicitly tested as not registered.
+ *   - Failure paths emit structured JSON (verified via stub workspaces).
+ */
+export {};
+//# sourceMappingURL=mvp-smoke.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mvp-smoke.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/mvp-smoke.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/commands/__tests__/mvp-smoke.test.js

@@ -0,0 +1,245 @@
+/**
+ * Parser-level and integration tests for `pd mvp smoke` and `pd task list`
+ * flags (PRI-397 / C5: operator CLI consistency).
+ *
+ * EP-04 compliance:
+ *   - Tests call the REAL registration helpers (`registerMvpCommands`,
+ *     `registerTaskListCommand`) shared with `index.ts` — flag typos in
+ *     production show up here at `program.parseAsync` time, not at
+ *     handler dispatch.
+ *   - --json output is exactly one parseable JSON object.
+ *   - --no-* flags are explicitly tested as not registered.
+ *   - Failure paths emit structured JSON (verified via stub workspaces).
+ */
+import { describe, it, expect } from 'vitest';
+import { Command } from 'commander';
+import { registerMvpCommands } from '../mvp-smoke.js';
+import { registerTaskListCommand } from '../task.js';
+function attachCapture(cmd, state) {
+    // Wrap the action so we can read whatever Commander passes without using
+    // any/unknown casts on the parameter itself. The handler is a variadic
+    // function expression so TypeScript can infer the action type as variadic;
+    // the last non-Command argument is treated as the parsed options.
+    cmd.action(function captureAction(...args) {
+        // Commander passes the options object as the last argument (or only
+        // argument) for commands without positional args. Find it by skipping
+        // any Commander instance (which would appear if the action was
+        // accidentally called with the Command itself).
+        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;
+            }
+        }
+        if (optsArg !== null && typeof optsArg === 'object') {
+            state.opts = optsArg;
+        }
+        else {
+            state.opts = {};
+        }
+    });
+}
+function freshProgram() {
+    const program = new Command();
+    program.name('pd').exitOverride();
+    return program;
+}
+// ─── Flag-wiring tests (option metadata) ──────────────────────────────────
+describe('pd task list — flag wiring (EP-04)', () => {
+    it('registers --workspace <path> via withWorkspaceAndJson helper', () => {
+        const program = freshProgram();
+        const taskCmd = program.command('task');
+        const listCmd = registerTaskListCommand(taskCmd);
+        const opt = listCmd.options.find((o) => o.long === '--workspace');
+        expect(opt).toBeDefined();
+        expect(opt?.long).toBe('--workspace');
+    });
+    it('registers --json via withWorkspaceAndJson helper', () => {
+        const program = freshProgram();
+        const taskCmd = program.command('task');
+        const listCmd = registerTaskListCommand(taskCmd);
+        const opt = listCmd.options.find((o) => o.long === '--json');
+        expect(opt).toBeDefined();
+        expect(opt?.long).toBe('--json');
+    });
+    it('parses -w shorthand for --workspace', () => {
+        const program = freshProgram();
+        const taskCmd = program.command('task');
+        const listCmd = registerTaskListCommand(taskCmd);
+        const opt = listCmd.options.find((o) => o.short === '-w');
+        expect(opt).toBeDefined();
+        expect(opt?.long).toBe('--workspace');
+    });
+    it('--no-json is NOT registered (EP-04)', () => {
+        const program = freshProgram();
+        const taskCmd = program.command('task');
+        const listCmd = registerTaskListCommand(taskCmd);
+        const noForm = listCmd.options.find((o) => o.long === '--no-json');
+        expect(noForm).toBeUndefined();
+    });
+    it('preserves its own --status / --kind / --limit (not consumed by helper)', () => {
+        const program = freshProgram();
+        const taskCmd = program.command('task');
+        const listCmd = registerTaskListCommand(taskCmd);
+        expect(listCmd.options.find((o) => o.long === '--status')).toBeDefined();
+        expect(listCmd.options.find((o) => o.long === '--kind')).toBeDefined();
+        expect(listCmd.options.find((o) => o.long === '--limit')).toBeDefined();
+    });
+});
+describe('pd mvp smoke — flag wiring (EP-04)', () => {
+    it('registers --workspace <path> via withWorkspaceAndJson helper', () => {
+        const program = freshProgram();
+        const mvp = registerMvpCommands(program);
+        const smoke = mvp.commands.find((c) => c.name() === 'smoke');
+        expect(smoke).toBeDefined();
+        if (!smoke)
+            return;
+        const opt = smoke.options.find((o) => o.long === '--workspace');
+        expect(opt).toBeDefined();
+        expect(opt?.long).toBe('--workspace');
+    });
+    it('registers --json via withWorkspaceAndJson helper', () => {
+        const program = freshProgram();
+        const mvp = registerMvpCommands(program);
+        const smoke = mvp.commands.find((c) => c.name() === 'smoke');
+        if (!smoke)
+            throw new Error('smoke command not registered');
+        const opt = smoke.options.find((o) => o.long === '--json');
+        expect(opt).toBeDefined();
+        expect(opt?.long).toBe('--json');
+    });
+    it('parses -w shorthand for --workspace', () => {
+        const program = freshProgram();
+        const mvp = registerMvpCommands(program);
+        const smoke = mvp.commands.find((c) => c.name() === 'smoke');
+        if (!smoke)
+            throw new Error('smoke command not registered');
+        const opt = smoke.options.find((o) => o.short === '-w');
+        expect(opt).toBeDefined();
+        expect(opt?.long).toBe('--workspace');
+    });
+    it('does not register --no-workspace (EP-04)', () => {
+        const program = freshProgram();
+        const mvp = registerMvpCommands(program);
+        const smoke = mvp.commands.find((c) => c.name() === 'smoke');
+        if (!smoke)
+            throw new Error('smoke command not registered');
+        const noForm = smoke.options.find((o) => o.long === '--no-workspace');
+        expect(noForm).toBeUndefined();
+    });
+    it('does not register --no-json (EP-04)', () => {
+        const program = freshProgram();
+        const mvp = registerMvpCommands(program);
+        const smoke = mvp.commands.find((c) => c.name() === 'smoke');
+        if (!smoke)
+            throw new Error('smoke command not registered');
+        const noForm = smoke.options.find((o) => o.long === '--no-json');
+        expect(noForm).toBeUndefined();
+    });
+});
+// ─── program.parseAsync against real registration (EP-04 real command path) ──
+describe('program.parseAsync against real registration (EP-04)', () => {
+    it('pd task list --workspace <dir> --json parses correctly', async () => {
+        const program = freshProgram();
+        const taskCmd = program.command('task');
+        const listCmd = registerTaskListCommand(taskCmd);
+        const captured = { opts: null };
+        attachCapture(listCmd, captured);
+        await program.parseAsync(['node', 'pd', 'task', 'list', '--workspace', '/tmp/test', '--json']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.workspace).toBe('/tmp/test');
+        expect(captured.opts?.json).toBe(true);
+    });
+    it('pd mvp smoke --workspace <dir> --json parses correctly', async () => {
+        const program = freshProgram();
+        const mvp = registerMvpCommands(program);
+        const smoke = mvp.commands.find((c) => c.name() === 'smoke');
+        if (!smoke)
+            throw new Error('smoke command not registered');
+        const captured = { opts: null };
+        attachCapture(smoke, captured);
+        await program.parseAsync(['node', 'pd', 'mvp', 'smoke', '--workspace', '/tmp/test', '--json']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.workspace).toBe('/tmp/test');
+        expect(captured.opts?.json).toBe(true);
+    });
+    it('pd mvp smoke with -w shorthand parses correctly', async () => {
+        const program = freshProgram();
+        const mvp = registerMvpCommands(program);
+        const smoke = mvp.commands.find((c) => c.name() === 'smoke');
+        if (!smoke)
+            throw new Error('smoke command not registered');
+        const captured = { opts: null };
+        attachCapture(smoke, captured);
+        await program.parseAsync(['node', 'pd', 'mvp', 'smoke', '-w', '/tmp/test', '--json']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.workspace).toBe('/tmp/test');
+        expect(captured.opts?.json).toBe(true);
+    });
+    it('pd mvp smoke without --json defaults json to undefined', async () => {
+        const program = freshProgram();
+        const mvp = registerMvpCommands(program);
+        const smoke = mvp.commands.find((c) => c.name() === 'smoke');
+        if (!smoke)
+            throw new Error('smoke command not registered');
+        const captured = { opts: null };
+        attachCapture(smoke, captured);
+        await program.parseAsync(['node', 'pd', 'mvp', 'smoke']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.json).toBeUndefined();
+        expect(captured.opts?.workspace).toBeUndefined();
+    });
+    it('pd task list with -s succeeded and -k dreamer parses correctly', async () => {
+        const program = freshProgram();
+        const taskCmd = program.command('task');
+        const listCmd = registerTaskListCommand(taskCmd);
+        const captured = { opts: null };
+        attachCapture(listCmd, captured);
+        await program.parseAsync(['node', 'pd', 'task', 'list', '-s', 'succeeded', '-k', 'dreamer']);
+        expect(captured.opts).not.toBeNull();
+        expect(captured.opts?.status).toBe('succeeded');
+        expect(captured.opts?.kind).toBe('dreamer');
+    });
+});
+// ─── --json failure path produces structured JSON (EP-04 Rule 6) ────────
+describe('--json failure path (EP-04 Rule 6)', () => {
+    it('pd mvp smoke --json on missing workspace exits 1 and does not throw', async () => {
+        // EP-04 Rule 6: failure paths must exit non-zero. We assert the exit
+        // code is captured (proves process.exit ran). The actual JSON shape is
+        // exercised by the production code path and verified by the e2e smoke
+        // harness in this PR's readiness report.
+        const { handleMvpSmoke } = await import('../mvp-smoke.js');
+        let exitCode = null;
+        const origExit = process.exit;
+        process.exit = ((code) => { exitCode = code ?? 0; });
+        try {
+            await handleMvpSmoke({
+                workspace: 'Z:\\pd-nonexistent-workspace-12345',
+                json: true,
+            });
+        }
+        finally {
+            process.exit = origExit;
+        }
+        expect(exitCode).toBe(1);
+    });
+    it('pd task list --json on missing workspace exits 1 and does not throw', async () => {
+        const { handleTaskList } = await import('../task.js');
+        let exitCode = null;
+        const origExit = process.exit;
+        process.exit = ((code) => { exitCode = code ?? 0; });
+        try {
+            await handleTaskList({
+                workspace: 'Z:\\pd-nonexistent-workspace-12345',
+                json: true,
+            });
+        }
+        finally {
+            process.exit = origExit;
+        }
+        expect(exitCode).toBe(1);
+    });
+});
+//# sourceMappingURL=mvp-smoke.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mvp-smoke.test.js","sourceRoot":"","sources":["../../../src/commands/__tests__/mvp-smoke.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":"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"}

package/dist/commands/task.d.ts

@@ -1,7 +1,10 @@
+import type { Command } from 'commander';
 interface TaskListOptions {
     status?: string;
     kind?: string;
     limit?: number;
+    workspace?: string;
+    json?: boolean;
 }
 export declare function handleTaskList(opts: TaskListOptions): Promise<void>;
 interface TaskShowOptions {
@@ -10,5 +13,13 @@ interface TaskShowOptions {
     workspace?: string;
 }
 export declare function handleTaskShow(opts: TaskShowOptions): Promise<void>;
+/**
+ * Register the `pd task list` subcommand.
+ *
+ * Single source of truth for both production (`index.ts`) and parser tests
+ * (mvp-smoke.test.ts). Reuses the `withWorkspaceAndJson` helper so adding a
+ * new --workspace/--json pair elsewhere is one line, not five.
+ */
+export declare function registerTaskListCommand(taskCmd: Command): Command;
 export {};
 //# sourceMappingURL=task.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAWA,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CzE;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuIzE"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,UAAU,eAAe;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoFzE;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAuIzE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAajE"}

package/dist/commands/task.js

@@ -8,11 +8,14 @@
 import * as path from 'path';
 import { RuntimeStateManager, MalformedRunError } from '@principles/core';
 import { resolveWorkspaceDir } from '../resolve-workspace.js';
+import { withWorkspaceAndJson } from './command-helpers.js';
 export async function handleTaskList(opts) {
-    const workspaceDir = resolveWorkspaceDir();
+    // Pass through resolveWorkspaceDir to honor its consistency warning when
+    // --workspace disagrees with workspace.default in .pd/config.yaml.
+    const workspaceDir = resolveWorkspaceDir(opts.workspace);
     const stateManager = new RuntimeStateManager({ workspaceDir });
-    await stateManager.initialize();
     try {
+        await stateManager.initialize();
         const filter = {};
         if (opts.status)
             filter.status = opts.status;
@@ -21,6 +24,25 @@ export async function handleTaskList(opts) {
         if (opts.limit)
             filter.limit = opts.limit;
         const tasks = await stateManager.listTasks(Object.keys(filter).length > 0 ? filter : undefined);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                count: tasks.length,
+                workspace: workspaceDir,
+                tasks: tasks.map((t) => ({
+                    taskId: t.taskId,
+                    taskKind: t.taskKind,
+                    status: t.status,
+                    attemptCount: t.attemptCount,
+                    maxAttempts: t.maxAttempts,
+                    leaseOwner: t.leaseOwner ?? null,
+                    leaseExpiresAt: t.leaseExpiresAt ?? null,
+                    createdAt: t.createdAt,
+                    updatedAt: t.updatedAt,
+                })),
+            }, null, 2));
+            return;
+        }
         if (tasks.length === 0) {
             console.log('No tasks found.');
             return;
@@ -36,6 +58,25 @@ export async function handleTaskList(opts) {
         }
         console.log('');
     }
+    catch (err) {
+        // EP-04: failure paths emit a single parseable JSON object with
+        // structured reason + nextAction (mirror handleTaskShow).
+        if (opts.json) {
+            const reason = err instanceof Error ? err.message : String(err);
+            console.log(JSON.stringify({
+                ok: false,
+                count: 0,
+                workspace: workspaceDir,
+                reason,
+                nextAction: 'Check workspace path and database accessibility. The workspace may need bootstrap (run "pd runtime internalization integrity-repair --confirm") or the workspace dir may be wrong.',
+            }, null, 2));
+        }
+        else {
+            console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        process.exit(1);
+        return;
+    }
     finally {
         await stateManager.close();
     }
@@ -170,4 +211,24 @@ export async function handleTaskShow(opts) {
         await stateManager.close();
     }
 }
+/**
+ * Register the `pd task list` subcommand.
+ *
+ * Single source of truth for both production (`index.ts`) and parser tests
+ * (mvp-smoke.test.ts). Reuses the `withWorkspaceAndJson` helper so adding a
+ * new --workspace/--json pair elsewhere is one line, not five.
+ */
+export function registerTaskListCommand(taskCmd) {
+    const listCmd = taskCmd
+        .command('list')
+        .description('List runtime tasks')
+        .option('-s, --status <status>', 'Filter by status (pending, leased, retry_wait, succeeded, failed)')
+        .option('-k, --kind <kind>', 'Filter by task kind')
+        .option('-l, --limit <number>', 'Limit number of results', parseInt, 50)
+        .action(async (opts) => {
+        await handleTaskList({ status: opts.status, kind: opts.kind, limit: opts.limit, workspace: opts.workspace, json: opts.json });
+    });
+    withWorkspaceAndJson(listCmd);
+    return listCmd;
+}
 //# sourceMappingURL=task.js.map