aicodeman 0.2.9 → 0.3.1

package/dist/types/api.js

@@ -0,0 +1,98 @@
+/**
+ * @fileoverview API types and error handling.
+ *
+ * Defines the standardized API response envelope (ApiResponse), error codes,
+ * hook event types from Claude Code's hooks system, and utility functions
+ * for error message extraction. Used by all route modules in `src/web/routes/`.
+ *
+ * Key exports:
+ * - ApiResponse<T> — discriminated union envelope (success with data or error with code)
+ * - ApiErrorCode — enum of standard error codes with user-friendly messages
+ * - HookEventType — union of Claude Code hook event names (idle_prompt, stop, etc.)
+ * - createErrorResponse() — factory for consistent error responses
+ * - getErrorMessage() — safe extraction from unknown catch values
+ * - CaseInfo, QuickStartResponse — case folder metadata types
+ *
+ * No dependencies on other domain modules. Consumed by all route modules
+ * and validated via Zod schemas in `src/web/schemas.ts`.
+ */
+/**
+ * Standard error codes for API responses
+ */
+export var ApiErrorCode;
+(function (ApiErrorCode) {
+    /** Resource not found */
+    ApiErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    /** Invalid input provided */
+    ApiErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    /** Session is currently busy */
+    ApiErrorCode["SESSION_BUSY"] = "SESSION_BUSY";
+    /** Operation failed */
+    ApiErrorCode["OPERATION_FAILED"] = "OPERATION_FAILED";
+    /** Resource already exists */
+    ApiErrorCode["ALREADY_EXISTS"] = "ALREADY_EXISTS";
+    /** Internal server error */
+    ApiErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(ApiErrorCode || (ApiErrorCode = {}));
+/**
+ * User-friendly error messages for each error code
+ */
+const ErrorMessages = {
+    [ApiErrorCode.NOT_FOUND]: 'The requested resource was not found',
+    [ApiErrorCode.INVALID_INPUT]: 'Invalid input provided',
+    [ApiErrorCode.SESSION_BUSY]: 'Session is currently busy',
+    [ApiErrorCode.OPERATION_FAILED]: 'The operation failed',
+    [ApiErrorCode.ALREADY_EXISTS]: 'Resource already exists',
+    [ApiErrorCode.INTERNAL_ERROR]: 'An internal error occurred',
+};
+/**
+ * Creates a standardized error response
+ * @param code Error code
+ * @param details Optional detailed error message
+ * @returns Formatted error response
+ */
+export function createErrorResponse(code, details) {
+    return {
+        success: false,
+        error: details || ErrorMessages[code],
+        errorCode: code,
+    };
+}
+// ========== Error Handling Utilities ==========
+/**
+ * Type guard to check if a value is an Error instance
+ * @param value The value to check
+ * @returns True if the value is an Error instance
+ */
+export function isError(value) {
+    return value instanceof Error;
+}
+/**
+ * Safely extracts an error message from an unknown caught value.
+ * Handles the TypeScript 4.4+ unknown error type in catch blocks.
+ *
+ * @param error The caught error (type unknown in strict mode)
+ * @returns A string error message
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await riskyOperation();
+ * } catch (err) {
+ *   console.error('Failed:', getErrorMessage(err));
+ * }
+ * ```
+ */
+export function getErrorMessage(error) {
+    if (isError(error)) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object' && 'message' in error) {
+        return String(error.message);
+    }
+    return 'An unknown error occurred';
+}
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,YAaX;AAbD,WAAY,YAAY;IACtB,yBAAyB;IACzB,uCAAuB,CAAA;IACvB,6BAA6B;IAC7B,+CAA+B,CAAA;IAC/B,gCAAgC;IAChC,6CAA6B,CAAA;IAC7B,uBAAuB;IACvB,qDAAqC,CAAA;IACrC,8BAA8B;IAC9B,iDAAiC,CAAA;IACjC,4BAA4B;IAC5B,iDAAiC,CAAA;AACnC,CAAC,EAbW,YAAY,KAAZ,YAAY,QAavB;AAED;;GAEG;AACH,MAAM,aAAa,GAAiC;IAClD,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,sCAAsC;IAChE,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,wBAAwB;IACtD,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,2BAA2B;IACxD,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,sBAAsB;IACvD,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,yBAAyB;IACxD,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,4BAA4B;CAC5D,CAAC;AAuBF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAkB,EAAE,OAAgB;IACtE,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC;QACrC,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AA8BD,iDAAiD;AAEjD;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAE,KAA8B,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,2BAA2B,CAAC;AACrC,CAAC"}

package/dist/types/app-state.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Application state type definitions.
+ *
+ * Defines the top-level persisted state structure (AppState) which composes
+ * types from multiple domains: SessionState (session), TaskState (task),
+ * RalphLoopState (ralph), and RespawnConfig (respawn).
+ *
+ * Key exports:
+ * - AppState — root state object (sessions, tasks, ralphLoop, config, globalStats, tokenStats)
+ * - AppConfig — app configuration including default RespawnConfig
+ * - GlobalStats — cumulative usage stats across all sessions (lifetime)
+ * - TokenStats / TokenUsageEntry — daily token usage history
+ * - DEFAULT_CONFIG — default AppConfig values
+ * - createInitialState() — factory for fresh AppState
+ *
+ * Persisted to `~/.codeman/state.json` via StateStore (debounced 500ms writes).
+ * Served at `GET /api/status` (full state) and `GET /api/config` (config subset).
+ *
+ * Cross-domain imports: SessionState, TaskState, RalphLoopState, RespawnConfig.
+ */
+import type { SessionState } from './session.js';
+import type { TaskState } from './task.js';
+import type { RalphLoopState } from './ralph.js';
+import type { RespawnConfig } from './respawn.js';
+/**
+ * Global statistics across all sessions (including deleted ones).
+ * Persisted to track cumulative usage over time.
+ */
+export interface GlobalStats {
+    /** Total input tokens used across all sessions */
+    totalInputTokens: number;
+    /** Total output tokens used across all sessions */
+    totalOutputTokens: number;
+    /** Total cost in USD across all sessions */
+    totalCost: number;
+    /** Total number of sessions created (lifetime) */
+    totalSessionsCreated: number;
+    /** Timestamp when stats were first recorded */
+    firstRecordedAt: number;
+    /** Timestamp of last update */
+    lastUpdatedAt: number;
+}
+/**
+ * Daily token usage entry for historical tracking.
+ */
+export interface TokenUsageEntry {
+    /** Date in YYYY-MM-DD format */
+    date: string;
+    /** Input tokens used on this day */
+    inputTokens: number;
+    /** Output tokens used on this day */
+    outputTokens: number;
+    /** Estimated cost in USD */
+    estimatedCost: number;
+    /** Number of sessions that contributed to this day's usage */
+    sessions: number;
+}
+/**
+ * Token usage statistics with daily tracking.
+ */
+export interface TokenStats {
+    /** Daily usage entries (most recent first) */
+    daily: TokenUsageEntry[];
+    /** Timestamp of last update */
+    lastUpdated: number;
+}
+/**
+ * Application configuration
+ */
+export interface AppConfig {
+    /** Interval for polling session status (ms) */
+    pollIntervalMs: number;
+    /** Default timeout for tasks (ms) */
+    defaultTimeoutMs: number;
+    /** Maximum concurrent sessions allowed */
+    maxConcurrentSessions: number;
+    /** Path to state file */
+    stateFilePath: string;
+    /** Respawn controller configuration */
+    respawn: RespawnConfig;
+    /** Last used case name (for default selection) */
+    lastUsedCase: string | null;
+    /** Whether Ralph/Todo tracker is globally enabled for all new sessions */
+    ralphEnabled: boolean;
+}
+/**
+ * Complete application state
+ */
+export interface AppState {
+    /** Map of session ID to session state */
+    sessions: Record<string, SessionState>;
+    /** Map of task ID to task state */
+    tasks: Record<string, TaskState>;
+    /** Ralph Loop controller state */
+    ralphLoop: RalphLoopState;
+    /** Application configuration */
+    config: AppConfig;
+    /** Global statistics (cumulative across all sessions) */
+    globalStats?: GlobalStats;
+    /** Daily token usage statistics */
+    tokenStats?: TokenStats;
+}
+/**
+ * Default application configuration values
+ */
+export declare const DEFAULT_CONFIG: AppConfig;
+/**
+ * Creates initial application state
+ * @returns Fresh application state with defaults
+ */
+export declare function createInitialState(): AppState;
+/**
+ * Creates initial global stats object
+ * @returns Fresh global stats with zero values
+ */
+export declare function createInitialGlobalStats(): GlobalStats;
+//# sourceMappingURL=app-state.d.ts.map

package/dist/types/app-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.d.ts","sourceRoot":"","sources":["../../src/types/app-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,OAAO,EAAE,aAAa,CAAC;IACvB,kDAAkD;IAClD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0EAA0E;IAC1E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,kCAAkC;IAClC,SAAS,EAAE,cAAc,CAAC;IAC1B,gCAAgC;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,yDAAyD;IACzD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,mCAAmC;IACnC,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAID;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAe5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAe7C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAUtD"}

package/dist/types/app-state.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Application state type definitions.
+ *
+ * Defines the top-level persisted state structure (AppState) which composes
+ * types from multiple domains: SessionState (session), TaskState (task),
+ * RalphLoopState (ralph), and RespawnConfig (respawn).
+ *
+ * Key exports:
+ * - AppState — root state object (sessions, tasks, ralphLoop, config, globalStats, tokenStats)
+ * - AppConfig — app configuration including default RespawnConfig
+ * - GlobalStats — cumulative usage stats across all sessions (lifetime)
+ * - TokenStats / TokenUsageEntry — daily token usage history
+ * - DEFAULT_CONFIG — default AppConfig values
+ * - createInitialState() — factory for fresh AppState
+ *
+ * Persisted to `~/.codeman/state.json` via StateStore (debounced 500ms writes).
+ * Served at `GET /api/status` (full state) and `GET /api/config` (config subset).
+ *
+ * Cross-domain imports: SessionState, TaskState, RalphLoopState, RespawnConfig.
+ */
+// ========== Default Configuration ==========
+/**
+ * Default application configuration values
+ */
+export const DEFAULT_CONFIG = {
+    pollIntervalMs: 1000,
+    defaultTimeoutMs: 300000, // 5 minutes
+    maxConcurrentSessions: 5,
+    stateFilePath: '',
+    respawn: {
+        idleTimeoutMs: 5000, // 5 seconds of no activity after prompt
+        updatePrompt: 'update all the docs and CLAUDE.md',
+        interStepDelayMs: 1000, // 1 second between steps
+        enabled: false, // disabled by default
+        sendClear: true, // send /clear after update prompt
+        sendInit: true, // send /init after /clear
+    },
+    lastUsedCase: null,
+    ralphEnabled: false,
+};
+/**
+ * Creates initial application state
+ * @returns Fresh application state with defaults
+ */
+export function createInitialState() {
+    return {
+        sessions: {},
+        tasks: {},
+        ralphLoop: {
+            status: 'stopped',
+            startedAt: null,
+            minDurationMs: null,
+            tasksCompleted: 0,
+            tasksGenerated: 0,
+            lastCheckAt: null,
+        },
+        config: { ...DEFAULT_CONFIG },
+        globalStats: createInitialGlobalStats(),
+    };
+}
+/**
+ * Creates initial global stats object
+ * @returns Fresh global stats with zero values
+ */
+export function createInitialGlobalStats() {
+    const now = Date.now();
+    return {
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCost: 0,
+        totalSessionsCreated: 0,
+        firstRecordedAt: now,
+        lastUpdatedAt: now,
+    };
+}
+//# sourceMappingURL=app-state.js.map

package/dist/types/app-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.js","sourceRoot":"","sources":["../../src/types/app-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA8FH,8CAA8C;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,MAAM,EAAE,YAAY;IACtC,qBAAqB,EAAE,CAAC;IACxB,aAAa,EAAE,EAAE;IACjB,OAAO,EAAE;QACP,aAAa,EAAE,IAAI,EAAE,wCAAwC;QAC7D,YAAY,EAAE,mCAAmC;QACjD,gBAAgB,EAAE,IAAI,EAAE,yBAAyB;QACjD,OAAO,EAAE,KAAK,EAAE,sBAAsB;QACtC,SAAS,EAAE,IAAI,EAAE,kCAAkC;QACnD,QAAQ,EAAE,IAAI,EAAE,0BAA0B;KAC3C;IACD,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,KAAK;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,SAAS,EAAE;YACT,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;YACnB,cAAc,EAAE,CAAC;YACjB,cAAc,EAAE,CAAC;YACjB,WAAW,EAAE,IAAI;SAClB;QACD,MAAM,EAAE,EAAE,GAAG,cAAc,EAAE;QAC7B,WAAW,EAAE,wBAAwB,EAAE;KACxC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACL,gBAAgB,EAAE,CAAC;QACnB,iBAAiB,EAAE,CAAC;QACpB,SAAS,EAAE,CAAC;QACZ,oBAAoB,EAAE,CAAC;QACvB,eAAe,EAAE,GAAG;QACpB,aAAa,EAAE,GAAG;KACnB,CAAC;AACJ,CAAC"}

package/dist/types/common.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Common/shared type definitions.
+ *
+ * Base types used across multiple domains. No dependencies on other domain modules.
+ *
+ * Key exports:
+ * - Disposable — interface for objects requiring explicit cleanup (timers, watchers)
+ * - BufferConfig — size-limited storage config (terminal: 2MB, text: 1MB)
+ * - CleanupRegistration / CleanupResourceType — entries for the centralized CleanupManager
+ * - NiceConfig / DEFAULT_NICE_CONFIG — process priority settings for `nice`/`ionice`
+ * - ProcessStats — memory/CPU/child-count snapshot for resource monitoring
+ */
+/**
+ * Interface for objects that hold resources requiring explicit cleanup.
+ * Implementing classes should release timers, watchers, and other resources in dispose().
+ */
+export interface Disposable {
+    /** Release all held resources. Safe to call multiple times. */
+    dispose(): void;
+    /** Whether this object has been disposed */
+    readonly isDisposed: boolean;
+}
+/**
+ * Configuration for buffer accumulator instances.
+ * Used for terminal buffers, text output, and other size-limited string storage.
+ */
+export interface BufferConfig {
+    /** Maximum buffer size in bytes before trimming */
+    maxSize: number;
+    /** Size to trim to when maxSize is exceeded */
+    trimSize: number;
+    /** Optional callback invoked when buffer is trimmed */
+    onTrim?: (trimmedBytes: number) => void;
+}
+/**
+ * Resource types that can be registered for cleanup.
+ */
+/**
+ * Configuration for process priority using `nice`.
+ * Lower priority reduces CPU contention with other processes.
+ */
+export interface NiceConfig {
+    /** Whether nice priority is enabled */
+    enabled: boolean;
+    /** Nice value (-20 to 19, default: 10 = lower priority) */
+    niceValue: number;
+}
+export declare const DEFAULT_NICE_CONFIG: NiceConfig;
+/**
+ * Process resource statistics
+ */
+export interface ProcessStats {
+    /** Memory usage in megabytes */
+    memoryMB: number;
+    /** CPU usage percentage */
+    cpuPercent: number;
+    /** Number of child processes */
+    childCount: number;
+    /** Timestamp of stats collection */
+    updatedAt: number;
+}
+export type CleanupResourceType = 'timer' | 'interval' | 'watcher' | 'listener' | 'stream';
+/**
+ * Registration entry for a cleanup resource.
+ * Used by CleanupManager to track and dispose resources.
+ */
+export interface CleanupRegistration {
+    /** Unique identifier for this registration */
+    id: string;
+    /** Type of resource */
+    type: CleanupResourceType;
+    /** Human-readable description for debugging */
+    description: string;
+    /** Cleanup function to call on dispose */
+    cleanup: () => void;
+    /** Timestamp when registered */
+    registeredAt: number;
+}
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,OAAO,IAAI,IAAI,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;GAEG;AACH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,mBAAmB,EAAE,UAGjC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE3F;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/common.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Common/shared type definitions.
+ *
+ * Base types used across multiple domains. No dependencies on other domain modules.
+ *
+ * Key exports:
+ * - Disposable — interface for objects requiring explicit cleanup (timers, watchers)
+ * - BufferConfig — size-limited storage config (terminal: 2MB, text: 1MB)
+ * - CleanupRegistration / CleanupResourceType — entries for the centralized CleanupManager
+ * - NiceConfig / DEFAULT_NICE_CONFIG — process priority settings for `nice`/`ionice`
+ * - ProcessStats — memory/CPU/child-count snapshot for resource monitoring
+ */
+export const DEFAULT_NICE_CONFIG = {
+    enabled: false,
+    niceValue: 10,
+};
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwCH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,EAAE;CACd,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Barrel re-export for all Codeman type definitions.
+ *
+ * The type system is split into 13 domain modules for maintainability.
+ * Import from `'./types'` (or `'./types/index.js'`) to access any type:
+ *
+ * ```ts
+ * import type { SessionState, AppState, RespawnConfig } from './types';
+ * import { createErrorResponse, ApiErrorCode } from './types';
+ * ```
+ *
+ * ## Domain modules
+ *
+ * | Module       | Key exports                                                           | Persistence / API                              |
+ * |--------------|-----------------------------------------------------------------------|-------------------------------------------------|
+ * | common       | Disposable, BufferConfig, CleanupRegistration, NiceConfig, ProcessStats | In-memory only                                 |
+ * | session      | SessionState, SessionConfig, SessionStatus, SessionMode, ClaudeMode, OpenCodeConfig | `~/.codeman/state.json` → `GET /api/sessions`  |
+ * | task         | TaskDefinition, TaskState, TaskStatus                                 | `~/.codeman/state.json` → `GET /api/tasks`     |
+ * | app-state    | AppState, AppConfig, GlobalStats, TokenStats, DEFAULT_CONFIG          | `~/.codeman/state.json` → `GET /api/status`    |
+ * | respawn      | RespawnConfig, RespawnPreset, RespawnCycleMetrics, RalphLoopHealthScore, TimingHistory | Per-session in state.json → `GET /api/sessions/:id/respawn` |
+ * | ralph        | RalphTrackerState, RalphTodoItem, CircuitBreakerStatus, RalphStatusBlock, RalphSessionState | Per-session → `GET /api/sessions/:id/ralph-state` |
+ * | api          | ApiResponse, ApiErrorCode, HookEventType, CaseInfo, createErrorResponse, getErrorMessage | Used by all route handlers                     |
+ * | lifecycle    | LifecycleEntry, LifecycleEventType                                    | `~/.codeman/session-lifecycle.jsonl` (append-only) |
+ * | run-summary  | RunSummary, RunSummaryEvent, RunSummaryStats                          | In-memory → `GET /api/sessions/:id/run-summary` |
+ * | tools        | ActiveBashTool, ImageDetectedEvent                                    | In-memory, broadcast via SSE                   |
+ * | teams        | TeamConfig, TeamMember, TeamTask, InboxMessage, PaneInfo              | `~/.claude/teams/`, `~/.claude/tasks/` → `GET /api/teams` |
+ * | push         | PushSubscriptionRecord, VapidKeys                                     | `~/.codeman/push-keys.json`, `~/.codeman/push-subscriptions.json` |
+ * | plan         | PlanItem, PlanTaskStatus, TddPhase                                    | In-memory → `GET /api/sessions/:id/plan/tasks` |
+ *
+ * ## Cross-domain relationship map
+ *
+ * ```
+ * AppState (app-state)
+ * ├── sessions: Record<id, SessionState>        ← session domain
+ * │   ├── respawnConfig?: RespawnConfig          ← respawn domain (per-session settings)
+ * │   ├── ralphEnabled?: boolean                 ← toggles ralph tracking
+ * │   └── id ← referenced by:
+ * │       ├── RalphSessionState.sessionId        ← ralph domain
+ * │       ├── RunSummary.sessionId               ← run-summary domain
+ * │       ├── ActiveBashTool.sessionId            ← tools domain
+ * │       ├── RespawnCycleMetrics.sessionId       ← respawn domain
+ * │       └── TeamConfig.leadSessionId            ← teams domain
+ * ├── tasks: Record<id, TaskState>              ← task domain
+ * │   └── assignedSessionId → SessionState.id
+ * ├── ralphLoop: RalphLoopState                 ← ralph domain (global loop state)
+ * └── config: AppConfig
+ *     └── respawn: RespawnConfig                ← respawn domain (global defaults)
+ *
+ * RalphLoopHealthScore (respawn)
+ * └── components.circuitBreaker ← derived from CircuitBreakerStatus (ralph)
+ * ```
+ */
+export * from './common.js';
+export * from './session.js';
+export * from './task.js';
+export * from './app-state.js';
+export * from './respawn.js';
+export * from './ralph.js';
+export * from './api.js';
+export * from './lifecycle.js';
+export * from './run-summary.js';
+export * from './tools.js';
+export * from './teams.js';
+export * from './push.js';
+export * from './plan.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Barrel re-export for all Codeman type definitions.
+ *
+ * The type system is split into 13 domain modules for maintainability.
+ * Import from `'./types'` (or `'./types/index.js'`) to access any type:
+ *
+ * ```ts
+ * import type { SessionState, AppState, RespawnConfig } from './types';
+ * import { createErrorResponse, ApiErrorCode } from './types';
+ * ```
+ *
+ * ## Domain modules
+ *
+ * | Module       | Key exports                                                           | Persistence / API                              |
+ * |--------------|-----------------------------------------------------------------------|-------------------------------------------------|
+ * | common       | Disposable, BufferConfig, CleanupRegistration, NiceConfig, ProcessStats | In-memory only                                 |
+ * | session      | SessionState, SessionConfig, SessionStatus, SessionMode, ClaudeMode, OpenCodeConfig | `~/.codeman/state.json` → `GET /api/sessions`  |
+ * | task         | TaskDefinition, TaskState, TaskStatus                                 | `~/.codeman/state.json` → `GET /api/tasks`     |
+ * | app-state    | AppState, AppConfig, GlobalStats, TokenStats, DEFAULT_CONFIG          | `~/.codeman/state.json` → `GET /api/status`    |
+ * | respawn      | RespawnConfig, RespawnPreset, RespawnCycleMetrics, RalphLoopHealthScore, TimingHistory | Per-session in state.json → `GET /api/sessions/:id/respawn` |
+ * | ralph        | RalphTrackerState, RalphTodoItem, CircuitBreakerStatus, RalphStatusBlock, RalphSessionState | Per-session → `GET /api/sessions/:id/ralph-state` |
+ * | api          | ApiResponse, ApiErrorCode, HookEventType, CaseInfo, createErrorResponse, getErrorMessage | Used by all route handlers                     |
+ * | lifecycle    | LifecycleEntry, LifecycleEventType                                    | `~/.codeman/session-lifecycle.jsonl` (append-only) |
+ * | run-summary  | RunSummary, RunSummaryEvent, RunSummaryStats                          | In-memory → `GET /api/sessions/:id/run-summary` |
+ * | tools        | ActiveBashTool, ImageDetectedEvent                                    | In-memory, broadcast via SSE                   |
+ * | teams        | TeamConfig, TeamMember, TeamTask, InboxMessage, PaneInfo              | `~/.claude/teams/`, `~/.claude/tasks/` → `GET /api/teams` |
+ * | push         | PushSubscriptionRecord, VapidKeys                                     | `~/.codeman/push-keys.json`, `~/.codeman/push-subscriptions.json` |
+ * | plan         | PlanItem, PlanTaskStatus, TddPhase                                    | In-memory → `GET /api/sessions/:id/plan/tasks` |
+ *
+ * ## Cross-domain relationship map
+ *
+ * ```
+ * AppState (app-state)
+ * ├── sessions: Record<id, SessionState>        ← session domain
+ * │   ├── respawnConfig?: RespawnConfig          ← respawn domain (per-session settings)
+ * │   ├── ralphEnabled?: boolean                 ← toggles ralph tracking
+ * │   └── id ← referenced by:
+ * │       ├── RalphSessionState.sessionId        ← ralph domain
+ * │       ├── RunSummary.sessionId               ← run-summary domain
+ * │       ├── ActiveBashTool.sessionId            ← tools domain
+ * │       ├── RespawnCycleMetrics.sessionId       ← respawn domain
+ * │       └── TeamConfig.leadSessionId            ← teams domain
+ * ├── tasks: Record<id, TaskState>              ← task domain
+ * │   └── assignedSessionId → SessionState.id
+ * ├── ralphLoop: RalphLoopState                 ← ralph domain (global loop state)
+ * └── config: AppConfig
+ *     └── respawn: RespawnConfig                ← respawn domain (global defaults)
+ *
+ * RalphLoopHealthScore (respawn)
+ * └── components.circuitBreaker ← derived from CircuitBreakerStatus (ralph)
+ * ```
+ */
+export * from './common.js';
+export * from './session.js';
+export * from './task.js';
+export * from './app-state.js';
+export * from './respawn.js';
+export * from './ralph.js';
+export * from './api.js';
+export * from './lifecycle.js';
+export * from './run-summary.js';
+export * from './tools.js';
+export * from './teams.js';
+export * from './push.js';
+export * from './plan.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/types/lifecycle.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Session lifecycle audit types.
+ *
+ * Types for the append-only JSONL audit log at `~/.codeman/session-lifecycle.jsonl`.
+ * Records session creation, PTY launch/exit, server start/stop, tmux recovery,
+ * and QR auth events. Written by `SessionLifecycleLog`, read for debugging.
+ *
+ * Key exports:
+ * - LifecycleEventType — union of 11 event types (created, started, exit, qr_auth, etc.)
+ * - LifecycleEntry — a single timestamped log entry with event, sessionId, and optional metadata
+ *
+ * No dependencies on other domain modules. LifecycleEntry.sessionId links
+ * back to SessionState.id for correlation.
+ */
+/** Types of session lifecycle events recorded to the audit log */
+export type LifecycleEventType = 'created' | 'started' | 'exit' | 'deleted' | 'detached' | 'recovered' | 'stale_cleaned' | 'mux_died' | 'server_started' | 'server_stopped' | 'qr_auth';
+/** A single entry in the session lifecycle audit log */
+export interface LifecycleEntry {
+    ts: number;
+    event: LifecycleEventType;
+    sessionId: string;
+    name?: string;
+    mode?: string;
+    reason?: string;
+    exitCode?: number | null;
+    extra?: Record<string, unknown>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/types/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,SAAS,GACT,MAAM,GACN,SAAS,GACT,UAAU,GACV,WAAW,GACX,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,gBAAgB,GAChB,SAAS,CAAC;AAEd,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC"}

package/dist/types/lifecycle.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Session lifecycle audit types.
+ *
+ * Types for the append-only JSONL audit log at `~/.codeman/session-lifecycle.jsonl`.
+ * Records session creation, PTY launch/exit, server start/stop, tmux recovery,
+ * and QR auth events. Written by `SessionLifecycleLog`, read for debugging.
+ *
+ * Key exports:
+ * - LifecycleEventType — union of 11 event types (created, started, exit, qr_auth, etc.)
+ * - LifecycleEntry — a single timestamped log entry with event, sessionId, and optional metadata
+ *
+ * No dependencies on other domain modules. LifecycleEntry.sessionId links
+ * back to SessionState.id for correlation.
+ */
+export {};
+//# sourceMappingURL=lifecycle.js.map

package/dist/types/lifecycle.js.map

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

package/dist/types/plan.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @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.
+ */
+/** Task execution status for plan tracking */
+export type PlanTaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'blocked';
+/** TDD phase categories */
+export type TddPhase = 'setup' | 'test' | 'impl' | 'verify' | 'review';
+/** Development phase in TDD cycle (alias for TddPhase) */
+export type PlanPhase = TddPhase;
+/**
+ * A single plan item for plan orchestration.
+ * Moved here from plan-orchestrator.ts to break circular dependency.
+ */
+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[];
+}
+//# sourceMappingURL=plan.d.ts.map