@curdx/flow 1.1.8 → 1.1.10

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "CurDX-Flow marketplace — distributes the curdx-flow meta-framework plugin",
-    "version": "1.1.8"
+    "version": "1.1.10"
   },
   "plugins": [
     {

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "curdx-flow",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "AI engineering workflow meta-framework — spec-driven + autonomous execution + quality gates + multi-agent collaboration. Distills Karpathy + BMAD + GSD + Ralph + Superpowers + GStack and orchestrates context7 / sequential-thinking / chrome-devtools / frontend-design / claude-mem / pua dependencies.",
   "author": {
     "name": "wdx",

package/README.md

@@ -43,14 +43,21 @@ Existing AI-coding workflows suffer from:
 
 ### Recommended: one-shot via npm (works in any project, fast on Chinese npm mirrors)
 ```bash
-# Interactive (picks recommended plugins)
+# Interactive install (picks recommended plugins)
 npx @curdx/flow install
 
 # Or install everything automatically
 npx @curdx/flow install --all
 
-# Health check
-npx @curdx/flow doctor
+# After the one-time install, initialize your project INSIDE Claude Code:
+#   $ claude
+#   /curdx-flow:init
+#   /curdx-flow:start my-feature "<description>"
+
+# Other CLI lifecycle operations
+npx @curdx/flow doctor      # Health check
+npx @curdx/flow upgrade     # Update all plugins
+npx @curdx/flow uninstall   # Remove curdx-flow
 ```
 
 ### From the Claude Code marketplace

package/bin/curdx-flow.js

@@ -3,21 +3,25 @@
  * curdx-flow CLI entry
  *
  * Usage:
- *   npx github:curdx/curdx-flow <command> [args]
- *   (or after npm publish: npx @curdx/flow <command> [args])
+ *   npx @curdx/flow <command> [args]
+ *
+ * The CLI only handles install-time and lifecycle operations that must
+ * happen outside Claude Code. Anything a user does while Claude Code is
+ * running (init a project, start a spec, run the workflow, etc.) is a
+ * slash command: /curdx-flow:init, /curdx-flow:start, and so on.
  *
  * Commands:
- *   install   Install curdx-flow plugin + optional recommended plugins
- *   doctor    Check health (claude CLI, plugin, MCPs, recommended plugins)
- *   init      Initialize .flow/ in current project (external version)
- *   upgrade   Update curdx-flow + recommended plugins to latest
- *   help      Show this help
+ *   install    Install curdx-flow plugin + optional recommended plugins
+ *   doctor     Check health (claude CLI, plugin, MCPs, recommended plugins)
+ *   upgrade    Update curdx-flow + recommended plugins to latest
+ *   uninstall  Remove curdx-flow plugin (and optionally recommended / artifacts)
  *   --version / -v
+ *   --help / -h  (CLI usage summary — use /curdx-flow:help in Claude Code
+ *                 for the full command/workflow reference)
  */
 
 import { install } from "../cli/install.js";
 import { doctor } from "../cli/doctor.js";
-import { init } from "../cli/init.js";
 import { upgrade } from "../cli/upgrade.js";
 import { uninstall } from "../cli/uninstall.js";
 import { VERSION, color } from "../cli/utils.js";
@@ -32,7 +36,7 @@ ${color.bold("curdx-flow")} ${color.dim(`v${VERSION}`)}
 CurDX-Flow installer & helper for Claude Code
 
 ${color.bold("USAGE")}
-  curdx-flow <command> [options]
+  npx @curdx/flow <command> [options]
 
 ${color.bold("COMMANDS")}
   ${color.cyan("install")}   Install curdx-flow plugin + optional recommended plugins
@@ -44,10 +48,6 @@ ${color.bold("COMMANDS")}
 
   ${color.cyan("doctor")}    Check health (claude CLI, plugin, MCPs, recommended)
 
-  ${color.cyan("init")}      Initialize .flow/ in current project (no Claude Code needed)
-            [path]      Target directory (default: cwd)
-            --force     Overwrite existing .flow/
-
   ${color.cyan("upgrade")}   Update curdx-flow and recommended plugins to latest
 
   ${color.cyan("uninstall")} Remove curdx-flow plugin (and optionally recommended / artifacts)
@@ -55,24 +55,30 @@ ${color.bold("COMMANDS")}
             --keep-recommended  Don't ask about pua/claude-mem/frontend-design
             --purge             Also remove ~/.local/bin/bun, ~/.local/bin/uv symlinks
 
-  ${color.cyan("help")}      Show this help (same as --help / -h)
-
 ${color.bold("OPTIONS")}
   -v, --version       Print version
-  -h, --help          Show help
+  -h, --help          Show this CLI usage summary
+
+${color.dim("For the full command / workflow reference (including all slash")}
+${color.dim("commands like /curdx-flow:start, /curdx-flow:spec, …) run:")}
+  ${color.cyan("/curdx-flow:help")}  ${color.dim("(inside Claude Code)")}
 
 ${color.bold("EXAMPLES")}
   ${color.dim("# First-time install with recommended plugins")}
-  npx github:curdx/curdx-flow install --all
+  npx @curdx/flow install --all
 
   ${color.dim("# Check what's installed")}
-  npx github:curdx/curdx-flow doctor
-
-  ${color.dim("# Initialize your project")}
-  cd ~/my-project && npx github:curdx/curdx-flow init
+  npx @curdx/flow doctor
 
   ${color.dim("# Update everything")}
-  npx github:curdx/curdx-flow upgrade
+  npx @curdx/flow upgrade
+
+${color.bold("INITIALIZING A PROJECT")}
+  Once curdx-flow is installed, initialize your project inside Claude Code:
+
+    ${color.cyan("claude")}
+    ${color.cyan("/curdx-flow:init")}
+    ${color.cyan("/curdx-flow:start my-feature \"<description>\"")}
 
 ${color.bold("LEARN MORE")}
   https://github.com/curdx/curdx-flow
@@ -86,8 +92,8 @@ async function main() {
     return;
   }
 
-  // Help flags
-  if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+  // Help flags (standard CLI convention: -h / --help / no args)
+  if (!cmd || cmd === "--help" || cmd === "-h") {
     printHelp();
     return;
   }
@@ -101,9 +107,6 @@ async function main() {
       case "doctor":
         await doctor(rest);
         break;
-      case "init":
-        await init(rest);
-        break;
       case "upgrade":
         await upgrade(rest);
         break;
@@ -111,9 +114,29 @@ async function main() {
       case "remove":
         await uninstall(rest);
         break;
+      case "init":
+        console.error(color.red(`The 'init' CLI command has been removed in 1.1.9.`));
+        console.error(``);
+        console.error(`Project initialization is a Claude Code slash command:`);
+        console.error(`  ${color.cyan("claude")}`);
+        console.error(`  ${color.cyan("/curdx-flow:init")}`);
+        console.error(``);
+        console.error(`The CLI only handles install-time operations.`);
+        process.exit(1);
+      case "help":
+        console.error(color.red(`The 'help' CLI subcommand has been removed in 1.1.10.`));
+        console.error(``);
+        console.error(`For a brief CLI usage summary, use the standard flag:`);
+        console.error(`  ${color.cyan("npx @curdx/flow --help")}   ${color.dim("(or -h)")}`);
+        console.error(``);
+        console.error(`For the full command / workflow reference, use the slash command`);
+        console.error(`inside Claude Code:`);
+        console.error(`  ${color.cyan("claude")}`);
+        console.error(`  ${color.cyan("/curdx-flow:help")}`);
+        process.exit(1);
       default:
         console.error(color.red(`Unknown command: ${cmd}`));
-        console.error(`Run ${color.cyan("curdx-flow help")} for usage.`);
+        console.error(`Run ${color.cyan("npx @curdx/flow --help")} for CLI usage.`);
         process.exit(1);
     }
   } catch (err) {

package/cli/README.md

@@ -12,14 +12,10 @@ npx github:curdx/curdx-flow install
 npx github:curdx/curdx-flow install --all
 
 # Health check
-npx github:curdx/curdx-flow doctor
-
-# Initialize a project (creates .flow/ in cwd)
-cd ~/your-project
-npx github:curdx/curdx-flow init
+npx @curdx/flow doctor
 
 # Update all plugins
-npx github:curdx/curdx-flow upgrade
+npx @curdx/flow upgrade
 ```
 
 ## Commands
@@ -41,11 +37,16 @@ Steps:
 
 External diagnostics: claude CLI / curdx-flow / 3 MCPs / 3 recommended plugins / current directory `.flow/` state.
 
-### `init [path] [--force]`
+### Project initialization (not a CLI command)
+
+Project initialization is a Claude Code slash command, not a CLI one. After `install`, open your project in Claude Code and run:
 
-In `path` (default cwd) creates `.flow/` directory: PROJECT.md / CONTEXT.md / STATE.md / ROADMAP.md / config.json + updates `.gitignore`.
+```
+claude
+/curdx-flow:init
+```
 
-If the curdx-flow plugin is installed, reads templates from the plugin cache; otherwise uses embedded fallback templates.
+This keeps the CLI scoped to install-time and lifecycle operations only — anything the user does while Claude Code is running stays inside Claude Code.
 
 ### `upgrade`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curdx/flow",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "CLI installer for CurDX-Flow — AI engineering workflow meta-framework for Claude Code",
   "type": "module",
   "bin": {

package/cli/init.js

@@ -1,312 +0,0 @@
-/**
- * init command — external version of /curdx-flow:init.
- * Creates .flow/ structure in target directory.
- *
- * Uses templates from plugin cache if available, falls back to embedded templates.
- */
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import { existsSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import {
-  color,
-  log,
-  confirm,
-  pluginCacheDir,
-  has,
-  runSync,
-} from "./utils.js";
-
-// When installed via npm, this file lives at <pkg>/cli/init.js; the templates
-// that ship with the npm package live at <pkg>/templates/. Always prefer those
-// over plugin-cache templates so the version installed via npm controls which
-// template language/content wins (plugin cache may lag behind npm releases).
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const NPM_PKG_TEMPLATES = path.join(__dirname, "..", "templates");
-
-export async function init(args = []) {
-  const force = args.includes("--force");
-  const target = args.find((a) => !a.startsWith("--")) || process.cwd();
-  const absTarget = path.resolve(target);
-
-  log.title(`📦 Initialize CurDX-Flow project`);
-  console.log(`   Target: ${color.cyan(absTarget)}`);
-
-  // ---------- Check target exists ----------
-  try {
-    const stat = await fs.stat(absTarget);
-    if (!stat.isDirectory()) {
-      log.err(`Target is not a directory: ${absTarget}`);
-      process.exit(1);
-    }
-  } catch {
-    log.err(`Directory does not exist: ${absTarget}`);
-    process.exit(1);
-  }
-
-  // ---------- Check existing .flow/ ----------
-  const flowDir = path.join(absTarget, ".flow");
-  if (existsSync(flowDir)) {
-    if (!force) {
-      log.warn(`.flow/ already exists`);
-      const ok = await confirm("Overwrite existing .flow/?", false);
-      if (!ok) {
-        log.info("Cancelled");
-        return;
-      }
-    }
-  }
-
-  // ---------- Find templates ----------
-  const tmplDir = await findLatestTemplatesDir();
-
-  // ---------- Create directory structure ----------
-  log.step(1, 4, "Creating .flow/ directory structure...");
-  const dirs = [
-    ".flow",
-    ".flow/specs",
-    ".flow/_epics",
-    ".flow/checkpoints",
-    ".flow/threads",
-    ".flow/seeds",
-  ];
-  for (const d of dirs) {
-    await fs.mkdir(path.join(absTarget, d), { recursive: true });
-  }
-  log.ok("Directories created");
-
-  // ---------- Generate files from templates ----------
-  log.step(2, 4, "Generating core files...");
-  const today = new Date().toISOString().slice(0, 10);
-  const userName = gitConfig("user.name") || "you";
-  const projectName = path.basename(absTarget);
-
-  const files = [
-    { tmpl: "PROJECT.md.tmpl", out: "PROJECT.md" },
-    { tmpl: "CONTEXT.md.tmpl", out: "CONTEXT.md" },
-    { tmpl: "STATE.md.tmpl", out: "STATE.md" },
-    { tmpl: "ROADMAP.md.tmpl", out: "ROADMAP.md" },
-    { tmpl: "config.json.tmpl", out: "config.json" },
-  ];
-
-  for (const f of files) {
-    const outPath = path.join(flowDir, f.out);
-    if (existsSync(outPath) && !force) {
-      log.info(`   ${f.out} already exists, skipping`);
-      continue;
-    }
-
-    let content;
-    if (tmplDir) {
-      try {
-        content = await fs.readFile(path.join(tmplDir, f.tmpl), "utf-8");
-      } catch {
-        content = embeddedTemplate(f.tmpl);
-      }
-    } else {
-      content = embeddedTemplate(f.tmpl);
-    }
-
-    // Placeholder replacement
-    content = content
-      .replace(/\{\{PROJECT_NAME\}\}/g, projectName)
-      .replace(/\{\{CREATED_DATE\}\}/g, today)
-      .replace(/\{\{USER_NAME\}\}/g, userName);
-
-    await fs.writeFile(outPath, content, "utf-8");
-    log.ok(`   .flow/${f.out}`);
-  }
-
-  // ---------- Update .gitignore ----------
-  log.step(3, 4, "Updating .gitignore...");
-  const giPath = path.join(absTarget, ".gitignore");
-  const giAdd = [
-    "",
-    "# CurDX-Flow runtime (auto-generated, do not commit)",
-    ".flow/checkpoints/",
-    ".flow/threads/",
-    ".flow/seeds/",
-    ".flow/.active-spec",
-    ".flow/specs/*/.state.json",
-    ".flow/specs/*/.progress.md",
-    ".flow/_epics/*/.epic-state.json",
-  ].join("\n");
-
-  let existingGi = "";
-  try {
-    existingGi = await fs.readFile(giPath, "utf-8");
-  } catch {
-    // no .gitignore yet
-  }
-
-  if (!existingGi.includes("CurDX-Flow")) {
-    await fs.writeFile(giPath, existingGi + giAdd + "\n", "utf-8");
-    log.ok(".gitignore appended with CurDX-Flow ignores");
-  } else {
-    log.info(".gitignore already has CurDX-Flow rules, skipping");
-  }
-
-  // ---------- Done ----------
-  log.blank();
-  log.step(4, 4, "Done");
-  log.ok(`CurDX-Flow project initialized: ${color.cyan(absTarget)}`);
-
-  console.log(`\n${color.bold("Next steps:")}\n`);
-  console.log(`  1. Edit ${color.cyan(".flow/PROJECT.md")} — fill in the project vision (~5 min)`);
-  console.log(`  2. Edit ${color.cyan(".flow/CONTEXT.md")} — your preferences`);
-  console.log(`  3. Enter Claude Code:`);
-  console.log(`     ${color.cyan("cd " + absTarget)}`);
-  console.log(`     ${color.cyan("claude")}`);
-  console.log(`     ${color.cyan("/curdx-flow:start my-feature \"<description>\"")}`);
-  console.log();
-}
-
-// ---------- Helpers ----------
-
-/**
- * Resolve the templates directory. Priority:
- *   1. npm package's own templates/ (shipped with this CLI version — authoritative)
- *   2. Latest Claude Code plugin cache (fallback for local-dev / unbundled runs)
- *   3. null → embedded fallback in embeddedTemplate() below
- */
-async function findLatestTemplatesDir() {
-  // 1. npm package ships its own templates (highest priority — never stale)
-  if (existsSync(NPM_PKG_TEMPLATES)) {
-    return NPM_PKG_TEMPLATES;
-  }
-
-  // 2. Claude Code plugin cache (for local-dev where pkg root is the plugin root)
-  const pluginBase = pluginCacheDir();
-  try {
-    const versions = await fs.readdir(pluginBase);
-    // Pick last (lexicographically — semver works for simple cases)
-    const sorted = versions.sort();
-    for (let i = sorted.length - 1; i >= 0; i--) {
-      const tmplDir = path.join(pluginBase, sorted[i], "templates");
-      if (existsSync(tmplDir)) return tmplDir;
-    }
-  } catch {
-    return null;
-  }
-  return null;
-}
-
-function gitConfig(key) {
-  if (!has("git")) return null;
-  const r = runSync("git", ["config", "--get", key]);
-  return r.code === 0 ? r.stdout.trim() : null;
-}
-
-/**
- * Embedded fallback templates — used when plugin cache not available.
- * Keep these minimal; rich templates live in templates/*.tmpl.
- *
- * Note: these embedded templates are English. Users who want Chinese
- * project state can edit the resulting files (or set lang preference
- * in CONTEXT.md and use the rich templates from the plugin cache).
- */
-function embeddedTemplate(name) {
-  const today = "{{CREATED_DATE}}";
-  const project = "{{PROJECT_NAME}}";
-  const user = "{{USER_NAME}}";
-
-  switch (name) {
-    case "PROJECT.md.tmpl":
-      return `# ${project}
-
-> CurDX-Flow project vision
-
-## One-line description
-TODO: in one sentence — what is the project, who is it for, what problem does it solve
-
-## Why this exists
-TODO:
-
-## Core users
-TODO:
-
-## Success criteria (verifiable metrics)
-1. TODO:
-2. TODO:
-
-## Tech stack
-TODO:
-
-## Out of scope (Scope Guard)
-- ✗ TODO:
-
----
-
-_Generated by curdx-flow init on ${today}. Maintainer: ${user}_
-`;
-
-    case "CONTEXT.md.tmpl":
-      return `# ${project} — User preferences
-
-## Code style
-- Indentation: TODO
-- Quotes: TODO
-- Naming: TODO
-
-## Communication preferences
-- Language: en
-- Verbosity: balanced
-
-## Tooling preferences
-- Package manager: TODO
-
----
-
-_Generated by curdx-flow init on ${today}_
-`;
-
-    case "STATE.md.tmpl":
-      return `# ${project} — Cross-session state
-
-## Key decisions (Decisions)
-None yet.
-
-## Blockers
-None yet.
-
----
-
-_Initialized on ${today}_
-`;
-
-    case "ROADMAP.md.tmpl":
-      return `# ${project} — Roadmap
-
-## Current version: v0.1 (MVP)
-
-**Goal**: TODO
-
-### Success criteria
-- [ ] TODO
-
----
-
-_Initialized on ${today}_
-`;
-
-    case "config.json.tmpl":
-      return `{
-  "version": "1.0",
-  "mode": "standard",
-  "execution": {
-    "strategy": "auto",
-    "max_parallel": 5
-  },
-  "gates": {
-    "always_on": ["karpathy-gate", "verification-gate"],
-    "standard_mode": ["tdd-gate", "coverage-audit-gate"]
-  },
-  "created": "${today}"
-}
-`;
-
-    default:
-      return `# ${name}\n\n(template not found)\n`;
-  }
-}