prjct-cli 0.64.1 → 1.1.0

package/CHANGELOG.md

@@ -1,10 +1,310 @@
 # Changelog
 
-## [0.64.1] - 2026-02-05
+## [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
+
+- add input source tagging for context items (PRJ-102) (#106)
+- add timeout management with configurable limits (PRJ-111) (#104)
+- implement graceful degradation for missing dependencies (PRJ-114) (#103)
+- add .prjct-state.md local state file for persistence (PRJ-112) (#102)
+- hierarchical AGENTS.md resolution and template improvements (PRJ-101) (#99)
+- add staleness detection for CLAUDE.md context (PRJ-120) (#97)
+- complete Linear/JIRA workflow integration (#95)
+- monorepo support with nested PRJCT.md inheritance (PRJ-118) (#94)
+- implement output tiers for cleaner CLI output (#88)
+- modular CLAUDE.md for reduced token usage - PRJ-94 (#86)
+- Add showMetrics config option - PRJ-70 (#82)
+- Selective memory retrieval based on task relevance - PRJ-107 (#81)
+- Add session stats to p. stats command - PRJ-89 (#80)
+- Lazy template loading with TTL cache - PRJ-76 (#79)
+- Add confidence scores to all stored preferences - PRJ-104 (#78)
+- Context diff preview before sync applies - PRJ-125 (#77)
+- Unified output system with new methods - PRJ-130 (#76)
+- Error messages with context and recovery hints - PRJ-131 (#75)
+- Read-before-write enforcement for templates - PRJ-108 (#74)
+- Complete and improve help text documentation - PRJ-133 (#73)
+- Workflow hooks via natural language - PRJ-137 (#72)
+- Subtask progress dashboard with domain colors - PRJ-138 (#71)
+- preserve user customizations during sync - PRJ-115 (#70)
+- automated release pipeline - PRJ-147 (#68)
+- add project indexing and analysis services (PRJ-85, PRJ-87) (#66)
+- metrics display in output (PRJ-68, PRJ-69) (#54)
+- add prjct uninstall command (PRJ-146) (#65)
+- add prjct doctor command (PRJ-117) (#62)
+- smart watch mode - auto-sync on file changes (PRJ-123) (#61)
+- add --quiet flag for silent output (PRJ-97) (#60)
+- interactive onboarding wizard (PRJ-124) (#58)
+- smart context filtering tools for AI agents (PRJ-127) (#57)
+- workflow state machine + bidirectional Linear sync (#55)
+- progress indicators for long-running operations (PRJ-129) (#52)
+- agent activity stream for real-time visibility (PRJ-135) (#51)
+- show explicit next steps after each command (PRJ-136) (#50)
+- multi-agent output Phase 3 - Auto-detect + Continue.dev (PRJ-126) (#49)
+- multi-agent output Phase 2 - Copilot + Windsurf (PRJ-126) (#48)
+- multi-agent context output - Phase 1 (PRJ-126) (#47)
+- bidirectional sync Linear ↔ prjct (PRJ-142) (#46)
+- migrate Linear and JIRA from MCP to native SDK (PRJ-141) (#45)
+- enhance skill system with remote installation and lock file (#44)
+- Windsurf IDE support (PRJ-66) (#43)
+- Google Antigravity support via Skills (PRJ-64) (#42)
+- add mandatory plan-before-action rule to all agents
+- Cursor IDE support (PRJ-63) (#40)
+- Cursor IDE support (PRJ-63)
+- dual platform support - Claude + Gemini (PRJ-62) (#39)
+- 100% agentic task routing with subtask fragmentation
+- add agent/skill orchestrator + agentskills.io integration
+- auto-install MCP servers + individual command skills
+- AI-powered ticket enrichment + 4 tracker integrations v0.33.0
+- JIRA MCP integration for corporate SSO v0.32.0
+- JIRA Integration v0.31.0 (#30)
+- PM Expert auto-enrichment + statusline fixes v0.30.2
+- add p. update command for manual sync
+- modular statusline with Linear integration v0.29.0 (#29)
+- redesign build and release flow for npm
+- modular statusline with Linear integration v0.29.0
+- integrate issue tracker and AI enrichment for project management
+- per-project task filtering for status bar v0.28.0
+- Skill integration system v0.27.0 (#24)
+- Claude Code Skill Integration (Agentic) v0.27.0
+- Complete development cycle with workflow integrity v0.26.0
+- Unified /p:task command + auto-sync notification v0.24.0
+- Branch + PR workflow v0.23.0
+- Notion per-project databases + skill registration v0.22.0
+- add optional Notion integration v0.21.0
+- enhance error handling and permissions management
+- UX/UI Design Agent Integration v0.20.0
+- prompt-builder fix + web removal v0.19.0
+- add TestSprite integration for AI-powered testing
+- CLI-API sync bridge + /p:auth command v0.18.0
+- Claude Code sub-agents integration v0.17.0
+- Security, performance, and architecture improvements v0.16.1
+- Dead code cleanup - remove ~6,600 lines v0.16.0
+- Add MCP server configuration for Context7
+- Template optimization - reduce 39 to 27 commands v0.15.0
+- Refactor Project Management with UUID Migration and Enhanced Context Handling
+- Enhance Project Management with Terminal Dock and UI Improvements
+- Actionable Dashboard + Session Recovery v0.14.0
+- Add MomentumWidget + Code workspace + Weekly reports
+- Ship Deep Sync + Cleanup migrations v0.13.0
+- MigrationGate + bug fixes
+- JSON-First Architecture (Zero Data Loss)
+- Implement project stats API and enhance UI components
+- Enhance project management and terminal functionality in web application
+- Revamp web application with Next.js and enhanced features
+- Introduce new server and web components for prjct
+- Release 0.10.14 with 100% agentic delegation and task tool integration
+- Add ⚡ prjct branding with animated spinner
+- 100% agentic agent assignment - JS=orchestrator, Claude=decisions
+- 100% agentic system - eliminate all procedural keyword-based logic
+- Release 0.10.10 with executable templates and context reduction
+- Release 0.10.8 with minimal output system and reduced CLI verbosity
+- Release 0.10.7 with critical improvements and enhanced context handling
+- Enhanced global CLAUDE.md template for better prjct usage
+- Rich project context for Claude
+- Dynamic project context for Claude
+- Intelligent Agent System & Performance Optimization (v0.10.0)
+- add November 22, 2025 release notes for version 0.9.1
+- context optimization and prompt conciseness
+- add legacy installation detector and cleanup system for pre-v0.8.2 curl installations
+- add system timestamp tools and optimize top 7 templates
+- memory-efficient file operations for large JSONL files
+- simplify installation to npm-only with automatic post-install setup
+- v0.8.0 - conversational interface with zero memorization
+- add comprehensive testing documentation
+- add website component tests and configure vitest workspace
+- migrate test suite to Vitest with coverage reporting
+- add isSupported flag to agent detection for Claude and Terminal agents
+- add setup, migrate-all commands and mark roadmap/status/build as implemented
+- redesign footer layout and add AI policy page with updated navigation
+- add Vercel Analytics and Speed Insights tracking to website
+- simplify workflow to 5 essential commands
+- rebrand from project management to developer momentum tool with streamlined templates and workflows
+- add editor uninstallation and smart project data fusion to prjct init
+- add first-time setup flow and auto-initialization for all commands
+- add auto-migration from v0.1.0 projects during post-install hook
+- add auto-install and clean uninstall functionality with editor tracking
+- add GitHub Packages support and track installed editors in config
+- add Windows compatibility feature card to changelog
+- add automatic npm publication and update detection system
+- publish prjct-cli to npm registry
+- remove bun and homebrew installation methods
+- add natural language interface with English and Spanish support
+- add interactive workflow system with capability detection and installation
+- release v0.3.0 with interactive editor selection and codebase analysis
+- add project management workflows for analyzing, tracking, and fixing tasks
+- update CNAME handling and add 404 page for better routing
+- add cleanup and design commands with advanced options
+- initialize project structure with core files and documentation
 
 ### Bug Fixes
 
 - generate IDE context files with correct paths and formats (PRJ-122) (#107)
+- improve sync output with summary-first format (PRJ-100) (#100)
+- correct template paths and agent loading in CLAUDE.md (#93)
+- make lefthook hooks portable (no bun required) (#92)
+- skip lefthook in CI environments (#91)
+- use npm instead of bun in lefthook hooks (#90)
+- add pre-commit hooks to prevent commits with lint errors (#89)
+- remove legacy p.*.md commands on sync
+- ensure test isolation in IndexStorage tests
+- remove MCP integrations, keep only Context7 (#87)
+- make Linear/JIRA templates explicitly ignore MCP tools
+- remove MCP inheritance from Linear/JIRA templates
+- standardize confirmation pattern across all commands (#85)
+- LLM debe manejar los prompts, no el CLI - PRJ-149 (#84)
+- Claude over-plans simple commands like p. sync - PRJ-148 (#83)
+- implement silent memory application - PRJ-103 (#69)
+- ignore tar warning in release workflow - PRJ-147
+- remove --provenance (requires public repo) - PRJ-147
+- use Production environment for npm secrets - PRJ-147
+- use semver-sorted tags for version detection - PRJ-147
+- npm auth configuration for CI publish - PRJ-147
+- add Bun setup for test runner in CI - PRJ-147
+- use npm instead of bun for CI tests - PRJ-147
+- remove IDE files from repo - PRJ-144, PRJ-145
+- add --help handler in CLI entry point for CI compatibility
+- update tests for CI compatibility
+- CI workflow - remove unsupported bun reporter flag and fix verification
+- enforce workflow steps in templates (PRJ-143) (#56)
+- add $PRJCT_CLI prefix to relative paths in templates (PRJ-143)
+- use stderr for Linear connection log to not break JSON output
+- show Cursor in same format as other providers in --version
+- Cursor command syntax (PRJ-65) (#41)
+- reduce permission prompts from 50+ to 1 (#38)
+- cleanup legacy files and fix TS error (#37)
+- chore: release v0.35.2
+- connect CLI workflow to CommandExecutor
+- execute orchestration in TypeScript, not just paths (#36)
+- execute orchestration in TypeScript, not just paths
+- remove unsafe 'as unknown' casts (PRJ-54)
+- complete error differentiation (Phase 3) (#35)
+- enable enrichment by default in statusline config
+- self-healing setup in bin/prjct v0.30.1
+- distribution system overhaul - remove fallback, always read from npm root v0.30.0
+- setup.ts auto-execute when run directly
+- remove duplicate statusline version check
+- dynamic path resolution for compiled dist/
+- ALWAYS run postinstall setup, remove global detection
+- detect /opt/homebrew for M1/M2 Macs in postinstall
+- handle bun test warnings in release script
+- include assets/ in npm package + add linear to router
+- add cliVersion to project.json on postinstall
+- resolve symlinks in bin/prjct for npm install
+- agents only write to global storage v0.18.2
+- agents only in global storage + auto-migrate legacy v0.18.1
+- serve.js use start instead of start:prod
+- Remove migration gate from production
+- Restore sidebar collapse + fix server OOM crash
+- Prevent terminal session loss on navigation
+- Terminal responsive & performance issues
+- Server runs in production mode, port 9472
+- Export commands as singleton for direct invocation
+- Update global CLAUDE.md on sync, analyze, and init
+- Add glob dependency and update to modern API
+- critical memory leaks - LRU cache, HTTP cleanup, session expiration
+- ensure command templates always update by removing mtime checks and forcing overwrites
+- resolve critical installation bugs and add auto-update functionality with visual feedback
+- resolve TypeScript errors in website tests
+- remove unused variables to pass lint
+- update vercel build and install commands to use npm prefix syntax
+- remove unused Globe import from Privacy.tsx
+- resolve TypeScript errors in website build
+- remove vercel.json, configure Root Directory in Vercel UI
+- set rootDirectory to website for Vercel
+- use npm --prefix for Vercel build command
+- correct Vercel install command path
+- configure Vercel deployment output directory
+- restore Catppuccin-inspired ASCII art and fix undefined editor names in prjct start command
+- update Badge import path to use correct casing
+- return success exit code for help command
+- remove install script tests from workflow
+- add TERM environment variable to workflow steps
+- add missing WorkflowsGuide.tsx to repository
+- deploy install.sh and setup.sh to website
+- replace inquirer with prompts for better CommonJS compatibility in interactive editor selection
+- resolve installation path errors in setup scripts and add verification tests
+- update init command to use global architecture and fix installer version display
+- update install command URL to use www.prjct.app
+- build(deps-dev): bump vite from 4.5.14 to 7.1.7 in /docs (#1)
+
+### Performance
+
+- parallelize agent/skill loading with Promise.all (PRJ-110) (#101)
+- parallelize sync operations for 30-50% speedup (PRJ-116) (#59)
+
+### Refactoring
+
+- migrate from ESLint + Prettier to Biome
+- consolidate and optimize CI workflows
+- extract StackDetector from sync-service (PRJ-86) (#64)
+- extract ContextFileGenerator from sync-service (PRJ-88) (#63)
+- differentiate error types in catch blocks - Phase 2 (PRJ-60) (#34)
+- differentiate error types in catch blocks (PRJ-51) (#33)
+- simplify logger level detection logic (#32)
+- consolidate hardcoded paths to use pathManager singleton (#31)
+- type consolidation in core/types/ v0.20.1
+- centralize types in core/types/ following DRY principles
+- restructure command and agent modules for improved organization
+- consolidate command and storage modules for improved structure
+- migrate testing setup to Bun and enhance documentation
+- Update project structure and enhance component functionality
+- update command registry structure and remove unused imports
+- remove open source references and GitHub links
+- move Changelog link from header to footer
+- use centralized helper utilities in commands
+- migrate from GitHub Pages to Vercel deployment
+- remove redundant title from changelog technical details section
+- extract reusable components from Changelog.tsx
+- sync install.sh from scripts directory to website/public and docs
+- remove unnecessary comments from prjct.sh script
+- remove unnecessary comments from command line parsing logic
+- remove comments and unnecessary whitespace across core modules
+- move author data and system fields from local to global config
+- migrate legacy project files to new global structure with auto-migration
+- rename landing directory to website and update deploy workflow paths
+- update build paths from docs to lp directory in deploy workflow
+- improve GitHub Pages deployment workflow with better file handling and directory structure
 
 
 ## [0.64.1] - 2026-02-05

package/dist/bin/prjct.mjs

@@ -26859,7 +26859,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.64.1",
+      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": "0.64.1",
+  "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`