@telora/factory 0.4.5

package/dist/gate-context.js

@@ -0,0 +1,63 @@
+/**
+ * Gate context formatter.
+ *
+ * Builds a human-readable summary of which gate layers were enabled on a
+ * blueprint and what they validate. Used to give AI reviewers and planners
+ * context about which validation dimensions the gate system already handles,
+ * so they do not flag test coverage, type safety, or E2E behavior as gaps.
+ *
+ * This module has no dependencies other than types, so it can be safely
+ * imported by any prompt builder without pulling in the full gate stack.
+ */
+/**
+ * Build a human-readable summary of which gates were enabled on this blueprint
+ * and what they validated.
+ *
+ * Called only when all strategy-level gates have already passed, so every
+ * gate listed here is known to have succeeded before the review runs.
+ *
+ * Returns an empty string if no gates are enabled (caller should skip the section).
+ */
+export function formatGateContext(blueprint) {
+    const enabled = new Set(blueprint.gatesEnabled);
+    if (enabled.size === 0)
+        return '';
+    const lines = [
+        '## Gate Validation Already Completed',
+        '',
+        'Before this review, the factory gate system ran the following automated',
+        'validation layers. All enabled gates PASSED before this review was invoked.',
+        '',
+        'These dimensions are ALREADY VALIDATED by the gate layer. Do NOT flag them',
+        'as specification gaps:',
+        '- Test coverage and test results',
+        '- TypeScript type correctness',
+        '- Build validity',
+        '- Runtime behavioral correctness (E2E)',
+        '- Adversarial edge cases',
+        '',
+    ];
+    if (enabled.has('deterministic')) {
+        const cmds = blueprint.deterministicConfig?.commands ??
+            ['npm run typecheck', 'npm run lint', 'npm test', 'npm run build'];
+        lines.push('### Deterministic Gates: PASSED');
+        for (const cmd of cmds) {
+            lines.push(`- \`${cmd}\``);
+        }
+        lines.push('');
+    }
+    if (enabled.has('behavioral')) {
+        const glob = blueprint.behavioralConfig?.testGlob ?? 'tests/**/*.spec.ts';
+        lines.push('### Behavioral Gates: PASSED');
+        lines.push(`- Playwright E2E tests matching \`${glob}\``);
+        lines.push('');
+    }
+    if (enabled.has('adversarial')) {
+        const sessions = blueprint.adversarialConfig?.maxSessions ?? 3;
+        lines.push('### Adversarial Gates: PASSED');
+        lines.push(`- AI adversary (up to ${sessions} session(s)) generated and ran break-attempt Playwright tests`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=gate-context.js.map

package/dist/gate-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-context.js","sourceRoot":"","sources":["../src/gate-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAA2B;IAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,MAAM,KAAK,GAAa;QACtB,sCAAsC;QACtC,EAAE;QACF,yEAAyE;QACzE,6EAA6E;QAC7E,EAAE;QACF,4EAA4E;QAC5E,wBAAwB;QACxB,kCAAkC;QAClC,+BAA+B;QAC/B,kBAAkB;QAClB,wCAAwC;QACxC,0BAA0B;QAC1B,EAAE;KACH,CAAC;IAEF,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,SAAS,CAAC,mBAAmB,EAAE,QAAQ;YAClD,CAAC,mBAAmB,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,gBAAgB,EAAE,QAAQ,IAAI,oBAAoB,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,qCAAqC,IAAI,IAAI,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,SAAS,CAAC,iBAAiB,EAAE,WAAW,IAAI,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CACR,yBAAyB,QAAQ,+DAA+D,CACjG,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/gate-engine.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Gate evaluation engine orchestrator.
+ *
+ * Orchestrates the 3-layer gate architecture for a work unit:
+ *   1. Deterministic gates (typecheck, lint, test, build)
+ *   2. Behavioral gates (Playwright E2E against dev server)
+ *   3. Adversarial gates (AI-generated break-attempt tests)
+ *
+ * Each layer only runs after the previous layer passes. Results are recorded
+ * to factory_gate_results via the API layer. On failure, gate output is
+ * formatted as structured feedback for the builder session to use in its
+ * next iteration.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import type { FactoryInstanceState, FactoryConfig, GateType, GateCheckResult } from './types.js';
+/** Result of evaluating all gate layers for a work unit. */
+export interface GateEvaluationResult {
+    /** Whether all enabled gate layers passed. */
+    passed: boolean;
+    /** Per-layer results in order of evaluation. */
+    layers: GateLayerResult[];
+    /** Formatted feedback string for the builder on failure. */
+    failureFeedback: string | null;
+}
+/** Result of a single gate layer. */
+interface GateLayerResult {
+    gateType: GateType;
+    passed: boolean;
+    results: GateCheckResult[];
+    durationMs: number;
+}
+/** Context for attributing gate results to the right entity. */
+export interface GateContext {
+    /** Strategy being evaluated. */
+    strategyId: string;
+    /** Factory instance ID. */
+    instanceId: string;
+    /** Current iteration number. */
+    iteration: number;
+}
+/**
+ * Evaluate all gate layers for a strategy or work unit.
+ *
+ * Runs enabled gate layers sequentially (deterministic -> behavioral -> adversarial).
+ * Each layer only runs if the previous layer passed. Records all results to the
+ * database via the API layer.
+ *
+ * @param ctx           Context identifying what is being gated (strategy or work unit).
+ * @param instanceState The parent factory instance state.
+ * @param config        Factory configuration.
+ * @returns             The evaluation result with pass/fail and optional failure feedback.
+ */
+export declare function evaluateGates(ctx: GateContext, instanceState: FactoryInstanceState, config: FactoryConfig, governor?: ResourceGovernor | null): Promise<GateEvaluationResult>;
+export {};
+//# sourceMappingURL=gate-engine.d.ts.map

package/dist/gate-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-engine.d.ts","sourceRoot":"","sources":["../src/gate-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,QAAQ,EACR,eAAe,EAChB,MAAM,YAAY,CAAC;AAWpB,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,4DAA4D;IAC5D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,qCAAqC;AACrC,UAAU,eAAe;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,aAAa,EAAE,oBAAoB,EACnC,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAoF/B"}

package/dist/gate-engine.js

@@ -0,0 +1,191 @@
+/**
+ * Gate evaluation engine orchestrator.
+ *
+ * Orchestrates the 3-layer gate architecture for a work unit:
+ *   1. Deterministic gates (typecheck, lint, test, build)
+ *   2. Behavioral gates (Playwright E2E against dev server)
+ *   3. Adversarial gates (AI-generated break-attempt tests)
+ *
+ * Each layer only runs after the previous layer passes. Results are recorded
+ * to factory_gate_results via the API layer. On failure, gate output is
+ * formatted as structured feedback for the builder session to use in its
+ * next iteration.
+ */
+import { createGateResult } from './queries/gate-results.js';
+import { runDeterministicGates } from './gates/deterministic.js';
+import { runBehavioralGates } from './gates/behavioral.js';
+import { runAdversarialGates } from './gates/adversarial.js';
+import { resolveExecutionProfile } from './spec-profiles.js';
+/**
+ * Evaluate all gate layers for a strategy or work unit.
+ *
+ * Runs enabled gate layers sequentially (deterministic -> behavioral -> adversarial).
+ * Each layer only runs if the previous layer passed. Records all results to the
+ * database via the API layer.
+ *
+ * @param ctx           Context identifying what is being gated (strategy or work unit).
+ * @param instanceState The parent factory instance state.
+ * @param config        Factory configuration.
+ * @returns             The evaluation result with pass/fail and optional failure feedback.
+ */
+export async function evaluateGates(ctx, instanceState, config, governor) {
+    const blueprint = instanceState.blueprint;
+    const worktreePath = instanceState.worktreePath;
+    const specification = instanceState.specification ?? '';
+    const label = `strategy ${ctx.strategyId}`;
+    if (!worktreePath) {
+        return {
+            passed: false,
+            layers: [],
+            failureFeedback: 'No worktree path set on instance -- cannot evaluate gates.',
+        };
+    }
+    // Start with blueprint-enabled gates, then intersect with execution profile.
+    const blueprintGates = new Set(blueprint.gatesEnabled);
+    const profile = resolveExecutionProfile(instanceState.specType ?? null, blueprint);
+    const profileGates = new Set(Object.entries(profile.gatesEnabled)
+        .filter(([, enabled]) => enabled)
+        .map(([name]) => name));
+    const enabledGates = new Set([...blueprintGates].filter((g) => profileGates.has(g)));
+    const skipped = [...blueprintGates].filter((g) => !profileGates.has(g));
+    if (skipped.length > 0) {
+        console.log(`[gate-engine] Spec type "${instanceState.specType}" profile disables gates: [${skipped.join(', ')}]`);
+    }
+    const layers = [];
+    console.log(`[gate-engine] Evaluating gates for ${label} ` +
+        `(iteration ${ctx.iteration}, enabled: [${[...enabledGates].join(', ')}])`);
+    // Layer 1: Deterministic
+    if (enabledGates.has('deterministic')) {
+        const layerResult = await runLayer('deterministic', () => runDeterministicGates(worktreePath, blueprint.deterministicConfig, blueprint.traceChecks), ctx);
+        layers.push(layerResult);
+        if (!layerResult.passed)
+            return buildResult(false, layers);
+    }
+    // Layer 2: Behavioral
+    if (enabledGates.has('behavioral')) {
+        const layerResult = await runLayer('behavioral', () => runBehavioralGates(worktreePath, blueprint.behavioralConfig), ctx);
+        layers.push(layerResult);
+        if (!layerResult.passed)
+            return buildResult(false, layers);
+    }
+    // Layer 3: Adversarial
+    if (enabledGates.has('adversarial')) {
+        const layerResult = await runLayer('adversarial', () => runAdversarialGates(worktreePath, specification, blueprint.adversarialConfig, instanceState.instanceId, config.claudeCodePath, governor), ctx);
+        layers.push(layerResult);
+        if (!layerResult.passed)
+            return buildResult(false, layers);
+    }
+    if (layers.length === 0) {
+        console.log('[gate-engine] No gates enabled -- auto-passing');
+    }
+    return buildResult(true, layers);
+}
+// ============================================================================
+// Layer runner
+// ============================================================================
+/**
+ * Run a single gate layer and record results to the database.
+ */
+async function runLayer(gateType, runner, ctx) {
+    const startTime = Date.now();
+    console.log(`[gate-engine] Running ${gateType} gates...`);
+    try {
+        const { passed, results } = await runner();
+        const durationMs = Date.now() - startTime;
+        // Record each check result to the database
+        for (const check of results) {
+            try {
+                await createGateResult({
+                    strategyId: ctx.strategyId,
+                    instanceId: ctx.instanceId,
+                    gateType,
+                    iteration: ctx.iteration,
+                    passed: check.passed,
+                    checkName: check.checkName,
+                    output: check.output,
+                    durationMs: check.durationMs,
+                    isAdversaryGenerated: check.isAdversaryGenerated,
+                });
+            }
+            catch (err) {
+                console.warn(`[gate-engine] Failed to record gate result for ${check.checkName}:`, err.message);
+            }
+        }
+        console.log(`[gate-engine] ${gateType} gates ${passed ? 'PASSED' : 'FAILED'} ` +
+            `(${results.length} check(s), ${durationMs}ms)`);
+        return { gateType, passed, results, durationMs };
+    }
+    catch (err) {
+        const durationMs = Date.now() - startTime;
+        const errorResult = {
+            checkName: `${gateType}-error`,
+            passed: false,
+            output: `Gate layer threw an error: ${err.message}`,
+            durationMs,
+            isAdversaryGenerated: false,
+        };
+        try {
+            await createGateResult({
+                strategyId: ctx.strategyId,
+                instanceId: ctx.instanceId,
+                gateType,
+                iteration: ctx.iteration,
+                passed: false,
+                checkName: errorResult.checkName,
+                output: errorResult.output,
+                durationMs,
+            });
+        }
+        catch {
+            // Best effort
+        }
+        console.error(`[gate-engine] ${gateType} gates ERROR: ${err.message} (${durationMs}ms)`);
+        return { gateType, passed: false, results: [errorResult], durationMs };
+    }
+}
+// ============================================================================
+// Result builder
+// ============================================================================
+/**
+ * Build the final evaluation result with optional failure feedback.
+ */
+function buildResult(passed, layers) {
+    if (passed) {
+        return { passed: true, layers, failureFeedback: null };
+    }
+    // Format failure feedback for the builder
+    const feedback = formatFailureFeedback(layers);
+    return { passed: false, layers, failureFeedback: feedback };
+}
+/**
+ * Format gate failure output into structured feedback for the builder session.
+ *
+ * The builder receives this as context for its next iteration attempt.
+ * Format: markdown-like sections with check names, pass/fail status,
+ * and relevant output.
+ */
+function formatFailureFeedback(layers) {
+    const sections = [];
+    for (const layer of layers) {
+        if (layer.passed) {
+            sections.push(`## ${layer.gateType} gates: PASSED`);
+            continue;
+        }
+        sections.push(`## ${layer.gateType} gates: FAILED`);
+        for (const check of layer.results) {
+            const status = check.passed ? 'PASS' : 'FAIL';
+            sections.push(`### [${status}] ${check.checkName}`);
+            if (!check.passed && check.output) {
+                // Include failure output, truncated if very long
+                const output = check.output.length > 5000
+                    ? '...[truncated]...\n' + check.output.slice(-5000)
+                    : check.output;
+                sections.push('```');
+                sections.push(output);
+                sections.push('```');
+            }
+        }
+    }
+    return sections.join('\n');
+}
+//# sourceMappingURL=gate-engine.js.map

package/dist/gate-engine.js.map

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

package/dist/gates/adversarial.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Adversarial gate evaluation.
+ *
+ * Spawns a separate Claude Code session (the "adversary") that tries to
+ * break the builder's implementation by writing Playwright tests. Tests
+ * accumulate in an external directory OUTSIDE the worktree so builder
+ * agents never see adversary-generated test files.
+ *
+ * External test directory: `{worktreePath}-adversary/` (sibling to the
+ * factory worktree). This directory is created on first adversary run
+ * and cleaned up when the instance completes.
+ *
+ * The adversary prompt contains ONLY:
+ *   1. The factory specification text
+ *   2. The current source file contents from the worktree
+ *
+ * Builder reasoning, logs, and stream.jsonl are NEVER included.
+ *
+ * After each adversary session, ALL accumulated adversary tests are run
+ * (not just the new ones). Results are marked with isAdversaryGenerated=true.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import type { AdversarialGateConfig, GateCheckResult } from '../types.js';
+/**
+ * Derive the external adversary test directory path from a worktree path.
+ *
+ * Returns `{worktreePath}-adversary/` -- a sibling directory that lives
+ * outside the git worktree so builder agents never see adversary tests.
+ */
+export declare function getAdversaryTestDir(worktreePath: string): string;
+/**
+ * Remove the external adversary test directory for a completed instance.
+ *
+ * Safe to call even if the directory does not exist. Callers should invoke
+ * this alongside worktree removal when an instance reaches a terminal state.
+ */
+export declare function cleanupAdversaryTestDir(worktreePath: string): void;
+/**
+ * Run adversarial gates for a work unit's implementation.
+ *
+ * Spawns up to `config.maxSessions` adversary Claude Code sessions, each
+ * writing Playwright tests to an external directory outside the worktree.
+ * After all sessions complete, runs ALL accumulated adversary tests and
+ * returns the results.
+ *
+ * Each adversary session is tracked with session_type='adversary'.
+ *
+ * @param worktreePath    Absolute path to the factory worktree.
+ * @param specification   The factory specification text.
+ * @param config          Adversarial gate config from the blueprint (nullable).
+ * @param instanceId      Factory instance ID (for session tracking).
+ * @param claudeCodePath  Path to the Claude Code CLI executable.
+ * @returns               Overall pass/fail and individual check results.
+ */
+export declare function runAdversarialGates(worktreePath: string, specification: string, config: AdversarialGateConfig | null, instanceId: string, claudeCodePath: string, governor?: ResourceGovernor | null): Promise<{
+    passed: boolean;
+    results: GateCheckResult[];
+}>;
+//# sourceMappingURL=adversarial.d.ts.map

package/dist/gates/adversarial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adversarial.d.ts","sourceRoot":"","sources":["../../src/gates/adversarial.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgC1E;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAalE;AAiTD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,qBAAqB,GAAG,IAAI,EACpC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CAgJ1D"}