prjct-cli 1.0.0 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,86 @@
 # Changelog
 
+## [1.1.1] - 2026-02-06
+
+### Bug Fixes
+
+- visual grouping with boxes and tables for structured output (PRJ-134) (#110)
+
+
+## [1.1.1] - 2026-02-05
+
+### Improved
+
+- **Visual grouping for structured output (PRJ-134)**: Added `out.section()` and integrated `out.box()`, `out.table()`, `out.list()` into sync, doctor, and status commands
+
+### Implementation Details
+
+Added `out.section(title)` method to the unified output system (`core/utils/output.ts`) — bold title with dim underline, chainable, quiet-mode aware.
+
+Refactored three commands to use unified output helpers instead of raw `console.log`:
+- **Sync** (`analysis.ts`): Summary metrics in `out.box()`, generated items via `out.section()` + `out.list()`
+- **Doctor** (`doctor-service.ts`): Section headers via `out.section()`, recommendations via `out.list()`, summary via `out.done()`/`out.warn()`/`out.fail()`
+- **Status** (`staleness-checker.ts`): Key-value details wrapped in box-drawing characters
+
+### Learnings
+
+- `staleness-checker.formatStatus()` returns a string (not direct output), so `out.box()` can't be used directly — used inline box-drawing chars instead
+- Doctor service had its own icon logic for check results that was worth preserving alongside the new section headers
+- Unified output helpers reduce code while maintaining the same visual style
+
+### Test Plan
+
+#### For QA
+1. Run `prjct sync` — verify boxed "Sync Summary" with metrics, "Generated" section header with underline, `✓` bullet items
+2. Run `prjct doctor` — verify bold+underline section headers for "System Tools", "Project Status", "Recommendations"
+3. Run `prjct status` — verify key-value details in box-drawing characters
+4. Run with `--quiet` flag — verify no visual output is printed
+
+#### For Users
+**What changed:** CLI output now uses visual grouping (boxes, section headers, structured lists) for better scannability
+**How to use:** No changes needed — output is automatically improved
+**Breaking changes:** None
+
+## [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/core/commands/analysis.ts

@@ -478,67 +478,55 @@ export class AnalysisCommands extends PrjctCommandsBase {
     // ═══════════════════════════════════════════════════════════════════════
     // SUCCESS LINE - Immediate confirmation with timing
     // ═══════════════════════════════════════════════════════════════════════
-    console.log(`✅ Synced ${result.stats.name || 'project'} (${(elapsed / 1000).toFixed(1)}s)\n`)
+    out.done(`Synced ${result.stats.name || 'project'} (${(elapsed / 1000).toFixed(1)}s)`)
+    console.log('')
 
     // ═══════════════════════════════════════════════════════════════════════
-    // KEY METRICS - Single scannable line
+    // SUMMARY BOX - Key metrics grouped visually
     // ═══════════════════════════════════════════════════════════════════════
-    // Only show compression rate if meaningful (> 10%)
     const compressionPct = result.syncMetrics?.compressionRate
       ? Math.round(result.syncMetrics.compressionRate * 100)
       : 0
-    const metricsLine = [
-      `${result.stats.fileCount} files → ${contextFilesCount} context`,
-      `${agentCount} agents`,
-      compressionPct > 10 ? `${compressionPct}% reduction` : null,
-    ]
-      .filter(Boolean)
-      .join(' | ')
-    console.log(metricsLine)
-
-    // Stack and branch info
     const framework = result.stats.frameworks.length > 0 ? ` (${result.stats.frameworks[0]})` : ''
-    console.log(`Stack: ${result.stats.ecosystem}${framework} | Branch: ${result.git.branch}\n`)
+    const boxLines = [
+      `${result.stats.fileCount} files → ${contextFilesCount} context | ${agentCount} agents${compressionPct > 10 ? ` | ${compressionPct}% reduction` : ''}`,
+      `Stack: ${result.stats.ecosystem}${framework} | Branch: ${result.git.branch}`,
+    ]
+    out.box('Sync Summary', boxLines.join('\n'))
 
     // ═══════════════════════════════════════════════════════════════════════
     // CHANGES SECTION - What was generated/updated
     // ═══════════════════════════════════════════════════════════════════════
-    console.log('Generated:')
-
-    // Context files (condensed)
+    const generatedItems: string[] = []
     if (result.contextFiles.length > 0) {
-      console.log(`  ✓ ${result.contextFiles.length} context files`)
+      generatedItems.push(`${result.contextFiles.length} context files`)
     }
-
-    // AI tools
     const successTools = result.aiTools?.filter((t) => t.success) || []
     if (successTools.length > 0) {
-      const toolNames = successTools.map((t) => t.toolId).join(', ')
-      console.log(`  ✓ AI tools: ${toolNames}`)
+      generatedItems.push(`AI tools: ${successTools.map((t) => t.toolId).join(', ')}`)
     }
-
-    // Agents (show count with breakdown)
     if (agentCount > 0) {
       const agentSummary =
         domainAgentCount > 0
           ? `${agentCount} agents (${domainAgentCount} domain)`
           : `${agentCount} agents`
-      console.log(`  ✓ ${agentSummary}`)
+      generatedItems.push(agentSummary)
     }
-
-    // Skills
     if (result.skills.length > 0) {
       const skillWord = result.skills.length === 1 ? 'skill' : 'skills'
-      console.log(`  ✓ ${result.skills.length} ${skillWord}`)
+      generatedItems.push(`${result.skills.length} ${skillWord}`)
     }
 
+    out.section('Generated')
+    out.list(generatedItems, { bullet: '✓' })
     console.log('')
 
     // ═══════════════════════════════════════════════════════════════════════
     // STATUS INDICATOR - Repository state
     // ═══════════════════════════════════════════════════════════════════════
     if (result.git.hasChanges) {
-      console.log('⚠️  Uncommitted changes detected\n')
+      out.warn('Uncommitted changes detected')
+      console.log('')
     }
 
     // ═══════════════════════════════════════════════════════════════════════

package/core/services/doctor-service.ts

@@ -15,6 +15,7 @@ import path from 'node:path'
 import chalk from 'chalk'
 import configManager from '../infrastructure/config-manager'
 import pathManager from '../infrastructure/path-manager'
+import out from '../utils/output'
 import { VERSION } from '../utils/version'
 
 // ============================================================================
@@ -367,32 +368,28 @@ class DoctorService {
   // ==========================================================================
 
   private printHeader(): void {
-    console.log('')
-    console.log(chalk.bold(`prjct doctor v${VERSION}`))
-    console.log(chalk.dim('─'.repeat(40)))
+    out.section(`prjct doctor v${VERSION}`)
   }
 
   private printSection(title: string, checks: CheckResult[]): void {
-    console.log('')
-    console.log(chalk.bold(title))
+    out.section(title)
 
-    for (const check of checks) {
+    const items = checks.map((check) => {
       const icon = this.getStatusIcon(check.status, check.optional)
       const name = check.name.padEnd(14)
       const detail = check.version || check.message || ''
       const optionalTag = check.optional && check.status === 'error' ? chalk.dim(' (optional)') : ''
+      return `${icon} ${name} ${chalk.dim(detail)}${optionalTag}`
+    })
 
-      console.log(`  ${icon} ${name} ${chalk.dim(detail)}${optionalTag}`)
+    for (const item of items) {
+      console.log(`  ${item}`)
     }
   }
 
   private printRecommendations(recommendations: string[]): void {
-    console.log('')
-    console.log(chalk.bold('Recommendations'))
-
-    for (const rec of recommendations) {
-      console.log(`  ${chalk.yellow('•')} ${rec}`)
-    }
+    out.section('Recommendations')
+    out.list(recommendations, { bullet: chalk.yellow('•') })
   }
 
   private printSummary(result: DoctorResult): void {
@@ -400,11 +397,11 @@ class DoctorService {
     console.log(chalk.dim('─'.repeat(40)))
 
     if (result.hasErrors) {
-      console.log(chalk.red('✗ Some required checks failed'))
+      out.fail('Some required checks failed')
     } else if (result.hasWarnings) {
-      console.log(chalk.yellow('⚠ All required checks passed (some warnings)'))
+      out.warn('All required checks passed (some warnings)')
     } else {
-      console.log(chalk.green('✓ All checks passed'))
+      out.done('All checks passed')
     }
 
     console.log('')

package/core/services/staleness-checker.ts

@@ -195,23 +195,35 @@ export class StalenessChecker {
       lines.push('CLAUDE.md status: ✓ Fresh')
     }
 
-    lines.push('─────────────────────────────')
-
+    // Build key-value table content
+    const details: string[] = []
     if (status.lastSyncCommit) {
-      lines.push(`Last sync:      ${status.lastSyncCommit}`)
+      details.push(`Last sync:      ${status.lastSyncCommit}`)
     }
     if (status.currentCommit) {
-      lines.push(`Current:        ${status.currentCommit}`)
+      details.push(`Current:        ${status.currentCommit}`)
     }
     if (status.commitsSinceSync > 0) {
-      lines.push(`Commits since:  ${status.commitsSinceSync}`)
+      details.push(`Commits since:  ${status.commitsSinceSync}`)
     }
     if (status.daysSinceSync > 0) {
-      lines.push(`Days since:     ${status.daysSinceSync}`)
+      details.push(`Days since:     ${status.daysSinceSync}`)
     }
     if (status.changedFiles.length > 0) {
-      lines.push(`Files changed:  ${status.changedFiles.length}`)
+      details.push(`Files changed:  ${status.changedFiles.length}`)
     }
+
+    // Wrap details in a box
+    if (details.length > 0) {
+      const maxLen = Math.max(...details.map((l) => l.length))
+      const border = '─'.repeat(maxLen + 2)
+      lines.push(`┌${border}┐`)
+      for (const detail of details) {
+        lines.push(`│ ${detail.padEnd(maxLen)} │`)
+      }
+      lines.push(`└${border}┘`)
+    }
+
     if (status.significantChanges.length > 0) {
       lines.push(``)
       lines.push(`Significant changes:`)

package/core/utils/output.ts

@@ -206,6 +206,7 @@ interface Output {
   list(items: string[], options?: { bullet?: string; indent?: number }): Output
   table(rows: Array<Record<string, string | number>>, options?: { header?: boolean }): Output
   box(title: string, content: string): Output
+  section(title: string): Output
   stop(): Output
   step(current: number, total: number, msg: string): Output
   progress(current: number, total: number, msg?: string): Output
@@ -369,6 +370,15 @@ const out: Output = {
     return this
   },
 
+  // Section header: bold title + underline
+  section(title: string) {
+    this.stop()
+    if (quietMode) return this
+    console.log(`\n${chalk.bold(title)}`)
+    console.log(chalk.dim('─'.repeat(title.length)))
+    return this
+  },
+
   stop() {
     if (interval) {
       clearInterval(interval)

package/dist/bin/prjct.mjs

@@ -2495,6 +2495,15 @@ var init_output = __esm({
         console.log(chalk2.dim(`\u2514${border}\u2518`));
         return this;
       },
+      // Section header: bold title + underline
+      section(title) {
+        this.stop();
+        if (quietMode) return this;
+        console.log(`
+${chalk2.bold(title)}`);
+        console.log(chalk2.dim("\u2500".repeat(title.length)));
+        return this;
+      },
       stop() {
         if (interval) {
           clearInterval(interval);
@@ -5448,6 +5457,7 @@ var init_doctor_service = __esm({
     "use strict";
     init_config_manager();
     init_path_manager();
+    init_output();
     init_version();
     DoctorService = class {
       static {
@@ -5702,37 +5712,34 @@ var init_doctor_service = __esm({
       // OUTPUT
       // ==========================================================================
       printHeader() {
-        console.log("");
-        console.log(chalk3.bold(`prjct doctor v${VERSION}`));
-        console.log(chalk3.dim("\u2500".repeat(40)));
+        output_default.section(`prjct doctor v${VERSION}`);
       }
       printSection(title, checks) {
-        console.log("");
-        console.log(chalk3.bold(title));
-        for (const check of checks) {
+        output_default.section(title);
+        const items = checks.map((check) => {
           const icon = this.getStatusIcon(check.status, check.optional);
           const name = check.name.padEnd(14);
           const detail = check.version || check.message || "";
           const optionalTag = check.optional && check.status === "error" ? chalk3.dim(" (optional)") : "";
-          console.log(`  ${icon} ${name} ${chalk3.dim(detail)}${optionalTag}`);
+          return `${icon} ${name} ${chalk3.dim(detail)}${optionalTag}`;
+        });
+        for (const item of items) {
+          console.log(`  ${item}`);
         }
       }
       printRecommendations(recommendations) {
-        console.log("");
-        console.log(chalk3.bold("Recommendations"));
-        for (const rec of recommendations) {
-          console.log(`  ${chalk3.yellow("\u2022")} ${rec}`);
-        }
+        output_default.section("Recommendations");
+        output_default.list(recommendations, { bullet: chalk3.yellow("\u2022") });
       }
       printSummary(result) {
         console.log("");
         console.log(chalk3.dim("\u2500".repeat(40)));
         if (result.hasErrors) {
-          console.log(chalk3.red("\u2717 Some required checks failed"));
+          output_default.fail("Some required checks failed");
         } else if (result.hasWarnings) {
-          console.log(chalk3.yellow("\u26A0 All required checks passed (some warnings)"));
+          output_default.warn("All required checks passed (some warnings)");
         } else {
-          console.log(chalk3.green("\u2713 All checks passed"));
+          output_default.done("All checks passed");
         }
         console.log("");
       }
@@ -18383,38 +18390,37 @@ ${formatFullDiff(diff)}`);
         const agentCount = result.agents.length;
         const domainAgentCount = result.agents.filter((a) => a.type === "domain").length;
         await command_installer_default.installGlobalConfig();
-        console.log(`\u2705 Synced ${result.stats.name || "project"} (${(elapsed / 1e3).toFixed(1)}s)
-`);
+        output_default.done(`Synced ${result.stats.name || "project"} (${(elapsed / 1e3).toFixed(1)}s)`);
+        console.log("");
         const compressionPct = result.syncMetrics?.compressionRate ? Math.round(result.syncMetrics.compressionRate * 100) : 0;
-        const metricsLine = [
-          `${result.stats.fileCount} files \u2192 ${contextFilesCount} context`,
-          `${agentCount} agents`,
-          compressionPct > 10 ? `${compressionPct}% reduction` : null
-        ].filter(Boolean).join(" | ");
-        console.log(metricsLine);
         const framework = result.stats.frameworks.length > 0 ? ` (${result.stats.frameworks[0]})` : "";
-        console.log(`Stack: ${result.stats.ecosystem}${framework} | Branch: ${result.git.branch}
-`);
-        console.log("Generated:");
+        const boxLines = [
+          `${result.stats.fileCount} files \u2192 ${contextFilesCount} context | ${agentCount} agents${compressionPct > 10 ? ` | ${compressionPct}% reduction` : ""}`,
+          `Stack: ${result.stats.ecosystem}${framework} | Branch: ${result.git.branch}`
+        ];
+        output_default.box("Sync Summary", boxLines.join("\n"));
+        const generatedItems = [];
         if (result.contextFiles.length > 0) {
-          console.log(`  \u2713 ${result.contextFiles.length} context files`);
+          generatedItems.push(`${result.contextFiles.length} context files`);
         }
         const successTools = result.aiTools?.filter((t) => t.success) || [];
         if (successTools.length > 0) {
-          const toolNames = successTools.map((t) => t.toolId).join(", ");
-          console.log(`  \u2713 AI tools: ${toolNames}`);
+          generatedItems.push(`AI tools: ${successTools.map((t) => t.toolId).join(", ")}`);
         }
         if (agentCount > 0) {
           const agentSummary = domainAgentCount > 0 ? `${agentCount} agents (${domainAgentCount} domain)` : `${agentCount} agents`;
-          console.log(`  \u2713 ${agentSummary}`);
+          generatedItems.push(agentSummary);
         }
         if (result.skills.length > 0) {
           const skillWord = result.skills.length === 1 ? "skill" : "skills";
-          console.log(`  \u2713 ${result.skills.length} ${skillWord}`);
+          generatedItems.push(`${result.skills.length} ${skillWord}`);
         }
+        output_default.section("Generated");
+        output_default.list(generatedItems, { bullet: "\u2713" });
         console.log("");
         if (result.git.hasChanges) {
-          console.log("\u26A0\uFE0F  Uncommitted changes detected\n");
+          output_default.warn("Uncommitted changes detected");
+          console.log("");
         }
         showNextSteps("sync");
         return {
@@ -19574,21 +19580,30 @@ var init_staleness_checker = __esm({
         } else {
           lines.push("CLAUDE.md status: \u2713 Fresh");
         }
-        lines.push("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+        const details = [];
         if (status.lastSyncCommit) {
-          lines.push(`Last sync:      ${status.lastSyncCommit}`);
+          details.push(`Last sync:      ${status.lastSyncCommit}`);
         }
         if (status.currentCommit) {
-          lines.push(`Current:        ${status.currentCommit}`);
+          details.push(`Current:        ${status.currentCommit}`);
         }
         if (status.commitsSinceSync > 0) {
-          lines.push(`Commits since:  ${status.commitsSinceSync}`);
+          details.push(`Commits since:  ${status.commitsSinceSync}`);
         }
         if (status.daysSinceSync > 0) {
-          lines.push(`Days since:     ${status.daysSinceSync}`);
+          details.push(`Days since:     ${status.daysSinceSync}`);
         }
         if (status.changedFiles.length > 0) {
-          lines.push(`Files changed:  ${status.changedFiles.length}`);
+          details.push(`Files changed:  ${status.changedFiles.length}`);
+        }
+        if (details.length > 0) {
+          const maxLen = Math.max(...details.map((l) => l.length));
+          const border = "\u2500".repeat(maxLen + 2);
+          lines.push(`\u250C${border}\u2510`);
+          for (const detail of details) {
+            lines.push(`\u2502 ${detail.padEnd(maxLen)} \u2502`);
+          }
+          lines.push(`\u2514${border}\u2518`);
         }
         if (status.significantChanges.length > 0) {
           lines.push(``);
@@ -26859,7 +26874,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "1.0.0",
+      version: "1.1.1",
       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.1",
   "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`