@proletariat/cli 0.3.35 → 0.3.40

package/dist/commands/category/list.js

@@ -1,9 +1,11 @@
 import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 import { styles } from '../../lib/styles.js';
 export default class CategoryList extends PMOCommand {
     static description = 'List categories for ticket or status types';
     static examples = [
+        '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --type ticket',
         '<%= config.bin %> <%= command.id %> --type status',
         '<%= config.bin %> <%= command.id %> --type ticket --builtin',
@@ -13,9 +15,8 @@ export default class CategoryList extends PMOCommand {
         ...pmoBaseFlags,
         type: Flags.string({
             char: 't',
-            description: 'Category type to list',
+            description: 'Category type to list (omit to list all)',
             options: ['ticket', 'status'],
-            required: true,
         }),
         builtin: Flags.boolean({
             description: 'Show only built-in categories',
@@ -36,25 +37,52 @@ export default class CategoryList extends PMOCommand {
     async execute() {
         const { flags } = await this.parse(CategoryList);
         const categoryType = flags.type;
-        const filter = { type: categoryType };
+        const filter = {};
+        if (categoryType)
+            filter.type = categoryType;
         if (flags.builtin)
             filter.isBuiltin = true;
         if (flags.custom)
             filter.isBuiltin = false;
         const categories = await this.storage.listCategories(filter);
-        if (flags.json || flags.machine) {
+        if (shouldOutputJson(flags)) {
             this.log(JSON.stringify(categories, null, 2));
             return;
         }
         if (categories.length === 0) {
-            this.log(styles.muted(`\nNo ${categoryType} categories found.`));
-            this.log(styles.muted(`Create one: prlt category create --type ${categoryType}`));
+            const typeStr = categoryType ? `${categoryType} ` : '';
+            this.log(styles.muted(`\nNo ${typeStr}categories found.`));
+            this.log(styles.muted(`Create one: prlt category create --type ticket`));
             return;
         }
-        const typeLabel = categoryType === 'ticket' ? 'Ticket' : 'Status';
-        this.log(`\n📁 ${styles.emphasis(`${typeLabel} Categories`)}`);
-        this.log('═'.repeat(60));
-        // Group by builtin vs custom
+        if (categoryType) {
+            // Single type: show as before
+            const typeLabel = categoryType === 'ticket' ? 'Ticket' : 'Status';
+            this.log(`\n📁 ${styles.emphasis(`${typeLabel} Categories`)}`);
+            this.log('═'.repeat(60));
+            this.printCategoryGroup(categories, flags);
+            this.log('');
+            this.log(styles.muted(`Create new: prlt category create --type ${categoryType} <name>`));
+            this.log('');
+        }
+        else {
+            // All types: group by type
+            const ticketCategories = categories.filter(c => c.type === 'ticket');
+            const statusCategories = categories.filter(c => c.type === 'status');
+            if (ticketCategories.length > 0) {
+                this.log(`\n📁 ${styles.emphasis('Ticket Categories')}`);
+                this.log('═'.repeat(60));
+                this.printCategoryGroup(ticketCategories, flags);
+            }
+            if (statusCategories.length > 0) {
+                this.log(`\n📁 ${styles.emphasis('Status Categories')}`);
+                this.log('═'.repeat(60));
+                this.printCategoryGroup(statusCategories, flags);
+            }
+            this.log('');
+        }
+    }
+    printCategoryGroup(categories, flags) {
         const builtinCategories = categories.filter(c => c.isBuiltin);
         const customCategories = categories.filter(c => !c.isBuiltin);
         if (builtinCategories.length > 0 && !flags.custom) {
@@ -71,9 +99,6 @@ export default class CategoryList extends PMOCommand {
                 this.printCategory(category);
             }
         }
-        this.log('');
-        this.log(styles.muted(`Create new: prlt category create --type ${categoryType} <name>`));
-        this.log('');
     }
     printCategory(category) {
         const builtinBadge = category.isBuiltin ? '' : ' [custom]';

package/dist/commands/{claude.d.ts → claude/index.d.ts}

@@ -1,4 +1,4 @@
-import { PromptCommand } from '../lib/prompt-command.js';
+import { PromptCommand } from '../../lib/prompt-command.js';
 export default class Claude extends PromptCommand {
     static description: string;
     static examples: string[];

package/dist/commands/{claude.js → claude/index.js}

@@ -3,18 +3,18 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
 import { execSync } from 'node:child_process';
-import { PromptCommand } from '../lib/prompt-command.js';
-import { machineOutputFlags } from '../lib/pmo/index.js';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
 import Database from 'better-sqlite3';
-import { findHQRoot } from '../lib/workspace.js';
-import { getWorkspaceInfo, createEphemeralAgent, } from '../lib/agents/commands.js';
-import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../lib/prompt-json.js';
-import { styles } from '../lib/styles.js';
-import { DEFAULT_EXECUTION_CONFIG, } from '../lib/execution/types.js';
-import { runExecution, isDockerRunning, isGitHubTokenAvailable, isDevcontainerCliInstalled } from '../lib/execution/runners.js';
-import { ExecutionStorage } from '../lib/execution/storage.js';
-import { loadExecutionConfig, getTerminalApp, promptTerminalPreference, getShell, promptShellPreference, hasTerminalPreference, hasShellPreference, } from '../lib/execution/config.js';
-import { hasDevcontainerConfig } from '../lib/execution/devcontainer.js';
+import { findHQRoot } from '../../lib/workspace.js';
+import { getWorkspaceInfo, createEphemeralAgent, } from '../../lib/agents/commands.js';
+import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { DEFAULT_EXECUTION_CONFIG, } from '../../lib/execution/types.js';
+import { runExecution, isDockerRunning, isGitHubTokenAvailable, isDevcontainerCliInstalled } from '../../lib/execution/runners.js';
+import { ExecutionStorage } from '../../lib/execution/storage.js';
+import { loadExecutionConfig, getTerminalApp, promptTerminalPreference, getShell, promptShellPreference, hasTerminalPreference, hasShellPreference, } from '../../lib/execution/config.js';
+import { hasDevcontainerConfig } from '../../lib/execution/devcontainer.js';
 // Catch-all devcontainer image for directories without .devcontainer
 const CATCHALL_DEVCONTAINER_IMAGE = 'ghcr.io/chrismcdermut/proletariat-claude:latest';
 /**
@@ -450,7 +450,7 @@ export default class Claude extends PromptCommand {
         const executionStorage = new ExecutionStorage(db);
         try {
             // Import PMO storage for ticket/project operations
-            const { getPMOContext } = await import('../lib/pmo/index.js');
+            const { getPMOContext } = await import('../../lib/pmo/index.js');
             let pmoPath;
             let storage;
             try {

package/dist/commands/claude/open.d.ts

@@ -0,0 +1,13 @@
+import { PromptCommand } from '../../lib/prompt-command.js';
+export default class Open extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        directory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        prompt: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/claude/open.js

@@ -0,0 +1,175 @@
+import { Flags } from '@oclif/core';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import Database from 'better-sqlite3';
+import { PromptCommand } from '../../lib/prompt-command.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { findHQRoot } from '../../lib/workspace.js';
+import { getWorkspaceInfo } from '../../lib/agents/commands.js';
+import { shouldOutputJson, outputErrorAsJson, outputSuccessAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { styles } from '../../lib/styles.js';
+import { DEFAULT_EXECUTION_CONFIG, } from '../../lib/execution/types.js';
+import { runExecution } from '../../lib/execution/runners.js';
+import { loadExecutionConfig, getTerminalApp, promptTerminalPreference, getShell, promptShellPreference, hasTerminalPreference, hasShellPreference, } from '../../lib/execution/config.js';
+export default class Open extends PromptCommand {
+    static description = 'Open Claude Code in a new terminal tab (side-by-side workflow)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --agent altman',
+        '<%= config.bin %> <%= command.id %> --directory /path/to/project',
+        '<%= config.bin %> <%= command.id %> --prompt "help me debug the auth flow"',
+    ];
+    static flags = {
+        ...machineOutputFlags,
+        agent: Flags.string({
+            char: 'a',
+            description: 'Open in an agent\'s workspace directory',
+        }),
+        directory: Flags.string({
+            char: 'C',
+            description: 'Directory to open in (default: current directory)',
+        }),
+        prompt: Flags.string({
+            char: 'p',
+            description: 'Initial prompt for Claude Code',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(Open);
+        const jsonMode = shouldOutputJson(flags);
+        // Resolve the target directory
+        let workDir;
+        let label;
+        if (flags.agent) {
+            // Resolve agent workspace directory
+            let workspaceInfo;
+            try {
+                workspaceInfo = getWorkspaceInfo();
+            }
+            catch {
+                if (jsonMode) {
+                    outputErrorAsJson('NO_WORKSPACE', 'Not in an HQ or workspace. --agent requires an HQ.', createMetadata('open', flags));
+                }
+                this.error('Not in an HQ or workspace. --agent requires an HQ.');
+            }
+            const agent = workspaceInfo.agents.find(a => a.name === flags.agent);
+            if (!agent) {
+                const available = workspaceInfo.agents.map(a => a.name).join(', ');
+                const msg = `Agent "${flags.agent}" not found. Available: ${available || 'none'}`;
+                if (jsonMode) {
+                    outputErrorAsJson('AGENT_NOT_FOUND', msg, createMetadata('open', flags));
+                }
+                this.error(msg);
+            }
+            workDir = agent.type === 'ephemeral'
+                ? path.join(workspaceInfo.path, 'agents', workspaceInfo.ephemeralAgentsDir, flags.agent)
+                : path.join(workspaceInfo.path, 'agents', workspaceInfo.persistentAgentsDir, flags.agent);
+            label = flags.agent;
+        }
+        else if (flags.directory) {
+            workDir = path.resolve(flags.directory);
+            label = path.basename(workDir);
+        }
+        else {
+            workDir = process.cwd();
+            label = path.basename(workDir);
+        }
+        // Validate directory exists
+        if (!fs.existsSync(workDir)) {
+            if (jsonMode) {
+                outputErrorAsJson('DIRECTORY_NOT_FOUND', `Directory not found: ${workDir}`, createMetadata('open', flags));
+            }
+            this.error(`Directory not found: ${workDir}`);
+        }
+        // Build execution context
+        const sessionName = `open-${label}`;
+        const context = {
+            ticketId: 'OPEN',
+            ticketTitle: `Open: ${label}`,
+            agentName: label,
+            agentDir: workDir,
+            worktreePath: workDir,
+            branch: 'main',
+            actionName: 'open',
+            actionPrompt: flags.prompt,
+            modifiesCode: false,
+        };
+        // Try to find HQ for execution config, fall back to home dir config
+        const hqPath = findHQRoot(workDir);
+        if (hqPath) {
+            context.hqPath = hqPath;
+        }
+        // Load execution config
+        const executionConfig = { ...DEFAULT_EXECUTION_CONFIG };
+        executionConfig.outputMode = 'interactive';
+        executionConfig.sandboxed = false; // Default to dangerously-skip-permissions for quick open
+        // Try to load saved preferences from workspace DB or home dir
+        const dbPath = hqPath
+            ? path.join(hqPath, '.proletariat', 'workspace.db')
+            : path.join(process.env.HOME || '', '.proletariat', 'adhoc.db');
+        let db = null;
+        try {
+            if (fs.existsSync(dbPath)) {
+                db = new Database(dbPath);
+                const savedConfig = loadExecutionConfig(db);
+                executionConfig.terminal = savedConfig.terminal;
+                executionConfig.shell = savedConfig.shell;
+                executionConfig.tmux = savedConfig.tmux;
+            }
+        }
+        catch {
+            // Ignore config loading errors, use defaults
+        }
+        // If no terminal preference saved, prompt for it (first run only)
+        if (!jsonMode && db) {
+            if (!hasTerminalPreference(db)) {
+                executionConfig.terminal.app = await promptTerminalPreference(db);
+            }
+            else {
+                executionConfig.terminal.app = await getTerminalApp(db);
+            }
+            if (!hasShellPreference(db)) {
+                executionConfig.shell = await promptShellPreference(db);
+            }
+            else {
+                executionConfig.shell = await getShell(db);
+            }
+        }
+        if (db) {
+            db.close();
+        }
+        // Show what we're doing
+        if (!jsonMode) {
+            this.log('');
+            this.log(styles.muted(`   Opening Claude Code in new tab...`));
+            this.log(styles.muted(`   Directory: ${workDir}`));
+            if (flags.prompt) {
+                this.log(styles.muted(`   Prompt: "${flags.prompt.substring(0, 60)}${flags.prompt.length > 60 ? '...' : ''}"`));
+            }
+            this.log('');
+        }
+        // Launch Claude Code in a new terminal tab
+        const result = await runExecution('host', context, 'claude-code', executionConfig, {
+            displayMode: 'terminal',
+        });
+        if (result.success) {
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    directory: workDir,
+                    sessionId: result.sessionId,
+                    sessionName,
+                }, createMetadata('open', flags));
+            }
+            this.log(styles.success(`✓ Claude Code opened in new tab`));
+            if (result.sessionId) {
+                this.log(styles.muted(`   Session: ${result.sessionId}`));
+            }
+        }
+        else {
+            if (jsonMode) {
+                outputErrorAsJson('EXECUTION_FAILED', `Failed to open: ${result.error}`, createMetadata('open', flags));
+            }
+            this.error(`Failed to open: ${result.error}`);
+        }
+    }
+}

package/dist/commands/diet.js

@@ -1,5 +1,6 @@
 import { Flags } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../lib/pmo/base-command.js';
+import { shouldOutputJson } from '../lib/prompt-json.js';
 import { styles, divider } from '../lib/styles.js';
 import { loadDietConfig, saveDietConfig, parseDietString, formatDietConfig, } from '../lib/pmo/diet.js';
 export default class Diet extends PMOCommand {
@@ -23,6 +24,7 @@ export default class Diet extends PMOCommand {
     };
     async execute() {
         const { flags } = await this.parse(Diet);
+        const jsonMode = shouldOutputJson(flags);
         const projectId = await this.requireProject();
         const db = this.storage.getDatabase();
         // Handle --set
@@ -30,7 +32,12 @@ export default class Diet extends PMOCommand {
             try {
                 const newConfig = parseDietString(flags.set);
                 saveDietConfig(db, newConfig);
-                this.log(styles.success(`Diet updated: ${formatDietConfig(newConfig)}`));
+                if (jsonMode) {
+                    this.log(JSON.stringify({ type: 'success', result: { action: 'set', diet: newConfig } }, null, 2));
+                }
+                else {
+                    this.log(styles.success(`Diet updated: ${formatDietConfig(newConfig)}`));
+                }
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
@@ -42,12 +49,21 @@ export default class Diet extends PMOCommand {
         if (flags.reset) {
             const { DEFAULT_DIET_CONFIG } = await import('../lib/pmo/diet.js');
             saveDietConfig(db, DEFAULT_DIET_CONFIG);
-            this.log(styles.success(`Diet reset to defaults: ${formatDietConfig(DEFAULT_DIET_CONFIG)}`));
+            if (jsonMode) {
+                this.log(JSON.stringify({ type: 'success', result: { action: 'reset', diet: DEFAULT_DIET_CONFIG } }, null, 2));
+            }
+            else {
+                this.log(styles.success(`Diet reset to defaults: ${formatDietConfig(DEFAULT_DIET_CONFIG)}`));
+            }
             return;
         }
         // Show diet report
         const dietConfig = loadDietConfig(db);
         const report = await this.buildDietReport(projectId, dietConfig);
+        if (jsonMode) {
+            this.log(JSON.stringify({ type: 'success', result: { diet: dietConfig, report } }, null, 2));
+            return;
+        }
         this.displayDietReport(report, dietConfig);
     }
     /**

package/dist/commands/docker/logs.js

@@ -8,6 +8,7 @@ import { ExecutionStorage } from '../../lib/execution/storage.js';
 import { isDockerRunning } from '../../lib/execution/runners.js';
 import { resolveContainerId } from '../../lib/docker/resolve.js';
 import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class DockerLogs extends Command {
     static description = 'View logs from a container (by execution ID, agent name, or container ID)';
     static examples = [
@@ -42,6 +43,7 @@ export default class DockerLogs extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(DockerLogs);
+        const jsonMode = shouldOutputJson(flags);
         if (!isDockerRunning()) {
             this.error('Docker is not running. Start Docker Desktop or the Docker daemon first.');
         }
@@ -81,9 +83,11 @@ export default class DockerLogs extends Command {
                 dockerArgs.push('--timestamps');
             }
             dockerArgs.push(result.containerId);
-            this.log(`\n${styles.header(`Logs for ${result.displayName}`)}`);
-            this.log(styles.muted(`Container: ${result.containerId}`));
-            this.log('─'.repeat(60) + '\n');
+            if (!jsonMode) {
+                this.log(`\n${styles.header(`Logs for ${result.displayName}`)}`);
+                this.log(styles.muted(`Container: ${result.containerId}`));
+                this.log('─'.repeat(60) + '\n');
+            }
             db.close();
             if (flags.follow) {
                 // Stream logs

package/dist/commands/docker/shell.js

@@ -8,6 +8,7 @@ import { ExecutionStorage } from '../../lib/execution/storage.js';
 import { isDockerRunning } from '../../lib/execution/runners.js';
 import { resolveContainerId, isContainerRunning } from '../../lib/docker/resolve.js';
 import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class DockerShell extends Command {
     static description = 'Open a shell in a running container (by execution ID, agent name, or container ID)';
     static examples = [
@@ -39,6 +40,11 @@ export default class DockerShell extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(DockerShell);
+        if (shouldOutputJson(flags)) {
+            this.log(JSON.stringify({ type: 'error', error: { code: 'REQUIRES_TTY', message: 'docker shell requires an interactive terminal' } }));
+            this.exit(1);
+            return;
+        }
         if (!isDockerRunning()) {
             this.error('Docker is not running. Start Docker Desktop or the Docker daemon first.');
         }

package/dist/commands/docker/start.js

@@ -8,6 +8,7 @@ import { ExecutionStorage } from '../../lib/execution/storage.js';
 import { isDockerRunning } from '../../lib/execution/runners.js';
 import { resolveContainerId, isContainerRunning, sanitizeContainerId } from '../../lib/docker/resolve.js';
 import { machineOutputFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class DockerStart extends Command {
     static description = 'Start a stopped container (by execution ID, agent name, or container ID)';
     static examples = [
@@ -31,6 +32,7 @@ export default class DockerStart extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(DockerStart);
+        const jsonMode = shouldOutputJson(flags);
         if (!isDockerRunning()) {
             this.error('Docker is not running. Start Docker Desktop or the Docker daemon first.');
         }
@@ -60,15 +62,24 @@ export default class DockerStart extends Command {
             }
             // Check if container is already running
             if (isContainerRunning(result.containerId)) {
+                if (jsonMode) {
+                    this.log(JSON.stringify({ type: 'success', result: { containerId: result.containerId, displayName: result.displayName, executionId: result.executionId, status: 'already_running' } }, null, 2));
+                    db.close();
+                    return;
+                }
                 this.log(`\n${styles.warning(`Container ${result.displayName} is already running`)}\n`);
                 db.close();
                 return;
             }
-            this.log(`\n${styles.header('Start Container')}`);
-            this.log(styles.muted(`Target: ${result.displayName}`));
-            this.log(styles.muted(`Container: ${result.containerId.substring(0, 12)}\n`));
+            if (!jsonMode) {
+                this.log(`\n${styles.header('Start Container')}`);
+                this.log(styles.muted(`Target: ${result.displayName}`));
+                this.log(styles.muted(`Container: ${result.containerId.substring(0, 12)}\n`));
+            }
             // Start container
-            this.log(styles.muted('Starting container...'));
+            if (!jsonMode) {
+                this.log(styles.muted('Starting container...'));
+            }
             try {
                 const attachFlag = flags.attach ? '-a' : '';
                 const safeId = sanitizeContainerId(result.containerId);
@@ -79,6 +90,11 @@ export default class DockerStart extends Command {
                 if (result.executionId) {
                     executionStorage.updateStatus(result.executionId, 'running');
                 }
+                if (jsonMode) {
+                    this.log(JSON.stringify({ type: 'success', result: { containerId: result.containerId, displayName: result.displayName, executionId: result.executionId, status: 'started' } }, null, 2));
+                    db.close();
+                    return;
+                }
                 this.log(`${styles.success('Container started successfully')}\n`);
             }
             catch (error) {

package/dist/commands/docker/sync.d.ts

@@ -2,6 +2,10 @@ import { Command } from '@oclif/core';
 export default class DockerSync extends Command {
     static description: string;
     static examples: string[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
     run(): Promise<void>;
     /**
      * Get raw container info from Docker

package/dist/commands/docker/sync.js

@@ -7,12 +7,19 @@ import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ContainerStorage } from '../../lib/execution/storage.js';
 import { isDockerRunning } from '../../lib/execution/runners.js';
 import { visualPadEnd } from '../../lib/string-utils.js';
+import { shouldOutputJson } from '../../lib/prompt-json.js';
+import { machineOutputFlags } from '../../lib/pmo/index.js';
 export default class DockerSync extends Command {
     static description = 'Sync container status from Docker into the database';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
     ];
+    static flags = {
+        ...machineOutputFlags,
+    };
     async run() {
+        const { flags } = await this.parse(DockerSync);
+        const jsonMode = shouldOutputJson(flags);
         if (!isDockerRunning()) {
             this.error('Docker is not running. Start Docker Desktop or the Docker daemon first.');
         }
@@ -37,8 +44,10 @@ export default class DockerSync extends Command {
             const containerStorage = new ContainerStorage(db);
             // Get devcontainers from Docker
             const dockerContainers = this.getDockerContainers();
-            this.log(`\n${styles.header('Syncing Containers')}`);
-            this.log(styles.muted(`Found ${dockerContainers.length} devcontainers in Docker\n`));
+            if (!jsonMode) {
+                this.log(`\n${styles.header('Syncing Containers')}`);
+                this.log(styles.muted(`Found ${dockerContainers.length} devcontainers in Docker\n`));
+            }
             // Add agent name from image (only used for new containers)
             const containersWithAgent = dockerContainers.map(c => ({
                 ...c,
@@ -46,6 +55,25 @@ export default class DockerSync extends Command {
             }));
             // Sync with database
             const result = containerStorage.syncFromDocker(containersWithAgent);
+            if (jsonMode) {
+                const containers = containerStorage.listContainers({ limit: 20 });
+                this.log(JSON.stringify({
+                    type: 'success',
+                    result: {
+                        added: result.added,
+                        updated: result.updated,
+                        removed: result.removed,
+                        containers: containers.map(c => ({
+                            id: c.id,
+                            agentName: c.agentName,
+                            status: c.status,
+                            dockerId: c.dockerId,
+                        })),
+                    },
+                }, null, 2));
+                db.close();
+                return;
+            }
             this.log(styles.success('✓ Sync complete'));
             this.log(styles.muted(`  Added: ${result.added}`));
             this.log(styles.muted(`  Updated: ${result.updated}`));

package/dist/commands/epic/show.d.ts

@@ -0,0 +1,13 @@
+import EpicView from './view.js';
+export default class EpicShow extends EpicView {
+    static description: string;
+    static hidden: boolean;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+}

package/dist/commands/epic/show.js

@@ -0,0 +1,16 @@
+import { Args } from '@oclif/core';
+import { pmoBaseFlags } from '../../lib/pmo/index.js';
+import EpicView from './view.js';
+export default class EpicShow extends EpicView {
+    static description = 'View epic details and linked tickets (alias for epic view)';
+    static hidden = true;
+    static args = {
+        id: Args.string({
+            description: 'Epic ID',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+    };
+}

package/dist/commands/epic/ticket.js

@@ -81,11 +81,10 @@ export default class EpicTicket extends PMOCommand {
             this.log(styles.muted('\nNo tickets found.'));
             return;
         }
-        // Get epic_id for each ticket via direct DB query
-        const db = this.storage.db;
+        // Helper to get ticket's epic ID from the loaded ticket list
         const getTicketEpicId = (ticketId) => {
-            const row = db.prepare(`SELECT epic_id FROM pmo_tickets WHERE id = ?`).get(ticketId);
-            return row?.epic_id || null;
+            const ticket = allTickets.find((t) => t.id === ticketId);
+            return ticket?.epicId ?? null;
         };
         let epicId = args.id;
         // If no epic ID provided, prompt for selection
@@ -201,11 +200,7 @@ export default class EpicTicket extends PMOCommand {
                     this.log(styles.muted(`  ${ticketId} is not linked to ${epicId}, skipping`));
                     continue;
                 }
-                db.prepare(`
-          UPDATE pmo_tickets
-          SET epic_id = NULL, updated_at = ?
-          WHERE id = ?
-        `).run(Date.now(), ticketId);
+                await this.storage.unlinkTicketFromEpic(ticketId);
             }
             else {
                 // Link: check if already linked to same epic
@@ -253,11 +248,7 @@ export default class EpicTicket extends PMOCommand {
                     }
                     if (action === 'use_epic') {
                         // Update ticket to use epic's spec
-                        db.prepare(`
-              UPDATE pmo_tickets
-              SET spec_id = ?, updated_at = ?
-              WHERE id = ?
-            `).run(epicSpecId, Date.now(), ticketId);
+                        await this.storage.updateTicket(ticketId, { specId: epicSpecId });
                         this.log(styles.muted(`  Updated ${ticketId} to use spec "${epicSpecId}"`));
                     }
                 }
@@ -284,19 +275,11 @@ export default class EpicTicket extends PMOCommand {
                         inherit = result.inherit;
                     }
                     if (inherit) {
-                        db.prepare(`
-              UPDATE pmo_tickets
-              SET spec_id = ?, updated_at = ?
-              WHERE id = ?
-            `).run(epicSpecId, Date.now(), ticketId);
+                        await this.storage.updateTicket(ticketId, { specId: epicSpecId });
                         this.log(styles.muted(`  Assigned spec "${epicSpecId}" to ${ticketId}`));
                     }
                 }
-                db.prepare(`
-          UPDATE pmo_tickets
-          SET epic_id = ?, updated_at = ?
-          WHERE id = ?
-        `).run(epicId, Date.now(), ticketId);
+                await this.storage.linkTicketToEpic(ticketId, epicId);
             }
             linkedTickets.push(`${ticketId}: ${ticket.title}`);
             successCount++;