pmpt-cli 1.17.0 → 1.18.0

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/harness.js

@@ -77,6 +77,9 @@ 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 -->';
@@ -94,6 +97,54 @@ function ensureClaudeMdIndexRef(projectPath) {
         writeFileSync(claudeMdPath, section + '\n\n' + content, 'utf-8');
     }
 }
+// ─── 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);
+    }
+    if (added.length > 0) {
+        writeFileSync(pmptMdPath, content, 'utf-8');
+    }
+    return added;
+}
 // ─── Constraint management — reads/writes pmpt.md ## Constraints ──
 export function readConstraints(projectPath) {
     const pmptMdPath = join(getDocsDir(projectPath), 'pmpt.md');

package/package.json

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