@synergenius/flow-weaver-pack-weaver 0.8.1

package/dist/bot/design-checker.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Weaver Design Quality Checker
+ *
+ * Heuristic, context-dependent design checks that the bot evaluates during
+ * its exec-validate-retry loop and genesis proposal validation. These are
+ * opinionated recommendations, not core validator rules.
+ *
+ * Checks structural quality, complexity limits, and completeness.
+ */
+import type { TWorkflowAST } from '@synergenius/flow-weaver';
+export interface DesignCheck {
+    code: string;
+    severity: 'info' | 'warning' | 'error';
+    message: string;
+    nodeId?: string;
+}
+export interface DesignReport {
+    score: number;
+    checks: DesignCheck[];
+    passed: number;
+    failed: number;
+}
+export declare function checkDesignQuality(ast: TWorkflowAST): DesignReport;
+//# sourceMappingURL=design-checker.d.ts.map

package/dist/bot/design-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-checker.d.ts","sourceRoot":"","sources":["../../src/bot/design-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkC,MAAM,0BAA0B,CAAC;AAE7F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAiRD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CA6BlE"}

package/dist/bot/design-checker.js

@@ -0,0 +1,269 @@
+/**
+ * Weaver Design Quality Checker
+ *
+ * Heuristic, context-dependent design checks that the bot evaluates during
+ * its exec-validate-retry loop and genesis proposal validation. These are
+ * opinionated recommendations, not core validator rules.
+ *
+ * Checks structural quality, complexity limits, and completeness.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function resolveNodeType(ast, instance) {
+    return ast.nodeTypes.find((nt) => nt.name === instance.nodeType || nt.functionName === instance.nodeType);
+}
+function getOutgoing(ast, nodeId, portName) {
+    return ast.connections.filter((c) => {
+        if (c.from.node !== nodeId)
+            return false;
+        if (portName && c.from.port !== portName)
+            return false;
+        return true;
+    });
+}
+function getIncoming(ast, nodeId) {
+    return ast.connections.filter((c) => c.to.node === nodeId);
+}
+const GENERIC_ID_PATTERN = /^(node|n|tmp|x|test|foo|bar)\d*$/i;
+// ---------------------------------------------------------------------------
+// Structural Quality Checks
+// ---------------------------------------------------------------------------
+function checkVisualAnnotations(ast) {
+    const checks = [];
+    for (const inst of ast.instances) {
+        const hasColor = inst.config?.color;
+        const hasIcon = inst.config?.icon;
+        if (!hasColor && !hasIcon) {
+            checks.push({
+                code: 'WEAVER_MISSING_VISUALS',
+                severity: 'info',
+                message: `Node '${inst.id}' has no @color or @icon set. Visual annotations help readability.`,
+                nodeId: inst.id,
+            });
+        }
+    }
+    return checks;
+}
+function checkDescriptiveIds(ast) {
+    const checks = [];
+    for (const inst of ast.instances) {
+        if (GENERIC_ID_PATTERN.test(inst.id)) {
+            checks.push({
+                code: 'WEAVER_GENERIC_NODE_ID',
+                severity: 'warning',
+                message: `Node instance ID '${inst.id}' is generic. Use a descriptive ID that reflects the node's purpose.`,
+                nodeId: inst.id,
+            });
+        }
+    }
+    return checks;
+}
+function checkFlowDirection(ast) {
+    const checks = [];
+    if (!ast.ui?.instances || ast.ui.instances.length < 2)
+        return checks;
+    // Check if x-positions generally increase along step connections
+    const posMap = new Map();
+    for (const uiNode of ast.ui.instances) {
+        posMap.set(uiNode.name, uiNode.x);
+    }
+    let violations = 0;
+    let total = 0;
+    for (const conn of ast.connections) {
+        const fromX = posMap.get(conn.from.node);
+        const toX = posMap.get(conn.to.node);
+        if (fromX !== undefined && toX !== undefined) {
+            total++;
+            if (toX < fromX - 50)
+                violations++; // Allow small tolerance
+        }
+    }
+    if (total > 0 && violations / total > 0.3) {
+        checks.push({
+            code: 'WEAVER_LAYOUT_DIRECTION',
+            severity: 'info',
+            message: `${violations} of ${total} connections flow right-to-left. Consider a left-to-right or top-to-bottom layout for readability.`,
+        });
+    }
+    return checks;
+}
+function checkDescription(ast) {
+    if (!ast.description) {
+        return [{
+                code: 'WEAVER_NO_DESCRIPTION',
+                severity: 'info',
+                message: 'Workflow has no JSDoc description. A short summary helps collaborators understand its purpose.',
+            }];
+    }
+    return [];
+}
+// ---------------------------------------------------------------------------
+// Complexity Checks
+// ---------------------------------------------------------------------------
+function checkNodeCount(ast) {
+    const checks = [];
+    const count = ast.instances.length;
+    if (count > 50) {
+        checks.push({
+            code: 'WEAVER_TOO_MANY_NODES',
+            severity: 'error',
+            message: `Workflow has ${count} nodes (limit: 50). Extract sub-workflows to reduce complexity.`,
+        });
+    }
+    else if (count > 30) {
+        checks.push({
+            code: 'WEAVER_TOO_MANY_NODES',
+            severity: 'warning',
+            message: `Workflow has ${count} nodes (recommended limit: 30). Consider extracting sub-workflows.`,
+        });
+    }
+    return checks;
+}
+function checkScopeNesting(ast) {
+    const checks = [];
+    if (!ast.scopes)
+        return checks;
+    // Build parent chain: instance -> scope -> parent instance
+    const instanceScopeDepth = new Map();
+    function getDepth(instanceId, visited) {
+        if (visited.has(instanceId))
+            return 0;
+        visited.add(instanceId);
+        const cached = instanceScopeDepth.get(instanceId);
+        if (cached !== undefined)
+            return cached;
+        const inst = ast.instances.find((i) => i.id === instanceId);
+        if (!inst?.parent) {
+            instanceScopeDepth.set(instanceId, 0);
+            return 0;
+        }
+        const parentDepth = getDepth(inst.parent.id, visited);
+        const depth = parentDepth + 1;
+        instanceScopeDepth.set(instanceId, depth);
+        return depth;
+    }
+    for (const inst of ast.instances) {
+        const depth = getDepth(inst.id, new Set());
+        if (depth > 3) {
+            checks.push({
+                code: 'WEAVER_DEEP_NESTING',
+                severity: 'warning',
+                message: `Node '${inst.id}' is nested ${depth} scopes deep (limit: 3). Deep nesting makes workflows hard to follow.`,
+                nodeId: inst.id,
+            });
+        }
+    }
+    return checks;
+}
+function checkFanInComplexity(ast) {
+    const checks = [];
+    for (const inst of ast.instances) {
+        const dataIn = getIncoming(ast, inst.id).filter((c) => c.to.port !== 'execute' && c.to.port !== 'start');
+        if (dataIn.length > 5) {
+            checks.push({
+                code: 'WEAVER_HIGH_FANIN',
+                severity: 'warning',
+                message: `Node '${inst.id}' receives ${dataIn.length} data connections (limit: 5). This may be a bottleneck.`,
+                nodeId: inst.id,
+            });
+        }
+    }
+    return checks;
+}
+function checkFanOutComplexity(ast) {
+    const checks = [];
+    const stepPorts = new Set(['onSuccess', 'onFailure', 'execute', 'start', 'success', 'failure']);
+    for (const inst of ast.instances) {
+        const stepOut = getOutgoing(ast, inst.id).filter((c) => stepPorts.has(c.from.port));
+        const uniqueTargets = new Set(stepOut.map((c) => c.to.node));
+        if (uniqueTargets.size > 4) {
+            checks.push({
+                code: 'WEAVER_HIGH_FANOUT',
+                severity: 'warning',
+                message: `Node '${inst.id}' fans out to ${uniqueTargets.size} step targets (limit: 4). High branching increases complexity.`,
+                nodeId: inst.id,
+            });
+        }
+    }
+    return checks;
+}
+// ---------------------------------------------------------------------------
+// Completeness Checks
+// ---------------------------------------------------------------------------
+function checkNotificationPresence(ast) {
+    const checks = [];
+    // Check if workflow has side-effect nodes (heuristic: async nodes with write/send/push-like names)
+    const sideEffectPattern = /write|send|push|post|create|delete|update|deploy|publish|upload|notify/i;
+    const hasSideEffects = ast.instances.some((inst) => {
+        const nt = resolveNodeType(ast, inst);
+        const nameHint = `${inst.id} ${nt?.name ?? ''} ${nt?.functionName ?? ''} ${nt?.label ?? ''}`;
+        return sideEffectPattern.test(nameHint);
+    });
+    if (!hasSideEffects)
+        return checks;
+    // Check if there's a notification-like node
+    const notifyPattern = /notify|notification|alert|report|summary|slack|email|webhook|message/i;
+    const hasNotification = ast.instances.some((inst) => {
+        const nt = resolveNodeType(ast, inst);
+        const nameHint = `${inst.id} ${nt?.name ?? ''} ${nt?.functionName ?? ''} ${nt?.label ?? ''}`;
+        return notifyPattern.test(nameHint);
+    });
+    if (!hasNotification) {
+        checks.push({
+            code: 'WEAVER_NO_NOTIFICATION',
+            severity: 'info',
+            message: 'Workflow has side-effect nodes but no notification or reporting node. Consider adding one for observability.',
+        });
+    }
+    return checks;
+}
+// ---------------------------------------------------------------------------
+// Score calculation
+// ---------------------------------------------------------------------------
+const SEVERITY_WEIGHTS = {
+    error: 10,
+    warning: 3,
+    info: 1,
+};
+function calculateScore(checks) {
+    if (checks.length === 0)
+        return 100;
+    let penalty = 0;
+    for (const check of checks) {
+        penalty += SEVERITY_WEIGHTS[check.severity] ?? 1;
+    }
+    // Cap at 0
+    return Math.max(0, 100 - penalty);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function checkDesignQuality(ast) {
+    const allCheckers = [
+        checkVisualAnnotations,
+        checkDescriptiveIds,
+        checkFlowDirection,
+        checkDescription,
+        checkNodeCount,
+        checkScopeNesting,
+        checkFanInComplexity,
+        checkFanOutComplexity,
+        checkNotificationPresence,
+    ];
+    const checks = [];
+    for (const checker of allCheckers) {
+        checks.push(...checker(ast));
+    }
+    const failed = checks.length;
+    // Total possible checks is roughly: instances * 2 (visuals, id) + 4 (globals)
+    const totalPossible = ast.instances.length * 2 + 4;
+    const passed = Math.max(0, totalPossible - failed);
+    return {
+        score: calculateScore(checks),
+        checks,
+        passed,
+        failed,
+    };
+}
+//# sourceMappingURL=design-checker.js.map

package/dist/bot/design-checker.js.map

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

package/dist/bot/file-lock.d.ts

@@ -0,0 +1,7 @@
+export interface FileLockOptions {
+    retries?: number;
+    retryWait?: number;
+    staleMs?: number;
+}
+export declare function withFileLock<T>(lockPath: string, fn: () => T | Promise<T>, options?: FileLockOptions): Promise<T>;
+//# sourceMappingURL=file-lock.d.ts.map

package/dist/bot/file-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../../src/bot/file-lock.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgBD,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,CAAC,CA6CZ"}

package/dist/bot/file-lock.js

@@ -0,0 +1,64 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function withFileLock(lockPath, fn, options) {
+    const retries = options?.retries ?? 50;
+    const retryWait = options?.retryWait ?? 50;
+    const staleMs = options?.staleMs ?? 10_000;
+    const lockDir = lockPath + '.lock';
+    const infoFile = path.join(lockDir, 'info.json');
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            fs.mkdirSync(lockDir, { recursive: false });
+            fs.writeFileSync(infoFile, JSON.stringify({ pid: process.pid, timestamp: Date.now() }), 'utf-8');
+            try {
+                return await fn();
+            }
+            finally {
+                try {
+                    fs.rmSync(lockDir, { recursive: true });
+                }
+                catch { /* ignore */ }
+            }
+        }
+        catch (err) {
+            if (err.code !== 'EEXIST')
+                throw err;
+            // Lock exists, check if stale
+            try {
+                const raw = fs.readFileSync(infoFile, 'utf-8');
+                const info = JSON.parse(raw);
+                const isStale = Date.now() - info.timestamp > staleMs;
+                const isDead = !isPidAlive(info.pid);
+                if (isStale || isDead) {
+                    try {
+                        fs.rmSync(lockDir, { recursive: true });
+                    }
+                    catch { /* ignore */ }
+                    continue;
+                }
+            }
+            catch {
+                // Can't read lock info, try to clean up
+                try {
+                    fs.rmSync(lockDir, { recursive: true });
+                }
+                catch { /* ignore */ }
+                continue;
+            }
+            if (attempt < retries) {
+                await new Promise(r => setTimeout(r, retryWait));
+            }
+        }
+    }
+    throw new Error(`Failed to acquire file lock after ${retries} retries: ${lockPath}`);
+}
+//# sourceMappingURL=file-lock.js.map

package/dist/bot/file-lock.js.map

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

package/dist/bot/file-validator.d.ts

@@ -0,0 +1,10 @@
+import { type DesignReport } from './design-checker.js';
+export interface FileValidationResult {
+    file: string;
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    designReport?: DesignReport;
+}
+export declare function validateFiles(files: string[], projectDir: string): Promise<FileValidationResult[]>;
+//# sourceMappingURL=file-validator.d.ts.map

package/dist/bot/file-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-validator.d.ts","sourceRoot":"","sources":["../../src/bot/file-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG5E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA0BjC"}

package/dist/bot/file-validator.js

@@ -0,0 +1,27 @@
+import { checkDesignQuality } from './design-checker.js';
+import { fwValidate } from './fw-api.js';
+export async function validateFiles(files, projectDir) {
+    const results = [];
+    for (const file of files) {
+        if (!file.endsWith('.ts'))
+            continue;
+        try {
+            const { valid, errors, warnings, ast } = await fwValidate(file);
+            if (!valid) {
+                results.push({ file, valid: false, errors, warnings });
+                continue;
+            }
+            const designReport = checkDesignQuality(ast);
+            const designWarnings = designReport.checks
+                .filter((c) => c.severity === 'warning' || c.severity === 'error')
+                .map((c) => `[${c.code}] ${c.message}`);
+            results.push({ file, valid: true, errors: [], warnings: [...warnings, ...designWarnings], designReport });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            results.push({ file, valid: false, errors: [msg], warnings: [] });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=file-validator.js.map

package/dist/bot/file-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-validator.js","sourceRoot":"","sources":["../../src/bot/file-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAe,EACf,UAAkB;IAElB,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YAEhE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACvD,SAAS;YACX,CAAC;YAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM;iBACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;iBACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAE1C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;QAC5G,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/bot/file-watcher.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from 'node:events';
+export interface FileWatcherOptions {
+    filePath: string;
+    debounceMs?: number;
+    pollingIntervalMs?: number;
+}
+export declare class FileWatcher extends EventEmitter {
+    private filePath;
+    private debounceMs;
+    private pollingIntervalMs;
+    private watcher;
+    private pollTimer;
+    private debounceTimer;
+    private lastMtime;
+    private stopped;
+    constructor(options: FileWatcherOptions);
+    start(): void;
+    stop(): void;
+    private attachFsWatch;
+    private switchToPolling;
+    private onFsEvent;
+    private getMtime;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/bot/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/bot/file-watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,kBAAkB;IAOvC,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAUZ,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,QAAQ;CAOjB"}

package/dist/bot/file-watcher.js

@@ -0,0 +1,98 @@
+import * as fs from 'node:fs';
+import { EventEmitter } from 'node:events';
+export class FileWatcher extends EventEmitter {
+    filePath;
+    debounceMs;
+    pollingIntervalMs;
+    watcher = null;
+    pollTimer = null;
+    debounceTimer = null;
+    lastMtime = 0;
+    stopped = false;
+    constructor(options) {
+        super();
+        this.filePath = options.filePath;
+        this.debounceMs = options.debounceMs ?? 500;
+        this.pollingIntervalMs = options.pollingIntervalMs ?? 2000;
+    }
+    start() {
+        this.stopped = false;
+        this.lastMtime = this.getMtime();
+        this.attachFsWatch();
+    }
+    stop() {
+        this.stopped = true;
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        if (this.pollTimer)
+            clearInterval(this.pollTimer);
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+    }
+    attachFsWatch() {
+        try {
+            this.watcher = fs.watch(this.filePath, () => this.onFsEvent());
+            this.watcher.on('error', () => this.switchToPolling());
+        }
+        catch {
+            this.switchToPolling();
+        }
+    }
+    switchToPolling() {
+        if (this.stopped)
+            return;
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        if (this.pollTimer)
+            return;
+        this.pollTimer = setInterval(() => {
+            if (this.stopped)
+                return;
+            const mtime = this.getMtime();
+            if (mtime > this.lastMtime) {
+                this.lastMtime = mtime;
+                this.emit('change');
+            }
+            // Try to re-attach fs.watch
+            if (!this.watcher && fs.existsSync(this.filePath)) {
+                try {
+                    this.watcher = fs.watch(this.filePath, () => this.onFsEvent());
+                    this.watcher.on('error', () => this.switchToPolling());
+                    if (this.pollTimer) {
+                        clearInterval(this.pollTimer);
+                        this.pollTimer = null;
+                    }
+                }
+                catch {
+                    // Stay in polling mode
+                }
+            }
+        }, this.pollingIntervalMs);
+    }
+    onFsEvent() {
+        if (this.stopped)
+            return;
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => {
+            const mtime = this.getMtime();
+            if (mtime > this.lastMtime) {
+                this.lastMtime = mtime;
+                this.emit('change');
+            }
+        }, this.debounceMs);
+    }
+    getMtime() {
+        try {
+            return fs.statSync(this.filePath).mtimeMs;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/bot/file-watcher.js.map

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

package/dist/bot/fw-api.d.ts

@@ -0,0 +1,8 @@
+import type { TWorkflowAST } from '@synergenius/flow-weaver';
+export declare function fwValidate(filePath: string): Promise<{
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    ast: TWorkflowAST;
+}>;
+//# sourceMappingURL=fw-api.d.ts.map

package/dist/bot/fw-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fw-api.d.ts","sourceRoot":"","sources":["../../src/bot/fw-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,YAAY,CAAC;CACnB,CAAC,CASD"}

package/dist/bot/fw-api.js

@@ -0,0 +1,12 @@
+import { parseWorkflow, validateWorkflow } from '@synergenius/flow-weaver';
+export async function fwValidate(filePath) {
+    const parseResult = await parseWorkflow(filePath);
+    if (parseResult.errors.length > 0) {
+        return { valid: false, errors: parseResult.errors, warnings: parseResult.warnings, ast: parseResult.ast };
+    }
+    const validation = validateWorkflow(parseResult.ast);
+    const errors = validation.errors.map((e) => typeof e === 'string' ? e : e.message);
+    const warnings = validation.warnings.map((w) => typeof w === 'string' ? w : w.message);
+    return { valid: errors.length === 0, errors, warnings, ast: parseResult.ast };
+}
+//# sourceMappingURL=fw-api.js.map

package/dist/bot/fw-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fw-api.js","sourceRoot":"","sources":["../../src/bot/fw-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG3E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAM/C,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC;IAC5G,CAAC;IACD,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACvF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,CAAC;AAChF,CAAC"}

package/dist/bot/genesis-prompt-context.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared prompt helpers for genesis propose and revise steps.
+ * Centralises context building so the AI always gets the CLI grammar,
+ * operation syntax, and workflow structure it needs to produce valid proposals.
+ */
+import type { GenesisConfig } from './types.js';
+/**
+ * Full system prompt with annotation grammar, CLI commands, validation codes,
+ * and genesis protocol. Cached after first call.
+ */
+export declare function getGenesisSystemPrompt(config: GenesisConfig, stabilized: boolean, options?: {
+    selfEvolveLocked?: boolean;
+    graceRemaining?: number;
+}): Promise<string>;
+/**
+ * Operation format reference with concrete examples.
+ * Appended to both propose and revise prompts so the AI knows
+ * the exact CLI arg format.
+ */
+export declare function getOperationExamples(targetPath: string): string;
+/**
+ * Ops context from flow-weaver docs (CLI reference, error codes, etc.).
+ * Falls back gracefully if the context module is unavailable.
+ */
+export declare function getOpsContext(): Promise<string>;
+/**
+ * Gets a text description of the workflow using the describe module.
+ * Falls back to reading the raw file if describe isn't available.
+ */
+export declare function getWorkflowDescription(filePath: string): Promise<string>;
+//# sourceMappingURL=genesis-prompt-context.d.ts.map

package/dist/bot/genesis-prompt-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genesis-prompt-context.d.ts","sourceRoot":"","sources":["../../src/bot/genesis-prompt-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqC/D;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAYrD;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW9E"}