@icex-labs/icex-flow 0.3.0

package/dist/src/engine/verifier.js

@@ -0,0 +1,55 @@
+import { execSync } from 'node:child_process';
+import { resolveTemplate } from '../utils.js';
+/**
+ * Run a verification command and check the result.
+ *
+ * Supports retries with delay. Matching is substring-based for `expect`,
+ * exact for `expect_exit`.
+ */
+export function verifyStep(verify, vars, cwd) {
+    const command = resolveTemplate(verify.command, vars);
+    const maxRetries = verify.retry ?? 0;
+    const retryDelay = verify.retry_delay ?? 5;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        if (attempt > 0) {
+            sleepSync(retryDelay * 1000);
+        }
+        try {
+            const output = execSync(command, {
+                cwd,
+                encoding: 'utf-8',
+                timeout: 30_000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            // Check expected output substring
+            if (verify.expect !== undefined) {
+                const expected = resolveTemplate(verify.expect, vars);
+                if (output.includes(expected)) {
+                    return { passed: true, output, expected };
+                }
+                if (attempt < maxRetries)
+                    continue;
+                return { passed: false, output, expected };
+            }
+            // No expect — command succeeded (exit 0)
+            return { passed: true, output, exit_code: 0 };
+        }
+        catch (err) {
+            const e = err;
+            const exitCode = e.status ?? 1;
+            const output = ((e.stdout ?? '') + (e.stderr ?? '')).trim();
+            if (verify.expect_exit !== undefined &&
+                exitCode === verify.expect_exit) {
+                return { passed: true, output, exit_code: exitCode };
+            }
+            if (attempt < maxRetries)
+                continue;
+            return { passed: false, output, exit_code: exitCode };
+        }
+    }
+    return { passed: false, output: 'Max retries exceeded' };
+}
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+//# sourceMappingURL=verifier.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../../src/engine/verifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,MAAwB,EACxB,IAA4B,EAC5B,GAAY;IAEZ,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;IAE3C,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE;gBAC/B,GAAG;gBACH,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,MAAM;gBACf,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEV,kCAAkC;YAClC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACtD,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAC5C,CAAC;gBACD,IAAI,OAAO,GAAG,UAAU;oBAAE,SAAS;gBACnC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC7C,CAAC;YAED,yCAAyC;YACzC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,GAA4D,CAAC;YACvE,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE5D,IACE,MAAM,CAAC,WAAW,KAAK,SAAS;gBAChC,QAAQ,KAAK,MAAM,CAAC,WAAW,EAC/B,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;YACvD,CAAC;YAED,IAAI,OAAO,GAAG,UAAU;gBAAE,SAAS;YACnC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+export { routeTask } from './engine/router.js';
+export { assembleContext, listContextFiles } from './engine/context.js';
+export { planWorkflow, formatPlan } from './engine/planner.js';
+export { verifyStep } from './engine/verifier.js';
+export { detectProject } from './engine/detect.js';
+export { discoverEnvironments } from './engine/environment.js';
+export { extractArchitecture } from './engine/architecture.js';
+export { generatePreset } from './presets/index.js';
+export { ensureGlobalDir, loadRegistry, registerProject, unregisterProject, mergeRoutes, mergeWorkflows, mergeContextManifest, GLOBAL_DIR, } from './engine/config.js';
+export { handleTask, getChannelMode, shouldUseIcexFlow, routeViaCLI, planViaCLI } from './adapters/index.js';
+export type { DiscoveredEnvironment, EnvironmentDiscoveryResult, } from './engine/environment.js';
+export type { DiscoveredService, ArchitectureResult, } from './engine/architecture.js';
+export type { KnowledgeCategory, KnowledgeEntry, KnowledgeStore, } from './commands/learn.js';
+export type { WorkflowDefinition, WorkflowStep, StepVerification, RoutesConfig, Route, RouteMatch, ContextManifest, TaskInput, RouteResult, ExecutionPlan, PlannedStep, VerifyResult, IcexFlowConfig, GlobalConfig, ProjectRegistry, ProjectRegistryEntry, DetectedProject, PresetType, } from './types.js';

package/dist/src/index.js

@@ -0,0 +1,13 @@
+// Public API — for programmatic usage and Claude Code integration
+export { routeTask } from './engine/router.js';
+export { assembleContext, listContextFiles } from './engine/context.js';
+export { planWorkflow, formatPlan } from './engine/planner.js';
+export { verifyStep } from './engine/verifier.js';
+export { detectProject } from './engine/detect.js';
+export { discoverEnvironments } from './engine/environment.js';
+export { extractArchitecture } from './engine/architecture.js';
+export { generatePreset } from './presets/index.js';
+export { ensureGlobalDir, loadRegistry, registerProject, unregisterProject, mergeRoutes, mergeWorkflows, mergeContextManifest, GLOBAL_DIR, } from './engine/config.js';
+// OpenClaw adapter
+export { handleTask, getChannelMode, shouldUseIcexFlow, routeViaCLI, planViaCLI } from './adapters/index.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,mBAAmB;AACnB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/presets/index.d.ts

@@ -0,0 +1,11 @@
+import type { DetectedProject, RoutesConfig, WorkflowDefinition } from '../types.js';
+export interface PresetOutput {
+    routes: RoutesConfig;
+    workflows: WorkflowDefinition[];
+    context_manifest: object;
+}
+/**
+ * Generate config files based on detected project type.
+ * Each preset produces routes, workflows, and a context manifest.
+ */
+export declare function generatePreset(detected: DetectedProject): PresetOutput;

package/dist/src/presets/index.js

@@ -0,0 +1,352 @@
+/**
+ * Generate config files based on detected project type.
+ * Each preset produces routes, workflows, and a context manifest.
+ */
+export function generatePreset(detected) {
+    const generator = PRESETS[detected.preset] ?? PRESETS.generic;
+    return generator(detected);
+}
+const PRESETS = {
+    microservice: generateMicroservice,
+    monorepo: generateMonorepo,
+    frontend: generateFrontend,
+    library: generateLibrary,
+    'data-pipeline': generateDataPipeline,
+    generic: generateGeneric,
+};
+// ── Microservice ─────────────────────────────────────────────────────
+function generateMicroservice(d) {
+    const testCmd = d.test_command ?? 'npm test';
+    const repo = d.repo_url ? repoSlug(d.repo_url) : d.name;
+    return {
+        routes: {
+            version: '1.0.0',
+            default_agent: 'main',
+            default_workflow: 'dev-chain',
+            routes: [
+                {
+                    match: { labels: ['auto-ok'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 10,
+                },
+                {
+                    match: { keywords: ['implement', 'fix', 'bug', 'feature', 'refactor', 'add'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['deploy', 'rollout', 'release', 'helm', 'cluster'] },
+                    workflow: 'dev-chain',
+                    agent: 'ops',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['test', 'validate', 'qa', 'regression', 'lint', 'coverage'] },
+                    workflow: 'dev-chain',
+                    agent: 'qa',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['architecture', 'design', 'rfc', 'review'] },
+                    workflow: 'dev-chain',
+                    agent: 'arch',
+                    priority: 5,
+                },
+            ],
+        },
+        workflows: [devChainWorkflow(d, testCmd, repo)],
+        context_manifest: contextManifest(),
+    };
+}
+// ── Monorepo ─────────────────────────────────────────────────────────
+function generateMonorepo(d) {
+    const testCmd = d.test_command ?? 'npm test';
+    const repo = d.repo_url ? repoSlug(d.repo_url) : d.name;
+    return {
+        routes: {
+            version: '1.0.0',
+            default_agent: 'main',
+            default_workflow: 'dev-chain',
+            routes: [
+                {
+                    match: { labels: ['auto-ok'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 10,
+                },
+                {
+                    match: { keywords: ['implement', 'fix', 'bug', 'feature', 'refactor'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['deploy', 'rollout', 'release'] },
+                    workflow: 'dev-chain',
+                    agent: 'ops',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['test', 'lint', 'ci'] },
+                    workflow: 'dev-chain',
+                    agent: 'qa',
+                    priority: 5,
+                },
+            ],
+        },
+        workflows: [devChainWorkflow(d, testCmd, repo)],
+        context_manifest: contextManifest(),
+    };
+}
+// ── Frontend ─────────────────────────────────────────────────────────
+function generateFrontend(d) {
+    const testCmd = d.test_command ?? 'npm test';
+    const repo = d.repo_url ? repoSlug(d.repo_url) : d.name;
+    return {
+        routes: {
+            version: '1.0.0',
+            default_agent: 'main',
+            default_workflow: 'dev-chain',
+            routes: [
+                {
+                    match: { labels: ['auto-ok'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 10,
+                },
+                {
+                    match: { keywords: ['implement', 'fix', 'bug', 'feature', 'refactor', 'component', 'ui'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['test', 'lint', 'accessibility', 'e2e', 'storybook'] },
+                    workflow: 'dev-chain',
+                    agent: 'qa',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['design', 'review', 'ux'] },
+                    workflow: 'dev-chain',
+                    agent: 'arch',
+                    priority: 5,
+                },
+            ],
+        },
+        workflows: [devChainWorkflow(d, testCmd, repo)],
+        context_manifest: contextManifest(),
+    };
+}
+// ── Library ──────────────────────────────────────────────────────────
+function generateLibrary(d) {
+    const testCmd = d.test_command ?? 'npm test';
+    const repo = d.repo_url ? repoSlug(d.repo_url) : d.name;
+    return {
+        routes: {
+            version: '1.0.0',
+            default_agent: 'main',
+            default_workflow: 'dev-chain',
+            routes: [
+                {
+                    match: { labels: ['auto-ok'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 10,
+                },
+                {
+                    match: { keywords: ['implement', 'fix', 'bug', 'feature', 'refactor'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['test', 'lint', 'coverage'] },
+                    workflow: 'dev-chain',
+                    agent: 'qa',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['release', 'publish', 'version'] },
+                    workflow: 'dev-chain',
+                    agent: 'ops',
+                    priority: 5,
+                },
+            ],
+        },
+        workflows: [devChainWorkflow(d, testCmd, repo)],
+        context_manifest: contextManifest(),
+    };
+}
+// ── Data Pipeline ────────────────────────────────────────────────────
+function generateDataPipeline(d) {
+    const testCmd = d.test_command ?? 'pytest';
+    const repo = d.repo_url ? repoSlug(d.repo_url) : d.name;
+    return {
+        routes: {
+            version: '1.0.0',
+            default_agent: 'main',
+            default_workflow: 'dev-chain',
+            routes: [
+                {
+                    match: { labels: ['auto-ok'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 10,
+                },
+                {
+                    match: { keywords: ['implement', 'fix', 'pipeline', 'etl', 'transform'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['test', 'validate', 'data-quality'] },
+                    workflow: 'dev-chain',
+                    agent: 'qa',
+                    priority: 5,
+                },
+                {
+                    match: { keywords: ['deploy', 'schedule', 'orchestrate'] },
+                    workflow: 'dev-chain',
+                    agent: 'ops',
+                    priority: 5,
+                },
+            ],
+        },
+        workflows: [devChainWorkflow(d, testCmd, repo)],
+        context_manifest: contextManifest(),
+    };
+}
+// ── Generic ──────────────────────────────────────────────────────────
+function generateGeneric(d) {
+    const testCmd = d.test_command ?? 'echo "no tests configured"';
+    const repo = d.repo_url ? repoSlug(d.repo_url) : d.name;
+    return {
+        routes: {
+            version: '1.0.0',
+            default_agent: 'main',
+            default_workflow: 'default',
+            routes: [
+                {
+                    match: { keywords: ['implement', 'fix', 'bug', 'feature'] },
+                    workflow: 'dev-chain',
+                    agent: 'dev',
+                    priority: 5,
+                },
+            ],
+        },
+        workflows: [devChainWorkflow(d, testCmd, repo)],
+        context_manifest: contextManifest(),
+    };
+}
+// ── Shared helpers ───────────────────────────────────────────────────
+function devChainWorkflow(d, testCmd, repo) {
+    return {
+        name: 'dev-chain',
+        version: '1.0.0',
+        description: 'Issue → Branch → Implement → Test → PR → Merge',
+        triggers: {
+            labels: ['auto-ok', 'bug', 'feature', 'enhancement'],
+            keywords: ['implement', 'fix', 'add', 'refactor', 'build'],
+        },
+        context: {
+            always: ['.icex-flow/context/L1-project/'],
+            per_step: {},
+        },
+        inputs: {
+            issue_number: { type: 'string', required: true, description: 'Issue number' },
+            branch_name: { type: 'string', required: true, description: 'Feature branch name' },
+            repo: { type: 'string', default: repo, description: 'Repository slug' },
+            pr_title: { type: 'string', required: true, description: 'Pull request title' },
+        },
+        steps: [
+            {
+                id: 'lock-issue',
+                name: 'Lock Issue',
+                action: 'shell',
+                command: 'gh issue edit {{issue_number}} --add-label in-progress --repo {{repo}}',
+                verify: {
+                    command: "gh issue view {{issue_number}} --repo {{repo}} --json labels -q '.labels[].name'",
+                    expect: 'in-progress',
+                },
+            },
+            {
+                id: 'create-branch',
+                name: 'Create Feature Branch',
+                action: 'shell',
+                command: 'git checkout -b {{branch_name}} && git push -u origin {{branch_name}}',
+                verify: {
+                    command: 'git branch --show-current',
+                    expect: '{{branch_name}}',
+                },
+            },
+            {
+                id: 'implement',
+                name: 'Implement Changes',
+                action: 'agent',
+                agent: 'dev-coder',
+                timeout: 600,
+                input: 'Implement the changes described in issue #{{issue_number}}. Branch: {{branch_name}}. Run tests before committing.',
+                verify: {
+                    command: testCmd,
+                    expect_exit: 0,
+                },
+            },
+            {
+                id: 'create-pr',
+                name: 'Create Pull Request',
+                action: 'shell',
+                command: "gh pr create --base main --head {{branch_name}} --title '{{pr_title}}' --body 'Closes #{{issue_number}}' --repo {{repo}}",
+                capture: 'pr_url',
+            },
+            {
+                id: 'merge-pr',
+                name: 'Merge PR',
+                action: 'shell',
+                command: 'gh pr merge {{branch_name}} --squash --delete-branch --repo {{repo}}',
+                verify: {
+                    command: "gh pr view {{branch_name}} --repo {{repo}} --json state -q '.state'",
+                    expect: 'MERGED',
+                },
+            },
+            {
+                id: 'notify',
+                name: 'Notify Completion',
+                action: 'notify',
+                channels: ['telegram:notify'],
+                message: 'dev-chain complete: {{pr_title}} (issue #{{issue_number}}) merged',
+            },
+        ],
+        on_failure: {
+            action: 'notify',
+            channels: ['telegram:notify'],
+            message: "dev-chain failed at step '{{failed_step}}' for issue #{{issue_number}}: {{error}}",
+        },
+    };
+}
+function contextManifest() {
+    return {
+        version: '1.0.0',
+        base_dir: '.',
+        global: {
+            always_inject: ['context/L0-global/'],
+            inject_if_exists: [],
+        },
+        workflows: {
+            'dev-chain': {
+                always_inject: ['context/L1-project/'],
+                inject_if_exists: ['context/L2-reference/'],
+                steps: {},
+            },
+        },
+    };
+}
+function repoSlug(url) {
+    // Extract owner/repo from URL like https://github.com/owner/repo
+    const match = url.match(/(?:github\.com|gitlab\.com)[/:]([^/]+\/[^/]+?)(?:\.git)?$/);
+    return match?.[1] ?? url;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/presets/index.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,161 @@
+export interface WorkflowDefinition {
+    name: string;
+    version: string;
+    description: string;
+    triggers?: {
+        labels?: string[];
+        keywords?: string[];
+    };
+    context?: {
+        always?: string[];
+        per_step?: Record<string, string[]>;
+    };
+    inputs?: Record<string, InputDefinition>;
+    steps: WorkflowStep[];
+    on_failure?: FailureHandler;
+}
+export interface InputDefinition {
+    type: 'string' | 'number' | 'boolean';
+    required?: boolean;
+    default?: string | number | boolean;
+    description?: string;
+}
+export interface WorkflowStep {
+    id: string;
+    name: string;
+    action: 'shell' | 'agent' | 'notify' | 'gate';
+    command?: string;
+    agent?: string;
+    timeout?: number;
+    input?: string;
+    channels?: string[];
+    message?: string;
+    capture?: string;
+    condition?: string;
+    verify?: StepVerification;
+}
+export interface StepVerification {
+    command: string;
+    expect?: string;
+    expect_exit?: number;
+    retry?: number;
+    retry_delay?: number;
+}
+export interface FailureHandler {
+    action: 'notify' | 'rollback';
+    channels?: string[];
+    message?: string;
+    rollback_steps?: string[];
+}
+export interface RoutesConfig {
+    version: string;
+    default_agent: string;
+    default_workflow?: string;
+    routes: Route[];
+}
+export interface Route {
+    match: RouteMatch;
+    workflow: string;
+    agent: string;
+    priority?: number;
+}
+export interface RouteMatch {
+    labels?: string[];
+    keywords?: string[];
+    channel?: string;
+    sender?: string;
+}
+export interface ContextManifest {
+    version: string;
+    base_dir?: string;
+    global: {
+        always_inject: string[];
+        inject_if_exists?: string[];
+    };
+    workflows?: Record<string, WorkflowContextDef>;
+}
+export interface WorkflowContextDef {
+    always_inject?: string[];
+    inject_if_exists?: string[];
+    steps?: Record<string, {
+        inject?: string[];
+    }>;
+}
+export interface TaskInput {
+    description: string;
+    labels?: string[];
+    channel?: string;
+    sender?: string;
+}
+export interface RouteResult {
+    agent: string;
+    workflow: string;
+    matched_route?: Route;
+    confidence: 'exact' | 'keyword' | 'default';
+}
+export interface ExecutionPlan {
+    workflow: string;
+    steps: PlannedStep[];
+    context_files: string[];
+    variables: Record<string, string>;
+}
+export interface PlannedStep {
+    id: string;
+    name: string;
+    action: string;
+    resolved_command?: string;
+    resolved_input?: string;
+    timeout?: number;
+    verify?: {
+        command: string;
+        expect?: string;
+        expect_exit?: number;
+    };
+    status: 'pending' | 'running' | 'passed' | 'failed' | 'skipped';
+}
+export interface VerifyResult {
+    passed: boolean;
+    output: string;
+    expected?: string;
+    exit_code?: number;
+}
+export interface IcexFlowConfig {
+    workflows_dir: string;
+    routes_file: string;
+    context_file: string;
+    base_dir: string;
+}
+export declare const DEFAULT_CONFIG: IcexFlowConfig;
+export interface GlobalConfig {
+    version: string;
+    notification_channel?: string;
+    safety_constraints?: string[];
+}
+export interface ProjectRegistryEntry {
+    path: string;
+    name: string;
+    preset?: string;
+    registered_at: string;
+    repo_url?: string;
+}
+export interface ProjectRegistry {
+    version: string;
+    projects: ProjectRegistryEntry[];
+}
+export type PresetType = 'microservice' | 'monorepo' | 'frontend' | 'library' | 'data-pipeline' | 'generic';
+export interface DetectedProject {
+    name: string;
+    repo_url?: string;
+    language: string;
+    languages: string[];
+    ci?: string;
+    deployment?: string;
+    test_command?: string;
+    build_command?: string;
+    has_db_migrations: boolean;
+    containerized: boolean;
+    is_claude_code: boolean;
+    is_monorepo: boolean;
+    preset: PresetType;
+    detected_features: string[];
+}

package/dist/src/types.js

@@ -0,0 +1,8 @@
+// ── Workflow Definition ──────────────────────────────────────────────
+export const DEFAULT_CONFIG = {
+    workflows_dir: '.icex-flow/workflows',
+    routes_file: '.icex-flow/routes.json',
+    context_file: '.icex-flow/context.manifest.json',
+    base_dir: '.',
+};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAuJxE,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,aAAa,EAAE,sBAAsB;IACrC,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,kCAAkC;IAChD,QAAQ,EAAE,GAAG;CACd,CAAC"}

package/dist/src/utils.d.ts

@@ -0,0 +1,8 @@
+export declare function resolveTemplate(template: string, vars: Record<string, string>): string;
+export declare function readFileSafe(path: string): string | null;
+export declare function loadJson<T>(path: string): T;
+export declare function parseFlags(args: string[]): {
+    positional: string[];
+    flags: Record<string, string>;
+};
+export declare function formatTable(rows: string[][], headers?: string[]): string;