@icex-labs/icex-flow 0.3.0

package/dist/src/engine/architecture.js

@@ -0,0 +1,367 @@
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, basename } from 'node:path';
+// ── Helpers ──────────────────────────────────────────────────────────
+function readFileSafe(path) {
+    try {
+        return readFileSync(path, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function detectLanguage(dir) {
+    if (existsSync(join(dir, 'package.json'))) {
+        if (existsSync(join(dir, 'tsconfig.json')))
+            return 'typescript';
+        return 'node';
+    }
+    if (existsSync(join(dir, 'pyproject.toml')) || existsSync(join(dir, 'requirements.txt')) || existsSync(join(dir, 'setup.py')))
+        return 'python';
+    if (existsSync(join(dir, 'go.mod')))
+        return 'go';
+    if (existsSync(join(dir, 'Cargo.toml')))
+        return 'rust';
+    if (existsSync(join(dir, 'pom.xml')) || existsSync(join(dir, 'build.gradle')) || existsSync(join(dir, 'build.gradle.kts')))
+        return 'java';
+    return undefined;
+}
+function detectDatabaseFromContent(content) {
+    const lower = content.toLowerCase();
+    if (/postgres(ql)?|pg_|psycopg|DATABASE_URL.*postgres/i.test(content))
+        return 'postgresql';
+    if (/mysql|mariadb/i.test(content))
+        return 'mysql';
+    if (/mongodb|mongo_uri|mongoose/i.test(content))
+        return 'mongodb';
+    if (/redis|REDIS_URL|ioredis/i.test(content))
+        return 'redis';
+    if (/sqlite/i.test(content))
+        return 'sqlite';
+    if (/cassandra|cql/i.test(content))
+        return 'cassandra';
+    if (/elasticsearch|elastic/i.test(content))
+        return 'elasticsearch';
+    return undefined;
+}
+function detectPortFromDockerfile(dir) {
+    const content = readFileSafe(join(dir, 'Dockerfile')) || readFileSafe(join(dir, 'Containerfile'));
+    if (!content)
+        return undefined;
+    const match = content.match(/EXPOSE\s+(\d+)/);
+    return match ? parseInt(match[1], 10) : undefined;
+}
+function detectDatabaseInDir(dir) {
+    // Check common config files for DB references
+    const configFiles = [
+        'docker-compose.yml', 'docker-compose.yaml',
+        '.env', '.env.local', '.env.development',
+        'config.yaml', 'config.yml', 'config.json',
+        'application.yml', 'application.yaml', 'application.properties',
+        'settings.py', 'database.yml',
+    ];
+    for (const file of configFiles) {
+        const content = readFileSafe(join(dir, file));
+        if (content) {
+            const db = detectDatabaseFromContent(content);
+            if (db)
+                return db;
+        }
+    }
+    // Check package.json dependencies
+    const pkgContent = readFileSafe(join(dir, 'package.json'));
+    if (pkgContent) {
+        try {
+            const pkg = JSON.parse(pkgContent);
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (allDeps['pg'] || allDeps['postgres'] || allDeps['knex'] || allDeps['typeorm'] || allDeps['prisma'] || allDeps['@prisma/client'])
+                return 'postgresql';
+            if (allDeps['mysql'] || allDeps['mysql2'])
+                return 'mysql';
+            if (allDeps['mongodb'] || allDeps['mongoose'])
+                return 'mongodb';
+            if (allDeps['redis'] || allDeps['ioredis'])
+                return 'redis';
+            if (allDeps['better-sqlite3'] || allDeps['sqlite3'])
+                return 'sqlite';
+        }
+        catch { /* skip */ }
+    }
+    // Check pyproject.toml / requirements.txt
+    const pyContent = readFileSafe(join(dir, 'requirements.txt'));
+    if (pyContent) {
+        const db = detectDatabaseFromContent(pyContent);
+        if (db)
+            return db;
+    }
+    return undefined;
+}
+// ── Scanners ─────────────────────────────────────────────────────────
+function scanServiceDirs(dir) {
+    const services = [];
+    const serviceDirs = ['services', 'packages', 'apps', 'modules'];
+    for (const svcDir of serviceDirs) {
+        const svcPath = join(dir, svcDir);
+        if (!existsSync(svcPath))
+            continue;
+        try {
+            if (!statSync(svcPath).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const subs = readdirSync(svcPath).filter(f => {
+            try {
+                return statSync(join(svcPath, f)).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        });
+        for (const sub of subs) {
+            const subPath = join(svcPath, sub);
+            const svc = {
+                name: sub,
+                language: detectLanguage(subPath),
+                port: detectPortFromDockerfile(subPath),
+                database: detectDatabaseInDir(subPath),
+            };
+            // Try to find port from package.json scripts (e.g., --port 3000)
+            if (!svc.port) {
+                const pkg = readFileSafe(join(subPath, 'package.json'));
+                if (pkg) {
+                    try {
+                        const parsed = JSON.parse(pkg);
+                        const startScript = parsed.scripts?.start || parsed.scripts?.dev || '';
+                        const portMatch = startScript.match(/(?:--port|PORT=|-p)\s*(\d+)/);
+                        if (portMatch)
+                            svc.port = parseInt(portMatch[1], 10);
+                    }
+                    catch { /* skip */ }
+                }
+            }
+            services.push(svc);
+        }
+    }
+    return services;
+}
+function scanDockerCompose(dir) {
+    const services = [];
+    const dataFlow = [];
+    const composeFiles = ['docker-compose.yml', 'docker-compose.yaml', 'compose.yml', 'compose.yaml'];
+    for (const file of composeFiles) {
+        const content = readFileSafe(join(dir, file));
+        if (!content)
+            continue;
+        const lines = content.split('\n');
+        let inServices = false;
+        let currentService = null;
+        let currentIndent = 0;
+        for (const line of lines) {
+            if (/^services:\s*$/.test(line)) {
+                inServices = true;
+                continue;
+            }
+            if (inServices) {
+                // New top-level key ends services section
+                if (/^\S/.test(line) && line.trim() !== '' && !/^services:/.test(line)) {
+                    inServices = false;
+                    currentService = null;
+                    continue;
+                }
+                // Service name (2-space indent)
+                const svcMatch = line.match(/^(\s{2})(\w[\w.-]*):\s*$/);
+                if (svcMatch) {
+                    currentService = svcMatch[2];
+                    // Skip known infra services for architecture but still track dependencies
+                    const svc = { name: currentService };
+                    // Detect database services
+                    const lower = currentService.toLowerCase();
+                    if (/postgres/.test(lower))
+                        svc.database = 'postgresql';
+                    else if (/mysql|mariadb/.test(lower))
+                        svc.database = 'mysql';
+                    else if (/mongo/.test(lower))
+                        svc.database = 'mongodb';
+                    else if (/redis/.test(lower))
+                        svc.database = 'redis';
+                    else if (/elasticsearch|elastic/.test(lower))
+                        svc.database = 'elasticsearch';
+                    services.push(svc);
+                    continue;
+                }
+                // Detect ports within a service
+                if (currentService) {
+                    const portMatch = line.match(/["']?(\d+):(\d+)["']?/);
+                    if (portMatch) {
+                        const svc = services.find(s => s.name === currentService);
+                        if (svc && !svc.port) {
+                            svc.port = parseInt(portMatch[2], 10);
+                        }
+                    }
+                    // Detect depends_on
+                    const depMatch = line.match(/^\s+-\s+(\w[\w.-]*)\s*$/);
+                    if (depMatch && currentService) {
+                        const svc = services.find(s => s.name === currentService);
+                        if (svc) {
+                            svc.dependencies = svc.dependencies || [];
+                            svc.dependencies.push(depMatch[1]);
+                            dataFlow.push(`${currentService} -> ${depMatch[1]}`);
+                        }
+                    }
+                }
+            }
+        }
+        break; // Only process first found compose file
+    }
+    return { services, dataFlow };
+}
+function scanHelmCharts(dir) {
+    const services = [];
+    const chartDirs = ['charts', 'helm'];
+    for (const chartDir of chartDirs) {
+        const chartsPath = join(dir, chartDir);
+        if (!existsSync(chartsPath))
+            continue;
+        try {
+            if (!statSync(chartsPath).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const subs = readdirSync(chartsPath).filter(f => {
+            try {
+                return statSync(join(chartsPath, f)).isDirectory();
+            }
+            catch {
+                return false;
+            }
+        });
+        for (const sub of subs) {
+            const chartYaml = readFileSafe(join(chartsPath, sub, 'Chart.yaml')) ||
+                readFileSafe(join(chartsPath, sub, 'Chart.yml'));
+            if (chartYaml) {
+                services.push({ name: sub });
+            }
+        }
+    }
+    // Single chart at root
+    if (existsSync(join(dir, 'Chart.yaml')) || existsSync(join(dir, 'Chart.yml'))) {
+        const name = basename(dir) || 'chart';
+        if (!services.some(s => s.name === name)) {
+            services.push({ name });
+        }
+    }
+    return services;
+}
+function scanK8sManifests(dir) {
+    const services = [];
+    const dataFlow = [];
+    const k8sDirs = ['k8s', 'kubernetes', 'manifests', 'deploy'];
+    for (const k8sDir of k8sDirs) {
+        const k8sPath = join(dir, k8sDir);
+        if (!existsSync(k8sPath))
+            continue;
+        try {
+            if (!statSync(k8sPath).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const files = readdirSync(k8sPath).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+        for (const file of files) {
+            const content = readFileSafe(join(k8sPath, file));
+            if (!content)
+                continue;
+            // Extract service/deployment names
+            if (content.includes('kind: Deployment') || content.includes('kind: Service') || content.includes('kind: StatefulSet')) {
+                const nameMatch = content.match(/^\s*name:\s*(.+)$/m);
+                if (nameMatch) {
+                    const name = nameMatch[1].trim();
+                    const existing = services.find(s => s.name === name);
+                    if (!existing) {
+                        const svc = { name };
+                        // Extract containerPort
+                        const portMatch = content.match(/containerPort:\s*(\d+)/);
+                        if (portMatch)
+                            svc.port = parseInt(portMatch[1], 10);
+                        services.push(svc);
+                    }
+                }
+            }
+        }
+    }
+    return { services, dataFlow };
+}
+// ── Main ─────────────────────────────────────────────────────────────
+export function extractArchitecture(dir) {
+    const allServices = new Map();
+    const allDataFlow = [];
+    // 1. Scan service directories
+    for (const svc of scanServiceDirs(dir)) {
+        allServices.set(svc.name, svc);
+    }
+    // 2. Scan docker-compose
+    const compose = scanDockerCompose(dir);
+    for (const svc of compose.services) {
+        const existing = allServices.get(svc.name);
+        if (existing) {
+            // Merge: compose adds ports/deps, dir scan adds language
+            existing.port = existing.port || svc.port;
+            existing.database = existing.database || svc.database;
+            existing.dependencies = existing.dependencies || svc.dependencies;
+        }
+        else {
+            allServices.set(svc.name, svc);
+        }
+    }
+    allDataFlow.push(...compose.dataFlow);
+    // 3. Scan Helm charts
+    for (const svc of scanHelmCharts(dir)) {
+        if (!allServices.has(svc.name)) {
+            allServices.set(svc.name, svc);
+        }
+    }
+    // 4. Scan k8s manifests
+    const k8s = scanK8sManifests(dir);
+    for (const svc of k8s.services) {
+        const existing = allServices.get(svc.name);
+        if (existing) {
+            existing.port = existing.port || svc.port;
+        }
+        else {
+            allServices.set(svc.name, svc);
+        }
+    }
+    allDataFlow.push(...k8s.dataFlow);
+    // 5. If no services found, treat root as single service
+    if (allServices.size === 0) {
+        const lang = detectLanguage(dir);
+        const port = detectPortFromDockerfile(dir);
+        const db = detectDatabaseInDir(dir);
+        if (lang || port || db) {
+            allServices.set(basename(dir) || 'app', {
+                name: basename(dir) || 'app',
+                language: lang,
+                port,
+                database: db,
+            });
+        }
+    }
+    // 6. Try to detect root-level database if services don't have one
+    const rootDb = detectDatabaseInDir(dir);
+    if (rootDb) {
+        for (const svc of allServices.values()) {
+            if (!svc.database) {
+                svc.database = rootDb;
+            }
+        }
+    }
+    return {
+        services: Array.from(allServices.values()),
+        dataFlow: allDataFlow.length > 0 ? allDataFlow : undefined,
+    };
+}
+//# sourceMappingURL=architecture.js.map

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

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

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

@@ -0,0 +1,24 @@
+import type { ProjectRegistry, ProjectRegistryEntry, RoutesConfig, ContextManifest, WorkflowDefinition } from '../types.js';
+export declare const GLOBAL_DIR: string;
+export declare const GLOBAL_CONFIG_PATH: string;
+export declare const GLOBAL_REGISTRY_PATH: string;
+export declare const GLOBAL_CONTEXT_DIR: string;
+export declare const GLOBAL_WORKFLOWS_DIR: string;
+export declare function ensureGlobalDir(): void;
+export declare function loadRegistry(): ProjectRegistry;
+export declare function saveRegistry(registry: ProjectRegistry): void;
+export declare function registerProject(entry: ProjectRegistryEntry): void;
+export declare function unregisterProject(path: string): boolean;
+/**
+ * Merge global + project routes. Project routes override global routes
+ * when they share the same workflow+agent combination.
+ */
+export declare function mergeRoutes(projectDir: string): RoutesConfig | null;
+/**
+ * Merge global + project workflows. Project workflows override global by name.
+ */
+export declare function mergeWorkflows(projectDir: string): WorkflowDefinition[];
+/**
+ * Merge context: L0 from global, L1+L2 from project, produce unified manifest.
+ */
+export declare function mergeContextManifest(projectDir: string): ContextManifest | null;

package/dist/src/engine/config.js

@@ -0,0 +1,164 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+// ── Paths ────────────────────────────────────────────────────────────
+export const GLOBAL_DIR = join(homedir(), '.icex-flow');
+export const GLOBAL_CONFIG_PATH = join(GLOBAL_DIR, 'config.json');
+export const GLOBAL_REGISTRY_PATH = join(GLOBAL_DIR, 'projects.json');
+export const GLOBAL_CONTEXT_DIR = join(GLOBAL_DIR, 'context', 'L0-global');
+export const GLOBAL_WORKFLOWS_DIR = join(GLOBAL_DIR, 'workflows');
+// ── Global directory init ────────────────────────────────────────────
+export function ensureGlobalDir() {
+    mkdirSync(GLOBAL_DIR, { recursive: true });
+    mkdirSync(GLOBAL_CONTEXT_DIR, { recursive: true });
+    mkdirSync(GLOBAL_WORKFLOWS_DIR, { recursive: true });
+    if (!existsSync(GLOBAL_CONFIG_PATH)) {
+        const config = {
+            version: '1.0.0',
+        };
+        writeFileSync(GLOBAL_CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    if (!existsSync(GLOBAL_REGISTRY_PATH)) {
+        const registry = {
+            version: '1.0.0',
+            projects: [],
+        };
+        writeFileSync(GLOBAL_REGISTRY_PATH, JSON.stringify(registry, null, 2), 'utf-8');
+    }
+}
+// ── Registry operations ──────────────────────────────────────────────
+export function loadRegistry() {
+    ensureGlobalDir();
+    try {
+        return JSON.parse(readFileSync(GLOBAL_REGISTRY_PATH, 'utf-8'));
+    }
+    catch {
+        return { version: '1.0.0', projects: [] };
+    }
+}
+export function saveRegistry(registry) {
+    ensureGlobalDir();
+    writeFileSync(GLOBAL_REGISTRY_PATH, JSON.stringify(registry, null, 2), 'utf-8');
+}
+export function registerProject(entry) {
+    const registry = loadRegistry();
+    const absPath = resolve(entry.path);
+    // Upsert by path
+    const idx = registry.projects.findIndex((p) => resolve(p.path) === absPath);
+    if (idx >= 0) {
+        registry.projects[idx] = { ...entry, path: absPath };
+    }
+    else {
+        registry.projects.push({ ...entry, path: absPath });
+    }
+    saveRegistry(registry);
+}
+export function unregisterProject(path) {
+    const registry = loadRegistry();
+    const absPath = resolve(path);
+    const before = registry.projects.length;
+    registry.projects = registry.projects.filter((p) => resolve(p.path) !== absPath);
+    saveRegistry(registry);
+    return registry.projects.length < before;
+}
+// ── Config merging ───────────────────────────────────────────────────
+/**
+ * Merge global + project routes. Project routes override global routes
+ * when they share the same workflow+agent combination.
+ */
+export function mergeRoutes(projectDir) {
+    const projectRoutesPath = join(projectDir, '.icex-flow', 'routes.json');
+    const globalRoutesPath = join(GLOBAL_DIR, 'routes.json');
+    let projectRoutes = null;
+    let globalRoutes = null;
+    if (existsSync(projectRoutesPath)) {
+        try {
+            projectRoutes = JSON.parse(readFileSync(projectRoutesPath, 'utf-8'));
+        }
+        catch { /* skip */ }
+    }
+    if (existsSync(globalRoutesPath)) {
+        try {
+            globalRoutes = JSON.parse(readFileSync(globalRoutesPath, 'utf-8'));
+        }
+        catch { /* skip */ }
+    }
+    if (!projectRoutes && !globalRoutes)
+        return null;
+    if (!projectRoutes)
+        return globalRoutes;
+    if (!globalRoutes)
+        return projectRoutes;
+    // Project routes take priority; add global routes that don't conflict
+    const projectKeys = new Set(projectRoutes.routes.map((r) => routeKey(r)));
+    const mergedRoutes = [
+        ...projectRoutes.routes,
+        ...globalRoutes.routes.filter((r) => !projectKeys.has(routeKey(r))),
+    ];
+    return {
+        version: projectRoutes.version,
+        default_agent: projectRoutes.default_agent ?? globalRoutes.default_agent,
+        default_workflow: projectRoutes.default_workflow ?? globalRoutes.default_workflow,
+        routes: mergedRoutes,
+    };
+}
+function routeKey(r) {
+    return `${r.workflow}:${r.agent}`;
+}
+/**
+ * Merge global + project workflows. Project workflows override global by name.
+ */
+export function mergeWorkflows(projectDir) {
+    const projectWfDir = join(projectDir, '.icex-flow', 'workflows');
+    const workflows = new Map();
+    // Load global workflows first
+    if (existsSync(GLOBAL_WORKFLOWS_DIR)) {
+        for (const file of readdirSync(GLOBAL_WORKFLOWS_DIR).filter((f) => f.endsWith('.flow.json'))) {
+            try {
+                const wf = JSON.parse(readFileSync(join(GLOBAL_WORKFLOWS_DIR, file), 'utf-8'));
+                workflows.set(wf.name, wf);
+            }
+            catch { /* skip */ }
+        }
+    }
+    // Project workflows override by name
+    if (existsSync(projectWfDir)) {
+        for (const file of readdirSync(projectWfDir).filter((f) => f.endsWith('.flow.json'))) {
+            try {
+                const wf = JSON.parse(readFileSync(join(projectWfDir, file), 'utf-8'));
+                workflows.set(wf.name, wf);
+            }
+            catch { /* skip */ }
+        }
+    }
+    return Array.from(workflows.values());
+}
+/**
+ * Merge context: L0 from global, L1+L2 from project, produce unified manifest.
+ */
+export function mergeContextManifest(projectDir) {
+    const projectManifestPath = join(projectDir, '.icex-flow', 'context.manifest.json');
+    if (!existsSync(projectManifestPath))
+        return null;
+    try {
+        const manifest = JSON.parse(readFileSync(projectManifestPath, 'utf-8'));
+        // Inject global L0 context files if the global context dir has content
+        if (existsSync(GLOBAL_CONTEXT_DIR)) {
+            const globalFiles = readdirSync(GLOBAL_CONTEXT_DIR).filter((f) => f.endsWith('.md'));
+            if (globalFiles.length > 0) {
+                // Ensure global L0 is in the inject_if_exists (optional, don't break if missing)
+                const globalPath = GLOBAL_CONTEXT_DIR + '/';
+                if (!manifest.global.always_inject.includes(globalPath) &&
+                    !(manifest.global.inject_if_exists ?? []).includes(globalPath)) {
+                    manifest.global.inject_if_exists = manifest.global.inject_if_exists ?? [];
+                    manifest.global.inject_if_exists.push(globalPath);
+                }
+            }
+        }
+        return manifest;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=config.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { ContextManifest } from '../types.js';
+/**
+ * Mechanical context assembly — reads manifest, injects files, no LLM discretion.
+ *
+ * Returns concatenated file contents with section headers.
+ * Missing required files throw. Missing optional files are silently skipped.
+ */
+export declare function assembleContext(manifest: ContextManifest, baseDir: string, workflow?: string, step?: string, vars?: Record<string, string>): string;
+/**
+ * List all files that would be injected (dry-run mode).
+ */
+export declare function listContextFiles(manifest: ContextManifest, baseDir: string, workflow?: string, step?: string, vars?: Record<string, string>): string[];