pmpt-cli 1.14.17 → 1.14.21

package/dist/commands/clone.js

@@ -1,7 +1,7 @@
 import * as p from '@clack/prompts';
 import { join, dirname, resolve, sep } from 'path';
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
-import { isInitialized, getConfigDir, getHistoryDir, getDocsDir, initializeProject } from '../lib/config.js';
+import { isInitialized, getConfigDir, getHistoryDir, getDocsDir, initializeProject, ensurePmptClaudeMd, ensureMcpJson } from '../lib/config.js';
 import { validatePmptFile, isSafeFilename } from '../lib/pmptFile.js';
 import { fetchPmptFile, trackClone } from '../lib/api.js';
 import { copyToClipboard } from '../lib/clipboard.js';
@@ -112,6 +112,9 @@ export async function cmdClone(slug) {
     const docsDir = getDocsDir(projectPath);
     // History is not restored — user's journey starts fresh from v1.
     // The version summary is embedded in pmpt.ai.md for AI reference.
+    // Add pmpt MCP instructions to CLAUDE.md and register .mcp.json for Claude Code
+    ensurePmptClaudeMd(projectPath);
+    ensureMcpJson(projectPath);
     if (pmptData.docs) {
         restoreDocs(docsDir, pmptData.docs);
     }
@@ -161,7 +164,13 @@ export async function cmdClone(slug) {
         `- When requirements change or new decisions are made`,
         '',
         `Keep the Progress and Snapshot Log sections in pmpt.md up to date.`,
-        `After significant milestones, run \`pmpt save\` to create a snapshot.`,
+        `**Always save proactively after milestones — do not wait for the user to ask.**`,
+        ``,
+        `Try the pmpt MCP tool first:`,
+        `- Claude Code: call \`mcp__pmpt__pmpt_save\` with a descriptive \`summary\``,
+        `- Other MCP clients: call \`pmpt_save\` with a descriptive \`summary\``,
+        ``,
+        `If no MCP tool is available, run \`pmpt save\` in terminal.`,
         '',
         '---',
         '',

package/dist/commands/init.js

@@ -1,7 +1,7 @@
 import * as p from '@clack/prompts';
 import { existsSync, readFileSync, writeFileSync } from 'fs';
 import { resolve, basename, join } from 'path';
-import { initializeProject, isInitialized, getDocsDir } from '../lib/config.js';
+import { initializeProject, isInitialized, getDocsDir, ensurePmptClaudeMd, ensureMcpJson } from '../lib/config.js';
 import { isGitRepo, getGitInfo, formatGitInfo, getCommitCount } from '../lib/git.js';
 import { cmdPlan } from './plan.js';
 import { scanProject, scanResultToAnswers } from '../lib/scanner.js';
@@ -97,6 +97,9 @@ export async function cmdInit(path, options) {
             gitCommitsAtInit: isGit ? gitCommits : undefined,
         });
         s.stop('Initialized');
+        // Add pmpt MCP instructions to CLAUDE.md and register .mcp.json for Claude Code
+        ensurePmptClaudeMd(projectPath);
+        ensureMcpJson(projectPath);
         // Build folder structure display
         const notes = [
             `Path: ${config.projectPath}`,

package/dist/commands/remix.js

@@ -114,7 +114,13 @@ When you make progress, update \`.pmpt/docs/pmpt.md\`:
 - When a feature is implemented (mark as done)
 - When a development phase is completed
 
-Keep the Snapshot Log up to date. Run \`pmpt save\` after milestones.
+Keep the Snapshot Log up to date. **Always save proactively after milestones — do not wait for the user to ask.**
+
+Try the pmpt MCP tool first:
+- Claude Code: call \`mcp__pmpt__pmpt_save\` with a descriptive \`summary\`
+- Other MCP clients: call \`pmpt_save\` with a descriptive \`summary\`
+
+If no MCP tool is available, run \`pmpt save\` in terminal.
 
 ---
 

package/dist/lib/config.js

@@ -1,5 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
-import { join } from 'path';
+import { join, dirname } from 'path';
+import { execSync } from 'child_process';
 const CONFIG_DIR = '.pmpt';
 const CONFIG_FILE = 'config.json';
 const DEFAULT_DOCS_DIR = 'docs';
@@ -61,6 +62,87 @@ export function saveConfig(projectPath, config) {
     const configPath = join(getConfigDir(projectPath), CONFIG_FILE);
     writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
 }
+const PMPT_CLAUDE_SECTION = `
+<!-- pmpt -->
+## pmpt MCP Tools
+
+This project uses [pmpt](https://pmptwiki.com) to track development progress.
+
+**If pmpt MCP is available in this session**, use these tools proactively — do not wait for the user to ask:
+- \`mcp__pmpt__pmpt_save\` — save a snapshot after milestones (always include a \`summary\`)
+- \`mcp__pmpt__pmpt_status\` — check project status
+- \`mcp__pmpt__pmpt_read_context\` — read project context at session start
+
+Save after: feature completion, architecture decisions, bug fixes, or any significant progress.
+
+If pmpt MCP is not available, run \`pmpt save\` in terminal instead.
+<!-- /pmpt -->
+`;
+/**
+ * Add pmpt MCP instructions to CLAUDE.md in the project root.
+ * Creates the file if it doesn't exist; appends the section if not already present.
+ */
+export function ensurePmptClaudeMd(projectPath) {
+    const claudeMdPath = join(projectPath, 'CLAUDE.md');
+    const marker = '<!-- pmpt -->';
+    if (existsSync(claudeMdPath)) {
+        const content = readFileSync(claudeMdPath, 'utf-8');
+        if (content.includes(marker))
+            return; // already has pmpt section
+        writeFileSync(claudeMdPath, content.trimEnd() + '\n' + PMPT_CLAUDE_SECTION, 'utf-8');
+    }
+    else {
+        writeFileSync(claudeMdPath, '# Project Instructions\n' + PMPT_CLAUDE_SECTION, 'utf-8');
+    }
+}
+function detectPmptMcpPath() {
+    // Strategy 1: sibling to the current pmpt binary
+    try {
+        const pmptBin = process.argv[1];
+        const siblingPath = join(dirname(pmptBin), 'pmpt-mcp');
+        if (existsSync(siblingPath))
+            return siblingPath;
+    }
+    catch { /* skip */ }
+    // Strategy 2: which / where command
+    try {
+        const cmd = process.platform === 'win32' ? 'where pmpt-mcp' : 'which pmpt-mcp';
+        const result = execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        const firstLine = result.split('\n')[0].trim();
+        if (firstLine && existsSync(firstLine))
+            return firstLine;
+    }
+    catch { /* not in PATH */ }
+    return null;
+}
+/**
+ * Create or update .mcp.json in the project root to register the pmpt MCP server.
+ * Skips silently if pmpt-mcp binary cannot be found.
+ */
+export function ensureMcpJson(projectPath) {
+    const mcpJsonPath = join(projectPath, '.mcp.json');
+    const mcpPath = detectPmptMcpPath();
+    if (!mcpPath)
+        return; // can't detect binary — skip silently
+    let config = {};
+    if (existsSync(mcpJsonPath)) {
+        try {
+            config = JSON.parse(readFileSync(mcpJsonPath, 'utf-8'));
+        }
+        catch {
+            config = {};
+        }
+        // Already registered — don't overwrite
+        const servers = config.mcpServers;
+        if (servers?.pmpt)
+            return;
+    }
+    if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+        config.mcpServers = {};
+    }
+    config.mcpServers.pmpt = { command: mcpPath };
+    writeFileSync(mcpJsonPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
 const PMPT_README = `# .pmpt — Your Project's Development Journal
 
 This folder is managed by [pmpt](https://pmptwiki.com). It records your product development journey with AI.

package/dist/lib/plan.js

@@ -98,13 +98,23 @@ ${workflowSteps}
 - When requirements change or new decisions are made
 
 Keep the Progress and Snapshot Log sections in pmpt.md up to date.
-After significant milestones, run \`pmpt save\` to create a snapshot.
+After significant milestones, save a snapshot using the method below.
+
+### Saving Snapshots
+
+**Always save proactively after milestones — do not wait for the user to ask.**
+
+Try the pmpt MCP tool first:
+- Claude Code: call \`mcp__pmpt__pmpt_save\` with a descriptive \`summary\`
+- Other MCP clients: call \`pmpt_save\` with a descriptive \`summary\`
+
+If no MCP tool is available, run \`pmpt save\` in the terminal.
 
 ### Per-Feature Checklist
 After completing each feature above:
 1. Mark the feature done in \`.pmpt/docs/pmpt.md\` (change \`- [ ]\` to \`- [x]\`)
 2. Add a brief note to the Snapshot Log section
-3. Run \`pmpt save\` in terminal
+3. Call \`mcp__pmpt__pmpt_save\` (or \`pmpt save\` in terminal) with a summary
 
 ### What to Record in pmpt.md
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmpt-cli",
-  "version": "1.14.17",
+  "version": "1.14.21",
   "description": "Record and share your AI-driven product development journey",
   "type": "module",
   "bin": {