openplanr 3.0.0 → 3.1.0

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

@@ -1,153 +0,0 @@
-/**
- * Revise plan parser.
- *
- * A "plan" is a previously-written revise audit log that we replay to disk
- * without any model calls. This service parses a Markdown audit file
- * emitted by `audit-log-service.ts` back into structured `ReviseAuditEntry`
- * records that the CLI's apply-from-audit path can replay.
- *
- * Parsing is deliberately strict about structure but tolerant of
- * whitespace — audit files are written by us and edited by no-one, so we
- * can rely on the heading hierarchy and section markers. If a user has
- * hand-edited the audit, the parser surfaces specific errors so the user
- * can fix or discard the file rather than silently getting bad replays.
- *
- * Future extension: we may emit a sidecar `.plan.json` next to the
- * Markdown audit to carry content hashes and `revisedMarkdown` without
- * parsing overhead. The Markdown path remains supported indefinitely —
- * older audits predate any sidecar format and still need replay support.
- */
-import { readFileSync } from 'node:fs';
-/**
- * Parse a revise Markdown audit log into its constituent entries.
- * Throws if the file cannot be read, is empty, or has no entries.
- */
-export function readPlanFromAudit(auditPath) {
-    let raw;
-    try {
-        raw = readFileSync(auditPath, 'utf-8');
-    }
-    catch (err) {
-        throw new Error(`Cannot read audit file at ${auditPath}: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    if (raw.length === 0) {
-        throw new Error(`Audit file ${auditPath} is empty.`);
-    }
-    const { scope, startedAt } = parseHeader(raw, auditPath);
-    const entries = parseEntries(raw, auditPath);
-    if (entries.length === 0) {
-        throw new Error(`Audit file ${auditPath} contains no entries — nothing to apply. Re-run revise with --dry-run first.`);
-    }
-    return { sourcePath: auditPath, scope, startedAt, entries };
-}
-/** Entries that can actually be written on replay (have a diff and target path). */
-export function filterReplayable(plan) {
-    return plan.entries.filter((e) => e.outcome === 'would-apply' && e.artifactPath && e.diff && e.diff.length > 0);
-}
-// ---------------------------------------------------------------------------
-// Parsing internals
-// ---------------------------------------------------------------------------
-function parseHeader(raw, auditPath) {
-    const title = raw.match(/^#\s+Revise audit\s+—\s+([A-Z]+-\d{3,})\b/m);
-    if (!title) {
-        throw new Error(`Audit file ${auditPath} does not start with a recognizable header (expected "# Revise audit — <SCOPE>").`);
-    }
-    const scope = title[1];
-    const started = raw.match(/started=([0-9T:\-.Z]+)/);
-    return { scope, startedAt: started ? started[1] : undefined };
-}
-/**
- * Split the audit body into entries by the `### [outcome] ArtifactId` heading.
- * Each entry then parses independently; any entry that fails to parse is
- * collected with a reason in its error field rather than aborting the whole
- * parse — the caller filters to `would-apply` for replay, so skipped/malformed
- * entries simply won't be replayed.
- */
-function parseEntries(raw, auditPath) {
-    // The `## Entries` / `## Summary` headings bookend the body; we scan between them.
-    const entriesStart = raw.indexOf('\n## Entries');
-    const summaryStart = raw.indexOf('\n## Summary');
-    const body = entriesStart >= 0
-        ? raw.slice(entriesStart, summaryStart >= 0 ? summaryStart : raw.length)
-        : raw;
-    // Split on the entry heading. Each chunk (except the first, which is the
-    // `## Entries` preamble) corresponds to one entry.
-    const chunks = body.split(/\n(?=### \[)/);
-    const entries = [];
-    for (const chunk of chunks) {
-        const trimmed = chunk.trim();
-        if (!trimmed.startsWith('### ['))
-            continue;
-        const parsed = parseEntry(trimmed, auditPath);
-        if (parsed)
-            entries.push(parsed);
-    }
-    return entries;
-}
-function parseEntry(chunk, _auditPath) {
-    const heading = chunk.match(/^### \[([^\]]+)\]\s+(\S+)/);
-    if (!heading)
-        return null;
-    const outcome = heading[1];
-    const artifactId = heading[2];
-    // Audit files contain native filesystem paths. Capture the complete quoted
-    // line so POSIX, Windows drive, UNC, and paths containing spaces all replay.
-    const artifactPathMatch = chunk.match(/\n>\s+([^\r\n]+?\.md)\r?(?=\n|$)/);
-    const artifactPath = artifactPathMatch ? artifactPathMatch[1] : undefined;
-    const timestampMatch = chunk.match(/timestamp=([0-9T:\-.Z]+)/);
-    const timestamp = timestampMatch ? timestampMatch[1] : new Date().toISOString();
-    const rationaleMatch = chunk.match(/\*\*Rationale:\*\*\s+([\s\S]*?)(?=\n\n\*\*|\n\n```|$)/);
-    const rationale = rationaleMatch ? rationaleMatch[1].trim() : '';
-    const evidence = parseEvidenceList(chunk);
-    const ambiguous = parseAmbiguousList(chunk);
-    const diff = parseDiffBlock(chunk);
-    return {
-        artifactId,
-        artifactPath,
-        outcome,
-        rationale,
-        evidence,
-        ambiguous,
-        diff,
-        timestamp,
-        // Older audits don't carry these; the replay flow is responsible for
-        // computing / verifying them against live content when present.
-    };
-}
-function parseEvidenceList(chunk) {
-    // Match from `**Evidence:**` heading to the next `**Xxx:**` / `## ` /
-    // fenced-diff / end.
-    const section = chunk.match(/\*\*Evidence:\*\*\s*\n([\s\S]*?)(?=\n\n\*\*[A-Z]|\n\n```|\n## |$)/);
-    if (!section)
-        return [];
-    const out = [];
-    const lineRe = /^-\s+\[([a-z_]+)\]\s+`([^`]+)`(?:\s+—\s+"([\s\S]*?)"\s*$)?/gm;
-    let m = lineRe.exec(section[1]);
-    while (m !== null) {
-        out.push({
-            type: m[1],
-            ref: m[2],
-            quote: m[3],
-        });
-        m = lineRe.exec(section[1]);
-    }
-    return out;
-}
-function parseAmbiguousList(chunk) {
-    const section = chunk.match(/\*\*Ambiguous[^*]*\*\*\s*\n([\s\S]*?)(?=\n\n\*\*[A-Z]|\n\n```|\n## |$)/);
-    if (!section)
-        return [];
-    const out = [];
-    const lineRe = /^-\s+§([^:]+):\s+(.+)$/gm;
-    let m = lineRe.exec(section[1]);
-    while (m !== null) {
-        out.push({ section: m[1].trim(), reason: m[2].trim() });
-        m = lineRe.exec(section[1]);
-    }
-    return out;
-}
-function parseDiffBlock(chunk) {
-    const m = chunk.match(/\*\*Diff:\*\*\s*\n```diff\n([\s\S]*?)\n```/);
-    return m ? m[1] : undefined;
-}
-//# sourceMappingURL=revise-plan-service.js.map

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

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