openplanr 1.2.6 → 1.2.8

package/dist/services/evidence-service.js

@@ -0,0 +1,85 @@
+/**
+ * Evidence linking and validation for stakeholder reports.
+ */
+import { validateRepoAccessible } from './github-service.js';
+const URL_RE = /https?:\/\/[^\s)]+/g;
+const ISSUE_RE = /(?:#|GH-)\d+/gi;
+export function countEvidenceAnchors(markdown) {
+    const urls = markdown.match(URL_RE) ?? [];
+    const issues = markdown.match(ISSUE_RE) ?? [];
+    return urls.length + issues.length;
+}
+function shouldSkipStrictEvidenceSection(heading) {
+    return /^\s*evidence\b/i.test(heading);
+}
+/** Template placeholder bullets (italic instructions) are not treated as factual claims. */
+function isPlaceholderClaimBullet(line) {
+    const m = line.match(/^\s*[-*]\s+(.+)$/);
+    if (!m)
+        return false;
+    const t = m[1].trim();
+    return /^_.+_$/s.test(t);
+}
+export function validateClaimsHaveAnchors(markdown, minAnchors, options) {
+    void options?.reportType;
+    const sections = markdown.split(/^## /m).slice(1);
+    const results = [];
+    let idx = 0;
+    for (const chunk of sections) {
+        idx += 1;
+        const lines = chunk.split('\n');
+        const heading = lines[0]?.trim() ?? `section-${idx}`;
+        if (shouldSkipStrictEvidenceSection(heading)) {
+            continue;
+        }
+        const body = lines.slice(1).join('\n');
+        const bullets = body.split('\n').filter((l) => /^\s*[-*]\s+/.test(l));
+        for (let j = 0; j < bullets.length; j += 1) {
+            const line = bullets[j];
+            if (isPlaceholderClaimBullet(line)) {
+                continue;
+            }
+            const n = countEvidenceAnchors(line);
+            const claimId = `${heading}:${j}`;
+            if (n < minAnchors) {
+                results.push({
+                    claimId,
+                    ok: false,
+                    missingReason: 'No link or issue reference found for this bullet; add a PR URL, commit, or #issue.',
+                });
+            }
+            else {
+                results.push({ claimId, ok: true });
+            }
+        }
+    }
+    return results;
+}
+export async function validateRemoteEvidence(items) {
+    const repo = await validateRepoAccessible();
+    const inaccessible = [];
+    for (const it of items) {
+        if (!it.url)
+            continue;
+        try {
+            const u = new URL(it.url);
+            if (u.hostname !== 'github.com')
+                continue;
+            // Lightweight check only — full HTTP HEAD would add dependency noise
+            if (!repo.ok)
+                inaccessible.push(it);
+        }
+        catch {
+            inaccessible.push(it);
+        }
+    }
+    return { inaccessible, repoOk: repo.ok, repoMessage: repo.message };
+}
+export function summarizeEvidenceItem(item) {
+    return {
+        evidenceId: item.id,
+        title: item.label,
+        body: [item.detail, item.url].filter(Boolean).join('\n'),
+    };
+}
+//# sourceMappingURL=evidence-service.js.map

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

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

package/dist/services/evidence-verifier.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Post-flight evidence verification for `planr revise` (EPIC-003, FEAT-011).
+ *
+ * The revise agent emits a ReviseDecision with typed evidence citations. Before
+ * the user ever sees a diff, this verifier checks each citation against the
+ * real repo:
+ *
+ * - `file_exists` / `file_absent` — fs.stat on the ref path
+ * - `grep_match`                   — literal check inside the codebase context
+ *                                    the agent was given; rejects claims the
+ *                                    agent could not have seen
+ * - `sibling_artifact`             — artifact id must exist on disk
+ * - `source_quote`                 — source path must exist on disk (quote
+ *                                    fuzzy-match is best-effort)
+ * - `pattern_rule`                 — rule id must be in the detected pattern
+ *                                    rules for this run
+ *
+ * Unverifiable evidence is dropped with a reason. If a `revise` action has no
+ * surviving evidence after the sweep, the decision is demoted to `flag` with
+ * an explicit ambiguity entry — the agent's judgment wasn't necessarily wrong,
+ * but its *proof* can't be trusted, so a human owns the call.
+ */
+import type { OpenPlanrConfig, ReviseDecision, ReviseEvidence } from '../models/types.js';
+/**
+ * Run-time context the verifier needs. Callers should populate this from the
+ * same inputs used to build the revise prompt, so the verifier checks evidence
+ * against exactly the material the agent had access to.
+ */
+export interface EvidenceVerifierContext {
+    projectDir: string;
+    config: OpenPlanrConfig;
+    /**
+     * Directory of the artifact being verified. Used to resolve relative
+     * evidence refs like `../features/FEAT-001-slug.md` that appear in
+     * markdown cross-reference links (those paths are relative to the
+     * artifact's file location, not to projectDir). Falls back to projectDir
+     * when omitted.
+     */
+    artifactDir?: string;
+    /** Concatenated string from `formatCodebaseContext`; undefined in fast mode. */
+    codebaseContextFormatted?: string;
+    /** Labels (paths or URLs) of declared sources supplied to the agent. */
+    knownSourceRefs: string[];
+    /** Pattern rule ids detected in the codebase context (from pattern-rules). */
+    knownPatternRuleIds: string[];
+}
+export interface DroppedEvidence {
+    evidence: ReviseEvidence;
+    reason: string;
+}
+export interface DecisionVerificationResult {
+    /** Possibly-rewritten decision (evidence filtered; action demoted if needed). */
+    decision: ReviseDecision;
+    /** Evidence items that failed verification and were removed from the decision. */
+    dropped: DroppedEvidence[];
+    /** True when the verifier changed the action (e.g., revise → flag). */
+    demoted: boolean;
+}
+/**
+ * Verify every evidence item in a decision; drop anything unverifiable.
+ * Demote `revise` to `flag` when no verifiable evidence remains.
+ */
+export declare function verifyDecision(decision: ReviseDecision, ctx: EvidenceVerifierContext): Promise<DecisionVerificationResult>;
+interface EvidenceCheck {
+    ok: boolean;
+    reason: string;
+}
+/** Verify a single evidence item. Exported primarily for testing. */
+export declare function verifyEvidence(ev: ReviseEvidence, ctx: EvidenceVerifierContext): Promise<EvidenceCheck>;
+export {};
+//# sourceMappingURL=evidence-verifier.d.ts.map

package/dist/services/evidence-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-verifier.d.ts","sourceRoot":"","sources":["../../src/services/evidence-verifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAEV,eAAe,EAEf,cAAc,EACd,cAAc,EACf,MAAM,oBAAoB,CAAC;AAI5B;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,wEAAwE;IACxE,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,8EAA8E;IAC9E,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,iFAAiF;IACjF,QAAQ,EAAE,cAAc,CAAC;IACzB,kFAAkF;IAClF,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,0BAA0B,CAAC,CAgErC;AAED,UAAU,aAAa;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,wBAAsB,cAAc,CAClC,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,uBAAuB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAwDxB"}

package/dist/services/evidence-verifier.js

@@ -0,0 +1,171 @@
+/**
+ * Post-flight evidence verification for `planr revise` (EPIC-003, FEAT-011).
+ *
+ * The revise agent emits a ReviseDecision with typed evidence citations. Before
+ * the user ever sees a diff, this verifier checks each citation against the
+ * real repo:
+ *
+ * - `file_exists` / `file_absent` — fs.stat on the ref path
+ * - `grep_match`                   — literal check inside the codebase context
+ *                                    the agent was given; rejects claims the
+ *                                    agent could not have seen
+ * - `sibling_artifact`             — artifact id must exist on disk
+ * - `source_quote`                 — source path must exist on disk (quote
+ *                                    fuzzy-match is best-effort)
+ * - `pattern_rule`                 — rule id must be in the detected pattern
+ *                                    rules for this run
+ *
+ * Unverifiable evidence is dropped with a reason. If a `revise` action has no
+ * surviving evidence after the sweep, the decision is demoted to `flag` with
+ * an explicit ambiguity entry — the agent's judgment wasn't necessarily wrong,
+ * but its *proof* can't be trusted, so a human owns the call.
+ */
+import { stat } from 'node:fs/promises';
+import path from 'node:path';
+import { logger } from '../utils/logger.js';
+import { findArtifactTypeById, listArtifacts, readArtifact } from './artifact-service.js';
+/**
+ * Verify every evidence item in a decision; drop anything unverifiable.
+ * Demote `revise` to `flag` when no verifiable evidence remains.
+ */
+export async function verifyDecision(decision, ctx) {
+    const dropped = [];
+    const verified = [];
+    for (const ev of decision.evidence) {
+        const check = await verifyEvidence(ev, ctx);
+        if (check.ok) {
+            verified.push(ev);
+        }
+        else {
+            dropped.push({ evidence: ev, reason: check.reason });
+        }
+    }
+    if (dropped.length > 0) {
+        logger.debug(`evidence-verifier: dropped ${dropped.length}/${decision.evidence.length} citations for ${decision.artifactId}`);
+    }
+    // Demotion rules for a `revise` action. We never silently apply a rewrite
+    // whose evidence base is weak. Two triggers:
+    //
+    //   (a) `verified.length === 0` — no evidence survived at all
+    //   (b) `dropped.length > verified.length` — a majority of the agent's
+    //       evidence was unverifiable. This catches the failure mode where
+    //       the agent cites one true thing and several hallucinated ones;
+    //       without this rule a 1-out-of-6 verification rate passes through
+    //       because at least one citation survives.
+    //
+    // Both rules target `revise` specifically — `flag` decisions are already
+    // asking for human review, and `skip` decisions don't change anything.
+    const shouldDemote = decision.action === 'revise' && (verified.length === 0 || dropped.length > verified.length);
+    if (shouldDemote) {
+        const reason = verified.length === 0
+            ? 'Agent proposed a revision but none of its evidence citations could be verified against the repo. Human review required.'
+            : `Agent proposed a revision but a majority of its evidence citations (${dropped.length}/${dropped.length + verified.length}) could not be verified. Most likely hallucinated — human review required.`;
+        const tag = verified.length === 0 ? 'all evidence unverifiable' : 'majority evidence unverifiable';
+        const ambiguity = {
+            section: '(evidence verification)',
+            reason,
+        };
+        return {
+            decision: {
+                ...decision,
+                action: 'flag',
+                evidence: verified, // keep any surviving citations in the flag record
+                revisedMarkdown: undefined,
+                ambiguous: [...decision.ambiguous, ambiguity],
+                rationale: `${decision.rationale} [demoted: ${tag}]`,
+            },
+            dropped,
+            demoted: true,
+        };
+    }
+    return {
+        decision: { ...decision, evidence: verified },
+        dropped,
+        demoted: false,
+    };
+}
+/** Verify a single evidence item. Exported primarily for testing. */
+export async function verifyEvidence(ev, ctx) {
+    switch (ev.type) {
+        case 'file_exists':
+            return (await pathExists(ctx.projectDir, ev.ref, ctx.artifactDir))
+                ? ok()
+                : fail(`cited file does not exist: ${ev.ref}`);
+        case 'file_absent':
+            return (await pathExists(ctx.projectDir, ev.ref, ctx.artifactDir))
+                ? fail(`cited file IS present in the repo, contradicting 'file_absent': ${ev.ref}`)
+                : ok();
+        case 'grep_match':
+            if (!ctx.codebaseContextFormatted) {
+                return fail('grep_match citation requires codebase context, but context was not loaded (fast mode)');
+            }
+            // Require either ref OR quote to appear in the context the agent saw.
+            if (ctx.codebaseContextFormatted.includes(ev.ref) ||
+                (ev.quote && ctx.codebaseContextFormatted.includes(ev.quote))) {
+                return ok();
+            }
+            return fail(`grep_match token not found in codebase context: ${ev.ref}`);
+        case 'sibling_artifact': {
+            const type = findArtifactTypeById(ev.ref);
+            if (!type) {
+                return fail(`sibling_artifact ref is not a recognizable artifact id: ${ev.ref}`);
+            }
+            return (await artifactExists(ctx.projectDir, ctx.config, type, ev.ref))
+                ? ok()
+                : fail(`sibling_artifact not found on disk: ${ev.ref}`);
+        }
+        case 'source_quote':
+            // Source refs are labels/paths declared in .planr/revise.yaml; the
+            // caller has already globbed them, so we validate against that list.
+            return ctx.knownSourceRefs.includes(ev.ref)
+                ? ok()
+                : fail(`source_quote ref is not a declared source: ${ev.ref}`);
+        case 'pattern_rule':
+            return ctx.knownPatternRuleIds.includes(ev.ref)
+                ? ok()
+                : fail(`pattern_rule ref is not a detected pattern rule: ${ev.ref}`);
+        default: {
+            // Exhaustive check — if a new evidence type is added to the TS union
+            // but not here, the compiler will complain.
+            const _exhaustive = ev.type;
+            return fail(`unhandled evidence type: ${String(_exhaustive)}`);
+        }
+    }
+}
+const ok = () => ({ ok: true, reason: '' });
+const fail = (reason) => ({ ok: false, reason });
+async function pathExists(projectDir, ref, artifactDir) {
+    // Choose resolution base:
+    // - Relative refs (`./` or `../`) resolve against the artifact's directory
+    //   when available, because OpenPlanr's cross-reference convention writes
+    //   paths like `../features/FEAT-001-slug.md` relative to the artifact file.
+    // - Everything else (repo-root-style refs like `src/services/foo.ts`) resolves
+    //   against projectDir.
+    const looksRelative = ref.startsWith('./') || ref.startsWith('../');
+    const base = looksRelative && artifactDir ? artifactDir : projectDir;
+    const resolved = path.resolve(base, ref);
+    const normalized = path.normalize(resolved);
+    // Traversal guard — the final path must still land inside projectDir
+    // (after following any `../`). This blocks probes like `../../../etc/passwd`
+    // while allowing legitimate artifact→sibling-dir references.
+    if (!normalized.startsWith(path.normalize(projectDir)))
+        return false;
+    try {
+        await stat(normalized);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function artifactExists(projectDir, config, type, id) {
+    // readArtifact is the authoritative existence check — it looks for files
+    // matching `${id}-*.md` in the correct artifact-type directory.
+    const artifact = await readArtifact(projectDir, config, type, id);
+    if (artifact !== null)
+        return true;
+    // Fallback: scan the listing in case id-case or prefix routing differs.
+    const list = await listArtifacts(projectDir, config, type);
+    return list.some((a) => a.id === id);
+}
+//# sourceMappingURL=evidence-verifier.js.map

package/dist/services/evidence-verifier.js.map

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

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

@@ -0,0 +1,60 @@
+/**
+ * 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.
+ */
+export type GitTreeStatus = {
+    kind: 'clean';
+    head: string;
+} | {
+    kind: 'dirty';
+    head: string;
+    changedPaths: string[];
+} | {
+    kind: 'not-a-repo';
+    reason: string;
+} | {
+    kind: 'git-missing';
+    reason: string;
+};
+export interface GitCleanTreeCheckOptions {
+    allowDirty: boolean;
+}
+export interface GitCleanTreeCheckResult {
+    ok: boolean;
+    status: GitTreeStatus;
+    /** User-facing message describing why the gate opened or closed. */
+    message: string;
+}
+/**
+ * Inspect the working tree. Never throws — always returns a typed status so
+ * callers can render errors consistently.
+ */
+export declare function inspectGitTree(projectDir: string): Promise<GitTreeStatus>;
+/**
+ * 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 declare function checkCleanTree(projectDir: string, options: GitCleanTreeCheckOptions): Promise<GitCleanTreeCheckResult>;
+/**
+ * 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 declare function checkoutPaths(projectDir: string, relativePaths: string[]): Promise<void>;
+//# sourceMappingURL=git-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-service.d.ts","sourceRoot":"","sources":["../../src/services/git-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;IACtB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAuC/E;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA0DlC;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9F"}

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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAmBxC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;YACnE,GAAG,EAAE,UAAU;YACf,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;QACH,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,0CAA0C,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACjD,CAAC;QACD,IAAI,0CAA0C,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAClD,CAAC;QACD,wEAAwE;QACxE,qEAAqE;QACrE,IAAI,6CAA6C,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,mCAAmC,EAAE,CAAC;QAC7E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;QAClF,GAAG,EAAE,UAAU;QACf,SAAS,EAAE,cAAc;KAC1B,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,YAAY,GAAG,SAAS;SAC3B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAEvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB,EAClB,OAAiC;IAEjC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IAEhD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,MAAM;gBACN,OAAO,EAAE,4BAA4B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG;aACjE,CAAC;QAEJ,KAAK,OAAO;YACV,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,MAAM;oBACN,OAAO,EAAE,oBAAoB,MAAM,CAAC,YAAY,CAAC,MAAM,wGAAwG;iBAChK,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM;gBACN,OAAO,EAAE,oBAAoB,MAAM,CAAC,YAAY,CAAC,MAAM,oIAAoI;aAC5L,CAAC;QAEJ,KAAK,YAAY;YACf,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,MAAM;oBACN,OAAO,EAAE,yBAAyB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kEAAkE;iBACzH,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM;gBACN,OAAO,EAAE,yBAAyB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,4IAA4I;aACnM,CAAC;QAEJ,KAAK,aAAa;YAChB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO;oBACL,EAAE,EAAE,IAAI;oBACR,MAAM;oBACN,OAAO,EAAE,kFAAkF;iBAC5F,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM;gBACN,OAAO,EAAE,+IAA+I;aACzJ,CAAC;QAEJ,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB,EAAE,aAAuB;IAC7E,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACvC,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,EAAE;QAC/D,GAAG,EAAE,UAAU;QACf,SAAS,EAAE,cAAc;KAC1B,CAAC,CAAC;AACL,CAAC"}

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

@@ -5,7 +5,7 @@
  * All operations use `gh` so authentication is handled by the user's
  * existing GitHub CLI session — no extra API tokens needed.
  */
-import type { ArtifactFrontmatter, ArtifactType } from '../models/types.js';
+import type { ArtifactFrontmatter, ArtifactType, GitHubCommitSummary, GitHubPullRequestSummary } from '../models/types.js';
 export interface GitHubIssue {
     number: number;
     title: string;
@@ -94,4 +94,31 @@ export declare function fetchIssueTypes(owner: string, repo: string): Promise<Re
  * Requires the issue's node ID and the issue type's node ID.
  */
 export declare function setIssueType(owner: string, repo: string, issueNumber: number, issueTypeName: string): Promise<void>;
+/**
+ * Recent commits on the default branch (best-effort via GitHub API).
+ */
+export declare function fetchRecentCommits(args: {
+    days: number;
+    limit: number;
+}): Promise<{
+    commits: GitHubCommitSummary[];
+    warning?: string;
+}>;
+/**
+ * Recently updated pull requests (all states), filtered client-side by `updated_at`.
+ */
+export declare function fetchRecentPullRequests(args: {
+    days: number;
+    limit: number;
+}): Promise<{
+    pullRequests: GitHubPullRequestSummary[];
+    warning?: string;
+}>;
+/**
+ * Best-effort check that `gh` can read the repo (already implied by verifyGitHubRepo).
+ */
+export declare function validateRepoAccessible(): Promise<{
+    ok: boolean;
+    message: string;
+}>;
 //# sourceMappingURL=github-service.d.ts.map

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

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