@cliangdev/flux-plugin 0.0.0-dev.8e9707e → 0.0.0-dev.cf5e864

package/README.md

@@ -4,30 +4,29 @@ Agent-orchestrated, spec-driven workflow for Claude Code.
 
 ## Installation
 
-### Quick Install (Recommended)
-
 ```bash
-claude mcp add flux -- npx -y @cliangdev/flux-plugin
+npx @cliangdev/flux-plugin
 ```
 
-### Manual Configuration
-
-Add to your `.mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "flux": {
-      "command": "npx",
-      "args": ["-y", "@cliangdev/flux-plugin"],
-      "env": {
-        "FLUX_PROJECT_ROOT": "${CLAUDE_PROJECT_DIR}"
-      }
-    }
-  }
-}
+This installs:
+- Commands (`/flux`, `/flux:prd`, `/flux:breakdown`, `/flux:implement`)
+- Skills for AI orchestration
+- MCP server for project data
+
+### Options
+
+```bash
+npx @cliangdev/flux-plugin --global   # Install to ~/.claude (all projects)
+npx @cliangdev/flux-plugin --local    # Install to ./.claude (current project)
 ```
 
+### What Gets Configured
+
+The installer automatically:
+1. Copies commands to `.claude/commands/`
+2. Copies skills to `.claude/skills/`
+3. Adds MCP server config to `.claude.json`
+
 ## Commands
 
 | Command | Purpose |
@@ -119,13 +118,47 @@ your-project/
 
 ## Updating
 
-The plugin auto-updates via npx. Restart Claude Code to get the latest version.
+To update to the latest version, simply re-run the installer:
 
-Check your version:
+```bash
+npx @cliangdev/flux-plugin@latest --global
+```
+
+This will:
+- Update commands and skills to the latest version
+- Update the MCP server configuration
+
+Check your current version:
 ```
 /flux version
 ```
 
+## Uninstall
+
+### Global Installation
+
+```bash
+# Remove commands and skills
+rm -rf ~/.claude/commands/flux ~/.claude/commands/prd ~/.claude/commands/breakdown ~/.claude/commands/implement
+rm -rf ~/.claude/skills/agent-creator ~/.claude/skills/epic-template ~/.claude/skills/flux-orchestrator ~/.claude/skills/prd-template
+rm -f ~/.claude/flux-version
+
+# Remove MCP server config (edit ~/.claude.json and remove the "flux" entry from "mcpServers")
+```
+
+### Local Installation
+
+```bash
+# Remove commands and skills
+rm -rf .claude/commands/flux .claude/commands/prd .claude/commands/breakdown .claude/commands/implement
+rm -rf .claude/skills/agent-creator .claude/skills/epic-template .claude/skills/flux-orchestrator .claude/skills/prd-template
+rm -f .claude/flux-version
+
+# Remove MCP server config (edit .claude.json and remove the "flux" entry from "mcpServers")
+```
+
+Note: Your project data in `.flux/` is preserved. Delete it manually if you want to remove all Flux data.
+
 ## Support
 
 GitHub: [github.com/cliangdev/flux-plugin](https://github.com/cliangdev/flux-plugin)

package/bin/install.cjs

@@ -0,0 +1,243 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const readline = require("readline");
+
+// Parse args first to check for serve command
+const args = process.argv.slice(2);
+
+// Check for "serve" subcommand - starts MCP server
+if (args[0] === "serve") {
+	// Dynamic import to load ESM server
+	import("../dist/server/index.js").catch((err) => {
+		console.error("Failed to start Flux MCP server:", err.message);
+		process.exit(1);
+	});
+} else {
+	// Run installer
+	runInstaller();
+}
+
+function runInstaller() {
+	// Colors
+	const cyan = "\x1b[36m";
+	const green = "\x1b[32m";
+	const yellow = "\x1b[33m";
+	const dim = "\x1b[2m";
+	const reset = "\x1b[0m";
+
+	// Get version from package.json
+	const pkg = require("../package.json");
+
+	const banner = `
+${cyan}  ███████╗██╗     ██╗   ██╗██╗  ██╗
+  ██╔════╝██║     ██║   ██║╚██╗██╔╝
+  █████╗  ██║     ██║   ██║ ╚███╔╝
+  ██╔══╝  ██║     ██║   ██║ ██╔██╗
+  ██║     ███████╗╚██████╔╝██╔╝ ██╗
+  ╚═╝     ╚══════╝ ╚═════╝ ╚═╝  ╚═╝${reset}
+
+  Flux Plugin ${dim}v${pkg.version}${reset}
+  AI-first workflow orchestration for Claude Code
+`;
+
+	const hasGlobal = args.includes("--global") || args.includes("-g");
+	const hasLocal = args.includes("--local") || args.includes("-l");
+	const hasHelp = args.includes("--help") || args.includes("-h");
+
+	console.log(banner);
+
+	// Show help
+	if (hasHelp) {
+		console.log(`  ${yellow}Usage:${reset} npx @cliangdev/flux-plugin [options]
+
+  ${yellow}Options:${reset}
+    ${cyan}-g, --global${reset}    Install globally (to ~/.claude)
+    ${cyan}-l, --local${reset}     Install locally (to ./.claude in current directory)
+    ${cyan}-h, --help${reset}      Show this help message
+
+  ${yellow}Examples:${reset}
+    ${dim}# Interactive installation${reset}
+    npx @cliangdev/flux-plugin
+
+    ${dim}# Install globally (all projects)${reset}
+    npx @cliangdev/flux-plugin --global
+
+    ${dim}# Install locally (current project only)${reset}
+    npx @cliangdev/flux-plugin --local
+`);
+		process.exit(0);
+	}
+
+	/**
+	 * Recursively copy directory
+	 */
+	function copyDir(src, dest) {
+		fs.mkdirSync(dest, { recursive: true });
+		const entries = fs.readdirSync(src, { withFileTypes: true });
+
+		for (const entry of entries) {
+			const srcPath = path.join(src, entry.name);
+			const destPath = path.join(dest, entry.name);
+
+			if (entry.isDirectory()) {
+				copyDir(srcPath, destPath);
+			} else {
+				fs.copyFileSync(srcPath, destPath);
+			}
+		}
+	}
+
+	/**
+	 * Read JSON file, return empty object if doesn't exist
+	 */
+	function readJson(filePath) {
+		if (fs.existsSync(filePath)) {
+			try {
+				return JSON.parse(fs.readFileSync(filePath, "utf8"));
+			} catch {
+				return {};
+			}
+		}
+		return {};
+	}
+
+	/**
+	 * Write JSON file with formatting
+	 */
+	function writeJson(filePath, data) {
+		fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
+	}
+
+	/**
+	 * Install to specified directory
+	 */
+	function install(isGlobal) {
+		const src = path.join(__dirname, "..");
+		const claudeDir = isGlobal
+			? path.join(os.homedir(), ".claude")
+			: path.join(process.cwd(), ".claude");
+
+		const locationLabel = isGlobal ? "~/.claude" : "./.claude";
+
+		console.log(`  Installing to ${cyan}${locationLabel}${reset}\n`);
+
+		// Create directories
+		fs.mkdirSync(claudeDir, { recursive: true });
+
+		// Copy commands
+		const commandsSrc = path.join(src, "commands");
+		if (fs.existsSync(commandsSrc)) {
+			const commandsDest = path.join(claudeDir, "commands");
+			fs.mkdirSync(commandsDest, { recursive: true });
+
+			// Copy each command as a directory (flux.md -> commands/flux/COMMAND.md)
+			const commandFiles = fs.readdirSync(commandsSrc);
+			for (const file of commandFiles) {
+				if (file.endsWith(".md")) {
+					const name = file.replace(".md", "");
+					const destDir = path.join(commandsDest, name);
+					fs.mkdirSync(destDir, { recursive: true });
+					fs.copyFileSync(
+						path.join(commandsSrc, file),
+						path.join(destDir, "COMMAND.md")
+					);
+					console.log(`  ${green}✓${reset} Installed command: /${name}`);
+				}
+			}
+		}
+
+		// Copy skills
+		const skillsSrc = path.join(src, "skills");
+		if (fs.existsSync(skillsSrc)) {
+			const skillsDest = path.join(claudeDir, "skills");
+			fs.mkdirSync(skillsDest, { recursive: true });
+
+			// Copy each skill directory
+			const skillDirs = fs.readdirSync(skillsSrc, { withFileTypes: true });
+			for (const dir of skillDirs) {
+				if (dir.isDirectory()) {
+					copyDir(
+						path.join(skillsSrc, dir.name),
+						path.join(skillsDest, dir.name)
+					);
+					console.log(`  ${green}✓${reset} Installed skill: ${dir.name}`);
+				}
+			}
+		}
+
+		// Configure MCP server
+		const claudeJsonPath = isGlobal
+			? path.join(os.homedir(), ".claude.json")
+			: path.join(process.cwd(), ".claude.json");
+
+		const claudeJson = readJson(claudeJsonPath);
+
+		if (!claudeJson.mcpServers) {
+			claudeJson.mcpServers = {};
+		}
+
+		// Add or update flux MCP server
+		claudeJson.mcpServers.flux = {
+			command: "npx",
+			args: ["-y", "@cliangdev/flux-plugin", "serve"],
+		};
+
+		writeJson(claudeJsonPath, claudeJson);
+		console.log(
+			`  ${green}✓${reset} Configured MCP server in ${isGlobal ? "~/.claude.json" : "./.claude.json"}`
+		);
+
+		// Write version file for update checking
+		const versionFile = path.join(claudeDir, "flux-version");
+		fs.writeFileSync(versionFile, pkg.version);
+
+		console.log(`
+  ${green}Done!${reset} Restart Claude Code and run ${cyan}/flux${reset} to get started.
+
+  ${dim}Commands available:${reset}
+    /flux           - Project status and guidance
+    /flux:prd       - Create or refine PRDs
+    /flux:breakdown - Break PRDs into epics and tasks
+    /flux:implement - Implement tasks with TDD
+
+  ${dim}Learn more:${reset} https://github.com/cliangdev/flux-plugin
+`);
+	}
+
+	/**
+	 * Prompt for install location
+	 */
+	function promptLocation() {
+		const rl = readline.createInterface({
+			input: process.stdin,
+			output: process.stdout,
+		});
+
+		console.log(`  ${yellow}Where would you like to install?${reset}
+
+  ${cyan}1${reset}) Global ${dim}(~/.claude)${reset} - available in all projects
+  ${cyan}2${reset}) Local  ${dim}(./.claude)${reset} - this project only
+`);
+
+		rl.question(`  Choice ${dim}[1]${reset}: `, (answer) => {
+			rl.close();
+			const choice = answer.trim() || "1";
+			install(choice !== "2");
+		});
+	}
+
+	// Main
+	if (hasGlobal && hasLocal) {
+		console.error(`  ${yellow}Cannot specify both --global and --local${reset}`);
+		process.exit(1);
+	} else if (hasGlobal) {
+		install(true);
+	} else if (hasLocal) {
+		install(false);
+	} else {
+		promptLocation();
+	}
+}

package/dist/server/index.js

@@ -22481,7 +22481,6 @@ var config2 = {
 };
 
 // src/server/db/index.ts
-import { Database } from "bun:sqlite";
 import { existsSync as existsSync2, mkdirSync } from "node:fs";
 
 // src/server/utils/logger.ts
@@ -22584,6 +22583,43 @@ CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
 CREATE INDEX IF NOT EXISTS idx_criteria_parent ON acceptance_criteria(parent_type, parent_id);
 `;
 
+// src/server/db/sqlite.ts
+var isBun = typeof process !== "undefined" && !!process.versions?.bun;
+var DatabaseImpl;
+if (isBun) {
+  const { Database: BunDatabase } = await import("bun:sqlite");
+  DatabaseImpl = BunDatabase;
+} else {
+  const BetterSqlite3 = (await import("better-sqlite3")).default;
+
+  class BetterSqlite3Wrapper {
+    db;
+    constructor(path) {
+      this.db = new BetterSqlite3(path);
+    }
+    query(sql) {
+      const stmt = this.db.prepare(sql);
+      return {
+        get: (...params) => stmt.get(...params),
+        all: (...params) => stmt.all(...params),
+        run: (...params) => {
+          stmt.run(...params);
+        }
+      };
+    }
+    exec(sql) {
+      this.db.exec(sql);
+    }
+    run(sql) {
+      this.db.exec(sql);
+    }
+    close() {
+      this.db.close();
+    }
+  }
+  DatabaseImpl = BetterSqlite3Wrapper;
+}
+
 // src/server/db/ids.ts
 function generateId(prefix = "") {
   const timestamp = Date.now().toString(36);
@@ -22686,7 +22722,7 @@ function initDb() {
     mkdirSync(config2.fluxPath, { recursive: true });
   }
   logger.info(`Opening database: ${config2.dbPath}`);
-  db = new Database(config2.dbPath);
+  db = new DatabaseImpl(config2.dbPath);
   db.run("PRAGMA foreign_keys = ON");
   db.exec(SCHEMA);
   logger.info("Database initialized successfully");
@@ -86184,14 +86220,7 @@ var getStatsTool = {
   handler: handler8
 };
 // src/version.ts
-import { readFileSync as readFileSync6 } from "node:fs";
-import { dirname as dirname2, join as join2 } from "node:path";
-import { fileURLToPath } from "node:url";
-var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = dirname2(__filename2);
-var packageJsonPath = join2(__dirname2, "..", "package.json");
-var packageJson = JSON.parse(readFileSync6(packageJsonPath, "utf-8"));
-var VERSION = packageJson.version;
+var VERSION = "0.1.0";
 
 // src/server/tools/get-version.ts
 var inputSchema10 = exports_external.object({});
@@ -86208,15 +86237,15 @@ var getVersionTool = {
   handler: handler9
 };
 // src/server/tools/init-project.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
-import { dirname as dirname3, join as join3 } from "node:path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname2, join as join2 } from "node:path";
 function getStatusLineBinaryPath() {
-  const thisDir = dirname3(new URL(import.meta.url).pathname);
-  return join3(thisDir, "..", "..", "..", "bin", "flux-status");
+  const thisDir = dirname2(new URL(import.meta.url).pathname);
+  return join2(thisDir, "..", "..", "..", "bin", "flux-status");
 }
 function setupClaudeSettings(projectRoot) {
-  const claudeDir = join3(projectRoot, ".claude");
-  const settingsPath = join3(claudeDir, "settings.local.json");
+  const claudeDir = join2(projectRoot, ".claude");
+  const settingsPath = join2(claudeDir, "settings.local.json");
   const statusBinaryPath = getStatusLineBinaryPath();
   if (!existsSync8(statusBinaryPath)) {
     return;
@@ -86227,7 +86256,7 @@ function setupClaudeSettings(projectRoot) {
   let settings = {};
   if (existsSync8(settingsPath)) {
     try {
-      settings = JSON.parse(readFileSync7(settingsPath, "utf-8"));
+      settings = JSON.parse(readFileSync6(settingsPath, "utf-8"));
     } catch {
       settings = {};
     }
@@ -86393,7 +86422,7 @@ var queryEntitiesTool = {
   handler: handler11
 };
 // src/server/tools/render-status.ts
-import { existsSync as existsSync9, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync9, readFileSync as readFileSync7 } from "node:fs";
 
 // src/utils/display.ts
 function renderProgressBar(percentage, width) {
@@ -86506,7 +86535,7 @@ function getProjectInfo() {
     return null;
   }
   try {
-    const content = readFileSync8(config2.projectJsonPath, "utf-8");
+    const content = readFileSync7(config2.projectJsonPath, "utf-8");
     const project = JSON.parse(content);
     return {
       name: project.name || "Unnamed Project",

package/package.json

@@ -1,20 +1,21 @@
 {
   "name": "@cliangdev/flux-plugin",
-  "version": "0.0.0-dev.8e9707e",
+  "version": "0.0.0-dev.cf5e864",
   "description": "Claude Code plugin for AI-first workflow orchestration with MCP server",
   "type": "module",
   "main": "./dist/server/index.js",
   "bin": {
-    "flux-plugin": "./dist/server/index.js"
+    "flux-plugin": "./bin/install.cjs"
   },
   "files": [
+    "bin/",
     "dist/",
     "skills/",
     "commands/"
   ],
   "scripts": {
     "dev": "bun run src/server/index.ts",
-    "build": "bun build src/server/index.ts --outdir dist/server --target node",
+    "build": "bun build src/server/index.ts --outdir dist/server --target node --external better-sqlite3",
     "postbuild": "node -e \"const fs=require('fs');const f='dist/server/index.js';const c=fs.readFileSync(f,'utf-8');if(!c.startsWith('#!/usr/bin/env node')){fs.writeFileSync(f,'#!/usr/bin/env node\\n'+c)}\"",
     "build:compile": "bun build --compile --outfile bin/flux-server src/server/index.ts && bun build --compile --outfile bin/flux-status src/status-line/index.ts",
     "build:compile:server": "bun build --compile --outfile bin/flux-server src/server/index.ts",
@@ -47,12 +48,14 @@
   "license": "MIT",
   "devDependencies": {
     "@biomejs/biome": "^2.3.11",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/bun": "^1.3.6",
     "typescript": "^5.0.0"
   },
   "dependencies": {
     "@linear/sdk": "^70.0.0",
     "@modelcontextprotocol/sdk": "^1.25.2",
+    "better-sqlite3": "^12.6.2",
     "chalk": "^5.4.1",
     "zod": "^4.3.5"
   },