prjct-cli 0.55.2 → 0.55.3

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [0.55.3] - 2026-02-05
+
+### Bug Fixes
+
+- ensure test isolation in IndexStorage tests
+- remove MCP integrations, keep only Context7 (#87)
+
+
+## [0.56.0] - 2026-02-04
+
+### Breaking Changes
+
+- **Removed MCP-based integrations** (Monday.com, GitHub Issues)
+  - Only Context7 remains as the sole MCP server (for library docs)
+  - Linear and JIRA use SDK/REST API directly (4x faster)
+
+### Features
+
+- **Context7 auto-install**: Now automatically configured in `~/.claude/mcp.json` on `prjct init`
+
+### Fixed
+
+- Templates no longer reference non-existent CLI commands (`prjct context task`, etc.)
+- All workflow templates (task, done, bug, pause, resume, next, dash) now use Read/Write directly
+
+### Removed
+
+- `templates/commands/monday.md` - MCP integration
+- `templates/commands/github.md` - MCP integration
+- `templates/_bases/tracker-base.md` - MCP base template
+- `core/integrations/jira/mcp-adapter.ts` - Unused MCP adapter
+
 ## [0.55.2] - 2026-02-04
 
 ### Bug Fixes

package/core/__tests__/services/project-index.test.ts

@@ -184,9 +184,11 @@ describe('FileScorer', () => {
 })
 
 describe('IndexStorage', () => {
-  const testProjectId = `test-project-${Date.now()}`
+  let testProjectId: string
 
   beforeEach(async () => {
+    // Generate unique project ID for each test to ensure isolation
+    testProjectId = `test-project-${Date.now()}-${Math.random().toString(36).slice(2)}`
     // Set up test directory
     const testDir = path.join(os.tmpdir(), `prjct-test-${Date.now()}`)
     pathManager.setGlobalBaseDir(testDir)

package/core/infrastructure/setup.ts

@@ -169,6 +169,9 @@ export async function run(): Promise<SetupResults> {
 
         // Install status line (Claude only)
         await installStatusLine()
+
+        // Install Context7 MCP (only MCP server prjct uses)
+        await installContext7MCP()
       }
     } else if (providerName === 'gemini') {
       // Gemini provider - install router and global config
@@ -875,6 +878,58 @@ echo "prjct"
   }
 }
 
+/**
+ * Install Context7 MCP server configuration
+ *
+ * Context7 is the ONLY MCP server prjct uses - for library documentation lookup.
+ * All issue tracker integrations (Linear, JIRA) use SDK/REST API directly.
+ */
+async function installContext7MCP(): Promise<void> {
+  try {
+    const claudeDir = path.join(os.homedir(), '.claude')
+    const mcpConfigPath = path.join(claudeDir, 'mcp.json')
+
+    // Ensure ~/.claude directory exists
+    if (!fs.existsSync(claudeDir)) {
+      fs.mkdirSync(claudeDir, { recursive: true })
+    }
+
+    // Context7 MCP configuration
+    const context7Config = {
+      mcpServers: {
+        context7: {
+          command: 'npx',
+          args: ['-y', '@upstash/context7-mcp@latest'],
+        },
+      },
+    }
+
+    // Check if mcp.json exists
+    if (fs.existsSync(mcpConfigPath)) {
+      // Read existing config
+      const existingContent = fs.readFileSync(mcpConfigPath, 'utf-8')
+      const existingConfig = JSON.parse(existingContent)
+
+      // Check if context7 is already configured
+      if (existingConfig.mcpServers?.context7) {
+        // Already configured, skip
+        return
+      }
+
+      // Add context7 to existing config
+      existingConfig.mcpServers = existingConfig.mcpServers || {}
+      existingConfig.mcpServers.context7 = context7Config.mcpServers.context7
+      fs.writeFileSync(mcpConfigPath, JSON.stringify(existingConfig, null, 2), 'utf-8')
+    } else {
+      // Create new mcp.json with context7
+      fs.writeFileSync(mcpConfigPath, JSON.stringify(context7Config, null, 2), 'utf-8')
+    }
+  } catch (error) {
+    // Non-fatal error, just log
+    console.error(`Context7 MCP setup warning: ${(error as Error).message}`)
+  }
+}
+
 /**
  * Install statusline modules (lib/ or components/)
  * Copies .sh files from source to destination, always overwriting for updates

package/core/integrations/jira/index.ts

@@ -19,20 +19,5 @@ export {
 } from './cache'
 // REST API client
 export { type JiraAuthMode, JiraProvider, jiraProvider } from './client'
-// MCP adapter (deprecated - will be removed)
-export {
-  createCreateIssueInstruction,
-  createGetIssueInstruction,
-  // MCP instruction generators
-  createSearchInstruction,
-  createTransitionInstruction,
-  createUpdateInstruction,
-  getMCPSetupInstructions,
-  // Utilities
-  isMCPAvailable,
-  JiraMCPAdapter,
-  jiraMCPAdapter,
-  type MCPInstruction,
-} from './mcp-adapter'
 // Service layer with caching (preferred API)
 export { JiraService, jiraService } from './service'

package/core/services/sync-service.ts

@@ -26,6 +26,7 @@ import {
   type ProjectContext,
   resolveToolIds,
 } from '../ai-tools'
+import commandInstaller from '../infrastructure/command-installer'
 import configManager from '../infrastructure/config-manager'
 import pathManager from '../infrastructure/path-manager'
 import { metricsStorage } from '../storage/metrics-storage'
@@ -232,6 +233,11 @@ class SyncService {
       const duration = Date.now() - startTime
       const syncMetrics = await this.recordSyncMetrics(stats, contextFiles, agents, duration)
 
+      // 10. Update global config and commands (CLI does EVERYTHING)
+      // This ensures `prjct sync` from terminal updates global CLAUDE.md and commands
+      await commandInstaller.installGlobalConfig()
+      await commandInstaller.syncCommands()
+
       return {
         success: true,
         projectId: this.projectId,

package/dist/bin/prjct.mjs

@@ -19105,6 +19105,7 @@ var init_sync_service = __esm({
   "core/services/sync-service.ts"() {
     "use strict";
     init_ai_tools();
+    init_command_installer();
     init_config_manager();
     init_path_manager();
     init_metrics_storage();
@@ -19203,6 +19204,8 @@ var init_sync_service = __esm({
           ]);
           const duration = Date.now() - startTime;
           const syncMetrics = await this.recordSyncMetrics(stats, contextFiles, agents, duration);
+          await command_installer_default.installGlobalConfig();
+          await command_installer_default.syncCommands();
           return {
             success: true,
             projectId: this.projectId,
@@ -21231,6 +21234,7 @@ async function run() {
         }
         await command_installer_default.installDocs();
         await installStatusLine();
+        await installContext7MCP();
       }
     } else if (providerName === "gemini") {
       const geminiInstalled = await installGeminiRouter();
@@ -21681,6 +21685,37 @@ echo "prjct"
     }
   }
 }
+async function installContext7MCP() {
+  try {
+    const claudeDir = path44.join(os13.homedir(), ".claude");
+    const mcpConfigPath = path44.join(claudeDir, "mcp.json");
+    if (!fs41.existsSync(claudeDir)) {
+      fs41.mkdirSync(claudeDir, { recursive: true });
+    }
+    const context7Config = {
+      mcpServers: {
+        context7: {
+          command: "npx",
+          args: ["-y", "@upstash/context7-mcp@latest"]
+        }
+      }
+    };
+    if (fs41.existsSync(mcpConfigPath)) {
+      const existingContent = fs41.readFileSync(mcpConfigPath, "utf-8");
+      const existingConfig = JSON.parse(existingContent);
+      if (existingConfig.mcpServers?.context7) {
+        return;
+      }
+      existingConfig.mcpServers = existingConfig.mcpServers || {};
+      existingConfig.mcpServers.context7 = context7Config.mcpServers.context7;
+      fs41.writeFileSync(mcpConfigPath, JSON.stringify(existingConfig, null, 2), "utf-8");
+    } else {
+      fs41.writeFileSync(mcpConfigPath, JSON.stringify(context7Config, null, 2), "utf-8");
+    }
+  } catch (error) {
+    console.error(`Context7 MCP setup warning: ${error.message}`);
+  }
+}
 function installStatusLineModules(sourceDir, destDir) {
   if (!fs41.existsSync(sourceDir)) {
     return;
@@ -21777,6 +21812,7 @@ var init_setup = __esm({
     __name(migrateProjectsCliVersion, "migrateProjectsCliVersion");
     __name(ensureStatusLineSettings, "ensureStatusLineSettings");
     __name(installStatusLine, "installStatusLine");
+    __name(installContext7MCP, "installContext7MCP");
     __name(installStatusLineModules, "installStatusLineModules");
     __name(ensureStatusLineSymlink, "ensureStatusLineSymlink");
     __name(showResults, "showResults");
@@ -25161,7 +25197,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.55.2",
+      version: "0.55.3",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/dist/core/infrastructure/setup.js

@@ -1168,6 +1168,7 @@ async function run() {
         }
         await command_installer_default.installDocs();
         await installStatusLine();
+        await installContext7MCP();
       }
     } else if (providerName === "gemini") {
       const geminiInstalled = await installGeminiRouter();
@@ -1635,6 +1636,38 @@ echo "prjct"
   }
 }
 __name(installStatusLine, "installStatusLine");
+async function installContext7MCP() {
+  try {
+    const claudeDir = import_node_path5.default.join(import_node_os4.default.homedir(), ".claude");
+    const mcpConfigPath = import_node_path5.default.join(claudeDir, "mcp.json");
+    if (!import_node_fs3.default.existsSync(claudeDir)) {
+      import_node_fs3.default.mkdirSync(claudeDir, { recursive: true });
+    }
+    const context7Config = {
+      mcpServers: {
+        context7: {
+          command: "npx",
+          args: ["-y", "@upstash/context7-mcp@latest"]
+        }
+      }
+    };
+    if (import_node_fs3.default.existsSync(mcpConfigPath)) {
+      const existingContent = import_node_fs3.default.readFileSync(mcpConfigPath, "utf-8");
+      const existingConfig = JSON.parse(existingContent);
+      if (existingConfig.mcpServers?.context7) {
+        return;
+      }
+      existingConfig.mcpServers = existingConfig.mcpServers || {};
+      existingConfig.mcpServers.context7 = context7Config.mcpServers.context7;
+      import_node_fs3.default.writeFileSync(mcpConfigPath, JSON.stringify(existingConfig, null, 2), "utf-8");
+    } else {
+      import_node_fs3.default.writeFileSync(mcpConfigPath, JSON.stringify(context7Config, null, 2), "utf-8");
+    }
+  } catch (error) {
+    console.error(`Context7 MCP setup warning: ${error.message}`);
+  }
+}
+__name(installContext7MCP, "installContext7MCP");
 function installStatusLineModules(sourceDir, destDir) {
   if (!import_node_fs3.default.existsSync(sourceDir)) {
     return;

package/package.json

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

package/templates/commands/bug.md

@@ -4,35 +4,160 @@ allowed-tools: [Read, Write, Bash, Task, AskUserQuestion]
 
 # p. bug "$ARGUMENTS"
 
+## Step 1: Validate Arguments
+
+```
+IF $ARGUMENTS is empty:
+  ASK: "What bug do you want to report?"
+  WAIT for response
+  DO NOT proceed with empty description
+```
+
+## Step 2: 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 3: Parse Severity from Keywords
+
+Analyze `$ARGUMENTS` for severity indicators:
+- `crash`, `down`, `broken`, `production`, `critical` → **critical**
+- `error`, `fail`, `exception`, `cannot` → **high**
+- `bug`, `incorrect`, `wrong`, `issue` → **medium** (default)
+- `minor`, `typo`, `cosmetic`, `ui` → **low**
+
+## Step 4: Explore Codebase
+
+```
+USE Task(Explore) → find affected files, recent commits related to the bug
+```
+
+## Step 5: Check for Active Task
+
+READ `{globalPath}/storage/state.json`
+
+```
+IF currentTask exists AND currentTask.status == "active":
+  AskUserQuestion:
+    question: "You have an active task. How should we handle this bug?"
+    header: "Bug"
+    options:
+      - label: "Pause current and fix bug (Recommended)"
+        description: "Save current task, start bug fix"
+      - label: "Queue bug for later"
+        description: "Add to queue, continue current task"
+
+  IF "Queue bug for later":
+    # Add to queue and stop
+    READ {globalPath}/storage/queue.json (or create empty array)
+    APPEND bug to queue:
+    {
+      "id": "{uuid}",
+      "type": "bug",
+      "description": "$ARGUMENTS",
+      "severity": "{severity}",
+      "createdAt": "{timestamp}",
+      "status": "queued"
+    }
+    WRITE {globalPath}/storage/queue.json
+
+    OUTPUT:
+    """
+    🐛 Queued: $ARGUMENTS [{severity}]
+
+    Continue with: {currentTask.description}
+
+    Later: `p. task` to work on queued bug
+    """
+    STOP
+
+  IF "Pause current and fix bug":
+    # Move current task to pausedTasks
+    # Will be handled in Step 6
+```
+
+## Step 6: Create Bug Branch
+
+```bash
+git branch --show-current
+```
+
+```
+IF current branch == "main" OR "master":
+  # Create bug fix branch
+  slug = sanitize($ARGUMENTS) # lowercase, hyphens, max 50 chars
+
+  git checkout -b bug/{slug}
+
+  IF git command fails:
+    OUTPUT: "Failed to create branch. Check git status."
+    STOP
+```
+
+## Step 7: Write State
+
+Generate UUID and timestamp:
 ```bash
-prjct context bug $ARGUMENTS
+node -e "console.log(require('crypto').randomUUID())"
+node -e "console.log(new Date().toISOString())"
 ```
 
-Parse severity from keywords:
-- crash/down/broken/production → critical
-- error/fail → high
-- bug/incorrect → medium (default)
-- minor/typo → low
+READ current state, then update:
 
-USE Task(Explore) → find affected files, recent commits
+```
+# If there was an active task, move it to pausedTasks
+IF state.currentTask exists:
+  interruptedTask = state.currentTask
+  interruptedTask.status = "interrupted"
+  interruptedTask.interruptedAt = "{timestamp}"
+  interruptedTask.interruptedBy = "{new bug task id}"
 
-IF `currentTask` active:
-  Ask: "Pause current and fix?" or "Queue for later"
-  IF pause → save as `interruptedTask`
+  state.pausedTasks = state.pausedTasks || []
+  state.pausedTasks.push(interruptedTask)
+```
 
-IF on main → `git checkout -b bug/{slug}`
+WRITE `{globalPath}/storage/state.json`:
+```json
+{
+  "currentTask": {
+    "id": "{uuid}",
+    "description": "$ARGUMENTS",
+    "type": "bug",
+    "severity": "{severity}",
+    "status": "active",
+    "startedAt": "{timestamp}",
+    "branch": "bug/{slug}",
+    "affectedFiles": ["{files from exploration}"]
+  },
+  "pausedTasks": [{interruptedTask if any}]
+}
+```
 
-UPDATE `{globalPath}/storage/state.json` with new bug task
-ADD to `{globalPath}/storage/queue.json`
+## Step 8: Log Event
+
+APPEND to `{globalPath}/memory/events.jsonl`:
+```json
+{"type":"bug_reported","taskId":"{uuid}","description":"$ARGUMENTS","severity":"{severity}","timestamp":"{timestamp}","branch":"bug/{slug}"}
+```
+
+---
+
+## Output
 
-**Output**:
 ```
 🐛 [{severity}] $ARGUMENTS
 
-Affected: {files}
-Branch: {branch}
+Affected: {files from exploration}
+Branch: bug/{slug}
+
+{IF interruptedTask: "Paused: {interruptedTask.description}"}
 
 Next:
-- Fix the bug → `p. done`
-- Queue only → add `--later` flag
+- Fix the bug → work on code
+- When fixed → `p. done`
+- Resume previous → `p. resume`
 ```

package/templates/commands/dash.md

@@ -1,32 +1,61 @@
 ---
-allowed-tools: [Read]
+allowed-tools: [Read, Bash]
 ---
 
 # p. dash
 
+## Step 1: Resolve Project Paths
+
 ```bash
-prjct context dash
+# 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 All Storage Files
+
 READ all storage files:
-- `{globalPath}/storage/state.json` → current/paused task
-- `{globalPath}/storage/queue.json` → queue
-- `{globalPath}/storage/shipped.json` → ships
-- `{globalPath}/storage/ideas.json` → ideas
+- `{globalPath}/storage/state.json` → current/paused tasks
+- `{globalPath}/storage/queue.json` → queue (or empty array)
+- `{globalPath}/storage/shipped.json` → shipped features (or empty array)
+- `{globalPath}/storage/ideas.json` → ideas (or empty array)
+
+## Step 3: Calculate Metrics
+
+```
+currentTask = state.currentTask
+pausedTasks = state.pausedTasks || []
+queueCount = queue.length
+shippedCount = shipped.length
+ideasCount = ideas.length
+
+IF currentTask:
+  elapsed = time since currentTask.startedAt (or resumedAt)
+
+IF shipped.length > 0:
+  lastShip = shipped[0]
+  daysSinceLastShip = days since lastShip.shippedAt
+```
+
+---
+
+## Output (default)
 
-**Output (default)**:
 ```
 📊 DASHBOARD
 
-🎯 Current: {task} ({elapsed})
-⏸️ Paused: {paused_task or "None"}
+🎯 Current: {currentTask.parentDescription or currentTask.description} ({elapsed})
+   Subtask: {current subtask if exists}
+⏸️ Paused: {pausedTasks[0].description or "None"}
 
-📋 Queue ({count})
-• {task_1}
-• {task_2}
+📋 Queue ({queueCount})
+• {queue[0].description}
+• {queue[1].description}
+{... up to 5 items}
 
-🚀 Recent: {last_ship} ({days}d ago)
-💡 Ideas: {count}
+🚀 Recent: {lastShip.description} ({daysSinceLastShip}d ago)
+💡 Ideas: {ideasCount}
 
 Next:
 - Finish → `p. done`
@@ -34,10 +63,37 @@ Next:
 - Queue → `p. next`
 ```
 
-**Compact** (`p. dash compact`):
+---
+
+## Compact View (`p. dash compact`)
+
+```
+🎯 {currentTask.description} | 📋 {queueCount} | 🚀 {daysSinceLastShip}d ago
 ```
-🎯 {task} | 📋 {queue} | 🚀 {days}d ago
+
+---
+
+## Week View (`p. dash week`)
+
+Calculate from events.jsonl:
+- Tasks completed this week
+- Time spent (sum of task durations)
+- Velocity (tasks/day)
+
 ```
+📊 This Week
+
+Completed: {count} tasks
+Time: {hours}h focused
+Velocity: {tasks_per_day}/day
+
+Top areas:
+- {area_1}: {count} tasks
+- {area_2}: {count} tasks
+```
+
+---
+
+## Month View (`p. dash month`)
 
-**Week/Month** (`p. dash week`):
-Show completed tasks, velocity, focus time
+Same as week, but for last 30 days. Show weekly trends.