@telora/daemon 0.21.26 → 0.21.82

package/dist/guard/guard-evaluator.js

@@ -0,0 +1,195 @@
+/**
+ * Core condition tree evaluation logic for the guard engine.
+ *
+ * Contains the main evaluateGuardConditionTree function that traverses
+ * AND/OR/NOT trees and dispatches to leaf condition evaluators, plus the
+ * high-level guard evaluation orchestrator (evaluateGuardsAtTransition).
+ *
+ * Extracted from guard-engine.ts to improve maintainability.
+ */
+import { buildEvaluationContext } from './evaluation-context.js';
+import { evaluateLeafCondition } from './condition-evaluators.js';
+import { fetchTransitionGuards, createTransitionEvaluation, } from '../queries/guards.js';
+import { withRetry } from '@telora/daemon-core';
+import { createLogger } from '../shell/log.js';
+const log = createLogger({ module: 'guard-evaluator' });
+// ============================================
+// Guard Evaluation Error
+// ============================================
+/**
+ * Error thrown when guard evaluation fails.
+ * Carries the fetched guards (if available) so callers can determine
+ * failure mode based on enforcement levels.
+ */
+export class GuardEvaluationError extends Error {
+    cause;
+    fetchedGuards;
+    constructor(message, cause, 
+    /** Guards that were successfully fetched before the error, if any. */
+    fetchedGuards) {
+        super(message);
+        this.cause = cause;
+        this.fetchedGuards = fetchedGuards;
+        this.name = 'GuardEvaluationError';
+    }
+    /** Whether any fetched guard has hard enforcement. */
+    get hasHardEnforcementGuards() {
+        return this.fetchedGuards?.some(g => g.enforcement === 'hard') ?? false;
+    }
+    /** Names of fetched guards (for error messages). */
+    get guardNames() {
+        return this.fetchedGuards?.map(g => g.name) ?? [];
+    }
+}
+// ============================================
+// Condition Tree Evaluator
+// ============================================
+/**
+ * Evaluate a single condition tree node recursively.
+ *
+ * Accumulates leaf evaluation results into `details` and uses
+ * `nodeCounter` (passed by reference as a wrapper) to assign stable IDs.
+ * Extracted from evaluateGuardConditionTree to eliminate mutable closure state.
+ */
+function evaluateConditionNode(node, ctx, details, nodeCounter) {
+    const children = node.children ?? [];
+    if (children.length > 0) {
+        // Group node -- evaluate children with this node's logical operator
+        const operator = node.logical_operator ?? 'AND';
+        const childResults = children.map(child => evaluateConditionNode(child, ctx, details, nodeCounter));
+        return operator === 'AND'
+            ? childResults.every(r => r)
+            : childResults.some(r => r);
+    }
+    // Leaf node -- evaluate the condition and record the result
+    const nodeId = `cond-${nodeCounter.value++}`;
+    const evalResult = evaluateLeafCondition(node, nodeId, ctx);
+    details.push(evalResult);
+    return evalResult.passed;
+}
+/**
+ * Evaluate a JSONB condition tree for a guard.
+ *
+ * The JSONB tree uses nested children arrays rather than
+ * parent_condition_id references. Root-level nodes are combined
+ * with AND by default.
+ */
+export function evaluateGuardConditionTree(conditions, ctx) {
+    if (conditions.length === 0) {
+        return { passed: true, details: [] };
+    }
+    const details = [];
+    const nodeCounter = { value: 0 };
+    const rootResults = conditions.map(node => evaluateConditionNode(node, ctx, details, nodeCounter));
+    const passed = rootResults.every(r => r);
+    return { passed, details };
+}
+// ============================================
+// Guard Evaluation Orchestrator
+// ============================================
+/**
+ * Evaluate all guards at a workflow transition.
+ *
+ * Returns a TransitionGuardResult indicating whether the transition
+ * should proceed and what triggers need to be executed.
+ */
+export async function evaluateGuardsAtTransition(deliveryId, organizationId, transitionId, lastExitCode) {
+    let guards;
+    let triggers;
+    try {
+        const resolved = await withRetry(() => fetchTransitionGuards(transitionId), { label: 'guard-fetch' });
+        guards = resolved.guards;
+        triggers = resolved.triggers;
+    }
+    catch (err) {
+        throw new GuardEvaluationError(`Failed to fetch guards: ${err.message}`, err, null);
+    }
+    if (guards.length === 0) {
+        // No guards -- collect on_enter triggers and proceed
+        const enterTriggers = triggers.filter(t => t.trigger_event === 'on_enter');
+        return {
+            should_proceed: true,
+            evaluations: [],
+            triggers_to_execute: enterTriggers.map(t => ({ trigger: t, guard: null, eval_result: null })),
+            warnings: [],
+            blocks: [],
+        };
+    }
+    let ctx;
+    try {
+        ctx = await withRetry(() => buildEvaluationContext(deliveryId, lastExitCode), { label: 'guard-context' });
+    }
+    catch (err) {
+        throw new GuardEvaluationError(`Failed to build evaluation context: ${err.message}`, err, guards);
+    }
+    // Evaluate each guard's conditions
+    const evaluations = [];
+    const triggersToExecute = [];
+    const warnings = [];
+    const blocks = [];
+    for (const guard of guards) {
+        const { passed, details } = evaluateGuardConditionTree(guard.conditions, ctx);
+        const evalResult = {
+            guard_id: guard.id,
+            guard_name: guard.name,
+            enforcement: guard.enforcement,
+            passed,
+            condition_details: details,
+        };
+        evaluations.push(evalResult);
+        if (!passed) {
+            // Collect on_guard_fail triggers for this guard
+            const failTriggers = triggers.filter(t => t.trigger_event === 'on_guard_fail');
+            for (const trigger of failTriggers) {
+                triggersToExecute.push({ trigger, guard, eval_result: evalResult });
+            }
+            if (guard.enforcement === 'hard') {
+                blocks.push(evalResult);
+            }
+            else {
+                warnings.push(evalResult);
+            }
+        }
+        else {
+            // Collect on_guard_pass triggers
+            const passTriggers = triggers.filter(t => t.trigger_event === 'on_guard_pass');
+            for (const trigger of passTriggers) {
+                triggersToExecute.push({ trigger, guard, eval_result: evalResult });
+            }
+        }
+        // Record evaluation in audit trail
+        const evaluationRecord = {
+            organization_id: organizationId,
+            entity_type: 'delivery',
+            entity_id: deliveryId,
+            transition_id: transitionId,
+            guard_id: guard.id,
+            result: passed ? 'passed' : 'failed',
+            blocked: !passed && guard.enforcement === 'hard',
+            enforcement_level: guard.enforcement,
+            evaluation_details: { conditions: details },
+        };
+        try {
+            await createTransitionEvaluation(evaluationRecord);
+        }
+        catch (err) {
+            log.warn(`Failed to record guard evaluation for "${guard.name}":`, err.message);
+        }
+    }
+    // Collect on_enter triggers if proceeding
+    const shouldProceed = blocks.length === 0;
+    if (shouldProceed) {
+        const enterTriggers = triggers.filter(t => t.trigger_event === 'on_enter');
+        for (const trigger of enterTriggers) {
+            triggersToExecute.push({ trigger, guard: null, eval_result: null });
+        }
+    }
+    return {
+        should_proceed: shouldProceed,
+        evaluations,
+        triggers_to_execute: triggersToExecute,
+        warnings,
+        blocks,
+    };
+}
+//# sourceMappingURL=guard-evaluator.js.map

package/dist/guard/guard-evaluator.js.map

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

package/dist/guard/trigger-executor.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Trigger execution for the guard engine.
+ *
+ * Contains all trigger action type executors: block_transition, emit_warning,
+ * spawn_agent, create_issue, inject_prompt, manage_context, set_field, notify.
+ * Also includes the main executeTriggers orchestrator and template interpolation.
+ *
+ * Extracted from guard-engine.ts to improve maintainability.
+ */
+import type { WorkflowGuard, WorkflowTrigger, GuardEvalResult, TransitionGuardResult, TriggerExecutionTarget } from '../types/index.js';
+import { createSession } from '../queries/sessions.js';
+import { updateDeliveryStatus } from '../queries/deliveries.js';
+import { markSessionPersisted } from '../otlp/telemetry-writer.js';
+/**
+ * Template interpolation for trigger templates.
+ * Supports guard variables.
+ *
+ * Guard variables: {{guard_name}}, {{condition_summary}}, {{observed_values}}, {{policy_name}}
+ */
+export declare function interpolateTemplate(template: string | null, evalResult: GuardEvalResult | null): string;
+/**
+ * Execute a block_transition trigger.
+ * Sets delivery to paused and creates a transition_blocks record.
+ */
+export declare function executeBlockTransition(deliveryId: string, organizationId: string, transitionId: string, guard: WorkflowGuard | null, trigger: WorkflowTrigger, evaluationId: string): Promise<string>;
+/**
+ * Execute an emit_warning trigger.
+ * Logs the warning.
+ */
+export declare function executeEmitWarning(guard: WorkflowGuard | null, evalResult: GuardEvalResult | null): void;
+/**
+ * Execute a spawn_agent trigger.
+ * Creates a new agent session for the specified role.
+ */
+/**
+ * The query/telemetry functions executeSpawnAgent reaches into, injectable for
+ * tests. Each defaults to the real import; a test supplies fakes through this
+ * seam instead of registering `mock.module` (which would poison the daemon-core
+ * loader -- see packages/daemon/CLAUDE.md). mock.fn spies are fine.
+ */
+export interface ExecuteSpawnAgentDeps {
+    createSession?: typeof createSession;
+    markSessionPersisted?: typeof markSessionPersisted;
+    updateDeliveryStatus?: typeof updateDeliveryStatus;
+}
+export declare function executeSpawnAgent(deliveryId: string, organizationId: string, trigger: WorkflowTrigger, deps?: ExecuteSpawnAgentDeps): Promise<string>;
+/**
+ * Execute a create_issue trigger.
+ * Creates a bug or task on the delivery.
+ */
+export declare function executeCreateIssue(deliveryId: string, trigger: WorkflowTrigger, evalResult: GuardEvalResult | null): Promise<string>;
+/**
+ * Execute an advance_linked_injections trigger.
+ * Finds injections linked to a focus via reality_tree_links and
+ * advances their injection_status to the configured targetStatus.
+ *
+ * Idempotent: skips injections already at or past the target status.
+ * Never moves backward in the lifecycle ordering.
+ */
+export declare function executeAdvanceLinkedInjections(focusId: string, actionConfig: Record<string, unknown>): Promise<void>;
+/**
+ * Execute a verify_linked_injection trigger.
+ *
+ * Dispatches the delivery verify -> done transition into the reassessment
+ * pass (supabase/functions/_shared/reassessment-pass.ts) via the
+ * reality_tree_reassess_injection action. The pass observes current reality
+ * and produces one of four judgments (verified, realized_with_gaps,
+ * realized_pending, crt_mismatch) with the appropriate side effects.
+ *
+ * The pass owns idempotency end-to-end via the (injection_node_id,
+ * observation_snapshot) unique constraint on reality_tree_reassessments,
+ * so we no longer need the focus-injections status lookup that the legacy
+ * inline path used.
+ *
+ * Fail-soft: any error is caught and logged via console.warn. The handler
+ * MUST NOT throw -- the workflow transition continues regardless.
+ *
+ * @param deliveryId The delivery transitioning to done.
+ * @param callApiFn Optional injection of the API client (used by tests).
+ *   Defaults to the module-level callApi.
+ */
+export declare function executeVerifyLinkedInjection(deliveryId: string, callApiFn?: <T>(action: string, params?: Record<string, unknown>) => Promise<T>): Promise<void>;
+/**
+ * Execute all triggers from a guard evaluation result.
+ * Returns metadata about what was executed.
+ *
+ * @param target Optional TriggerExecutionTarget for a live AI session. When
+ *   provided, inject_prompt and manage_context triggers use it. When absent
+ *   (daemon delivery context), those trigger types log a warning and skip.
+ * @param focusId Optional focus ID for focus-level triggers
+ *   (e.g. advance_linked_injections).
+ */
+export declare function executeTriggers(deliveryId: string, organizationId: string, transitionId: string, triggersToExecute: TransitionGuardResult['triggers_to_execute'], target?: TriggerExecutionTarget | null, focusId?: string | null): Promise<{
+    blocked: boolean;
+    blockId: string | null;
+    spawnedSessionIds: string[];
+    createdIssueIds: string[];
+}>;
+//# sourceMappingURL=trigger-executor.d.ts.map

package/dist/guard/trigger-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-executor.d.ts","sourceRoot":"","sources":["../../src/guard/trigger-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,qBAAqB,EAErB,sBAAsB,EAEvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAOhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAUnE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,UAAU,EAAE,eAAe,GAAG,IAAI,GACjC,MAAM,CAuBR;AAMD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,UAAU,EAAE,eAAe,GAAG,IAAI,GACjC,IAAI,CASN;AAED;;;GAGG;AACH;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACnD,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAC;CACpD;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,eAAe,GAAG,IAAI,GACjC,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAwID;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC,CA6Ef;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAW,GACvF,OAAO,CAAC,IAAI,CAAC,CA6Df;AAMD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,qBAAqB,CAAC,qBAAqB,CAAC,EAC/D,MAAM,CAAC,EAAE,sBAAsB,GAAG,IAAI,EACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC,CAiGD"}