flowbook 0.2.0 → 0.2.2

package/README.md

@@ -36,8 +36,6 @@ flowbook skill <agent> [-g]  Install AI agent skill & /flowbook command
 ### `flowbook init`
 
 - Adds `"flowbook"` and `"build-flowbook"` scripts to your `package.json`
-- Creates `flows/example.flow.md` as a starter template
-- Installs AI agent skills to all supported agent directories
 
 ### `flowbook dev`
 
@@ -93,7 +91,7 @@ Ignores `node_modules/`, `.git/`, and `dist/`.
 
 ## AI Agent Skill
 
-`flowbook init` automatically installs AI agent skills to all supported coding agent directories.
+Use `flowbook skill` to install AI agent skills and `/flowbook` slash commands for your coding agents.
 When a coding agent (Claude Code, OpenAI Codex, VS Code Copilot, Cursor, Gemini CLI, etc.) detects the keyword **"flowbook"** in your prompt, it will:
 
 1. Analyze your codebase for logical flows (API routes, auth, state management, business logic, etc.)

package/dist/cli.js

@@ -1,235 +1,13 @@
 #!/usr/bin/env node
 
 // src/node/init.ts
-import { readFileSync, writeFileSync, existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
-import { resolve as resolve2 } from "path";
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { resolve } from "path";
 import { execSync } from "child_process";
-
-// src/node/skill.ts
-import { existsSync, mkdirSync, copyFileSync } from "fs";
-import { resolve, dirname } from "path";
-import { fileURLToPath } from "url";
-import { homedir } from "os";
-var __dirname = dirname(fileURLToPath(import.meta.url));
-var AGENTS = [
-  {
-    name: "Claude Code",
-    aliases: ["claude"],
-    skill: {
-      project: ".claude/skills/flowbook",
-      global: ".claude/skills/flowbook"
-    },
-    command: {
-      project: ".claude/commands",
-      global: ".claude/commands",
-      format: "frontmatter"
-    }
-  },
-  {
-    name: "OpenAI Codex",
-    aliases: ["codex"],
-    skill: {
-      project: ".agents/skills/flowbook",
-      global: ".codex/skills/flowbook"
-    }
-  },
-  {
-    name: "VS Code / GitHub Copilot",
-    aliases: ["copilot", "vscode"],
-    skill: {
-      project: ".github/skills/flowbook",
-      global: ".copilot/skills/flowbook"
-    }
-  },
-  {
-    name: "Google Antigravity",
-    aliases: ["antigravity"],
-    skill: {
-      project: ".agent/skills/flowbook",
-      global: ".gemini/antigravity/skills/flowbook"
-    }
-  },
-  {
-    name: "Gemini CLI",
-    aliases: ["gemini"],
-    skill: {
-      project: ".gemini/skills/flowbook",
-      global: ".gemini/skills/flowbook"
-    }
-  },
-  {
-    name: "Cursor",
-    aliases: ["cursor"],
-    skill: {
-      project: ".cursor/skills/flowbook",
-      global: ".cursor/skills/flowbook"
-    },
-    command: {
-      project: ".cursor/commands",
-      global: ".cursor/commands",
-      format: "plain"
-    }
-  },
-  {
-    name: "Windsurf",
-    aliases: ["windsurf"],
-    skill: {
-      project: ".windsurf/skills/flowbook",
-      global: ".codeium/windsurf/skills/flowbook"
-    },
-    command: {
-      project: ".windsurf/workflows",
-      global: ".codeium/windsurf/workflows",
-      format: "plain"
-    }
-  },
-  {
-    name: "AmpCode",
-    aliases: ["amp"],
-    skill: {
-      project: ".amp/skills/flowbook",
-      global: ".config/agents/skills/flowbook"
-    }
-  },
-  {
-    name: "OpenCode",
-    aliases: ["opencode"],
-    skill: {
-      project: ".opencode/skills/flowbook",
-      global: ".config/opencode/skills/flowbook"
-    },
-    command: {
-      project: ".opencode/command",
-      global: ".config/opencode/command",
-      format: "frontmatter"
-    }
-  }
-];
-function getSkillSrc() {
-  return resolve(__dirname, "..", "src", "skills", "flowbook", "SKILL.md");
-}
-function getCommandSrc(format) {
-  const file = format === "frontmatter" ? "flowbook.md" : "flowbook.plain.md";
-  return resolve(__dirname, "..", "src", "commands", file);
-}
-function resolveAgents(agentArg) {
-  if (agentArg === "all") return AGENTS;
-  const lower = agentArg.toLowerCase();
-  const found = AGENTS.filter(
-    (a) => a.aliases.includes(lower) || a.name.toLowerCase().includes(lower)
-  );
-  if (found.length === 0) {
-    console.error(`  Unknown agent: "${agentArg}"`);
-    console.error(`  Available: all, ${AGENTS.flatMap((a) => a.aliases).join(", ")}`);
-    process.exit(1);
-  }
-  return found;
-}
-function installFile(src, destDir, destFilename) {
-  const dest = resolve(destDir, destFilename);
-  if (existsSync(dest)) return false;
-  mkdirSync(destDir, { recursive: true });
-  copyFileSync(src, dest);
-  return true;
-}
-function installSkills(agentArg, global) {
-  const agents = resolveAgents(agentArg);
-  const base = global ? homedir() : process.cwd();
-  const skillSrc = getSkillSrc();
-  if (!existsSync(skillSrc)) {
-    console.error("  \u2717 Skill source file not found. Reinstall flowbook.");
-    process.exit(1);
-  }
-  let skillCount = 0;
-  let cmdCount = 0;
-  for (const agent of agents) {
-    const skillDir = resolve(base, global ? agent.skill.global : agent.skill.project);
-    if (installFile(skillSrc, skillDir, "SKILL.md")) {
-      skillCount++;
-    }
-    if (agent.command) {
-      const cmdSrc = getCommandSrc(agent.command.format);
-      if (existsSync(cmdSrc)) {
-        const cmdDir = resolve(base, global ? agent.command.global : agent.command.project);
-        if (installFile(cmdSrc, cmdDir, "flowbook.md")) {
-          cmdCount++;
-        }
-      }
-    }
-  }
-  const scope = global ? "global" : "project";
-  const agentNames = agents.map((a) => a.name).join(", ");
-  if (skillCount > 0 || cmdCount > 0) {
-    if (skillCount > 0) console.log(`  \u2713 Installed skill to ${skillCount} ${scope} director${skillCount > 1 ? "ies" : "y"}`);
-    if (cmdCount > 0) console.log(`  \u2713 Installed /flowbook command to ${cmdCount} ${scope} director${cmdCount > 1 ? "ies" : "y"}`);
-    console.log(`  Agents: ${agentNames}`);
-  } else {
-    console.log(`  \u2713 Already installed for: ${agentNames}`);
-  }
-}
-function installAllProjectSkills() {
-  const cwd = process.cwd();
-  const skillSrc = getSkillSrc();
-  if (!existsSync(skillSrc)) return 0;
-  let installed = 0;
-  for (const agent of AGENTS) {
-    const dir = resolve(cwd, agent.skill.project);
-    if (installFile(skillSrc, dir, "SKILL.md")) {
-      installed++;
-    }
-  }
-  return installed;
-}
-function printSkillUsage() {
-  console.log(`
-  flowbook skill \u2014 Install AI agent skill & /flowbook command
-
-  Usage:
-    flowbook skill <agent>           Install to project
-    flowbook skill <agent> --global  Install globally
-    flowbook skill <agent> -g        Install globally (short)
-
-  Agents:
-    all          All supported agents
-    claude       Claude Code
-    codex        OpenAI Codex
-    copilot      VS Code / GitHub Copilot
-    antigravity  Google Antigravity
-    gemini       Gemini CLI
-    cursor       Cursor
-    windsurf     Windsurf (Codeium)
-    amp          AmpCode
-    opencode     OpenCode / oh-my-opencode
-
-  Examples:
-    flowbook skill all              Install to all agents (project)
-    flowbook skill opencode -g      Install globally for OpenCode
-    flowbook skill claude --global  Install globally for Claude Code
-`);
-}
-
-// src/node/init.ts
-var EXAMPLE_FLOW = `---
-title: Example Flow
-category: Getting Started
-tags: [example]
-order: 1
-description: An example flowchart to get you started
----
-
-\`\`\`mermaid
-flowchart TD
-    A[Start] --> B{Decision}
-    B -->|Yes| C[Action A]
-    B -->|No| D[Action B]
-    C --> E[End]
-    D --> E
-\`\`\`
-`;
 async function initFlowbook() {
   const cwd = process.cwd();
-  const pkgPath = resolve2(cwd, "package.json");
-  if (!existsSync2(pkgPath)) {
+  const pkgPath = resolve(cwd, "package.json");
+  if (!existsSync(pkgPath)) {
     console.error("  No package.json found. Run 'npm init' first.");
     process.exit(1);
   }
@@ -260,40 +38,26 @@ async function initFlowbook() {
   } else {
     console.log("  \u2713 Scripts already exist in package.json");
   }
-  const flowsDir = resolve2(cwd, "flows");
-  const examplePath = resolve2(flowsDir, "example.flow.md");
-  if (!existsSync2(examplePath)) {
-    mkdirSync2(flowsDir, { recursive: true });
-    writeFileSync(examplePath, EXAMPLE_FLOW);
-    console.log("  \u2713 Created flows/example.flow.md");
-  } else {
-    console.log("  \u2713 Example flow already exists");
-  }
-  const gitignorePath = resolve2(cwd, ".gitignore");
-  if (existsSync2(gitignorePath)) {
+  const gitignorePath = resolve(cwd, ".gitignore");
+  if (existsSync(gitignorePath)) {
     const gitignore = readFileSync(gitignorePath, "utf-8");
     if (!gitignore.includes("flowbook-static")) {
       writeFileSync(gitignorePath, gitignore.trimEnd() + "\nflowbook-static\n");
       console.log("  \u2713 Added flowbook-static to .gitignore");
     }
   }
-  const installed = installAllProjectSkills();
-  if (installed > 0) {
-    console.log(`  \u2713 Installed AI agent skill to ${installed} agent directories`);
-  } else {
-    console.log("  \u2713 AI agent skills already installed");
-  }
   const run = pm === "yarn" ? "yarn" : `${pm} run`;
   console.log("");
   console.log("  Next steps:");
-  console.log(`    ${run} flowbook       Start the dev server`);
-  console.log(`    ${run} build-flowbook  Build static site`);
+  console.log(`    ${run} flowbook              Start the dev server`);
+  console.log(`    ${run} build-flowbook         Build static site`);
+  console.log(`    flowbook skill <agent> [-g]   Install AI skill & /flowbook command`);
   console.log("");
 }
 function detectPackageManager(cwd) {
-  if (existsSync2(resolve2(cwd, "bun.lockb")) || existsSync2(resolve2(cwd, "bun.lock"))) return "bun";
-  if (existsSync2(resolve2(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync2(resolve2(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync(resolve(cwd, "bun.lockb")) || existsSync(resolve(cwd, "bun.lock"))) return "bun";
+  if (existsSync(resolve(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(resolve(cwd, "yarn.lock"))) return "yarn";
   return "npm";
 }
 function getInstallCommand(pm) {
@@ -400,11 +164,11 @@ function flowbookPlugin(options = {}) {
 }
 
 // src/node/server.ts
-import { resolve as resolve3, dirname as dirname2 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+import { resolve as resolve2, dirname } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
 function getClientDir() {
-  return resolve3(__dirname2, "..", "src", "client");
+  return resolve2(__dirname, "..", "src", "client");
 }
 function createConfig(options) {
   const cwd = options.cwd ?? process.cwd();
@@ -425,7 +189,7 @@ function createConfig(options) {
       port: options.port ?? 6200
     },
     build: {
-      outDir: resolve3(cwd, options.outDir ?? "flowbook-static"),
+      outDir: resolve2(cwd, options.outDir ?? "flowbook-static"),
       emptyOutDir: true
     }
   };
@@ -444,6 +208,196 @@ async function buildStatic(options) {
 `);
 }
 
+// src/node/skill.ts
+import { existsSync as existsSync2, mkdirSync, copyFileSync } from "fs";
+import { resolve as resolve3, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { homedir } from "os";
+var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+var AGENTS = [
+  {
+    name: "Claude Code",
+    aliases: ["claude"],
+    skill: {
+      project: ".claude/skills/flowbook",
+      global: ".claude/skills/flowbook"
+    },
+    command: {
+      project: ".claude/commands",
+      global: ".claude/commands",
+      format: "frontmatter"
+    }
+  },
+  {
+    name: "OpenAI Codex",
+    aliases: ["codex"],
+    skill: {
+      project: ".agents/skills/flowbook",
+      global: ".codex/skills/flowbook"
+    }
+  },
+  {
+    name: "VS Code / GitHub Copilot",
+    aliases: ["copilot", "vscode"],
+    skill: {
+      project: ".github/skills/flowbook",
+      global: ".copilot/skills/flowbook"
+    }
+  },
+  {
+    name: "Google Antigravity",
+    aliases: ["antigravity"],
+    skill: {
+      project: ".agent/skills/flowbook",
+      global: ".gemini/antigravity/skills/flowbook"
+    }
+  },
+  {
+    name: "Gemini CLI",
+    aliases: ["gemini"],
+    skill: {
+      project: ".gemini/skills/flowbook",
+      global: ".gemini/skills/flowbook"
+    }
+  },
+  {
+    name: "Cursor",
+    aliases: ["cursor"],
+    skill: {
+      project: ".cursor/skills/flowbook",
+      global: ".cursor/skills/flowbook"
+    },
+    command: {
+      project: ".cursor/commands",
+      global: ".cursor/commands",
+      format: "plain"
+    }
+  },
+  {
+    name: "Windsurf",
+    aliases: ["windsurf"],
+    skill: {
+      project: ".windsurf/skills/flowbook",
+      global: ".codeium/windsurf/skills/flowbook"
+    },
+    command: {
+      project: ".windsurf/workflows",
+      global: ".codeium/windsurf/workflows",
+      format: "plain"
+    }
+  },
+  {
+    name: "AmpCode",
+    aliases: ["amp"],
+    skill: {
+      project: ".amp/skills/flowbook",
+      global: ".config/agents/skills/flowbook"
+    }
+  },
+  {
+    name: "OpenCode",
+    aliases: ["opencode"],
+    skill: {
+      project: ".opencode/skills/flowbook",
+      global: ".config/opencode/skills/flowbook"
+    },
+    command: {
+      project: ".opencode/command",
+      global: ".config/opencode/command",
+      format: "frontmatter"
+    }
+  }
+];
+function getSkillSrc() {
+  return resolve3(__dirname2, "..", "src", "skills", "flowbook", "SKILL.md");
+}
+function getCommandSrc(format) {
+  const file = format === "frontmatter" ? "flowbook.md" : "flowbook.plain.md";
+  return resolve3(__dirname2, "..", "src", "commands", file);
+}
+function resolveAgents(agentArg) {
+  if (agentArg === "all") return AGENTS;
+  const lower = agentArg.toLowerCase();
+  const found = AGENTS.filter(
+    (a) => a.aliases.includes(lower) || a.name.toLowerCase().includes(lower)
+  );
+  if (found.length === 0) {
+    console.error(`  Unknown agent: "${agentArg}"`);
+    console.error(`  Available: all, ${AGENTS.flatMap((a) => a.aliases).join(", ")}`);
+    process.exit(1);
+  }
+  return found;
+}
+function installFile(src, destDir, destFilename) {
+  const dest = resolve3(destDir, destFilename);
+  if (existsSync2(dest)) return false;
+  mkdirSync(destDir, { recursive: true });
+  copyFileSync(src, dest);
+  return true;
+}
+function installSkills(agentArg, global) {
+  const agents = resolveAgents(agentArg);
+  const base = global ? homedir() : process.cwd();
+  const skillSrc = getSkillSrc();
+  if (!existsSync2(skillSrc)) {
+    console.error("  \u2717 Skill source file not found. Reinstall flowbook.");
+    process.exit(1);
+  }
+  let skillCount = 0;
+  let cmdCount = 0;
+  for (const agent of agents) {
+    const skillDir = resolve3(base, global ? agent.skill.global : agent.skill.project);
+    if (installFile(skillSrc, skillDir, "SKILL.md")) {
+      skillCount++;
+    }
+    if (agent.command) {
+      const cmdSrc = getCommandSrc(agent.command.format);
+      if (existsSync2(cmdSrc)) {
+        const cmdDir = resolve3(base, global ? agent.command.global : agent.command.project);
+        if (installFile(cmdSrc, cmdDir, "flowbook.md")) {
+          cmdCount++;
+        }
+      }
+    }
+  }
+  const scope = global ? "global" : "project";
+  const agentNames = agents.map((a) => a.name).join(", ");
+  if (skillCount > 0 || cmdCount > 0) {
+    if (skillCount > 0) console.log(`  \u2713 Installed skill to ${skillCount} ${scope} director${skillCount > 1 ? "ies" : "y"}`);
+    if (cmdCount > 0) console.log(`  \u2713 Installed /flowbook command to ${cmdCount} ${scope} director${cmdCount > 1 ? "ies" : "y"}`);
+    console.log(`  Agents: ${agentNames}`);
+  } else {
+    console.log(`  \u2713 Already installed for: ${agentNames}`);
+  }
+}
+function printSkillUsage() {
+  console.log(`
+  flowbook skill \u2014 Install AI agent skill & /flowbook command
+
+  Usage:
+    flowbook skill <agent>           Install to project
+    flowbook skill <agent> --global  Install globally
+    flowbook skill <agent> -g        Install globally (short)
+
+  Agents:
+    all          All supported agents
+    claude       Claude Code
+    codex        OpenAI Codex
+    copilot      VS Code / GitHub Copilot
+    antigravity  Google Antigravity
+    gemini       Gemini CLI
+    cursor       Cursor
+    windsurf     Windsurf (Codeium)
+    amp          AmpCode
+    opencode     OpenCode / oh-my-opencode
+
+  Examples:
+    flowbook skill all              Install to all agents (project)
+    flowbook skill opencode -g      Install globally for OpenCode
+    flowbook skill claude --global  Install globally for Claude Code
+`);
+}
+
 // src/node/cli.ts
 async function main() {
   const args = process.argv.slice(2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowbook",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "bin": {
     "flowbook": "./dist/cli.js"

package/src/node/init.ts

@@ -1,26 +1,6 @@
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
 import { resolve } from "node:path";
 import { execSync } from "node:child_process";
-import { installAllProjectSkills } from "./skill";
-
-
-const EXAMPLE_FLOW = `---
-title: Example Flow
-category: Getting Started
-tags: [example]
-order: 1
-description: An example flowchart to get you started
----
-
-\`\`\`mermaid
-flowchart TD
-    A[Start] --> B{Decision}
-    B -->|Yes| C[Action A]
-    B -->|No| D[Action B]
-    C --> E[End]
-    D --> E
-\`\`\`
-`;
 
 export async function initFlowbook() {
   const cwd = process.cwd();
@@ -65,18 +45,6 @@ export async function initFlowbook() {
     console.log("  ✓ Scripts already exist in package.json");
   }
 
-  // 3. Create example flow file
-  const flowsDir = resolve(cwd, "flows");
-  const examplePath = resolve(flowsDir, "example.flow.md");
-
-  if (!existsSync(examplePath)) {
-    mkdirSync(flowsDir, { recursive: true });
-    writeFileSync(examplePath, EXAMPLE_FLOW);
-    console.log("  ✓ Created flows/example.flow.md");
-  } else {
-    console.log("  ✓ Example flow already exists");
-  }
-
   // 4. Add flowbook-static to .gitignore
   const gitignorePath = resolve(cwd, ".gitignore");
   if (existsSync(gitignorePath)) {
@@ -87,19 +55,12 @@ export async function initFlowbook() {
     }
   }
 
-  // 5. Install AI agent skill to all supported agent directories
-  const installed = installAllProjectSkills();
-  if (installed > 0) {
-    console.log(`  ✓ Installed AI agent skill to ${installed} agent directories`);
-  } else {
-    console.log("  ✓ AI agent skills already installed");
-  }
-
   const run = pm === "yarn" ? "yarn" : `${pm} run`;
   console.log("");
   console.log("  Next steps:");
-  console.log(`    ${run} flowbook       Start the dev server`);
-  console.log(`    ${run} build-flowbook  Build static site`);
+  console.log(`    ${run} flowbook              Start the dev server`);
+  console.log(`    ${run} build-flowbook         Build static site`);
+  console.log(`    flowbook skill <agent> [-g]   Install AI skill & /flowbook command`);
   console.log("");
 }