@cluesmith/codev 1.6.2 → 2.0.0-rc.1

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

@@ -0,0 +1,46 @@
+/**
+ * Protocol Loader
+ *
+ * Loads and validates protocol definitions from JSON files.
+ */
+import type { Protocol, Phase } from './types.js';
+/**
+ * Find protocol JSON file
+ */
+export declare function findProtocolFile(projectRoot: string, protocolName: string): string | null;
+/**
+ * Load protocol from JSON file
+ */
+export declare function loadProtocol(projectRoot: string, protocolName: string): Protocol | null;
+/**
+ * Get all available protocols
+ */
+export declare function listProtocols(projectRoot: string): string[];
+/**
+ * Get default protocol (spider)
+ */
+export declare function getDefaultProtocol(projectRoot: string): Protocol | null;
+/**
+ * Validate a protocol has required phases
+ */
+export declare function validateProtocol(protocol: Protocol): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get phase by ID
+ */
+export declare function getPhase(protocol: Protocol, phaseId: string): Phase | null;
+/**
+ * Get the next phase after a given phase
+ */
+export declare function getNextPhase(protocol: Protocol, currentPhaseId: string): Phase | null;
+/**
+ * Check if a phase is a terminal phase (no next phase)
+ */
+export declare function isTerminalPhase(protocol: Protocol, phaseId: string): boolean;
+/**
+ * Get phased phases (phases that run per plan phase)
+ */
+export declare function getPhasedPhases(protocol: Protocol): Phase[];
+//# sourceMappingURL=protocol-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-loader.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/protocol-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAyC,MAAM,YAAY,CAAC;AA6EzF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQzF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAevF;AAkID;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAmCzF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAMrF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAE,CAE3D"}

package/dist/commands/porch/protocol-loader.js

@@ -0,0 +1,249 @@
+/**
+ * Protocol Loader
+ *
+ * Loads and validates protocol definitions from JSON files.
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+/**
+ * Known protocol locations (relative to project root)
+ */
+const PROTOCOL_PATHS = [
+    'codev/protocols',
+    'codev-skeleton/protocols',
+];
+/**
+ * Find protocol JSON file
+ */
+export function findProtocolFile(projectRoot, protocolName) {
+    for (const basePath of PROTOCOL_PATHS) {
+        const fullPath = resolve(projectRoot, basePath, protocolName, 'protocol.json');
+        if (existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    return null;
+}
+/**
+ * Load protocol from JSON file
+ */
+export function loadProtocol(projectRoot, protocolName) {
+    const filePath = findProtocolFile(projectRoot, protocolName);
+    if (!filePath) {
+        return null;
+    }
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const json = JSON.parse(content);
+        return convertJsonToProtocol(json);
+    }
+    catch (error) {
+        console.error(`Failed to load protocol ${protocolName}: ${error}`);
+        return null;
+    }
+}
+/**
+ * Convert JSON representation to Protocol type
+ */
+function convertJsonToProtocol(json) {
+    const phases = [];
+    for (const phaseJson of json.phases) {
+        phases.push(convertPhase(phaseJson, json.defaults));
+    }
+    // Determine initial state - first phase with first substate or just phase id
+    const firstPhase = phases[0];
+    const initialState = firstPhase.substates && firstPhase.substates.length > 0
+        ? `${firstPhase.id}:${firstPhase.substates[0]}`
+        : firstPhase.id;
+    return {
+        name: json.name,
+        version: json.version,
+        description: json.description,
+        phases,
+        initial: initialState,
+    };
+}
+/**
+ * Convert phase JSON to Phase type
+ */
+function convertPhase(json, defaults) {
+    const phase = {
+        id: json.id,
+        name: json.name,
+        phased: json.type === 'per_plan_phase',
+    };
+    // Add substates from steps
+    if (json.steps && json.steps.length > 0) {
+        phase.substates = json.steps;
+    }
+    // Add checks
+    if (json.checks) {
+        phase.checks = {};
+        for (const [name, checkJson] of Object.entries(json.checks)) {
+            phase.checks[name] = convertCheck(checkJson);
+        }
+    }
+    // Add consultation
+    if (json.consultation) {
+        phase.consultation = convertConsultation(json.consultation, defaults?.consultation);
+    }
+    // Add gate - determine when gate triggers based on requires or last step
+    if (json.gate) {
+        // Gate triggers after the last required substate, or after the last step
+        const gateAfter = json.gate.requires?.length
+            ? json.gate.requires[json.gate.requires.length - 1]
+            : json.steps?.length
+                ? json.steps[json.steps.length - 1]
+                : null;
+        phase.gate = convertGate(json.gate, gateAfter);
+    }
+    // Build signals from transitions
+    if (json.transition) {
+        phase.signals = {};
+        if (json.transition.on_complete) {
+            phase.signals['PHASE_COMPLETE'] = json.transition.on_complete;
+        }
+        if (json.transition.on_fail) {
+            phase.signals['PHASE_FAILED'] = json.transition.on_fail;
+        }
+        if (json.transition.on_all_phases_complete) {
+            phase.signals['ALL_PHASES_COMPLETE'] = json.transition.on_all_phases_complete;
+        }
+    }
+    // Mark as terminal if gate has no next
+    if (json.gate && json.gate.next === null) {
+        phase.terminal = true;
+    }
+    return phase;
+}
+/**
+ * Convert check JSON to Check type
+ */
+function convertCheck(json) {
+    return {
+        command: json.command,
+        on_fail: json.on_fail || 'retry',
+        max_retries: json.max_retries ?? 3,
+        retry_delay: json.retry_delay ?? 5,
+    };
+}
+/**
+ * Convert consultation JSON to ConsultationConfig type
+ */
+function convertConsultation(json, defaults) {
+    return {
+        on: json.on || 'review',
+        models: json.models || defaults?.models || ['gemini', 'codex', 'claude'],
+        type: json.type || 'impl-review',
+        parallel: json.parallel ?? defaults?.parallel ?? true,
+        max_rounds: json.max_rounds ?? 3,
+        next: json.next || '',
+    };
+}
+/**
+ * Convert gate JSON to GateConfig type
+ * @param json - Gate configuration from protocol JSON
+ * @param gateAfter - Substate after which the gate triggers (from requires or last step)
+ */
+function convertGate(json, gateAfter) {
+    return {
+        after: gateAfter || json.name, // Use computed trigger point, fallback to gate name
+        type: 'human',
+        next: json.next || '',
+    };
+}
+/**
+ * Get all available protocols
+ */
+export function listProtocols(projectRoot) {
+    const protocols = [];
+    for (const basePath of PROTOCOL_PATHS) {
+        const fullPath = resolve(projectRoot, basePath);
+        if (existsSync(fullPath)) {
+            try {
+                const entries = readdirSync(fullPath, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isDirectory()) {
+                        const protocolFile = join(fullPath, entry.name, 'protocol.json');
+                        if (existsSync(protocolFile)) {
+                            protocols.push(entry.name);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+    }
+    return [...new Set(protocols)];
+}
+/**
+ * Get default protocol (spider)
+ */
+export function getDefaultProtocol(projectRoot) {
+    return loadProtocol(projectRoot, 'spider');
+}
+/**
+ * Validate a protocol has required phases
+ */
+export function validateProtocol(protocol) {
+    const errors = [];
+    if (!protocol.name) {
+        errors.push('Protocol name is required');
+    }
+    if (!protocol.phases || protocol.phases.length === 0) {
+        errors.push('Protocol must have at least one phase');
+    }
+    if (!protocol.initial) {
+        errors.push('Protocol must specify an initial state');
+    }
+    // Build phase ID lookup
+    const phaseIds = new Set(protocol.phases.map(p => p.id));
+    // Check phase signals reference valid phases
+    for (const phase of protocol.phases) {
+        if (phase.signals) {
+            for (const [signal, targetPhase] of Object.entries(phase.signals)) {
+                // Target might be "phaseId" or "phaseId:substate"
+                const targetPhaseId = targetPhase.split(':')[0];
+                if (!phaseIds.has(targetPhaseId)) {
+                    errors.push(`Phase '${phase.id}' signal '${signal}' references unknown phase '${targetPhaseId}'`);
+                }
+            }
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Get phase by ID
+ */
+export function getPhase(protocol, phaseId) {
+    return protocol.phases.find(p => p.id === phaseId) || null;
+}
+/**
+ * Get the next phase after a given phase
+ */
+export function getNextPhase(protocol, currentPhaseId) {
+    const currentIndex = protocol.phases.findIndex(p => p.id === currentPhaseId);
+    if (currentIndex === -1 || currentIndex >= protocol.phases.length - 1) {
+        return null;
+    }
+    return protocol.phases[currentIndex + 1];
+}
+/**
+ * Check if a phase is a terminal phase (no next phase)
+ */
+export function isTerminalPhase(protocol, phaseId) {
+    const phase = getPhase(protocol, phaseId);
+    return phase?.terminal ?? false;
+}
+/**
+ * Get phased phases (phases that run per plan phase)
+ */
+export function getPhasedPhases(protocol) {
+    return protocol.phases.filter(p => p.phased);
+}
+//# sourceMappingURL=protocol-loader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-loader.js","sourceRoot":"","sources":["../../../src/commands/porch/protocol-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG1C;;GAEG;AACH,MAAM,cAAc,GAAG;IACrB,iBAAiB;IACjB,0BAA0B;CAC3B,CAAC;AAqEF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,YAAoB;IACxE,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;QAC/E,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,YAAoB;IACpE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAE7D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;QACjD,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,YAAY,KAAK,KAAK,EAAE,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,IAAkB;IAC/C,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,6EAA6E;IAC7E,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAC1E,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;QAC/C,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;IAElB,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM;QACN,OAAO,EAAE,YAAY;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAe,EAAE,QAAmC;IACxE,MAAM,KAAK,GAAU;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,IAAI,KAAK,gBAAgB;KACvC,CAAC;IAEF,2BAA2B;IAC3B,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,aAAa;IACb,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,KAAK,CAAC,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IACtF,CAAC;IAED,yEAAyE;IACzE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,yEAAyE;QACzE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM;YAC1C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACnD,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;gBAClB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;gBACnC,CAAC,CAAC,IAAI,CAAC;QACX,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAChC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAChE,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAC5B,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAC1D,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC;YAC3C,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC;QAChF,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAe;IACnC,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;QAChC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;QAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,IAAsB,EACtB,QAAuE;IAEvE,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;QACxE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,aAAa;QAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ,EAAE,QAAQ,IAAI,IAAI;QACrD,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAc,EAAE,SAAwB;IAC3D,OAAO;QACL,KAAK,EAAE,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,oDAAoD;QACnF,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;wBACxB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;wBACjE,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;4BAC7B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC7B,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,OAAO,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACxD,CAAC;IAED,wBAAwB;IACxB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEzD,6CAA6C;IAC7C,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClE,kDAAkD;gBAClD,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;oBACjC,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,aAAa,MAAM,+BAA+B,aAAa,GAAG,CAAC,CAAC;gBACpG,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,OAAe;IAC1D,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,QAAkB,EAAE,cAAsB;IACrE,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,cAAc,CAAC,CAAC;IAC7E,IAAI,YAAY,KAAK,CAAC,CAAC,IAAI,YAAY,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB,EAAE,OAAe;IACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,KAAK,EAAE,QAAQ,IAAI,KAAK,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB;IAChD,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC"}

package/dist/commands/porch/signal-parser.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Signal Parser
+ *
+ * Extracts signals from Claude output and validates them against protocol definitions.
+ * Signals use XML-style tags: <signal>SIGNAL_NAME</signal>
+ */
+import type { Protocol } from './types.js';
+/**
+ * Signal extraction result
+ */
+export interface SignalResult {
+    signal: string | null;
+    allSignals: string[];
+    isValid: boolean;
+    error?: string;
+}
+/**
+ * Extract signal from Claude output
+ *
+ * Rules:
+ * - Scan for <signal>...</signal> patterns
+ * - Return the LAST signal found (multiple signals → last wins)
+ * - Return null if no signal found
+ */
+export declare function extractSignal(output: string): string | null;
+/**
+ * Extract all signals from output
+ */
+export declare function extractAllSignals(output: string): string[];
+/**
+ * Validate a signal against the protocol definition
+ *
+ * Returns true if the signal is valid for the current phase.
+ * Unknown signals are logged but considered valid (lenient mode).
+ */
+export declare function validateSignal(signal: string, protocol: Protocol, currentState: string): {
+    valid: boolean;
+    nextState?: string;
+    warning?: string;
+};
+/**
+ * Extract and validate signal from output
+ */
+export declare function parseSignal(output: string, protocol: Protocol, currentState: string): SignalResult;
+/**
+ * Get valid signals for a phase
+ */
+export declare function getValidSignals(protocol: Protocol, phaseId: string): string[];
+/**
+ * Common signals used across protocols
+ */
+export declare const CommonSignals: {
+    readonly SPEC_DRAFTED: "SPEC_DRAFTED";
+    readonly SPEC_READY: "SPEC_READY";
+    readonly REVISION_COMPLETE: "REVISION_COMPLETE";
+    readonly PLAN_DRAFTED: "PLAN_DRAFTED";
+    readonly PLAN_READY: "PLAN_READY";
+    readonly PHASE_IMPLEMENTED: "PHASE_IMPLEMENTED";
+    readonly IMPLEMENTATION_COMPLETE: "IMPLEMENTATION_COMPLETE";
+    readonly TESTS_WRITTEN: "TESTS_WRITTEN";
+    readonly TESTS_PASSING: "TESTS_PASSING";
+    readonly EVALUATION_COMPLETE: "EVALUATION_COMPLETE";
+    readonly PHASE_COMPLETE: "PHASE_COMPLETE";
+    readonly REVIEW_COMPLETE: "REVIEW_COMPLETE";
+    readonly UNDERSTOOD: "UNDERSTOOD";
+    readonly IMPLEMENTED: "IMPLEMENTED";
+    readonly VERIFIED: "VERIFIED";
+    readonly DIAGNOSED: "DIAGNOSED";
+    readonly FIXED: "FIXED";
+    readonly TESTED: "TESTED";
+    readonly PR_CREATED: "PR_CREATED";
+    readonly COMPLETE: "COMPLETE";
+    readonly BLOCKED: "BLOCKED";
+    readonly NEEDS_CLARIFICATION: "NEEDS_CLARIFICATION";
+};
+/**
+ * Format a signal for output
+ */
+export declare function formatSignal(signal: string): string;
+/**
+ * Check if output contains any signal
+ */
+export declare function hasSignal(output: string): boolean;
+/**
+ * Strip all signals from output (for clean display)
+ */
+export declare function stripSignals(output: string): string;
+//# sourceMappingURL=signal-parser.d.ts.map

package/dist/commands/porch/signal-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-parser.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/signal-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAS,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,GACnB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAwB1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,MAAM,GACnB,YAAY,CAoBd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAI7E;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;CAwChB,CAAC;AAEX;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/commands/porch/signal-parser.js

@@ -0,0 +1,148 @@
+/**
+ * Signal Parser
+ *
+ * Extracts signals from Claude output and validates them against protocol definitions.
+ * Signals use XML-style tags: <signal>SIGNAL_NAME</signal>
+ */
+/**
+ * Extract signal from Claude output
+ *
+ * Rules:
+ * - Scan for <signal>...</signal> patterns
+ * - Return the LAST signal found (multiple signals → last wins)
+ * - Return null if no signal found
+ */
+export function extractSignal(output) {
+    const matches = output.match(/<signal>([^<]+)<\/signal>/gi);
+    if (!matches || matches.length === 0)
+        return null;
+    // Get the last match
+    const lastMatch = matches[matches.length - 1];
+    const signalMatch = lastMatch.match(/<signal>([^<]+)<\/signal>/i);
+    return signalMatch ? signalMatch[1].trim() : null;
+}
+/**
+ * Extract all signals from output
+ */
+export function extractAllSignals(output) {
+    const matches = output.match(/<signal>([^<]+)<\/signal>/gi);
+    if (!matches)
+        return [];
+    return matches.map(match => {
+        const signalMatch = match.match(/<signal>([^<]+)<\/signal>/i);
+        return signalMatch ? signalMatch[1].trim() : '';
+    }).filter(Boolean);
+}
+/**
+ * Validate a signal against the protocol definition
+ *
+ * Returns true if the signal is valid for the current phase.
+ * Unknown signals are logged but considered valid (lenient mode).
+ */
+export function validateSignal(signal, protocol, currentState) {
+    const [phaseId, substate] = currentState.split(':');
+    const phase = protocol.phases.find(p => p.id === phaseId);
+    if (!phase) {
+        return {
+            valid: false,
+            warning: `Unknown phase: ${phaseId}`,
+        };
+    }
+    // Check if signal is defined for this phase
+    if (phase.signals && phase.signals[signal]) {
+        return {
+            valid: true,
+            nextState: phase.signals[signal],
+        };
+    }
+    // Signal not defined - lenient mode: allow but warn
+    return {
+        valid: true, // Allow unknown signals to prevent blocking
+        warning: `Signal "${signal}" not defined in protocol for phase ${phaseId}`,
+    };
+}
+/**
+ * Extract and validate signal from output
+ */
+export function parseSignal(output, protocol, currentState) {
+    const signal = extractSignal(output);
+    const allSignals = extractAllSignals(output);
+    if (!signal) {
+        return {
+            signal: null,
+            allSignals: [],
+            isValid: true, // No signal is valid (use default transition)
+        };
+    }
+    const validation = validateSignal(signal, protocol, currentState);
+    return {
+        signal,
+        allSignals,
+        isValid: validation.valid,
+        error: validation.warning,
+    };
+}
+/**
+ * Get valid signals for a phase
+ */
+export function getValidSignals(protocol, phaseId) {
+    const phase = protocol.phases.find(p => p.id === phaseId);
+    if (!phase?.signals)
+        return [];
+    return Object.keys(phase.signals);
+}
+/**
+ * Common signals used across protocols
+ */
+export const CommonSignals = {
+    // Specify phase
+    SPEC_DRAFTED: 'SPEC_DRAFTED',
+    SPEC_READY: 'SPEC_READY',
+    REVISION_COMPLETE: 'REVISION_COMPLETE',
+    // Plan phase
+    PLAN_DRAFTED: 'PLAN_DRAFTED',
+    PLAN_READY: 'PLAN_READY',
+    // Implement phase
+    PHASE_IMPLEMENTED: 'PHASE_IMPLEMENTED',
+    IMPLEMENTATION_COMPLETE: 'IMPLEMENTATION_COMPLETE',
+    // Defend phase
+    TESTS_WRITTEN: 'TESTS_WRITTEN',
+    TESTS_PASSING: 'TESTS_PASSING',
+    // Evaluate phase
+    EVALUATION_COMPLETE: 'EVALUATION_COMPLETE',
+    PHASE_COMPLETE: 'PHASE_COMPLETE',
+    // Review phase
+    REVIEW_COMPLETE: 'REVIEW_COMPLETE',
+    // TICK protocol
+    UNDERSTOOD: 'UNDERSTOOD',
+    IMPLEMENTED: 'IMPLEMENTED',
+    VERIFIED: 'VERIFIED',
+    // BUGFIX protocol
+    DIAGNOSED: 'DIAGNOSED',
+    FIXED: 'FIXED',
+    TESTED: 'TESTED',
+    PR_CREATED: 'PR_CREATED',
+    // General
+    COMPLETE: 'COMPLETE',
+    BLOCKED: 'BLOCKED',
+    NEEDS_CLARIFICATION: 'NEEDS_CLARIFICATION',
+};
+/**
+ * Format a signal for output
+ */
+export function formatSignal(signal) {
+    return `<signal>${signal}</signal>`;
+}
+/**
+ * Check if output contains any signal
+ */
+export function hasSignal(output) {
+    return /<signal>[^<]+<\/signal>/i.test(output);
+}
+/**
+ * Strip all signals from output (for clean display)
+ */
+export function stripSignals(output) {
+    return output.replace(/<signal>[^<]+<\/signal>/gi, '').trim();
+}
+//# sourceMappingURL=signal-parser.js.map

package/dist/commands/porch/signal-parser.js.map

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