openplanr 3.0.0 → 3.1.0

package/dist/services/audit-log-service.d.ts

@@ -1,47 +0,0 @@
-/**
- * Audit log writer for `planr revise`.
- *
- * Every revise run — dry-run included — produces an audit log capturing
- * applied / skipped / flagged / failed artifacts with rationale, evidence,
- * ambiguities, and unified diffs. Entries are *flushed immediately* to
- * disk as they are produced (see `appendEntry`), not batched at cascade
- * end, so an interrupted run still leaves an accurate record of exactly
- * what was written.
- *
- * Two output formats: Markdown (human-readable, default) and JSON (for CI /
- * tooling / future telemetry workflows). Core structure lives here so
- * token-usage and cache-hit/miss stats can layer on additively.
- */
-import type { ReviseAudit, ReviseAuditEntry, ReviseAuditFormat } from '../models/types.js';
-export interface AuditLogWriterOptions {
-    projectDir: string;
-    scope: string;
-    cascade: boolean;
-    dryRun: boolean;
-    format: ReviseAuditFormat;
-    /** Override the default path (.planr/reports/revise-<scope>-<date>.<ext>). */
-    overridePath?: string;
-    /** ISO date used in the default filename. Defaults to today in local time. */
-    dateStamp?: string;
-}
-export interface AuditLogWriter {
-    /** Absolute path of the audit file being written. */
-    path: string;
-    /** Append one artifact entry and flush to disk immediately. */
-    appendEntry(entry: ReviseAuditEntry): void;
-    /**
-     * Close the audit — records `completedAt`, final summary, and (for JSON
-     * format) rewrites the file with the accumulated entries wrapped in a
-     * ReviseAudit envelope. Markdown output is append-only and closes with a
-     * trailing summary section.
-     */
-    close(summary?: Partial<Pick<ReviseAudit, 'interrupted' | 'tokenUsage'>>): void;
-}
-/**
- * Create a writer. For Markdown output, writes the header immediately so
- * users can `tail -f` the log during long cascades. For JSON output, the
- * accumulated entries are materialized on close (JSON is not line-oriented).
- */
-export declare function createAuditLogWriter(options: AuditLogWriterOptions): AuditLogWriter;
-export declare function readAuditJson(logPath: string): ReviseAudit;
-//# sourceMappingURL=audit-log-service.d.ts.map

package/dist/services/audit-log-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audit-log-service.d.ts","sourceRoot":"","sources":["../../src/services/audit-log-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3F,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC;CACjF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA0CnF;AA4JD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAM1D"}

package/dist/services/audit-log-service.js

@@ -1,211 +0,0 @@
-/**
- * Audit log writer for `planr revise`.
- *
- * Every revise run — dry-run included — produces an audit log capturing
- * applied / skipped / flagged / failed artifacts with rationale, evidence,
- * ambiguities, and unified diffs. Entries are *flushed immediately* to
- * disk as they are produced (see `appendEntry`), not batched at cascade
- * end, so an interrupted run still leaves an accurate record of exactly
- * what was written.
- *
- * Two output formats: Markdown (human-readable, default) and JSON (for CI /
- * tooling / future telemetry workflows). Core structure lives here so
- * token-usage and cache-hit/miss stats can layer on additively.
- */
-import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import { PLANNING_FOLDER } from '../utils/constants.js';
-/**
- * Create a writer. For Markdown output, writes the header immediately so
- * users can `tail -f` the log during long cascades. For JSON output, the
- * accumulated entries are materialized on close (JSON is not line-oriented).
- */
-export function createAuditLogWriter(options) {
-    const audit = {
-        scope: options.scope,
-        cascade: options.cascade,
-        dryRun: options.dryRun,
-        startedAt: new Date().toISOString(),
-        entries: [],
-    };
-    const logPath = options.overridePath ?? defaultAuditPath(options);
-    mkdirSync(path.dirname(logPath), { recursive: true });
-    if (options.format === 'md') {
-        writeFileSync(logPath, renderHeader(audit), 'utf-8');
-    }
-    else {
-        writeFileSync(logPath, JSON.stringify(audit, null, 2), 'utf-8');
-    }
-    return {
-        path: logPath,
-        appendEntry(entry) {
-            audit.entries.push(entry);
-            if (options.format === 'md') {
-                appendFileSync(logPath, renderEntry(entry), 'utf-8');
-            }
-            else {
-                // JSON: rewrite the envelope each append. O(n²) over the run, but
-                // for a typical cascade (<100 artifacts) this is well under 10ms.
-                // The guarantee we need is durability, not write efficiency.
-                writeFileSync(logPath, JSON.stringify(audit, null, 2), 'utf-8');
-            }
-        },
-        close(summary) {
-            audit.completedAt = new Date().toISOString();
-            if (summary?.interrupted)
-                audit.interrupted = summary.interrupted;
-            if (summary?.tokenUsage)
-                audit.tokenUsage = summary.tokenUsage;
-            if (options.format === 'md') {
-                appendFileSync(logPath, renderFooter(audit), 'utf-8');
-            }
-            else {
-                writeFileSync(logPath, JSON.stringify(audit, null, 2), 'utf-8');
-            }
-        },
-    };
-}
-function defaultAuditPath(options) {
-    const date = options.dateStamp ?? toIsoDate(new Date());
-    const ext = options.format === 'json' ? 'json' : 'md';
-    const file = `revise-${options.scope}-${date}.${ext}`;
-    return path.join(options.projectDir, PLANNING_FOLDER, 'reports', file);
-}
-function toIsoDate(d) {
-    const y = d.getFullYear();
-    const m = String(d.getMonth() + 1).padStart(2, '0');
-    const day = String(d.getDate()).padStart(2, '0');
-    return `${y}-${m}-${day}`;
-}
-// ---------------------------------------------------------------------------
-// Markdown rendering
-// ---------------------------------------------------------------------------
-function renderHeader(audit) {
-    const mode = audit.dryRun ? 'dry-run' : 'apply';
-    const cascade = audit.cascade ? 'on' : 'off';
-    return [
-        `# Revise audit — ${audit.scope} (${toIsoDate(new Date(audit.startedAt))})`,
-        `> mode=${mode} · cascade=${cascade} · started=${audit.startedAt}`,
-        '',
-        '## Entries',
-        '',
-        '',
-    ].join('\n');
-}
-function renderEntry(entry) {
-    const out = [];
-    out.push(`### [${entry.outcome}] ${entry.artifactId}`);
-    if (entry.artifactPath)
-        out.push(`> ${entry.artifactPath}`);
-    out.push(`> timestamp=${entry.timestamp}`);
-    out.push('');
-    out.push(`**Rationale:** ${entry.rationale}`);
-    if (entry.evidence.length > 0) {
-        out.push('');
-        out.push('**Evidence:**');
-        for (const ev of entry.evidence) {
-            const quote = ev.quote ? ` — "${truncate(ev.quote, 120)}"` : '';
-            out.push(`- [${ev.type}] \`${ev.ref}\`${quote}`);
-        }
-    }
-    if (entry.ambiguous.length > 0) {
-        out.push('');
-        out.push('**Ambiguous (human decision required):**');
-        for (const a of entry.ambiguous) {
-            out.push(`- §${a.section}: ${a.reason}`);
-        }
-    }
-    if (entry.error) {
-        out.push('');
-        out.push(`**Error:** \`${entry.error}\``);
-    }
-    if (entry.diff && entry.diff.length > 0) {
-        out.push('');
-        out.push('**Diff:**');
-        out.push('```diff');
-        out.push(entry.diff);
-        out.push('```');
-    }
-    out.push('');
-    return `${out.join('\n')}\n`;
-}
-function renderFooter(audit) {
-    const counts = audit.entries.reduce((acc, e) => {
-        acc[e.outcome] = (acc[e.outcome] ?? 0) + 1;
-        return acc;
-    }, {});
-    const summaryRows = Object.entries(counts)
-        .sort(([a], [b]) => a.localeCompare(b))
-        .map(([outcome, n]) => `- ${outcome}: ${n}`);
-    const out = [];
-    out.push('');
-    out.push('## Summary');
-    out.push(`> completed=${audit.completedAt ?? 'n/a'} · entries=${audit.entries.length}`);
-    out.push('');
-    if (summaryRows.length > 0) {
-        out.push(...summaryRows);
-    }
-    else {
-        out.push('- (no entries recorded)');
-    }
-    // Cascade-level grouping — only emitted when at least one entry carries
-    // a level tag. Includes empty groups (with a count of 0) so readers can
-    // see which levels had nothing to process.
-    if (audit.cascade) {
-        const levels = [
-            'epic',
-            'features',
-            'stories',
-            'tasks',
-        ];
-        const byLevel = audit.entries.reduce((acc, e) => {
-            const key = e.cascadeLevel ?? 'unlabeled';
-            if (!acc[key])
-                acc[key] = [];
-            acc[key].push({ outcome: e.outcome, artifactId: e.artifactId });
-            return acc;
-        }, {});
-        out.push('');
-        out.push('### By cascade level');
-        for (const level of levels) {
-            const rows = byLevel[level] ?? [];
-            out.push('');
-            out.push(`**${level}** (${rows.length}):`);
-            if (rows.length === 0) {
-                out.push('- (no artifacts at this level)');
-                continue;
-            }
-            for (const row of rows) {
-                out.push(`- [${row.outcome}] ${row.artifactId}`);
-            }
-        }
-    }
-    if (audit.interrupted) {
-        out.push('');
-        out.push(`**Interrupted:** reason=${audit.interrupted.reason}${audit.interrupted.atArtifactId ? ` (at ${audit.interrupted.atArtifactId})` : ''}`);
-    }
-    if (audit.tokenUsage) {
-        out.push('');
-        out.push(`**Tokens:** ${audit.tokenUsage.inputTokens.toLocaleString()} in → ${audit.tokenUsage.outputTokens.toLocaleString()} out`);
-    }
-    out.push('');
-    return `${out.join('\n')}\n`;
-}
-function truncate(s, n) {
-    if (s.length <= n)
-        return s;
-    return `${s.slice(0, n)}…`;
-}
-// ---------------------------------------------------------------------------
-// Convenience: load an audit log back into a ReviseAudit (for tooling).
-// Not used by the revise command itself but required by future `planr
-// revise feedback <finding-id>` in this release.
-// ---------------------------------------------------------------------------
-export function readAuditJson(logPath) {
-    if (!existsSync(logPath)) {
-        throw new Error(`Audit log not found at ${logPath}`);
-    }
-    const raw = readFileSync(logPath, 'utf-8');
-    return JSON.parse(raw);
-}
-//# sourceMappingURL=audit-log-service.js.map

package/dist/services/audit-log-service.js.map

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

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

@@ -1,16 +0,0 @@
-/**
- * Apply structured deltas from AI refine to an artifact — replaces the
- * whole-file `improvedMarkdown` blob contract.
- *
- * Frontmatter changes are surgical (regex per field, same as updateArtifactFields).
- * Body changes target specific ## headings or exact text matches.
- */
-export interface BodyChange {
-    type: 'replaceSection' | 'replaceText';
-    heading?: string;
-    findExact?: string;
-    replaceWith?: string;
-    newContent?: string;
-}
-export declare function applyRefineDeltas(raw: string, frontmatterChanges?: Record<string, unknown>, bodyChanges?: BodyChange[]): string;
-//# sourceMappingURL=delta-apply-service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"delta-apply-service.d.ts","sourceRoot":"","sources":["../../src/services/delta-apply-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,WAAW,CAAC,EAAE,UAAU,EAAE,GACzB,MAAM,CAmER"}

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

@@ -1,74 +0,0 @@
-/**
- * Apply structured deltas from AI refine to an artifact — replaces the
- * whole-file `improvedMarkdown` blob contract.
- *
- * Frontmatter changes are surgical (regex per field, same as updateArtifactFields).
- * Body changes target specific ## headings or exact text matches.
- */
-import { escapeRegExp } from '../utils/escape-regexp.js';
-function yamlEscapeValue(value) {
-    const str = String(value);
-    const escaped = str.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-    return `"${escaped}"`;
-}
-export function applyRefineDeltas(raw, frontmatterChanges, bodyChanges) {
-    let result = raw;
-    if (frontmatterChanges && Object.keys(frontmatterChanges).length > 0) {
-        const openIdx = result.indexOf('---');
-        const closeIdx = result.indexOf('\n---', openIdx + 3);
-        if (openIdx !== -1 && closeIdx !== -1) {
-            let frontmatter = result.slice(openIdx, closeIdx);
-            const body = result.slice(closeIdx);
-            for (const [key, value] of Object.entries(frontmatterChanges)) {
-                const pattern = new RegExp(`^${escapeRegExp(key)}:\\s*.*$`, 'm');
-                const replacement = `${key}: ${yamlEscapeValue(value)}`;
-                if (pattern.test(frontmatter)) {
-                    frontmatter = frontmatter.replace(pattern, () => replacement);
-                }
-                else {
-                    frontmatter += `\n${replacement}`;
-                }
-            }
-            result = frontmatter + body;
-        }
-    }
-    if (bodyChanges && bodyChanges.length > 0) {
-        const openIdx = result.indexOf('---');
-        const closeIdx = result.indexOf('\n---', openIdx + 3);
-        if (closeIdx === -1)
-            return result;
-        const header = result.slice(0, closeIdx + 4);
-        let body = result.slice(closeIdx + 4);
-        for (const change of bodyChanges) {
-            if (change.type === 'replaceSection' && change.heading && change.newContent !== undefined) {
-                const headingPattern = new RegExp(`(^|\\n)(##\\s+${escapeRegExp(change.heading)}\\s*\\n)`, 'i');
-                const match = headingPattern.exec(body);
-                if (match) {
-                    const sectionStart = (match.index ?? 0) + match[1].length;
-                    const afterHeading = sectionStart + match[2].length;
-                    const nextHeading = body.slice(afterHeading).search(/\n##\s+/);
-                    const sectionEnd = nextHeading === -1 ? body.length : afterHeading + nextHeading;
-                    body =
-                        body.slice(0, sectionStart) +
-                            match[2] +
-                            change.newContent.trimEnd() +
-                            '\n' +
-                            body.slice(sectionEnd);
-                }
-                else {
-                    body = `${body.trimEnd()}\n\n## ${change.heading}\n\n${change.newContent.trimEnd()}\n`;
-                }
-            }
-            else if (change.type === 'replaceText' &&
-                change.findExact &&
-                change.replaceWith !== undefined) {
-                if (body.includes(change.findExact)) {
-                    body = body.replace(change.findExact, change.replaceWith);
-                }
-            }
-        }
-        result = header + body;
-    }
-    return result;
-}
-//# sourceMappingURL=delta-apply-service.js.map

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

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

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

@@ -1,71 +0,0 @@
-/**
- * Post-flight evidence verification for `planr revise`.
- *
- * 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

@@ -1 +0,0 @@
-{"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,CAmErC;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

@@ -1,174 +0,0 @@
-/**
- * Post-flight evidence verification for `planr revise`.
- *
- * 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
-                // Preserve the agent's proposed rewrite so the audit log can show it
-                // as a "rejected proposal" diff. The apply path still refuses to
-                // write it (action=flag), but users can read the audit entry to
-                // see what the agent wanted and decide whether to hand-apply.
-                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

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