@proletariat/cli 0.3.35 → 0.3.40

package/dist/commands/repo/view.js

@@ -2,7 +2,7 @@ import { Args } from '@oclif/core';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { colors, format } from '../../lib/colors.js';
 import { findHQRoot, getWorkspaceRepoInfo, } from '../../lib/repos/index.js';
-import { openWorkspaceDatabase } from '../../lib/database/index.js';
+import { getWorktreesForRepo } from '../../lib/database/index.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 import { visualPadEnd } from '../../lib/string-utils.js';
 export default class View extends PMOCommand {
@@ -102,13 +102,7 @@ export default class View extends PMOCommand {
             }
         }
         // Get agent worktree info
-        const db = openWorkspaceDatabase(hqPath);
-        const worktrees = db.prepare(`
-      SELECT agent_name, is_clean, commits_ahead, branch
-      FROM agent_worktrees
-      WHERE repo_name = ?
-    `).all(repoName);
-        db.close();
+        const worktrees = getWorktreesForRepo(hqPath, repoName);
         if (worktrees.length > 0) {
             this.log(format.subtitle('\n👥 Agent Worktrees:'));
             for (const wt of worktrees) {

package/dist/commands/session/attach.js

@@ -7,7 +7,7 @@ import Database from 'better-sqlite3';
 import { styles } from '../../lib/styles.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ExecutionStorage } from '../../lib/execution/index.js';
-import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findSessionForExecution, } from '../../lib/execution/session-utils.js';
+import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findContainerSessionsByPrefix, findSessionForExecution, } from '../../lib/execution/session-utils.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 export default class SessionAttach extends PMOCommand {
@@ -154,7 +154,7 @@ export default class SessionAttach extends PMOCommand {
                 // If sessionId is NULL, try to find session by naming convention
                 if (!exec.sessionId) {
                     if (isContainer && exec.containerId) {
-                        const containerSessions = containerTmuxSessions.get(exec.containerId) || [];
+                        const containerSessions = findContainerSessionsByPrefix(containerTmuxSessions, exec.containerId);
                         const match = findSessionForExecution(exec.ticketId, exec.agentName, containerSessions);
                         if (match) {
                             actualSessionId = match;
@@ -177,8 +177,8 @@ export default class SessionAttach extends PMOCommand {
                 else {
                     // sessionId is set, verify it exists
                     if (isContainer && exec.containerId) {
-                        const containerSessions = containerTmuxSessions.get(exec.containerId);
-                        exists = containerSessions?.includes(exec.sessionId) ?? false;
+                        const containerSessions = findContainerSessionsByPrefix(containerTmuxSessions, exec.containerId);
+                        exists = containerSessions.includes(exec.sessionId);
                         containerId = exec.containerId;
                     }
                     else {

package/dist/commands/session/create.d.ts

@@ -0,0 +1,19 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class SessionCreate extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        command: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        detach: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        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>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+}

package/dist/commands/session/create.js

@@ -0,0 +1,102 @@
+import { Args, Flags } from '@oclif/core';
+import { execSync } from 'node:child_process';
+import { styles } from '../../lib/styles.js';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class SessionCreate extends PMOCommand {
+    static description = 'Create a new tmux session';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> my-session',
+        '<%= config.bin %> <%= command.id %> my-session --command "npm run dev"',
+        '<%= config.bin %> <%= command.id %> my-session --detach',
+    ];
+    static args = {
+        name: Args.string({
+            description: 'Name for the new tmux session',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...pmoBaseFlags,
+        command: Flags.string({
+            char: 'c',
+            description: 'Initial command to run in the session',
+        }),
+        detach: Flags.boolean({
+            char: 'd',
+            description: 'Create session in detached mode (do not attach)',
+            default: false,
+        }),
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { args, flags } = await this.parse(SessionCreate);
+        const jsonMode = shouldOutputJson(flags);
+        const sessionName = args.name;
+        // Check if tmux is available
+        try {
+            execSync('which tmux', { stdio: 'pipe' });
+        }
+        catch {
+            if (jsonMode) {
+                outputErrorAsJson('TMUX_NOT_FOUND', 'tmux is not installed or not in PATH.', createMetadata('session create', flags));
+            }
+            this.error('tmux is not installed or not in PATH.');
+        }
+        // Check if a session with this name already exists
+        try {
+            execSync(`tmux has-session -t "${sessionName}" 2>/dev/null`, { stdio: 'pipe' });
+            // If we get here, session exists
+            if (jsonMode) {
+                outputErrorAsJson('SESSION_EXISTS', `A tmux session named "${sessionName}" already exists.`, createMetadata('session create', flags));
+            }
+            this.error(`A tmux session named "${sessionName}" already exists.`);
+        }
+        catch {
+            // Session doesn't exist, good to proceed
+        }
+        // Build the tmux new-session command
+        const tmuxArgs = ['tmux', 'new-session'];
+        // Always use detached mode for creation, then attach if needed
+        tmuxArgs.push('-d');
+        tmuxArgs.push('-s', `"${sessionName}"`);
+        if (flags.command) {
+            tmuxArgs.push(`"${flags.command}"`);
+        }
+        try {
+            execSync(tmuxArgs.join(' '), { stdio: 'pipe' });
+        }
+        catch (error) {
+            const message = `Failed to create tmux session "${sessionName}": ${error instanceof Error ? error.message : error}`;
+            if (jsonMode) {
+                outputErrorAsJson('CREATE_FAILED', message, createMetadata('session create', flags));
+            }
+            this.error(message);
+        }
+        if (jsonMode) {
+            outputSuccessAsJson({
+                sessionName,
+                detached: flags.detach,
+                command: flags.command || null,
+            }, createMetadata('session create', flags));
+        }
+        this.log('');
+        this.log(styles.success(`Created tmux session: ${sessionName}`));
+        if (!flags.detach) {
+            this.log(styles.info(`Attaching to session: ${sessionName}`));
+            try {
+                execSync(`tmux attach -t "${sessionName}"`, { stdio: 'inherit' });
+            }
+            catch {
+                this.log(styles.muted(`Session "${sessionName}" is running in detached mode.`));
+                this.log(styles.muted(`Attach with: tmux attach -t "${sessionName}"`));
+            }
+        }
+        else {
+            this.log(styles.muted(`Attach with: prlt session attach ${sessionName}`));
+        }
+        this.log('');
+    }
+}

package/dist/commands/session/health.js

@@ -5,32 +5,13 @@ import Database from 'better-sqlite3';
 import { styles } from '../../lib/styles.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ExecutionStorage } from '../../lib/execution/index.js';
-import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findSessionForExecution, } from '../../lib/execution/session-utils.js';
+import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findContainerSessionsByPrefix, findSessionForExecution, captureTmuxPane, } from '../../lib/execution/session-utils.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { visualPadEnd } from '../../lib/string-utils.js';
 import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
 // =============================================================================
 // Detection Logic
 // =============================================================================
-/**
- * Capture the last N lines from a tmux pane.
- */
-function captureTmuxPane(sessionId, lines, containerId) {
-    try {
-        const captureCmd = `tmux capture-pane -t "${sessionId}" -p -S -${lines}`;
-        if (containerId) {
-            return execSync(`docker exec ${containerId} bash -c '${captureCmd}'`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 10000 }).trim();
-        }
-        return execSync(captureCmd, {
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe'],
-            timeout: 5000,
-        }).trim();
-    }
-    catch {
-        return null;
-    }
-}
 /**
  * Detect agent health state from tmux pane content.
  *
@@ -187,7 +168,7 @@ export default class SessionHealth extends PMOCommand {
                 // Try to find session if sessionId is NULL
                 if (!exec.sessionId) {
                     if (isContainer && exec.containerId) {
-                        const containerSessions = containerTmuxSessions.get(exec.containerId) || [];
+                        const containerSessions = findContainerSessionsByPrefix(containerTmuxSessions, exec.containerId);
                         const match = findSessionForExecution(exec.ticketId, exec.agentName, containerSessions);
                         if (match) {
                             actualSessionId = match;
@@ -207,8 +188,8 @@ export default class SessionHealth extends PMOCommand {
                 }
                 else {
                     if (isContainer && exec.containerId) {
-                        const containerSessions = containerTmuxSessions.get(exec.containerId);
-                        exists = containerSessions?.includes(exec.sessionId) ?? false;
+                        const containerSessions = findContainerSessionsByPrefix(containerTmuxSessions, exec.containerId);
+                        exists = containerSessions.includes(exec.sessionId);
                         containerId = exec.containerId;
                     }
                     else {

package/dist/commands/session/index.js

@@ -1,11 +1,12 @@
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson } from '../../lib/prompt-json.js';
 export default class Session extends PMOCommand {
-    static description = 'Manage agent tmux sessions (list, attach, detach)';
+    static description = 'Manage agent tmux sessions (list, attach, create, detach)';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> list',
         '<%= config.bin %> <%= command.id %> attach TKT-347-implement',
+        '<%= config.bin %> <%= command.id %> create my-session',
     ];
     static flags = {
         ...pmoBaseFlags,
@@ -22,8 +23,11 @@ export default class Session extends PMOCommand {
                 message: 'Session Management - What would you like to do?',
                 choices: [
                     { name: 'List active sessions', value: 'list', command: 'prlt session list --json' },
+                    { name: 'Create a new session', value: 'create', command: 'prlt session create --json' },
                     { name: 'Attach to a session', value: 'attach', command: 'prlt session attach --json' },
+                    { name: 'Peek at agent output', value: 'peek', command: 'prlt session peek --json' },
                     { name: 'Check agent health', value: 'health', command: 'prlt session health --json' },
+                    { name: 'Poke a running agent', value: 'poke', command: 'prlt session poke --json' },
                     { name: 'Cancel', value: 'cancel' },
                 ],
             }], jsonModeConfig);
@@ -35,12 +39,21 @@ export default class Session extends PMOCommand {
             case 'list':
                 await this.config.runCommand('session:list', []);
                 break;
+            case 'create':
+                await this.config.runCommand('session:create', []);
+                break;
             case 'attach':
                 await this.config.runCommand('session:attach', []);
                 break;
+            case 'peek':
+                await this.config.runCommand('session:peek', []);
+                break;
             case 'health':
                 await this.config.runCommand('session:health', []);
                 break;
+            case 'poke':
+                await this.config.runCommand('session:poke', []);
+                break;
         }
     }
 }

package/dist/commands/session/list.js

@@ -4,7 +4,7 @@ import Database from 'better-sqlite3';
 import { styles } from '../../lib/styles.js';
 import { getWorkspaceInfo } from '../../lib/agents/commands.js';
 import { ExecutionStorage } from '../../lib/execution/index.js';
-import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findSessionForExecution, } from '../../lib/execution/session-utils.js';
+import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findContainerSessionsByPrefix, findSessionForExecution, } from '../../lib/execution/session-utils.js';
 import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
 import { shouldOutputJson } from '../../lib/prompt-json.js';
 import { visualPadEnd } from '../../lib/string-utils.js';
@@ -65,7 +65,7 @@ export default class SessionList extends PMOCommand {
                 // If sessionId is NULL, try to find session by naming convention
                 if (!exec.sessionId) {
                     if (isContainer && exec.containerId) {
-                        const containerSessions = containerTmuxSessions.get(exec.containerId) || [];
+                        const containerSessions = findContainerSessionsByPrefix(containerTmuxSessions, exec.containerId);
                         const match = findSessionForExecution(exec.ticketId, exec.agentName, containerSessions);
                         if (match) {
                             actualSessionId = match;
@@ -88,8 +88,8 @@ export default class SessionList extends PMOCommand {
                 else {
                     // sessionId is set, verify it exists
                     if (isContainer && exec.containerId) {
-                        const containerSessions = containerTmuxSessions.get(exec.containerId);
-                        exists = containerSessions?.includes(exec.sessionId) ?? false;
+                        const containerSessions = findContainerSessionsByPrefix(containerTmuxSessions, exec.containerId);
+                        exists = containerSessions.includes(exec.sessionId);
                         containerId = exec.containerId;
                     }
                     else {
@@ -105,14 +105,15 @@ export default class SessionList extends PMOCommand {
                         matchedHostSessions.add(actualSessionId);
                     }
                 }
-                // Only include if session exists, unless --all flag
-                // Note: actualSessionId is guaranteed non-null here due to continue above
-                if ((exists || flags.all) && actualSessionId) {
+                // Always include sessions from DB that have a sessionId.
+                // When tmux verification fails (e.g., Docker/tmux not accessible from MCP context),
+                // show the session with the DB status instead of silently dropping it.
+                if (actualSessionId) {
                     sessions.push({
                         sessionId: actualSessionId,
                         ticketId: exec.ticketId,
                         agentName: exec.agentName,
-                        status: exists ? exec.status : 'stale',
+                        status: exists ? exec.status : (flags.all ? 'stale' : exec.status),
                         environment: isContainer ? 'container' : 'host',
                         containerId,
                         exists,

package/dist/commands/session/peek.d.ts

@@ -0,0 +1,38 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class SessionPeek extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        lines: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        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>;
+    };
+    protected getPMOOptions(): {
+        promptIfMultiple: boolean;
+    };
+    execute(): Promise<void>;
+    /**
+     * Resolve a target identifier to matching sessions.
+     * Supports: agent name, ticket ID (TKT-XXX), execution ID (WORK-XXX), or session ID.
+     */
+    private resolveTarget;
+    /**
+     * Resolve an execution ID (WORK-XXX) to matching sessions.
+     */
+    private resolveFromExecution;
+    /**
+     * Output peek content for a session.
+     * In raw mode: outputs plain text to stdout.
+     * In JSON mode: outputs structured JSON.
+     */
+    private outputPeek;
+    /**
+     * Get verified sessions from DB that have actual tmux processes.
+     * Same discovery pattern as attach.ts and list.ts.
+     */
+    private getVerifiedSessions;
+}