prjct-cli 0.6.0 → 0.7.0

package/templates/commands/now.md

@@ -1,11 +1,12 @@
 ---
 allowed-tools: [Read, Write]
-description: "Manage current focus task"
+description: 'Manage current focus task'
 ---
 
 # /p:now
 
 ## Usage
+
 ```
 /p:now              # Show
 /p:now [task]       # Set
@@ -16,11 +17,13 @@ description: "Manage current focus task"
 **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`
 
 ## Response
+
 ```
 🎯 {task}
 Started: {time}
@@ -28,4 +31,3 @@ Started: {time}
 Done? → /p:done
 Stuck? → /p:stuck
 ```
-

package/templates/commands/progress.md

@@ -1,22 +1,45 @@
 ---
 allowed-tools: [Read]
-description: "Progress metrics for period"
+description: 'Progress metrics for period'
 ---
 
 # /p:progress
 
 ## Usage
+
 ```
 /p:progress [day|week|month]  # Default: week
 ```
 
 ## Flow
+
 1. Parse: timeframe (day/week/month)
-2. Read: `progress/shipped.md` + `progress/metrics.md`
-3. Calculate: velocity, trends, quality
-4. Display: detailed metrics
+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)
+```
 
 ## Response
+
 ```
 📈 PROGRESS - This {period}
 ━━━━━━━━━━━━━━━━━━━━━
@@ -34,4 +57,3 @@ Recent ships:
 
 /p:ship | /p:status
 ```
-

package/templates/commands/recap.md

@@ -1,34 +1,63 @@
 ---
 allowed-tools: [Read]
-description: "Project status overview"
+description: 'Project context and status overview'
 ---
 
 # /p:recap
 
+## Usage
+
+```
+/p:recap              # Full overview
+/p:context            # Alias for recap
+```
+
 ## Flow
-1. Read: all data layers (core, progress, planning, analysis, memory)
-2. Aggregate: metrics and status from each layer
-3. Display: comprehensive overview
+
+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
+```
 
 ## Response
+
 ```
-📊 PROJECT RECAP
-━━━━━━━━━━━━━━━━
+📊 PROJECT OVERVIEW
+━━━━━━━━━━━━━━━━━━
 
-🎯 FOCUS
-Current: {task} ({duration})
-Queue: {N} tasks
+📦 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,22 +1,37 @@
 ---
 allowed-tools: [Read, Write]
-description: "Strategic roadmap management"
+description: 'Strategic roadmap management'
 ---
 
 # /p:roadmap
 
 ## Usage
+
 ```
 /p:roadmap [show|add|complete|next]  # Default: show
 ```
 
 ## Flow
+
 1. Parse: action (show/add/complete/next)
-2. Read: `planning/roadmap.md`
-3. Execute: based on action
-4. Update: roadmap file if needed
+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`
+
+## Query Sessions
+
+To get complete roadmap history or specific date range:
+
+```javascript
+// Read sessions for date range
+const sessions = await readSessions('planning/sessions', startDate, endDate)
+const features = sessions.filter(s => s.type === 'feature_add')
+```
 
 ## Response (show)
+
 ```
 📍 PRODUCT ROADMAP
 
@@ -35,4 +50,3 @@ description: "Strategic roadmap management"
 
 /p:now "{next_feature}"
 ```
-

package/templates/commands/ship.md

@@ -1,27 +1,109 @@
 ---
 allowed-tools: [Read, Write, Bash]
-description: "Ship feature with Git commit/push"
+description: 'Ship feature with complete automated workflow'
 ---
 
 # /p:ship
 
 ## Usage
+
 ```
 /p:ship              # Current task
-/p:ship <feature>    # Named feature
+/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
+
+### 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
+```
+
+### 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}"}
 ```
 
-## Flow
-1. Get: feature name (from arg or `core/now.md`)
-2. Git: `add .` → check status
-3. Create: commit message with metadata
-4. Commit: with message
-5. Prompt: "Push? (y/n)"
-6. If yes: `git push`
-7. Update: `progress/shipped.md`, clear `core/now.md`
-8. Log: `memory/context.jsonl`
+### 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
 
-## Commit Message
 ```
 feat: {feature_name}
 
@@ -30,17 +112,37 @@ Dev: @{github_dev}
 Complexity: {complexity}
 Time: {actual_time}
 
-Generated-by: prjct/cli
-Co-Authored-By: @{github_dev}
+🤖 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!
 
-✅ Committed {+ pushed}
+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}
 
-/p:next | /p:status
+💡 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

package/templates/commands/status.md

@@ -1,16 +1,18 @@
 ---
 allowed-tools: [Read]
-description: "KPI dashboard with ASCII graphics"
+description: 'KPI dashboard with ASCII graphics'
 ---
 
 # /p:status
 
 ## Flow
+
 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,
@@ -24,6 +26,7 @@ description: "KPI dashboard with ASCII graphics"
 ```
 
 ## Output (Catppuccin Mocha)
+
 ```
 ┌─ Project Status ────────────────┐
 │ Sprint Progress  [████░] 80%    │
@@ -37,4 +40,3 @@ description: "KPI dashboard with ASCII graphics"
 ```
 
 **Colors**: Mauve borders, Teal progress, Sapphire highlights, Green/Yellow/Red for status
-

package/templates/commands/sync.md

@@ -1,30 +1,34 @@
 ---
-allowed-tools: [Read, Bash, TodoWrite]
-description: "Sync project state and agents"
+allowed-tools: [Read, Write, Bash, TodoWrite]
+description: 'Sync project state and generate dynamic agents'
 ---
 
 # /p:sync
 
 ## Flow
+
 1. Run: `/p:analyze` → get current state
-2. Compare: with previous analysis
-3. Update: all existing agents with new context
-4. Add: newly required agents
-5. Remove: obsolete agents (with confirmation)
-6. Log: changes to `memory/context.jsonl`
+2. **Read**: `analysis/repo-summary.md`
+3. **Generate**: Dynamic agents for each technology
+4. Log: changes to `memory/context.jsonl`
+
+## Agent Generation
+
+**See `templates/agents/AGENTS.md` for complete reference** with examples and guidelines.
+
+Use `generator.generateDynamicAgent(name, config)` for each specialist.
 
 ## Response
+
 ```
 🔄 Sync complete!
 
-📊 Changes:
-• {N} agents updated
-• {N} agents added
-• {N} agents removed
+🤖 Agents Generated:
+• {agent_name_1} - {role}
+• {agent_name_2} - {role}
 
-Stack changes:
-• {changes_list}
+📋 Based on: analysis/repo-summary.md
+💡 See templates/agents/AGENTS.md for generation reference
 
-/p:status | /p:context
+/p:context
 ```
-

package/templates/commands/task.md

@@ -1,16 +1,18 @@
 ---
 allowed-tools: [Read, Write, TodoWrite]
-description: "Break down complex tasks"
+description: 'Break down complex tasks'
 ---
 
 # /p:task
 
 ## Usage
+
 ```
 /p:task <description>
 ```
 
 ## Flow
+
 1. Analyze: task complexity
 2. Break down: into 3-7 subtasks
 3. Create: execution plan
@@ -18,6 +20,7 @@ description: "Break down complex tasks"
 5. Track: progress in `planning/tasks/`
 
 ## Response
+
 ```
 📋 Task Plan: {description}
 
@@ -32,4 +35,3 @@ Est total: {total_time}
 [1/{N}] {subtask}... ✅
 [2/{N}] {subtask}... 🔄
 ```
-

package/templates/commands/test.md

@@ -1,16 +1,18 @@
 ---
 allowed-tools: [Bash, Read, Edit]
-description: "Run tests with auto-fix"
+description: 'Run tests with auto-fix'
 ---
 
 # /p:test
 
 ## Usage
+
 ```
 /p:test [all|unit|e2e|failed|fix]  # Default: all
 ```
 
 ## Flow
+
 1. Detect: test runner (jest/vitest/pytest/etc)
 2. Run: tests with appropriate command
 3. Parse: results
@@ -18,6 +20,7 @@ description: "Run tests with auto-fix"
 5. Update: coverage in `progress/metrics.md`
 
 ## Response (success)
+
 ```
 ✅ All tests passing!
 
@@ -33,6 +36,7 @@ description: "Run tests with auto-fix"
 ```
 
 ## Response (failures)
+
 ```
 ❌ {N} tests failing
 
@@ -42,4 +46,3 @@ description: "Run tests with auto-fix"
 
 📊 Summary: {passed}/{total} ({X}%)
 ```
-

package/templates/commands/workflow.md

@@ -1,22 +1,25 @@
 ---
 allowed-tools: [Read, Write]
-description: "Show workflow status"
+description: 'Show workflow status'
 ---
 
 # /p:workflow
 
 ## Usage
+
 ```
 /p:workflow           # Show status
 /p:workflow skip      # Skip current step
 ```
 
 ## Flow
+
 1. Read: `workflow/state.json`
 2. Display: current step + progress
 3. Check: capabilities for next steps
 
 ## Response
+
 ```
 🔄 Workflow: {task_type}
 
@@ -29,4 +32,3 @@ Next: {next_step}
 
 /p:done | /p:workflow skip
 ```
-