openplanr 1.2.7 → 1.3.0

package/dist/services/prompt-service.js

@@ -1,6 +1,7 @@
 import { checkbox, confirm, editor, input, password, select } from '@inquirer/prompts';
 import { logger } from '../utils/logger.js';
 import { isNonInteractive } from './interactive-state.js';
+import { getTeamProjects } from './linear-service.js';
 /** Prompt the user for a single line of text input. Falls back to defaultValue in non-interactive mode. */
 export async function promptText(message, defaultValue) {
     if (isNonInteractive()) {
@@ -70,4 +71,114 @@ export async function promptMultiText(message, hint) {
         .map((s) => s.trim())
         .filter(Boolean);
 }
+const REVISE_CONFIRM_CHOICES = [
+    { name: '[a] Apply — write this revision to disk', value: 'apply' },
+    { name: '[s] Skip — do not write; cascade continues', value: 'skip' },
+    { name: '[e] Edit rationale — record a human reason for this decision', value: 'edit-rationale' },
+    { name: '[d] Diff again — re-print the diff', value: 'diff-again' },
+    { name: '[q] Quit — stop cascade; already-applied artifacts remain applied', value: 'quit' },
+];
+/**
+ * Prompt the user for the per-artifact revise confirmation menu. In
+ * non-interactive mode, returns `apply` by default (caller should only
+ * enter this path after the typed-YES gate in `confirmBulkRevise`).
+ */
+export async function promptReviseConfirm(artifactId) {
+    if (isNonInteractive()) {
+        logger.dim(`  [auto] Revise ${artifactId} → apply`);
+        return 'apply';
+    }
+    return select({
+        message: `Revise ${artifactId}:`,
+        choices: REVISE_CONFIRM_CHOICES,
+        default: 'apply',
+    });
+}
+// ---------------------------------------------------------------------------
+// Linear integration prompts
+// ---------------------------------------------------------------------------
+/**
+ * First-time epic-push: offer the three mapping strategies and (for
+ * `milestone-of` / `label-on`) let the user pick an existing Linear project
+ * to attach into. Pure UI + one read-only SDK call (`getTeamProjects`).
+ */
+export async function promptMappingStrategy(client, teamId, epicId) {
+    if (isNonInteractive())
+        return null;
+    const strategy = await select({
+        message: `How should ${epicId} map to Linear?`,
+        choices: [
+            {
+                name: '[a] Create a new Linear project (recommended — Epic = Project, v1 behavior)',
+                value: 'project',
+            },
+            { name: '[b] Attach as a milestone of an existing Linear project', value: 'milestone-of' },
+            { name: '[c] Attach as a label on an existing Linear project', value: 'label-on' },
+        ],
+        default: 'project',
+    });
+    if (strategy === 'project') {
+        return { strategy };
+    }
+    const projects = await getTeamProjects(client, teamId);
+    if (projects.length === 0) {
+        logger.warn('This team has no Linear projects yet — falling back to creating a new one (strategy: project).');
+        return { strategy: 'project' };
+    }
+    const targetProjectId = await select({
+        message: `Pick the target Linear project for ${epicId}:`,
+        choices: projects.map((p) => ({ name: `${p.name}  (${p.url})`, value: p.id })),
+    });
+    return { strategy, targetProjectId };
+}
+/**
+ * First-time QT / BL push: let the user pick the Linear project that will
+ * host `QT-*` and `BL-*` issues (stored in `linear.standaloneProjectId`).
+ */
+export async function promptStandaloneProject(client, teamId) {
+    if (isNonInteractive())
+        return null;
+    const projects = await getTeamProjects(client, teamId);
+    if (projects.length === 0) {
+        logger.warn('This team has no Linear projects yet — create one in Linear first, then re-run the push.');
+        return null;
+    }
+    const choice = await select({
+        message: 'Pick the Linear project that will host Planr quick tasks & backlog items:',
+        choices: [
+            ...projects.map((p) => ({ name: `${p.name}  (${p.url})`, value: p.id })),
+            { name: '[cancel]', value: '__cancel__' },
+        ],
+    });
+    if (choice === '__cancel__')
+        return null;
+    const picked = projects.find((p) => p.id === choice);
+    if (!picked)
+        return null;
+    return { projectId: picked.id, projectName: picked.name };
+}
+/**
+ * Typed-YES confirmation gate for `--yes` bulk-apply runs.
+ *
+ * In an interactive TTY, prints the provided summary and blocks on the user
+ * typing "YES" (case-sensitive) to proceed. In non-TTY environments
+ * (piped stdout, CI), returns `true` unconditionally — the `--yes` flag
+ * alone is the contract with the pipeline, and PR review is the upstream
+ * human gate. Returns `false` if the user types anything other than "YES".
+ */
+export async function confirmBulkRevise(summary) {
+    // Non-TTY: the flag is sufficient. Humans can't type at pipelines.
+    if (!process.stdout.isTTY) {
+        logger.dim('Non-interactive environment detected — --yes flag accepted without typed-YES.');
+        return true;
+    }
+    if (isNonInteractive()) {
+        // Explicit --no-interactive / -y also skips the typed-YES.
+        logger.dim('Non-interactive mode — --yes flag accepted without typed-YES.');
+        return true;
+    }
+    logger.info(summary);
+    const typed = await input({ message: 'Type YES to continue:' });
+    return typed === 'YES';
+}
 //# sourceMappingURL=prompt-service.js.map

package/dist/services/prompt-service.js.map

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

package/dist/services/revise-apply-service.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Replay a previously-written revise audit to disk without any model calls.
+ *
+ * Implements after `planr revise --dry-run` produces an audit log
+ * with the proposed diffs, `planr revise --apply-from <audit>` reads those
+ * diffs and writes them to the corresponding artifacts. Zero tokens spent
+ * in this mode.
+ *
+ * Pipeline:
+ *   1. Clean-tree gate (same as normal revise)
+ *   2. Parse the audit (via `revise-plan-service`) → list of replayable entries
+ *   3. Filter to `would-apply` entries that have a diff + artifact path
+ *   4. Per entry:
+ *      a. Read current artifact content
+ *      b. Apply the stored diff; if the diff doesn't land cleanly (the
+ *         source has drifted since the dry-run), skip the entry and
+ *         record the skip reason in the new audit
+ *      c. Atomic write with sidecar backup
+ *      d. Append an `applied-from-plan` entry to the new audit log
+ *   5. Post-flight graph-integrity check + git rollback on break
+ *
+ * Safety gates preserved vs. normal apply:
+ * - Clean-tree gate ✓
+ * - Atomic writes (temp file + rename) ✓
+ * - Post-flight graph integrity + git rollback ✓
+ * - Per-artifact confirmation (prompt unless `--yes`) ✓
+ *
+ * Note: sidecar `.bak` files are deliberately NOT written on this path.
+ * Rollback already flows through git (clean-tree gate guarantees HEAD is a
+ * valid restore point), so per-file backups would be redundant noise in
+ * `.planr/reports/`. The atomic-write guarantee covers partial-write
+ * crashes; git covers "I wish I hadn't applied that."
+ *
+ * Deliberately NOT run on replay:
+ * - AI model calls (the point of this feature)
+ * - Evidence verification (the dry-run already verified; nothing changes
+ *   between dry-run and apply that evidence verification would catch that
+ *   the diff-apply staleness check doesn't already catch)
+ * - `--cascade` / `--all` orchestration (the audit already encodes the
+ *   cascade order as entry order)
+ */
+import type { OpenPlanrConfig } from '../models/types.js';
+export interface ApplyFromAuditOptions {
+    projectDir: string;
+    config: OpenPlanrConfig;
+    auditPath: string;
+    allowDirty: boolean;
+    /** Print the plan without writing — useful to confirm what would replay. */
+    dryRun: boolean;
+    /** Skip per-artifact confirmation; still requires typed-YES in an interactive TTY. */
+    yes: boolean;
+}
+/** Returns the process exit code. 0 on success, 1 on fatal error, non-zero on partial/rollback. */
+export declare function runApplyFromAudit(opts: ApplyFromAuditOptions): Promise<number>;
+//# sourceMappingURL=revise-apply-service.d.ts.map

package/dist/services/revise-apply-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revise-apply-service.d.ts","sourceRoot":"","sources":["../../src/services/revise-apply-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,oBAAoB,CAAC;AAW5E,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAC;IAChB,sFAAsF;IACtF,GAAG,EAAE,OAAO,CAAC;CACd;AAED,mGAAmG;AACnG,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyMpF"}

package/dist/services/revise-apply-service.js

@@ -0,0 +1,255 @@
+/**
+ * Replay a previously-written revise audit to disk without any model calls.
+ *
+ * Implements after `planr revise --dry-run` produces an audit log
+ * with the proposed diffs, `planr revise --apply-from <audit>` reads those
+ * diffs and writes them to the corresponding artifacts. Zero tokens spent
+ * in this mode.
+ *
+ * Pipeline:
+ *   1. Clean-tree gate (same as normal revise)
+ *   2. Parse the audit (via `revise-plan-service`) → list of replayable entries
+ *   3. Filter to `would-apply` entries that have a diff + artifact path
+ *   4. Per entry:
+ *      a. Read current artifact content
+ *      b. Apply the stored diff; if the diff doesn't land cleanly (the
+ *         source has drifted since the dry-run), skip the entry and
+ *         record the skip reason in the new audit
+ *      c. Atomic write with sidecar backup
+ *      d. Append an `applied-from-plan` entry to the new audit log
+ *   5. Post-flight graph-integrity check + git rollback on break
+ *
+ * Safety gates preserved vs. normal apply:
+ * - Clean-tree gate ✓
+ * - Atomic writes (temp file + rename) ✓
+ * - Post-flight graph integrity + git rollback ✓
+ * - Per-artifact confirmation (prompt unless `--yes`) ✓
+ *
+ * Note: sidecar `.bak` files are deliberately NOT written on this path.
+ * Rollback already flows through git (clean-tree gate guarantees HEAD is a
+ * valid restore point), so per-file backups would be redundant noise in
+ * `.planr/reports/`. The atomic-write guarantee covers partial-write
+ * crashes; git covers "I wish I hadn't applied that."
+ *
+ * Deliberately NOT run on replay:
+ * - AI model calls (the point of this feature)
+ * - Evidence verification (the dry-run already verified; nothing changes
+ *   between dry-run and apply that evidence verification would catch that
+ *   the diff-apply staleness check doesn't already catch)
+ * - `--cascade` / `--all` orchestration (the audit already encodes the
+ *   cascade order as entry order)
+ */
+import path from 'node:path';
+import chalk from 'chalk';
+import { applyUnifiedDiff } from '../utils/diff.js';
+import { readFile } from '../utils/fs.js';
+import { display, logger } from '../utils/logger.js';
+import { atomicWriteFile } from './atomic-write-service.js';
+import { createAuditLogWriter } from './audit-log-service.js';
+import { checkCleanTree, checkoutPaths } from './git-service.js';
+import { checkGraphIntegrity } from './graph-integrity.js';
+import { confirmBulkRevise, promptReviseConfirm } from './prompt-service.js';
+import { filterReplayable, readPlanFromAudit } from './revise-plan-service.js';
+/** Returns the process exit code. 0 on success, 1 on fatal error, non-zero on partial/rollback. */
+export async function runApplyFromAudit(opts) {
+    const { projectDir, config, auditPath, allowDirty, dryRun, yes } = opts;
+    logger.heading(`Apply revise plan from ${path.basename(auditPath)}${dryRun ? ' (dry-run)' : ''}`);
+    logger.dim('Mode: replay — zero AI tokens will be spent.');
+    // --- Layer 1: clean-tree gate -------------------------------------------
+    const treeCheck = await checkCleanTree(projectDir, { allowDirty });
+    if (!treeCheck.ok) {
+        logger.error(treeCheck.message);
+        return 1;
+    }
+    if (treeCheck.status.kind !== 'clean') {
+        logger.warn(treeCheck.message);
+    }
+    // --- Layer 2: parse the audit -------------------------------------------
+    let plan;
+    try {
+        plan = readPlanFromAudit(auditPath);
+    }
+    catch (err) {
+        logger.error(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+    const replayable = filterReplayable(plan);
+    logger.info(`Parsed ${plan.entries.length} audit entries (${replayable.length} replayable, ${plan.entries.length - replayable.length} skipped/flagged without diff).`);
+    if (replayable.length === 0) {
+        logger.warn('No replayable entries (would-apply + diff + artifact path). Nothing to do.');
+        return 0;
+    }
+    // --- Bulk confirmation: typed-YES for TTY, flag-only for CI -------------
+    if (yes && !dryRun) {
+        const summary = buildReplaySummary(auditPath, replayable);
+        const confirmed = await confirmBulkRevise(summary);
+        if (!confirmed) {
+            logger.dim('Confirmation declined — exiting without changes.');
+            return 0;
+        }
+    }
+    // --- New audit log for the apply-from-plan run --------------------------
+    const writer = createAuditLogWriter({
+        projectDir,
+        scope: `${plan.scope}-applied`,
+        cascade: false,
+        dryRun,
+        format: 'md',
+    });
+    logger.dim(`Apply audit log: ${writer.path}`);
+    // --- Per-entry replay ---------------------------------------------------
+    const affectedPaths = [];
+    let applied = 0;
+    let stale = 0;
+    let conflicts = 0;
+    let skipped = 0;
+    let userQuit = false;
+    for (let i = 0; i < replayable.length; i++) {
+        if (userQuit)
+            break;
+        const entry = replayable[i];
+        const progress = `[${i + 1}/${replayable.length}] ${entry.artifactId}`;
+        if (!entry.artifactPath) {
+            skipped++;
+            recordSkip(writer, entry, 'stale-skipped', 'no artifact path recorded in plan');
+            continue;
+        }
+        let currentContent;
+        try {
+            currentContent = await readFile(entry.artifactPath);
+        }
+        catch (err) {
+            stale++;
+            recordSkip(writer, entry, 'stale-skipped', `cannot read artifact: ${err instanceof Error ? err.message : String(err)}`);
+            logger.warn(`${progress}: stale — artifact not readable.`);
+            continue;
+        }
+        const patch = applyUnifiedDiff(currentContent, entry.diff ?? '');
+        if (!patch.ok) {
+            conflicts++;
+            recordSkip(writer, entry, 'conflict-skipped', patch.error ?? 'diff did not apply cleanly');
+            logger.warn(`${progress}: conflict — ${patch.error}`);
+            continue;
+        }
+        // Per-artifact confirmation (skipped when --yes or --dry-run).
+        if (!dryRun && !yes) {
+            display.separator(60);
+            display.heading(`  ${progress}: ${chalk.yellow('REPLAY REVISE')}`);
+            display.line(`  Artifact: ${entry.artifactId}`);
+            display.line(`  Rationale: ${entry.rationale}`);
+            display.line('');
+            display.line('  Diff:');
+            const diffPreview = (entry.diff ?? '')
+                .split('\n')
+                .map((l) => `    ${colorizeDiffLine(l)}`)
+                .join('\n');
+            display.line(diffPreview);
+            display.separator(60);
+            const action = await promptReviseConfirm(entry.artifactId);
+            if (action === 'skip') {
+                skipped++;
+                recordSkip(writer, entry, 'skipped-by-user', 'user declined at replay prompt');
+                logger.dim(`${progress}: skipped by user.`);
+                continue;
+            }
+            if (action === 'quit') {
+                recordSkip(writer, entry, 'skipped-by-user', 'user quit replay at this entry');
+                userQuit = true;
+                break;
+            }
+            // For 'diff-again' we just continue; the diff was already shown. For
+            // 'edit-rationale' we accept as-is (replay doesn't let you edit).
+        }
+        if (dryRun) {
+            writer.appendEntry({
+                ...entry,
+                outcome: 'would-apply',
+                timestamp: new Date().toISOString(),
+            });
+            applied++;
+            logger.info(`${progress}: would apply (dry-run).`);
+            continue;
+        }
+        // Atomic write (temp file + rename). No sidecar backup — git covers
+        // rollback via the clean-tree gate + post-flight checkout.
+        try {
+            await atomicWriteFile(entry.artifactPath, patch.result ?? '');
+            affectedPaths.push(path.relative(projectDir, entry.artifactPath) || entry.artifactPath);
+            applied++;
+            writer.appendEntry({
+                ...entry,
+                outcome: 'applied-from-plan',
+                timestamp: new Date().toISOString(),
+            });
+            logger.info(`${progress}: ${chalk.green('applied')}.`);
+        }
+        catch (err) {
+            conflicts++;
+            recordSkip(writer, entry, 'conflict-skipped', `write failed: ${err instanceof Error ? err.message : String(err)}`);
+            logger.error(`${progress}: write failed — ${err}`);
+        }
+    }
+    // --- Post-flight graph integrity + rollback -----------------------------
+    let exitCode = 0;
+    if (!dryRun && affectedPaths.length > 0) {
+        const integrity = await checkGraphIntegrity(projectDir, config);
+        if (!integrity.ok) {
+            logger.error(`Post-flight graph integrity broken: ${integrity.issues.length} issue(s). Rolling back…`);
+            if (treeCheck.status.kind === 'clean') {
+                await checkoutPaths(projectDir, affectedPaths);
+                logger.info(`Rolled back ${affectedPaths.length} artifact path(s) to HEAD.`);
+            }
+            else {
+                logger.warn('Cannot rollback — pre-run tree was dirty. Inspect changes manually.');
+            }
+            exitCode = 1;
+        }
+        else {
+            logger.dim('Post-flight graph integrity: ok.');
+        }
+    }
+    writer.close();
+    // --- Summary ------------------------------------------------------------
+    display.separator(60);
+    display.heading('  Replay summary');
+    display.line(`  Applied:          ${chalk.green(String(applied))}`);
+    display.line(`  Stale-skipped:    ${stale}  (artifact missing or unreadable)`);
+    display.line(`  Conflict-skipped: ${conflicts}  (diff did not apply cleanly)`);
+    display.line(`  User-skipped:     ${skipped}`);
+    display.line(`  ${chalk.bold('AI tokens spent:  0')}  (replay mode — zero model calls)`);
+    if (!dryRun && applied > 0 && exitCode === 0) {
+        display.line('');
+        display.line(`  Suggested commit: ${chalk.cyan(`git commit -am "chore(plan): apply revise plan ${plan.scope}"`)}`);
+    }
+    display.separator(60);
+    return exitCode;
+}
+function recordSkip(writer, entry, outcome, reason) {
+    writer.appendEntry({
+        ...entry,
+        outcome,
+        error: reason,
+        timestamp: new Date().toISOString(),
+    });
+}
+function buildReplaySummary(auditPath, entries) {
+    const head = `About to replay ${entries.length} revise entries from ${path.basename(auditPath)}.`;
+    const sample = entries
+        .slice(0, 8)
+        .map((e) => `  - ${e.artifactId} (${e.outcome} → applied-from-plan)`)
+        .join('\n');
+    const tail = entries.length > 8 ? `\n  … and ${entries.length - 8} more` : '';
+    return `${head}\nZero model calls will be made.\n${sample}${tail}`;
+}
+function colorizeDiffLine(line) {
+    if (line.startsWith('+++') || line.startsWith('---'))
+        return chalk.bold(line);
+    if (line.startsWith('@@'))
+        return chalk.cyan(line);
+    if (line.startsWith('+'))
+        return chalk.green(line);
+    if (line.startsWith('-'))
+        return chalk.red(line);
+    return chalk.dim(line);
+}
+//# sourceMappingURL=revise-apply-service.js.map

package/dist/services/revise-apply-service.js.map

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

package/dist/services/revise-cache-service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Content-hash run cache for `planr revise`.
+ *
+ * Between runs, we hash each artifact's raw content (+ the codebase-digest
+ * input, when present) and skip artifacts whose hash matches the last
+ * successful revise of that artifact with the same codebase state. Keeps
+ * `--all` cheap to re-run on an untouched repo (a common check-before-PR
+ * workflow) without sacrificing correctness: any edit to the artifact or
+ * the codebase invalidates the cache entry automatically.
+ *
+ * Persisted at `.planr/reports/.revise-cache.json`. JSON was chosen over
+ * a line-oriented format because the cache is small (one entry per
+ * artifact) and atomic updates via atomicWriteFile are simpler with JSON.
+ *
+ * Cache semantics are best-effort: if the cache file is missing or
+ * malformed, reads return empty (never throw). Writes are fire-and-forget.
+ */
+export interface ReviseCacheEntry {
+    artifactHash: string;
+    /** Digest over codebase-context-relevant state (folder tree, architecture files) — optional. */
+    codebaseHash?: string;
+    lastOutcome: 'skipped-by-agent' | 'applied' | 'would-apply' | 'flagged';
+    lastRunAt: string;
+}
+export interface ReviseCache {
+    entries: Record<string, ReviseCacheEntry>;
+}
+export declare function defaultCachePath(projectDir: string): string;
+export declare function loadCache(projectDir: string): ReviseCache;
+export declare function saveCache(projectDir: string, cache: ReviseCache): Promise<void>;
+/** SHA-256 of the artifact raw content (body + frontmatter) used as cache key. */
+export declare function hashArtifactContent(raw: string): string;
+/** Optional SHA-256 over the codebase context string, so code changes invalidate cache. */
+export declare function hashCodebaseContext(formatted?: string): string | undefined;
+/**
+ * Returns true when the given artifact + codebase hash matches the cache
+ * entry from a prior successful revise — caller may skip the AI call.
+ * A mismatch on either dimension invalidates the entry.
+ */
+export declare function shouldSkipArtifact(cache: ReviseCache, artifactId: string, artifactHash: string, codebaseHash: string | undefined): boolean;
+/**
+ * Record an outcome in the cache. Returns a new cache object (pure) so
+ * callers can decide when to flush.
+ */
+export declare function recordOutcome(cache: ReviseCache, artifactId: string, artifactHash: string, codebaseHash: string | undefined, outcome: ReviseCacheEntry['lastOutcome']): ReviseCache;
+//# sourceMappingURL=revise-cache-service.d.ts.map

package/dist/services/revise-cache-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revise-cache-service.d.ts","sourceRoot":"","sources":["../../src/services/revise-cache-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;IACxE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3C;AAID,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAazD;AAED,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAOT;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,gBAAgB,CAAC,aAAa,CAAC,GACvC,WAAW,CAYb"}

package/dist/services/revise-cache-service.js

@@ -0,0 +1,88 @@
+/**
+ * Content-hash run cache for `planr revise`.
+ *
+ * Between runs, we hash each artifact's raw content (+ the codebase-digest
+ * input, when present) and skip artifacts whose hash matches the last
+ * successful revise of that artifact with the same codebase state. Keeps
+ * `--all` cheap to re-run on an untouched repo (a common check-before-PR
+ * workflow) without sacrificing correctness: any edit to the artifact or
+ * the codebase invalidates the cache entry automatically.
+ *
+ * Persisted at `.planr/reports/.revise-cache.json`. JSON was chosen over
+ * a line-oriented format because the cache is small (one entry per
+ * artifact) and atomic updates via atomicWriteFile are simpler with JSON.
+ *
+ * Cache semantics are best-effort: if the cache file is missing or
+ * malformed, reads return empty (never throw). Writes are fire-and-forget.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { atomicWriteFile } from './atomic-write-service.js';
+const EMPTY = { entries: {} };
+export function defaultCachePath(projectDir) {
+    return path.join(projectDir, '.planr', 'reports', '.revise-cache.json');
+}
+export function loadCache(projectDir) {
+    const p = defaultCachePath(projectDir);
+    if (!existsSync(p))
+        return { entries: {} };
+    try {
+        const raw = readFileSync(p, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === 'object' && parsed.entries) {
+            return { entries: parsed.entries };
+        }
+        return EMPTY;
+    }
+    catch {
+        return EMPTY;
+    }
+}
+export async function saveCache(projectDir, cache) {
+    await atomicWriteFile(defaultCachePath(projectDir), JSON.stringify(cache, null, 2));
+}
+/** SHA-256 of the artifact raw content (body + frontmatter) used as cache key. */
+export function hashArtifactContent(raw) {
+    return createHash('sha256').update(raw).digest('hex');
+}
+/** Optional SHA-256 over the codebase context string, so code changes invalidate cache. */
+export function hashCodebaseContext(formatted) {
+    if (!formatted)
+        return undefined;
+    return createHash('sha256').update(formatted).digest('hex');
+}
+/**
+ * Returns true when the given artifact + codebase hash matches the cache
+ * entry from a prior successful revise — caller may skip the AI call.
+ * A mismatch on either dimension invalidates the entry.
+ */
+export function shouldSkipArtifact(cache, artifactId, artifactHash, codebaseHash) {
+    const entry = cache.entries[artifactId];
+    if (!entry)
+        return false;
+    if (entry.artifactHash !== artifactHash)
+        return false;
+    if (entry.codebaseHash !== codebaseHash)
+        return false;
+    // Only cache-skip when the prior outcome indicated "nothing to do".
+    return entry.lastOutcome === 'skipped-by-agent';
+}
+/**
+ * Record an outcome in the cache. Returns a new cache object (pure) so
+ * callers can decide when to flush.
+ */
+export function recordOutcome(cache, artifactId, artifactHash, codebaseHash, outcome) {
+    return {
+        entries: {
+            ...cache.entries,
+            [artifactId]: {
+                artifactHash,
+                codebaseHash,
+                lastOutcome: outcome,
+                lastRunAt: new Date().toISOString(),
+            },
+        },
+    };
+}
+//# sourceMappingURL=revise-cache-service.js.map

package/dist/services/revise-cache-service.js.map

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