pmpt-cli 1.17.0 → 1.18.1

package/README.md

@@ -96,6 +96,7 @@ The generated prompt is **automatically copied to your clipboard**. Just paste i
 | Command | Description |
 |---------|-------------|
 | `pmpt init` | Initialize project — sets up `.pmpt/`, selects AI tool, creates entry points |
+| `pmpt harness` | Add harness to existing project — missing pmpt.md sections + index.md + tool entry points |
 | `pmpt plan` | 5 questions → AI prompt (auto-copied to clipboard) |
 | `pmpt plan --template` | Generate a fillable `answers.json` (Windows/PowerShell friendly) |
 | `pmpt plan --answers-file <f>` | Run plan non-interactively from a JSON file |

package/dist/commands/harness.js

@@ -0,0 +1,59 @@
+import * as p from '@clack/prompts';
+import { resolve, basename } from 'path';
+import { isInitialized } from '../lib/config.js';
+import { addMissingSections, ensureIndexMd, ensureCursorRules, ensureAgentsMd, ensureClaudeMdRef, } from '../lib/harness.js';
+export async function cmdHarness(path) {
+    const projectPath = path ? resolve(path) : process.cwd();
+    const projectName = basename(projectPath);
+    p.intro('pmpt harness');
+    if (!isInitialized(projectPath)) {
+        p.log.error('Project not initialized. Run `pmpt init` first.');
+        process.exit(1);
+    }
+    // 1. Add missing sections to pmpt.md
+    const added = addMissingSections(projectPath);
+    if (added.length > 0) {
+        p.log.success(`Added to pmpt.md: ${added.join(', ')}`);
+    }
+    else {
+        p.log.info('pmpt.md already has all harness sections.');
+    }
+    // 2. Create .pmpt/index.md
+    ensureIndexMd(projectPath, projectName);
+    p.log.success('Created: .pmpt/index.md');
+    // 3. Ask which AI tool
+    const toolChoice = await p.select({
+        message: 'Which AI coding tool do you use?',
+        options: [
+            { value: 'claude', label: 'Claude Code', hint: 'CLAUDE.md → .pmpt/index.md' },
+            { value: 'cursor', label: 'Cursor', hint: '.cursorrules → .pmpt/index.md' },
+            { value: 'codex', label: 'Codex', hint: 'AGENTS.md → .pmpt/index.md' },
+            { value: 'all', label: 'All of the above' },
+            { value: 'skip', label: 'Skip' },
+        ],
+    });
+    if (p.isCancel(toolChoice) || toolChoice === 'skip') {
+        p.outro('Done. .pmpt/index.md created, pmpt.md updated.');
+        return;
+    }
+    const tool = toolChoice;
+    const created = [];
+    if (tool === 'claude' || tool === 'all') {
+        ensureClaudeMdRef(projectPath);
+        created.push('CLAUDE.md (updated)');
+    }
+    if (tool === 'cursor' || tool === 'all') {
+        ensureCursorRules(projectPath);
+        created.push('.cursorrules');
+    }
+    if (tool === 'codex' || tool === 'all') {
+        ensureAgentsMd(projectPath, projectName);
+        created.push('AGENTS.md');
+    }
+    if (created.length > 0) {
+        p.log.success(`Created: ${created.join(', ')}`);
+    }
+    p.log.message('');
+    p.log.info('AI tools will now read .pmpt/index.md → .pmpt/docs/pmpt.md at session start.');
+    p.outro('Harness ready.');
+}

package/dist/index.js

@@ -47,6 +47,7 @@ import { cmdInternalSeed } from './commands/internal-seed.js';
 import { cmdMcpSetup } from './commands/mcp-setup.js';
 import { cmdDoctor } from './commands/doctor.js';
 import { cmdConstraint } from './commands/constraint.js';
+import { cmdHarness } from './commands/harness.js';
 import { trackCommand } from './lib/api.js';
 import { checkForUpdates } from './lib/update-check.js';
 import { createRequire } from 'module';
@@ -154,6 +155,10 @@ program
     ...options,
     template: options.template === true ? 'answers.json' : options.template,
 }));
+program
+    .command('harness [path]')
+    .description('Set up AI context harness for existing projects — adds missing pmpt.md sections and creates tool entry points')
+    .action(cmdHarness);
 program
     .command('constraint <action>')
     .description('Manage architecture constraints — add, list, or remove rules')

package/dist/lib/config.js

@@ -62,7 +62,12 @@ export function saveConfig(projectPath, config) {
     const configPath = join(getConfigDir(projectPath), CONFIG_FILE);
     writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
 }
-const PMPT_CLAUDE_SECTION = `
+const PMPT_INDEX_SECTION = `
+<!-- pmpt-index -->
+See \`.pmpt/index.md\` for project context. Single source of truth: \`.pmpt/docs/pmpt.md\`.
+<!-- /pmpt-index -->
+`;
+const PMPT_MCP_SECTION = `
 <!-- pmpt -->
 ## pmpt MCP Tools
 
@@ -78,6 +83,7 @@ Save after: feature completion, architecture decisions, bug fixes, or any signif
 If pmpt MCP is not available, run \`pmpt save\` in terminal instead.
 <!-- /pmpt -->
 `;
+const PMPT_CLAUDE_SECTION = PMPT_INDEX_SECTION + PMPT_MCP_SECTION;
 /**
  * Add pmpt MCP instructions to CLAUDE.md in the project root.
  * Creates the file if it doesn't exist; appends the section if not already present.

package/dist/lib/harness.js

@@ -26,21 +26,35 @@ export function generateIndexMd(projectName) {
 export function generateCursorRules() {
     return `# Project Rules
 
-See \`.pmpt/index.md\` for the project context map.
-
+See \`.pmpt/index.md\` for the full project context map.
 The single source of truth is \`.pmpt/docs/pmpt.md\`.
-Always check the **## Constraints** section before making code changes.
-After completing milestones, run \`pmpt save\` in terminal.
+
+## pmpt
+
+This project uses [pmpt](https://pmptwiki.com) to track development progress.
+
+- Read \`.pmpt/docs/pmpt.md\` before making any code changes
+- Follow every rule in the **## Constraints** section of pmpt.md
+- After milestones, run \`pmpt save\` in terminal with a summary
+- Run \`pmpt status\` to check project state
+- Update pmpt.md when architecture, constraints, or features change
 `;
 }
 export function generateAgentsMd(projectName) {
     return `# ${projectName} — Agent Instructions
 
-See \`.pmpt/index.md\` for the project context map.
-
+See \`.pmpt/index.md\` for the full project context map.
 The single source of truth is \`.pmpt/docs/pmpt.md\`.
-Always check the **## Constraints** section before making code changes.
-After completing milestones, run \`pmpt save\` in terminal.
+
+## pmpt
+
+This project uses [pmpt](https://pmptwiki.com) to track development progress.
+
+- Read \`.pmpt/docs/pmpt.md\` before making any code changes
+- Follow every rule in the **## Constraints** section of pmpt.md
+- After milestones, run \`pmpt save\` in terminal with a summary
+- Run \`pmpt status\` to check project state
+- Update pmpt.md when architecture, constraints, or features change
 `;
 }
 // ─── Setup functions ───────────────────────────────────────────────
@@ -77,22 +91,62 @@ export function setupHarnessForTools(projectPath, projectName, tools) {
         ensureClaudeMdIndexRef(projectPath);
     }
 }
+export function ensureClaudeMdRef(projectPath) {
+    ensureClaudeMdIndexRef(projectPath);
+}
 function ensureClaudeMdIndexRef(projectPath) {
-    const claudeMdPath = join(projectPath, 'CLAUDE.md');
-    const marker = '<!-- pmpt-index -->';
-    const section = `${marker}\nSee \`.pmpt/index.md\` for project context. Single source of truth: \`.pmpt/docs/pmpt.md\`.\n<!-- /pmpt-index -->`;
-    if (!existsSync(claudeMdPath))
-        return;
-    const content = readFileSync(claudeMdPath, 'utf-8');
-    if (content.includes(marker))
-        return;
-    const pmptMarker = '<!-- pmpt -->';
-    if (content.includes(pmptMarker)) {
-        writeFileSync(claudeMdPath, content.replace(pmptMarker, section + '\n\n' + pmptMarker), 'utf-8');
+    // Delegate to ensurePmptClaudeMd which handles both creation and section injection
+    // (index pointer + MCP tools)
+    const { ensurePmptClaudeMd } = require('./config.js');
+    ensurePmptClaudeMd(projectPath);
+}
+// ─── pmpt.md section migration ────────────────────────────────────
+const HARNESS_SECTIONS = [
+    {
+        heading: '## Architecture',
+        comment: '<!-- High-level structure. Update as it evolves. -->\n<!-- Example: "Next.js frontend → Cloudflare Workers API → D1 database" -->',
+    },
+    {
+        heading: '## Active Work',
+        comment: '<!-- What\'s currently being built. Clear when done, move to Snapshot Log. -->',
+    },
+    {
+        heading: '## Constraints',
+        comment: '<!-- Platform or library limitations discovered during development. -->\n<!-- Format: - [Platform/Tool]: what doesn\'t work → workaround used -->',
+    },
+    {
+        heading: '## Lessons',
+        comment: '<!-- Anti-patterns and "tried X, broke because Y" discoveries. -->\n<!-- Format: - [What failed] → [Root cause] → [Fix applied] -->',
+    },
+];
+/**
+ * Add missing harness sections to an existing pmpt.md.
+ * Returns list of section headings that were added.
+ */
+export function addMissingSections(projectPath) {
+    const pmptMdPath = join(getDocsDir(projectPath), 'pmpt.md');
+    if (!existsSync(pmptMdPath))
+        return [];
+    let content = readFileSync(pmptMdPath, 'utf-8');
+    const added = [];
+    for (const section of HARNESS_SECTIONS) {
+        if (content.includes(section.heading))
+            continue;
+        // Insert before ## Decisions if it exists, otherwise append
+        const insertBefore = '## Decisions';
+        const block = `${section.heading}\n${section.comment}\n`;
+        if (content.includes(insertBefore)) {
+            content = content.replace(insertBefore, block + '\n' + insertBefore);
+        }
+        else {
+            content = content.trimEnd() + '\n\n' + block;
+        }
+        added.push(section.heading);
     }
-    else {
-        writeFileSync(claudeMdPath, section + '\n\n' + content, 'utf-8');
+    if (added.length > 0) {
+        writeFileSync(pmptMdPath, content, 'utf-8');
     }
+    return added;
 }
 // ─── Constraint management — reads/writes pmpt.md ## Constraints ──
 export function readConstraints(projectPath) {

package/package.json

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