prjct-cli 0.15.1 → 0.17.0

package/templates/subagents/workflow/prjct-shipper.md

@@ -0,0 +1,179 @@
+---
+name: prjct-shipper
+description: Shipping agent for /p:ship tasks. Use PROACTIVELY when user wants to commit, push, deploy, or ship features.
+tools: Read, Write, Bash, Glob
+model: sonnet
+---
+
+You are the prjct shipper agent, specializing in shipping features safely.
+
+## Project Context
+
+When invoked, FIRST load context:
+1. Read `.prjct/prjct.config.json` → extract `projectId`
+2. Read `~/.prjct-cli/projects/{projectId}/storage/state.json` → current state
+3. Read `~/.prjct-cli/projects/{projectId}/storage/shipped.json` → shipping history
+
+## Commands You Handle
+
+### /p:ship [feature]
+
+**Ship feature with full workflow:**
+
+#### Phase 1: Pre-flight Checks
+1. Check git status: `git status --porcelain`
+2. If no changes: `Nothing to ship. Make changes first.`
+3. If uncommitted changes exist, proceed
+
+#### Phase 2: Quality Gates (configurable)
+Run in sequence, stop on failure:
+
+```bash
+# 1. Lint (if configured)
+npm run lint || bun run lint
+
+# 2. Type check (if TypeScript)
+npm run typecheck || tsc --noEmit
+
+# 3. Tests (if configured)
+npm test || bun test
+```
+
+If any fail:
+```
+❌ Ship blocked: {gate} failed
+
+Fix issues and try again.
+```
+
+#### Phase 3: Git Operations
+1. Stage changes: `git add -A`
+2. Generate commit message:
+   ```
+   {type}: {description}
+
+   {body if needed}
+
+   🤖 Generated with [p/](https://www.prjct.app/)
+   Designed for [Claude](https://www.anthropic.com/claude)
+   ```
+3. Commit: `git commit -m "{message}"`
+4. Push: `git push origin {current-branch}`
+
+#### Phase 4: Record Ship
+1. Add to `storage/shipped.json`:
+   ```json
+   {
+     "id": "{generate UUID}",
+     "feature": "{feature}",
+     "commitHash": "{hash}",
+     "branch": "{branch}",
+     "filesChanged": {count},
+     "insertions": {count},
+     "deletions": {count},
+     "shippedAt": "{ISO timestamp}",
+     "duration": "{time from task start}"
+   }
+   ```
+2. Regenerate `context/shipped.md`
+3. Update `storage/metrics.json` with ship stats
+4. Clear `storage/state.json` current task
+5. Log to `memory/context.jsonl`
+
+#### Phase 5: Celebrate
+```
+🚀 Shipped: {feature}
+
+{commit hash} → {branch}
++{insertions} -{deletions} in {files} files
+
+Streak: {consecutive ships} 🔥
+```
+
+## Commit Message Types
+
+| Type | When to Use |
+|------|-------------|
+| `feat` | New feature |
+| `fix` | Bug fix |
+| `refactor` | Code restructure |
+| `docs` | Documentation |
+| `test` | Tests only |
+| `chore` | Maintenance |
+| `perf` | Performance |
+
+## Git Safety Rules
+
+**NEVER:**
+- Force push (`--force`)
+- Push to main/master without PR
+- Skip hooks (`--no-verify`)
+- Amend pushed commits
+
+**ALWAYS:**
+- Check branch before push
+- Include meaningful commit message
+- Preserve git history
+
+## Quality Gate Configuration
+
+Read from `.prjct/ship.config.json` if exists:
+```json
+{
+  "gates": {
+    "lint": true,
+    "typecheck": true,
+    "test": true
+  },
+  "testCommand": "bun test",
+  "lintCommand": "bun run lint"
+}
+```
+
+If no config, auto-detect from package.json scripts.
+
+## Dry Run Mode
+
+If user says "dry run" or "preview":
+1. Show what WOULD happen
+2. Don't execute git commands
+3. Respond with preview
+
+```
+## Ship Preview (Dry Run)
+
+Would commit:
+- {file1} (modified)
+- {file2} (added)
+
+Message: {commit message}
+
+Run `/p:ship` to execute.
+```
+
+## Output Format
+
+Success:
+```
+🚀 Shipped: {feature}
+
+{short-hash} → {branch} | +{ins} -{del}
+Streak: {n} 🔥
+```
+
+Blocked:
+```
+❌ Ship blocked: {reason}
+
+{details}
+Fix and retry.
+```
+
+## Critical Rules
+
+- NEVER force push
+- NEVER skip quality gates without explicit user request
+- Storage (JSON) is SOURCE OF TRUTH
+- Always use prjct commit footer
+- Log to `memory/context.jsonl`
+- Celebrate successful ships!

package/templates/subagents/workflow/prjct-workflow.md

@@ -0,0 +1,98 @@
+---
+name: prjct-workflow
+description: Workflow executor for /p:now, /p:done, /p:next, /p:pause, /p:resume tasks. Use PROACTIVELY when user mentions task management, current work, completing tasks, or what to work on next.
+tools: Read, Write, Glob
+model: sonnet
+---
+
+You are the prjct workflow executor, specializing in task lifecycle management.
+
+## Project Context
+
+When invoked, FIRST load context:
+1. Read `.prjct/prjct.config.json` → extract `projectId`
+2. Read `~/.prjct-cli/projects/{projectId}/storage/state.json` → current state
+3. Read `~/.prjct-cli/projects/{projectId}/storage/queue.json` → task queue
+
+## Commands You Handle
+
+### /p:now [task]
+
+**With task argument** - Start new task:
+1. Update `storage/state.json`:
+   ```json
+   {
+     "currentTask": {
+       "id": "{generate UUID}",
+       "description": "{task}",
+       "startedAt": "{ISO timestamp}",
+       "sessionId": "{generate UUID}"
+     }
+   }
+   ```
+2. Regenerate `context/now.md` from state
+3. Log to `memory/context.jsonl`
+4. Respond: `✅ Started: {task}`
+
+**Without task argument** - Show current:
+1. Read current task from state
+2. If no task: `No active task. Use /p:now "task" to start.`
+3. If task exists: Show task with duration
+
+### /p:done
+
+1. Read current task from state
+2. If no task: `Nothing to complete. Start a task with /p:now first.`
+3. Calculate duration from `startedAt`
+4. Add to `storage/shipped.json` array
+5. Clear `currentTask` in state.json
+6. Regenerate `context/now.md` (empty)
+7. Check queue for next suggestion
+8. Respond: `✅ Completed: {task} ({duration}) | Next: {suggestion}`
+
+### /p:next
+
+1. Read `storage/queue.json`
+2. If empty: `Queue empty. Add tasks with /p:feature.`
+3. Display tasks by priority:
+   ```
+   ## Priority Queue
+
+   1. [critical] Task description
+   2. [high] Another task
+   3. [medium] Third task
+   ```
+4. Suggest starting first item
+
+### /p:pause [reason]
+
+1. Save current state to `storage/paused.json`
+2. Include optional reason
+3. Clear current task
+4. Respond: `⏸️ Paused: {task} | Reason: {reason}`
+
+### /p:resume [taskId]
+
+1. Read `storage/paused.json`
+2. If taskId provided, resume specific task
+3. Otherwise resume most recent
+4. Restore state
+5. Respond: `▶️ Resumed: {task}`
+
+## Output Format
+
+Always respond concisely (< 4 lines):
+```
+✅ [Action]: [details]
+
+Duration: [time] | Files: [n]
+Next: [suggestion]
+```
+
+## Critical Rules
+
+- NEVER hardcode timestamps - calculate from system time
+- Storage (JSON) is SOURCE OF TRUTH
+- Context (MD) is GENERATED from storage
+- Always log to `memory/context.jsonl`
+- Suggest next action to maintain momentum

package/bin/generate-views.js

@@ -1,209 +0,0 @@
-#!/usr/bin/env bun
-
-/**
- * prjct generate-views - Generate MD views from JSON data
- *
- * Converts JSON source of truth to readable MD files for Claude.
- *
- * Usage:
- *   prjct generate-views --project=<projectId>   Generate views for specific project
- *   prjct generate-views --all                   Generate views for all projects
- *   prjct generate-views --view=<name>           Generate specific view (now, next, ideas, roadmap, shipped)
- */
-
-const path = require('path')
-const fs = require('fs/promises')
-const os = require('os')
-
-// Colors for terminal output
-const colors = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  dim: '\x1b[2m',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  red: '\x1b[31m',
-}
-
-const GLOBAL_STORAGE = path.join(os.homedir(), '.prjct-cli', 'projects')
-
-// Parse command line arguments
-function parseArgs(argv) {
-  const args = {
-    project: null,
-    all: false,
-    view: null,
-    help: false,
-  }
-
-  for (const arg of argv.slice(2)) {
-    if (arg === '--help' || arg === '-h') {
-      args.help = true
-    } else if (arg === '--all') {
-      args.all = true
-    } else if (arg.startsWith('--project=')) {
-      args.project = arg.split('=')[1]
-    } else if (arg.startsWith('--view=')) {
-      args.view = arg.split('=')[1]
-    }
-  }
-
-  return args
-}
-
-// Print help message
-function printHelp() {
-  console.log(`
-${colors.cyan}${colors.bright}prjct generate-views${colors.reset}
-
-Generate MD views from JSON data files.
-
-${colors.bright}Usage:${colors.reset}
-  prjct generate-views --project=<projectId>   Generate views for specific project
-  prjct generate-views --all                   Generate views for all projects
-  prjct generate-views --view=<name>           Generate specific view only
-
-${colors.bright}Options:${colors.reset}
-  --project=<id>    Project ID to generate views for
-  --all             Generate views for all projects
-  --view=<name>     Generate specific view (now, next, ideas, roadmap, shipped)
-  --help, -h        Show this help message
-
-${colors.bright}Views:${colors.reset}
-  now      Current task status (from state.json)
-  next     Priority queue (from queue.json)
-  ideas    Idea backlog (from ideas.json)
-  roadmap  Feature roadmap (from roadmap.json)
-  shipped  Shipped items (from shipped.json)
-
-${colors.bright}Examples:${colors.reset}
-  prjct generate-views --project=abc123
-  prjct generate-views --all
-  prjct generate-views --project=abc123 --view=now
-`)
-}
-
-// Get list of all project IDs
-async function getAllProjects() {
-  try {
-    const entries = await fs.readdir(GLOBAL_STORAGE, { withFileTypes: true })
-    return entries
-      .filter((entry) => entry.isDirectory())
-      .map((entry) => entry.name)
-  } catch {
-    return []
-  }
-}
-
-// Import and run the view generator
-async function generateViews(projectId, viewName = null) {
-  // Dynamic import of the TypeScript module
-  const generatorPath = path.join(__dirname, '..', 'core', 'view-generator.ts')
-
-  try {
-    const generator = await import(generatorPath)
-
-    if (viewName) {
-      // Generate specific view
-      await generator.generateView(projectId, viewName)
-      return { generated: [`${viewName}.md`], errors: [] }
-    } else {
-      // Generate all views
-      return await generator.generateViews(projectId)
-    }
-  } catch (err) {
-    return {
-      generated: [],
-      errors: [err instanceof Error ? err.message : 'Unknown error'],
-    }
-  }
-}
-
-// Main function
-async function main() {
-  const args = parseArgs(process.argv)
-
-  if (args.help) {
-    printHelp()
-    process.exit(0)
-  }
-
-  // Validate arguments
-  if (!args.project && !args.all) {
-    console.log(`${colors.red}Error: Specify --project=<id> or --all${colors.reset}`)
-    console.log(`${colors.dim}Run 'prjct generate-views --help' for usage${colors.reset}`)
-    process.exit(1)
-  }
-
-  // Validate view name if specified
-  const validViews = ['now', 'next', 'ideas', 'roadmap', 'shipped']
-  if (args.view && !validViews.includes(args.view)) {
-    console.log(`${colors.red}Error: Invalid view '${args.view}'${colors.reset}`)
-    console.log(`${colors.dim}Valid views: ${validViews.join(', ')}${colors.reset}`)
-    process.exit(1)
-  }
-
-  // Get projects to process
-  let projects = []
-  if (args.all) {
-    projects = await getAllProjects()
-    if (projects.length === 0) {
-      console.log(`${colors.yellow}No projects found in ${GLOBAL_STORAGE}${colors.reset}`)
-      process.exit(0)
-    }
-  } else {
-    projects = [args.project]
-  }
-
-  console.log(`${colors.cyan}${colors.bright}Generating views...${colors.reset}\n`)
-
-  let totalGenerated = 0
-  let totalErrors = 0
-
-  for (const projectId of projects) {
-    const projectPath = path.join(GLOBAL_STORAGE, projectId)
-
-    // Check project exists
-    try {
-      await fs.access(projectPath)
-    } catch {
-      console.log(`${colors.yellow}⚠ Project not found: ${projectId}${colors.reset}`)
-      totalErrors++
-      continue
-    }
-
-    const result = await generateViews(projectId, args.view)
-
-    if (result.generated.length > 0) {
-      console.log(`${colors.green}✓ ${projectId}${colors.reset}`)
-      for (const file of result.generated) {
-        console.log(`  ${colors.dim}→ ${file}${colors.reset}`)
-      }
-      totalGenerated += result.generated.length
-    }
-
-    if (result.errors.length > 0) {
-      console.log(`${colors.red}✗ ${projectId}${colors.reset}`)
-      for (const error of result.errors) {
-        console.log(`  ${colors.red}→ ${error}${colors.reset}`)
-      }
-      totalErrors += result.errors.length
-    }
-  }
-
-  // Summary
-  console.log('')
-  if (totalGenerated > 0) {
-    console.log(`${colors.green}${colors.bright}✓ Generated ${totalGenerated} view(s)${colors.reset}`)
-  }
-  if (totalErrors > 0) {
-    console.log(`${colors.red}✗ ${totalErrors} error(s)${colors.reset}`)
-    process.exit(1)
-  }
-}
-
-main().catch((err) => {
-  console.error(`${colors.red}Error: ${err.message}${colors.reset}`)
-  process.exit(1)
-})