@icex-labs/icex-flow 0.3.0

package/dist/src/engine/environment.js

@@ -0,0 +1,399 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { homedir } from 'node:os';
+// ── Helpers ──────────────────────────────────────────────────────────
+function isProdName(name) {
+    const lower = name.toLowerCase();
+    return /\bprod(uction)?\b/.test(lower) || lower === 'prd' || lower === 'live';
+}
+function envNameFromSuffix(filename) {
+    // .env.production -> production, .env.dev -> dev
+    const m = filename.match(/\.env\.(.+)$/);
+    if (m)
+        return m[1];
+    return 'default';
+}
+function readFileSafe(path) {
+    try {
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+// ── Scanners ─────────────────────────────────────────────────────────
+function scanKubeConfig() {
+    const envs = [];
+    const kubeconfigPath = process.env['KUBECONFIG'] || join(homedir(), '.kube', 'config');
+    const content = readFileSafe(kubeconfigPath);
+    if (!content)
+        return envs;
+    // Parse YAML-like kubeconfig (simple regex extraction, no YAML parser dep)
+    // Extract contexts
+    const contextBlocks = content.split(/^- context:/gm);
+    const nameMatches = content.matchAll(/^- name:\s*(.+)$/gm);
+    // Simpler approach: extract context names
+    const contextNames = [];
+    for (const m of nameMatches) {
+        contextNames.push(m[1].trim());
+    }
+    // Extract clusters and namespaces per context
+    // Pattern: "- context:\n    cluster: <cluster>\n    namespace: <ns>\n    user: <user>\n  name: <name>"
+    const contextRegex = /-\s*context:\s*\n\s*cluster:\s*(.+)\n(?:\s*namespace:\s*(.+)\n)?\s*(?:user:\s*.+\n)?\s*name:\s*(.+)/gm;
+    let match;
+    while ((match = contextRegex.exec(content)) !== null) {
+        const cluster = match[1].trim();
+        const namespace = match[2]?.trim() || undefined;
+        const name = match[3].trim();
+        envs.push({
+            name,
+            type: 'kubernetes',
+            endpoint: cluster,
+            namespace,
+            isProduction: isProdName(name) || isProdName(cluster),
+        });
+    }
+    // If regex didn't match (different YAML formatting), fall back to simpler extraction
+    if (envs.length === 0 && contextNames.length > 0) {
+        for (const name of contextNames) {
+            // Skip entries that look like cluster/user definitions rather than contexts
+            envs.push({
+                name,
+                type: 'kubernetes',
+                isProduction: isProdName(name),
+            });
+        }
+        // Deduplicate: only keep unique context names (the contexts: section names)
+        // In kubeconfig, names appear under contexts, clusters, and users sections
+        // We try to identify context-specific ones
+    }
+    return envs;
+}
+function scanDockerCompose(dir) {
+    const envs = [];
+    const composeFiles = ['docker-compose.yml', 'docker-compose.yaml', 'docker-compose.dev.yml',
+        'docker-compose.dev.yaml', 'docker-compose.prod.yml', 'docker-compose.prod.yaml',
+        'docker-compose.staging.yml', 'docker-compose.staging.yaml',
+        'docker-compose.override.yml', 'docker-compose.override.yaml',
+        'compose.yml', 'compose.yaml'];
+    for (const file of composeFiles) {
+        const filePath = join(dir, file);
+        const content = readFileSafe(filePath);
+        if (!content)
+            continue;
+        // Extract environment name from filename
+        const envMatch = file.match(/docker-compose\.(\w+)\.(yml|yaml)$/) || file.match(/compose\.(\w+)\.(yml|yaml)$/);
+        const envName = envMatch ? envMatch[1] : 'local';
+        // Extract services
+        const services = [];
+        const ports = [];
+        const volumes = [];
+        // Simple YAML parsing: find services section and extract top-level keys
+        const lines = content.split('\n');
+        let inServices = false;
+        let indent = 0;
+        for (const line of lines) {
+            if (/^services:\s*$/.test(line)) {
+                inServices = true;
+                continue;
+            }
+            if (inServices) {
+                // Top-level service key (2-space or 4-space indent)
+                const svcMatch = line.match(/^(\s{2}|\s{4})(\w[\w-]*):\s*$/);
+                if (svcMatch && !line.startsWith('    ')) {
+                    services.push(svcMatch[2]);
+                }
+                else if (/^\S/.test(line) && line.trim() !== '') {
+                    inServices = false;
+                }
+            }
+            // Extract ports
+            const portMatch = line.match(/["']?(\d+:\d+)["']?/);
+            if (portMatch)
+                ports.push(portMatch[1]);
+            // Extract volumes
+            const volMatch = line.match(/-\s*["']?([./\w-]+:[./\w-]+)["']?/);
+            if (volMatch)
+                volumes.push(volMatch[1]);
+        }
+        envs.push({
+            name: envName === 'override' ? 'local' : envName,
+            type: 'docker-compose',
+            isProduction: isProdName(envName),
+            details: {
+                file,
+                services,
+                ports,
+                volumes,
+            },
+        });
+    }
+    return envs;
+}
+function scanEnvFiles(dir) {
+    const envs = [];
+    try {
+        const files = readdirSync(dir);
+        for (const file of files) {
+            if (file === '.env' || /^\.env\.\w+$/.test(file)) {
+                const envName = file === '.env' ? 'default' : envNameFromSuffix(file);
+                // Don't add if it's just '.env.example' or '.env.template'
+                if (envName === 'example' || envName === 'template' || envName === 'sample')
+                    continue;
+                envs.push({
+                    name: envName,
+                    type: 'env-file',
+                    isProduction: isProdName(envName),
+                    details: { file },
+                });
+            }
+        }
+    }
+    catch {
+        // Directory not readable
+    }
+    return envs;
+}
+function scanContainerFiles(dir) {
+    const envs = [];
+    const containerFiles = ['Dockerfile', 'Containerfile'];
+    for (const file of containerFiles) {
+        if (existsSync(join(dir, file))) {
+            envs.push({
+                name: 'container',
+                type: 'container',
+                isProduction: false,
+                details: { file },
+            });
+            break; // Only add once
+        }
+    }
+    return envs;
+}
+function scanTerraform(dir) {
+    const envs = [];
+    const tfDir = join(dir, 'terraform');
+    const tfDirs = [tfDir, dir];
+    for (const d of tfDirs) {
+        try {
+            if (!existsSync(d))
+                continue;
+            const files = readdirSync(d);
+            const hasTf = files.some(f => f.endsWith('.tf'));
+            if (!hasTf)
+                continue;
+            // Check for environment-specific directories
+            const envDirs = files.filter(f => {
+                try {
+                    return statSync(join(d, f)).isDirectory() &&
+                        ['dev', 'staging', 'prod', 'production', 'test', 'uat'].includes(f.toLowerCase());
+                }
+                catch {
+                    return false;
+                }
+            });
+            if (envDirs.length > 0) {
+                for (const envDir of envDirs) {
+                    envs.push({
+                        name: envDir,
+                        type: 'terraform',
+                        isProduction: isProdName(envDir),
+                    });
+                }
+            }
+            else if (d === tfDir) {
+                envs.push({
+                    name: 'terraform',
+                    type: 'terraform',
+                    isProduction: false,
+                });
+            }
+            break;
+        }
+        catch { /* skip */ }
+    }
+    return envs;
+}
+function scanPulumi(dir) {
+    const envs = [];
+    if (existsSync(join(dir, 'Pulumi.yaml')) || existsSync(join(dir, 'Pulumi.yml'))) {
+        // Check for stack files: Pulumi.<stack>.yaml
+        try {
+            const files = readdirSync(dir);
+            const stacks = files
+                .filter(f => /^Pulumi\.\w+\.(yaml|yml)$/.test(f) && f !== 'Pulumi.yaml' && f !== 'Pulumi.yml')
+                .map(f => {
+                const m = f.match(/^Pulumi\.(\w+)\.(yaml|yml)$/);
+                return m ? m[1] : null;
+            })
+                .filter((s) => s !== null);
+            if (stacks.length > 0) {
+                for (const stack of stacks) {
+                    envs.push({
+                        name: stack,
+                        type: 'pulumi',
+                        isProduction: isProdName(stack),
+                    });
+                }
+            }
+            else {
+                envs.push({
+                    name: 'pulumi',
+                    type: 'pulumi',
+                    isProduction: false,
+                });
+            }
+        }
+        catch {
+            envs.push({
+                name: 'pulumi',
+                type: 'pulumi',
+                isProduction: false,
+            });
+        }
+    }
+    return envs;
+}
+function scanArgoCD(dir) {
+    const envs = [];
+    const argoDir = join(dir, 'argocd');
+    const appDir = join(dir, 'apps');
+    for (const d of [argoDir, appDir, dir]) {
+        try {
+            if (!existsSync(d))
+                continue;
+            const files = readdirSync(d);
+            for (const file of files) {
+                if (!file.endsWith('.yaml') && !file.endsWith('.yml'))
+                    continue;
+                const content = readFileSafe(join(d, file));
+                if (!content)
+                    continue;
+                if (content.includes('kind: Application') && content.includes('argoproj.io')) {
+                    const nameMatch = content.match(/^\s*name:\s*(.+)$/m);
+                    const nsMatch = content.match(/^\s*namespace:\s*(.+)$/m);
+                    const name = nameMatch ? nameMatch[1].trim() : basename(file, '.yaml').replace('.yml', '');
+                    envs.push({
+                        name,
+                        type: 'argocd',
+                        namespace: nsMatch ? nsMatch[1].trim() : undefined,
+                        isProduction: isProdName(name),
+                    });
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    return envs;
+}
+function scanFlux(dir) {
+    const envs = [];
+    const fluxDir = join(dir, 'flux-system');
+    const clusterDir = join(dir, 'clusters');
+    for (const d of [fluxDir, clusterDir, dir]) {
+        try {
+            if (!existsSync(d))
+                continue;
+            const files = readdirSync(d);
+            for (const file of files) {
+                if (!file.endsWith('.yaml') && !file.endsWith('.yml'))
+                    continue;
+                const content = readFileSafe(join(d, file));
+                if (!content)
+                    continue;
+                if (content.includes('fluxcd.io') || content.includes('toolkit.fluxcd.io')) {
+                    const nameMatch = content.match(/^\s*name:\s*(.+)$/m);
+                    const name = nameMatch ? nameMatch[1].trim() : basename(file).replace(/\.(yaml|yml)$/, '');
+                    envs.push({
+                        name,
+                        type: 'flux',
+                        isProduction: isProdName(name),
+                    });
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    return envs;
+}
+function scanHelmValues(dir) {
+    const envs = [];
+    const searchDirs = [dir, join(dir, 'helm'), join(dir, 'charts')];
+    for (const d of searchDirs) {
+        try {
+            if (!existsSync(d))
+                continue;
+            const files = readdirSync(d);
+            for (const file of files) {
+                const m = file.match(/^values[-.](\w+)\.(yaml|yml)$/);
+                if (m) {
+                    const envName = m[1];
+                    if (envName === 'schema' || envName === 'template')
+                        continue;
+                    envs.push({
+                        name: envName,
+                        type: 'helm',
+                        isProduction: isProdName(envName),
+                    });
+                }
+            }
+            // Also scan chart subdirectories
+            if (d !== dir)
+                continue;
+            const chartsDir = join(d, 'charts');
+            if (!existsSync(chartsDir))
+                continue;
+            const chartSubs = readdirSync(chartsDir).filter(f => {
+                try {
+                    return statSync(join(chartsDir, f)).isDirectory();
+                }
+                catch {
+                    return false;
+                }
+            });
+            for (const chart of chartSubs) {
+                const chartFiles = readdirSync(join(chartsDir, chart));
+                for (const file of chartFiles) {
+                    const cm = file.match(/^values[-.](\w+)\.(yaml|yml)$/);
+                    if (cm) {
+                        const envName = cm[1];
+                        if (envName === 'schema' || envName === 'template')
+                            continue;
+                        envs.push({
+                            name: `${chart}/${envName}`,
+                            type: 'helm',
+                            isProduction: isProdName(envName),
+                        });
+                    }
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    return envs;
+}
+// ── Main ─────────────────────────────────────────────────────────────
+export function discoverEnvironments(dir) {
+    const environments = [
+        ...scanKubeConfig(),
+        ...scanDockerCompose(dir),
+        ...scanEnvFiles(dir),
+        ...scanContainerFiles(dir),
+        ...scanTerraform(dir),
+        ...scanPulumi(dir),
+        ...scanArgoCD(dir),
+        ...scanFlux(dir),
+        ...scanHelmValues(dir),
+    ];
+    // Deduplicate by name+type
+    const seen = new Set();
+    const unique = environments.filter(e => {
+        const key = `${e.type}:${e.name}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    return { environments: unique };
+}
+//# sourceMappingURL=environment.js.map

package/dist/src/engine/environment.js.map

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

package/dist/src/engine/planner.d.ts

@@ -0,0 +1,12 @@
+import type { WorkflowDefinition, ExecutionPlan } from '../types.js';
+/**
+ * Generate a deterministic execution plan from a workflow definition + input variables.
+ *
+ * The plan is a fully-resolved, step-by-step sequence with all templates expanded.
+ * The LLM follows this plan mechanically — no freestyle decisions.
+ */
+export declare function planWorkflow(workflow: WorkflowDefinition, input: Record<string, string>): ExecutionPlan;
+/**
+ * Format an execution plan as human/agent-readable text output.
+ */
+export declare function formatPlan(plan: ExecutionPlan): string;

package/dist/src/engine/planner.js

@@ -0,0 +1,130 @@
+import { resolveTemplate } from '../utils.js';
+/**
+ * Generate a deterministic execution plan from a workflow definition + input variables.
+ *
+ * The plan is a fully-resolved, step-by-step sequence with all templates expanded.
+ * The LLM follows this plan mechanically — no freestyle decisions.
+ */
+export function planWorkflow(workflow, input) {
+    const vars = resolveInputs(workflow, input);
+    const steps = workflow.steps.map((step) => {
+        // Evaluate condition
+        if (step.condition) {
+            const resolved = resolveTemplate(step.condition, vars);
+            // Simple truthy check: skip if variable is empty or "false"
+            if (!resolved || resolved === 'false' || resolved === '{{' + step.condition.slice(2)) {
+                return {
+                    id: step.id,
+                    name: step.name,
+                    action: step.action,
+                    status: 'skipped',
+                };
+            }
+        }
+        return {
+            id: step.id,
+            name: step.name,
+            action: step.action,
+            resolved_command: step.command
+                ? resolveTemplate(step.command, vars)
+                : undefined,
+            resolved_input: step.input
+                ? resolveTemplate(step.input, vars)
+                : undefined,
+            timeout: step.timeout,
+            verify: step.verify
+                ? {
+                    command: resolveTemplate(step.verify.command, vars),
+                    expect: step.verify.expect
+                        ? resolveTemplate(step.verify.expect, vars)
+                        : undefined,
+                    expect_exit: step.verify.expect_exit,
+                }
+                : undefined,
+            status: 'pending',
+        };
+    });
+    return {
+        workflow: workflow.name,
+        steps,
+        context_files: workflow.context?.always ?? [],
+        variables: vars,
+    };
+}
+/**
+ * Format an execution plan as human/agent-readable text output.
+ */
+export function formatPlan(plan) {
+    const lines = [];
+    lines.push(`# Execution Plan: ${plan.workflow}`);
+    lines.push('');
+    lines.push(`Variables: ${JSON.stringify(plan.variables, null, 2)}`);
+    lines.push('');
+    if (plan.context_files.length) {
+        lines.push('## Context Files');
+        for (const f of plan.context_files) {
+            lines.push(`  - ${f}`);
+        }
+        lines.push('');
+    }
+    lines.push('## Steps');
+    lines.push('');
+    for (let i = 0; i < plan.steps.length; i++) {
+        const step = plan.steps[i];
+        const num = i + 1;
+        if (step.status === 'skipped') {
+            lines.push(`### Step ${num}: ${step.name} [SKIPPED]`);
+            lines.push('');
+            continue;
+        }
+        lines.push(`### Step ${num}: ${step.name}`);
+        lines.push(`- Action: ${step.action}`);
+        if (step.resolved_command) {
+            lines.push(`- Command: \`${step.resolved_command}\``);
+        }
+        if (step.resolved_input) {
+            lines.push(`- Input: ${step.resolved_input}`);
+        }
+        if (step.timeout) {
+            lines.push(`- Timeout: ${step.timeout}s`);
+        }
+        if (step.verify) {
+            lines.push(`- Verify: \`${step.verify.command}\``);
+            if (step.verify.expect) {
+                lines.push(`  - Expect output: "${step.verify.expect}"`);
+            }
+            if (step.verify.expect_exit !== undefined) {
+                lines.push(`  - Expect exit code: ${step.verify.expect_exit}`);
+            }
+        }
+        lines.push('');
+    }
+    lines.push('---');
+    lines.push('IMPORTANT: Execute steps in order. Do NOT skip steps. Run verification after each step. Stop on failure.');
+    return lines.join('\n');
+}
+function resolveInputs(workflow, input) {
+    const vars = {};
+    // Apply defaults from workflow definition
+    if (workflow.inputs) {
+        for (const [key, def] of Object.entries(workflow.inputs)) {
+            if (input[key] !== undefined) {
+                vars[key] = String(input[key]);
+            }
+            else if (def.default !== undefined) {
+                vars[key] = String(def.default);
+            }
+            else if (def.required) {
+                throw new Error(`Missing required input: ${key} (${def.description ?? 'no description'})`);
+            }
+        }
+    }
+    // Include any extra input vars not in the definition
+    for (const [key, val] of Object.entries(input)) {
+        if (!(key in vars)) {
+            vars[key] = val;
+        }
+    }
+    return vars;
+}
+//# sourceMappingURL=planner.js.map

package/dist/src/engine/planner.js.map

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

package/dist/src/engine/router.d.ts

@@ -0,0 +1,7 @@
+import type { RoutesConfig, TaskInput, RouteResult } from '../types.js';
+/**
+ * Deterministic task routing — no LLM judgment, pure rule matching.
+ *
+ * Priority: label match (exact) → keyword match (scored) → channel match → default
+ */
+export declare function routeTask(config: RoutesConfig, task: TaskInput): RouteResult;

package/dist/src/engine/router.js

@@ -0,0 +1,56 @@
+/**
+ * Deterministic task routing — no LLM judgment, pure rule matching.
+ *
+ * Priority: label match (exact) → keyword match (scored) → channel match → default
+ */
+export function routeTask(config, task) {
+    // 1. Label match (exact — highest priority)
+    if (task.labels?.length) {
+        for (const route of config.routes) {
+            if (route.match.labels?.some((l) => task.labels.includes(l))) {
+                return hit(route, 'exact');
+            }
+        }
+    }
+    // 2. Keyword match (scored — best match wins)
+    const desc = task.description.toLowerCase();
+    let best = null;
+    for (const route of config.routes) {
+        if (!route.match.keywords?.length)
+            continue;
+        const score = route.match.keywords.filter((k) => desc.includes(k.toLowerCase())).length;
+        if (score > 0 &&
+            (!best ||
+                score > best.score ||
+                (score === best.score &&
+                    (route.priority ?? 0) > (best.route.priority ?? 0)))) {
+            best = { route, score };
+        }
+    }
+    if (best) {
+        return hit(best.route, 'keyword');
+    }
+    // 3. Channel match
+    if (task.channel) {
+        for (const route of config.routes) {
+            if (route.match.channel === task.channel) {
+                return hit(route, 'exact');
+            }
+        }
+    }
+    // 4. Default
+    return {
+        agent: config.default_agent,
+        workflow: config.default_workflow ?? 'default',
+        confidence: 'default',
+    };
+}
+function hit(route, confidence) {
+    return {
+        agent: route.agent,
+        workflow: route.workflow,
+        matched_route: route,
+        confidence,
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/src/engine/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/engine/router.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,MAAoB,EACpB,IAAe;IAEf,4CAA4C;IAC5C,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,IAAI,GAA2C,IAAI,CAAC;IAExD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM;YAAE,SAAS;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAC/B,CAAC,MAAM,CAAC;QACT,IACE,KAAK,GAAG,CAAC;YACT,CAAC,CAAC,IAAI;gBACJ,KAAK,GAAG,IAAI,CAAC,KAAK;gBAClB,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;oBACnB,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,EACxD,CAAC;YACD,IAAI,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,mBAAmB;IACnB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBACzC,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,aAAa;IACb,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,aAAa;QAC3B,QAAQ,EAAE,MAAM,CAAC,gBAAgB,IAAI,SAAS;QAC9C,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CACV,KAAY,EACZ,UAA+B;IAE/B,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,aAAa,EAAE,KAAK;QACpB,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/engine/verifier.d.ts

@@ -0,0 +1,8 @@
+import type { StepVerification, VerifyResult } from '../types.js';
+/**
+ * Run a verification command and check the result.
+ *
+ * Supports retries with delay. Matching is substring-based for `expect`,
+ * exact for `expect_exit`.
+ */
+export declare function verifyStep(verify: StepVerification, vars: Record<string, string>, cwd?: string): VerifyResult;