mindsystem-cc 4.6.0 → 4.6.1

package/README.md

@@ -420,9 +420,9 @@ Every artifact Mindsystem generates lives in `.planning/` — a markdown knowled
 │       └── 02-01-PLAN.md             #   planned, not yet executed
 │
 ├── adhoc/                            # /ms:adhoc → out-of-pipeline work
-│   └── 2026-01-15-fix-token/
-│       ├── adhoc-01-SUMMARY.md       # Execution results and learnings
-│       └── adhoc-01-changes.patch    # Code diff
+│   └── fix-token/
+│       ├── fix-token-SUMMARY.md      # Execution results and learnings
+│       └── fix-token-changes.patch   # Code diff
 │
 ├── debug/                            # /ms:debug → structured investigations
 │   ├── websocket-reconnect.md        # Active investigation — survives /clear

package/commands/ms/help.md

@@ -369,7 +369,7 @@ Execute discovered work with knowledge-aware planning and execution.
 - Browser verification for web projects (same flow as execute-phase)
 - Accepts Linear ticket IDs when task tracker is configured via `/ms:config` — auto-fetches context, tags commits, and finalizes the ticket on completion
 - Spawns Explore agents for codebase understanding, ms-adhoc-planner for plan creation, ms-executor for execution
-- Creates per-execution artifacts in `.planning/adhoc/{timestamp}-{slug}/`
+- Creates per-execution artifacts in `.planning/adhoc/{slug}/`
 - Updates knowledge files via ms-consolidator after execution
 
 Usage: `/ms:adhoc Fix auth token not refreshing on 401`
@@ -440,9 +440,9 @@ Usage: `/ms:release-notes`
 │   ├── *.md              # Pending todos (flat files)
 │   └── done/             # Completed todos
 ├── adhoc/                # Work executed via /ms:adhoc
-│   └── {date}-{slug}/    # Per-execution subdirectory
-│       ├── adhoc-01-PLAN.md    # Execution plan (deleted after consolidation)
-│       └── adhoc-01-SUMMARY.md # Completion summary
+│   └── {slug}/           # Per-execution subdirectory
+│       ├── {slug}-PLAN.md      # Execution plan (deleted after consolidation)
+│       └── {slug}-SUMMARY.md   # Completion summary
 ├── debug/                # Active debug sessions
 │   └── resolved/         # Archived resolved issues
 ├── codebase/             # Codebase map (brownfield projects)

package/mindsystem/references/browser-verification.md

@@ -102,16 +102,17 @@ Group journeys by starting area for efficient navigation. Format as a numbered l
 
 ## Spawn
 
-Spawn the browser verifier agent after auth is established and journeys are derived:
+Spawn the browser verifier agent after auth is established and journeys are derived.
+
+The orchestrator must pass `{screenshots_dir}` as a fully resolved path (e.g., `.planning/phases/04-comments/screenshots` or `.planning/adhoc/fix-auth/screenshots`). The browser verifier does not resolve paths — it uses whatever directory is provided.
 
 ```
 Task(
-  prompt="Run browser verification for phase {phase_number}.
+  prompt="Run browser verification.
 
-Phase directory: {phase_dir}
 Dev URL: {dev_url}
 Auth state: .agent-browser-state.json
-Screenshots directory: {phase_dir}/screenshots
+Screenshots directory: {screenshots_dir}
 
 ## User Journeys
 
@@ -122,7 +123,7 @@ Screenshots directory: {phase_dir}/screenshots
 {summary of which journeys need real backend data — from mock_hints external_data entries.
 Journeys needing backend data may show empty states or errors — mark as ENVIRONMENT_BLOCKED, not ISSUE.}
 
-Complete each user journey end-to-end. Save all screenshots to {phase_dir}/screenshots/.
+Complete each user journey end-to-end. Save all screenshots to {screenshots_dir}/.
 Fix trivial issues inline. Return structured report.",
   subagent_type="ms-browser-verifier"
 )
@@ -143,7 +144,7 @@ Report: "Browser verification: {N} fixes applied, {M} issues found"
 Include the Fixes Applied section in the consolidator prompt (step `consolidate_knowledge`) so browser-discovered patterns are captured in knowledge files.
 
 **`has_issues`:**
-Report: "Browser verification: {N} issues found (see screenshots in {phase_dir}/screenshots/)"
+Report: "Browser verification: {N} issues found (see screenshots in {screenshots_dir}/)"
 Note issues for verify-work — these are candidates for manual UAT.
 
 **`all_passed`:**

package/mindsystem/templates/adhoc-summary.md

@@ -1,6 +1,6 @@
 # Adhoc Summary Template
 
-Template for `.planning/adhoc/{timestamp}-{slug}-SUMMARY.md` — documentation for work items executed via `/ms:adhoc`.
+Template for `.planning/adhoc/{slug}/{slug}-SUMMARY.md` — documentation for work items executed via `/ms:adhoc`.
 
 ---
 
@@ -111,7 +111,7 @@ files_modified:
   - src/lib/api-client.ts
   - src/hooks/useAuth.ts
 commit: abc123f
-patch_file: .planning/adhoc/2026-01-20-fix-auth-token-not-refreshing-on-401.patch
+patch_file: .planning/adhoc/fix-auth-token-not-refreshing-on-401/fix-auth-token-not-refreshing-on-401-changes.patch
 learnings:
   - "401 interceptors must queue concurrent requests during token refresh to avoid race conditions"
 ---

package/mindsystem/workflows/adhoc.md

@@ -133,9 +133,13 @@ Present via AskUserQuestion with `multiSelect: true`:
 Create per-execution subdirectory:
 
 ```bash
-timestamp=$(date "+%Y-%m-%d")
 slug=$(echo "$description" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//;s/-$//' | cut -c1-50)
-exec_dir=".planning/adhoc/${timestamp}-${slug}"
+exec_dir=".planning/adhoc/${slug}"
+if [ -d "$exec_dir" ]; then
+  echo "COLLISION: $exec_dir already exists from a previous adhoc execution"
+  echo "Choose a more specific description or remove the existing directory"
+  exit 1
+fi
 mkdir -p "$exec_dir"
 ```
 
@@ -146,7 +150,7 @@ Assemble context payload for ms-adhoc-planner:
 - User decisions (from clarification step)
 - STATE.md context (current phase, accumulated decisions)
 - Subsystem list from config.json
-- Output path: `${exec_dir}/adhoc-01-PLAN.md`
+- Output path: `${exec_dir}/${slug}-PLAN.md`
 - Ticket context when detected (per loaded ticket reference)
 - Todo context when detected (per loaded todo reference)
 
@@ -154,7 +158,7 @@ Spawn ms-adhoc-planner via Task tool. Receive completion report with plan path.
 </step>
 
 <step name="review_plan">
-Read the generated plan at `${exec_dir}/adhoc-01-PLAN.md`.
+Read the generated plan at `${exec_dir}/${slug}-PLAN.md`.
 
 Present a summary to the user:
 - Number of Changes sections
@@ -170,12 +174,19 @@ If edits requested, apply them directly to the plan file, then re-present and as
 </step>
 
 <step name="spawn_executor">
+Record pre-execution HEAD for accurate diff scoping:
+
+```bash
+PRE_EXEC_HEAD=$(git rev-parse HEAD)
+```
+
 Spawn ms-executor via Task tool.
 
 Provide in the prompt:
-- Plan path: `${exec_dir}/adhoc-01-PLAN.md`
-- SUMMARY output path: `${exec_dir}/adhoc-01-SUMMARY.md`
+- Plan path: `${exec_dir}/${slug}-PLAN.md`
+- SUMMARY output path: `${exec_dir}/${slug}-SUMMARY.md`
 - Instruction to use phase-style SUMMARY format (with key-decisions, patterns-established, key-files, mock_hints frontmatter fields) for consolidator compatibility
+- Commit scope: `"Use (${slug}) as commit scope for all task commits: {type}(${slug}): description"`
 - Ticket commit instructions when detected (per loaded ticket reference)
 - Todo commit instructions when detected (per loaded todo reference)
 
@@ -191,11 +202,11 @@ ms-tools browser-check
 
 **If exit 0 (READY):**
 
-Ensure `${exec_dir}/adhoc-01-SUMMARY.md` is available (needed for journey derivation — may already be in context from executor report).
+Ensure `${exec_dir}/${slug}-SUMMARY.md` is available (needed for journey derivation — may already be in context from executor report).
 
 Read `~/.claude/mindsystem/references/browser-verification.md` and follow its sections in order:
 1. **Auth Flow** — establish browser authentication
-2. **Derive User Journeys** — transform SUMMARY into user journeys (single file: `${exec_dir}/adhoc-01-SUMMARY.md`)
+2. **Derive User Journeys** — transform SUMMARY into user journeys (single file: `${exec_dir}/${slug}-SUMMARY.md`)
 3. **Spawn** — launch ms-browser-verifier with derived journeys, screenshots directory: `${exec_dir}/screenshots`
 4. **Post-Verifier Handling** — route by report status
 
@@ -232,8 +243,7 @@ CODE_REVIEW=$(ms-tools config-get code_review.adhoc)
 
 1. Get modified files from executor's commits:
    ```bash
-   ADHOC_COMMITS=$(git log --oneline --grep="(adhoc-" --format="%H")
-   CHANGED_FILES=$(git diff --name-only $(echo "$ADHOC_COMMITS" | tail -1)^..HEAD | grep -E '\.(dart|ts|tsx|js|jsx|swift|kt|py|go|rs)$')
+   CHANGED_FILES=$(git diff --name-only ${PRE_EXEC_HEAD}..HEAD | grep -E '\.(dart|ts|tsx|js|jsx|swift|kt|py|go|rs)$')
    ```
 
 2. Spawn code review agent with adhoc scope.
@@ -245,11 +255,13 @@ CODE_REVIEW=$(ms-tools config-get code_review.adhoc)
 Generate a patch file capturing all adhoc changes:
 
 ```bash
-ADHOC_COMMITS=$(git log --oneline --grep="(adhoc-" --format="%H")
-FIRST_COMMIT=$(echo "$ADHOC_COMMITS" | tail -1)
-LAST_COMMIT=$(echo "$ADHOC_COMMITS" | head -1)
-patch_file="${exec_dir}/adhoc-01-changes.patch"
-ms-tools generate-adhoc-patch "$FIRST_COMMIT" "$patch_file" --end "$LAST_COMMIT"
+ADHOC_COMMITS=$(git log --reverse --grep="(${slug})" --format="%H" ${PRE_EXEC_HEAD}..HEAD)
+FIRST_COMMIT=$(echo "$ADHOC_COMMITS" | head -1)
+LAST_COMMIT=$(echo "$ADHOC_COMMITS" | tail -1)
+patch_file="${exec_dir}/${slug}-changes.patch"
+if [ -n "$FIRST_COMMIT" ]; then
+  ms-tools generate-adhoc-patch "$FIRST_COMMIT" "$patch_file" --end "$LAST_COMMIT"
+fi
 ```
 
 If no adhoc commits found or patch generation reports no changes, skip silently.
@@ -262,7 +274,7 @@ Provide:
 - Phase directory: `${exec_dir}` (the per-execution subdirectory)
 - Phase identifier: "adhoc"
 
-The consolidator reads `adhoc-01-SUMMARY.md`, extracts knowledge (key-decisions, patterns-established, key-files), updates `.planning/knowledge/*.md` files, and deletes `adhoc-01-PLAN.md`.
+The consolidator reads `${slug}-SUMMARY.md`, extracts knowledge (key-decisions, patterns-established, key-files), updates `.planning/knowledge/*.md` files, and deletes `${slug}-PLAN.md`.
 </step>
 
 <step name="cleanup_and_report">
@@ -272,15 +284,16 @@ The consolidator reads `adhoc-01-SUMMARY.md`, extracts knowledge (key-decisions,
 
 **Update STATE.md** "Recent Adhoc Work" section:
 - Find or create "### Recent Adhoc Work" under "## Accumulated Context"
-- Add entry at top: `- [YYYY-MM-DD]: [description] ({exec_dir}/adhoc-01-SUMMARY.md)`
+- Add entry at top: `- [YYYY-MM-DD]: [description] ({exec_dir}/${slug}-SUMMARY.md)`
 - Keep last 5 entries (remove older ones from list)
 
 **Update state and commit:**
 ```bash
+# Use the slug (sanitized directory name), not the raw description or ticket IDs
 ms-tools set-last-command "ms:adhoc ${slug}"
-git add .planning/knowledge/*.md "${exec_dir}/adhoc-01-SUMMARY.md" .planning/STATE.md
+git add .planning/knowledge/*.md "${exec_dir}/${slug}-SUMMARY.md" .planning/STATE.md
 # Only include patch if it was generated
-[ -f "${exec_dir}/adhoc-01-changes.patch" ] && git add "${exec_dir}/adhoc-01-changes.patch"
+[ -f "${exec_dir}/${slug}-changes.patch" ] && git add "${exec_dir}/${slug}-changes.patch"
 git commit -m "$(cat <<EOF
 docs(adhoc): consolidate knowledge from $description
 
@@ -298,8 +311,8 @@ Adhoc work complete: [description]
 **Knowledge updated:** [list of knowledge files]
 
 Artifacts:
-- Summary: {exec_dir}/adhoc-01-SUMMARY.md
-- Patch: {exec_dir}/adhoc-01-changes.patch
+- Summary: {exec_dir}/${slug}-SUMMARY.md
+- Patch: {exec_dir}/${slug}-changes.patch
 - Knowledge: .planning/knowledge/[subsystem].md
 ```
 

package/mindsystem/workflows/execute-phase.md

@@ -320,7 +320,7 @@ Ensure `$PHASE_DIR/*-SUMMARY.md` files are available (needed for journey derivat
 Read `~/.claude/mindsystem/references/browser-verification.md` and follow its sections in order:
 1. **Auth Flow** — establish browser authentication
 2. **Derive User Journeys** — transform SUMMARYs into user journeys
-3. **Spawn** — launch verifier with derived journeys
+3. **Spawn** — launch verifier with derived journeys, screenshots directory: `$PHASE_DIR/screenshots`
 4. **Post-Verifier Handling** — route by report status
 
 **If exit 1 (MISSING_DEPS):**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindsystem-cc",
-  "version": "4.6.0",
+  "version": "4.6.1",
   "description": "The engineer's meta-prompting system for Claude Code.",
   "bin": {
     "mindsystem-cc": "bin/install.js"

package/scripts/ms-tools.py

@@ -2199,7 +2199,7 @@ def _scan_artifact_subsystem_values(planning: Path) -> list[str]:
     values: list[str] = []
     scan_globs = [
         ("phases", "*/*-SUMMARY.md"),
-        ("adhoc", "*-SUMMARY.md"),
+        ("adhoc", "**/*-SUMMARY.md"),
         ("debug", "*.md"),
         ("debug/resolved", "*.md"),
         ("todos", "*.md"),
@@ -2321,7 +2321,7 @@ def cmd_scan_artifact_subsystems(args: argparse.Namespace) -> None:
 
     sections = [
         ("Phase SUMMARYs", "phases", "*/*-SUMMARY.md"),
-        ("Adhoc SUMMARYs", "adhoc", "*-SUMMARY.md"),
+        ("Adhoc SUMMARYs", "adhoc", "**/*-SUMMARY.md"),
         ("Debug docs", "debug", "*.md"),
         ("Debug resolved", "debug/resolved", "*.md"),
         ("Pending Todos", "todos", "*.md"),