agileflow 2.77.0 → 2.79.0

package/src/core/commands/session/resume.md

@@ -1,6 +1,19 @@
 ---
 description: Pick a session to switch to or resume
 argument-hint: (no arguments)
+compact_context:
+  priority: high
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:session:resume - Switch between parallel sessions"
+    - "Lists all registered sessions (active and inactive) with status"
+    - "User selects which session to resume"
+    - "Returns `cd` command to switch to selected session"
+    - "Formats nickname/branch with activity status (Active now / inactive)"
+    - "Marks current session with '(current)' label"
+  state_fields:
+    - current_session
+    - all_sessions
+    - user_selection
 ---
 
 # /agileflow:session:resume
@@ -89,3 +102,156 @@ Run /agileflow:session:new to create a new parallel workspace.
 - `/agileflow:session:new` - Create new session
 - `/agileflow:session:status` - Quick status view
 - `/agileflow:session:end` - End current session
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+
+## ⚠️ COMPACT SUMMARY - /agileflow:session:resume IS ACTIVE
+
+**CRITICAL**: This command is the primary way to **switch between parallel sessions**. User selects, you display the cd command.
+
+---
+
+### 🚨 RULE #1: ALWAYS USE AskUserQuestion
+
+**NEVER just describe the sessions.** Build an AskUserQuestion with:
+- One option per session
+- Current session marked "(current)"
+- Active sessions marked "Active now"
+- Inactive sessions show "last active: {time}"
+- "Create new session" option at bottom
+
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "Which session would you like to resume?",
+  "header": "Sessions",
+  "multiSelect": false,
+  "options": [
+    {"label": "Session 1: main (current)",
+     "description": "US-0042: User Auth API │ Active now │ /home/user/project"},
+    {"label": "Session 2: \"auth\"",
+     "description": "US-0038: Fix Login │ Active now │ ../project-auth"},
+    {"label": "Session 3: feature/payments",
+     "description": "US-0051 │ Inactive (1 day ago) │ ../project-payments"},
+    {"label": "Create new session",
+     "description": "Start a fresh parallel workspace"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+---
+
+### 🚨 RULE #2: HANDLE EACH SELECTION CASE
+
+**If user selects current session:**
+```
+You're already in Session 1!
+```
+
+**If user selects different session:**
+```
+To resume Session 2 "auth":
+
+┌─────────────────────────────────────────────────────────┐
+│   cd ../project-auth && claude --resume                 │
+└─────────────────────────────────────────────────────────┘
+
+Session info:
+  Branch: session-2
+  Story:  US-0038 (in-progress)
+```
+
+**If user selects "Create new session":**
+```
+Run /agileflow:session:new to create a new parallel workspace.
+```
+
+---
+
+### 🚨 RULE #3: FORMATTING LABELS & DESCRIPTIONS
+
+**Label format (session option):**
+- Session with nickname: `Session {id}: "{nickname}"`
+- Session with branch: `Session {id}: {branch}`
+- Current session: append ` (current)`
+
+**Description format:**
+- Include story ID if available: `US-0042`
+- Include status: `Active now` OR `Inactive (N days ago)`
+- Include relative path: `../project-auth`
+- Format: `{STORY_ID} │ {STATUS} │ {PATH}`
+
+---
+
+### 🚨 RULE #4: SESSION DATA STRUCTURE
+
+Sessions from `session-manager.js list --json` contain:
+```json
+{
+  "id": 1,
+  "path": "/home/user/project",
+  "branch": "main",
+  "nickname": null,
+  "status": "active",
+  "is_current": true,
+  "is_main": true,
+  "created": "2025-12-20T10:00:00Z",
+  "last_active": "2025-12-20T10:30:00Z"
+}
+```
+
+Use these fields to build readable labels.
+
+---
+
+### KEY FILES TO REMEMBER
+
+| File | Purpose |
+|------|---------|
+| `.agileflow/sessions/registry.json` | Master list of all sessions |
+| `.agileflow/sessions/{id}.lock` | Lock file = session is active |
+| `.agileflow/scripts/session-manager.js` | Script providing session data |
+
+---
+
+### WORKFLOW
+
+1. **Get sessions** → `node .agileflow/scripts/session-manager.js list --json`
+2. **Parse JSON** → Extract id, branch, nickname, status, path
+3. **Build options** → Create readable labels with status
+4. **Show AskUserQuestion** → Let user select
+5. **Handle selection** → Show cd command or appropriate response
+
+---
+
+### ANTI-PATTERNS (DON'T DO THESE)
+
+❌ Just list sessions without AskUserQuestion
+❌ Format label as "session_1_main" (use readable format)
+❌ Show path as absolute when relative is shorter
+❌ Don't mark current session with "(current)"
+❌ Don't show "Active now" status for active sessions
+
+### DO THESE INSTEAD
+
+✅ ALWAYS use AskUserQuestion with user options
+✅ Format labels as "Session 1: main (current)"
+✅ Show relative paths (../project-auth)
+✅ Mark current session clearly
+✅ Show activity status (Active now / Inactive Xd ago)
+
+---
+
+### REMEMBER AFTER COMPACTION
+
+- `/agileflow:session:resume` IS ACTIVE
+- ALWAYS use AskUserQuestion to let user select
+- Format labels clearly: `Session {id}: {nickname/branch} {(current)}`
+- Show status in description: `Active now` OR `Inactive (N days ago)`
+- Handle each case: current / different / create new
+- Return cd command when user selects different session
+
+<!-- COMPACT_SUMMARY_END -->

package/src/core/commands/session/status.md

@@ -1,6 +1,19 @@
 ---
 description: View current session state and activity
 argument-hint: (no arguments)
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:session:status - Display all sessions in table"
+    - "Does NOT prompt for action (read-only display)"
+    - "Shows current session, then table of other sessions"
+    - "Marks active sessions with ● bullet, inactive with ○"
+    - "Returns session count and active count"
+  state_fields:
+    - current_session
+    - all_sessions
+    - active_count
+    - total_count
 ---
 
 # /agileflow:session:status
@@ -63,3 +76,156 @@ Run /agileflow:session:new to create a parallel workspace.
 - `/agileflow:session:new` - Create new session
 - `/agileflow:session:resume` - Switch sessions
 - `/agileflow:session:end` - End current session
+
+---
+
+<!-- COMPACT_SUMMARY_START -->
+
+## ⚠️ COMPACT SUMMARY - /agileflow:session:status IS ACTIVE
+
+**CRITICAL**: This command displays read-only status. It NEVER prompts for action - just shows information.
+
+---
+
+### 🚨 RULE #1: READ-ONLY DISPLAY (NO USER PROMPTS)
+
+**NEVER use AskUserQuestion or present options.** This command is informational only.
+
+| Command | Has Prompts? | Use Case |
+|---------|-------------|----------|
+| `/agileflow:session:status` | ❌ No | Quick info view |
+| `/agileflow:session:resume` | ✅ Yes | Switch sessions |
+| `/agileflow:session:new` | ✅ Yes | Create session |
+| `/agileflow:session:end` | ✅ Yes | End session |
+
+---
+
+### 🚨 RULE #2: DISPLAY FORMAT
+
+**Structure:**
+1. Header with emoji: `📊 Session Status`
+2. Current session info (highlighted)
+3. Table of other sessions
+4. Summary line: `Total: X sessions │ Y active`
+5. Quick actions (optional)
+
+**Example:**
+```
+📊 Session Status
+
+Current: Session 1 (main)
+         Branch: main │ Story: US-0042 │ Active
+
+Other Sessions:
+┌─────┬──────────────────┬─────────────┬────────────┐
+│  #  │ Name/Branch      │ Story       │ Status     │
+├─────┼──────────────────┼─────────────┼────────────┤
+│  2  │ "auth"           │ US-0038     │ ● Active   │
+│  3  │ feature/payments │ -           │ ○ Inactive │
+└─────┴──────────────────┴─────────────┴────────────┘
+
+Total: 3 sessions │ 2 active
+```
+
+---
+
+### 🚨 RULE #3: STATUS BULLETS
+
+- **● Active** - Session has lock file (Claude process running)
+- **○ Inactive** - No lock file (can be resumed)
+
+---
+
+### 🚨 RULE #4: SHOW QUICK ACTIONS (OPTIONAL)
+
+After the table, show optional quick actions info:
+```
+💡 Quick actions:
+   /agileflow:session:new    - Create parallel session
+   /agileflow:session:resume - Switch to another session
+   /agileflow:session:end    - End current session
+```
+
+---
+
+### 🚨 RULE #5: HANDLE EDGE CASES
+
+**If no sessions exist:**
+```
+📊 Session Status
+
+No sessions registered yet. You're in the main project directory.
+Run /agileflow:session:new to create a parallel workspace.
+```
+
+**If only current session:**
+```
+📊 Session Status
+
+Current: Session 1 (main)
+         Branch: main │ Active
+
+This is your only session. Use /agileflow:session:new to create more.
+```
+
+---
+
+### FORMATTING RULES
+
+| Element | Format | Example |
+|---------|--------|---------|
+| Session name | Branch or nickname | `main` or `"auth"` |
+| Story ID | US-#### or dash | `US-0042` or `-` |
+| Status | ● Active or ○ Inactive | `● Active` |
+| Session reference | Session {id} | `Session 1` |
+
+---
+
+### KEY FILES TO REMEMBER
+
+| File | Purpose |
+|------|---------|
+| `.agileflow/sessions/registry.json` | Master list of sessions |
+| `.agileflow/sessions/{id}.lock` | Lock file marks session active |
+| `.agileflow/scripts/session-manager.js` | Data source |
+
+---
+
+### WORKFLOW
+
+1. **Get sessions** → `node .agileflow/scripts/session-manager.js list --json`
+2. **Parse JSON** → Extract sessions, identify current
+3. **Build display** → Format header, current session, table
+4. **Show summary** → Total and active counts
+5. **Optionally show** → Quick actions reference
+
+---
+
+### ANTI-PATTERNS (DON'T DO THESE)
+
+❌ Use AskUserQuestion to prompt for action
+❌ Show "Resume Session 2?" or similar prompts
+❌ Use table without proper formatting
+❌ Show path in table (too much info)
+❌ Skip summary line showing counts
+
+### DO THESE INSTEAD
+
+✅ Display as read-only information
+✅ Use ● and ○ bullets for status
+✅ Format table with proper borders
+✅ Show summary with counts
+✅ Optionally show quick actions for reference
+
+---
+
+### REMEMBER AFTER COMPACTION
+
+- `/agileflow:session:status` IS ACTIVE
+- NEVER prompt for action (read-only display)
+- Format: header + current session + table + summary
+- Use ● for active, ○ for inactive
+- Show session counts in summary
+- Optionally show quick actions reference
+
+<!-- COMPACT_SUMMARY_END -->