@telora/factory 0.4.5

package/dist/workflow-transition.js

@@ -0,0 +1,340 @@
+/**
+ * Workflow transition orchestrator for the factory engine.
+ *
+ * Provides a high-level API for transitioning factory entities through
+ * workflow-governed state changes. Each transition:
+ * 1. Resolves the entity's workflow (cached per instance)
+ * 2. Finds the transition from current stage to target stage
+ * 3. Fetches and evaluates guards
+ * 4. Executes triggers
+ * 5. Updates the entity's current_workflow_stage_id
+ * 6. Records audit trail
+ *
+ * Falls back gracefully when no workflow is assigned (direct status update).
+ */
+import { evaluateGuardConditionTree, interpolateTemplate } from './guard-evaluation.js';
+import { resolveFactoryWorkflow, fetchTransitionGuards, createTransitionEvaluation, } from './queries/workflows.js';
+/** Default cache TTL: 5 minutes. */
+const CACHE_TTL_MS = 5 * 60 * 1000;
+const workflowCache = new Map();
+/**
+ * Resolve and cache a factory workflow by entity type.
+ * Returns null if no workflow exists for this entity type.
+ * Cached entries expire after CACHE_TTL_MS (5 minutes).
+ */
+export async function getOrResolveWorkflow(entityType) {
+    const cached = workflowCache.get(entityType);
+    if (cached && (Date.now() - cached.cachedAt) < CACHE_TTL_MS) {
+        return cached.workflow;
+    }
+    try {
+        const workflow = await resolveFactoryWorkflow(entityType);
+        workflowCache.set(entityType, { workflow, cachedAt: Date.now() });
+        return workflow;
+    }
+    catch (err) {
+        console.warn(`[workflow] Failed to resolve workflow for ${entityType}:`, err.message);
+        workflowCache.set(entityType, { workflow: null, cachedAt: Date.now() });
+        return null;
+    }
+}
+/**
+ * Clear the workflow cache (for testing or hot-reload).
+ */
+export function clearWorkflowCache() {
+    workflowCache.clear();
+}
+// ============================================================================
+// Transition finder
+// ============================================================================
+/**
+ * Find the transition between two stages by name within a workflow.
+ * Returns null if no such transition exists.
+ */
+export function findTransition(workflow, fromStageName, toStageName) {
+    const fromStage = workflow.stageByName.get(fromStageName);
+    const toStage = workflow.stageByName.get(toStageName);
+    if (!fromStage || !toStage)
+        return null;
+    return workflow.transitions.find(t => t.from_stage_id === fromStage.id && t.to_stage_id === toStage.id) ?? null;
+}
+/**
+ * Get the stage name for a given stage ID.
+ */
+export function getStageName(workflow, stageId) {
+    return workflow.stageById.get(stageId)?.name ?? null;
+}
+// ============================================================================
+// Guard evaluation at a transition
+// ============================================================================
+/**
+ * Evaluate all guards at a workflow transition.
+ * Fetches guards from the DB, evaluates conditions, collects triggers.
+ */
+export async function evaluateTransitionGuards(organizationId, entityType, entityId, transition, ctx) {
+    let guards;
+    let triggers;
+    try {
+        const resolved = await fetchTransitionGuards(transition.id);
+        guards = resolved.guards;
+        triggers = resolved.triggers;
+    }
+    catch (err) {
+        console.error(`[workflow] Failed to fetch guards for transition ${transition.id}:`, err.message);
+        // Fail-open: proceed without guards
+        return {
+            should_proceed: true,
+            evaluations: [],
+            triggers_to_execute: [],
+            warnings: [],
+            blocks: [],
+        };
+    }
+    if (guards.length === 0) {
+        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: [],
+        };
+    }
+    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) {
+            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 {
+            const passTriggers = triggers.filter(t => t.trigger_event === 'on_guard_pass');
+            for (const trigger of passTriggers) {
+                triggersToExecute.push({ trigger, guard, eval_result: evalResult });
+            }
+        }
+        // Record audit trail (best-effort)
+        try {
+            await createTransitionEvaluation({
+                organization_id: organizationId,
+                entity_type: entityType,
+                entity_id: entityId,
+                transition_id: transition.id,
+                guard_id: guard.id,
+                result: passed ? 'passed' : 'failed',
+                blocked: !passed && guard.enforcement === 'hard',
+                enforcement_level: guard.enforcement,
+                evaluation_details: { conditions: details },
+            });
+        }
+        catch (err) {
+            console.warn(`[workflow] Failed to record evaluation for guard "${guard.name}":`, err.message);
+        }
+    }
+    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 };
+}
+// ============================================================================
+// Trigger executor
+// ============================================================================
+/**
+ * Execute triggers from a guard evaluation result.
+ * Factory-specific: handles inject_prompt, manage_context, set_field, notify.
+ * Skips spawn_agent, create_issue, block_transition (daemon-only).
+ */
+export async function executeFactoryTriggers(triggersToExecute, target, factoryCtx) {
+    for (const { trigger, eval_result } of triggersToExecute) {
+        try {
+            switch (trigger.action_type) {
+                case 'inject_prompt': {
+                    if (!target) {
+                        console.warn(`[workflow] inject_prompt trigger "${trigger.name}" skipped: no execution target`);
+                        break;
+                    }
+                    const prompt = interpolateTemplate(trigger.directive_template, eval_result, factoryCtx);
+                    if (prompt)
+                        await target.injectPrompt(prompt);
+                    break;
+                }
+                case 'manage_context': {
+                    if (!target) {
+                        console.warn(`[workflow] manage_context trigger "${trigger.name}" skipped: no execution target`);
+                        break;
+                    }
+                    const directiveType = trigger.action_config.directive;
+                    if (!directiveType) {
+                        console.warn(`[workflow] manage_context trigger "${trigger.name}" skipped: missing directive in action_config`);
+                        break;
+                    }
+                    const directive = {
+                        type: directiveType,
+                        files: trigger.action_config.files,
+                    };
+                    await target.manageContext(directive);
+                    break;
+                }
+                case 'set_field': {
+                    if (!target) {
+                        console.warn(`[workflow] set_field trigger "${trigger.name}" skipped: no execution target`);
+                        break;
+                    }
+                    const fieldName = trigger.action_config.field_name;
+                    if (!fieldName) {
+                        console.warn(`[workflow] set_field trigger "${trigger.name}" skipped: missing field_name in action_config`);
+                        break;
+                    }
+                    let fieldValue = trigger.action_config.field_value;
+                    if (typeof fieldValue === 'string') {
+                        fieldValue = interpolateTemplate(fieldValue, eval_result, factoryCtx);
+                    }
+                    await target.setField(fieldName, fieldValue);
+                    break;
+                }
+                case 'notify': {
+                    const recipients = trigger.action_config.recipients ?? [];
+                    const message = interpolateTemplate(trigger.action_config.message_template ?? null, eval_result, factoryCtx);
+                    if (target) {
+                        await target.notify(recipients, message || '');
+                    }
+                    else {
+                        // Structured log fallback when no execution target is available
+                        console.warn(`[workflow] notify trigger "${trigger.name}": recipients=${JSON.stringify(recipients)} message="${message || '(no message)'}"`);
+                    }
+                    break;
+                }
+                case 'emit_warning': {
+                    const details = eval_result?.condition_details ?? [];
+                    const failedConditions = details
+                        .filter(d => !d.passed).map(d => d.message).join('; ');
+                    console.warn(`[workflow] Warning [${trigger.name}]: ${failedConditions || 'conditions not met'}`);
+                    break;
+                }
+                // block_transition, spawn_agent, create_issue are daemon-only
+                default:
+                    console.debug(`[workflow] Trigger type "${trigger.action_type}" not handled in factory context`);
+            }
+        }
+        catch (err) {
+            console.error(`[workflow] Failed to execute ${trigger.action_type} trigger "${trigger.name}":`, err.message);
+        }
+    }
+}
+/**
+ * Attempt a workflow-governed transition for a factory entity.
+ *
+ * This is the main entry point for the factory engine. It:
+ * 1. Optionally checks expectedStageId for optimistic locking (concurrent transition protection)
+ * 2. Finds the transition in the resolved workflow
+ * 3. Evaluates guards
+ * 4. Executes triggers (if guards pass)
+ * 5. Returns whether the transition is allowed and the new stage ID
+ *
+ * The caller is responsible for:
+ * - Updating the entity's status and current_workflow_stage_id in the DB
+ *   using WHERE current_workflow_stage_id = expectedStageId for optimistic locking
+ * - Updating in-memory state
+ * - Retrying on stale result (re-read entity state and re-attempt)
+ *
+ * @param workflow Resolved workflow (from instance state cache)
+ * @param currentStageName Current stage name (e.g. 'pending', 'building')
+ * @param targetStageName Target stage name (e.g. 'planning', 'completed')
+ * @param organizationId Organization ID for audit trail
+ * @param entityType Entity type for audit trail (e.g. 'factory_instance')
+ * @param entityId Entity UUID for audit trail
+ * @param ctx Evaluation context with factory state data
+ * @param target Optional trigger execution target for active sessions
+ * @param factoryCtx Optional factory template context for prompt interpolation
+ * @param expectedStageId Optional expected current stage ID for optimistic locking.
+ *   When provided, the transition is rejected with stale=true if the entity's
+ *   current stage doesn't match, preventing race conditions from concurrent transitions.
+ */
+export async function attemptTransition(workflow, currentStageName, targetStageName, organizationId, entityType, entityId, ctx, target, factoryCtx, expectedStageId) {
+    if (!workflow) {
+        // No workflow -- allow all transitions (backward compatible)
+        return {
+            allowed: true,
+            newStageId: null,
+            newStageName: targetStageName,
+            guardResult: null,
+            hasWorkflow: false,
+        };
+    }
+    // Optimistic locking: verify current stage hasn't changed
+    if (expectedStageId != null) {
+        const currentStage = workflow.stageByName.get(currentStageName);
+        if (currentStage && currentStage.id !== expectedStageId) {
+            console.warn(`[workflow] Stale transition attempt for ${entityType} ${entityId}: ` +
+                `expected stage ${expectedStageId} but current is ${currentStage.id} ("${currentStageName}")`);
+            return {
+                allowed: false,
+                newStageId: null,
+                newStageName: null,
+                guardResult: null,
+                hasWorkflow: true,
+                stale: true,
+            };
+        }
+    }
+    const transition = findTransition(workflow, currentStageName, targetStageName);
+    if (!transition) {
+        console.warn(`[workflow] No transition found from "${currentStageName}" to "${targetStageName}" ` +
+            `in workflow ${workflow.id} -- allowing (graceful fallback)`);
+        return {
+            allowed: true,
+            newStageId: workflow.stageByName.get(targetStageName)?.id ?? null,
+            newStageName: targetStageName,
+            guardResult: null,
+            hasWorkflow: true,
+        };
+    }
+    const guardResult = await evaluateTransitionGuards(organizationId, entityType, entityId, transition, ctx);
+    if (!guardResult.should_proceed) {
+        console.log(`[workflow] Transition "${currentStageName}" -> "${targetStageName}" blocked ` +
+            `by ${guardResult.blocks.length} hard guard(s) for ${entityType} ${entityId}`);
+        return {
+            allowed: false,
+            newStageId: null,
+            newStageName: null,
+            guardResult,
+            hasWorkflow: true,
+        };
+    }
+    // Execute triggers
+    if (guardResult.triggers_to_execute.length > 0) {
+        await executeFactoryTriggers(guardResult.triggers_to_execute, target ?? null, factoryCtx);
+    }
+    const targetStage = workflow.stageByName.get(targetStageName);
+    return {
+        allowed: true,
+        newStageId: targetStage?.id ?? null,
+        newStageName: targetStageName,
+        guardResult,
+        hasWorkflow: true,
+    };
+}
+//# sourceMappingURL=workflow-transition.js.map

package/dist/workflow-transition.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@telora/factory",
+  "version": "0.4.5",
+  "description": "Factory orchestrator for Telora - manages build-gate cycles for AI-driven code generation",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./factory-engine": {
+      "import": "./dist/factory-engine.js",
+      "types": "./dist/factory-engine.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "start": "echo 'Library package -- use telora-daemon instead' && exit 1",
+    "lint": "eslint .",
+    "test": "npx tsx --experimental-test-module-mocks --test src/__tests__/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@telora/daemon-core": "^0.2.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.12.0",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import-x": "^4.16.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "telora",
+    "factory",
+    "claude",
+    "claude-code",
+    "orchestration",
+    "ai-agent",
+    "build-gate"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/syntelyos/telora.git",
+    "directory": "packages/factory"
+  },
+  "license": "MIT",
+  "author": "Syntelyos",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}