@synergenius/flowweaver-pack-weaver 0.5.3 → 0.6.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-validator.d.ts

@@ -1,7 +1,10 @@
-export declare function validateFiles(files: string[], projectDir: string): Array<{
+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): FileValidationResult[];
 //# sourceMappingURL=file-validator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"file-validator.d.ts","sourceRoot":"","sources":["../../src/bot/file-validator.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiB/E"}
+{"version":3,"file":"file-validator.d.ts","sourceRoot":"","sources":["../../src/bot/file-validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE5E,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,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,GACjB,oBAAoB,EAAE,CAwBxB"}

package/dist/bot/file-validator.js

@@ -1,4 +1,5 @@
 import { execFileSync } from 'node:child_process';
+import { checkDesignQuality } from './design-checker.js';
 export function validateFiles(files, projectDir) {
     const results = [];
     for (const file of files) {
@@ -8,7 +9,14 @@ export function validateFiles(files, projectDir) {
             execFileSync('flow-weaver', ['validate', file], {
                 cwd: projectDir, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 30_000,
             });
-            results.push({ file, valid: true, errors: [], warnings: [] });
+            // Run design quality check on the AST
+            const designReport = runDesignCheck(file, projectDir);
+            const designWarnings = designReport
+                ? designReport.checks
+                    .filter((c) => c.severity === 'warning' || c.severity === 'error')
+                    .map((c) => `[${c.code}] ${c.message}`)
+                : [];
+            results.push({ file, valid: true, errors: [], warnings: designWarnings, designReport: designReport ?? undefined });
         }
         catch (err) {
             const msg = err instanceof Error ? err.stderr ?? err.message : String(err);
@@ -17,4 +25,17 @@ export function validateFiles(files, projectDir) {
     }
     return results;
 }
+function runDesignCheck(file, projectDir) {
+    try {
+        const astJson = execFileSync('flow-weaver', ['parse', file, '--format', 'json'], {
+            cwd: projectDir, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 30_000,
+        });
+        const ast = JSON.parse(astJson);
+        return checkDesignQuality(ast);
+    }
+    catch {
+        // If parse fails, skip design checks (validation already caught the error)
+        return null;
+    }
+}
 //# sourceMappingURL=file-validator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"file-validator.js","sourceRoot":"","sources":["../../src/bot/file-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,aAAa,CAC3B,KAAe,EACf,UAAkB;IAElB,MAAM,OAAO,GAAkF,EAAE,CAAC;IAElG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC;YACH,YAAY,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;gBAC9C,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;aACrF,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAE,GAA2B,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpG,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"}
+{"version":3,"file":"file-validator.js","sourceRoot":"","sources":["../../src/bot/file-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAU5E,MAAM,UAAU,aAAa,CAC3B,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,YAAY,CAAC,aAAa,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE;gBAC9C,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;aACrF,CAAC,CAAC;YACH,sCAAsC;YACtC,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACtD,MAAM,cAAc,GAAG,YAAY;gBACjC,CAAC,CAAC,YAAY,CAAC,MAAM;qBAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;qBACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC3C,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC;QACrH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAE,GAA2B,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpG,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;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,UAAkB;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE;YAC/E,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;SACrF,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,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"}

package/dist/bot/genesis-prompt-context.js

@@ -0,0 +1,121 @@
+/**
+ * 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 { buildSystemPrompt } from './system-prompt.js';
+let cachedOpsContext = null;
+/**
+ * Full system prompt with annotation grammar, CLI commands, validation codes,
+ * and genesis protocol. Cached after first call.
+ */
+export async function getGenesisSystemPrompt(config, stabilized, options) {
+    const base = await buildSystemPrompt();
+    const stabilizeClause = stabilized
+        ? '\n\nSTABILIZE MODE: Only removeNode, removeConnection, and implementNode operations are allowed. Do NOT propose addNode or addConnection.'
+        : '';
+    const selfEvolveClause = config.selfEvolve
+        ? [
+            '',
+            '## Self-Evolution',
+            `Self-evolution is ENABLED with a budget of ${config.selfEvolveBudget ?? 2} cost units.`,
+            'Cost map: selfModifyWorkflow=3, selfModifyNodeType=2, selfModifyModule=2.',
+            'Self-modify operations use { file: "relative/path.ts", content: "full file content" } in args.',
+            'The file path is relative to the pack root (e.g. "src/workflows/genesis-task.ts").',
+            'Content must be the complete replacement file, not a diff.',
+        ].join('\n')
+        : '';
+    const lockClause = options?.selfEvolveLocked
+        ? `\n\nSELF-EVOLUTION LOCKED: A migration is in grace period (${options.graceRemaining} cycles remaining). Do not propose selfModify operations.`
+        : '';
+    return [
+        base,
+        '',
+        '## Genesis Cycle Config',
+        `Intent: ${config.intent}`,
+        config.focus.length > 0 ? `Focus areas: ${config.focus.join(', ')}` : '',
+        config.constraints.length > 0 ? `Constraints: ${config.constraints.join(', ')}` : '',
+        `Budget: ${config.budgetPerCycle} cost units per cycle.`,
+        'Cost map: addNode=1, removeNode=1, addConnection=1, removeConnection=1, implementNode=2.',
+        stabilizeClause,
+        selfEvolveClause,
+        lockClause,
+    ].filter(Boolean).join('\n');
+}
+/**
+ * Operation format reference with concrete examples.
+ * Appended to both propose and revise prompts so the AI knows
+ * the exact CLI arg format.
+ */
+export function getOperationExamples(targetPath) {
+    return `## Operation Format
+
+Each operation is { type, args, costUnits, rationale }.
+
+### addNode
+args: { "nodeId": "myNode", "nodeType": "someFunction", "file": "${targetPath}" }
+
+### removeNode
+args: { "nodeId": "myNode", "file": "${targetPath}" }
+
+### addConnection
+args: { "from": "sourceNode.portName", "to": "targetNode.portName", "file": "${targetPath}" }
+IMPORTANT: Connection format is "node.port" using a DOT separator. NOT "node:port", NOT "node:portName".
+
+### removeConnection
+args: { "from": "sourceNode.portName", "to": "targetNode.portName", "file": "${targetPath}" }
+
+### implementNode
+args: { "nodeId": "existingStubNodeId", "file": "${targetPath}" }
+Only works on nodes declared with \`declare function\` (stubs). The nodeId must match an existing stub in the workflow.
+
+### selfModifyWorkflow (cost: 3)
+args: { "file": "src/workflows/genesis-task.ts", "content": "// full file content..." }
+Replaces the genesis workflow file. File path is relative to pack root.
+
+### selfModifyNodeType (cost: 2)
+args: { "file": "src/node-types/genesis-propose.ts", "content": "// full file content..." }
+Replaces a genesis node type implementation.
+
+### selfModifyModule (cost: 2)
+args: { "file": "src/bot/genesis-prompt-context.ts", "content": "// full file content..." }
+Replaces a bot module file.
+
+## Response Format
+Return ONLY valid JSON with: { operations: [...], totalCost: number, impactLevel: "COSMETIC"|"MINOR"|"BREAKING"|"CRITICAL", summary: string, rationale: string }
+No markdown, no code fences, no explanation outside the JSON.`;
+}
+/**
+ * Ops context from flow-weaver docs (CLI reference, error codes, etc.).
+ * Falls back gracefully if the context module is unavailable.
+ */
+export async function getOpsContext() {
+    if (cachedOpsContext)
+        return cachedOpsContext;
+    try {
+        const { buildContext } = await import('@synergenius/flow-weaver/context');
+        const result = buildContext({ preset: 'ops', includeGrammar: false });
+        cachedOpsContext = result.content;
+    }
+    catch {
+        cachedOpsContext = '(ops context unavailable)';
+    }
+    return cachedOpsContext;
+}
+/**
+ * Gets a text description of the workflow using the describe module.
+ * Falls back to reading the raw file if describe isn't available.
+ */
+export async function getWorkflowDescription(filePath) {
+    try {
+        const { parseWorkflow } = await import('@synergenius/flow-weaver/api');
+        const { describeWorkflow, formatTextOutput } = await import('@synergenius/flow-weaver/describe');
+        const result = await parseWorkflow(filePath);
+        const output = describeWorkflow(result.ast);
+        return formatTextOutput(result.ast, output);
+    }
+    catch {
+        return '(workflow description unavailable)';
+    }
+}
+//# sourceMappingURL=genesis-prompt-context.js.map

package/dist/bot/genesis-prompt-context.js.map

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

package/dist/bot/genesis-store.d.ts

@@ -1,4 +1,4 @@
-import type { GenesisConfig, GenesisHistory, GenesisCycleRecord, GenesisFingerprint } from './types.js';
+import type { GenesisConfig, GenesisHistory, GenesisCycleRecord, GenesisFingerprint, EscrowToken, GenesisSelfMigrationRecord } from './types.js';
 export declare class GenesisStore {
     private genesisDir;
     constructor(projectDir: string);
@@ -14,5 +14,15 @@ export declare class GenesisStore {
     getRecentOutcomes(count: number): string[];
     static newCycleId(): string;
     static hashConfig(config: GenesisConfig): string;
+    ensureEscrowDirs(): void;
+    loadEscrowToken(): EscrowToken | null;
+    saveEscrowToken(token: EscrowToken): void;
+    clearEscrow(): void;
+    getEscrowStagedPath(relativePath: string): string;
+    getEscrowBackupPath(relativePath: string): string;
+    loadSelfHistory(): GenesisSelfMigrationRecord[];
+    appendSelfMigration(record: GenesisSelfMigrationRecord): void;
+    getSelfFailureCount(): number;
+    static hashFile(filePath: string): string;
 }
 //# sourceMappingURL=genesis-store.d.ts.map

package/dist/bot/genesis-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"genesis-store.d.ts","sourceRoot":"","sources":["../../src/bot/genesis-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAaxG,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAI9B,UAAU,IAAI,IAAI;IAIlB,UAAU,IAAI,aAAa;IAW3B,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKvC,WAAW,IAAI,cAAc;IAQ7B,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAO5C,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAOtD,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQjD,eAAe,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAKtD,kBAAkB,IAAI,kBAAkB,GAAG,IAAI;IAU/C,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAK1C,MAAM,CAAC,UAAU,IAAI,MAAM;IAI3B,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;CAGjD"}
+{"version":3,"file":"genesis-store.d.ts","sourceRoot":"","sources":["../../src/bot/genesis-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAajJ,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAI9B,UAAU,IAAI,IAAI;IAIlB,UAAU,IAAI,aAAa;IAW3B,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKvC,WAAW,IAAI,cAAc;IAQ7B,WAAW,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAO5C,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAOtD,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQjD,eAAe,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI;IAKtD,kBAAkB,IAAI,kBAAkB,GAAG,IAAI;IAU/C,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAK1C,MAAM,CAAC,UAAU,IAAI,MAAM;IAI3B,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAMhD,gBAAgB,IAAI,IAAI;IAKxB,eAAe,IAAI,WAAW,GAAG,IAAI;IAUrC,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IASzC,WAAW,IAAI,IAAI;IAOnB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAIjD,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAMjD,eAAe,IAAI,0BAA0B,EAAE;IAU/C,mBAAmB,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI;IAW7D,mBAAmB,IAAI,MAAM;IAU7B,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAI1C"}

package/dist/bot/genesis-store.js

@@ -85,5 +85,70 @@ export class GenesisStore {
     static hashConfig(config) {
         return crypto.createHash('sha256').update(JSON.stringify(config)).digest('hex').slice(0, 12);
     }
+    // --- Escrow ---
+    ensureEscrowDirs() {
+        fs.mkdirSync(path.join(this.genesisDir, 'escrow', 'staged'), { recursive: true });
+        fs.mkdirSync(path.join(this.genesisDir, 'escrow', 'backup'), { recursive: true });
+    }
+    loadEscrowToken() {
+        const tokenPath = path.join(this.genesisDir, 'escrow', 'token.json');
+        if (!fs.existsSync(tokenPath))
+            return null;
+        try {
+            return JSON.parse(fs.readFileSync(tokenPath, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    saveEscrowToken(token) {
+        this.ensureEscrowDirs();
+        fs.writeFileSync(path.join(this.genesisDir, 'escrow', 'token.json'), JSON.stringify(token, null, 2), 'utf-8');
+    }
+    clearEscrow() {
+        const escrowDir = path.join(this.genesisDir, 'escrow');
+        if (fs.existsSync(escrowDir)) {
+            fs.rmSync(escrowDir, { recursive: true, force: true });
+        }
+    }
+    getEscrowStagedPath(relativePath) {
+        return path.join(this.genesisDir, 'escrow', 'staged', relativePath);
+    }
+    getEscrowBackupPath(relativePath) {
+        return path.join(this.genesisDir, 'escrow', 'backup', relativePath);
+    }
+    // --- Self-evolution history ---
+    loadSelfHistory() {
+        const histPath = path.join(this.genesisDir, 'self-history.json');
+        if (!fs.existsSync(histPath))
+            return [];
+        try {
+            return JSON.parse(fs.readFileSync(histPath, 'utf-8'));
+        }
+        catch {
+            return [];
+        }
+    }
+    appendSelfMigration(record) {
+        const records = this.loadSelfHistory();
+        records.push(record);
+        this.ensureDirs();
+        fs.writeFileSync(path.join(this.genesisDir, 'self-history.json'), JSON.stringify(records, null, 2), 'utf-8');
+    }
+    getSelfFailureCount() {
+        const records = this.loadSelfHistory();
+        let count = 0;
+        for (let i = records.length - 1; i >= 0; i--) {
+            if (records[i].outcome === 'rolled-back')
+                count++;
+            else
+                break;
+        }
+        return count;
+    }
+    static hashFile(filePath) {
+        const content = fs.readFileSync(filePath);
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
 }
 //# sourceMappingURL=genesis-store.js.map