pmpt-cli 1.5.1 → 1.5.2

package/dist/index.js

@@ -17,7 +17,7 @@ const program = new Command();
 program
     .name('pmpt')
     .description('pmpt — Record and share your AI-driven product development journey')
-    .version('1.4.1')
+    .version('1.5.2')
     .addHelpText('after', `
 Examples:
   $ pmpt init                    Initialize project

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmpt-cli",
-  "version": "1.5.1",
+  "version": "1.5.2",
   "description": "Record and share your AI-driven product development journey",
   "type": "module",
   "bin": {
@@ -35,11 +35,9 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.7.0",
-    "@octokit/rest": "^21.0.0",
     "chokidar": "^3.6.0",
     "commander": "^12.0.0",
     "fast-glob": "^3.3.0",
-    "gray-matter": "^4.0.3",
     "open": "^11.0.0",
     "zod": "^3.22.0"
   },

package/dist/commands/new.js

@@ -1,78 +0,0 @@
-import * as p from '@clack/prompts';
-import { writeFileSync, mkdirSync } from 'fs';
-import { dirname } from 'path';
-import { generateContent, generateFilePath } from '../lib/template.js';
-export async function cmdNew() {
-    p.intro('pmptwiki — create new document');
-    const answers = await p.group({
-        lang: () => p.select({
-            message: 'Select language',
-            options: [
-                { value: 'ko', label: 'Korean (ko)' },
-                { value: 'en', label: 'English (en)' },
-            ],
-        }),
-        purpose: () => p.select({
-            message: 'Select document type',
-            options: [
-                { value: 'guide', label: 'Guide', hint: 'Concept explanation + how-to' },
-                { value: 'rule', label: 'Rule', hint: 'Do / Don\'t' },
-                { value: 'template', label: 'Template', hint: 'Copy-paste prompt' },
-                { value: 'example', label: 'Example', hint: 'Real-world use case' },
-                { value: 'reference', label: 'Reference', hint: 'Resource collection' },
-            ],
-        }),
-        level: () => p.select({
-            message: 'Select difficulty',
-            options: [
-                { value: 'beginner', label: 'Beginner' },
-                { value: 'intermediate', label: 'Intermediate' },
-                { value: 'advanced', label: 'Advanced' },
-            ],
-        }),
-        title: () => p.text({
-            message: 'Enter a title',
-            placeholder: 'Providing enough context to AI changes the response',
-            validate: (v) => (v.trim().length < 5 ? 'At least 5 characters required' : undefined),
-        }),
-        tags: () => p.text({
-            message: 'Enter tags (comma-separated, optional)',
-            placeholder: 'context, beginner, prompt',
-        }),
-        persona: () => p.multiselect({
-            message: 'Select target audience (optional)',
-            options: [
-                { value: 'general', label: 'General' },
-                { value: 'power-user', label: 'Power User' },
-                { value: 'developer', label: 'Developer' },
-                { value: 'organization', label: 'Organization' },
-            ],
-            required: false,
-        }),
-    }, {
-        onCancel: () => {
-            p.cancel('Cancelled');
-            process.exit(0);
-        },
-    });
-    const fm = {
-        title: answers.title,
-        purpose: answers.purpose,
-        level: answers.level,
-        lang: answers.lang,
-        tags: answers.tags
-            ? answers.tags.split(',').map((t) => t.trim()).filter(Boolean)
-            : [],
-        persona: answers.persona.length ? answers.persona : undefined,
-    };
-    const filePath = generateFilePath(fm);
-    const content = generateContent(fm);
-    mkdirSync(dirname(filePath), { recursive: true });
-    writeFileSync(filePath, content, 'utf-8');
-    p.outro(`File created: ${filePath}
-
-Next steps:
-  1. Open the file and write the content
-  2. pmpt validate ${filePath}
-  3. pmpt submit ${filePath}`);
-}

package/dist/commands/submit.js

@@ -1,103 +0,0 @@
-import * as p from '@clack/prompts';
-import matter from 'gray-matter';
-import { readFileSync } from 'fs';
-import { loadAuth, saveAuth } from '../lib/auth.js';
-import { createClient, createBranch, createPR, ensureFork, getAuthUser, pushFile, } from '../lib/github.js';
-import { validate } from '../lib/schema.js';
-import { today } from '../lib/template.js';
-export async function cmdSubmit(filePath) {
-    p.intro(`pmptwiki — submit: ${filePath}`);
-    // 1. Validate
-    const s1 = p.spinner();
-    s1.start('Validating file...');
-    const result = validate(filePath);
-    if (!result.valid) {
-        s1.stop('Validation failed');
-        for (const err of result.errors)
-            p.log.error(err);
-        p.outro('Fix errors and retry: pmpt validate ' + filePath);
-        process.exit(1);
-    }
-    s1.stop(`Validation passed${result.warnings.length ? ` (${result.warnings.length} warnings)` : ''}`);
-    for (const warn of result.warnings)
-        p.log.warn(warn);
-    // 2. Auth
-    let auth = loadAuth();
-    if (!auth) {
-        p.log.info('GitHub authentication required.');
-        p.log.info('Create a Personal Access Token:\n  https://github.com/settings/tokens/new\n  Required scope: repo (full)');
-        const token = await p.password({
-            message: 'Enter your GitHub PAT:',
-            validate: (v) => (v.trim().length < 10 ? 'Please enter a valid token' : undefined),
-        });
-        if (p.isCancel(token)) {
-            p.cancel('Cancelled');
-            process.exit(0);
-        }
-        const s2 = p.spinner();
-        s2.start('Verifying authentication...');
-        try {
-            const octokit = createClient(token);
-            const username = await getAuthUser(octokit);
-            saveAuth({ token: token, username });
-            auth = { token: token, username };
-            s2.stop(`Authenticated — @${username}`);
-        }
-        catch {
-            s2.stop('Authentication failed');
-            p.outro('Invalid token. Please try again');
-            process.exit(1);
-        }
-    }
-    const octokit = createClient(auth.token);
-    // 3. Generate branch name
-    const { data: fm } = matter(readFileSync(filePath, 'utf-8'));
-    const slug = filePath
-        .replace(/^.*?(?=ko\/|en\/)/, '')
-        .replace(/\.mdx?$/, '')
-        .replace(/\//g, '-');
-    const branchName = `content/${slug}-${today()}`;
-    // 4. Check / create fork
-    const s3 = p.spinner();
-    s3.start('Checking fork...');
-    await ensureFork(octokit, auth.username);
-    s3.stop('Fork ready');
-    // 5. Create branch
-    const s4 = p.spinner();
-    s4.start(`Creating branch: ${branchName}`);
-    await createBranch(octokit, auth.username, branchName);
-    s4.stop('Branch created');
-    // 6. Push file
-    const repoPath = filePath.replace(/^.*?(?=ko\/|en\/)/, '');
-    const s5 = p.spinner();
-    s5.start('Uploading file...');
-    await pushFile(octokit, auth.username, branchName, repoPath, filePath, `docs: add ${repoPath}`);
-    s5.stop('File uploaded');
-    // 7. Create PR
-    const prTitle = fm.purpose
-        ? `[${fm.purpose}] ${fm.title}`
-        : fm.title;
-    const prBody = [
-        `## Document Info`,
-        `- **Title**: ${fm.title}`,
-        `- **Type**: ${fm.purpose ?? '-'}`,
-        `- **Level**: ${fm.level ?? '-'}`,
-        `- **Language**: ${fm.lang ?? '-'}`,
-        fm.tags?.length ? `- **Tags**: ${fm.tags.map((t) => `\`${t}\``).join(' ')}` : null,
-        ``,
-        `## Checklist`,
-        `- [ ] Is the content clear and practical?`,
-        `- [ ] Are examples included?`,
-        `- [ ] Does the title match the content?`,
-        ``,
-        `---`,
-        `_Submitted via pmpt-cli_`,
-    ]
-        .filter((l) => l !== null)
-        .join('\n');
-    const s6 = p.spinner();
-    s6.start('Creating PR...');
-    const prUrl = await createPR(octokit, auth.username, branchName, prTitle, prBody);
-    s6.stop('PR created');
-    p.outro(`Submitted!\n\n  PR: ${prUrl}\n\nOnce reviewed and merged, it will be published on pmptwiki.com.`);
-}

package/dist/commands/validate.js

@@ -1,23 +0,0 @@
-import * as p from '@clack/prompts';
-import { validate } from '../lib/schema.js';
-export function cmdValidate(filePath) {
-    p.intro(`pmptwiki — validate: ${filePath}`);
-    const result = validate(filePath);
-    if (result.errors.length === 0 && result.warnings.length === 0) {
-        p.outro('All validations passed');
-        return true;
-    }
-    for (const err of result.errors) {
-        p.log.error(err);
-    }
-    for (const warn of result.warnings) {
-        p.log.warn(warn);
-    }
-    if (result.valid) {
-        p.outro(`Validation passed (${result.warnings.length} warnings)`);
-    }
-    else {
-        p.outro(`Validation failed (${result.errors.length} errors) — fix and retry`);
-    }
-    return result.valid;
-}

package/dist/lib/github.js

@@ -1,81 +0,0 @@
-import { Octokit } from '@octokit/rest';
-import { readFileSync } from 'fs';
-const CONTENT_OWNER = 'pmptwiki';
-const CONTENT_REPO = 'content';
-export function createClient(token) {
-    return new Octokit({ auth: token });
-}
-export async function getAuthUser(octokit) {
-    const { data } = await octokit.rest.users.getAuthenticated();
-    return data.login;
-}
-/** Create fork if not exists, otherwise return existing */
-export async function ensureFork(octokit, username) {
-    try {
-        await octokit.rest.repos.get({ owner: username, repo: CONTENT_REPO });
-    }
-    catch {
-        await octokit.rest.repos.createFork({
-            owner: CONTENT_OWNER,
-            repo: CONTENT_REPO,
-        });
-        // Fork creation is async - wait briefly
-        await new Promise((r) => setTimeout(r, 3000));
-    }
-}
-/** Create branch (based on upstream main) */
-export async function createBranch(octokit, username, branchName) {
-    // Get sha of upstream main
-    const { data: ref } = await octokit.rest.git.getRef({
-        owner: CONTENT_OWNER,
-        repo: CONTENT_REPO,
-        ref: 'heads/main',
-    });
-    const sha = ref.object.sha;
-    await octokit.rest.git.createRef({
-        owner: username,
-        repo: CONTENT_REPO,
-        ref: `refs/heads/${branchName}`,
-        sha,
-    });
-}
-/** Commit file to fork branch */
-export async function pushFile(octokit, username, branchName, filePath, localFilePath, commitMessage) {
-    const content = Buffer.from(readFileSync(localFilePath, 'utf-8')).toString('base64');
-    // Check existing file sha (for update)
-    let sha;
-    try {
-        const { data } = await octokit.rest.repos.getContent({
-            owner: username,
-            repo: CONTENT_REPO,
-            path: filePath,
-            ref: branchName,
-        });
-        if (!Array.isArray(data) && 'sha' in data)
-            sha = data.sha;
-    }
-    catch {
-        // New file
-    }
-    await octokit.rest.repos.createOrUpdateFileContents({
-        owner: username,
-        repo: CONTENT_REPO,
-        path: filePath,
-        message: commitMessage,
-        content,
-        branch: branchName,
-        ...(sha ? { sha } : {}),
-    });
-}
-/** Create PR to upstream */
-export async function createPR(octokit, username, branchName, title, body) {
-    const { data } = await octokit.rest.pulls.create({
-        owner: CONTENT_OWNER,
-        repo: CONTENT_REPO,
-        title,
-        body,
-        head: `${username}:${branchName}`,
-        base: 'main',
-    });
-    return data.html_url;
-}

package/dist/lib/schema.js

@@ -1,61 +0,0 @@
-import { z } from 'zod';
-import matter from 'gray-matter';
-import { readFileSync } from 'fs';
-const frontmatterSchema = z.object({
-    title: z.string().min(5, 'Title must be at least 5 characters'),
-    purpose: z.enum(['guide', 'rule', 'template', 'example', 'reference']),
-    level: z.enum(['beginner', 'intermediate', 'advanced']),
-    lang: z.enum(['ko', 'en']),
-    persona: z.array(z.enum(['general', 'power-user', 'developer', 'organization'])).optional(),
-    status: z.enum(['draft', 'review', 'stable', 'recommended', 'deprecated']).optional(),
-    translationKey: z.string().optional(),
-    tags: z.array(z.string()).optional(),
-    created: z.string().optional(),
-    updated: z.string().optional(),
-    contributors: z.array(z.string()).optional(),
-});
-const FILE_PATH_RE = /^(ko|en)\/(guide|rule|template|example|reference)\/(beginner|intermediate|advanced)\/.+\.mdx?$/;
-export function validate(filePath) {
-    const errors = [];
-    const warnings = [];
-    // 1. File path rules
-    const relative = filePath.replace(/^.*?(?=ko\/|en\/)/, '');
-    if (!FILE_PATH_RE.test(relative)) {
-        errors.push(`File path does not match: {lang}/{purpose}/{level}/filename.md`);
-    }
-    // 2. Read file
-    let raw;
-    try {
-        raw = readFileSync(filePath, 'utf-8');
-    }
-    catch {
-        errors.push('Cannot read file');
-        return { valid: false, errors, warnings };
-    }
-    // 3. Parse frontmatter
-    const { data, content } = matter(raw);
-    const result = frontmatterSchema.safeParse(data);
-    if (!result.success) {
-        for (const issue of result.error.issues) {
-            const field = issue.path.join('.');
-            errors.push(`[${field}] ${issue.message}`);
-        }
-    }
-    // 4. Body length
-    const bodyLength = content.trim().length;
-    if (bodyLength < 200) {
-        errors.push(`Content too short (${bodyLength} chars, minimum 200)`);
-    }
-    // 5. Warnings
-    if (!data.tags || data.tags.length === 0) {
-        warnings.push('Adding tags helps with search and related document links');
-    }
-    if (!data.persona) {
-        warnings.push('Specifying a persona clarifies the target audience');
-    }
-    return {
-        valid: errors.length === 0,
-        errors,
-        warnings,
-    };
-}

package/dist/lib/template.js

@@ -1,37 +0,0 @@
-export function toSlug(title) {
-    return title
-        .toLowerCase()
-        .replace(/[^\w\s-]/g, '')
-        .trim()
-        .replace(/\s+/g, '-')
-        .replace(/-+/g, '-')
-        .slice(0, 60);
-}
-export function today() {
-    return new Date().toISOString().slice(0, 10);
-}
-export function generateFilePath(fm) {
-    const slug = toSlug(fm.title);
-    return `${fm.lang}/${fm.purpose}/${fm.level}/${slug}.md`;
-}
-export function generateContent(fm) {
-    const frontmatter = [
-        '---',
-        `title: "${fm.title}"`,
-        `purpose: ${fm.purpose}`,
-        `level: ${fm.level}`,
-        `lang: ${fm.lang}`,
-        fm.persona?.length ? `persona: [${fm.persona.map((p) => `"${p}"`).join(', ')}]` : null,
-        `status: draft`,
-        fm.tags?.length ? `tags: [${fm.tags.map((t) => `"${t}"`).join(', ')}]` : null,
-        `created: "${today()}"`,
-        `updated: "${today()}"`,
-        '---',
-    ]
-        .filter(Boolean)
-        .join('\n');
-    const body = fm.lang === 'ko'
-        ? `\n## Why It Matters\n\n<!-- Explain why this document is needed -->\n\n## How To\n\n<!-- Explain step by step -->\n\n## Examples\n\n<!-- Add real examples -->\n`
-        : `\n## Why it matters\n\n<!-- Explain why this document is needed -->\n\n## How to\n\n<!-- Explain step by step -->\n\n## Example\n\n<!-- Add a real example -->\n`;
-    return frontmatter + body;
-}