@telora/daemon 0.12.33

package/dist/completion-handler.js

@@ -0,0 +1,200 @@
+/**
+ * Completion handler - processes agent exit events.
+ *
+ * Handles the post-completion lifecycle for the legacy per-delivery model:
+ * - Querying open issues and session counts
+ * - Workflow-driven transition determination
+ * - Guard evaluation at stage transitions
+ * - Merge operations (integration branch, CI/CD)
+ * - Delivery status updates and session finalization
+ * - Worktree cleanup and re-poll triggering
+ *
+ * For the strategy team model, see delivery-lifecycle.ts which provides
+ * reusable functions (evaluateGuardsForDeliveryTransition, mergeDeliveryBranch,
+ * advanceDeliveryStage) that the team lead calls directly.
+ */
+import { updateSession, updateDeliveryStatus, getDeliveryIssues, getDeliverySessionCount, reportGitState } from './supabase.js';
+import { removeWorktree } from './git.js';
+import { getStageByName, determineTransition } from './workflow-engine.js';
+import { evaluateGuardsForDeliveryTransition, mergeDeliveryBranch } from './delivery-lifecycle.js';
+import { recordSessionCompleted, recordActivity } from './heartbeat.js';
+import { triggerCheck } from './listener.js';
+const MAX_RETRY_ATTEMPTS = 5;
+/**
+ * Handle agent process exit.
+ *
+ * This is the main post-completion handler that runs when a Claude Code agent
+ * process exits. It determines the workflow transition, evaluates guards,
+ * performs merge operations, and updates delivery/session status.
+ */
+export async function handleAgentCompletion(code, signal, params) {
+    const { config, context, runningAgent, workflow, branchName, currentStageId, timedOut, timeoutMs, sessionId, deliveryId, completionDetector, stdoutLogStream, stderrStream, jsonlStream, runningAgents, } = params;
+    console.log(`Agent for "${context.delivery.name}" exited with code ${code}, signal ${signal}`);
+    recordActivity();
+    // Clear timeout timers
+    if (runningAgent.warningTimer)
+        clearTimeout(runningAgent.warningTimer);
+    if (runningAgent.timeoutTimer)
+        clearTimeout(runningAgent.timeoutTimer);
+    // Clean up completion detector
+    completionDetector?.destroy();
+    runningAgents.delete(sessionId);
+    // Close log streams
+    stdoutLogStream.end();
+    stderrStream.end();
+    jsonlStream.end();
+    // Report worktree_complete now that the agent has finished (success or failure)
+    reportGitState(deliveryId, 'worktree_complete').catch(err => console.warn(`[reportGitState] worktree_complete failed:`, err.message));
+    // Query issues and session count for transition decision
+    let openIssueCount = 0;
+    let attemptCount = 0;
+    if (code === 0) {
+        try {
+            const [issues, count] = await Promise.all([
+                getDeliveryIssues(deliveryId),
+                getDeliverySessionCount(deliveryId),
+            ]);
+            openIssueCount = issues.filter(i => i.status !== 'Done').length;
+            attemptCount = count;
+        }
+        catch (err) {
+            console.warn(`Failed to query issues/sessions for "${context.delivery.name}":`, err.message);
+            // Fall through with 0 open issues (treat as all done) to avoid blocking on API errors
+        }
+    }
+    else {
+        try {
+            attemptCount = await getDeliverySessionCount(deliveryId);
+        }
+        catch (err) {
+            console.warn(`Failed to query session count for "${context.delivery.name}":`, err.message);
+        }
+    }
+    // Build failure reason for non-zero exits
+    const failureReason = code !== 0
+        ? (timedOut
+            ? `Timeout exceeded (${timeoutMs / 60000} min limit)`
+            : signal
+                ? `Terminated by signal: ${signal}`
+                : `Exit code: ${code}`)
+        : undefined;
+    // Determine transition via workflow engine
+    const transition = currentStageId
+        ? determineTransition({
+            workflow,
+            currentStageId,
+            exitCode: code ?? 1,
+            openIssueCount,
+            attemptCount,
+            maxRetries: MAX_RETRY_ATTEMPTS,
+            failureReason,
+        })
+        : {
+            // No workflow stage -- legacy fallback
+            nextStage: null,
+            workflowTransition: null,
+            shouldMerge: code === 0 && openIssueCount === 0,
+            shouldTriggerRepoll: code === 0 && openIssueCount === 0,
+            sessionStatus: (code === 0 && openIssueCount === 0 ? 'completed' : 'failed'),
+            exitReason: failureReason ?? (openIssueCount === 0 ? 'Completed.' : `${openIssueCount} open issues.`),
+        };
+    let { exitReason } = transition;
+    let { shouldMerge, shouldTriggerRepoll, sessionStatus } = transition;
+    // -- Guard evaluation at stage transitions --
+    const evalResult = await evaluateGuardsForDeliveryTransition({
+        deliveryId,
+        organizationId: context.delivery.organization_id,
+        workflowTransition: transition.workflowTransition ?? null,
+        exitCode: code ?? 1,
+        policyFailureMode: config.policyFailureMode,
+        deliveryName: context.delivery.name,
+        sessionId,
+    });
+    const evalBlocked = evalResult.blocked;
+    if (evalBlocked) {
+        shouldMerge = evalResult.shouldMerge;
+        shouldTriggerRepoll = evalResult.shouldTriggerRepoll;
+        sessionStatus = evalResult.sessionStatus;
+        exitReason = evalResult.exitReason;
+    }
+    else if (evalResult.exitReason && evalResult.exitReason !== exitReason) {
+        exitReason += ` ${evalResult.exitReason}`;
+    }
+    // Determine delivery status from transition
+    let deliveryStatus;
+    let deliveryStageId;
+    if (evalBlocked) {
+        // Guard already set delivery to 'paused' -- don't overwrite
+        deliveryStatus = 'paused';
+        deliveryStageId = currentStageId;
+    }
+    else if (transition.nextStage) {
+        deliveryStatus = transition.nextStage.name;
+        deliveryStageId = transition.nextStage.id;
+    }
+    else {
+        // Staying on current stage means re-queuing
+        const queuedStage = getStageByName(workflow, 'queued');
+        deliveryStatus = queuedStage?.name ?? 'queued';
+        deliveryStageId = queuedStage?.id;
+    }
+    if (exitReason !== transition.exitReason) {
+        // exitReason was modified -- log the warning
+        console.warn(`Delivery "${context.delivery.name}": ${exitReason}`);
+    }
+    // Merge branch if warranted
+    let mergeOutcome = { mergeSucceeded: false, exitReason };
+    if (shouldMerge) {
+        mergeOutcome = await mergeDeliveryBranch({
+            config,
+            branchName,
+            deliveryId,
+            deliveryName: context.delivery.name,
+            organizationId: context.delivery.organization_id,
+            sessionId,
+            workflow,
+        });
+        exitReason = mergeOutcome.exitReason;
+    }
+    if (mergeOutcome.overrideDeliveryStatus) {
+        deliveryStatus = mergeOutcome.overrideDeliveryStatus;
+        deliveryStageId = mergeOutcome.overrideDeliveryStageId;
+    }
+    // Update delivery status with workflow stage
+    try {
+        await updateDeliveryStatus(deliveryId, deliveryStatus, deliveryStageId);
+        console.log(`Delivery "${context.delivery.name}" set to ${deliveryStatus}`);
+    }
+    catch (err) {
+        console.warn(`Failed to set delivery "${context.delivery.name}" to ${deliveryStatus}:`, err.message);
+    }
+    // Clean up worktree (branch is preserved for PR/review)
+    // Safety guards will refuse to delete if uncommitted changes or unmerged commits exist
+    removeWorktree(config.repoPath, runningAgent.worktreePath, {
+        branchName,
+        integrationBranch: config.integrationBranch,
+        deliveryName: context.delivery.name,
+        mergeSucceeded: mergeOutcome.mergeSucceeded,
+    });
+    // Report worktree_cleaned if merge succeeded (worktree was actually removed)
+    if (mergeOutcome.mergeSucceeded) {
+        reportGitState(deliveryId, 'worktree_cleaned').catch(err => console.warn(`[reportGitState] worktree_cleaned failed:`, err.message));
+    }
+    await updateSession(sessionId, {
+        status: sessionStatus,
+        exit_reason: exitReason,
+        ended_at: new Date().toISOString(),
+    });
+    // Record session completion for heartbeat counters
+    recordSessionCompleted(0, 0); // Token/cost tracking can be enriched later
+    // Trigger re-poll to pick up next delivery in the strategy's priority queue
+    if (shouldTriggerRepoll) {
+        console.log(`Delivery "${context.delivery.name}" completed, checking for next delivery in strategy...`);
+        triggerCheck();
+    }
+}
+// Note: MergeOutcome type and merge functions are now in delivery-lifecycle.ts.
+// The handleMergeIfNeeded and handleCiMerge functions have been extracted to
+// mergeDeliveryBranch() in delivery-lifecycle.ts for reuse by both the
+// legacy per-delivery handler and the strategy team lead.
+//# sourceMappingURL=completion-handler.js.map

package/dist/completion-handler.js.map

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

package/dist/condition-evaluators.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Individual condition type evaluators for the guard engine.
+ *
+ * Each condition type (open_issues_count, all_issues_done, agent_exit_code,
+ * gate_result, token_budget, work_unit_state, all_work_units_completed,
+ * cycle_count, wall_clock) is a separate function. A dispatch map routes
+ * condition_type strings to the appropriate evaluator.
+ *
+ * Extracted from guard-engine.ts to improve maintainability.
+ */
+import type { GuardConditionNode, ConditionEvalResult } from './types.js';
+import type { EvaluationContext } from './evaluation-context.js';
+/**
+ * Safely coerce a JSONB value to a number.
+ * Returns null if the value is not a valid finite number.
+ */
+export declare function toSafeNumber(value: unknown): number | null;
+/**
+ * Compare two numeric values with the given operator.
+ */
+export declare function compareValues(observed: number, operator: string, expected: number): boolean;
+/**
+ * Signature for a leaf condition evaluator function.
+ */
+export type ConditionEvaluatorFn = (node: GuardConditionNode, nodeId: string, ctx: EvaluationContext) => ConditionEvalResult;
+/**
+ * Evaluate a single leaf condition against the evaluation context.
+ * Dispatches to the appropriate evaluator based on condition_type.
+ */
+export declare function evaluateLeafCondition(node: GuardConditionNode, nodeId: string, ctx: EvaluationContext): ConditionEvalResult;
+//# sourceMappingURL=condition-evaluators.d.ts.map

package/dist/condition-evaluators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition-evaluators.d.ts","sourceRoot":"","sources":["../src/condition-evaluators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAMjE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAU3F;AAMD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,KACnB,mBAAmB,CAAC;AAmczB;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,GACrB,mBAAmB,CASrB"}

package/dist/condition-evaluators.js

@@ -0,0 +1,416 @@
+/**
+ * Individual condition type evaluators for the guard engine.
+ *
+ * Each condition type (open_issues_count, all_issues_done, agent_exit_code,
+ * gate_result, token_budget, work_unit_state, all_work_units_completed,
+ * cycle_count, wall_clock) is a separate function. A dispatch map routes
+ * condition_type strings to the appropriate evaluator.
+ *
+ * Extracted from guard-engine.ts to improve maintainability.
+ */
+// ============================================
+// Shared Utilities
+// ============================================
+/**
+ * Safely coerce a JSONB value to a number.
+ * Returns null if the value is not a valid finite number.
+ */
+export function toSafeNumber(value) {
+    if (value === null || value === undefined)
+        return null;
+    const num = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(num) ? num : null;
+}
+/**
+ * Compare two numeric values with the given operator.
+ */
+export function compareValues(observed, operator, expected) {
+    switch (operator) {
+        case 'eq': return observed === expected;
+        case 'neq': return observed !== expected;
+        case 'lt': return observed < expected;
+        case 'lte': return observed <= expected;
+        case 'gt': return observed > expected;
+        case 'gte': return observed >= expected;
+        default: return observed === expected;
+    }
+}
+// ============================================
+// Individual Condition Evaluators
+// ============================================
+function evaluateOpenIssuesCount(node, nodeId, ctx) {
+    const expr = node.expression ?? {};
+    const conditionType = 'open_issues_count';
+    const statuses = expr.statuses ?? ['To Do', 'In Progress', 'Blocked'];
+    const operator = expr.operator ?? 'eq';
+    const expected = toSafeNumber(expr.value) ?? 0;
+    let observed = 0;
+    for (const status of statuses) {
+        observed += ctx.issuesByStatus[status] ?? 0;
+    }
+    const passed = compareValues(observed, operator, expected);
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: observed,
+        expected_value: `${operator} ${expected}`,
+        message: passed
+            ? `Open issues count (${observed}) satisfies ${operator} ${expected}`
+            : `Open issues count (${observed}) does not satisfy ${operator} ${expected}`,
+    };
+}
+function evaluateAllIssuesDone(node, nodeId, ctx) {
+    const conditionType = 'all_issues_done';
+    const passed = ctx.openIssueCount === 0 && ctx.totalIssueCount > 0;
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: ctx.openIssueCount,
+        expected_value: 0,
+        message: passed
+            ? 'All issues are Done'
+            : ctx.totalIssueCount === 0
+                ? 'No issues exist on this delivery'
+                : `${ctx.openIssueCount} issue(s) are not Done`,
+    };
+}
+function evaluateAgentExitCode(node, nodeId, ctx) {
+    const expr = node.expression ?? {};
+    const conditionType = 'agent_exit_code';
+    const operator = expr.operator ?? 'eq';
+    const expected = toSafeNumber(expr.value) ?? 0;
+    const passed = compareValues(ctx.lastExitCode, operator, expected);
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: ctx.lastExitCode,
+        expected_value: `${operator} ${expected}`,
+        message: passed
+            ? `Agent exit code (${ctx.lastExitCode}) satisfies ${operator} ${expected}`
+            : `Agent exit code (${ctx.lastExitCode}) does not satisfy ${operator} ${expected}`,
+    };
+}
+function evaluateGateResult(node, nodeId, ctx) {
+    const expr = node.expression ?? {};
+    const conditionType = 'gate_result';
+    const gateType = expr.gate_type;
+    if (!gateType) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: false,
+            observed_value: null,
+            expected_value: 'gate_type required',
+            message: 'gate_result condition missing required gate_type in expression',
+        };
+    }
+    const scope = expr.scope ?? 'strategy';
+    const operator = expr.operator ?? 'eq';
+    const expectedValue = expr.value ?? 'passed';
+    const strategyId = expr.strategy_id;
+    const results = ctx.gateResults ?? [];
+    let filtered = results.filter(r => r.gateType === gateType);
+    if (scope === 'strategy' && strategyId) {
+        filtered = filtered.filter(r => r.strategyId === strategyId);
+    }
+    if (filtered.length === 0) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: false,
+            observed_value: 'no_results',
+            expected_value: `${operator} ${expectedValue}`,
+            message: `No gate results found for gate_type "${gateType}" (gate hasn't run yet)`,
+        };
+    }
+    // Use the most recent result (last in array)
+    const latest = filtered[filtered.length - 1];
+    const observedState = latest.passed ? 'passed' : 'failed';
+    const passed = operator === 'neq'
+        ? observedState !== expectedValue
+        : observedState === expectedValue;
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: observedState,
+        expected_value: `${operator} ${expectedValue}`,
+        message: passed
+            ? `Gate ${gateType} result (${observedState}) satisfies ${operator} ${expectedValue}`
+            : `Gate ${gateType} result (${observedState}) does not satisfy ${operator} ${expectedValue}`,
+    };
+}
+function evaluateTokenBudget(node, nodeId, ctx) {
+    const expr = node.expression ?? {};
+    const conditionType = 'token_budget';
+    if (ctx.tokensUsed === undefined) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: true,
+            observed_value: null,
+            expected_value: null,
+            message: 'No factory context -- token_budget skipped',
+        };
+    }
+    const mode = expr.mode ?? 'percentage';
+    const operator = expr.operator ?? 'lt';
+    const expected = toSafeNumber(expr.value);
+    if (expected === null) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: false,
+            observed_value: ctx.tokensUsed,
+            expected_value: 'value required',
+            message: 'token_budget condition missing or invalid value in expression',
+        };
+    }
+    let observed;
+    if (mode === 'percentage') {
+        if (ctx.tokenBudget == null) {
+            // Unlimited budget -- percentage mode always passes
+            return {
+                condition_id: nodeId,
+                condition_type: conditionType,
+                passed: true,
+                observed_value: 0,
+                expected_value: `${operator} ${expected}%`,
+                message: 'Token budget is unlimited -- percentage check passes',
+            };
+        }
+        if (ctx.tokenBudget === 0) {
+            // Zero budget means no tokens allowed -- usage is always 100%
+            observed = ctx.tokensUsed > 0 ? 100 : 0;
+        }
+        else {
+            observed = (ctx.tokensUsed / ctx.tokenBudget) * 100;
+        }
+    }
+    else {
+        observed = ctx.tokensUsed;
+    }
+    const passed = compareValues(observed, operator, expected);
+    const unit = mode === 'percentage' ? '%' : ' tokens';
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: Math.round(observed * 100) / 100,
+        expected_value: `${operator} ${expected}${unit}`,
+        message: passed
+            ? `Token usage (${Math.round(observed)}${unit}) satisfies ${operator} ${expected}${unit}`
+            : `Token usage (${Math.round(observed)}${unit}) does not satisfy ${operator} ${expected}${unit}`,
+    };
+}
+function evaluateWorkUnitState(node, nodeId, ctx) {
+    const expr = node.expression ?? {};
+    const conditionType = 'work_unit_state';
+    const statuses = expr.statuses;
+    if (!statuses || statuses.length === 0) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: false,
+            observed_value: null,
+            expected_value: 'statuses required',
+            message: 'work_unit_state condition missing required statuses in expression',
+        };
+    }
+    const operator = expr.operator ?? 'eq';
+    const expected = toSafeNumber(expr.value);
+    if (expected === null) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: false,
+            observed_value: null,
+            expected_value: 'value required',
+            message: 'work_unit_state condition missing or invalid value in expression',
+        };
+    }
+    const wuByStatus = ctx.workUnitsByStatus ?? {};
+    let observed = 0;
+    for (const status of statuses) {
+        observed += wuByStatus[status] ?? 0;
+    }
+    const passed = compareValues(observed, operator, expected);
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: observed,
+        expected_value: `${operator} ${expected}`,
+        message: passed
+            ? `Work units in [${statuses.join(', ')}] (${observed}) satisfies ${operator} ${expected}`
+            : `Work units in [${statuses.join(', ')}] (${observed}) does not satisfy ${operator} ${expected}`,
+    };
+}
+function evaluateAllWorkUnitsCompleted(node, nodeId, ctx) {
+    const conditionType = 'all_work_units_completed';
+    const wuByStatus = ctx.workUnitsByStatus ?? {};
+    const total = ctx.totalWorkUnitCount ?? 0;
+    const completed = wuByStatus['completed'] ?? 0;
+    const passed = completed === total && total > 0;
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: completed,
+        expected_value: total,
+        message: passed
+            ? `All ${total} work units are completed`
+            : total === 0
+                ? 'No work units exist'
+                : `${completed} of ${total} work units are completed`,
+    };
+}
+function evaluateCycleCount(node, nodeId, ctx) {
+    const expr = node.expression ?? {};
+    const conditionType = 'cycle_count';
+    if (ctx.cycleCount === undefined) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: true,
+            observed_value: null,
+            expected_value: null,
+            message: 'No factory context -- cycle_count skipped',
+        };
+    }
+    const operator = expr.operator ?? 'lt';
+    // Support dynamic values via value_from (reads from ctx.configValues)
+    const rawExpected = expr.value_from
+        ? (ctx.configValues?.[expr.value_from] ?? toSafeNumber(expr.value))
+        : toSafeNumber(expr.value);
+    if (rawExpected === null || rawExpected === undefined) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: false,
+            observed_value: ctx.cycleCount,
+            expected_value: 'value required',
+            message: 'cycle_count condition missing or invalid value in expression',
+        };
+    }
+    const expected = rawExpected;
+    const passed = compareValues(ctx.cycleCount, operator, expected);
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: ctx.cycleCount,
+        expected_value: `${operator} ${expected}`,
+        message: passed
+            ? `Cycle count (${ctx.cycleCount}) satisfies ${operator} ${expected}`
+            : `Cycle count (${ctx.cycleCount}) does not satisfy ${operator} ${expected}`,
+    };
+}
+function evaluateWallClock(node, nodeId, ctx) {
+    const expr = node.expression ?? {};
+    const conditionType = 'wall_clock';
+    if (ctx.wallClockSeconds === undefined) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: true,
+            observed_value: null,
+            expected_value: null,
+            message: 'No factory context -- wall_clock skipped',
+        };
+    }
+    const mode = expr.mode ?? 'percentage';
+    const operator = expr.operator ?? 'lt';
+    const expected = toSafeNumber(expr.value);
+    if (expected === null) {
+        return {
+            condition_id: nodeId,
+            condition_type: conditionType,
+            passed: false,
+            observed_value: ctx.wallClockSeconds,
+            expected_value: 'value required',
+            message: 'wall_clock condition missing or invalid value in expression',
+        };
+    }
+    let observed;
+    if (mode === 'percentage') {
+        if (ctx.wallClockLimitSeconds == null) {
+            return {
+                condition_id: nodeId,
+                condition_type: conditionType,
+                passed: true,
+                observed_value: 0,
+                expected_value: `${operator} ${expected}%`,
+                message: 'Wall clock limit is unlimited -- percentage check passes',
+            };
+        }
+        if (ctx.wallClockLimitSeconds === 0) {
+            // Zero time limit means no time allowed -- elapsed is always 100%
+            observed = ctx.wallClockSeconds > 0 ? 100 : 0;
+        }
+        else {
+            observed = (ctx.wallClockSeconds / ctx.wallClockLimitSeconds) * 100;
+        }
+    }
+    else {
+        observed = ctx.wallClockSeconds;
+    }
+    const passed = compareValues(observed, operator, expected);
+    const unit = mode === 'percentage' ? '%' : 's';
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed,
+        observed_value: Math.round(observed * 100) / 100,
+        expected_value: `${operator} ${expected}${unit}`,
+        message: passed
+            ? `Wall clock (${Math.round(observed)}${unit}) satisfies ${operator} ${expected}${unit}`
+            : `Wall clock (${Math.round(observed)}${unit}) does not satisfy ${operator} ${expected}${unit}`,
+    };
+}
+function evaluateUnknown(node, nodeId, _ctx) {
+    const conditionType = node.condition_type ?? 'unknown';
+    console.warn(`[guard] Unknown condition type "${conditionType}" -- blocking (possible misconfiguration)`);
+    return {
+        condition_id: nodeId,
+        condition_type: conditionType,
+        passed: false,
+        observed_value: null,
+        expected_value: null,
+        message: `Unknown condition type "${conditionType}" -- blocked (unrecognized type)`,
+    };
+}
+// ============================================
+// Dispatch Map
+// ============================================
+/**
+ * Map of condition type strings to their evaluator functions.
+ * Add new condition types here.
+ */
+const conditionEvaluators = {
+    open_issues_count: evaluateOpenIssuesCount,
+    all_issues_done: evaluateAllIssuesDone,
+    agent_exit_code: evaluateAgentExitCode,
+    gate_result: evaluateGateResult,
+    token_budget: evaluateTokenBudget,
+    work_unit_state: evaluateWorkUnitState,
+    all_work_units_completed: evaluateAllWorkUnitsCompleted,
+    cycle_count: evaluateCycleCount,
+    wall_clock: evaluateWallClock,
+};
+/**
+ * Evaluate a single leaf condition against the evaluation context.
+ * Dispatches to the appropriate evaluator based on condition_type.
+ */
+export function evaluateLeafCondition(node, nodeId, ctx) {
+    const conditionType = node.condition_type ?? 'unknown';
+    const evaluator = conditionEvaluators[conditionType];
+    if (evaluator) {
+        return evaluator(node, nodeId, ctx);
+    }
+    return evaluateUnknown(node, nodeId, ctx);
+}
+//# sourceMappingURL=condition-evaluators.js.map