@codihaus/claude-skills 1.0.0

package/src/utils/config.js

@@ -0,0 +1,272 @@
+/**
+ * Configuration Utilities
+ *
+ * Set up Claude Code settings, hooks, and project configuration.
+ */
+
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const TEMPLATES_PATH = path.join(__dirname, '../../templates');
+
+/**
+ * Default settings for Claude Code
+ */
+const DEFAULT_SETTINGS = {
+  permissions: {
+    allow: [
+      "Bash(npm run *)",
+      "Bash(npm test*)",
+      "Bash(npm install*)",
+      "Bash(npx *)",
+      "Bash(git *)",
+      "Bash(python3 *)",
+      "Bash(curl *)",
+      "Bash(ls *)",
+      "Bash(find *)",
+      "Bash(grep *)",
+      "Bash(cat *)",
+      "Bash(mkdir *)",
+      "Bash(cp *)",
+      "Bash(mv *)",
+      "Bash(rm -rf node_modules*)",
+      "Bash(rm -rf .next*)",
+      "Bash(rm -rf dist*)",
+      "Read(*)",
+      "Write(*)",
+      "Edit(*)"
+    ],
+    deny: []
+  }
+};
+
+/**
+ * Hooks for automatic graph updates
+ */
+const DEFAULT_HOOKS = {
+  postToolUse: [
+    {
+      matcher: {
+        toolName: "Write|Edit",
+        path: "plans/**/*"
+      },
+      command: "python3 scripts/graph.py --check-path $PATH || true"
+    }
+  ]
+};
+
+/**
+ * Set up Claude Code settings
+ */
+export async function setupSettings(projectPath, options = {}) {
+  const claudePath = path.join(projectPath, '.claude');
+  const settingsPath = path.join(claudePath, 'settings.local.json');
+
+  await fs.ensureDir(claudePath);
+
+  let settings = DEFAULT_SETTINGS;
+
+  // Merge with existing if present
+  if (await fs.pathExists(settingsPath)) {
+    try {
+      const existing = await fs.readJson(settingsPath);
+      settings = mergeSettings(existing, settings);
+    } catch (e) {
+      // Invalid JSON, use defaults
+    }
+  }
+
+  await fs.writeJson(settingsPath, settings, { spaces: 2 });
+
+  return { path: settingsPath, settings };
+}
+
+/**
+ * Set up hooks
+ */
+export async function setupHooks(projectPath, options = {}) {
+  if (options.noHooks) return null;
+
+  const claudePath = path.join(projectPath, '.claude');
+  const hooksPath = path.join(claudePath, 'hooks.json');
+
+  await fs.ensureDir(claudePath);
+
+  let hooks = DEFAULT_HOOKS;
+
+  // Merge with existing if present
+  if (await fs.pathExists(hooksPath)) {
+    try {
+      const existing = await fs.readJson(hooksPath);
+      hooks = mergeHooks(existing, hooks);
+    } catch (e) {
+      // Invalid JSON, use defaults
+    }
+  }
+
+  await fs.writeJson(hooksPath, hooks, { spaces: 2 });
+
+  return { path: hooksPath, hooks };
+}
+
+/**
+ * Set up or update CLAUDE.md
+ */
+export async function setupClaudeMd(projectPath, options = {}) {
+  const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
+  const templatePath = path.join(TEMPLATES_PATH, 'CLAUDE.md.template');
+
+  // Check if CLAUDE.md already exists
+  if (await fs.pathExists(claudeMdPath)) {
+    if (options.skipExisting) {
+      return { path: claudeMdPath, action: 'skipped', reason: 'already exists' };
+    }
+
+    // Don't overwrite, but append skills reference if not present
+    const content = await fs.readFile(claudeMdPath, 'utf-8');
+
+    if (!content.includes('## Skills')) {
+      const skillsSection = `
+## Skills
+
+This project uses CodiHaus Claude Skills. Available skills:
+
+- \`/debrief\` - Create BRD and use cases
+- \`/dev-scout\` - Explore and document codebase
+- \`/dev-arch\` - Architecture decisions
+- \`/dev-specs\` - Create implementation plans
+- \`/dev-coding\` - Implement features
+- \`/dev-test\` - Automated testing
+- \`/dev-review\` - Code review
+- \`/dev-changelog\` - Document what was built
+
+See \`.claude/skills/_registry.md\` for full documentation.
+`;
+      await fs.appendFile(claudeMdPath, skillsSection);
+      return { path: claudeMdPath, action: 'updated', reason: 'added skills section' };
+    }
+
+    return { path: claudeMdPath, action: 'skipped', reason: 'skills section exists' };
+  }
+
+  // Create from template
+  if (await fs.pathExists(templatePath)) {
+    await fs.copy(templatePath, claudeMdPath);
+    return { path: claudeMdPath, action: 'created', reason: 'from template' };
+  }
+
+  // Create minimal CLAUDE.md
+  const minimalContent = `# CLAUDE.md
+
+Project-specific instructions for Claude Code.
+
+## Skills
+
+This project uses CodiHaus Claude Skills. Available skills:
+
+- \`/debrief\` - Create BRD and use cases
+- \`/dev-scout\` - Explore and document codebase
+- \`/dev-arch\` - Architecture decisions
+- \`/dev-specs\` - Create implementation plans
+- \`/dev-coding\` - Implement features
+- \`/dev-test\` - Automated testing
+- \`/dev-review\` - Code review
+- \`/dev-changelog\` - Document what was built
+
+See \`.claude/skills/_registry.md\` for full documentation.
+
+## Project Overview
+
+{Add your project description here}
+
+## Development
+
+{Add development instructions here}
+`;
+
+  await fs.writeFile(claudeMdPath, minimalContent);
+  return { path: claudeMdPath, action: 'created', reason: 'minimal template' };
+}
+
+/**
+ * Set up scripts directory
+ */
+export async function setupScripts(projectPath) {
+  const scriptsPath = path.join(projectPath, 'scripts');
+  const sourceScripts = path.join(TEMPLATES_PATH, 'scripts');
+
+  await fs.ensureDir(scriptsPath);
+
+  // Copy graph.py if it exists in templates
+  const graphPy = path.join(sourceScripts, 'graph.py');
+  if (await fs.pathExists(graphPy)) {
+    await fs.copy(graphPy, path.join(scriptsPath, 'graph.py'));
+  }
+
+  return { path: scriptsPath };
+}
+
+/**
+ * Add to .gitignore
+ */
+export async function updateGitignore(projectPath) {
+  const gitignorePath = path.join(projectPath, '.gitignore');
+
+  const entriesToAdd = [
+    '',
+    '# Claude Code',
+    '.claude/settings.local.json',
+    '.env',
+    '*.env.local',
+    ''
+  ];
+
+  if (await fs.pathExists(gitignorePath)) {
+    const content = await fs.readFile(gitignorePath, 'utf-8');
+
+    // Check if already has Claude section
+    if (content.includes('# Claude Code')) {
+      return { action: 'skipped' };
+    }
+
+    await fs.appendFile(gitignorePath, entriesToAdd.join('\n'));
+    return { action: 'updated' };
+  }
+
+  await fs.writeFile(gitignorePath, entriesToAdd.join('\n'));
+  return { action: 'created' };
+}
+
+/**
+ * Merge settings objects
+ */
+function mergeSettings(existing, defaults) {
+  return {
+    permissions: {
+      allow: [...new Set([
+        ...(existing.permissions?.allow || []),
+        ...(defaults.permissions?.allow || [])
+      ])],
+      deny: [...new Set([
+        ...(existing.permissions?.deny || []),
+        ...(defaults.permissions?.deny || [])
+      ])]
+    }
+  };
+}
+
+/**
+ * Merge hooks objects
+ */
+function mergeHooks(existing, defaults) {
+  // For now, just use defaults if hooks exist
+  // More sophisticated merging could be added
+  return {
+    ...defaults,
+    ...existing
+  };
+}