prjct-cli 0.8.8 → 0.9.1

package/templates/commands/init.md

@@ -1,102 +1,23 @@
 ---
 allowed-tools: [Read, Write, Bash]
-description: 'Initialize prjct project (with architect mode for blank projects)'
+description: 'Initialize prjct'
 ---
 
 # /p:init
 
-## Usage
+## Flow
 
-```
-/p:init                    # Existing project
-/p:init "[idea]"          # New blank project (architect mode)
-```
-
-## Flow: Existing Project
-
-1. Generate: project ID from path hash
-2. Create: `~/.prjct-cli/projects/{id}/` structure (including `agents/`)
-3. Write: `.prjct/prjct.config.json`
-4. Run: `/p:analyze` to understand stack
-5. Generate: agents based on stack
-6. Log: `memory/context.jsonl`
-
-## Flow: Blank Project (Architect Mode)
-
-1. Generate: project ID
-2. Activate: ARCHITECT role
-3. Analyze: idea/requirements
-4. Recommend: tech stack options (Next.js, React, Vue, etc.)
-5. User confirms: choice
-6. Create: directory structure + base files
-7. Generate: initial roadmap
-8. Generate: agents
-9. Ask: "Ready to start with the first feature?"
-
-## Directory Structure
-
-```
-~/.prjct-cli/projects/{id}/
-├── core/          # now.md, next.md, context.md
-├── progress/      # shipped.md, metrics.md
-├── planning/      # ideas.md, roadmap.md
-├── analysis/      # repo-summary.md
-├── agents/        # AI agent definitions
-└── memory/        # context.jsonl
-```
-
-## Config Format
-
-```json
-{
-  "version": "0.6.0",
-  "projectId": "{id}",
-  "dataPath": "~/.prjct-cli/projects/{id}",
-  "author": {
-    "name": "{from git}",
-    "email": "{from git}",
-    "github": "{from remote}"
-  }
-}
-```
+**Existing**: ID → dirs → config → analyze → agents
+**Blank + idea**: ARCHITECT → analyze → recommend stack → create → roadmap
 
-## Response: Existing Project
+## Structure
+`~/.prjct-cli/projects/{id}/`: core, progress, planning, analysis, agents, memory
 
-```
-✅ prjct initialized!
-
-📁 Data: ~/.prjct-cli/projects/{id}
-📝 Config: .prjct/prjct.config.json
-📊 Analysis: {stack_summary}
-🤖 Agents: {N} agents generated
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 WHAT DO YOU WANT TO DO FIRST?
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-5 clear paths:
-1. 🚀 Add feature → /p:feature "{desc}"
-2. 🐛 Fix bug → /p:bug "{desc}"
-3. 🔍 Analyze deeper → /p:analyze
-4. 📊 See status → /p:status or /p:recap
-5. 💡 Not sure? → /p:suggest or /p:help
-
-💬 OR JUST TELL ME: "I want to add authentication" / "What should I do?"
-
-Let's ship something! 🚀
-```
-
-## Response: Blank Project
-
-After ARCHITECT MODE activates and user confirms stack:
-
-```
-✅ Structure created!
+## Config
+`.prjct/prjct.config.json`: version, projectId, dataPath, author
 
-📁 Project: {path}
-📦 Stack: {chosen_stack}
-📋 Initial roadmap: {N} features
-🤖 Agents: {N} specialists generated
+## Response
+`✅ Init | {stack} | {N} agents | Next: /p:feature or /p:help`
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 🎯 WHAT'S NEXT?

package/templates/commands/next.md

@@ -1,34 +1,14 @@
 ---
 allowed-tools: [Read]
-description: 'Show priority queue (top 5 non-blocking)'
+description: 'Show priority queue'
 ---
 
 # /p:next
 
 ## Flow
+1. Check `core/now.md` → warn if active
+2. Read `core/next.md` → top 5 non-blocked
 
-1. Check: `core/now.md` → if active task, show warning
-2. Read: `core/next.md` → filter blocked tasks
-3. Return: top 5 actionable
-
-## Response (active task)
-
-```
-⚠️  Active: {current_task}
-Started: {time_ago}
-
-Complete first: /p:done
-
-📋 Queue preview:
-{top_5_numbered}
-```
-
-## Response (no active)
-
-```
-📋 Priority Queue
-
-{numbered_tasks_1_to_5}
-
-/p:build {1-5} | /p:build "{task}"
-```
+## Response
+**Active**: `⚠️ Active: {task} | Complete: /p:done`
+**Queue**: Show 1-5 → `/p:work {N}`

package/templates/commands/now.md

@@ -1,34 +1,14 @@
 ---
-allowed-tools: [Read, Write, GetTimestamp, GetDate]
-description: 'Manage current focus task'
-timestamp-rule: 'CRITICAL - ALWAYS use GetTimestamp() tool for ALL timestamps. NEVER generate timestamps manually. LLM does not know current date/time.'
+allowed-tools: [Read, Write, GetTimestamp]
+description: 'Current task'
+timestamp-rule: 'GetTimestamp() for timestamps'
 ---
 
 # /p:now
 
-## Usage
-
-```
-/p:now              # Show
-/p:now [task]       # Set
-```
-
 ## Flow
-
-**Show**: Read `core/now.md` → display task + elapsed
-
-**Set**:
-
-1. Write: `core/now.md` with task + timestamp (use GetTimestamp() tool)
-2. Update: `core/context.md`, `progress/metrics.md`
-3. Log: `memory/context.jsonl` (use GetTimestamp() tool)
+**Show**: Read `core/now.md`
+**Set**: Write now.md + {GetTimestamp()} → Log
 
 ## Response
-
-```
-🎯 {task}
-Started: {time}
-
-Done? → /p:done
-Stuck? → /p:stuck
-```
+`🎯 {task} | Started: {time} | Done: /p:done`

package/templates/commands/pause.md

@@ -0,0 +1,18 @@
+---
+allowed-tools: [Read, Write, GetTimestamp]
+description: 'Pause task'
+timestamp-rule: 'GetTimestamp() for paused'
+---
+
+# /p:pause
+
+## Check
+Requires active in `core/stack.jsonl`
+
+## Flow
+1. Find active → Set status='paused', paused={GetTimestamp()}
+2. Update stack.jsonl + now.md
+3. Log: `{"ts":"{GetTimestamp()}","type":"task_pause","task":"{t}"}`
+
+## Response
+`⏸️ {task} | Active: {duration} | Resume: /p:resume`

package/templates/commands/progress.md

@@ -1,59 +1,14 @@
 ---
 allowed-tools: [Read]
-description: 'Progress metrics for period'
+description: 'Progress metrics'
 ---
 
 # /p:progress
 
-## Usage
-
-```
-/p:progress [day|week|month]  # Default: week
-```
-
 ## Flow
-
-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
-
-## 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)
-```
+1. Parse period (day/week/month, default: week)
+2. Read sessions → filter by date range
+3. Aggregate: ships, velocity, trends
 
 ## Response
-
-```
-📈 PROGRESS - This {period}
-━━━━━━━━━━━━━━━━━━━━━
-
-🚀 SHIPPED: {N} features
-⚡ VELOCITY: {X.X} features/day
-📊 TREND: {↗ +X%}
-
-Recent ships:
-• ✅ {feature} ({time_ago})
-• ✅ {feature} ({time_ago})
-
-🏆 Best day: {day} ({N} features)
-🔥 Streak: {N} days
-
-/p:ship | /p:status
-```
+`📈 {period} | 🚀 {N} shipped | ⚡ {velocity}/day | Trend: {↗%}`

package/templates/commands/recap.md

@@ -1,63 +1,14 @@
 ---
 allowed-tools: [Read]
-description: 'Project context and status overview'
+description: 'Project overview'
 ---
 
 # /p:recap
 
-## Usage
-
-```
-/p:recap              # Full overview
-/p:context            # Alias for recap
-```
-
 ## Flow
-
-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
-```
+1. Read: core/, progress/, planning/ (30 days)
+2. Read: sessions (7 days) → aggregate metrics
+3. Show: project, focus, progress, activity
 
 ## Response
-
-```
-📊 PROJECT OVERVIEW
-━━━━━━━━━━━━━━━━━━
-
-📦 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
-```
+`📊 {project} | 🎯 {task} | 📈 {shipped}/week | Queue: {N}`

package/templates/commands/resume.md

@@ -0,0 +1,97 @@
+---
+allowed-tools: [Read, Write, GetTimestamp]
+description: 'Resume paused task'
+timestamp-rule: 'GetTimestamp() for resumed'
+---
+
+# /p:resume
+
+## Check
+- Requires paused tasks
+- Blocks if active exists
+
+## Flow
+1. Select: last/ID/# → Set status='active', resumed={GetTimestamp()}
+2. Update stack.jsonl + now.md → Log resume
+
+## Response
+`▶️ {task} | Paused: {duration} | {agent} | Done: /p:done`
+
+## Examples
+
+### Resume last paused
+```
+/p:resume
+→ Resumes most recently paused task
+→ Picks up exactly where you left off
+```
+
+### Resume specific task
+```
+/p:resume task-1234567890
+→ Resumes task by ID
+```
+
+### Resume by number
+```
+/p:resume 2
+→ Resumes 2nd task from paused list
+→ Useful when shown list by /p:stack
+```
+
+## Stack Display Format
+
+When multiple paused tasks exist:
+```
+⏸️  Paused tasks (3):
+
+1. Fix login validation bug
+   Paused 10m ago | Active time: 45m
+
+2. Implement dark mode toggle
+   Paused 2h ago | Active time: 1h 20m
+
+3. Update documentation
+   Paused yesterday | Active time: 30m
+
+Resume: /p:resume {1-3}
+```
+
+## Natural Language Support
+
+Detect intent for resume:
+- "p. resume" → Resume last paused
+- "p. continue" → Resume last paused
+- "p. back to {task}" → Resume matching task
+- "p. resume 2" → Resume task #2
+
+## Error Handling
+
+### No paused tasks
+```
+❌ No paused tasks to resume
+
+See what's in queue:
+→ /p:next
+
+Start new task:
+→ /p:work "{task}"
+```
+
+### Active task exists
+```
+❌ Already working on: {current_task}
+
+Options:
+→ /p:done (complete current)
+→ /p:pause (pause current)
+→ /p:switch {task_id} (atomic switch)
+```
+
+### Invalid task ID
+```
+❌ Task {id} not found or not paused
+
+See paused tasks:
+→ /p:stack
+```

package/templates/commands/ship.md

@@ -1,82 +1,27 @@
 ---
 allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
-description: 'Ship feature with complete automated workflow'
-timestamp-rule: 'CRITICAL - ALWAYS use GetTimestamp() and GetDate() tools for ALL timestamps and dates. NEVER generate dates manually. LLM does not know current date.'
+description: 'Ship feature workflow'
+timestamp-rule: 'GetTimestamp() and GetDate() for timestamps'
 ---
 
 # /p:ship
 
-## Usage
+## Workflow (non-blocking)
+1. Lint → Tests → Docs update
+2. Version bump → CHANGELOG
+3. Commit + push (prjct footer)
+4. Log: `progress/sessions/{YY-MM}/{DD}.jsonl`
+5. Update: `progress/shipped.md` (30 days)
+6. Recommend: compact
 
-```
-/p:ship              # Current task
-/p:ship "<feature>"  # Named feature
-```
-
-## Complete Workflow (Automated)
-
-1. ✅ **Lint checks** → Run linters (non-blocking if fail)
-2. ✅ **Run tests** → Execute test suite (non-blocking if fail)
-3. ✅ **Update docs** → README, API docs, component docs if needed
-4. ✅ **Update version** → Bump version (patch/minor based on changes)
-5. ✅ **Update CHANGELOG** → Add entry with metadata
-6. ✅ **Git commit** → With prjct footer format
-7. ✅ **Git push** → Push to remote
-8. ✅ **Log to session** → Append to `progress/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl`
-9. ✅ **Update index** → Prepend to `progress/shipped.md` (last 30 days only)
-10. ✅ **Update roadmap** → Mark as complete in `planning/roadmap.md`
-11. ✅ **Recommend compact** → Suggest conversation compacting
-
-## Session Log Format
-
-Append to `progress/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl`:
+## Data
+Session: `{"ts":"{GetTimestamp()}","type":"feature_ship","name":"{f}","agent":"{a}","version":"{v}"}`
 
-**Use GetTimestamp() tool for real system time:**
-
-```jsonl
-{"ts":"{GetTimestamp()}","type":"feature_ship","name":"{feature}","tasks_done":{N},"duration":"{Xh}","agent":"{agent}","version":"{X.Y.Z}"}
+Commit footer:
 ```
-
-## Commit Message Format
-
-```
-feat: {feature_name}
-
-Agent: {agent}
-Dev: @{github_dev}
-Complexity: {complexity}
-Time: {actual_time}
-
 🤖 Generated with [p/](https://www.prjct.app/)
 Designed for [Claude](https://www.anthropic.com/claude)
 ```
 
-**CRITICAL**: This footer format MUST be used in ALL commits made by prjct.
-
 ## Response
-
-```
-🚀 {feature} shipped!
-
-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}
-
-💡 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
-- **ALWAYS** updates version and CHANGELOG
-- **ALWAYS** commits and pushes if workflow completes
-- Archive `shipped.md` entries > 30 days to `progress/archive/shipped-{YYYY-MM}.md`
+`🚀 {feature} | {agent} | {time} | v{version} | Next: compact`

package/templates/commands/status.md

@@ -1,42 +1,17 @@
 ---
 allowed-tools: [Read]
-description: 'KPI dashboard with ASCII graphics'
+description: 'KPI dashboard'
 ---
 
 # /p:status
 
 ## Flow
+Read metrics → Calculate KPIs → ASCII dashboard
 
-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,
-  tasksComplete: count,
-  tasksTotal: count,
-  ideasCount: count,
-  daysSinceShip: days,
-  currentTask: string,
-  taskTime: 'Xh Ym ago'
-}
-```
-
-## Output (Catppuccin Mocha)
-
+## Display
 ```
-┌─ Project Status ────────────────┐
-│ Sprint Progress  [████░] 80%    │
-│ Tasks Complete   12/15          │
-│ Ideas Backlog    8              │
-│ Days Since Ship  3              │
-├─ Current Focus ─────────────────┤
-│ → {current_task}                │
-│   Started: {time_ago}           │
-└─────────────────────────────────┘
+Sprint: [████░] {%}
+Tasks: {done}/{total}
+Ship: {days} ago
+Focus: {task}
 ```
-
-**Colors**: Mauve borders, Teal progress, Sapphire highlights, Green/Yellow/Red for status

package/templates/commands/sync.md

@@ -1,34 +1,17 @@
 ---
 allowed-tools: [Read, Write, Bash, TodoWrite]
-description: 'Sync project state and generate dynamic agents'
+description: 'Sync state + generate agents'
 ---
 
 # /p:sync
 
 ## Flow
+1. Execute `/p:analyze`
+2. Read `analysis/repo-summary.md`
+3. Generate agents per technology → `agents/`
+4. Log to memory
 
-1. Run: `/p:analyze` → get current state
-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.
+Use: `generateDynamicAgent(name, config)`
 
 ## Response
-
-```
-🔄 Sync complete!
-
-🤖 Agents Generated:
-• {agent_name_1} - {role}
-• {agent_name_2} - {role}
-
-📋 Based on: analysis/repo-summary.md
-💡 See templates/agents/AGENTS.md for generation reference
-
-/p:context
-```
+`🔄 Synced | Generated: {agents} | Next: /p:context`

package/templates/commands/work.md

@@ -0,0 +1,44 @@
+---
+allowed-tools: [Read, Write, GetTimestamp]
+description: 'Show current task or start new one'
+timestamp-rule: 'GetTimestamp() for all timestamps'
+required-agent: auto-detect
+enforce-agent: true
+---
+
+# /p:work
+
+## Flow
+
+**No params**: Show active task from `core/stack.jsonl`
+**With task**: Start new (pause current if exists)
+**With number**: Start task #N from `core/next.md`
+
+### Starting Task
+1. Check active → Pause if exists
+2. Parse input → String or number
+3. **ASSIGN AGENT** → Detect expertise, filter context (70-90% reduction)
+4. Create entry → status='active', agent, filtered_context
+5. Update → `core/stack.jsonl` + `core/now.md`
+6. Log → Agent usage to memory
+
+## Responses
+
+**Active**: `🎯 {task} | {agent} | {duration}`
+**Empty**: `💤 No active task | {paused_count} paused`
+**Started**: `🚀 {task} | Agent: {agent}`
+**Switched**: `⏸️ Paused {old} → Started {new}`
+
+## Agent Detection
+Keywords → Agent:
+- UI/frontend/React → `fe`
+- API/backend/database → `be`
+- design/UX → `ux`
+- test/QA/bug → `qa`
+- docs/README → `docs`
+- else → `general`
+
+## Errors
+**Active exists**: Show options (pause/done/switch)
+**Invalid #**: Task not in queue
+**Migration**: Replaces /p:now and /p:build