@proletariat/cli 0.3.69 → 0.3.71

package/dist/lib/execution/runners/shared.js

@@ -0,0 +1,141 @@
+/**
+ * Shared Runner Utilities — Barrel Re-export
+ *
+ * This module re-exports all shared utilities from sub-modules.
+ * Runner modules import from this file for convenience.
+ *
+ * Sub-modules:
+ * - docker-credentials.ts — Credential volume + host creds + tmux keychain
+ * - executor.ts — Executor command building + preflight checks
+ * - docker-management.ts — Container lifecycle (create, setup, ensure, etc.)
+ * - prompt-builder.ts — Integration commands + orchestrator/ticket prompts
+ */
+import { spawn, execSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_EXECUTION_CONFIG, normalizeEnvironment, } from '../types.js';
+import { getSetTitleCommands } from '../../terminal.js';
+import { readDevcontainerJson, generateOrchestratorDockerfile } from '../devcontainer.js';
+import { getCodexCommand, resolveCodexExecutionContext, validateCodexMode, CodexModeError } from '../codex-adapter.js';
+import { resolveToolsForSpawn } from '../../tool-registry/index.js';
+// =============================================================================
+// Terminal Title Helpers
+// =============================================================================
+/**
+ * Build a unified name for tmux sessions, window names, and tab titles.
+ * Format: "{ticketId}-{action}-{agentName}"
+ */
+export function buildSessionName(context) {
+    const action = (context.actionName || 'work')
+        .replace(/[^a-zA-Z0-9._-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    const agent = context.agentName || 'agent';
+    return `${context.ticketId}-${action}-${agent}`;
+}
+export function buildWindowTitle(context) {
+    return buildSessionName(context);
+}
+export function buildTmuxWindowName(context) {
+    return buildSessionName(context);
+}
+// =============================================================================
+// Control Mode Helpers (iTerm -CC integration)
+// =============================================================================
+export function shouldUseControlMode(terminalApp, controlModeEnabled) {
+    return terminalApp === 'iTerm' && controlModeEnabled;
+}
+export function buildTmuxMouseOption(_useControlMode) {
+    return ' \\; set-option -g mouse on';
+}
+export function buildTmuxAttachCommand(useControlMode, includeUnicodeFlag = false) {
+    const unicodeFlag = includeUnicodeFlag ? '-u ' : '';
+    if (useControlMode) {
+        return `tmux -u -CC attach -d`;
+    }
+    return `tmux ${unicodeFlag}attach -d`;
+}
+export function configureITermTmuxPreferences(mode) {
+    try {
+        const windowModeValue = mode === 'tab' ? 2 : 1;
+        execSync(`defaults write com.googlecode.iterm2 OpenTmuxWindowsIn -int ${windowModeValue}`, { stdio: 'pipe' });
+        execSync(`defaults write com.googlecode.iterm2 AutoHideTmuxClientSession -bool true`, { stdio: 'pipe' });
+    }
+    catch {
+        // Non-fatal
+    }
+}
+export function configureITermTmuxWindowMode(mode) {
+    configureITermTmuxPreferences(mode);
+}
+// =============================================================================
+// GitHub Token Check
+// =============================================================================
+export function getGitHubToken() {
+    if (process.env.GITHUB_TOKEN)
+        return process.env.GITHUB_TOKEN;
+    if (process.env.GH_TOKEN)
+        return process.env.GH_TOKEN;
+    try {
+        const token = execSync('gh auth token', { encoding: 'utf-8', stdio: 'pipe' }).trim();
+        if (token)
+            return token;
+    }
+    catch {
+        // gh auth token failed
+    }
+    return null;
+}
+export function isGitHubTokenAvailable() {
+    return getGitHubToken() !== null;
+}
+export function checkDockerDaemon() {
+    try {
+        execSync('which docker', { stdio: 'pipe', timeout: 3000 });
+    }
+    catch {
+        return { available: false, reason: 'not-installed', message: 'Docker is not installed.' };
+    }
+    const timeout = 5000;
+    try {
+        execSync('docker ps -q --no-trunc', { stdio: 'pipe', timeout });
+        return { available: true, reason: 'ready', message: 'Docker daemon is ready.' };
+    }
+    catch (error) {
+        const stderr = error?.stderr?.toString() || '';
+        const isTimeout = error?.killed === true;
+        let message;
+        if (isTimeout) {
+            message = 'Docker daemon is not responding (timed out after 5s). Docker Desktop may be initializing or stuck — check for license/login prompts.';
+        }
+        else if (stderr.includes('500') || stderr.includes('Internal Server Error')) {
+            message = 'Docker daemon is returning errors (500). Docker Desktop needs attention — check for license/login prompts.';
+        }
+        else if (stderr.includes('connect') || stderr.includes('Cannot connect') || stderr.includes('Is the docker daemon running')) {
+            message = 'Docker daemon is not running. Start Docker Desktop and try again.';
+        }
+        else {
+            message = `Docker daemon is not ready: ${stderr.trim() || 'unknown error'}. Check Docker Desktop status.`;
+        }
+        return { available: false, reason: 'daemon-not-ready', message };
+    }
+}
+export function isDockerRunning() {
+    return checkDockerDaemon().available;
+}
+/** @deprecated No longer required - we use raw Docker commands now */
+export function isDevcontainerCliInstalled() {
+    return true;
+}
+// =============================================================================
+// Re-exports from sub-modules
+// =============================================================================
+export { CLAUDE_CREDENTIALS_VOLUME, credentialsVolumeExists, dockerCredentialsExist, getDockerCredentialInfo, hostCredentialsExist, ensureTmuxServerHasKeychainAccess, copyClaudeCredentials, } from './docker-credentials.js';
+export { getExecutorCommand, isClaudeExecutor, getExecutorDisplayName, getExecutorPackage, checkExecutorOnHost, checkExecutorInContainer, runExecutorPreflight, } from './executor.js';
+export { getHostPrltVersion, getAgentContainerName, getContainerName, getImageName, containerExists, isContainerRunning, getContainerId, buildDockerImage, imageExists, createDockerContainer, runContainerSetup, ensureDockerContainer, } from './docker-management.js';
+export { buildIntegrationCommandsSection, buildOrchestratorSystemPrompt, buildPrompt, } from './prompt-builder.js';
+// Re-export Node modules and external deps used by runner modules
+export { spawn, execSync, fs, path, os, fileURLToPath, DEFAULT_EXECUTION_CONFIG, normalizeEnvironment, getSetTitleCommands, readDevcontainerJson, generateOrchestratorDockerfile, getCodexCommand, resolveCodexExecutionContext, validateCodexMode, CodexModeError, resolveToolsForSpawn, };
+//# sourceMappingURL=shared.js.map

package/dist/lib/execution/runners/shared.js.map

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

package/dist/lib/execution/runners.d.ts

@@ -1,276 +1,16 @@
 /**
- * Execution Runners
+ * Execution Runners — Re-export barrel
  *
- * Implementations for each execution environment (host, sandbox, devcontainer, docker, cloud).
- */
-import { ExecutionEnvironment, DisplayMode, OutputMode, PermissionMode, SessionManager, ExecutorType, ExecutionContext, ExecutionConfig } from './types.js';
-/**
- * Build a unified name for tmux sessions, window names, and tab titles.
- * Format: "{ticketId}-{action}-{agentName}"
- * Example: "TKT-347-implement-altman"
- */
-export declare function buildSessionName(context: ExecutionContext): string;
-import type { TerminalApp } from './types.js';
-/**
- * Check if tmux control mode (-CC) should be used.
- * Control mode is only used with iTerm when controlMode is enabled in config.
- *
- * When control mode is active:
- * - iTerm handles scrolling, selection, and gestures natively
- * - tmux mouse mode should be disabled to avoid conflicts
- */
-export declare function shouldUseControlMode(terminalApp: TerminalApp, controlModeEnabled: boolean): boolean;
-/**
- * Build the tmux mouse option string for session creation.
- * Enables mouse mode for scroll support in tmux.
- * To select text or switch tabs, hold Shift or Option to bypass tmux.
- */
-export declare function buildTmuxMouseOption(_useControlMode: boolean): string;
-/**
- * Build the tmux attach command based on control mode.
- * Uses -u -CC flags for iTerm control mode (native scrolling/selection).
- * -u forces UTF-8 mode which is required for proper iTerm integration.
- * Uses regular attach otherwise.
- */
-export declare function buildTmuxAttachCommand(useControlMode: boolean, includeUnicodeFlag?: boolean): string;
-/**
- * Configure iTerm tmux preferences for control mode.
- * - windowMode: whether tmux -CC opens windows as tabs or new windows
- * - autoHide: automatically bury/hide the control session (the terminal where -CC was run)
- * @param mode - 'tab' for tabs in current window, 'window' for new windows
- */
-export declare function configureITermTmuxPreferences(mode: 'tab' | 'window'): void;
-export declare function configureITermTmuxWindowMode(mode: 'tab' | 'window'): void;
-/**
- * Check if the claude-credentials Docker volume exists.
- */
-export declare function credentialsVolumeExists(): boolean;
-/**
- * Check if valid Claude OAuth credentials exist in the Docker volume.
- * Returns true if OAuth credentials are stored (even if access token is expired,
- * since Claude Code handles refresh internally using stored refresh tokens).
- *
- * NOTE: This intentionally does NOT check for ANTHROPIC_API_KEY. If the user
- * has an API key but no OAuth credentials, we want to prompt them to set up
- * OAuth (which uses their Max subscription) rather than silently burning API credits.
- */
-export declare function dockerCredentialsExist(): boolean;
-/**
- * Get Docker credential info for display.
- * Returns expiration date and subscription type if available.
- */
-export declare function getDockerCredentialInfo(): {
-    expiresAt: Date;
-    subscriptionType?: string;
-} | null;
-/**
- * Check if Claude Code authentication is available on the host system.
- * Returns true if any of:
- * 1. ANTHROPIC_API_KEY environment variable is set
- * 2. OAuth credentials exist in ~/.claude/.credentials.json (Claude Code 1.x)
- * 3. OAuth credentials exist in macOS keychain (Claude Code 2.x)
- *
- * This is used to validate auth before spawning host sessions (e.g., orchestrator)
- * to avoid creating stuck sessions when the keychain is locked (SSH contexts).
- */
-export declare function hostCredentialsExist(): boolean;
-export declare function getExecutorCommand(executor: ExecutorType, prompt: string, skipPermissions?: boolean): {
-    cmd: string;
-    args: string[];
-};
-/**
- * Check if an executor is Claude Code.
- * Used to gate Claude-specific flags and configuration.
- */
-export declare function isClaudeExecutor(executor: ExecutorType): boolean;
-/**
- * Get the display name for an executor type.
- */
-export declare function getExecutorDisplayName(executor: ExecutorType): string;
-/**
- * Get the npm package name for an executor (for container installation).
- */
-export declare function getExecutorPackage(executor: ExecutorType): string | null;
-export interface PreflightResult {
-    ok: boolean;
-    error?: string;
-}
-/**
- * Check executor binary availability on host.
- */
-export declare function checkExecutorOnHost(executor: ExecutorType): PreflightResult;
-/**
- * Check executor binary availability inside a container.
- */
-export declare function checkExecutorInContainer(executor: ExecutorType, containerId: string): PreflightResult;
-/**
- * Run executor preflight checks for the target environment.
- */
-export declare function runExecutorPreflight(environment: ExecutionEnvironment, executor: ExecutorType, options?: {
-    containerId?: string;
-}): PreflightResult;
-/**
- * Build the system prompt for orchestrator sessions.
- * This is injected via Claude Code's --system-prompt flag so the orchestrator
- * knows its role immediately without relying on CLAUDE.md.
- */
-export declare function buildOrchestratorSystemPrompt(context: ExecutionContext): string;
-export interface RunnerResult {
-    success: boolean;
-    pid?: string;
-    containerId?: string;
-    sessionId?: string;
-    logPath?: string;
-    error?: string;
-}
-export type Runner = (context: ExecutionContext, executor: ExecutorType, config: ExecutionConfig) => Promise<RunnerResult>;
-/**
- * Run command on the host machine with tmux session for persistence.
- * Supports multiple terminal emulators on macOS.
- *
- * Architecture (same as devcontainer):
- * - Always creates a host tmux session for session persistence
- * - displayMode controls whether to open a terminal tab attached to the session
- * - User can reattach with `prlt session attach` if tab is closed
- */
-export declare function runHost(context: ExecutionContext, executor: ExecutorType, config: ExecutionConfig, displayMode?: DisplayMode): Promise<RunnerResult>;
-/**
- * Check if GitHub token is available for git push operations.
- * Checks environment variables first, then tries gh auth token.
- * Returns the token if available, null otherwise.
- */
-export declare function getGitHubToken(): string | null;
-/**
- * Check if GitHub token is available.
- * Returns true if token is available via env vars or gh CLI.
- */
-export declare function isGitHubTokenAvailable(): boolean;
-/**
- * Docker daemon health check result (TKT-081).
- * Provides diagnostic info about why Docker isn't available.
- */
-export type DockerDaemonStatus = {
-    available: boolean;
-    /** 'ready' | 'not-installed' | 'daemon-not-ready' */
-    reason: 'ready' | 'not-installed' | 'daemon-not-ready';
-    /** Human-readable message for logging/display */
-    message: string;
-};
-/**
- * Check Docker daemon health with fast detection (TKT-081).
- *
- * Uses `docker ps` with a 5-second timeout to quickly detect:
- * - Docker not installed
- * - Docker installed but daemon unresponsive (stuck on license, initializing, 500 errors)
- * - Docker ready
- *
- * Total worst-case time: ~5 seconds (single attempt with timeout).
- */
-export declare function checkDockerDaemon(): DockerDaemonStatus;
-/**
- * Check if Docker daemon is running.
- * Returns true if Docker is available and responsive.
- *
- * For detailed diagnostics, use checkDockerDaemon() instead.
- */
-export declare function isDockerRunning(): boolean;
-/**
- * Check if the devcontainer CLI is installed.
- * Returns true if the CLI is available, false otherwise.
- * @deprecated No longer required - we use raw Docker commands now
- */
-export declare function isDevcontainerCliInstalled(): boolean;
-/**
- * Get the container name for an agent.
- * Format: prlt-agent-{agentName}
- */
-export declare function getAgentContainerName(agentName: string): string;
-/**
- * Check if a Docker container exists (running or stopped).
- */
-export declare function containerExists(containerName: string): boolean;
-/**
- * Check if a Docker container is running.
- */
-export declare function isContainerRunning(containerName: string): boolean;
-/**
- * Get the container ID for a running container.
- */
-export declare function getContainerId(containerName: string): string | null;
-/**
- * Build the command to run Claude inside the container.
- * Uses docker exec for direct container access.
- * Uses a prompt file to avoid shell escaping issues.
- */
-export declare function buildDevcontainerCommand(context: ExecutionContext, executor: ExecutorType, promptFile: string, containerId?: string, outputMode?: OutputMode, permissionMode?: PermissionMode, displayMode?: DisplayMode, mcpConfigFile?: string): string;
-/**
- * Run command inside a Docker container.
- * Uses raw Docker commands for filesystem isolation - no devcontainer CLI required.
- * Agent can only access mounted worktrees and configured paths.
- *
- * @param displayMode - How to display output (terminal, foreground, background, tmux)
- * @param sessionManager - How to manage the session inside the container (tmux, direct)
- */
-export declare function runDevcontainer(context: ExecutionContext, executor: ExecutorType, config: ExecutionConfig, displayMode?: DisplayMode, sessionManager?: SessionManager): Promise<RunnerResult>;
-export declare function runDocker(context: ExecutionContext, executor: ExecutorType, config: ExecutionConfig): Promise<RunnerResult>;
-/**
- * Run orchestrator in a Docker container using the sibling container pattern.
- *
- * Architecture:
- * ```
- * Host Docker daemon
- * ├── orchestrator container (has /var/run/docker.sock mounted)
- * ├── agent-1 container (spawned by orchestrator, sibling)
- * ├── agent-2 container (spawned by orchestrator, sibling)
- * ```
- *
- * The orchestrator container needs:
- * - HQ directory mounted (proletariat-hq)
- * - Docker socket mounted (/var/run/docker.sock) — so it can spawn agent containers as siblings
- * - prlt CLI installed in the container
- * - OAuth credentials for Claude Code (via Docker volume)
- * - tmux for session persistence inside the container
- */
-export declare function runOrchestratorInDocker(context: ExecutionContext, executor: ExecutorType, config: ExecutionConfig, options?: {
-    displayMode?: DisplayMode;
-    sessionName?: string;
-}): Promise<RunnerResult>;
-/**
- * Check if srt (sandbox-runtime) is installed on the host.
- */
-export declare function isSrtInstalled(): boolean;
-/**
- * Build the srt command with filesystem and network restrictions.
- *
- * Filesystem policy (read-restriction philosophy from claude-code-sandbox):
- * - Read/write: agent worktree directory
- * - Read-only: repo source (if different from worktree)
- * - Read-only: additional configured read paths
- * - Deny: home directory, system paths, other repos
+ * This file has been refactored into separate modules under ./runners/.
+ * All exports are preserved for backwards compatibility.
  *
- * Network policy:
- * - Allow: configured domains (GitHub, Anthropic API, npm registries, etc.)
- * - Deny: everything else
- */
-export declare function buildSrtCommand(innerCommand: string, context: ExecutionContext, config: ExecutionConfig): string;
-/**
- * Run command in an srt sandbox on the host machine.
- * Uses the same tmux session approach as the host runner, but wraps the
- * executor command with srt for filesystem and network isolation.
- *
- * Falls back to host runner with warning if srt is not installed.
- */
-export declare function runSandbox(context: ExecutionContext, executor: ExecutorType, config: ExecutionConfig, displayMode?: DisplayMode): Promise<RunnerResult>;
-/**
- * Run command on a remote machine (cloud) via SSH.
- * Formerly 'runVm' — renamed to reflect the simplified environment hierarchy.
- * Uses cloud config with fallback to legacy vm config for backwards compatibility.
+ * @see ./runners/index.ts — Dispatcher and re-exports
+ * @see ./runners/shared.ts — Shared utilities
+ * @see ./runners/host.ts — Host runner
+ * @see ./runners/devcontainer.ts — Devcontainer runner
+ * @see ./runners/docker.ts — Docker runner
+ * @see ./runners/orchestrator.ts — Orchestrator-in-Docker runner
+ * @see ./runners/sandbox.ts — Sandbox runner
+ * @see ./runners/cloud.ts — Cloud/VM runner
  */
-export declare function runCloud(context: ExecutionContext, executor: ExecutorType, config: ExecutionConfig, host?: string): Promise<RunnerResult>;
-/** @deprecated Use runCloud instead */
-export declare const runVm: typeof runCloud;
-export declare function runExecution(environment: ExecutionEnvironment, context: ExecutionContext, executor: ExecutorType, config?: ExecutionConfig, options?: {
-    host?: string;
-    displayMode?: DisplayMode;
-    sessionManager?: SessionManager;
-}): Promise<RunnerResult>;
+export * from './runners/index.js';