@cluesmith/codev 1.6.1 → 2.0.0-rc.1

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

@@ -0,0 +1,133 @@
+/**
+ * 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
+ */
+import type { ProjectState, Protocol } from './types.js';
+/** Directory for SPIDER 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
+ */
+export declare function getProjectStatusPath(projectRoot: string, projectId: string, name?: string): string;
+/**
+ * Get the status file path for a TICK/BUGFIX execution
+ */
+export declare function getExecutionStatusPath(projectRoot: string, protocol: string, id: string, name?: string): string;
+/**
+ * Get the project directory for a SPIDER project
+ */
+export declare function getProjectDir(projectRoot: string, projectId: string, name?: string): string;
+/**
+ * Get the worktree path for a protocol execution
+ */
+export declare function getWorktreePath(projectRoot: string, protocol: string, id: string, name?: string): string;
+interface FileLock {
+    fd: number;
+    lockFile: string;
+}
+/**
+ * Acquire an advisory lock on a file
+ * Creates a .lock file to indicate lock ownership
+ */
+export declare function acquireLock(filePath: string): Promise<FileLock>;
+/**
+ * Release an advisory lock
+ */
+export declare function releaseLock(lock: FileLock): void;
+/**
+ * Simple YAML serializer for project state
+ * Handles our specific data structures without external dependencies
+ */
+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 {};
+//# sourceMappingURL=state.d.ts.map

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

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