prjct-cli 1.22.0 → 1.23.0

package/templates/commands/merge.md

@@ -1,206 +0,0 @@
----
-allowed-tools: [Bash, Read, Write, AskUserQuestion]
----
-
-# p. merge
-
-## ⛔ MANDATORY WORKFLOW - DO NOT SKIP ANY STEP
-
----
-
-### STEP 1: Pre-flight Checks (BLOCKING)
-
-```bash
-# 1a. Check if there's an active task with a PR
-```
-
-**⛔ IF no `currentTask`:**
-```
-STOP. DO NOT PROCEED.
-Tell user: "No active task. Use p. task first."
-ABORT.
-```
-
-**⛔ IF no PR number in task state:**
-```
-STOP. DO NOT PROCEED.
-Tell user: "No PR found. Run p. ship first to create a PR."
-ABORT.
-```
-
----
-
-### STEP 2: Check PR Status (BLOCKING)
-
-```bash
-gh pr view {prNumber} --json reviewDecision,mergeable,state,statusCheckRollup
-```
-
-**⛔ IF PR is not approved:**
-```
-STOP. DO NOT PROCEED.
-Tell user: "PR needs approval. Get reviews first."
-Show: gh pr view {prNumber} --web
-ABORT.
-```
-
-**⛔ IF PR has merge conflicts:**
-```
-STOP. DO NOT PROCEED.
-Tell user: "PR has conflicts. Resolve them first:
-  git checkout {branch}
-  git pull origin main
-  # fix conflicts
-  git push"
-ABORT.
-```
-
-**⛔ IF CI checks are failing:**
-```
-STOP. DO NOT PROCEED.
-Tell user: "CI checks are failing. Fix them first."
-Show failing checks.
-ABORT.
-```
-
----
-
-### STEP 3: Show Plan and Get Approval (BLOCKING)
-
-Show the user:
-```
-## Merge Plan
-
-PR: #{prNumber} - {title}
-Branch: {branch} → main
-Strategy: squash
-
-Will do:
-1. Merge PR with squash
-2. Delete feature branch
-3. Update local main
-```
-
-Then ask for confirmation:
-
-```
-AskUserQuestion:
-  question: "Merge this PR?"
-  header: "Merge"
-  options:
-    - label: "Yes, merge (Recommended)"
-      description: "Squash merge and delete branch"
-    - label: "No, cancel"
-      description: "Keep PR open"
-```
-
-**Handle responses:**
-
-**If "No, cancel":**
-```
-OUTPUT: "✅ Merge cancelled"
-STOP - Do not continue
-```
-
-**If "Yes, merge":**
-CONTINUE to Step 4
-
----
-
-### STEP 4: Execute Merge
-
-```bash
-gh pr merge {prNumber} --squash --delete-branch
-```
-
----
-
-### STEP 5: Update Local
-
-```bash
-git checkout main
-git pull origin main
-```
-
----
-
-### STEP 6: Update Task State
-
-- Set `currentTask.status = "merged"`
-- Set `currentTask.mergedAt = {now}`
-- Clear PR reference
-
----
-
-### STEP 7: Update Issue Tracker (REQUIRED - DO NOT SKIP)
-
-**⛔ This step is MANDATORY if there's a linked issue.**
-
-```
-READ: {globalPath}/storage/state.json
-GET: currentTask.linearId, currentTask.jiraId
-```
-
-**IF linearId exists:**
-```bash
-# USE prjct CLI DIRECTLY - NOT $PRJCT_CLI (may be unset)
-prjct linear done "{linearId}"
-prjct linear comment "{linearId}" "✅ PR #{prNumber} merged and released"
-```
-OUTPUT: "Linear: {linearId} → Done ✓"
-
-**ELSE IF jiraId exists:**
-```bash
-prjct jira transition "{jiraId}" "Done"
-prjct jira comment "{jiraId}" "✅ PR #{prNumber} merged and released"
-```
-OUTPUT: "JIRA: {jiraId} → Done ✓"
-
-**ELSE (no issue tracker):**
-```
-# No issue tracker linked - that's OK, just skip this step
-OUTPUT: "✓ No issue tracker linked"
-```
-
----
-
-### STEP 8: Complete Task State
-
-```
-UPDATE: {globalPath}/storage/state.json
-
-SET: previousTask = currentTask
-SET: previousTask.status = "completed"
-SET: previousTask.completedAt = {timestamp}
-SET: currentTask = null
-```
-
-APPEND to `{globalPath}/memory/events.jsonl`:
-```json
-{"type":"task_completed","taskId":"{id}","linearId":"{linearId}","prNumber":"{prNumber}","timestamp":"{timestamp}"}
-```
-
----
-
-## Output Format
-
-```
-✅ Merged: {title}
-
-PR: #{prNumber}
-Strategy: squash
-Branch: {branch} (deleted)
-
-Next:
-- New task → `p. task "description"`
-- See backlog → `p. next`
-```
-
----
-
-## ⛔ VIOLATIONS
-
-- ❌ Merging without PR approval
-- ❌ Merging with failing CI
-- ❌ Merging with conflicts
-- ❌ Not waiting for user approval

package/templates/commands/next.md

@@ -1,80 +0,0 @@
----
-allowed-tools: [Read]
----
-
-# p. next
-
-## 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}`
-
-## Step 2: Read State
-
-READ `{globalPath}/storage/queue.json` (or empty array if doesn't exist)
-READ `{globalPath}/storage/state.json`
-
-## Step 3: Show Active Task Warning
-
-```
-IF state.currentTask exists AND currentTask.status == "active":
-  OUTPUT:
-  """
-  ⚠️ Active task: {currentTask.description}
-
-  Consider: `p. done` or `p. pause` before starting new work
-  """
-```
-
-## Step 4: Display Queue
-
-**Output (queue has items)**:
-```
-📋 Queue ({count})
-
-1. {task_1.description} [{task_1.type}] {priority badge if high/critical}
-2. {task_2.description} [{task_2.type}]
-3. {task_3.description} [{task_3.type}]
-...
-
-Next:
-- Start task → `p. task "{task_1.description}"`
-- Add task → `p. task "description"`
-- Report bug → `p. bug "description"`
-```
-
-**Output (empty queue)**:
-```
-📋 Queue is empty
-
-Next:
-- Add task → `p. task "description"`
-- Report bug → `p. bug "description"`
-- Capture idea → `p. idea "note"`
-```
-
-## Step 5: Roadmap View (if `p. next roadmap`)
-
-IF arguments include "roadmap":
-
-Group tasks by feature/epic and show completion percentage:
-
-```
-📊 Roadmap
-
-Feature A (75% complete)
-├─ ✅ Task 1
-├─ ✅ Task 2
-├─ ✅ Task 3
-└─ ⬜ Task 4
-
-Feature B (0% complete)
-├─ ⬜ Task 5
-└─ ⬜ Task 6
-
-Next: `p. task` to continue work
-```

package/templates/commands/p.md

@@ -1,67 +0,0 @@
----
-description: 'prjct CLI - Context layer for AI agents'
-allowed-tools: [Read, Write, Edit, Bash, Glob, Grep, Task, AskUserQuestion, TodoWrite, WebFetch]
----
-
-# prjct Command Router
-
-**ARGUMENTS**: $ARGUMENTS
-
-All commands use the `p.` prefix.
-
-## Quick Reference
-
-| Command | Description |
-|---------|-------------|
-| `p. task <desc>` | Start a task |
-| `p. done` | Complete current subtask |
-| `p. ship [name]` | Ship feature with PR + version bump |
-| `p. sync` | Analyze project, regenerate agents |
-| `p. pause` | Pause current task |
-| `p. resume` | Resume paused task |
-| `p. next` | Show priority queue |
-| `p. idea <desc>` | Quick idea capture |
-| `p. bug <desc>` | Report bug with auto-priority |
-| `p. linear` | Linear integration (via SDK) |
-| `p. jira` | JIRA integration (via REST API) |
-
-## Execution
-
-```
-1. PARSE: $ARGUMENTS → extract command (first word)
-2. GET npm root: npm root -g
-3. LOAD template: {npmRoot}/prjct-cli/templates/commands/{command}.md
-4. EXECUTE template
-```
-
-## Command Aliases
-
-| Input | Redirects To |
-|-------|--------------|
-| `p. undo` | `p. history undo` |
-| `p. redo` | `p. history redo` |
-
-## State Context
-
-Before executing commands, load state:
-
-```
-READ: .prjct/prjct.config.json → get projectId
-SET: globalPath = ~/.prjct-cli/projects/{projectId}
-READ: {globalPath}/storage/state.json (if exists)
-```
-
-## Error Handling
-
-| Error | Action |
-|-------|--------|
-| Unknown command | "Unknown command: {command}. Run `p. help` for available commands." |
-| No project | "No prjct project. Run `p. init` first." |
-| Template not found | "Template not found: {command}.md" |
-
-## NOW: Execute
-
-1. Parse command from $ARGUMENTS
-2. Handle aliases (undo → history undo, redo → history redo)
-3. Run `npm root -g` to get template path
-4. Load and execute command template

package/templates/commands/p.toml

@@ -1,37 +0,0 @@
-# prjct Command Router for Gemini CLI
-description = "prjct - Context layer for AI coding agents"
-
-prompt = """
-# prjct Command Router
-
-You are using prjct, a context layer for AI coding agents.
-
-**ARGUMENTS**: {{args}}
-
-## Instructions
-
-1. Parse arguments: first word = `command`, rest = `commandArgs`
-2. Get npm global root by running: `npm root -g`
-3. Read the command template from:
-   `{npmRoot}/prjct-cli/templates/commands/{command}.md`
-4. Execute the template with `commandArgs` as input
-
-## Example
-
-If arguments = "task fix the login bug":
-- command = "task"
-- commandArgs = "fix the login bug"
-- npm root -g → `/opt/homebrew/lib/node_modules`
-- Read: `/opt/homebrew/lib/node_modules/prjct-cli/templates/commands/task.md`
-- Execute template with: "fix the login bug"
-
-## Available Commands
-
-task, done, ship, sync, init, idea, dash, next, pause, resume, bug,
-linear, feature, prd, plan, review, merge, git, test, cleanup,
-design, analyze, history, enrich, update
-
-## Action
-
-NOW run `npm root -g` and read the appropriate command template.
-"""

package/templates/commands/pause.md

@@ -1,136 +0,0 @@
----
-allowed-tools: [Read, Write, Bash, AskUserQuestion]
----
-
-# p. pause "$ARGUMENTS"
-
-## 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}`
-
-## Step 2: Read Current State
-
-READ `{globalPath}/storage/state.json`
-
-```
-IF no currentTask OR currentTask is null:
-  OUTPUT: "No active task to pause."
-  STOP
-
-IF currentTask.status == "paused":
-  OUTPUT:
-  """
-  ⏸️ Already paused: {currentTask.description}
-
-  To resume: `p. resume`
-  """
-  STOP
-```
-
-## Step 3: Get Pause Reason
-
-```
-IF $ARGUMENTS is empty:
-  AskUserQuestion:
-    question: "Why are you pausing?"
-    header: "Pause"
-    options:
-      - label: "Blocked (waiting on external)"
-        description: "Waiting for review, dependency, or other team"
-      - label: "Switching task"
-        description: "Need to work on something else"
-      - label: "Taking a break"
-        description: "Stepping away temporarily"
-      - label: "Researching"
-        description: "Need to investigate before continuing"
-
-  SET pauseReason = selected option
-
-  IF pauseReason == "Blocked":
-    ASK: "What's blocking you?"
-    SET blockingReason = response
-ELSE:
-  SET pauseReason = $ARGUMENTS
-```
-
-## Step 4: Calculate Duration
-
-```bash
-# Get current timestamp
-node -e "console.log(new Date().toISOString())"
-```
-
-Calculate time elapsed since `currentTask.startedAt` (or `resumedAt` if it exists).
-
-## Step 5: Update State
-
-READ current state, then update:
-
-```
-pausedTask = currentTask
-pausedTask.status = "paused"
-pausedTask.pausedAt = "{timestamp}"
-pausedTask.pauseReason = "{pauseReason}"
-pausedTask.blockingReason = "{blockingReason if set}"
-pausedTask.activeTime = "{duration worked so far}"
-
-state.pausedTasks = state.pausedTasks || []
-state.pausedTasks.unshift(pausedTask)  # Add to front
-state.currentTask = null
-```
-
-WRITE `{globalPath}/storage/state.json`:
-```json
-{
-  "currentTask": null,
-  "pausedTasks": [
-    {
-      "id": "{task.id}",
-      "description": "{task.description}",
-      "type": "{task.type}",
-      "status": "paused",
-      "startedAt": "{task.startedAt}",
-      "pausedAt": "{timestamp}",
-      "pauseReason": "{pauseReason}",
-      "blockingReason": "{blockingReason or null}",
-      "activeTime": "{duration}",
-      "subtasks": [...],
-      "currentSubtaskIndex": {task.currentSubtaskIndex},
-      "parentDescription": "{task.parentDescription}",
-      "branch": "{task.branch}",
-      "linearId": "{task.linearId or null}"
-    },
-    ...existing paused tasks
-  ],
-  "previousTask": {...}
-}
-```
-
-## Step 6: Log Event
-
-APPEND to `{globalPath}/memory/events.jsonl`:
-```json
-{"type":"task_paused","taskId":"{id}","description":"{description}","reason":"{pauseReason}","timestamp":"{timestamp}","activeTime":"{duration}"}
-```
-
----
-
-## Output
-
-```
-⏸️ Paused: {task description}
-
-Duration: {time worked}
-Reason: {pauseReason}
-{IF blockingReason: "Blocked by: {blockingReason}"}
-
-Next:
-- Resume → `p. resume`
-- New task → `p. task "description"`
-- Fix bug → `p. bug "description"`
-```