@drafthq/draft 2.7.1 → 2.8.3

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.1",
+      "version": "2.8.3",
       "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.1",
+  "version": "2.8.3",
   "author": {
     "name": "mayurpise"
   },

package/README.md

@@ -113,9 +113,9 @@ curl -o .gemini.md https://raw.githubusercontent.com/drafthq/draft/main/integrat
 
 ---
 
-## Beyond `/draft:review` — 27 more commands
+## Beyond `/draft:review` — 33 more commands
 
-`/draft:review` is the wedge. Once Draft has indexed your repo, you also get spec-driven planning, TDD-enforced implementation, exhaustive bug hunting, deep architectural audits, and 23 more commands covering the full development lifecycle.
+`/draft:review` is the wedge. Once Draft has indexed your repo, you also get spec-driven planning, TDD-enforced implementation, exhaustive bug hunting, deep architectural audits, and 29 more commands covering the full development lifecycle.
 
 ---
 
@@ -124,6 +124,10 @@ curl -o .gemini.md https://raw.githubusercontent.com/drafthq/draft/main/integrat
 | Command | What It Does |
 |---------|--------------|
 | **`/draft`** | Overview, intent mapping, and command reference |
+| **`/draft:plan`** | Router for planning, architecture, and track management |
+| **`/draft:ops`** | Router for operations, deployment, incident, and lifecycle |
+| **`/draft:docs`** | Router for authoring and documentation workflows |
+| **`/draft:discover`** | Router for discovery, debugging, investigation, and quality |
 | **`/draft:init`** | Analyze codebase, create context files + state tracking |
 | **`/draft:index`** | Aggregate monorepo service contexts |
 | **`/draft:new-track`** | Collaborative spec + plan with AI |
@@ -141,11 +145,13 @@ curl -o .gemini.md https://raw.githubusercontent.com/drafthq/draft/main/integrat
 | **`/draft:debug`** | Structured debugging: reproduce, isolate, diagnose, fix |
 | **`/draft:quick-review`** | Lightweight 4-dimension code review |
 | **`/draft:deploy-checklist`** | Pre-deployment verification with rollback triggers |
+| **`/draft:upload`** | Pre-upload handoff gate (review, HLD, checklist, validators) |
 | **`/draft:testing-strategy`** | Test plan design with coverage targets |
 | **`/draft:tech-debt`** | Technical debt analysis across 6 dimensions |
 | **`/draft:standup`** | Git activity standup summary (read-only) |
 | **`/draft:incident-response`** | Incident lifecycle: triage, communicate, mitigate, postmortem |
 | **`/draft:documentation`** | Technical docs: readme, runbook, api, onboarding |
+| **`/draft:integrations`** | External system exports and syncs (jira preview / create) |
 | **`/draft:jira`** | Unified Jira workflows (preview / create / review) |
 | **`/draft:tour`** | Interactive architecture mentorship and codebase walk-through |
 | **`/draft:impact`** | ROI analytics tracking friction and timeline metrics |
@@ -159,7 +165,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

@@ -2,13 +2,20 @@
 
 // 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:
-//   claude plugin marketplace add drafthq/draft
-//   claude plugin install draft@draft-plugins --scope <user|project>
-// Default scope is `user` (global, available in every project). If the `claude`
-// CLI isn't on PATH, we print the equivalent in-session slash commands.
+// 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 PLUGIN_REF = 'draft@draft-plugins'; // name@<marketplace name from marketplace.json>
+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',
@@ -28,19 +35,33 @@ module.exports = {
           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: false, // /draft:init fetches the graph engine on first use
-      done: 'Installed draft. Restart Claude Code (or start a new session), then run /draft:init.',
+      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

@@ -11,13 +11,22 @@ function hasBinary(name) {
   return !(r.error && r.error.code === 'ENOENT');
 }
 
+// Per-step ceiling so a stalled network op (e.g. the `git clone` behind
+// `claude plugin marketplace add`) fails loudly with the manual fallback
+// instead of hanging the installer forever. Override with DRAFT_INSTALL_TIMEOUT_MS.
+const STEP_TIMEOUT_MS = Number(process.env.DRAFT_INSTALL_TIMEOUT_MS) || 300000;
+
 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' });
+  const r = spawnSync(act.cmd, act.args, { stdio: 'inherit', timeout: STEP_TIMEOUT_MS });
   if (r.error) {
-    log.error(`failed to run ${act.cmd}: ${r.error.message}`);
+    if (r.error.code === 'ETIMEDOUT') {
+      log.error(`timed out after ${Math.round(STEP_TIMEOUT_MS / 1000)}s: ${printable}`);
+    } else {
+      log.error(`failed to run ${act.cmd}: ${r.error.message}`);
+    }
     return 1;
   }
   return r.status == null ? 1 : r.status;

package/integrations/copilot/.github/copilot-instructions.md.7iDz8X

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.DoBdtd

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.McGoBW

@@ -0,0 +1,122 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/.ai-profile.md` - Ultra-compact profile (always loaded, 20-50 lines)
+- `draft/architecture.md` - Human-readable engineering guide (source of truth)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+- `draft/guardrails.md` - Hard rules and learned patterns
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft deploy-checklist [track <id>]` | Pre-deployment verification checklist |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft quick-review [file|pr <number>]` | Lightweight 4-dimension review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft testing-strategy [track <id>|path]` | Design test strategy with coverage targets |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft debug [description|track <id>]` | Structured debugging session |
+| `draft standup [date|week|save]` | Generate standup summary |
+| `draft tech-debt [path|track <id>]` | Identify and prioritize tech debt |
+| `draft incident-response [new|update|postmortem]` | Incident management lifecycle |
+| `draft documentation [readme|runbook|api|onboarding]` | Technical documentation |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+| `draft tour` | Interactive onboarding tour |
+| `draft impact` | Telemetry and analytics insights |
+| `draft assist-review` | Assist human reviewers with architectural risk audit |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "deploy checklist", "pre-deploy check" | Run deploy-checklist |
+| "hunt bugs", "find bugs" | Run bughunt |
+| "review code", "review track", "check quality" | Run review |
+| "quick review", "lightweight review" | Run quick-review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "test strategy", "plan tests" | Run testing-strategy |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "document decision", "create ADR" | Create architecture decision record |
+| "debug bug", "investigate issue" | Run debug |
+| "standup", "daily summary" | Run standup |
+| "tech debt", "identify debt" | Run tech-debt |
+| "incident", "outage", "postmortem" | Run incident-response |
+| "write docs", "document" | Run documentation |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "tour", "onboard me" | Run tour |
+| "impact", "analytics" | Run impact |
+| "assist review", "help reviewer" | Run assist-review |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+
+
+---
+
+## Init Command
+
+When user says "init draft" or "draft init [refresh]":
+

package/integrations/copilot/.github/copilot-instructions.md.VsPyLB

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.XAVr7D

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.YoFVFa

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.a9DeW0

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.oxQs3B

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.ww33Ly

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drafthq/draft",
-  "version": "2.7.1",
+  "version": "2.8.3",
   "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