prjct-cli 1.22.0 → 1.24.0

package/templates/commands/verify.md

@@ -1,204 +0,0 @@
----
-allowed-tools: [Bash, Read, Write]
-description: 'Verify workflow completion and close task'
-timestamp-rule: 'GetTimestamp() for ALL timestamps'
-architecture: 'Write-Through (JSON -> MD -> Events)'
-storage-layer: true
-source-of-truth: 'storage/state.json'
----
-
-# /p:verify
-
-Verify all workflow checkpoints are complete and close the task.
-
-## Usage
-
-```
-/p:verify
-```
-
-## Context Variables
-- `{projectId}`: From `.prjct/prjct.config.json`
-- `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
-- `{statePath}`: `{globalPath}/storage/state.json`
-- `{memoryPath}`: `{globalPath}/memory/events.jsonl`
-- `{syncPath}`: `{globalPath}/sync/pending.json`
-- `{nowContextPath}`: `{globalPath}/context/now.md`
-
-## Step 1: Validate Project
-
-READ: `.prjct/prjct.config.json`
-EXTRACT: `projectId`
-
-IF file not found:
-  OUTPUT: "No prjct project. Run /p:init first."
-  STOP
-
-## Step 2: Validate Workflow Phase
-
-READ: `{globalPath}/storage/state.json`
-
-IF currentTask is null:
-  OUTPUT: "No active task. Nothing to verify."
-  STOP
-
-IF currentTask.workflow is null:
-  OUTPUT: "Task has no workflow. This is a legacy task."
-  STOP
-
-IF currentTask.workflow.phase != "register":
-  OUTPUT:
-  ```
-  Cannot verify. Current phase: {currentTask.workflow.phase}
-
-  Required phase: register (after ship)
-
-  Workflow: analyze → branch → implement → test → review → merge → ship → verify
-  
-  Complete p. ship first.
-  ```
-  STOP
-
-## Step 3: Validate All Checkpoints
-
-SET: {checkpoints} = currentTask.workflow.checkpoints
-SET: {required} = ["analyze", "branch", "implement", "test", "review", "merge", "tag", "release", "deploy", "register"]
-SET: {missing} = []
-
-FOR each checkpoint in {required}:
-  IF {checkpoints}[checkpoint] is null:
-    APPEND checkpoint to {missing}
-
-IF {missing}.length > 0:
-  OUTPUT:
-  ```
-  ⚠️ Incomplete workflow
-
-  Missing checkpoints:
-  {FOR each in missing: "- {checkpoint}"}
-
-  Complete all phases before verifying.
-  ```
-  STOP
-
-## Step 4: Calculate Workflow Summary
-
-SET: {startedAt} = currentTask.workflow.startedAt
-SET: {now} = GetTimestamp()
-SET: {totalDuration} = time between {startedAt} and {now}
-FORMAT: as "Xh Ym" or "Xd Xh"
-
-### Gather metrics from checkpoints
-SET: {scope} = checkpoints.analyze.data.scope
-SET: {branchName} = checkpoints.branch.data.branchName
-SET: {coverage} = checkpoints.test.data.coverage
-SET: {mcpScore} = checkpoints.review.data.mcpScore
-SET: {approvals} = checkpoints.review.data.approvals.length
-SET: {mergeCommit} = checkpoints.merge.data.mergeCommit
-SET: {version} = checkpoints.tag.data.version
-SET: {releaseUrl} = checkpoints.release.data.releaseUrl
-
-## Step 5: Complete Workflow
-
-SET: currentTask.workflow.phase = "verify"
-SET: currentTask.workflow.checkpoints.verify = {
-  "completedAt": "{now}",
-  "data": {
-    "verified": true,
-    "totalDuration": "{totalDuration}"
-  }
-}
-SET: currentTask.workflow.completedAt = "{now}"
-SET: currentTask.workflow.lastCheckpoint = "verify"
-
-### Move to previousTask
-SET: state.previousTask = {
-  ...currentTask,
-  "status": "completed",
-  "completedAt": "{now}"
-}
-SET: state.currentTask = null
-SET: state.lastUpdated = "{now}"
-
-WRITE: `{statePath}`
-
-## Step 6: Generate Context
-
-WRITE: `{nowContextPath}`
-
-```markdown
-# NOW
-
-_No active task_
-
-Last completed: {previousTask.description}
-Duration: {totalDuration}
-Version: {version}
-
-Use p. task to start new work.
-```
-
-## Step 7: Log Events
-
-APPEND to `{memoryPath}`:
-```json
-{"timestamp":"{now}","action":"workflow_completed","taskId":"{previousTask.id}","duration":"{totalDuration}","checkpoints":11}
-{"timestamp":"{now}","action":"checkpoint_completed","taskId":"{previousTask.id}","checkpoint":"verify"}
-```
-
-APPEND to `{syncPath}`:
-```json
-{"type":"workflow.completed","data":{"taskId":"{previousTask.id}","duration":"{totalDuration}","version":"{version}"},"timestamp":"{now}"}
-```
-
-## Output
-
-```
-✓ Workflow Complete
-
-Task: {previousTask.description}
-Type: {previousTask.type}
-Duration: {totalDuration}
-Version: {version}
-
-Checkpoints (11/11):
-1. analyze ✓ - Scope: {scope}
-2. branch ✓ - {branchName}
-3. implement ✓
-4. test ✓ - Coverage: {coverage}
-5. review ✓ - MCP: {mcpScore}/100, Approvals: {approvals}
-6. merge ✓ - {mergeCommit}
-7. tag ✓ - v{version}
-8. release ✓ - {releaseUrl}
-9. deploy ✓ - Reminded
-10. register ✓ - Logged
-11. verify ✓ - Complete
-
-Summary:
-- All phases completed
-- Audit trail recorded
-- Task closed
-
-Next: p. task to start new work
-```
-
-## Error Handling
-
-| Error | Response | Action |
-|-------|----------|--------|
-| No project | "No prjct project" | STOP |
-| No active task | "Nothing to verify" | STOP |
-| No workflow | "Legacy task" | STOP |
-| Wrong phase | Show required phase | STOP |
-| Missing checkpoints | List missing | STOP |
-
-## Natural Language Triggers
-
-- `p. verify` -> /p:verify
-- `p. complete` -> /p:verify
-- `p. close` -> /p:verify
-
-## References
-
-- Architecture: `~/.prjct-cli/docs/architecture.md`
-- Workflow: `~/.prjct-cli/docs/workflow.md`

package/templates/commands/workflow.md

@@ -1,150 +0,0 @@
----
-allowed-tools: [Read, Write, Bash, AskUserQuestion]
----
-
-# p. workflow "$ARGUMENTS"
-
-Manage workflow preferences using natural language.
-
-## Step 1: Resolve Project Paths
-
-```bash
-# Get projectId from local config
-cat .prjct/prjct.config.json | grep -o '"projectId"[[:space:]]*:[[:space:]]*"[^"]*"' | cut -d'"' -f4
-```
-
-Set `globalPath = ~/.prjct-cli/projects/{projectId}`
-
----
-
-## If NO argument provided
-
-Show current workflow preferences:
-
-READ `{globalPath}/config/workflow-preferences.json` (or empty object)
-
-**When preferences exist:**
-```
-WORKFLOW PREFERENCES
-────────────────────────────
-  [permanent] before ship    → bun test
-  [session]   after done     → npm run docs
-
-Modify: "p. workflow before ship run npm test"
-Remove: "p. workflow remove ship hook"
-```
-
-**When no preferences:**
-```
-No workflow preferences configured.
-
-Set one: "p. workflow before ship run tests"
-```
-
----
-
-## If argument provided (natural language)
-
-Parse the user's intent and update preferences accordingly.
-
-### Patterns to detect:
-
-| Pattern | Hook | Command | Action |
-|---------|------|---------|--------|
-| "before ship run X" | before | ship | X |
-| "after done run X" | after | done | X |
-| "skip tests on ship" | skip | ship | tests |
-| "remove ship hook" | * | ship | REMOVE |
-
-### Flow:
-
-1. **Detect intent** from natural language
-
-2. **Ask for scope** (ALWAYS):
-
-```
-AskUserQuestion:
-  question: "When should this apply?"
-  header: "Scope"
-  options:
-    - label: "Always (Recommended)"
-      description: "Save permanently in your preferences"
-    - label: "This session only"
-      description: "Until you close the terminal"
-    - label: "Just the next command"
-      description: "Use once and discard"
-```
-
-3. **Save preference**:
-
-READ `{globalPath}/config/workflow-preferences.json` (or create empty object)
-
-For adding/updating:
-```json
-{
-  "preferences": [
-    {
-      "hook": "{before|after|skip}",
-      "command": "{task|done|ship|sync}",
-      "action": "{command to run}",
-      "scope": "{permanent|session|once}",
-      "createdAt": "{timestamp}"
-    }
-  ]
-}
-```
-
-WRITE `{globalPath}/config/workflow-preferences.json`
-
-For removal:
-- Filter out preferences matching the hook and command
-- Write updated file
-
-4. **Confirm**:
-
-```
-IF scope == 'permanent':
-  OUTPUT: "Saved. Before each {command} I'll run: {action}"
-ELSE IF scope == 'session':
-  OUTPUT: "OK. During this session, before {command} I'll run: {action}"
-ELSE:
-  OUTPUT: "OK. On the next {command} I'll run: {action}"
-```
-
----
-
-## Examples
-
-### Setting a hook
-
-```
-User: "p. workflow before ship run bun test"
-
-→ Detect: hook=before, command=ship, action="bun test"
-→ Ask scope
-→ User: "always"
-→ Save preference
-→ Output: "Saved. Before each ship I'll run: bun test"
-```
-
-### Removing a hook
-
-```
-User: "p. workflow remove ship hook"
-
-→ Detect: REMOVE for ship
-→ Remove all hooks for ship command
-→ Output: "Removed. Ship hooks are no longer active."
-```
-
-### Skipping a step
-
-```
-User: "p. workflow skip lint on ship"
-
-→ Detect: hook=skip, command=ship, action="lint"
-→ Ask scope
-→ User: "just this once"
-→ Save preference with scope=once
-→ Output: "OK. On the next ship, lint will be skipped."
-```

package/templates/config/skill-mappings.json

@@ -1,82 +0,0 @@
-{
-  "version": "3.0.0",
-  "description": "Skill packages from skills.sh for auto-installation during sync",
-  "sources": {
-    "primary": {
-      "name": "skills.sh",
-      "url": "https://skills.sh",
-      "installCmd": "npx skills add {package}"
-    },
-    "fallback": {
-      "name": "GitHub direct",
-      "installFormat": "owner/repo"
-    }
-  },
-  "skillsDirectory": "~/.claude/skills/",
-  "skillFormat": {
-    "required": ["name", "description"],
-    "optional": ["license", "compatibility", "metadata", "allowed-tools"],
-    "fileStructure": {
-      "required": "SKILL.md",
-      "optional": ["scripts/", "references/", "assets/"]
-    }
-  },
-  "agentToSkillMap": {
-    "frontend": {
-      "packages": [
-        "anthropics/skills/frontend-design",
-        "vercel-labs/agent-skills/vercel-react-best-practices"
-      ]
-    },
-    "uxui": {
-      "packages": ["anthropics/skills/frontend-design"]
-    },
-    "backend": {
-      "packages": ["obra/superpowers/systematic-debugging"]
-    },
-    "database": {
-      "packages": []
-    },
-    "testing": {
-      "packages": ["obra/superpowers/test-driven-development", "anthropics/skills/webapp-testing"]
-    },
-    "devops": {
-      "packages": ["anthropics/skills/mcp-builder"]
-    },
-    "prjct-planner": {
-      "packages": ["obra/superpowers/brainstorming"]
-    },
-    "prjct-shipper": {
-      "packages": []
-    },
-    "prjct-workflow": {
-      "packages": []
-    }
-  },
-  "documentSkills": {
-    "note": "Official Anthropic document creation skills",
-    "source": "anthropics/skills",
-    "skills": {
-      "pdf": {
-        "name": "pdf",
-        "description": "Create and edit PDF documents",
-        "path": "skills/pdf"
-      },
-      "docx": {
-        "name": "docx",
-        "description": "Create and edit Word documents",
-        "path": "skills/docx"
-      },
-      "pptx": {
-        "name": "pptx",
-        "description": "Create PowerPoint presentations",
-        "path": "skills/pptx"
-      },
-      "xlsx": {
-        "name": "xlsx",
-        "description": "Create Excel spreadsheets",
-        "path": "skills/xlsx"
-      }
-    }
-  }
-}

package/templates/context/dashboard.md

@@ -1,256 +0,0 @@
----
-description: 'Template for generated dashboard context'
-generated-by: 'p. dashboard'
-storage-sources:
-  - storage/roadmap.json
-  - storage/prds.json
-  - storage/shipped.json
-  - storage/outcomes.json
-  - storage/state.json
----
-
-# Dashboard Context Template
-
-This template defines the format for `{globalPath}/context/dashboard.md` generated by `p. dashboard`.
-
----
-
-## Template
-
-```markdown
-# Dashboard
-
-**Project:** {projectName}
-**Generated:** {timestamp}
-
----
-
-## Health Score
-
-**Overall:** {healthScore}/100
-
-| Component | Score | Weight | Contribution |
-|-----------|-------|--------|--------------|
-| Roadmap Progress | {roadmapScore}/100 | 25% | {roadmapContribution} |
-| Estimation Accuracy | {estimationScore}/100 | 25% | {estimationContribution} |
-| Success Rate | {successScore}/100 | 25% | {successContribution} |
-| Velocity Trend | {velocityScore}/100 | 25% | {velocityContribution} |
-
----
-
-## Quick Stats
-
-| Metric | Value | Trend |
-|--------|-------|-------|
-| Features Shipped | {shippedCount} | {shippedTrend} |
-| PRDs Created | {prdCount} | {prdTrend} |
-| Avg Cycle Time | {avgCycleTime}d | {cycleTrend} |
-| Estimation Accuracy | {estimationAccuracy}% | {accuracyTrend} |
-| Success Rate | {successRate}% | {successTrend} |
-| ROI Score | {avgROI} | {roiTrend} |
-
----
-
-## Active Quarter: {activeQuarter.id}
-
-**Theme:** {activeQuarter.theme}
-**Status:** {activeQuarter.status}
-
-### Progress
-
-```
-Features:  {featureBar} {quarterFeatureProgress}%
-Capacity:  {capacityBar} {capacityUtilization}%
-Timeline:  {timelineBar} {timelineProgress}%
-```
-
-### Features
-
-| Feature | Status | Progress | Owner |
-|---------|--------|----------|-------|
-{FOR EACH feature in quarterFeatures:}
-| {feature.name} | {statusEmoji(feature.status)} | {feature.progress}% | {feature.agent || '-'} |
-{END FOR}
-
----
-
-## Current Work
-
-### Active Task
-{IF currentTask:}
-**{currentTask.description}**
-
-- Type: {currentTask.type}
-- Started: {currentTask.startedAt}
-- Elapsed: {elapsed}
-- Branch: {currentTask.branch?.name || 'N/A'}
-
-Subtasks: {completedSubtasks}/{totalSubtasks}
-{ELSE:}
-*No active task*
-{END IF}
-
-### In Progress Features
-
-{FOR EACH feature in activeFeatures:}
-#### {feature.name}
-
-- Progress: {progressBar(feature.progress)} {feature.progress}%
-- Quarter: {feature.quarter || 'Unassigned'}
-- PRD: {feature.prdId || 'None'}
-- Dependencies: {feature.dependencies?.join(', ') || 'None'}
-{END FOR}
-
----
-
-## Pipeline
-
-```
-PRDs          Features       Active         Shipped
-┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
-│ Draft   │──▶│ Planned │──▶│ Active  │──▶│ Shipped │
-│  ({draft})  │   │  ({planned}) │   │  ({active})  │   │  ({shipped}) │
-└─────────┘   └─────────┘   └─────────┘   └─────────┘
-     │
-     ▼
-┌─────────┐
-│Approved │
-│  ({approved}) │
-└─────────┘
-```
-
----
-
-## Metrics Trends (Last 4 Weeks)
-
-### Velocity
-```
-W-3: {velocityW3Bar} {velocityW3}
-W-2: {velocityW2Bar} {velocityW2}
-W-1: {velocityW1Bar} {velocityW1}
-W-0: {velocityW0Bar} {velocityW0}
-```
-
-### Estimation Accuracy
-```
-W-3: {accuracyW3Bar} {accuracyW3}%
-W-2: {accuracyW2Bar} {accuracyW2}%
-W-1: {accuracyW1Bar} {accuracyW1}%
-W-0: {accuracyW0Bar} {accuracyW0}%
-```
-
----
-
-## Alerts & Actions
-
-### Warnings
-{FOR EACH alert in alerts:}
-- {alert.icon} {alert.message}
-{END FOR}
-
-### Suggested Actions
-{FOR EACH action in suggestedActions:}
-1. {action.description}
-   - Command: `{action.command}`
-{END FOR}
-
----
-
-## Recent Activity
-
-| Date | Action | Details |
-|------|--------|---------|
-{FOR EACH event in recentEvents.slice(0, 10):}
-| {event.date} | {event.action} | {event.details} |
-{END FOR}
-
----
-
-## Learnings Summary
-
-### Top Patterns
-{FOR EACH pattern in topPatterns.slice(0, 5):}
-- {pattern.insight} ({pattern.frequency}x)
-{END FOR}
-
-### Improvement Areas
-{FOR EACH area in improvementAreas:}
-- **{area.name}**: {area.suggestion}
-{END FOR}
-
----
-
-*Generated by prjct-cli | https://prjct.app*
-```
-
----
-
-## Health Score Calculation
-
-```javascript
-const healthScore = Math.round(
-  (roadmapProgress * 0.25) +
-  (estimationAccuracy * 0.25) +
-  (successRate * 0.25) +
-  (normalizedVelocity * 0.25)
-)
-```
-
-| Score Range | Health Level | Color |
-|-------------|--------------|-------|
-| 80-100 | Excellent | Green |
-| 60-79 | Good | Blue |
-| 40-59 | Needs Attention | Yellow |
-| 0-39 | Critical | Red |
-
----
-
-## Alert Definitions
-
-| Condition | Alert | Severity |
-|-----------|-------|----------|
-| `capacityUtilization > 90` | Quarter capacity nearly full | Warning |
-| `estimationAccuracy < 60` | Estimation accuracy below target | Warning |
-| `activeFeatures.length > 3` | Too many features in progress | Info |
-| `draftPRDs.length > 3` | PRDs awaiting review | Info |
-| `successRate < 70` | Success rate declining | Warning |
-| `velocityTrend < -20` | Velocity dropping | Warning |
-| `currentTask && elapsed > 4h` | Task running long | Info |
-
----
-
-## Suggested Actions Matrix
-
-| Condition | Suggested Action | Command |
-|-----------|------------------|---------|
-| No active task | Start a task | `p. task` |
-| PRDs in draft | Review PRDs | `p. prd list` |
-| Features pending review | Record impact | `p. impact` |
-| Quarter ending soon | Plan next quarter | `p. plan quarter` |
-| Low estimation accuracy | Analyze estimates | `p. dashboard estimates` |
-
----
-
-## Integration with Linear/Jira/Monday
-
-The dashboard context maps to PM tool dashboards:
-
-| Dashboard Section | Linear | Jira | Monday |
-|-------------------|--------|------|--------|
-| Health Score | Project Health | Dashboard Gadget | Board Overview |
-| Active Quarter | Cycle | Sprint | Timeline |
-| Pipeline | Workflow Board | Kanban | Board |
-| Velocity | Velocity Chart | Velocity Report | Chart Widget |
-| Alerts | Notifications | Issues | Notifications |
-
----
-
-## Refresh Frequency
-
-| Data Type | Refresh Trigger |
-|-----------|-----------------|
-| Current Task | Real-time (on state change) |
-| Features | On feature status change |
-| Metrics | On `p. dashboard` execution |
-| Aggregates | On `p. impact` completion |
-| Alerts | Calculated on view |