@thedecipherist/mdd 1.0.0

package/commands/mdd-plan.md

@@ -0,0 +1,347 @@
+## PLAN-INITIATIVE MODE — `/mdd plan-initiative`
+
+Triggered when arguments start with `plan-initiative`. Creates a new initiative doc.
+
+### Phase PI1 — Mode choice
+
+Ask the user:
+```
+How do you want to create this initiative?
+  (a) Guide me — I'll ask questions and build the file
+  (b) Template — generate a blank file I'll fill out manually
+```
+
+**If (b) Template:**
+1. Ask for a title (e.g. "Auth System") → slugify to `auth-system`
+2. Check for slug collision: if `initiatives/auth-system.md` already exists → hard stop:
+   *"An initiative with this name already exists (`initiatives/auth-system.md`)."*
+   - Check all wave docs for active feature docs (`wave_status` not `complete`/`archived`/`deprecated`)
+   - If active docs found → *"This initiative has active feature docs. Deprecate them first before re-initialising."* List them.
+   - If no active docs → ask "Overwrite? (yes/no)"
+3. Create `.mdd/initiatives/<slug>.md` with blank template (all sections as placeholders, `version: 1`, `hash: ` empty)
+4. Tell user: *"Fill it out in your editor, then run `/mdd plan-sync` to register the hash, then `/mdd plan-wave <wave-slug>` when ready."*
+5. Stop.
+
+**If (a) Guide me:** proceed to Phase PI2.
+
+### Phase PI2 — Questions
+
+Ask all questions in a single interaction:
+1. "What is the title of this initiative?"
+2. "Describe it — what does it deliver and why does it exist?"
+3. "Roughly how many waves do you think this needs? (2–6 is typical)"
+4. For each wave: "Wave N — name and one-sentence demo-state (what can the user DO when this wave is done?)"
+5. "What's still undecided that could affect architecture?" → these become open product questions (unchecked `- [ ]` items)
+
+### Phase PI3 — Write initiative doc
+
+**Slug format:** lowercase, hyphens, no special characters. "Auth System" → `auth-system`.
+
+**Collision check:** same as template mode above.
+
+Create `.mdd/initiatives/<slug>.md`:
+
+```markdown
+---
+id: <slug>
+title: <title>
+status: active
+version: 1
+hash:
+created: <YYYY-MM-DD>
+---
+
+# <title>
+
+## Overview
+<description>
+
+## Open Product Questions
+- [ ] <question 1>
+- [ ] <question 2>
+
+## Waves
+| Wave | File | Demo-state | Status |
+|------|------|------------|--------|
+| Wave 1 | waves/<slug>-wave-1.md | <demo-state> | planned |
+| Wave 2 | waves/<slug>-wave-2.md | <demo-state> | planned |
+```
+
+Compute and write `hash:` field after writing (hash of file content excluding the hash line).
+
+Rebuild `.mdd/.startup.md`.
+
+### Phase PI4 — Chain to plan-wave
+
+Show the created doc to the user. Ask:
+*"Want to plan Wave 1 now? (yes / no — I'll run /mdd plan-wave <slug>-wave-1 later)"*
+
+If yes → run Phase PW1 inline for `<slug>-wave-1`.
+
+---
+
+## PLAN-WAVE MODE — `/mdd plan-wave <wave-slug>`
+
+Triggered when arguments start with `plan-wave`. Takes a wave slug (e.g. `auth-system-wave-2`), resolves the parent initiative from it.
+
+### Phase PW1 — Load and validate
+
+1. Parse `<wave-slug>` from arguments — hard stop *"Wave slug required. Usage: /mdd plan-wave <wave-slug>"* if missing.
+2. Derive initiative slug: everything before `-wave-N` (e.g. `auth-system-wave-2` → `auth-system`).
+3. Read `initiatives/<initiative-slug>.md` fresh from disk — hard stop *"Initiative does not exist: `initiatives/<slug>.md`"* if not found.
+4. **Hash check:** compute hash of initiative file (excluding `hash:` line), compare to stored `hash:` field. If mismatch → hard stop: *"Initiative file has been manually edited since last sync. Run `/mdd plan-sync` first."*
+5. **Open questions gate:** check for any unchecked `- [ ]` items in Open Product Questions. If found → hard stop, quote each unchecked question back: *"These questions must be answered before planning a wave."*
+6. **Depends-on gate:** read existing wave docs for this initiative. If the new wave's `depends_on` wave exists and is not `complete` → hard stop.
+7. Surface context summary to user: initiative title, overview, wave count, which waves are done.
+
+### Phase PW2 — Mode choice
+
+Same as PI1: ask "(a) Guide me / (b) Template".
+
+**If (b) Template:** create `waves/<wave-slug>.md` with blank template, tell user to fill it out and run `/mdd plan-sync` then `/mdd plan-execute <wave-slug>`.
+
+**If (a) Guide me:** proceed to Phase PW3.
+
+### Phase PW3 — Questions
+
+Ask in a single interaction:
+1. "Here's the demo-state from the initiative: [X]. Does this need sharpening for this wave?"
+2. "List the features needed to reach that demo-state — name + one-line description each."
+3. "Do any features depend on other features within this wave?"
+4. "Any open research questions before building? Or none?"
+
+### Phase PW4 — Write wave doc
+
+Create `waves/<wave-slug>.md`:
+
+```markdown
+---
+id: <wave-slug>
+title: "Wave N: <title>"
+initiative: <initiative-slug>
+initiative_version: <current initiative version>
+status: planned
+depends_on: none
+demo_state: "<demo-state>"
+created: <YYYY-MM-DD>
+hash:
+---
+
+# Wave N: <title>
+
+## Demo-State
+<demo-state>
+*(This wave is not complete until this can be manually demonstrated.)*
+
+## Features
+| # | Feature | Doc | Status | Depends on |
+|---|---------|-----|--------|------------|
+| 1 | <feature-slug> | — | planned | — |
+| 2 | <feature-slug> | — | planned | <dep-slug or —> |
+
+## Open Research
+<research items or (none)>
+```
+
+Compute and write `hash:` field. Update the Waves table in `initiatives/<slug>.md` to add this wave row. Increment `version` and recompute `hash` on the initiative file.
+
+Rebuild `.mdd/.startup.md`.
+
+### Phase PW5 — Chain
+
+Ask: *"Want to plan Wave N+1 now? (yes / no)"*
+If yes → run Phase PW1 inline for the next wave slug.
+
+---
+
+## PLAN-EXECUTE MODE — `/mdd plan-execute <wave-slug>`
+
+Triggered when arguments start with `plan-execute`. Runs the full MDD build flow for each feature in the wave.
+
+### Phase PE1 — Load and validate
+
+1. Parse `<wave-slug>` — hard stop *"Wave does not exist"* if `waves/<wave-slug>.md` not found.
+2. Read the wave doc.
+3. Derive and read the parent initiative — hard stop if not found.
+4. **Hash check:** verify both initiative and wave file hashes. Hard stop on any mismatch: *"File has been manually edited since last sync. Run `/mdd plan-sync` first."*
+5. **Depends-on gate:** if wave's `depends_on` is not `none`, verify that wave is `complete`. Hard stop if not.
+6. **Feature ordering check (Gap 4):** build dependency graph of features within the wave. If any ordering violation found → hard stop, explain exact conflict, offer auto-reorder.
+
+### Phase PE2 — Interaction mode
+
+Ask:
+```
+How do you want to run this wave?
+  (a) Automated — minimal interruptions, pauses only on errors
+  (b) Interactive — full MDD gates on every feature
+```
+
+**Automated:** data flow shown but not gated, build plan shown but not gated, green gate runs silently. On 5-iteration failure or integration failure → pause and surface to user with options (continue / narrow scope / stop). Does NOT fail the whole wave.
+
+**Interactive:** full Phase 2 gate, Phase 5 plan confirmation, green gate iteration prompts on every feature.
+
+### Phase PE3 — Execute features
+
+For each feature in the wave's feature table, in dependency order, skipping `complete` features:
+
+1. Tell user: *"Starting Feature N: <feature-slug>"*
+2. Flip `wave_status: active` for this feature in the wave doc immediately.
+3. Update the wave doc's `Doc` column with the feature doc path (once created in MDD Phase 3).
+4. Run full MDD Build Mode (Phases 1–7) for the feature, at the chosen interaction level.
+   - Feature doc is auto-numbered from `.mdd/docs/` and gets `initiative`, `wave`, `wave_status` fields added.
+5. After Phase 7 verify: flip `wave_status: complete` in wave doc.
+6. Ask: *"Feature N done ✓. Start Feature N+1? (yes / pause here)"*
+
+**Resume behaviour (Gap 2):** if re-run on a partially complete wave, read each feature's `wave_status`. Skip `complete`. Resume at first `active` or `planned`. If `active` but no doc exists → restart from Phase 1.
+
+### Phase PE4 — Wave completion
+
+When all features are `complete`:
+1. Show the demo-state: *"Wave complete. Demo-state: '<demo-state>'. Have you verified this?"*
+2. User confirms → flip wave `status: complete` in both `waves/<slug>.md` AND the waves table in `initiatives/<slug>.md`.
+3. Recompute hashes for both files.
+4. If all waves in initiative are `complete` → ask: *"All waves done. Mark initiative complete? (yes / no)"*
+5. Rebuild `.mdd/.startup.md`.
+
+---
+
+## PLAN-SYNC MODE — `/mdd plan-sync`
+
+Triggered when arguments start with `plan-sync`. Detects manual edits to initiative/wave files via hash comparison and reconciles them.
+
+### Phase PS1 — Scan all files
+
+Read every file in `.mdd/initiatives/` and `.mdd/waves/` (including `archive/`). For each, compute the hash of the file content (excluding the `hash:` line). Compare against stored `hash:` field.
+
+Build a change table:
+```
+Initiative / Wave                | Stored hash | Computed hash | Changed?
+auth-system.md                   | a3f5b2c1    | a3f5b2c1      | No
+auth-system-wave-1.md            | def456      | abc999        | YES
+billing-module.md                | (empty)     | xyz111        | YES (new — no hash yet)
+```
+
+### Phase PS2 — Present changes + confirm
+
+Show the full change table. Tell the user what will happen:
+
+- **Initiative changed:** version incremented, hash updated, completed waves with old `initiative_version` flagged for review
+- **Wave changed:** hash updated, completed features in that wave flagged for review
+- **No hash yet (new file):** hash computed and written — no version bump needed
+
+Ask: *"Apply these updates? (yes / review each / cancel)"*
+
+### Phase PS3 — Apply
+
+For each changed file, in initiative-first order:
+
+**Initiative changed:**
+1. Increment `version` field
+2. Rewrite `hash:` field
+3. Find all wave docs for this initiative where `status: complete` AND `initiative_version` < new version
+4. Prompt: *"Initiative updated (v1 → v2) since these waves were completed: [list]. Mark them back to in_progress for review? (yes / no / skip)"*
+   - `yes` → flip those waves back to `in_progress`
+   - `no` / `skip` → leave them complete
+
+**Wave changed:**
+1. Rewrite `hash:` field
+2. Find all features in this wave with `wave_status: complete`
+3. Prompt: *"Wave file edited since these features were completed: [list]. Flag for review? (yes / no)"*
+   - `yes` → add a `known_issues` entry to each feature doc: *"Wave file was manually edited after this feature completed — review for consistency."*
+
+**New file (no hash):**
+1. Write computed hash to `hash:` field — no other changes
+
+Rebuild `.mdd/.startup.md`.
+
+Report:
+```
+✅ plan-sync complete
+
+  auth-system.md            — no change
+  auth-system-wave-1.md     — hash updated, 2 features flagged
+  billing-module.md         — hash written (new file)
+```
+
+---
+
+## PLAN-REMOVE-FEATURE MODE — `/mdd plan-remove-feature <wave-slug> <feature-slug>`
+
+Triggered when arguments start with `plan-remove-feature`.
+
+### Phase PRF1 — Load and validate
+
+1. Parse `<wave-slug>` and `<feature-slug>` from arguments.
+2. Read wave doc — hard stop *"Wave does not exist"* if not found.
+3. Find the feature row — hard stop *"Feature `<slug>` does not exist in wave `<wave-slug>`"* if not found.
+4. **Dependency guard:** check if any other feature in the wave lists `<feature-slug>` in its `Depends on` column. If so → hard stop: *"`<other-feature>` depends on `<feature-slug>`. Remove or reassign that dependency first."*
+
+### Phase PRF2 — Confirm and remove
+
+Show summary:
+```
+Remove feature from wave?
+
+  Feature:  auth-login
+  Wave:     auth-system-wave-1
+  Doc:      docs/02-auth-login.md (draft)
+  Status:   planned
+
+Remove from wave? (yes/no)
+```
+
+If yes and a feature doc exists: *"Archive feature doc? (yes/no)"*
+
+If confirmed:
+1. Remove the feature row from the wave doc table.
+2. Renumber the `#` column sequentially (cosmetic — `Depends on` uses slugs, not numbers, so renumbering is safe).
+3. If archiving doc: move to `.mdd/docs/archive/`, set `status: archived`, `wave_status: archived`.
+4. Recompute and update `hash:` on wave doc.
+5. Tell user: *"Re-run `/mdd plan-execute <wave-slug>` to continue the wave."*
+
+Rebuild `.mdd/.startup.md`.
+
+---
+
+## PLAN-CANCEL-INITIATIVE MODE — `/mdd plan-cancel-initiative <slug>`
+
+Triggered when arguments start with `plan-cancel-initiative`.
+
+### Phase PCI1 — Load
+
+1. Parse `<slug>` — hard stop *"Initiative does not exist"* if `initiatives/<slug>.md` not found.
+2. Read initiative doc. Count: waves, wave statuses, associated feature docs (those with `initiative: <slug>` frontmatter).
+
+### Phase PCI2 — Confirm
+
+Show summary:
+```
+Cancel initiative: Auth System
+
+  Status:        active
+  Waves:         3 (1 complete, 2 active)
+  Feature docs:  5 created
+
+Cancel this initiative? (yes/no)
+```
+
+If yes:
+
+### Phase PCI3 — Cancel
+
+1. Set `status: cancelled` in initiative frontmatter. Recompute hash.
+2. Ask: *"Archive wave docs? (yes/no)"* — if yes, move all wave files to `.mdd/waves/archive/`
+3. Ask: *"Flag feature docs with a warning? (yes/no)"* — if yes, add to each associated feature doc's `known_issues`: `"Initiative <slug> was cancelled — review whether this feature is still needed."`
+
+Rebuild `.mdd/.startup.md`.
+
+Report:
+```
+✅ Initiative cancelled: auth-system
+
+  Status set: cancelled
+  Wave docs: archived (3 files)
+  Feature docs: 5 flagged with known_issues warning
+```
+
+---

package/commands/mdd.md

@@ -0,0 +1,152 @@
+---
+description: "MDD workflow — Document → Audit → Fix → Verify. Build features or audit existing code using Manual-Driven Development."
+scope: project
+argument-hint: "<feature-description> or audit [section]"
+allowed-tools: Read, Write, Edit, Grep, Glob, Bash, AskUserQuestion, Agent
+mdd_version: 8
+---
+
+# MDD — Manual-Driven Development Workflow
+
+**$ARGUMENTS**
+
+MDD is the core development workflow. Each feature is driven by its document — written before a line of code, referenced throughout development, and kept in sync as the feature evolves. The document is the single source of truth for what is being built and why. Every fix starts with an audit. No exceptions.
+
+## Step 0 — Worktree Check (before everything else)
+
+Before any other work, offer worktree isolation for parallel `/mdd` sessions:
+
+1. Check current branch: `git branch --show-current`
+2. Ask the user via AskUserQuestion:
+   - **Question:** "Do you want to work in an isolated worktree? This lets you run multiple `/mdd` sessions in parallel."
+   - **Options:**
+     - **"No, continue here" (Recommended)** — proceed in current directory with auto-branch as usual
+     - **"Yes, create a worktree"** — create an isolated worktree, then the user re-runs `/mdd` there
+3. If the user selects **"Yes, create a worktree"**:
+   - Derive a slug from `$ARGUMENTS` (e.g., `add-auth` from "add auth system"). If no arguments, ask for a name.
+   - Run: `/worktree mdd-<feature-slug>` (this creates a sibling directory with its own branch)
+   - Tell the user: "Worktree created. Open a new Claude Code session in the worktree directory and run `/mdd $ARGUMENTS` there."
+   - **STOP here** — do not continue in the current session (the working directory hasn't changed)
+4. If the user selects **"No, continue here"** — proceed to Step 0a below.
+
+## Step 0a — Bootstrap Check (silent, automatic)
+
+Before detecting mode or doing anything else, ensure the `.mdd/` directory structure exists. This runs silently — no user prompt, no confirmation. If everything already exists, nothing happens.
+
+```bash
+# Check and create missing pieces
+[ -d .mdd ]           || mkdir -p .mdd
+[ -d .mdd/docs ]      || mkdir -p .mdd/docs
+[ -d .mdd/audits ]    || mkdir -p .mdd/audits
+[ -d .mdd/ops ]       || mkdir -p .mdd/ops
+[ -d .mdd/jobs ]      || mkdir -p .mdd/jobs
+```
+
+**If `.mdd/.startup.md` does not exist**, create it with the default template:
+
+```markdown
+## Project Snapshot
+Generated: (run /mdd status to populate) | Branch: (unknown)
+
+## Stack
+Framework: (unknown) | DB: (unknown) | Host: (unknown)
+
+## Features Documented
+(none yet — run /mdd <feature> to create your first doc)
+
+## Last Audit
+(no audit run yet — run /mdd audit to generate findings)
+
+## Rules Summary
+Read CLAUDE.md for the full rulebook. Key rules:
+- TypeScript always, strict mode, no any
+- StrictDB only — no raw database drivers
+- /api/v1/ prefix on all endpoints
+- No file > 300 lines, no function > 50 lines
+- Never commit .env or secrets
+- Always branch — never commit to main
+
+---
+
+## Notes
+(add notes with: /mdd note "your note here")
+```
+
+**If `.gitignore` exists**, check whether `.mdd/audits/` and `.mdd/jobs/` are already ignored. For any that are missing, append:
+```
+# MDD audit reports (ephemeral — regenerated by /mdd audit)
+.mdd/audits/
+# MDD active jobs (ephemeral — deleted on completion)
+.mdd/jobs/
+```
+
+**Report only if something was created** (skip entirely if everything already existed):
+```
+📁 MDD structure initialised:
+   .mdd/docs/       ✓ created
+   .mdd/audits/     ✓ created
+   .mdd/ops/        ✓ created
+   .mdd/jobs/       ✓ created
+   .mdd/.startup.md ✓ created
+   .gitignore       ✓ updated (.mdd/audits/ and .mdd/jobs/ added)
+```
+
+This bootstrap runs for **all modes** — build, audit, scan, update, and every other mode — so no mode ever fails due to a missing `.mdd/` structure.
+
+## Step 0b — Detect Mode
+
+The user's full arguments are: **$ARGUMENTS**
+
+Parse these arguments to determine the mode. **Before doing anything else, read the appropriate mode file listed below.** The mode file contains the complete instructions for that mode. When mode file instructions reference `$ARGUMENTS`, treat it as the arguments stated above.
+
+Find the MDD commands directory by checking `~/.claude/commands/` (global install via `npm install -g mdd`).
+
+- If arguments start with `audit` →
+  **Read `~/.claude/commands/mdd-audit.md` then follow its AUDIT MODE instructions.**
+
+- If arguments start with `status`, `note`, `scan`, `update`, or `deprecate` →
+  **Read `~/.claude/commands/mdd-manage.md` then follow the relevant mode instructions.**
+
+- If arguments start with `reverse-engineer`, `reverse`, `graph`, or `upgrade` →
+  **Read `~/.claude/commands/mdd-lifecycle.md` then follow the relevant mode instructions.**
+
+- If arguments start with `plan-` →
+  **Read `~/.claude/commands/mdd-plan.md` then follow the relevant PLAN mode instructions.**
+
+- If arguments start with `ops`, `runop`, `update-op`, or `commands` →
+  **Read `~/.claude/commands/mdd-ops.md` then follow the relevant OPS/COMMANDS mode instructions.**
+
+- If arguments are empty → ask the user what they want to do (build a feature, run an audit, check status, etc.)
+
+- Otherwise → **Read `~/.claude/commands/mdd-build.md` then follow BUILD MODE instructions.**
+
+---
+
+## Auto-Branch (All Modes)
+
+**If the user already chose a worktree in Step 0, skip auto-branch entirely** — the worktree was created with its own dedicated branch.
+
+Otherwise, before creating or modifying any files, check the current branch:
+
+```bash
+git branch --show-current
+```
+
+**Default behavior** (`auto_branch = true` in `claude-mastery-project.conf`):
+- If on `main` or `master`:
+  - Build mode: `git checkout -b feat/<feature-name>`
+  - Audit mode: `git checkout -b fix/mdd-audit-<date>`
+- If already on a feature branch: proceed
+
+---
+
+## CLAUDE.md Update Trigger
+
+After ANY MDD operation that changes code, check if new patterns were established that should be added to CLAUDE.md. If so, suggest the addition:
+
+```
+💡 New pattern detected: <description>
+Add to CLAUDE.md? (yes / no)
+```
+
+This is the MDD feedback loop — every project interaction improves future interactions.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { install } from './install.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { join, dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('mdd')
+    .description('MDD — Manual-Driven Development workflow for Claude Code')
+    .version(pkg.version);
+program
+    .command('install')
+    .description('Install MDD Claude commands to ~/.claude/commands/')
+    .option('--dir <path>', 'Custom install directory (default: ~/.claude/commands)', '~/.claude/commands')
+    .option('--force', 'Overwrite existing files even if already up to date', false)
+    .action(install);
+program
+    .command('update')
+    .description('Update MDD commands to latest version (alias for install --force)')
+    .option('--dir <path>', 'Custom install directory', '~/.claude/commands')
+    .action((options) => install({ ...options, force: true }));
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAwB,CAAC;AAEzG,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,0DAA0D,CAAC;KACvE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,oDAAoD,CAAC;KACjE,MAAM,CAAC,cAAc,EAAE,wDAAwD,EAAE,oBAAoB,CAAC;KACtG,MAAM,CAAC,SAAS,EAAE,qDAAqD,EAAE,KAAK,CAAC;KAC/E,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,mEAAmE,CAAC;KAChF,MAAM,CAAC,cAAc,EAAE,0BAA0B,EAAE,oBAAoB,CAAC;KACxE,MAAM,CAAC,CAAC,OAAwB,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAE9E,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,7 @@
+interface InstallOptions {
+    dir: string;
+    force?: boolean;
+}
+export declare function install(options: InstallOptions): void;
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AASA,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAUD,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAwErD"}

package/dist/install.js

@@ -0,0 +1,91 @@
+import { copyFileSync, mkdirSync, existsSync, readdirSync, readFileSync } from 'fs';
+import { join, resolve } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export function install(options) {
+    const destDir = resolve(options.dir.replace('~', homedir()));
+    const srcDir = join(__dirname, '../commands');
+    const version = getPackageVersion();
+    mkdirSync(destDir, { recursive: true });
+    const files = readdirSync(srcDir)
+        .filter(f => f.endsWith('.md'))
+        .sort((a, b) => {
+        // mdd.md first, then alphabetical
+        if (a === 'mdd.md')
+            return -1;
+        if (b === 'mdd.md')
+            return 1;
+        return a.localeCompare(b);
+    });
+    const results = [];
+    for (const file of files) {
+        const src = join(srcDir, file);
+        const dest = join(destDir, file);
+        try {
+            if (existsSync(dest) && !options.force) {
+                if (file === 'mdd.md') {
+                    const srcVer = getMddVersion(readFileSync(src, 'utf-8'));
+                    const destVer = getMddVersion(readFileSync(dest, 'utf-8'));
+                    if (srcVer <= destVer) {
+                        results.push({ file, status: 'skipped', reason: `v${destVer} already up to date` });
+                        continue;
+                    }
+                    copyFileSync(src, dest);
+                    results.push({ file, status: 'updated', fromVersion: destVer, toVersion: srcVer });
+                }
+                else {
+                    // For mode files: compare modification — just overwrite silently
+                    copyFileSync(src, dest);
+                    results.push({ file, status: 'updated' });
+                }
+            }
+            else {
+                copyFileSync(src, dest);
+                results.push({ file, status: existsSync(dest) ? 'updated' : 'installed' });
+            }
+        }
+        catch (err) {
+            results.push({ file, status: 'error', reason: String(err) });
+        }
+    }
+    console.log(`\nMDD v${version} — Claude Code workflow installer`);
+    console.log(`Install directory: ${destDir}\n`);
+    for (const r of results) {
+        const icon = r.status === 'error' ? '✗' : r.status === 'skipped' ? '·' : '✓';
+        const detail = r.status === 'updated' && r.fromVersion !== undefined
+            ? ` (v${r.fromVersion} → v${r.toVersion})`
+            : r.reason ? ` — ${r.reason}` : '';
+        console.log(`  ${icon} ${r.file}${detail}`);
+    }
+    const installed = results.filter(r => r.status === 'installed' || r.status === 'updated').length;
+    const skipped = results.filter(r => r.status === 'skipped').length;
+    const errors = results.filter(r => r.status === 'error').length;
+    console.log('');
+    if (errors > 0) {
+        console.log(`  ${errors} error(s) — check the output above`);
+    }
+    else if (installed === 0) {
+        console.log('  Already up to date.');
+    }
+    else {
+        console.log(`  ${installed} file(s) installed/updated${skipped > 0 ? `, ${skipped} skipped` : ''}`);
+    }
+    console.log('\nOpen Claude Code and run /mdd to get started.\n');
+}
+function getMddVersion(content) {
+    const match = content.match(/^mdd_version:\s*(\d+)/m);
+    return match ? parseInt(match[1], 10) : 0;
+}
+function getPackageVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}