prjct-cli 0.8.6 → 0.9.1

package/templates/commands/dash.md

@@ -0,0 +1,241 @@
+---
+allowed-tools: [Read, GetTimestamp, GetDate]
+description: 'Unified dashboard - project status, progress, and roadmap'
+timestamp-rule: 'ALWAYS use GetTimestamp() and GetDate() tools for timestamps'
+---
+
+# /p:dash
+
+## Usage
+
+```
+/p:dash                    # Full dashboard (default view)
+/p:dash week               # Weekly progress focus
+/p:dash month              # Monthly progress focus
+/p:dash roadmap            # Roadmap and planning focus
+/p:dash compact            # Minimal status only
+```
+
+## Flow
+
+1. **Read all relevant files**:
+   - `core/stack.jsonl` → Active and paused tasks
+   - `core/next.md` → Priority queue
+   - `progress/shipped.md` → Recent ships
+   - `planning/roadmap.md` → Active roadmap
+   - `planning/ideas.md` → Recent ideas
+   - `progress/metrics.md` → Velocity metrics
+
+2. **Calculate metrics**:
+   - Current task and elapsed time
+   - Tasks completed today/week/month
+   - Paused tasks count
+   - Queue depth
+   - Days since last ship
+   - Velocity (tasks/week)
+   - Sprint progress percentage
+
+3. **Generate view based on param**:
+   - Default → Balanced overview
+   - Week/Month → Progress focused
+   - Roadmap → Planning focused
+   - Compact → Just essentials
+
+## Response Formats
+
+### Default Dashboard
+
+```
+┌─────────────────────────────────────────┐
+│           📊 PROJECT DASHBOARD          │
+├─────────────────────────────────────────┤
+│ 🎯 Current Focus                        │
+│ {active_task}                           │
+│ Started: {time_ago} | Agent: {agent}    │
+├─────────────────────────────────────────┤
+│ ⏸️  Paused Tasks: {count}               │
+│ 1. {task} (paused {time} ago)          │
+├─────────────────────────────────────────┤
+│ 📋 Priority Queue                       │
+│ • {next_task_1} ({estimate})           │
+│ • {next_task_2} ({estimate})           │
+│ • {next_task_3} ({estimate})           │
+│ → /p:next for full queue                │
+├─────────────────────────────────────────┤
+│ 📈 Progress This Week                   │
+│ Sprint: [████████░░] 80%                │
+│ Completed: {N} tasks                    │
+│ Shipped: {M} features                   │
+│ Velocity: {V} tasks/week                │
+├─────────────────────────────────────────┤
+│ 🚀 Last Ship: {days} days ago          │
+│ {last_shipped_feature}                  │
+├─────────────────────────────────────────┤
+│ 🗺️ Roadmap Status                      │
+│ Phase: {current_phase} ({progress}%)    │
+│ Next milestone: {milestone}             │
+└─────────────────────────────────────────┘
+
+💡 Suggestions:
+{contextual_suggestions_based_on_state}
+```
+
+### Weekly Progress View
+
+```
+📊 WEEKLY PROGRESS - Week of {week_start}
+
+## 🎯 This Week's Accomplishments
+
+### Completed Tasks ({count})
+✅ {task_1} - {duration}
+✅ {task_2} - {duration}
+✅ {task_3} - {duration}
+
+### Features Shipped ({count})
+🚀 {feature_1} - {complexity} - {date}
+🚀 {feature_2} - {complexity} - {date}
+
+## 📈 Metrics
+
+**Velocity**: {tasks_per_day} tasks/day
+**Focus Time**: {total_hours} hours
+**Efficiency**: {completion_rate}%
+**Interruptions**: {pause_count} pauses
+
+## 🔄 Week-over-Week
+
+Compared to last week:
+• Tasks: {trend} ({percentage}%)
+• Velocity: {trend} ({percentage}%)
+• Ships: {trend} ({count_diff})
+
+## 📋 Upcoming
+
+Next week's priorities:
+1. {priority_1}
+2. {priority_2}
+3. {priority_3}
+```
+
+### Roadmap View
+
+```
+🗺️ ROADMAP & PLANNING
+
+## Current Phase: {phase_name}
+Progress: [████████░░] {percentage}%
+Timeline: {start_date} → {end_date}
+Status: {on_track|at_risk|delayed}
+
+### Phase Goals
+• {goal_1} - {status}
+• {goal_2} - {status}
+• {goal_3} - {status}
+
+### Completed Milestones
+✅ {milestone_1} - {date}
+✅ {milestone_2} - {date}
+
+### Upcoming Milestones
+🎯 {milestone_1} - {eta}
+🎯 {milestone_2} - {eta}
+
+## Future Phases
+
+**Phase 2**: {name} ({estimate})
+- {key_feature_1}
+- {key_feature_2}
+
+**Phase 3**: {name} ({estimate})
+- {key_feature_1}
+- {key_feature_2}
+
+## 💡 Recent Ideas ({count})
+• {idea_1} - {priority}
+• {idea_2} - {priority}
+• {idea_3} - {priority}
+
+→ /p:idea for new ideas
+→ /p:feature to add to roadmap
+```
+
+### Compact View
+
+```
+🎯 {active_task} ({time_elapsed})
+📋 Queue: {queue_count} | ⏸️ Paused: {paused_count}
+📈 Week: {tasks_done} done | {velocity}/day
+🚀 Last ship: {days}d ago
+
+→ /p:done | /p:next | /p:ship
+```
+
+## Contextual Suggestions
+
+Based on project state, suggest next actions:
+
+### If no active task
+```
+💡 Start working:
+→ /p:work 1 (from queue)
+→ /p:resume (paused task)
+```
+
+### If haven't shipped recently
+```
+⚠️ {days} days since last ship!
+→ /p:ship "{feature}"
+→ Find quick win in /p:next
+```
+
+### If velocity dropping
+```
+📉 Velocity trend down
+→ Check if tasks too complex
+→ Consider breaking down with /p:feature
+```
+
+### If many paused tasks
+```
+⏸️ {count} tasks paused
+→ Review with /p:stack
+→ Consider completing or dropping
+```
+
+## Natural Language Support
+
+Detect intent:
+- "p. dashboard" → Full dashboard
+- "p. status" → Default view
+- "p. progress" → Weekly view
+- "p. how am I doing" → Default view
+- "p. roadmap" → Roadmap view
+- "p. weekly" → Weekly progress
+
+## ASCII Art Helpers
+
+For progress bars:
+```
+Empty: ░░░░░░░░░░
+Full:  ██████████
+Mixed: ████████░░
+```
+
+For borders:
+```
+┌─┬─┐
+│ │ │
+├─┼─┤
+└─┴─┘
+```
+
+## Migration Note
+
+This command replaces:
+- `/p:status` → Use `/p:dash`
+- `/p:recap` → Use `/p:dash`
+- `/p:progress` → Use `/p:dash week`
+- `/p:roadmap` → Use `/p:dash roadmap`
+
+Old commands will show deprecation notice and redirect here.

package/templates/commands/design.md

@@ -1,38 +1,15 @@
 ---
 allowed-tools: [Read, Write]
-description: 'Design architecture and APIs'
+description: 'Design systems'
 ---
 
 # /p:design
 
-## Usage
-
-```
-/p:design [target] [--type architecture|api|component|database|flow]
-```
-
-## Flow
-
-1. Parse: target + type
-2. Generate: ASCII diagrams
-3. Create: specifications
-4. Save: `designs/{target}-{type}.md`
-
 ## Types
+architecture | api | component | database | flow
 
-- **architecture**: System design, components, data flow
-- **api**: Endpoint specs, schemas, auth
-- **component**: Interfaces, props, state
-- **database**: Schema, relationships, indexes
-- **flow**: User journeys, workflows
+## Flow
+Parse → Generate ASCII diagrams → Specs → Save `designs/{target}-{type}.md`
 
 ## Response
-
-```
-🎨 Design complete!
-
-📐 {target} - {type}
-📄 Saved: designs/{target}-{type}.md
-
-/p:now "Implement {target}"
-```
+`🎨 {target} design | Saved: designs/{target}-{type}.md`

package/templates/commands/done.md

@@ -1,30 +1,16 @@
 ---
 allowed-tools: [Read, Write]
-description: 'Complete task, clear focus'
+description: 'Complete task'
 ---
 
 # /p:done
 
-## Validation
-
-- Requires: `.prjct/prjct.config.json` exists
-- Requires: `core/now.md` has content
-- Else: "Not working on anything. Use /p:now or /p:next"
+## Check
+Requires: `core/now.md` has content
 
 ## Flow
-
-1. Read: `core/now.md` → calculate duration
-2. Clear: `core/now.md`
-3. Update: `progress/metrics.md`, `core/context.md`
-4. Log: `memory/context.jsonl`
+1. Read `core/now.md` → calculate duration
+2. Clear now.md → Update metrics → Log
 
 ## Response
-
-```
-✅ {task} ({duration})
-
-Next?
-• "start {task}" → work
-• "ship {feature}" → celebrate
-• /p:now | /p:ship
-```
+`✅ {task} ({duration}) | Next: /p:now or /p:ship`

package/templates/commands/feature.md

@@ -1,239 +1,26 @@
 ---
-allowed-tools: [Read, Write, Bash]
+allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
 description: 'Value analysis + roadmap + task breakdown + auto-start'
+timestamp-rule: 'GetTimestamp() and GetDate() for ALL timestamps'
 ---
 
 # /p:feature
 
-## Usage
-
-```
-/p:feature "<description>"    # Direct description
-/p:feature                     # Interactive mode with templates
-```
-
-## What It Does
-
-1. **Value analysis**: Impact/effort/timing analysis
-2. **Roadmap**: Positioning in project roadmap
-3. **Task breakdown**: Smart breakdown into logical tasks
-4. **Auto-start**: First task starts automatically
-
-## Interactive Mode (No Parameters)
-
-When executed without parameters, `/p:feature` enters interactive mode with quick start templates.
-
-### Response: Interactive Mode
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 WHAT FEATURE DO YOU WANT TO ADD?
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-You can describe freely or choose a template:
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📋 QUICK START TEMPLATES:
-
-1. 🎨 UI/UX Improvements
-   Examples:
-   • "add dark mode"
-   • "redesign dashboard"
-   • "improve mobile responsiveness"
-   • "add animations and transitions"
-
-2. ⚡ Performance Optimization
-   Examples:
-   • "optimize page load time"
-   • "reduce memory leaks"
-   • "implement code splitting"
-   • "improve API response time"
-
-3. 🔐 Features & Functionality
-   Examples:
-   • "implement user authentication"
-   • "add payment system"
-   • "create admin dashboard"
-   • "implement real-time notifications"
-
-4. 🧪 Quality & Testing
-   Examples:
-   • "add unit tests"
-   • "implement E2E testing"
-   • "add error tracking"
-   • "improve code coverage"
-
-5. 🐛 Bug Fixes & Refactoring
-   Examples:
-   • "refactor authentication flow"
-   • "fix memory leaks"
-   • "clean up deprecated code"
-   • "improve error handling"
-
-6. 📚 Documentation & DevX
-   Examples:
-   • "add API documentation"
-   • "create onboarding guide"
-   • "improve developer setup"
-   • "add code examples"
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💬 HOW TO USE:
-
-Choose a number (1-6) or just describe what you want:
-  "I want to add authentication"
-  "Need to optimize performance"
-  "3" (shows feature examples)
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-What feature do you want to add?
-```
-
-### Template Category Deep Dive
-
-If user selects a category number (1-6):
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-{CATEGORY_ICON} {CATEGORY_NAME}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Common features in this category:
-
-{template_options_with_descriptions}
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Choose one or describe your own:
-```
-
-**Example for Performance (Category 2):**
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-⚡ PERFORMANCE OPTIMIZATION
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Common features in this category:
-
-1. "Optimize page load time"
-   → Bundle analysis, lazy loading, CDN setup
-   Impact: HIGH | Effort: 6-8h
-
-2. "Reduce memory leaks"
-   → Profiling, cleanup, optimization
-   Impact: HIGH | Effort: 4-6h
-
-3. "Implement code splitting"
-   → Route-based, component-based splitting
-   Impact: MEDIUM | Effort: 3-4h
-
-4. "Improve API response time"
-   → Caching, query optimization, CDN
-   Impact: HIGH | Effort: 6-10h
-
-5. "Optimize rendering performance"
-   → React.memo, useMemo, virtualization
-   Impact: MEDIUM | Effort: 4-6h
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Choose a number or describe your specific need:
-```
-
 ## Flow
 
-1. Analyze value (impact/effort/timing)
-2. Position in roadmap
-3. Break down into logical tasks (as many as needed)
-4. **Write to session**: Append to `planning/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl`
-5. **Update index**: Add to `planning/roadmap.md` (lightweight, last 30 days only)
-6. **Queue tasks**: Write to `core/next.md`
-7. Auto-start first task
-
-## Session Log Format
-
-Append to `planning/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl`:
-
-```jsonl
-{"ts":"2025-10-04T14:30:00Z","type":"feature_add","name":"{feature}","tasks":{N},"impact":"{high/med/low}","effort":"{Xh}","status":"queued"}
-```
-
-## Index Update
-
-Append to `planning/roadmap.md` (keep only last 30 days):
-
-```markdown
-## Queued
-- [ ] {feature_name} ({N} tasks, {Xh} estimated) - Added 2025-10-04
-```
+1. **Value**: Impact/effort/timing → do_now/defer/blocked
+2. **Roadmap**: Add to `planning/roadmap.md` (30 days max)
+3. **Tasks**: Break down → `core/next.md`
+4. **Session**: Log to `planning/sessions/{YYYY-MM}/{DD}.jsonl`
+5. **Start**: Auto-start task 1 with agent assignment
 
-If roadmap.md > 30 days old entries, archive them to `planning/archive/roadmap-{YYYY-MM}.md`
+**No params**: Show 6 categories (UI/Performance/Features/Quality/Bugs/Docs)
 
-## Value Analysis
+## Data
 
-```
-Feature: {description}
-
-Value Analysis:
-• Impact: {high/medium/low}
-• Effort: {hours estimation}
-• Timing: {now/later/blocked_by}
-• Recommendation: {do_now/defer/needs_X_first}
-```
-
-## Task Breakdown
-
-```
-Roadmap: {feature_name}
-
-Tasks:
-1. [ ] {task_1}
-2. [ ] {task_2}
-3. [ ] {task_3}
-... (as many as needed)
-
-Estimated: {total_hours}h
-```
+Session: `{"ts":"{GetTimestamp()}","type":"feature_add","name":"{f}","tasks":{n},"impact":"{h/m/l}","effort":"{Xh}"}`
+Roadmap: `- [ ] {feature} ({n} tasks, {Xh}) - {GetDate()}`
 
 ## Response
 
-```
-✅ Feature roadmap created!
-
-{feature_name}
-📊 Value: {impact} | Effort: {hours}h
-⏰ Recommendation: {timing_advice}
-
-Tasks:
-1. {task_1}
-2. {task_2}
-...
-
-¿Empezamos con tarea 1?
-
-/p:done (when task complete) | /p:ship (when feature complete)
-```
-
-## Example
-
-```
-User: p. feature "agregar unit testing"
-
-Claude analyzes:
-- Impact: HIGH (quality improvement)
-- Effort: 8h
-- Timing: NOW (before shipping more features)
-
-Tasks created:
-1. Setup Jest/Vitest configuration
-2. Write tests for core utilities
-3. Write tests for components
-4. Add CI/CD test runner
-5. Update docs with testing guide
-
-"¿Empezamos con tarea 1: Setup Jest/Vitest?"
-```
+`✅ {feature} | Impact: {impact} | {n} tasks | Starting #{1}`