pmpt-cli 1.3.1 → 1.4.1

package/README.md

@@ -32,8 +32,9 @@ pmpt plan
 # 4. Save your progress
 pmpt save
 
-# 5. Export & share
-pmpt export
+# 5. Publish to pmptwiki
+pmpt login
+pmpt publish
 ```
 
 ---
@@ -42,12 +43,15 @@ pmpt export
 
 - **5 questions** — Quick product planning with AI-ready prompts
 - **Version history** — Track every step of your AI-assisted development
-- **Share & reproduce** — Export `.pmpt` files for others to learn from
+- **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)
 
 ---
 
 ## Commands
 
+### Local
+
 | Command | Description |
 |---------|-------------|
 | `pmpt init` | Initialize project |
@@ -61,6 +65,33 @@ pmpt export
 | `pmpt import <file>` | Import from `.pmpt` file |
 | `pmpt status` | Check project status |
 
+### Platform
+
+| Command | Description |
+|---------|-------------|
+| `pmpt login` | Authenticate with GitHub (one-time setup) |
+| `pmpt publish` | Publish project to pmptwiki |
+| `pmpt clone <slug>` | Clone a published project |
+| `pmpt browse` | Browse and discover projects |
+
+---
+
+## Workflow
+
+```
+[You]
+  │
+  ├─ pmpt plan ─────→ 5 questions → AI prompt (clipboard)
+  │
+  ├─ Build with AI ──→ Create files, iterate
+  │
+  ├─ pmpt save ─────→ Save to .pmpt/.history
+  │
+  ├─ pmpt publish ──→ Share on pmptwiki.com
+  │
+  └─ pmpt clone ────→ Reproduce someone's project
+```
+
 ---
 
 ## Folder Structure
@@ -79,24 +110,6 @@ pmpt export
 
 ---
 
-## Workflow
-
-```
-[You]
-  │
-  ├─ pmpt plan ────→ 5 questions → AI prompt (clipboard)
-  │
-  ├─ Build with AI ─→ Create files, iterate
-  │
-  ├─ pmpt save ────→ Save to .pmpt/.history
-  │
-  ├─ pmpt export ──→ Create .pmpt file (shareable)
-  │
-  └─ pmpt import ──→ Reproduce someone's project
-```
-
----
-
 ## .pmpt File Format
 
 Single JSON file containing your entire development journey:
@@ -104,12 +117,12 @@ Single JSON file containing your entire development journey:
 ```json
 {
   "schemaVersion": "1.0",
-  "meta": { "projectName", "description", "createdAt" },
-  "plan": { "productIdea", "coreFeatures", "techStack" },
+  "meta": { "projectName": "", "description": "", "createdAt": "" },
+  "plan": { "productIdea": "", "coreFeatures": "", "techStack": "" },
   "docs": { "plan.md": "...", "pmpt.md": "..." },
   "history": [
-    { "version": 1, "timestamp": "...", "files": {...} },
-    { "version": 2, "timestamp": "...", "files": {...} }
+    { "version": 1, "timestamp": "...", "files": {} },
+    { "version": 2, "timestamp": "...", "files": {} }
   ]
 }
 ```
@@ -121,13 +134,14 @@ Single JSON file containing your entire development journey:
 - **Side project builders** — Track your AI-assisted development
 - **Startup founders** — Document MVP creation process
 - **Content creators** — Share your coding journey
-- **Learners** — Study how others build with AI
+- **Learners** — Browse and clone projects to study how others build with AI
 
 ---
 
 ## Links
 
 - [Website](https://pmptwiki.com)
+- [Explore Projects](https://pmptwiki.com/en/explore)
 - [GitHub](https://github.com/pmptwiki/pmpt-cli)
 - [npm](https://www.npmjs.com/package/pmpt-cli)
 

package/dist/commands/browse.js

@@ -0,0 +1,73 @@
+import * as p from '@clack/prompts';
+import { fetchProjects } from '../lib/api.js';
+export async function cmdBrowse() {
+    p.intro('pmpt browse');
+    const s = p.spinner();
+    s.start('프로젝트 목록 불러오는 중...');
+    let projects;
+    try {
+        const index = await fetchProjects();
+        projects = index.projects;
+    }
+    catch (err) {
+        s.stop('불러오기 실패');
+        p.log.error(err instanceof Error ? err.message : '프로젝트 목록을 불러올 수 없습니다.');
+        process.exit(1);
+    }
+    s.stop(`${projects.length}개 프로젝트`);
+    if (projects.length === 0) {
+        p.log.info('아직 공개된 프로젝트가 없습니다.');
+        p.log.message('  pmpt publish  — 첫 번째 프로젝트를 공유해보세요!');
+        p.outro('');
+        return;
+    }
+    // Select project
+    const selected = await p.select({
+        message: '프로젝트를 선택하세요:',
+        options: projects.map((proj) => ({
+            value: proj.slug,
+            label: proj.projectName,
+            hint: `v${proj.versionCount} · @${proj.author}${proj.description ? ` — ${proj.description.slice(0, 40)}` : ''}`,
+        })),
+    });
+    if (p.isCancel(selected)) {
+        p.cancel('');
+        process.exit(0);
+    }
+    const project = projects.find((p) => p.slug === selected);
+    // Show details
+    p.note([
+        `Project: ${project.projectName}`,
+        `Author: @${project.author}`,
+        `Versions: ${project.versionCount}`,
+        project.description ? `Description: ${project.description}` : '',
+        project.tags.length ? `Tags: ${project.tags.join(', ')}` : '',
+        `Published: ${project.publishedAt.slice(0, 10)}`,
+        `Size: ${(project.fileSize / 1024).toFixed(1)} KB`,
+    ].filter(Boolean).join('\n'), 'Project Details');
+    // Action
+    const action = await p.select({
+        message: '어떻게 할까요?',
+        options: [
+            { value: 'clone', label: '이 프로젝트 복제', hint: 'pmpt clone' },
+            { value: 'url', label: 'URL 표시', hint: '브라우저에서 보기' },
+            { value: 'back', label: '돌아가기' },
+        ],
+    });
+    if (p.isCancel(action) || action === 'back') {
+        p.outro('');
+        return;
+    }
+    if (action === 'clone') {
+        const { cmdClone } = await import('./clone.js');
+        await cmdClone(project.slug);
+        return;
+    }
+    if (action === 'url') {
+        const url = `https://pmptwiki.com/ko/p/${project.slug}`;
+        p.log.info(`URL: ${url}`);
+        p.log.message(`Download: ${project.downloadUrl}`);
+        p.log.message(`\npmpt clone ${project.slug}  — 터미널에서 복제`);
+        p.outro('');
+    }
+}

package/dist/commands/clone.js

@@ -0,0 +1,127 @@
+import * as p from '@clack/prompts';
+import { join, dirname } from 'path';
+import { existsSync, mkdirSync, writeFileSync, readdirSync } from 'fs';
+import { isInitialized, getConfigDir, getHistoryDir, getDocsDir, initializeProject } from '../lib/config.js';
+import { validatePmptFile } from '../lib/pmptFile.js';
+import { fetchPmptFile } from '../lib/api.js';
+/**
+ * Restore history from .pmpt data (shared with import command)
+ */
+export function restoreHistory(historyDir, history) {
+    mkdirSync(historyDir, { recursive: true });
+    for (const version of history) {
+        const timestamp = version.timestamp.replace(/[:.]/g, '-').slice(0, 19);
+        const snapshotName = `v${version.version}-${timestamp}`;
+        const snapshotDir = join(historyDir, snapshotName);
+        mkdirSync(snapshotDir, { recursive: true });
+        for (const [filename, content] of Object.entries(version.files)) {
+            const filePath = join(snapshotDir, filename);
+            const fileDir = dirname(filePath);
+            if (fileDir !== snapshotDir) {
+                mkdirSync(fileDir, { recursive: true });
+            }
+            writeFileSync(filePath, content, 'utf-8');
+        }
+        writeFileSync(join(snapshotDir, '.meta.json'), JSON.stringify({
+            version: version.version,
+            timestamp: version.timestamp,
+            files: Object.keys(version.files),
+            git: version.git,
+        }, null, 2), 'utf-8');
+    }
+}
+/**
+ * Restore docs from .pmpt data (shared with import command)
+ */
+export function restoreDocs(docsDir, docs) {
+    mkdirSync(docsDir, { recursive: true });
+    for (const [filename, content] of Object.entries(docs)) {
+        const filePath = join(docsDir, filename);
+        const fileDir = dirname(filePath);
+        if (fileDir !== docsDir) {
+            mkdirSync(fileDir, { recursive: true });
+        }
+        writeFileSync(filePath, content, 'utf-8');
+    }
+}
+export async function cmdClone(slug) {
+    if (!slug) {
+        p.log.error('slug를 입력하세요.');
+        p.log.info('사용법: pmpt clone <slug>');
+        process.exit(1);
+    }
+    p.intro(`pmpt clone — ${slug}`);
+    const s = p.spinner();
+    s.start('프로젝트 다운로드 중...');
+    let fileContent;
+    try {
+        fileContent = await fetchPmptFile(slug);
+    }
+    catch (err) {
+        s.stop('다운로드 실패');
+        p.log.error(err instanceof Error ? err.message : '프로젝트를 찾을 수 없습니다.');
+        process.exit(1);
+    }
+    s.message('검증 중...');
+    const validation = validatePmptFile(fileContent);
+    if (!validation.success || !validation.data) {
+        s.stop('검증 실패');
+        p.log.error(validation.error || '잘못된 .pmpt 파일입니다.');
+        process.exit(1);
+    }
+    const pmptData = validation.data;
+    s.stop('다운로드 완료');
+    // Show summary
+    p.note([
+        `Project: ${pmptData.meta.projectName}`,
+        `Versions: ${pmptData.history.length}`,
+        pmptData.meta.author ? `Author: @${pmptData.meta.author}` : '',
+        pmptData.meta.description ? `Description: ${pmptData.meta.description.slice(0, 80)}` : '',
+    ].filter(Boolean).join('\n'), 'Project Info');
+    const projectPath = process.cwd();
+    if (isInitialized(projectPath)) {
+        const overwrite = await p.confirm({
+            message: '이미 초기화된 프로젝트입니다. 히스토리를 병합하시겠습니까?',
+            initialValue: true,
+        });
+        if (p.isCancel(overwrite) || !overwrite) {
+            p.cancel('취소됨');
+            process.exit(0);
+        }
+    }
+    const importSpinner = p.spinner();
+    importSpinner.start('프로젝트 복원 중...');
+    if (!isInitialized(projectPath)) {
+        initializeProject(projectPath, { trackGit: true });
+    }
+    const pmptDir = getConfigDir(projectPath);
+    const historyDir = getHistoryDir(projectPath);
+    const docsDir = getDocsDir(projectPath);
+    restoreHistory(historyDir, pmptData.history);
+    if (pmptData.docs) {
+        restoreDocs(docsDir, pmptData.docs);
+    }
+    if (pmptData.plan) {
+        writeFileSync(join(pmptDir, 'plan-progress.json'), JSON.stringify({
+            completed: true,
+            startedAt: pmptData.meta.createdAt,
+            updatedAt: pmptData.meta.exportedAt,
+            answers: pmptData.plan,
+        }, null, 2), 'utf-8');
+    }
+    let versionCount = 0;
+    if (existsSync(historyDir)) {
+        versionCount = readdirSync(historyDir).filter((d) => d.startsWith('v')).length;
+    }
+    importSpinner.stop('복원 완료!');
+    p.note([
+        `Project: ${pmptData.meta.projectName}`,
+        `Versions: ${versionCount}`,
+        `Location: ${pmptDir}`,
+    ].join('\n'), 'Clone Summary');
+    p.log.info('다음 단계:');
+    p.log.message('  pmpt history    — 버전 히스토리 보기');
+    p.log.message('  pmpt plan       — AI 프롬프트 보기');
+    p.log.message('  pmpt save       — 새 스냅샷 저장');
+    p.outro('프로젝트가 복제되었습니다!');
+}

package/dist/commands/login.js

@@ -0,0 +1,46 @@
+import * as p from '@clack/prompts';
+import { loadAuth, saveAuth } from '../lib/auth.js';
+import { registerAuth } from '../lib/api.js';
+export async function cmdLogin() {
+    p.intro('pmpt login');
+    const existing = loadAuth();
+    if (existing?.token && existing?.username) {
+        p.log.info(`Currently logged in as @${existing.username}`);
+        const reauth = await p.confirm({
+            message: 'Re-authenticate?',
+            initialValue: false,
+        });
+        if (p.isCancel(reauth) || !reauth) {
+            p.outro('');
+            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);
+    }
+    const s = p.spinner();
+    s.start('인증 중...');
+    try {
+        const result = await registerAuth(pat);
+        saveAuth({
+            token: result.token,
+            githubToken: pat,
+            username: result.username,
+        });
+        s.stop(`인증 완료 — @${result.username}`);
+    }
+    catch (err) {
+        s.stop('인증 실패');
+        p.log.error(err instanceof Error ? err.message : '인증에 실패했습니다.');
+        process.exit(1);
+    }
+    p.outro('로그인 완료! pmpt publish로 프로젝트를 공유하세요.');
+}

package/dist/commands/publish.js

@@ -0,0 +1,167 @@
+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 { 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))
+        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 cmdPublish(path) {
+    const projectPath = path ? resolve(path) : process.cwd();
+    if (!isInitialized(projectPath)) {
+        p.log.error('프로젝트가 초기화되지 않았습니다. `pmpt init`을 먼저 실행하세요.');
+        process.exit(1);
+    }
+    const auth = loadAuth();
+    if (!auth?.token || !auth?.username) {
+        p.log.error('로그인이 필요합니다. `pmpt login`을 먼저 실행하세요.');
+        process.exit(1);
+    }
+    p.intro('pmpt publish');
+    const config = loadConfig(projectPath);
+    const snapshots = getAllSnapshots(projectPath);
+    const planProgress = getPlanProgress(projectPath);
+    if (snapshots.length === 0) {
+        p.log.warn('스냅샷이 없습니다. `pmpt save` 또는 `pmpt plan`을 먼저 실행하세요.');
+        p.outro('');
+        return;
+    }
+    const projectName = planProgress?.answers?.projectName || basename(projectPath);
+    // Collect publish info
+    const slug = await p.text({
+        message: '프로젝트 slug (URL에 사용될 이름):',
+        placeholder: projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-'),
+        validate: (v) => {
+            if (!/^[a-z0-9][a-z0-9-]{1,48}[a-z0-9]$/.test(v)) {
+                return '3~50자, 소문자/숫자/하이픈만 사용 가능합니다.';
+            }
+        },
+    });
+    if (p.isCancel(slug)) {
+        p.cancel('취소됨');
+        process.exit(0);
+    }
+    const description = await p.text({
+        message: '프로젝트 설명 (짧게):',
+        placeholder: planProgress?.answers?.productIdea?.slice(0, 100) || '',
+        defaultValue: planProgress?.answers?.productIdea?.slice(0, 200) || '',
+    });
+    if (p.isCancel(description)) {
+        p.cancel('취소됨');
+        process.exit(0);
+    }
+    const tagsInput = await p.text({
+        message: '태그 (쉼표로 구분):',
+        placeholder: 'react, saas, mvp',
+        defaultValue: '',
+    });
+    if (p.isCancel(tagsInput)) {
+        p.cancel('취소됨');
+        process.exit(0);
+    }
+    const tags = tagsInput
+        .split(',')
+        .map((t) => t.trim().toLowerCase())
+        .filter(Boolean);
+    // Build .pmpt content (reuse export logic)
+    const history = snapshots.map((snapshot) => ({
+        version: snapshot.version,
+        timestamp: snapshot.timestamp,
+        files: readSnapshotFiles(snapshot.snapshotDir),
+        git: snapshot.git,
+    }));
+    const docsDir = getDocsDir(projectPath);
+    const docs = readDocsFolder(docsDir);
+    const meta = {
+        projectName,
+        author: auth.username,
+        description: description,
+        createdAt: config?.createdAt || new Date().toISOString(),
+        exportedAt: new Date().toISOString(),
+    };
+    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);
+    // Confirm
+    p.note([
+        `Project: ${projectName}`,
+        `Slug: ${slug}`,
+        `Versions: ${snapshots.length}`,
+        `Size: ${(pmptContent.length / 1024).toFixed(1)} KB`,
+        `Author: @${auth.username}`,
+        tags.length ? `Tags: ${tags.join(', ')}` : '',
+    ].filter(Boolean).join('\n'), 'Publish Preview');
+    const confirm = await p.confirm({
+        message: '게시하시겠습니까?',
+        initialValue: true,
+    });
+    if (p.isCancel(confirm) || !confirm) {
+        p.cancel('취소됨');
+        process.exit(0);
+    }
+    // Upload
+    const s = p.spinner();
+    s.start('업로드 중...');
+    try {
+        const result = await publishProject(auth.token, {
+            slug: slug,
+            pmptContent,
+            description: description,
+            tags,
+        });
+        s.stop('게시 완료!');
+        // Update config
+        if (config) {
+            config.lastPublished = new Date().toISOString();
+            saveConfig(projectPath, config);
+        }
+        p.note([
+            `URL: ${result.url}`,
+            `Download: ${result.downloadUrl}`,
+            '',
+            `pmpt clone ${slug}  — 다른 사람이 이 프로젝트를 복제할 수 있습니다`,
+        ].join('\n'), 'Published!');
+    }
+    catch (err) {
+        s.stop('게시 실패');
+        p.log.error(err instanceof Error ? err.message : '게시에 실패했습니다.');
+        process.exit(1);
+    }
+    p.outro('');
+}

package/dist/index.js

@@ -12,11 +12,15 @@ import { cmdSave } from './commands/save.js';
 import { cmdSquash } from './commands/squash.js';
 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 { cmdClone } from './commands/clone.js';
+import { cmdBrowse } from './commands/browse.js';
 const program = new Command();
 program
     .name('pmpt')
     .description('pmpt — Record and share your AI-driven product development journey')
-    .version('1.3.0')
+    .version('1.4.1')
     .addHelpText('after', `
 Examples:
   $ pmpt init                    Initialize project
@@ -24,16 +28,13 @@ Examples:
   $ 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 as .pmpt file (single JSON)
   $ pmpt import <file.pmpt>      Import from .pmpt file
-
-Folder structure:
-  .pmpt/
-  ├── config.json               Config file
-  ├── docs/                     Working folder (MD files)
-  └── .history/                 Version history
+  $ pmpt login                   Authenticate with pmptwiki
+  $ pmpt publish                 Publish project to pmptwiki
+  $ pmpt clone <slug>            Clone a project from pmptwiki
+  $ pmpt browse                  Browse published projects
 
 Documentation: https://pmptwiki.com
 `);
@@ -104,4 +105,21 @@ program
     clearAuth();
     console.log('Logged out successfully');
 });
+// Platform commands
+program
+    .command('login')
+    .description('Authenticate with pmptwiki platform')
+    .action(cmdLogin);
+program
+    .command('publish [path]')
+    .description('Publish project to pmptwiki platform')
+    .action(cmdPublish);
+program
+    .command('clone <slug>')
+    .description('Clone a project from pmptwiki platform')
+    .action(cmdClone);
+program
+    .command('browse')
+    .description('Browse and search published projects')
+    .action(cmdBrowse);
 program.parse();

package/dist/lib/api.js

@@ -0,0 +1,46 @@
+/**
+ * pmptwiki API client
+ */
+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`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ githubToken }),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({ error: 'Auth failed' }));
+        throw new Error(err.error);
+    }
+    return res.json();
+}
+export async function publishProject(token, data) {
+    const res = await fetch(`${API_BASE}/publish`, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(data),
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(() => ({ error: 'Publish failed' }));
+        throw new Error(err.error);
+    }
+    return res.json();
+}
+export async function fetchProjects() {
+    const res = await fetch(`${API_BASE}/projects`);
+    if (!res.ok) {
+        throw new Error('Failed to fetch projects');
+    }
+    return res.json();
+}
+export async function fetchPmptFile(slug) {
+    const res = await fetch(`${R2_PUBLIC_URL}/projects/${slug}.pmpt`);
+    if (!res.ok) {
+        throw new Error(`Project not found: ${slug}`);
+    }
+    return res.text();
+}

package/package.json

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