@cluesmith/codev 2.0.0-rc.7 → 2.0.0-rc.70

package/dist/commands/porch/protocol.js

@@ -0,0 +1,294 @@
+/**
+ * Porch Protocol Loading
+ *
+ * Loads protocol definitions from JSON files.
+ * Fails loudly if protocol not found or invalid.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/** Known protocol locations (relative to project root) */
+const PROTOCOL_PATHS = [
+    'codev/protocols',
+    'codev-skeleton/protocols',
+];
+// ============================================================================
+// Protocol Loading
+// ============================================================================
+/**
+ * Find and load a protocol by name
+ * Fails loudly if not found or invalid.
+ */
+export function loadProtocol(projectRoot, protocolName) {
+    const protocolFile = findProtocolFile(projectRoot, protocolName);
+    if (!protocolFile) {
+        throw new Error(`Protocol '${protocolName}' not found.\n` +
+            `Searched in: ${PROTOCOL_PATHS.map(p => path.join(projectRoot, p, protocolName)).join(', ')}`);
+    }
+    try {
+        const content = fs.readFileSync(protocolFile, 'utf-8');
+        const json = JSON.parse(content);
+        return normalizeProtocol(json);
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            throw new Error(`Invalid protocol '${protocolName}': JSON parse error\n${err.message}`);
+        }
+        throw err;
+    }
+}
+/**
+ * Find protocol.json file in {name}/protocol.json format.
+ * Falls back to alias lookup: scans all protocol.json files for a matching "alias" field.
+ */
+function findProtocolFile(projectRoot, protocolName) {
+    // Direct lookup first
+    for (const basePath of PROTOCOL_PATHS) {
+        const fullPath = path.resolve(projectRoot, basePath, protocolName, 'protocol.json');
+        if (fs.existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    // Alias lookup: scan all protocol.json files for matching alias
+    for (const basePath of PROTOCOL_PATHS) {
+        const protocolsDir = path.resolve(projectRoot, basePath);
+        if (!fs.existsSync(protocolsDir))
+            continue;
+        try {
+            const dirs = fs.readdirSync(protocolsDir, { withFileTypes: true })
+                .filter(d => d.isDirectory());
+            for (const dir of dirs) {
+                const jsonPath = path.join(protocolsDir, dir.name, 'protocol.json');
+                if (!fs.existsSync(jsonPath))
+                    continue;
+                try {
+                    const content = JSON.parse(fs.readFileSync(jsonPath, 'utf-8'));
+                    if (content.alias === protocolName) {
+                        return jsonPath;
+                    }
+                }
+                catch { /* skip invalid JSON */ }
+            }
+        }
+        catch { /* skip unreadable dirs */ }
+    }
+    return null;
+}
+/**
+ * Normalize protocol JSON to our simplified Protocol type
+ */
+function normalizeProtocol(json) {
+    const obj = json;
+    if (!obj.name || typeof obj.name !== 'string') {
+        throw new Error('Invalid protocol: missing "name" field');
+    }
+    if (!obj.phases || !Array.isArray(obj.phases)) {
+        throw new Error('Invalid protocol: missing "phases" array');
+    }
+    const phases = obj.phases.map((p) => normalizePhase(p));
+    // Set next phase based on array order (if not explicitly set)
+    for (let i = 0; i < phases.length; i++) {
+        if (!phases[i].next && i + 1 < phases.length) {
+            phases[i].next = phases[i + 1].id;
+        }
+    }
+    // Extract default checks
+    const checks = {};
+    const defaults = obj.defaults;
+    if (defaults?.checks) {
+        for (const [name, val] of Object.entries(defaults.checks)) {
+            if (typeof val === 'string') {
+                checks[name] = { command: val };
+            }
+            else if (typeof val === 'object' && val !== null && 'command' in val) {
+                const checkObj = val;
+                checks[name] = { command: checkObj.command, cwd: checkObj.cwd };
+            }
+        }
+    }
+    // Also collect per-phase checks (override defaults)
+    for (const phase of obj.phases) {
+        if (phase.checks && typeof phase.checks === 'object') {
+            for (const [name, check] of Object.entries(phase.checks)) {
+                if (typeof check === 'object' && check !== null && 'command' in check) {
+                    const checkObj = check;
+                    checks[name] = { command: checkObj.command, cwd: checkObj.cwd };
+                }
+                else if (typeof check === 'string') {
+                    checks[name] = { command: check };
+                }
+            }
+        }
+    }
+    return {
+        name: obj.name,
+        version: obj.version,
+        description: obj.description,
+        phases,
+        checks,
+    };
+}
+/**
+ * Normalize a phase from JSON
+ */
+function normalizePhase(p) {
+    const phase = p;
+    if (!phase.id || typeof phase.id !== 'string') {
+        throw new Error('Invalid protocol phase: missing "id"');
+    }
+    // Determine next phase from transition or gate
+    let next;
+    const transition = phase.transition;
+    // Gate can be a string (gate name) or object { name, next }
+    let gateName;
+    if (typeof phase.gate === 'string') {
+        gateName = phase.gate;
+    }
+    else if (typeof phase.gate === 'object' && phase.gate !== null) {
+        const gateObj = phase.gate;
+        gateName = gateObj.name;
+        if (gateObj.next !== undefined) {
+            next = gateObj.next;
+        }
+    }
+    if (transition?.on_complete) {
+        next = transition.on_complete;
+    }
+    // Collect check names
+    const checks = [];
+    if (phase.checks && typeof phase.checks === 'object') {
+        checks.push(...Object.keys(phase.checks));
+    }
+    // Parse build config (for build_verify phases)
+    let build;
+    const buildRaw = phase.build;
+    if (buildRaw) {
+        build = {
+            prompt: buildRaw.prompt,
+            artifact: buildRaw.artifact,
+        };
+    }
+    // Parse verify config (for build_verify phases)
+    let verify;
+    const verifyRaw = phase.verify;
+    if (verifyRaw) {
+        verify = {
+            type: verifyRaw.type,
+            models: verifyRaw.models,
+            parallel: verifyRaw.parallel ?? true,
+        };
+    }
+    // Parse on_complete config
+    let on_complete;
+    const onCompleteRaw = phase.on_complete;
+    if (onCompleteRaw) {
+        on_complete = {
+            commit: onCompleteRaw.commit,
+            push: onCompleteRaw.push,
+        };
+    }
+    return {
+        id: phase.id,
+        name: phase.name || phase.id,
+        type: phase.type,
+        build,
+        verify,
+        max_iterations: phase.max_iterations ?? 7,
+        on_complete,
+        gate: gateName,
+        checks: checks.length > 0 ? checks : undefined,
+        next,
+    };
+}
+// ============================================================================
+// Phase Queries
+// ============================================================================
+/**
+ * Get phase configuration by id
+ */
+export function getPhaseConfig(protocol, phaseId) {
+    return protocol.phases.find(p => p.id === phaseId) || null;
+}
+/**
+ * Get the next phase after the given phase
+ */
+export function getNextPhase(protocol, currentPhaseId) {
+    const current = getPhaseConfig(protocol, currentPhaseId);
+    if (!current || !current.next) {
+        return null;
+    }
+    return getPhaseConfig(protocol, current.next);
+}
+/**
+ * Get check definitions for a phase
+ */
+export function getPhaseChecks(protocol, phaseId) {
+    const phase = getPhaseConfig(protocol, phaseId);
+    if (!phase || !phase.checks) {
+        return {};
+    }
+    const result = {};
+    for (const checkName of phase.checks) {
+        if (protocol.checks?.[checkName]) {
+            result[checkName] = protocol.checks[checkName];
+        }
+    }
+    return result;
+}
+/**
+ * Get gate name for a phase (if any)
+ */
+export function getPhaseGate(protocol, phaseId) {
+    const phase = getPhaseConfig(protocol, phaseId);
+    return phase?.gate || null;
+}
+/**
+ * Check if a phase runs per plan phase
+ */
+export function isPhased(protocol, phaseId) {
+    const phase = getPhaseConfig(protocol, phaseId);
+    return phase?.type === 'per_plan_phase';
+}
+/**
+ * Get checks to run when a plan phase completes (after evaluate stage)
+ */
+export function getPhaseCompletionChecks(protocol) {
+    return protocol.phase_completion ?? {};
+}
+/**
+ * Check if a phase uses the build-verify cycle.
+ * A phase uses build-verify if it has both build and verify configs,
+ * regardless of whether type is 'build_verify' or 'per_plan_phase'.
+ */
+export function isBuildVerify(protocol, phaseId) {
+    const phase = getPhaseConfig(protocol, phaseId);
+    return !!(phase?.build && phase?.verify);
+}
+/**
+ * Get build config for a phase
+ */
+export function getBuildConfig(protocol, phaseId) {
+    const phase = getPhaseConfig(protocol, phaseId);
+    return phase?.build || null;
+}
+/**
+ * Get verify config for a phase
+ */
+export function getVerifyConfig(protocol, phaseId) {
+    const phase = getPhaseConfig(protocol, phaseId);
+    return phase?.verify || null;
+}
+/**
+ * Get max iterations for a build_verify phase
+ */
+export function getMaxIterations(protocol, phaseId) {
+    const phase = getPhaseConfig(protocol, phaseId);
+    return phase?.max_iterations ?? 7;
+}
+/**
+ * Get on_complete config for a phase
+ */
+export function getOnCompleteConfig(protocol, phaseId) {
+    const phase = getPhaseConfig(protocol, phaseId);
+    return phase?.on_complete || null;
+}
+//# sourceMappingURL=protocol.js.map

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

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

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

@@ -1,133 +1,62 @@
 /**
  * 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
- */
-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
+ * Create initial state for a new project.
+ *
+ * Always starts at the first protocol phase. If artifacts (spec, plan)
+ * already exist with approval metadata (YAML frontmatter), the run loop
+ * will detect this and skip those phases automatically.
  */
-export declare function updatePhaseStatus(state: ProjectState, phaseId: string, status: 'pending' | 'in_progress' | 'complete'): ProjectState;
+export declare function createInitialState(protocol: Protocol, projectId: string, title: string, _projectRoot?: string): ProjectState;
 /**
- * Set plan phases extracted from plan.md
+ * Find status.yaml by project ID (searches for NNNN-* directories)
  */
-export declare function setPlanPhases(state: ProjectState, phases: Array<{
-    id: string;
-    title: string;
-    description?: string;
-}>): ProjectState;
+export declare function findStatusPath(projectRoot: string, projectId: string): string | null;
 /**
- * Find all SPIDER projects
+ * Detect project ID from the current working directory if inside a builder worktree.
+ * Works from any subdirectory within the worktree.
+ * Returns the porch project ID (e.g. "bugfix-237" or "0073"), or null if not in a recognized worktree.
  */
-export declare function findProjects(projectRoot: string): Array<{
+export declare function detectProjectIdFromCwd(cwd: string): string | null;
+export type ResolvedProjectId = {
     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;
+    source: 'explicit' | 'cwd' | 'filesystem';
+};
 /**
- * Reset consultation attempts for a given state (e.g., after gate approval)
+ * Resolve project ID using the priority chain:
+ * 1. Explicit CLI argument (highest priority)
+ * 2. CWD worktree detection
+ * 3. Filesystem scan fallback
+ * 4. Error if none succeed
  */
-export declare function resetConsultationAttempts(state: ProjectState, stateKey: string): ProjectState;
+export declare function resolveProjectId(provided: string | undefined, cwd: string, projectRoot: string): ResolvedProjectId;
 /**
- * Find all status files with pending gates
+ * Auto-detect project ID when only one project exists.
+ * Returns null if zero or multiple projects found.
  */
-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;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,YAAY,CA2Bd;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBpF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,YAAY,CAAA;CAAE,CAAC;AAE1F;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAcnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0BlE"}