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

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

@@ -0,0 +1,70 @@
+/**
+ * Porch Plan Parsing
+ *
+ * Extracts implementation phases from plan.md files.
+ * Looks for `### Phase N: <title>` headers or JSON phases block.
+ *
+ * Plan phases are simple: pending → in_progress → complete.
+ * All checks (implement, defend, evaluate) run together at the end.
+ */
+import type { PlanPhase } from './types.js';
+/**
+ * Find the plan file for a project
+ * Searches both legacy (codev/plans/NNNN-name.md) and new (codev/projects/NNNN-name/plan.md) locations
+ */
+export declare function findPlanFile(projectRoot: string, projectId: string, projectName?: string): string | null;
+/**
+ * Extract phases from plan markdown content
+ * Returns phases with status 'pending'
+ *
+ * Supports two formats:
+ *
+ * 1. JSON code block:
+ * ```json
+ * {"phases": [{"id": "phase_1", "title": "..."}, ...]}
+ * ```
+ *
+ * 2. Markdown headers (fallback):
+ * ## Phase 1: Core Types
+ * ## Phase 2: State Management
+ *
+ * Also matches "---" separated sections with "## Phase N:" headers.
+ */
+export declare function extractPlanPhases(planContent: string): PlanPhase[];
+/**
+ * Extract phases from a plan file
+ * Fails loudly if file doesn't exist
+ */
+export declare function extractPhasesFromFile(planFilePath: string): PlanPhase[];
+/**
+ * Check if a plan phase is complete
+ */
+export declare function isPlanPhaseComplete(phase: PlanPhase): boolean;
+/**
+ * Get the current plan phase (first non-complete phase)
+ */
+export declare function getCurrentPlanPhase(phases: PlanPhase[]): PlanPhase | null;
+/**
+ * Get the next plan phase after a given phase
+ */
+export declare function getNextPlanPhase(phases: PlanPhase[], currentPhaseId: string): PlanPhase | null;
+/**
+ * Check if all plan phases are complete
+ */
+export declare function allPlanPhasesComplete(phases: PlanPhase[]): boolean;
+/**
+ * Advance to the next plan phase
+ * Marks current phase complete and next phase in_progress
+ * Returns updated phases array and whether to move to review
+ */
+export declare function advancePlanPhase(phases: PlanPhase[], currentPhaseId: string): {
+    phases: PlanPhase[];
+    moveToReview: boolean;
+};
+/**
+ * Get phase content from plan (the text under the phase header)
+ * Matches both ## and ### phase headers, and terminates at the next
+ * phase header of same or higher level, or a "---" separator.
+ */
+export declare function getPhaseContent(planContent: string, phaseId: string): string | null;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBxG;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CA6ClE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,CAOvE;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,GAAG,IAAI,CAOzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAM9F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,cAAc,EAAE,MAAM,GACrB;IAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAoBhD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAenF"}

package/dist/commands/porch/plan.js

@@ -0,0 +1,190 @@
+/**
+ * Porch Plan Parsing
+ *
+ * Extracts implementation phases from plan.md files.
+ * Looks for `### Phase N: <title>` headers or JSON phases block.
+ *
+ * Plan phases are simple: pending → in_progress → complete.
+ * All checks (implement, defend, evaluate) run together at the end.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ============================================================================
+// Plan File Discovery
+// ============================================================================
+/**
+ * Find the plan file for a project
+ * Searches both legacy (codev/plans/NNNN-name.md) and new (codev/projects/NNNN-name/plan.md) locations
+ */
+export function findPlanFile(projectRoot, projectId, projectName) {
+    const searchPaths = [];
+    // New structure: codev/projects/<id>-<name>/plan.md
+    if (projectName) {
+        searchPaths.push(path.join(projectRoot, 'codev/projects', `${projectId}-${projectName}`, 'plan.md'));
+    }
+    // Legacy structure: codev/plans/<id>-*.md
+    const plansDir = path.join(projectRoot, 'codev/plans');
+    if (fs.existsSync(plansDir)) {
+        const files = fs.readdirSync(plansDir);
+        const match = files.find(f => f.startsWith(`${projectId}-`) && f.endsWith('.md'));
+        if (match) {
+            searchPaths.push(path.join(plansDir, match));
+        }
+    }
+    for (const planPath of searchPaths) {
+        if (fs.existsSync(planPath)) {
+            return planPath;
+        }
+    }
+    return null;
+}
+// ============================================================================
+// Phase Extraction
+// ============================================================================
+/**
+ * Extract phases from plan markdown content
+ * Returns phases with status 'pending'
+ *
+ * Supports two formats:
+ *
+ * 1. JSON code block:
+ * ```json
+ * {"phases": [{"id": "phase_1", "title": "..."}, ...]}
+ * ```
+ *
+ * 2. Markdown headers (fallback):
+ * ## Phase 1: Core Types
+ * ## Phase 2: State Management
+ *
+ * Also matches "---" separated sections with "## Phase N:" headers.
+ */
+export function extractPlanPhases(planContent) {
+    // First, try JSON code block with phases
+    const jsonMatch = planContent.match(/```json\s*\n([\s\S]*?)\n```/);
+    if (jsonMatch) {
+        try {
+            const parsed = JSON.parse(jsonMatch[1]);
+            if (parsed.phases && Array.isArray(parsed.phases)) {
+                return parsed.phases.map((p, index) => ({
+                    id: p.id,
+                    title: p.title,
+                    status: index === 0 ? 'in_progress' : 'pending',
+                }));
+            }
+        }
+        catch (e) {
+            // JSON parse failed, fall through to markdown parsing
+            console.warn('Failed to parse phases JSON from plan:', e);
+        }
+    }
+    // Second, try markdown headers: "## Phase N: Title" or "### Phase N: Title"
+    const phaseHeaderRegex = /^#{2,3}\s+Phase\s+(\d+):\s*(.+)$/gm;
+    const phases = [];
+    let match;
+    while ((match = phaseHeaderRegex.exec(planContent)) !== null) {
+        const phaseNum = match[1];
+        const title = match[2].trim();
+        phases.push({
+            id: `phase_${phaseNum}`,
+            title,
+            status: phases.length === 0 ? 'in_progress' : 'pending',
+        });
+    }
+    if (phases.length > 0) {
+        return phases;
+    }
+    // No phases found - return single default phase
+    return [{
+            id: 'phase_1',
+            title: 'Implementation',
+            status: 'in_progress',
+        }];
+}
+/**
+ * Extract phases from a plan file
+ * Fails loudly if file doesn't exist
+ */
+export function extractPhasesFromFile(planFilePath) {
+    if (!fs.existsSync(planFilePath)) {
+        throw new Error(`Plan file not found: ${planFilePath}`);
+    }
+    const content = fs.readFileSync(planFilePath, 'utf-8');
+    return extractPlanPhases(content);
+}
+// ============================================================================
+// Phase Navigation
+// ============================================================================
+/**
+ * Check if a plan phase is complete
+ */
+export function isPlanPhaseComplete(phase) {
+    return phase.status === 'complete';
+}
+/**
+ * Get the current plan phase (first non-complete phase)
+ */
+export function getCurrentPlanPhase(phases) {
+    for (const phase of phases) {
+        if (phase.status !== 'complete') {
+            return phase;
+        }
+    }
+    return null; // All phases complete
+}
+/**
+ * Get the next plan phase after a given phase
+ */
+export function getNextPlanPhase(phases, currentPhaseId) {
+    const currentIndex = phases.findIndex(p => p.id === currentPhaseId);
+    if (currentIndex >= 0 && currentIndex < phases.length - 1) {
+        return phases[currentIndex + 1];
+    }
+    return null;
+}
+/**
+ * Check if all plan phases are complete
+ */
+export function allPlanPhasesComplete(phases) {
+    return phases.every(isPlanPhaseComplete);
+}
+/**
+ * Advance to the next plan phase
+ * Marks current phase complete and next phase in_progress
+ * Returns updated phases array and whether to move to review
+ */
+export function advancePlanPhase(phases, currentPhaseId) {
+    const phaseIndex = phases.findIndex(p => p.id === currentPhaseId);
+    if (phaseIndex < 0) {
+        return { phases, moveToReview: false };
+    }
+    const updatedPhases = phases.map((p, i) => {
+        if (i === phaseIndex) {
+            return { ...p, status: 'complete' };
+        }
+        if (i === phaseIndex + 1) {
+            return { ...p, status: 'in_progress' };
+        }
+        return p;
+    });
+    // Check if all phases are now complete
+    const moveToReview = updatedPhases.every(p => p.status === 'complete');
+    return { phases: updatedPhases, moveToReview };
+}
+/**
+ * Get phase content from plan (the text under the phase header)
+ * Matches both ## and ### phase headers, and terminates at the next
+ * phase header of same or higher level, or a "---" separator.
+ */
+export function getPhaseContent(planContent, phaseId) {
+    // Extract phase number from id
+    const numMatch = phaseId.match(/phase_(\d+)/);
+    if (!numMatch)
+        return null;
+    const phaseNum = numMatch[1];
+    // Match ## or ### Phase N: Title
+    // Content ends at: next phase header (## or ### Phase), a --- separator, or end of file
+    const regex = new RegExp(`#{2,3}\\s*Phase\\s+${phaseNum}:\\s*[^\\n]+\\n([\\s\\S]*?)(?=\\n#{2,3}\\s*Phase\\s+\\d|\\n---\\s*\\n|$)`, 'i');
+    const match = planContent.match(regex);
+    return match ? match[1].trim() : null;
+}
+//# sourceMappingURL=plan.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Phase prompts for Porch
+ *
+ * Loads phase-specific prompts from the protocol's prompts/ directory.
+ * Prompts are markdown files with {{variable}} placeholders.
+ *
+ * For build-verify cycles, when iteration > 1, previous build outputs
+ * and review files are listed so Claude can read them for context.
+ */
+import type { ProjectState, Protocol } from './types.js';
+/**
+ * Build a prompt for the current phase.
+ * Loads from protocol's prompts/ directory if available, otherwise uses fallback.
+ *
+ * For build-verify phases with iteration > 1, lists previous build outputs
+ * and review files so Claude can read them for context.
+ */
+export declare function buildPhasePrompt(projectRoot: string, state: ProjectState, protocol: Protocol): string;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAA6C,MAAM,YAAY,CAAC;AA4KpG;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,QAAQ,GACjB,MAAM,CA+ER"}

package/dist/commands/porch/prompts.js

@@ -0,0 +1,277 @@
+/**
+ * Phase prompts for Porch
+ *
+ * Loads phase-specific prompts from the protocol's prompts/ directory.
+ * Prompts are markdown files with {{variable}} placeholders.
+ *
+ * For build-verify cycles, when iteration > 1, previous build outputs
+ * and review files are listed so Claude can read them for context.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getPhaseConfig, isPhased, isBuildVerify, getBuildConfig } from './protocol.js';
+import { findPlanFile, getCurrentPlanPhase, getPhaseContent } from './plan.js';
+import { getProjectDir } from './state.js';
+/** Locations to search for protocol prompts */
+const PROTOCOL_PATHS = [
+    'codev/protocols',
+    'codev-skeleton/protocols',
+    'skeleton/protocols', // Used in packages/codev
+];
+/**
+ * Get project summary from projectlist.md.
+ * Returns the summary field for the given project ID.
+ */
+function getProjectSummary(projectRoot, projectId) {
+    const projectlistPath = path.join(projectRoot, 'codev', 'projectlist.md');
+    if (!fs.existsSync(projectlistPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(projectlistPath, 'utf-8');
+        // Look for the project entry by ID
+        // Format: - id: "0076" followed by summary: "..."
+        const idPattern = new RegExp(`- id: ["']?${projectId}["']?`, 'i');
+        const idMatch = content.match(idPattern);
+        if (!idMatch) {
+            return null;
+        }
+        // Find the summary after this ID (within the next ~500 chars)
+        const afterId = content.slice(idMatch.index, idMatch.index + 500);
+        const summaryMatch = afterId.match(/summary:\s*["'](.+?)["']/);
+        if (summaryMatch) {
+            return summaryMatch[1];
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find the prompts directory for a protocol.
+ */
+function findPromptsDir(projectRoot, protocolName) {
+    for (const basePath of PROTOCOL_PATHS) {
+        const promptsDir = path.join(projectRoot, basePath, protocolName, 'prompts');
+        if (fs.existsSync(promptsDir)) {
+            return promptsDir;
+        }
+    }
+    return null;
+}
+/**
+ * Load a prompt file from the protocol's prompts directory.
+ */
+function loadPromptFile(promptsDir, promptFile) {
+    const promptPath = path.join(promptsDir, promptFile);
+    if (fs.existsSync(promptPath)) {
+        return fs.readFileSync(promptPath, 'utf-8');
+    }
+    return null;
+}
+/**
+ * Substitute template variables in a prompt.
+ */
+function substituteVariables(prompt, state, planPhase, summary) {
+    const variables = {
+        project_id: state.id,
+        title: state.title,
+        current_state: state.phase,
+        protocol: state.protocol,
+    };
+    // Add summary/goal if available
+    if (summary) {
+        variables.summary = summary;
+        variables.goal = summary; // Alias for convenience
+    }
+    if (planPhase) {
+        variables.plan_phase_id = planPhase.id;
+        variables.plan_phase_title = planPhase.title;
+    }
+    // Replace {{variable}} with values
+    return prompt.replace(/\{\{(\w+)\}\}/g, (match, varName) => {
+        return variables[varName] || match;
+    });
+}
+/**
+ * Build a header listing all previous iteration files.
+ * Claude can read these files to understand the history and feedback.
+ */
+function buildHistoryHeader(history, currentIteration, state, projectRoot) {
+    const lines = [
+        '# REVISION REQUIRED',
+        '',
+        `This is iteration ${currentIteration}. Previous iterations received feedback from reviewers.`,
+        '',
+        '**Read the files below to understand the history and address the feedback.**',
+        '',
+        '## Previous Iterations',
+        '',
+    ];
+    for (const record of history) {
+        lines.push(`### Iteration ${record.iteration}`);
+        lines.push('');
+        if (record.build_output) {
+            lines.push(`**Build Output:** \`${record.build_output}\``);
+        }
+        if (record.reviews.length > 0) {
+            lines.push('');
+            lines.push('**Reviews:**');
+            for (const review of record.reviews) {
+                const icon = review.verdict === 'APPROVE' ? '✓' :
+                    review.verdict === 'COMMENT' ? '💬' : '✗';
+                lines.push(`- ${review.model} (${icon} ${review.verdict}): \`${review.file}\``);
+            }
+        }
+        lines.push('');
+    }
+    lines.push('## Instructions');
+    lines.push('');
+    lines.push('1. Read the review files above to understand the feedback');
+    lines.push('2. Address any legitimate REQUEST_CHANGES issues');
+    lines.push('3. Consider suggestions from COMMENT and APPROVE reviews');
+    lines.push('4. **If a reviewer concern is a false positive**, write a rebuttal (see below)');
+    lines.push('');
+    // Add rebuttal instructions
+    const projectDir = getProjectDir(projectRoot, state.id, state.title);
+    const phase = state.current_plan_phase || state.phase;
+    const rebuttalFileName = `${state.id}-${phase}-iter${currentIteration - 1}-rebuttals.md`;
+    const rebuttalPath = path.join(projectDir, rebuttalFileName);
+    lines.push('## Rebuttals (Dispute False Positives)');
+    lines.push('');
+    lines.push('If you believe a reviewer concern is a false positive (e.g., based on outdated framework knowledge),');
+    lines.push(`write your rebuttal to: \`${rebuttalPath}\``);
+    lines.push('');
+    lines.push('Format each disputed concern as a section:');
+    lines.push('```');
+    lines.push('## Disputed: [Brief description of the concern]');
+    lines.push('');
+    lines.push('[Your explanation of why this is a false positive, with evidence]');
+    lines.push('```');
+    lines.push('');
+    lines.push('Rebuttals are passed as context to reviewers in the next iteration.');
+    lines.push('Only dispute genuinely incorrect feedback — still fix legitimate issues.');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Build a prompt for the current phase.
+ * Loads from protocol's prompts/ directory if available, otherwise uses fallback.
+ *
+ * For build-verify phases with iteration > 1, lists previous build outputs
+ * and review files so Claude can read them for context.
+ */
+export function buildPhasePrompt(projectRoot, state, protocol) {
+    const phaseConfig = getPhaseConfig(protocol, state.phase);
+    if (!phaseConfig) {
+        return buildFallbackPrompt(state, 'unknown');
+    }
+    // Get project summary from projectlist.md
+    const summary = getProjectSummary(projectRoot, state.id);
+    // Get current plan phase for phased protocols
+    let currentPlanPhase = null;
+    if (isPhased(protocol, state.phase) && state.plan_phases.length > 0) {
+        currentPlanPhase = getCurrentPlanPhase(state.plan_phases);
+    }
+    // Build history header if this is a retry iteration
+    // Filter history by current plan phase to avoid mixing context from other phases
+    let historyHeader = '';
+    if (isBuildVerify(protocol, state.phase) && state.iteration > 1 && state.history.length > 0) {
+        const currentPhase = state.current_plan_phase || undefined;
+        const phaseHistory = state.history.filter(h => (h.plan_phase || undefined) === currentPhase);
+        if (phaseHistory.length > 0) {
+            historyHeader = buildHistoryHeader(phaseHistory, state.iteration, state, projectRoot);
+        }
+    }
+    // Build user answers section if they asked clarifying questions
+    let userAnswersSection = '';
+    if (state.context?.user_answers) {
+        userAnswersSection = `# User Answers to Your Questions\n\n${state.context.user_answers}\n\n---\n\n`;
+    }
+    // Try to load prompt from protocol directory
+    const promptsDir = findPromptsDir(projectRoot, state.protocol);
+    if (promptsDir) {
+        // Get prompt filename from protocol's build config, fallback to phase.md
+        const buildConfig = getBuildConfig(protocol, state.phase);
+        const promptFileName = buildConfig?.prompt || `${state.phase}.md`;
+        const promptContent = loadPromptFile(promptsDir, promptFileName);
+        if (promptContent) {
+            let result = substituteVariables(promptContent, state, currentPlanPhase, summary);
+            // Add goal/summary header if available
+            if (summary) {
+                result = `## Goal\n\n${summary}\n\n---\n\n` + result;
+            }
+            // Add user answers if Claude asked clarifying questions
+            if (userAnswersSection) {
+                result = userAnswersSection + result;
+            }
+            // Add plan phase context if applicable
+            if (currentPlanPhase) {
+                result = addPlanPhaseContext(projectRoot, state, currentPlanPhase, result);
+            }
+            // Prepend history if this is a retry
+            if (historyHeader) {
+                result = historyHeader + '\n\n---\n\n' + result;
+            }
+            return result;
+        }
+    }
+    // Fallback to generic prompt if no protocol prompt found
+    let fallback = buildFallbackPrompt(state, phaseConfig.name, currentPlanPhase, summary);
+    // Prepend history if this is a retry
+    if (historyHeader) {
+        fallback = historyHeader + '\n\n---\n\n' + fallback;
+    }
+    return fallback;
+}
+/**
+ * Add plan phase context from the plan file.
+ */
+function addPlanPhaseContext(projectRoot, state, planPhase, prompt) {
+    const planPath = findPlanFile(projectRoot, state.id, state.title);
+    if (!planPath) {
+        return prompt;
+    }
+    try {
+        const planContent = fs.readFileSync(planPath, 'utf-8');
+        const phaseContent = getPhaseContent(planContent, planPhase.id);
+        if (phaseContent) {
+            return prompt + `\n\n## Current Plan Phase Details\n\n**${planPhase.id}: ${planPhase.title}**\n\n${phaseContent}\n`;
+        }
+    }
+    catch {
+        // Ignore errors reading plan
+    }
+    return prompt;
+}
+/**
+ * Build a fallback prompt when no protocol prompt is found.
+ */
+function buildFallbackPrompt(state, phaseName, planPhase, summary) {
+    let prompt = `# Phase: ${phaseName}
+
+You are executing the ${phaseName} phase of the ${state.protocol.toUpperCase()} protocol.
+
+## Context
+
+- **Project ID**: ${state.id}
+- **Project Title**: ${state.title}
+- **Protocol**: ${state.protocol}
+`;
+    if (planPhase) {
+        prompt += `- **Plan Phase**: ${planPhase.id} - ${planPhase.title}\n`;
+    }
+    // Add goal from projectlist.md summary
+    if (summary) {
+        prompt += `\n## Goal\n\n${summary}\n`;
+    }
+    prompt += `
+## Task
+
+Complete the work for this phase according to the protocol.
+
+`;
+    return prompt;
+}
+//# sourceMappingURL=prompts.js.map

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

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

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

@@ -0,0 +1,59 @@
+/**
+ * Porch Protocol Loading
+ *
+ * Loads protocol definitions from JSON files.
+ * Fails loudly if protocol not found or invalid.
+ */
+import type { Protocol, ProtocolPhase, BuildConfig, VerifyConfig, OnCompleteConfig, CheckDef } from './types.js';
+/**
+ * Find and load a protocol by name
+ * Fails loudly if not found or invalid.
+ */
+export declare function loadProtocol(projectRoot: string, protocolName: string): Protocol;
+/**
+ * Get phase configuration by id
+ */
+export declare function getPhaseConfig(protocol: Protocol, phaseId: string): ProtocolPhase | null;
+/**
+ * Get the next phase after the given phase
+ */
+export declare function getNextPhase(protocol: Protocol, currentPhaseId: string): ProtocolPhase | null;
+/**
+ * Get check definitions for a phase
+ */
+export declare function getPhaseChecks(protocol: Protocol, phaseId: string): Record<string, CheckDef>;
+/**
+ * Get gate name for a phase (if any)
+ */
+export declare function getPhaseGate(protocol: Protocol, phaseId: string): string | null;
+/**
+ * Check if a phase runs per plan phase
+ */
+export declare function isPhased(protocol: Protocol, phaseId: string): boolean;
+/**
+ * Get checks to run when a plan phase completes (after evaluate stage)
+ */
+export declare function getPhaseCompletionChecks(protocol: Protocol): Record<string, string>;
+/**
+ * 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 declare function isBuildVerify(protocol: Protocol, phaseId: string): boolean;
+/**
+ * Get build config for a phase
+ */
+export declare function getBuildConfig(protocol: Protocol, phaseId: string): BuildConfig | null;
+/**
+ * Get verify config for a phase
+ */
+export declare function getVerifyConfig(protocol: Protocol, phaseId: string): VerifyConfig | null;
+/**
+ * Get max iterations for a build_verify phase
+ */
+export declare function getMaxIterations(protocol: Protocol, phaseId: string): number;
+/**
+ * Get on_complete config for a phase
+ */
+export declare function getOnCompleteConfig(protocol: Protocol, phaseId: string): OnCompleteConfig | null;
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAYjH;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,QAAQ,CAoBhF;AAuLD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAExF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAM7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAa5F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG/E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGtF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAGxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAGhG"}