golem-cc 3.0.0 → 3.0.2

package/.golem/lib/build.mjs

@@ -194,10 +194,16 @@ function gitOpts() {
 }
 
 export function gitSnapshot() {
-  return execSync('git rev-parse HEAD', gitOpts()).toString().trim();
+  try {
+    return execSync('git rev-parse HEAD', gitOpts()).toString().trim();
+  } catch {
+    // No commits yet (empty repo) — nothing to snapshot
+    return null;
+  }
 }
 
 export function gitRestore(sha) {
+  if (!sha) return;
   execSync('git checkout .', gitOpts());
   execSync('git clean -fd', gitOpts());
   execSync(`git reset --hard ${sha}`, gitOpts());

package/README.md

@@ -6,12 +6,31 @@ Golem provides structured workflows for speccing, planning, building, reviewing,
 
 ## Installation
 
+### Global install (recommended)
+
+Install once per machine to get the `golem` command everywhere:
+
+```bash
+pnpm install -g golem-cc
+```
+
+Then in any golem project you can run `golem build`, `golem status`, etc. directly.
+
+To update:
+
+```bash
+pnpm install -g golem-cc@latest
+```
+
+### Project setup
+
+Run once per project to scaffold `.golem/` and slash commands:
+
 ```bash
-# Install into an existing project
 pnpm dlx golem-cc
 
 # Or with npx
-npx golem-cc
+golem-cc
 ```
 
 This copies `.golem/` and `.claude/commands/golem/` into your project, detects your framework (Nuxt/Next), and generates `AGENTS.md` with your test/build/lint commands.
@@ -19,7 +38,7 @@ This copies `.golem/` and `.claude/commands/golem/` into your project, detects y
 After installing, configure for your project:
 
 ```bash
-npx golem init
+golem init
 ```
 
 ## Prerequisites
@@ -41,7 +60,7 @@ The typical golem workflow:
 ```
 1. /golem:spec     →  Build specs through guided conversation
 2. /golem:plan     →  Generate staged implementation plan
-3. npx golem build →  Autonomous build loop with TUI
+3. golem build     →  Autonomous build loop with TUI
 4. /golem:review   →  Parallel code review (6 agents)
 5. /golem:security →  Security scan before shipping
 ```
@@ -68,16 +87,16 @@ Reads all specs, analyzes the codebase, and generates `.golem/IMPLEMENTATION_PLA
 
 ```bash
 # Full autonomous build loop with TUI
-npx golem build
+golem build
 
 # Limit to N iterations
-npx golem build --iterations 3
+golem build --iterations 3
 
 # Preview next task without executing
-npx golem build --dry-run
+golem build --dry-run
 
 # Skip simplification pass
-npx golem build --no-simplify
+golem build --no-simplify
 ```
 
 The build loop reads the implementation plan, finds the next incomplete task, spawns Claude with a focused prompt, streams output through a full-screen TUI with progress bar and usage sparklines, then commits on success.
@@ -94,21 +113,21 @@ Spawns 6 parallel review agents (security, logic, style, tests, architecture, de
 
 ```bash
 # Default scan (gitleaks + semgrep + pnpm audit + env checks)
-npx golem security
+golem security
 
 # Full scan (adds git history, trivy, outdated deps, file perms, headers)
-npx golem security --full
+golem security --full
 
 # Auto-install missing security tools
-npx golem security --fix
+golem security --fix
 
 # Install pre-commit hook for gitleaks
-npx golem security --pre-commit
+golem security --pre-commit
 ```
 
 ## Commands
 
-### Terminal (npx golem)
+### Terminal
 
 | Command | Description |
 |---------|-------------|
@@ -156,8 +175,8 @@ Configuration lives in `.golem/config.json`:
 | `simplifyOnBuild` | `true` | Run simplifier after building |
 
 ```bash
-npx golem config set model sonnet
-npx golem config set autoCommit false
+golem config set model sonnet
+golem config set autoCommit false
 ```
 
 ## Project Structure
@@ -192,17 +211,17 @@ npx golem config set autoCommit false
 Run the doctor to check your setup:
 
 ```bash
-npx golem doctor
+golem doctor
 
 # Auto-fix common issues
-npx golem doctor --fix
+golem doctor --fix
 ```
 
 Common issues:
 - **Claude CLI not found** — Install from https://docs.anthropic.com/en/docs/claude-code
 - **No implementation plan** — Run `/golem:plan` in Claude Code first
 - **Empty specs directory** — Run `/golem:spec` in Claude Code first
-- **Security tools missing** — Run `npx golem security --fix` to auto-install
+- **Security tools missing** — Run `golem security --fix` to auto-install
 
 ## License
 

package/bin/golem-shim.mjs

@@ -1,36 +1,36 @@
 #!/usr/bin/env node
 import { existsSync } from 'node:fs';
 import { join, dirname } from 'node:path';
-import { execFileSync } from 'node:child_process';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
 
 // Walk up from cwd to find .golem/bin/golem.mjs
 function findGolemProject(startDir) {
   let currentDir = startDir;
   while (true) {
-    const golemPath = join(currentDir, '.golem', 'bin', 'golem.mjs');
-    if (existsSync(golemPath)) {
-      return { projectRoot: currentDir, golemPath };
+    if (existsSync(join(currentDir, '.golem', 'bin', 'golem.mjs'))) {
+      return currentDir;
     }
     if (currentDir === '/') return null;
     currentDir = dirname(currentDir);
   }
 }
 
-const result = findGolemProject(process.cwd());
+const projectRoot = findGolemProject(process.cwd());
 
-if (!result) {
+if (!projectRoot) {
   console.error('No golem project found. Run `pnpm dlx golem-cc` to set one up.');
   process.exit(1);
 }
 
-const { projectRoot, golemPath } = result;
-
 if (process.env.GOLEM_DEBUG === '1') {
   console.log(`[golem-shim] Resolved project root: ${projectRoot}`);
 }
 
-try {
-  execFileSync('node', [golemPath, ...process.argv.slice(2)], { stdio: 'inherit' });
-} catch (error) {
-  process.exit(error.status ?? 1);
-}
+// chdir to project root so the CLI resolves config/plans/specs correctly
+process.chdir(projectRoot);
+
+// Import the CLI from our own package so dependencies (commander, chalk, ora)
+// resolve from the global install's node_modules, not the project's.
+await import(pathToFileURL(join(__dirname, '..', '.golem', 'bin', 'golem.mjs')).href);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "golem-cc",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "Project-scoped autonomous coding agent framework for Claude Code CLI",
   "type": "module",
   "bin": {