pmpt-cli 1.1.1 → 1.2.1

package/dist/commands/export.js

@@ -0,0 +1,206 @@
+import * as p from '@clack/prompts';
+import { resolve, join, basename } from 'path';
+import { existsSync, writeFileSync, statSync } from 'fs';
+import { execSync } from 'child_process';
+import { isInitialized, getConfigDir, getHistoryDir, loadConfig } from '../lib/config.js';
+import { getAllSnapshots } from '../lib/history.js';
+import { getPlanProgress } from '../lib/plan.js';
+/**
+ * Create a zip file without external dependencies
+ * Uses native zip command on macOS/Linux, PowerShell on Windows
+ */
+function createZip(sourceDir, outputPath) {
+    try {
+        const platform = process.platform;
+        if (platform === 'win32') {
+            // PowerShell Compress-Archive
+            execSync(`powershell -command "Compress-Archive -Path '${sourceDir}/*' -DestinationPath '${outputPath}'"`, {
+                stdio: 'pipe',
+            });
+        }
+        else {
+            // Unix zip command
+            execSync(`cd "${sourceDir}" && zip -r "${outputPath}" .`, {
+                stdio: 'pipe',
+            });
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate metadata markdown file
+ */
+function generateMetadataMarkdown(projectPath, snapshots, planProgress, config) {
+    const answers = planProgress?.answers || {};
+    const projectName = answers.projectName || basename(projectPath);
+    // Timeline info
+    const firstSnapshot = snapshots[0];
+    const lastSnapshot = snapshots[snapshots.length - 1];
+    const startDate = firstSnapshot?.timestamp || 'N/A';
+    const lastDate = lastSnapshot?.timestamp || 'N/A';
+    // Git info from last snapshot
+    const gitInfo = lastSnapshot?.git;
+    // All unique files across snapshots
+    const allFiles = new Set();
+    for (const snapshot of snapshots) {
+        for (const file of snapshot.files) {
+            allFiles.add(file);
+        }
+    }
+    // Parse features
+    const features = answers.coreFeatures
+        ? answers.coreFeatures
+            .split(/[,;\n]/)
+            .map((f) => f.trim())
+            .filter((f) => f)
+            .map((f) => `- ${f}`)
+            .join('\n')
+        : 'Not specified';
+    let md = `# ${projectName}
+
+> Exported from pmpt-cli
+
+## Project Overview
+
+**Product Idea:**
+${answers.productIdea || 'Not specified'}
+
+${answers.additionalContext ? `**Additional Context:**\n${answers.additionalContext}\n` : ''}
+**Key Features:**
+${features}
+
+**Tech Stack:**
+${answers.techStack || 'Not specified'}
+
+---
+
+## Export Information
+
+| Item | Value |
+|------|-------|
+| Total Iterations | ${snapshots.length} |
+| First Version | ${startDate} |
+| Last Version | ${lastDate} |
+| Files Tracked | ${allFiles.size} |
+`;
+    if (gitInfo) {
+        md += `| Git Branch | ${gitInfo.branch} |
+| Last Commit | ${gitInfo.commit} |
+`;
+    }
+    md += `
+---
+
+## Version Timeline
+
+| Version | Date | Files | Git |
+|---------|------|-------|-----|
+`;
+    for (const snapshot of snapshots) {
+        const gitCol = snapshot.git
+            ? `${snapshot.git.commit}${snapshot.git.dirty ? ' (dirty)' : ''}`
+            : '-';
+        md += `| v${snapshot.version} | ${snapshot.timestamp} | ${snapshot.files.length} | ${gitCol} |\n`;
+    }
+    md += `
+---
+
+## File List
+
+`;
+    for (const file of Array.from(allFiles).sort()) {
+        md += `- ${file}\n`;
+    }
+    md += `
+---
+
+*Generated by [pmpt-cli](https://pmptwiki.com)*
+`;
+    return md;
+}
+export async function cmdExport(path, options) {
+    const projectPath = path ? resolve(path) : process.cwd();
+    if (!isInitialized(projectPath)) {
+        p.log.error('Project not initialized. Run `pmpt init` first.');
+        process.exit(1);
+    }
+    p.intro('pmpt export');
+    const config = loadConfig(projectPath);
+    const snapshots = getAllSnapshots(projectPath);
+    const planProgress = getPlanProgress(projectPath);
+    if (snapshots.length === 0) {
+        p.log.warn('No snapshots found.');
+        p.log.info('Run `pmpt save` or `pmpt plan` first to create versions.');
+        p.outro('');
+        return;
+    }
+    const projectName = planProgress?.answers?.projectName || basename(projectPath);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 10);
+    const exportName = `pmpt-export-${projectName}-${timestamp}`;
+    // Output path
+    const outputPath = options?.output
+        ? resolve(options.output)
+        : resolve(projectPath, `${exportName}.zip`);
+    const s = p.spinner();
+    s.start('Preparing export...');
+    // Create temp directory for export
+    const tempDir = join(projectPath, '.pmpt', '.export-temp');
+    execSync(`rm -rf "${tempDir}" && mkdir -p "${tempDir}"`, { stdio: 'pipe' });
+    // Copy history folder
+    const historyDir = getHistoryDir(projectPath);
+    execSync(`cp -r "${historyDir}" "${tempDir}/history"`, { stdio: 'pipe' });
+    // Generate and save metadata
+    const metadataContent = generateMetadataMarkdown(projectPath, snapshots, planProgress, config);
+    writeFileSync(join(tempDir, 'README.md'), metadataContent, 'utf-8');
+    // Copy current docs if exists
+    const docsDir = join(getConfigDir(projectPath), 'docs');
+    if (existsSync(docsDir)) {
+        execSync(`cp -r "${docsDir}" "${tempDir}/docs"`, { stdio: 'pipe' });
+    }
+    // Copy config (without sensitive data)
+    if (config) {
+        const exportConfig = {
+            projectPath: basename(projectPath),
+            docsPath: config.docsPath,
+            createdAt: config.createdAt,
+            trackGit: config.trackGit,
+        };
+        writeFileSync(join(tempDir, 'config.json'), JSON.stringify(exportConfig, null, 2), 'utf-8');
+    }
+    // Copy plan progress if exists
+    if (planProgress) {
+        writeFileSync(join(tempDir, 'plan.json'), JSON.stringify(planProgress, null, 2), 'utf-8');
+    }
+    s.message('Creating archive...');
+    // Create zip
+    const zipSuccess = createZip(tempDir, outputPath);
+    // Cleanup temp directory
+    execSync(`rm -rf "${tempDir}"`, { stdio: 'pipe' });
+    if (!zipSuccess) {
+        s.stop('Export failed');
+        p.log.error('Failed to create zip archive.');
+        p.log.info('Make sure `zip` command is available on your system.');
+        process.exit(1);
+    }
+    s.stop('Export complete!');
+    // Summary
+    const fileSizeBytes = statSync(outputPath).size;
+    const fileSize = fileSizeBytes < 1024
+        ? `${fileSizeBytes} B`
+        : fileSizeBytes < 1024 * 1024
+            ? `${(fileSizeBytes / 1024).toFixed(1)} KB`
+            : `${(fileSizeBytes / 1024 / 1024).toFixed(1)} MB`;
+    const summary = [
+        `Project: ${projectName}`,
+        `Versions: ${snapshots.length}`,
+        `Size: ${fileSize}`,
+        '',
+        `Output: ${outputPath}`,
+    ];
+    p.note(summary.join('\n'), 'Export Summary');
+    p.log.info('Share this file to let others reproduce your AI development journey!');
+    p.outro('');
+}

package/dist/commands/import.js

@@ -0,0 +1,152 @@
+import * as p from '@clack/prompts';
+import { resolve, join } from 'path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, cpSync, rmSync } from 'fs';
+import { execSync } from 'child_process';
+import { isInitialized, getConfigDir, getHistoryDir, getDocsDir, initializeProject } from '../lib/config.js';
+/**
+ * Extract zip file
+ * Uses native unzip command on macOS/Linux, PowerShell on Windows
+ */
+function extractZip(zipPath, destDir) {
+    try {
+        const platform = process.platform;
+        mkdirSync(destDir, { recursive: true });
+        if (platform === 'win32') {
+            // PowerShell Expand-Archive
+            execSync(`powershell -command "Expand-Archive -Path '${zipPath}' -DestinationPath '${destDir}' -Force"`, {
+                stdio: 'pipe',
+            });
+        }
+        else {
+            // Unix unzip command
+            execSync(`unzip -o "${zipPath}" -d "${destDir}"`, {
+                stdio: 'pipe',
+            });
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function cmdImport(zipFile, options) {
+    if (!zipFile) {
+        p.log.error('Please provide a zip file path.');
+        p.log.info('Usage: pmpt import <file.zip>');
+        process.exit(1);
+    }
+    const zipPath = resolve(zipFile);
+    if (!existsSync(zipPath)) {
+        p.log.error(`File not found: ${zipPath}`);
+        process.exit(1);
+    }
+    if (!zipPath.endsWith('.zip')) {
+        p.log.error('Please provide a .zip file.');
+        process.exit(1);
+    }
+    p.intro('pmpt import');
+    const projectPath = process.cwd();
+    // Check if already initialized
+    if (isInitialized(projectPath) && !options?.force) {
+        const overwrite = await p.confirm({
+            message: 'Project already initialized. Merge imported history?',
+            initialValue: true,
+        });
+        if (p.isCancel(overwrite)) {
+            p.cancel('Import cancelled.');
+            process.exit(0);
+        }
+        if (!overwrite) {
+            p.log.info('Use --force to overwrite existing project.');
+            p.outro('');
+            return;
+        }
+    }
+    const s = p.spinner();
+    s.start('Extracting archive...');
+    // Create temp directory for extraction
+    const tempDir = join(projectPath, '.pmpt-import-temp');
+    rmSync(tempDir, { recursive: true, force: true });
+    const extracted = extractZip(zipPath, tempDir);
+    if (!extracted) {
+        rmSync(tempDir, { recursive: true, force: true });
+        s.stop('Extraction failed');
+        p.log.error('Failed to extract zip file.');
+        p.log.info('Make sure `unzip` command is available on your system.');
+        process.exit(1);
+    }
+    s.message('Importing project...');
+    // Read imported data
+    let importedPlan = null;
+    let importedConfig = null;
+    let projectName = 'imported-project';
+    // Read plan.json if exists
+    const planPath = join(tempDir, 'plan.json');
+    if (existsSync(planPath)) {
+        try {
+            importedPlan = JSON.parse(readFileSync(planPath, 'utf-8'));
+            if (importedPlan.answers?.projectName) {
+                projectName = importedPlan.answers.projectName;
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    // Read config.json if exists
+    const configPath = join(tempDir, 'config.json');
+    if (existsSync(configPath)) {
+        try {
+            importedConfig = JSON.parse(readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    // Initialize project if not exists
+    if (!isInitialized(projectPath)) {
+        initializeProject(projectPath, {
+            trackGit: importedConfig?.trackGit ?? true,
+        });
+    }
+    const pmptDir = getConfigDir(projectPath);
+    const historyDir = getHistoryDir(projectPath);
+    const docsDir = getDocsDir(projectPath);
+    // Import history
+    const importedHistoryDir = join(tempDir, 'history');
+    if (existsSync(importedHistoryDir)) {
+        // Copy all version folders
+        cpSync(importedHistoryDir, historyDir, { recursive: true, force: true });
+    }
+    // Import docs
+    const importedDocsDir = join(tempDir, 'docs');
+    if (existsSync(importedDocsDir)) {
+        cpSync(importedDocsDir, docsDir, { recursive: true, force: true });
+    }
+    // Import plan progress
+    if (importedPlan) {
+        const planProgressPath = join(pmptDir, 'plan-progress.json');
+        writeFileSync(planProgressPath, JSON.stringify(importedPlan, null, 2), 'utf-8');
+    }
+    // Count imported versions
+    let versionCount = 0;
+    if (existsSync(historyDir)) {
+        const { readdirSync } = await import('fs');
+        versionCount = readdirSync(historyDir).filter(d => d.startsWith('v')).length;
+    }
+    // Cleanup temp directory
+    rmSync(tempDir, { recursive: true, force: true });
+    s.stop('Import complete!');
+    // Summary
+    const summary = [
+        `Project: ${projectName}`,
+        `Versions imported: ${versionCount}`,
+        `Location: ${pmptDir}`,
+    ];
+    p.note(summary.join('\n'), 'Import Summary');
+    p.log.info('Next steps:');
+    p.log.message('  pmpt history    — View imported versions');
+    p.log.message('  pmpt plan       — View or copy AI prompt');
+    p.log.message('  pmpt save       — Save a new snapshot');
+    p.outro('Ready to continue the journey!');
+}

package/dist/index.js

@@ -10,6 +10,8 @@ import { cmdWatch } from './commands/watch.js';
 import { cmdPlan } from './commands/plan.js';
 import { cmdSave } from './commands/save.js';
 import { cmdSquash } from './commands/squash.js';
+import { cmdExport } from './commands/export.js';
+import { cmdImport } from './commands/import.js';
 const program = new Command();
 program
     .name('pmpt')
@@ -18,12 +20,14 @@ program
     .addHelpText('after', `
 Examples:
   $ pmpt init                    Initialize project
-  $ pmpt plan                    Start product planning (6 questions → AI prompt)
+  $ 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 --compact       Hide minor changes
   $ pmpt squash v2 v5            Merge versions v2-v5 into v2
+  $ pmpt export                  Export history as shareable zip
+  $ pmpt import <file.zip>       Import project from zip
 
 Folder structure:
   .pmpt/
@@ -60,9 +64,19 @@ program
     .command('squash <from> <to> [path]')
     .description('Squash multiple versions into one (e.g., pmpt squash v2 v5)')
     .action(cmdSquash);
+program
+    .command('export [path]')
+    .description('Export project history as a shareable zip archive')
+    .option('-o, --output <file>', 'Output file path')
+    .action(cmdExport);
+program
+    .command('import <file>')
+    .description('Import project from exported zip archive')
+    .option('-f, --force', 'Overwrite existing project')
+    .action(cmdImport);
 program
     .command('plan [path]')
-    .description('Quick product planning with 6 questions — auto-generate AI prompt')
+    .description('Quick product planning with 5 questions — auto-generate AI prompt')
     .option('--reset', 'Restart plan from scratch')
     .action(cmdPlan);
 // Contribution commands

package/dist/lib/plan.js

@@ -90,7 +90,19 @@ Add a "## Progress" section below and keep it updated:
 - [ ] Pending item
 \`\`\`
 
-This keeps a living record of our development journey.
+Also, add a "## Snapshot Log" section to record what was built at each checkpoint:
+\`\`\`
+## Snapshot Log
+### v1 - Initial Setup
+- Set up project structure
+- Installed dependencies: React, Tailwind
+
+### v2 - Auth Feature
+- Implemented login/signup
+- Added JWT authentication
+\`\`\`
+
+This helps others understand what was built at each version when they import this project.
 `;
 }
 // Generate plan document

package/package.json

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