prjct-cli 0.8.8 → 0.9.1

package/templates/commands/build.md

@@ -1,47 +1,17 @@
 ---
 allowed-tools: [Read, Write, GetTimestamp]
-description: 'Start task with agent assignment'
-timestamp-rule: 'CRITICAL - ALWAYS use GetTimestamp() tool for id and started fields. NEVER generate timestamps manually.'
+description: 'Start task'
+timestamp-rule: 'GetTimestamp() for id and started'
 ---
 
 # /p:build
 
-## Validation
-
-- Blocks if: `core/now.md` has active task
-- Error: "Complete current task first. Use /p:done"
+## Check
+Block if `core/now.md` active
 
 ## Flow
-
-1. Parse: task desc OR queue # (1-5)
-2. Detect: `TaskSchema.detectAgent(task)` + complexity
-3. Get: GitHub dev from `git config user.name` + remote
-4. Create: task metadata with agent, complexity, estimate
-5. Write: `core/now.md` with frontmatter (use GetTimestamp() for id and started)
-
-## Frontmatter
-
-**Use GetTimestamp() tool for both id and started fields:**
-
-```yaml
----
-id: task-{GetTimestamp()}
-agent: {detected_agent}
-dev: @{github_username}
-complexity: {trivial|simple|moderate|complex|epic}
-estimated: {time_range}
-started: {GetTimestamp()}
----
-{task_description}
-```
+1. Parse task/# → Detect agent + complexity
+2. Write now.md: id={GetTimestamp()}, agent, started={GetTimestamp()}
 
 ## Response
-
-```
-🎯 {task}
-{agent_icon} {agent_name}
-Est: {time_estimate}
-Complexity: {level}
-
-/p:done when finished
-```
+`🎯 {task} | {agent} | Est: {time} | Done: /p:done`

package/templates/commands/cleanup.md

@@ -1,42 +1,19 @@
 ---
 allowed-tools: [Read, Edit, Bash]
-description: 'Code cleanup and optimization'
+description: 'Code cleanup'
 ---
 
 # /p:cleanup
 
-## Usage
-
-```
-/p:cleanup [--type code|imports|files|deps|all] [--dry-run]
-```
-
-## Flow
-
-1. Parse: type + mode
-2. Backup: create if needed
-3. Execute: cleanup by type
-4. Validate: syntax check
-5. Log: `memory/cleanup-log.jsonl`
-
 ## Types
+- **code**: Remove logs, dead code
+- **imports**: Clean unused
+- **files**: Remove temp/empty
+- **deps**: Find unused
+- **all**: Everything
 
-- **code**: Remove console.logs, commented code, dead code
-- **imports**: Remove unused, organize imports
-- **files**: Remove temp files, empty files
-- **deps**: Analyze unused dependencies
-- **all**: All cleanup types
+## Flow
+Parse type → Backup → Clean → Validate → Log
 
 ## Response
-
-```
-🧹 Cleanup complete!
-
-📊 Results:
-• Console.logs: {N} removed
-• Dead code: {N} blocks
-• Unused imports: {N}
-• Space freed: {X} MB
-
-/p:test | /p:ship
-```
+`🧹 Cleaned: {N} logs, {N} dead code, {N} imports | Freed: {X}MB`

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,98 +1,26 @@
 ---
 allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
 description: 'Value analysis + roadmap + task breakdown + auto-start'
-timestamp-rule: 'CRITICAL - ALWAYS use GetTimestamp() and GetDate() tools for ALL timestamps and dates. NEVER generate dates manually. LLM does not know current date.'
+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, show 6 category templates:
-
-**1. 🎨 UI/UX**: dark mode, redesign, responsiveness, animations
-**2. ⚡ Performance**: load time, memory leaks, code splitting, API speed
-**3. 🔐 Features**: authentication, payments, admin dashboard, notifications
-**4. 🧪 Quality**: unit tests, E2E testing, error tracking, coverage
-**5. 🐛 Bug Fixes**: refactoring, memory leaks, deprecated code, error handling
-**6. 📚 Docs**: API docs, onboarding, developer setup, examples
-
-User can: choose category number OR describe freely
-
 ## 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`:
-
-**Use GetTimestamp() and GetDate() tools to get real system time:**
+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
 
-```jsonl
-{"ts":"{GetTimestamp()}","type":"feature_add","name":"{feature}","tasks":{N},"impact":"{high/med/low}","effort":"{Xh}","status":"queued"}
-```
+**No params**: Show 6 categories (UI/Performance/Features/Quality/Bugs/Docs)
 
-## Index Update
+## Data
 
-Append to `planning/roadmap.md` (keep only last 30 days):
-
-**Use GetDate() tool for current date:**
-
-```markdown
-## Queued
-- [ ] {feature_name} ({N} tasks, {Xh} estimated) - Added {GetDate()}
-```
-
-If roadmap.md > 30 days old entries, archive to `planning/archive/roadmap-{YYYY-MM}.md`
-
-## Value Analysis Format
-
-```
-Feature: {description}
-
-Value Analysis:
-• Impact: {high/medium/low}
-• Effort: {hours estimation}
-• Timing: {now/later/blocked_by}
-• Recommendation: {do_now/defer/needs_X_first}
-```
+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}
-...
-
-Ready to start with task 1?
-
-/p:done (when task complete) | /p:ship (when feature complete)
-```
+`✅ {feature} | Impact: {impact} | {n} tasks | Starting #{1}`

package/templates/commands/help.md

@@ -1,48 +1,19 @@
 ---
 allowed-tools: [Read]
-description: 'Interactive contextual guide - helps users based on their current state'
+description: 'Contextual help'
 ---
 
 # /p:help
 
-## Purpose
-
-Contextual help that analyzes project state and provides relevant guidance based on user's current situation.
-
 ## Flow
-
-1. **Check project state**: Read core files if initialized
-2. **Determine context**: What state is the user in?
-3. **Provide relevant help**: Suggestions based on context
-4. **Show examples**: Concrete examples for their situation
-
-## Context-Based Responses
-
-### 1. Not Initialized
-→ Show welcome, explain `/p:init` vs `/p:init "idea"` (ARCHITECT MODE)
-
-### 2. Empty Queue + No Active Task
-→ Suggest: `/p:feature "{desc}"`, `/p:analyze`, `/p:roadmap`
-→ Emphasize: Can talk naturally, no need to memorize commands
-
-### 3. Has Active Task
-→ Show: current task, duration, started time
-→ Suggest: `/p:done` (finished?), `/p:stuck "{issue}"` (blocked?), `/p:next` (see queue?)
-→ Emphasize: Focus on one task → Ship faster
-
-### 4. Has Queue, No Active Task
-→ Suggest: `/p:next` (see top 5), `/p:build 1` (start #1), `/p:build "{name}"` (start specific)
-→ Show: queue size, last ship time
-→ Tip: `/p:suggest` for personalized recommendations
-
-### 5. Lost/Confused
-→ Show 5 scenarios with examples:
-  - Want to build? → `/p:feature "{desc}"`
-  - Something broken? → `/p:bug "{desc}"`
-  - Don't know what to do? → `/p:suggest`
-  - See progress? → `/p:status` or `/p:recap`
-  - Need guidance? → `/p:ask "{what you want}"`
-→ Emphasize: Natural language works (English & Spanish)
+Check state → Determine context → Show relevant help
+
+## Contexts
+1. **Not init**: Show `/p:init` guide
+2. **Empty**: Suggest `/p:feature` or `/p:analyze`
+3. **Active task**: Show task, suggest `/p:done`
+4. **Has queue**: Suggest `/p:work 1`
+5. **Lost**: Show all options with examples
 
 ## Response Format
 

package/templates/commands/idea.md

@@ -1,37 +1,16 @@
 ---
-allowed-tools: [Write, GetTimestamp, GetDate]
+allowed-tools: [Read, Write, GetTimestamp, GetDate]
 description: 'Quick idea capture'
-timestamp-rule: 'CRITICAL - ALWAYS use GetTimestamp() tool for timestamps. NEVER generate timestamps manually. LLM does not know current date/time.'
+timestamp-rule: 'GetTimestamp() and GetDate() for timestamps'
 ---
 
 # /p:idea
 
-## Usage
-
-```
-/p:idea <text>
-```
-
 ## Flow
-
-1. **Append to session**: `planning/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl` (use GetTimestamp())
-2. **Update index**: Append to `planning/ideas.md` (keep only last 30 days, use GetDate())
-3. If actionable → add to `core/next.md`
-4. **Archive old**: If ideas.md > 30 days, move to `planning/archive/ideas-{YYYY-MM}.md`
-
-## Session Log Format
-
-**Use GetTimestamp() tool for real system time:**
-
-```jsonl
-{"ts":"{GetTimestamp()}","type":"idea_add","idea":"{text}","actionable":{true/false},"priority":"{high/med/low}"}
-```
+1. Log: `planning/sessions/{YY-MM}/{DD}.jsonl`
+   `{"ts":"{GetTimestamp()}","type":"idea_add","idea":"{text}"}`
+2. Update: `planning/ideas.md` with {GetDate()}
+3. If actionable → `core/next.md`
 
 ## Response
-
-```
-💡 {idea}
-{✅ Added to queue | 📝 Saved to backlog}
-
-/p:now "{idea}" | /p:next
-```
+`💡 {idea} | Saved | Start: /p:feature "{idea}"`