@synergenius/flow-weaver 0.22.0 → 0.22.3

package/dist/cli/index.js

@@ -10,35 +10,6 @@ import './env-setup.js';
 // Load built-in extensions (CI/CD, etc.) before any commands run
 import '../extensions/index.js';
 import { Command, Option } from 'commander';
-import { compileCommand } from './commands/compile.js';
-import { createWorkflowCommand, createNodeCommand } from './commands/create.js';
-import { describeCommand } from './commands/describe.js';
-import { diagramCommand } from './commands/diagram.js';
-import { diffCommand } from './commands/diff.js';
-import { patternListCommand, patternApplyCommand, patternExtractCommand, } from './commands/pattern.js';
-import { templatesCommand } from './commands/templates.js';
-import { validateCommand } from './commands/validate.js';
-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 { mcpServerCommand } from '../mcp/server.js';
-import { grammarCommand } from './commands/grammar.js';
-import { runCommand } from './commands/run.js';
-import { serveCommand } from './commands/serve.js';
-import { exportCommand } from './commands/export.js';
-import { openapiCommand } from './commands/openapi.js';
-import { pluginInitCommand } from './commands/plugin.js';
-import { migrateCommand } from './commands/migrate.js';
-import { changelogCommand } from './commands/changelog.js';
-import { stripCommand } from './commands/strip.js';
-import { docsListCommand, docsReadCommand, docsSearchCommand } from './commands/docs.js';
-import { contextCommand } from './commands/context.js';
-import { statusCommand } from './commands/status.js';
-import { implementCommand } from './commands/implement.js';
-import { modifyAddNodeCommand, modifyRemoveNodeCommand, modifyAddConnectionCommand, modifyRemoveConnectionCommand, modifyRenameNodeCommand, modifySetPositionCommand, modifySetLabelCommand, } from './commands/modify.js';
-import { marketInitCommand, marketPackCommand, marketPublishCommand, marketInstallCommand, marketSearchCommand, marketListCommand, } from './commands/market.js';
-import { mcpSetupCommand } from './commands/mcp-setup.js';
 import { logger } from './utils/logger.js';
 import { getErrorMessage } from '../utils/error-utils.js';
 const version = typeof __CLI_VERSION__ !== 'undefined' ? __CLI_VERSION__ : '0.0.0-dev';
@@ -109,6 +80,7 @@ program
     .option('--retries <n>', 'Number of retries per function', parseInt)
     .option('--timeout <duration>', 'Function timeout (e.g. "30m", "1h")')
     .action(wrapAction(async (input, options) => {
+    const { compileCommand } = await import('./commands/compile.js');
     if (options.workflow)
         options.workflowName = options.workflow;
     await compileCommand(input, options);
@@ -121,6 +93,7 @@ program
     .option('--dry-run', 'Preview without writing', false)
     .option('--verbose', 'Verbose output', false)
     .action(wrapAction(async (input, options) => {
+    const { stripCommand } = await import('./commands/strip.js');
     await stripCommand(input, options);
 }));
 // Describe command
@@ -132,6 +105,7 @@ program
     .option('--compile', 'Also update runtime markers in the source file')
     .option('-w, --workflow <name>', 'Specific workflow name to describe')
     .action(wrapAction(async (input, options) => {
+    const { describeCommand } = await import('./commands/describe.js');
     if (options.workflow)
         options.workflowName = options.workflow;
     await describeCommand(input, options);
@@ -155,6 +129,7 @@ program
     options.showPortLabels = options.portLabels;
     if (options.workflow)
         options.workflowName = options.workflow;
+    const { diagramCommand } = await import('./commands/diagram.js');
     await diagramCommand(input, options);
 }));
 // Diff command
@@ -165,6 +140,7 @@ program
     .option('-w, --workflow <name>', 'Specific workflow name to compare')
     .option('--exit-zero', 'Exit 0 even when differences are found', false)
     .action(wrapAction(async (file1, file2, options) => {
+    const { diffCommand } = await import('./commands/diff.js');
     if (options.workflow)
         options.workflowName = options.workflow;
     await diffCommand(file1, file2, options);
@@ -179,6 +155,7 @@ program
     .option('-w, --workflow <name>', 'Specific workflow name to validate')
     .option('--strict', 'Treat type coercion warnings as errors', false)
     .action(wrapAction(async (input, options) => {
+    const { validateCommand } = await import('./commands/validate.js');
     if (options.workflow)
         options.workflowName = options.workflow;
     await validateCommand(input, options);
@@ -189,6 +166,7 @@ program
     .description('Check project environment and configuration for flow-weaver compatibility')
     .option('--json', 'Output results as JSON', false)
     .action(wrapAction(async (options) => {
+    const { doctorCommand } = await import('./commands/doctor.js');
     await doctorCommand(options);
 }));
 // Init command
@@ -211,6 +189,7 @@ program
     .option('--force', 'Overwrite existing files', false)
     .option('--json', 'Output results as JSON', false)
     .action(wrapAction(async (directory, options) => {
+    const { initCommand } = await import('./commands/init.js');
     await initCommand(directory, options);
 }));
 // Watch command
@@ -224,6 +203,7 @@ program
     .option('-w, --workflow <name>', 'Specific workflow name to compile')
     .option('-f, --format <format>', 'Module format: esm, cjs, or auto', 'auto')
     .action(wrapAction(async (input, options) => {
+    const { watchCommand } = await import('./commands/watch.js');
     if (options.workflow)
         options.workflowName = options.workflow;
     await watchCommand(input, options);
@@ -244,6 +224,7 @@ program
     .option('--framework <framework>', 'Framework for serve handler', 'express')
     .option('--port <port>', 'Port for dev server', (v) => parseInt(v, 10), 3000)
     .action(wrapAction(async (input, options) => {
+    const { devCommand } = await import('./commands/dev.js');
     await devCommand(input, options);
 }));
 // MCP server command
@@ -252,6 +233,7 @@ program
     .description('Start MCP server for Claude Code integration')
     .option('--stdio', 'Run in MCP stdio mode (skip interactive registration)')
     .action(wrapAction(async (options) => {
+    const { mcpServerCommand } = await import('../mcp/server.js');
     await mcpServerCommand(options);
 }));
 // MCP setup command
@@ -262,6 +244,7 @@ program
     .option('--all', 'Configure all detected tools without prompting')
     .option('--list', 'List detected tools without configuring')
     .action(wrapAction(async (options) => {
+    const { mcpSetupCommand } = await import('./commands/mcp-setup.js');
     await mcpSetupCommand(options);
 }));
 // Create command (with subcommands)
@@ -280,6 +263,7 @@ createCmd
     .option('--input <name>', 'Custom input port name (default: "data")')
     .option('--output <name>', 'Custom output port name (default: "result")')
     .action(wrapAction(async (template, file, options) => {
+    const { createWorkflowCommand } = await import('./commands/create.js');
     await createWorkflowCommand(template, file, options);
 }));
 createCmd
@@ -291,6 +275,7 @@ createCmd
     .option('--strategy <strategy>', 'Template strategy (e.g. mock, callback, webhook)')
     .option('--config <json>', 'Additional configuration (JSON)')
     .action(wrapAction(async (name, file, options) => {
+    const { createNodeCommand } = await import('./commands/create.js');
     await createNodeCommand(name, file, options);
 }));
 // Modify command (with subcommands)
@@ -302,6 +287,7 @@ modifyCmd
     .requiredOption('--nodeId <id>', 'Node instance ID')
     .requiredOption('--nodeType <type>', 'Node type name')
     .action(wrapAction(async (options) => {
+    const { modifyAddNodeCommand } = await import('./commands/modify.js');
     await modifyAddNodeCommand(options.file, options);
 }));
 modifyCmd
@@ -310,6 +296,7 @@ modifyCmd
     .requiredOption('--file <path>', 'Workflow file')
     .requiredOption('--nodeId <id>', 'Node instance ID')
     .action(wrapAction(async (options) => {
+    const { modifyRemoveNodeCommand } = await import('./commands/modify.js');
     await modifyRemoveNodeCommand(options.file, options);
 }));
 modifyCmd
@@ -319,6 +306,7 @@ modifyCmd
     .requiredOption('--from <node.port>', 'Source (e.g. nodeA.output)')
     .requiredOption('--to <node.port>', 'Target (e.g. nodeB.input)')
     .action(wrapAction(async (options) => {
+    const { modifyAddConnectionCommand } = await import('./commands/modify.js');
     await modifyAddConnectionCommand(options.file, options);
 }));
 modifyCmd
@@ -328,6 +316,7 @@ modifyCmd
     .requiredOption('--from <node.port>', 'Source (e.g. nodeA.output)')
     .requiredOption('--to <node.port>', 'Target (e.g. nodeB.input)')
     .action(wrapAction(async (options) => {
+    const { modifyRemoveConnectionCommand } = await import('./commands/modify.js');
     await modifyRemoveConnectionCommand(options.file, options);
 }));
 modifyCmd
@@ -337,6 +326,7 @@ modifyCmd
     .requiredOption('--oldId <id>', 'Current node ID')
     .requiredOption('--newId <id>', 'New node ID')
     .action(wrapAction(async (options) => {
+    const { modifyRenameNodeCommand } = await import('./commands/modify.js');
     await modifyRenameNodeCommand(options.file, options);
 }));
 modifyCmd
@@ -347,6 +337,7 @@ modifyCmd
     .requiredOption('--x <number>', 'X coordinate')
     .requiredOption('--y <number>', 'Y coordinate')
     .action(wrapAction(async (options) => {
+    const { modifySetPositionCommand } = await import('./commands/modify.js');
     await modifySetPositionCommand(options.file, options);
 }));
 modifyCmd
@@ -356,6 +347,7 @@ modifyCmd
     .requiredOption('--nodeId <id>', 'Node instance ID')
     .requiredOption('--label <text>', 'Display label')
     .action(wrapAction(async (options) => {
+    const { modifySetLabelCommand } = await import('./commands/modify.js');
     await modifySetLabelCommand(options.file, options);
 }));
 // Templates command
@@ -364,6 +356,7 @@ program
     .description('List available templates')
     .option('--json', 'Output as JSON', false)
     .action(wrapAction(async (options) => {
+    const { templatesCommand } = await import('./commands/templates.js');
     await templatesCommand(options);
 }));
 // Grammar command
@@ -373,6 +366,7 @@ program
     .addOption(new Option('-f, --format <format>', 'Output format').choices(['html', 'ebnf']))
     .option('-o, --output <path>', 'Write output to file instead of stdout')
     .action(wrapAction(async (options) => {
+    const { grammarCommand } = await import('./commands/grammar.js');
     await grammarCommand(options);
 }));
 // Pattern command (with subcommands)
@@ -382,6 +376,7 @@ patternCmd
     .description('List patterns in a file or directory')
     .option('--json', 'Output as JSON', false)
     .action(wrapAction(async (inputPath, options) => {
+    const { patternListCommand } = await import('./commands/pattern.js');
     await patternListCommand(inputPath, options);
 }));
 patternCmd
@@ -391,6 +386,7 @@ patternCmd
     .option('--prefix <prefix>', 'Prefix for node instance IDs')
     .option('-n, --name <name>', 'Specific pattern name to apply')
     .action(wrapAction(async (patternFile, targetFile, options) => {
+    const { patternApplyCommand } = await import('./commands/pattern.js');
     await patternApplyCommand(patternFile, targetFile, options);
 }));
 patternCmd
@@ -401,6 +397,7 @@ patternCmd
     .option('-n, --name <name>', 'Pattern name')
     .option('-p, --preview', 'Preview pattern without writing', false)
     .action(wrapAction(async (sourceFile, options) => {
+    const { patternExtractCommand } = await import('./commands/pattern.js');
     await patternExtractCommand(sourceFile, options);
 }));
 // Run command
@@ -422,6 +419,7 @@ program
     .option('--resume [file]', 'Resume from a checkpoint file (auto-detects latest if no file)')
     .option('-b, --breakpoint <nodeIds...>', 'Set initial breakpoints (repeatable)')
     .action(wrapAction(async (input, options) => {
+    const { runCommand } = await import('./commands/run.js');
     await runCommand(input, options);
 }));
 // Serve command
@@ -436,6 +434,7 @@ program
     .option('--cors <origin>', 'CORS origin', '*')
     .option('--swagger', 'Enable Swagger UI at /docs', false)
     .action(wrapAction(async (directory, options) => {
+    const { serveCommand } = await import('./commands/serve.js');
     await serveCommand(directory, {
         port: parseInt(options.port, 10),
         host: options.host,
@@ -460,6 +459,7 @@ program
     .option('--docs', 'Include API documentation routes (/docs and /openapi.json)', false)
     .option('--durable-steps', 'Use deep generator with per-node durable steps', false)
     .action(wrapAction(async (input, options) => {
+    const { exportCommand } = await import('./commands/export.js');
     await exportCommand(input, options);
 }));
 // OpenAPI command
@@ -473,6 +473,7 @@ program
     .option('-f, --format <format>', 'Output format: json, yaml', 'json')
     .option('--server <url>', 'Server URL')
     .action(wrapAction(async (directory, options) => {
+    const { openapiCommand } = await import('./commands/openapi.js');
     await openapiCommand(directory, options);
 }));
 // Plugin command group
@@ -485,6 +486,7 @@ pluginCmd
     .option('-p, --preview', 'Preview generated files without writing', false)
     .option('--force', 'Overwrite existing files', false)
     .action(wrapAction(async (name, options) => {
+    const { pluginInitCommand } = await import('./commands/plugin.js');
     await pluginInitCommand(name, options);
 }));
 // Migrate command
@@ -494,6 +496,7 @@ program
     .option('--dry-run', 'Preview changes without writing files', false)
     .option('--diff', 'Show semantic diff before/after', false)
     .action(wrapAction(async (glob, options) => {
+    const { migrateCommand } = await import('./commands/migrate.js');
     await migrateCommand(glob, options);
 }));
 // Status command
@@ -503,6 +506,7 @@ program
     .option('-w, --workflow <name>', 'Specific workflow name')
     .option('--json', 'Output as JSON', false)
     .action(wrapAction(async (input, options) => {
+    const { statusCommand } = await import('./commands/status.js');
     if (options.workflow)
         options.workflowName = options.workflow;
     await statusCommand(input, options);
@@ -519,6 +523,7 @@ program
     if (!nodeName) {
         throw new Error('Node name is required (as positional arg or --nodeId flag)');
     }
+    const { implementCommand } = await import('./commands/implement.js');
     if (options.workflow)
         options.workflowName = options.workflow;
     await implementCommand(input, nodeName, options);
@@ -531,6 +536,7 @@ program
     .option('--since <date>', 'Date-based range (e.g., "2024-01-01")')
     .option('-r, --range <range>', 'Custom git range (e.g., "v0.1.0..HEAD")')
     .action(wrapAction(async (options) => {
+    const { changelogCommand } = await import('./commands/changelog.js');
     await changelogCommand(options);
 }));
 // Docs command: fw docs [topic] | fw docs search <query>
@@ -540,6 +546,7 @@ program
     .option('--json', 'Output as JSON', false)
     .option('--compact', 'Return compact LLM-friendly version', false)
     .action(wrapAction(async (args, options) => {
+    const { docsListCommand, docsReadCommand, docsSearchCommand } = await import('./commands/docs.js');
     if (args.length === 0 || args[0] === 'list') {
         await docsListCommand(options);
     }
@@ -566,6 +573,7 @@ program
     .option('-o, --output <path>', 'Write to file instead of stdout')
     .option('--list', 'List available presets and exit')
     .action(wrapAction(async (preset, options) => {
+    const { contextCommand } = await import('./commands/context.js');
     await contextCommand(preset, options);
 }));
 // Marketplace command group
@@ -577,6 +585,7 @@ marketCmd
     .option('-a, --author <author>', 'Author name')
     .option('-y, --yes', 'Skip prompts and use defaults', false)
     .action(wrapAction(async (name, options) => {
+    const { marketInitCommand } = await import('./commands/market.js');
     await marketInitCommand(name, options);
 }));
 marketCmd
@@ -585,6 +594,7 @@ marketCmd
     .option('--json', 'Output results as JSON', false)
     .option('--verbose', 'Show parse warnings', false)
     .action(wrapAction(async (directory, options) => {
+    const { marketPackCommand } = await import('./commands/market.js');
     await marketPackCommand(directory, options);
 }));
 marketCmd
@@ -593,6 +603,7 @@ marketCmd
     .option('--dry-run', 'Preview without publishing', false)
     .option('--tag <tag>', 'npm dist-tag')
     .action(wrapAction(async (directory, options) => {
+    const { marketPublishCommand } = await import('./commands/market.js');
     await marketPublishCommand(directory, options);
 }));
 marketCmd
@@ -600,6 +611,7 @@ marketCmd
     .description('Install a marketplace package')
     .option('--json', 'Output results as JSON', false)
     .action(wrapAction(async (packageSpec, options) => {
+    const { marketInstallCommand } = await import('./commands/market.js');
     await marketInstallCommand(packageSpec, options);
 }));
 marketCmd
@@ -609,6 +621,7 @@ marketCmd
     .option('-r, --registry <url>', 'Custom registry search URL (e.g., private npm registry)')
     .option('--json', 'Output as JSON', false)
     .action(wrapAction(async (query, options) => {
+    const { marketSearchCommand } = await import('./commands/market.js');
     await marketSearchCommand(query, { ...options, limit: parseInt(options.limit, 10) });
 }));
 marketCmd
@@ -616,6 +629,7 @@ marketCmd
     .description('List installed marketplace packages')
     .option('--json', 'Output as JSON', false)
     .action(wrapAction(async (options) => {
+    const { marketListCommand } = await import('./commands/market.js');
     await marketListCommand(options);
 }));
 // Concise examples appended to --help

package/dist/cli/templates/workflows/ai-rag.js

@@ -48,7 +48,7 @@ const documentStore: Document[] = [
  * @input query [order:1] - Search query
  * @input [topK] [order:2] - Number of results (default 3)
  * @input execute [order:0] - Execute
- * @output documents [order:2] - Retrieved documents
+ * @output documents [order:2] [hidden] - Retrieved documents
  * @output context [order:3] - Combined document text
  * @output onSuccess [order:0] - On Success
  * @output onFailure [order:1] - On Failure

package/dist/diff/formatDiff.js

@@ -2,6 +2,25 @@
  * Human-readable diff formatter for workflow diffs.
  */
 import { IMPACT_DESCRIPTIONS, getImpactReasons } from './impact.js';
+import pc from 'picocolors';
+// Colorize diff symbols: green for added, red for removed, yellow for modified
+function colorSymbol(symbol, text) {
+    switch (symbol) {
+        case '+': return pc.green(`${symbol} ${text}`);
+        case '-': return pc.red(`${symbol} ${text}`);
+        case '~': return pc.yellow(`${symbol} ${text}`);
+        default: return `${symbol} ${text}`;
+    }
+}
+function impactColor(impact) {
+    switch (impact) {
+        case 'CRITICAL': return pc.red(pc.bold(impact));
+        case 'BREAKING': return pc.red(impact);
+        case 'MINOR': return pc.yellow(impact);
+        case 'COSMETIC': return pc.dim(impact);
+        default: return impact;
+    }
+}
 /**
  * Format a workflow diff for display
  */
@@ -41,7 +60,7 @@ function formatCompact(diff) {
         parts.push(`+${summary.connectionsAdded} conns`);
     if (summary.connectionsRemoved > 0)
         parts.push(`-${summary.connectionsRemoved} conns`);
-    return `[${diff.impact}] ${parts.join(', ')}`;
+    return `[${impactColor(diff.impact)}] ${parts.join(', ')}`;
 }
 /**
  * Full text format
@@ -50,11 +69,11 @@ function formatText(diff) {
     const lines = [];
     // Header
     lines.push('═══════════════════════════════════════════════════════════════');
-    lines.push(`  WORKFLOW DIFF - Impact: ${diff.impact}`);
+    lines.push(`  WORKFLOW DIFF - Impact: ${impactColor(diff.impact)}`);
     lines.push('═══════════════════════════════════════════════════════════════');
     lines.push('');
     if (diff.identical) {
-        lines.push('  ✓ Workflows are semantically identical');
+        lines.push(pc.green('  ✓ Workflows are semantically identical'));
         lines.push('');
         return lines.join('\n');
     }
@@ -106,22 +125,22 @@ function formatText(diff) {
         lines.push('  WORKFLOW PORTS');
         lines.push('  ───────────────────────────────────────────────────────────');
         if (diff.startPorts.added.length > 0) {
-            lines.push(`  + Start ports added: ${diff.startPorts.added.map(p => p.name).join(', ')}`);
+            lines.push('  ' + colorSymbol('+', `Start ports added: ${diff.startPorts.added.map(p => p.name).join(', ')}`));
         }
         if (diff.startPorts.removed.length > 0) {
-            lines.push(`  - Start ports removed: ${diff.startPorts.removed.map(p => p.name).join(', ')}`);
+            lines.push('  ' + colorSymbol('-', `Start ports removed: ${diff.startPorts.removed.map(p => p.name).join(', ')}`));
         }
         if (diff.startPorts.modified.length > 0) {
-            lines.push(`  ~ Start ports modified: ${diff.startPorts.modified.map(p => p.name).join(', ')}`);
+            lines.push('  ' + colorSymbol('~', `Start ports modified: ${diff.startPorts.modified.map(p => p.name).join(', ')}`));
         }
         if (diff.exitPorts.added.length > 0) {
-            lines.push(`  + Exit ports added: ${diff.exitPorts.added.map(p => p.name).join(', ')}`);
+            lines.push('  ' + colorSymbol('+', `Exit ports added: ${diff.exitPorts.added.map(p => p.name).join(', ')}`));
         }
         if (diff.exitPorts.removed.length > 0) {
-            lines.push(`  - Exit ports removed: ${diff.exitPorts.removed.map(p => p.name).join(', ')}`);
+            lines.push('  ' + colorSymbol('-', `Exit ports removed: ${diff.exitPorts.removed.map(p => p.name).join(', ')}`));
         }
         if (diff.exitPorts.modified.length > 0) {
-            lines.push(`  ~ Exit ports modified: ${diff.exitPorts.modified.map(p => p.name).join(', ')}`);
+            lines.push('  ' + colorSymbol('~', `Exit ports modified: ${diff.exitPorts.modified.map(p => p.name).join(', ')}`));
         }
         lines.push('');
     }
@@ -131,7 +150,7 @@ function formatText(diff) {
         lines.push('  ───────────────────────────────────────────────────────────');
         for (const scope of diff.scopes) {
             const symbol = scope.changeType === 'ADDED' ? '+' : scope.changeType === 'REMOVED' ? '-' : '~';
-            lines.push(`  ${symbol} ${scope.name}`);
+            lines.push('  ' + colorSymbol(symbol, scope.name));
         }
         lines.push('');
     }
@@ -149,7 +168,7 @@ function formatText(diff) {
 }
 function formatNodeType(nt) {
     const symbol = nt.changeType === 'ADDED' ? '+' : nt.changeType === 'REMOVED' ? '-' : '~';
-    let line = `  ${symbol} ${nt.name}`;
+    let text = nt.name;
     if (nt.changeType === 'MODIFIED') {
         const details = [];
         if (nt.changes.functionName)
@@ -181,14 +200,14 @@ function formatNodeType(nt) {
                 details.push(`~outputs: ${modified.join(', ')}`);
         }
         if (details.length > 0) {
-            line += ` (${details.join('; ')})`;
+            text += ` (${details.join('; ')})`;
         }
     }
-    return line;
+    return '  ' + colorSymbol(symbol, text);
 }
 function formatInstance(inst) {
     const symbol = inst.changeType === 'ADDED' ? '+' : inst.changeType === 'REMOVED' ? '-' : '~';
-    let line = `  ${symbol} ${inst.id}`;
+    let text = inst.id;
     if (inst.changeType === 'MODIFIED') {
         const details = [];
         if (inst.changes.nodeType) {
@@ -206,15 +225,15 @@ function formatInstance(inst) {
             details.push(`portConfigs changed`);
         }
         if (details.length > 0) {
-            line += ` (${details.join('; ')})`;
+            text += ` (${details.join('; ')})`;
         }
     }
-    return line;
+    return '  ' + colorSymbol(symbol, text);
 }
 function formatConnection(conn) {
     const symbol = conn.changeType === 'ADDED' ? '+' : '-';
     const fromScope = conn.from.scope ? `:${conn.from.scope}` : '';
     const toScope = conn.to.scope ? `:${conn.to.scope}` : '';
-    return `  ${symbol} ${conn.from.node}.${conn.from.port}${fromScope} → ${conn.to.node}.${conn.to.port}${toScope}`;
+    return '  ' + colorSymbol(symbol, `${conn.from.node}.${conn.from.port}${fromScope} → ${conn.to.node}.${conn.to.port}${toScope}`);
 }
 //# sourceMappingURL=formatDiff.js.map

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

@@ -179,7 +179,7 @@ export const CLI_COMMANDS = [
         description: 'Create a new flow-weaver project with templates and config',
         options: [
             { flags: '-n, --name', arg: '<name>', description: 'Project name (defaults to directory name)' },
-            { flags: '-t, --template', arg: workflowTemplates.map(t => t.id).join('|'), description: 'Workflow template', defaultValue: 'simple' },
+            { flags: '-t, --template', arg: workflowTemplates.map(t => t.id).join('|'), description: 'Workflow template', defaultValue: 'sequential' },
             { flags: '-f, --format', arg: 'esm|cjs', description: 'Module format', defaultValue: 'esm' },
             { flags: '-y, --yes', description: 'Skip prompts, use defaults' },
             { flags: '--install / --no-install', description: 'Run npm install after scaffolding' },

package/dist/doc-metadata/extractors/core-metadata.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Core metadata extractor.
+ *
+ * Provides runtime-accessible arrays and objects for data types, strategies,
+ * reserved names, templates, and package exports — derived from the actual
+ * source constants so documentation stays in sync automatically.
+ */
+import { RESERVED_NODE_NAMES, RESERVED_PORT_NAMES, SCOPED_PORT_NAMES, EXECUTION_STRATEGIES, BRANCHING_STRATEGIES, VALID_NODE_COLORS } from '../../constants.js';
+import { type WorkflowTemplate, type NodeTemplate } from '../../cli/templates/index.js';
+/** All supported port data types (runtime array, mirrors TDataType union). */
+export declare const DATA_TYPES: readonly ["STRING", "NUMBER", "BOOLEAN", "OBJECT", "ARRAY", "FUNCTION", "STEP", "ANY"];
+/** All supported merge strategies (runtime array, mirrors TMergeStrategy union). */
+export declare const MERGE_STRATEGIES: readonly ["FIRST", "LAST", "COLLECT", "MERGE", "CONCAT"];
+/** All supported branching strategies (runtime array, mirrors TBranchingStrategy union). */
+export declare const BRANCHING_STRATEGY_VALUES: readonly ["value-based", "exception-based", "none"];
+/** All supported execution strategies (runtime array, mirrors TExecuteWhen union). */
+export declare const EXECUTION_STRATEGY_VALUES: readonly ["CONJUNCTION", "DISJUNCTION", "CUSTOM"];
+export { RESERVED_NODE_NAMES, RESERVED_PORT_NAMES, SCOPED_PORT_NAMES };
+export { EXECUTION_STRATEGIES, BRANCHING_STRATEGIES, VALID_NODE_COLORS };
+/** Summary of a workflow template (without the generate function). */
+export interface TemplateSummary {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+}
+/** All registered workflow templates (id, name, description, category). */
+export declare const WORKFLOW_TEMPLATES: TemplateSummary[];
+/** All registered node templates (id, name, description, category). */
+export declare const NODE_TEMPLATES: TemplateSummary[];
+export type { WorkflowTemplate, NodeTemplate };
+/** All named export subpaths from @synergenius/flow-weaver/package.json. */
+export declare const PACKAGE_EXPORTS: readonly [{
+    readonly subpath: ".";
+    readonly description: "Core library (parser, validator, compiler)";
+}, {
+    readonly subpath: "./runtime";
+    readonly description: "Workflow runtime executor";
+}, {
+    readonly subpath: "./built-in-nodes";
+    readonly description: "Standard node type library";
+}, {
+    readonly subpath: "./diagram";
+    readonly description: "Diagram rendering (SVG/Mermaid)";
+}, {
+    readonly subpath: "./describe";
+    readonly description: "Workflow description formatter";
+}, {
+    readonly subpath: "./doc-metadata";
+    readonly description: "Documentation metadata extractors";
+}, {
+    readonly subpath: "./docs";
+    readonly description: "Documentation generation utilities";
+}, {
+    readonly subpath: "./ast";
+    readonly description: "AST type definitions and builders";
+}, {
+    readonly subpath: "./api";
+    readonly description: "Public API (parseWorkflow, validateWorkflow, etc.)";
+}, {
+    readonly subpath: "./diff";
+    readonly description: "Workflow semantic diff engine";
+}, {
+    readonly subpath: "./editor";
+    readonly description: "Editor completions and diagnostics";
+}, {
+    readonly subpath: "./browser";
+    readonly description: "Browser-compatible JSDoc port sync";
+}, {
+    readonly subpath: "./generated-branding";
+    readonly description: "Generated branding configuration";
+}, {
+    readonly subpath: "./npm-packages";
+    readonly description: "NPM package metadata";
+}, {
+    readonly subpath: "./deployment";
+    readonly description: "Deployment target configurations";
+}, {
+    readonly subpath: "./marketplace";
+    readonly description: "Extension/pack marketplace APIs";
+}, {
+    readonly subpath: "./testing";
+    readonly description: "Testing utilities";
+}, {
+    readonly subpath: "./generator";
+    readonly description: "Code generation";
+}, {
+    readonly subpath: "./constants";
+    readonly description: "Constants and reserved names";
+}, {
+    readonly subpath: "./cli";
+    readonly description: "CLI command definitions";
+}, {
+    readonly subpath: "./executor";
+    readonly description: "MCP workflow executor";
+}, {
+    readonly subpath: "./context";
+    readonly description: "LLM context generation";
+}];
+//# sourceMappingURL=core-metadata.d.ts.map