@the-bearded-bear/claude-craft 7.3.0 → 7.4.0-next.cf176bf

package/README.md

@@ -531,8 +531,6 @@ Copy the appropriate bundle into your preferred AI platform's custom instruction
 - `/project:` - Project management (backlog, PRD, tech-spec, sprints, **batch processing, migration**)
 - `/sprint:` - **BMAD sprint management (status, transitions, routing, TDD)**
 - `/gate:` - **Quality gate validation (PRD, tech-spec, backlog, story, sprint)**
-- `/pm:` - **Product Manager commands (prd, vision, roadmap, prioritize)**
-- `/arch:` - **Architect commands (design, techspec, adr, api, security)**
 - `/common:` - Transversal commands (audit, changelog, CI/CD)
 - `/symfony:` - Symfony-specific (CRUD, migrations, Doctrine)
 - `/flutter:` - Flutter-specific (widgets, BLoC, performance)
@@ -545,7 +543,7 @@ Copy the appropriate bundle into your preferred AI platform's custom instruction
 - `/vuejs:` - Vue.js-specific (components, composables, Pinia)
 - `/php:` - PHP-specific (entities, value objects, use cases, Clean Architecture)
 - `/docker:` - Docker/Infrastructure (compose, debug, pipelines, architecture)
-- `/common:recette*` - **QA Recette** (acceptance testing, regression, Chrome automation)
+- `/qa:*` - **QA Recette** (acceptance testing, regression, Chrome automation)
 
 ## Documentation
 

package/cli/index.js

@@ -35,6 +35,9 @@ import { printHelp } from './lib/help.js';
 import { interactiveInstall, runInstallation } from './lib/installer.js';
 import { runRalph } from './lib/ralph.js';
 import { runCheck } from './lib/check.js';
+import { runList } from './lib/list.js';
+import { runDoctor } from './lib/doctor.js';
+import { runUpdate } from './lib/update.js';
 
 // Flattener module
 import { flatten as flattenCodebaseFn } from './flattener.js';
@@ -172,6 +175,21 @@ class ClaudeCraftCLI {
         runCheck(this.config.targetPath);
         break;
 
+      case 'list':
+        printBanner(VERSION);
+        runList(this.config.targetPath);
+        break;
+
+      case 'doctor':
+        printBanner(VERSION);
+        runDoctor(this.config.targetPath);
+        break;
+
+      case 'update':
+        printBanner(VERSION);
+        runUpdate(this.config.targetPath, options, CLI_ROOT);
+        break;
+
       case 'init':
         printBanner(VERSION);
         console.log(`${c.cyan}Workflow initialization is available after installation.${c.reset}`);

package/cli/lib/check.js

@@ -7,36 +7,7 @@ import fs from 'fs';
 import path from 'path';
 import c from './colors.js';
 import { detectProject } from './detect-project.js';
-
-/**
- * Count files matching a glob pattern in a directory (non-recursive).
- * @param {string} dir - Directory path
- * @param {string} ext - File extension (e.g. '.md')
- * @returns {number}
- */
-function countFiles(dir, ext) {
-  try {
-    return fs.readdirSync(dir).filter((f) => f.endsWith(ext)).length;
-  } catch {
-    return 0;
-  }
-}
-
-/**
- * List subdirectories of a directory.
- * @param {string} dir - Directory path
- * @returns {string[]}
- */
-function listDirs(dir) {
-  try {
-    return fs
-      .readdirSync(dir, { withFileTypes: true })
-      .filter((d) => d.isDirectory())
-      .map((d) => d.name);
-  } catch {
-    return [];
-  }
-}
+import { countFiles, listDirs } from './fs-utils.js';
 
 /**
  * Run the check command against a target directory.

package/cli/lib/doctor.js

@@ -0,0 +1,166 @@
+/**
+ * CLI `doctor` command — environment diagnostics & installation health check.
+ * @module cli/lib/doctor
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import c from './colors.js';
+import { listDirs } from './fs-utils.js';
+
+/**
+ * Run a shell command and return the trimmed output, or null on failure.
+ * @param {string} cmd - Shell command to execute
+ * @returns {string|null}
+ */
+function tryExec(cmd) {
+  try {
+    return execSync(cmd, { encoding: 'utf8', timeout: 10_000 }).trim();
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Run the doctor command against a target directory.
+ * @param {string} targetPath - Absolute path to the project directory
+ * @param {Object} [deps] - Injectable dependencies for testing
+ * @param {function} [deps.execFn] - Custom exec function
+ */
+function runDoctor(targetPath, deps = {}) {
+  const exec = deps.execFn || tryExec;
+  let passed = 0;
+  let failed = 0;
+  let warned = 0;
+
+  console.log(`\n${c.bold}Claude Craft Doctor — Environment Diagnostics${c.reset}`);
+  console.log(`${c.dim}Directory: ${targetPath}${c.reset}\n`);
+
+  // 1. Node.js version >= 20
+  const nodeVer = process.version;
+  const major = parseInt(nodeVer.slice(1), 10);
+  if (major >= 20) {
+    console.log(`  ${c.green}[OK]${c.reset} Node.js ${nodeVer}`);
+    passed++;
+  } else {
+    console.log(`  ${c.red}[FAIL]${c.reset} Node.js ${nodeVer} — requires >= 20`);
+    failed++;
+  }
+
+  // 2. npm available
+  const npmVer = exec('npm --version');
+  if (npmVer) {
+    console.log(`  ${c.green}[OK]${c.reset} npm ${npmVer}`);
+    passed++;
+  } else {
+    console.log(`  ${c.red}[FAIL]${c.reset} npm not found`);
+    failed++;
+  }
+
+  // 3. Claude Code installed
+  const claudeVer = exec('claude --version');
+  if (claudeVer) {
+    console.log(`  ${c.green}[OK]${c.reset} Claude Code ${claudeVer}`);
+    passed++;
+  } else {
+    console.log(`  ${c.yellow}[WARN]${c.reset} Claude Code not found (optional for install, required for usage)`);
+    warned++;
+  }
+
+  // 4. Git available
+  const gitVer = exec('git --version');
+  if (gitVer) {
+    console.log(`  ${c.green}[OK]${c.reset} ${gitVer}`);
+    passed++;
+  } else {
+    console.log(`  ${c.red}[FAIL]${c.reset} git not found`);
+    failed++;
+  }
+
+  // 5. .claude/ structure integrity
+  const claudeDir = path.join(targetPath, '.claude');
+  if (fs.existsSync(claudeDir)) {
+    console.log(`  ${c.green}[OK]${c.reset} .claude/ directory exists`);
+    passed++;
+
+    // Check required subdirs
+    const requiredDirs = ['commands', 'agents', 'references', 'skills'];
+    for (const dir of requiredDirs) {
+      if (fs.existsSync(path.join(claudeDir, dir))) {
+        console.log(`  ${c.green}[OK]${c.reset} .claude/${dir}/`);
+        passed++;
+      } else {
+        console.log(`  ${c.yellow}[WARN]${c.reset} .claude/${dir}/ missing`);
+        warned++;
+      }
+    }
+
+    // CLAUDE.md
+    if (fs.existsSync(path.join(claudeDir, 'CLAUDE.md'))) {
+      console.log(`  ${c.green}[OK]${c.reset} .claude/CLAUDE.md`);
+      passed++;
+    } else {
+      console.log(`  ${c.yellow}[WARN]${c.reset} .claude/CLAUDE.md missing`);
+      warned++;
+    }
+  } else {
+    console.log(`  ${c.yellow}[WARN]${c.reset} .claude/ directory not found (not installed here)`);
+    warned++;
+  }
+
+  // 6. Shell scripts have execute permissions
+  const scriptsDir = path.join(targetPath, 'Dev', 'scripts');
+  if (fs.existsSync(scriptsDir)) {
+    try {
+      const files = fs.readdirSync(scriptsDir).filter((f) => f.endsWith('.sh'));
+      let execCount = 0;
+      let noExecCount = 0;
+      for (const f of files) {
+        try {
+          fs.accessSync(path.join(scriptsDir, f), fs.constants.X_OK);
+          execCount++;
+        } catch {
+          noExecCount++;
+        }
+      }
+      if (noExecCount === 0 && execCount > 0) {
+        console.log(`  ${c.green}[OK]${c.reset} Shell scripts executable (${execCount} scripts)`);
+        passed++;
+      } else if (noExecCount > 0) {
+        console.log(`  ${c.yellow}[WARN]${c.reset} ${noExecCount} script(s) missing execute permission`);
+        warned++;
+      }
+    } catch {
+      // scriptsDir not readable
+    }
+  }
+
+  // 7. i18n base dirs
+  const i18nBase = path.join(targetPath, 'Dev', 'i18n');
+  if (fs.existsSync(i18nBase)) {
+    const langs = listDirs(i18nBase);
+    if (langs.length > 0) {
+      console.log(`  ${c.green}[OK]${c.reset} i18n base dirs: ${c.cyan}${langs.join(', ')}${c.reset}`);
+      passed++;
+    } else {
+      console.log(`  ${c.yellow}[WARN]${c.reset} i18n/ exists but no language dirs found`);
+      warned++;
+    }
+  }
+
+  // Summary
+  console.log('');
+  if (failed === 0 && warned === 0) {
+    console.log(`${c.green}All checks passed! (${passed} OK)${c.reset}\n`);
+  } else if (failed === 0) {
+    console.log(`${c.green}${passed} passed${c.reset}, ${c.yellow}${warned} warning(s)${c.reset}\n`);
+  } else {
+    console.log(
+      `${c.green}${passed} passed${c.reset}, ${c.red}${failed} failed${c.reset}, ${c.yellow}${warned} warning(s)${c.reset}\n`
+    );
+    process.exitCode = 1;
+  }
+}
+
+export { runDoctor };

package/cli/lib/fs-utils.js

@@ -0,0 +1,38 @@
+/**
+ * Shared filesystem utilities for CLI modules.
+ * @module cli/lib/fs-utils
+ */
+
+import fs from 'fs';
+
+/**
+ * Count files matching a given extension in a directory (non-recursive).
+ * @param {string} dir - Directory path
+ * @param {string} ext - File extension (e.g. '.md')
+ * @returns {number}
+ */
+function countFiles(dir, ext) {
+  try {
+    return fs.readdirSync(dir).filter((f) => f.endsWith(ext)).length;
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * List subdirectories of a directory.
+ * @param {string} dir - Directory path
+ * @returns {string[]}
+ */
+function listDirs(dir) {
+  try {
+    return fs
+      .readdirSync(dir, { withFileTypes: true })
+      .filter((d) => d.isDirectory())
+      .map((d) => d.name);
+  } catch {
+    return [];
+  }
+}
+
+export { countFiles, listDirs };

package/cli/lib/help.js

@@ -24,6 +24,9 @@ const NAMESPACES = [
   { prefix: 'angular', desc: 'Angular: architecture, compliance, testing' },
   { prefix: 'laravel', desc: 'Laravel: architecture, compliance, testing' },
   { prefix: 'vuejs', desc: 'Vue.js: architecture, compliance, testing' },
+  { prefix: 'python', desc: 'Python: endpoints, async, typing, FastAPI' },
+  { prefix: 'reactnative', desc: 'React Native: screens, navigation, native modules' },
+  { prefix: 'php', desc: 'PHP: entities, value objects, use cases, Clean Architecture' },
 ];
 
 /**
@@ -38,6 +41,9 @@ ${c.bold}Commands:${c.reset}
   ${c.green}install <path>${c.reset}       Install to specific directory
   ${c.green}init${c.reset}                 Initialize workflow in current project
   ${c.green}check${c.reset}                Verify claude-craft installation
+  ${c.green}list${c.reset}                 List installed components
+  ${c.green}doctor${c.reset}               Environment diagnostics
+  ${c.green}update${c.reset}               Refresh existing installation
   ${c.green}flatten${c.reset}              Generate flattened codebase summary
   ${c.green}ralph${c.reset}                Run Ralph Wiggum continuous loop
   ${c.green}help${c.reset}                 Show this help message
@@ -52,7 +58,7 @@ ${c.bold}Options:${c.reset}
   ${c.yellow}--enterprise${c.reset}         Enterprise track (platforms)
 
 ${c.bold}Available Namespaces:${c.reset}
-${NAMESPACES.map((ns) => `  ${c.cyan}/${ns.prefix}:*${c.reset}`.padEnd(30 + c.cyan.length + c.reset.length) + `${ns.desc}`).join('\n')}
+${NAMESPACES.map((ns) => `  ${c.cyan}/${ns.prefix}:*${c.reset}`.padEnd(30 + c.cyan.length + c.reset.length) + ns.desc).join('\n')}
 
   ${c.dim}Example: /common:pre-commit-check, /workflow:init, /team:sprint${c.reset}
 

package/cli/lib/list.js

@@ -0,0 +1,103 @@
+/**
+ * CLI `list` command — detailed listing of installed claude-craft components.
+ * @module cli/lib/list
+ */
+
+import fs from 'fs';
+import path from 'path';
+import c from './colors.js';
+import { countFiles, listDirs } from './fs-utils.js';
+import { detectProject } from './detect-project.js';
+
+/**
+ * Run the list command against a target directory.
+ * @param {string} targetPath - Absolute path to the project directory
+ */
+function runList(targetPath) {
+  const claudeDir = path.join(targetPath, '.claude');
+
+  console.log(`\n${c.bold}Claude Craft Installation — Detailed Listing${c.reset}`);
+  console.log(`${c.dim}Directory: ${targetPath}${c.reset}\n`);
+
+  if (!fs.existsSync(claudeDir)) {
+    console.log(`${c.red}No claude-craft installation detected.${c.reset}`);
+    console.log(`Run: npx @the-bearded-bear/claude-craft install ${targetPath}\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  // 1. Commands by namespace
+  const commandsDir = path.join(claudeDir, 'commands');
+  const namespaces = listDirs(commandsDir);
+  console.log(`${c.bold}Commands:${c.reset}`);
+  if (namespaces.length > 0) {
+    let totalCommands = 0;
+    for (const ns of namespaces) {
+      const count = countFiles(path.join(commandsDir, ns), '.md');
+      totalCommands += count;
+      console.log(`  ${c.cyan}/${ns}:*${c.reset} — ${count} command(s)`);
+    }
+    console.log(`  ${c.dim}Total: ${totalCommands} commands in ${namespaces.length} namespace(s)${c.reset}`);
+  } else {
+    console.log(`  ${c.yellow}No namespaces found${c.reset}`);
+  }
+
+  // 2. Agents
+  const agentsDir = path.join(claudeDir, 'agents');
+  const agentCount = countFiles(agentsDir, '.md');
+  console.log(`\n${c.bold}Agents:${c.reset}`);
+  if (agentCount > 0) {
+    console.log(`  ${agentCount} agent(s) in ${c.cyan}agents/${c.reset}`);
+  } else {
+    console.log(`  ${c.yellow}No agents found${c.reset}`);
+  }
+
+  // 3. References (installed tech refs)
+  const refsDir = path.join(claudeDir, 'references');
+  const refDirs = listDirs(refsDir);
+  console.log(`\n${c.bold}References:${c.reset}`);
+  if (refDirs.length > 0) {
+    for (const ref of refDirs) {
+      console.log(`  ${c.cyan}${ref}${c.reset}`);
+    }
+  } else {
+    console.log(`  ${c.yellow}No tech references found${c.reset}`);
+  }
+
+  // 4. Skills
+  const skillsDir = path.join(claudeDir, 'skills');
+  const skillDirs = listDirs(skillsDir);
+  let totalSkills = 0;
+  console.log(`\n${c.bold}Skills:${c.reset}`);
+  for (const sd of skillDirs) {
+    const count = countFiles(path.join(skillsDir, sd), '.md');
+    totalSkills += count;
+    if (count > 0) {
+      console.log(`  ${c.cyan}${sd}/${c.reset} — ${count} skill(s)`);
+    }
+  }
+  // Top-level skill files
+  const topSkills = countFiles(skillsDir, '.md');
+  totalSkills += topSkills;
+  if (topSkills > 0) {
+    console.log(`  ${c.dim}(+ ${topSkills} top-level)${c.reset}`);
+  }
+  if (totalSkills === 0) {
+    console.log(`  ${c.yellow}No skills found${c.reset}`);
+  } else {
+    console.log(`  ${c.dim}Total: ${totalSkills} skill(s)${c.reset}`);
+  }
+
+  // 5. Tech detection
+  const detected = detectProject(targetPath);
+  console.log(`\n${c.bold}Detected Technologies:${c.reset}`);
+  if (detected.suggestedTechs.length > 0) {
+    console.log(`  ${c.cyan}${detected.suggestedTechs.join(', ')}${c.reset} (complexity: ${detected.complexity})`);
+  } else {
+    console.log(`  ${c.dim}No technology detected from project files${c.reset}`);
+  }
+
+  console.log('');
+}
+
+export { runList };

package/cli/lib/update.js

@@ -0,0 +1,112 @@
+/**
+ * CLI `update` command — re-run install scripts to refresh an existing installation.
+ * @module cli/lib/update
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import c from './colors.js';
+import { listDirs } from './fs-utils.js';
+import { TECH_REGISTRY } from './tech-registry.js';
+
+/**
+ * Run the update command against a target directory.
+ * @param {string} targetPath - Absolute path to the project directory
+ * @param {Object} options - CLI options
+ * @param {string} [options.lang] - Language override (default: 'en')
+ * @param {string} [options.tech] - Specific tech to update (if omitted, updates all detected)
+ * @param {string} cliRoot - Path to the CLI package root
+ */
+function runUpdate(targetPath, options, cliRoot) {
+  const claudeDir = path.join(targetPath, '.claude');
+  const lang = options.lang || 'en';
+
+  console.log(`\n${c.bold}Claude Craft Update${c.reset}`);
+  console.log(`${c.dim}Directory: ${targetPath}${c.reset}\n`);
+
+  // Verify existing installation
+  if (!fs.existsSync(claudeDir)) {
+    console.log(`${c.red}No claude-craft installation detected.${c.reset}`);
+    console.log(`Run: npx @the-bearded-bear/claude-craft install ${targetPath}\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  // Determine techs to update
+  let techsToUpdate = [];
+
+  if (options.tech) {
+    // Explicit --tech flag
+    if (!TECH_REGISTRY[options.tech]) {
+      console.log(`${c.red}Unknown technology: ${options.tech}${c.reset}`);
+      console.log(`Available: ${Object.keys(TECH_REGISTRY).join(', ')}\n`);
+      process.exitCode = 1;
+      return;
+    }
+    techsToUpdate = [options.tech];
+  } else {
+    // Auto-detect from installed references
+    const refsDir = path.join(claudeDir, 'references');
+    const installedRefs = listDirs(refsDir);
+    techsToUpdate = installedRefs.filter((ref) => TECH_REGISTRY[ref]);
+  }
+
+  // Always refresh common rules
+  const scriptsDir = path.join(cliRoot, 'Dev', 'scripts');
+  const commonScript = path.join(scriptsDir, 'install-common-rules.sh');
+
+  let updated = 0;
+
+  if (fs.existsSync(commonScript)) {
+    console.log(`  ${c.cyan}Refreshing common rules...${c.reset}`);
+    try {
+      execSync(`bash "${commonScript}" "${targetPath}" "${lang}" --force`, {
+        encoding: 'utf8',
+        timeout: 60_000,
+        stdio: 'pipe',
+      });
+      console.log(`  ${c.green}[OK]${c.reset} Common rules updated`);
+      updated++;
+    } catch (e) {
+      console.log(`  ${c.red}[FAIL]${c.reset} Common rules: ${e.message}`);
+    }
+  }
+
+  // Run tech-specific install scripts
+  for (const tech of techsToUpdate) {
+    const entry = TECH_REGISTRY[tech];
+    const script = path.join(scriptsDir, entry.installScript);
+
+    if (!fs.existsSync(script)) {
+      console.log(`  ${c.yellow}[SKIP]${c.reset} ${entry.displayName} — install script not found`);
+      continue;
+    }
+
+    console.log(`  ${c.cyan}Refreshing ${entry.displayName}...${c.reset}`);
+    try {
+      execSync(`bash "${script}" "${targetPath}" "${lang}" --force`, {
+        encoding: 'utf8',
+        timeout: 60_000,
+        stdio: 'pipe',
+      });
+      console.log(`  ${c.green}[OK]${c.reset} ${entry.displayName} updated`);
+      updated++;
+    } catch (e) {
+      console.log(`  ${c.red}[FAIL]${c.reset} ${entry.displayName}: ${e.message}`);
+    }
+  }
+
+  // Summary
+  console.log('');
+  if (updated > 0) {
+    console.log(`${c.green}Update complete — ${updated} component(s) refreshed.${c.reset}\n`);
+  } else if (techsToUpdate.length === 0) {
+    console.log(`${c.yellow}No tech references detected. Use --tech=NAME to specify.${c.reset}\n`);
+  } else {
+    console.log(`${c.red}Update failed — no components were refreshed.${c.reset}\n`);
+    process.exitCode = 1;
+  }
+}
+
+export { runUpdate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-bearded-bear/claude-craft",
-  "version": "7.3.0",
+  "version": "7.4.0-next.cf176bf",
   "description": "A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects.",
   "type": "module",
   "main": "cli/index.js",