pmpt-cli 1.14.11 → 1.14.13

package/README.md

@@ -104,6 +104,7 @@ The generated prompt is **automatically copied to your clipboard**. Just paste i
 | `pmpt export` | Export project as `.pmpt` file |
 | `pmpt import <file>` | Import from `.pmpt` file |
 | `pmpt recover` | Recover damaged pmpt.md via AI-generated prompt |
+| `pmpt mcp-setup` | Auto-configure MCP server for your AI tool |
 | `pmpt -v` | Show current CLI version |
 
 ### Platform
@@ -113,8 +114,9 @@ The generated prompt is **automatically copied to your clipboard**. Just paste i
 | `pmpt login` | Authenticate via GitHub (one-time) |
 | `pmpt publish` | Publish your project (requires quality score ≥ 40) |
 | `pmpt update` | Quick re-publish: update content without changing metadata |
-| `pmpt edit` | Edit published project metadata (description, tags, category) |
+| `pmpt edit` | Edit published project metadata (description, tags, category, visibility, related projects, product URL) |
 | `pmpt unpublish` | Remove a published project from pmptwiki |
+| `pmpt graduate` | Graduate a project — archive with badge, move to Hall of Fame |
 | `pmpt clone <slug>` | Clone and reproduce someone's project |
 | `pmpt explore` | Open pmptwiki.com/explore in your browser |
 
@@ -133,7 +135,7 @@ pmpt includes a built-in [MCP](https://modelcontextprotocol.io) server so AI too
 `pmpt-mcp` is included when you install pmpt — no separate installation needed.
 
 ```bash
-npm install -g pmpt   # pmpt + pmpt-mcp both installed
+npm install -g pmpt-cli   # pmpt + pmpt-mcp both installed
 ```
 
 #### Automatic Setup (Recommended)
@@ -164,11 +166,18 @@ Add to your `.mcp.json` (or IDE MCP config):
 
 | Tool | Description |
 |------|-------------|
-| `pmpt_save` | Save a snapshot after completing features, fixes, or milestones |
+| `pmpt_plan_questions` | Get planning questions to ask the user conversationally |
+| `pmpt_plan` | Submit answers to generate AI prompt and project docs |
+| `pmpt_save` | Save a snapshot with detailed summary |
+| `pmpt_update_doc` | Check off features, add progress notes, backfill summaries |
+| `pmpt_log_decision` | Record architectural/technical decisions with reasoning |
+| `pmpt_read_context` | Read full project context (plan, docs, history, quality) |
 | `pmpt_status` | Check tracked files, snapshot count, and quality score |
 | `pmpt_history` | View version history with git commit info |
 | `pmpt_diff` | Compare two versions, or a version against working copy |
+| `pmpt_edit_plan` | Edit plan fields — regenerates plan.md and pmpt.ai.md |
 | `pmpt_quality` | Check quality score and publish readiness |
+| `pmpt_publish` | Publish project to pmptwiki.com |
 
 All tools accept an optional `projectPath` parameter (defaults to cwd).
 

package/dist/commands/edit.js

@@ -51,24 +51,27 @@ export async function cmdEdit() {
         { value: 'other', label: 'Other' },
     ].find((o) => o.value === project.category)?.label ?? project.category ?? 'Other';
     p.note([
+        project.graduated ? '🎓 Graduated — only Product URL can be updated.' : null,
         `Description: ${project.description || '(none)'}`,
         `Tags: ${project.tags?.length ? project.tags.join(', ') : '(none)'}`,
         `Category: ${categoryLabel}`,
         project.productUrl ? `Product: ${project.productUrl}` : 'Product: (none)',
         `Visibility: ${project.unlisted ? 'Unlisted' : 'Listed'}`,
         `Related: ${project.related?.length ? project.related.join(', ') : '(none)'}`,
-    ].join('\n'), 'Current Settings');
+    ].filter(Boolean).join('\n'), 'Current Settings');
     // Pick fields to edit
     const fields = await p.multiselect({
         message: 'What do you want to edit?',
-        options: [
-            { value: 'description', label: 'Description' },
-            { value: 'tags', label: 'Tags' },
-            { value: 'category', label: 'Category' },
-            { value: 'productUrl', label: 'Product Link' },
-            { value: 'unlisted', label: 'Visibility (listed/unlisted)' },
-            { value: 'related', label: 'Related Projects' },
-        ],
+        options: project.graduated
+            ? [{ value: 'productUrl', label: 'Product Link' }]
+            : [
+                { value: 'description', label: 'Description' },
+                { value: 'tags', label: 'Tags' },
+                { value: 'category', label: 'Category' },
+                { value: 'productUrl', label: 'Product Link' },
+                { value: 'unlisted', label: 'Visibility (listed/unlisted)' },
+                { value: 'related', label: 'Related Projects' },
+            ],
     });
     if (p.isCancel(fields)) {
         p.cancel('Cancelled');

package/dist/commands/init.js

@@ -275,6 +275,10 @@ function ensureMinimalDocs(projectPath) {
         '',
         '## Decisions',
         '',
+        '## Constraints',
+        '',
+        '## Lessons',
+        '',
     ].join('\n');
     writeFileSync(pmptMdPath, skeleton, 'utf-8');
 }

package/dist/lib/plan.js

@@ -105,6 +105,20 @@ After completing each feature above:
 1. Mark the feature done in \`.pmpt/docs/pmpt.md\` (change \`- [ ]\` to \`- [x]\`)
 2. Add a brief note to the Snapshot Log section
 3. Run \`pmpt save\` in terminal
+
+### What to Record in pmpt.md
+
+**## Decisions** — Record WHY, not just WHAT. Include the data or observation that led to the decision.
+- Bad: "Set minimum description length to 150 chars"
+- Good: "Set minimum description length to 150 chars (50-char threshold caused 60% low-quality entries)"
+
+**## Constraints** — Record platform/library limitations discovered during development.
+- Examples: DB quirks, API limits, framework restrictions, version incompatibilities
+- Format: \`- [Platform]: what doesn't work → workaround used\`
+
+**## Lessons** — Record anti-patterns and "we tried X, it broke because Y" discoveries.
+- Examples: wrong deletion order causing FK errors, caching issues, race conditions
+- Format: \`- [What failed] → [Root cause] → [Fix applied]\`
 `;
 }
 // Generate human-facing project document (pmpt.md)
@@ -138,6 +152,12 @@ ${techSection}
 ### v1 - Initial Setup
 - Project initialized with pmpt
 
+## Decisions
+
+## Constraints
+
+## Lessons
+
 ---
 *This document tracks your project progress. Update it as you build.*
 *AI instructions are in \`pmpt.ai.md\` — paste that into your AI tool.*

package/package.json

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