aicodeman 0.2.8

package/dist/mux-interface.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @fileoverview Terminal multiplexer abstraction layer (tmux).
+ *
+ * Defines the TerminalMultiplexer interface that TmuxManager implements.
+ *
+ * @module mux-interface
+ */
+import type { EventEmitter } from 'node:events';
+import type { ProcessStats, PersistedRespawnConfig, NiceConfig, ClaudeMode, SessionMode, OpenCodeConfig } from './types.js';
+/**
+ * Multiplexer session metadata.
+ */
+export interface MuxSession {
+    /** Codeman session ID */
+    sessionId: string;
+    /** Multiplexer session name (e.g., "codeman-abc12345") */
+    muxName: string;
+    /** Process PID */
+    pid: number;
+    /** Timestamp when created */
+    createdAt: number;
+    /** Working directory */
+    workingDir: string;
+    /** Session mode */
+    mode: SessionMode;
+    /** Whether webserver is attached to this session */
+    attached: boolean;
+    /** Session display name (tab name) */
+    name?: string;
+    /** Persisted respawn controller configuration (restored on server restart) */
+    respawnConfig?: PersistedRespawnConfig;
+    /** Whether Ralph / Todo tracking is enabled */
+    ralphEnabled?: boolean;
+}
+/**
+ * MuxSession with optional process resource statistics.
+ */
+export interface MuxSessionWithStats extends MuxSession {
+    /** Optional resource statistics */
+    stats?: ProcessStats;
+}
+/** Options for creating a new multiplexer session. */
+export interface CreateSessionOptions {
+    sessionId: string;
+    workingDir: string;
+    mode: SessionMode;
+    name?: string;
+    niceConfig?: NiceConfig;
+    model?: string;
+    claudeMode?: ClaudeMode;
+    allowedTools?: string;
+    openCodeConfig?: OpenCodeConfig;
+}
+/** Options for respawning a dead pane. */
+export interface RespawnPaneOptions {
+    sessionId: string;
+    workingDir: string;
+    mode: SessionMode;
+    niceConfig?: NiceConfig;
+    model?: string;
+    claudeMode?: ClaudeMode;
+    allowedTools?: string;
+    openCodeConfig?: OpenCodeConfig;
+}
+/**
+ * Terminal multiplexer interface.
+ *
+ * Implemented by TmuxManager.
+ *
+ * Events emitted:
+ * - `sessionCreated` (session: MuxSession) - New session created
+ * - `sessionKilled` (data: { sessionId: string }) - Session terminated
+ * - `sessionDied` (data: { sessionId: string }) - Session died unexpectedly
+ * - `statsUpdated` (sessions: MuxSessionWithStats[]) - Stats refreshed
+ */
+export interface TerminalMultiplexer extends EventEmitter {
+    /** Which backend this instance uses */
+    readonly backend: 'tmux';
+    /**
+     * Create a new multiplexer session.
+     * The session runs the appropriate command (claude, opencode, or shell) in detached mode.
+     */
+    createSession(options: CreateSessionOptions): Promise<MuxSession>;
+    /**
+     * Kill a session and all its child processes.
+     * Uses a multi-strategy approach (children → process group → mux kill → SIGKILL).
+     */
+    killSession(sessionId: string): Promise<boolean>;
+    /** Clean up resources (stop stats collection, etc.) */
+    destroy(): void;
+    /** Get all tracked sessions */
+    getSessions(): MuxSession[];
+    /** Get a session by Codeman session ID */
+    getSession(sessionId: string): MuxSession | undefined;
+    /** Get all sessions with process resource statistics */
+    getSessionsWithStats(): Promise<MuxSessionWithStats[]>;
+    /** Get process stats for a single session */
+    getProcessStats(sessionId: string): Promise<ProcessStats | null>;
+    /**
+     * Send input to a session via tmux send-keys.
+     */
+    sendInput(sessionId: string, input: string): Promise<boolean>;
+    /** Update the display name of a session */
+    updateSessionName(sessionId: string, name: string): boolean;
+    /** Mark session as attached/detached */
+    setAttached(sessionId: string, attached: boolean): void;
+    /** Register an externally-created session for tracking */
+    registerSession(session: MuxSession): void;
+    /** Update persisted respawn config for a session */
+    updateRespawnConfig(sessionId: string, config: PersistedRespawnConfig | undefined): void;
+    /** Clear respawn config when respawn is stopped */
+    clearRespawnConfig(sessionId: string): void;
+    /** Update Ralph enabled state for a session */
+    updateRalphEnabled(sessionId: string, enabled: boolean): void;
+    /**
+     * Reconcile tracked sessions with actual running sessions.
+     * Finds dead sessions and discovers unknown ones.
+     */
+    reconcileSessions(): Promise<{
+        alive: string[];
+        dead: string[];
+        discovered: string[];
+    }>;
+    /** Start periodic process stats collection */
+    startStatsCollection(intervalMs?: number): void;
+    /** Stop periodic process stats collection */
+    stopStatsCollection(): void;
+    /**
+     * Get the command to spawn for attaching to a session ('tmux').
+     */
+    getAttachCommand(): string;
+    /**
+     * Get the arguments for attaching to a session by mux name.
+     */
+    getAttachArgs(muxName: string): string[];
+    /** Check if the multiplexer binary is available on the system */
+    isAvailable(): boolean;
+    /** Check if a multiplexer session actually exists (process-level check, not just tracked) */
+    muxSessionExists(muxName: string): boolean;
+    /** Check if the pane in a session is dead (command exited but remain-on-exit keeps it alive) */
+    isPaneDead(muxName: string): boolean;
+    /** Respawn a dead pane with a fresh command. Returns the new PID or null on failure. */
+    respawnPane(options: RespawnPaneOptions): Promise<number | null>;
+}
+//# sourceMappingURL=mux-interface.d.ts.map

package/dist/mux-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mux-interface.d.ts","sourceRoot":"","sources":["../src/mux-interface.ts"],"names":[],"mappings":"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"}

package/dist/mux-interface.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Terminal multiplexer abstraction layer (tmux).
+ *
+ * Defines the TerminalMultiplexer interface that TmuxManager implements.
+ *
+ * @module mux-interface
+ */
+export {};
+//# sourceMappingURL=mux-interface.js.map

package/dist/mux-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mux-interface.js","sourceRoot":"","sources":["../src/mux-interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/plan-orchestrator.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @fileoverview Simplified plan generation with 2 agents instead of 9.
+ *
+ * Previous architecture (removed):
+ * - 4 parallel analysis agents (requirements, architecture, testing, risks)
+ * - Synthesis phase
+ * - Verification agent
+ * - Execution optimizer agent (output was ignored anyway)
+ * - Final review agent
+ *
+ * New architecture:
+ * 1. Research Agent - gather context (optional, can fail)
+ * 2. Planner Agent - single agent generates complete TDD plan
+ *
+ * @module plan-orchestrator
+ */
+import type { TerminalMultiplexer } from './mux-interface.js';
+import { PlanTaskStatus, TddPhase } from './types.js';
+/** Development phase in TDD cycle (alias for TddPhase) */
+export type PlanPhase = TddPhase;
+/**
+ * Plan item with TDD structure.
+ */
+export interface PlanItem {
+    id?: string;
+    content: string;
+    priority: 'P0' | 'P1' | 'P2' | null;
+    source?: string;
+    rationale?: string;
+    verificationCriteria?: string;
+    testCommand?: string;
+    dependencies?: string[];
+    status?: PlanTaskStatus;
+    attempts?: number;
+    lastError?: string;
+    completedAt?: number;
+    complexity?: 'low' | 'medium' | 'high';
+    tddPhase?: PlanPhase;
+    pairedWith?: string;
+    reviewChecklist?: string[];
+}
+export interface ResearchResult {
+    success: boolean;
+    findings: {
+        externalResources: Array<{
+            type: 'github' | 'documentation' | 'tutorial' | 'article' | 'stackoverflow';
+            url?: string;
+            title: string;
+            relevance: string;
+            keyInsights: string[];
+        }>;
+        codebasePatterns: Array<{
+            pattern: string;
+            location: string;
+            relevance: string;
+        }>;
+        technicalRecommendations: string[];
+        potentialChallenges: string[];
+        recommendedTools: Array<{
+            name: string;
+            purpose: string;
+            reason: string;
+        }>;
+    };
+    enrichedTaskDescription: string;
+    error?: string;
+    durationMs: number;
+}
+export interface DetailedPlanResult {
+    success: boolean;
+    items?: PlanItem[];
+    costUsd?: number;
+    metadata?: {
+        researchResult?: ResearchResult;
+        plannerGaps: string[];
+        plannerWarnings: string[];
+        totalDurationMs: number;
+    };
+    error?: string;
+}
+export type ProgressCallback = (phase: string, detail: string) => void;
+export interface PlanSubagentEvent {
+    type: 'started' | 'progress' | 'completed' | 'failed';
+    agentId: string;
+    agentType: 'research' | 'planner';
+    model: string;
+    status: string;
+    detail?: string;
+    itemCount?: number;
+    durationMs?: number;
+    error?: string;
+}
+export type SubagentCallback = (event: PlanSubagentEvent) => void;
+export declare class PlanOrchestrator {
+    private mux;
+    private workingDir;
+    private outputDir?;
+    private runningSessions;
+    private cancelled;
+    private taskDescription;
+    private researchModel;
+    private plannerModel;
+    constructor(mux: TerminalMultiplexer, workingDir?: string, outputDir?: string, modelConfig?: {
+        defaultModel?: string;
+        agentTypeOverrides?: Record<string, string>;
+    });
+    private saveAgentOutput;
+    private saveFinalResult;
+    private generateSummary;
+    cancel(): Promise<void>;
+    /**
+     * Generate a detailed TDD plan.
+     *
+     * Flow:
+     * 1. Research Agent (optional - failures don't block)
+     * 2. Planner Agent (generates complete TDD plan)
+     */
+    generateDetailedPlan(taskDescription: string, onProgress?: ProgressCallback, onSubagent?: SubagentCallback): Promise<DetailedPlanResult>;
+    private formatResearchContext;
+    private runResearchAgent;
+    private runPlannerAgent;
+}
+//# sourceMappingURL=plan-orchestrator.d.ts.map

package/dist/plan-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-orchestrator.d.ts","sourceRoot":"","sources":["../src/plan-orchestrator.ts"],"names":[],"mappings":"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"}