prjct-cli 0.8.6 → 0.9.1

package/templates/commands/migrate-all.md

@@ -1,6 +1,9 @@
-# /p:migrate-all - Migrate All Legacy Projects
+---
+allowed-tools: [Read, Write, Bash]
+description: 'Migrate all legacy projects to global storage architecture'
+---
 
-Migrates all legacy prjct projects to the new global storage architecture.
+# /p:migrate-all
 
 ## Usage
 
@@ -8,113 +11,51 @@ Migrates all legacy prjct projects to the new global storage architecture.
 /p:migrate-all [--deep-scan] [--remove-legacy] [--dry-run]
 ```
 
-## What This Command Does
+## What It Does
 
-1. **Scans Global Storage**
-   - Reads all project IDs from `~/.prjct-cli/projects/`
-   - Retrieves project paths from `project.json` files
-
-2. **Detects Legacy Structure**
-   - Checks each project for old `.prjct/` directory structure
-   - Identifies projects that need migration
-
-3. **Migrates Each Project**
-   - Moves data from local `.prjct/` to global `~/.prjct-cli/projects/{id}/`
-   - Creates new minimal local config (`.prjct/prjct.config.json`)
-   - Preserves all project data and history
-
-4. **Cleanup (Optional)**
-   - Removes legacy `.prjct/` directories (with `--remove-legacy`)
-   - Keeps only the new minimal config file
-
-5. **Reports Summary**
-   - Shows migrated, skipped, and failed projects
-   - Lists detailed errors for any failures
+1. **Scans global storage** → Reads all project IDs from `~/.prjct-cli/projects/`
+2. **Detects legacy structure** → Checks each project for old `.prjct/` directory
+3. **Migrates each project** → Moves data from local `.prjct/` to global storage
+4. **Cleanup (optional)** → Removes legacy `.prjct/` directories (with `--remove-legacy`)
+5. **Reports summary** → Shows migrated, skipped, failed counts
 
 ## Options
 
 - `--deep-scan`: Scan entire file system (slow but thorough)
-- `--remove-legacy`: Delete old `.prjct/` directories after successful migration
+- `--remove-legacy`: Delete old `.prjct/` after successful migration
 - `--dry-run`: Show what would be migrated without making changes
 
 ## When to Use
 
-- **After major version updates**: When architecture changes
-- **Upgrading from v0.7.x to v0.8.x**: New global storage system
-- **Consolidating projects**: Moving all projects to global storage
-- **Troubleshooting**: If projects aren't working after update
+- After major version updates (architecture changes)
+- Upgrading from v0.7.x to v0.8.x (new global storage)
+- Troubleshooting projects not working after update
 
-## Migration Process
+## Migration: Before → After
 
-### Before (Legacy Structure)
+**Before (Legacy)**:
 ```
-your-project/
-  .prjct/
-    core/
-    planning/
-    progress/
-    memory/
-    analysis/
-    prjct.config.json  # Full config
+your-project/.prjct/     # All data locally
+  core/, planning/, progress/, memory/, analysis/
 ```
 
-### After (Global Storage)
+**After (Global)**:
 ```
-your-project/
-  .prjct/
-    prjct.config.json  # Minimal (projectId + dataPath only)
-
-~/.prjct-cli/projects/3a5667a5dedb/
-  core/
-  planning/
-  progress/
-  memory/
-  analysis/
-  agents/
-  project.json  # System config (authors, version, etc.)
-```
-
-## Output Example
+your-project/.prjct/
+  prjct.config.json      # Minimal (projectId + dataPath only)
 
+~/.prjct-cli/projects/{id}/
+  core/, planning/, progress/, memory/, analysis/, agents/
 ```
-🔄 Scanning for legacy prjct projects...
-
-📁 Found 3 projects in global storage
-
-🔄 Migrating: /Users/jj/Apps/my-app
-   ✅ Migrated successfully
-
-🔄 Migrating: /Users/jj/Apps/other-project
-   ⏭️  Already migrated
-
-📊 Migration Summary:
-   ✅ Migrated: 1
-   ⏭️  Skipped: 1
-   ❌ Failed: 0
-```
-
-## Error Handling
-
-- **No global storage**: Creates directory structure
-- **Missing project paths**: Skips projects with invalid paths
-- **Permission errors**: Reports which projects couldn't be migrated
-- **Already migrated**: Safely skips without changes
 
 ## Safety
 
 - **Idempotent**: Safe to run multiple times
 - **Non-destructive**: Original files only removed with `--remove-legacy`
-- **Dry run available**: Test migration with `--dry-run` first
+- **Dry run**: Test with `--dry-run` first
 - **Automatic backup**: Legacy data preserved until explicitly removed
 
 ## Requirements
 
 - Write permissions to `~/.prjct-cli/` and project directories
 - Projects must have valid global config in `project.json`
-
-## Notes
-
-- This command does NOT require an initialized prjct project
-- Migration is automatic on install (but manual execution is safer)
-- Always test with `--dry-run` first for large migrations
-- Can be safely interrupted and resumed

package/templates/commands/next.md

@@ -1,34 +1,14 @@
 ---
 allowed-tools: [Read]
-description: 'Show priority queue (top 5 non-blocking)'
+description: 'Show priority queue'
 ---
 
 # /p:next
 
 ## Flow
+1. Check `core/now.md` → warn if active
+2. Read `core/next.md` → top 5 non-blocked
 
-1. Check: `core/now.md` → if active task, show warning
-2. Read: `core/next.md` → filter blocked tasks
-3. Return: top 5 actionable
-
-## Response (active task)
-
-```
-⚠️  Active: {current_task}
-Started: {time_ago}
-
-Complete first: /p:done
-
-📋 Queue preview:
-{top_5_numbered}
-```
-
-## Response (no active)
-
-```
-📋 Priority Queue
-
-{numbered_tasks_1_to_5}
-
-/p:build {1-5} | /p:build "{task}"
-```
+## Response
+**Active**: `⚠️ Active: {task} | Complete: /p:done`
+**Queue**: Show 1-5 → `/p:work {N}`

package/templates/commands/now.md

@@ -1,33 +1,14 @@
 ---
-allowed-tools: [Read, Write]
-description: 'Manage current focus task'
+allowed-tools: [Read, Write, GetTimestamp]
+description: 'Current task'
+timestamp-rule: 'GetTimestamp() for timestamps'
 ---
 
 # /p:now
 
-## Usage
-
-```
-/p:now              # Show
-/p:now [task]       # Set
-```
-
 ## Flow
-
-**Show**: Read `core/now.md` → display task + elapsed
-
-**Set**:
-
-1. Write: `core/now.md` with task + timestamp
-2. Update: `core/context.md`, `progress/metrics.md`
-3. Log: `memory/context.jsonl`
+**Show**: Read `core/now.md`
+**Set**: Write now.md + {GetTimestamp()} → Log
 
 ## Response
-
-```
-🎯 {task}
-Started: {time}
-
-Done? → /p:done
-Stuck? → /p:stuck
-```
+`🎯 {task} | Started: {time} | Done: /p:done`

package/templates/commands/pause.md

@@ -0,0 +1,18 @@
+---
+allowed-tools: [Read, Write, GetTimestamp]
+description: 'Pause task'
+timestamp-rule: 'GetTimestamp() for paused'
+---
+
+# /p:pause
+
+## Check
+Requires active in `core/stack.jsonl`
+
+## Flow
+1. Find active → Set status='paused', paused={GetTimestamp()}
+2. Update stack.jsonl + now.md
+3. Log: `{"ts":"{GetTimestamp()}","type":"task_pause","task":"{t}"}`
+
+## Response
+`⏸️ {task} | Active: {duration} | Resume: /p:resume`

package/templates/commands/progress.md

@@ -1,59 +1,14 @@
 ---
 allowed-tools: [Read]
-description: 'Progress metrics for period'
+description: 'Progress metrics'
 ---
 
 # /p:progress
 
-## Usage
-
-```
-/p:progress [day|week|month]  # Default: week
-```
-
 ## Flow
-
-1. Parse: timeframe (day/week/month)
-2. **Calculate date range**: Based on timeframe
-3. **Read sessions**: Query `progress/sessions/{YYYY-MM}/` for date range
-4. **Aggregate**: Ships, tasks, duration from sessions
-5. **Calculate**: Velocity, trends, quality metrics
-6. Display: detailed metrics
-
-## Session Queries by Period
-
-```javascript
-// Day: Today's sessions
-const today = await readSessionFile('progress/sessions', today)
-const shipped = today.filter(s => s.type === 'feature_ship')
-
-// Week: Last 7 days
-const weekSessions = await readSessions('progress/sessions', -7, 'now')
-const velocity = weekSessions.filter(s => s.type === 'feature_ship').length / 7
-
-// Month: Last 30 days
-const monthSessions = await readSessions('progress/sessions', -30, 'now')
-const totalTime = monthSessions
-  .filter(s => s.type === 'feature_ship')
-  .reduce((sum, s) => sum + parseTime(s.duration), 0)
-```
+1. Parse period (day/week/month, default: week)
+2. Read sessions → filter by date range
+3. Aggregate: ships, velocity, trends
 
 ## Response
-
-```
-📈 PROGRESS - This {period}
-━━━━━━━━━━━━━━━━━━━━━
-
-🚀 SHIPPED: {N} features
-⚡ VELOCITY: {X.X} features/day
-📊 TREND: {↗ +X%}
-
-Recent ships:
-• ✅ {feature} ({time_ago})
-• ✅ {feature} ({time_ago})
-
-🏆 Best day: {day} ({N} features)
-🔥 Streak: {N} days
-
-/p:ship | /p:status
-```
+`📈 {period} | 🚀 {N} shipped | ⚡ {velocity}/day | Trend: {↗%}`

package/templates/commands/recap.md

@@ -1,63 +1,14 @@
 ---
 allowed-tools: [Read]
-description: 'Project context and status overview'
+description: 'Project overview'
 ---
 
 # /p:recap
 
-## Usage
-
-```
-/p:recap              # Full overview
-/p:context            # Alias for recap
-```
-
 ## Flow
-
-1. **Read indexes**: Recent data from core/, progress/, planning/ (last 30 days)
-2. **Read sessions**: Last 7 days from all session directories
-3. **Aggregate**: Metrics from sessions (features added, tasks done, ships)
-4. **Display**: Comprehensive context and status
-
-## Session Queries
-
-```javascript
-// Aggregate last 7 days activity
-const recentSessions = await readSessions('*/sessions', -7, 'now')
-const shipped = recentSessions.filter(s => s.type === 'feature_ship').length
-const tasksComplete = recentSessions.filter(s => s.type === 'task_complete').length
-const velocity = shipped / 7 // features per day
-```
+1. Read: core/, progress/, planning/ (30 days)
+2. Read: sessions (7 days) → aggregate metrics
+3. Show: project, focus, progress, activity
 
 ## Response
-
-```
-📊 PROJECT OVERVIEW
-━━━━━━━━━━━━━━━━━━
-
-📦 PROJECT
-Type: {type}
-Stack: {stack}
-
-🎯 CURRENT FOCUS
-Task: {task}
-Started: {time_ago} ({duration})
-
-📈 PROGRESS
-Shipped: {X} this week
-Velocity: {X.X} features/day
-
-💡 PLANNING
-Queue: {N} tasks
-Ideas: {M} captured
-Roadmap: {X}% complete
-
-🔄 RECENT ACTIVITY
-• {event}: {desc} ({time_ago})
-• {event}: {desc} ({time_ago})
-• {event}: {desc} ({time_ago})
-
-{motivational_message}
-
-/p:now | /p:status | /p:next
-```
+`📊 {project} | 🎯 {task} | 📈 {shipped}/week | Queue: {N}`

package/templates/commands/resume.md

@@ -0,0 +1,97 @@
+---
+allowed-tools: [Read, Write, GetTimestamp]
+description: 'Resume paused task'
+timestamp-rule: 'GetTimestamp() for resumed'
+---
+
+# /p:resume
+
+## Check
+- Requires paused tasks
+- Blocks if active exists
+
+## Flow
+1. Select: last/ID/# → Set status='active', resumed={GetTimestamp()}
+2. Update stack.jsonl + now.md → Log resume
+
+## Response
+`▶️ {task} | Paused: {duration} | {agent} | Done: /p:done`
+
+## Examples
+
+### Resume last paused
+```
+/p:resume
+→ Resumes most recently paused task
+→ Picks up exactly where you left off
+```
+
+### Resume specific task
+```
+/p:resume task-1234567890
+→ Resumes task by ID
+```
+
+### Resume by number
+```
+/p:resume 2
+→ Resumes 2nd task from paused list
+→ Useful when shown list by /p:stack
+```
+
+## Stack Display Format
+
+When multiple paused tasks exist:
+```
+⏸️  Paused tasks (3):
+
+1. Fix login validation bug
+   Paused 10m ago | Active time: 45m
+
+2. Implement dark mode toggle
+   Paused 2h ago | Active time: 1h 20m
+
+3. Update documentation
+   Paused yesterday | Active time: 30m
+
+Resume: /p:resume {1-3}
+```
+
+## Natural Language Support
+
+Detect intent for resume:
+- "p. resume" → Resume last paused
+- "p. continue" → Resume last paused
+- "p. back to {task}" → Resume matching task
+- "p. resume 2" → Resume task #2
+
+## Error Handling
+
+### No paused tasks
+```
+❌ No paused tasks to resume
+
+See what's in queue:
+→ /p:next
+
+Start new task:
+→ /p:work "{task}"
+```
+
+### Active task exists
+```
+❌ Already working on: {current_task}
+
+Options:
+→ /p:done (complete current)
+→ /p:pause (pause current)
+→ /p:switch {task_id} (atomic switch)
+```
+
+### Invalid task ID
+```
+❌ Task {id} not found or not paused
+
+See paused tasks:
+→ /p:stack
+```

package/templates/commands/ship.md

@@ -1,148 +1,27 @@
 ---
-allowed-tools: [Read, Write, Bash]
-description: 'Ship feature with complete automated workflow'
+allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
+description: 'Ship feature workflow'
+timestamp-rule: 'GetTimestamp() and GetDate() for timestamps'
 ---
 
 # /p:ship
 
-## Usage
+## Workflow (non-blocking)
+1. Lint → Tests → Docs update
+2. Version bump → CHANGELOG
+3. Commit + push (prjct footer)
+4. Log: `progress/sessions/{YY-MM}/{DD}.jsonl`
+5. Update: `progress/shipped.md` (30 days)
+6. Recommend: compact
 
-```
-/p:ship              # Current task
-/p:ship "<feature>"  # Named feature
-```
-
-## Complete Workflow (Automated)
-
-1. ✅ **Lint checks** → Run project linters
-2. ✅ **Run tests** → Execute test suite (does NOT block if fail)
-3. ✅ **Update docs** → Update relevant documentation
-4. ✅ **Update version** → Bump version (patch/minor based on changes)
-5. ✅ **Update CHANGELOG** → Add entry with changes
-6. ✅ **Git commit** → Create commit with metadata
-7. ✅ **Git push** → Push to remote
-8. ✅ **Recommend compact** → Suggest conversation compacting
-
-## Workflow Steps Detail
-
-### Step 1: Lint Checks
-
-```bash
-npm run lint || yarn lint || pnpm lint
-# If fails: Show errors but continue
-```
-
-### Step 2: Run Tests
-
-```bash
-npm test || yarn test || pnpm test
-# If fails: Show results but DO NOT block (no infinite loop)
-# User decides if acceptable to ship
-```
-
-### Step 3: Update Docs
-
-- Update README if needed
-- Update API docs if endpoints changed
-- Update component docs if UI changed
+## Data
+Session: `{"ts":"{GetTimestamp()}","type":"feature_ship","name":"{f}","agent":"{a}","version":"{v}"}`
 
-### Step 4: Update Version
-
-```json
-// package.json
-"version": "X.Y.Z" → "X.Y.(Z+1)"  // patch for fixes
-"version": "X.Y.Z" → "X.(Y+1).0"  // minor for features
+Commit footer:
 ```
-
-### Step 5: Update CHANGELOG
-
-```markdown
-## [X.Y.Z] - YYYY-MM-DD
-
-### Added / Changed / Fixed
-
-- {feature_description}
-- Agent: {agent}
-- Time: {actual_time}
-```
-
-### Step 6-7: Git Commit + Push
-
-Auto-commit with metadata and push
-
-### Step 8: Log to Session
-
-Append to `progress/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl`:
-
-```jsonl
-{"ts":"2025-10-04T18:00:00Z","type":"feature_ship","name":"{feature}","tasks_done":{N},"duration":"{Xh}","agent":"{agent}","version":"{X.Y.Z}"}
-```
-
-### Step 9: Update Index
-
-Prepend to `progress/shipped.md` (keep only last 30 days):
-
-```markdown
-## 2025-10-04
-- ✅ {feature_name} ({Xh}, {N} tasks, v{X.Y.Z})
-```
-
-If shipped.md has entries > 30 days old, archive to `progress/archive/shipped-{YYYY-MM}.md`
-
-### Step 10: Update Roadmap
-
-Mark feature as complete in `planning/roadmap.md`:
-
-```markdown
-## Completed
-- [x] {feature_name} - Shipped 2025-10-04
-```
-
-### Step 11: Recommend Compact
-
-Suggest compacting conversation after ship
-
-## Commit Message Format
-
-```
-feat: {feature_name}
-
-Agent: {agent}
-Dev: @{github_dev}
-Complexity: {complexity}
-Time: {actual_time}
-
 🤖 Generated with [p/](https://www.prjct.app/)
 Designed for [Claude](https://www.anthropic.com/claude)
 ```
 
-**IMPORTANT**: This footer format MUST be used in ALL commits made by prjct.
-
 ## Response
-
-```
-🚀 {feature} shipped!
-
-Workflow completed:
-  ✅ Lint checks: {pass/fail_continued}
-  ✅ Tests: {pass/fail_continued}
-  ✅ Docs: updated
-  ✅ Version: {old} → {new}
-  ✅ CHANGELOG: updated
-  ✅ Git: committed + pushed
-
-{agent_icon} {agent} • {actual_time}
-
-💡 Recommendation: Compact conversation now
-   (Keeps context clean for next feature)
-
-/p:feature | /p:done
-```
-
-## Important Notes
-
-- **Tests/Lint failures DO NOT block shipping**
-- User sees results and decides
-- Prevents infinite loop of "fix → test → fail → fix"
-- ALWAYS updates version and CHANGELOG
-- ALWAYS commits and pushes if workflow completes
+`🚀 {feature} | {agent} | {time} | v{version} | Next: compact`

package/templates/commands/status.md

@@ -1,42 +1,17 @@
 ---
 allowed-tools: [Read]
-description: 'KPI dashboard with ASCII graphics'
+description: 'KPI dashboard'
 ---
 
 # /p:status
 
 ## Flow
+Read metrics → Calculate KPIs → ASCII dashboard
 
-1. Read: all core files + progress files
-2. Calculate: metrics (sprint %, tasks complete, days since ship, etc.)
-3. Render: `ASCIIGraphics.createDashboard(data)`
-
-## Data Structure
-
-```js
-{
-  sprintProgress: (complete / total) * 100,
-  tasksComplete: count,
-  tasksTotal: count,
-  ideasCount: count,
-  daysSinceShip: days,
-  currentTask: string,
-  taskTime: 'Xh Ym ago'
-}
-```
-
-## Output (Catppuccin Mocha)
-
+## Display
 ```
-┌─ Project Status ────────────────┐
-│ Sprint Progress  [████░] 80%    │
-│ Tasks Complete   12/15          │
-│ Ideas Backlog    8              │
-│ Days Since Ship  3              │
-├─ Current Focus ─────────────────┤
-│ → {current_task}                │
-│   Started: {time_ago}           │
-└─────────────────────────────────┘
+Sprint: [████░] {%}
+Tasks: {done}/{total}
+Ship: {days} ago
+Focus: {task}
 ```
-
-**Colors**: Mauve borders, Teal progress, Sapphire highlights, Green/Yellow/Red for status