@loom-framework/core 0.1.0-alpha.19 → 0.1.0-alpha.191

package/dist/backend/process/migrate.js

@@ -0,0 +1,145 @@
+/**
+ * Phase 1 migration: consolidate process directories
+ *
+ * Moves:
+ *   .loom/processes.json              → .loom/processes/_registry.json
+ *   .loom/process-logs/{name}/        → .loom/processes/{name}/logs/
+ *   .loom/process-metrics/{name}/*    → .loom/processes/{name}/
+ *
+ * Uses .loom/.process-migration-v1 as a marker to prevent duplicate runs.
+ */
+import fs from 'fs/promises';
+import path from 'path';
+const MIGRATION_MARKER = '.process-migration-v1';
+export async function migrateProcessDirectories(projectRoot) {
+    const loomDir = path.join(projectRoot, '.loom');
+    const markerPath = path.join(loomDir, MIGRATION_MARKER);
+    // Skip if already migrated
+    try {
+        await fs.access(markerPath);
+        return;
+    }
+    catch {
+        // Marker not found — proceed with migration
+    }
+    const processesDir = path.join(loomDir, 'processes');
+    await fs.mkdir(processesDir, { recursive: true });
+    // 1. processes.json → processes/_registry.json
+    const oldRegistry = path.join(loomDir, 'processes.json');
+    const newRegistry = path.join(processesDir, '_registry.json');
+    try {
+        await fs.access(oldRegistry);
+        try {
+            await fs.access(newRegistry);
+            // New registry already exists — skip, don't overwrite
+        }
+        catch {
+            await fs.rename(oldRegistry, newRegistry);
+        }
+    }
+    catch {
+        // Old registry doesn't exist — nothing to do
+    }
+    // 2. process-logs/{name}/ → processes/{name}/logs/
+    const oldLogsDir = path.join(loomDir, 'process-logs');
+    try {
+        const logEntries = await fs.readdir(oldLogsDir, { withFileTypes: true });
+        for (const entry of logEntries) {
+            if (!entry.isDirectory())
+                continue;
+            const srcDir = path.join(oldLogsDir, entry.name);
+            const destDir = path.join(processesDir, entry.name, 'logs');
+            try {
+                await fs.mkdir(destDir, { recursive: true });
+                const files = await fs.readdir(srcDir);
+                for (const file of files) {
+                    const srcFile = path.join(srcDir, file);
+                    const destFile = path.join(destDir, file);
+                    try {
+                        await fs.access(destFile);
+                        // Dest exists — skip
+                    }
+                    catch {
+                        await fs.rename(srcFile, destFile);
+                    }
+                }
+                // Remove source dir if empty
+                const remaining = await fs.readdir(srcDir);
+                if (remaining.length === 0) {
+                    await fs.rmdir(srcDir);
+                }
+            }
+            catch (err) {
+                console.warn(`[Migration] Failed to migrate logs for "${entry.name}":`, err instanceof Error ? err.message : String(err));
+            }
+        }
+        // Remove old logs dir if empty
+        try {
+            const remaining = await fs.readdir(oldLogsDir);
+            if (remaining.length === 0) {
+                await fs.rmdir(oldLogsDir);
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    catch {
+        // oldLogsDir doesn't exist — nothing to do
+    }
+    // 3. process-metrics/{name}/* → processes/{name}/
+    const oldMetricsDir = path.join(loomDir, 'process-metrics');
+    try {
+        const metricEntries = await fs.readdir(oldMetricsDir, { withFileTypes: true });
+        for (const entry of metricEntries) {
+            if (!entry.isDirectory())
+                continue;
+            const srcDir = path.join(oldMetricsDir, entry.name);
+            const destDir = path.join(processesDir, entry.name);
+            await fs.mkdir(destDir, { recursive: true });
+            for (const file of ['metrics.jsonl', 'view-config.json']) {
+                const srcFile = path.join(srcDir, file);
+                const destFile = path.join(destDir, file);
+                try {
+                    await fs.access(srcFile);
+                    try {
+                        await fs.access(destFile);
+                        // Dest exists — skip
+                    }
+                    catch {
+                        await fs.rename(srcFile, destFile);
+                    }
+                }
+                catch {
+                    // Source file doesn't exist — skip
+                }
+            }
+            // Remove source dir if empty
+            try {
+                const remaining = await fs.readdir(srcDir);
+                if (remaining.length === 0) {
+                    await fs.rmdir(srcDir);
+                }
+            }
+            catch {
+                // Ignore
+            }
+        }
+        // Remove old metrics dir if empty
+        try {
+            const remaining = await fs.readdir(oldMetricsDir);
+            if (remaining.length === 0) {
+                await fs.rmdir(oldMetricsDir);
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    catch {
+        // oldMetricsDir doesn't exist — nothing to do
+    }
+    // Write migration marker
+    await fs.writeFile(markerPath, new Date().toISOString(), 'utf-8');
+}
+//# sourceMappingURL=migrate.js.map

package/dist/backend/process/migrate.js.map

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

package/dist/backend/process/process-helpers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Process helper functions — shared utilities for multi-source normalization
+ * and lifecycle script name derivation.
+ */
+import type { ProcessSource } from '../../types/process.js';
+/** Normalize source + sources into a single sources array. */
+export declare function normalizeSources(def: {
+    source?: ProcessSource;
+    sources?: ProcessSource[];
+}): ProcessSource[];
+/** Derive lifecycle script names from process name and its sources. */
+export declare function deriveLifecycleNames(processName: string, sources: ProcessSource[]): string[];
+//# sourceMappingURL=process-helpers.d.ts.map

package/dist/backend/process/process-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-helpers.d.ts","sourceRoot":"","sources":["../../../src/backend/process/process-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAA2B,MAAM,wBAAwB,CAAC;AAErF,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IAAE,MAAM,CAAC,EAAE,aAAa,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;CAAE,GAAG,aAAa,EAAE,CAQ5G;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAI5F"}

package/dist/backend/process/process-helpers.js

@@ -0,0 +1,23 @@
+/**
+ * Process helper functions — shared utilities for multi-source normalization
+ * and lifecycle script name derivation.
+ */
+/** Normalize source + sources into a single sources array. */
+export function normalizeSources(def) {
+    if (def.sources && def.sources.length > 0) {
+        return def.sources;
+    }
+    if (def.source) {
+        return [def.source];
+    }
+    return [];
+}
+/** Derive lifecycle script names from process name and its sources. */
+export function deriveLifecycleNames(processName, sources) {
+    if (sources.length === 0)
+        return [];
+    if (sources.length === 1 && !sources[0].name)
+        return [`${processName}-feeder`];
+    return sources.map(s => `${processName}-feeder-${s.name}`);
+}
+//# sourceMappingURL=process-helpers.js.map

package/dist/backend/process/process-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-helpers.js","sourceRoot":"","sources":["../../../src/backend/process/process-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,GAA0D;IACzF,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAAC,WAAmB,EAAE,OAAwB;IAChF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;QAAE,OAAO,CAAC,GAAG,WAAW,SAAS,CAAC,CAAC;IAC/E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,WAAW,CAAC,CAAC,IAAK,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/backend/process/queue.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ExecutionQueue - FIFO queue with maxConcurrent limit
+ *
+ * In-memory with crash recovery awareness.
+ * On server crash, queued entries are lost (acceptable).
+ * Running entries are recovered by ProcessEngine.initialize() scanning logs.
+ */
+import type { ProcessQueueEntry } from '../../types/process.js';
+export declare class ExecutionQueue {
+    private queue;
+    private running;
+    private maxConcurrent;
+    constructor(maxConcurrent: number);
+    enqueue(entry: ProcessQueueEntry): void;
+    dequeue(): ProcessQueueEntry | undefined;
+    markRunning(runId: string, sessionId: string): void;
+    /** Move entry directly to running map before async execution starts */
+    markRunningEager(entry: ProcessQueueEntry): void;
+    markCompleted(runId: string): void;
+    markFailed(runId: string, error: string): void;
+    markTimeout(runId: string): void;
+    cancelForProcess(processName: string): number;
+    getQueueStatus(): {
+        queued: number;
+        running: number;
+        maxConcurrent: number;
+        entries: ProcessQueueEntry[];
+    };
+    getRunning(): ProcessQueueEntry[];
+    getQueued(): ProcessQueueEntry[];
+    hasSlot(): boolean;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/backend/process/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/backend/process/queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,aAAa,CAAS;gBAElB,aAAa,EAAE,MAAM;IAIjC,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAIvC,OAAO,IAAI,iBAAiB,GAAG,SAAS;IAIxC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAkBnD,uEAAuE;IACvE,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAMhD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASlC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAU9C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAUhC,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAM7C,cAAc,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE;IAS1G,UAAU,IAAI,iBAAiB,EAAE;IAIjC,SAAS,IAAI,iBAAiB,EAAE;IAIhC,OAAO,IAAI,OAAO;CAGnB"}

package/dist/backend/process/queue.js

@@ -0,0 +1,94 @@
+/**
+ * ExecutionQueue - FIFO queue with maxConcurrent limit
+ *
+ * In-memory with crash recovery awareness.
+ * On server crash, queued entries are lost (acceptable).
+ * Running entries are recovered by ProcessEngine.initialize() scanning logs.
+ */
+export class ExecutionQueue {
+    queue = [];
+    running = new Map();
+    maxConcurrent;
+    constructor(maxConcurrent) {
+        this.maxConcurrent = maxConcurrent;
+    }
+    enqueue(entry) {
+        this.queue.push(entry);
+    }
+    dequeue() {
+        return this.queue.shift();
+    }
+    markRunning(runId, sessionId) {
+        const entry = this.queue.find(e => e.runId === runId);
+        if (entry) {
+            entry.state = 'running';
+            entry.sessionId = sessionId;
+            entry.startedAt = new Date().toISOString();
+            this.queue = this.queue.filter(e => e.runId !== runId);
+            this.running.set(runId, entry);
+        }
+        else {
+            // Entry already moved to running map (eager mark), just update sessionId
+            const running = this.running.get(runId);
+            if (running) {
+                running.sessionId = sessionId;
+                running.startedAt = new Date().toISOString();
+            }
+        }
+    }
+    /** Move entry directly to running map before async execution starts */
+    markRunningEager(entry) {
+        entry.state = 'running';
+        entry.startedAt = new Date().toISOString();
+        this.running.set(entry.runId, entry);
+    }
+    markCompleted(runId) {
+        const entry = this.running.get(runId);
+        if (entry) {
+            entry.state = 'completed';
+            entry.endedAt = new Date().toISOString();
+            this.running.delete(runId);
+        }
+    }
+    markFailed(runId, error) {
+        const entry = this.running.get(runId);
+        if (entry) {
+            entry.state = 'failed';
+            entry.endedAt = new Date().toISOString();
+            entry.error = error;
+            this.running.delete(runId);
+        }
+    }
+    markTimeout(runId) {
+        const entry = this.running.get(runId);
+        if (entry) {
+            entry.state = 'timeout';
+            entry.endedAt = new Date().toISOString();
+            entry.error = 'Execution timed out';
+            this.running.delete(runId);
+        }
+    }
+    cancelForProcess(processName) {
+        const before = this.queue.length;
+        this.queue = this.queue.filter(e => e.processName !== processName);
+        return before - this.queue.length;
+    }
+    getQueueStatus() {
+        return {
+            queued: this.queue.length,
+            running: this.running.size,
+            maxConcurrent: this.maxConcurrent,
+            entries: [...this.running.values(), ...this.queue],
+        };
+    }
+    getRunning() {
+        return Array.from(this.running.values());
+    }
+    getQueued() {
+        return [...this.queue];
+    }
+    hasSlot() {
+        return this.running.size < this.maxConcurrent;
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/backend/process/queue.js.map

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

package/dist/backend/process/registry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * ProcessRegistry - Dual-source process definition + runtime state
+ *
+ * Definitions come from loom.config.ts (processes.definitions),
+ * runtime state (paused, timestamps) from .loom/processes/_state.json.
+ * getProcess() merges both sources into a ProcessDefinition.
+ *
+ * Uses atomic file write (temp file + rename) for _state.json.
+ */
+import type { ProcessDefinition, ProcessDefinitionConfig, ProcessRuntimeState } from '../../types/process.js';
+import type { LoomPaths } from '../loom-paths.js';
+export declare class ProcessRegistry {
+    /** Config-sourced definitions, keyed by name */
+    private definitions;
+    /** Runtime state, keyed by name */
+    private states;
+    private paths;
+    private defaultUserId;
+    private projectRoot;
+    constructor(paths: LoomPaths, defaultUserId?: string, projectRoot?: string);
+    private get statePath();
+    private get processesDir();
+    initialize(): Promise<void>;
+    /** Load process definitions from loom.config.ts */
+    private loadDefinitionsFromConfig;
+    /** Load runtime state from _state.json */
+    private loadState;
+    /** Ensure every definition has a runtime state entry; remove orphaned states */
+    private syncState;
+    /** Persist runtime state to _state.json (atomic: .tmp + rename) */
+    private saveState;
+    /** Merge a definition + state into a ProcessDefinition */
+    private merge;
+    addProcess(def: ProcessDefinitionConfig): Promise<ProcessDefinition>;
+    removeProcess(name: string): Promise<boolean>;
+    getProcess(name: string): Promise<ProcessDefinition | undefined>;
+    /** Synchronous version for status checks */
+    getProcessSync(name: string): ProcessDefinition | undefined;
+    listProcesses(options?: {
+        status?: 'active' | 'paused';
+    }): Promise<ProcessDefinition[]>;
+    /**
+     * Update a process. Config fields go to loom.config.ts, runtime fields go to _state.json.
+     * Config fields: description, cron, cronTimezone, prompt, metricsConfig, sources, model
+     * Runtime fields: paused
+     */
+    updateProcess(name: string, updates: Partial<Pick<ProcessDefinition, 'description' | 'cron' | 'cronTimezone' | 'prompt' | 'paused' | 'metricsConfig' | 'sources' | 'model'>>): Promise<ProcessDefinition | undefined>;
+    /** Set paused state (only touches _state.json, not config) */
+    setPaused(name: string, paused: boolean): Promise<ProcessRuntimeState | undefined>;
+    /** Validate that a full process has a PROCESS.md file */
+    validateProcessFile(name: string): Promise<boolean>;
+    /** Get all definitions (for config persistence by route layer) */
+    getAllDefinitions(): ProcessDefinitionConfig[];
+    /**
+     * Reload definitions from config (e.g., after external config change).
+     * Does NOT re-read _state.json.
+     */
+    reloadDefinitions(): Promise<void>;
+    /**
+     * Get all runtime states.
+     */
+    getAllStates(): ProcessRuntimeState[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/backend/process/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/backend/process/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE9G,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,qBAAa,eAAe;IAC1B,gDAAgD;IAChD,OAAO,CAAC,WAAW,CAAmD;IACtE,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,KAAK,EAAE,SAAS,EAAE,aAAa,SAAU,EAAE,WAAW,CAAC,EAAE,MAAM;IAO3E,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,KAAK,YAAY,GAEvB;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,mDAAmD;YACrC,yBAAyB;IAcvC,0CAA0C;YAC5B,SAAS;IAevB,gFAAgF;IAChF,OAAO,CAAC,SAAS;IAwBjB,mEAAmE;YACrD,SAAS;IAcvB,0DAA0D;IAC1D,OAAO,CAAC,KAAK;IAmBP,UAAU,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0BpE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAOtE,4CAA4C;IAC5C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAOrD,aAAa,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAa7F;;;;OAIG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,GAC/I,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IA+CzC,8DAA8D;IACxD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAUxF,yDAAyD;IACnD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASzD,kEAAkE;IAClE,iBAAiB,IAAI,uBAAuB,EAAE;IAI9C;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACH,YAAY,IAAI,mBAAmB,EAAE;CAGtC"}