@massu/core 0.5.0 → 0.6.1

package/commands/massu-batch.md

@@ -7,7 +7,7 @@ name: massu-batch
 
 # Massu Batch: Parallel Code Migration via Worktree Agents
 
-> **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding.
+**Shared rules**: Read `.claude/commands/_shared-preamble.md` for POST-COMPACTION (CR-12), ENTERPRISE-GRADE (CR-14), AWS SECRETS (CR-5) rules.
 
 ---
 
@@ -17,7 +17,7 @@ name: massu-batch
 /massu-batch [migration] → /massu-simplify → /massu-commit → /massu-push
 ```
 
-**This command is for CODE-ONLY migrations. It REFUSES database work.**
+**This command is for CODE-ONLY migrations. It REFUSES database work (CR-36 safety).**
 
 ---
 
@@ -37,16 +37,35 @@ Takes a migration description, identifies all affected files, splits them into b
 
 Read `$ARGUMENTS` for the migration description.
 
-If no arguments provided, ask:
+If no arguments provided, use AskUserQuestion:
+```
+question: "What code migration do you want to run?"
+options:
+  - label: "Import path change"
+    description: "Rename/move imports across files (e.g., @/old/path → @/new/path)"
+  - label: "Component swap"
+    description: "Replace one component with another across files"
+  - label: "Pattern replacement"
+    description: "Replace a code pattern with a new one across files"
+  - label: "API update"
+    description: "Update API calls to a new format"
+```
+
+Then ask for specifics:
 - **Search pattern**: What to find (glob pattern or grep pattern)
 - **Transformation**: What to change it to
 - **Scope**: Directory to limit search (default: `src/`)
 
-### Step 2: DB Guard (Safety Gate — MANDATORY)
+### Step 2: DB Guard (CR-36 Safety Gate — MANDATORY)
 
 **This step CANNOT be skipped. No exceptions.**
 
-Check the migration description for these keywords:
+```bash
+# Run the DB guard script
+bash scripts/batch-db-guard.sh "$MIGRATION_DESCRIPTION" $TARGET_FILES
+```
+
+Additionally, check the migration description for these keywords:
 ```
 migration, schema, ALTER, CREATE TABLE, DROP, column, RLS, GRANT,
 database, prisma, supabase, ctx.db, ctx.prisma, $queryRaw, execute_sql
@@ -65,8 +84,8 @@ supabase/migrations/
 ```
 ## DB GUARD: Migration Blocked
 
-This migration touches database-related code. Database migrations require
-sequential coordination across environments.
+This migration touches database-related code. Database migrations MUST use
+/massu-loop to ensure CR-36 compliance (all 3 environments in same session).
 
 /massu-batch is designed for code-only migrations:
   - Import path changes
@@ -122,6 +141,18 @@ Each agent will:
 4. Report results
 ```
 
+Use AskUserQuestion:
+```
+question: "Proceed with this batch migration plan?"
+options:
+  - label: "Proceed"
+    description: "Execute the migration with M parallel agents"
+  - label: "Adjust batch size"
+    description: "Change the number of files per agent"
+  - label: "Cancel"
+    description: "Abort the migration"
+```
+
 **Wait for explicit user approval. Do NOT proceed without it.**
 
 ### Step 5: Execution Phase (Parallel Worktree Agents)
@@ -283,8 +314,8 @@ git worktree remove [path]
 
 | Rule | Enforcement |
 |------|-------------|
-| **No database changes** | DB guard inline keyword check + path check |
-| **User approval required** | Interactive approval before execution phase |
+| **No database changes** | DB guard script + inline keyword check + path check |
+| **User approval required** | AskUserQuestion before execution phase |
 | **No file overlap between batches** | Planning phase ensures each file appears in exactly one batch |
 | **Per-agent verification** | Each agent runs pattern-scanner + tsc before completing |
 | **Consolidated verification** | Full checks run after merge |
@@ -314,7 +345,7 @@ git worktree remove [path]
 
 | Scenario | Use Instead |
 |----------|-------------|
-| Database/schema changes | `/massu-loop` |
+| Database/schema changes | `/massu-loop` (CR-36: all 3 envs) |
 | < 5 files affected | Manual changes + `/massu-simplify` |
 | New feature development | `/massu-create-plan` → `/massu-loop` |
 | Cross-file dependencies | `/massu-loop` (sequential is safer) |
@@ -322,6 +353,7 @@ git worktree remove [path]
 
 ## Gotchas
 
-- **NEVER for database work** — batch migrations are CODE-ONLY. Database migrations must be applied to all environments in sequence, which requires coordination that parallel agents cannot provide
+- **NEVER for database work (CR-36)** — batch migrations are CODE-ONLY. Database migrations must be applied to all 3 environments in sequence, which requires coordination that parallel agents cannot provide
+- **DB guard auto-refuses** — `scripts/batch-db-guard.sh` automatically blocks batch items that reference database tables, migrations, or SQL
 - **Worktree isolation** — each agent runs in a git worktree. Changes must be mergeable. Agents editing the same file will cause merge conflicts
-- **One task per agent** — each worktree agent gets exactly one plan item. Never combine unrelated items in a single agent
+- **One task per agent (Principle #20)** — each worktree agent gets exactly one plan item. Never combine unrelated items in a single agent

package/commands/massu-bearings.md

@@ -1,13 +1,13 @@
 ---
 name: massu-bearings
 description: "When user starts a new session, says 'good morning', asks 'where was I', 'what should I work on', or needs session orientation after being away"
-allowed-tools: Bash(*), Read(*), Grep(*), Glob(*)
+allowed-tools: Bash(*), Read(*), Grep(*), Glob(*), mcp__massu-codegraph__massu_cost_session, mcp__massu-codegraph__massu_cost_trend, mcp__massu-codegraph__massu_cost_feature
 ---
 name: massu-bearings
 
 # Massu Bearings: Session Orientation
 
-> **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding.
+> **Shared rules apply.** Read `.claude/commands/_shared-preamble.md` before proceeding. CR-14, CR-5, CR-12 enforced.
 
 ---
 
@@ -41,6 +41,9 @@ Read these in parallel where possible:
 | 10 | `.claude/metrics/command-invocations.jsonl` | Command usage frequency — top/least used in last 7 days |
 | 11 | `.claude/metrics/bearings-history.jsonl` | Previous bearings runs — show trends |
 | 12 | `.claude/commands/` (ls -d */`) | Detect folder-based skills (directories vs flat files) |
+| 13 | `bash scripts/memory-contradiction-check.sh` | Contradiction count, consolidation candidates |
+| 14 | `massu_cost_session` + `massu_cost_trend` MCP tools | Token spend this session, cost trend over time |
+| 15 | `session-state/deferred-verifications.md` | Pending production verifications from previous deploys |
 
 ---
 
@@ -93,10 +96,28 @@ COMMAND USAGE (last 7 days)
   Least: [command] (N invocations), [command] (N)
   (or "No invocation data yet")
 
+TOKEN SPEND
+  Session: $X.XX (N calls)
+  7-day trend: $XX.XX total, $X.XX/day avg
+  Top feature: [feature] ($X.XX)
+  (or "No cost data available — massu_cost_session returned empty")
+
 FOLDER-BASED SKILLS
   [list any commands that are directories: massu-golden-path, massu-debug, massu-loop, massu-data]
   (or "No folder-based skills detected")
 
+MEMORY HEALTH
+  Contradictions: [N] found
+  [1] file_a.md vs file_b.md — [brief description]
+  Consolidation candidates: [N]
+  (or "Memory is clean — 0 contradictions")
+
+DEFERRED VERIFICATIONS
+  ! [DV-001] [feature] — expected by [time], query: [sql snippet]
+  ! [DV-002] [feature] — expected by [time], query: [sql snippet]
+  (or "No deferred verifications pending")
+  Action: Run `/massu-production-verify --deferred` to check
+
 ACTIVE WARNINGS
   - [any correction rules or memory enforcement reminders]
   (or "No active warnings")
@@ -109,11 +130,12 @@ ACTIVE WARNINGS
 ## Suggested Focus Logic
 
 Prioritize items in this order:
-1. **Blockers** — anything marked as blocked in CURRENT.md
-2. **In-progress tasks** — partially completed work from last session
-3. **Open plan items** — next items in an active plan
-4. **Aging squirrels** — ideas parked > 7 days ago (mention but don't auto-promote)
-5. **New work** — only if nothing else is open
+1. **Deferred verifications past due** — items in `session-state/deferred-verifications.md` past their expected verification time
+2. **Blockers** — anything marked as blocked in CURRENT.md
+3. **In-progress tasks** — partially completed work from last session
+4. **Open plan items** — next items in an active plan
+5. **Aging squirrels** — ideas parked > 7 days ago (mention but don't auto-promote)
+6. **New work** — only if nothing else is open
 
 Keep to 2-3 items. This is a focus list, not an inventory.
 
@@ -189,6 +211,18 @@ Read `.claude/metrics/command-invocations.jsonl`. Filter to last 7 days by `time
 
 ---
 
+## Token Spend Logic
+
+Call `massu_cost_session` MCP tool for current session cost. Call `massu_cost_trend` MCP tool for 7-day cost history. If either tool returns empty or errors, show "No cost data available — massu_cost_session returned empty". Otherwise:
+
+1. **Session cost**: Display total cost and call count from `massu_cost_session`
+2. **7-day trend**: Sum daily costs, calculate daily average from `massu_cost_trend`
+3. **Top feature**: If `massu_cost_feature` data is available, show the most expensive feature
+
+If the MCP tools are unavailable (server not running), skip this section silently — do NOT error or block the bearings output.
+
+---
+
 ## Folder-Based Skill Detection
 
 Run `ls -d .claude/commands/*/` to find commands that are directories. Display the list in FOLDER-BASED SKILLS section. Each folder-based skill has a `## Skill Contents` table in its main file listing sub-files.
@@ -197,7 +231,7 @@ Run `ls -d .claude/commands/*/` to find commands that are directories. Display t
 
 ## START NOW
 
-1. Read all data sources in parallel (CURRENT.md, archives, squirrels, plans, git log, git diff, corrections, metrics, bearings-history)
+1. Read all data sources in parallel (CURRENT.md, archives, squirrels, plans, git log, git diff, corrections, metrics, bearings-history, memory-contradiction-check, cost MCP tools)
 2. Synthesize into the output format above
 3. Present to terminal
 4. Append bearings-history.jsonl entry