claude-chrome-parallel 1.0.0

package/dist/orchestration/plan-registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * PlanRegistry — Manages compiled plan storage, loading, matching, and stats tracking.
+ *
+ * Plans are stored at {basePath}/plan-registry.json (index) and
+ * {basePath}/plans/{planId}.json (individual plan files).
+ */
+import type { CompiledPlan, PlanEntry, TaskPattern } from '../types/plan-cache';
+export declare class PlanRegistry {
+    private basePath;
+    private registryPath;
+    private plansDir;
+    private data;
+    constructor(basePath?: string);
+    /**
+     * Load plan registry from disk.
+     */
+    load(): void;
+    /**
+     * Persist plan registry to disk.
+     */
+    save(): void;
+    /**
+     * Find the best matching plan entry for a given task and URL.
+     * Filters by urlPattern, taskKeywords, and confidence threshold.
+     * Returns the highest-confidence match, or null if none found.
+     */
+    matchTask(task: string, url: string): PlanEntry | null;
+    /**
+     * Load a compiled plan from disk by its registry entry.
+     */
+    loadPlan(entry: PlanEntry): CompiledPlan | null;
+    /**
+     * Update execution stats for a plan and recalculate confidence.
+     */
+    updateStats(planId: string, success: boolean, durationMs: number): void;
+    /**
+     * Register a new compiled plan with the given task pattern.
+     * Saves plan JSON to disk and adds entry to the registry.
+     */
+    registerPlan(plan: CompiledPlan, pattern: TaskPattern): PlanEntry;
+    /**
+     * Get all plan entries.
+     */
+    getEntries(): PlanEntry[];
+    /**
+     * Get a single plan entry by ID.
+     */
+    getEntry(planId: string): PlanEntry | null;
+}
+/**
+ * Get a singleton PlanRegistry instance.
+ * Pass basePath to create/replace the singleton with a new base path.
+ */
+export declare function getPlanRegistry(basePath?: string): PlanRegistry;
+//# sourceMappingURL=plan-registry.d.ts.map

package/dist/orchestration/plan-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-registry.d.ts","sourceRoot":"","sources":["../../src/orchestration/plan-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EAET,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAO7B,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAmB;gBAEnB,QAAQ,GAAE,MAA0B;IAWhD;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAgDtD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI;IAY/C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA+BvE;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,SAAS;IAyCjE;;OAEG;IACH,UAAU,IAAI,SAAS,EAAE;IAIzB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;CAI3C;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,CAQ/D"}

package/dist/orchestration/plan-registry.js

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * PlanRegistry — Manages compiled plan storage, loading, matching, and stats tracking.
+ *
+ * Plans are stored at {basePath}/plan-registry.json (index) and
+ * {basePath}/plans/{planId}.json (individual plan files).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanRegistry = void 0;
+exports.getPlanRegistry = getPlanRegistry;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_BASE_PATH = '.chrome-parallel/plans/';
+const REGISTRY_FILENAME = 'plan-registry.json';
+const PLANS_SUBDIR = 'plans';
+const REGISTRY_VERSION = '1.0.0';
+class PlanRegistry {
+    basePath;
+    registryPath;
+    plansDir;
+    data;
+    constructor(basePath = DEFAULT_BASE_PATH) {
+        this.basePath = basePath;
+        this.registryPath = path.join(basePath, REGISTRY_FILENAME);
+        this.plansDir = path.join(basePath, PLANS_SUBDIR);
+        this.data = {
+            version: REGISTRY_VERSION,
+            plans: [],
+            updatedAt: Date.now(),
+        };
+    }
+    /**
+     * Load plan registry from disk.
+     */
+    load() {
+        try {
+            const raw = fs.readFileSync(this.registryPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            this.data = parsed;
+        }
+        catch {
+            // Best-effort — start with empty registry
+            this.data = {
+                version: REGISTRY_VERSION,
+                plans: [],
+                updatedAt: Date.now(),
+            };
+        }
+    }
+    /**
+     * Persist plan registry to disk.
+     */
+    save() {
+        try {
+            fs.mkdirSync(this.basePath, { recursive: true });
+            this.data.updatedAt = Date.now();
+            fs.writeFileSync(this.registryPath, JSON.stringify(this.data, null, 2));
+        }
+        catch {
+            // Best-effort
+        }
+    }
+    /**
+     * Find the best matching plan entry for a given task and URL.
+     * Filters by urlPattern, taskKeywords, and confidence threshold.
+     * Returns the highest-confidence match, or null if none found.
+     */
+    matchTask(task, url) {
+        const taskLower = task.toLowerCase();
+        const candidates = this.data.plans.filter(entry => {
+            // Filter by confidence threshold
+            if (entry.confidence < entry.minConfidenceToUse) {
+                return false;
+            }
+            // Filter by urlPattern (if specified)
+            if (entry.pattern.urlPattern) {
+                try {
+                    const regex = new RegExp(entry.pattern.urlPattern);
+                    if (!regex.test(url)) {
+                        return false;
+                    }
+                }
+                catch {
+                    // Invalid regex — skip this entry
+                    return false;
+                }
+            }
+            // Filter by taskKeywords (all must be present, case-insensitive)
+            const allKeywordsMatch = entry.pattern.taskKeywords.every(kw => taskLower.includes(kw.toLowerCase()));
+            if (!allKeywordsMatch) {
+                return false;
+            }
+            return true;
+        });
+        if (candidates.length === 0) {
+            return null;
+        }
+        // Sort by confidence desc, then successCount desc
+        candidates.sort((a, b) => {
+            if (b.confidence !== a.confidence) {
+                return b.confidence - a.confidence;
+            }
+            return b.stats.successCount - a.stats.successCount;
+        });
+        return candidates[0];
+    }
+    /**
+     * Load a compiled plan from disk by its registry entry.
+     */
+    loadPlan(entry) {
+        try {
+            const planPath = path.isAbsolute(entry.planPath)
+                ? entry.planPath
+                : path.join(this.basePath, entry.planPath);
+            const raw = fs.readFileSync(planPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Update execution stats for a plan and recalculate confidence.
+     */
+    updateStats(planId, success, durationMs) {
+        const entry = this.data.plans.find(p => p.id === planId);
+        if (!entry)
+            return;
+        const stats = entry.stats;
+        stats.totalExecutions++;
+        if (success) {
+            stats.successCount++;
+        }
+        else {
+            stats.failCount++;
+        }
+        // Rolling average for duration
+        if (stats.totalExecutions === 1) {
+            stats.avgDurationMs = durationMs;
+        }
+        else {
+            stats.avgDurationMs = Math.round((stats.avgDurationMs * (stats.totalExecutions - 1) + durationMs) /
+                stats.totalExecutions);
+        }
+        stats.lastUsed = Date.now();
+        // Recalculate confidence as success rate
+        entry.confidence = stats.totalExecutions > 0
+            ? stats.successCount / stats.totalExecutions
+            : 0;
+        this.save();
+    }
+    /**
+     * Register a new compiled plan with the given task pattern.
+     * Saves plan JSON to disk and adds entry to the registry.
+     */
+    registerPlan(plan, pattern) {
+        try {
+            fs.mkdirSync(this.plansDir, { recursive: true });
+        }
+        catch {
+            // Best-effort
+        }
+        const planFilename = `${plan.id}.json`;
+        const planPath = path.join(PLANS_SUBDIR, planFilename);
+        const planFullPath = path.join(this.plansDir, planFilename);
+        try {
+            fs.writeFileSync(planFullPath, JSON.stringify(plan, null, 2));
+        }
+        catch {
+            // Best-effort
+        }
+        // Remove existing entry with same ID (if any)
+        this.data.plans = this.data.plans.filter(p => p.id !== plan.id);
+        const entry = {
+            id: plan.id,
+            pattern,
+            planPath,
+            stats: {
+                totalExecutions: 0,
+                successCount: 0,
+                failCount: 0,
+                avgDurationMs: 0,
+                lastUsed: 0,
+            },
+            confidence: 0.5, // Initial neutral confidence
+            minConfidenceToUse: 0.3,
+        };
+        this.data.plans.push(entry);
+        this.save();
+        return entry;
+    }
+    /**
+     * Get all plan entries.
+     */
+    getEntries() {
+        return this.data.plans;
+    }
+    /**
+     * Get a single plan entry by ID.
+     */
+    getEntry(planId) {
+        return this.data.plans.find(p => p.id === planId) ?? null;
+    }
+}
+exports.PlanRegistry = PlanRegistry;
+// Singleton instance cache
+let _instance = null;
+let _instanceBasePath = null;
+/**
+ * Get a singleton PlanRegistry instance.
+ * Pass basePath to create/replace the singleton with a new base path.
+ */
+function getPlanRegistry(basePath) {
+    const resolvedPath = basePath ?? DEFAULT_BASE_PATH;
+    if (!_instance || _instanceBasePath !== resolvedPath) {
+        _instance = new PlanRegistry(resolvedPath);
+        _instanceBasePath = resolvedPath;
+        _instance.load();
+    }
+    return _instance;
+}
+//# sourceMappingURL=plan-registry.js.map

package/dist/orchestration/plan-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-registry.js","sourceRoot":"","sources":["../../src/orchestration/plan-registry.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2OH,0CAQC;AAjPD,uCAAyB;AACzB,2CAA6B;AAQ7B,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AACpD,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAC/C,MAAM,YAAY,GAAG,OAAO,CAAC;AAC7B,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,MAAa,YAAY;IACf,QAAQ,CAAS;IACjB,YAAY,CAAS;IACrB,QAAQ,CAAS;IACjB,IAAI,CAAmB;IAE/B,YAAY,WAAmB,iBAAiB;QAC9C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG;YACV,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,MAAM,GAAqB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;YAC1C,IAAI,CAAC,IAAI,GAAG;gBACV,OAAO,EAAE,gBAAgB;gBACzB,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,IAAY,EAAE,GAAW;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAChD,iCAAiC;YACjC,IAAI,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,kBAAkB,EAAE,CAAC;gBAChD,OAAO,KAAK,CAAC;YACf,CAAC;YAED,sCAAsC;YACtC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBACnD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBACrB,OAAO,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,kCAAkC;oBAClC,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YAED,iEAAiE;YACjE,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAC7D,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CACrC,CAAC;YACF,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kDAAkD;QAClD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,IAAI,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;gBAClC,OAAO,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;YACrC,CAAC;YACD,OAAO,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAgB;QACvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC9C,CAAC,CAAC,KAAK,CAAC,QAAQ;gBAChB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAc,EAAE,OAAgB,EAAE,UAAkB;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAC1B,KAAK,CAAC,eAAe,EAAE,CAAC;QACxB,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,CAAC;QAED,+BAA+B;QAC/B,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,aAAa,GAAG,UAAU,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAC9B,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC;gBAC9D,KAAK,CAAC,eAAe,CACxB,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE5B,yCAAyC;QACzC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,eAAe,GAAG,CAAC;YAC1C,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,eAAe;YAC5C,CAAC,CAAC,CAAC,CAAC;QAEN,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,IAAkB,EAAE,OAAoB;QACnD,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAE5D,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;QAEhE,MAAM,KAAK,GAAc;YACvB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO;YACP,QAAQ;YACR,KAAK,EAAE;gBACL,eAAe,EAAE,CAAC;gBAClB,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,aAAa,EAAE,CAAC;gBAChB,QAAQ,EAAE,CAAC;aACZ;YACD,UAAU,EAAE,GAAG,EAAE,6BAA6B;YAC9C,kBAAkB,EAAE,GAAG;SACxB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;QAEZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;IAC5D,CAAC;CAEF;AAjND,oCAiNC;AAED,2BAA2B;AAC3B,IAAI,SAAS,GAAwB,IAAI,CAAC;AAC1C,IAAI,iBAAiB,GAAkB,IAAI,CAAC;AAE5C;;;GAGG;AACH,SAAgB,eAAe,CAAC,QAAiB;IAC/C,MAAM,YAAY,GAAG,QAAQ,IAAI,iBAAiB,CAAC;IACnD,IAAI,CAAC,SAAS,IAAI,iBAAiB,KAAK,YAAY,EAAE,CAAC;QACrD,SAAS,GAAG,IAAI,YAAY,CAAC,YAAY,CAAC,CAAC;QAC3C,iBAAiB,GAAG,YAAY,CAAC;QACjC,SAAS,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/orchestration/state-manager.d.ts

@@ -0,0 +1,127 @@
+/**
+ * State Manager - Manages orchestration state for Chrome-Sisyphus
+ * Provides file-based scratchpad management for workers
+ */
+export interface WorkerState {
+    workerId: string;
+    workerName: string;
+    tabId: string;
+    status: 'INIT' | 'IN_PROGRESS' | 'SUCCESS' | 'PARTIAL' | 'FAIL';
+    iteration: number;
+    maxIterations: number;
+    startedAt: number;
+    lastUpdatedAt: number;
+    task: string;
+    progressLog: ProgressEntry[];
+    extractedData: unknown;
+    errors: string[];
+}
+export interface ProgressEntry {
+    iteration: number;
+    timestamp: string;
+    action: string;
+    result: 'SUCCESS' | 'FAIL' | 'IN_PROGRESS';
+    error?: string;
+}
+export interface OrchestrationState {
+    orchestrationId: string;
+    status: 'INIT' | 'RUNNING' | 'COMPLETED' | 'PARTIAL' | 'FAILED';
+    createdAt: number;
+    updatedAt: number;
+    task: string;
+    workers: WorkerSummary[];
+    completedWorkers: number;
+    failedWorkers: number;
+}
+export interface WorkerSummary {
+    workerId: string;
+    workerName: string;
+    status: WorkerState['status'];
+    resultSummary?: string;
+}
+export declare class OrchestrationStateManager {
+    private baseDir;
+    constructor(baseDir?: string);
+    /**
+     * Ensure the orchestration directory exists
+     */
+    ensureDirectory(): Promise<void>;
+    /**
+     * Initialize orchestration state
+     */
+    initOrchestration(orchestrationId: string, task: string, workers: Array<{
+        workerId: string;
+        workerName: string;
+        tabId: string;
+        task: string;
+    }>): Promise<OrchestrationState>;
+    /**
+     * Initialize worker scratchpad
+     */
+    initWorkerState(workerId: string, workerName: string, tabId: string, task: string): Promise<WorkerState | null>;
+    /**
+     * Update worker state
+     */
+    updateWorkerState(workerName: string, update: Partial<WorkerState>): Promise<WorkerState | null>;
+    /**
+     * Add progress entry
+     * Note: Progress log is limited to MAX_PROGRESS_LOG_ENTRIES to prevent unbounded growth
+     */
+    addProgressEntry(workerName: string, action: string, result: ProgressEntry['result'], error?: string): Promise<void>;
+    /**
+     * Read worker state from scratchpad
+     */
+    readWorkerState(workerName: string): Promise<WorkerState | null>;
+    /**
+     * Write worker state to scratchpad (markdown format)
+     */
+    writeWorkerState(workerName: string, state: WorkerState): Promise<void>;
+    /**
+     * Format worker state as markdown
+     */
+    private formatWorkerMarkdown;
+    /**
+     * Read orchestration state from file.
+     *
+     * NOTE: As of the race-condition fix, WorkflowEngine maintains in-memory state as the
+     * authoritative source of truth for completion counting. File reads/writes here are
+     * write-behind (persistence and debugging only) — they are NOT used for correctness by
+     * WorkflowEngine.completeWorker(). Use WorkflowEngine.getOrchestrationStatus() to get
+     * the most current state.
+     */
+    readOrchestrationState(): Promise<OrchestrationState | null>;
+    /**
+     * Write orchestration state to file (write-behind).
+     *
+     * NOTE: This write is for persistence and debugging visibility only.
+     * WorkflowEngine holds the authoritative in-memory state — correctness does NOT
+     * depend on this file being up-to-date.
+     */
+    writeOrchestrationState(state: OrchestrationState): Promise<void>;
+    /**
+     * Update orchestration state
+     */
+    updateOrchestrationState(update: Partial<OrchestrationState>): Promise<OrchestrationState | null>;
+    /**
+     * Format orchestration state as markdown
+     */
+    private formatOrchestrationMarkdown;
+    /**
+     * Get all worker states
+     */
+    getAllWorkerStates(): Promise<WorkerState[]>;
+    /**
+     * Get worker scratchpad path
+     */
+    getWorkerPath(workerName: string): string;
+    /**
+     * Get orchestration state path
+     */
+    getOrchestrationPath(): string;
+    /**
+     * Clean up orchestration files
+     */
+    cleanup(): Promise<void>;
+}
+export declare function getOrchestrationStateManager(baseDir?: string): OrchestrationStateManager;
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/orchestration/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/orchestration/state-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6CH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAiC;IAItD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;OAEG;IACG,iBAAiB,CACrB,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GACpF,OAAO,CAAC,kBAAkB,CAAC;IA6B9B;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA6B9B;;OAEG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAC3B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAwB9B;;;OAGG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA8BhB;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAiCtE;;OAEG;IACG,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoD5B;;;;;;;;OAQG;IACG,sBAAsB,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAsBlE;;;;;;OAMG;IACG,uBAAuB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvE;;OAEG;IACG,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAcvG;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgCnC;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBlD;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIzC;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B;AAKD,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,yBAAyB,CAKxF"}