golem-cc 1.0.2 → 2.0.0

package/README.md

@@ -5,21 +5,33 @@ Personal agentic workflow manager. Integrates Freshservice tickets, Gitea issues
 ## Installation
 
 ```bash
-# Install globally via npm
-npm install -g golem-cc
-
-# Or run directly with pnpm
+# Bootstrap (one command)
 pnpm dlx golem-cc
 ```
 
-After installing, run the setup:
+This copies everything to `~/.golem/`, links binaries to `~/.local/bin/`, and wires up Claude slash-commands.
+
+After installing, restart your shell and configure:
 
 ```bash
-# Check your installation
+# Verify setup
 golem doctor
 
-# Configure credentials
+# Edit credentials
 vim ~/.golem/.env
+
+# Initialize a project
+cd your-project && golem init
+```
+
+### Updating
+
+```bash
+# From a running install
+golem install
+
+# Or from a local checkout (dev workflow)
+golem install --from /path/to/golem-cc
 ```
 
 ## Architecture

package/bin/golem

@@ -8,7 +8,7 @@
 
 set -euo pipefail
 
-VERSION="0.1.0"
+VERSION="2.0.0"
 GOLEM_HOME="${GOLEM_HOME:-$HOME/.golem}"
 GOLEM_API="golem-api"
 
@@ -124,6 +124,7 @@ SYNC COMMANDS:
 
 OTHER:
     install               Install/update golem globally
+    uninstall             Remove golem completely
     config                Show current configuration
     doctor                Diagnose setup issues
     init                  Initialize golem in current project
@@ -148,7 +149,15 @@ cmd_version() {
 
 cmd_init() {
   print_banner
-  info "Initializing golem..."
+
+  # Validate global installation
+  if [[ ! -d "$GOLEM_HOME/lib" ]]; then
+    warn "Golem is not installed globally."
+    echo "  Run: pnpm dlx golem-cc"
+    echo ""
+  fi
+
+  info "Initializing golem in current project..."
 
   mkdir -p .golem/{specs,tickets,worktrees}
 
@@ -184,6 +193,8 @@ EOF
   if [[ -d "$GOLEM_HOME/commands/golem" ]]; then
     ln -sf "$GOLEM_HOME/commands/golem" .claude/commands/golem 2>/dev/null || true
     success "Linked Claude commands"
+  else
+    warn "Claude commands not found (install golem globally first)"
   fi
 
   # Add .golem to .gitignore
@@ -507,68 +518,175 @@ Branch: $branch" \
   success "PR created"
 }
 
-cmd_install() {
-  print_banner
-  info "Installing/updating golem..."
-
-  local src_dir="$GOLEM_HOME/src"
+# Resolve the package root from this script's location.
+# When run via pnpm dlx, $0 lives inside a temp store.
+# When run from ~/.golem/lib, $0 is there.
+_resolve_pkg_root() {
+  local script_path
+  script_path="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  # bin/ is one level under package root
+  echo "$(cd "$script_path/.." && pwd)"
+}
 
-  # Clone or update
-  if [[ -d "$src_dir/.git" ]]; then
-    info "Updating existing installation..."
-    git -C "$src_dir" pull --ff-only || die "Failed to update. Try: rm -rf $src_dir"
-  else
-    info "Cloning golem..."
-    mkdir -p "$GOLEM_HOME"
-    git clone https://github.com/daresTheDevil/golem.git "$src_dir" || die "Failed to clone"
-  fi
+# Bootstrap: copy package contents into ~/.golem/lib and wire everything up.
+cmd_bootstrap() {
+  local pkg_root
+  pkg_root="$(_resolve_pkg_root)"
 
-  # Build
-  info "Building..."
-  cd "$src_dir"
-  pnpm install --silent || die "pnpm install failed"
-  pnpm build || die "Build failed"
+  print_banner
+  info "Installing golem to $GOLEM_HOME..."
+
+  # ---- runtime ----
+  mkdir -p "$GOLEM_HOME/lib"
+  # Copy the package runtime (bin, dist, node_modules, package.json)
+  for item in bin dist node_modules package.json; do
+    if [[ -e "$pkg_root/$item" ]]; then
+      rm -rf "$GOLEM_HOME/lib/$item"
+      cp -R "$pkg_root/$item" "$GOLEM_HOME/lib/$item"
+    fi
+  done
+  success "Installed runtime to $GOLEM_HOME/lib"
 
-  # Copy assets
-  info "Installing assets..."
+  # ---- assets ----
   mkdir -p "$GOLEM_HOME"/{commands,agents,prompts}
-  cp -r "$src_dir/commands/golem" "$GOLEM_HOME/commands/"
-  cp "$src_dir/golem/agents/"*.md "$GOLEM_HOME/agents/"
-  cp "$src_dir/golem/prompts/"*.md "$GOLEM_HOME/prompts/"
+  if [[ -d "$pkg_root/commands/golem" ]]; then
+    rm -rf "$GOLEM_HOME/commands/golem"
+    cp -R "$pkg_root/commands/golem" "$GOLEM_HOME/commands/golem"
+  fi
+  if compgen -G "$pkg_root/golem/agents/"*.md &>/dev/null; then
+    cp "$pkg_root/golem/agents/"*.md "$GOLEM_HOME/agents/"
+  fi
+  if compgen -G "$pkg_root/golem/prompts/"*.md &>/dev/null; then
+    cp "$pkg_root/golem/prompts/"*.md "$GOLEM_HOME/prompts/"
+  fi
+  success "Installed assets (commands, agents, prompts)"
 
-  # Link binaries
+  # ---- symlinks in ~/.local/bin ----
   mkdir -p "$HOME/.local/bin"
-  ln -sf "$src_dir/bin/golem" "$HOME/.local/bin/golem"
-  ln -sf "$src_dir/dist/cli/index.js" "$HOME/.local/bin/golem-api"
-  chmod +x "$src_dir/dist/cli/index.js"
+  ln -sf "$GOLEM_HOME/lib/bin/golem" "$HOME/.local/bin/golem"
+  ln -sf "$GOLEM_HOME/lib/dist/cli/index.js" "$HOME/.local/bin/golem-api"
+  chmod +x "$GOLEM_HOME/lib/bin/golem"
+  chmod +x "$GOLEM_HOME/lib/dist/cli/index.js" 2>/dev/null || true
+  success "Linked binaries to ~/.local/bin"
 
-  # Link Claude commands
+  # ---- Claude slash-commands ----
   mkdir -p "$HOME/.claude/commands"
   ln -sf "$GOLEM_HOME/commands/golem" "$HOME/.claude/commands/golem" 2>/dev/null || true
+  success "Linked Claude commands"
 
-  # Create env template if needed
+  # ---- .env template ----
+  if [[ -f "$pkg_root/.env.example" ]]; then
+    cp "$pkg_root/.env.example" "$GOLEM_HOME/.env.example"
+  fi
   if [[ ! -f "$GOLEM_HOME/.env" ]]; then
-    cat > "$GOLEM_HOME/.env" << 'ENVEOF'
-# Freshservice
+    if [[ -f "$GOLEM_HOME/.env.example" ]]; then
+      cp "$GOLEM_HOME/.env.example" "$GOLEM_HOME/.env"
+    else
+      cat > "$GOLEM_HOME/.env" << 'ENVEOF'
+# Freshworks/Freshservice
 FRESH_DOMAIN=yourcompany.freshservice.com
-FRESH_API_KEY=your_api_key
+FRESH_API_KEY=your_api_key_here
+
+# Gitea (on-prem)
+GITEA_URL=https://dev.pearlriverresort.com
+GITEA_TOKEN=your_token_here
+GITEA_ORG=CRDE
 
-# Gitea
-GITEA_URL=https://gitea.example.com
-GITEA_TOKEN=your_token
-GITEA_ORG=your-org
-GITEA_REPO=default-repo
+# Default repo for issues (can be overridden per-project)
+GITEA_REPO=
 ENVEOF
-    warn "Created $GOLEM_HOME/.env - edit with your credentials"
+    fi
+    warn "Created $GOLEM_HOME/.env — edit with your credentials"
+  fi
+
+  # ---- PATH setup (idempotent) ----
+  local shell_rc="$HOME/.zshrc"
+  [[ -f "$HOME/.bashrc" && ! -f "$HOME/.zshrc" ]] && shell_rc="$HOME/.bashrc"
+
+  if [[ -f "$shell_rc" ]]; then
+    if ! grep -q '$HOME/.local/bin' "$shell_rc" 2>/dev/null; then
+      echo '' >> "$shell_rc"
+      echo '# golem: add ~/.local/bin to PATH' >> "$shell_rc"
+      echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$shell_rc"
+      success "Added ~/.local/bin to PATH in $(basename "$shell_rc")"
+    fi
   fi
 
   echo ""
   success "Installation complete!"
   echo ""
-  echo "Make sure ~/.local/bin is in your PATH:"
-  echo '  export PATH="$HOME/.local/bin:$PATH"'
+  echo "Restart your shell (or run: source $shell_rc), then:"
+  echo "  golem doctor     # verify setup"
+  echo "  golem config     # show configuration"
+  echo "  cd <project> && golem init   # set up a project"
+}
+
+cmd_uninstall() {
+  print_banner
+  echo -e "${BOLD}This will remove:${NC}"
+  echo "  $GOLEM_HOME              (runtime, assets, config)"
+  echo "  ~/.local/bin/golem       (symlink)"
+  echo "  ~/.local/bin/golem-api   (symlink)"
+  echo "  ~/.claude/commands/golem (symlink)"
   echo ""
-  echo "Then run: golem doctor"
+
+  # Check for .env with real credentials and warn
+  if [[ -f "$GOLEM_HOME/.env" ]]; then
+    warn "Your credentials in $GOLEM_HOME/.env will be deleted."
+    echo "  Back up now if needed: cp $GOLEM_HOME/.env ~/golem-env-backup"
+    echo ""
+  fi
+
+  read -p "Are you sure? [y/N] " confirm
+  [[ "$confirm" != "y" && "$confirm" != "Y" ]] && { echo "Aborted."; exit 0; }
+
+  # Remove symlinks in ~/.local/bin
+  for bin in golem golem-api; do
+    local target="$HOME/.local/bin/$bin"
+    if [[ -L "$target" || -f "$target" ]]; then
+      rm -f "$target"
+      success "Removed $target"
+    fi
+  done
+
+  # Remove Claude commands symlink
+  if [[ -L "$HOME/.claude/commands/golem" || -d "$HOME/.claude/commands/golem" ]]; then
+    rm -rf "$HOME/.claude/commands/golem"
+    success "Removed ~/.claude/commands/golem"
+  fi
+
+  # Remove ~/.golem entirely
+  if [[ -d "$GOLEM_HOME" ]]; then
+    rm -rf "$GOLEM_HOME"
+    success "Removed $GOLEM_HOME"
+  fi
+
+  echo ""
+  success "Golem uninstalled."
+  echo ""
+  dim "The PATH entry in your shell rc was left in place (it's harmless)."
+  dim "To reinstall later: pnpm dlx golem-cc"
+}
+
+cmd_install() {
+  # If --from <path> given, bootstrap from a local checkout (dev workflow)
+  if [[ "${1:-}" == "--from" ]]; then
+    local local_path="${2:-}"
+    [[ -z "$local_path" ]] && die "Usage: golem install --from <path>"
+    [[ ! -d "$local_path/bin" ]] && die "Not a golem package directory: $local_path"
+
+    # Temporarily override _resolve_pkg_root
+    _resolve_pkg_root() { echo "$local_path"; }
+    cmd_bootstrap
+    return
+  fi
+
+  print_banner
+  info "Updating golem via pnpm dlx..."
+  echo ""
+
+  # Re-run pnpm dlx golem-cc which will hit the bootstrap path
+  pnpm dlx golem-cc || die "Update failed"
 }
 
 cmd_config() {
@@ -715,7 +833,7 @@ cmd_doctor() {
   if command -v golem-api &>/dev/null; then
     check_pass "golem-api accessible"
   else
-    check_fail "golem-api not found" "Run: ./bin/install.sh in golem directory"
+    check_fail "golem-api not found" "Run: pnpm dlx golem-cc"
   fi
 
   echo ""
@@ -723,24 +841,30 @@ cmd_doctor() {
   # Installation checks
   echo -e "${BOLD}Installation${NC}"
 
+  if [[ -d "$GOLEM_HOME/lib" ]]; then
+    check_pass "Runtime installed ($GOLEM_HOME/lib)"
+  else
+    check_fail "Runtime not installed" "Run: pnpm dlx golem-cc"
+  fi
+
   local prompt_count=$(ls "$GOLEM_HOME/prompts/"*.md 2>/dev/null | wc -l | tr -d ' ')
   if [[ "$prompt_count" -gt 0 ]]; then
     check_pass "Prompts installed ($prompt_count files)"
   else
-    check_fail "No prompts installed" "Run: ./bin/install.sh"
+    check_fail "No prompts installed" "Run: pnpm dlx golem-cc"
   fi
 
   local agent_count=$(ls "$GOLEM_HOME/agents/"*.md 2>/dev/null | wc -l | tr -d ' ')
   if [[ "$agent_count" -gt 0 ]]; then
     check_pass "Agents installed ($agent_count files)"
   else
-    check_fail "No agents installed" "Run: ./bin/install.sh"
+    check_fail "No agents installed" "Run: pnpm dlx golem-cc"
   fi
 
   if [[ -d "$GOLEM_HOME/commands/golem" ]]; then
     check_pass "Commands installed"
   else
-    check_fail "Commands not installed" "Run: ./bin/install.sh"
+    check_fail "Commands not installed" "Run: pnpm dlx golem-cc"
   fi
 
   if [[ -L "$HOME/.claude/commands/golem" ]] && [[ -d "$HOME/.claude/commands/golem" ]]; then
@@ -786,9 +910,19 @@ cmd_doctor() {
 # ============================================================================
 
 main() {
-  local cmd="${1:-help}"
+  local cmd="${1:-}"
   shift || true
 
+  # No args: bootstrap if not installed, otherwise show help
+  if [[ -z "$cmd" ]]; then
+    if [[ -d "$GOLEM_HOME/lib" ]]; then
+      cmd_help
+    else
+      cmd_bootstrap
+    fi
+    return
+  fi
+
   case "$cmd" in
     help|--help|-h)
       cmd_help
@@ -844,6 +978,9 @@ main() {
     install)
       cmd_install "$@"
       ;;
+    uninstall)
+      cmd_uninstall "$@"
+      ;;
     *)
       die "Unknown command: $cmd. Run 'golem help' for usage."
       ;;

package/package.json

@@ -1,13 +1,22 @@
 {
   "name": "golem-cc",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "description": "Personal agentic workflow: Freshworks ↔ Gitea ↔ Local development",
   "repository": {
     "type": "git",
     "url": "https://github.com/daresTheDevil/golem"
   },
   "type": "module",
+  "files": [
+    "bin/",
+    "dist/",
+    "commands/",
+    "golem/",
+    ".env.example",
+    "README.md"
+  ],
   "bin": {
+    "golem-cc": "./bin/golem",
     "golem": "./bin/golem",
     "golem-api": "./dist/cli/index.js"
   },
@@ -15,8 +24,7 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "lint": "eslint src/",
-    "typecheck": "tsc --noEmit",
-    "install:global": "./bin/install.sh"
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "chalk": "^5.3.0",

package/.github/workflows/publish.yml

@@ -1,42 +0,0 @@
-name: Publish to npm
-
-on:
-  push:
-    tags:
-      - 'v*'
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Upgrade npm for OIDC support
-        run: npm install -g npm@latest
-
-      - uses: pnpm/action-setup@v2
-        with:
-          version: 9
-
-      - name: Install dependencies
-        run: pnpm install
-
-      - name: Build
-        run: pnpm build
-
-      - name: Sync package.json version from git tag
-        run: |
-          VERSION=${GITHUB_REF#refs/tags/v}
-          echo "Setting version to $VERSION"
-          npm version $VERSION --no-git-tag-version --allow-same-version
-
-      - name: Publish to npm
-        run: npm publish --access public --provenance

package/.golem/IMPLEMENTATION_PLAN.md

@@ -1,59 +0,0 @@
-# Implementation Plan
-
-Ticket: LOCAL-DEV (no external ticket)
-Generated: 2026-02-04
-Based on: .golem/specs/config-command.md, .golem/specs/doctor-command.md
-
-## Status
-- Stages: 2
-- Completed: 0
-- Current: Stage 1
-
----
-
-## Stage 1: Config Command
-Commit: feat(cli): add golem config command to display configuration status
-
-### [x] 1.1. Add cmd_config function to bin/golem
-Files: bin/golem
-Notes: Add function that displays GOLEM_HOME, env file locations, and all env vars with appropriate masking for secrets. Use existing color helpers (GREEN for set, YELLOW for unset optional, RED for unset required). Required vars: FRESH_DOMAIN, FRESH_API_KEY, GITEA_URL, GITEA_TOKEN.
-Tests: Run `golem config` and verify output shows env status correctly
-
-### [x] 1.2. Add config to main case statement and help text
-Files: bin/golem
-Notes: Add "config)" case to main(), add to cmd_help() under OTHER section
-Tests: `golem help` shows config command, `golem config` routes correctly
-
-### [x] 1.3. Create /golem:config Claude command
-Files: commands/golem/config.md
-Notes: Follow pattern from status.md - use bash context blocks to read env status, display formatted output
-Tests: Run `/golem:config` in Claude and verify it shows configuration
-
----
-
-## Stage 2: Doctor Command
-Commit: feat(cli): add golem doctor command to diagnose setup issues
-Depends on: Stage 1
-
-### [x] 2.1. Add cmd_doctor function to bin/golem
-Files: bin/golem
-Notes: Implement environment checks (~/.golem dir, .env file, required vars), dependency checks (node, pnpm, git, golem-api with versions), installation checks (prompts, agents, commands, claude symlink). Track pass/fail count. Support --check-apis flag for optional API tests.
-Tests: Run `golem doctor` and verify all checks run and display correctly
-
-### [x] 2.2. Add doctor to main case statement and help text
-Files: bin/golem
-Notes: Add "doctor)" case to main(), add to cmd_help() under OTHER section
-Tests: `golem help` shows doctor command, `golem doctor` routes correctly
-
-### [x] 2.3. Create /golem:doctor Claude command
-Files: commands/golem/doctor.md
-Notes: Follow same pattern, run diagnostic checks and display results
-Tests: Run `/golem:doctor` in Claude and verify diagnostics display
-
----
-
-## Notes
-
-- No external services needed - all local checks
-- Install script may need re-run after adding new commands to copy them to ~/.golem
-- Exit codes: config always 0 (informational), doctor 0 if all pass / 1 if any fail

package/bin/install.sh

@@ -1,69 +0,0 @@
-#!/usr/bin/env bash
-#
-# Install golem globally
-#
-
-set -euo pipefail
-
-GOLEM_HOME="${GOLEM_HOME:-$HOME/.golem}"
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-
-echo "Installing golem to $GOLEM_HOME..."
-
-# Create directory structure
-mkdir -p "$GOLEM_HOME"/{commands,agents,prompts}
-
-# Copy commands
-cp -r "$SCRIPT_DIR/commands/golem" "$GOLEM_HOME/commands/"
-echo "✓ Installed Claude commands"
-
-# Copy agents and prompts
-cp "$SCRIPT_DIR/golem/agents/"*.md "$GOLEM_HOME/agents/"
-cp "$SCRIPT_DIR/golem/prompts/"*.md "$GOLEM_HOME/prompts/"
-echo "✓ Installed agents and prompts"
-
-# Build TypeScript
-echo "Building TypeScript..."
-cd "$SCRIPT_DIR"
-pnpm build
-
-# Link binaries
-mkdir -p "$HOME/.local/bin"
-ln -sf "$SCRIPT_DIR/bin/golem" "$HOME/.local/bin/golem"
-ln -sf "$SCRIPT_DIR/dist/cli/index.js" "$HOME/.local/bin/golem-api"
-chmod +x "$SCRIPT_DIR/dist/cli/index.js"
-echo "✓ Linked binaries to ~/.local/bin"
-
-# Create env template if not exists
-if [[ ! -f "$GOLEM_HOME/.env" ]]; then
-  cat > "$GOLEM_HOME/.env" << 'EOF'
-# Freshworks/Freshservice
-FRESH_DOMAIN=yourcompany.freshservice.com
-FRESH_API_KEY=your_api_key_here
-
-# Gitea (on-prem)
-GITEA_URL=https://dev.pearlriverresort.com
-GITEA_TOKEN=your_token_here
-GITEA_ORG=CRDE
-
-# Default repo for issues (can be overridden per-project)
-GITEA_REPO=
-EOF
-  echo "✓ Created $GOLEM_HOME/.env template"
-  echo ""
-  echo "⚠️  Edit $GOLEM_HOME/.env with your API credentials"
-fi
-
-# Setup Claude integration
-mkdir -p "$HOME/.claude/commands"
-ln -sf "$GOLEM_HOME/commands/golem" "$HOME/.claude/commands/golem" 2>/dev/null || true
-echo "✓ Linked Claude commands"
-
-echo ""
-echo "Installation complete!"
-echo ""
-echo "Make sure ~/.local/bin is in your PATH:"
-echo '  export PATH="$HOME/.local/bin:$PATH"'
-echo ""
-echo "Then configure your credentials:"
-echo "  $GOLEM_HOME/.env"