@synergenius/flow-weaver 0.17.0 → 0.17.1

package/dist/cli/commands/init-personas.d.ts

@@ -58,6 +58,8 @@ export interface PrintNextStepsOptions {
     mcpConfigured?: string[];
     /** When true, skip persona-specific guidance (the agent handles it) */
     agentLaunched?: boolean;
+    /** When true, the workflow was auto-compiled and npm start works immediately */
+    compiled?: boolean;
 }
 export declare function printNextSteps(opts: PrintNextStepsOptions): void;
 /** Maps each persona to the fw_context preset used for agent knowledge bootstrap. */
@@ -66,17 +68,17 @@ export declare const AGENT_CONTEXT_PRESETS: Record<PersonaId, string>;
  * Generate the initial prompt for a CLI agent (Claude Code, Codex).
  * Interpolates project name and template into the persona-specific template.
  */
-export declare function generateAgentPrompt(projectName: string, persona: PersonaId, template: string): string;
+export declare function generateAgentPrompt(projectName: string, persona: PersonaId, template: string, useCaseDescription?: string): string;
 /**
  * Generate a shorter prompt suitable for pasting into a GUI editor.
  * Persona-aware but more concise than the full agent prompt.
  */
-export declare function generateEditorPrompt(projectName: string, persona: PersonaId, template: string): string;
+export declare function generateEditorPrompt(projectName: string, persona: PersonaId, template: string, useCaseDescription?: string): string;
 /**
  * Generate the full content for a PROJECT_SETUP.md file.
  * Includes the agent prompt plus project context.
  */
-export declare function generateSetupPromptFile(projectName: string, persona: PersonaId, template: string, filesCreated: string[]): string;
+export declare function generateSetupPromptFile(projectName: string, persona: PersonaId, template: string, filesCreated: string[], useCaseDescription?: string): string;
 /**
  * Print a copyable prompt in a bordered box.
  * Long lines are word-wrapped to fit within the box.

package/dist/cli/commands/init-personas.js

@@ -2,6 +2,7 @@
  * Persona-specific logic for the init command.
  * Types, use-case mappings, template selection, and post-scaffold output.
  */
+import { execSync } from 'child_process';
 import { logger } from '../utils/logger.js';
 import { workflowTemplates } from '../templates/index.js';
 import { buildContext } from '../../context/index.js';
@@ -215,7 +216,7 @@ export function ${fnName}(
 `;
 }
 export function printNextSteps(opts) {
-    const { projectName, persona, displayDir, installSkipped, workflowCode, workflowFile, agentLaunched } = opts;
+    const { projectName, persona, displayDir, installSkipped, workflowCode, workflowFile, agentLaunched, compiled } = opts;
     // Workflow preview
     if (workflowCode) {
         const preview = extractWorkflowPreview(workflowCode);
@@ -247,7 +248,13 @@ export function printNextSteps(opts) {
     if (installSkipped) {
         logger.log('    npm install');
     }
-    logger.log('    npm run dev');
+    if (compiled) {
+        logger.log(`    npm start${' '.repeat(14)}${logger.dim('Run your compiled workflow')}`);
+        logger.log(`    npm run dev${' '.repeat(12)}${logger.dim('Recompile + run (after editing)')}`);
+    }
+    else {
+        logger.log('    npm run dev');
+    }
     // Persona-specific guidance (skip if agent was launched, it handles this)
     if (!agentLaunched) {
         if (persona === 'nocode') {
@@ -282,27 +289,26 @@ function printNocodeGuidance(_projectName) {
 }
 function printVibecoderGuidance() {
     logger.newline();
-    logger.log('  With your AI editor connected, try:');
+    logger.log(`  ${logger.bold('Describe what you want, AI handles the code.')}`);
     logger.newline();
     logger.log(`    ${logger.dim('"Add a retry loop when the model call fails"')}`);
-    logger.log(`    ${logger.dim('"Add a tool that searches a knowledge base"')}`);
+    logger.log(`    ${logger.dim('"Connect this to a Postgres database"')}`);
+    logger.log(`    ${logger.dim('"Show me a diagram of the current workflow"')}`);
     logger.newline();
-    logger.log(`  ${logger.bold('Commands you\'ll use')}`);
+    logger.log(`  ${logger.bold('When you want to see the structure')}`);
     logger.newline();
-    logger.log(`    flow-weaver diagram src/*.ts     ${logger.dim('See a visual diagram')}`);
-    logger.log(`    flow-weaver validate src/*.ts    ${logger.dim('Check for errors')}`);
-    logger.log(`    flow-weaver templates            ${logger.dim('Browse all templates')}`);
+    logger.log(`    npm run diagram                  ${logger.dim('Visual diagram of your workflow')}`);
 }
 function printLowcodeGuidance() {
     logger.newline();
-    logger.log(`  ${logger.bold('Explore and learn')}`);
+    logger.log(`  ${logger.bold('Explore and customize')}`);
     logger.newline();
     logger.log(`    flow-weaver templates            ${logger.dim('List all 16 workflow templates')}`);
-    logger.log(`    flow-weaver create workflow ...   ${logger.dim('Add another workflow')}`);
-    logger.log(`    flow-weaver describe src/*.ts     ${logger.dim('See workflow structure')}`);
-    logger.log(`    flow-weaver docs annotations     ${logger.dim('Read the annotation reference')}`);
+    logger.log(`    flow-weaver describe src/*.ts     ${logger.dim('See the workflow structure')}`);
+    logger.log(`    flow-weaver docs annotations     ${logger.dim('Annotation reference')}`);
     logger.newline();
     logger.log(`  Your project includes an example in ${logger.highlight('examples/')} to study.`);
+    logger.log(`  With MCP connected, AI can help modify nodes and connections.`);
 }
 function printExpertGuidance() {
     logger.newline();
@@ -370,26 +376,32 @@ Then ask what I'd like to build.`,
  * Generate the initial prompt for a CLI agent (Claude Code, Codex).
  * Interpolates project name and template into the persona-specific template.
  */
-export function generateAgentPrompt(projectName, persona, template) {
-    return AGENT_PROMPTS[persona]
+export function generateAgentPrompt(projectName, persona, template, useCaseDescription) {
+    let prompt = AGENT_PROMPTS[persona]
         .replace(/\{name\}/g, projectName)
         .replace(/\{template\}/g, template);
+    if (useCaseDescription) {
+        // Insert the user's description after the template mention line
+        prompt = prompt.replace(/(using the .+ template\.?\n)/, `$1The user wants to build: ${useCaseDescription}\n`);
+    }
+    return prompt;
 }
 /**
  * Generate a shorter prompt suitable for pasting into a GUI editor.
  * Persona-aware but more concise than the full agent prompt.
  */
-export function generateEditorPrompt(projectName, persona, template) {
+export function generateEditorPrompt(projectName, persona, template, useCaseDescription) {
     const preset = AGENT_CONTEXT_PRESETS[persona];
     const bootstrap = `Start by calling fw_context(preset="${preset}", profile="assistant") to learn Flow Weaver.`;
+    const desc = useCaseDescription ? ` I want to build: ${useCaseDescription}.` : '';
     if (persona === 'nocode') {
-        return `${bootstrap}\nThis is a Flow Weaver project called "${projectName}" using the ${template} template. Show me the workflow diagram, walk me through what each step does in plain language, then ask me what I want to build. Keep it simple, no code.`;
+        return `${bootstrap}\nThis is a Flow Weaver project called "${projectName}" using the ${template} template.${desc} Show me the workflow diagram, walk me through what each step does in plain language, then ask me what I want to build. Keep it simple, no code.`;
     }
     if (persona === 'vibecoder') {
-        return `${bootstrap}\nThis is a Flow Weaver project called "${projectName}" using the ${template} template. Show me the workflow diagram, then let's iterate on it together. I'll describe what I want and you handle the implementation.`;
+        return `${bootstrap}\nThis is a Flow Weaver project called "${projectName}" using the ${template} template.${desc} Show me the workflow diagram, then let's iterate on it together. I'll describe what I want and you handle the implementation.`;
     }
     if (persona === 'lowcode') {
-        return `${bootstrap}\nThis is a Flow Weaver project called "${projectName}" using the ${template} template. Show me the workflow diagram and explain the template, then help me customize it for my use case.`;
+        return `${bootstrap}\nThis is a Flow Weaver project called "${projectName}" using the ${template} template.${desc} Show me the workflow diagram and explain the template, then help me customize it for my use case.`;
     }
     return `${bootstrap}\nFlow Weaver project "${projectName}" (template: ${template}). Show the workflow diagram and implementation status.`;
 }
@@ -397,8 +409,8 @@ export function generateEditorPrompt(projectName, persona, template) {
  * Generate the full content for a PROJECT_SETUP.md file.
  * Includes the agent prompt plus project context.
  */
-export function generateSetupPromptFile(projectName, persona, template, filesCreated) {
-    const prompt = generateAgentPrompt(projectName, persona, template);
+export function generateSetupPromptFile(projectName, persona, template, filesCreated, useCaseDescription) {
+    const prompt = generateAgentPrompt(projectName, persona, template, useCaseDescription);
     // Embed Flow Weaver knowledge directly so the file is self-contained.
     // GUI editors may not have MCP tools configured when first reading this file.
     const contextResult = buildContext({ preset: 'core', profile: 'assistant' });
@@ -481,6 +493,20 @@ export function printCopyablePrompt(prompt) {
         logger.log(`  │ ${padded} │`);
     }
     logger.log(`  ${'└' + '─'.repeat(width) + '┘'}`);
+    // Auto-copy to clipboard (best-effort)
+    try {
+        const clipCmd = process.platform === 'darwin' ? 'pbcopy'
+            : process.platform === 'linux' ? 'xclip -selection clipboard'
+                : null;
+        if (clipCmd) {
+            execSync(clipCmd, { input: prompt, stdio: ['pipe', 'pipe', 'pipe'], timeout: 3000 });
+            logger.newline();
+            logger.success('Copied to clipboard');
+        }
+    }
+    catch {
+        // Clipboard not available, box is still there
+    }
 }
 /** Default for the "Launch agent?" confirm prompt per persona */
 export const AGENT_LAUNCH_DEFAULTS = {

package/dist/cli/commands/init.d.ts

@@ -29,6 +29,8 @@ export interface InitConfig {
     force: boolean;
     persona: PersonaId;
     useCase?: UseCaseId;
+    /** Free-text description when user picked "Something else" */
+    useCaseDescription?: string;
     mcp: boolean;
 }
 export interface InitReport {
@@ -76,6 +78,7 @@ interface AgentHandoffOptions {
     cliTools: ToolId[];
     guiTools: ToolId[];
     filesCreated: string[];
+    useCaseDescription?: string;
 }
 /**
  * After init + MCP setup, offer to launch a CLI agent or generate a prompt for GUI editors.

package/dist/cli/commands/init.js

@@ -13,7 +13,7 @@ import { ExitPromptError } from '@inquirer/core';
 import { getWorkflowTemplate, workflowTemplates } from '../templates/index.js';
 import { logger } from '../utils/logger.js';
 import { compileCommand } from './compile.js';
-import { runMcpSetupFromInit, CLI_TOOL_BINARY } from './mcp-setup.js';
+import { runMcpSetupFromInit, CLI_TOOL_BINARY, detectCliTools } from './mcp-setup.js';
 import { PERSONA_CHOICES, PERSONA_CONFIRMATIONS, USE_CASE_CHOICES, selectTemplateForPersona, getTemplateSubChoices, printNextSteps, generateReadme, generateExampleWorkflow, generateAgentPrompt, generateEditorPrompt, generateSetupPromptFile, printCopyablePrompt, AGENT_LAUNCH_DEFAULTS, } from './init-personas.js';
 // ── Utilities ────────────────────────────────────────────────────────────────
 const PROJECT_NAME_RE = /^[a-zA-Z0-9][-a-zA-Z0-9_.]*$/;
@@ -172,7 +172,19 @@ export async function resolveInitConfig(dirArg, options) {
             template = selection.template;
         }
     }
-    // 4. MCP setup (nocode + vibecoder only)
+    // 3b. "Something else" follow-up: ask what they're building
+    let useCaseDescription;
+    if (useCase === 'minimal' && !skipPrompts && persona !== 'expert') {
+        useCaseDescription = await input({
+            message: 'Briefly describe what you want to build:',
+        });
+        if (useCaseDescription) {
+            useCaseDescription = useCaseDescription.trim();
+        }
+        if (!useCaseDescription)
+            useCaseDescription = undefined;
+    }
+    // 4. MCP setup (nocode, vibecoder, lowcode: prompt; expert: skip unless --mcp)
     let mcp;
     if (options.mcp !== undefined) {
         mcp = options.mcp;
@@ -180,7 +192,7 @@ export async function resolveInitConfig(dirArg, options) {
     else if (skipPrompts) {
         mcp = false;
     }
-    else if (persona === 'nocode' || persona === 'vibecoder') {
+    else if (persona === 'nocode' || persona === 'vibecoder' || persona === 'lowcode') {
         mcp = await confirm({
             message: 'Set up AI editor integration? (Claude Code, Cursor, VS Code, etc.)',
             default: true,
@@ -242,6 +254,7 @@ export async function resolveInitConfig(dirArg, options) {
         force,
         persona,
         useCase,
+        useCaseDescription,
         mcp,
     };
 }
@@ -415,7 +428,7 @@ export function runGitInit(targetDir) {
  * Returns true if a CLI agent was spawned (init should exit and let the agent take over).
  */
 export async function handleAgentHandoff(opts) {
-    const { projectName, persona, template, targetDir, cliTools, guiTools, filesCreated } = opts;
+    const { projectName, persona, template, targetDir, cliTools, guiTools, filesCreated, useCaseDescription } = opts;
     // Step 1: If CLI agent available, offer to launch it
     if (cliTools.length > 0) {
         const toolId = cliTools[0]; // Prefer first (claude > codex)
@@ -427,7 +440,7 @@ export async function handleAgentHandoff(opts) {
             default: launchDefault,
         });
         if (shouldLaunch && binary) {
-            const prompt = generateAgentPrompt(projectName, persona, template);
+            const prompt = generateAgentPrompt(projectName, persona, template, useCaseDescription);
             logger.newline();
             logger.log(`  ${logger.dim(`Starting ${displayName}...`)}`);
             logger.newline();
@@ -456,12 +469,12 @@ export async function handleAgentHandoff(opts) {
         });
         if (promptAction === 'skip')
             return false;
-        const editorPrompt = generateEditorPrompt(projectName, persona, template);
+        const editorPrompt = generateEditorPrompt(projectName, persona, template, useCaseDescription);
         if (promptAction === 'terminal' || promptAction === 'both') {
             printCopyablePrompt(editorPrompt);
         }
         if (promptAction === 'file' || promptAction === 'both') {
-            const setupContent = generateSetupPromptFile(projectName, persona, template, filesCreated);
+            const setupContent = generateSetupPromptFile(projectName, persona, template, filesCreated, useCaseDescription);
             const setupPath = path.join(targetDir, 'PROJECT_SETUP.md');
             fs.writeFileSync(setupPath, setupContent, 'utf8');
             // Add to .gitignore
@@ -526,18 +539,27 @@ export async function initCommand(dirArg, options) {
         let mcpConfigured;
         let mcpResult;
         if (config.mcp && !options.json) {
-            const spinner = logger.spinner('Configuring AI editors...');
+            const spinner = logger.spinner('Detecting AI editors...');
             try {
                 mcpResult = await runMcpSetupFromInit();
                 mcpConfigured = mcpResult.configured;
-                if (mcpResult.configured.length > 0) {
-                    spinner.stop(`${mcpResult.configured.join(', ')} configured`);
+                spinner.stop();
+                // Per-tool status lines
+                for (const t of mcpResult.detected) {
+                    if (!t.detected)
+                        continue;
+                    const wasConfigured = mcpConfigured.includes(t.displayName);
+                    if (wasConfigured) {
+                        logger.success(`${t.displayName} configured`);
+                    }
                 }
-                else if (mcpResult.failed.length > 0) {
-                    spinner.fail('MCP setup failed');
+                if (mcpResult.failed.length > 0) {
+                    for (const name of mcpResult.failed) {
+                        logger.warn(`${name} failed to configure`);
+                    }
                 }
-                else {
-                    spinner.stop('No AI editors detected');
+                if (mcpResult.detected.every((t) => !t.detected)) {
+                    logger.log(`  ${logger.dim('No AI editors detected')}`);
                 }
             }
             catch {
@@ -604,25 +626,39 @@ export async function initCommand(dirArg, options) {
         // Persona-specific rich output
         const relDir = path.relative(process.cwd(), config.targetDir);
         const displayDir = !relDir || relDir === '.' ? null : relDir.startsWith('../../') ? config.targetDir : relDir;
-        // Agent handoff: offer to launch CLI agent or generate prompt for GUI editors
+        // Agent handoff: offer to launch CLI agent or generate prompt for GUI editors.
+        // Decoupled from MCP: even if MCP wasn't run, check for available CLI tools.
         const skipAgent = options.agent === false || options.yes || isNonInteractive();
-        if (mcpConfigured && mcpConfigured.length > 0 && !skipAgent) {
-            try {
-                agentLaunched = await handleAgentHandoff({
-                    projectName: config.projectName,
-                    persona: config.persona,
-                    template: config.template,
-                    targetDir: config.targetDir,
-                    cliTools: mcpCliTools,
-                    guiTools: mcpGuiTools,
-                    filesCreated,
-                });
-                report.agentLaunched = agentLaunched;
+        if (!skipAgent) {
+            // If MCP didn't run or found no CLI tools, do a quick binary check
+            if (mcpCliTools.length === 0) {
+                try {
+                    mcpCliTools = await detectCliTools();
+                }
+                catch {
+                    // Non-fatal
+                }
             }
-            catch (err) {
-                if (err instanceof ExitPromptError)
-                    return;
-                // Non-fatal: just skip agent handoff
+            const hasTools = mcpCliTools.length > 0 || mcpGuiTools.length > 0;
+            if (hasTools) {
+                try {
+                    agentLaunched = await handleAgentHandoff({
+                        projectName: config.projectName,
+                        persona: config.persona,
+                        template: config.template,
+                        targetDir: config.targetDir,
+                        cliTools: mcpCliTools,
+                        guiTools: mcpGuiTools,
+                        filesCreated,
+                        useCaseDescription: config.useCaseDescription,
+                    });
+                    report.agentLaunched = agentLaunched;
+                }
+                catch (err) {
+                    if (err instanceof ExitPromptError)
+                        return;
+                    // Non-fatal: just skip agent handoff
+                }
             }
         }
         // If an agent was spawned, it takes over. Print minimal output.
@@ -639,6 +675,7 @@ export async function initCommand(dirArg, options) {
             workflowFile,
             mcpConfigured,
             agentLaunched,
+            compiled: compileResult?.success,
         });
     }
     catch (err) {

package/dist/cli/commands/mcp-setup.d.ts

@@ -47,6 +47,8 @@ export declare function detectTools(deps: McpSetupDeps): Promise<DetectedTool[]>
 export interface McpSetupFromInitResult {
     configured: string[];
     failed: string[];
+    /** Full detection results for each tool (used by init for transparent feedback) */
+    detected: DetectedTool[];
     /** Tool IDs that can be spawned as interactive CLI sessions (e.g. claude, codex) */
     cliTools: ToolId[];
     /** Tool IDs that are GUI-only editors (e.g. cursor, vscode, windsurf) */
@@ -57,6 +59,11 @@ export interface McpSetupFromInitResult {
  * Used by the init command after the user has already consented.
  */
 export declare function runMcpSetupFromInit(deps?: McpSetupDeps): Promise<McpSetupFromInitResult>;
+/**
+ * Check which CLI agent tools are available on PATH.
+ * Lightweight: only runs `which` for known CLI binaries.
+ */
+export declare function detectCliTools(deps?: McpSetupDeps): Promise<ToolId[]>;
 export declare function mcpSetupCommand(options: McpSetupOptions, deps?: McpSetupDeps): Promise<void>;
 export {};
 //# sourceMappingURL=mcp-setup.d.ts.map

package/dist/cli/commands/mcp-setup.js

@@ -303,7 +303,22 @@ export async function runMcpSetupFromInit(deps) {
         .map((t) => t.id);
     const cliTools = allConfiguredIds.filter((id) => CLI_TOOL_IDS.has(id));
     const guiTools = allConfiguredIds.filter((id) => !CLI_TOOL_IDS.has(id));
-    return { configured, failed, cliTools, guiTools };
+    return { configured, failed, detected, cliTools, guiTools };
+}
+// ── Quick CLI tool detection (no config, just binary check) ──────────────────
+/**
+ * Check which CLI agent tools are available on PATH.
+ * Lightweight: only runs `which` for known CLI binaries.
+ */
+export async function detectCliTools(deps) {
+    const d = deps ?? defaultDeps();
+    const results = [];
+    for (const [id, binary] of Object.entries(CLI_TOOL_BINARY)) {
+        if (binary && await binaryExists(binary, d)) {
+            results.push(id);
+        }
+    }
+    return results;
 }
 // ── Command ──────────────────────────────────────────────────────────────────
 export async function mcpSetupCommand(options, deps) {

package/dist/cli/flow-weaver.mjs

@@ -9671,7 +9671,7 @@ var VERSION;
 var init_generated_version = __esm({
   "src/generated-version.ts"() {
     "use strict";
-    VERSION = "0.17.0";
+    VERSION = "0.17.1";
   }
 });
 
@@ -77764,7 +77764,7 @@ async function validateCommand(input, options = {}) {
 // src/cli/commands/init.ts
 import * as fs19 from "fs";
 import * as path18 from "path";
-import { execSync as execSync3, spawn } from "child_process";
+import { execSync as execSync4, spawn } from "child_process";
 
 // node_modules/@inquirer/input/node_modules/@inquirer/core/dist/lib/key.js
 var isBackspaceKey = (key) => key.name === "backspace";
@@ -81038,7 +81038,17 @@ async function runMcpSetupFromInit(deps) {
   const allConfiguredIds = detected.filter((t) => t.detected && (t.configured || configured.includes(t.displayName))).map((t) => t.id);
   const cliTools = allConfiguredIds.filter((id) => CLI_TOOL_IDS.has(id));
   const guiTools = allConfiguredIds.filter((id) => !CLI_TOOL_IDS.has(id));
-  return { configured, failed, cliTools, guiTools };
+  return { configured, failed, detected, cliTools, guiTools };
+}
+async function detectCliTools(deps) {
+  const d = deps ?? defaultDeps();
+  const results = [];
+  for (const [id, binary2] of Object.entries(CLI_TOOL_BINARY)) {
+    if (binary2 && await binaryExists(binary2, d)) {
+      results.push(id);
+    }
+  }
+  return results;
 }
 async function mcpSetupCommand(options, deps) {
   const d = deps ?? defaultDeps();
@@ -81129,6 +81139,7 @@ async function mcpSetupCommand(options, deps) {
 }
 
 // src/cli/commands/init-personas.ts
+import { execSync as execSync3 } from "child_process";
 init_templates();
 
 // src/docs/index.ts
@@ -81739,7 +81750,7 @@ export function ${fnName}(
 `;
 }
 function printNextSteps(opts) {
-  const { projectName, persona, displayDir, installSkipped, workflowCode, workflowFile, agentLaunched } = opts;
+  const { projectName, persona, displayDir, installSkipped, workflowCode, workflowFile, agentLaunched, compiled } = opts;
   if (workflowCode) {
     const preview = extractWorkflowPreview(workflowCode);
     if (preview) {
@@ -81768,7 +81779,12 @@ function printNextSteps(opts) {
   if (installSkipped) {
     logger.log("    npm install");
   }
-  logger.log("    npm run dev");
+  if (compiled) {
+    logger.log(`    npm start${" ".repeat(14)}${logger.dim("Run your compiled workflow")}`);
+    logger.log(`    npm run dev${" ".repeat(12)}${logger.dim("Recompile + run (after editing)")}`);
+  } else {
+    logger.log("    npm run dev");
+  }
   if (!agentLaunched) {
     if (persona === "nocode") {
       printNocodeGuidance(projectName);
@@ -81799,27 +81815,26 @@ function printNocodeGuidance(_projectName) {
 }
 function printVibecoderGuidance() {
   logger.newline();
-  logger.log("  With your AI editor connected, try:");
+  logger.log(`  ${logger.bold("Describe what you want, AI handles the code.")}`);
   logger.newline();
   logger.log(`    ${logger.dim('"Add a retry loop when the model call fails"')}`);
-  logger.log(`    ${logger.dim('"Add a tool that searches a knowledge base"')}`);
+  logger.log(`    ${logger.dim('"Connect this to a Postgres database"')}`);
+  logger.log(`    ${logger.dim('"Show me a diagram of the current workflow"')}`);
   logger.newline();
-  logger.log(`  ${logger.bold("Commands you'll use")}`);
+  logger.log(`  ${logger.bold("When you want to see the structure")}`);
   logger.newline();
-  logger.log(`    flow-weaver diagram src/*.ts     ${logger.dim("See a visual diagram")}`);
-  logger.log(`    flow-weaver validate src/*.ts    ${logger.dim("Check for errors")}`);
-  logger.log(`    flow-weaver templates            ${logger.dim("Browse all templates")}`);
+  logger.log(`    npm run diagram                  ${logger.dim("Visual diagram of your workflow")}`);
 }
 function printLowcodeGuidance() {
   logger.newline();
-  logger.log(`  ${logger.bold("Explore and learn")}`);
+  logger.log(`  ${logger.bold("Explore and customize")}`);
   logger.newline();
   logger.log(`    flow-weaver templates            ${logger.dim("List all 16 workflow templates")}`);
-  logger.log(`    flow-weaver create workflow ...   ${logger.dim("Add another workflow")}`);
-  logger.log(`    flow-weaver describe src/*.ts     ${logger.dim("See workflow structure")}`);
-  logger.log(`    flow-weaver docs annotations     ${logger.dim("Read the annotation reference")}`);
+  logger.log(`    flow-weaver describe src/*.ts     ${logger.dim("See the workflow structure")}`);
+  logger.log(`    flow-weaver docs annotations     ${logger.dim("Annotation reference")}`);
   logger.newline();
   logger.log(`  Your project includes an example in ${logger.highlight("examples/")} to study.`);
+  logger.log(`  With MCP connected, AI can help modify nodes and connections.`);
 }
 function printExpertGuidance() {
   logger.newline();
@@ -81880,29 +81895,38 @@ New Flow Weaver project "{name}" (template: {template}).
 Show the workflow diagram and current implementation status (fw_workflow_status).
 Then ask what I'd like to build.`
 };
-function generateAgentPrompt(projectName, persona, template) {
-  return AGENT_PROMPTS[persona].replace(/\{name\}/g, projectName).replace(/\{template\}/g, template);
+function generateAgentPrompt(projectName, persona, template, useCaseDescription) {
+  let prompt = AGENT_PROMPTS[persona].replace(/\{name\}/g, projectName).replace(/\{template\}/g, template);
+  if (useCaseDescription) {
+    prompt = prompt.replace(
+      /(using the .+ template\.?\n)/,
+      `$1The user wants to build: ${useCaseDescription}
+`
+    );
+  }
+  return prompt;
 }
-function generateEditorPrompt(projectName, persona, template) {
+function generateEditorPrompt(projectName, persona, template, useCaseDescription) {
   const preset = AGENT_CONTEXT_PRESETS[persona];
   const bootstrap = `Start by calling fw_context(preset="${preset}", profile="assistant") to learn Flow Weaver.`;
+  const desc = useCaseDescription ? ` I want to build: ${useCaseDescription}.` : "";
   if (persona === "nocode") {
     return `${bootstrap}
-This is a Flow Weaver project called "${projectName}" using the ${template} template. Show me the workflow diagram, walk me through what each step does in plain language, then ask me what I want to build. Keep it simple, no code.`;
+This is a Flow Weaver project called "${projectName}" using the ${template} template.${desc} Show me the workflow diagram, walk me through what each step does in plain language, then ask me what I want to build. Keep it simple, no code.`;
   }
   if (persona === "vibecoder") {
     return `${bootstrap}
-This is a Flow Weaver project called "${projectName}" using the ${template} template. Show me the workflow diagram, then let's iterate on it together. I'll describe what I want and you handle the implementation.`;
+This is a Flow Weaver project called "${projectName}" using the ${template} template.${desc} Show me the workflow diagram, then let's iterate on it together. I'll describe what I want and you handle the implementation.`;
   }
   if (persona === "lowcode") {
     return `${bootstrap}
-This is a Flow Weaver project called "${projectName}" using the ${template} template. Show me the workflow diagram and explain the template, then help me customize it for my use case.`;
+This is a Flow Weaver project called "${projectName}" using the ${template} template.${desc} Show me the workflow diagram and explain the template, then help me customize it for my use case.`;
   }
   return `${bootstrap}
 Flow Weaver project "${projectName}" (template: ${template}). Show the workflow diagram and implementation status.`;
 }
-function generateSetupPromptFile(projectName, persona, template, filesCreated) {
-  const prompt = generateAgentPrompt(projectName, persona, template);
+function generateSetupPromptFile(projectName, persona, template, filesCreated, useCaseDescription) {
+  const prompt = generateAgentPrompt(projectName, persona, template, useCaseDescription);
   const contextResult = buildContext({ preset: "core", profile: "assistant" });
   const lines = [
     `# ${projectName} Setup`,
@@ -81975,6 +81999,15 @@ function printCopyablePrompt(prompt) {
     logger.log(`  \u2502 ${padded} \u2502`);
   }
   logger.log(`  ${"\u2514" + "\u2500".repeat(width) + "\u2518"}`);
+  try {
+    const clipCmd = process.platform === "darwin" ? "pbcopy" : process.platform === "linux" ? "xclip -selection clipboard" : null;
+    if (clipCmd) {
+      execSync3(clipCmd, { input: prompt, stdio: ["pipe", "pipe", "pipe"], timeout: 3e3 });
+      logger.newline();
+      logger.success("Copied to clipboard");
+    }
+  } catch {
+  }
 }
 var AGENT_LAUNCH_DEFAULTS = {
   nocode: true,
@@ -82115,12 +82148,22 @@ async function resolveInitConfig(dirArg, options) {
       template = selection.template;
     }
   }
+  let useCaseDescription;
+  if (useCase === "minimal" && !skipPrompts && persona !== "expert") {
+    useCaseDescription = await dist_default4({
+      message: "Briefly describe what you want to build:"
+    });
+    if (useCaseDescription) {
+      useCaseDescription = useCaseDescription.trim();
+    }
+    if (!useCaseDescription) useCaseDescription = void 0;
+  }
   let mcp;
   if (options.mcp !== void 0) {
     mcp = options.mcp;
   } else if (skipPrompts) {
     mcp = false;
-  } else if (persona === "nocode" || persona === "vibecoder") {
+  } else if (persona === "nocode" || persona === "vibecoder" || persona === "lowcode") {
     mcp = await dist_default6({
       message: "Set up AI editor integration? (Claude Code, Cursor, VS Code, etc.)",
       default: true
@@ -82172,6 +82215,7 @@ async function resolveInitConfig(dirArg, options) {
     force,
     persona,
     useCase,
+    useCaseDescription,
     mcp
   };
 }
@@ -82316,7 +82360,7 @@ function scaffoldProject(targetDir, files, options) {
 }
 function runNpmInstall(targetDir) {
   try {
-    execSync3("npm install", { cwd: targetDir, stdio: "pipe", timeout: 12e4 });
+    execSync4("npm install", { cwd: targetDir, stdio: "pipe", timeout: 12e4 });
     return { success: true };
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -82325,7 +82369,7 @@ function runNpmInstall(targetDir) {
 }
 function runGitInit(targetDir) {
   try {
-    execSync3("git init", { cwd: targetDir, stdio: "pipe", timeout: 1e4 });
+    execSync4("git init", { cwd: targetDir, stdio: "pipe", timeout: 1e4 });
     return { success: true };
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -82333,7 +82377,7 @@ function runGitInit(targetDir) {
   }
 }
 async function handleAgentHandoff(opts) {
-  const { projectName, persona, template, targetDir, cliTools, guiTools, filesCreated } = opts;
+  const { projectName, persona, template, targetDir, cliTools, guiTools, filesCreated, useCaseDescription } = opts;
   if (cliTools.length > 0) {
     const toolId = cliTools[0];
     const binary2 = CLI_TOOL_BINARY[toolId];
@@ -82344,7 +82388,7 @@ async function handleAgentHandoff(opts) {
       default: launchDefault
     });
     if (shouldLaunch && binary2) {
-      const prompt = generateAgentPrompt(projectName, persona, template);
+      const prompt = generateAgentPrompt(projectName, persona, template, useCaseDescription);
       logger.newline();
       logger.log(`  ${logger.dim(`Starting ${displayName}...`)}`);
       logger.newline();
@@ -82371,12 +82415,12 @@ async function handleAgentHandoff(opts) {
       default: "terminal"
     });
     if (promptAction === "skip") return false;
-    const editorPrompt = generateEditorPrompt(projectName, persona, template);
+    const editorPrompt = generateEditorPrompt(projectName, persona, template, useCaseDescription);
     if (promptAction === "terminal" || promptAction === "both") {
       printCopyablePrompt(editorPrompt);
     }
     if (promptAction === "file" || promptAction === "both") {
-      const setupContent = generateSetupPromptFile(projectName, persona, template, filesCreated);
+      const setupContent = generateSetupPromptFile(projectName, persona, template, filesCreated, useCaseDescription);
       const setupPath = path18.join(targetDir, "PROJECT_SETUP.md");
       fs19.writeFileSync(setupPath, setupContent, "utf8");
       const gitignorePath = path18.join(targetDir, ".gitignore");
@@ -82433,16 +82477,25 @@ async function initCommand(dirArg, options) {
     let mcpConfigured;
     let mcpResult;
     if (config2.mcp && !options.json) {
-      const spinner = logger.spinner("Configuring AI editors...");
+      const spinner = logger.spinner("Detecting AI editors...");
       try {
         mcpResult = await runMcpSetupFromInit();
         mcpConfigured = mcpResult.configured;
-        if (mcpResult.configured.length > 0) {
-          spinner.stop(`${mcpResult.configured.join(", ")} configured`);
-        } else if (mcpResult.failed.length > 0) {
-          spinner.fail("MCP setup failed");
-        } else {
-          spinner.stop("No AI editors detected");
+        spinner.stop();
+        for (const t of mcpResult.detected) {
+          if (!t.detected) continue;
+          const wasConfigured = mcpConfigured.includes(t.displayName);
+          if (wasConfigured) {
+            logger.success(`${t.displayName} configured`);
+          }
+        }
+        if (mcpResult.failed.length > 0) {
+          for (const name of mcpResult.failed) {
+            logger.warn(`${name} failed to configure`);
+          }
+        }
+        if (mcpResult.detected.every((t) => !t.detected)) {
+          logger.log(`  ${logger.dim("No AI editors detected")}`);
         }
       } catch {
         spinner.fail("MCP setup failed");
@@ -82501,20 +82554,30 @@ async function initCommand(dirArg, options) {
     const relDir = path18.relative(process.cwd(), config2.targetDir);
     const displayDir = !relDir || relDir === "." ? null : relDir.startsWith("../../") ? config2.targetDir : relDir;
     const skipAgent = options.agent === false || options.yes || isNonInteractive();
-    if (mcpConfigured && mcpConfigured.length > 0 && !skipAgent) {
-      try {
-        agentLaunched = await handleAgentHandoff({
-          projectName: config2.projectName,
-          persona: config2.persona,
-          template: config2.template,
-          targetDir: config2.targetDir,
-          cliTools: mcpCliTools,
-          guiTools: mcpGuiTools,
-          filesCreated
-        });
-        report.agentLaunched = agentLaunched;
-      } catch (err) {
-        if (err instanceof ExitPromptError4) return;
+    if (!skipAgent) {
+      if (mcpCliTools.length === 0) {
+        try {
+          mcpCliTools = await detectCliTools();
+        } catch {
+        }
+      }
+      const hasTools = mcpCliTools.length > 0 || mcpGuiTools.length > 0;
+      if (hasTools) {
+        try {
+          agentLaunched = await handleAgentHandoff({
+            projectName: config2.projectName,
+            persona: config2.persona,
+            template: config2.template,
+            targetDir: config2.targetDir,
+            cliTools: mcpCliTools,
+            guiTools: mcpGuiTools,
+            filesCreated,
+            useCaseDescription: config2.useCaseDescription
+          });
+          report.agentLaunched = agentLaunched;
+        } catch (err) {
+          if (err instanceof ExitPromptError4) return;
+        }
       }
     }
     if (agentLaunched) {
@@ -82529,7 +82592,8 @@ async function initCommand(dirArg, options) {
       workflowCode,
       workflowFile,
       mcpConfigured,
-      agentLaunched
+      agentLaunched,
+      compiled: compileResult?.success
     });
   } catch (err) {
     if (err instanceof ExitPromptError4) {
@@ -103975,7 +104039,7 @@ function registerExportTools(mcp) {
 }
 
 // src/mcp/tools-marketplace.ts
-import { execSync as execSync4 } from "child_process";
+import { execSync as execSync5 } from "child_process";
 
 // src/marketplace/manifest.ts
 init_esm5();
@@ -104345,7 +104409,7 @@ function registerMarketplaceTools(mcp) {
     },
     async (args) => {
       try {
-        execSync4(`npm install ${args.package}`, {
+        execSync5(`npm install ${args.package}`, {
           cwd: process.cwd(),
           stdio: "pipe"
         });
@@ -107758,7 +107822,7 @@ ${file}:`);
 }
 
 // src/cli/commands/changelog.ts
-import { execSync as execSync5 } from "child_process";
+import { execSync as execSync6 } from "child_process";
 var CATEGORIES2 = [
   { name: "Grammar", match: (f) => /parser|chevrotain|grammar/.test(f) },
   { name: "Code Generation", match: (f) => /generator|body-generator|generate/.test(f) },
@@ -107785,7 +107849,7 @@ function getGitRange(options) {
   }
   if (options.lastTag) {
     try {
-      const lastTag = execSync5("git describe --tags --abbrev=0", {
+      const lastTag = execSync6("git describe --tags --abbrev=0", {
         encoding: "utf8"
       }).trim();
       return `${lastTag}..HEAD`;
@@ -107810,7 +107874,7 @@ function getCommits(rangeArg) {
   } else {
     logCmd = `git log ${rangeArg} --format="%H %s" --no-merges`;
   }
-  const logOutput = execSync5(logCmd, { encoding: "utf8" }).trim();
+  const logOutput = execSync6(logCmd, { encoding: "utf8" }).trim();
   if (!logOutput) {
     return [];
   }
@@ -107822,7 +107886,7 @@ function getCommits(rangeArg) {
     const message = line.slice(spaceIdx + 1);
     let files;
     try {
-      const filesOutput = execSync5(`git diff-tree --no-commit-id --name-only -r ${hash}`, {
+      const filesOutput = execSync6(`git diff-tree --no-commit-id --name-only -r ${hash}`, {
         encoding: "utf8"
       }).trim();
       files = filesOutput ? filesOutput.split(/\r?\n/) : [];
@@ -108237,7 +108301,7 @@ async function implementCommand(input, nodeName, options = {}) {
 // src/cli/commands/market.ts
 import * as fs52 from "fs";
 import * as path53 from "path";
-import { execSync as execSync6 } from "child_process";
+import { execSync as execSync7 } from "child_process";
 init_error_utils();
 async function marketInitCommand(name, options = {}) {
   if (!name.startsWith("flowweaver-pack-")) {
@@ -108470,7 +108534,7 @@ async function marketPublishCommand(directory, options = {}) {
   if (tag) npmArgs.push("--tag", tag);
   try {
     logger.newline();
-    execSync6(`npm ${npmArgs.join(" ")}`, { cwd: dir, stdio: "inherit" });
+    execSync7(`npm ${npmArgs.join(" ")}`, { cwd: dir, stdio: "inherit" });
     if (!dryRun) {
       logger.newline();
       logger.success(`Published ${pkg.name}@${pkg.version} to npm`);
@@ -108488,7 +108552,7 @@ async function marketInstallCommand(packageSpec, options = {}) {
     logger.newline();
   }
   try {
-    execSync6(`npm install ${packageSpec}`, { stdio: json2 ? "pipe" : "inherit" });
+    execSync7(`npm install ${packageSpec}`, { stdio: json2 ? "pipe" : "inherit" });
   } catch (err) {
     if (json2) {
       console.log(JSON.stringify({ success: false, error: getErrorMessage(err) }));
@@ -108640,7 +108704,7 @@ function displayInstalledPackage(pkg) {
 
 // src/cli/index.ts
 init_error_utils();
-var version2 = true ? "0.17.0" : "0.0.0-dev";
+var version2 = true ? "0.17.1" : "0.0.0-dev";
 var program2 = new Command();
 program2.name("flow-weaver").description("Flow Weaver Annotations - Compile and validate workflow files").option("-v, --version", "Output the current version").option("--no-color", "Disable colors").option("--color", "Force colors").on("option:version", () => {
   logger.banner(version2);

package/dist/generated-version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.17.0";
+export declare const VERSION = "0.17.1";
 //# 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.17.0';
+export const VERSION = '0.17.1';
 //# sourceMappingURL=generated-version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",