@cluesmith/codev 2.0.0-rc.1 → 2.0.0-rc.10

package/dist/commands/porch/signals.js

@@ -0,0 +1,76 @@
+/**
+ * Signal detection for Porch
+ *
+ * Watches Claude's output file for signal markers:
+ *   PHASE_COMPLETE - Phase work is done
+ *   GATE_NEEDED - Human approval required
+ *   BLOCKED: <reason> - Claude is stuck
+ */
+import * as fs from 'node:fs';
+/**
+ * Create a signal watcher for the given output file.
+ */
+export function watchForSignal(outputPath) {
+    let lastPosition = 0;
+    let stopped = false;
+    return {
+        async check() {
+            if (stopped)
+                return null;
+            try {
+                if (!fs.existsSync(outputPath)) {
+                    return null;
+                }
+                const content = fs.readFileSync(outputPath, 'utf-8');
+                // Only check new content since last position
+                const newContent = content.slice(lastPosition);
+                lastPosition = content.length;
+                // Look for signal markers
+                // These should be on their own line, possibly in output blocks
+                const lines = newContent.split('\n');
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (trimmed === 'PHASE_COMPLETE' || trimmed.includes('PHASE_COMPLETE')) {
+                        return { type: 'PHASE_COMPLETE' };
+                    }
+                    if (trimmed === 'GATE_NEEDED' || trimmed.includes('GATE_NEEDED')) {
+                        return { type: 'GATE_NEEDED' };
+                    }
+                    const blockedMatch = trimmed.match(/BLOCKED:\s*(.+)/);
+                    if (blockedMatch) {
+                        return { type: 'BLOCKED', reason: blockedMatch[1] };
+                    }
+                }
+                return null;
+            }
+            catch (err) {
+                // File might not exist yet or be locked
+                return null;
+            }
+        },
+        stop() {
+            stopped = true;
+        },
+    };
+}
+/**
+ * Parse a signal from text content (one-shot check).
+ */
+export function parseSignal(content) {
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === 'PHASE_COMPLETE') {
+            return { type: 'PHASE_COMPLETE' };
+        }
+        if (trimmed === 'GATE_NEEDED') {
+            return { type: 'GATE_NEEDED' };
+        }
+        const blockedMatch = trimmed.match(/BLOCKED:\s*(.+)/);
+        if (blockedMatch) {
+            return { type: 'BLOCKED', reason: blockedMatch[1] };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=signals.js.map

package/dist/commands/porch/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../../src/commands/porch/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAmB9B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO;QACL,KAAK,CAAC,KAAK;YACT,IAAI,OAAO;gBAAE,OAAO,IAAI,CAAC;YAEzB,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC/B,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAErD,6CAA6C;gBAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC/C,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;gBAE9B,0BAA0B;gBAC1B,+DAA+D;gBAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAE5B,IAAI,OAAO,KAAK,gBAAgB,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;wBACvE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;oBACpC,CAAC;oBAED,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;wBACjE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;oBACjC,CAAC;oBAED,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;oBACtD,IAAI,YAAY,EAAE,CAAC;wBACjB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtD,CAAC;gBACH,CAAC;gBAED,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,wCAAwC;gBACxC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,IAAI;YACF,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,OAAO,KAAK,gBAAgB,EAAE,CAAC;YACjC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;QACpC,CAAC;QAED,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACtD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commands/porch/state.d.ts

@@ -1,133 +1,40 @@
 /**
  * Porch State Management
  *
- * Handles project state persistence with:
- * - Pure YAML format (no markdown frontmatter)
- * - Atomic writes (tmp file + fsync + rename)
- * - File locking (flock advisory locking)
- * - Crash recovery
+ * Handles project state persistence with atomic writes.
+ * Fails loudly on any error - no guessing.
  */
 import type { ProjectState, Protocol } from './types.js';
-/** Directory for SPIDER project state (relative to project root) */
+/** Directory for project state (relative to project root) */
 export declare const PROJECTS_DIR = "codev/projects";
-/** Directory for TICK/BUGFIX execution state (relative to project root) */
-export declare const EXECUTIONS_DIR = "codev/executions";
 /**
- * Get the status file path for a SPIDER project
+ * Get the project directory path
  */
-export declare function getProjectStatusPath(projectRoot: string, projectId: string, name?: string): string;
+export declare function getProjectDir(projectRoot: string, projectId: string, name: string): string;
 /**
- * Get the status file path for a TICK/BUGFIX execution
+ * Get the status.yaml path for a project
  */
-export declare function getExecutionStatusPath(projectRoot: string, protocol: string, id: string, name?: string): string;
+export declare function getStatusPath(projectRoot: string, projectId: string, name: string): string;
 /**
- * Get the project directory for a SPIDER project
+ * Read project state from status.yaml
+ * Fails loudly if file is missing or corrupted.
  */
-export declare function getProjectDir(projectRoot: string, projectId: string, name?: string): string;
+export declare function readState(statusPath: string): ProjectState;
 /**
- * Get the worktree path for a protocol execution
+ * Write project state atomically (tmp file + rename)
  */
-export declare function getWorktreePath(projectRoot: string, protocol: string, id: string, name?: string): string;
-interface FileLock {
-    fd: number;
-    lockFile: string;
-}
+export declare function writeState(statusPath: string, state: ProjectState): void;
 /**
- * Acquire an advisory lock on a file
- * Creates a .lock file to indicate lock ownership
+ * Create initial state for a new project
  */
-export declare function acquireLock(filePath: string): Promise<FileLock>;
+export declare function createInitialState(protocol: Protocol, projectId: string, title: string): ProjectState;
 /**
- * Release an advisory lock
+ * Find status.yaml by project ID (searches for NNNN-* directories)
  */
-export declare function releaseLock(lock: FileLock): void;
+export declare function findStatusPath(projectRoot: string, projectId: string): string | null;
 /**
- * Simple YAML serializer for project state
- * Handles our specific data structures without external dependencies
+ * Auto-detect project ID when only one project exists.
+ * Returns null if zero or multiple projects found.
  */
-export declare function serializeState(state: ProjectState): string;
-/**
- * Parse YAML status file into ProjectState
- */
-export declare function parseState(content: string): ProjectState;
-/**
- * Read project state from status file
- */
-export declare function readState(statusFilePath: string): ProjectState | null;
-/**
- * Write project state atomically
- * Uses tmp file + fsync + rename for crash safety
- */
-export declare function writeState(statusFilePath: string, state: ProjectState): Promise<void>;
-/**
- * Create initial project state
- */
-export declare function createInitialState(protocol: Protocol, projectId: string, title: string, worktreePath?: string): ProjectState;
-/**
- * Update state with a new current state
- */
-export declare function updateState(state: ProjectState, newState: string, options?: {
-    signal?: string;
-}): ProjectState;
-/**
- * Approve a gate in state
- */
-export declare function approveGate(state: ProjectState, gateId: string): ProjectState;
-/**
- * Request a gate approval (mark as pending with timestamp)
- */
-export declare function requestGateApproval(state: ProjectState, gateId: string): ProjectState;
-/**
- * Update phase status
- */
-export declare function updatePhaseStatus(state: ProjectState, phaseId: string, status: 'pending' | 'in_progress' | 'complete'): ProjectState;
-/**
- * Set plan phases extracted from plan.md
- */
-export declare function setPlanPhases(state: ProjectState, phases: Array<{
-    id: string;
-    title: string;
-    description?: string;
-}>): ProjectState;
-/**
- * Find all SPIDER projects
- */
-export declare function findProjects(projectRoot: string): Array<{
-    id: string;
-    path: string;
-}>;
-/**
- * Find all executions (TICK, BUGFIX, etc.)
- */
-export declare function findExecutions(projectRoot: string): Array<{
-    protocol: string;
-    id: string;
-    path: string;
-}>;
-/**
- * Find status file for a project by ID
- */
-export declare function findStatusFile(projectRoot: string, projectId: string): string | null;
-/**
- * Get the number of consultation attempts for a given state
- */
-export declare function getConsultationAttempts(state: ProjectState, stateKey: string): number;
-/**
- * Increment consultation attempts for a given state
- */
-export declare function incrementConsultationAttempts(state: ProjectState, stateKey: string): ProjectState;
-/**
- * Reset consultation attempts for a given state (e.g., after gate approval)
- */
-export declare function resetConsultationAttempts(state: ProjectState, stateKey: string): ProjectState;
-/**
- * Find all status files with pending gates
- */
-export declare function findPendingGates(projectRoot: string): Array<{
-    projectId: string;
-    gateId: string;
-    requestedAt?: string;
-    statusPath: string;
-}>;
-export {};
+export declare function detectProjectId(projectRoot: string): string | null;
 //# sourceMappingURL=state.d.ts.map

package/dist/commands/porch/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAa,MAAM,YAAY,CAAC;AAEpE,6DAA6D;AAC7D,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAM7C;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1F;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAwB1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAmBxE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,YAAY,CA4Bd;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBpF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBlE"}