@synergenius/flow-weaver-pack-weaver 0.9.14 → 0.9.16

package/dist/ai-chat-provider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * AI Chat Provider for the Weaver pack.
+ *
+ * Thin adapter that bridges Weaver's existing capabilities into the
+ * platform's generic pack AI chat extension system.
+ *
+ * - executeTool() delegates to the same handlers used by MCP tools
+ * - getSystemPromptSections() composes from existing bot infrastructure
+ */
+interface AiChatToolContext {
+    workspacePath: string;
+    userId: string;
+}
+interface AiChatToolResult {
+    result: string;
+    isError: boolean;
+}
+interface AiChatPromptSection {
+    id: string;
+    title: string;
+    content: string;
+    priority: number;
+}
+interface AiChatPromptContext {
+    workspacePath: string;
+    conversationId: string;
+    messageCount: number;
+}
+declare const _default: {
+    executeTool(name: string, args: Record<string, unknown>, context: AiChatToolContext): Promise<AiChatToolResult>;
+    getSystemPromptSections(context: AiChatPromptContext): Promise<AiChatPromptSection[]>;
+};
+export default _default;
+//# sourceMappingURL=ai-chat-provider.d.ts.map

package/dist/ai-chat-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat-provider.d.ts","sourceRoot":"","sources":["../src/ai-chat-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,UAAU,iBAAiB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,mBAAmB;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;;sBAkLS,MAAM,QACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WACpB,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC;qCAcjB,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,EAAE,CAAC;;AApBnC,wBAuFE"}

package/dist/ai-chat-provider.js

@@ -0,0 +1,256 @@
+/**
+ * AI Chat Provider for the Weaver pack.
+ *
+ * Thin adapter that bridges Weaver's existing capabilities into the
+ * platform's generic pack AI chat extension system.
+ *
+ * - executeTool() delegates to the same handlers used by MCP tools
+ * - getSystemPromptSections() composes from existing bot infrastructure
+ */
+import { runWorkflow } from './bot/runner.js';
+import { RunStore } from './bot/run-store.js';
+import { CostStore } from './bot/cost-store.js';
+import { defaultRegistry, discoverProviders } from './bot/provider-registry.js';
+// ---------------------------------------------------------------------------
+// Tool handlers — reuse the same logic as MCP tools
+// ---------------------------------------------------------------------------
+const toolHandlers = {
+    async fw_weaver_run(args, ctx) {
+        const result = await runWorkflow(args.file, {
+            params: args.params,
+            verbose: args.verbose,
+            dryRun: args.dryRun,
+        });
+        return JSON.stringify(result, null, 2);
+    },
+    async fw_weaver_history(args) {
+        const store = new RunStore();
+        if (args.id) {
+            const record = store.get(args.id);
+            return record ? JSON.stringify(record, null, 2) : `No run found matching "${args.id}"`;
+        }
+        const records = store.list({
+            outcome: args.outcome,
+            workflowFile: args.workflowFile,
+            limit: args.limit ?? 20,
+        });
+        return records.length === 0 ? 'No runs recorded yet.' : JSON.stringify(records, null, 2);
+    },
+    async fw_weaver_costs(args) {
+        const store = new CostStore();
+        let sinceTs;
+        if (args.since) {
+            const spec = args.since;
+            const match = spec.match(/^(\d+)([dhm])$/);
+            if (match) {
+                const n = parseInt(match[1], 10);
+                const unit = match[2];
+                const ms = unit === 'd' ? n * 86_400_000 : unit === 'h' ? n * 3_600_000 : n * 60_000;
+                sinceTs = Date.now() - ms;
+            }
+            else {
+                const ts = new Date(spec).getTime();
+                if (!isNaN(ts))
+                    sinceTs = ts;
+            }
+        }
+        const summary = store.summarize({ since: sinceTs, model: args.model });
+        return JSON.stringify(summary, null, 2);
+    },
+    async fw_weaver_providers() {
+        await discoverProviders(defaultRegistry);
+        const providers = defaultRegistry.list();
+        const result = providers.map(({ name, metadata }) => ({
+            name,
+            source: metadata.source,
+            description: metadata.description,
+            requiredEnvVars: metadata.requiredEnvVars,
+            envVarsSet: metadata.requiredEnvVars?.every((v) => process.env[v]) ?? false,
+            detectCliCommand: metadata.detectCliCommand,
+        }));
+        return JSON.stringify(result, null, 2);
+    },
+    async fw_weaver_bot(args, ctx) {
+        const { fileURLToPath } = await import('node:url');
+        const { existsSync } = await import('node:fs');
+        const task = {
+            instruction: args.task,
+            mode: args.mode ?? 'create',
+            targets: args.targets,
+            options: {
+                template: args.template,
+                dryRun: args.dryRun,
+                autoApprove: args.autoApprove ?? true,
+            },
+        };
+        const packRoot = new URL('..', import.meta.url);
+        let workflowPath = fileURLToPath(new URL('src/workflows/weaver-bot.ts', packRoot));
+        if (!existsSync(workflowPath)) {
+            workflowPath = fileURLToPath(new URL('dist/workflows/weaver-bot.js', packRoot));
+        }
+        const result = await runWorkflow(workflowPath, {
+            params: { taskJson: JSON.stringify(task), projectDir: ctx.workspacePath || process.cwd() },
+            dryRun: args.dryRun,
+        });
+        return JSON.stringify(result, null, 2);
+    },
+    async fw_weaver_steer(args) {
+        const { SteeringController } = await import('./bot/steering.js');
+        const controller = new SteeringController();
+        await controller.write({
+            command: args.command,
+            payload: args.payload,
+            timestamp: Date.now(),
+        });
+        return `Steering command sent: ${args.command}`;
+    },
+    async fw_weaver_queue(args) {
+        const { TaskQueue } = await import('./bot/task-queue.js');
+        const queue = new TaskQueue();
+        switch (args.action) {
+            case 'add': {
+                if (!args.task)
+                    return 'Error: task instruction required';
+                const { id, duplicate } = await queue.add({ instruction: args.task, priority: 0 });
+                return duplicate ? `Task already queued (${id})` : `Task added: ${id}`;
+            }
+            case 'list':
+                return JSON.stringify(await queue.list(), null, 2);
+            case 'clear': {
+                const count = await queue.clear();
+                return `Cleared ${count} task(s)`;
+            }
+            case 'remove': {
+                if (!args.id)
+                    return 'Error: task ID required';
+                const removed = await queue.remove(args.id);
+                return removed ? `Removed ${args.id}` : `Not found: ${args.id}`;
+            }
+            default:
+                return `Unknown action: ${args.action}`;
+        }
+    },
+    async fw_weaver_status() {
+        const { SessionStore } = await import('./bot/session-state.js');
+        const store = new SessionStore();
+        const state = store.load();
+        return state ? JSON.stringify(state, null, 2) : JSON.stringify({ status: 'no active session' }, null, 2);
+    },
+    async fw_weaver_genesis(args, ctx) {
+        const { fileURLToPath } = await import('node:url');
+        const { existsSync } = await import('node:fs');
+        const packRoot = new URL('..', import.meta.url);
+        let workflowPath = fileURLToPath(new URL('src/workflows/genesis-task.ts', packRoot));
+        if (!existsSync(workflowPath)) {
+            workflowPath = fileURLToPath(new URL('dist/workflows/genesis-task.js', packRoot));
+        }
+        const result = await runWorkflow(workflowPath, {
+            params: { projectDir: ctx.workspacePath || process.cwd() },
+            dryRun: args.dryRun,
+        });
+        return JSON.stringify(result, null, 2);
+    },
+    async fw_weaver_insights(args, ctx) {
+        const { ProjectModelStore } = await import('./bot/project-model.js');
+        const { InsightEngine } = await import('./bot/insight-engine.js');
+        const projectDir = args.projectDir || ctx.workspacePath;
+        const pms = new ProjectModelStore(projectDir);
+        const model = await pms.getOrBuild();
+        const engine = new InsightEngine();
+        const insights = engine.analyze(model);
+        return JSON.stringify({
+            health: model.health,
+            bots: model.bots,
+            insights: insights.slice(0, 10),
+            trust: model.trust,
+            cost: model.cost,
+            evolution: {
+                totalCycles: model.evolution.totalCycles,
+                successRate: model.evolution.successRate,
+            },
+        }, null, 2);
+    },
+};
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+export default {
+    async executeTool(name, args, context) {
+        const handler = toolHandlers[name];
+        if (!handler) {
+            return { result: `Unknown weaver tool: ${name}`, isError: true };
+        }
+        try {
+            const result = await handler(args, context);
+            return { result, isError: false };
+        }
+        catch (err) {
+            return { result: err instanceof Error ? err.message : String(err), isError: true };
+        }
+    },
+    async getSystemPromptSections(context) {
+        const sections = [];
+        // Weaver behavioral instructions
+        try {
+            const { buildBotSystemPrompt } = await import('./bot/system-prompt.js');
+            const prompt = buildBotSystemPrompt();
+            if (prompt) {
+                sections.push({
+                    id: 'weaver-identity',
+                    title: 'Weaver Behavioral Instructions',
+                    content: prompt,
+                    priority: 10,
+                });
+            }
+        }
+        catch {
+            // system-prompt module not available — skip
+        }
+        // Project intelligence
+        if (context.workspacePath) {
+            try {
+                const { ProjectModelStore } = await import('./bot/project-model.js');
+                const pms = new ProjectModelStore(context.workspacePath);
+                const model = await pms.getOrBuild();
+                if (model && (model.health.workflows.length > 0 || model.bots.length > 0)) {
+                    sections.push({
+                        id: 'project-intelligence',
+                        title: 'Project Intelligence',
+                        content: pms.formatSummary(model) +
+                            '\n\nBe proactive: mention relevant insights when they relate to what the user is working on.',
+                        priority: 20,
+                    });
+                }
+            }
+            catch {
+                // ProjectModelStore not available — skip
+            }
+        }
+        // Proactive insights
+        if (context.workspacePath) {
+            try {
+                const { InsightEngine } = await import('./bot/insight-engine.js');
+                const engine = new InsightEngine();
+                const { ProjectModelStore } = await import('./bot/project-model.js');
+                const pms = new ProjectModelStore(context.workspacePath);
+                const model = await pms.getOrBuild();
+                if (model) {
+                    const insights = engine.analyze(model).slice(0, 3);
+                    if (insights.length > 0) {
+                        sections.push({
+                            id: 'proactive-insights',
+                            title: 'Proactive Insights',
+                            content: insights.map((i) => `- [${i.severity}] ${i.title}: ${i.description}`).join('\n'),
+                            priority: 30,
+                        });
+                    }
+                }
+            }
+            catch {
+                // InsightEngine not available — skip
+            }
+        }
+        return sections;
+    },
+};
+//# sourceMappingURL=ai-chat-provider.js.map

package/dist/ai-chat-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-chat-provider.js","sourceRoot":"","sources":["../src/ai-chat-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAyBhF,8EAA8E;AAC9E,oDAAoD;AACpD,8EAA8E;AAE9E,MAAM,YAAY,GAGd;IACF,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG;QAC3B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAc,EAAE;YACpD,MAAM,EAAE,IAAI,CAAC,MAA6C;YAC1D,OAAO,EAAE,IAAI,CAAC,OAA8B;YAC5C,MAAM,EAAE,IAAI,CAAC,MAA6B;SAC3C,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,IAAI;QAC1B,MAAM,KAAK,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;YAC5C,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,0BAA0B,IAAI,CAAC,EAAE,GAAG,CAAC;QACzF,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,OAAmE;YACjF,YAAY,EAAE,IAAI,CAAC,YAAkC;YACrD,KAAK,EAAG,IAAI,CAAC,KAA4B,IAAI,EAAE;SAChD,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAI;QACxB,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,OAA2B,CAAC;QAChC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,IAAI,CAAC,KAAe,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAC3C,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;gBAClC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,MAAM,EAAE,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;gBACrF,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAAE,OAAO,GAAG,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAA2B,EAAE,CAAC,CAAC;QAC7F,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,iBAAiB,CAAC,eAAe,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI;YACJ,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,eAAe,EAAE,QAAQ,CAAC,eAAe;YACzC,UAAU,EAAE,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK;YACnF,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;SAC5C,CAAC,CAAC,CAAC;QACJ,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG;QAC3B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG;YACX,WAAW,EAAE,IAAI,CAAC,IAAc;YAChC,IAAI,EAAG,IAAI,CAAC,IAAe,IAAI,QAAQ;YACvC,OAAO,EAAE,IAAI,CAAC,OAA+B;YAC7C,OAAO,EAAE;gBACP,QAAQ,EAAE,IAAI,CAAC,QAA8B;gBAC7C,MAAM,EAAE,IAAI,CAAC,MAA6B;gBAC1C,WAAW,EAAG,IAAI,CAAC,WAAmC,IAAI,IAAI;aAC/D;SACF,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,6BAA6B,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnF,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,8BAA8B,EAAE,QAAQ,CAAC,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE;YAC7C,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE;YAC1F,MAAM,EAAE,IAAI,CAAC,MAA6B;SAC3C,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAI;QACxB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC5C,MAAM,UAAU,CAAC,KAAK,CAAC;YACrB,OAAO,EAAE,IAAI,CAAC,OAA+D;YAC7E,OAAO,EAAE,IAAI,CAAC,OAA6B;YAC3C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QACH,OAAO,0BAA0B,IAAI,CAAC,OAAO,EAAE,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAI;QACxB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAC;QAC9B,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,IAAI,CAAC,IAAI,CAAC,IAAI;oBAAE,OAAO,kCAAkC,CAAC;gBAC1D,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,IAAc,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC7F,OAAO,SAAS,CAAC,CAAC,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC;YACzE,CAAC;YACD,KAAK,MAAM;gBACT,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACrD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;gBAClC,OAAO,WAAW,KAAK,UAAU,CAAC;YACpC,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,IAAI,CAAC,EAAE;oBAAE,OAAO,yBAAyB,CAAC;gBAC/C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;gBACtD,OAAO,OAAO,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,EAAE,EAAE,CAAC;YAClE,CAAC;YACD;gBACE,OAAO,mBAAmB,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3G,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,GAAG;QAC/B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,gCAAgC,EAAE,QAAQ,CAAC,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,EAAE;YAC7C,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE;YAC1D,MAAM,EAAE,IAAI,CAAC,MAA6B;SAC3C,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG;QAChC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QACrE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QAClE,MAAM,UAAU,GAAI,IAAI,CAAC,UAAqB,IAAI,GAAG,CAAC,aAAa,CAAC;QACpE,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAC/B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE;gBACT,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;gBACxC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW;aACzC;SACF,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACd,CAAC;CACF,CAAC;AAEF,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,eAAe;IACb,KAAK,CAAC,WAAW,CACf,IAAY,EACZ,IAA6B,EAC7B,OAA0B;QAE1B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,wBAAwB,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACnE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACrF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,OAA4B;QAE5B,MAAM,QAAQ,GAA0B,EAAE,CAAC;QAE3C,iCAAiC;QACjC,IAAI,CAAC;YACH,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;YACtC,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC;oBACZ,EAAE,EAAE,iBAAiB;oBACrB,KAAK,EAAE,gCAAgC;oBACvC,OAAO,EAAE,MAAM;oBACf,QAAQ,EAAE,EAAE;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;QAED,uBAAuB;QACvB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;gBACrE,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;gBACrC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;oBAC1E,QAAQ,CAAC,IAAI,CAAC;wBACZ,EAAE,EAAE,sBAAsB;wBAC1B,KAAK,EAAE,sBAAsB;wBAC7B,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC;4BAC/B,8FAA8F;wBAChG,QAAQ,EAAE,EAAE;qBACb,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;gBAClE,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;gBACnC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;gBACrE,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;gBACrC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACxB,QAAQ,CAAC,IAAI,CAAC;4BACZ,EAAE,EAAE,oBAAoB;4BACxB,KAAK,EAAE,oBAAoB;4BAC3B,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1B,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,WAAW,EAAE,CACjD,CAAC,IAAI,CAAC,IAAI,CAAC;4BACZ,QAAQ,EAAE,EAAE;yBACb,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qCAAqC;YACvC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC"}

package/dist/docs/docs/weaver-bot-usage.md

@@ -0,0 +1,34 @@
+## Weaver Bot
+
+The Weaver bot is an autonomous AI agent that creates and modifies Flow Weaver workflows from natural language instructions.
+
+### Running the bot
+
+Use `fw_weaver_bot` with a task description:
+- `task`: Natural language instruction (required)
+- `mode`: `create` (new workflow), `modify` (edit existing), `read` (analyze), `batch` (multiple tasks)
+- `targets`: File paths for modify/read mode
+- `autoApprove`: Skip the approval gate (default: true in studio)
+
+### Execution flow
+
+1. **Receive task** — parses instruction and determines mode
+2. **Build context** — gathers project state, templates, and relevant files
+3. **Plan** — AI generates a step-by-step execution plan
+4. **Approval gate** — plan shown for review (skipped if autoApprove)
+5. **Execute + validate + retry** — runs steps, validates output, retries on errors (up to 3 attempts)
+6. **Git ops** — commits changes if successful
+7. **Report** — returns summary with outcome
+
+### Steering a running bot
+
+Use `fw_weaver_steer` to control execution:
+- `pause` — pause at next safe point
+- `resume` — continue after pause
+- `cancel` — abort execution
+- `redirect` — change task mid-execution
+- `queue` — add a follow-up task
+
+### Checking status
+
+Use `fw_weaver_status` to see the current bot session state, active task, and completion count.

package/dist/docs/docs/weaver-genesis.md

@@ -0,0 +1,32 @@
+## Genesis Self-Evolution
+
+Genesis is Weaver's self-evolution protocol. It autonomously observes, proposes, applies, and validates changes to workflows.
+
+### Running a Genesis cycle
+
+Use `fw_weaver_genesis` to trigger a single cycle:
+- `projectDir`: Project directory (defaults to workspace)
+- `dryRun`: Preview changes without applying
+
+### How it works
+
+1. **Observe** — scans project for workflows and their health
+2. **Fingerprint** — detects if workflows changed since last cycle (avoids duplicate proposals)
+3. **Stabilize check** — prevents rapid churn (cooldown between cycles)
+4. **Propose** — AI analyzes project state and proposes modifications within a budget
+5. **Validate proposal** — checks proposed changes are safe
+6. **Snapshot** — creates backup before applying
+7. **Apply** — executes proposed operations via `flow-weaver modify`
+8. **Validate result** — compiles and validates the modified workflow
+9. **Threshold check** — decides if changes meet the quality bar
+10. **Approve** — human approval gate (configurable)
+11. **Commit** — git commit with rollback capability
+12. **Escrow** — data safety pipeline for recovery
+
+### Safety features
+
+- Pre-apply snapshots for rollback
+- Escrow recovery from previous cycles
+- Fingerprinting prevents duplicate proposals
+- Threshold checking before committing
+- Budget limits on proposed changes

package/dist/docs/docs/weaver-task-queue.md

@@ -0,0 +1,34 @@
+## Task Queue & Steering
+
+Weaver supports queuing tasks for background processing and steering running bots in real-time.
+
+### Task queue
+
+Use `fw_weaver_queue` to manage tasks:
+- `add` — add a task to the queue (requires `task` instruction)
+- `list` — show all queued tasks
+- `clear` — remove all pending tasks
+- `remove` — remove a specific task by ID
+
+Tasks are stored in NDJSON format and processed sequentially by the bot session.
+
+### Steering commands
+
+Use `fw_weaver_steer` to control a running bot:
+- `pause` — pause execution at the next safe point
+- `resume` — continue after a pause
+- `cancel` — abort the current task
+- `redirect` — change the task instruction mid-execution (requires `payload` with new instruction)
+- `queue` — add a follow-up task without interrupting the current one
+
+### Batch mode
+
+For multiple related tasks, use `fw_weaver_bot` with `mode: "batch"` to process them in sequence through the same bot session, sharing context between tasks.
+
+### Monitoring
+
+Use `fw_weaver_status` to check the current session state:
+- Session phase (idle, planning, executing, validating)
+- Current task instruction
+- Completed task count
+- Error state if any

package/dist/docs/weaver-bot-usage.md

@@ -0,0 +1,34 @@
+## Weaver Bot
+
+The Weaver bot is an autonomous AI agent that creates and modifies Flow Weaver workflows from natural language instructions.
+
+### Running the bot
+
+Use `fw_weaver_bot` with a task description:
+- `task`: Natural language instruction (required)
+- `mode`: `create` (new workflow), `modify` (edit existing), `read` (analyze), `batch` (multiple tasks)
+- `targets`: File paths for modify/read mode
+- `autoApprove`: Skip the approval gate (default: true in studio)
+
+### Execution flow
+
+1. **Receive task** — parses instruction and determines mode
+2. **Build context** — gathers project state, templates, and relevant files
+3. **Plan** — AI generates a step-by-step execution plan
+4. **Approval gate** — plan shown for review (skipped if autoApprove)
+5. **Execute + validate + retry** — runs steps, validates output, retries on errors (up to 3 attempts)
+6. **Git ops** — commits changes if successful
+7. **Report** — returns summary with outcome
+
+### Steering a running bot
+
+Use `fw_weaver_steer` to control execution:
+- `pause` — pause at next safe point
+- `resume` — continue after pause
+- `cancel` — abort execution
+- `redirect` — change task mid-execution
+- `queue` — add a follow-up task
+
+### Checking status
+
+Use `fw_weaver_status` to see the current bot session state, active task, and completion count.

package/dist/docs/weaver-config.md

@@ -1,26 +1,20 @@
-# Weaver Configuration Reference
+# Weaver Bot Configuration Reference
 
-Weaver is a Flow Weaver workflow template that runs any other workflow autonomously. It auto-detects AI providers, resolves the target workflow, executes it with an agent channel, and sends notifications.
+The weaver bot runs workflows, executes tasks from natural language, and evolves autonomously. It auto-detects AI providers, manages approval gates, handles git operations, and sends notifications.
 
-Weaver has deep knowledge of the full flow-weaver ecosystem: annotation grammar, CLI tools, node patterns, error diagnosis, and the genesis protocol (loaded dynamically from `@synergenius/flow-weaver/doc-metadata`).
+The bot has deep knowledge of the full flow-weaver ecosystem: annotation grammar, CLI tools, node patterns, error diagnosis, and the genesis protocol (loaded dynamically from `@synergenius/flow-weaver/doc-metadata`).
 
 ## Getting started
 
-Scaffold via `flow-weaver init` and select the "AI Workflow Runner" use case, or use it programmatically:
-
-```typescript
-import { weaverTemplate } from '@synergenius/flowweaver-pack-weaver/templates';
-const source = weaverTemplate.generate({ projectDir: '.' });
-```
-
-Then compile and run:
+Run the bot directly via CLI:
 
 ```bash
-flow-weaver compile weaver.ts
-tsx weaver.ts
+flow-weaver weaver bot "Create a workflow that processes CSV files"
+flow-weaver weaver run my-workflow.ts
+flow-weaver weaver session
 ```
 
-Or run via MCP: `fw_execute_workflow` pointing at the compiled `weaver.ts`.
+Or scaffold a project via `flow-weaver init` and select the "AI Workflow Runner" use case.
 
 ## .weaver.json
 
@@ -127,7 +121,7 @@ import {
   detectProvider,
   runWorkflow,
   BotAgentChannel,
-} from '@synergenius/flowweaver-pack-weaver';
+} from '@synergenius/flow-weaver-pack-weaver';
 
 // Auto-detect and run
 const result = await runWorkflow('path/to/workflow.ts', { verbose: true });

package/dist/docs/weaver-genesis.md

@@ -0,0 +1,32 @@
+## Genesis Self-Evolution
+
+Genesis is Weaver's self-evolution protocol. It autonomously observes, proposes, applies, and validates changes to workflows.
+
+### Running a Genesis cycle
+
+Use `fw_weaver_genesis` to trigger a single cycle:
+- `projectDir`: Project directory (defaults to workspace)
+- `dryRun`: Preview changes without applying
+
+### How it works
+
+1. **Observe** — scans project for workflows and their health
+2. **Fingerprint** — detects if workflows changed since last cycle (avoids duplicate proposals)
+3. **Stabilize check** — prevents rapid churn (cooldown between cycles)
+4. **Propose** — AI analyzes project state and proposes modifications within a budget
+5. **Validate proposal** — checks proposed changes are safe
+6. **Snapshot** — creates backup before applying
+7. **Apply** — executes proposed operations via `flow-weaver modify`
+8. **Validate result** — compiles and validates the modified workflow
+9. **Threshold check** — decides if changes meet the quality bar
+10. **Approve** — human approval gate (configurable)
+11. **Commit** — git commit with rollback capability
+12. **Escrow** — data safety pipeline for recovery
+
+### Safety features
+
+- Pre-apply snapshots for rollback
+- Escrow recovery from previous cycles
+- Fingerprinting prevents duplicate proposals
+- Threshold checking before committing
+- Budget limits on proposed changes

package/dist/docs/weaver-task-queue.md

@@ -0,0 +1,34 @@
+## Task Queue & Steering
+
+Weaver supports queuing tasks for background processing and steering running bots in real-time.
+
+### Task queue
+
+Use `fw_weaver_queue` to manage tasks:
+- `add` — add a task to the queue (requires `task` instruction)
+- `list` — show all queued tasks
+- `clear` — remove all pending tasks
+- `remove` — remove a specific task by ID
+
+Tasks are stored in NDJSON format and processed sequentially by the bot session.
+
+### Steering commands
+
+Use `fw_weaver_steer` to control a running bot:
+- `pause` — pause execution at the next safe point
+- `resume` — continue after a pause
+- `cancel` — abort the current task
+- `redirect` — change the task instruction mid-execution (requires `payload` with new instruction)
+- `queue` — add a follow-up task without interrupting the current one
+
+### Batch mode
+
+For multiple related tasks, use `fw_weaver_bot` with `mode: "batch"` to process them in sequence through the same bot session, sharing context between tasks.
+
+### Monitoring
+
+Use `fw_weaver_status` to check the current session state:
+- Session phase (idle, planning, executing, validating)
+- Current task instruction
+- Completed task count
+- Error state if any