mindsystem-cc 3.0.0

package/commands/ms/update.md

@@ -0,0 +1,159 @@
+---
+name: ms:update
+description: Update Mindsystem to latest version with changelog display
+---
+
+<objective>
+Check for Mindsystem updates, install if available, and display what changed.
+
+Provides a better update experience than raw `npx mindsystem-cc` by showing version diff and changelog entries.
+</objective>
+
+<process>
+
+<step name="get_installed_version">
+Read installed version:
+
+```bash
+cat ~/.claude/mindsystem/VERSION 2>/dev/null
+```
+
+**If VERSION file missing:**
+```
+## Mindsystem 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 mindsystem-cc version 2>/dev/null
+```
+
+**If npm check fails:**
+```
+Couldn't check for updates (offline or npm unavailable).
+
+To update manually: `npx mindsystem-cc --global`
+```
+
+STOP here if npm unavailable.
+</step>
+
+<step name="compare_versions">
+Compare installed vs latest:
+
+**If installed == latest:**
+```
+## Mindsystem Update
+
+**Installed:** X.Y.Z
+**Latest:** X.Y.Z
+
+You're already on the latest version.
+```
+
+STOP here if already up to date.
+
+**If installed > latest:**
+```
+## Mindsystem Update
+
+**Installed:** X.Y.Z
+**Latest:** A.B.C
+
+You're ahead of the latest release (development version?).
+```
+
+STOP here if ahead.
+</step>
+
+<step name="run_update">
+Run the update:
+
+```bash
+npx mindsystem-cc --global
+```
+
+Capture output. If install fails, show error and STOP.
+</step>
+
+<step name="fetch_changelog">
+Fetch changelog from GitHub:
+
+Use WebFetch tool with:
+- URL: `https://raw.githubusercontent.com/rolandtolnay/mindsystem/main/CHANGELOG.md`
+- Prompt: "Extract all version entries with their dates and changes. Return the raw markdown for each version section."
+
+**If fetch fails:**
+Fall back to local:
+```bash
+cat ~/.claude/mindsystem/CHANGELOG.md 2>/dev/null
+```
+</step>
+
+<step name="extract_changes">
+From the changelog, extract entries between:
+- **From:** installed version (exclusive)
+- **To:** latest version (inclusive)
+
+Parse each `## [X.Y.Z]` section and collect all versions in the range.
+</step>
+
+<step name="display_result">
+Format beautiful output:
+
+```
+╔═══════════════════════════════════════════════════════════╗
+║  Mindsystem Updated: v1.5.10 → v1.5.15                           ║
+╚═══════════════════════════════════════════════════════════╝
+
+✨ What's New
+────────────────────────────────────────────────────────────
+
+## [1.5.15] - 2026-01-20
+
+### Added
+- Feature X
+- Feature Y
+
+## [1.5.14] - 2026-01-18
+
+### Fixed
+- Bug in feature A
+
+────────────────────────────────────────────────────────────
+
+⚠️  Restart Claude Code to pick up the new commands.
+
+[View full changelog](https://github.com/rolandtolnay/mindsystem/blob/main/CHANGELOG.md)
+```
+
+**Key elements:**
+- Box header with version transition
+- All changelog entries in the range
+- **BREAKING:** changes surfaced prominently
+- Restart reminder (critical for picking up new commands)
+- Link to full changelog
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Installed version read correctly
+- [ ] Latest version checked via npm
+- [ ] Update skipped if already current
+- [ ] Update executed successfully
+- [ ] Changelog fetched (remote or local fallback)
+- [ ] Changes between versions displayed
+- [ ] Restart reminder shown
+</success_criteria>

package/commands/ms/verify-work.md

@@ -0,0 +1,92 @@
+---
+name: ms:verify-work
+description: Validate built features through batched UAT with inline fixing
+argument-hint: "[phase number, e.g., '4']"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Edit
+  - Write
+  - Task
+  - AskUserQuestion
+---
+
+<objective>
+Validate built features through batched testing with mock support and inline fixing.
+
+Purpose: Confirm what Claude built actually works from user's perspective. Tests presented in batches of 4 using AskUserQuestion. Issues can be fixed inline during the same session — no context switching to separate plan/execute phases.
+
+Output: {phase}-UAT.md tracking all test results. Fixes committed with `fix({phase}-uat):` prefix. Patch file generated for all UAT fixes.
+</objective>
+
+<execution_context>
+@~/.claude/mindsystem/workflows/verify-work.md
+@~/.claude/mindsystem/workflows/generate-mocks.md
+@~/.claude/mindsystem/templates/UAT.md
+@~/.claude/mindsystem/references/mock-patterns.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS (optional)
+- If provided: Test specific phase (e.g., "4")
+- If not provided: Check for active sessions or prompt for phase
+
+@.planning/STATE.md
+@.planning/ROADMAP.md
+@.planning/PROJECT.md
+</context>
+
+<process>
+1. **Check dirty tree** — If uncommitted changes, ask: stash / commit / abort
+2. **Check for active UAT sessions** — Resume or start new
+3. **Find SUMMARY.md files** for the phase
+4. **Extract testable deliverables** from summaries
+5. **Classify tests by mock requirements** — Infer mock_type from test descriptions
+6. **Group into batches** — By mock type, max 4 per batch, no-mock tests first
+7. **For each batch:**
+   - If mock needed: Generate mocks, present toggle instructions, wait for confirmation
+   - Present tests via AskUserQuestion (Pass / Can't test / Skip / Other)
+   - Process results, update UAT.md
+   - **For each issue found:**
+     - Lightweight investigation (2-3 tool calls)
+     - If simple: Fix inline, commit, ask for re-test
+     - If complex: Spawn ms-verify-fixer subagent
+     - 2 retries on failed re-test, then offer options
+8. **On batch transition:**
+   - If new mock_type: Discard old mocks, generate new ones
+   - If same mock_type: Keep mocks active
+9. **On completion:**
+   - Discard all mocks (git stash drop)
+   - Generate UAT fixes patch
+   - Restore user's pre-existing work (if stashed)
+   - Commit UAT.md, present summary
+</process>
+
+<anti_patterns>
+- Don't ask severity — infer from description
+- Don't present more than 4 tests at a time
+- Don't run automated tests — this is manual user validation
+- Don't skip investigation — always try 2-3 tool calls before escalating
+- Don't fix complex issues inline — spawn fixer subagent for multi-file or architectural changes
+- Don't commit mock code — always stash before fixing
+- Don't re-present skipped tests — assumptions stand
+</anti_patterns>
+
+<success_criteria>
+- [ ] Dirty tree handled at start (stash/commit/abort)
+- [ ] Tests extracted from SUMMARY.md and classified
+- [ ] Tests batched by mock requirements
+- [ ] Mocks generated when needed with clear toggle instructions
+- [ ] Tests presented in batches of 4 using AskUserQuestion
+- [ ] Issues investigated with lightweight check first
+- [ ] Simple issues fixed inline with proper commit message
+- [ ] Complex issues escalated to fixer subagent
+- [ ] Failed re-tests get 2 retries then options
+- [ ] Stash conflicts auto-resolved to fix version
+- [ ] Mocks discarded on completion
+- [ ] UAT fixes patch generated
+- [ ] User's pre-existing work restored
+- [ ] UAT.md committed with final summary
+</success_criteria>

package/commands/ms/whats-new.md

@@ -0,0 +1,124 @@
+---
+name: ms:whats-new
+description: See what's new in Mindsystem since your installed version
+---
+
+<objective>
+Display changes between installed version and latest available version.
+
+Shows version comparison, changelog entries for missed versions, and update instructions.
+</objective>
+
+<process>
+
+<step name="get_installed_version">
+Read installed version from VERSION file:
+
+```bash
+cat ~/.claude/mindsystem/VERSION 2>/dev/null
+```
+
+**If VERSION file missing:**
+```
+## Mindsystem What's New
+
+**Installed version:** Unknown
+
+Your installation doesn't include version tracking.
+
+**To fix:** `npx mindsystem-cc --global`
+
+This will reinstall with version tracking enabled.
+```
+
+STOP here if no VERSION file.
+</step>
+
+<step name="fetch_remote_changelog">
+Fetch latest CHANGELOG.md from GitHub:
+
+Use WebFetch tool with:
+- URL: `https://raw.githubusercontent.com/rolandtolnay/gsd/main/CHANGELOG.md`
+- Prompt: "Extract all version entries with their dates and changes. Return in Keep-a-Changelog format."
+
+**If fetch fails:**
+Fall back to local changelog:
+```bash
+cat ~/.claude/mindsystem/CHANGELOG.md 2>/dev/null
+```
+
+Note to user: "Couldn't check for updates (offline or GitHub unavailable). Showing local changelog."
+</step>
+
+<step name="parse_versions">
+From the remote (or local) changelog:
+
+1. **Extract latest version** - First `## [X.Y.Z]` line after `## [Unreleased]`
+2. **Compare with installed** - From VERSION file
+3. **Extract entries between** - All version sections from latest down to (but not including) installed
+
+**Version comparison:**
+- If installed == latest: "You're on the latest version"
+- If installed < latest: Show changes since installed version
+- If installed > latest: "You're ahead of latest release (development version?)"
+</step>
+
+<step name="display_output">
+Format output clearly:
+
+**If up to date:**
+```
+## Mindsystem What's New
+
+**Installed:** 1.4.26
+**Latest:** 1.4.26
+
+You're on the latest version.
+
+[View full changelog](https://github.com/rolandtolnay/gsd/blob/main/CHANGELOG.md)
+```
+
+**If updates available:**
+```
+## Mindsystem What's New
+
+**Installed:** 1.4.23
+**Latest:** 1.4.26
+
+---
+
+### Changes since your version:
+
+## [1.4.26] - 2026-01-20
+
+### Added
+- Feature X
+- Feature Y
+
+### Changed
+- **BREAKING:** Changed Z behavior
+
+## [1.4.25] - 2026-01-18
+
+### Fixed
+- Bug in feature A
+
+---
+
+[View full changelog](https://github.com/rolandtolnay/gsd/blob/main/CHANGELOG.md)
+
+**To update:** `npx mindsystem-cc --global`
+```
+
+**Breaking changes:** Surface prominently with **BREAKING:** prefix in the output.
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Installed version read from VERSION file
+- [ ] Remote changelog fetched (or graceful fallback to local)
+- [ ] Version comparison displayed clearly
+- [ ] Changes since installed version shown (if any)
+- [ ] Update instructions provided when behind
+</success_criteria>