prjct-cli 0.28.4 → 0.29.1

package/CHANGELOG.md

@@ -1,178 +1,43 @@
 # Changelog
 
-## [0.28.4] - 2026-01-11
-
-### Feature: Claude Code UX Enhancements
-
-Rich terminal experience for Claude Code - 100% ToS compliant.
-
-**Status Line System:**
-- Custom status line script showing prjct task, git branch, lines changed
-- Context usage bar with color-coded warnings (green/yellow/red)
-- Model icons (🎭 Opus, 📝 Sonnet, 🍃 Haiku)
-- Installed at `~/.prjct-cli/statusline/statusline.sh`
-
-**Theme System:**
-- Three built-in themes: default (prjct), gentleman, minimal
-- JSON-based theme configuration
-- ANSI 256 color support
-- Located at `~/.prjct-cli/statusline/themes/`
-
-**Output Styles:**
-- `prjct.md` - Concise, actionable output (default)
-- `verbose.md` - Detailed explanations for learning
-- `ship-fast.md` - Minimal output for max velocity
-- Located at `~/.prjct-cli/output-styles/`
-
-**Hooks Integration:**
-- `update-metrics.sh` - Tracks tool usage per session
-- `session-summary.sh` - Shows stats when Claude stops
-- Located at `~/.prjct-cli/hooks/`
-
-**Visual Theme (tweakcc):**
-- Full Claude Code color theme
-- Spanish thinking verbs
-- Located at `~/.prjct-cli/tweakcc-theme.json`
-
-**New Templates:**
-- `templates/commands/setup-statusline.md` - Interactive setup
-- `templates/guides/claude-code-ux.md` - Full documentation
-- Updated `templates/global/CLAUDE.md` with UX section
-
-**Template Optimization:**
-- Further reduced template sizes
-- New shared patterns in `templates/shared/`
-
-## [0.28.3] - 2026-01-11
-
-### Feature: Claude Code Synergy Optimization
-
-Major improvements to maximize prjct + Claude Code integration efficiency.
-
-**Skill Auto-Invocation (Phase 4 of /p:task):**
-- Skills are now automatically invoked when loading agents
-- Agent frontmatter `skills: [skill-name]` triggers `Skill("skill-name")`
-- Example: Loading `frontend.md` auto-activates `/frontend-design`
-
-**MCP Auto-Usage:**
-- Agents with `mcp: [context7]` auto-query documentation during tasks
-- Per-project MCP config at `{globalPath}/config/mcp-servers.json`
-- Seamless library documentation lookup during implementation
-
-**Think Blocks for Destructive Commands:**
-- `/p:ship` now includes mandatory `<think>` block
-- Pre-ship verification checklist (completeness, quality, git state)
-- Prevents shipping incomplete or broken code
-
-**Agent Auto-Refresh in /p:sync:**
-- Detects when dependencies change (package.json, etc.)
-- Regenerates stale agents (>7 days old)
-- Versions previous agents as `.backup` files
-- Logs refresh events to memory
-
-**Slash Command Registration:**
-- New `slash-commands.json` config for Claude Code integration
-- Enables command discovery and validation
-- Path: `{globalPath}/config/slash-commands.json`
-
-**Token Budget Analysis:**
-- Estimates context token usage during sync
-- Warns if approaching 80% of budget (160k tokens)
-- Auto-summarizes large agents if needed
-
-**Client Migration on Update:**
-- Setup now creates missing config files for existing projects
-- `slash-commands.json` auto-created for existing installations
-- Seamless upgrade experience for npm update users
-
-**New TypeScript Modules:**
-- `core/infrastructure/slash-command-registry.ts` - Command validation
-- `core/agentic/token-estimator.ts` - Token budget estimation
-
-**Template Context Optimization:**
-- Reduced main templates from 3,197 to 2,214 lines (-31%)
-- `sync.md`: 1,602 → 835 lines (-48%)
-- `global/CLAUDE.md`: 429 → 363 lines (-15%)
-- `task.md`: 397 → 336 lines (-15%)
-- `ship.md`: 769 → 680 lines (-12%)
-- New `templates/guides/` for on-demand documentation
-- New `templates/shared/validation.md` for reusable validation
-
-**Files Removed (Agentic Generation):**
-- Deleted hardcoded domain agents from `templates/subagents/domain/`
-- Deleted `.mcp.json` (now generated per-project)
-- Deleted `CLAUDE.md` from root (moved to templates/global/)
+## [0.28.0] - 2026-01-12
 
----
-
-## [0.28.2] - 2026-01-10
-
-### Feature: Agent Mentions and Major Cleanup
+### Feature: Per-Project Task Filtering for Status Bar
 
-**Agent Mentions (p.agent.{name}):**
-- New `agentId` field in agent frontmatter for identification
-- Users can invoke agents in prompts: `p.agent.backend help me...`
-- Format: `p.agent.workflow`, `p.agent.planner`, `p.agent.frontend`, etc.
+Extended API now supports filtering by current working directory, enabling the status bar to show project-specific tasks.
 
-**Deprecated Commands Removed:**
-- `/p:now` - Use `/p:task` instead
-- `/p:feature` - Use `/p:task` instead
-- `/p:work` - Use `/p:task` instead
+**New Endpoints:**
+- `GET /api/status-bar/compact?cwd=/path` - Filter by cwd
+- `GET /api/projects` - List all projects
+- `GET /api/projects/:id/full` - Project dashboard
+- `POST /api/projects/:id/task/{complete,pause,resume}`
+- `GET /api/stats/global` - Global statistics
 
-**Notion Integration Removed:**
-- Removed entire `core/integrations/notion/` directory
-- Removed Notion skills and MCP config
-- Cleaned up type references
+**How it works:**
+1. Status bar detects cwd from frontmost app (Terminal, VS Code, etc.)
+2. Calls `/api/status-bar/compact?cwd=/current/path`
+3. Server matches cwd to project's `repoPath`
+4. Returns only that project's task
 
-**Code Cleanup:**
-- Removed `executeWithoutProject()` deprecated method
-- Cleaned dead code in prompt-builder arrays
-- Removed ARCHITECTURE.md (outdated)
-
-**Ship Template Enhancement:**
-- Version bump now REQUIRED before PR creation
-- CHANGELOG.md update now REQUIRED before PR creation
-- Better categorization of changes (Added/Fixed/Changed)
+**Files:**
+- `core/server/routes-extended.ts` - New extended API routes
+- `core/server/server.ts` - Mount extended routes
+- `core/server/index.ts` - Export extended routes
 
 ---
 
-## [0.28.1] - 2026-01-10
-
-### Feature: @ Agent Mentions
+## [0.27.1] - 2026-01-12
 
-Direct agent invocation via @ notation in tasks.
+### Docs: Differentiation Strategy vs Coding Agents
 
-**New Capabilities:**
+Clarified prjct's positioning as a **workflow layer**, not a coding agent.
 
-1. **@ Agent Mentions**
-   - `p. task @frontend add button` - Loads frontend specialist directly
-   - `p. task @frontend @uxui dark mode` - Loads multiple agents
-   - Supports all prjct agents: `@frontend`, `@backend`, `@database`, `@uxui`, `@testing`, `@devops`
-
-2. **@ Claude Subagents**
-   - `@explore` - Fast codebase search (Task tool with subagent_type=Explore)
-   - `@general` - Complex multi-step research
-   - `@plan` - Architecture design and planning
-   - Example: `p. task @frontend @explore add button like existing ones`
-
-3. **Performance Improvements**
-   - Template cache: O(1) LRU using ES6 Map insertion order
-   - Agent loading: Parallel Promise.all() for faster startup
-   - Glob searches: Parallel execution in context estimation
-
-4. **Tool Permissions**
-   - Templates can specify `tool-permissions` in frontmatter
-   - Supports `allow`, `ask`, and `deny` rules per tool
-   - Example: `ship.md` now declares safe vs dangerous git commands
+**Changes:**
+- Added "What prjct is (and isn't)" section to README
+- Created COMPARISON.md documenting prjct vs OpenCode, Cursor, Jira, etc.
+- Clear messaging: prjct enhances Claude Code, doesn't compete with it
 
-**Files Changed:**
-- `core/agentic/command-executor.ts` - Parse @ mentions, load mentioned agents
-- `core/agentic/prompt-builder.ts` - Build subagent instructions, tool permissions
-- `core/agentic/template-loader.ts` - LRU cache optimization, tool-permissions parsing
-- `core/agentic/agent-router.ts` - `loadAgentsByMention()` method
-- `core/domain/agent-loader.ts` - Parallel agent loading
-- `core/domain/context-estimator.ts` - Parallel glob execution
-- `templates/commands/task.md` - @ mention documentation
+**Key insight:** prjct competes with Jira/Linear/Notion (workflow tools), not with OpenCode/Cursor/Copilot (coding agents). Use both together for maximum developer momentum.
 
 ---
 

package/CLAUDE.md

@@ -0,0 +1,170 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code when working with prjct-cli.
+
+## Project Overview
+
+**prjct-cli** is a developer momentum tool. Track progress through natural language commands (`p. <command>`) without meetings or traditional PM overhead.
+
+## HOW PRJCT WORKS
+
+When user types `p. <command>`, load the template from `templates/commands/{command}.md` and execute it **intelligently** - templates are GUIDANCE, not rigid scripts.
+
+```
+p. sync     → Analyze project, generate domain agents
+p. task X   → Start task with classification + breakdown
+p. done     → Complete current subtask
+p. ship X   → Ship feature with PR + version bump
+```
+
+---
+
+## CRITICAL RULES
+
+### 1. Path Resolution (MOST IMPORTANT)
+**ALL writes go to global storage**: `~/.prjct-cli/projects/{projectId}/`
+- **NEVER** write to `.prjct/` (config only, read-only)
+- **NEVER** write to `./` (current directory)
+
+### 2. Before Any Command
+```
+1. Read .prjct/prjct.config.json → get projectId
+2. Set globalPath = ~/.prjct-cli/projects/{projectId}
+3. Execute using globalPath for all writes
+4. Log to {globalPath}/memory/events.jsonl
+```
+
+### 3. Timestamps & UUIDs
+```bash
+# Timestamp (NEVER hardcode)
+bun -e "console.log(new Date().toISOString())" 2>/dev/null || node -e "console.log(new Date().toISOString())"
+
+# UUID
+bun -e "console.log(crypto.randomUUID())" 2>/dev/null || node -e "console.log(require('crypto').randomUUID())"
+```
+
+### 4. Git Commit Footer (CRITICAL - ALWAYS INCLUDE)
+
+**Every commit MUST include the prjct signature:**
+
+```
+🤖 Generated with [p/](https://www.prjct.app/)
+Designed for [Claude](https://www.anthropic.com/claude)
+
+```
+
+**NON-NEGOTIABLE: The `🤖 Generated with [p/]` line identifies prjct-powered commits.**
+
+---
+
+## ARCHITECTURE: Write-Through Pattern
+
+```
+User Action → Storage (JSON) → Context (MD) → Sync Events
+```
+
+| Layer | Path | Purpose |
+|-------|------|---------|
+| **Storage** | `storage/*.json` | Source of truth |
+| **Context** | `context/*.md` | Claude-readable summaries |
+| **Memory** | `memory/events.jsonl` | Audit trail (append-only) |
+| **Agents** | `agents/*.md` | Domain specialists |
+
+### File Structure
+```
+~/.prjct-cli/projects/{projectId}/
+├── storage/
+│   ├── state.json      # Current task (SOURCE OF TRUTH)
+│   ├── queue.json      # Task queue
+│   └── shipped.json    # Shipped features
+├── context/
+│   ├── now.md          # Current task (generated)
+│   └── next.md         # Queue (generated)
+├── memory/
+│   └── events.jsonl    # Audit trail
+├── agents/             # Domain specialists
+└── sync/
+    └── pending.json    # Backend events
+```
+
+---
+
+## COMMANDS
+
+| Trigger | Purpose |
+|---------|---------|
+| `p. init` | Initialize project with deep analysis |
+| `p. sync` | Analyze repo, generate agents |
+| `p. task <desc>` | Start task with agentic classification |
+| `p. done` | Complete current subtask |
+| `p. ship [name]` | Ship with PR + version bump |
+| `p. pause` | Pause active task |
+| `p. resume` | Resume paused task |
+| `p. bug <desc>` | Report bug with auto-priority |
+
+### Workflow
+```
+p. sync → p. task "description" → [work] → p. done → p. ship
+```
+
+---
+
+## INTELLIGENT BEHAVIOR
+
+Templates provide guidance. Use your intelligence to:
+
+1. **Read before write** - Always read existing files first
+2. **Explore before coding** - Use Task(Explore) to understand codebase
+3. **Ask when uncertain** - Use AskUserQuestion to clarify
+4. **Load agents** - Read from `{globalPath}/agents/` for domain expertise
+5. **Adapt templates** - They're guidance, not rigid scripts
+6. **Log everything** - Append to memory/events.jsonl
+
+---
+
+## OUTPUT FORMAT
+
+Concise responses (< 4 lines):
+```
+✅ [What was done]
+
+[Key metrics]
+Next: [suggested action]
+```
+
+---
+
+## KEY RULES
+
+1. **Read files before editing** - Never assume structure
+2. **Use node/bun for timestamps** - Never hardcode dates
+3. **Follow template guidance** - But adapt intelligently
+4. **Log to memory** - Append to `memory/events.jsonl`
+5. **Suggest next actions** - Maintain user momentum
+6. **Use linked skills** - Agents have skills in frontmatter
+
+---
+
+## SKILL INTEGRATION (v0.27)
+
+Agents are linked to Claude Code skills from claude-plugins.dev.
+
+### Agent → Skill Mapping
+
+| Agent | Skill |
+|-------|-------|
+| `frontend.md` | `frontend-design` |
+| `uxui.md` | `frontend-design` |
+| `backend.md` | `javascript-typescript` |
+| `testing.md` | `developer-kit` |
+| `devops.md` | `developer-kit` |
+| `prjct-planner.md` | `feature-dev` |
+| `prjct-shipper.md` | `code-review` |
+
+### Usage
+
+- `p. sync` installs required skills automatically
+- `p. task` invokes skills based on task type
+- Skills config: `{globalPath}/config/skills.json`
+
+See `templates/agentic/skill-integration.md` for details.

package/README.md

@@ -22,7 +22,20 @@ Developer momentum tool for indie hackers and small teams.
 > - `p. I'm done`
 > - `p. ship the authentication`
 
-## 💬 p. Trigger - Zero Memorization
+## What prjct is (and isn't)
+
+**prjct is a workflow layer, not a coding agent.**
+
+| Coding Agents | prjct-cli |
+|---------------|-----------|
+| Write code for you | Tracks what you're building |
+| Replace your IDE | Enhances Claude Code |
+| Multi-provider (GPT, Claude, etc.) | 100% Claude-optimized |
+| Compete with Cursor, Copilot | Replaces Jira, Linear, Notion |
+
+**Use both together:** OpenCode/Cursor/Claude Code writes the code. prjct tracks your progress, maintains context between sessions, and keeps you focused.
+
+## p. Trigger - Zero Memorization
 
 **You don't need to memorize commands.** Just use the `p.` prefix and talk naturally!
 

package/assets/statusline/components/changes.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# prjct statusline - Changes component
+# Displays lines added and removed
+
+component_changes() {
+  component_enabled "changes" || return
+
+  # ADDED and REMOVED are set by parse_stdin in cache.sh
+  echo -e "${SUCCESS}+${ADDED}${NC} ${ERROR}-${REMOVED}${NC}"
+}

package/assets/statusline/components/context.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+# prjct statusline - Context component
+# Displays context window usage progress bar
+
+component_context() {
+  component_enabled "context" || return
+
+  # CTX_PERCENT is set by parse_stdin in cache.sh
+  local bar_width="${CONFIG_CONTEXT_BAR_WIDTH:-10}"
+  local filled=$((CTX_PERCENT * bar_width / 100))
+  local empty=$((bar_width - filled))
+
+  # Determine color based on usage
+  local bar_color
+  if [[ "$CTX_PERCENT" -ge 80 ]]; then
+    bar_color="$ERROR"
+  elif [[ "$CTX_PERCENT" -ge 50 ]]; then
+    bar_color="$ACCENT"
+  else
+    bar_color="$SUCCESS"
+  fi
+
+  # Build progress bar
+  local bar="${bar_color}"
+  for ((i=0; i<filled; i++)); do bar+="█"; done
+  bar+="${MUTED}"
+  for ((i=0; i<empty; i++)); do bar+="░"; done
+  bar+="${NC}"
+
+  echo -e "${MUTED}ctx${NC} ${bar} ${MUTED}${CTX_PERCENT}%${NC}"
+}

package/assets/statusline/components/dir.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+# prjct statusline - Directory component
+# Displays the current directory name
+
+component_dir() {
+  component_enabled "dir" || return
+
+  local dir_name=$(basename "$CWD")
+
+  echo -e "${ACCENT}${ICON_DIR} ${dir_name}${NC}"
+}

package/assets/statusline/components/git.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# prjct statusline - Git component
+# Displays the current branch and dirty status
+
+component_git() {
+  component_enabled "git" || return
+
+  local cache_file="${CACHE_DIR}/git.cache"
+  local git_data=""
+
+  # Check cache first
+  if cache_valid "$cache_file" "$CONFIG_CACHE_TTL_GIT"; then
+    git_data=$(cat "$cache_file")
+  else
+    # Check if in git repo
+    if ! git -C "$CWD" rev-parse --git-dir > /dev/null 2>&1; then
+      return
+    fi
+
+    # Get branch name
+    local branch=$(git -C "$CWD" branch --show-current 2>/dev/null)
+    [[ -z "$branch" ]] && return
+
+    # Check for dirty state
+    local dirty=""
+    if [[ -n $(git -C "$CWD" status --porcelain 2>/dev/null | head -1) ]]; then
+      dirty="*"
+    fi
+
+    git_data="${branch}|${dirty}"
+
+    # Cache the result
+    write_cache "$cache_file" "$git_data"
+  fi
+
+  [[ -z "$git_data" ]] && return
+
+  # Parse git data
+  local branch=$(echo "$git_data" | cut -d'|' -f1)
+  local dirty=$(echo "$git_data" | cut -d'|' -f2)
+
+  [[ -z "$branch" ]] && return
+
+  echo -e "${SECONDARY}${ICON_GIT} ${branch}${dirty}${NC}"
+}

package/assets/statusline/components/linear.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# prjct statusline - Linear integration component
+# Displays the linked Linear issue ID and priority
+
+component_linear() {
+  component_enabled "linear" || return
+  [[ "${CONFIG_LINEAR_ENABLED}" != "true" ]] && return
+
+  local cache_file="${CACHE_DIR}/linear.cache"
+  local issue_data=""
+
+  # Check cache first
+  if cache_valid "$cache_file" "$CONFIG_CACHE_TTL_LINEAR"; then
+    issue_data=$(cat "$cache_file")
+  else
+    # Get project ID
+    local project_id=$(get_project_id)
+    [[ -z "$project_id" ]] && return
+
+    local global_path="${HOME}/.prjct-cli/projects/${project_id}"
+    local state_file="${global_path}/storage/state.json"
+    local issues_file="${global_path}/storage/issues.json"
+
+    # Check if state file exists
+    [[ ! -f "$state_file" ]] && return
+
+    # Get linked issue from current task
+    local linked_issue=$(jq -r '.currentTask.linkedIssue // ""' "$state_file" 2>/dev/null)
+
+    # If no linked issue, try to get from issues.json (last worked)
+    if [[ -z "$linked_issue" ]] && [[ -f "$issues_file" ]]; then
+      # Get most recently updated issue that's in_progress
+      linked_issue=$(jq -r '
+        .issues // {} | to_entries
+        | map(select(.value.status == "in_progress"))
+        | sort_by(.value.updatedAt) | last
+        | .key // ""
+      ' "$issues_file" 2>/dev/null)
+    fi
+
+    [[ -z "$linked_issue" ]] && return
+
+    # Get issue details from issues cache
+    if [[ -f "$issues_file" ]]; then
+      issue_data=$(jq -r --arg id "$linked_issue" '
+        .issues[$id] // {} |
+        "\(.externalId // "")|\(.priority // "none")"
+      ' "$issues_file" 2>/dev/null)
+
+      # Cache the result
+      write_cache "$cache_file" "$issue_data"
+    fi
+  fi
+
+  # Return empty if no data
+  [[ -z "$issue_data" || "$issue_data" == "|" ]] && return
+
+  # Parse issue data
+  local issue_id=$(echo "$issue_data" | cut -d'|' -f1)
+  local priority=$(echo "$issue_data" | cut -d'|' -f2)
+
+  [[ -z "$issue_id" ]] && return
+
+  # Format output
+  local output="${ACCENT}${issue_id}${NC}"
+
+  # Add priority icon if enabled and priority is significant
+  if [[ "${CONFIG_LINEAR_SHOW_PRIORITY}" == "true" ]]; then
+    local priority_icon=$(get_priority_icon "$priority")
+    [[ -n "$priority_icon" ]] && output+="${priority_icon}"
+  fi
+
+  echo -e "$output"
+}

package/assets/statusline/components/model.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+# prjct statusline - Model component
+# Displays the current model icon
+
+component_model() {
+  component_enabled "model" || return
+
+  # MODEL is set by parse_stdin in cache.sh
+  local icon=$(get_model_icon "$MODEL")
+
+  echo -e "$icon"
+}

package/assets/statusline/components/prjct_icon.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+# prjct statusline - prjct icon component
+# Displays the prjct brand icon
+
+component_prjct_icon() {
+  component_enabled "prjct_icon" || return
+
+  echo -e "${PRIMARY}${BOLD}${ICON_PRJCT}${NC}"
+}

package/assets/statusline/components/task.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# prjct statusline - Task component
+# Displays the current prjct task
+
+component_task() {
+  component_enabled "task" || return
+
+  local cache_file="${CACHE_DIR}/prjct_task.cache"
+  local task=""
+
+  # Check cache first
+  if cache_valid "$cache_file" "$CONFIG_CACHE_TTL_PRJCT"; then
+    task=$(cat "$cache_file")
+  else
+    # Get project ID
+    local project_id=$(get_project_id)
+    [[ -z "$project_id" ]] && return
+
+    # Get state file
+    local state_file="${HOME}/.prjct-cli/projects/${project_id}/storage/state.json"
+    [[ ! -f "$state_file" ]] && return
+
+    # Extract task title or description
+    task=$(jq -r '.currentTask.title // .currentTask.description // ""' "$state_file" 2>/dev/null)
+
+    # Truncate if too long
+    local max_len="${CONFIG_TASK_MAX_LENGTH:-25}"
+    if [[ ${#task} -gt $max_len ]]; then
+      task="${task:0:$((max_len - 3))}..."
+    fi
+
+    # Cache the result
+    write_cache "$cache_file" "$task"
+  fi
+
+  # Return empty if no task
+  [[ -z "$task" ]] && return
+
+  echo -e "${PURPLE}${task}${NC}"
+}

package/assets/statusline/default-config.json

@@ -0,0 +1,46 @@
+{
+  "version": 1,
+  "theme": "default",
+  "cacheTTL": {
+    "prjct": 30,
+    "git": 5,
+    "linear": 60
+  },
+  "components": {
+    "prjct_icon": {
+      "enabled": true,
+      "position": 0
+    },
+    "task": {
+      "enabled": true,
+      "position": 1,
+      "maxLength": 25
+    },
+    "linear": {
+      "enabled": true,
+      "position": 2,
+      "showPriority": true
+    },
+    "dir": {
+      "enabled": true,
+      "position": 3
+    },
+    "git": {
+      "enabled": true,
+      "position": 4
+    },
+    "changes": {
+      "enabled": true,
+      "position": 5
+    },
+    "context": {
+      "enabled": true,
+      "position": 6,
+      "barWidth": 10
+    },
+    "model": {
+      "enabled": true,
+      "position": 7
+    }
+  }
+}