pmpt-cli 1.9.0 → 1.10.0

package/dist/commands/diff.js

@@ -74,16 +74,23 @@ function printSummary(diffs) {
     p.log.info(`${pc.green(`+${additions}`)} additions, ${pc.red(`-${deletions}`)} deletions`);
 }
 export function cmdDiff(v1, v2, pathOrOptions, maybeOptions) {
-    // Commander passes args differently depending on how many positionals are given.
-    // pmpt diff v1 --file x       → (v1, options)
-    // pmpt diff v1 v2             → (v1, v2, options)
-    // pmpt diff v1 v2 /path       → (v1, v2, path, options)
+    // Commander passes args in order: pmpt diff v1 [v2] [path] [options]
+    // Smart parsing: if v2 looks like a path (not a version pattern), treat it as path.
     let v2Str;
     let path;
     let options = {};
+    const isVersion = (s) => /^v?\d+$/.test(s);
     if (typeof v2 === 'object') {
+        // pmpt diff v1 --file x → (v1, options)
         options = v2;
     }
+    else if (v2 !== undefined && !isVersion(v2)) {
+        // pmpt diff v1 /some/path → v2 is actually a path
+        path = v2;
+        if (typeof pathOrOptions === 'object') {
+            options = pathOrOptions;
+        }
+    }
     else {
         v2Str = v2;
         if (typeof pathOrOptions === 'object') {

package/dist/commands/internal-seed.js

@@ -0,0 +1,104 @@
+import * as p from '@clack/prompts';
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { getDocsDir, initializeProject, isInitialized } from '../lib/config.js';
+import { createFullSnapshot } from '../lib/history.js';
+import { cmdPlan } from './plan.js';
+import { cmdPublish } from './publish.js';
+function assertInternalEnabled() {
+    if (process.env.PMPT_INTERNAL !== '1') {
+        p.log.error('internal-seed is disabled.');
+        p.log.info('Set PMPT_INTERNAL=1 to enable internal automation commands.');
+        process.exit(1);
+    }
+}
+function readJsonFile(filePath) {
+    if (!existsSync(filePath)) {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        throw new Error(`Invalid JSON: ${filePath}`);
+    }
+}
+function writeDocFile(docsDir, fileName, content) {
+    const outPath = resolve(docsDir, fileName);
+    const docsRoot = resolve(docsDir);
+    if (!outPath.startsWith(docsRoot + '/') && outPath !== docsRoot) {
+        throw new Error(`Unsafe docs path: ${fileName}`);
+    }
+    mkdirSync(dirname(outPath), { recursive: true });
+    writeFileSync(outPath, content, 'utf-8');
+}
+function normalizeTags(tags) {
+    if (!tags)
+        return undefined;
+    if (Array.isArray(tags))
+        return tags.join(',');
+    return tags;
+}
+export async function cmdInternalSeed(options) {
+    assertInternalEnabled();
+    if (!options?.spec) {
+        p.log.error('Missing required option: --spec <file>');
+        process.exit(1);
+    }
+    const specPath = resolve(options.spec);
+    const specDir = dirname(specPath);
+    const spec = readJsonFile(specPath);
+    const projectPath = spec.projectPath ? resolve(spec.projectPath) : process.cwd();
+    p.intro('pmpt internal-seed');
+    if (!isInitialized(projectPath)) {
+        initializeProject(projectPath, { trackGit: true });
+        p.log.info(`Initialized: ${projectPath}`);
+    }
+    let answersFileForPlan;
+    if (spec.answers) {
+        const tempAnswersPath = join(projectPath, '.pmpt', '.internal-seed-answers.json');
+        mkdirSync(dirname(tempAnswersPath), { recursive: true });
+        writeFileSync(tempAnswersPath, JSON.stringify(spec.answers, null, 2), 'utf-8');
+        answersFileForPlan = tempAnswersPath;
+    }
+    else if (spec.answersFile) {
+        answersFileForPlan = resolve(specDir, spec.answersFile);
+    }
+    if (answersFileForPlan) {
+        await cmdPlan(projectPath, {
+            reset: spec.resetPlan ?? true,
+            answersFile: answersFileForPlan,
+        });
+        // Clean up temp answers file
+        const tempAnswersPath = join(projectPath, '.pmpt', '.internal-seed-answers.json');
+        if (spec.answers && existsSync(tempAnswersPath)) {
+            unlinkSync(tempAnswersPath);
+        }
+    }
+    const docsDir = getDocsDir(projectPath);
+    for (const step of spec.versions ?? []) {
+        for (const [fileName, content] of Object.entries(step.files ?? {})) {
+            writeDocFile(docsDir, fileName, content);
+        }
+        for (const [fileName, fromPath] of Object.entries(step.filesFrom ?? {})) {
+            const content = readFileSync(resolve(specDir, fromPath), 'utf-8');
+            writeDocFile(docsDir, fileName, content);
+        }
+        const entry = createFullSnapshot(projectPath);
+        const note = step.saveNote ? ` — ${step.saveNote}` : '';
+        p.log.success(`v${entry.version} saved${note}`);
+    }
+    if (spec.publish?.enabled) {
+        await cmdPublish(projectPath, {
+            force: spec.publish.force ?? false,
+            nonInteractive: true,
+            yes: spec.publish.yes ?? true,
+            metaFile: spec.publish.metaFile ? resolve(specDir, spec.publish.metaFile) : undefined,
+            slug: spec.publish.slug,
+            description: spec.publish.description,
+            tags: normalizeTags(spec.publish.tags),
+            category: spec.publish.category,
+        });
+    }
+    p.outro('internal-seed completed');
+}

package/dist/commands/plan.js

@@ -1,10 +1,30 @@
 import * as p from '@clack/prompts';
 import { resolve } from 'path';
-import { readFileSync } from 'fs';
+import { existsSync, readFileSync } from 'fs';
 import { isInitialized } 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';
+function loadAnswersFromFile(projectPath, inputPath) {
+    const filePath = resolve(projectPath, inputPath);
+    if (!existsSync(filePath)) {
+        throw new Error(`Answers file not found: ${filePath}`);
+    }
+    const raw = JSON.parse(readFileSync(filePath, 'utf-8'));
+    const requiredKeys = ['projectName', 'productIdea', 'coreFeatures'];
+    for (const key of requiredKeys) {
+        if (!raw[key] || String(raw[key]).trim().length === 0) {
+            throw new Error(`Missing required field in answers file: ${key}`);
+        }
+    }
+    return {
+        projectName: String(raw.projectName ?? '').trim(),
+        productIdea: String(raw.productIdea ?? '').trim(),
+        additionalContext: String(raw.additionalContext ?? '').trim(),
+        coreFeatures: String(raw.coreFeatures ?? '').trim(),
+        techStack: String(raw.techStack ?? '').trim(),
+    };
+}
 export async function cmdPlan(path, options) {
     const projectPath = path ? resolve(path) : process.cwd();
     // Check initialization
@@ -17,20 +37,25 @@ export async function cmdPlan(path, options) {
     }
     // Reset option
     if (options?.reset) {
-        const confirm = await p.confirm({
-            message: 'Restart plan from scratch?',
-            initialValue: false,
-        });
-        if (p.isCancel(confirm) || !confirm) {
-            p.cancel('Cancelled');
-            process.exit(0);
+        if (options.answersFile) {
+            initPlanProgress(projectPath);
+        }
+        else {
+            const confirm = await p.confirm({
+                message: 'Restart plan from scratch?',
+                initialValue: false,
+            });
+            if (p.isCancel(confirm) || !confirm) {
+                p.cancel('Cancelled');
+                process.exit(0);
+            }
+            initPlanProgress(projectPath);
         }
-        initPlanProgress(projectPath);
     }
     // Check progress
     let progress = getPlanProgress(projectPath);
     // If already completed
-    if (progress?.completed) {
+    if (progress?.completed && !options?.answersFile) {
         p.intro('pmpt plan');
         p.log.success('Plan already completed.');
         const action = await p.select({
@@ -122,6 +147,33 @@ export async function cmdPlan(path, options) {
     if (!progress) {
         progress = initPlanProgress(projectPath);
     }
+    // Non-interactive mode for agents/automation
+    if (options?.answersFile) {
+        p.log.info('Plan: non-interactive mode');
+        let answers;
+        try {
+            answers = loadAnswersFromFile(projectPath, options.answersFile);
+        }
+        catch (err) {
+            p.log.error(err instanceof Error ? err.message : 'Invalid answers file.');
+            p.outro('');
+            process.exit(1);
+        }
+        const s = p.spinner();
+        s.start('Generating documents from answers file...');
+        const { planPath, promptPath } = savePlanDocuments(projectPath, answers);
+        progress.completed = true;
+        progress.answers = answers;
+        savePlanProgress(projectPath, progress);
+        s.stop('Done!');
+        const pmptMdPath = promptPath.replace('pmpt.ai.md', 'pmpt.md');
+        p.note([
+            `plan.md: ${planPath}`,
+            `pmpt.md: ${pmptMdPath}`,
+            `pmpt.ai.md: ${promptPath}`,
+        ].join('\n'), 'Generated');
+        return;
+    }
     p.intro('pmpt plan — Your Product Journey Starts Here!');
     p.log.info(`Answer ${PLAN_QUESTIONS.length} quick questions to generate your AI prompt.`);
     p.log.message('You can answer in any language you prefer.');

package/dist/commands/publish.js

@@ -11,6 +11,43 @@ import { computeQuality } from '../lib/quality.js';
 import pc from 'picocolors';
 import glob from 'fast-glob';
 import { join } from 'path';
+const CATEGORY_OPTIONS = [
+    { value: 'web-app', label: 'Web App' },
+    { value: 'mobile-app', label: 'Mobile App' },
+    { value: 'cli-tool', label: 'CLI Tool' },
+    { value: 'api-backend', label: 'API/Backend' },
+    { value: 'ai-ml', label: 'AI/ML' },
+    { value: 'game', label: 'Game' },
+    { value: 'library', label: 'Library' },
+    { value: 'other', label: 'Other' },
+];
+const VALID_CATEGORIES = new Set(CATEGORY_OPTIONS.map((o) => o.value));
+function normalizeTags(value) {
+    if (Array.isArray(value)) {
+        return value
+            .map((v) => String(v).trim().toLowerCase())
+            .filter(Boolean);
+    }
+    if (typeof value === 'string') {
+        return value
+            .split(',')
+            .map((t) => t.trim().toLowerCase())
+            .filter(Boolean);
+    }
+    return [];
+}
+function loadMetaFile(projectPath, filePath) {
+    const resolved = resolve(projectPath, filePath);
+    if (!existsSync(resolved)) {
+        throw new Error(`Meta file not found: ${resolved}`);
+    }
+    try {
+        return JSON.parse(readFileSync(resolved, 'utf-8'));
+    }
+    catch {
+        throw new Error(`Invalid JSON in meta file: ${resolved}`);
+    }
+}
 function readDocsFolder(docsDir) {
     const files = {};
     if (!existsSync(docsDir))
@@ -35,7 +72,12 @@ export async function cmdPublish(path, options) {
         p.log.error('Login required. Run `pmpt login` first.');
         process.exit(1);
     }
-    p.intro('pmpt publish');
+    if (options?.nonInteractive) {
+        p.log.info('Publish: non-interactive mode');
+    }
+    else {
+        p.intro('pmpt publish');
+    }
     const config = loadConfig(projectPath);
     const snapshots = getAllSnapshots(projectPath);
     const planProgress = getPlanProgress(projectPath);
@@ -102,59 +144,92 @@ export async function cmdPublish(path, options) {
     const defaultSlug = savedSlug
         || projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-');
     // Collect publish info
-    const slug = 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.';
+    let slug;
+    let description;
+    let tags;
+    let category;
+    if (options?.nonInteractive) {
+        let metaFromFile = {};
+        if (options.metaFile) {
+            try {
+                metaFromFile = loadMetaFile(projectPath, options.metaFile);
             }
-        },
-    });
-    if (p.isCancel(slug)) {
-        p.cancel('Cancelled');
-        process.exit(0);
-    }
-    const description = 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(description)) {
-        p.cancel('Cancelled');
-        process.exit(0);
-    }
-    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);
-    }
-    const tags = tagsInput
-        .split(',')
-        .map((t) => t.trim().toLowerCase())
-        .filter(Boolean);
-    const category = await p.select({
-        message: 'Project category:',
-        initialValue: existing?.category || 'other',
-        options: [
-            { value: 'web-app', label: 'Web App' },
-            { value: 'mobile-app', label: 'Mobile App' },
-            { value: 'cli-tool', label: 'CLI Tool' },
-            { value: 'api-backend', label: 'API/Backend' },
-            { value: 'ai-ml', label: 'AI/ML' },
-            { value: 'game', label: 'Game' },
-            { value: 'library', label: 'Library' },
-            { value: 'other', label: 'Other' },
-        ],
-    });
-    if (p.isCancel(category)) {
-        p.cancel('Cancelled');
-        process.exit(0);
+            catch (err) {
+                p.log.error(err instanceof Error ? err.message : 'Failed to load meta file.');
+                process.exit(1);
+            }
+        }
+        slug = String(options.slug
+            ?? metaFromFile.slug
+            ?? savedSlug
+            ?? defaultSlug).trim();
+        description = String(options.description
+            ?? metaFromFile.description
+            ?? existing?.description
+            ?? planProgress?.answers?.productIdea?.slice(0, 200)
+            ?? '').trim();
+        tags = normalizeTags(options.tags ?? metaFromFile.tags ?? existing?.tags ?? []);
+        category = String(options.category ?? metaFromFile.category ?? existing?.category ?? 'other').trim();
+        if (!/^[a-z0-9][a-z0-9-]{1,48}[a-z0-9]$/.test(slug)) {
+            p.log.error('Invalid slug. Use 3-50 chars, lowercase letters, numbers, and hyphens only.');
+            process.exit(1);
+        }
+        if (!description) {
+            p.log.error('Description is required in non-interactive mode.');
+            process.exit(1);
+        }
+        if (!VALID_CATEGORIES.has(category)) {
+            p.log.error(`Invalid category: ${category}`);
+            p.log.info(`Allowed: ${[...VALID_CATEGORIES].join(', ')}`);
+            process.exit(1);
+        }
+    }
+    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);
+        }
+        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;
     }
     // Build .pmpt content (resolve from optimized snapshots)
     const history = snapshots.map((snapshot, i) => ({
@@ -191,13 +266,21 @@ export async function cmdPublish(path, options) {
         `Category: ${category}`,
         tags.length ? `Tags: ${tags.join(', ')}` : '',
     ].filter(Boolean).join('\n'), 'Publish Preview');
-    const confirm = await p.confirm({
-        message: 'Publish this project?',
-        initialValue: true,
-    });
-    if (p.isCancel(confirm) || !confirm) {
-        p.cancel('Cancelled');
-        process.exit(0);
+    if (options?.nonInteractive) {
+        if (!options.yes) {
+            p.log.error('Non-interactive mode requires --yes to confirm publish.');
+            process.exit(1);
+        }
+    }
+    else if (!options?.yes) {
+        const confirm = await p.confirm({
+            message: 'Publish this project?',
+            initialValue: true,
+        });
+        if (p.isCancel(confirm) || !confirm) {
+            p.cancel('Cancelled');
+            process.exit(0);
+        }
     }
     // Upload
     const s = p.spinner();
@@ -206,9 +289,9 @@ export async function cmdPublish(path, options) {
         const result = await publishProject(auth.token, {
             slug: slug,
             pmptContent,
-            description: description,
+            description,
             tags,
-            category: category,
+            category,
         });
         s.stop('Published!');
         // Update config

package/dist/index.js

@@ -40,6 +40,7 @@ import { cmdClone } from './commands/clone.js';
 import { cmdBrowse } from './commands/browse.js';
 import { cmdRecover } from './commands/recover.js';
 import { cmdDiff } from './commands/diff.js';
+import { cmdInternalSeed } from './commands/internal-seed.js';
 import { createRequire } from 'module';
 const require = createRequire(import.meta.url);
 const { version } = require('../package.json');
@@ -114,6 +115,7 @@ program
     .command('plan [path]')
     .description('Quick product planning with 5 questions — auto-generate AI prompt')
     .option('--reset', 'Restart plan from scratch')
+    .option('--answers-file <file>', 'Load plan answers from JSON file (non-interactive)')
     .action(cmdPlan);
 program
     .command('logout')
@@ -132,6 +134,13 @@ program
     .command('publish [path]')
     .description('Publish project to pmptwiki platform')
     .option('--force', 'Publish even if quality score is below minimum')
+    .option('--non-interactive', 'Run without interactive prompts')
+    .option('--meta-file <file>', 'JSON file with slug, description, tags, category')
+    .option('--slug <slug>', 'Project slug')
+    .option('--description <text>', 'Project description')
+    .option('--tags <csv>', 'Comma-separated tags')
+    .option('--category <id>', 'Project category')
+    .option('--yes', 'Skip confirmation prompt')
     .action(cmdPublish);
 program
     .command('edit')
@@ -153,4 +162,9 @@ program
     .command('recover [path]')
     .description('Generate a recovery prompt to regenerate pmpt.md via AI')
     .action(cmdRecover);
+// Internal automation command (hidden from help)
+program
+    .command('internal-seed', { hidden: true })
+    .requiredOption('--spec <file>', 'Seed spec JSON file')
+    .action(cmdInternalSeed);
 program.parse();

package/package.json

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