aicodeman 0.2.9 → 0.3.1

package/dist/types/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/types/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5F,2BAA2B;AAC3B,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvE,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC;AAEjC;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B"}

package/dist/types/plan.js

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Plan orchestrator type definitions.
+ *
+ * Types for the 2-agent plan generation system (optional research agent → planner agent).
+ *
+ * Key exports:
+ * - PlanItem — a single task with priority (P0/P1/P2), TDD phase, dependencies, verification criteria
+ * - PlanTaskStatus — 'pending' | 'in_progress' | 'completed' | 'failed' | 'blocked'
+ * - TddPhase / PlanPhase — 'setup' | 'test' | 'impl' | 'verify' | 'review'
+ *
+ * Used by PlanOrchestrator (`src/plan-orchestrator.ts`) and the plan API routes
+ * (`src/web/routes/plan-routes.ts`). Served at `GET /api/sessions/:id/plan/tasks`.
+ *
+ * PlanItem was moved here from plan-orchestrator.ts to break a circular dependency.
+ * No dependencies on other domain modules.
+ */
+export {};
+//# sourceMappingURL=plan.js.map

package/dist/types/plan.js.map

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

package/dist/types/push.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Web Push notification type definitions.
+ *
+ * Types for the Web Push notification layer (layer 4 of the 5-layer notification system).
+ *
+ * Key exports:
+ * - PushSubscriptionRecord — a registered push endpoint with per-event preferences
+ * - VapidKeys — VAPID key pair (public + private) for Web Push authentication
+ *
+ * Persistence:
+ * - VAPID keys: `~/.codeman/push-keys.json` (auto-generated on first use)
+ * - Subscriptions: `~/.codeman/push-subscriptions.json` (expired auto-cleaned on 410/404)
+ *
+ * Managed by PushStore (`src/push-store.ts`). Served at `GET /api/push/vapid-key`,
+ * `POST /api/push/subscribe`. No dependencies on other domain modules.
+ */
+/** A registered push subscription */
+export interface PushSubscriptionRecord {
+    id: string;
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+    userAgent: string;
+    createdAt: number;
+    lastUsedAt: number;
+    pushPreferences: Record<string, boolean>;
+}
+/** VAPID key pair for Web Push */
+export interface VapidKeys {
+    publicKey: string;
+    privateKey: string;
+    generatedAt: number;
+}
+//# sourceMappingURL=push.d.ts.map

package/dist/types/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/types/push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,qCAAqC;AACrC,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,kCAAkC;AAClC,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/push.js

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Web Push notification type definitions.
+ *
+ * Types for the Web Push notification layer (layer 4 of the 5-layer notification system).
+ *
+ * Key exports:
+ * - PushSubscriptionRecord — a registered push endpoint with per-event preferences
+ * - VapidKeys — VAPID key pair (public + private) for Web Push authentication
+ *
+ * Persistence:
+ * - VAPID keys: `~/.codeman/push-keys.json` (auto-generated on first use)
+ * - Subscriptions: `~/.codeman/push-subscriptions.json` (expired auto-cleaned on 410/404)
+ *
+ * Managed by PushStore (`src/push-store.ts`). Served at `GET /api/push/vapid-key`,
+ * `POST /api/push/subscribe`. No dependencies on other domain modules.
+ */
+export {};
+//# sourceMappingURL=push.js.map

package/dist/types/push.js.map

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

package/dist/types/ralph.d.ts

@@ -0,0 +1,262 @@
+/**
+ * @fileoverview Ralph Loop / todo tracking type definitions.
+ *
+ * Covers the autonomous task execution system: loop state, todo items,
+ * completion confidence scoring, RALPH_STATUS block parsing, and the
+ * circuit breaker for stuck-loop detection.
+ *
+ * Key exports:
+ * - RalphLoopState / RalphLoopStatus — global loop controller state (embedded in AppState)
+ * - RalphTrackerState — per-session loop tracking (cycle count, completion phrase, plan version)
+ * - RalphTodoItem / RalphTodoProgress — detected todo items with priority and progress estimation
+ * - RalphSessionState — composite per-session state (loop + todos), linked via sessionId
+ * - CompletionConfidence — multi-signal scoring for completion detection (0-100)
+ * - RalphStatusBlock — parsed RALPH_STATUS block from Claude output (status, tests, exit signal)
+ * - CircuitBreakerStatus / CircuitBreakerState — stuck-loop detection state machine (CLOSED → HALF_OPEN → OPEN)
+ * - Factory functions: createInitialCircuitBreakerStatus(), createInitialRalphTrackerState(), createInitialRalphSessionState()
+ *
+ * Cross-domain relationships:
+ * - RalphLoopState is embedded in AppState.ralphLoop (app-state domain)
+ * - RalphSessionState.sessionId links to SessionState.id (session domain)
+ * - CircuitBreakerStatus feeds into RalphLoopHealthScore.components.circuitBreaker (respawn domain)
+ *
+ * Served at `GET /api/sessions/:id/ralph-state` and `GET /api/sessions/:id/ralph-status`.
+ */
+/** Status of the Ralph Loop controller */
+export type RalphLoopStatus = 'stopped' | 'running' | 'paused';
+/**
+ * State of the Ralph Loop controller
+ */
+export interface RalphLoopState {
+    /** Current loop status */
+    status: RalphLoopStatus;
+    /** Timestamp when loop started */
+    startedAt: number | null;
+    /** Minimum duration to run in milliseconds */
+    minDurationMs: number | null;
+    /** Number of tasks completed in this run */
+    tasksCompleted: number;
+    /** Number of tasks auto-generated */
+    tasksGenerated: number;
+    /** Timestamp of last status check */
+    lastCheckAt: number | null;
+}
+/** Status of a detected todo item */
+export type RalphTodoStatus = 'pending' | 'in_progress' | 'completed';
+/**
+ * Confidence scoring for completion detection.
+ * Helps distinguish genuine completion signals from false positives.
+ */
+export interface CompletionConfidence {
+    /** Overall confidence level (0-100) */
+    score: number;
+    /** Whether score is above threshold for triggering completion */
+    isConfident: boolean;
+    /** Individual signal contributions */
+    signals: {
+        /** Promise tag detected with proper formatting */
+        hasPromiseTag: boolean;
+        /** Phrase matches expected completion phrase */
+        matchesExpected: boolean;
+        /** All todos are marked complete */
+        allTodosComplete: boolean;
+        /** EXIT_SIGNAL: true in RALPH_STATUS block */
+        hasExitSignal: boolean;
+        /** Multiple completion indicators present */
+        multipleIndicators: boolean;
+        /** Output context suggests completion (not in prompt/explanation) */
+        contextAppropriate: boolean;
+    };
+    /** Timestamp of last confidence calculation */
+    calculatedAt: number;
+}
+export interface RalphTrackerState {
+    /** Whether the tracker is actively monitoring (disabled by default) */
+    enabled: boolean;
+    /** Whether a loop is currently active */
+    active: boolean;
+    /** Detected completion phrase (primary) */
+    completionPhrase: string | null;
+    /** Additional valid completion phrases (P1-003: multi-phrase support) */
+    alternateCompletionPhrases?: string[];
+    /** Timestamp when loop started */
+    startedAt: number | null;
+    /** Number of cycles/iterations detected */
+    cycleCount: number;
+    /** Maximum iterations if detected */
+    maxIterations: number | null;
+    /** Timestamp of last activity */
+    lastActivity: number;
+    /** Elapsed hours if detected */
+    elapsedHours: number | null;
+    /** Current plan version (for versioning UI) */
+    planVersion?: number;
+    /** Number of versions in history (for versioning UI) */
+    planHistoryLength?: number;
+    /** Last completion confidence assessment */
+    completionConfidence?: CompletionConfidence;
+}
+/**
+ * Priority levels for todo items.
+ * Matches @fix_plan.md format (P0=critical, P1=high, P2=normal).
+ */
+export type RalphTodoPriority = 'P0' | 'P1' | 'P2' | null;
+/**
+ * A detected todo item from Claude Code output
+ */
+export interface RalphTodoItem {
+    /** Unique identifier based on content hash */
+    id: string;
+    /** Todo item text content */
+    content: string;
+    /** Current status */
+    status: RalphTodoStatus;
+    /** Timestamp when detected */
+    detectedAt: number;
+    /** Priority level (P0=critical, P1=high, P2=normal) */
+    priority: RalphTodoPriority;
+    /** P1-009: Estimated time to complete (ms), based on historical patterns */
+    estimatedDurationMs?: number;
+    /** P1-009: Complexity category for progress estimation */
+    estimatedComplexity?: 'trivial' | 'simple' | 'moderate' | 'complex';
+}
+/**
+ * Progress estimation for the todo list
+ */
+export interface RalphTodoProgress {
+    /** Total number of todos */
+    total: number;
+    /** Number completed */
+    completed: number;
+    /** Number in progress */
+    inProgress: number;
+    /** Number pending */
+    pending: number;
+    /** Completion percentage (0-100) */
+    percentComplete: number;
+    /** Estimated remaining time (ms), based on historical completion rate */
+    estimatedRemainingMs: number | null;
+    /** Average time per todo completion (ms) */
+    avgCompletionTimeMs: number | null;
+    /** Projected completion timestamp (epoch ms) */
+    projectedCompletionAt: number | null;
+}
+/**
+ * Complete Ralph/todo state for a session
+ */
+export interface RalphSessionState {
+    /** Session this state belongs to */
+    sessionId: string;
+    /** Loop tracking state */
+    loop: RalphTrackerState;
+    /** Detected todo items */
+    todos: RalphTodoItem[];
+    /** Timestamp of last update */
+    lastUpdated: number;
+}
+/**
+ * Status values from RALPH_STATUS block.
+ * - IN_PROGRESS: Work is ongoing
+ * - COMPLETE: All tasks finished
+ * - BLOCKED: Needs human intervention
+ */
+export type RalphStatusValue = 'IN_PROGRESS' | 'COMPLETE' | 'BLOCKED';
+/**
+ * Test status from RALPH_STATUS block.
+ */
+export type RalphTestsStatus = 'PASSING' | 'FAILING' | 'NOT_RUN';
+/**
+ * Work type classification for current iteration.
+ */
+export type RalphWorkType = 'IMPLEMENTATION' | 'TESTING' | 'DOCUMENTATION' | 'REFACTORING';
+/**
+ * Parsed RALPH_STATUS block from Claude output.
+ *
+ * Claude outputs this at the end of every response:
+ * ```
+ * ---RALPH_STATUS---
+ * STATUS: IN_PROGRESS
+ * TASKS_COMPLETED_THIS_LOOP: 3
+ * FILES_MODIFIED: 5
+ * TESTS_STATUS: PASSING
+ * WORK_TYPE: IMPLEMENTATION
+ * EXIT_SIGNAL: false
+ * RECOMMENDATION: Continue with database migration
+ * ---END_RALPH_STATUS---
+ * ```
+ */
+export interface RalphStatusBlock {
+    /** Overall loop status */
+    status: RalphStatusValue;
+    /** Number of tasks completed in current iteration */
+    tasksCompletedThisLoop: number;
+    /** Number of files modified in current iteration */
+    filesModified: number;
+    /** Current state of tests */
+    testsStatus: RalphTestsStatus;
+    /** Type of work being performed */
+    workType: RalphWorkType;
+    /** Whether Claude is signaling completion */
+    exitSignal: boolean;
+    /** Claude's recommendation for next steps */
+    recommendation: string;
+    /** Timestamp when this block was parsed */
+    parsedAt: number;
+}
+/**
+ * Circuit breaker states for detecting stuck loops.
+ * - CLOSED: Normal operation, all checks passing
+ * - HALF_OPEN: Warning state, some checks failing
+ * - OPEN: Loop is stuck, requires intervention
+ */
+export type CircuitBreakerState = 'CLOSED' | 'HALF_OPEN' | 'OPEN';
+/**
+ * Reason codes for circuit breaker state transitions.
+ */
+export type CircuitBreakerReason = 'normal_operation' | 'no_progress_warning' | 'no_progress_open' | 'same_error_repeated' | 'tests_failing_too_long' | 'progress_detected' | 'manual_reset';
+/**
+ * Circuit breaker status for tracking loop health.
+ *
+ * Transitions:
+ * - CLOSED -> HALF_OPEN: consecutive_no_progress >= 2
+ * - CLOSED -> OPEN: consecutive_no_progress >= 3 OR consecutive_same_error >= 5
+ * - HALF_OPEN -> CLOSED: progress detected
+ * - HALF_OPEN -> OPEN: consecutive_no_progress >= 3
+ * - OPEN -> CLOSED: manual reset only
+ */
+export interface CircuitBreakerStatus {
+    /** Current state of the circuit breaker */
+    state: CircuitBreakerState;
+    /** Number of consecutive iterations with no progress */
+    consecutiveNoProgress: number;
+    /** Number of consecutive iterations with the same error */
+    consecutiveSameError: number;
+    /** Number of consecutive iterations with failing tests */
+    consecutiveTestsFailure: number;
+    /** Last iteration number that showed progress */
+    lastProgressIteration: number;
+    /** Human-readable reason for current state */
+    reason: string;
+    /** Reason code for programmatic handling */
+    reasonCode: CircuitBreakerReason;
+    /** Timestamp of last state transition */
+    lastTransitionAt: number;
+    /** Last error message seen (for same-error tracking) */
+    lastErrorMessage: string | null;
+}
+/**
+ * Creates initial circuit breaker status.
+ */
+export declare function createInitialCircuitBreakerStatus(): CircuitBreakerStatus;
+/**
+ * Creates initial Ralph tracker state
+ * @returns Fresh Ralph tracker state with defaults
+ */
+export declare function createInitialRalphTrackerState(): RalphTrackerState;
+/**
+ * Creates initial Ralph session state
+ * @param sessionId Session ID this state belongs to
+ * @returns Fresh Ralph session state
+ */
+export declare function createInitialRalphSessionState(sessionId: string): RalphSessionState;
+//# sourceMappingURL=ralph.d.ts.map

package/dist/types/ralph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph.d.ts","sourceRoot":"","sources":["../../src/types/ralph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,kCAAkC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,OAAO,EAAE;QACP,kDAAkD;QAClD,aAAa,EAAE,OAAO,CAAC;QACvB,gDAAgD;QAChD,eAAe,EAAE,OAAO,CAAC;QACzB,oCAAoC;QACpC,gBAAgB,EAAE,OAAO,CAAC;QAC1B,8CAA8C;QAC9C,aAAa,EAAE,OAAO,CAAC;QACvB,6CAA6C;QAC7C,kBAAkB,EAAE,OAAO,CAAC;QAC5B,qEAAqE;QACrE,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IACF,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,yEAAyE;IACzE,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;IACtC,kCAAkC;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,MAAM,EAAE,eAAe,CAAC;IACxB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;CACrE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gDAAgD;IAChD,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,IAAI,EAAE,iBAAiB,CAAC;IACxB,0BAA0B;IAC1B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,SAAS,GAAG,eAAe,GAAG,aAAa,CAAC;AAE3F;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,qDAAqD;IACrD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,mCAAmC;IACnC,QAAQ,EAAE,aAAa,CAAC;IACxB,6CAA6C;IAC7C,UAAU,EAAE,OAAO,CAAC;IACpB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,GAClB,qBAAqB,GACrB,wBAAwB,GACxB,mBAAmB,GACnB,cAAc,CAAC;AAEnB;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,wDAAwD;IACxD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,uBAAuB,EAAE,MAAM,CAAC;IAChC,iDAAiD;IACjD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,UAAU,EAAE,oBAAoB,CAAC;IACjC,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,oBAAoB,CAYxE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,iBAAiB,CAWlE;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAOnF"}

package/dist/types/ralph.js

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Ralph Loop / todo tracking type definitions.
+ *
+ * Covers the autonomous task execution system: loop state, todo items,
+ * completion confidence scoring, RALPH_STATUS block parsing, and the
+ * circuit breaker for stuck-loop detection.
+ *
+ * Key exports:
+ * - RalphLoopState / RalphLoopStatus — global loop controller state (embedded in AppState)
+ * - RalphTrackerState — per-session loop tracking (cycle count, completion phrase, plan version)
+ * - RalphTodoItem / RalphTodoProgress — detected todo items with priority and progress estimation
+ * - RalphSessionState — composite per-session state (loop + todos), linked via sessionId
+ * - CompletionConfidence — multi-signal scoring for completion detection (0-100)
+ * - RalphStatusBlock — parsed RALPH_STATUS block from Claude output (status, tests, exit signal)
+ * - CircuitBreakerStatus / CircuitBreakerState — stuck-loop detection state machine (CLOSED → HALF_OPEN → OPEN)
+ * - Factory functions: createInitialCircuitBreakerStatus(), createInitialRalphTrackerState(), createInitialRalphSessionState()
+ *
+ * Cross-domain relationships:
+ * - RalphLoopState is embedded in AppState.ralphLoop (app-state domain)
+ * - RalphSessionState.sessionId links to SessionState.id (session domain)
+ * - CircuitBreakerStatus feeds into RalphLoopHealthScore.components.circuitBreaker (respawn domain)
+ *
+ * Served at `GET /api/sessions/:id/ralph-state` and `GET /api/sessions/:id/ralph-status`.
+ */
+/**
+ * Creates initial circuit breaker status.
+ */
+export function createInitialCircuitBreakerStatus() {
+    return {
+        state: 'CLOSED',
+        consecutiveNoProgress: 0,
+        consecutiveSameError: 0,
+        consecutiveTestsFailure: 0,
+        lastProgressIteration: 0,
+        reason: 'Initial state',
+        reasonCode: 'normal_operation',
+        lastTransitionAt: Date.now(),
+        lastErrorMessage: null,
+    };
+}
+/**
+ * Creates initial Ralph tracker state
+ * @returns Fresh Ralph tracker state with defaults
+ */
+export function createInitialRalphTrackerState() {
+    return {
+        enabled: false, // Disabled by default, auto-enables when Ralph patterns detected
+        active: false,
+        completionPhrase: null,
+        startedAt: null,
+        cycleCount: 0,
+        maxIterations: null,
+        lastActivity: Date.now(),
+        elapsedHours: null,
+    };
+}
+/**
+ * Creates initial Ralph session state
+ * @param sessionId Session ID this state belongs to
+ * @returns Fresh Ralph session state
+ */
+export function createInitialRalphSessionState(sessionId) {
+    return {
+        sessionId,
+        loop: createInitialRalphTrackerState(),
+        todos: [],
+        lastUpdated: Date.now(),
+    };
+}
+//# sourceMappingURL=ralph.js.map

package/dist/types/ralph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph.js","sourceRoot":"","sources":["../../src/types/ralph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA2PH;;GAEG;AACH,MAAM,UAAU,iCAAiC;IAC/C,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,qBAAqB,EAAE,CAAC;QACxB,oBAAoB,EAAE,CAAC;QACvB,uBAAuB,EAAE,CAAC;QAC1B,qBAAqB,EAAE,CAAC;QACxB,MAAM,EAAE,eAAe;QACvB,UAAU,EAAE,kBAAkB;QAC9B,gBAAgB,EAAE,IAAI,CAAC,GAAG,EAAE;QAC5B,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,iEAAiE;QACjF,MAAM,EAAE,KAAK;QACb,gBAAgB,EAAE,IAAI;QACtB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,CAAC;QACb,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;QACxB,YAAY,EAAE,IAAI;KACnB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,SAAiB;IAC9D,OAAO;QACL,SAAS;QACT,IAAI,EAAE,8BAA8B,EAAE;QACtC,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;KACxB,CAAC;AACJ,CAAC"}