pmpt-cli 1.12.1 → 1.12.3

package/dist/commands/clone.js

@@ -190,22 +190,24 @@ export async function cmdClone(slug) {
     // Copy AI prompt to clipboard
     const aiContent = readFileSync(aiMdPath, 'utf-8');
     const copied = copyToClipboard(aiContent);
+    p.log.info('Tips:');
+    p.log.message('  pmpt history    — view version history');
+    p.log.message('  pmpt plan       — view or edit AI prompt');
+    p.log.message('  pmpt save       — save a new snapshot');
+    p.log.message('');
     if (copied) {
-        p.log.message('');
-        p.log.success('AI prompt copied to clipboard!');
-        p.log.message('');
         const banner = [
-            '',
             '┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓',
             '┃                                                        ┃',
             '┃   📋  NEXT STEP                                        ┃',
             '┃                                                        ┃',
-            '┃   Open your AI coding tool and press:           ┃',
+            '┃   AI prompt is already copied to clipboard!             ┃',
+            '┃   Open your AI coding tool and paste it:               ┃',
             '┃                                                        ┃',
             '┃              ⌘ + V  (Mac)                              ┃',
             '┃             Ctrl + V (Windows/Linux)                   ┃',
             '┃                                                        ┃',
-            '┃   Your cloned project context is ready! 🚀             ┃',
+            '┃   Your project context is ready! 🚀                    ┃',
             '┃                                                        ┃',
             '┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛',
             '',
@@ -216,9 +218,5 @@ export async function cmdClone(slug) {
         p.log.warn('Could not copy to clipboard.');
         p.log.info(`Read it at: ${aiMdPath}`);
     }
-    p.log.info('Tips:');
-    p.log.message('  pmpt history    — view version history');
-    p.log.message('  pmpt plan       — view or edit AI prompt');
-    p.log.message('  pmpt save       — save a new snapshot');
     p.outro('Project cloned!');
 }

package/dist/commands/diff.js

@@ -126,16 +126,17 @@ export function cmdDiff(v1, v2, pathOrOptions, maybeOptions) {
         p.log.error('No snapshots found.');
         process.exit(1);
     }
+    const versionList = snapshots.map(s => `v${s.version}`).join(', ');
     const fromIndex = snapshots.findIndex(s => s.version === fromVersion);
     if (fromIndex === -1) {
-        p.log.error(`Version v${fromVersion} not found.`);
+        p.log.error(`Version v${fromVersion} not found. Available: ${versionList}`);
         process.exit(1);
     }
     let toIndex;
     if (!diffAgainstWorking) {
         toIndex = snapshots.findIndex(s => s.version === toVersion);
         if (toIndex === -1) {
-            p.log.error(`Version v${toVersion} not found.`);
+            p.log.error(`Version v${toVersion} not found. Available: ${versionList}`);
             process.exit(1);
         }
     }

package/dist/commands/init.js

@@ -176,7 +176,7 @@ export async function cmdInit(path, options) {
                 const s2 = p.spinner();
                 s2.start('Scanning project and generating plan...');
                 const answers = scanResultToAnswers(scanResult, userDesc);
-                const { planPath, promptPath } = savePlanDocuments(projectPath, answers);
+                const { planPath, promptPath } = savePlanDocuments(projectPath, answers, origin);
                 const progress = initPlanProgress(projectPath);
                 progress.completed = true;
                 progress.answers = answers;
@@ -197,17 +197,19 @@ export async function cmdInit(path, options) {
                 // Copy to clipboard
                 const content = readFileSync(promptPath, 'utf-8');
                 const copied = copyToClipboard(content);
+                p.log.info('Tips:');
+                p.log.message('  pmpt plan     — View or edit your AI prompt');
+                p.log.message('  pmpt save     — Save a snapshot anytime');
+                p.log.message('  pmpt watch    — Auto-save on file changes');
+                p.log.message('');
                 if (copied) {
-                    p.log.message('');
-                    p.log.success('AI prompt copied to clipboard!');
-                    p.log.message('');
                     const banner = [
-                        '',
                         '┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓',
                         '┃                                                        ┃',
                         '┃   📋  NEXT STEP                                        ┃',
                         '┃                                                        ┃',
-                        '┃   Open your AI coding tool and press:           ┃',
+                        '┃   AI prompt is already copied to clipboard!             ┃',
+                        '┃   Open your AI coding tool and paste it:               ┃',
                         '┃                                                        ┃',
                         '┃              ⌘ + V  (Mac)                              ┃',
                         '┃             Ctrl + V (Windows/Linux)                   ┃',
@@ -223,10 +225,6 @@ export async function cmdInit(path, options) {
                     p.log.warn('Could not copy to clipboard.');
                     p.log.info(`Read it at: ${promptPath}`);
                 }
-                p.log.info('Tips:');
-                p.log.message('  pmpt plan     — View or edit your AI prompt');
-                p.log.message('  pmpt save     — Save a snapshot anytime');
-                p.log.message('  pmpt watch    — Auto-save on file changes');
                 p.outro('Ready to go!');
             }
             else if (scanChoice === 'manual') {

package/dist/commands/plan.js

@@ -1,7 +1,7 @@
 import * as p from '@clack/prompts';
 import { resolve } from 'path';
 import { existsSync, readFileSync } from 'fs';
-import { isInitialized } from '../lib/config.js';
+import { isInitialized, loadConfig } from '../lib/config.js';
 import { copyToClipboard } from '../lib/clipboard.js';
 import { cmdWatch } from './watch.js';
 import { PLAN_QUESTIONS, getPlanProgress, initPlanProgress, savePlanProgress, savePlanDocuments, } from '../lib/plan.js';
@@ -88,16 +88,14 @@ export async function cmdPlan(path, options) {
                     if (action === 'copy') {
                         const copied = copyToClipboard(content);
                         if (copied) {
-                            p.log.success('AI prompt copied to clipboard!');
                             p.log.message('');
-                            // Eye-catching next step banner
                             const banner = [
-                                '',
                                 '┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓',
                                 '┃                                                        ┃',
                                 '┃   📋  NEXT STEP                                        ┃',
                                 '┃                                                        ┃',
-                                '┃   Open your AI coding tool and press:           ┃',
+                                '┃   AI prompt is already copied to clipboard!             ┃',
+                                '┃   Open your AI coding tool and paste it:               ┃',
                                 '┃                                                        ┃',
                                 '┃              ⌘ + V  (Mac)                              ┃',
                                 '┃             Ctrl + V (Windows/Linux)                   ┃',
@@ -159,9 +157,10 @@ export async function cmdPlan(path, options) {
             p.outro('');
             process.exit(1);
         }
+        const config = loadConfig(projectPath);
         const s = p.spinner();
         s.start('Generating documents from answers file...');
-        const { planPath, promptPath } = savePlanDocuments(projectPath, answers);
+        const { planPath, promptPath } = savePlanDocuments(projectPath, answers, config?.origin);
         progress.completed = true;
         progress.answers = answers;
         savePlanProgress(projectPath, progress);
@@ -197,9 +196,10 @@ export async function cmdPlan(path, options) {
         answers[question.key] = answer;
     }
     // Generate documents
+    const config = loadConfig(projectPath);
     const s = p.spinner();
     s.start('Generating your AI prompt...');
-    const { planPath, promptPath } = savePlanDocuments(projectPath, answers);
+    const { planPath, promptPath } = savePlanDocuments(projectPath, answers, config?.origin);
     // Update progress
     progress.completed = true;
     progress.answers = answers;
@@ -233,16 +233,13 @@ export async function cmdPlan(path, options) {
     const copied = copyToClipboard(content);
     if (copied) {
         p.log.message('');
-        p.log.success('AI prompt copied to clipboard!');
-        p.log.message('');
-        // Eye-catching next step banner
         const banner = [
-            '',
             '┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓',
             '┃                                                        ┃',
             '┃   📋  NEXT STEP                                        ┃',
             '┃                                                        ┃',
-            '┃   Open your AI coding tool and press:           ┃',
+            '┃   AI prompt is already copied to clipboard!             ┃',
+            '┃   Open your AI coding tool and paste it:               ┃',
             '┃                                                        ┃',
             '┃              ⌘ + V  (Mac)                              ┃',
             '┃             Ctrl + V (Windows/Linux)                   ┃',

package/dist/commands/publish.js

@@ -411,6 +411,7 @@ export async function cmdPublish(path, options) {
         if (config) {
             config.lastPublished = new Date().toISOString();
             config.lastPublishedSlug = slug;
+            config.lastPublishedVersionCount = snapshots.length;
             saveConfig(projectPath, config);
         }
         p.note([

package/dist/commands/squash.js

@@ -25,10 +25,12 @@ export async function cmdSquash(from, to, path) {
         p.log.error('No snapshots found.');
         process.exit(1);
     }
+    const versionList = snapshots.map(s => `v${s.version}`).join(', ');
     // Find snapshots to squash
     const toSquash = snapshots.filter(s => s.version >= fromVersion && s.version <= toVersion);
     if (toSquash.length < 2) {
         p.log.error(`Need at least 2 versions to squash. Found ${toSquash.length} in range v${fromVersion}-v${toVersion}.`);
+        p.log.info(`Available versions: ${versionList}`);
         process.exit(1);
     }
     p.intro('pmpt squash');

package/dist/commands/update.js

@@ -67,6 +67,13 @@ export async function cmdUpdate(path) {
         p.outro('');
         return;
     }
+    // Check if already up to date
+    if (config?.lastPublishedVersionCount === snapshots.length) {
+        p.log.success('Already up to date — no new snapshots since last publish.');
+        p.log.info('Run `pmpt save` to create a new snapshot, then try again.');
+        p.outro('');
+        return;
+    }
     // Quality gate
     const docsDir = getDocsDir(projectPath);
     const aiMdPath = join(docsDir, 'pmpt.ai.md');
@@ -136,6 +143,7 @@ export async function cmdUpdate(path) {
         s.stop('Updated!');
         if (config) {
             config.lastPublished = new Date().toISOString();
+            config.lastPublishedVersionCount = snapshots.length;
             saveConfig(projectPath, config);
         }
         p.note([

package/dist/index.js

@@ -42,10 +42,15 @@ import { cmdExplore } from './commands/browse.js';
 import { cmdRecover } from './commands/recover.js';
 import { cmdDiff } from './commands/diff.js';
 import { cmdInternalSeed } from './commands/internal-seed.js';
+import { trackCommand } from './lib/api.js';
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
 const program = new Command();
+// Track every command invocation (fire-and-forget)
+program.hook('preAction', (thisCommand) => {
+    trackCommand(thisCommand.name());
+});
 program
     .name('pmpt')
     .description('pmpt — Record and share your AI-driven product development journey')
@@ -56,19 +61,24 @@ Examples:
   $ pmpt plan                    Start product planning (5 questions → AI prompt)
   $ pmpt save                    Save snapshot of docs folder
   $ pmpt watch                   Auto-detect file changes
-  $ pmpt history                 View version history
+  $ pmpt history (hist)          View version history
   $ pmpt diff v1 v2              Compare two versions
   $ pmpt diff v3                 Compare v3 to working copy
   $ pmpt squash v2 v5            Merge versions v2-v5 into v2
   $ pmpt export                  Export as .pmpt file (single JSON)
   $ pmpt import <file.pmpt>      Import from .pmpt file
   $ pmpt login                   Authenticate with pmptwiki
-  $ pmpt publish                 Publish project to pmptwiki
+  $ pmpt publish (pub)           Publish project to pmptwiki
   $ pmpt update                  Quick re-publish (content only)
   $ pmpt clone <slug>            Clone a project from pmptwiki
-  $ pmpt explore                  Explore projects on pmptwiki.com
+  $ pmpt explore (exp)           Explore projects on pmptwiki.com
   $ pmpt recover                 Recover damaged pmpt.md via AI
 
+Workflow:
+  init → plan → save → publish   Basic publishing flow
+  init → plan → watch            Continuous development
+  login → publish → update       Re-publish with updates
+
 Documentation: https://pmptwiki.com
 `);
 // Project tracking commands
@@ -87,10 +97,12 @@ program
     .action(cmdSave);
 program
     .command('status [path]')
+    .alias('st')
     .description('Check project status and tracked files')
     .action(cmdStatus);
 program
     .command('history [path]')
+    .alias('hist')
     .description('View saved version history')
     .option('-c, --compact', 'Show compact history (hide small changes)')
     .action(cmdHistory);
@@ -123,9 +135,12 @@ program
     .command('logout')
     .description('Clear saved GitHub authentication')
     .action(async () => {
+    const prompts = await import('@clack/prompts');
     const { clearAuth } = await import('./lib/auth.js');
+    prompts.intro('pmpt logout');
     clearAuth();
-    console.log('Logged out successfully');
+    prompts.log.success('Logged out successfully.');
+    prompts.outro('');
 });
 // Platform commands
 program
@@ -134,6 +149,7 @@ program
     .action(cmdLogin);
 program
     .command('publish [path]')
+    .alias('pub')
     .description('Publish project to pmptwiki platform')
     .option('--non-interactive', 'Run without interactive prompts')
     .option('--meta-file <file>', 'JSON file with slug, description, tags, category')
@@ -163,6 +179,7 @@ program
     .action(cmdClone);
 program
     .command('explore')
+    .alias('exp')
     .description('Open pmptwiki.com to explore and search projects')
     .action(cmdExplore);
 program
@@ -174,4 +191,58 @@ program
     .command('internal-seed', { hidden: true })
     .requiredOption('--spec <file>', 'Seed spec JSON file')
     .action(cmdInternalSeed);
+// "Did you mean?" helper
+function levenshtein(a, b) {
+    const m = a.length, n = b.length;
+    const dp = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            dp[i][j] = a[i - 1] === b[j - 1]
+                ? dp[i - 1][j - 1]
+                : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+        }
+    }
+    return dp[m][n];
+}
+function suggestCommand(unknown) {
+    const available = program.commands
+        .filter(cmd => !cmd._hidden)
+        .flatMap(cmd => [cmd.name(), ...(cmd.aliases?.() ?? [])]);
+    let bestMatch = '';
+    let bestDist = Infinity;
+    for (const name of available) {
+        const dist = levenshtein(unknown, name);
+        if (dist < bestDist) {
+            bestDist = dist;
+            bestMatch = name;
+        }
+    }
+    console.error(`\n  Unknown command: ${unknown}\n`);
+    if (bestDist <= 3 && bestMatch) {
+        console.error(`  Did you mean \x1b[36mpmpt ${bestMatch}\x1b[0m?\n`);
+    }
+    console.error(`  Run \x1b[36mpmpt --help\x1b[0m to see all commands.\n`);
+    process.exit(1);
+}
+// Handle unknown subcommands and Quick Start
+program.on('command:*', (operands) => {
+    suggestCommand(operands[0]);
+});
+// Show Quick Start when no arguments provided
+const args = process.argv.slice(2);
+if (args.length === 0) {
+    console.log(`
+  pmpt v${version} — Record and share your AI-driven product development journey
+
+  Quick Start:
+    $ pmpt init          1. Initialize project
+    $ pmpt plan          2. Generate AI prompt (copied to clipboard)
+    $ pmpt save          3. Save snapshot after progress
+    $ pmpt publish       4. Share on pmptwiki.com
+
+  Run \x1b[36mpmpt --help\x1b[0m for all commands.
+  Documentation: https://pmptwiki.com
+`);
+    process.exit(0);
+}
 program.parse();

package/dist/lib/api.js

@@ -92,3 +92,14 @@ export function trackClone(slug) {
         body: JSON.stringify({ slug }),
     }).catch(() => { });
 }
+/**
+ * Fire-and-forget CLI command usage tracking.
+ * Never throws — failures are silently ignored.
+ */
+export function trackCommand(command) {
+    fetch(`${API_BASE}/metrics/command`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ command }),
+    }).catch(() => { });
+}

package/dist/lib/plan.js

@@ -42,7 +42,7 @@ export const PLAN_QUESTIONS = [
     },
 ];
 // Generate AI instruction file (pmpt.ai.md) — always English, AI-facing
-export function generateAIPrompt(answers) {
+export function generateAIPrompt(answers, origin) {
     // Parse features (support comma, semicolon, or newline separators)
     const features = answers.coreFeatures
         .split(/[,;\n]/)
@@ -56,10 +56,28 @@ export function generateAIPrompt(answers) {
     const techSection = answers.techStack
         ? `\n## Tech Stack Preferences\n${answers.techStack}\n`
         : '';
+    const isAdopted = origin === 'adopted';
+    const workflowSteps = isAdopted
+        ? `This is an **existing project** — you are joining mid-development.
+
+1. First, explore the existing codebase and understand the current architecture.
+2. Review what's already implemented vs what still needs to be done.
+3. Suggest improvements or next steps based on the current state.
+4. Continue development from where it left off.
+
+Do NOT start from scratch. Build on the existing code.`
+        : `Please help me build this product based on the requirements above.
+
+1. First, review the requirements and ask if anything is unclear.
+2. Propose a technical architecture.
+3. Outline the implementation steps.
+4. Start coding from the first step.
+
+I'll confirm progress at each step before moving to the next.`;
     return `<!-- This file is for AI tools only. Do not edit manually. -->
 <!-- Paste this into Claude Code, Codex, Cursor, or any AI coding tool. -->
 
-# ${answers.projectName} — Product Development Request
+# ${answers.projectName} — ${isAdopted ? 'Continue Development' : 'Product Development Request'}
 
 ## What I Want to Build
 ${answers.productIdea}
@@ -69,14 +87,7 @@ ${features}
 ${techSection}
 ---
 
-Please help me build this product based on the requirements above.
-
-1. First, review the requirements and ask if anything is unclear.
-2. Propose a technical architecture.
-3. Outline the implementation steps.
-4. Start coding from the first step.
-
-I'll confirm progress at each step before moving to the next.
+${workflowSteps}
 
 ## Documentation Rule
 
@@ -186,7 +197,7 @@ export function initPlanProgress(projectPath) {
     savePlanProgress(projectPath, progress);
     return progress;
 }
-export function savePlanDocuments(projectPath, answers) {
+export function savePlanDocuments(projectPath, answers, origin) {
     const pmptDir = getPmptDir(projectPath);
     mkdirSync(pmptDir, { recursive: true });
     // Save plan to pmpt folder
@@ -199,7 +210,7 @@ export function savePlanDocuments(projectPath, answers) {
     writeFileSync(pmptMdPath, pmptMdContent, 'utf-8');
     // Save AI instruction file
     const promptPath = join(pmptDir, 'pmpt.ai.md');
-    const promptContent = generateAIPrompt(answers);
+    const promptContent = generateAIPrompt(answers, origin);
     writeFileSync(promptPath, promptContent, 'utf-8');
     // Create initial snapshot
     createFullSnapshot(projectPath);

package/package.json

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