multi-forge 0.2.0__py3-none-any.whl

forge/_extensions/skills/qa/resources/checklist/17-info.md

@@ -0,0 +1,50 @@
+<!-- prereq: 0.3 -->
+
+## 17. System Info
+
+### 17.1 `forge info`
+
+<!-- auto -->
+
+```bash
+forge info
+```
+
+- [ ] Shows Forge version
+- [ ] Shows installation status
+- [ ] Shows proxy status
+- [ ] Shows active session (if any)
+
+### 17.2 Debug Logging and `forge logs`
+
+<!-- human:confirm -->
+
+Run a Forge command with debug logging enabled, then use `forge logs` to inspect and clean up log files.
+
+```bash
+# Run a command with debug logging
+FORGE_DEBUG=1 forge info
+
+# Show log locations and file counts
+forge logs
+
+# Verify logs were written
+forge logs
+# Expected: shows log directory path and file count > 0
+
+# Clean up logs
+forge logs --clean
+
+# Verify cleanup
+forge logs
+# Expected: reports 0 log files when no Forge processes are running.
+# If QA proxies are still running, active proxy logs may be retained.
+```
+
+- [ ] `FORGE_DEBUG=1` enables debug logging (no crash, no error)
+- [ ] `forge logs` shows log directory location and file counts
+- [ ] Log files were actually written (count > 0 after debug run)
+- [ ] `forge logs --clean` removes stale log files
+- [ ] After cleanup, `forge logs` reports 0 files, or only logs for currently running Forge proxy processes
+
+---

forge/_extensions/skills/qa/resources/checklist/18-disable.md

@@ -0,0 +1,84 @@
+<!-- prereq: 0.3, 2.4 -->
+
+## 18. Uninstallation (Incremental)
+
+Test uninstalling individual scopes before the complete uninstall.
+
+### 18.1 Uninstall Local Scope Only
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+cd $FORGE_TEST_REPO
+
+# Uninstall only the local scope
+forge extension disable --scope local
+
+# (Optional) Uninstall hooks-only path, if you used it
+forge hook disable --local
+
+# Verify local removal
+ls .claude/commands/   # Should be empty or removed
+cat .claude/settings.local.json | jq '.hooks'  # Should have no Forge hooks
+
+# Verify user scope STILL installed
+ls ~/.claude/commands/  # Should still have Forge commands
+cat ~/.claude/settings.json | jq '.hooks'  # Should still have Forge hooks
+
+# Check tracking
+cat ~/.forge/installed.json | jq '.installations | keys'
+# Should show only ["user"], not the local:... key
+```
+
+- [ ] Local commands removed
+- [ ] Local hooks removed from settings.local.json
+- [ ] User scope commands still present
+- [ ] User scope hooks still present
+- [ ] Tracking shows only "user" key
+
+### 18.2 Verify Pre-Existing Settings Restored (Local)
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+# CRITICAL: Check that user's original settings survived uninstall
+cat .claude/settings.local.json | jq '.'
+
+# Original permissions should still be there
+cat .claude/settings.local.json | jq '.permissions.allow'
+# Should show: ["Bash(npm test)", "Bash(uv run pytest*)"]
+
+# Custom env var should still be there
+cat .claude/settings.local.json | jq '.env.MY_CUSTOM_VAR'
+# Should show: "should-survive-forge"
+```
+
+- [ ] Original `permissions.allow` entries preserved
+- [ ] `env.MY_CUSTOM_VAR` still present
+- [ ] Forge-added hooks removed; Forge-added permissions (Write, Edit) removed
+- [ ] User-approved permissions (e.g., `Bash(forge workflow:*)`) may remain -- these are Claude Code auto-learned, not
+  Forge-managed
+
+### 18.3 Re-install Local for Complete Test
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+# Re-install local scope so we can test complete uninstall
+forge extension enable --scope local
+
+# Verify both scopes installed again
+cat ~/.forge/installed.json | jq '.installations | keys'
+# Should show: ["user", "local:/Users/..."]
+```
+
+- [ ] Local scope re-installed
+- [ ] Both installations tracked
+
+---

forge/_extensions/skills/qa/resources/checklist/19-uninstall.md

@@ -0,0 +1,146 @@
+<!-- prereq: 0.3, 2.4, 18 -->
+
+## 19. Complete Uninstallation (setup.sh --uninstall)
+
+This tests the curl-installable uninstall that removes EVERYTHING.
+
+### 19.1 Pre-Uninstall State Verification
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+# Verify we have both installations
+cat ~/.forge/installed.json | jq '.installations | keys'
+# Should show: ["user", "local:$FORGE_TEST_REPO"]
+
+# Verify artifacts exist
+ls ~/.forge/             # Should exist
+ls ~/.forge/bin/forge    # Should exist
+ls ~/.claude/commands/   # Should have Forge commands
+ls .claude/commands/     # Should have Forge commands (local)
+```
+
+- [ ] Both user and local installations tracked
+- [ ] `~/.forge/` exists
+- [ ] User scope has Forge files
+- [ ] Local scope has Forge files
+
+### 19.2 Run Complete Uninstall
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+# Run the uninstall script using the local copy
+~/.forge/repo/scripts/setup.sh --uninstall
+```
+
+The script attempts to remove extensions via Forge CLI:
+
+- `forge extension disable --all --force` (remove tracked extensions)
+
+Then it removes `~/.forge/` and other artifacts.
+
+- [ ] Script runs without errors
+- [ ] ALL scopes uninstalled (via `forge extension disable --all --force` or equivalent)
+- [ ] Shows "Found N Forge installation(s)" summary (if forge available)
+- [ ] `~/.forge/` removed
+- [ ] `~/.forge/sessions/` removed (Forge session data)
+- [ ] Docker images removed (multi-forge-\*)
+- [ ] Shell profile cleaned (block markers removed)
+
+### 19.3 Verify Complete Removal
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+# Verify ~/.forge/ is gone
+ls ~/.forge/ 2>/dev/null || echo "~/.forge/ removed"
+
+# Verify forge not on PATH (need new terminal or source profile)
+# source ~/.zshrc  # or restart terminal
+# which forge      # Should fail or show nothing
+
+# Verify no Forge hooks in global settings
+cat ~/.claude/settings.json | jq '.hooks'
+# Should be null or empty of Forge entries
+
+# Verify user commands removed
+ls ~/.claude/commands/ 2>/dev/null | grep -v "^$" || echo "User commands removed"
+ls ~/.claude/agents/ 2>/dev/null | grep -v "^$" || echo "User agents removed"
+ls ~/.claude/skills/ 2>/dev/null | grep -v "^$" || echo "User skills removed"
+```
+
+- [ ] `~/.forge/` directory removed
+- [ ] Forge hooks removed from `~/.claude/settings.json`
+- [ ] User commands/agents/skills removed
+
+### 19.4 Verify Local Project Settings Preserved
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+cd $FORGE_TEST_REPO
+
+# CRITICAL: Local pre-existing settings should survive
+cat .claude/settings.local.json | jq '.'
+
+# Original permissions should still be there
+cat .claude/settings.local.json | jq '.permissions.allow'
+# Should show: ["Bash(npm test)", "Bash(uv run pytest*)"]
+
+# Custom env var should still be there
+cat .claude/settings.local.json | jq '.env.MY_CUSTOM_VAR'
+# Should show: "should-survive-forge"
+```
+
+- [ ] `.claude/settings.local.json` still exists
+- [ ] Original permissions preserved
+- [ ] `env.MY_CUSTOM_VAR` preserved
+- [ ] Forge-added entries (hooks, Write/Edit permissions, env) removed; user-approved permissions (e.g.,
+  `Bash(forge workflow:*)`) may remain
+
+### 19.5 Verify Shell Profile Cleaned
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+# Check that block markers were removed from any shell profile Forge may touch.
+PROFILES=("$HOME/.bashrc" "$HOME/.bash_profile" "$HOME/.zshrc" "$HOME/.config/fish/config.fish")
+FOUND_PROFILE=0
+FOUND_BACKUP=0
+
+for profile in "${PROFILES[@]}"; do
+  if [ -f "$profile" ]; then
+    FOUND_PROFILE=1
+    echo "Checking $profile"
+    grep -n ">>> multi-forge >>>" "$profile" && exit 1 || true
+    grep -n "$HOME/.forge/bin" "$profile" && exit 1 || true
+  fi
+
+  if [ -f "$profile.forge-uninstall-backup" ]; then
+    FOUND_BACKUP=1
+    echo "Backup exists: $profile.forge-uninstall-backup"
+  fi
+done
+
+echo "profiles_found=$FOUND_PROFILE backups_found=$FOUND_BACKUP"
+if [ "$FOUND_PROFILE" -eq 0 ]; then
+  echo "No shell profile exists in this container; profile cleanup is N/A."
+fi
+```
+
+- [ ] No `>>> multi-forge >>>` block remains in any existing shell profile
+- [ ] No `.forge/bin` PATH entry remains in any existing shell profile
+- [ ] Backup file exists for any profile that was modified; if no shell profile exists, profile cleanup is N/A
+
+---

forge/_extensions/skills/qa/resources/checklist/2-extensions.md

@@ -0,0 +1,188 @@
+<!-- prereq: 0.3, 1.1 -->
+
+## 2. Claude Code Extensions (`forge extension enable`)
+
+### 2.1 Basic Installation (User Scope)
+
+<!-- auto -->
+
+```bash
+# Install forge extensions (default: standard profile, user scope)
+cd $FORGE_TEST_REPO
+forge extension enable --scope user --symlink
+
+# Optional: preview changes instead of applying
+forge extension enable --scope user --dry-run
+
+# Verify installation
+ls -la $CLAUDE_HOME/skills/
+cat $CLAUDE_HOME/settings.json | jq '.hooks'
+cat $FORGE_HOME/installed.json | jq '.installations.user.modules_enabled'
+
+# Optional: confirm status line + permissions were merged (user scope)
+cat $CLAUDE_HOME/settings.json | jq '.statusLine'
+cat $CLAUDE_HOME/settings.json | jq '.permissions'
+```
+
+- [ ] `modules_enabled` in `installed.json` lists `commands` and `agents` (directories created only if source has
+  installable files)
+- [ ] Skills installed to `$CLAUDE_HOME/skills/` (standard profile)
+- [ ] Hooks configured in `$CLAUDE_HOME/settings.json` (or in `$CLAUDE_HOME/settings.local.json` if you used hooks-only
+  install)
+- [ ] `$FORGE_HOME/installed.json` tracking file created
+
+### 2.2 Verify Installed Content
+
+<!-- auto -->
+
+```bash
+# Check what was installed
+cat $FORGE_HOME/installed.json | jq '.'
+
+# Verify user-scope status line setting
+cat $CLAUDE_HOME/settings.json | jq '.statusLine'
+
+# Verify user-scope permissions
+cat $CLAUDE_HOME/settings.json | jq '.permissions'
+
+# Verify skills are installed
+ls $CLAUDE_HOME/skills/
+```
+
+- [ ] `installed.json` lists all installed files
+- [ ] `statusLine` points to `forge status-line`
+- [ ] Permissions include Forge-required entries
+- [ ] Skills directory contains skill folders (analyze, debate, panel, review, review-docs, etc.)
+
+### 2.3 Verify Pre-Existing Settings Preserved
+
+<!-- auto -->
+
+```bash
+# Check that user's original settings survived installation
+cat .claude/settings.local.json | jq '.'
+
+# Verify original permissions still present (merged, not replaced)
+cat .claude/settings.local.json | jq '.permissions.allow'
+# Should include BOTH:
+# - Original: "Bash(npm test)", "Bash(uv run pytest*)"
+# - Forge-added permissions (if any added to local scope)
+
+# Verify custom env var preserved
+cat .claude/settings.local.json | jq '.env.MY_CUSTOM_VAR'
+# Should show: "should-survive-forge"
+```
+
+- [ ] Original `permissions.allow` entries preserved
+- [ ] `env.MY_CUSTOM_VAR` still present
+- [ ] Forge merged settings, didn't replace
+
+### 2.4 Install Local Scope
+
+<!-- auto -->
+
+```bash
+# Install Forge extensions to LOCAL scope (this project only)
+cd $FORGE_TEST_REPO
+forge extension enable --scope local
+
+# Verify local installation
+cat .claude/settings.local.json | jq '.hooks'
+LOCAL_KEY="local:$(cd "$FORGE_TEST_REPO" && pwd -P)"
+cat $FORGE_HOME/installed.json | jq --arg key "$LOCAL_KEY" '.installations[$key].modules_enabled'
+```
+
+- [ ] `modules_enabled` for local installation lists `commands` and `agents` (directories created only if source has
+  installable files)
+- [ ] Hooks configured in `.claude/settings.local.json`
+
+### 2.5 Verify Both Installations Tracked
+
+<!-- auto -->
+
+```bash
+# Check tracking file shows BOTH installations
+LOCAL_KEY="local:$(cd "$FORGE_TEST_REPO" && pwd -P)"
+cat $FORGE_HOME/installed.json | jq '.installations | keys'
+printf 'Expected local key: %s\n' "$LOCAL_KEY"
+
+# Show user installation
+cat $FORGE_HOME/installed.json | jq '.installations.user.scope'
+# Should show: "user"
+
+# Show local installation (note the key format with path)
+cat $FORGE_HOME/installed.json | jq --arg key "$LOCAL_KEY" '.installations[$key].scope'
+# Should show: "local"
+
+# Verify project_path is tracked
+cat $FORGE_HOME/installed.json | jq --arg key "$LOCAL_KEY" '.installations[$key].project_path'
+# Should show the resolved path part of LOCAL_KEY
+```
+
+- [ ] Tracking shows "user" key
+- [ ] Tracking shows "local:/path/to/project" key
+- [ ] Both installations tracked separately
+- [ ] project_path field populated for local installation
+
+### 2.6 Test Double-Install Prevention
+
+<!-- auto -->
+
+```bash
+# Try to install local again to same project
+forge extension enable --scope local
+
+# Should either:
+# - Say "already installed" and skip
+# - Or update existing installation (idempotent)
+
+# Verify only ONE local entry in tracking
+cat $FORGE_HOME/installed.json | jq '.installations | keys | length'
+# Should show 2 (user + 1 local), not 3
+```
+
+- [ ] Re-running `forge extension enable --scope local` is idempotent
+- [ ] No duplicate entries in tracking
+
+### 2.7 Check Install Status (Nearest Scope)
+
+<!-- auto -->
+
+```bash
+cd $FORGE_TEST_REPO
+
+# Status for the nearest installation (auto-detects local/project/user)
+forge extension status
+```
+
+- [ ] `forge extension status` succeeds
+- [ ] Shows detected scope + profile/modules summary
+
+### 2.8 Check Install Status (All Scopes)
+
+<!-- auto -->
+
+```bash
+cd $FORGE_TEST_REPO
+
+# Show user + project + local scopes
+forge extension status --all
+```
+
+- [ ] Shows all three scopes (user/project/local)
+- [ ] Missing scopes are shown as "Not installed" (does not error)
+
+### 2.9 Update Installation (Idempotent)
+
+<!-- auto -->
+
+```bash
+cd $FORGE_TEST_REPO
+
+# Update the nearest installation (auto-detects)
+forge extension sync
+```
+
+- [ ] Update completes (or reports already up to date)
+
+---

forge/_extensions/skills/qa/resources/checklist/20-cleanup.md

@@ -0,0 +1,36 @@
+## 20. Cleanup
+
+### 20.1 Cleanup Test Artifacts
+
+<!-- auto -->
+
+<!-- destructive -->
+
+```bash
+# Clean up test sessions and artifacts, but preserve the QA state mount
+rm -rf .forge/sessions/ .forge/artifacts/ .forge/prev_sessions/ .forge/search-index/
+
+# Remove shell profile backups (optional)
+rm -f \
+  ~/.bashrc.forge-uninstall-backup \
+  ~/.bash_profile.forge-uninstall-backup \
+  ~/.zshrc.forge-uninstall-backup \
+  ~/.config/fish/config.fish.forge-uninstall-backup
+
+# Remove QA cost fixture logs (safe: only QA-owned fixture names)
+rm -f ~/.forge/costs/requests/qa-fixture_*.jsonl
+rm -f ~/.forge/costs/verbs/qa-fixture_*.jsonl
+rm -f ~/.forge/costs/requests/*_qa-cap-seed.jsonl
+
+# Remove test repo entirely (optional)
+# cd .. && rm -rf manual-testing/walkthrough/test-repo
+```
+
+- [ ] `.forge/sessions/` removed (or did not exist)
+- [ ] `.forge/qa/` preserved (QA state mount -- do NOT delete)
+- [ ] Shell profile backup removed (if existed)
+- [ ] QA cost fixture logs removed from `~/.forge/costs/requests/` (no `qa-fixture_*.jsonl`)
+- [ ] QA cost fixture logs removed from `~/.forge/costs/verbs/` (no `qa-fixture_*.jsonl`)
+- [ ] QA cap seed logs removed from `~/.forge/costs/requests/` (no `*_qa-cap-seed.jsonl`)
+
+---