prjct-cli 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## [1.1.0] - 2026-02-05
+
+### Features
+
+- visual workflow status command (PRJ-140) (#109)
+
+
+## [1.1.0] - 2026-02-05
+
+### Features
+
+- **Workflow visualization (PRJ-140)**: New `p. status` command with visual workflow diagram
+
+### Implementation Details
+
+Added visual workflow status template showing:
+- ASCII workflow diagram with current position indicator (sync → task → work → done → ship)
+- Subtask tree visualization with status icons (✅/🔄/⬜)
+- Progress bar for subtask completion
+- Paused tasks, queue summary, and recent ships
+- Context staleness indicator from `prjct status --json`
+- Compact mode for single-line status output
+
+### Learnings
+
+- Template-first approach: Complex visualizations can be defined entirely in markdown templates without code changes
+
+### Test Plan
+
+#### For QA
+1. Run `prjct sync` to install new status template
+2. Run `p. status` - verify workflow diagram displays
+3. Verify subtask tree shows correct status icons
+4. Test `p. status compact` for single-line output
+
+#### For Users
+- New `p. status` command shows visual workflow overview
+- No breaking changes
+
+
 ## [1.0.0] - 2026-02-05
 
 ### Features

package/dist/bin/prjct.mjs

@@ -26859,7 +26859,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "1.0.0",
+      version: "1.1.0",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {

package/templates/commands/status.md

@@ -0,0 +1,207 @@
+---
+allowed-tools: [Read, Bash]
+---
+
+# p. status
+
+Visual workflow status showing current position in the prjct lifecycle.
+
+## 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 and Context
+
+READ:
+- `{globalPath}/storage/state.json` → current task, paused, previous
+- `{globalPath}/storage/queue.json` → upcoming tasks
+- `{globalPath}/storage/shipped.json` → recent ships
+- `{globalPath}/project.json` → lastSync timestamp
+
+```bash
+# Get staleness info
+prjct status --json 2>/dev/null || echo '{"isStale": false}'
+```
+
+## Step 3: Determine Workflow Position
+
+Based on state.json, determine current position:
+
+```
+IF no currentTask AND no previousTask:
+  position = "ready"  # Ready to start (after sync)
+ELSE IF currentTask.status == "active":
+  position = "working"  # In task
+ELSE IF currentTask.status == "in_review":
+  position = "reviewing"  # PR open, waiting for merge
+ELSE IF currentTask.status == "shipped":
+  position = "shipped"  # Ready for next task
+ELSE:
+  position = "idle"
+```
+
+## Step 4: Calculate Progress
+
+```
+IF currentTask.subtasks exists:
+  completed = count where status == "completed"
+  total = subtasks.length
+  percent = (completed / total) * 100
+  progressBar = generateBar(percent, 10)  # 10 chars wide
+```
+
+Progress bar generation:
+```
+filled = floor(percent / 10)
+empty = 10 - filled
+bar = "█" × filled + "░" × empty
+```
+
+## Step 5: Format Subtask Tree
+
+```
+FOR EACH subtask in currentTask.subtasks:
+  IF index == currentSubtaskIndex:
+    prefix = "🔄"  # Current
+  ELSE IF subtask.status == "completed":
+    prefix = "✅"  # Done
+  ELSE:
+    prefix = "⬜"  # Pending
+
+  connector = (index == last) ? "└─" : "├─"
+  OUTPUT: "   {connector} {prefix} {subtask.description}"
+```
+
+---
+
+## Output: Workflow Diagram
+
+```
+📊 WORKFLOW STATUS
+
+┌─────────────────────────────────────────────────────────┐
+│                                                         │
+│   sync ──▶ task ──▶ [work] ──▶ done ──▶ ship           │
+│    ○        ○         ●         ○        ○             │
+│                       ▲                                 │
+│                    YOU ARE HERE                         │
+│                                                         │
+└─────────────────────────────────────────────────────────┘
+```
+
+Position indicators:
+- `○` = not active
+- `●` = current position
+- Arrow indicates flow direction
+
+---
+
+## Output: Full Status
+
+```
+📊 WORKFLOW STATUS
+
+┌─────────────────────────────────────────────────────────┐
+│   sync ──▶ task ──▶ work ──▶ done ──▶ ship             │
+│    {s}       {t}      {w}      {d}      {h}            │
+└─────────────────────────────────────────────────────────┘
+
+🎯 Current: {currentTask.parentDescription}
+   Branch: {currentTask.branch}
+   Type: {currentTask.type} | Started: {elapsed}
+   {IF linearId: "Linear: {linearId}"}
+
+   Progress: {progressBar} {completed}/{total} subtasks
+   {subtask tree}
+
+⏸️ Paused: {pausedTasks[0].description or "none"}
+
+📋 Queue: {queueCount} tasks
+{IF queueCount > 0:}
+   • {queue[0].description}
+   • {queue[1].description}
+   {... up to 3}
+
+🚀 Last ship: {previousTask.description} ({daysSince})
+   {IF previousTask.prUrl: "PR: {prUrl}"}
+
+📡 Context: {staleness status}
+   Last sync: {timeSinceSync}
+   {IF isStale: "⚠️ Run `p. sync` to refresh"}
+```
+
+---
+
+## Output: Compact (`p. status compact`)
+
+Single-line summary:
+
+```
+{position_emoji} {currentTask.description} │ {progressBar} {completed}/{total} │ 📋 {queueCount} │ {staleness_emoji}
+```
+
+Position emojis:
+- 🔄 = working
+- 👀 = reviewing
+- ✅ = shipped
+- 💤 = idle
+
+Staleness emojis:
+- ✅ = fresh
+- ⚠️ = stale
+
+---
+
+## Output: No Active Task
+
+```
+📊 WORKFLOW STATUS
+
+┌─────────────────────────────────────────────────────────┐
+│   sync ──▶ task ──▶ work ──▶ done ──▶ ship             │
+│    ●        ○        ○        ○        ○               │
+└─────────────────────────────────────────────────────────┘
+
+💤 No active task
+
+📋 Queue: {queueCount} tasks
+{IF queueCount > 0:}
+   • {queue[0].description}
+
+🚀 Last ship: {previousTask.description} ({daysSince})
+
+Next: `p. task "description"` or `p. task PRJ-XXX`
+```
+
+---
+
+## Elapsed Time Formatting
+
+```
+IF minutes < 60: "{minutes}m"
+ELSE IF hours < 24: "{hours}h {minutes}m"
+ELSE: "{days}d {hours}h"
+```
+
+---
+
+## Context Staleness
+
+From `prjct status --json`:
+```json
+{
+  "isStale": true,
+  "commitsSinceSync": 15,
+  "daysSinceSync": 3,
+  "significantChanges": ["package.json", "tsconfig.json"]
+}
+```
+
+Display:
+- Fresh (< 10 commits, < 3 days): `✅ Fresh (synced {time} ago)`
+- Stale: `⚠️ Stale ({commits} commits, {days}d) - run p. sync`