@drafthq/draft 2.7.0 → 2.8.1

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "draft",
       "source": "./",
       "description": "Context-Driven Development: draft specs and plans before implementation. Structured workflows for features and fixes.",
-      "version": "2.7.0",
+      "version": "2.8.0",
       "author": {
         "name": "mayurpise"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "draft",
   "description": "Context-Driven Development: draft specs and plans before implementation. Structured workflows for features and fixes.",
-  "version": "2.7.0",
+  "version": "2.8.1",
   "author": {
     "name": "mayurpise"
   },

package/README.md

@@ -62,16 +62,18 @@ draft install <host>
 draft list                             # show every host + where it installs
 ```
 
-| Host | `draft install …` | Lands in |
-|------|-------------------|----------|
-| **Claude Code** | `claude-code` | `./.claude-plugin/` + `skills/` `core/` (project) |
-| **Cursor** | `cursor` | `~/.cursor/plugins/local/draft/` (global) |
-| **Codex** | `codex` | `./AGENTS.md` (project) |
-| **opencode** | `opencode` | `./AGENTS.md` + `~/.agents/skills/draft/` |
+Each host installs the way that host actually loads extensions — no manual steps after the command:
 
-Flags: `--global` / `--project` to pick scope, `--dry-run` to preview writes, `--force` to overwrite, `--no-graph` to skip the graph-engine fetch.
+| Host | `draft install …` | What it does |
+|------|-------------------|--------------|
+| **Claude Code** | `claude-code` | Registers the plugin via `claude plugin marketplace add` + `claude plugin install` (user scope). Restart Claude Code. |
+| **Cursor** | `cursor` | Copies the plugin into `~/.cursor/plugins/local/draft/` (auto-loaded). Restart Cursor. |
+| **Codex** | `codex` | Writes `./AGENTS.md`, which Codex reads automatically. |
+| **opencode** | `opencode` | Writes `./AGENTS.md` + `~/.agents/skills/draft/`, both auto-discovered. |
 
-Then, in Claude Code:
+Flags: `--global` / `--project` to pick scope, `--dry-run` to preview, `--force` to overwrite, `--no-graph` to skip the graph-engine fetch.
+
+Then, in Claude Code (after restarting):
 
 ```bash
 /draft:init       # 5-phase codebase analysis (one-time)
@@ -157,7 +159,7 @@ curl -o .gemini.md https://raw.githubusercontent.com/drafthq/draft/main/integrat
 
 ## Built-in Code Intelligence
 
-Draft is powered by a **local knowledge graph engine** ([codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp)) that gives every command precise structural context — module boundaries, call graphs, dependencies, hotspots. It's 100% local (no API key, no SaaS), installed on first use.
+Draft is powered by a **local knowledge graph engine** ([codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp)) that gives every command precise structural context — module boundaries, call graphs, dependencies, hotspots. It's 100% local (no API key, no SaaS), fetched during `draft install` (best-effort; `--no-graph` to skip), with first-use fetch as a fallback.
 
 ```bash
 /draft:graph                                  # build / refresh the snapshot

package/cli/src/hosts/claude-code.js

@@ -1,45 +1,67 @@
 'use strict';
 
-const path = require('path');
-const { asset } = require('../lib/paths');
-
-// Draft's native plugin shape: the .claude-plugin manifest + skills/core/bin and
-// the deterministic shell helpers the skills invoke. Copied into the project root
-// so Claude Code (and Cursor, which shares the format) discovers it locally.
-const ITEMS = [
-  { p: '.claude-plugin', kind: 'copyTree' },
-  { p: 'skills', kind: 'copyTree' },
-  { p: 'core', kind: 'copyTree' },
-  { p: 'bin', kind: 'copyTree' },
-  { p: 'scripts/tools', kind: 'copyTree' },
-  { p: 'scripts/fetch-memory-engine.sh', kind: 'copyFile' },
-  { p: 'scripts/lib.sh', kind: 'copyFile' },
-];
+// Claude Code loads plugins from its own registry (via a marketplace), NOT from
+// an arbitrary project directory — so copying files into the cwd never registers
+// the /draft:* commands. The correct install is the `claude plugin` CLI.
+//
+// We run four idempotent steps so a re-run UPGRADES an existing install rather
+// than no-op'ing on "already installed":
+//   1. marketplace add  <repo>   — register the marketplace (no-op if present)
+//   2. marketplace update <name> — re-fetch manifest from GitHub (the upgrade key)
+//   3. plugin install   <ref>    — install (no-op if already installed)
+//   4. plugin update    <ref>    — bump an existing install to the new version
+// Steps 2 and 4 exit 0 when there's nothing to do, so they're safe on a fresh
+// install too. Default scope is `user` (global). If the `claude` CLI isn't on
+// PATH, we print the equivalent in-session slash commands.
+const MARKETPLACE_REPO = 'drafthq/draft';
+const MARKETPLACE_NAME = 'draft-plugins'; // the `name` field in .claude-plugin/marketplace.json
+const PLUGIN_REF = `draft@${MARKETPLACE_NAME}`; // name@<marketplace name>
 
 module.exports = {
   id: 'claude-code',
   label: 'Claude Code',
   aliases: ['claude', 'claudecode'],
-  defaultScope: 'project',
+  defaultScope: 'global',
 
   plan(ctx) {
-    const root = ctx.cwd;
-    const actions = ITEMS.map((it) => ({
-      kind: it.kind,
-      src: asset(it.p),
-      dest: path.join(root, it.p),
-      label: it.p,
-      // Guard on the manifest dir: its presence marks a prior Draft install.
-      guard: it.p === '.claude-plugin',
-    }));
-
+    const scope = ctx.scope === 'project' ? 'project' : 'user'; // --global -> user
     return {
-      targetSummary: `${root} (project)`,
-      actions,
-      graph: true,
-      done: 'Draft plugin copied into the project. Run /draft in Claude Code to see the commands.',
-      notes: [
-        'Alternative (no npm): /plugin marketplace add drafthq/draft  then  /plugin install draft',
+      targetSummary: `Claude Code plugin registry (scope: ${scope})`,
+      requires: 'claude',
+      actions: [
+        {
+          kind: 'exec',
+          cmd: 'claude',
+          args: ['plugin', 'marketplace', 'add', MARKETPLACE_REPO],
+          label: `claude plugin marketplace add ${MARKETPLACE_REPO}`,
+        },
+        {
+          kind: 'exec',
+          cmd: 'claude',
+          args: ['plugin', 'marketplace', 'update', MARKETPLACE_NAME],
+          label: `claude plugin marketplace update ${MARKETPLACE_NAME}`,
+        },
+        {
+          kind: 'exec',
+          cmd: 'claude',
+          args: ['plugin', 'install', PLUGIN_REF, '--scope', scope],
+          label: `claude plugin install ${PLUGIN_REF} --scope ${scope}`,
+        },
+        {
+          kind: 'exec',
+          cmd: 'claude',
+          args: ['plugin', 'update', PLUGIN_REF, '--scope', scope],
+          label: `claude plugin update ${PLUGIN_REF} --scope ${scope}`,
+        },
+      ],
+      graph: true, // fetch the graph engine at install time (/draft:init also fetches on first use as a fallback)
+      done: 'Installed/updated draft. Restart Claude Code (or start a new session), then run /draft:init.',
+      fallbackTitle: 'Claude Code CLI not found. Run these in Claude Code instead:',
+      fallback: [
+        '/plugin marketplace add drafthq/draft',
+        '/plugin marketplace update draft-plugins',
+        '/plugin install draft',
+        '/plugin update draft',
       ],
     };
   },

package/cli/src/hosts/codex.js

@@ -25,7 +25,7 @@ module.exports = {
           guard: true,
         },
       ],
-      graph: false,
+      graph: true,
       done: 'Wrote AGENTS.md — Codex reads it automatically from the repo root.',
       notes: ['Commit AGENTS.md so your whole team shares the Draft methodology.'],
     };

package/cli/src/hosts/opencode.js

@@ -32,7 +32,7 @@ module.exports = {
           label: '~/.agents/skills/draft/',
         },
       ],
-      graph: false,
+      graph: true,
       done: 'opencode reads AGENTS.md from the repo root; Draft skills bundled under ~/.agents/skills/draft/.',
     };
   },

package/cli/src/installer.js

@@ -1,10 +1,29 @@
 'use strict';
 
+const { spawnSync } = require('child_process');
 const fsx = require('./lib/fsx');
 const log = require('./lib/log');
 const { fetchGraph } = require('./lib/graph');
 
+function hasBinary(name) {
+  // ENOENT on the error means the binary is not on PATH.
+  const r = spawnSync(name, ['--version'], { stdio: 'ignore' });
+  return !(r.error && r.error.code === 'ENOENT');
+}
+
 function execAction(act, ctx) {
+  const printable = `${act.cmd} ${act.args.join(' ')}`;
+  log.plan(`${ctx.dryRun ? 'would run' : 'running'}: ${printable}`);
+  if (ctx.dryRun) return 0;
+  const r = spawnSync(act.cmd, act.args, { stdio: 'inherit' });
+  if (r.error) {
+    log.error(`failed to run ${act.cmd}: ${r.error.message}`);
+    return 1;
+  }
+  return r.status == null ? 1 : r.status;
+}
+
+function fsAction(act, ctx) {
   log.plan(`${ctx.dryRun ? 'would write' : 'writing'}: ${act.dest}`);
   if (ctx.dryRun) return;
   switch (act.kind) {
@@ -22,13 +41,28 @@ function execAction(act, ctx) {
   }
 }
 
+function printFallback(plan) {
+  if (plan.fallbackTitle) log.warn(plan.fallbackTitle);
+  (plan.fallback || []).forEach((line) => log.info('    ' + line));
+}
+
 function install(host, ctx) {
   const plan = host.plan(ctx);
   log.step(`Installing Draft -> ${host.label}  [${plan.targetSummary}]${ctx.dryRun ? '  (dry run)' : ''}`);
 
-  // Pre-flight: every bundled source must exist, and guarded targets must not
-  // already exist unless --force. Checked up front so a failure writes nothing.
+  // A plan may require an external CLI (e.g. claude). If it's missing, print
+  // the manual fallback and stop — but only when actually installing; a
+  // dry run still shows the planned commands.
+  if (plan.requires && !ctx.dryRun && !hasBinary(plan.requires)) {
+    printFallback(plan);
+    return 0;
+  }
+
+  // Pre-flight: for file copies, every bundled source must exist and guarded
+  // targets must not already exist unless --force. Checked up front so a
+  // failure writes nothing.
   for (const act of plan.actions) {
+    if (act.kind === 'exec') continue;
     if (!fsx.exists(act.src)) {
       log.error(`Bundled asset missing: ${act.src}`);
       log.error('Reinstall @drafthq/draft — the package looks incomplete.');
@@ -41,7 +75,16 @@ function install(host, ctx) {
   }
 
   for (const act of plan.actions) {
-    execAction(act, ctx);
+    if (act.kind === 'exec') {
+      const code = execAction(act, ctx);
+      if (code !== 0) {
+        log.error(`Step failed (exit ${code}): ${act.label || act.cmd}`);
+        if (plan.fallback) printFallback(plan);
+        return code;
+      }
+    } else {
+      fsAction(act, ctx);
+    }
   }
 
   if (plan.graph && ctx.graph && !ctx.dryRun) {
@@ -58,4 +101,4 @@ function install(host, ctx) {
   return 0;
 }
 
-module.exports = { install };
+module.exports = { install, hasBinary };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drafthq/draft",
-  "version": "2.7.0",
+  "version": "2.8.1",
   "description": "Context-Driven Development for AI coding agents — install Draft into Claude Code, Cursor, Codex, or opencode.",
   "bin": {
     "draft": "cli/bin/draft.js"

package/scripts/fetch-memory-engine.sh

@@ -8,7 +8,7 @@
 # which scripts/tools/_lib.sh:find_memory_bin resolves.
 #
 # Pinned by default for reproducibility; override with CMM_VERSION (a tag, e.g.
-# "v0.7.0", or "latest").
+# "v0.8.1", or "latest").
 #
 # Usage:
 #   scripts/fetch-memory-engine.sh [--dest DIR] [--force]
@@ -21,7 +21,7 @@
 set -euo pipefail
 
 REPO="DeusData/codebase-memory-mcp"
-DEFAULT_VERSION="v0.7.0"   # pinned; bump deliberately
+DEFAULT_VERSION="v0.8.1"   # pinned; bump deliberately. NOTE: tag must carry the leading "v" AND have published assets (0.7.0 had none → 404).
 VERSION="${CMM_VERSION:-$DEFAULT_VERSION}"
 DEST="$HOME/.cache/draft/bin"
 FORCE=0