prjct-cli 0.5.1 → 0.7.0

package/templates/commands/next.md

@@ -1,74 +1,34 @@
 ---
-allowed-tools: [Read, Write, Edit]
-description: "Display and manage priority queue"
+allowed-tools: [Read]
+description: 'Show priority queue (top 5 non-blocking)'
 ---
 
-## Global Architecture
-This command uses the global prjct architecture:
-- Data stored in: `~/.prjct-cli/projects/{id}/`
-- Config stored in: `{project}/.prjct/prjct.config.json`
-- Commands synchronized across all editors
+# /p:next
 
+## Flow
 
+1. Check: `core/now.md` → if active task, show warning
+2. Read: `core/next.md` → filter blocked tasks
+3. Return: top 5 actionable
 
-# /p:next - Priority Queue
+## Response (active task)
 
-## Purpose
-Display the prioritized queue of upcoming tasks.
-
-## Usage
-```
-/p:next
 ```
+⚠️  Active: {current_task}
+Started: {time_ago}
 
-## Execution
-1. Read `.prjct/core/next.md`
-2. Display numbered list of pending tasks with context
-3. Show task count and suggest next action
-4. Reference related planning and progress layers
-
-## Implementation
-
-1. **Read core/next.md**:
-   - Parse markdown list of tasks
-   - Number them for easy reference
-   - Show task priorities and contexts
-
-2. **Context integration**:
-   - Reference planning/roadmap.md for strategic context
-   - Show progress/metrics.md for capacity planning
-   - Link to analysis/repo-summary.md for technical context
+Complete first: /p:done
 
-3. **Response format**:
-   ```
-   📋 Priority Queue ([count] tasks):
-
-   1. [first task]
-      - Context: [link to planning/analysis if relevant]
-      - Priority: [high/medium/low]
-   2. [second task]
-   3. [third task]
-   ...
-
-   💡 Start next task with: /p:now "[first task]"
-   📊 Context: See planning/roadmap.md for strategic priorities
-   ```
+📋 Queue preview:
+{top_5_numbered}
+```
 
-   Or if empty:
-   ```
-   📋 Queue is empty!
+## Response (no active)
 
-   Add tasks:
-   - Directly edit .prjct/core/next.md
-   - Use /p:idea for quick capture
-   - Check /p:roadmap for strategic planning
+```
+📋 Priority Queue
 
-   📂 Related:
-   - Planning: .prjct/planning/roadmap.md
-   - Ideas: .prjct/planning/ideas.md
-   ```
+{numbered_tasks_1_to_5}
 
-## Tips
-- Keep queue short (5-10 items)
-- Most important tasks first
-- Review and reprioritize regularly
+/p:build {1-5} | /p:build "{task}"
+```

package/templates/commands/now.md

@@ -1,35 +1,33 @@
 ---
-allowed-tools: [Read, Write, Edit, TodoWrite]
-description: "Manage current focus task"
+allowed-tools: [Read, Write]
+description: 'Manage current focus task'
 ---
 
 # /p:now
 
 ## Usage
+
 ```
-/p:now              # Show current
-/p:now [task]       # Set focus
+/p:now              # Show
+/p:now [task]       # Set
 ```
 
-## Execution
+## Flow
 
-**Show**: Read `~/.prjct-cli/projects/{id}/core/now.md`, display task + elapsed time
+**Show**: Read `core/now.md` → display task + elapsed
 
 **Set**:
-1. Update `core/now.md` with task + timestamp
-2. Update `core/context.md`, `progress/metrics.md`
-3. Log to `memory/context.jsonl`:
-   ```json
-   {"action":"now","task":"[task]","timestamp":"[ISO]","previous":"[old]","layer":"core"}
-   ```
-4. Response:
-   ```
-   🎯 Working on: [task description]
-   Started: [time]
-
-   When you're done:
-   • "I'm done" or "finished"
-   • Or type: /p:done
-
-   Need help? Say "I'm stuck" or use /p:stuck
-   ```
+
+1. Write: `core/now.md` with task + timestamp
+2. Update: `core/context.md`, `progress/metrics.md`
+3. Log: `memory/context.jsonl`
+
+## Response
+
+```
+🎯 {task}
+Started: {time}
+
+Done? → /p:done
+Stuck? → /p:stuck
+```

package/templates/commands/progress.md

@@ -1,92 +1,59 @@
 ---
-allowed-tools: [Read, Glob]
-description: "Show progress metrics for specified period"
+allowed-tools: [Read]
+description: 'Progress metrics for period'
 ---
 
-## Global Architecture
-This command uses the global prjct architecture:
-- Data stored in: `~/.prjct-cli/projects/{id}/`
-- Config stored in: `{project}/.prjct/prjct.config.json`
-- Commands synchronized across all editors
-
-
-
-# /p:progress - Progress Metrics
-
-## Purpose
-Display detailed progress metrics and trends for a specified time period.
+# /p:progress
 
 ## Usage
+
 ```
-/p:progress [day|week|month]
+/p:progress [day|week|month]  # Default: week
 ```
 
-Default: week
+## Flow
 
-## Execution
-1. Read from `.prjct/progress/shipped.md` for shipped features
-2. Aggregate metrics from `.prjct/progress/metrics.md`
-3. Calculate velocity and trends across layers
-4. Cross-reference with planning and analysis layers
-5. Display comprehensive progress indicators
+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
 
-## Implementation
+## Session Queries by Period
 
-1. **Parse timeframe**:
-   - day: last 24 hours
-   - week: current ISO week
-   - month: current calendar month
+```javascript
+// Day: Today's sessions
+const today = await readSessionFile('progress/sessions', today)
+const shipped = today.filter(s => s.type === 'feature_ship')
 
-2. **Calculate layered metrics**:
-   - **Progress Layer**: Features shipped, velocity, trends
-   - **Core Layer**: Task completion rate, focus time
-   - **Planning Layer**: Roadmap progress, idea conversion rate
-   - **Memory Layer**: Decision impact, learning velocity
+// Week: Last 7 days
+const weekSessions = await readSessions('progress/sessions', -7, 'now')
+const velocity = weekSessions.filter(s => s.type === 'feature_ship').length / 7
 
-3. **Enhanced response format**:
-   ```
-   📈 PROGRESS - This Week
-   ━━━━━━━━━━━━━━━━━━━━━━━
-
-   🚀 SHIPPED FEATURES
-   Count: 7 features (↗ +40% vs last week)
-   Velocity: 1.4 features/day
-   Quality: 95% passed validation
-
-   ⚡ CORE PRODUCTIVITY
-   Tasks completed: 12 (avg 1.7/day)
-   Focus time: 28h (70% efficiency)
-   Context switches: 3 (↘ -50%)
+// 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)
+```
 
-   💡 PLANNING EXECUTION
-   Roadmap progress: 23% complete
-   Ideas converted: 4/8 (50% rate)
-   Strategic alignment: High
+## Response
 
-   🧠 LEARNING & DECISIONS
-   Decisions logged: 3 critical
-   Key insights: Architecture patterns
-   Knowledge growth: +15% complexity
+```
+📈 PROGRESS - This {period}
+━━━━━━━━━━━━━━━━━━━━━
 
-   Recent ships:
-   • ✅ User authentication (2h ago)
-   • ✅ Dashboard redesign (1d ago)
-   • ✅ API optimization (2d ago)
+🚀 SHIPPED: {N} features
+⚡ VELOCITY: {X.X} features/day
+📊 TREND: {↗ +X%}
 
-   🏆 Best day: Tuesday (3 features)
-   🔥 Current streak: 5 days
+Recent ships:
+• ✅ {feature} ({time_ago})
+• ✅ {feature} ({time_ago})
 
-   📂 Deep dive:
-   - Metrics: .prjct/progress/metrics.md
-   - Shipped: .prjct/progress/shipped.md
-   ```
+🏆 Best day: {day} ({N} features)
+🔥 Streak: {N} days
 
-4. **Visual indicators**:
-   - 📈 Improving
-   - ➡️ Steady
-   - 📉 Declining
-   
-5. **Motivational insights**:
-   - "You're 40% more productive than last week!"
-   - "On track to ship 10 features this week!"
-   - "Your best week yet!"
+/p:ship | /p:status
+```

package/templates/commands/recap.md

@@ -1,86 +1,63 @@
 ---
-allowed-tools: [Read, Glob]
-description: "Show project status overview"
+allowed-tools: [Read]
+description: 'Project context and status overview'
 ---
 
-## Global Architecture
-This command uses the global prjct architecture:
-- Data stored in: `~/.prjct-cli/projects/{id}/`
-- Config stored in: `{project}/.prjct/prjct.config.json`
-- Commands synchronized across all editors
+# /p:recap
 
+## Usage
 
+```
+/p:recap              # Full overview
+/p:context            # Alias for recap
+```
 
-# /p:recap - Project Recap
+## Flow
 
-## Purpose
-Display a comprehensive overview of project status and progress.
+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
 
-## Usage
+## 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
 ```
-/p:recap
+
+## Response
+
 ```
+📊 PROJECT OVERVIEW
+━━━━━━━━━━━━━━━━━━
 
-## Execution
-1. Read current task from `.prjct/core/now.md`
-2. Aggregate metrics from `.prjct/progress/metrics.md`
-3. Count shipped features from `.prjct/progress/shipped.md`
-4. Count queue items from `.prjct/core/next.md`
-5. Count ideas from `.prjct/planning/ideas.md`
-6. Reference project analysis and context
-7. Display comprehensive layered summary
-
-## Implementation
-
-1. **Gather cross-layer metrics**:
-   - **Core Layer**: Current task and duration, next queue
-   - **Progress Layer**: Shipped features, metrics, velocity trends
-   - **Planning Layer**: Ideas count, roadmap progress
-   - **Analysis Layer**: Repository insights, technical context
-   - **Memory Layer**: Decision history, learnings
-
-2. **Enhanced response format**:
-   ```
-   📊 PROJECT RECAP
-   ━━━━━━━━━━━━━━━━━━━
-
-   🎯 FOCUS
-   Current: [task] (2h 15m)
-   Queue: [N] tasks pending
-
-   📈 PROGRESS
-   Shipped: [X] this week, [Y] total
-   Velocity: [X.X] features/day
-   Streak: [N] days shipping
-
-   💡 PLANNING
-   Ideas: [M] captured
-   Roadmap: [X]% complete
-
-   🔍 INSIGHTS
-   Repository: [project_type] with [tech_stack]
-   Architecture: [key_patterns]
-
-   🧠 MEMORY
-   Decisions: [N] logged
-   Learnings: [key_insights]
-
-   [Motivational message based on metrics]
-
-   📂 Quick Access:
-   - Core: .prjct/core/ (focus & priorities)
-   - Progress: .prjct/progress/ (metrics & shipped)
-   - Planning: .prjct/planning/ (ideas & roadmap)
-   - Analysis: .prjct/analysis/ (technical insights)
-   ```
-
-3. **Motivational messages**:
-   - High velocity: "🔥 You're on fire! Keep shipping!"
-   - Many ideas: "💡 Creative flow is strong!"
-   - Long streak: "🏆 Consistency champion!"
-   - Empty queue: "🎆 Time to dream bigger!"
-
-## Visual Elements
-- Use progress bars for completion
-- Show week-over-week trends
-- Highlight achievements
+📦 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
+```

package/templates/commands/roadmap.md

@@ -1,107 +1,52 @@
 ---
-allowed-tools: [Read, Write, Edit, TodoWrite]
-description: "Strategic planning and feature roadmap management"
+allowed-tools: [Read, Write]
+description: 'Strategic roadmap management'
 ---
 
-## Global Architecture
-This command uses the global prjct architecture:
-- Data stored in: `~/.prjct-cli/projects/{id}/`
-- Config stored in: `{project}/.prjct/prjct.config.json`
-- Commands synchronized across all editors
-
-
-
-# /p:roadmap - Strategic Planning
-
-## Purpose
-Plan features, track strategic progress, and stay aligned with goals. Zero PM overhead.
+# /p:roadmap
 
 ## Usage
+
 ```
-/p:roadmap [show|add|complete|next]
+/p:roadmap [show|add|complete|next]  # Default: show
 ```
 
-Default: show
-
-## Execution
-
-### `/p:roadmap` or `/p:roadmap show`
-Display current roadmap with progress
-
-### `/p:roadmap add <feature>`
-Add feature to roadmap with smart prioritization
-
-### `/p:roadmap complete <feature>`
-Mark feature as shipped and celebrate
+## Flow
 
-### `/p:roadmap next`
-Show next priority item to work on
+1. Parse: action (show/add/complete/next)
+2. **Read index**: `planning/roadmap.md` (last 30 days)
+3. **Read sessions**: Last 3-7 days from `planning/sessions/{YYYY-MM}/` for details
+4. Execute: based on action
+5. Update: roadmap index if needed
+6. Archive: entries > 30 days to `planning/archive/roadmap-{YYYY-MM}.md`
 
-## Implementation
+## Query Sessions
 
-**Roadmap structure** in `.prjct/planning/roadmap.md`:
-```markdown
-# Product Roadmap
+To get complete roadmap history or specific date range:
 
-## 🚀 Current Sprint (Week X)
-- [x] User authentication
-- [ ] Dashboard redesign
-- [ ] API optimization
-
-## 📅 Next Up
-- [ ] Real-time notifications
-- [ ] Data export feature
-- [ ] Mobile responsive design
-
-## 🌟 Future Vision
-- [ ] AI recommendations
-- [ ] Team collaboration
-- [ ] Analytics dashboard
+```javascript
+// Read sessions for date range
+const sessions = await readSessions('planning/sessions', startDate, endDate)
+const features = sessions.filter(s => s.type === 'feature_add')
 ```
 
-**Smart prioritization**:
-- Impact vs effort matrix
-- User value scoring
-- Technical dependencies
-- Strategic alignment
+## Response (show)
 
-**Response format for show**:
 ```
 📍 PRODUCT ROADMAP
 
-🚀 Current Sprint (23% complete)
-├── ✅ User authentication
-├── 🔄 Dashboard redesign (in progress)
-└── ⏳ API optimization
-
-📅 Next Up (3 features)
-├── Real-time notifications
-├── Data export feature
-└── Mobile responsive design
-
-📊 Progress Metrics:
-• Sprint velocity: 1.4 features/week
-• On track for: Dec 15 completion
-• Strategic alignment: High
+🚀 Current Sprint ({X}% complete)
+├── ✅ {feature}
+├── 🔄 {feature} (in progress)
+└── ⏳ {feature}
 
-💡 Start next: /p:now "Dashboard redesign"
-```
-
-**Response format for add**:
-```
-✅ Added to roadmap: "Payment integration"
+📅 Next Up ({N} features)
+├── {feature}
+└── {feature}
 
-📍 Prioritized as: Next Up #1
-⚡ Estimated effort: Medium (3-5 days)
-🎯 Impact score: High
-🔗 Dependencies: User authentication ✅
+📊 Progress:
+• Velocity: {X.X} features/week
+• On track: {date}
 
-📋 Updated roadmap in .prjct/planning/roadmap.md
+/p:now "{next_feature}"
 ```
-
-## Features
-- Visual progress tracking
-- Smart prioritization
-- Sprint management
-- Velocity tracking
-- Strategic alignment