pmpt-cli 1.14.12 → 1.14.14

package/dist/commands/init.js

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

package/dist/commands/save.js

@@ -51,7 +51,7 @@ export async function cmdSave(fileOrPath) {
         p.cancel('Save cancelled.');
         process.exit(0);
     }
-    const note = summary.trim() || undefined;
+    const note = typeof summary === 'string' ? summary.trim() || undefined : undefined;
     // Write summary to pmpt.md Snapshot Log before snapshot
     if (note) {
         const pmptMdPath = join(docsDir, 'pmpt.md');

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/dist/mcp.js

@@ -123,6 +123,10 @@ server.tool('pmpt_save', 'Save a snapshot of .pmpt/docs/ files. Call after compl
                 '',
                 '## Decisions',
                 '',
+                '## Constraints',
+                '',
+                '## Lessons',
+                '',
             ].join('\n');
             writeFileSync(pmptMdPath, skeleton, 'utf-8');
         }

package/package.json

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