prjct-cli 0.4.0

package/templates/commands/progress.md

@@ -0,0 +1,92 @@
+---
+allowed-tools: [Read, Glob]
+description: "Show progress metrics for specified 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.
+
+## Usage
+```
+/p:progress [day|week|month]
+```
+
+Default: week
+
+## 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
+
+## Implementation
+
+1. **Parse timeframe**:
+   - day: last 24 hours
+   - week: current ISO week
+   - month: current calendar month
+
+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
+
+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%)
+
+   💡 PLANNING EXECUTION
+   Roadmap progress: 23% complete
+   Ideas converted: 4/8 (50% rate)
+   Strategic alignment: High
+
+   🧠 LEARNING & DECISIONS
+   Decisions logged: 3 critical
+   Key insights: Architecture patterns
+   Knowledge growth: +15% complexity
+
+   Recent ships:
+   • ✅ User authentication (2h ago)
+   • ✅ Dashboard redesign (1d ago)
+   • ✅ API optimization (2d ago)
+
+   🏆 Best day: Tuesday (3 features)
+   🔥 Current streak: 5 days
+
+   📂 Deep dive:
+   - Metrics: .prjct/progress/metrics.md
+   - Shipped: .prjct/progress/shipped.md
+   ```
+
+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!"

package/templates/commands/recap.md

@@ -0,0 +1,86 @@
+---
+allowed-tools: [Read, Glob]
+description: "Show project 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 - Project Recap
+
+## Purpose
+Display a comprehensive overview of project status and progress.
+
+## Usage
+```
+/p:recap
+```
+
+## 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

package/templates/commands/roadmap.md

@@ -0,0 +1,107 @@
+---
+allowed-tools: [Read, Write, Edit, TodoWrite]
+description: "Strategic planning and feature 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.
+
+## Usage
+```
+/p:roadmap [show|add|complete|next]
+```
+
+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
+
+### `/p:roadmap next`
+Show next priority item to work on
+
+## Implementation
+
+**Roadmap structure** in `.prjct/planning/roadmap.md`:
+```markdown
+# Product Roadmap
+
+## 🚀 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
+```
+
+**Smart prioritization**:
+- Impact vs effort matrix
+- User value scoring
+- Technical dependencies
+- Strategic alignment
+
+**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
+
+💡 Start next: /p:now "Dashboard redesign"
+```
+
+**Response format for add**:
+```
+✅ Added to roadmap: "Payment integration"
+
+📍 Prioritized as: Next Up #1
+⚡ Estimated effort: Medium (3-5 days)
+🎯 Impact score: High
+🔗 Dependencies: User authentication ✅
+
+📋 Updated roadmap in .prjct/planning/roadmap.md
+```
+
+## Features
+- Visual progress tracking
+- Smart prioritization
+- Sprint management
+- Velocity tracking
+- Strategic alignment

package/templates/commands/ship.md

@@ -0,0 +1,41 @@
+---
+allowed-tools: [Read, Write, Edit, TodoWrite]
+description: "Ship a feature"
+---
+
+# /p:ship
+
+## Usage
+```
+/p:ship <feature>
+```
+
+## Execution
+
+1. Add to `~/.prjct-cli/projects/{id}/progress/shipped.md`:
+   ```markdown
+   ## Week [W], [YEAR]
+   - ✅ [feature] ([timestamp])
+   ```
+
+2. Update `progress/metrics.md` (count, velocity, streak)
+3. Update `core/context.md`
+4. Log to `memory/context.jsonl`:
+   ```json
+   {"action":"ship","feature":"[desc]","timestamp":"[ISO]","week":"[w]","layer":"progress","total":[n]}
+   ```
+
+5. Response:
+   ```
+   🚀 [feature name] shipped!
+
+   📈 This week: [count] | Total: [total]
+   Velocity: [X] features/day
+
+   Keep the momentum!
+   • "start next task" → Keep building
+   • "see my progress" → View stats
+   • "plan ahead" → Strategic thinking
+
+   Or: /p:now | /p:recap | /p:roadmap
+   ```

package/templates/commands/stuck.md

@@ -0,0 +1,48 @@
+---
+allowed-tools: [Read]
+description: "Get unstuck"
+---
+
+# /p:stuck
+
+## Usage
+```
+/p:stuck <issue>
+```
+
+## Execution
+
+1. Detect issue type (bug/design/perf/feature)
+2. Check context:
+   - `~/.prjct-cli/projects/{id}/analysis/repo-summary.md`
+   - `~/.prjct-cli/projects/{id}/memory/context.jsonl`
+3. Log to `memory/context.jsonl`:
+   ```json
+   {"action":"stuck","issue":"[desc]","category":"[type]","approach":"[steps]","status":"in_progress"}
+   ```
+
+4. Response by type:
+
+   **Bug**: `🔍 1. Check logs 2. Isolate problem 3. Search error`
+
+   **Design**: `🎨 1. Define requirements 2. Start simple 3. Ship MVP`
+
+   **Performance**: `⚡ 1. Profile first 2. Fix slowest 3. Cache operations`
+
+   **Default**: `💡 1. Break into tasks 2. Start smallest 3. Ship it`
+
+5. Suggest breakdown + next actions:
+   ```
+   💡 [Type-specific guidance above]
+
+   Let's break it down:
+   1. [subtask 1] (~15min)
+   2. [subtask 2] (~30min)
+
+   Ready to start?
+   • "start the first part" → Begin small
+   • "add these as tasks" → Queue them
+   • "think more" → Capture ideas
+
+   Or: /p:now "[first subtask]" | /p:task | /p:idea
+   ```

package/templates/commands/task.md

@@ -0,0 +1,97 @@
+---
+allowed-tools: [Read, Write, Edit, TodoWrite, Bash, Glob]
+description: "Break down and execute complex tasks systematically"
+---
+
+## 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:task - Complex Task Execution
+
+## Purpose
+Handle complex features by breaking them down, executing systematically, and tracking progress. No overwhelm.
+
+## Usage
+```
+/p:task <description>
+```
+
+## Execution
+1. Analyze task complexity
+2. Break into 3-7 subtasks automatically
+3. Create execution plan in `.prjct/planning/tasks/`
+4. Execute each subtask with validation
+5. Track progress and update metrics
+
+## Implementation
+
+**Task breakdown**:
+- Identify main components needed
+- Order by dependencies
+- Estimate time for each
+- Create actionable subtasks
+
+**Example breakdown**:
+```
+/p:task "implement user authentication"
+
+📋 Task Plan Created:
+
+1. Database schema (15 min)
+   - User table with email/password
+   - Sessions table
+
+2. Auth middleware (30 min)
+   - JWT token generation
+   - Route protection
+
+3. API endpoints (45 min)
+   - POST /auth/signup
+   - POST /auth/login
+   - POST /auth/logout
+
+4. Frontend forms (30 min)
+   - Login component
+   - Signup component
+
+5. Testing (20 min)
+   - Auth flow tests
+   - Security tests
+
+🚀 Starting execution...
+[1/5] Creating database schema... ✅
+[2/5] Building auth middleware... 🔄
+```
+
+**Progress tracking**:
+- Real-time status updates
+- Save progress between sessions
+- Resume interrupted tasks
+- Log to `.prjct/memory/context.jsonl`
+
+**Response format**:
+```
+✅ Task completed: User authentication
+
+📊 Execution Summary:
+• Time: 2h 15min (estimated 2h 20min)
+• Subtasks: 5/5 completed
+• Tests: All passing
+• Files: 12 created/modified
+
+📝 Logged to: .prjct/planning/tasks/auth_system.md
+
+💡 Next: /p:ship "user authentication"
+```
+
+## Features
+- Automatic task decomposition
+- Progress persistence
+- Time tracking
+- Dependency management
+- Smart validation gates

package/templates/commands/test.md

@@ -0,0 +1,94 @@
+---
+allowed-tools: [Bash, Read, Edit, Glob]
+description: "Run tests and auto-fix simple failures"
+---
+
+## 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:test - Smart Test Execution
+
+## Purpose
+Run tests, show failures clearly, and auto-fix obvious issues. Ship with confidence.
+
+## Usage
+```
+/p:test [all|unit|e2e|failed]
+```
+
+Default: all
+
+## Execution
+1. Detect test runner (jest/vitest/mocha/pytest)
+2. Run tests with appropriate command
+3. Parse and display results with clarity
+4. Auto-fix simple test failures
+5. Update `.prjct/progress/metrics.md` with coverage
+
+## Implementation
+
+**Test detection**:
+```bash
+# Auto-detect test command from package.json or config
+- npm test / npm run test
+- pytest / python -m pytest
+- go test ./...
+- cargo test
+```
+
+**Auto-fixable issues**:
+- Snapshot updates → Update automatically
+- Timeout errors → Increase timeout
+- Import errors → Fix imports
+- Expected vs received → Show diff clearly
+
+**Response format for success**:
+```
+✅ All tests passing!
+
+📊 Test Results:
+• Unit: 45/45 passed
+• Integration: 12/12 passed
+• E2E: 8/8 passed
+
+🎯 Coverage: 87% (+2%)
+⚡ Time: 4.2s
+
+🚀 Ready to ship!
+```
+
+**Response format for failures**:
+```
+❌ 3 tests failing
+
+1️⃣ UserService.test.js:
+   Expected: "John Doe"
+   Received: "John"
+
+   💡 Auto-fix available: /p:test fix
+
+2️⃣ auth.e2e.js:
+   Timeout after 5000ms
+
+   💡 Increasing timeout to 10000ms...
+
+📊 Summary: 62/65 passed (95%)
+```
+
+**Quick commands**:
+- `/p:test` - Run all tests
+- `/p:test failed` - Re-run only failed tests
+- `/p:test watch` - Run in watch mode
+- `/p:test fix` - Apply available auto-fixes
+
+## Features
+- Smart failure detection
+- Clear error messages
+- Auto-fix common issues
+- Coverage tracking
+- Performance monitoring