prjct-cli 0.13.3 → 0.15.1

package/templates/commands/sync.md

@@ -2,13 +2,27 @@
 allowed-tools: [Read, Write, Bash, Glob, Grep]
 description: 'Deep sync - analyze git, update ALL project data'
 timestamp-rule: 'GetTimestamp() for all timestamps'
-architecture: 'MD-first - MD files are source of truth'
+architecture: 'Write-Through (JSON → MD → Events)'
+storage-layer: true
+source-of-truth: 'storage/*.json'
+claude-context: 'context/*.md'
+backend-sync: 'sync/pending.json'
 ---
 
 # /p:sync - Deep Project Sync
 
 **CRITICAL**: This is a DEEP analysis. Sync EVERYTHING with the real state of the repository.
 
+## Architecture: Write-Through Pattern
+
+```
+Git Analysis → Storage (JSON) → Context (MD) → Project Metadata
+```
+
+**Source of Truth**: `storage/*.json` (state, queue, ideas, shipped)
+**Claude Context**: `context/*.md` (now, next, ideas, shipped, CLAUDE.md)
+**Project Metadata**: `project.json`
+
 ## What Gets Analyzed & Updated
 
 ### Git Analysis (Deep)
@@ -17,18 +31,21 @@ architecture: 'MD-first - MD files are source of truth'
 - `git diff` - What's changed since last commit
 - `git branch` - Current branch, feature branches
 
-### ALL MD Files Updated
-- `core/now.md` - Current task (validate against git status)
-- `core/next.md` - Task queue (remove completed ones)
-- `progress/shipped.md` - Add tasks found in commits
-- `planning/ideas.md` - Keep valid, remove implemented
-- `planning/roadmap.md` - Update feature status
+### Storage Files (Source of Truth)
+- `storage/state.json` - Current task state
+- `storage/queue.json` - Task queue
+- `storage/ideas.json` - Ideas list
+- `storage/shipped.json` - Shipped features
+
+### Context Files (Generated for Claude)
+- `context/now.md` - Current task (from state.json)
+- `context/next.md` - Task queue (from queue.json)
+- `context/ideas.md` - Ideas (from ideas.json)
+- `context/shipped.md` - Shipped (from shipped.json)
+- `context/CLAUDE.md` - Full project context
 
 ### Project Metadata
 - `project.json` - ALL fields with real data
-- `CLAUDE.md` - Quick Reference with real stats
-- `analysis/repo-summary.md` - Full analysis
-- `agents/*.md` - Specialized agents
 
 ## Context Variables
 - `{projectId}`: From `.prjct/prjct.config.json`
@@ -56,9 +73,9 @@ git status --porcelain
 ```
 
 EXTRACT:
-- `{stagedFiles}`: Files staged for commit (A, M, D prefixed with space)
-- `{modifiedFiles}`: Modified but not staged (M, D without space prefix)
-- `{untrackedFiles}`: New files (??)
+- `{stagedFiles}`: Files staged for commit
+- `{modifiedFiles}`: Modified but not staged
+- `{untrackedFiles}`: New files
 - `{hasUncommittedChanges}`: true/false
 
 ### 2.2 Recent Commits (Last 20)
@@ -66,17 +83,14 @@ EXTRACT:
 git log --oneline -20 --pretty=format:"%h|%s|%ad" --date=short
 ```
 
-ANALYZE each commit message for:
-- Keywords: "feat:", "fix:", "complete", "done", "implement", "add", "finish"
-- Task patterns: "Task: X", "#123", issue references
-- Feature completions: "feat(auth):", "feat: user login"
+ANALYZE each commit for completed tasks.
 
 EXTRACT: `{completedTasks}` - List of tasks found in commits
 
 ### 2.3 Current Branch Analysis
 ```bash
 git branch --show-current
-git log main..HEAD --oneline 2>/dev/null || git log master..HEAD --oneline 2>/dev/null
+git log main..HEAD --oneline 2>/dev/null
 ```
 
 EXTRACT:
@@ -84,21 +98,13 @@ EXTRACT:
 - `{branchCommits}`: Commits ahead of main
 - `{isFeatureBranch}`: true if not main/master
 
-### 2.4 Uncommitted Changes Summary
-```bash
-git diff --stat
-git diff --cached --stat
-```
-
-EXTRACT: `{changesDescription}` - What files are being worked on
-
 ---
 
 ## Step 3: Gather Project Stats
 
 ### Count Files
 ```bash
-find . -type f \( -name "*.js" -o -name "*.ts" -o -name "*.jsx" -o -name "*.tsx" -o -name "*.py" -o -name "*.go" -o -name "*.rs" \) -not -path "./node_modules/*" -not -path "./.git/*" -not -path "./dist/*" -not -path "./.next/*" | wc -l
+find . -type f \( -name "*.js" -o -name "*.ts" -o -name "*.tsx" -o -name "*.py" \) -not -path "./node_modules/*" -not -path "./.git/*" | wc -l
 ```
 EXTRACT: `{fileCount}`
 
@@ -127,86 +133,120 @@ EXTRACT: `{languages}`, `{frameworks}`, `{techStack}`
 
 ---
 
-## Step 4: Sync Core MD Files
+## Step 4: Regenerate ALL Context Files
 
-### 4.1 Update now.md (Current Task)
+### 4.1 Read Storage (Source of Truth)
 
-READ: `{globalPath}/core/now.md`
+READ: `{globalPath}/storage/state.json`
+READ: `{globalPath}/storage/queue.json`
+READ: `{globalPath}/storage/ideas.json`
+READ: `{globalPath}/storage/shipped.json`
 
-**Logic:**
-- IF `{hasUncommittedChanges}` AND now.md is empty:
-  - INFER task from modified files (e.g., "Working on: auth module")
-  - UPDATE now.md with inferred task
+### 4.2 Generate context/now.md
 
-- IF now.md has task AND task appears in recent commits:
-  - Task is DONE → Clear now.md, add to shipped.md
+WRITE: `{globalPath}/context/now.md`
 
-- IF `{isFeatureBranch}`:
-  - Suggest task based on branch name (e.g., `feature/auth` → "Implement authentication")
+IF state.currentTask exists:
+```markdown
+# NOW
 
-WRITE: `{globalPath}/core/now.md`
+**{state.currentTask.description}**
 
-### 4.2 Update next.md (Task Queue)
+Started: {state.currentTask.startedAt}
+Session: {state.currentTask.sessionId}
+{IF estimate: Estimate: {state.currentTask.estimate}}
+```
 
-READ: `{globalPath}/core/next.md`
+ELSE IF state.pausedTask exists:
+```markdown
+# NOW
 
-**Logic:**
-- Parse existing tasks (lines starting with `- `)
-- For each task, check if it appears in `{completedTasks}` from commits
-- REMOVE completed tasks from queue
-- Keep remaining tasks
+⏸️ **{state.pausedTask.description}** (paused)
 
-WRITE: `{globalPath}/core/next.md`
+Paused: {state.pausedTask.pausedAt}
+Reason: {state.pausedTask.pauseReason}
+```
 
-### 4.3 Update shipped.md (Completed Work)
+ELSE:
+```markdown
+# NOW
 
-READ: `{globalPath}/progress/shipped.md`
+_No active task_
 
-**Logic:**
-- For each task in `{completedTasks}` from git commits:
-  - Check if NOT already in shipped.md
-  - ADD new entries with commit date
+Use `/p:now <task>` to start working.
+```
+
+### 4.3 Generate context/next.md
+
+WRITE: `{globalPath}/context/next.md`
 
-FORMAT for new entries:
 ```markdown
-- **{taskName}** - {date}
-  - Commit: {commitHash}
+# NEXT
+
+## Active
+
+{FOR EACH task in queue.tasks WHERE section == "active":}
+- [ ] {task.description} {task.priority ? `[${task.priority}]` : ''}
+{END FOR}
+
+## Backlog
+
+{FOR EACH task in queue.tasks WHERE section == "backlog":}
+- [ ] {task.description}
+{END FOR}
 ```
 
-WRITE: `{globalPath}/progress/shipped.md`
+### 4.4 Generate context/ideas.md
+
+WRITE: `{globalPath}/context/ideas.md`
+
+```markdown
+# IDEAS
 
-### 4.4 Update ideas.md
+## Pending
 
-READ: `{globalPath}/planning/ideas.md`
+{FOR EACH idea in ideas.ideas WHERE status == "pending":}
+- **{idea.text}** {idea.tags.join(' ')}
+  - Priority: {idea.priority}
+  - Added: {idea.createdAt}
+{END FOR}
 
-**Logic:**
-- Parse existing ideas
-- Check if any idea was implemented (appears in commits)
-- REMOVE implemented ideas OR mark as done
+## Converted
 
-WRITE: `{globalPath}/planning/ideas.md`
+{FOR EACH idea in ideas.ideas WHERE status == "converted":}
+- ~~{idea.text}~~ → Feature
+{END FOR}
+```
 
-### 4.5 Update roadmap.md
+### 4.5 Generate context/shipped.md
 
-READ: `{globalPath}/planning/roadmap.md`
+WRITE: `{globalPath}/context/shipped.md`
 
-**Logic:**
-- Parse features and their status
-- For each feature, check commits for implementation
-- UPDATE status: planning → in-progress → completed
-- Add completion dates where applicable
+```markdown
+# SHIPPED 🚀
 
-WRITE: `{globalPath}/planning/roadmap.md`
+## {Current Month Year}
+
+{FOR EACH ship in shipped.shipped WHERE month matches:}
+- **{ship.name}** v{ship.version} - {formatDate(ship.shippedAt)}
+{END FOR}
 
 ---
 
-## Step 5: Update CLAUDE.md
+**Total shipped:** {shipped.shipped.length}
+```
 
-READ: `{globalPath}/CLAUDE.md`
+---
+
+## Step 5: Update context/CLAUDE.md
 
-### Quick Reference Table (MUST UPDATE)
+WRITE: `{globalPath}/context/CLAUDE.md`
 
 ```markdown
+# {projectName} - Project Context
+<!-- projectId: {projectId} -->
+<!-- Generated: {GetTimestamp()} -->
+
 ## Quick Reference
 
 | Field | Value |
@@ -219,11 +259,7 @@ READ: `{globalPath}/CLAUDE.md`
 | **Branch** | {currentBranch} |
 | **Path** | {cwd} |
 | **Last Sync** | {GetTimestamp()} |
-```
-
-### Git Status Section
 
-```markdown
 ## Current Git Status
 
 **Branch**: `{currentBranch}`
@@ -232,13 +268,46 @@ READ: `{globalPath}/CLAUDE.md`
 {IF hasUncommittedChanges}
 ### Modified Files
 {list of modified files}
-
-### What's Being Worked On
-{changesDescription}
 {ENDIF}
-```
 
-WRITE: `{globalPath}/CLAUDE.md`
+## PROJECT DATA
+
+### Dependencies
+{list dependencies from package.json}
+
+### Scripts
+{list scripts from package.json}
+
+## CURRENT STATE
+
+**Now:** {currentTask or "_No active task_"}
+
+**Queue ({queue.tasks.length}):**
+{list first 5 tasks}
+
+**Ideas ({ideas.ideas.length}):**
+{list first 3 ideas}
+
+## DATA LOCATION
+
+\`\`\`
+~/.prjct-cli/projects/{projectId}/
+├── storage/        # JSON (source of truth)
+│   ├── state.json
+│   ├── queue.json
+│   ├── ideas.json
+│   └── shipped.json
+├── context/        # MD (for Claude)
+│   ├── CLAUDE.md
+│   ├── now.md
+│   ├── next.md
+│   ├── ideas.md
+│   └── shipped.md
+├── sync/           # Backend sync
+│   └── pending.json
+└── agents/         # Specialists
+\`\`\`
+```
 
 ---
 
@@ -267,64 +336,28 @@ WRITE: `{globalPath}/project.json`
 
 ---
 
-## Step 7: Generate Analysis Files
+## Step 7: Generate Agents (AGENTIC)
 
-### repo-summary.md
-WRITE: `{globalPath}/analysis/repo-summary.md`
+Based on detected stack, generate specialized agents.
 
-```markdown
-# Repository Summary
-
-> Generated: {GetTimestamp()}
-
-## Project
-- **Name**: {projectName}
-- **Version**: {version}
-- **Path**: {cwd}
-
-## Stack
-- **Languages**: {languages}
-- **Frameworks**: {frameworks}
-- **Package Manager**: {packageManager}
-
-## Stats
-- **Files**: {fileCount}
-- **Commits**: {commitCount}
-- **Contributors**: {contributorCount}
-
-## Structure
-- **Source**: {sourceDir}
-- **Tests**: {testDir}
-- **Config**: {configFiles}
-
-## Git Status
-- **Branch**: {currentBranch}
-- **Uncommitted**: {hasUncommittedChanges}
-- **Recent Activity**: {recentCommitCount} commits this week
+For EACH specialist needed:
+```typescript
+const generator = new AgentGenerator('{projectId}')
+await generator.generateDynamicAgent('agent-name', {
+  role: 'specific role',
+  domain: 'domain',
+  expertise: 'technologies'
+})
 ```
 
-### patterns.md (Code patterns detected)
-Analyze code and WRITE: `{globalPath}/analysis/patterns.md`
-
 ---
 
-## Step 8: Generate/Update Agents
+## Step 8: Log to Memory
 
-Based on detected stack, generate specialized agents in `{globalPath}/agents/`:
-
-- `coordinator.md` - Always generated
-- `fe.md` - If React/Vue/Angular detected
-- `be.md` - If Express/Fastify/Django detected
-- `qa.md` - If tests detected
-
----
-
-## Step 9: Log to Memory
-
-APPEND to: `{globalPath}/memory/context.jsonl`
+APPEND to: `{globalPath}/memory/events.jsonl`
 
 ```json
-{"ts":"{GetTimestamp()}","action":"sync","branch":"{currentBranch}","uncommitted":{hasUncommittedChanges},"tasksCompleted":{completedTaskCount},"fileCount":{fileCount},"commitCount":{commitCount}}
+{"ts":"{GetTimestamp()}","action":"sync","branch":"{currentBranch}","uncommitted":{hasUncommittedChanges},"fileCount":{fileCount},"commitCount":{commitCount}}
 ```
 
 ---
@@ -345,24 +378,15 @@ APPEND to: `{globalPath}/memory/context.jsonl`
 ├── Uncommitted: {hasUncommittedChanges ? "Yes - " + modifiedCount + " files" : "Clean"}
 └── Recent: {recentCommitCount} commits this week
 
-✅ Tasks Synced
-├── Completed (from commits): {completedTaskCount}
-├── Removed from queue: {removedFromQueue}
-└── Added to shipped: {addedToShipped}
-
-📁 Files Updated
-├── core/now.md
-├── core/next.md
-├── progress/shipped.md
-├── planning/ideas.md
-├── planning/roadmap.md
-├── project.json
-├── CLAUDE.md
-└── analysis/*.md
+📁 Context Updated
+├── context/now.md
+├── context/next.md
+├── context/ideas.md
+├── context/shipped.md
+└── context/CLAUDE.md
 
 {IF hasUncommittedChanges}
-⚠️  You have uncommitted changes:
-{changesDescription}
+⚠️  You have uncommitted changes
 
 Next: Commit your work or continue coding
 {ELSE}
@@ -385,60 +409,25 @@ Next: /p:now to start a new task
 
 ---
 
-## Examples
-
-### Example: Clean repo, tasks completed
-```
-🔄 Deep Sync Complete
-
-📊 Project Stats
-├── Files: 156
-├── Commits: 234
-├── Version: 1.2.0
-└── Stack: TypeScript + React + Node.js
-
-🌿 Git Status
-├── Branch: main
-├── Uncommitted: Clean
-└── Recent: 8 commits this week
-
-✅ Tasks Synced
-├── Completed (from commits): 3
-├── Removed from queue: 2
-└── Added to shipped: 3
-
-📁 Files Updated
-├── core/now.md (cleared - task completed)
-├── core/next.md (2 tasks removed)
-├── progress/shipped.md (+3 entries)
-└── All metadata updated
-
-✨ Repository is clean!
-
-Next: /p:now to start a new task
-```
+## File Structure Reference
 
-### Example: Work in progress
 ```
-🔄 Deep Sync Complete
-
-📊 Project Stats
-├── Files: 156
-├── Commits: 234
-├── Version: 1.2.0
-└── Stack: TypeScript + React + Node.js
-
-🌿 Git Status
-├── Branch: feature/auth
-├── Uncommitted: Yes - 5 files
-└── Recent: 3 commits today
-
-⚠️  You have uncommitted changes:
-   M src/auth/login.tsx
-   M src/auth/signup.tsx
-   A src/auth/utils.ts
-
-Working on: Authentication module
-
-Next: Commit your work or continue coding
+~/.prjct-cli/projects/{projectId}/
+├── storage/                  # Source of Truth (JSON)
+│   ├── state.json           # Current + paused task
+│   ├── queue.json           # Task queue
+│   ├── ideas.json           # Ideas list
+│   └── shipped.json         # Shipped features
+├── context/                  # For Claude (MD)
+│   ├── CLAUDE.md            # Full context
+│   ├── now.md               # Current task
+│   ├── next.md              # Queue
+│   ├── ideas.md             # Ideas
+│   └── shipped.md           # Shipped
+├── sync/                     # Backend Sync
+│   └── pending.json         # Events queue
+├── agents/                   # Specialists
+├── memory/                   # Audit Trail
+│   └── events.jsonl
+└── project.json             # Metadata
 ```

package/templates/commands/undo.md

@@ -2,6 +2,8 @@
 allowed-tools: [Read, Write, Bash]
 description: 'Undo last changes by restoring previous snapshot'
 timestamp-rule: 'GetTimestamp() for ALL timestamps'
+architecture: 'Write-Through (JSON → MD → Events)'
+storage-layer: true
 ---
 
 # /p:undo - Revert to Previous Snapshot
@@ -13,7 +15,7 @@ Reverts the project to the previous snapshot state. Uses Git-based snapshots sto
 - `{projectId}`: From `.prjct/prjct.config.json`
 - `{globalPath}`: `~/.prjct-cli/projects/{projectId}`
 - `{snapshotDir}`: `{globalPath}/snapshots`
-- `{memoryPath}`: `{globalPath}/memory/context.jsonl`
+- `{memoryPath}`: `{globalPath}/memory/events.jsonl`
 
 ## Step 1: Read Config
 
@@ -29,7 +31,7 @@ IF file not found:
 BASH: `cd ~/.prjct-cli/projects/{projectId}/snapshots && git log --oneline -5 2>/dev/null || echo "NO_SNAPSHOTS"`
 
 IF output contains "NO_SNAPSHOTS" OR empty:
-  OUTPUT: "⚠️ No snapshots available. Create one with /p:ship first."
+  OUTPUT: "No snapshots available. Create one with /p:ship first."
   STOP
 
 CAPTURE last two lines as:
@@ -37,7 +39,7 @@ CAPTURE last two lines as:
 - {previousHash}: Second line (snapshot to restore)
 
 IF only one snapshot exists:
-  OUTPUT: "⚠️ Only one snapshot exists. Nothing to undo."
+  OUTPUT: "Only one snapshot exists. Nothing to undo."
   STOP
 
 ## Step 3: Get Current State Info
@@ -139,7 +141,7 @@ Files affected: 5
 
 ### Example 2: Nothing to Undo
 ```
-⚠️ Only one snapshot exists. Nothing to undo.
+Only one snapshot exists. Nothing to undo.
 
 Create more snapshots with /p:ship
 ```

package/templates/mcp-config.json

@@ -2,7 +2,26 @@
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp@latest"]
+      "args": ["-y", "@upstash/context7-mcp@latest"],
+      "description": "Library documentation lookup - use for framework/library docs"
+    }
+  },
+  "usage": {
+    "context7": {
+      "when": [
+        "Looking up official documentation for any library/framework",
+        "Implementing features using specific libraries (React, Next.js, etc)",
+        "Checking API references and best practices",
+        "Troubleshooting library-specific issues"
+      ],
+      "tools": [
+        "resolve-library-id: Find library ID from name (e.g., 'react' → '/facebook/react')",
+        "get-library-docs: Fetch documentation for a library ID"
+      ],
+      "examples": [
+        "resolve-library-id('nextjs') → get-library-docs('/vercel/next.js', 'app router')",
+        "resolve-library-id('tailwindcss') → get-library-docs('/tailwindlabs/tailwindcss', 'configuration')"
+      ]
     }
   }
 }

package/core/data/agents-manager.ts

@@ -1,76 +0,0 @@
-/**
- * Agents Manager
- *
- * Manages agents.json - specialized AI agents.
- */
-
-import { ArrayManager } from './base-manager'
-import type { AgentSchema, AgentsSchema } from '../schemas'
-import { DEFAULT_AGENT } from '../schemas'
-
-class AgentsManager extends ArrayManager<AgentSchema> {
-  constructor() {
-    super('agents.json')
-  }
-
-  async getAgents(projectId: string): Promise<AgentsSchema> {
-    return this.read(projectId)
-  }
-
-  async getAgent(projectId: string, name: string): Promise<AgentSchema | undefined> {
-    return this.find(projectId, (agent) => agent.name === name)
-  }
-
-  async addAgent(
-    projectId: string,
-    agent: Pick<AgentSchema, 'name' | 'description'> & Partial<AgentSchema>
-  ): Promise<AgentsSchema> {
-    const fullAgent: AgentSchema = {
-      ...DEFAULT_AGENT,
-      ...agent
-    }
-    return this.add(projectId, fullAgent)
-  }
-
-  async updateAgent(
-    projectId: string,
-    name: string,
-    updates: Partial<AgentSchema>
-  ): Promise<AgentsSchema> {
-    return this.updateItem(
-      projectId,
-      (agent) => agent.name === name,
-      (agent) => ({ ...agent, ...updates })
-    )
-  }
-
-  async removeAgent(projectId: string, name: string): Promise<AgentsSchema> {
-    return this.remove(projectId, (agent) => agent.name === name)
-  }
-
-  async setAgents(projectId: string, agents: AgentsSchema): Promise<void> {
-    await this.write(projectId, agents)
-  }
-
-  async incrementTasksCompleted(projectId: string, name: string): Promise<AgentsSchema> {
-    return this.updateItem(
-      projectId,
-      (agent) => agent.name === name,
-      (agent) => ({
-        ...agent,
-        tasksCompleted: (agent.tasksCompleted || 0) + 1
-      })
-    )
-  }
-
-  async updateSuccessRate(
-    projectId: string,
-    name: string,
-    successRate: number
-  ): Promise<AgentsSchema> {
-    return this.updateAgent(projectId, name, { successRate })
-  }
-}
-
-export const agentsManager = new AgentsManager()
-export default agentsManager