pmpt-cli 1.4.1 → 1.5.0

package/README.md

@@ -2,8 +2,6 @@
 
 **Record and share your AI-driven product development journey.**
 
-AI와 대화하며 제품을 만드는 여정을 기록하고 공유하세요.
-
 [![npm version](https://img.shields.io/npm/v/pmpt-cli.svg)](https://www.npmjs.com/package/pmpt-cli)
 
 **Website**: [pmptwiki.com](https://pmptwiki.com)
@@ -44,7 +42,7 @@ pmpt publish
 - **5 questions** — Quick product planning with AI-ready prompts
 - **Version history** — Track every step of your AI-assisted development
 - **Share & reproduce** — Publish projects for others to learn from and clone
-- **Project hub** — Browse and clone projects at [pmptwiki.com](https://pmptwiki.com/en/explore)
+- **Project hub** — Browse and clone projects at [pmptwiki.com](https://pmptwiki.com/explore)
 
 ---
 
@@ -141,7 +139,7 @@ Single JSON file containing your entire development journey:
 ## Links
 
 - [Website](https://pmptwiki.com)
-- [Explore Projects](https://pmptwiki.com/en/explore)
+- [Explore Projects](https://pmptwiki.com/explore)
 - [GitHub](https://github.com/pmptwiki/pmpt-cli)
 - [npm](https://www.npmjs.com/package/pmpt-cli)
 

package/dist/commands/export.js

@@ -2,29 +2,10 @@ import * as p from '@clack/prompts';
 import { resolve, join, basename } from 'path';
 import { existsSync, readFileSync, writeFileSync, statSync } from 'fs';
 import { isInitialized, getDocsDir, loadConfig } from '../lib/config.js';
-import { getAllSnapshots } from '../lib/history.js';
+import { getAllSnapshots, resolveFullSnapshot } from '../lib/history.js';
 import { getPlanProgress } from '../lib/plan.js';
 import { createPmptFile, SCHEMA_VERSION } from '../lib/pmptFile.js';
 import glob from 'fast-glob';
-/**
- * Read all files from a snapshot directory
- */
-function readSnapshotFiles(snapshotDir) {
-    const files = {};
-    if (!existsSync(snapshotDir))
-        return files;
-    const mdFiles = glob.sync('**/*.md', { cwd: snapshotDir });
-    for (const file of mdFiles) {
-        const filePath = join(snapshotDir, file);
-        try {
-            files[file] = readFileSync(filePath, 'utf-8');
-        }
-        catch {
-            // Skip files that can't be read
-        }
-    }
-    return files;
-}
 /**
  * Read current docs folder
  */
@@ -69,15 +50,15 @@ export async function cmdExport(path, options) {
         : resolve(projectPath, `${exportName}.pmpt`);
     const s = p.spinner();
     s.start('Creating .pmpt file...');
-    // Build history array with file contents
+    // Build history array with file contents (resolve from optimized snapshots)
     const history = [];
-    for (const snapshot of snapshots) {
-        const files = readSnapshotFiles(snapshot.snapshotDir);
+    for (let i = 0; i < snapshots.length; i++) {
+        const files = resolveFullSnapshot(snapshots, i);
         history.push({
-            version: snapshot.version,
-            timestamp: snapshot.timestamp,
+            version: snapshots[i].version,
+            timestamp: snapshots[i].timestamp,
             files,
-            git: snapshot.git,
+            git: snapshots[i].git,
         });
     }
     // Read current docs

package/dist/commands/hist.js

@@ -1,8 +1,7 @@
 import * as p from '@clack/prompts';
-import { resolve, join } from 'path';
-import { readFileSync, existsSync } from 'fs';
+import { resolve } from 'path';
 import { isInitialized } from '../lib/config.js';
-import { getAllSnapshots } from '../lib/history.js';
+import { getAllSnapshots, resolveFileContent } from '../lib/history.js';
 // Simple diff calculation: count changed lines
 function calculateDiffSize(oldContent, newContent) {
     const oldLines = oldContent.split('\n');
@@ -16,15 +15,15 @@ function calculateDiffSize(oldContent, newContent) {
     }
     return changes;
 }
-// Get total diff between two snapshots
-function getSnapshotDiff(prev, curr) {
+// Get total diff between two snapshots (supports optimized snapshots)
+function getSnapshotDiff(snapshots, prevIndex, currIndex) {
+    const prev = snapshots[prevIndex];
+    const curr = snapshots[currIndex];
     let totalChanges = 0;
     const allFiles = new Set([...prev.files, ...curr.files]);
     for (const file of allFiles) {
-        const prevPath = join(prev.snapshotDir, file);
-        const currPath = join(curr.snapshotDir, file);
-        const prevContent = existsSync(prevPath) ? readFileSync(prevPath, 'utf-8') : '';
-        const currContent = existsSync(currPath) ? readFileSync(currPath, 'utf-8') : '';
+        const prevContent = resolveFileContent(snapshots, prevIndex, file) || '';
+        const currContent = resolveFileContent(snapshots, currIndex, file) || '';
         totalChanges += calculateDiffSize(prevContent, currContent);
     }
     return totalChanges;
@@ -49,7 +48,7 @@ export function cmdHistory(path, options) {
     if (options?.compact && snapshots.length > 1) {
         displaySnapshots = [snapshots[0]]; // Always show first
         for (let i = 1; i < snapshots.length; i++) {
-            const diffSize = getSnapshotDiff(snapshots[i - 1], snapshots[i]);
+            const diffSize = getSnapshotDiff(snapshots, i - 1, i);
             // Threshold: hide if less than 5 lines changed
             if (diffSize < 5) {
                 hiddenVersions.push(snapshots[i].version);

package/dist/commands/login.js

@@ -1,6 +1,7 @@
 import * as p from '@clack/prompts';
+import open from 'open';
 import { loadAuth, saveAuth } from '../lib/auth.js';
-import { registerAuth } from '../lib/api.js';
+import { requestDeviceCode, pollDeviceToken } from '../lib/api.js';
 export async function cmdLogin() {
     p.intro('pmpt login');
     const existing = loadAuth();
@@ -15,32 +16,63 @@ export async function cmdLogin() {
             return;
         }
     }
-    p.log.info('GitHub Personal Access Token이 필요합니다.\n' +
-        '  https://github.com/settings/tokens/new\n' +
-        '  필요 권한: read:user');
-    const pat = await p.password({
-        message: 'GitHub PAT를 입력하세요:',
-        validate: (v) => (v.trim().length < 10 ? '올바른 토큰을 입력하세요' : undefined),
-    });
-    if (p.isCancel(pat)) {
-        p.cancel('취소됨');
-        process.exit(0);
-    }
+    // Step 1: Request device code
     const s = p.spinner();
-    s.start('인증 중...');
+    s.start('GitHub 인증 준비 중...');
+    let device;
     try {
-        const result = await registerAuth(pat);
-        saveAuth({
-            token: result.token,
-            githubToken: pat,
-            username: result.username,
-        });
-        s.stop(`인증 완료 — @${result.username}`);
+        device = await requestDeviceCode();
+        s.stop('인증 코드가 발급되었습니다.');
     }
     catch (err) {
-        s.stop('인증 실패');
-        p.log.error(err instanceof Error ? err.message : '인증에 실패했습니다.');
+        s.stop('인증 코드 발급 실패');
+        p.log.error(err instanceof Error ? err.message : '인증 준비에 실패했습니다.');
         process.exit(1);
     }
-    p.outro('로그인 완료! pmpt publish로 프로젝트를 공유하세요.');
+    // Step 2: Show code and open browser
+    p.log.info(`아래 코드를 GitHub에 입력하세요:\n\n` +
+        `  코드: ${device.userCode}\n` +
+        `  주소: ${device.verificationUri}`);
+    const shouldOpen = await p.confirm({
+        message: '브라우저를 열까요?',
+        initialValue: true,
+    });
+    if (p.isCancel(shouldOpen)) {
+        p.cancel('취소됨');
+        process.exit(0);
+    }
+    if (shouldOpen) {
+        await open(device.verificationUri);
+    }
+    // Step 3: Poll for token
+    s.start('GitHub 인증 대기 중... (브라우저에서 코드를 입력하세요)');
+    let interval = device.interval * 1000; // seconds → ms
+    const deadline = Date.now() + device.expiresIn * 1000;
+    while (Date.now() < deadline) {
+        await sleep(interval);
+        try {
+            const result = await pollDeviceToken(device.deviceCode);
+            if (result.status === 'complete') {
+                saveAuth({ token: result.token, username: result.username });
+                s.stop(`인증 완료 — @${result.username}`);
+                p.outro('로그인 완료! pmpt publish로 프로젝트를 공유하세요.');
+                return;
+            }
+            if (result.status === 'slow_down') {
+                interval = (result.interval ?? 10) * 1000;
+            }
+            // status === 'pending' → keep polling
+        }
+        catch (err) {
+            s.stop('인증 실패');
+            p.log.error(err instanceof Error ? err.message : '인증에 실패했습니다.');
+            process.exit(1);
+        }
+    }
+    s.stop('인증 코드가 만료되었습니다.');
+    p.log.error('다시 pmpt login을 실행해 주세요.');
+    process.exit(1);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
 }

package/dist/commands/publish.js

@@ -2,26 +2,13 @@ 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 } from '../lib/history.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 } from '../lib/api.js';
 import glob from 'fast-glob';
 import { join } from 'path';
-function readSnapshotFiles(snapshotDir) {
-    const files = {};
-    if (!existsSync(snapshotDir))
-        return files;
-    const mdFiles = glob.sync('**/*.md', { cwd: snapshotDir });
-    for (const file of mdFiles) {
-        try {
-            files[file] = readFileSync(join(snapshotDir, file), 'utf-8');
-        }
-        catch { /* skip */ }
-    }
-    return files;
-}
 function readDocsFolder(docsDir) {
     const files = {};
     if (!existsSync(docsDir))
@@ -92,11 +79,28 @@ export async function cmdPublish(path) {
         .split(',')
         .map((t) => t.trim().toLowerCase())
         .filter(Boolean);
-    // Build .pmpt content (reuse export logic)
-    const history = snapshots.map((snapshot) => ({
+    const category = await p.select({
+        message: '프로젝트 카테고리:',
+        options: [
+            { value: 'web-app', label: '웹 앱 (Web App)' },
+            { value: 'mobile-app', label: '모바일 앱 (Mobile App)' },
+            { value: 'cli-tool', label: 'CLI 도구 (CLI Tool)' },
+            { value: 'api-backend', label: 'API/백엔드 (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('취소됨');
+        process.exit(0);
+    }
+    // Build .pmpt content (resolve from optimized snapshots)
+    const history = snapshots.map((snapshot, i) => ({
         version: snapshot.version,
         timestamp: snapshot.timestamp,
-        files: readSnapshotFiles(snapshot.snapshotDir),
+        files: resolveFullSnapshot(snapshots, i),
         git: snapshot.git,
     }));
     const docsDir = getDocsDir(projectPath);
@@ -125,6 +129,7 @@ export async function cmdPublish(path) {
         `Versions: ${snapshots.length}`,
         `Size: ${(pmptContent.length / 1024).toFixed(1)} KB`,
         `Author: @${auth.username}`,
+        `Category: ${category}`,
         tags.length ? `Tags: ${tags.join(', ')}` : '',
     ].filter(Boolean).join('\n'), 'Publish Preview');
     const confirm = await p.confirm({
@@ -144,6 +149,7 @@ export async function cmdPublish(path) {
             pmptContent,
             description: description,
             tags,
+            category: category,
         });
         s.stop('게시 완료!');
         // Update config

package/dist/commands/save.js

@@ -32,11 +32,17 @@ export async function cmdSave(fileOrPath) {
             if (entry.git.dirty)
                 msg += ' (uncommitted)';
         }
+        const changedCount = entry.changedFiles?.length ?? entry.files.length;
+        const unchangedCount = entry.files.length - changedCount;
+        if (unchangedCount > 0) {
+            msg += ` (${changedCount} changed, ${unchangedCount} skipped)`;
+        }
         p.log.success(msg);
         p.log.message('');
         p.log.info('Files included:');
         for (const file of entry.files) {
-            p.log.message(`  - ${file}`);
+            const isChanged = entry.changedFiles ? entry.changedFiles.includes(file) : true;
+            p.log.message(`  - ${file}${isChanged ? '' : ' (unchanged)'}`);
         }
     }
     catch (error) {

package/dist/index.js

@@ -1,8 +1,5 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import { cmdNew } from './commands/new.js';
-import { cmdValidate } from './commands/validate.js';
-import { cmdSubmit } from './commands/submit.js';
 import { cmdInit } from './commands/init.js';
 import { cmdStatus } from './commands/status.js';
 import { cmdHistory } from './commands/hist.js';
@@ -80,23 +77,6 @@ program
     .description('Quick product planning with 5 questions — auto-generate AI prompt')
     .option('--reset', 'Restart plan from scratch')
     .action(cmdPlan);
-// Contribution commands
-program
-    .command('new')
-    .description('Create new document interactively')
-    .action(cmdNew);
-program
-    .command('validate <file>')
-    .description('Validate document frontmatter and content')
-    .action((file) => {
-    const ok = cmdValidate(file);
-    if (!ok)
-        process.exit(1);
-});
-program
-    .command('submit <file>')
-    .description('Submit document via Fork → Branch → PR')
-    .action(cmdSubmit);
 program
     .command('logout')
     .description('Clear saved GitHub authentication')

package/dist/lib/api.js

@@ -3,11 +3,22 @@
  */
 const API_BASE = 'https://pmptwiki-api.sin2da.workers.dev';
 const R2_PUBLIC_URL = 'https://pub-ce73b2410943490d80b60ddad9243d31.r2.dev';
-export async function registerAuth(githubToken) {
-    const res = await fetch(`${API_BASE}/auth/register`, {
+export async function requestDeviceCode() {
+    const res = await fetch(`${API_BASE}/auth/device`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ githubToken }),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({ error: 'Device code request failed' }));
+        throw new Error(err.error);
+    }
+    return res.json();
+}
+export async function pollDeviceToken(deviceCode) {
+    const res = await fetch(`${API_BASE}/auth/device/token`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ deviceCode }),
     });
     if (!res.ok) {
         const err = await res.json().catch(() => ({ error: 'Auth failed' }));

package/dist/lib/auth.js

@@ -7,7 +7,10 @@ export function loadAuth() {
     try {
         if (!existsSync(TOKEN_FILE))
             return null;
-        return JSON.parse(readFileSync(TOKEN_FILE, 'utf-8'));
+        const data = JSON.parse(readFileSync(TOKEN_FILE, 'utf-8'));
+        if (!data.token || !data.username)
+            return null;
+        return { token: data.token, username: data.username };
     }
     catch {
         return null;

package/dist/lib/history.js

@@ -5,7 +5,7 @@ import { getGitInfo, isGitRepo } from './git.js';
 import glob from 'fast-glob';
 /**
  * .pmpt/docs 폴더의 MD 파일을 스냅샷으로 저장
- * .history/v{N}-{timestamp}/ 폴더에 모든 파일 복사
+ * 변경된 파일만 복사하여 저장 공간 최적화
  */
 export function createFullSnapshot(projectPath) {
     const historyDir = getHistoryDir(projectPath);
@@ -18,20 +18,33 @@ export function createFullSnapshot(projectPath) {
     const snapshotName = `v${version}-${timestamp}`;
     const snapshotDir = join(historyDir, snapshotName);
     mkdirSync(snapshotDir, { recursive: true });
-    // docs 폴더의 MD 파일 복사
+    // docs 폴더의 MD 파일 비교 후 변경분만 복사
     const files = [];
+    const changedFiles = [];
     if (existsSync(docsDir)) {
         const mdFiles = glob.sync('**/*.md', { cwd: docsDir });
         for (const file of mdFiles) {
             const srcPath = join(docsDir, file);
-            const destPath = join(snapshotDir, file);
-            // 하위 디렉토리가 있으면 생성
-            const destDir = join(snapshotDir, file.split('/').slice(0, -1).join('/'));
-            if (destDir !== snapshotDir) {
-                mkdirSync(destDir, { recursive: true });
-            }
-            copyFileSync(srcPath, destPath);
+            const newContent = readFileSync(srcPath, 'utf-8');
             files.push(file);
+            // 이전 버전과 비교
+            let hasChanged = true;
+            if (existing.length > 0) {
+                const prevContent = resolveFileContent(existing, existing.length - 1, file);
+                if (prevContent !== null && prevContent === newContent) {
+                    hasChanged = false;
+                }
+            }
+            if (hasChanged) {
+                const destPath = join(snapshotDir, file);
+                // 하위 디렉토리가 있으면 생성
+                const destDir = join(snapshotDir, file.split('/').slice(0, -1).join('/'));
+                if (destDir !== snapshotDir) {
+                    mkdirSync(destDir, { recursive: true });
+                }
+                copyFileSync(srcPath, destPath);
+                changedFiles.push(file);
+            }
         }
     }
     // Git 정보 수집
@@ -55,6 +68,7 @@ export function createFullSnapshot(projectPath) {
         version,
         timestamp,
         files,
+        changedFiles,
         git: gitData,
     }, null, 2), 'utf-8');
     return {
@@ -62,6 +76,7 @@ export function createFullSnapshot(projectPath) {
         timestamp,
         snapshotDir,
         files,
+        changedFiles,
         git: gitData,
     };
 }
@@ -156,6 +171,7 @@ export function getAllSnapshots(projectPath) {
             timestamp: match[2].replace(/-/g, ':'),
             snapshotDir,
             files: meta.files || [],
+            changedFiles: meta.changedFiles,
             git: meta.git,
         });
     }
@@ -230,3 +246,31 @@ export function getTrackedFiles(projectPath) {
         return [];
     return glob.sync('**/*.md', { cwd: docsDir });
 }
+/**
+ * Resolve file content by walking backwards through snapshots.
+ * Handles optimized snapshots where unchanged files are not stored.
+ */
+export function resolveFileContent(snapshots, fromIndex, fileName) {
+    for (let i = fromIndex; i >= 0; i--) {
+        const filePath = join(snapshots[i].snapshotDir, fileName);
+        if (existsSync(filePath)) {
+            return readFileSync(filePath, 'utf-8');
+        }
+    }
+    return null;
+}
+/**
+ * Resolve all file contents for a specific snapshot version.
+ * Reconstructs the full file set by walking backwards through history.
+ */
+export function resolveFullSnapshot(snapshots, targetIndex) {
+    const target = snapshots[targetIndex];
+    const files = {};
+    for (const fileName of target.files) {
+        const content = resolveFileContent(snapshots, targetIndex, fileName);
+        if (content !== null) {
+            files[fileName] = content;
+        }
+    }
+    return files;
+}

package/dist/lib/pmptFile.js

@@ -19,6 +19,7 @@ const GitInfoSchema = z.object({
 const VersionSchema = z.object({
     version: z.number().min(1),
     timestamp: z.string(),
+    summary: z.string().optional(),
     files: z.record(z.string(), z.string()), // filename -> content
     git: GitInfoSchema,
 });
@@ -42,6 +43,7 @@ const MetaSchema = z.object({
 export const PmptFileSchema = z.object({
     schemaVersion: z.string(),
     cliMinVersion: z.string().optional(),
+    guide: z.string().optional(),
     meta: MetaSchema,
     plan: PlanSchema,
     docs: z.record(z.string(), z.string()).optional(), // current docs
@@ -90,17 +92,87 @@ export function validatePmptFile(content) {
         data: result.data,
     };
 }
+/**
+ * AI guide text embedded in every .pmpt file.
+ * Helps AI models understand the project's development journey.
+ */
+const AI_GUIDE = [
+    'This is a .pmpt file — a complete record of a product built with AI.',
+    '',
+    'How to read this file:',
+    '- "plan" contains the original intent: what the creator wanted to build, key features, and tech preferences.',
+    '- "history" is an ordered array of snapshots (v1, v2, v3...). Each snapshot captures every tracked file at that point in time.',
+    '- To understand the evolution, compare files across versions sequentially. Look for what was added, removed, or rewritten between each version.',
+    '- "docs" contains the latest working documents (plan.md for the product plan, pmpt.md for the AI prompt used).',
+    '- "git" fields in each version link snapshots to source code commits, showing when code changes happened alongside document changes.',
+    '',
+    'Key insight: The value of this file is not just the final result — it is the journey. The sequence of iterations reveals how decisions were made, what was tried, and how the product evolved through AI-assisted development.',
+].join('\n');
+/**
+ * Generate a short summary describing what changed between two versions.
+ */
+function generateVersionSummary(version, prevVersion) {
+    if (!prevVersion) {
+        const fileCount = Object.keys(version.files).length;
+        const fileNames = Object.keys(version.files).join(', ');
+        return `Initial version with ${fileCount} file(s): ${fileNames}`;
+    }
+    const prevFiles = new Set(Object.keys(prevVersion.files));
+    const currFiles = new Set(Object.keys(version.files));
+    const added = [...currFiles].filter(f => !prevFiles.has(f));
+    const removed = [...prevFiles].filter(f => !currFiles.has(f));
+    const shared = [...currFiles].filter(f => prevFiles.has(f));
+    const modified = shared.filter(f => version.files[f] !== prevVersion.files[f]);
+    const parts = [];
+    if (added.length > 0) {
+        parts.push(`Added ${added.join(', ')}`);
+    }
+    if (removed.length > 0) {
+        parts.push(`Removed ${removed.join(', ')}`);
+    }
+    if (modified.length > 0) {
+        // Calculate total line changes for modified files
+        let totalAdded = 0;
+        let totalRemoved = 0;
+        for (const f of modified) {
+            const oldLines = prevVersion.files[f].split('\n');
+            const newLines = version.files[f].split('\n');
+            totalAdded += Math.max(0, newLines.length - oldLines.length);
+            totalRemoved += Math.max(0, oldLines.length - newLines.length);
+        }
+        let detail = `Modified ${modified.join(', ')}`;
+        if (totalAdded > 0 || totalRemoved > 0) {
+            const changes = [];
+            if (totalAdded > 0)
+                changes.push(`+${totalAdded} lines`);
+            if (totalRemoved > 0)
+                changes.push(`-${totalRemoved} lines`);
+            detail += ` (${changes.join(', ')})`;
+        }
+        parts.push(detail);
+    }
+    if (parts.length === 0) {
+        return 'No changes detected';
+    }
+    return parts.join('. ');
+}
 /**
  * Create .pmpt file content from project data
  */
 export function createPmptFile(meta, plan, docs, history) {
+    // Auto-generate summaries for each version
+    const historyWithSummary = history.map((version, i) => ({
+        ...version,
+        summary: version.summary || generateVersionSummary(version, i > 0 ? history[i - 1] : null),
+    }));
     const pmptFile = {
         schemaVersion: SCHEMA_VERSION,
         cliMinVersion: '1.3.0',
+        guide: AI_GUIDE,
         meta,
         plan,
         docs,
-        history,
+        history: historyWithSummary,
     };
     return JSON.stringify(pmptFile, null, 2);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmpt-cli",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "Record and share your AI-driven product development journey",
   "type": "module",
   "bin": {
@@ -40,6 +40,7 @@
     "commander": "^12.0.0",
     "fast-glob": "^3.3.0",
     "gray-matter": "^4.0.3",
+    "open": "^11.0.0",
     "zod": "^3.22.0"
   },
   "devDependencies": {