plan-review 0.1.0

package/dist/formatter.d.ts

@@ -0,0 +1,2 @@
+import type { PlanDocument } from './types.js';
+export declare function formatReview(doc: PlanDocument): string;

package/dist/formatter.js

@@ -0,0 +1,45 @@
+export function formatReview(doc) {
+    const commentedSectionIds = new Set(doc.comments.map((c) => c.sectionId));
+    const reviewableSections = doc.sections.filter((s) => doc.mode === 'plan' ? s.level === 3 : s.level >= 2);
+    const commentedSections = reviewableSections.filter((s) => commentedSectionIds.has(s.id));
+    const parts = [];
+    parts.push(`# Plan Review: ${doc.title}`);
+    parts.push('');
+    parts.push('## Review Summary');
+    parts.push(`- **Sections reviewed:** ${commentedSections.length}/${reviewableSections.length}`);
+    parts.push(`- **Comments:** ${doc.comments.length}`);
+    parts.push(`- **Skipped:** ${reviewableSections.length - commentedSections.length} sections without comments`);
+    parts.push('');
+    parts.push('---');
+    for (const section of commentedSections) {
+        const sectionComments = doc.comments.filter((c) => c.sectionId === section.id);
+        parts.push('');
+        parts.push(`## Section ${section.id}: ${section.heading}`);
+        parts.push('');
+        if (doc.mode === 'plan' && section.dependencies) {
+            const deps = section.dependencies;
+            if (deps.dependsOn.length > 0) {
+                parts.push(`Depends on: ${deps.dependsOn.join(', ')}`);
+            }
+            if (deps.blocks.length > 0) {
+                parts.push(`Blocks: ${deps.blocks.join(', ')}`);
+            }
+            parts.push('');
+        }
+        parts.push('### Original Content');
+        const blockquoted = section.body
+            .split('\n')
+            .map((line) => `> ${line}`)
+            .join('\n');
+        parts.push(blockquoted);
+        parts.push('');
+        for (const comment of sectionComments) {
+            parts.push('### Reviewer Comment');
+            parts.push(comment.text);
+            parts.push('');
+        }
+        parts.push('---');
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=formatter.js.map

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { existsSync } from 'node:fs';
+import * as readline from 'node:readline';
+import chalk from 'chalk';
+import { parse } from './parser.js';
+import { navigate } from './navigator.js';
+import { formatReview } from './formatter.js';
+import { writeOutput, isClaudeAvailable } from './output.js';
+const program = new Command();
+program
+    .name('plan-review')
+    .description('Interactive CLI for reviewing AI-generated markdown plans')
+    .version('0.1.0')
+    .argument('[file]', 'Path to markdown file (omit to read stdin)')
+    .option('-o, --output <target>', 'Output target: stdout, clipboard, file, claude')
+    .option('--output-file <path>', 'Custom output file path (with --output file)')
+    .option('--split-by <strategy>', 'Force split strategy: heading, separator')
+    .action(async (file, opts) => {
+    try {
+        await run(file, opts);
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            console.error(chalk.red(`Error: ${err.message}`));
+        }
+        process.exit(1);
+    }
+});
+program.parse();
+async function run(file, opts) {
+    // Validate explicit output target early, before the review starts
+    const validTargets = ['stdout', 'clipboard', 'file', 'claude'];
+    if (opts.output !== undefined) {
+        const explicitTarget = opts.output;
+        if (!validTargets.includes(explicitTarget)) {
+            throw new Error(`Invalid output target: "${opts.output}". Use: ${validTargets.join(', ')}`);
+        }
+        // Fail fast: check claude availability before starting review
+        if (explicitTarget === 'claude' && !isClaudeAvailable()) {
+            console.error(chalk.red('Claude CLI not found in PATH.'));
+            console.error(chalk.dim('Install: https://docs.anthropic.com/en/docs/claude-code'));
+            console.error(chalk.yellow('Will fall back to stdout after review.'));
+        }
+    }
+    // Read input — track whether it came from stdin
+    const inputFromStdin = !file && !process.stdin.isTTY;
+    const input = readInput(file);
+    if (!input.trim()) {
+        console.error(chalk.yellow('Empty file, nothing to review.'));
+        process.exit(0);
+    }
+    // Parse
+    const splitStrategy = opts.splitBy === 'heading' ? 'heading'
+        : opts.splitBy === 'separator' ? 'separator'
+            : 'auto';
+    const doc = parse(input, splitStrategy);
+    console.error(chalk.dim(`Detected mode: ${doc.mode} | ${doc.sections.length} sections`));
+    // Navigate (interactive review)
+    // When input came from stdin, navigator opens /dev/tty for prompts
+    const reviewed = await navigate(doc, inputFromStdin);
+    // Determine output target after review is complete
+    let outputTarget;
+    if (opts.output !== undefined) {
+        outputTarget = opts.output;
+    }
+    else {
+        outputTarget = await promptOutputTarget(inputFromStdin);
+        // Check claude availability after prompting
+        if (outputTarget === 'claude' && !isClaudeAvailable()) {
+            console.error(chalk.red('Claude CLI not found in PATH.'));
+            console.error(chalk.dim('Install: https://docs.anthropic.com/en/docs/claude-code'));
+            console.error(chalk.yellow('Falling back to stdout.'));
+            outputTarget = 'stdout';
+        }
+    }
+    // Format and output
+    const output = formatReview(reviewed);
+    writeOutput(output, outputTarget, { outputFile: opts.outputFile, inputFile: file });
+}
+async function promptOutputTarget(inputFromStdin) {
+    const ttyInput = inputFromStdin
+        ? (await import('node:fs')).createReadStream('/dev/tty')
+        : process.stdin;
+    const rl = readline.createInterface({
+        input: ttyInput,
+        output: process.stderr,
+    });
+    const answer = await new Promise((resolve) => {
+        rl.question(chalk.cyan('> Output: (s)tdout, (c)lipboard, (f)ile, cl(a)ude? '), (a) => resolve(a.trim().toLowerCase()));
+    });
+    rl.close();
+    switch (answer) {
+        case 's':
+        case 'stdout': return 'stdout';
+        case 'c':
+        case 'clipboard': return 'clipboard';
+        case 'f':
+        case 'file': return 'file';
+        case 'a':
+        case 'claude': return 'claude';
+        default: return 'stdout';
+    }
+}
+function readInput(file) {
+    if (file) {
+        if (!existsSync(file)) {
+            throw new Error(`File not found: ${file}`);
+        }
+        return readFileSync(file, 'utf-8');
+    }
+    // Read from stdin (piped)
+    if (!process.stdin.isTTY) {
+        return readFileSync('/dev/stdin', 'utf-8');
+    }
+    // No file, no stdin pipe — show help
+    program.help();
+    return ''; // unreachable
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/navigator.d.ts

@@ -0,0 +1,5 @@
+import type { PlanDocument, Section } from './types.js';
+export declare function navigate(doc: PlanDocument, inputFromStdin?: boolean): Promise<PlanDocument>;
+export declare function findSection(doc: PlanDocument, input: string): Section | undefined;
+export declare function getReviewableSections(doc: PlanDocument): Section[];
+export declare function printSummary(doc: PlanDocument): void;

package/dist/navigator.js

@@ -0,0 +1,93 @@
+import * as readline from 'node:readline';
+import chalk from 'chalk';
+import { renderSection, renderToc } from './renderer.js';
+export async function navigate(doc, inputFromStdin = false) {
+    // When input was read from stdin, stdin is exhausted.
+    // Open /dev/tty directly for interactive prompts.
+    const ttyInput = inputFromStdin
+        ? (await import('node:fs')).createReadStream('/dev/tty')
+        : process.stdin;
+    const rl = readline.createInterface({
+        input: ttyInput,
+        output: process.stderr,
+    });
+    const ask = (prompt) => new Promise((resolve) => {
+        rl.question(prompt, (answer) => resolve(answer.trim()));
+    });
+    const reviewableSections = getReviewableSections(doc);
+    let running = true;
+    while (running) {
+        console.error(renderToc(doc));
+        const input = await ask(chalk.cyan('> Enter section (e.g. 1.1), \'all\' for linear review, or \'done\' to finish: '));
+        if (input === 'done' || input === 'q') {
+            running = false;
+        }
+        else if (input === 'all') {
+            await linearReview(doc, reviewableSections, ask);
+        }
+        else {
+            const section = findSection(doc, input);
+            if (section) {
+                const startIdx = reviewableSections.indexOf(section);
+                await linearReview(doc, reviewableSections.slice(startIdx), ask);
+            }
+            else {
+                console.error(chalk.red(`Section "${input}" not found. Try again.`));
+            }
+        }
+    }
+    rl.close();
+    printSummary(doc);
+    return doc;
+}
+async function linearReview(doc, sections, ask) {
+    for (let i = 0; i < sections.length; i++) {
+        const section = sections[i];
+        console.error(renderSection(section));
+        const input = await ask(chalk.cyan('> Comment (enter to skip, \'toc\' for menu, \'back\' for previous): '));
+        if (input === 'toc') {
+            return;
+        }
+        else if (input === 'back') {
+            i -= (i > 0) ? 2 : 1; // -2 to go back (loop increments), -1 to re-show current
+            continue;
+        }
+        else if (input !== '') {
+            doc.comments.push({
+                sectionId: section.id,
+                text: input,
+                timestamp: new Date(),
+            });
+        }
+    }
+}
+export function findSection(doc, input) {
+    // Try exact ID match first
+    const byId = doc.sections.find((s) => s.id === input);
+    if (byId)
+        return byId;
+    // Try numeric index for generic mode
+    const num = parseInt(input, 10);
+    if (!isNaN(num)) {
+        const reviewable = getReviewableSections(doc);
+        if (num >= 1 && num <= reviewable.length) {
+            return reviewable[num - 1];
+        }
+    }
+    return undefined;
+}
+export function getReviewableSections(doc) {
+    return doc.sections.filter((s) => doc.mode === 'plan' ? s.level === 3 : s.level >= 2);
+}
+export function printSummary(doc) {
+    const reviewable = getReviewableSections(doc);
+    const commentedIds = new Set(doc.comments.map((c) => c.sectionId));
+    console.error('');
+    console.error(chalk.bold('Review Summary'));
+    console.error(`  Sections: ${reviewable.length}`);
+    console.error(`  Commented: ${chalk.green(String(commentedIds.size))}`);
+    console.error(`  Skipped: ${chalk.dim(String(reviewable.length - commentedIds.size))}`);
+    console.error(`  Total comments: ${doc.comments.length}`);
+    console.error('');
+}
+//# sourceMappingURL=navigator.js.map

package/dist/navigator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigator.js","sourceRoot":"","sources":["../src/navigator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAiB,EAAE,iBAA0B,KAAK;IAC/E,sDAAsD;IACtD,kDAAkD;IAClD,MAAM,QAAQ,GAAG,cAAc;QAC7B,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC;QACxD,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAElB,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,CAAC,MAAc,EAAmB,EAAE,CAC9C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACtB,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEL,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAEtD,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,OAAO,OAAO,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,GAAG,CACrB,KAAK,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAC7F,CAAC;QAEF,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACtC,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YAC3B,MAAM,YAAY,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACrD,MAAM,YAAY,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;YACnE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,yBAAyB,CAAC,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,GAAiB,EACjB,QAAmB,EACnB,GAAwC;IAExC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QAEtC,MAAM,KAAK,GAAG,MAAM,GAAG,CACrB,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,CACnF,CAAC;QAEF,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;aAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC5B,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,yDAAyD;YAC/E,SAAS;QACX,CAAC;aAAM,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAChB,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,IAAI,EAAE,KAAK;gBACX,SAAS,EAAE,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAiB,EAAE,KAAa;IAC1D,2BAA2B;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;IACtD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAEtB,qCAAqC;IACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACzC,OAAO,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAiB;IACrD,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAiB;IAC5C,MAAM,UAAU,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAEnE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,eAAe,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,KAAK,CAAC,gBAAgB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,OAAO,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACxF,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,7 @@
+import type { OutputTarget } from './types.js';
+export declare function writeOutput(content: string, target: OutputTarget, options?: {
+    outputFile?: string;
+    inputFile?: string;
+}): void;
+export declare function getClipboardCommand(platform: string): string | null;
+export declare function isClaudeAvailable(): boolean;

package/dist/output.js

@@ -0,0 +1,85 @@
+import { execSync, spawn } from 'node:child_process';
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import chalk from 'chalk';
+export function writeOutput(content, target, options = {}) {
+    switch (target) {
+        case 'stdout':
+            process.stdout.write(content + '\n');
+            break;
+        case 'clipboard':
+            writeToClipboard(content);
+            break;
+        case 'file':
+            writeToFile(content, options.outputFile, options.inputFile);
+            break;
+        case 'claude':
+            sendToClaude(content);
+            break;
+    }
+}
+function writeToClipboard(content) {
+    const cmd = getClipboardCommand(process.platform);
+    if (!cmd) {
+        console.error(chalk.yellow('Clipboard not supported on this platform. Falling back to stdout.'));
+        process.stdout.write(content + '\n');
+        return;
+    }
+    try {
+        execSync(cmd, { input: content, stdio: ['pipe', 'ignore', 'ignore'] });
+        console.error(chalk.green('Review copied to clipboard.'));
+    }
+    catch {
+        console.error(chalk.yellow('Failed to copy to clipboard. Falling back to stdout.'));
+        process.stdout.write(content + '\n');
+    }
+}
+function writeToFile(content, outputFile, inputFile) {
+    const filePath = outputFile
+        ? resolve(outputFile)
+        : inputFile
+            ? resolve(inputFile.replace(/\.md$/, '.review.md'))
+            : resolve('review.md');
+    writeFileSync(filePath, content, 'utf-8');
+    console.error(chalk.green(`Review written to ${filePath}`));
+}
+function sendToClaude(content) {
+    if (!isClaudeAvailable()) {
+        console.error(chalk.red('Claude CLI not found in PATH.'));
+        console.error(chalk.dim('Install: https://docs.anthropic.com/en/docs/claude-code'));
+        console.error(chalk.yellow('Falling back to stdout.'));
+        process.stdout.write(content + '\n');
+        return;
+    }
+    const child = spawn('claude', [], {
+        stdio: ['pipe', 'inherit', 'inherit'],
+    });
+    child.stdin.write(content);
+    child.stdin.end();
+    child.on('error', (err) => {
+        console.error(chalk.yellow(`Failed to pipe to claude: ${err.message}. Falling back to stdout.`));
+        process.stdout.write(content + '\n');
+    });
+}
+export function getClipboardCommand(platform) {
+    switch (platform) {
+        case 'darwin':
+            return 'pbcopy';
+        case 'linux':
+            return 'xclip -selection clipboard';
+        case 'win32':
+            return 'clip';
+        default:
+            return null;
+    }
+}
+export function isClaudeAvailable() {
+    try {
+        execSync('which claude', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}

package/dist/parser.d.ts

@@ -0,0 +1,3 @@
+import type { PlanDocument, SplitStrategy } from './types.js';
+export declare function parse(input: string, strategy?: SplitStrategy): PlanDocument;
+export declare function isPlanDocument(input: string): boolean;

package/dist/parser.js

@@ -0,0 +1,265 @@
+const MIN_SECTION_CHARS = 5;
+export function parse(input, strategy = 'auto') {
+    const lines = input.split('\n');
+    const title = extractTitle(lines);
+    const metadata = extractMetadata(lines);
+    if (strategy === 'auto') {
+        if (isPlanDocument(input)) {
+            return parsePlan(input, title, metadata);
+        }
+        return parseGeneric(input, title, metadata);
+    }
+    if (strategy === 'separator') {
+        return parseBySeparator(input, title, metadata);
+    }
+    return parseGeneric(input, title, metadata);
+}
+function extractTitle(lines) {
+    const h1 = lines.find((l) => /^# /.test(l));
+    return h1 ? h1.replace(/^# /, '').trim() : 'Untitled';
+}
+function extractMetadata(lines) {
+    const meta = {};
+    for (const line of lines.slice(0, 20)) {
+        const match = line.match(/^\*\*(\w[\w\s]*?):\*\*\s*(.+)/);
+        if (match) {
+            meta[match[1].trim()] = match[2].trim();
+        }
+    }
+    return meta;
+}
+export function isPlanDocument(input) {
+    const stripped = input.replace(/```[\s\S]*?```/g, '');
+    const hasH2H3Hierarchy = /^## /m.test(stripped) && /^### /m.test(stripped);
+    const hasPlanFields = /\*\*Depends On:\*\*/m.test(stripped) ||
+        /\*\*Blocks:\*\*/m.test(stripped) ||
+        /\*\*Verification:\*\*/m.test(stripped) ||
+        /\*\*Related Files:\*\*/m.test(stripped);
+    return hasH2H3Hierarchy && hasPlanFields;
+}
+function parseGeneric(input, title, metadata) {
+    const sections = splitByHeadings(input);
+    if (sections.length === 0) {
+        return parseBySeparator(input, title, metadata);
+    }
+    return {
+        title,
+        metadata,
+        mode: 'generic',
+        sections: sections.map((s, i) => ({
+            id: `section-${i + 1}`,
+            heading: s.heading,
+            level: s.level,
+            body: s.body,
+        })),
+        comments: [],
+    };
+}
+function splitByHeadings(input) {
+    const lines = input.split('\n');
+    const sections = [];
+    let currentHeading = '';
+    let currentLevel = 0;
+    let currentBody = [];
+    // Find the most common heading level (## or ###)
+    const h2Count = (input.match(/^## /gm) || []).length;
+    const h3Count = (input.match(/^### /gm) || []).length;
+    const splitLevel = h2Count > 0 ? 2 : h3Count > 0 ? 3 : 0;
+    if (splitLevel === 0)
+        return [];
+    const headingRegex = new RegExp(`^${'#'.repeat(splitLevel)} (.+)`);
+    let inCodeBlock = false;
+    for (const line of lines) {
+        if (line.startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+            if (currentHeading) {
+                currentBody.push(line);
+            }
+            continue;
+        }
+        if (inCodeBlock) {
+            if (currentHeading) {
+                currentBody.push(line);
+            }
+            continue;
+        }
+        const match = line.match(headingRegex);
+        if (match) {
+            if (currentHeading) {
+                sections.push({
+                    heading: currentHeading,
+                    level: currentLevel,
+                    body: currentBody.join('\n').trim(),
+                });
+            }
+            currentHeading = match[1].trim();
+            currentLevel = splitLevel;
+            currentBody = [];
+        }
+        else if (currentHeading) {
+            currentBody.push(line);
+        }
+    }
+    if (currentHeading) {
+        sections.push({
+            heading: currentHeading,
+            level: currentLevel,
+            body: currentBody.join('\n').trim(),
+        });
+    }
+    return sections;
+}
+function parseBySeparator(input, title, metadata) {
+    const parts = input.split(/\n---\n/).filter((p) => {
+        return p.trim().length >= MIN_SECTION_CHARS;
+    });
+    if (parts.length <= 1) {
+        return {
+            title,
+            metadata,
+            mode: 'generic',
+            sections: [
+                {
+                    id: 'section-1',
+                    heading: title,
+                    level: 1,
+                    body: input.trim(),
+                },
+            ],
+            comments: [],
+        };
+    }
+    return {
+        title,
+        metadata,
+        mode: 'generic',
+        sections: parts.map((p, i) => {
+            const lines = p.trim().split('\n');
+            const firstLine = lines[0].replace(/^#+\s*/, '').trim();
+            return {
+                id: `section-${i + 1}`,
+                heading: firstLine || `Section ${i + 1}`,
+                level: 2,
+                body: p.trim(),
+            };
+        }),
+        comments: [],
+    };
+}
+function parsePlan(input, title, metadata) {
+    const lines = input.split('\n');
+    const sections = [];
+    let milestoneIndex = 0;
+    let taskIndex = 0;
+    let currentMilestoneId = '';
+    let currentHeading = '';
+    let currentLevel = 0;
+    let currentBody = [];
+    let inCodeBlock = false;
+    function flushSection() {
+        if (!currentHeading)
+            return;
+        const body = currentBody.join('\n').trim();
+        if (currentLevel === 2) {
+            milestoneIndex++;
+            taskIndex = 0;
+            currentMilestoneId = `milestone-${milestoneIndex}`;
+            sections.push({
+                id: currentMilestoneId,
+                heading: currentHeading,
+                level: 2,
+                body,
+            });
+            return;
+        }
+        taskIndex++;
+        const id = `${milestoneIndex}.${taskIndex}`;
+        sections.push({
+            id,
+            heading: currentHeading,
+            level: 3,
+            body,
+            parent: currentMilestoneId,
+            dependencies: extractDependencies(body),
+            relatedFiles: extractRelatedFiles(body),
+            verification: extractVerification(body),
+        });
+    }
+    for (const line of lines) {
+        if (line.startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+            currentBody.push(line);
+            continue;
+        }
+        if (inCodeBlock) {
+            currentBody.push(line);
+            continue;
+        }
+        const h2Match = line.match(/^## (.+)/);
+        const h3Match = line.match(/^### (.+)/);
+        if (h2Match) {
+            flushSection();
+            currentHeading = h2Match[1].trim();
+            currentLevel = 2;
+            currentBody = [];
+        }
+        else if (h3Match) {
+            flushSection();
+            currentHeading = h3Match[1].trim();
+            currentLevel = 3;
+            currentBody = [];
+        }
+        else {
+            currentBody.push(line);
+        }
+    }
+    flushSection();
+    return {
+        title,
+        metadata,
+        mode: 'plan',
+        sections,
+        comments: [],
+    };
+}
+function extractDependencies(body) {
+    const dependsMatch = body.match(/\*\*Depends On:\*\*\s*(.+)/);
+    const blocksMatch = body.match(/\*\*Blocks:\*\*\s*(.+)/);
+    const parseList = (raw) => {
+        const trimmed = raw.trim();
+        if (trimmed === '(none)' || trimmed === '')
+            return [];
+        return trimmed.split(/,\s*/).map((s) => s.trim());
+    };
+    return {
+        dependsOn: dependsMatch ? parseList(dependsMatch[1]) : [],
+        blocks: blocksMatch ? parseList(blocksMatch[1]) : [],
+    };
+}
+function extractRelatedFiles(body) {
+    const files = [];
+    const lines = body.split('\n');
+    let inRelatedFiles = false;
+    for (const line of lines) {
+        if (/\*\*Related Files:\*\*/.test(line)) {
+            inRelatedFiles = true;
+            continue;
+        }
+        if (inRelatedFiles) {
+            const fileMatch = line.match(/^- `(.+)`(.*)$/);
+            if (fileMatch) {
+                const suffix = fileMatch[2].trim();
+                files.push(suffix ? `${fileMatch[1]} ${suffix}` : fileMatch[1]);
+            }
+            else if (line.trim() === '' || /^\*\*/.test(line.trim())) {
+                inRelatedFiles = false;
+            }
+        }
+    }
+    return files;
+}
+function extractVerification(body) {
+    const match = body.match(/\*\*Verification:\*\*\s*`(.+?)`/);
+    return match ? match[1] : undefined;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/dist/renderer.d.ts

@@ -0,0 +1,3 @@
+import type { Section, PlanDocument } from './types.js';
+export declare function renderSection(section: Section): string;
+export declare function renderToc(doc: PlanDocument): string;

package/dist/renderer.js

@@ -0,0 +1,78 @@
+import { marked } from 'marked';
+import { markedTerminal } from 'marked-terminal';
+import chalk from 'chalk';
+marked.use(markedTerminal());
+export function renderSection(section) {
+    const parts = [];
+    if (section.level === 3 && section.dependencies) {
+        parts.push(renderMetadataHeader(section));
+        parts.push('');
+    }
+    const heading = `${'#'.repeat(section.level)} ${section.heading}`;
+    const body = section.body || '';
+    const markdown = `${heading}\n\n${body}`;
+    parts.push(marked.parse(markdown));
+    return parts.join('\n');
+}
+function renderMetadataHeader(section) {
+    const deps = section.dependencies;
+    const dependsOn = deps.dependsOn.length > 0 ? deps.dependsOn.join(', ') : '(none)';
+    const blocks = deps.blocks.length > 0 ? deps.blocks.join(', ') : '(none)';
+    const lines = [
+        `Task ${section.id}: ${section.heading}`,
+        `← Depends on: ${dependsOn}`,
+        `→ Blocks: ${blocks}`,
+    ];
+    if (section.relatedFiles && section.relatedFiles.length > 0) {
+        const fileList = section.relatedFiles.length <= 2
+            ? section.relatedFiles.join(', ')
+            : `${section.relatedFiles[0]} (+${section.relatedFiles.length - 1} more)`;
+        lines.push(`Files: ${fileList}`);
+    }
+    if (section.verification) {
+        lines.push(`Verify: ${section.verification}`);
+    }
+    const maxLen = Math.max(...lines.map((l) => l.length));
+    const width = Math.min(maxLen + 4, process.stdout.columns || 80);
+    const innerWidth = width - 2;
+    const top = chalk.dim(`┌${'─'.repeat(innerWidth)}┐`);
+    const bottom = chalk.dim(`└${'─'.repeat(innerWidth)}┘`);
+    const content = lines.map((l) => chalk.dim('│') + ' ' + chalk.cyan(l.slice(0, innerWidth - 2).padEnd(innerWidth - 2)) + ' ' + chalk.dim('│'));
+    return [top, ...content, bottom].join('\n');
+}
+export function renderToc(doc) {
+    const parts = [];
+    const commentedIds = new Set(doc.comments.map((c) => c.sectionId));
+    parts.push('');
+    parts.push(chalk.bold.underline(doc.title));
+    parts.push('');
+    if (doc.mode === 'plan') {
+        for (const section of doc.sections) {
+            if (section.level === 2) {
+                parts.push(chalk.bold.yellow(`  ${section.heading}`));
+            }
+            else if (section.level === 3) {
+                const marker = commentedIds.has(section.id) ? chalk.green('✓') : ' ';
+                parts.push(`    ${marker} ${chalk.dim(section.id)}  ${section.heading}`);
+            }
+        }
+    }
+    else {
+        const reviewable = doc.sections.filter((s) => s.level >= 2);
+        for (let i = 0; i < reviewable.length; i++) {
+            const section = reviewable[i];
+            const num = String(i + 1).padStart(2);
+            const marker = commentedIds.has(section.id) ? chalk.green('✓') : ' ';
+            parts.push(`  ${marker} ${chalk.dim(num)}  ${section.heading}`);
+        }
+    }
+    const commentedCount = commentedIds.size;
+    const reviewable = doc.sections.filter((s) => doc.mode === 'plan' ? s.level === 3 : s.level >= 2);
+    const remaining = reviewable.length - commentedCount;
+    parts.push('');
+    parts.push(`  ${chalk.green(`${commentedCount} section${commentedCount !== 1 ? 's' : ''} commented`)}` +
+        `  ${chalk.dim(`${remaining} remaining`)}`);
+    parts.push('');
+    return parts.join('\n');
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+export interface PlanDocument {
+    title: string;
+    metadata: Record<string, string>;
+    mode: 'plan' | 'generic';
+    sections: Section[];
+    comments: ReviewComment[];
+}
+export interface Section {
+    id: string;
+    heading: string;
+    level: number;
+    body: string;
+    parent?: string;
+    dependencies?: {
+        dependsOn: string[];
+        blocks: string[];
+    };
+    relatedFiles?: string[];
+    verification?: string;
+}
+export interface ReviewComment {
+    sectionId: string;
+    text: string;
+    timestamp: Date;
+}
+export type OutputTarget = 'stdout' | 'clipboard' | 'file' | 'claude';
+export type SplitStrategy = 'heading' | 'separator' | 'auto';

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "plan-review",
+  "version": "0.1.0",
+  "description": "Interactive CLI for reviewing AI-generated markdown plans",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "plan-review": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "markdown",
+    "plan",
+    "review",
+    "cli"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.4",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
+  }
+}