@amsterdamdatalabs/enact-factory 0.1.1

package/dist/orchestration/workflow.js

@@ -0,0 +1,301 @@
+// ============================================
+// EnactFactory - DAG Workflow Engine
+// Agent workItem dependency management and execution
+// ============================================
+import { resolve } from 'path';
+import * as fs from 'fs/promises';
+import * as yaml from 'yaml';
+import { plansPath, sessionsPath } from '../factory/paths.js';
+// DAG Utilities
+/**
+ * Topological Sort (Kahn's Algorithm)
+ * Sort steps in dependency order
+ */
+export function topologicalSort(steps) {
+    const graph = new Map();
+    const inDegree = new Map();
+    const stepMap = new Map();
+    // Initialize graph
+    for (const step of steps) {
+        stepMap.set(step.id, step);
+        graph.set(step.id, new Set());
+        inDegree.set(step.id, 0);
+    }
+    // Add edges (dependencies)
+    for (const step of steps) {
+        if (step.dependsOn) {
+            for (const dep of step.dependsOn) {
+                if (!graph.has(dep)) {
+                    throw new Error(`Step "${step.id}" depends on unknown step "${dep}"`);
+                }
+                graph.get(dep).add(step.id);
+                inDegree.set(step.id, (inDegree.get(step.id) || 0) + 1);
+            }
+        }
+    }
+    // Kahn's Algorithm
+    const queue = [];
+    const result = [];
+    // Add nodes with in-degree 0 to queue
+    for (const [id, degree] of inDegree) {
+        if (degree === 0) {
+            queue.push(id);
+        }
+    }
+    while (queue.length > 0) {
+        const current = queue.shift();
+        result.push(stepMap.get(current));
+        for (const neighbor of graph.get(current)) {
+            inDegree.set(neighbor, inDegree.get(neighbor) - 1);
+            if (inDegree.get(neighbor) === 0) {
+                queue.push(neighbor);
+            }
+        }
+    }
+    // Cycle detection
+    if (result.length !== steps.length) {
+        throw new Error('Workflow contains circular dependencies');
+    }
+    return result;
+}
+/**
+ * Find currently executable steps (all dependencies completed)
+ */
+export function getExecutableSteps(steps, results) {
+    return steps.filter(step => {
+        // Already executed
+        if (results[step.id])
+            return false;
+        // Check dependencies
+        if (step.dependsOn) {
+            for (const depId of step.dependsOn) {
+                const depResult = results[depId];
+                if (!depResult || depResult.status !== 'completed') {
+                    return false;
+                }
+            }
+        }
+        return true;
+    });
+}
+/**
+ * Find parallelizable step groups
+ */
+export function getParallelGroups(steps) {
+    const sorted = topologicalSort(steps);
+    const groups = [];
+    const completed = new Set();
+    while (completed.size < sorted.length) {
+        const group = [];
+        for (const step of sorted) {
+            if (completed.has(step.id))
+                continue;
+            // All dependencies completed?
+            const depsCompleted = !step.dependsOn ||
+                step.dependsOn.every(dep => completed.has(dep));
+            if (depsCompleted) {
+                group.push(step);
+            }
+        }
+        if (group.length === 0)
+            break;
+        groups.push(group);
+        group.forEach(s => completed.add(s.id));
+    }
+    return groups;
+}
+// Workflow Storage
+const WORKFLOW_DIR = plansPath('workflows');
+const EXECUTION_DIR = sessionsPath('executions');
+/**
+ * Save workflow
+ */
+export async function saveWorkflow(workflow) {
+    await fs.mkdir(WORKFLOW_DIR, { recursive: true });
+    const filePath = resolve(WORKFLOW_DIR, `${workflow.id}.yaml`);
+    await fs.writeFile(filePath, yaml.stringify(workflow), 'utf-8');
+    console.log(`[Workflow] Saved: ${workflow.name} (${workflow.id})`);
+}
+/**
+ * Load workflow
+ */
+export async function loadWorkflow(workflowId) {
+    try {
+        const filePath = resolve(WORKFLOW_DIR, `${workflowId}.yaml`);
+        const content = await fs.readFile(filePath, 'utf-8');
+        return yaml.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all workflows
+ */
+export async function listWorkflows() {
+    try {
+        await fs.mkdir(WORKFLOW_DIR, { recursive: true });
+        const files = await fs.readdir(WORKFLOW_DIR);
+        const workflows = [];
+        for (const file of files) {
+            if (file.endsWith('.yaml')) {
+                const content = await fs.readFile(resolve(WORKFLOW_DIR, file), 'utf-8');
+                workflows.push(yaml.parse(content));
+            }
+        }
+        return workflows;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Save execution state
+ */
+export async function saveExecution(execution) {
+    await fs.mkdir(EXECUTION_DIR, { recursive: true });
+    const filePath = resolve(EXECUTION_DIR, `${execution.executionId}.json`);
+    await fs.writeFile(filePath, JSON.stringify(execution, null, 2), 'utf-8');
+}
+/**
+ * Load execution state
+ */
+export async function loadExecution(executionId) {
+    try {
+        const filePath = resolve(EXECUTION_DIR, `${executionId}.json`);
+        const content = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+// Workflow Templates
+/**
+ * CI pipeline template
+ */
+export function createCIPipelineTemplate(projectPath) {
+    return {
+        id: `ci-pipeline-${Date.now()}`,
+        name: 'CI Pipeline',
+        description: 'Lint → Test → Build → PR',
+        projectPath,
+        onFailure: 'rollback',
+        steps: [
+            {
+                id: 'lint',
+                name: 'Lint & Format',
+                prompt: 'Run linting and fix any workItems. Report what was fixed.',
+                onFailure: 'abort',
+            },
+            {
+                id: 'test',
+                name: 'Run Tests',
+                prompt: 'Run all tests and report results. Fix any failing tests if possible.',
+                dependsOn: ['lint'],
+                onFailure: 'abort',
+            },
+            {
+                id: 'build',
+                name: 'Build Check',
+                prompt: 'Run build and verify it succeeds. Fix any build errors.',
+                dependsOn: ['test'],
+                onFailure: 'abort',
+            },
+            {
+                id: 'pr',
+                name: 'Create PR',
+                prompt: 'Create a pull request with all changes made. Include a summary of fixes.',
+                dependsOn: ['build'],
+                onFailure: 'notify',
+            },
+        ],
+    };
+}
+/**
+ * Code review pipeline template
+ */
+export function createReviewPipelineTemplate(projectPath, prNumber) {
+    return {
+        id: `review-pipeline-${Date.now()}`,
+        name: 'Code Review Pipeline',
+        description: 'Security → Quality → Tests → Approve',
+        projectPath,
+        onFailure: 'notify',
+        steps: [
+            {
+                id: 'security',
+                name: 'Security Review',
+                prompt: `Review PR #${prNumber} for security vulnerabilities. Check for injection, auth workItems, data exposure.`,
+            },
+            {
+                id: 'quality',
+                name: 'Code Quality',
+                prompt: `Review PR #${prNumber} for code quality. Check naming, structure, SOLID principles.`,
+            },
+            {
+                id: 'tests',
+                name: 'Test Coverage',
+                prompt: `Check if PR #${prNumber} has adequate test coverage. Suggest missing tests.`,
+                dependsOn: ['security', 'quality'], // Execute after parallel steps
+            },
+            {
+                id: 'summary',
+                name: 'Review Summary',
+                prompt: 'Compile all review findings and create a summary comment on the PR.',
+                dependsOn: ['tests'],
+            },
+        ],
+    };
+}
+// Workflow Validation
+/**
+ * Validate workflow
+ */
+export function validateWorkflow(workflow) {
+    const errors = [];
+    // Basic field validation
+    if (!workflow.id)
+        errors.push('Workflow ID is required');
+    if (!workflow.name)
+        errors.push('Workflow name is required');
+    if (!workflow.steps || workflow.steps.length === 0) {
+        errors.push('Workflow must have at least one step');
+    }
+    // Step validation
+    const stepIds = new Set();
+    for (const step of workflow.steps || []) {
+        if (!step.id) {
+            errors.push('Each step must have an ID');
+            continue;
+        }
+        if (stepIds.has(step.id)) {
+            errors.push(`Duplicate step ID: ${step.id}`);
+        }
+        stepIds.add(step.id);
+        if (!step.prompt) {
+            errors.push(`Step "${step.id}" must have a prompt`);
+        }
+        // Dependency validation
+        if (step.dependsOn) {
+            for (const dep of step.dependsOn) {
+                if (!stepIds.has(dep) && !workflow.steps.some(s => s.id === dep)) {
+                    errors.push(`Step "${step.id}" depends on unknown step "${dep}"`);
+                }
+            }
+        }
+    }
+    // Circular dependency check
+    if (workflow.steps && workflow.steps.length > 0) {
+        try {
+            topologicalSort(workflow.steps);
+        }
+        catch (e) {
+            errors.push(e.message);
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+// Exports
+export { WORKFLOW_DIR, EXECUTION_DIR, };
+//# sourceMappingURL=workflow.js.map

package/dist/orchestration/workflow.js.map

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

package/dist/providers/codexSessions.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Codex - Session recording and summary system
+ *
+ * Structure:
+ * codex/
+ * ├── index.md                    # Full listing
+ * ├── 2026-02/                    # Monthly folders
+ * │   ├── 05-pykis-ci-fix.md     # Summary
+ * │   └── 05-us-stock-engine.md
+ * └── .sessions/                  # Detailed records (hidden)
+ *     └── 05-2050-pykis-ci-fix.md
+ */
+/**
+ * Session metadata
+ */
+export interface CodexSession {
+    id: string;
+    title: string;
+    repo?: string;
+    startedAt: number;
+    endedAt?: number;
+    tags: string[];
+    problem?: string;
+    solution?: string;
+    filesChanged: string[];
+    result: 'success' | 'partial' | 'failed' | 'ongoing';
+    commands: SessionCommand[];
+}
+/**
+ * Command executed during a session
+ */
+export interface SessionCommand {
+    tool: string;
+    description?: string;
+    timestamp: number;
+    result?: 'success' | 'error';
+}
+/**
+ * Initialize Codex - create directory structure
+ */
+export declare function initCodex(): Promise<void>;
+/**
+ * Save a session
+ */
+export declare function saveSession(session: CodexSession, rawLog?: string): Promise<{
+    summaryPath: string;
+    detailPath: string;
+}>;
+/**
+ * Session builder - incrementally construct a session
+ */
+export declare class SessionBuilder {
+    private session;
+    private rawLog;
+    constructor(title: string);
+    setRepo(repo: string): this;
+    addTag(...tags: string[]): this;
+    setProblem(problem: string): this;
+    setSolution(solution: string): this;
+    addFile(...files: string[]): this;
+    addCommand(tool: string, description?: string, result?: 'success' | 'error'): this;
+    appendLog(log: string): this;
+    setResult(result: CodexSession['result']): this;
+    save(): Promise<{
+        summaryPath: string;
+        detailPath: string;
+    }>;
+    getSession(): CodexSession;
+}
+/**
+ * Quick session save (for simple cases)
+ */
+export declare function quickSave(options: {
+    title: string;
+    repo?: string;
+    tags?: string[];
+    problem?: string;
+    solution?: string;
+    files?: string[];
+    result: CodexSession['result'];
+}): Promise<{
+    summaryPath: string;
+    detailPath: string;
+}>;
+/**
+ * Get recent session list
+ */
+export declare function getRecentSessions(limit?: number): Promise<string[]>;
+/**
+ * Return the Codex directory path
+ */
+export declare function getCodexPath(): string;
+//# sourceMappingURL=codexSessions.d.ts.map

package/dist/providers/codexSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codexSessions.d.ts","sourceRoot":"","sources":["../../src/providers/codexSessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrD,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B/C;AA4KD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCtD;AAoDD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAgB;gBAElB,KAAK,EAAE,MAAM;IAYzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAK/B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKjC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI;IAUlF,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK5B,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,IAAI;IAKzC,IAAI,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAKlE,UAAU,IAAI,YAAY;CAG3B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAWvD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiB7E;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}