@synergenius/flow-weaver 0.20.7 → 0.21.0

package/dist/cli/index.js

@@ -22,10 +22,7 @@ import { doctorCommand } from './commands/doctor.js';
 import { initCommand } from './commands/init.js';
 import { watchCommand } from './commands/watch.js';
 import { devCommand } from './commands/dev.js';
-import { listenCommand } from './commands/listen.js';
-import { tunnelCommand } from './commands/tunnel.js';
 import { mcpServerCommand } from '../mcp/server.js';
-import { uiFocusNode, uiAddNode, uiOpenWorkflow, uiGetState, uiBatch } from './commands/ui.js';
 import { grammarCommand } from './commands/grammar.js';
 import { runCommand } from './commands/run.js';
 import { serveCommand } from './commands/serve.js';
@@ -44,7 +41,6 @@ import { marketInitCommand, marketPackCommand, marketPublishCommand, marketInsta
 import { mcpSetupCommand } from './commands/mcp-setup.js';
 import { logger } from './utils/logger.js';
 import { getErrorMessage } from '../utils/error-utils.js';
-import { DEFAULT_SERVER_URL } from '../defaults.js';
 const version = typeof __CLI_VERSION__ !== 'undefined' ? __CLI_VERSION__ : '0.0.0-dev';
 const program = new Command();
 program
@@ -250,29 +246,10 @@ program
     .action(wrapAction(async (input, options) => {
     await devCommand(input, options);
 }));
-// Listen command
-program
-    .command('listen')
-    .description('Connect to Studio and stream integration events as JSON lines')
-    .option('-s, --server <url>', 'Studio URL', DEFAULT_SERVER_URL)
-    .action(wrapAction(async (options) => {
-    await listenCommand(options);
-}));
-// Tunnel command
-program
-    .command('tunnel')
-    .description('Connect cloud Studio to your local project directory')
-    .requiredOption('-k, --key <apiKey>', 'API key for cloud authentication (fw_xxxx)')
-    .option('-c, --cloud <url>', 'Cloud server URL', 'https://flowweaver.dev')
-    .option('-d, --dir <path>', 'Project directory', process.cwd())
-    .action(wrapAction(async (options) => {
-    await tunnelCommand(options);
-}));
 // MCP server command
 program
     .command('mcp-server')
     .description('Start MCP server for Claude Code integration')
-    .option('-s, --server <url>', 'Studio URL', DEFAULT_SERVER_URL)
     .option('--stdio', 'Run in MCP stdio mode (skip interactive registration)')
     .action(wrapAction(async (options) => {
     await mcpServerCommand(options);
@@ -287,43 +264,6 @@ program
     .action(wrapAction(async (options) => {
     await mcpSetupCommand(options);
 }));
-// UI command group (send commands to Studio)
-const uiCmd = program.command('ui').description('Send commands to Studio');
-uiCmd
-    .command('focus-node <nodeId>')
-    .description('Select and center a node in Studio')
-    .option('-s, --server <url>', 'Studio URL', DEFAULT_SERVER_URL)
-    .action(wrapAction(async (nodeId, options) => {
-    await uiFocusNode(nodeId, options);
-}));
-uiCmd
-    .command('add-node <nodeTypeName>')
-    .description('Add a node at viewport center')
-    .option('-s, --server <url>', 'Studio URL', DEFAULT_SERVER_URL)
-    .action(wrapAction(async (nodeTypeName, options) => {
-    await uiAddNode(nodeTypeName, options);
-}));
-uiCmd
-    .command('open-workflow <filePath>')
-    .description('Open a workflow file in Studio')
-    .option('-s, --server <url>', 'Studio URL', DEFAULT_SERVER_URL)
-    .action(wrapAction(async (filePath, options) => {
-    await uiOpenWorkflow(filePath, options);
-}));
-uiCmd
-    .command('get-state')
-    .description('Return current workflow state from Studio')
-    .option('-s, --server <url>', 'Studio URL', DEFAULT_SERVER_URL)
-    .action(wrapAction(async (options) => {
-    await uiGetState(options);
-}));
-uiCmd
-    .command('batch <json>')
-    .description('Execute a batch of commands with auto-snapshot rollback')
-    .option('-s, --server <url>', 'Studio URL', DEFAULT_SERVER_URL)
-    .action(wrapAction(async (json, options) => {
-    await uiBatch(json, options);
-}));
 // Create command (with subcommands)
 const createCmd = program.command('create').description('Create workflows or nodes from templates');
 createCmd

package/dist/doc-metadata/extractors/cli-commands.js

@@ -6,7 +6,6 @@
  * Template lists are generated from the actual template registries.
  */
 import { workflowTemplates, nodeTemplates } from '../../cli/templates/index.js';
-import { DEFAULT_SERVER_URL } from '../../defaults.js';
 /**
  * CLI command definitions - single source of truth for CLI documentation
  */
@@ -16,6 +15,7 @@ export const CLI_COMMANDS = [
         name: 'compile',
         syntax: 'flow-weaver compile <file> [options]',
         description: 'Compile workflow source file',
+        botCompatible: true,
         options: [
             { flags: '-o, --output', arg: '<path>', description: 'Output file or directory' },
             { flags: '-p, --production', description: 'Production build (no debug events)' },
@@ -31,6 +31,7 @@ export const CLI_COMMANDS = [
         name: 'validate',
         syntax: 'flow-weaver validate <file> [options]',
         description: 'Validate workflow without compiling',
+        botCompatible: true,
         options: [
             { flags: '-w, --workflow-name', arg: '<name>', description: 'Target specific workflow' },
             { flags: '--json', description: 'Output as JSON', exclusive: 'output-mode' },
@@ -43,6 +44,7 @@ export const CLI_COMMANDS = [
         name: 'describe',
         syntax: 'flow-weaver describe <file> [options]',
         description: 'Output workflow structure in LLM-friendly formats (JSON, text, mermaid)',
+        botCompatible: true,
         options: [
             { flags: '-f, --format', arg: 'json|text|mermaid|paths', description: 'Output format (paths: enumerate all Start-to-Exit paths via DFS)' },
             { flags: '-w, --workflow-name', arg: '<name>', description: 'Target workflow' },
@@ -54,6 +56,7 @@ export const CLI_COMMANDS = [
         name: 'run',
         syntax: 'flow-weaver run <file> [options]',
         description: 'Execute a workflow file directly',
+        botCompatible: true,
         options: [
             { flags: '-w, --workflow', arg: '<name>', description: 'Specific workflow to run' },
             { flags: '--params', arg: '<json>', description: 'Input parameters as JSON string', exclusive: 'params' },
@@ -83,6 +86,7 @@ export const CLI_COMMANDS = [
         name: 'create workflow',
         syntax: 'flow-weaver create workflow <template> <file> [options]',
         description: 'Create new workflow from template',
+        botCompatible: true,
         group: 'create',
         positionalChoices: {
             template: workflowTemplates.map(t => ({ id: t.id, label: t.id })),
@@ -104,6 +108,7 @@ export const CLI_COMMANDS = [
         name: 'create node',
         syntax: 'flow-weaver create node <name> <file> [options]',
         description: 'Create a node type from template',
+        botCompatible: true,
         group: 'create',
         options: [
             { flags: '-t, --template', arg: nodeTemplates.map(t => t.id).join('|'), description: 'Node template to use', defaultValue: 'processor' },
@@ -116,6 +121,7 @@ export const CLI_COMMANDS = [
         name: 'templates',
         syntax: 'flow-weaver templates [--json]',
         description: `List available workflow templates (${workflowTemplates.length} total)`,
+        botCompatible: true,
         listStyle: 'definition',
         options: [
             { flags: '--json', description: 'Output as JSON' },
@@ -135,6 +141,7 @@ export const CLI_COMMANDS = [
         name: 'pattern list',
         syntax: 'flow-weaver pattern list <path> [--json]',
         description: 'List patterns in file or directory',
+        botCompatible: true,
         group: 'pattern',
         options: [
             { flags: '--json', description: 'Output as JSON' },
@@ -144,6 +151,7 @@ export const CLI_COMMANDS = [
         name: 'pattern apply',
         syntax: 'flow-weaver pattern apply <pattern-file> <target-file> [options]',
         description: 'Apply a pattern to a workflow file',
+        botCompatible: true,
         group: 'pattern',
         options: [
             { flags: '-p, --preview', description: 'Preview changes without writing' },
@@ -155,6 +163,7 @@ export const CLI_COMMANDS = [
         name: 'pattern extract',
         syntax: 'flow-weaver pattern extract <source-file> --nodes <ids> -o <file> [options]',
         description: 'Extract nodes as reusable pattern',
+        botCompatible: true,
         group: 'pattern',
         options: [
             { flags: '--nodes', arg: '<ids>', description: 'Comma-separated list of node IDs to extract', required: true },
@@ -196,15 +205,40 @@ export const CLI_COMMANDS = [
         name: 'doctor',
         syntax: 'flow-weaver doctor [--json]',
         description: 'Check project environment and configuration. Validates Node.js version, TypeScript, package installation, and tsconfig.json settings.',
+        botCompatible: true,
         options: [
             { flags: '--json', description: 'Output results as JSON' },
         ],
     },
+    // ── Context ─────────────────────────────────────────────────────
+    {
+        name: 'context',
+        syntax: 'flow-weaver context [preset] [options]',
+        description: 'Generate LLM context bundle from documentation and grammar',
+        botCompatible: true,
+        options: [
+            { flags: '--profile', arg: 'standalone|assistant', description: 'Output profile', defaultValue: 'standalone' },
+            { flags: '--topics', arg: '<slugs>', description: 'Comma-separated topic slugs (overrides preset)' },
+            { flags: '--add', arg: '<slugs>', description: 'Extra topic slugs to add to preset' },
+            { flags: '--no-grammar', description: 'Omit EBNF grammar section' },
+            { flags: '-o, --output', arg: '<path>', description: 'Write to file instead of stdout' },
+            { flags: '--list', description: 'List available presets and exit' },
+        ],
+        positionalChoices: {
+            preset: [
+                { id: 'core', label: 'core' },
+                { id: 'authoring', label: 'authoring' },
+                { id: 'ops', label: 'ops' },
+                { id: 'full', label: 'full' },
+            ],
+        },
+    },
     // ── Export & generation ────────────────────────────────────────
     {
         name: 'export',
         syntax: 'flow-weaver export <file> -t <target> -o <path> [options]',
         description: 'Export workflow as serverless function',
+        botCompatible: true,
         options: [
             { flags: '-t, --target', arg: '<target>', description: 'Target platform (provided by installed packs)', required: true },
             { flags: '-o, --output', arg: '<path>', description: 'Output directory', required: true },
@@ -220,6 +254,7 @@ export const CLI_COMMANDS = [
         name: 'diff',
         syntax: 'flow-weaver diff <file1> <file2> [options]',
         description: 'Semantic diff between two workflow files',
+        botCompatible: true,
         options: [
             { flags: '-f, --format', arg: 'text|json|compact', description: 'Output format', defaultValue: 'text' },
             { flags: '-w, --workflow-name', arg: '<name>', description: 'Specific workflow to compare' },
@@ -249,69 +284,14 @@ export const CLI_COMMANDS = [
         ],
     },
     // ── Integration commands ───────────────────────────────────────
-    {
-        name: 'listen',
-        syntax: 'flow-weaver listen [options]',
-        description: 'Connect to the editor and stream integration events as JSON lines',
-        options: [
-            { flags: '-s, --server', arg: '<url>', description: 'Editor URL', defaultValue: DEFAULT_SERVER_URL },
-        ],
-    },
     {
         name: 'mcp-server',
         syntax: 'flow-weaver mcp-server [options]',
         description: 'Start MCP server for Claude Code integration',
         options: [
-            { flags: '-s, --server', arg: '<url>', description: 'Editor URL', defaultValue: DEFAULT_SERVER_URL },
             { flags: '--stdio', description: 'Run in MCP stdio mode (skip interactive registration)' },
         ],
     },
-    // ── UI subcommands ─────────────────────────────────────────────
-    {
-        name: 'ui focus-node',
-        syntax: 'flow-weaver ui focus-node <nodeId> [options]',
-        description: 'Select and center a node in the editor',
-        group: 'ui',
-        options: [
-            { flags: '-s, --server', arg: '<url>', description: 'Editor URL', defaultValue: DEFAULT_SERVER_URL },
-        ],
-    },
-    {
-        name: 'ui add-node',
-        syntax: 'flow-weaver ui add-node <nodeTypeName> [options]',
-        description: 'Add a node at viewport center',
-        group: 'ui',
-        options: [
-            { flags: '-s, --server', arg: '<url>', description: 'Editor URL', defaultValue: DEFAULT_SERVER_URL },
-        ],
-    },
-    {
-        name: 'ui open-workflow',
-        syntax: 'flow-weaver ui open-workflow <filePath> [options]',
-        description: 'Open a workflow file in the editor',
-        group: 'ui',
-        options: [
-            { flags: '-s, --server', arg: '<url>', description: 'Editor URL', defaultValue: DEFAULT_SERVER_URL },
-        ],
-    },
-    {
-        name: 'ui get-state',
-        syntax: 'flow-weaver ui get-state [options]',
-        description: 'Return current workflow state from the editor',
-        group: 'ui',
-        options: [
-            { flags: '-s, --server', arg: '<url>', description: 'Editor URL', defaultValue: DEFAULT_SERVER_URL },
-        ],
-    },
-    {
-        name: 'ui batch',
-        syntax: 'flow-weaver ui batch <json> [options]',
-        description: 'Execute a batch of commands with auto-snapshot rollback',
-        group: 'ui',
-        options: [
-            { flags: '-s, --server', arg: '<url>', description: 'Editor URL', defaultValue: DEFAULT_SERVER_URL },
-        ],
-    },
     // ── Plugin subcommands ─────────────────────────────────────────
     {
         name: 'plugin init',
@@ -330,6 +310,7 @@ export const CLI_COMMANDS = [
         name: 'migrate',
         syntax: 'flow-weaver migrate <glob> [options]',
         description: 'Migrate workflow files to current syntax via parse → regenerate round-trip',
+        botCompatible: true,
         options: [
             { flags: '--dry-run', description: 'Preview changes without writing files' },
             { flags: '--diff', description: 'Show semantic diff before/after' },

package/dist/doc-metadata/extractors/mcp-tools.d.ts

@@ -2,7 +2,7 @@
  * Extractor for MCP tool documentation
  *
  * This defines all MCP tools with their descriptions and parameters.
- * The data is extracted from the tool registration files (tools-query.ts, tools-template.ts, tools-pattern.ts, tools-editor.ts, tools-export.ts).
+ * The data is extracted from the tool registration files (tools-query.ts, tools-template.ts, tools-pattern.ts, tools-export.ts).
  */
 import type { TMcpToolDoc } from '../types.js';
 /**

package/dist/doc-metadata/extractors/mcp-tools.js

@@ -2,7 +2,7 @@
  * Extractor for MCP tool documentation
  *
  * This defines all MCP tools with their descriptions and parameters.
- * The data is extracted from the tool registration files (tools-query.ts, tools-template.ts, tools-pattern.ts, tools-editor.ts, tools-export.ts).
+ * The data is extracted from the tool registration files (tools-query.ts, tools-template.ts, tools-pattern.ts, tools-export.ts).
  */
 /**
  * MCP tool definitions - single source of truth for tool documentation
@@ -410,218 +410,6 @@ export const MCP_TOOLS = [
             },
         ],
     },
-    // Editor tools (tools-editor.ts)
-    {
-        name: 'fw_get_state',
-        description: 'Get the current editor/workflow state from Flow Weaver.',
-        category: 'editor',
-        params: [],
-    },
-    {
-        name: 'fw_check_events',
-        description: 'Get buffered editor events. Returns and clears the event buffer unless peek=true.',
-        category: 'editor',
-        params: [
-            {
-                name: 'peek',
-                type: 'boolean',
-                description: 'If true, return events without clearing the buffer',
-                required: false,
-            },
-        ],
-    },
-    {
-        name: 'fw_configure_events',
-        description: 'Configure event include/exclude filters, dedup window, and buffer size. Returns the active config after applying updates.',
-        category: 'editor',
-        params: [
-            {
-                name: 'include',
-                type: 'array',
-                description: 'Event types to include',
-                required: false,
-            },
-            {
-                name: 'exclude',
-                type: 'array',
-                description: 'Event types to exclude',
-                required: false,
-            },
-            {
-                name: 'dedupeWindowMs',
-                type: 'number',
-                description: 'Deduplication window in milliseconds',
-                required: false,
-            },
-            {
-                name: 'maxBufferSize',
-                type: 'number',
-                description: 'Maximum event buffer size',
-                required: false,
-            },
-        ],
-    },
-    {
-        name: 'fw_focus_node',
-        description: 'Select and center a node in the Flow Weaver editor.',
-        category: 'editor',
-        params: [
-            {
-                name: 'nodeId',
-                type: 'string',
-                description: 'ID of the node to focus',
-                required: true,
-            },
-        ],
-    },
-    {
-        name: 'fw_add_node',
-        description: 'Add a new node to the workflow in the Flow Weaver editor.',
-        category: 'editor',
-        params: [
-            {
-                name: 'nodeTypeName',
-                type: 'string',
-                description: 'Name of the node type to add',
-                required: true,
-            },
-            {
-                name: 'nodeTypeDefinition',
-                type: 'object',
-                description: 'Optional node type definition if creating a new type',
-                required: false,
-            },
-        ],
-    },
-    {
-        name: 'fw_remove_node',
-        description: 'Remove a node and its connections from the workflow.',
-        category: 'editor',
-        params: [
-            {
-                name: 'nodeName',
-                type: 'string',
-                description: 'Name of the node to remove',
-                required: true,
-            },
-        ],
-    },
-    {
-        name: 'fw_connect',
-        description: 'Add or remove a connection between ports.',
-        category: 'editor',
-        params: [
-            {
-                name: 'action',
-                type: 'string',
-                description: 'Whether to add or remove the connection',
-                required: true,
-                enum: ['add', 'remove'],
-            },
-            {
-                name: 'connection',
-                type: 'object',
-                description: 'Connection details: { sourceNode, sourcePort, targetNode, targetPort }',
-                required: true,
-            },
-        ],
-    },
-    {
-        name: 'fw_open_workflow',
-        description: 'Open a workflow file in the Flow Weaver editor.',
-        category: 'editor',
-        params: [
-            {
-                name: 'filePath',
-                type: 'string',
-                description: 'Path to the workflow file to open',
-                required: true,
-            },
-        ],
-    },
-    {
-        name: 'fw_send_command',
-        description: 'Send a generic command to the Flow Weaver editor.',
-        category: 'editor',
-        params: [
-            {
-                name: 'action',
-                type: 'string',
-                description: 'Command action name',
-                required: true,
-            },
-            {
-                name: 'params',
-                type: 'object',
-                description: 'Optional command parameters',
-                required: false,
-            },
-        ],
-    },
-    {
-        name: 'fw_batch',
-        description: 'Execute a batch of commands with auto-snapshot rollback support.',
-        category: 'editor',
-        params: [
-            {
-                name: 'commands',
-                type: 'array',
-                description: 'Array of commands to execute. Each command has { action, params? }.',
-                required: true,
-            },
-        ],
-    },
-    {
-        name: 'fw_undo_redo',
-        description: 'Undo or redo the last workflow change.',
-        category: 'editor',
-        params: [
-            {
-                name: 'action',
-                type: 'string',
-                description: 'Whether to undo or redo',
-                required: true,
-                enum: ['undo', 'redo'],
-            },
-        ],
-    },
-    {
-        name: 'fw_execute_workflow',
-        description: 'Run the current workflow with optional parameters and return the result.',
-        category: 'editor',
-        params: [
-            {
-                name: 'filePath',
-                type: 'string',
-                description: 'Path to workflow file (uses current if omitted)',
-                required: false,
-            },
-            {
-                name: 'workflowName',
-                type: 'string',
-                description: 'Specific workflow name',
-                required: false,
-            },
-            {
-                name: 'params',
-                type: 'object',
-                description: 'Input parameters for the workflow',
-                required: false,
-            },
-            {
-                name: 'includeTrace',
-                type: 'boolean',
-                description: 'Include execution trace events',
-                required: false,
-            },
-        ],
-    },
-    {
-        name: 'fw_get_workflow_details',
-        description: 'Get full workflow structure including nodes, connections, types, and positions.',
-        category: 'editor',
-        params: [],
-    },
     // Export tools (tools-export.ts)
     {
         name: 'fw_export',

package/dist/doc-metadata/types.d.ts

@@ -122,5 +122,7 @@ export interface TCliCommandDoc {
         id: string;
         label: string;
     }[]>;
+    /** Whether the command is available for programmatic bot/agent use via runCommand */
+    botCompatible?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/generated-version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.20.7";
+export declare const VERSION = "0.21.0";
 //# sourceMappingURL=generated-version.d.ts.map

package/dist/generated-version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.ts — do not edit manually
-export const VERSION = '0.20.7';
+export const VERSION = '0.21.0';
 //# sourceMappingURL=generated-version.js.map

package/dist/mcp/index.d.ts

@@ -1,14 +1,10 @@
-export type { McpServerOptions, RegistrationDeps, AckResponse, BufferedEvent, EditorConnectionOptions, } from './types.js';
-export { EventBuffer } from './event-buffer.js';
-export { EditorConnection } from './editor-connection.js';
+export type { McpServerOptions, RegistrationDeps, } from './types.js';
 export { offerClaudeRegistration } from './auto-registration.js';
 export { makeToolResult, makeErrorResult } from './response-utils.js';
-export { registerEditorTools } from './tools-editor.js';
 export { registerQueryTools } from './tools-query.js';
 export { registerTemplateTools } from './tools-template.js';
 export { registerPatternTools } from './tools-pattern.js';
 export { registerDebugTools } from './tools-debug.js';
-export { registerResources } from './resources.js';
 export { registerPrompts } from './prompts.js';
 export { startMcpServer, mcpServerCommand } from './server.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.js

@@ -1,13 +1,9 @@
-export { EventBuffer } from './event-buffer.js';
-export { EditorConnection } from './editor-connection.js';
 export { offerClaudeRegistration } from './auto-registration.js';
 export { makeToolResult, makeErrorResult } from './response-utils.js';
-export { registerEditorTools } from './tools-editor.js';
 export { registerQueryTools } from './tools-query.js';
 export { registerTemplateTools } from './tools-template.js';
 export { registerPatternTools } from './tools-pattern.js';
 export { registerDebugTools } from './tools-debug.js';
-export { registerResources } from './resources.js';
 export { registerPrompts } from './prompts.js';
 export { startMcpServer, mcpServerCommand } from './server.js';
 //# sourceMappingURL=index.js.map