pmpt-cli 1.12.0 → 1.12.2

package/README.md

@@ -2,17 +2,15 @@
 
 # pmpt
 
-**Answer 5 questions. Start building with AI.**
+**Record and share your AI-driven product development journey.**
 
 [![npm version](https://img.shields.io/npm/v/pmpt-cli.svg?style=flat-square&color=cb3837)](https://www.npmjs.com/package/pmpt-cli)
 [![license](https://img.shields.io/github/license/pmptwiki/pmpt-cli?style=flat-square&v=2)](https://github.com/pmptwiki/pmpt-cli/blob/main/LICENSE)
 [![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square)](https://github.com/pmptwiki/pmpt-cli)
 
-The CLI that turns your idea into an AI-ready prompt in 30 seconds.
+Plan with 5 questions. Build with AI. Save every version. Share and reproduce.
 
-No coding required. No complex setup. Just answer 5 questions.
-
-[Quick Start](#quick-start) · [Commands](#commands) · [How It Works](#how-it-works) · [Explore Projects](#explore-projects)
+[Quick Start](#quick-start) · [Commands](#commands) · [MCP Server](#mcp-server) · [Explore Projects](#explore-projects)
 
 </div>
 
@@ -57,7 +55,7 @@ pmpt save
 pmpt login && pmpt publish
 
 # Bonus: Explore what others are building
-pmpt browse
+pmpt explore
 ```
 
 ---
@@ -113,17 +111,51 @@ The generated prompt is **automatically copied to your clipboard**. Just paste i
 | Command | Description |
 |---------|-------------|
 | `pmpt login` | Authenticate via GitHub (one-time) |
-| `pmpt publish` | Publish your project (requires pmpt.md, quality ≥ 40) |
-| `pmpt publish --force` | Publish even if quality score is below minimum |
+| `pmpt publish` | Publish your project (requires quality score ≥ 40) |
+| `pmpt update` | Quick re-publish: update content without changing metadata |
 | `pmpt edit` | Edit published project metadata (description, tags, category) |
 | `pmpt unpublish` | Remove a published project from pmptwiki |
 | `pmpt clone <slug>` | Clone and reproduce someone's project |
-| `pmpt browse` | Browse and search published projects |
+| `pmpt explore` | Open pmptwiki.com/explore in your browser |
+
+> Quality score below 40? pmpt copies an **AI improvement prompt** to your clipboard — paste it into your AI tool to get help improving your project.
 
 > See the full documentation at [pmptwiki.com/docs](https://pmptwiki.com/docs)
 
 ---
 
+## MCP Server
+
+pmpt includes a built-in [MCP](https://modelcontextprotocol.io) server so AI tools can interact with pmpt directly. This means Claude Code, Cursor, and other MCP-compatible tools can save snapshots, check status, and review history without you typing commands.
+
+### Setup
+
+Add to your `.mcp.json` (or IDE MCP config):
+
+```json
+{
+  "mcpServers": {
+    "pmpt": {
+      "command": "pmpt-mcp"
+    }
+  }
+}
+```
+
+### Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `pmpt_save` | Save a snapshot after completing features, fixes, or milestones |
+| `pmpt_status` | Check tracked files, snapshot count, and quality score |
+| `pmpt_history` | View version history with git commit info |
+| `pmpt_diff` | Compare two versions, or a version against working copy |
+| `pmpt_quality` | Check quality score and publish readiness |
+
+All tools accept an optional `projectPath` parameter (defaults to cwd).
+
+---
+
 ## How It Works
 
 ```
@@ -158,7 +190,8 @@ your-project/
     ├── config.json        # Project configuration
     ├── docs/              # Generated documents
     │   ├── plan.md        # Product plan (features checklist)
-    │   └── pmpt.md        # AI-ready prompt
+    │   ├── pmpt.md        # Progress tracking & decisions
+    │   └── pmpt.ai.md     # AI-ready prompt (project context & instructions)
     └── .history/          # Auto-saved version history
         ├── v1-2024-02-20/
         ├── v2-2024-02-21/
@@ -186,7 +219,8 @@ A single portable file containing your entire development journey:
   },
   "docs": {
     "plan.md": "...",
-    "pmpt.md": "..."
+    "pmpt.md": "...",
+    "pmpt.ai.md": "..."
   },
   "history": [
     { "version": 1, "timestamp": "...", "files": {} },
@@ -210,11 +244,11 @@ Share it. Clone it. Reproduce it.
 
 ## Explore Projects
 
-Don't know what to build? Browse what others have created with AI.
+Don't know what to build? See what others have created with AI.
 
 ```bash
-# Discover projects from the community
-pmpt browse
+# Open the explore page
+pmpt explore
 
 # Found something interesting? Clone it and make it yours
 pmpt clone budget-tracker-app
@@ -222,7 +256,7 @@ pmpt clone budget-tracker-app
 
 **[Explore Projects on pmptwiki.com →](https://pmptwiki.com/explore)**
 
-See how others planned their products, what prompts they used, and how their projects evolved step by step. Clone any project and use it as a starting point for your own.
+Clone any project to see how it was planned, what prompts were used, and how it evolved step by step. The clone output shows the product idea, tech stack, and full version history.
 
 ---
 

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/init.js

@@ -2,7 +2,7 @@ import * as p from '@clack/prompts';
 import { existsSync, readFileSync } from 'fs';
 import { resolve } from 'path';
 import { initializeProject, isInitialized } from '../lib/config.js';
-import { isGitRepo, getGitInfo, formatGitInfo } from '../lib/git.js';
+import { isGitRepo, getGitInfo, formatGitInfo, getCommitCount } from '../lib/git.js';
 import { cmdPlan } from './plan.js';
 import { scanProject, scanResultToAnswers } from '../lib/scanner.js';
 import { savePlanDocuments, initPlanProgress, savePlanProgress } from '../lib/plan.js';
@@ -84,12 +84,17 @@ export async function cmdInit(path, options) {
             }
         }
     }
+    // Detect project origin
+    const gitCommits = isGit ? getCommitCount(projectPath) : 0;
+    const origin = gitCommits >= 10 ? 'adopted' : 'new';
     const s = p.spinner();
     s.start('Initializing project...');
     try {
         const config = initializeProject(projectPath, {
             repo: repoUrl,
             trackGit: isGit,
+            origin,
+            gitCommitsAtInit: isGit ? gitCommits : undefined,
         });
         s.stop('Initialized');
         // Build folder structure display
@@ -171,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;
@@ -192,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)                   ┃',
@@ -218,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

@@ -224,89 +224,120 @@ export async function cmdPublish(path, options) {
         }
     }
     else {
-        const slugInput = await p.text({
-            message: 'Project slug (used in URL):',
-            placeholder: defaultSlug,
-            defaultValue: savedSlug || '',
-            validate: (v) => {
-                if (!/^[a-z0-9][a-z0-9-]{1,48}[a-z0-9]$/.test(v)) {
-                    return '3-50 chars, lowercase letters, numbers, and hyphens only.';
-                }
-            },
-        });
-        if (p.isCancel(slugInput)) {
-            p.cancel('Cancelled');
-            process.exit(0);
-        }
-        slug = slugInput;
-        const descriptionInput = await p.text({
-            message: 'Project description (brief):',
-            placeholder: existing?.description || planProgress?.answers?.productIdea?.slice(0, 100) || '',
-            defaultValue: existing?.description || planProgress?.answers?.productIdea?.slice(0, 200) || '',
-        });
-        if (p.isCancel(descriptionInput)) {
-            p.cancel('Cancelled');
-            process.exit(0);
-        }
-        description = descriptionInput;
-        const tagsInput = await p.text({
-            message: 'Tags (comma-separated):',
-            placeholder: 'react, saas, mvp',
-            defaultValue: existing?.tags?.join(', ') || '',
-        });
-        if (p.isCancel(tagsInput)) {
-            p.cancel('Cancelled');
-            process.exit(0);
+        // If previously published, offer to reuse settings
+        let reuseExisting = false;
+        if (existing && savedSlug) {
+            const categoryLabel = CATEGORY_OPTIONS.find((o) => o.value === existing.category)?.label ?? existing.category ?? '';
+            p.note([
+                `Slug: ${savedSlug}`,
+                `Description: ${existing.description || '(none)'}`,
+                existing.tags?.length ? `Tags: ${existing.tags.join(', ')}` : '',
+                categoryLabel ? `Category: ${categoryLabel}` : '',
+                existing.productUrl ? `Product: ${existing.productUrl}` : '',
+            ].filter(Boolean).join('\n'), 'Previous Settings');
+            const reuse = await p.confirm({
+                message: 'Publish with same settings?',
+                initialValue: true,
+            });
+            if (p.isCancel(reuse)) {
+                p.cancel('Cancelled');
+                process.exit(0);
+            }
+            reuseExisting = !!reuse;
         }
-        tags = normalizeTags(tagsInput);
-        const categoryInput = await p.select({
-            message: 'Project category:',
-            initialValue: existing?.category || 'other',
-            options: CATEGORY_OPTIONS,
-        });
-        if (p.isCancel(categoryInput)) {
-            p.cancel('Cancelled');
-            process.exit(0);
+        if (reuseExisting && existing && savedSlug) {
+            slug = savedSlug;
+            description = existing.description || '';
+            tags = existing.tags || [];
+            category = existing.category || 'other';
+            productUrl = existing.productUrl || '';
+            productUrlType = existing.productUrlType || '';
         }
-        category = categoryInput;
-        // Product link (optional)
-        const linkTypeInput = await p.select({
-            message: 'Product link (optional):',
-            initialValue: existing?.productUrlType || 'none',
-            options: [
-                { value: 'none', label: 'No link' },
-                { value: 'git', label: 'Git Repository' },
-                { value: 'url', label: 'Website / URL' },
-            ],
-        });
-        if (p.isCancel(linkTypeInput)) {
-            p.cancel('Cancelled');
-            process.exit(0);
-        }
-        if (linkTypeInput !== 'none') {
-            productUrlType = linkTypeInput;
-            const productUrlInput = await p.text({
-                message: 'Product URL:',
-                placeholder: linkTypeInput === 'git'
-                    ? `https://github.com/${auth.username}/${slug}`
-                    : 'https://...',
-                defaultValue: existing?.productUrl || '',
+        else {
+            const slugInput = await p.text({
+                message: 'Project slug (used in URL):',
+                placeholder: defaultSlug,
+                defaultValue: savedSlug || '',
                 validate: (v) => {
-                    if (!v.trim())
-                        return 'URL is required when link type is selected.';
-                    try {
-                        new URL(v);
-                    }
-                    catch {
-                        return 'Invalid URL format.';
+                    if (!/^[a-z0-9][a-z0-9-]{1,48}[a-z0-9]$/.test(v)) {
+                        return '3-50 chars, lowercase letters, numbers, and hyphens only.';
                     }
                 },
             });
-            if (p.isCancel(productUrlInput)) {
+            if (p.isCancel(slugInput)) {
+                p.cancel('Cancelled');
+                process.exit(0);
+            }
+            slug = slugInput;
+            const descriptionInput = await p.text({
+                message: 'Project description (brief):',
+                placeholder: existing?.description || planProgress?.answers?.productIdea?.slice(0, 100) || '',
+                defaultValue: existing?.description || planProgress?.answers?.productIdea?.slice(0, 200) || '',
+            });
+            if (p.isCancel(descriptionInput)) {
+                p.cancel('Cancelled');
+                process.exit(0);
+            }
+            description = descriptionInput;
+            const tagsInput = await p.text({
+                message: 'Tags (comma-separated):',
+                placeholder: 'react, saas, mvp',
+                defaultValue: existing?.tags?.join(', ') || '',
+            });
+            if (p.isCancel(tagsInput)) {
                 p.cancel('Cancelled');
                 process.exit(0);
             }
-            productUrl = productUrlInput;
+            tags = normalizeTags(tagsInput);
+            const categoryInput = await p.select({
+                message: 'Project category:',
+                initialValue: existing?.category || 'other',
+                options: CATEGORY_OPTIONS,
+            });
+            if (p.isCancel(categoryInput)) {
+                p.cancel('Cancelled');
+                process.exit(0);
+            }
+            category = categoryInput;
+            // Product link (optional)
+            const linkTypeInput = await p.select({
+                message: 'Product link (optional):',
+                initialValue: existing?.productUrlType || 'none',
+                options: [
+                    { value: 'none', label: 'No link' },
+                    { value: 'git', label: 'Git Repository' },
+                    { value: 'url', label: 'Website / URL' },
+                ],
+            });
+            if (p.isCancel(linkTypeInput)) {
+                p.cancel('Cancelled');
+                process.exit(0);
+            }
+            if (linkTypeInput !== 'none') {
+                productUrlType = linkTypeInput;
+                const productUrlInput = await p.text({
+                    message: 'Product URL:',
+                    placeholder: linkTypeInput === 'git'
+                        ? `https://github.com/${auth.username}/${slug}`
+                        : 'https://...',
+                    defaultValue: existing?.productUrl || '',
+                    validate: (v) => {
+                        if (!v.trim())
+                            return 'URL is required when link type is selected.';
+                        try {
+                            new URL(v);
+                        }
+                        catch {
+                            return 'Invalid URL format.';
+                        }
+                    },
+                });
+                if (p.isCancel(productUrlInput)) {
+                    p.cancel('Cancelled');
+                    process.exit(0);
+                }
+                productUrl = productUrlInput;
+            }
         }
     }
     // Build .pmpt content (resolve from optimized snapshots)
@@ -323,6 +354,8 @@ export async function cmdPublish(path, options) {
         description: description,
         createdAt: config?.createdAt || new Date().toISOString(),
         exportedAt: new Date().toISOString(),
+        origin: config?.origin,
+        gitCommitsAtInit: config?.gitCommitsAtInit,
     };
     const planAnswers = planProgress?.answers
         ? {
@@ -378,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/update.js

@@ -0,0 +1,162 @@
+import * as p from '@clack/prompts';
+import { resolve, basename } from 'path';
+import { readFileSync, existsSync } from 'fs';
+import { isInitialized, loadConfig, saveConfig, getDocsDir } from '../lib/config.js';
+import { getAllSnapshots, resolveFullSnapshot } from '../lib/history.js';
+import { getPlanProgress } from '../lib/plan.js';
+import { createPmptFile } from '../lib/pmptFile.js';
+import { loadAuth } from '../lib/auth.js';
+import { publishProject, fetchProjects } from '../lib/api.js';
+import { computeQuality } from '../lib/quality.js';
+import glob from 'fast-glob';
+import { join } from 'path';
+function readDocsFolder(docsDir) {
+    const files = {};
+    if (!existsSync(docsDir))
+        return files;
+    const mdFiles = glob.sync('**/*.md', { cwd: docsDir });
+    for (const file of mdFiles) {
+        try {
+            files[file] = readFileSync(join(docsDir, file), 'utf-8');
+        }
+        catch { /* skip */ }
+    }
+    return files;
+}
+export async function cmdUpdate(path) {
+    const projectPath = path ? resolve(path) : process.cwd();
+    if (!isInitialized(projectPath)) {
+        p.log.error('Project not initialized. Run `pmpt init` first.');
+        process.exit(1);
+    }
+    const auth = loadAuth();
+    if (!auth?.token || !auth?.username) {
+        p.log.error('Login required. Run `pmpt login` first.');
+        process.exit(1);
+    }
+    p.intro('pmpt update');
+    const config = loadConfig(projectPath);
+    const savedSlug = config?.lastPublishedSlug;
+    if (!savedSlug) {
+        p.log.error('No previously published project found.');
+        p.log.info('Run `pmpt publish` first to publish your project.');
+        p.outro('');
+        process.exit(1);
+    }
+    // Find existing project on platform
+    let existing;
+    try {
+        const index = await fetchProjects();
+        existing = index.projects.find((proj) => proj.slug === savedSlug && proj.author === auth.username);
+    }
+    catch {
+        p.log.error('Failed to fetch project info. Check your internet connection.');
+        p.outro('');
+        process.exit(1);
+    }
+    if (!existing) {
+        p.log.error(`Project "${savedSlug}" not found on platform.`);
+        p.log.info('Run `pmpt publish` to publish it first.');
+        p.outro('');
+        process.exit(1);
+    }
+    const snapshots = getAllSnapshots(projectPath);
+    const planProgress = getPlanProgress(projectPath);
+    if (snapshots.length === 0) {
+        p.log.warn('No snapshots found. Run `pmpt save` first.');
+        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');
+    const aiMdContent = existsSync(aiMdPath) ? readFileSync(aiMdPath, 'utf-8').trim() : '';
+    const trackedFiles = glob.sync('**/*.md', { cwd: docsDir });
+    const hasGit = snapshots.some((s) => !!s.git);
+    const quality = computeQuality({
+        pmptAiMd: aiMdContent || null,
+        planAnswers: planProgress?.answers ?? null,
+        versionCount: snapshots.length,
+        docFiles: trackedFiles,
+        hasGit,
+    });
+    if (!quality.passesMinimum) {
+        p.log.warn(`Quality score ${quality.score}/100 is below minimum (40).`);
+        p.log.info('Run `pmpt publish` for detailed quality breakdown and improvement tips.');
+        p.outro('');
+        process.exit(1);
+    }
+    // Build .pmpt content
+    const projectName = planProgress?.answers?.projectName || basename(projectPath);
+    const history = snapshots.map((snapshot, i) => ({
+        version: snapshot.version,
+        timestamp: snapshot.timestamp,
+        files: resolveFullSnapshot(snapshots, i),
+        git: snapshot.git,
+    }));
+    const docs = readDocsFolder(docsDir);
+    const meta = {
+        projectName,
+        author: auth.username,
+        description: existing.description,
+        createdAt: config?.createdAt || new Date().toISOString(),
+        exportedAt: new Date().toISOString(),
+        origin: config?.origin,
+        gitCommitsAtInit: config?.gitCommitsAtInit,
+    };
+    const planAnswers = planProgress?.answers
+        ? {
+            projectName: planProgress.answers.projectName,
+            productIdea: planProgress.answers.productIdea,
+            additionalContext: planProgress.answers.additionalContext,
+            coreFeatures: planProgress.answers.coreFeatures,
+            techStack: planProgress.answers.techStack,
+        }
+        : undefined;
+    const pmptContent = createPmptFile(meta, planAnswers, docs, history);
+    // Show summary
+    p.note([
+        `Slug: ${savedSlug}`,
+        `Versions: ${snapshots.length}`,
+        `Size: ${(pmptContent.length / 1024).toFixed(1)} KB`,
+        `Quality: ${quality.score}/100 (${quality.grade})`,
+    ].join('\n'), 'Update Preview');
+    // Upload
+    const s = p.spinner();
+    s.start('Uploading...');
+    try {
+        const result = await publishProject(auth.token, {
+            slug: savedSlug,
+            pmptContent,
+            description: existing.description,
+            tags: existing.tags || [],
+            category: existing.category,
+            ...(existing.productUrl && { productUrl: existing.productUrl, productUrlType: existing.productUrlType }),
+        });
+        s.stop('Updated!');
+        if (config) {
+            config.lastPublished = new Date().toISOString();
+            config.lastPublishedVersionCount = snapshots.length;
+            saveConfig(projectPath, config);
+        }
+        p.note([
+            `URL: ${result.url}`,
+            '',
+            'Content updated. Metadata unchanged.',
+            'To change metadata, use `pmpt edit`.',
+        ].join('\n'), 'Updated!');
+    }
+    catch (err) {
+        s.stop('Update failed');
+        p.log.error(err instanceof Error ? err.message : 'Failed to update.');
+        process.exit(1);
+    }
+    p.outro('');
+}

package/dist/index.js

@@ -34,6 +34,7 @@ import { cmdExport } from './commands/export.js';
 import { cmdImport } from './commands/import.js';
 import { cmdLogin } from './commands/login.js';
 import { cmdPublish } from './commands/publish.js';
+import { cmdUpdate } from './commands/update.js';
 import { cmdEdit } from './commands/edit.js';
 import { cmdUnpublish } from './commands/unpublish.js';
 import { cmdClone } from './commands/clone.js';
@@ -63,6 +64,7 @@ Examples:
   $ pmpt import <file.pmpt>      Import from .pmpt file
   $ pmpt login                   Authenticate with pmptwiki
   $ pmpt publish                 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 recover                 Recover damaged pmpt.md via AI
@@ -143,6 +145,10 @@ program
     .option('--product-url-type <type>', 'Product link type: git or url')
     .option('--yes', 'Skip confirmation prompt')
     .action(cmdPublish);
+program
+    .command('update [path]')
+    .description('Quick re-publish: update content without changing metadata')
+    .action(cmdUpdate);
 program
     .command('edit')
     .description('Edit published project metadata (description, tags, category)')

package/dist/lib/config.js

@@ -35,6 +35,8 @@ export function initializeProject(projectPath, options) {
         createdAt: new Date().toISOString(),
         repo: options?.repo,
         trackGit: options?.trackGit ?? true,
+        origin: options?.origin,
+        gitCommitsAtInit: options?.gitCommitsAtInit,
     };
     saveConfig(projectPath, config);
     // Create README.md if it doesn't exist

package/dist/lib/git.js

@@ -84,6 +84,13 @@ export function isCommitMatch(path, expectedCommit) {
         currentFull.startsWith(expectedCommit) ||
         expectedCommit.startsWith(currentShort));
 }
+/**
+ * Count total commits in the repository
+ */
+export function getCommitCount(path) {
+    const count = git(path, 'rev-list --count HEAD');
+    return count ? parseInt(count, 10) : 0;
+}
 /**
  * Convert git info to human-readable string
  */

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/dist/lib/pmptFile.js

@@ -65,6 +65,8 @@ const MetaSchema = z.object({
     description: z.string().optional(),
     createdAt: z.string(),
     exportedAt: z.string(),
+    origin: z.enum(['new', 'adopted']).optional(),
+    gitCommitsAtInit: z.number().optional(),
 });
 // Full .pmpt file schema
 export const PmptFileSchema = z.object({

package/package.json

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