pmpt-cli 1.12.0 → 1.12.1

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/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

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
         ? {

package/dist/commands/update.js

@@ -0,0 +1,154 @@
+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;
+    }
+    // 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();
+            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/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.1",
   "description": "Record and share your AI-driven product development journey",
   "type": "module",
   "bin": {