openplanr 1.2.7 → 1.2.8

package/dist/services/git-service.js

@@ -0,0 +1,137 @@
+/**
+ * Git integration for `planr revise` (EPIC-003, FEAT-011 + FEAT-013).
+ *
+ * Two responsibilities:
+ *
+ * 1. **Clean-tree gate (FEAT-011 §2.0):** revise refuses to run with a dirty
+ *    working tree by default. Users can override with `--allow-dirty`, but
+ *    post-flight rollback depends on a clean pre-run state, so the gate is
+ *    the load-bearing safety net.
+ *
+ * 2. **Capture + rollback anchor (FEAT-013 §4.0):** before bulk writes,
+ *    revise captures HEAD and the set of touched paths so a post-flight
+ *    graph-integrity failure can restore via `git checkout`.
+ *
+ * All git operations use `execFile` (not shell), matching the pattern in
+ * github-service.ts. If git is not available or the project is not a git
+ * repo, clean-tree checks fail closed (revise refuses to run) unless
+ * --allow-dirty is passed, because without git there is no safety net.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+const GIT_MAX_BUFFER = 10 * 1024 * 1024;
+/**
+ * Inspect the working tree. Never throws — always returns a typed status so
+ * callers can render errors consistently.
+ */
+export async function inspectGitTree(projectDir) {
+    let head;
+    try {
+        const { stdout } = await execFileAsync('git', ['rev-parse', 'HEAD'], {
+            cwd: projectDir,
+            maxBuffer: GIT_MAX_BUFFER,
+        });
+        head = stdout.trim();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (/not a git repository|fatal:.*repository/i.test(message)) {
+            return { kind: 'not-a-repo', reason: message };
+        }
+        if (/ENOENT|git: not found|command not found/i.test(message)) {
+            return { kind: 'git-missing', reason: message };
+        }
+        // Empty repo (no commits yet) also reaches here; treat it as not-a-repo
+        // for clean-tree gating purposes — there is no HEAD to roll back to.
+        if (/unknown revision|does not have any commits/i.test(message)) {
+            return { kind: 'not-a-repo', reason: 'git repository has no commits yet' };
+        }
+        return { kind: 'not-a-repo', reason: message };
+    }
+    const { stdout: porcelain } = await execFileAsync('git', ['status', '--porcelain'], {
+        cwd: projectDir,
+        maxBuffer: GIT_MAX_BUFFER,
+    });
+    if (porcelain.trim().length === 0) {
+        return { kind: 'clean', head };
+    }
+    const changedPaths = porcelain
+        .split('\n')
+        .filter((line) => line.length > 0)
+        .map((line) => line.slice(3).trim());
+    return { kind: 'dirty', head, changedPaths };
+}
+/**
+ * The clean-tree gate: clean → pass; dirty → pass only when --allow-dirty;
+ * missing git / not a repo → fail closed unless --allow-dirty was passed
+ * (because without git there is no post-flight rollback safety net).
+ */
+export async function checkCleanTree(projectDir, options) {
+    const status = await inspectGitTree(projectDir);
+    switch (status.kind) {
+        case 'clean':
+            return {
+                ok: true,
+                status,
+                message: `Working tree is clean at ${status.head.slice(0, 12)}.`,
+            };
+        case 'dirty':
+            if (options.allowDirty) {
+                return {
+                    ok: true,
+                    status,
+                    message: `Working tree has ${status.changedPaths.length} uncommitted change(s); running with --allow-dirty. Post-flight rollback cannot restore these changes.`,
+                };
+            }
+            return {
+                ok: false,
+                status,
+                message: `Working tree has ${status.changedPaths.length} uncommitted change(s). Commit or stash them, or re-run with --allow-dirty (post-flight rollback cannot restore uncommitted work).`,
+            };
+        case 'not-a-repo':
+            if (options.allowDirty) {
+                return {
+                    ok: true,
+                    status,
+                    message: `Not a git repository (${status.reason.trim()}); running with --allow-dirty. Post-flight rollback is disabled.`,
+                };
+            }
+            return {
+                ok: false,
+                status,
+                message: `Not a git repository (${status.reason.trim()}). Revise requires git for its post-flight rollback safety net. Initialize git, or re-run with --allow-dirty to opt out of the safety net.`,
+            };
+        case 'git-missing':
+            if (options.allowDirty) {
+                return {
+                    ok: true,
+                    status,
+                    message: `git CLI not found; running with --allow-dirty. Post-flight rollback is disabled.`,
+                };
+            }
+            return {
+                ok: false,
+                status,
+                message: `git CLI not found on PATH. Revise requires git for its post-flight rollback safety net. Install git, or re-run with --allow-dirty to opt out.`,
+            };
+        default: {
+            const _exhaustive = status;
+            throw new Error(`unhandled GitTreeStatus: ${JSON.stringify(_exhaustive)}`);
+        }
+    }
+}
+/**
+ * Restore a set of paths from HEAD — the primitive FEAT-013's post-flight
+ * rollback invokes when graph integrity breaks after writes. Paths are
+ * relative to `projectDir`. Empty list is a no-op.
+ */
+export async function checkoutPaths(projectDir, relativePaths) {
+    if (relativePaths.length === 0)
+        return;
+    await execFileAsync('git', ['checkout', '--', ...relativePaths], {
+        cwd: projectDir,
+        maxBuffer: GIT_MAX_BUFFER,
+    });
+}
+//# sourceMappingURL=git-service.js.map

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

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

package/dist/services/graph-integrity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Read-only artifact-graph integrity check for `planr revise` post-flight
+ * (EPIC-003, FEAT-013 §3.0).
+ *
+ * Detects broken parent/child links after a revise run so FEAT-013 §4.0 can
+ * trigger automatic rollback if the writes left the tree inconsistent. This
+ * is deliberately narrower than `planr sync`: it does not fix anything, does
+ * not write to the logger, and only looks at the relationships revise might
+ * have perturbed (parent-id frontmatter fields on features, stories, tasks).
+ *
+ * Why a separate module: keeps revise decoupled from the `sync` command's
+ * repair logic, which has different invariants (fixes links, prompts the
+ * user, etc.). The check here is a pure data function.
+ */
+import type { ArtifactType, OpenPlanrConfig } from '../models/types.js';
+export interface GraphIntegrityIssue {
+    childId: string;
+    childType: ArtifactType;
+    childPath: string;
+    parentField: 'epicId' | 'featureId' | 'storyId';
+    parentId: string;
+    reason: 'missing-parent' | 'parent-type-mismatch';
+}
+export interface GraphIntegrityReport {
+    ok: boolean;
+    issues: GraphIntegrityIssue[];
+}
+/**
+ * Walk every feature/story/task and verify its parent-id frontmatter
+ * resolves to an existing parent artifact of the correct type. Missing
+ * parent-id fields are tolerated (some tasks legitimately attach at
+ * feature level, for example) — only *broken* non-empty references are
+ * reported.
+ */
+export declare function checkGraphIntegrity(projectDir: string, config: OpenPlanrConfig): Promise<GraphIntegrityReport>;
+//# sourceMappingURL=graph-integrity.d.ts.map

package/dist/services/graph-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-integrity.d.ts","sourceRoot":"","sources":["../../src/services/graph-integrity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGxE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,YAAY,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAcD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,oBAAoB,CAAC,CA0B/B"}

package/dist/services/graph-integrity.js

@@ -0,0 +1,54 @@
+/**
+ * Read-only artifact-graph integrity check for `planr revise` post-flight
+ * (EPIC-003, FEAT-013 §3.0).
+ *
+ * Detects broken parent/child links after a revise run so FEAT-013 §4.0 can
+ * trigger automatic rollback if the writes left the tree inconsistent. This
+ * is deliberately narrower than `planr sync`: it does not fix anything, does
+ * not write to the logger, and only looks at the relationships revise might
+ * have perturbed (parent-id frontmatter fields on features, stories, tasks).
+ *
+ * Why a separate module: keeps revise decoupled from the `sync` command's
+ * repair logic, which has different invariants (fixes links, prompts the
+ * user, etc.). The check here is a pure data function.
+ */
+import { listArtifacts, readArtifact } from './artifact-service.js';
+const CHECKS = [
+    { childType: 'feature', parentField: 'epicId', parentType: 'epic' },
+    { childType: 'story', parentField: 'featureId', parentType: 'feature' },
+    { childType: 'task', parentField: 'storyId', parentType: 'story' },
+];
+/**
+ * Walk every feature/story/task and verify its parent-id frontmatter
+ * resolves to an existing parent artifact of the correct type. Missing
+ * parent-id fields are tolerated (some tasks legitimately attach at
+ * feature level, for example) — only *broken* non-empty references are
+ * reported.
+ */
+export async function checkGraphIntegrity(projectDir, config) {
+    const issues = [];
+    for (const spec of CHECKS) {
+        const children = await listArtifacts(projectDir, config, spec.childType);
+        for (const childRow of children) {
+            const child = await readArtifact(projectDir, config, spec.childType, childRow.id);
+            if (!child)
+                continue;
+            const parentId = child.data[spec.parentField];
+            if (!parentId)
+                continue; // optional ref — not a broken link
+            const parent = await readArtifact(projectDir, config, spec.parentType, parentId);
+            if (!parent) {
+                issues.push({
+                    childId: childRow.id,
+                    childType: spec.childType,
+                    childPath: child.filePath,
+                    parentField: spec.parentField,
+                    parentId,
+                    reason: 'missing-parent',
+                });
+            }
+        }
+    }
+    return { ok: issues.length === 0, issues };
+}
+//# sourceMappingURL=graph-integrity.js.map

package/dist/services/graph-integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-integrity.js","sourceRoot":"","sources":["../../src/services/graph-integrity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAsBpE,MAAM,MAAM,GAAgB;IAC1B,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE;IACnE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE;IACvE,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE;CACnE,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,MAAuB;IAEvB,MAAM,MAAM,GAA0B,EAAE,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACzE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClF,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAuB,CAAC;YACpE,IAAI,CAAC,QAAQ;gBAAE,SAAS,CAAC,mCAAmC;YAE5D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACjF,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,QAAQ,CAAC,EAAE;oBACpB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,SAAS,EAAE,KAAK,CAAC,QAAQ;oBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,QAAQ;oBACR,MAAM,EAAE,gBAAgB;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC"}

package/dist/services/prompt-service.d.ts

@@ -19,4 +19,22 @@ export declare function promptCheckbox<T extends string>(message: string, choice
 }>): Promise<T[]>;
 /** Prompt the user for comma-separated text values, returned as a trimmed array. */
 export declare function promptMultiText(message: string, hint?: string): Promise<string[]>;
+/** One action the user can take at the diff-preview prompt for a proposed revise. */
+export type ReviseConfirmAction = 'apply' | 'skip' | 'edit-rationale' | 'diff-again' | '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 declare function promptReviseConfirm(artifactId: string): Promise<ReviseConfirmAction>;
+/**
+ * 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 declare function confirmBulkRevise(summary: string): Promise<boolean>;
 //# sourceMappingURL=prompt-service.d.ts.map

package/dist/services/prompt-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-service.d.ts","sourceRoot":"","sources":["../../src/services/prompt-service.ts"],"names":[],"mappings":"AAIA,2GAA2G;AAC3G,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASxF;AAED,wDAAwD;AACxD,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,EACjD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,EAC1C,YAAY,CAAC,EAAE,CAAC,GACf,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,iDAAiD;AACjD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAM1F;AAED,gEAAgE;AAChE,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW1F;AAED,kEAAkE;AAClE,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnE;AAED,uEAAuE;AACvE,wBAAsB,cAAc,CAAC,CAAC,SAAS,MAAM,EACnD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAC5D,OAAO,CAAC,CAAC,EAAE,CAAC,CAOd;AAED,oFAAoF;AACpF,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAavF"}
+{"version":3,"file":"prompt-service.d.ts","sourceRoot":"","sources":["../../src/services/prompt-service.ts"],"names":[],"mappings":"AAIA,2GAA2G;AAC3G,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASxF;AAED,wDAAwD;AACxD,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,EACjD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,EAC1C,YAAY,CAAC,EAAE,CAAC,GACf,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,iDAAiD;AACjD,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAM1F;AAED,gEAAgE;AAChE,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAW1F;AAED,kEAAkE;AAClE,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnE;AAED,uEAAuE;AACvE,wBAAsB,cAAc,CAAC,CAAC,SAAS,MAAM,EACnD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAC5D,OAAO,CAAC,CAAC,EAAE,CAAC,CAOd;AAED,oFAAoF;AACpF,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAavF;AAMD,qFAAqF;AACrF,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,MAAM,GAAG,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;AAU9F;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAU1F;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAczE"}

package/dist/services/prompt-service.js

@@ -70,4 +70,51 @@ 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',
+    });
+}
+/**
+ * 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-cache-service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Content-hash run cache for `planr revise` (EPIC-003, FEAT-014 §2.0).
+ *
+ * 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` (EPIC-003, FEAT-014 §2.0).
+ *
+ * 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":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAc5D,MAAM,KAAK,GAAgB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAE3C,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,MAAM,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QACvD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAAkB,EAAE,KAAkB;IACpE,MAAM,eAAe,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,mBAAmB,CAAC,SAAkB;IACpD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAkB,EAClB,UAAkB,EAClB,YAAoB,EACpB,YAAgC;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC,YAAY,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,KAAK,CAAC,YAAY,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IACtD,oEAAoE;IACpE,OAAO,KAAK,CAAC,WAAW,KAAK,kBAAkB,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAkB,EAClB,UAAkB,EAClB,YAAoB,EACpB,YAAgC,EAChC,OAAwC;IAExC,OAAO;QACL,OAAO,EAAE;YACP,GAAG,KAAK,CAAC,OAAO;YAChB,CAAC,UAAU,CAAC,EAAE;gBACZ,YAAY;gBACZ,YAAY;gBACZ,WAAW,EAAE,OAAO;gBACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,108 @@
+/**
+ * `planr revise` — core service (EPIC-003, FEAT-010 + FEAT-011).
+ *
+ * Exposes composable primitives; the CLI and future cascade service
+ * orchestrate them. Phase 1 (FEAT-010) ships `reviseArtifact` for dry-run
+ * decision generation; Phase 2 (FEAT-011) adds `applyDecision` for the
+ * write path and exposes the verifier context so callers can run
+ * `verifyDecision` against the same inputs the agent saw.
+ */
+import { type RevisePromptArtifact, type ReviseWritableScope } from '../ai/prompts/prompt-builder.js';
+import { type AIProvider, type AIUsage } from '../ai/types.js';
+import type { ArtifactType, OpenPlanrConfig, ReviseAuditEntry, ReviseDecision } from '../models/types.js';
+import type { AuditLogWriter } from './audit-log-service.js';
+import type { EvidenceVerifierContext } from './evidence-verifier.js';
+export interface ReviseArtifactOptions {
+    /** Must be `true` in Phase 1; reserved for future write path (FEAT-011). */
+    dryRun: true;
+    /** Which parts of the artifact the agent may modify. Default: 'all'. */
+    writableScope?: ReviseWritableScope;
+    /** Skip codebase context assembly (fast mode). Default: include code. */
+    noCodeContext?: boolean;
+    /** Skip immediate-sibling context gathering (fast mode / first-pass). Default: include. */
+    noSiblingContext?: boolean;
+    /** Maximum number of sibling artifacts to inject (budget guard). Default: 8. */
+    maxSiblings?: number;
+}
+export interface ReviseArtifactContextStats {
+    parentsLoaded: number;
+    siblingsLoaded: number;
+    codebaseContextIncluded: boolean;
+    sourcesLoaded: number;
+}
+export interface ReviseArtifactResult {
+    decision: ReviseDecision;
+    usage: AIUsage;
+    contextStats: ReviseArtifactContextStats;
+    /** Filesystem path the decision's revisedMarkdown would be written to. */
+    artifactPath: string;
+    /** Pre-revise raw content, used for diff rendering and auditing. */
+    originalContent: string;
+    /** Context the caller should pass to `verifyDecision`. */
+    verifierContext: EvidenceVerifierContext;
+}
+/**
+ * Error thrown when an artifact id cannot be resolved to an artifact type or
+ * the artifact file does not exist on disk.
+ */
+export declare class ReviseArtifactNotFoundError extends Error {
+    readonly artifactId: string;
+    constructor(artifactId: string, message: string);
+}
+/**
+ * Revise a single artifact — Phase 1 dry-run.
+ *
+ * Does NOT write any files. The returned decision is the agent output after
+ * schema validation; evidence verification, diff preview, and write are all
+ * Phase 2 responsibilities (FEAT-011). Cascade, siblings, and declared
+ * sources are Phase 3 (FEAT-012) and onwards.
+ */
+export declare function reviseArtifact(projectDir: string, config: OpenPlanrConfig, provider: AIProvider, artifactId: string, options: ReviseArtifactOptions): Promise<ReviseArtifactResult>;
+export interface ApplyDecisionOptions {
+    artifactPath: string;
+    originalContent: string;
+    decision: ReviseDecision;
+    /**
+     * Directory where sidecar backups are written. Typically
+     * `.planr/reports/revise-<scope>-<date>/backup/` — set by the CLI.
+     */
+    backupDir: string;
+    /** Audit writer that will persist an entry describing the outcome. */
+    audit: AuditLogWriter;
+    /** When true, produces an audit entry but does not write the artifact. */
+    dryRun: boolean;
+    /** Cascade level tag for audit log grouping; omit for single-artifact runs. */
+    cascadeLevel?: ReviseAuditEntry['cascadeLevel'];
+}
+export interface ApplyDecisionResult {
+    outcome: ReviseAuditEntry['outcome'];
+    wrote: boolean;
+    diff: string;
+}
+/**
+ * Apply a (verified) decision: write the artifact atomically when
+ * `action === 'revise'` and `dryRun` is false, emit an audit entry
+ * describing the outcome either way.
+ *
+ * Caller is expected to have already run `verifyDecision` — `applyDecision`
+ * trusts that whatever decision arrives is allowed to be written.
+ */
+export declare function applyDecision(options: ApplyDecisionOptions): Promise<ApplyDecisionResult>;
+/**
+ * Load immediate-sibling artifacts (same artifact type, same parent) as
+ * prompt entries. Lazy-reads each sibling's body only if it's going to be
+ * included — the listing check is cheap, the reads are budgeted by
+ * `maxSiblings` (default 8) so the prompt stays within token budget even on
+ * epics with many features.
+ *
+ * For epic scope, there are no siblings (epics live at the top). For types
+ * without a parent-id relationship (quick, backlog, etc.), returns empty.
+ */
+export declare function loadSiblingPromptArtifacts(projectDir: string, config: OpenPlanrConfig, type: ArtifactType, id: string, maxSiblings: number): Promise<RevisePromptArtifact[]>;
+/**
+ * Resolve the parent chain for an artifact and return it as the ordered
+ * `RevisePromptArtifact[]` the prompt builder expects (epic → feature →
+ * story). Empty array for top-level artifacts (epic scope).
+ */
+export declare function loadParentPromptArtifacts(projectDir: string, config: OpenPlanrConfig, type: ArtifactType, id: string): Promise<RevisePromptArtifact[]>;
+//# sourceMappingURL=revise-service.d.ts.map

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

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