pmpt-cli 1.14.2 → 1.14.4

package/dist/commands/export.js

@@ -58,6 +58,8 @@ export async function cmdExport(path, options) {
             version: snapshots[i].version,
             timestamp: snapshots[i].timestamp,
             files,
+            changedFiles: snapshots[i].changedFiles,
+            note: snapshots[i].note,
             git: snapshots[i].git,
         });
     }

package/dist/commands/publish.js

@@ -345,6 +345,8 @@ export async function cmdPublish(path, options) {
         version: snapshot.version,
         timestamp: snapshot.timestamp,
         files: resolveFullSnapshot(snapshots, i),
+        changedFiles: snapshot.changedFiles,
+        note: snapshot.note,
         git: snapshot.git,
     }));
     const docs = readDocsFolder(docsDir);

package/dist/commands/update.js

@@ -99,6 +99,8 @@ export async function cmdUpdate(path) {
         version: snapshot.version,
         timestamp: snapshot.timestamp,
         files: resolveFullSnapshot(snapshots, i),
+        changedFiles: snapshot.changedFiles,
+        note: snapshot.note,
         git: snapshot.git,
     }));
     const docs = readDocsFolder(docsDir);

package/dist/index.js

@@ -45,6 +45,7 @@ import { cmdDiff } from './commands/diff.js';
 import { cmdInternalSeed } from './commands/internal-seed.js';
 import { cmdMcpSetup } from './commands/mcp-setup.js';
 import { trackCommand } from './lib/api.js';
+import { checkForUpdates } from './lib/update-check.js';
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
@@ -54,6 +55,10 @@ program.hook('preAction', (thisCommand, actionCommand) => {
     const commandName = actionCommand?.name() || thisCommand.name();
     trackCommand(commandName);
 });
+// Check for updates after command finishes
+program.hook('postAction', () => {
+    checkForUpdates(version);
+});
 program
     .name('pmpt')
     .description('pmpt — Record and share your AI-driven product development journey')

package/dist/lib/pmptFile.js

@@ -47,6 +47,8 @@ const VersionSchema = z.object({
     version: z.number().min(1),
     timestamp: z.string(),
     summary: z.string().optional(),
+    note: z.string().optional(),
+    changedFiles: z.array(z.string()).optional(),
     files: z.record(safeFilenameKey, z.string()), // filename -> content
     git: GitInfoSchema,
 });

package/dist/lib/update-check.js

@@ -0,0 +1,84 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import https from 'https';
+const CACHE_DIR = join(homedir(), '.pmpt');
+const CACHE_FILE = join(CACHE_DIR, 'update-check.json');
+const CHECK_INTERVAL = 1000 * 60 * 60 * 24; // 24 hours
+function readCache() {
+    try {
+        if (!existsSync(CACHE_FILE))
+            return null;
+        return JSON.parse(readFileSync(CACHE_FILE, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(data) {
+    try {
+        if (!existsSync(CACHE_DIR))
+            mkdirSync(CACHE_DIR, { recursive: true });
+        writeFileSync(CACHE_FILE, JSON.stringify(data));
+    }
+    catch { }
+}
+function fetchLatestVersion() {
+    return new Promise((resolve) => {
+        const req = https.get('https://registry.npmjs.org/pmpt-cli/latest', { headers: { Accept: 'application/json' }, timeout: 3000 }, (res) => {
+            let body = '';
+            res.on('data', (d) => (body += d));
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(body).version || null);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => { req.destroy(); resolve(null); });
+    });
+}
+function compareVersions(current, latest) {
+    const c = current.split('.').map(Number);
+    const l = latest.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((l[i] || 0) > (c[i] || 0))
+            return true;
+        if ((l[i] || 0) < (c[i] || 0))
+            return false;
+    }
+    return false;
+}
+/**
+ * Check for updates and print a notification if a newer version is available.
+ * Non-blocking, silent on failure.
+ */
+export async function checkForUpdates(currentVersion) {
+    try {
+        const cache = readCache();
+        let latest = null;
+        if (cache && Date.now() - cache.checkedAt < CHECK_INTERVAL) {
+            latest = cache.latest;
+        }
+        else {
+            latest = await fetchLatestVersion();
+            if (latest)
+                writeCache({ latest, checkedAt: Date.now() });
+        }
+        if (latest && compareVersions(currentVersion, latest)) {
+            const msg = [
+                '',
+                `  \x1b[33m┌──────────────────────────────────────────┐\x1b[0m`,
+                `  \x1b[33m│\x1b[0m  Update available: \x1b[90m${currentVersion}\x1b[0m → \x1b[32m${latest}\x1b[0m${' '.repeat(Math.max(0, 14 - currentVersion.length - latest.length))}\x1b[33m│\x1b[0m`,
+                `  \x1b[33m│\x1b[0m  Run \x1b[36mnpm install -g pmpt-cli\x1b[0m to update  \x1b[33m│\x1b[0m`,
+                `  \x1b[33m└──────────────────────────────────────────┘\x1b[0m`,
+                '',
+            ].join('\n');
+            console.error(msg);
+        }
+    }
+    catch { }
+}

package/dist/mcp.js

@@ -98,7 +98,7 @@ function formatDiffs(diffs) {
     return lines.join('\n');
 }
 // ── Tools ───────────────────────────────────────────
-server.tool('pmpt_save', 'Save a snapshot of .pmpt/docs/ files. Call after completing features, fixes, or milestones. IMPORTANT: Always provide a summary describing what was accomplished — this gets recorded in the project development log.', {
+server.tool('pmpt_save', 'Save a snapshot of .pmpt/docs/ files. Call after completing features, fixes, or milestones. CRITICAL: Always provide a summary parameter — it becomes the version description shown on pmptwiki.com. Without a summary, the version appears empty on the project page. Write a concise description of what was accomplished (e.g. "Added user authentication with JWT").', {
     projectPath: z.string().optional().describe('Project root path. Defaults to cwd.'),
     summary: z.string().optional().describe('What was accomplished since the last save. This is recorded in pmpt.md as a development log entry. Examples: "Implemented user auth with JWT", "Fixed responsive layout on mobile", "Added search filtering by category".'),
 }, async ({ projectPath, summary }) => {
@@ -582,7 +582,7 @@ server.tool('pmpt_log_decision', 'Record an architectural or technical decision
         return { content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }], isError: true };
     }
 });
-server.tool('pmpt_publish', 'Publish the project to pmptwiki.com. This tool handles everything non-interactively — just provide the slug and optional metadata. Note: the user must have run `pmpt login` once before (check if auth exists). If not logged in, ask the user to run `pmpt login` in their terminal, then retry this tool.', {
+server.tool('pmpt_publish', 'Publish the project to pmptwiki.com. Non-interactive — just provide slug and optional metadata. BEFORE publishing, verify: (1) Run pmpt_history to check all snapshots have meaningful summaries — empty versions look bad on the project page. (2) If any versions lack descriptions, run pmpt_save with a summary or update pmpt.md Snapshot Log section with ### vN — Title entries. (3) Run pmpt_quality to check publish readiness. Note: user must have run `pmpt login` once before.', {
     projectPath: z.string().optional().describe('Project root path. Defaults to cwd.'),
     slug: z.string().describe('Project slug (3-50 chars, lowercase alphanumeric and hyphens).'),
     description: z.string().optional().describe('Project description (max 500 chars).'),

package/package.json

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