mindforge-cc 9.0.0 → 10.0.1

package/.agent/workflows/mindforge-update.md

@@ -1,323 +0,0 @@
-<purpose>
-Check for MindForge updates via npm, display changelog for versions between installed and latest, obtain user confirmation, and execute clean installation with cache clearing.
-</purpose>
-
-<required_reading>
-Read all files referenced by the invoking prompt's execution_context before starting.
-</required_reading>
-
-<process>
-
-<step name="get_installed_version">
-Detect whether MindForge is installed locally or globally by checking both locations and validating install integrity.
-
-First, derive `PREFERRED_RUNTIME` from the invoking prompt's `execution_context` path:
-- Path contains `/.codex/` -> `codex`
-- Path contains `/.gemini/` -> `gemini`
-- Path contains `/.config/opencode/` or `/.opencode/` -> `opencode`
-- Otherwise -> `claude`
-
-Use `PREFERRED_RUNTIME` as the first runtime checked so `/mindforge-update` targets the runtime that invoked it.
-
-```bash
-# Runtime candidates: "<runtime>:<config-dir>" stored as an array.
-# Using an array instead of a space-separated string ensures correct
-# iteration in both bash and zsh (zsh does not word-split unquoted
-# variables by default). Fixes #1173.
-RUNTIME_DIRS=( "claude:.claude" "opencode:.config/opencode" "opencode:.opencode" "gemini:.gemini" "codex:.codex" )
-
-# PREFERRED_RUNTIME should be set from execution_context before running this block.
-# If not set, infer from runtime env vars; fallback to claude.
-if [ -z "$PREFERRED_RUNTIME" ]; then
-  if [ -n "$CODEX_HOME" ]; then
-    PREFERRED_RUNTIME="codex"
-  elif [ -n "$GEMINI_CONFIG_DIR" ]; then
-    PREFERRED_RUNTIME="gemini"
-  elif [ -n "$OPENCODE_CONFIG_DIR" ] || [ -n "$OPENCODE_CONFIG" ]; then
-    PREFERRED_RUNTIME="opencode"
-  elif [ -n "$CLAUDE_CONFIG_DIR" ]; then
-    PREFERRED_RUNTIME="claude"
-  else
-    PREFERRED_RUNTIME="claude"
-  fi
-fi
-
-# Reorder entries so preferred runtime is checked first.
-ORDERED_RUNTIME_DIRS=()
-for entry in "${RUNTIME_DIRS[@]}"; do
-  runtime="${entry%%:*}"
-  if [ "$runtime" = "$PREFERRED_RUNTIME" ]; then
-    ORDERED_RUNTIME_DIRS+=( "$entry" )
-  fi
-done
-for entry in "${RUNTIME_DIRS[@]}"; do
-  runtime="${entry%%:*}"
-  if [ "$runtime" != "$PREFERRED_RUNTIME" ]; then
-    ORDERED_RUNTIME_DIRS+=( "$entry" )
-  fi
-done
-
-# Check local first (takes priority only if valid and distinct from global)
-LOCAL_VERSION_FILE="" LOCAL_MARKER_FILE="" LOCAL_DIR="" LOCAL_RUNTIME=""
-for entry in "${ORDERED_RUNTIME_DIRS[@]}"; do
-  runtime="${entry%%:*}"
-  dir="${entry#*:}"
-  if [ -f "./$dir/mindforge/VERSION" ] || [ -f "./$dir/mindforge/workflows/mindforge-update.md" ]; then
-    LOCAL_RUNTIME="$runtime"
-    LOCAL_VERSION_FILE="./$dir/mindforge/VERSION"
-    LOCAL_MARKER_FILE="./$dir/mindforge/workflows/mindforge-update.md"
-    LOCAL_DIR="$(cd "./$dir" 2>/dev/null && pwd)"
-    break
-  fi
-done
-
-GLOBAL_VERSION_FILE="" GLOBAL_MARKER_FILE="" GLOBAL_DIR="" GLOBAL_RUNTIME=""
-for entry in "${ORDERED_RUNTIME_DIRS[@]}"; do
-  runtime="${entry%%:*}"
-  dir="${entry#*:}"
-  if [ -f "$HOME/$dir/mindforge/VERSION" ] || [ -f "$HOME/$dir/mindforge/workflows/mindforge-update.md" ]; then
-    GLOBAL_RUNTIME="$runtime"
-    GLOBAL_VERSION_FILE="$HOME/$dir/mindforge/VERSION"
-    GLOBAL_MARKER_FILE="$HOME/$dir/mindforge/workflows/mindforge-update.md"
-    GLOBAL_DIR="$(cd "$HOME/$dir" 2>/dev/null && pwd)"
-    break
-  fi
-done
-
-# Only treat as LOCAL if the resolved paths differ (prevents misdetection when CWD=$HOME)
-IS_LOCAL=false
-if [ -n "$LOCAL_VERSION_FILE" ] && [ -f "$LOCAL_VERSION_FILE" ] && [ -f "$LOCAL_MARKER_FILE" ] && grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+' "$LOCAL_VERSION_FILE"; then
-  if [ -z "$GLOBAL_DIR" ] || [ "$LOCAL_DIR" != "$GLOBAL_DIR" ]; then
-    IS_LOCAL=true
-  fi
-fi
-
-if [ "$IS_LOCAL" = true ]; then
-  INSTALLED_VERSION="$(cat "$LOCAL_VERSION_FILE")"
-  INSTALL_SCOPE="LOCAL"
-  TARGET_RUNTIME="$LOCAL_RUNTIME"
-elif [ -n "$GLOBAL_VERSION_FILE" ] && [ -f "$GLOBAL_VERSION_FILE" ] && [ -f "$GLOBAL_MARKER_FILE" ] && grep -Eq '^[0-9]+\.[0-9]+\.[0-9]+' "$GLOBAL_VERSION_FILE"; then
-  INSTALLED_VERSION="$(cat "$GLOBAL_VERSION_FILE")"
-  INSTALL_SCOPE="GLOBAL"
-  TARGET_RUNTIME="$GLOBAL_RUNTIME"
-elif [ -n "$LOCAL_RUNTIME" ] && [ -f "$LOCAL_MARKER_FILE" ]; then
-  # Runtime detected but VERSION missing/corrupt: treat as unknown version, keep runtime target
-  INSTALLED_VERSION="0.0.0"
-  INSTALL_SCOPE="LOCAL"
-  TARGET_RUNTIME="$LOCAL_RUNTIME"
-elif [ -n "$GLOBAL_RUNTIME" ] && [ -f "$GLOBAL_MARKER_FILE" ]; then
-  INSTALLED_VERSION="0.0.0"
-  INSTALL_SCOPE="GLOBAL"
-  TARGET_RUNTIME="$GLOBAL_RUNTIME"
-else
-  INSTALLED_VERSION="0.0.0"
-  INSTALL_SCOPE="UNKNOWN"
-  TARGET_RUNTIME="claude"
-fi
-
-echo "$INSTALLED_VERSION"
-echo "$INSTALL_SCOPE"
-echo "$TARGET_RUNTIME"
-```
-
-Parse output:
-- Line 1 = installed version (`0.0.0` means unknown version)
-- Line 2 = install scope (`LOCAL`, `GLOBAL`, or `UNKNOWN`)
-- Line 3 = target runtime (`claude`, `opencode`, `gemini`, or `codex`)
-- If scope is `UNKNOWN`, proceed to install step using `--claude --global` fallback.
-
-If multiple runtime installs are detected and the invoking runtime cannot be determined from execution_context, ask the user which runtime to update before running install.
-
-**If VERSION file missing:**
-```
-## MindForge Update
-
-**Installed version:** Unknown
-
-Your installation doesn't include version tracking.
-
-Running fresh install...
-```
-
-Proceed to install step (treat as version 0.0.0 for comparison).
-</step>
-
-<step name="check_latest_version">
-Check npm for latest version:
-
-```bash
-npm view mindforge-cc version 2>/dev/null
-```
-
-**If npm check fails:**
-```
-Couldn't check for updates (offline or npm unavailable).
-
-To update manually: `npx mindforge-cc --global`
-```
-
-Exit.
-</step>
-
-<step name="compare_versions">
-Compare installed vs latest:
-
-**If installed == latest:**
-```
-## MindForge Update
-
-**Installed:** X.Y.Z
-**Latest:** X.Y.Z
-
-You're already on the latest version.
-```
-
-Exit.
-
-**If installed > latest:**
-```
-## MindForge Update
-
-**Installed:** X.Y.Z
-**Latest:** A.B.C
-
-You're ahead of the latest release (development version?).
-```
-
-Exit.
-</step>
-
-<step name="show_changes_and_confirm">
-**If update available**, fetch and show what's new BEFORE updating:
-
-1. Fetch changelog from GitHub raw URL
-2. Extract entries between installed and latest versions
-3. Display preview and ask for confirmation:
-
-```
-## MindForge Update Available
-
-**Installed:** 1.5.10
-**Latest:** 1.5.15
-
-### What's New
-────────────────────────────────────────────────────────────
-
-## [1.5.15] - 2026-01-20
-
-### Added
-- Feature X
-
-## [1.5.14] - 2026-01-18
-
-### Fixed
-- Bug fix Y
-
-────────────────────────────────────────────────────────────
-
-⚠️  **Note:** The installer performs a clean install of MindForge folders:
-- `commands/mindforge/` will be wiped and replaced
-- `mindforge/` will be wiped and replaced
-- `agents/mindforge-*` files will be replaced
-
-(Paths are relative to detected runtime install location:
-global: `.agent/`, `~/.config/opencode/`, `~/.opencode/`, `~/.gemini/`, or `~/.codex/`
-local: `./.agent/`, `./.config/opencode/`, `./.opencode/`, `./.gemini/`, or `./.codex/`)
-
-Your custom files in other locations are preserved:
-- Custom commands not in `commands/mindforge/` ✓
-- Custom agents not prefixed with `mindforge-` ✓
-- Custom hooks ✓
-- Your GEMINI.md files ✓
-
-If you've modified any MindForge files directly, they'll be automatically backed up to `mindforge-local-patches/` and can be reapplied with `/mindforge-reapply-patches` after the update.
-```
-
-Use AskUserQuestion:
-- Question: "Proceed with update?"
-- Options:
-  - "Yes, update now"
-  - "No, cancel"
-
-**If user cancels:** Exit.
-</step>
-
-<step name="run_update">
-Run the update using the install type detected in step 1:
-
-Build runtime flag from step 1:
-```bash
-RUNTIME_FLAG="--$TARGET_RUNTIME"
-```
-
-**If LOCAL install:**
-```bash
-npx -y mindforge-cc@latest "$RUNTIME_FLAG" --local
-```
-
-**If GLOBAL install:**
-```bash
-npx -y mindforge-cc@latest "$RUNTIME_FLAG" --global
-```
-
-**If UNKNOWN install:**
-```bash
-npx -y mindforge-cc@latest --claude --global
-```
-
-Capture output. If install fails, show error and exit.
-
-Clear the update cache so statusline indicator disappears:
-
-```bash
-# Clear update cache across all runtime directories
-for dir in .claude .config/opencode .opencode .gemini .codex; do
-  rm -f "./$dir/cache/mindforge-update-check.json"
-  rm -f "$HOME/$dir/cache/mindforge-update-check.json"
-done
-```
-
-The SessionStart hook (`mindforge-check-update.js`) writes to the detected runtime's cache directory, so all paths must be cleared to prevent stale update indicators.
-</step>
-
-<step name="display_result">
-Format completion message (changelog was already shown in confirmation step):
-
-```
-╔═══════════════════════════════════════════════════════════╗
-║  MindForge Updated: v1.5.10 → v1.5.15                           ║
-╚═══════════════════════════════════════════════════════════╝
-
-⚠️  Restart your runtime to pick up the new commands.
-
-[View full changelog](https://github.com/glittercowboy/mindforge/blob/main/CHANGELOG.md)
-```
-</step>
-
-
-<step name="check_local_patches">
-After update completes, check if the installer detected and backed up any locally modified files:
-
-Check for mindforge-local-patches/backup-meta.json in the config directory.
-
-**If patches found:**
-
-```
-Local patches were backed up before the update.
-Run /mindforge-reapply-patches to merge your modifications into the new version.
-```
-
-**If no patches:** Continue normally.
-</step>
-</process>
-
-<success_criteria>
-- [ ] Installed version read correctly
-- [ ] Latest version checked via npm
-- [ ] Update skipped if already current
-- [ ] Changelog fetched and displayed BEFORE update
-- [ ] Clean install warning shown
-- [ ] User confirmation obtained
-- [ ] Update executed successfully
-- [ ] Restart reminder shown
-</success_criteria>

package/.agent/workflows/mindforge-validate-phase.md

@@ -1,167 +0,0 @@
-<purpose>
-Audit Nyquist validation gaps for a completed phase. Generate missing tests. Update VALIDATION.md.
-</purpose>
-
-<required_reading>
-@.agent/references/ui-brand.md
-</required_reading>
-
-<process>
-
-## 0. Initialize
-
-```bash
-INIT=$(node ".agent/bin/mindforge-tools.cjs" init phase-op "${PHASE_ARG}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Parse: `phase_dir`, `phase_number`, `phase_name`, `phase_slug`, `padded_phase`.
-
-```bash
-AUDITOR_MODEL=$(node ".agent/bin/mindforge-tools.cjs" resolve-model mindforge-nyquist-auditor --raw)
-NYQUIST_CFG=$(node ".agent/bin/mindforge-tools.cjs" config-get workflow.nyquist_validation --raw)
-```
-
-If `NYQUIST_CFG` is `false`: exit with "Nyquist validation is disabled. Enable via /mindforge-settings."
-
-Display banner: `MindForge > VALIDATE PHASE {N}: {name}`
-
-## 1. Detect Input State
-
-```bash
-VALIDATION_FILE=$(ls "${PHASE_DIR}"/*-VALIDATION.md 2>/dev/null | head -1)
-SUMMARY_FILES=$(ls "${PHASE_DIR}"/*-SUMMARY.md 2>/dev/null)
-```
-
-- **State A** (`VALIDATION_FILE` non-empty): Audit existing
-- **State B** (`VALIDATION_FILE` empty, `SUMMARY_FILES` non-empty): Reconstruct from artifacts
-- **State C** (`SUMMARY_FILES` empty): Exit — "Phase {N} not executed. Run /mindforge-execute-phase {N} ${MindForge_WS} first."
-
-## 2. Discovery
-
-### 2a. Read Phase Artifacts
-
-Read all PLAN and SUMMARY files. Extract: task lists, requirement IDs, key-files changed, verify blocks.
-
-### 2b. Build Requirement-to-Task Map
-
-Per task: `{ task_id, plan_id, wave, requirement_ids, has_automated_command }`
-
-### 2c. Detect Test Infrastructure
-
-State A: Parse from existing VALIDATION.md Test Infrastructure table.
-State B: Filesystem scan:
-
-```bash
-find . -name "pytest.ini" -o -name "jest.config.*" -o -name "vitest.config.*" -o -name "pyproject.toml" 2>/dev/null | head -10
-find . \( -name "*.test.*" -o -name "*.spec.*" -o -name "test_*" \) -not -path "*/node_modules/*" 2>/dev/null | head -40
-```
-
-### 2d. Cross-Reference
-
-Match each requirement to existing tests by filename, imports, test descriptions. Record: requirement → test_file → status.
-
-## 3. Gap Analysis
-
-Classify each requirement:
-
-| Status | Criteria |
-|--------|----------|
-| COVERED | Test exists, targets behavior, runs green |
-| PARTIAL | Test exists, failing or incomplete |
-| MISSING | No test found |
-
-Build: `{ task_id, requirement, gap_type, suggested_test_path, suggested_command }`
-
-No gaps → skip to Step 6, set `nyquist_compliant: true`.
-
-## 4. Present Gap Plan
-
-Call AskUserQuestion with gap table and options:
-1. "Fix all gaps" → Step 5
-2. "Skip — mark manual-only" → add to Manual-Only, Step 6
-3. "Cancel" → exit
-
-## 5. Spawn mindforge-nyquist-auditor
-
-```
-Task(
-  prompt="Read .agent/agents/mindforge-nyquist-auditor.md for instructions.\n\n" +
-    "<files_to_read>{PLAN, SUMMARY, impl files, VALIDATION.md}</files_to_read>" +
-    "<gaps>{gap list}</gaps>" +
-    "<test_infrastructure>{framework, config, commands}</test_infrastructure>" +
-    "<constraints>Never modify impl files. Max 3 debug iterations. Escalate impl bugs.</constraints>",
-  subagent_type="mindforge-nyquist-auditor",
-  model="{AUDITOR_MODEL}",
-  description="Fill validation gaps for Phase {N}"
-)
-```
-
-Handle return:
-- `## GAPS FILLED` → record tests + map updates, Step 6
-- `## PARTIAL` → record resolved, move escalated to manual-only, Step 6
-- `## ESCALATE` → move all to manual-only, Step 6
-
-## 6. Generate/Update VALIDATION.md
-
-**State B (create):**
-1. Read template from `.agent/mindforge/templates/VALIDATION.md`
-2. Fill: frontmatter, Test Infrastructure, Per-Task Map, Manual-Only, Sign-Off
-3. Write to `${PHASE_DIR}/${PADDED_PHASE}-VALIDATION.md`
-
-**State A (update):**
-1. Update Per-Task Map statuses, add escalated to Manual-Only, update frontmatter
-2. Append audit trail:
-
-```markdown
-## Validation Audit {date}
-| Metric | Count |
-|--------|-------|
-| Gaps found | {N} |
-| Resolved | {M} |
-| Escalated | {K} |
-```
-
-## 7. Commit
-
-```bash
-git add {test_files}
-git commit -m "test(phase-${PHASE}): add Nyquist validation tests"
-
-node ".agent/bin/mindforge-tools.cjs" commit "docs(phase-${PHASE}): add/update validation strategy"
-```
-
-## 8. Results + Routing
-
-**Compliant:**
-```
-MindForge > PHASE {N} IS NYQUIST-COMPLIANT
-All requirements have automated verification.
-▶ Next: /mindforge-audit-milestone ${MindForge_WS}
-```
-
-**Partial:**
-```
-MindForge > PHASE {N} VALIDATED (PARTIAL)
-{M} automated, {K} manual-only.
-▶ Retry: /mindforge-validate-phase {N} ${MindForge_WS}
-```
-
-Display `/clear` reminder.
-
-</process>
-
-<success_criteria>
-- [ ] Nyquist config checked (exit if disabled)
-- [ ] Input state detected (A/B/C)
-- [ ] State C exits cleanly
-- [ ] PLAN/SUMMARY files read, requirement map built
-- [ ] Test infrastructure detected
-- [ ] Gaps classified (COVERED/PARTIAL/MISSING)
-- [ ] User gate with gap table
-- [ ] Auditor spawned with complete context
-- [ ] All three return formats handled
-- [ ] VALIDATION.md created or updated
-- [ ] Test files committed separately
-- [ ] Results with routing presented
-</success_criteria>