@telora/factory 0.4.5

package/dist/instance-completion.js

@@ -0,0 +1,366 @@
+/**
+ * Factory instance completion detection and gap evaluation.
+ *
+ * Handles the checkInstanceCompletion flow (strategy-level terminal detection,
+ * pipeline advance logic) and the runCompletionSequence flow (completion gate,
+ * report generation, finalization).
+ *
+ * Imports from instance-state-machine (leaf) but NOT from instance-poll-loop
+ * or instance-phase-dispatch, so no circular dependencies.
+ */
+import { updateInstanceStatus } from './queries/instances.js';
+import { getInstanceWorkUnits } from './queries/work-units.js';
+import { deleteExecutionUnitsByInstance } from './queries/execution-units.js';
+import { createCycleEvaluation } from './queries/cycle-evaluations.js';
+import { createFactoryEscalation } from './queries/escalations.js';
+import { updateSpecCompletionSummary } from './queries/specs.js';
+import { terminateAllUnits } from './unit-session.js';
+import { detectCompletion } from './completion.js';
+import { runCompletionGate } from './completion-gate.js';
+import { generateCompletionReport } from './completion-report.js';
+import { runReplanningPhase } from './replanning.js';
+import { releaseUnitForStrategy } from './scheduler.js';
+import { updateStrategyExecutionStatus } from './queries/strategies.js';
+import { escalateOrFail, TRIGGER_RESOURCE_LIMIT_EXCEEDED, } from './escalation.js';
+import { advancePipeline, usesPipeline, getNodeLabel } from './pipeline-traversal.js';
+import { collectMetrics } from './pipeline-metrics.js';
+import { transitionInstanceStatus, handleInstanceFailure } from './instance-state-machine.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Safety ceiling for instance iterations when blueprint has no limit configured. */
+const DEFAULT_MAX_INSTANCE_ITERATIONS = 10;
+// ============================================================================
+// Strategy completion detection
+// ============================================================================
+/**
+ * Detect strategies where all work units have reached a terminal state.
+ *
+ * For each in_progress or gate_fix_pending strategy, if all its work units
+ * are completed or failed, transition the strategy to the appropriate next state.
+ */
+export async function detectStrategyCompletion(state) {
+    let strategies;
+    try {
+        const { getStrategiesByFactoryInstance } = await import('./strategy-design.js');
+        strategies = await getStrategiesByFactoryInstance(state.instanceId);
+    }
+    catch {
+        return;
+    }
+    if (strategies.length === 0)
+        return;
+    const workUnits = await getInstanceWorkUnits(state.instanceId);
+    const unitsByStrategy = new Map();
+    for (const unit of workUnits) {
+        // Infrastructure-owned units are resolved by the engine, not agents --
+        // exclude them from strategy completion detection.
+        if (unit.strategyId && !unit.infrastructureOwned) {
+            const list = unitsByStrategy.get(unit.strategyId);
+            if (list)
+                list.push(unit);
+            else
+                unitsByStrategy.set(unit.strategyId, [unit]);
+        }
+    }
+    for (const strategy of strategies) {
+        if (strategy.executionStatus !== 'in_progress' && strategy.executionStatus !== 'gate_fix_pending')
+            continue;
+        const strategyUnits = unitsByStrategy.get(strategy.id);
+        if (!strategyUnits || strategyUnits.length === 0)
+            continue;
+        const allTerminal = strategyUnits.every((u) => u.status === 'completed' || u.status === 'failed');
+        if (!allTerminal)
+            continue;
+        const failedUnits = strategyUnits.filter((u) => u.status === 'failed');
+        try {
+            if (failedUnits.length > 0) {
+                await updateStrategyExecutionStatus(strategy.id, 'failed', { gateFixStartedAt: null });
+                console.log(`[factory] Strategy "${strategy.name}" -> failed ` +
+                    `(${failedUnits.length}/${strategyUnits.length} work units failed)`);
+                // Release the execution unit back to idle
+                try {
+                    await releaseUnitForStrategy(state, strategy.id);
+                }
+                catch {
+                    // Best effort
+                }
+            }
+            else {
+                const isReEvaluation = strategy.executionStatus === 'gate_fix_pending';
+                // Clear gate_fix_started_at when leaving gate_fix_pending
+                await updateStrategyExecutionStatus(strategy.id, 'gating_deterministic', {
+                    gateFixStartedAt: null,
+                });
+                console.log(`[factory] Strategy "${strategy.name}" -> gating_deterministic ` +
+                    (isReEvaluation
+                        ? `(re-evaluation after gate fix)`
+                        : `(${strategyUnits.length}/${strategyUnits.length} work units done, gates pending)`));
+            }
+        }
+        catch (err) {
+            console.warn(`[factory] Failed to update strategy ${strategy.id} status:`, err.message);
+        }
+    }
+}
+// ============================================================================
+// Instance completion check
+// ============================================================================
+/**
+ * Check whether the instance has completed (all strategies terminal).
+ *
+ * If all strategies are completed or failed, finalize the instance.
+ * Uses strategy-level completion (not work-unit level) for DAG-aware instances.
+ *
+ * The `runDesigningFn` and `runPlanningFn` callbacks allow the poll loop
+ * to inject the phase dispatch functions without creating a circular import.
+ */
+export async function checkInstanceCompletion(state, config, runDesigningFn, runPlanningFn) {
+    if (!config)
+        return;
+    if (state.status !== 'building')
+        return;
+    let strategies;
+    try {
+        const { getStrategiesByFactoryInstance } = await import('./strategy-design.js');
+        strategies = await getStrategiesByFactoryInstance(state.instanceId);
+    }
+    catch {
+        return;
+    }
+    if (strategies.length === 0)
+        return;
+    const allTerminal = strategies.every((s) => s.executionStatus === 'completed' || s.executionStatus === 'failed');
+    if (!allTerminal)
+        return;
+    const failedStrategies = strategies.filter((s) => s.executionStatus === 'failed');
+    // When all strategies succeeded and the instance uses a pipeline graph,
+    // attempt to advance to the next pipeline node instead of completing.
+    if (failedStrategies.length === 0 && usesPipeline(state)) {
+        const handled = await handlePipelineAdvance(state, runDesigningFn, runPlanningFn);
+        if (handled)
+            return;
+    }
+    // Terminate any still-running units
+    terminateAllUnits(state);
+    if (failedStrategies.length > 0) {
+        console.log(`[factory] All strategies terminal. ${failedStrategies.length} failed -- marking instance failed.`);
+        state.status = 'failed';
+    }
+    else {
+        console.log(`[factory] All strategies completed -- marking instance completed.`);
+        state.status = 'completed';
+    }
+    // Completion gate + report + workflow transition
+    if (state.status === 'completed') {
+        await runCompletionSequence(state, config);
+    }
+    else {
+        await transitionInstanceStatus(state, 'failed', 'All strategies failed or no progress possible');
+    }
+}
+/**
+ * Handle pipeline node advancement after all strategies complete successfully.
+ *
+ * Returns true if the pipeline was advanced (or paused/escalated), meaning the
+ * caller should return early. Returns false to fall through to normal completion.
+ */
+async function handlePipelineAdvance(state, runDesigningFn, runPlanningFn) {
+    const workUnits = await getInstanceWorkUnits(state.instanceId);
+    const completedUnits = workUnits.filter((u) => u.status === 'completed');
+    const wallClockMs = state.startedAt ? Date.now() - state.startedAt.getTime() : 0;
+    const metrics = collectMetrics({
+        cycleCount: state.completionGateIterations,
+        deliveryCompletionPct: workUnits.length > 0
+            ? (completedUnits.length / workUnits.length) * 100
+            : 0,
+        wallClockMinutes: wallClockMs / 60_000,
+    });
+    const advanceResult = advancePipeline(state, metrics);
+    switch (advanceResult.outcome) {
+        case 'advanced':
+            return handlePipelineNodeTransition(state, advanceResult.nextNodeId, runDesigningFn, runPlanningFn);
+        case 'completed':
+            console.log(`[factory] Pipeline completed at terminal node for instance ${state.instanceId}`);
+            return false;
+        case 'no_match': {
+            terminateAllUnits(state);
+            const nodeLabel = getNodeLabel(state.pipelineGraph, state.currentPipelineNodeId);
+            console.warn(`[factory] Pipeline stuck: no edge conditions matched at node "${nodeLabel}" ` +
+                `for instance ${state.instanceId}. Escalating.`);
+            await createFactoryEscalation(state.instanceId, `Pipeline stuck at node "${nodeLabel}": no outgoing edge conditions matched`, `Review pipeline edge conditions for node "${nodeLabel}" and either ` +
+                `add a fallback edge or manually advance the instance.`);
+            state.status = 'paused';
+            await updateInstanceStatus(state.instanceId, 'paused');
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+/**
+ * Transition the instance to a new pipeline node after the pipeline evaluator
+ * determined the next node. Resets execution state and kicks off the
+ * appropriate phase (designing or planning based on node template type).
+ *
+ * Returns true (caller should return early) unless the next node is terminal.
+ */
+async function handlePipelineNodeTransition(state, nextNodeId, runDesigningFn, runPlanningFn) {
+    const nextNodeTemplateType = state.pipelineGraph.nodes.find((n) => n.id === nextNodeId)?.templateType;
+    // Terminal nodes are stop signals -- fall through to normal completion.
+    if (nextNodeTemplateType === 'terminal') {
+        const nodeLabel = getNodeLabel(state.pipelineGraph, nextNodeId);
+        console.log(`[factory] Pipeline advanced to terminal node "${nodeLabel}" -- ` +
+            `completing instance ${state.instanceId}`);
+        return false;
+    }
+    // Reset execution state for the new pipeline node
+    terminateAllUnits(state);
+    await deleteExecutionUnitsByInstance(state.instanceId);
+    state.currentPipelineNodeId = nextNodeId;
+    state.executionUnits.clear();
+    state.completionGateIterations = 0;
+    const nodeLabel = getNodeLabel(state.pipelineGraph, nextNodeId);
+    // Engineering nodes skip strategy redesign -- go directly to planning.
+    if (nextNodeTemplateType === 'engineering') {
+        state.status = 'planning';
+        await updateInstanceStatus(state.instanceId, 'planning', {
+            currentPipelineNodeId: nextNodeId,
+        });
+        console.log(`[factory] Pipeline advanced to engineering node "${nodeLabel}" (${nextNodeId}) ` +
+            `-- skipping design, starting planning for instance ${state.instanceId}`);
+        runPlanningFn(state).catch((error) => {
+            console.error(`[factory] Planning failed for pipeline node "${nextNodeId}" ` +
+                `on instance ${state.instanceId}:`, error.message);
+            handleInstanceFailure(state, `Planning failed for pipeline node: ${error.message}`);
+        });
+    }
+    else {
+        state.status = 'designing';
+        await updateInstanceStatus(state.instanceId, 'designing', {
+            currentPipelineNodeId: nextNodeId,
+        });
+        console.log(`[factory] Pipeline advanced to node "${nodeLabel}" (${nextNodeId}) ` +
+            `for instance ${state.instanceId}`);
+        runDesigningFn(state).catch((error) => {
+            console.error(`[factory] Designing failed for pipeline node "${nextNodeId}" ` +
+                `on instance ${state.instanceId}:`, error.message);
+            handleInstanceFailure(state, `Designing failed for pipeline node: ${error.message}`);
+        });
+    }
+    return true;
+}
+// ============================================================================
+// Completion sequence
+// ============================================================================
+/**
+ * Run the completion sequence: completion gate, report, workflow transition.
+ */
+export async function runCompletionSequence(state, config, governor) {
+    if (!config)
+        return;
+    // Skip completion gate entirely when disabled -- proceed directly to completion
+    if (!state.blueprint.completionGateEnabled) {
+        console.log(`[factory] Completion gate disabled on blueprint -- skipping AI review, proceeding to completion`);
+    }
+    else {
+        const maxIterations = state.blueprint.maxInstanceIterations ?? DEFAULT_MAX_INSTANCE_ITERATIONS;
+        if (state.completionGateIterations < maxIterations) {
+            try {
+                const workUnits = await getInstanceWorkUnits(state.instanceId);
+                const gateResult = await runCompletionGate(state, config, workUnits, governor ?? null);
+                if (gateResult) {
+                    try {
+                        await createCycleEvaluation(state.instanceId, state.completionGateIterations + 1, gateResult);
+                    }
+                    catch (persistErr) {
+                        console.warn(`[factory] Failed to persist cycle evaluation (non-fatal): ` +
+                            `${persistErr instanceof Error ? persistErr.message : String(persistErr)}`);
+                    }
+                }
+                if (gateResult && !gateResult.passed && gateResult.gaps.some((g) => g.severity === 'critical')) {
+                    const replanResult = await runReplanningPhase(state, config, governor ?? null);
+                    if (replanResult.success && replanResult.workUnitsCreated > 0) {
+                        state.completionGateIterations++;
+                        state.status = 'building';
+                        await updateInstanceStatus(state.instanceId, 'building', {
+                            completion_gate_iterations: state.completionGateIterations,
+                        });
+                        console.log(`[factory] Re-planning cycle ${state.completionGateIterations}: ` +
+                            `${replanResult.workUnitsCreated} work unit(s) created from fresh context ` +
+                            `(iteration ${state.completionGateIterations}/${maxIterations})`);
+                        return;
+                    }
+                    if (!replanResult.success) {
+                        const failReason = `Re-planning failed after completion gate found critical gaps: ${replanResult.error ?? 'unknown'}`;
+                        await escalateOrFail(state, TRIGGER_RESOURCE_LIMIT_EXCEEDED, 'replanning_failed', failReason, () => transitionInstanceStatus(state, 'failed', `Re-planning failed: ${replanResult.error ?? 'unknown'}`));
+                        return;
+                    }
+                    const noWorkReason = 'Re-planning succeeded but produced no work units despite critical gaps. ' +
+                        'The planner could not determine what additional work is needed.';
+                    await escalateOrFail(state, TRIGGER_RESOURCE_LIMIT_EXCEEDED, 'replanning_no_work_units', noWorkReason, () => transitionInstanceStatus(state, 'failed', noWorkReason));
+                    return;
+                }
+                state.completionGateIterations++;
+                await updateInstanceStatus(state.instanceId, 'building', {
+                    completion_gate_iterations: state.completionGateIterations,
+                });
+            }
+            catch (err) {
+                console.warn(`[factory] Completion gate error (non-fatal): ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        else if (state.completionGateIterations >= maxIterations) {
+            console.log(`[factory] Completion gate iteration limit reached (${maxIterations}) -- proceeding to completion`);
+        }
+    }
+    // Generate completion report
+    if (state.completionReport) {
+        console.log('[factory] Completion report already exists -- skipping regeneration');
+    }
+    else {
+        try {
+            const report = await generateCompletionReport(state, config, governor ?? null);
+            if (report) {
+                await updateInstanceStatus(state.instanceId, state.status, {
+                    completionReport: report,
+                });
+                state.completionReport = report;
+                console.log(`[factory] Completion report generated: ${report.keep.length} keep, ` +
+                    `${report.stop.length} stop, ${report.change.length} change items. ` +
+                    `Spec quality: ${report.specQualityAssessment.overallScore}. ` +
+                    `Strategy design: ${report.strategyDesignAssessment.overallScore}.`);
+                if (state.specId) {
+                    const summary = {
+                        specQualityOverallScore: report.specQualityAssessment.overallScore,
+                        specQualityGaps: report.specQualityAssessment.gaps,
+                        strategyDesignOverallScore: report.strategyDesignAssessment.overallScore,
+                        changeItems: report.change,
+                        keepItems: report.keep,
+                        stopItems: report.stop,
+                        executionMetrics: report.executionMetrics,
+                        completedAt: new Date().toISOString(),
+                        instanceId: state.instanceId,
+                    };
+                    updateSpecCompletionSummary(state.specId, summary).catch((cbErr) => {
+                        console.warn(`[factory] Spec completion callback failed (non-fatal): ` +
+                            `${cbErr instanceof Error ? cbErr.message : String(cbErr)}`);
+                    });
+                }
+            }
+            else {
+                console.warn('[factory] Completion report generation returned null -- proceeding without report');
+            }
+        }
+        catch (reportErr) {
+            console.warn(`[factory] Completion report error (non-fatal): ${reportErr instanceof Error ? reportErr.message : String(reportErr)}`);
+        }
+    }
+    // Finalize
+    await transitionInstanceStatus(state, 'completed');
+    const completion = await detectCompletion(state.instanceId, config);
+    if (!completion.isComplete) {
+        state.status = 'building';
+    }
+}
+//# sourceMappingURL=instance-completion.js.map

package/dist/instance-completion.js.map

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

package/dist/instance-lifecycle.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Factory instance lifecycle -- barrel re-export.
+ *
+ * The implementation has been split into focused modules:
+ *   - instance-poll-loop.ts    -- poll loop, instance discovery, active tracking
+ *   - instance-phase-dispatch.ts -- phase handlers (designing, planning, building, gating)
+ *   - instance-state-machine.ts  -- workflow transitions, pause/resume, error handling
+ *   - instance-completion.ts     -- strategy/instance completion, gate evaluation, reports
+ *
+ * This file preserves the original import path for consumers (index.ts, factory-engine.ts).
+ */
+export { startPollLoop, stopPollLoop, getActiveInstances, setShuttingDown, setFactoryGovernor, } from './instance-poll-loop.js';
+export { handleInstanceFailure } from './instance-state-machine.js';
+export { checkGateFixTimeouts } from './instance-phase-dispatch.js';
+//# sourceMappingURL=instance-lifecycle.d.ts.map

package/dist/instance-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-lifecycle.d.ts","sourceRoot":"","sources":["../src/instance-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/instance-lifecycle.js

@@ -0,0 +1,18 @@
+/**
+ * Factory instance lifecycle -- barrel re-export.
+ *
+ * The implementation has been split into focused modules:
+ *   - instance-poll-loop.ts    -- poll loop, instance discovery, active tracking
+ *   - instance-phase-dispatch.ts -- phase handlers (designing, planning, building, gating)
+ *   - instance-state-machine.ts  -- workflow transitions, pause/resume, error handling
+ *   - instance-completion.ts     -- strategy/instance completion, gate evaluation, reports
+ *
+ * This file preserves the original import path for consumers (index.ts, factory-engine.ts).
+ */
+// Poll loop controls
+export { startPollLoop, stopPollLoop, getActiveInstances, setShuttingDown, setFactoryGovernor, } from './instance-poll-loop.js';
+// Error handling
+export { handleInstanceFailure } from './instance-state-machine.js';
+// Phase dispatch (checkGateFixTimeouts is consumed by factory-engine)
+export { checkGateFixTimeouts } from './instance-phase-dispatch.js';
+//# sourceMappingURL=instance-lifecycle.js.map

package/dist/instance-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-lifecycle.js","sourceRoot":"","sources":["../src/instance-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qBAAqB;AACrB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,iBAAiB;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,sEAAsE;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/instance-phase-dispatch.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Factory instance phase dispatch -- orchestrates designing, planning,
+ * building, and review phases.
+ *
+ * Contains the phase handler functions that drive instances through
+ * their lifecycle stages. Imports from instance-state-machine (leaf)
+ * and instance-completion, but NOT from instance-poll-loop.
+ */
+import type { ResourceGovernor } from '@telora/daemon-core';
+import type { FactoryConfig, FactoryInstanceState } from './types.js';
+/**
+ * Set the module-level config for phase dispatch functions.
+ * Called by the poll loop when starting.
+ */
+export declare function setPhaseDispatchConfig(factoryConfig: FactoryConfig): void;
+/**
+ * Set the module-level governor for phase dispatch functions.
+ * Called by the poll loop when the governor is set.
+ */
+export declare function setPhaseDispatchGovernor(gov: ResourceGovernor): void;
+export declare function getCurrentNodeTemplateType(state: FactoryInstanceState): string | null;
+/**
+ * Run the designing phase for an instance.
+ *
+ * Creates a git worktree, spawns Claude Code to decompose the specification
+ * into bounded strategies, validates and persists them, then transitions
+ * to "planning".
+ */
+export declare function runDesigning(state: FactoryInstanceState): Promise<void>;
+/**
+ * Execute the Review pipeline node.
+ *
+ * Review nodes skip the full design/plan/build cycle. Instead they:
+ * 1. Run the completion gate against all work produced so far
+ * 2. Use gap counts to populate pipeline edge metrics
+ * 3. Advance the pipeline (back to Engineering if gaps, to Done if clean)
+ * 4. Store gap details in state.reviewGaps so the next Engineering cycle
+ *    can constrain its scope to closing those gaps only
+ */
+export declare function runReviewGateAndAdvance(state: FactoryInstanceState): Promise<void>;
+/**
+ * Run the planning phase for an instance.
+ *
+ * Creates a git worktree, spawns Claude Code to generate a work plan,
+ * validates and persists work units, then transitions to "building".
+ */
+export declare function runPlanning(state: FactoryInstanceState): Promise<void>;
+/**
+ * Check on an instance in the building phase.
+ *
+ * Runs resource limit checks, the DAG-aware scheduler to assign strategies
+ * to execution units, spawns sessions for newly assigned units, monitors
+ * running unit health, evaluates strategy-level gates, and checks for
+ * instance completion.
+ */
+export declare function checkBuilding(state: FactoryInstanceState): Promise<void>;
+/**
+ * Log a compact cycle summary showing execution unit and strategy states.
+ */
+export declare function logCycleSummary(state: FactoryInstanceState): void;
+/**
+ * Check for strategies stuck in gate_fix_pending past their timeout.
+ *
+ * For each gate_fix_pending strategy with a configured gate_fix_timeout_ms,
+ * checks whether gate_fix_started_at + timeout has elapsed. On timeout,
+ * transitions the strategy to failed, creates an escalation, and terminates
+ * the unit session.
+ *
+ * Also warns about orphaned gate_fix_pending strategies that have no live
+ * unit session (the scheduler may reassign, so we don't auto-fail).
+ */
+/** @internal Exported for testing. */
+export declare function checkGateFixTimeouts(state: FactoryInstanceState): Promise<void>;
+export { recoverResumedInstance } from './instance-state-machine.js';
+//# sourceMappingURL=instance-phase-dispatch.d.ts.map

package/dist/instance-phase-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-phase-dispatch.d.ts","sourceRoot":"","sources":["../src/instance-phase-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EAErB,MAAM,YAAY,CAAC;AA4CpB;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAEzE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAEpE;AAMD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,CAIrF;AAMD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG7E;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4KxF;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C5E;AA6ID;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuG9E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAiBjE;AAuED;;;;;;;;;;GAUG;AACH,sCAAsC;AACtC,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyErF;AAMD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}