pmpt-cli 1.14.13 → 1.14.15

package/dist/commands/remix.js

@@ -0,0 +1,168 @@
+import * as p from '@clack/prompts';
+import { join, basename } from 'path';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { isInitialized, getDocsDir, getPmptDir } from '../lib/config.js';
+import { getPlanProgress } from '../lib/plan.js';
+import { copyToClipboard } from '../lib/clipboard.js';
+export async function cmdRemix() {
+    const projectPath = process.cwd();
+    if (!isInitialized(projectPath)) {
+        p.log.error('Project not initialized. Run `pmpt init` or `pmpt clone <slug>` first.');
+        process.exit(1);
+    }
+    p.intro('pmpt remix');
+    const docsDir = getDocsDir(projectPath);
+    const aiMdPath = join(docsDir, 'pmpt.ai.md');
+    const planPath = join(getPmptDir(projectPath), 'plan-progress.json');
+    // Read original project info
+    const originalAiMd = existsSync(aiMdPath) ? readFileSync(aiMdPath, 'utf-8') : '';
+    const planProgress = getPlanProgress(projectPath);
+    const originalName = planProgress?.answers?.projectName || basename(projectPath);
+    const originalIdea = planProgress?.answers?.productIdea || '';
+    const originalTech = planProgress?.answers?.techStack || '';
+    p.note([
+        `Original: ${originalName}`,
+        originalIdea ? `Idea: ${originalIdea.slice(0, 100)}${originalIdea.length > 100 ? '...' : ''}` : '',
+        originalTech ? `Tech: ${originalTech}` : '',
+    ].filter(Boolean).join('\n'), 'Remixing From');
+    // Ask remix questions
+    const newName = await p.text({
+        message: 'New project name?',
+        placeholder: `my-${basename(projectPath)}-variant`,
+        validate: (v) => {
+            if (!v.trim())
+                return 'Project name is required.';
+        },
+    });
+    if (p.isCancel(newName)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const twist = await p.text({
+        message: 'What\'s different about your version? (your key differentiation)',
+        placeholder: 'e.g., Web-based version, Korean market focus, B2B instead of B2C',
+        validate: (v) => {
+            if (!v.trim())
+                return 'Please describe your differentiation.';
+        },
+    });
+    if (p.isCancel(twist)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const targetAudience = await p.text({
+        message: 'Target audience or context? (optional)',
+        placeholder: 'e.g., Small business owners, Students, Enterprise teams',
+    });
+    if (p.isCancel(targetAudience)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const techOverride = await p.text({
+        message: 'Tech stack? (leave blank to keep original)',
+        placeholder: originalTech || 'e.g., Next.js, Supabase, Vercel',
+    });
+    if (p.isCancel(techOverride)) {
+        p.cancel('Cancelled');
+        process.exit(0);
+    }
+    const techStack = (typeof techOverride === 'string' && techOverride.trim())
+        ? techOverride.trim()
+        : originalTech;
+    // Generate remixed pmpt.ai.md
+    const contextSection = (typeof targetAudience === 'string' && targetAudience.trim())
+        ? `\n## Target Audience\n${targetAudience.trim()}\n`
+        : '';
+    const techSection = techStack
+        ? `\n## Tech Stack\n${techStack}\n`
+        : '';
+    const remixedPrompt = `<!-- This file is for AI tools only. Do not edit manually. -->
+<!-- Paste this into Claude Code, Codex, Cursor, or any AI coding tool. -->
+
+# ${newName.trim()} — Remix
+
+## My Version
+${twist.trim()}
+${contextSection}${techSection}
+---
+
+## Instructions for AI
+
+This is a **remix** of an existing project. Build my version based on the differentiation above.
+
+1. Read the original project below to understand the structure and approach.
+2. Build MY version — same core concept, but with my differentiation applied throughout.
+3. Do NOT copy content verbatim. Adapt everything to fit my context.
+4. Start with core features first, then iterate.
+
+### Documentation Rule
+
+When you make progress, update \`.pmpt/docs/pmpt.md\`:
+- When architecture or tech decisions are finalized
+- 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.
+
+---
+
+## Original Project Reference
+
+${originalAiMd}
+`;
+    writeFileSync(aiMdPath, remixedPrompt, 'utf-8');
+    // Update pmpt.md project name if exists
+    const pmptMdPath = join(docsDir, 'pmpt.md');
+    if (existsSync(pmptMdPath)) {
+        let content = readFileSync(pmptMdPath, 'utf-8');
+        // Replace first heading
+        content = content.replace(/^# .+$/m, `# ${newName.trim()}`);
+        writeFileSync(pmptMdPath, content, 'utf-8');
+    }
+    // Update plan-progress.json
+    if (existsSync(planPath)) {
+        try {
+            const plan = JSON.parse(readFileSync(planPath, 'utf-8'));
+            plan.answers = {
+                ...plan.answers,
+                projectName: newName.trim(),
+                productIdea: `${originalIdea}\n\nMy differentiation: ${twist.trim()}`,
+                techStack,
+            };
+            writeFileSync(planPath, JSON.stringify(plan, null, 2), 'utf-8');
+        }
+        catch { /* ignore */ }
+    }
+    // Copy to clipboard
+    const copied = copyToClipboard(remixedPrompt);
+    p.log.success(`Remix prompt generated for "${newName.trim()}"`);
+    p.log.message('');
+    p.log.info('Next steps:');
+    p.log.message('  1. Paste the prompt into your AI tool');
+    p.log.message('  2. Build your version');
+    p.log.message('  3. pmpt save — save your progress');
+    p.log.message('  4. pmpt publish — share your remix');
+    p.log.message('');
+    if (copied) {
+        const banner = [
+            '┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓',
+            '┃                                                        ┃',
+            '┃   📋  NEXT STEP                                        ┃',
+            '┃                                                        ┃',
+            '┃   Remix prompt copied to clipboard!                    ┃',
+            '┃   Open your AI coding tool and paste it:               ┃',
+            '┃                                                        ┃',
+            '┃              ⌘ + V  (Mac)                              ┃',
+            '┃             Ctrl + V (Windows/Linux)                   ┃',
+            '┃                                                        ┃',
+            '┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛',
+            '',
+        ];
+        console.log(banner.join('\n'));
+    }
+    else {
+        p.log.warn('Could not copy to clipboard.');
+        p.log.info(`Read it at: ${aiMdPath}`);
+    }
+    p.outro('Ready to remix!');
+}

package/dist/commands/save.js

@@ -51,7 +51,7 @@ export async function cmdSave(fileOrPath) {
         p.cancel('Save cancelled.');
         process.exit(0);
     }
-    const note = summary.trim() || undefined;
+    const note = typeof summary === 'string' ? summary.trim() || undefined : undefined;
     // Write summary to pmpt.md Snapshot Log before snapshot
     if (note) {
         const pmptMdPath = join(docsDir, 'pmpt.md');

package/dist/index.js

@@ -39,6 +39,7 @@ import { cmdEdit } from './commands/edit.js';
 import { cmdUnpublish } from './commands/unpublish.js';
 import { cmdGraduate } from './commands/graduate.js';
 import { cmdClone } from './commands/clone.js';
+import { cmdRemix } from './commands/remix.js';
 import { cmdExplore } from './commands/browse.js';
 import { cmdRecover } from './commands/recover.js';
 import { cmdDiff } from './commands/diff.js';
@@ -196,6 +197,10 @@ program
     .command('clone <slug>')
     .description('Clone a project from pmptwiki platform')
     .action(cmdClone);
+program
+    .command('remix')
+    .description('Remix a cloned project — customize it with your own twist')
+    .action(cmdRemix);
 program
     .command('explore')
     .alias('exp')

package/dist/mcp.js

@@ -123,6 +123,10 @@ server.tool('pmpt_save', 'Save a snapshot of .pmpt/docs/ files. Call after compl
                 '',
                 '## Decisions',
                 '',
+                '## Constraints',
+                '',
+                '## Lessons',
+                '',
             ].join('\n');
             writeFileSync(pmptMdPath, skeleton, 'utf-8');
         }

package/package.json

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