prjct-cli 0.55.2 → 0.55.4

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## [0.55.4] - 2026-02-05
+
+### Bug Fixes
+
+- remove legacy p.*.md commands on sync
+
+
+## [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/command-installer.ts

@@ -569,6 +569,36 @@ export class CommandInstaller {
     }
   }
 
+  /**
+   * Remove legacy p.*.md files from commands root directory
+   * These were replaced by the p/ subdirectory structure in v0.50+
+   */
+  async removeLegacyCommands(): Promise<number> {
+    const aiProvider = require('./ai-provider')
+    const activeProvider = aiProvider.getActiveProvider()
+    const commandsRoot = path.join(activeProvider.configDir, 'commands')
+
+    let removed = 0
+
+    try {
+      const files = await fs.readdir(commandsRoot)
+      const legacyFiles = files.filter((f) => f.startsWith('p.') && f.endsWith('.md'))
+
+      for (const file of legacyFiles) {
+        try {
+          await fs.unlink(path.join(commandsRoot, file))
+          removed++
+        } catch {
+          // Ignore errors removing individual files
+        }
+      }
+    } catch {
+      // Ignore errors if directory doesn't exist
+    }
+
+    return removed
+  }
+
   /**
    * Sync commands - intelligent update that detects and removes orphans
    */
@@ -639,9 +669,9 @@ export class CommandInstaller {
         }
       }
 
-      // Note: We do NOT remove orphaned files
-      // Legacy commands from older versions are preserved
-      // to avoid breaking existing workflows
+      // Remove legacy p.*.md files from commands root (old naming convention)
+      // These were replaced by p/ subdirectory structure
+      await this.removeLegacyCommands()
 
       return results
     } catch (error) {

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

@@ -5952,6 +5952,29 @@ var init_command_installer = __esm({
           throw error;
         }
       }
+      /**
+       * Remove legacy p.*.md files from commands root directory
+       * These were replaced by the p/ subdirectory structure in v0.50+
+       */
+      async removeLegacyCommands() {
+        const aiProvider = (init_ai_provider(), __toCommonJS(ai_provider_exports));
+        const activeProvider = aiProvider.getActiveProvider();
+        const commandsRoot = path16.join(activeProvider.configDir, "commands");
+        let removed = 0;
+        try {
+          const files = await fs16.readdir(commandsRoot);
+          const legacyFiles = files.filter((f) => f.startsWith("p.") && f.endsWith(".md"));
+          for (const file of legacyFiles) {
+            try {
+              await fs16.unlink(path16.join(commandsRoot, file));
+              removed++;
+            } catch {
+            }
+          }
+        } catch {
+        }
+        return removed;
+      }
       /**
        * Sync commands - intelligent update that detects and removes orphans
        */
@@ -6004,6 +6027,7 @@ var init_command_installer = __esm({
               results.errors.push({ file, error: error.message });
             }
           }
+          await this.removeLegacyCommands();
           return results;
         } catch (error) {
           return {
@@ -19105,6 +19129,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 +19228,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 +21258,7 @@ async function run() {
         }
         await command_installer_default.installDocs();
         await installStatusLine();
+        await installContext7MCP();
       }
     } else if (providerName === "gemini") {
       const geminiInstalled = await installGeminiRouter();
@@ -21681,6 +21709,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 +21836,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 +25221,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.55.2",
+      version: "0.55.4",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/dist/core/infrastructure/command-installer.js

@@ -873,6 +873,29 @@ var CommandInstaller = class {
       throw error;
     }
   }
+  /**
+   * Remove legacy p.*.md files from commands root directory
+   * These were replaced by the p/ subdirectory structure in v0.50+
+   */
+  async removeLegacyCommands() {
+    const aiProvider = (init_ai_provider(), __toCommonJS(ai_provider_exports));
+    const activeProvider = aiProvider.getActiveProvider();
+    const commandsRoot = import_node_path3.default.join(activeProvider.configDir, "commands");
+    let removed = 0;
+    try {
+      const files = await import_promises.default.readdir(commandsRoot);
+      const legacyFiles = files.filter((f) => f.startsWith("p.") && f.endsWith(".md"));
+      for (const file of legacyFiles) {
+        try {
+          await import_promises.default.unlink(import_node_path3.default.join(commandsRoot, file));
+          removed++;
+        } catch {
+        }
+      }
+    } catch {
+    }
+    return removed;
+  }
   /**
    * Sync commands - intelligent update that detects and removes orphans
    */
@@ -925,6 +948,7 @@ var CommandInstaller = class {
           results.errors.push({ file, error: error.message });
         }
       }
+      await this.removeLegacyCommands();
       return results;
     } catch (error) {
       return {

package/dist/core/infrastructure/setup.js

@@ -876,6 +876,29 @@ var CommandInstaller = class {
       throw error;
     }
   }
+  /**
+   * Remove legacy p.*.md files from commands root directory
+   * These were replaced by the p/ subdirectory structure in v0.50+
+   */
+  async removeLegacyCommands() {
+    const aiProvider = (init_ai_provider(), __toCommonJS(ai_provider_exports));
+    const activeProvider = aiProvider.getActiveProvider();
+    const commandsRoot = import_node_path3.default.join(activeProvider.configDir, "commands");
+    let removed = 0;
+    try {
+      const files = await import_promises.default.readdir(commandsRoot);
+      const legacyFiles = files.filter((f) => f.startsWith("p.") && f.endsWith(".md"));
+      for (const file of legacyFiles) {
+        try {
+          await import_promises.default.unlink(import_node_path3.default.join(commandsRoot, file));
+          removed++;
+        } catch {
+        }
+      }
+    } catch {
+    }
+    return removed;
+  }
   /**
    * Sync commands - intelligent update that detects and removes orphans
    */
@@ -928,6 +951,7 @@ var CommandInstaller = class {
           results.errors.push({ file, error: error.message });
         }
       }
+      await this.removeLegacyCommands();
       return results;
     } catch (error) {
       return {
@@ -1168,6 +1192,7 @@ async function run() {
         }
         await command_installer_default.installDocs();
         await installStatusLine();
+        await installContext7MCP();
       }
     } else if (providerName === "gemini") {
       const geminiInstalled = await installGeminiRouter();
@@ -1635,6 +1660,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.4",
   "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`
 ```