@renseiai/agentfactory 0.8.0

package/dist/src/orchestrator/state-recovery.js

@@ -0,0 +1,302 @@
+/**
+ * State Recovery
+ *
+ * Detects and recovers agent state from the .agent/ directory.
+ * Enables crash recovery and duplicate agent prevention.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { resolve } from 'path';
+// Default heartbeat timeout: 30 seconds
+const DEFAULT_HEARTBEAT_TIMEOUT_MS = 30000;
+// Default max recovery attempts
+const DEFAULT_MAX_RECOVERY_ATTEMPTS = 3;
+/**
+ * Get the .agent directory path for a worktree
+ */
+export function getAgentDir(worktreePath) {
+    return resolve(worktreePath, '.agent');
+}
+/**
+ * Get the path to the state.json file
+ */
+export function getStatePath(worktreePath) {
+    return resolve(getAgentDir(worktreePath), 'state.json');
+}
+/**
+ * Get the path to the heartbeat.json file
+ */
+export function getHeartbeatPath(worktreePath) {
+    return resolve(getAgentDir(worktreePath), 'heartbeat.json');
+}
+/**
+ * Get the path to the todos.json file
+ */
+export function getTodosPath(worktreePath) {
+    return resolve(getAgentDir(worktreePath), 'todos.json');
+}
+/**
+ * Read and parse a JSON file safely
+ */
+function readJsonSafe(path) {
+    try {
+        if (!existsSync(path))
+            return null;
+        const content = readFileSync(path, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a heartbeat is fresh (agent is alive)
+ */
+export function isHeartbeatFresh(heartbeat, timeoutMs = DEFAULT_HEARTBEAT_TIMEOUT_MS) {
+    if (!heartbeat)
+        return false;
+    const age = Date.now() - heartbeat.timestamp;
+    return age < timeoutMs;
+}
+/**
+ * Read the current state from a worktree
+ */
+export function readWorktreeState(worktreePath) {
+    return readJsonSafe(getStatePath(worktreePath));
+}
+/**
+ * Read the current heartbeat from a worktree
+ */
+export function readHeartbeat(worktreePath) {
+    return readJsonSafe(getHeartbeatPath(worktreePath));
+}
+/**
+ * Read the current todos from a worktree
+ */
+export function readTodos(worktreePath) {
+    return readJsonSafe(getTodosPath(worktreePath));
+}
+/**
+ * Check if recovery is possible for a worktree
+ */
+export function checkRecovery(worktreePath, options = {}) {
+    const heartbeatTimeoutMs = options.heartbeatTimeoutMs ?? DEFAULT_HEARTBEAT_TIMEOUT_MS;
+    const maxRecoveryAttempts = options.maxRecoveryAttempts ?? DEFAULT_MAX_RECOVERY_ATTEMPTS;
+    const agentDir = getAgentDir(worktreePath);
+    // Check if .agent directory exists
+    if (!existsSync(agentDir)) {
+        return {
+            canRecover: false,
+            agentAlive: false,
+            reason: 'no_state',
+            message: 'No .agent directory found in worktree',
+        };
+    }
+    // Read state
+    const state = readWorktreeState(worktreePath);
+    if (!state) {
+        return {
+            canRecover: false,
+            agentAlive: false,
+            reason: 'no_state',
+            message: 'No state.json found in .agent directory',
+        };
+    }
+    // Validate state
+    if (!state.issueId || !state.issueIdentifier) {
+        return {
+            canRecover: false,
+            agentAlive: false,
+            state,
+            reason: 'invalid_state',
+            message: 'State is missing required fields (issueId, issueIdentifier)',
+        };
+    }
+    // Read heartbeat
+    const heartbeat = readHeartbeat(worktreePath);
+    // Check if agent is alive
+    if (isHeartbeatFresh(heartbeat, heartbeatTimeoutMs)) {
+        return {
+            canRecover: false,
+            agentAlive: true,
+            state,
+            heartbeat: heartbeat,
+            reason: 'agent_alive',
+            message: `Agent is still running (PID: ${heartbeat.pid}, last heartbeat: ${new Date(heartbeat.timestamp).toISOString()})`,
+        };
+    }
+    // Check recovery attempts
+    if (state.recoveryAttempts >= maxRecoveryAttempts) {
+        return {
+            canRecover: false,
+            agentAlive: false,
+            state,
+            heartbeat: heartbeat ?? undefined,
+            reason: 'max_attempts',
+            message: `Maximum recovery attempts reached (${state.recoveryAttempts}/${maxRecoveryAttempts})`,
+        };
+    }
+    // Recovery is possible
+    const todos = readTodos(worktreePath);
+    return {
+        canRecover: true,
+        agentAlive: false,
+        state,
+        heartbeat: heartbeat ?? undefined,
+        todos: todos ?? undefined,
+        message: `Recovery possible (attempt ${state.recoveryAttempts + 1}/${maxRecoveryAttempts})`,
+    };
+}
+/**
+ * Initialize the .agent directory for a worktree
+ */
+export function initializeAgentDir(worktreePath) {
+    const agentDir = getAgentDir(worktreePath);
+    if (!existsSync(agentDir)) {
+        mkdirSync(agentDir, { recursive: true });
+    }
+}
+/**
+ * Write the state.json file
+ */
+export function writeState(worktreePath, state) {
+    const statePath = getStatePath(worktreePath);
+    initializeAgentDir(worktreePath);
+    writeFileSync(statePath, JSON.stringify(state, null, 2));
+}
+/**
+ * Update specific fields in the state
+ */
+export function updateState(worktreePath, updates) {
+    const current = readWorktreeState(worktreePath);
+    if (!current)
+        return null;
+    const updated = {
+        ...current,
+        ...updates,
+        lastUpdatedAt: Date.now(),
+    };
+    writeState(worktreePath, updated);
+    return updated;
+}
+/**
+ * Write the todos.json file
+ */
+export function writeTodos(worktreePath, todos) {
+    const todosPath = getTodosPath(worktreePath);
+    initializeAgentDir(worktreePath);
+    writeFileSync(todosPath, JSON.stringify(todos, null, 2));
+}
+/**
+ * Create initial state for a new agent
+ */
+export function createInitialState(options) {
+    const now = Date.now();
+    const taskListId = getTaskListId(options.issueIdentifier, options.workType);
+    return {
+        issueId: options.issueId,
+        issueIdentifier: options.issueIdentifier,
+        linearSessionId: options.linearSessionId,
+        providerSessionId: null,
+        workType: options.workType,
+        prompt: options.prompt,
+        startedAt: now,
+        status: 'initializing',
+        currentPhase: null,
+        lastUpdatedAt: now,
+        recoveryAttempts: 0,
+        workerId: options.workerId ?? null,
+        pid: options.pid ?? null,
+        taskListId,
+    };
+}
+/**
+ * Generate the task list ID for a worktree (matches orchestrator format)
+ *
+ * @param issueIdentifier - Issue identifier (e.g., "SUP-123")
+ * @param workType - Work type suffix (e.g., "development" -> "DEV")
+ * @returns Task list ID (e.g., "SUP-123-DEV")
+ */
+export function getTaskListId(issueIdentifier, workType) {
+    const suffixMap = {
+        research: 'RES',
+        'backlog-creation': 'BC',
+        development: 'DEV',
+        inflight: 'INF',
+        coordination: 'COORD',
+        qa: 'QA',
+        acceptance: 'AC',
+        refinement: 'REF',
+        'refinement-coordination': 'REF-COORD',
+        'qa-coordination': 'QA-COORD',
+        'acceptance-coordination': 'AC-COORD',
+    };
+    return `${issueIdentifier}-${suffixMap[workType]}`;
+}
+/**
+ * Build a recovery prompt for resuming crashed work
+ */
+export function buildRecoveryPrompt(state, todos) {
+    const lines = [];
+    lines.push(`Resume work on ${state.issueIdentifier}.`);
+    lines.push('');
+    lines.push('RECOVERY CONTEXT:');
+    lines.push(`- Previous work type: ${state.workType}`);
+    lines.push(`- Last status: ${state.status}`);
+    if (state.currentPhase) {
+        lines.push(`- Last phase: ${state.currentPhase}`);
+    }
+    lines.push(`- Recovery attempt: ${state.recoveryAttempts + 1}`);
+    // Include task list ID for Claude Code Tasks integration
+    const taskListId = getTaskListId(state.issueIdentifier, state.workType);
+    lines.push(`- Task list ID: ${taskListId}`);
+    lines.push('');
+    // Note about Claude Code Tasks persistence
+    lines.push('TASK STATE:');
+    lines.push(`Your task list is preserved at: ~/.claude/tasks/${taskListId}/`);
+    lines.push('Use TaskList to see the current state of pending/completed tasks.');
+    lines.push('');
+    if (todos && todos.items.length > 0) {
+        lines.push('PREVIOUS TODO LIST (legacy):');
+        for (const item of todos.items) {
+            const statusIcon = item.status === 'completed' ? '\u2713' :
+                item.status === 'in_progress' ? '\u2192' : '\u25CB';
+            lines.push(`  ${statusIcon} [${item.status}] ${item.content}`);
+        }
+        lines.push('');
+    }
+    lines.push('INSTRUCTIONS:');
+    lines.push('1. Run TaskList to see any pending tasks from the previous session');
+    lines.push('2. Check git status to see what has been done');
+    lines.push('3. Review the codebase for any partial changes');
+    lines.push('4. Continue from where the previous session left off');
+    lines.push('5. If work appears complete, verify and create PR if needed');
+    lines.push('');
+    lines.push(`Original prompt: ${state.prompt}`);
+    return lines.join('\n');
+}
+/**
+ * Parse environment variable for heartbeat timeout
+ */
+export function getHeartbeatTimeoutFromEnv() {
+    const envValue = process.env.AGENT_HEARTBEAT_TIMEOUT_MS;
+    if (envValue) {
+        const parsed = parseInt(envValue, 10);
+        if (!isNaN(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return DEFAULT_HEARTBEAT_TIMEOUT_MS;
+}
+/**
+ * Parse environment variable for max recovery attempts
+ */
+export function getMaxRecoveryAttemptsFromEnv() {
+    const envValue = process.env.AGENT_MAX_RECOVERY_ATTEMPTS;
+    if (envValue) {
+        const parsed = parseInt(envValue, 10);
+        if (!isNaN(parsed) && parsed > 0) {
+            return parsed;
+        }
+    }
+    return DEFAULT_MAX_RECOVERY_ATTEMPTS;
+}

package/dist/src/orchestrator/state-types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Worktree State Types
+ *
+ * Types for persisting agent state to the .agent/ directory within each worktree.
+ * This enables crash recovery, heartbeat monitoring, and progress tracking.
+ */
+import type { AgentWorkType } from '@renseiai/agentfactory-linear';
+/**
+ * Status of the agent's work in the worktree
+ */
+export type WorktreeStatus = 'initializing' | 'running' | 'completing' | 'completed' | 'failed' | 'stopped';
+/**
+ * Primary state file for the worktree
+ * Stored at: .agent/state.json
+ */
+export interface WorktreeState {
+    /** Linear issue ID (UUID) */
+    issueId: string;
+    /** Human-readable issue identifier (e.g., SUP-123) */
+    issueIdentifier: string;
+    /** Linear AgentSession ID (if available) */
+    linearSessionId: string | null;
+    /** Provider CLI session ID for --resume (if available) */
+    providerSessionId: string | null;
+    /** Type of work being performed */
+    workType: AgentWorkType;
+    /** The prompt that was given to the agent */
+    prompt: string;
+    /** Unix timestamp when work started */
+    startedAt: number;
+    /** Current status of the work */
+    status: WorktreeStatus;
+    /** Human-readable description of current activity */
+    currentPhase: string | null;
+    /** Unix timestamp of last state update */
+    lastUpdatedAt: number;
+    /** Number of times recovery has been attempted */
+    recoveryAttempts: number;
+    /** Worker ID if running on a remote worker */
+    workerId: string | null;
+    /** Process ID of the agent */
+    pid: number | null;
+    /** Error message if status is 'failed' */
+    errorMessage?: string;
+    /** PR URL if one was created */
+    pullRequestUrl?: string;
+    /**
+     * Claude Code Task List ID for intra-session task coordination
+     * Format: {issueIdentifier}-{WORKTYPE} (e.g., "SUP-123-DEV")
+     * Enables task persistence across crashes and subagent coordination
+     */
+    taskListId?: string;
+}
+/**
+ * Activity type for heartbeat tracking
+ */
+export type HeartbeatActivityType = 'tool_use' | 'thinking' | 'waiting' | 'idle';
+/**
+ * Heartbeat state file for liveness detection
+ * Stored at: .agent/heartbeat.json
+ * Updated every 10 seconds while the agent is running
+ */
+export interface HeartbeatState {
+    /** Unix timestamp of this heartbeat */
+    timestamp: number;
+    /** Process ID of the agent */
+    pid: number;
+    /** Memory usage in megabytes */
+    memoryUsageMB: number;
+    /** Uptime in seconds since agent started */
+    uptime: number;
+    /** Type of last detected activity */
+    lastActivityType: HeartbeatActivityType;
+    /** Unix timestamp of last activity */
+    lastActivityTimestamp: number;
+    /** Total number of tool calls made so far */
+    toolCallsCount: number;
+    /** Current operation being performed (if any) */
+    currentOperation: string | null;
+}
+/**
+ * Todo item status (mirrors TodoWrite tool)
+ */
+export type TodoStatus = 'pending' | 'in_progress' | 'completed';
+/**
+ * Todo item (mirrors TodoWrite tool structure)
+ */
+export interface TodoItem {
+    /** Task description (imperative form) */
+    content: string;
+    /** Current status */
+    status: TodoStatus;
+    /** Present continuous form for display */
+    activeForm: string;
+}
+/**
+ * Persisted todo list state
+ * Stored at: .agent/todos.json
+ * Synced with TodoWrite tool calls
+ */
+export interface TodosState {
+    /** Unix timestamp of last update */
+    updatedAt: number;
+    /** Current todo items */
+    items: TodoItem[];
+}
+/**
+ * Progress log entry type
+ */
+export type ProgressEventType = 'start' | 'phase' | 'tool' | 'error' | 'recovery' | 'complete' | 'stop';
+/**
+ * Progress log entry
+ * Appended to: .agent/progress.log
+ * Format: timestamp|event_type|details
+ */
+export interface ProgressLogEntry {
+    /** Unix timestamp */
+    timestamp: number;
+    /** Type of event */
+    eventType: ProgressEventType;
+    /** Event details (JSON stringified if object) */
+    details: string;
+}
+/**
+ * Result of checking for recoverable state in a worktree
+ */
+export interface RecoveryCheckResult {
+    /** Whether recovery is possible */
+    canRecover: boolean;
+    /** Whether an agent is currently alive (heartbeat fresh) */
+    agentAlive: boolean;
+    /** The state if found */
+    state?: WorktreeState;
+    /** The heartbeat if found */
+    heartbeat?: HeartbeatState;
+    /** The todos if found */
+    todos?: TodosState;
+    /** Reason why recovery is not possible */
+    reason?: 'no_state' | 'agent_alive' | 'max_attempts' | 'invalid_state';
+    /** Human-readable message */
+    message: string;
+}
+/**
+ * Configuration for heartbeat writer
+ */
+export interface HeartbeatWriterConfig {
+    /** Directory path to write heartbeat to */
+    agentDir: string;
+    /** Process ID of the agent */
+    pid: number;
+    /** Interval between heartbeats in milliseconds (default: 10000) */
+    intervalMs?: number;
+    /** Start time of the agent (for uptime calculation) */
+    startTime: number;
+}
+/**
+ * Configuration for progress logger
+ */
+export interface ProgressLoggerConfig {
+    /** Directory path to write progress log to */
+    agentDir: string;
+    /** Maximum log file size in bytes before rotation (default: 1MB) */
+    maxSizeBytes?: number;
+}
+//# sourceMappingURL=state-types.d.ts.map

package/dist/src/orchestrator/state-types.d.ts.map

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

package/dist/src/orchestrator/state-types.js

@@ -0,0 +1,7 @@
+/**
+ * Worktree State Types
+ *
+ * Types for persisting agent state to the .agent/ directory within each worktree.
+ * This enables crash recovery, heartbeat monitoring, and progress tracking.
+ */
+export {};

package/dist/src/orchestrator/stream-parser.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Claude Stream-JSON Parser
+ *
+ * @deprecated This module is dead code — providers now emit normalized AgentEvents
+ * directly (see providers/types.ts). Activity emitters consume AgentEvent streams,
+ * not ClaudeStreamEvent. Retained for backward compatibility of public type exports.
+ * Will be removed in v1.0.
+ *
+ * Parses Claude's stream-json output format and maps events to handler callbacks.
+ * The stream-json format emits newline-delimited JSON events during execution.
+ *
+ * Event types:
+ * - init: Initial message with configuration
+ * - system: System messages and prompts
+ * - assistant: Assistant text output (partial/streaming)
+ * - tool_use: Tool being invoked
+ * - tool_result: Result from tool execution
+ * - result: Final result when complete
+ * - error: Error events
+ */
+/** Base event structure */
+export interface ClaudeStreamEvent {
+    type: string;
+    timestamp?: string;
+}
+/** Initialization event */
+export interface ClaudeInitEvent extends ClaudeStreamEvent {
+    type: 'init';
+    message: string;
+    sessionId?: string;
+}
+/** System message event */
+export interface ClaudeSystemEvent extends ClaudeStreamEvent {
+    type: 'system';
+    message: string;
+    subtype?: 'prompt' | 'info' | 'warning';
+}
+/** Assistant text output event */
+export interface ClaudeAssistantEvent extends ClaudeStreamEvent {
+    type: 'assistant';
+    message: string;
+    partial?: boolean;
+}
+/** Tool use event - when Claude invokes a tool */
+export interface ClaudeToolUseEvent extends ClaudeStreamEvent {
+    type: 'tool_use';
+    tool: string;
+    input: Record<string, unknown>;
+    tool_use_id?: string;
+}
+/** Tool result event - when tool execution completes */
+export interface ClaudeToolResultEvent extends ClaudeStreamEvent {
+    type: 'tool_result';
+    tool: string;
+    output: string;
+    tool_use_id?: string;
+    is_error?: boolean;
+}
+/** Final result event */
+export interface ClaudeResultEvent extends ClaudeStreamEvent {
+    type: 'result';
+    result: string;
+    cost?: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    duration_ms?: number;
+}
+/** Error event */
+export interface ClaudeErrorEvent extends ClaudeStreamEvent {
+    type: 'error';
+    error: {
+        message: string;
+        code?: string;
+        details?: unknown;
+    };
+}
+/** Todo item in a user event */
+export interface ClaudeTodoItem {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed';
+    activeForm: string;
+}
+/** User event - contains tool results including todo updates */
+export interface ClaudeUserEvent extends ClaudeStreamEvent {
+    type: 'user';
+    message?: {
+        role: 'user';
+        content?: Array<{
+            tool_use_id?: string;
+            type?: string;
+            content?: string;
+        }>;
+    };
+    tool_use_result?: {
+        oldTodos?: ClaudeTodoItem[];
+        newTodos?: ClaudeTodoItem[];
+    };
+}
+/** Union of all Claude stream event types */
+export type ClaudeEvent = ClaudeInitEvent | ClaudeSystemEvent | ClaudeAssistantEvent | ClaudeToolUseEvent | ClaudeToolResultEvent | ClaudeResultEvent | ClaudeErrorEvent | ClaudeUserEvent | ClaudeStreamEvent;
+/** Event handlers for Claude stream events */
+export interface ClaudeStreamHandlers {
+    onInit?: (event: ClaudeInitEvent) => void | Promise<void>;
+    onSystem?: (event: ClaudeSystemEvent) => void | Promise<void>;
+    onAssistant?: (event: ClaudeAssistantEvent) => void | Promise<void>;
+    onToolUse?: (event: ClaudeToolUseEvent) => void | Promise<void>;
+    onToolResult?: (event: ClaudeToolResultEvent) => void | Promise<void>;
+    onResult?: (event: ClaudeResultEvent) => void | Promise<void>;
+    onError?: (event: ClaudeErrorEvent) => void | Promise<void>;
+    onUser?: (event: ClaudeUserEvent) => void | Promise<void>;
+    onTodo?: (newTodos: ClaudeTodoItem[], oldTodos: ClaudeTodoItem[]) => void | Promise<void>;
+    onUnknown?: (event: ClaudeStreamEvent) => void | Promise<void>;
+}
+/**
+ * Claude Stream Parser
+ *
+ * @deprecated Providers now emit normalized AgentEvents directly.
+ * Activity emitters consume AgentEvent streams, not ClaudeStreamEvent.
+ * This class is retained for backward compatibility and will be removed in v1.0.
+ */
+export declare class ClaudeStreamParser {
+    private buffer;
+    private handlers;
+    constructor(handlers?: ClaudeStreamHandlers);
+    /**
+     * Feed raw data from stdout into the parser
+     */
+    feed(data: Buffer | string): Promise<void>;
+    /**
+     * Flush any remaining buffered data
+     */
+    flush(): Promise<void>;
+    /**
+     * Parse a single JSON line and dispatch to appropriate handler
+     */
+    private parseLine;
+    /**
+     * Dispatch an event to the appropriate handler
+     */
+    private dispatchEvent;
+    /**
+     * Handle user events, extracting todo updates if present
+     */
+    private handleUserEvent;
+}
+/**
+ * Create a new Claude stream parser instance
+ */
+export declare function createStreamParser(handlers: ClaudeStreamHandlers): ClaudeStreamParser;
+//# sourceMappingURL=stream-parser.d.ts.map

package/dist/src/orchestrator/stream-parser.d.ts.map

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