mustard-claude 3.0.1 → 3.0.3

package/dist/commands/init.js

@@ -1,7 +1,8 @@
 import { existsSync, readdirSync } from 'fs';
-import { mkdir, copyFile, cp } from 'fs/promises';
+import { mkdir, copyFile, cp, writeFile } from 'fs/promises';
 import { join, resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
 import chalk from 'chalk';
 import ora from 'ora';
 import inquirer from 'inquirer';
@@ -101,8 +102,143 @@ export async function initCommand(options) {
         count; // already counted
     }
     spinner.succeed(`Copied ${count} files to .claude/`);
+    // Generate mustard.json (git flow config)
+    await generateMustardJson(projectPath, options);
     printNextSteps();
 }
+function detectDefaultBranch() {
+    try {
+        const ref = execSync('git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null', { encoding: 'utf-8' }).trim();
+        return ref.replace('refs/remotes/origin/', '');
+    }
+    catch {
+        try {
+            // Fallback: check if main or master exists
+            const branches = execSync('git branch -r', { encoding: 'utf-8' });
+            if (branches.includes('origin/main'))
+                return 'main';
+            if (branches.includes('origin/master'))
+                return 'master';
+        }
+        catch { /* not a git repo */ }
+        return 'main';
+    }
+}
+function detectHasSubmodules() {
+    try {
+        return existsSync(join(process.cwd(), '.gitmodules'));
+    }
+    catch {
+        return false;
+    }
+}
+function detectCurrentBranch() {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function detectRemoteBranches() {
+    try {
+        const output = execSync('git branch -r --format="%(refname:short)"', { encoding: 'utf-8' });
+        return output.split('\n').filter(Boolean).map(b => b.replace('origin/', ''));
+    }
+    catch {
+        return [];
+    }
+}
+async function generateMustardJson(projectPath, options) {
+    const configPath = join(projectPath, 'mustard.json');
+    if (existsSync(configPath)) {
+        console.log(chalk.gray('\n  mustard.json already exists — preserved'));
+        return;
+    }
+    const defaultBranch = detectDefaultBranch();
+    const hasSubmodules = detectHasSubmodules();
+    const currentBranch = detectCurrentBranch();
+    const remoteBranches = detectRemoteBranches();
+    const hasDevBranch = remoteBranches.includes('dev') || remoteBranches.includes('develop');
+    console.log(chalk.bold('\n📋 Git Flow Configuration\n'));
+    if (currentBranch) {
+        console.log(chalk.gray(`  Detected: branch=${currentBranch}, default=${defaultBranch}, submodules=${hasSubmodules}`));
+        if (hasDevBranch)
+            console.log(chalk.gray(`  Found dev branch: ${remoteBranches.includes('dev') ? 'dev' : 'develop'}`));
+        console.log();
+    }
+    let config;
+    if (options.yes) {
+        // Auto-config with sensible defaults
+        const flow = {};
+        if (hasDevBranch) {
+            flow['dev_*'] = remoteBranches.includes('dev') ? 'dev' : 'develop';
+            flow[remoteBranches.includes('dev') ? 'dev' : 'develop'] = defaultBranch;
+        }
+        config = {
+            git: {
+                flow,
+                pr: { enabled: true, provider: 'github' },
+                submodules: hasSubmodules
+            }
+        };
+    }
+    else {
+        // Interactive setup
+        const answers = await inquirer.prompt([
+            {
+                type: 'input',
+                name: 'production',
+                message: 'Production branch:',
+                default: defaultBranch
+            },
+            {
+                type: 'input',
+                name: 'devBranch',
+                message: 'Development branch (shared, leave empty to skip):',
+                default: hasDevBranch ? (remoteBranches.includes('dev') ? 'dev' : 'develop') : ''
+            },
+            {
+                type: 'input',
+                name: 'devPattern',
+                message: 'Personal branch pattern (glob → dev branch):',
+                default: 'dev_*',
+                when: (a) => !!a.devBranch
+            },
+            {
+                type: 'confirm',
+                name: 'prEnabled',
+                message: 'Use Pull Requests for merging?',
+                default: true
+            },
+            {
+                type: 'list',
+                name: 'provider',
+                message: 'Git provider:',
+                choices: ['github', 'gitlab', 'bitbucket'],
+                default: 'github',
+                when: (a) => a.prEnabled
+            }
+        ]);
+        const flow = {};
+        if (answers.devBranch) {
+            if (answers.devPattern) {
+                flow[answers.devPattern] = answers.devBranch;
+            }
+            flow[answers.devBranch] = answers.production;
+        }
+        config = {
+            git: {
+                flow,
+                pr: { enabled: answers.prEnabled, provider: answers.provider || 'github' },
+                submodules: hasSubmodules
+            }
+        };
+    }
+    const spinner = ora('Writing mustard.json...').start();
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n');
+    spinner.succeed('Created mustard.json');
+}
 function printNextSteps() {
     console.log(chalk.green.bold('\n✅ Done!\n'));
     console.log(chalk.white('Next: open Claude Code and run /scan to analyze your codebase.\n'));

package/dist/commands/init.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustard-claude",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "description": "Framework-agnostic CLI for Claude Code project setup",
   "type": "module",
   "bin": {

package/templates/.claude/commands/guards.md

@@ -0,0 +1,76 @@
+<!-- mustard:generated at:2026-03-25T00:00:00.000Z role:general -->
+# Guards: Templates
+
+> DO/DON'T rules for the Mustard templates subproject.
+
+## Hook Development
+
+| Rule | Type |
+|------|------|
+| DO read all stdin before processing (`on('end', ...)`) | DO |
+| DO fail-open: `catch → stderr + exit(0)` | DO |
+| DO normalize Windows paths (`\` to `/`) before pattern matching | DO |
+| DO use `process.exit(0)` for approve (silent exit) | DO |
+| DO write JSON to stdout for block/deny/context responses | DO |
+| DON'T use any npm dependencies — only Node.js built-ins | DON'T |
+| DON'T throw unhandled exceptions — always wrap in try/catch | DON'T |
+| DON'T block on parse errors — treat as approve | DON'T |
+| DON'T use `console.log` for debugging — use `process.stderr.write` | DON'T |
+
+## Hook Response Protocol
+
+| Rule | Type |
+|------|------|
+| DO use `permissionDecision: 'block'` or `'deny'` for PreToolUse hooks | DO |
+| DO use `decision: 'approve'` or `'block'` for PostToolUse hooks | DO |
+| DO include `hookEventName` matching the hook's lifecycle event | DO |
+| DON'T mix PreToolUse and PostToolUse response formats | DON'T |
+
+## Settings & Wiring
+
+| Rule | Type |
+|------|------|
+| DO register every new hook in `settings.json` under the correct lifecycle event | DO |
+| DO set a `timeout` for every hook registration (3-15 seconds) | DO |
+| DO use `$CLAUDE_PROJECT_DIR` in hook command paths | DO |
+| DON'T add hooks without a `matcher` — every hook must declare what it matches | DON'T |
+
+## Commands (SKILL.md)
+
+| Rule | Type |
+|------|------|
+| DO end every command SKILL.md with `ULTRATHINK` | DO |
+| DO include `## Trigger` with exact invocation syntax | DO |
+| DO include `## Rules` section with explicit constraints | DO |
+| DON'T create commands that implement code directly — delegate via Task | DON'T |
+
+## Scripts
+
+| Rule | Type |
+|------|------|
+| DO use `execSync` with `stdio: ['pipe','pipe','pipe']` and `windowsHide: true` | DO |
+| DO set timeouts on all `execSync` calls | DO |
+| DO handle missing files/dirs gracefully (try/catch around fs ops) | DO |
+| DON'T import external packages — all scripts must be self-contained | DON'T |
+
+## Skills (SKILL.md)
+
+| Rule | Type |
+|------|------|
+| DO include YAML frontmatter with `name` and `description` | DO |
+| DO write "pushy" descriptions with casual trigger phrases | DO |
+| DO add `<!-- mustard:generated -->` after the closing `---` | DO |
+| DO keep SKILL.md under 500 lines (ideally under 200) | DO |
+| DON'T put `<!-- mustard:generated -->` before the opening `---` | DON'T |
+| DON'T use generic descriptions — be specific about what and when | DON'T |
+
+## Generated Files
+
+| Rule | Type |
+|------|------|
+| DO start every generated file with `<!-- mustard:generated at:{ISO} role:{role} -->` | DO |
+| DO include H1 title + blockquote description | DO |
+| DO keep under 200 lines per file | DO |
+| DO reference real files with `Ref: path/file.ext` | DO |
+| DON'T include generic information — only data traced from real code | DON'T |
+| DON'T overwrite files without `<!-- mustard:generated` header (manual files) | DON'T |

package/templates/.claude/commands/notes.md

@@ -0,0 +1,22 @@
+# Notes: Templates (General)
+
+> Manual notes for the Mustard templates subproject. Never overwritten by /scan.
+
+## Mandatory Patterns
+
+- All hooks read JSON from stdin and write JSON to stdout
+- All hooks fail-open (exit 0 on error) except when explicitly blocking
+- All generated files start with `<!-- mustard:generated -->` header
+- Skills use YAML frontmatter with `name` and `description` fields
+
+## Known Pitfalls
+
+- Hook stdin must be fully consumed before processing (`on('end', ...)`)
+- Windows path separators must be normalized (`\` to `/`) in file-guard and guard-verify
+- CLAUDE_PROJECT_DIR env var may not be set in all contexts — always fallback to cwd
+
+## Observations
+
+- Templates are copied verbatim to target projects by `mustard init`/`mustard update`
+- The `settings.json` defines the full hook wiring — any new hook must be registered there
+- Skills in `skills/` are foundation skills (stack-agnostic); subproject-specific skills go in `{sub}/.claude/skills/`

package/templates/.claude/commands/patterns.md

@@ -0,0 +1,173 @@
+<!-- mustard:generated at:2026-03-25T00:00:00.000Z role:general -->
+# Patterns: Templates
+
+> Recurring code patterns across hooks, scripts, and commands.
+
+## P1. Hook Stdin/Stdout Protocol
+
+All hooks read JSON from stdin, process, and either exit silently (approve) or write JSON to stdout (block/deny/context).
+
+```js
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  const data = JSON.parse(input);
+  // ... process
+  process.exit(0); // approve (silent)
+});
+```
+
+Ref: `hooks/bash-safety.js`, `hooks/file-guard.js`, `hooks/enforce-registry.js`
+
+## P2. PreToolUse Block Response
+
+Hooks that block return a specific JSON structure with `permissionDecision`:
+
+```js
+console.log(JSON.stringify({
+  hookSpecificOutput: {
+    hookEventName: 'PreToolUse',
+    permissionDecision: 'block', // or 'deny'
+    permissionDecisionReason: 'Reason message'
+  }
+}));
+```
+
+Ref: `hooks/enforce-registry.js` (line 100-109), `hooks/bash-safety.js` (line 44-49)
+
+## P3. PostToolUse Approve/Block Response
+
+PostToolUse hooks use `decision` field (not `permissionDecision`):
+
+```js
+process.stdout.write(JSON.stringify({ decision: 'approve' }));
+// or
+process.stdout.write(JSON.stringify({ decision: 'block', reason: '...' }));
+```
+
+Ref: `hooks/guard-verify.js` (line 60-95)
+
+## P4. Fail-Open Error Handling
+
+Every hook wraps the main logic in try/catch and exits 0 on error — never blocking due to hook bugs:
+
+```js
+} catch (err) {
+  process.stderr.write(`[hook-name] Error: ${err.message}\n`);
+  process.exit(0); // fail-open
+}
+```
+
+Ref: `hooks/bash-safety.js` (line 56-59), `hooks/file-guard.js` (line 57-60)
+
+## P5. Regex-Based Dangerous Command Detection
+
+`bash-safety.js` uses an array of `{ re, msg }` objects tested sequentially against the command string:
+
+```js
+const DANGEROUS = [
+  { re: /\brm\s+(-\w*r\w*f|...)\b/i, msg: 'Recursive force delete blocked' },
+  // ...
+];
+for (const { re, msg } of DANGEROUS) {
+  if (re.test(cmd)) { /* deny */ }
+}
+```
+
+Ref: `hooks/bash-safety.js` (line 14-28)
+
+## P6. File Pattern Blocking
+
+`file-guard.js` blocks access to sensitive files using regex patterns tested against both full path and basename:
+
+```js
+const BLOCKED_PATTERNS = [/credentials/i, /\.pem$/i, /\.key$/i, ...];
+for (const pattern of BLOCKED_PATTERNS) {
+  if (pattern.test(normalized) || pattern.test(basename)) { /* deny */ }
+}
+```
+
+Ref: `hooks/file-guard.js` (line 16-25)
+
+## P7. Role Detection via Scoring
+
+`sync-detect.js` assigns numeric weights (HIGH=10, MEDIUM=5, LOW=3) to file/dep signals, accumulating scores per role. Highest score wins:
+
+| Weight | Signal Type | Example |
+|--------|------------|---------|
+| HIGH (10) | Config files | `.csproj` with Sdk.Web, `next.config.*` |
+| MEDIUM (5) | Package deps | `react` in package.json, `express` |
+| LOW (3) | Directories | `Controllers/`, `app/` + `components/` |
+
+Ref: `scripts/sync-detect.js` (line 210-327)
+
+## P8. SHA-256 Source Hashing for Incremental Scan
+
+`sync-detect.js` computes deterministic hashes by sorting files and updating hash with both path and content:
+
+```js
+const hash = crypto.createHash('sha256');
+for (const file of files.sort()) {
+  hash.update(file);    // path (rename-sensitive)
+  hash.update(content); // content
+}
+return hash.digest('hex');
+```
+
+Ref: `scripts/sync-detect.js` (line 643-659)
+
+## P9. FIFO Queue with Type-Match Preference (Subagent Tracker)
+
+Subagent tracker uses a queue to correlate Task tool calls with SubagentStart events. PreToolUse captures description; SubagentStart consumes by type-match first, FIFO fallback:
+
+```js
+const typeIdx = queue.findIndex(q => q.type === agentType);
+if (typeIdx >= 0) { /* consume type-matched entry */ }
+else { /* FIFO: consume first */ }
+```
+
+Ref: `hooks/subagent-tracker.js` (line 80-95)
+
+## P10. ANSI Statusline with Git Cache
+
+`statusline.js` caches git status in a temp file with 5s TTL to avoid repeated `git` calls:
+
+```js
+const GIT_CACHE_FILE = path.join(os.tmpdir(), 'claude-statusline-git.json');
+const GIT_CACHE_TTL = 5000;
+```
+
+Ref: `scripts/statusline.js` (line 17-18, 296-326)
+
+## P11. Command SKILL.md Structure
+
+All slash commands follow the same structure: H1 title, trigger section, description, procedure/action, rules, and `ULTRATHINK` footer:
+
+```markdown
+# /command-name - Title
+## Trigger
+`/command-name <args>`
+## Description / ## Procedure / ## Action
+...
+## Rules
+...
+ULTRATHINK
+```
+
+Ref: `commands/mustard/feature/SKILL.md`, `commands/mustard/bugfix/SKILL.md`
+
+## P12. Foundation Skill YAML Frontmatter
+
+Foundation skills use YAML frontmatter with `name`, `description`, and optional `disable-model-invocation`:
+
+```yaml
+---
+name: skill-name
+description: "What it does. When to use it."
+disable-model-invocation: true
+---
+<!-- mustard:generated -->
+```
+
+Ref: `skills/commit-workflow/SKILL.md`, `skills/pipeline-execution/SKILL.md`

package/templates/.claude/commands/recipes.md

@@ -0,0 +1,91 @@
+<!-- mustard:generated at:2026-03-25T00:00:00.000Z role:general -->
+# Recipes: Templates
+
+> Implementation recipes for common tasks in the templates subproject.
+
+## Recipe: New Hook
+
+### Steps
+1. Create `hooks/{hook-name}.js` following stdin/stdout protocol → `patterns.md` P1
+2. Implement logic with fail-open error handling → `patterns.md` P4
+3. Choose response format: PreToolUse (`permissionDecision`) or PostToolUse (`decision`) → `patterns.md` P2, P3
+4. Register in `settings.json` under correct lifecycle event with matcher and timeout
+5. Add test cases in `hooks/__tests__/hooks.test.js`
+6. Run tests: `node --test hooks/__tests__/hooks.test.js`
+
+### Reference module: bash-safety.js (PreToolUse) | guard-verify.js (PostToolUse)
+### Reference files: `hooks/bash-safety.js`, `hooks/guard-verify.js`, `settings.json`, `hooks/__tests__/hooks.test.js`
+
+### Task splits
+- **HookImpl** (steps 1-3): Patterns: `patterns.md` P1-P4 | Depends on: none
+- **HookWiring** (steps 4-6): Patterns: `guards.md` Settings | Depends on: HookImpl
+
+### File hierarchy
+| Level | Component | Depends on |
+|-------|-----------|-----------|
+| 1 | `hooks/{name}.js` | -- |
+| 2 | `settings.json` (registration) | hooks/{name}.js |
+| 3 | `hooks/__tests__/hooks.test.js` | hooks/{name}.js |
+| 4 | test run | all |
+
+## Recipe: New Slash Command
+
+### Steps
+1. Create `commands/mustard/{command-name}/SKILL.md` with trigger, description, procedure, rules → `patterns.md` P11
+2. Include `ULTRATHINK` at the end
+3. Verify command follows delegation pattern (no direct code implementation)
+
+### Reference module: feature/SKILL.md (complex) | status/SKILL.md (simple)
+### Reference files: `commands/mustard/feature/SKILL.md`, `commands/mustard/status/SKILL.md`
+
+### Task splits
+- **CommandDef** (steps 1-3): Patterns: `patterns.md` P11 | Depends on: none
+
+### File hierarchy
+| Level | Component | Depends on |
+|-------|-----------|-----------|
+| 1 | `commands/mustard/{name}/SKILL.md` | -- |
+
+## Recipe: New Foundation Skill
+
+### Steps
+1. Create `skills/{skill-name}/SKILL.md` with YAML frontmatter → `patterns.md` P12
+2. Write pushy description with casual trigger phrases → `guards.md` Skills
+3. Add `<!-- mustard:generated -->` after closing `---`
+4. Create `skills/{skill-name}/references/examples.md` with real code examples
+5. Keep SKILL.md under 500 lines
+
+### Reference module: commit-workflow (simple) | design-craft (with references)
+### Reference files: `skills/commit-workflow/SKILL.md`, `skills/design-craft/SKILL.md`
+
+### Task splits
+- **SkillDef** (steps 1-5): Patterns: `patterns.md` P12, `guards.md` Skills | Depends on: none
+
+### File hierarchy
+| Level | Component | Depends on |
+|-------|-----------|-----------|
+| 1 | `skills/{name}/SKILL.md` | -- |
+| 2 | `skills/{name}/references/examples.md` | SKILL.md |
+
+## Recipe: New Sync Script
+
+### Steps
+1. Create `scripts/{script-name}.js` with shebang and JSDoc header
+2. Use only Node.js built-ins (fs, path, child_process, crypto)
+3. Read ROOT from `path.resolve(__dirname, '..', '..')` → `patterns.md` P8
+4. Handle missing files/dirs gracefully with try/catch
+5. Output JSON to stdout for consumption by other tools
+6. Test manually: `node scripts/{script-name}.js`
+
+### Reference module: sync-detect.js (complex) | sync-registry.js (medium)
+### Reference files: `scripts/sync-detect.js`, `scripts/sync-registry.js`
+
+### Task splits
+- **ScriptImpl** (steps 1-5): Patterns: `patterns.md` P7, P8 | Depends on: none
+- **ScriptTest** (step 6): Depends on: ScriptImpl
+
+### File hierarchy
+| Level | Component | Depends on |
+|-------|-----------|-----------|
+| 1 | `scripts/{name}.js` | -- |
+| 2 | manual test | scripts/{name}.js |

package/templates/.claude/commands/stack.md

@@ -0,0 +1,86 @@
+<!-- mustard:generated at:2026-03-25T00:00:00.000Z role:general -->
+# Stack: Templates
+
+> Technology stack and tooling for the Mustard templates subproject.
+
+## Runtime
+
+| Component | Version | Notes |
+|-----------|---------|-------|
+| Node.js | >=18 | All hooks/scripts use CommonJS (`require`) |
+| JavaScript | ES2020+ | Optional chaining, nullish coalescing, `Set`, `Map` |
+
+## Dependencies
+
+None. All template files are dependency-free — they use only Node.js built-in modules:
+
+| Module | Used In |
+|--------|---------|
+| `fs` | All hooks, all scripts |
+| `path` | All hooks, all scripts |
+| `child_process` | `auto-format.js`, `pre-compact.js`, `statusline.js`, `sync-detect.js`, `sync-registry.js` |
+| `crypto` | `sync-detect.js` (SHA-256 hashing) |
+| `os` | `statusline.js`, `session-cleanup.js` |
+
+## File Categories
+
+| Category | Path | Count | Purpose |
+|----------|------|-------|---------|
+| Hooks | `hooks/*.js` | 8 | PreToolUse/PostToolUse/Session lifecycle guards |
+| Scripts | `scripts/*.js` | 3 | Sync-detect, sync-registry, statusline |
+| Commands | `commands/mustard/*/SKILL.md` | 14 | Slash command definitions |
+| Skills | `skills/*/SKILL.md` | 6 | Foundation skills (design-craft, react-best-practices, etc.) |
+| Config | `settings.json` | 1 | Hook wiring, permissions, statusline |
+| Config | `pipeline-config.md` | 1 | Agent dispatch rules, wave system, model selection |
+| Template | `CLAUDE.md` | 1 | Orchestrator rules template |
+
+## Commands
+
+```bash
+# Run hook tests
+node --test hooks/__tests__/hooks.test.js
+
+# Run sync-detect (outputs JSON)
+node scripts/sync-detect.js
+node scripts/sync-detect.js --no-cache
+
+# Run sync-registry
+node scripts/sync-registry.js
+node scripts/sync-registry.js --force
+```
+
+## Structure
+
+```
+templates/
+├── CLAUDE.md                    # Orchestrator rules (copied to .claude/CLAUDE.md)
+├── settings.json                # Hook wiring + permissions
+├── pipeline-config.md           # Agent/wave/model config
+├── commands/mustard/             # 14 slash commands
+│   ├── feature/SKILL.md
+│   ├── bugfix/SKILL.md
+│   ├── scan/SKILL.md
+│   ├── git/SKILL.md
+│   └── ... (approve, complete, resume, status, task, etc.)
+├── hooks/                        # 8 lifecycle hooks
+│   ├── bash-safety.js            # PreToolUse — block dangerous commands
+│   ├── file-guard.js             # PreToolUse — block sensitive files
+│   ├── enforce-registry.js       # PreToolUse — require entity-registry
+│   ├── auto-format.js            # PostToolUse — prettier/dotnet format
+│   ├── guard-verify.js           # PostToolUse — architectural rules
+│   ├── subagent-tracker.js       # Pre/SubagentStart/Stop — agent state
+│   ├── pre-compact.js            # PreCompact — snapshot before compaction
+│   ├── session-cleanup.js        # SessionEnd — prune stale state
+│   └── __tests__/hooks.test.js   # Tests (node:test + node:assert)
+├── scripts/
+│   ├── sync-detect.js            # Subproject discovery + role detection
+│   ├── sync-registry.js          # Entity registry generation
+│   └── statusline.js             # ANSI statusline renderer
+└── skills/                       # Foundation skills
+    ├── commit-workflow/
+    ├── design-craft/
+    ├── pipeline-execution/
+    ├── react-best-practices/
+    ├── senior-architect/
+    └── skill-creator/
+```