claude-power-setup 1.0.1

package/cli.js

@@ -0,0 +1,288 @@
+#!/usr/bin/env node
+// Claude Power Setup — npm CLI installer
+// Usage: npx claude-power-setup [--dry-run] [--force] [--skip-shell] [--skip-ecc]
+//
+// Delegates to install.sh if bash is available.
+// Falls back to pure Node.js file operations on Windows without bash.
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+const SCRIPT_DIR = __dirname;
+const CLAUDE_HOME = path.join(os.homedir(), ".claude");
+const VERSION = "1.0.0";
+
+const args = process.argv.slice(2);
+
+if (args.includes("--help") || args.includes("-h")) {
+  console.log(`
+Claude Power Setup v${VERSION}
+Multi-agent orchestration + self-improvement for Claude Code
+
+Usage: npx claude-power-setup [OPTIONS]
+
+Options:
+  --dry-run      Show what would be installed without writing files
+  --force        Overwrite existing files instead of skipping
+  --skip-shell   Don't modify shell profile (.bashrc/.zshrc)
+  --skip-ecc     Don't check for ECC installation
+  --uninstall    Run the uninstaller instead
+  --help         Show this help
+`);
+  process.exit(0);
+}
+
+// ── Try bash delegation ──────────────────────────────────────────
+function findBash() {
+  const candidates = [
+    "/bin/bash",
+    "/usr/bin/bash",
+    "/usr/local/bin/bash",
+    "C:\\Program Files\\Git\\bin\\bash.exe",
+    "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
+  ];
+
+  for (const candidate of candidates) {
+    try {
+      if (fs.existsSync(candidate)) return candidate;
+    } catch {
+      // skip
+    }
+  }
+
+  // Try PATH
+  try {
+    execFileSync("bash", ["--version"], { stdio: "ignore" });
+    return "bash";
+  } catch {
+    return null;
+  }
+}
+
+const bashPath = findBash();
+
+if (bashPath) {
+  const script = args.includes("--uninstall")
+    ? path.join(SCRIPT_DIR, "uninstall.sh")
+    : path.join(SCRIPT_DIR, "install.sh");
+
+  const bashArgs = args.filter((a) => a !== "--uninstall");
+
+  try {
+    execFileSync(bashPath, [script, ...bashArgs], {
+      stdio: "inherit",
+      env: { ...process.env, HOME: os.homedir() },
+    });
+  } catch (err) {
+    process.exit(err.status || 1);
+  }
+  process.exit(0);
+}
+
+// ── Pure Node.js fallback (no bash available) ────────────────────
+const DRY_RUN = args.includes("--dry-run");
+const FORCE = args.includes("--force");
+
+console.log(`
+  Claude Power Setup v${VERSION}
+  Multi-agent orchestration + self-improvement
+  (Node.js native mode — bash not found)
+`);
+
+if (DRY_RUN) {
+  console.log("[!] DRY RUN — no files will be written\n");
+}
+
+if (args.includes("--uninstall")) {
+  console.log("[!] Uninstall requires bash. Please run:");
+  console.log("    bash uninstall.sh");
+  process.exit(1);
+}
+
+function safeCopy(src, dest, label) {
+  if (DRY_RUN) {
+    if (fs.existsSync(dest) && !FORCE) {
+      console.log(`[i] SKIP (exists): ${label}`);
+    } else {
+      console.log(`[i] WOULD COPY: ${label} -> ${dest}`);
+    }
+    return;
+  }
+
+  const destDir = path.dirname(dest);
+  fs.mkdirSync(destDir, { recursive: true });
+
+  if (fs.existsSync(dest) && !FORCE) {
+    console.log(`[i] Skip (exists): ${label}`);
+    return;
+  }
+
+  fs.copyFileSync(src, dest);
+  console.log(`[+] Installed: ${label}`);
+}
+
+// ── Context profiles ─────────────────────────────────────────────
+console.log("Installing context profiles...");
+for (const name of ["dev.md", "orchestrate.md", "review.md", "research.md"]) {
+  safeCopy(
+    path.join(SCRIPT_DIR, "contexts", name),
+    path.join(CLAUDE_HOME, "contexts", name),
+    `contexts/${name}`
+  );
+}
+
+// ── Reference doc ────────────────────────────────────────────────
+console.log("\nInstalling orchestration reference...");
+safeCopy(
+  path.join(SCRIPT_DIR, "reference", "ORCHESTRATION-REFERENCE.md"),
+  path.join(CLAUDE_HOME, "contexts", "ORCHESTRATION-REFERENCE.md"),
+  "reference/ORCHESTRATION-REFERENCE.md"
+);
+
+// ── Automation scripts ───────────────────────────────────────────
+console.log("\nInstalling automation scripts...");
+const binDir = path.join(SCRIPT_DIR, "bin");
+for (const file of fs.readdirSync(binDir)) {
+  if (file.endsWith(".sh")) {
+    safeCopy(
+      path.join(binDir, file),
+      path.join(CLAUDE_HOME, "bin", file),
+      `bin/${file}`
+    );
+    if (!DRY_RUN) {
+      try {
+        fs.chmodSync(path.join(CLAUDE_HOME, "bin", file), 0o755);
+      } catch {
+        // chmod may not work on Windows — that's fine
+      }
+    }
+  }
+}
+
+// ── Instincts ────────────────────────────────────────────────────
+console.log("\nInstalling learned instincts...");
+const instinctDest = path.join(
+  CLAUDE_HOME,
+  "homunculus",
+  "instincts",
+  "personal"
+);
+
+if (!DRY_RUN) {
+  for (const dir of [
+    instinctDest,
+    path.join(CLAUDE_HOME, "homunculus", "instincts", "inherited"),
+    path.join(CLAUDE_HOME, "homunculus", "evolved", "agents"),
+    path.join(CLAUDE_HOME, "homunculus", "evolved", "skills"),
+    path.join(CLAUDE_HOME, "homunculus", "evolved", "commands"),
+    path.join(CLAUDE_HOME, "session-data"),
+    path.join(CLAUDE_HOME, "plans"),
+  ]) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+const instinctsDir = path.join(SCRIPT_DIR, "instincts");
+for (const file of fs.readdirSync(instinctsDir)) {
+  if (file.endsWith(".md")) {
+    safeCopy(
+      path.join(instinctsDir, file),
+      path.join(instinctDest, file),
+      `instincts/${file}`
+    );
+  }
+}
+
+// ── Merge env settings ───────────────────────────────────────────
+console.log("\nConfiguring settings.json...");
+const settingsFile = path.join(CLAUDE_HOME, "settings.json");
+const envFile = path.join(SCRIPT_DIR, "config", "env-settings.json");
+
+if (!DRY_RUN && fs.existsSync(settingsFile) && fs.existsSync(envFile)) {
+  try {
+    const settings = JSON.parse(fs.readFileSync(settingsFile, "utf8"));
+    const newEnv = JSON.parse(fs.readFileSync(envFile, "utf8"));
+
+    if (!settings.env) settings.env = {};
+
+    let added = 0;
+    for (const [key, value] of Object.entries(newEnv)) {
+      if (!(key in settings.env)) {
+        settings.env[key] = value;
+        added++;
+        console.log(`[+] Added env: ${key}=${value}`);
+      } else {
+        console.log(`[i] Skip env (exists): ${key}=${settings.env[key]}`);
+      }
+    }
+
+    if (added > 0) {
+      fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + "\n");
+    }
+  } catch (err) {
+    console.log(`[!] Could not merge env settings: ${err.message}`);
+  }
+} else if (DRY_RUN) {
+  console.log(
+    "[i] WOULD MERGE: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS, ECC_HOOK_PROFILE, CLAUDE_CODE_ENABLE_COST_TRACKING"
+  );
+}
+
+// ── Observer config ──────────────────────────────────────────────
+console.log("\nConfiguring continuous learning observer...");
+const observerSrc = path.join(SCRIPT_DIR, "config", "observer-config.json");
+const clv2Config = path.join(
+  CLAUDE_HOME,
+  "skills",
+  "continuous-learning-v2",
+  "config.json"
+);
+
+if (fs.existsSync(clv2Config)) {
+  if (DRY_RUN) {
+    console.log(`[i] WOULD UPDATE: ${clv2Config} (observer.enabled=true)`);
+  } else {
+    fs.copyFileSync(observerSrc, clv2Config);
+    console.log("[+] Observer enabled");
+  }
+} else {
+  console.log("[!] CLv2 config not found — install ECC first for observer");
+}
+
+// ── Write marker ─────────────────────────────────────────────────
+if (!DRY_RUN) {
+  const marker = {
+    version: VERSION,
+    installed_at: new Date().toISOString(),
+    platform: process.platform,
+    installer: "npm",
+    components: [
+      "contexts",
+      "bin-scripts",
+      "instincts",
+      "env-settings",
+      "observer-config",
+      "reference-doc",
+    ],
+  };
+  fs.writeFileSync(
+    path.join(CLAUDE_HOME, ".claude-power-setup-installed"),
+    JSON.stringify(marker, null, 2) + "\n"
+  );
+}
+
+// ── Summary ──────────────────────────────────────────────────────
+console.log(`
+  Installation Complete
+
+  Next steps:
+    1. source ~/.claude/bin/claude-aliases.sh  (or restart terminal)
+    2. Open a project and run: claude
+    3. Try: 'Please use a team of specialists for this'
+
+  Reference: ~/.claude/contexts/ORCHESTRATION-REFERENCE.md
+`);

package/config/env-settings.json

@@ -0,0 +1,5 @@
+{
+  "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+  "ECC_HOOK_PROFILE": "standard",
+  "CLAUDE_CODE_ENABLE_COST_TRACKING": "1"
+}

package/config/observer-config.json

@@ -0,0 +1,8 @@
+{
+  "version": "2.1",
+  "observer": {
+    "enabled": true,
+    "run_interval_minutes": 5,
+    "min_observations_to_analyze": 20
+  }
+}

package/contexts/dev.md

@@ -0,0 +1,23 @@
+# Development Mode
+
+You are in focused development mode. Priorities:
+
+1. **Plan before coding** - Use /plan for non-trivial tasks, get confirmation before writing code
+2. **TDD workflow** - Write failing tests first, then implement, then verify
+3. **De-sloppify** - After implementation, do a cleanup pass removing test slop, console.logs, dead code
+4. **Strategic compaction** - /compact after exploration phase, before implementation phase
+5. **Commit atomically** - Small, focused conventional commits with clear messages
+
+## Model Routing
+- Exploration/search: delegate to Haiku subagents
+- Implementation: use current model (Sonnet for routine, Opus for complex)
+- Security review: always Opus
+
+## Memory
+- Check ~/.claude/session-data/ for previous session state on this project
+- Before ending, run /save-session to persist progress
+- Use /learn to extract reusable patterns
+
+## Quality Gates
+- Run build + lint + tests before every commit
+- Use /verify for comprehensive checks before PR

package/contexts/orchestrate.md

@@ -0,0 +1,31 @@
+# Orchestration Mode
+
+You are the team lead in a multi-agent orchestration session. Your job is to PLAN, DELEGATE, and SYNTHESIZE - not write code yourself.
+
+## Agent Teams Protocol
+1. Decompose the task into independent work units with dependency DAG
+2. Assign each unit a complexity tier: trivial, small, medium, large
+3. Spawn specialist teammates for parallel execution
+4. Monitor progress via shared task board
+5. Synthesize results and resolve conflicts
+
+## Teammate Specializations
+- **architect**: System design, API contracts, data models
+- **backend**: Server logic, database, API implementation
+- **frontend**: UI components, state management, styling
+- **tester**: Unit tests, integration tests, E2E tests
+- **reviewer**: Code review, security audit, quality checks
+- **docs**: Documentation, API docs, README updates
+
+## Quality Pipeline Per Unit
+- trivial: implement -> test
+- small: implement -> test -> review
+- medium: research -> plan -> implement -> test -> review
+- large: research -> plan -> implement -> test -> review -> final-review
+
+## Rules
+- Max 5 teammates active at once
+- Each teammate works in isolated git worktree
+- Reviewer must NOT be the same agent that implemented
+- Use SHARED_TASK_NOTES.md for cross-iteration context
+- Never merge without tests passing

package/contexts/research.md

@@ -0,0 +1,25 @@
+# Research Mode
+
+You are in research and exploration mode. DO NOT write code unless explicitly asked.
+
+## Priorities
+1. Understand before suggesting
+2. Read the full codebase architecture before proposing changes
+3. Use iterative retrieval: broad search -> evaluate -> refine -> repeat (max 3 cycles)
+4. Document findings in structured files for later use
+
+## Tools
+- Use read-only tools only: Read, Grep, Glob, WebSearch, WebFetch
+- Save findings to .claude/plans/ or .claude/research/
+- Use /aside for quick side questions without losing context
+
+## Output Format
+For each finding:
+- **Source**: File path, URL, or documentation reference
+- **Relevance**: High/Medium/Low with explanation
+- **Implications**: How this affects the current task
+- **Gaps**: What we still don't know
+
+## Memory
+- Save research output to files for cross-session persistence
+- Use /learn to extract patterns discovered during research

package/contexts/review.md

@@ -0,0 +1,23 @@
+# Review Mode
+
+You are in code review mode. Focus on finding real issues, not style nitpicks.
+
+## Review Priorities (in order)
+1. **Security** - Injection, XSS, auth bypass, secrets in code, OWASP Top 10
+2. **Correctness** - Logic bugs, edge cases, race conditions, error handling
+3. **Data integrity** - Migration safety, transaction boundaries, constraint enforcement
+4. **Performance** - N+1 queries, unbounded iterations, memory leaks, missing indexes
+5. **Maintainability** - Only if something is genuinely confusing
+
+## Tools
+- Use /santa-loop for adversarial dual-model review (Claude + Codex/Gemini)
+- Use /code-review for standard review
+- Spawn parallel reviewer agents for different perspectives (security, performance, architecture)
+
+## Output Format
+For each issue:
+- **Severity**: critical / high / medium / low
+- **File:Line**: Exact location
+- **Issue**: What's wrong
+- **Fix**: Specific suggestion
+- **Evidence**: Why this matters (CVE, benchmark, etc.)

package/install.ps1

@@ -0,0 +1,178 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+    Claude Power Setup — Windows PowerShell Installer
+.DESCRIPTION
+    Installs multi-agent orchestration, automation scripts, and self-improvement
+    tools for Claude Code. Layers on top of ECC (Everything Claude Code).
+
+    If bash is available (Git Bash, WSL, MSYS2), delegates to install.sh.
+    Otherwise, performs native PowerShell file copies.
+.PARAMETER DryRun
+    Show what would be installed without writing files.
+.PARAMETER Force
+    Overwrite existing files instead of skipping.
+.PARAMETER SkipShell
+    Don't modify shell profile.
+.PARAMETER SkipECC
+    Don't check for ECC installation.
+.EXAMPLE
+    powershell -ExecutionPolicy Bypass -File install.ps1
+.EXAMPLE
+    powershell -ExecutionPolicy Bypass -File install.ps1 -DryRun
+#>
+param(
+    [switch]$DryRun,
+    [switch]$Force,
+    [switch]$SkipShell,
+    [switch]$SkipECC,
+    [switch]$Help
+)
+
+$Version = "1.0.0"
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition
+$ClaudeHome = Join-Path $env:USERPROFILE ".claude"
+
+if ($Help) {
+    Get-Help $MyInvocation.MyCommand.Definition -Detailed
+    exit 0
+}
+
+# ── Try to delegate to bash ────────────────────────────────────
+$BashPaths = @(
+    "C:\Program Files\Git\bin\bash.exe",
+    "C:\Program Files (x86)\Git\bin\bash.exe",
+    (Get-Command bash -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Source -ErrorAction SilentlyContinue)
+) | Where-Object { $_ -and (Test-Path $_ -ErrorAction SilentlyContinue) }
+
+if ($BashPaths.Count -gt 0) {
+    $BashExe = $BashPaths[0]
+    Write-Host "[i] Found bash at: $BashExe" -ForegroundColor Cyan
+    Write-Host "[i] Delegating to install.sh..." -ForegroundColor Cyan
+
+    $Args = @()
+    if ($DryRun)    { $Args += "--dry-run" }
+    if ($Force)     { $Args += "--force" }
+    if ($SkipShell) { $Args += "--skip-shell" }
+    if ($SkipECC)   { $Args += "--skip-ecc" }
+
+    $InstallScript = Join-Path $ScriptDir "install.sh"
+    & $BashExe $InstallScript @Args
+    exit $LASTEXITCODE
+}
+
+# ── Native PowerShell fallback ─────────────────────────────────
+Write-Host ""
+Write-Host "  Claude Power Setup v$Version" -ForegroundColor White
+Write-Host "  Multi-agent orchestration + self-improvement" -ForegroundColor Gray
+Write-Host "  (PowerShell native mode — bash not found)" -ForegroundColor Yellow
+Write-Host ""
+
+if ($DryRun) {
+    Write-Host "[!] DRY RUN - no files will be written" -ForegroundColor Yellow
+    Write-Host ""
+}
+
+function Safe-Copy {
+    param([string]$Source, [string]$Dest, [string]$Label)
+
+    if ($DryRun) {
+        if ((Test-Path $Dest) -and -not $Force) {
+            Write-Host "[i] SKIP (exists): $Label" -ForegroundColor Cyan
+        } else {
+            Write-Host "[i] WOULD COPY: $Label -> $Dest" -ForegroundColor Cyan
+        }
+        return
+    }
+
+    $DestDir = Split-Path -Parent $Dest
+    if (-not (Test-Path $DestDir)) {
+        New-Item -ItemType Directory -Path $DestDir -Force | Out-Null
+    }
+
+    if ((Test-Path $Dest) -and -not $Force) {
+        Write-Host "[i] Skip (exists): $Label" -ForegroundColor Cyan
+        return
+    }
+
+    Copy-Item -Path $Source -Destination $Dest -Force
+    Write-Host "[+] Installed: $Label" -ForegroundColor Green
+}
+
+# ── Install files ──────────────────────────────────────────────
+Write-Host "Installing context profiles..." -ForegroundColor White
+@("dev.md", "orchestrate.md", "review.md", "research.md") | ForEach-Object {
+    Safe-Copy (Join-Path $ScriptDir "contexts\$_") (Join-Path $ClaudeHome "contexts\$_") "contexts\$_"
+}
+
+Write-Host "`nInstalling orchestration reference..." -ForegroundColor White
+Safe-Copy (Join-Path $ScriptDir "reference\ORCHESTRATION-REFERENCE.md") `
+          (Join-Path $ClaudeHome "contexts\ORCHESTRATION-REFERENCE.md") `
+          "reference\ORCHESTRATION-REFERENCE.md"
+
+Write-Host "`nInstalling automation scripts..." -ForegroundColor White
+Get-ChildItem (Join-Path $ScriptDir "bin\*.sh") | ForEach-Object {
+    Safe-Copy $_.FullName (Join-Path $ClaudeHome "bin\$($_.Name)") "bin\$($_.Name)"
+}
+
+Write-Host "`nInstalling learned instincts..." -ForegroundColor White
+$InstinctDir = Join-Path $ClaudeHome "homunculus\instincts\personal"
+if (-not $DryRun) {
+    @(
+        $InstinctDir,
+        (Join-Path $ClaudeHome "homunculus\instincts\inherited"),
+        (Join-Path $ClaudeHome "homunculus\evolved\agents"),
+        (Join-Path $ClaudeHome "homunculus\evolved\skills"),
+        (Join-Path $ClaudeHome "homunculus\evolved\commands"),
+        (Join-Path $ClaudeHome "session-data"),
+        (Join-Path $ClaudeHome "plans")
+    ) | ForEach-Object {
+        if (-not (Test-Path $_)) { New-Item -ItemType Directory -Path $_ -Force | Out-Null }
+    }
+}
+Get-ChildItem (Join-Path $ScriptDir "instincts\*.md") | ForEach-Object {
+    Safe-Copy $_.FullName (Join-Path $InstinctDir $_.Name) "instincts\$($_.Name)"
+}
+
+# ── Merge env settings ────────────────────────────────────────
+Write-Host "`nConfiguring settings.json..." -ForegroundColor White
+$SettingsFile = Join-Path $ClaudeHome "settings.json"
+$EnvFile = Join-Path $ScriptDir "config\env-settings.json"
+
+if (-not $DryRun -and (Test-Path $SettingsFile) -and (Test-Path $EnvFile)) {
+    try {
+        $Settings = Get-Content $SettingsFile -Raw | ConvertFrom-Json
+        $NewEnv = Get-Content $EnvFile -Raw | ConvertFrom-Json
+
+        if (-not $Settings.env) {
+            $Settings | Add-Member -Type NoteProperty -Name "env" -Value ([PSCustomObject]@{})
+        }
+
+        $NewEnv.PSObject.Properties | ForEach-Object {
+            if (-not $Settings.env.PSObject.Properties[$_.Name]) {
+                $Settings.env | Add-Member -Type NoteProperty -Name $_.Name -Value $_.Value
+                Write-Host "[+] Added env: $($_.Name)=$($_.Value)" -ForegroundColor Green
+            } else {
+                Write-Host "[i] Skip env (exists): $($_.Name)" -ForegroundColor Cyan
+            }
+        }
+
+        $Settings | ConvertTo-Json -Depth 10 | Set-Content $SettingsFile -Encoding UTF8
+    } catch {
+        Write-Host "[!] Could not merge env settings: $_" -ForegroundColor Yellow
+    }
+} elseif ($DryRun) {
+    Write-Host "[i] WOULD MERGE: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS, ECC_HOOK_PROFILE, CLAUDE_CODE_ENABLE_COST_TRACKING" -ForegroundColor Cyan
+}
+
+# ── Summary ───────────────────────────────────────────────────
+Write-Host ""
+Write-Host "  Installation Complete" -ForegroundColor Green
+Write-Host ""
+Write-Host "  Next steps:" -ForegroundColor White
+Write-Host "    1. Open Git Bash and run: source ~/.claude/bin/claude-aliases.sh"
+Write-Host "    2. Open a project and run: claude"
+Write-Host "    3. Try: 'Please use a team of specialists for this'"
+Write-Host ""
+Write-Host "  Reference: ~/.claude/contexts/ORCHESTRATION-REFERENCE.md"
+Write-Host ""