@rasensio/aidlc 0.1.0

package/dist/state/snapshot-store.js

@@ -0,0 +1,164 @@
+/**
+ * Snapshot store with atomic writes and per-instance namespaces.
+ *
+ * All instance state lives under `.aidlc/state/<instance-name>/`:
+ *   - `instance.yaml` — instance metadata
+ *   - `phase-<name>.yaml` — per-phase state (one per applicable phase)
+ *
+ * Write semantics:
+ * - Snapshot files use write-to-tmp + rename for atomicity (Req 23.5).
+ *   Readers never observe partial writes.
+ * - Instance directories are fully isolated — edits to one instance
+ *   never touch another instance's files (Req 23.1, 23.3, 6.1).
+ *
+ * Requirements: 4.1, 6.1, 23.1, 23.3, 23.5
+ */
+import { readFileSync, writeFileSync, renameSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { parse, stringify } from 'yaml';
+import { YamlLoadError } from './yaml-helpers.js';
+// ---------------------------------------------------------------------------
+// YAML serialization options (deterministic, matching yaml-helpers.ts)
+// ---------------------------------------------------------------------------
+const SERIALIZE_OPTIONS = {
+    sortMapEntries: true,
+    blockQuote: 'literal',
+    lineWidth: 0,
+};
+// ---------------------------------------------------------------------------
+// Atomic write primitive
+// ---------------------------------------------------------------------------
+/**
+ * Write content to a file atomically using tmp-file + rename.
+ *
+ * 1. Write to `<filePath>.tmp.<pid>` — unique per process, avoids collisions.
+ * 2. Rename the tmp file to the target path — atomic on POSIX filesystems.
+ *
+ * Parent directories are created if they don't exist.
+ */
+export function atomicWrite(filePath, content) {
+    const tmpPath = `${filePath}.tmp.${process.pid}`;
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(tmpPath, content, 'utf8');
+    renameSync(tmpPath, filePath);
+}
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+/**
+ * Compute the absolute directory path for an instance namespace.
+ *
+ * @param stateDir - Root state directory (e.g., `/project/.aidlc/state`).
+ * @param instance - Instance name (URL-safe directory name).
+ * @returns Absolute path: `<stateDir>/<instance>/`.
+ */
+export function instancePath(stateDir, instance) {
+    return join(stateDir, instance);
+}
+// ---------------------------------------------------------------------------
+// Directory operations
+// ---------------------------------------------------------------------------
+/**
+ * Create the namespace directory for a new lifecycle instance.
+ *
+ * @param stateDir - Root state directory.
+ * @param name - Instance name.
+ * @returns The absolute path to the created directory.
+ */
+export function createInstanceDir(stateDir, name) {
+    const dir = instancePath(stateDir, name);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+/**
+ * List all instance namespace directories under the state root.
+ *
+ * Returns an array of instance names (directory basenames).
+ * Only directories are included — stray files at the state root are ignored.
+ *
+ * @param stateDir - Root state directory.
+ * @returns Array of instance names (directory names).
+ */
+export function listInstanceDirs(stateDir) {
+    let entries;
+    try {
+        entries = readdirSync(stateDir);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            return [];
+        }
+        throw err;
+    }
+    return entries.filter((entry) => {
+        try {
+            return statSync(join(stateDir, entry)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Save / Load snapshots
+// ---------------------------------------------------------------------------
+/**
+ * Save a snapshot file atomically within an instance namespace.
+ *
+ * Serializes `data` to deterministic YAML and writes it using
+ * tmp-file + rename to guarantee atomic writes (Req 23.5).
+ *
+ * @param stateDir - Root state directory.
+ * @param instance - Instance name.
+ * @param fileName - File name within the instance directory (e.g., `instance.yaml`).
+ * @param data - Data to serialize and persist.
+ */
+export function saveSnapshot(stateDir, instance, fileName, data) {
+    const filePath = join(instancePath(stateDir, instance), fileName);
+    const content = stringify(data, SERIALIZE_OPTIONS);
+    atomicWrite(filePath, content);
+}
+/**
+ * Load and parse a snapshot file from an instance namespace.
+ *
+ * Optionally validates the parsed data using a schema validator.
+ * Throws `YamlLoadError` on missing files, parse errors, or validation failures
+ * — always naming the file in the error message (Req 4.7).
+ *
+ * @param stateDir - Root state directory.
+ * @param instance - Instance name.
+ * @param fileName - File name within the instance directory.
+ * @param validate - Optional schema validator.
+ * @returns The parsed (and validated) data cast to `T`.
+ * @throws {YamlLoadError} If the file is missing, corrupt, or fails validation.
+ */
+export function loadSnapshot(stateDir, instance, fileName, validate) {
+    const filePath = join(instancePath(stateDir, instance), fileName);
+    let raw;
+    try {
+        raw = readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            throw new YamlLoadError(filePath, 'file not found');
+        }
+        throw new YamlLoadError(filePath, `unable to read file: ${err.message}`);
+    }
+    let data;
+    try {
+        data = parse(raw);
+    }
+    catch (err) {
+        throw new YamlLoadError(filePath, `YAML parse error: ${err.message}`);
+    }
+    if (validate) {
+        const error = validate(data);
+        if (error) {
+            throw new YamlLoadError(filePath, `validation failed: ${error}`);
+        }
+    }
+    return data;
+}
+//# sourceMappingURL=snapshot-store.js.map

package/dist/state/snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.js","sourceRoot":"","sources":["../../src/state/snapshot-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG;IACxB,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,SAAkB;IAC9B,SAAS,EAAE,CAAC;CACb,CAAC;AAEF,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IAC3D,MAAM,OAAO,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IACjD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACxC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAgB;IAC7D,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAAY;IAC9D,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAAgB,EAAE,IAAa;IAC9F,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IACnD,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,QAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAElE,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,wBAAyB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAS,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,IAAI,aAAa,CAAC,QAAQ,EAAE,sBAAsB,KAAK,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,OAAO,IAAS,CAAC;AACnB,CAAC"}

package/dist/state/state-recovery.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Corrupt/missing state handling with recovery support.
+ *
+ * Provides:
+ * - `loadWithRecovery()` — load a state file, reporting errors clearly
+ *   with optional backup before any recovery attempt.
+ * - `backupStateFile()` — create a timestamped backup copy of a file.
+ * - `detectConflictMarkers()` — scan a file for git conflict markers and
+ *   produce a report with resolution steps.
+ *
+ * Key invariant: the original file is NEVER modified or discarded.
+ * Backups are copies; the original stays intact until the user explicitly
+ * resolves the issue.
+ *
+ * Requirements: 4.6, 4.7
+ */
+import type { SchemaValidator } from './yaml-helpers.js';
+/**
+ * Result of a recovery-aware load attempt.
+ *
+ * - `data`: the parsed content if successful, null otherwise.
+ * - `recovered`: true if a backup was created during this load attempt.
+ * - `backupPath`: path to the backup file if one was created, null otherwise.
+ * - `error`: human-readable error message if loading failed, null on success.
+ */
+export interface RecoveryResult<T> {
+    data: T | null;
+    recovered: boolean;
+    backupPath: string | null;
+    error: string | null;
+}
+/**
+ * Report produced when git conflict markers are detected in a state file.
+ */
+export interface ConflictReport {
+    /** Path to the file containing conflict markers. */
+    filePath: string;
+    /** Fields that appear to be in conflict (best-effort extraction). */
+    conflictingFields: string[];
+    /** Human-readable resolution steps. */
+    resolutionSteps: string[];
+}
+/**
+ * Create a timestamped backup of a state file.
+ *
+ * Naming convention: `<filename>.backup.<ISO-timestamp>`
+ * (colons in the timestamp are replaced with hyphens for filesystem safety).
+ *
+ * The original file is NOT modified — the backup is a pure copy.
+ *
+ * @param filePath - Absolute path to the file to back up.
+ * @returns The absolute path to the created backup file.
+ * @throws {YamlLoadError} If the source file does not exist.
+ */
+export declare function backupStateFile(filePath: string): string;
+/**
+ * Detect git conflict markers in a file and produce a resolution report.
+ *
+ * Scans the file content for `<<<<<<<`, `=======`, `>>>>>>>` marker lines.
+ * If any are found, attempts to identify which YAML fields are in conflict
+ * by parsing the "ours" and "theirs" sections.
+ *
+ * @param filePath - Absolute path to the file to check.
+ * @returns A ConflictReport if markers are found, null otherwise.
+ */
+export declare function detectConflictMarkers(filePath: string): ConflictReport | null;
+/**
+ * Load a state file with recovery support.
+ *
+ * Behavior:
+ * - If the file is missing: returns an error result naming the file.
+ * - If the file has conflict markers: returns an error result describing
+ *   the conflicts, optionally backs up before returning.
+ * - If the file is corrupt (invalid YAML or fails validation):
+ *   a) Reports which file is invalid and why.
+ *   b) Optionally creates a backup copy before returning.
+ *   c) NEVER modifies or discards the original file.
+ *
+ * @param filePath - Absolute path to the state file to load.
+ * @param validate - Optional schema validator.
+ * @param opts - Options: `backup` controls whether a backup is created on error.
+ * @returns A RecoveryResult describing the outcome.
+ */
+export declare function loadWithRecovery<T = unknown>(filePath: string, validate?: SchemaValidator<T>, opts?: {
+    backup?: boolean;
+}): RecoveryResult<T>;
+//# sourceMappingURL=state-recovery.d.ts.map

package/dist/state/state-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-recovery.d.ts","sourceRoot":"","sources":["../../src/state/state-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOzD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYxD;AAWD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA8B7E;AAiFD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAC7B,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,cAAc,CAAC,CAAC,CAAC,CAsFnB"}

package/dist/state/state-recovery.js

@@ -0,0 +1,274 @@
+/**
+ * Corrupt/missing state handling with recovery support.
+ *
+ * Provides:
+ * - `loadWithRecovery()` — load a state file, reporting errors clearly
+ *   with optional backup before any recovery attempt.
+ * - `backupStateFile()` — create a timestamped backup copy of a file.
+ * - `detectConflictMarkers()` — scan a file for git conflict markers and
+ *   produce a report with resolution steps.
+ *
+ * Key invariant: the original file is NEVER modified or discarded.
+ * Backups are copies; the original stays intact until the user explicitly
+ * resolves the issue.
+ *
+ * Requirements: 4.6, 4.7
+ */
+import { readFileSync, copyFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname, basename } from 'node:path';
+import { parse } from 'yaml';
+import { YamlLoadError } from './yaml-helpers.js';
+// ---------------------------------------------------------------------------
+// Backup
+// ---------------------------------------------------------------------------
+/**
+ * Create a timestamped backup of a state file.
+ *
+ * Naming convention: `<filename>.backup.<ISO-timestamp>`
+ * (colons in the timestamp are replaced with hyphens for filesystem safety).
+ *
+ * The original file is NOT modified — the backup is a pure copy.
+ *
+ * @param filePath - Absolute path to the file to back up.
+ * @returns The absolute path to the created backup file.
+ * @throws {YamlLoadError} If the source file does not exist.
+ */
+export function backupStateFile(filePath) {
+    if (!existsSync(filePath)) {
+        throw new YamlLoadError(filePath, 'cannot back up: file not found');
+    }
+    const timestamp = new Date().toISOString().replace(/:/g, '-');
+    const backupPath = `${filePath}.backup.${timestamp}`;
+    mkdirSync(dirname(backupPath), { recursive: true });
+    copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+// ---------------------------------------------------------------------------
+// Conflict detection (Req 4.6)
+// ---------------------------------------------------------------------------
+/** Git conflict marker patterns. */
+const CONFLICT_START = /^<{7}\s/;
+const CONFLICT_SEPARATOR = /^={7}$/;
+const CONFLICT_END = /^>{7}\s/;
+/**
+ * Detect git conflict markers in a file and produce a resolution report.
+ *
+ * Scans the file content for `<<<<<<<`, `=======`, `>>>>>>>` marker lines.
+ * If any are found, attempts to identify which YAML fields are in conflict
+ * by parsing the "ours" and "theirs" sections.
+ *
+ * @param filePath - Absolute path to the file to check.
+ * @returns A ConflictReport if markers are found, null otherwise.
+ */
+export function detectConflictMarkers(filePath) {
+    let raw;
+    try {
+        raw = readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            return null;
+        }
+        throw err;
+    }
+    const lines = raw.split('\n');
+    const hasConflicts = lines.some((line) => CONFLICT_START.test(line) || CONFLICT_END.test(line));
+    if (!hasConflicts) {
+        return null;
+    }
+    // Extract conflicting fields by parsing ours/theirs sections
+    const conflictingFields = extractConflictingFields(lines);
+    const resolutionSteps = buildResolutionSteps(filePath, conflictingFields);
+    return {
+        filePath,
+        conflictingFields,
+        resolutionSteps,
+    };
+}
+/**
+ * Extract field names from conflict regions by parsing the ours/theirs sections.
+ */
+function extractConflictingFields(lines) {
+    const fields = new Set();
+    let inOurs = false;
+    let inTheirs = false;
+    const oursLines = [];
+    const theirsLines = [];
+    for (const line of lines) {
+        if (CONFLICT_START.test(line)) {
+            inOurs = true;
+            inTheirs = false;
+            continue;
+        }
+        if (CONFLICT_SEPARATOR.test(line)) {
+            inOurs = false;
+            inTheirs = true;
+            continue;
+        }
+        if (CONFLICT_END.test(line)) {
+            inTheirs = false;
+            // Attempt to extract field names from collected sections
+            extractFieldNames(oursLines, fields);
+            extractFieldNames(theirsLines, fields);
+            oursLines.length = 0;
+            theirsLines.length = 0;
+            continue;
+        }
+        if (inOurs)
+            oursLines.push(line);
+        if (inTheirs)
+            theirsLines.push(line);
+    }
+    return [...fields];
+}
+/**
+ * Extract top-level YAML field names from a set of lines.
+ */
+function extractFieldNames(lines, fields) {
+    for (const line of lines) {
+        // Match top-level YAML keys: `key:` at the start of a line (no leading whitespace)
+        const match = line.match(/^([a-zA-Z_][a-zA-Z0-9_-]*):/);
+        if (match) {
+            fields.add(match[1]);
+        }
+    }
+}
+/**
+ * Build human-readable resolution steps based on detected conflicts.
+ */
+function buildResolutionSteps(filePath, fields) {
+    const fileName = basename(filePath);
+    const steps = [];
+    steps.push(`Open ${fileName} in an editor`);
+    if (fields.length > 0) {
+        steps.push(`Resolve conflicts in field(s): ${fields.join(', ')} — choose the correct value for each`);
+    }
+    else {
+        steps.push('Identify the correct value for each conflicted section');
+    }
+    steps.push('Remove all conflict markers (lines starting with <<<<<<<, =======, >>>>>>>)');
+    steps.push('Validate the file is valid YAML after edits');
+    steps.push('Stage the resolved file with git add');
+    return steps;
+}
+// ---------------------------------------------------------------------------
+// Recovery-aware load (Req 4.7)
+// ---------------------------------------------------------------------------
+/**
+ * Load a state file with recovery support.
+ *
+ * Behavior:
+ * - If the file is missing: returns an error result naming the file.
+ * - If the file has conflict markers: returns an error result describing
+ *   the conflicts, optionally backs up before returning.
+ * - If the file is corrupt (invalid YAML or fails validation):
+ *   a) Reports which file is invalid and why.
+ *   b) Optionally creates a backup copy before returning.
+ *   c) NEVER modifies or discards the original file.
+ *
+ * @param filePath - Absolute path to the state file to load.
+ * @param validate - Optional schema validator.
+ * @param opts - Options: `backup` controls whether a backup is created on error.
+ * @returns A RecoveryResult describing the outcome.
+ */
+export function loadWithRecovery(filePath, validate, opts) {
+    const shouldBackup = opts?.backup ?? false;
+    // Check if file exists
+    if (!existsSync(filePath)) {
+        return {
+            data: null,
+            recovered: false,
+            backupPath: null,
+            error: `${filePath}: file not found`,
+        };
+    }
+    // Read file content
+    let raw;
+    try {
+        raw = readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        return {
+            data: null,
+            recovered: false,
+            backupPath: null,
+            error: `${filePath}: unable to read file: ${err.message}`,
+        };
+    }
+    // Check for conflict markers
+    const conflictReport = detectConflictMarkersFromContent(raw, filePath);
+    if (conflictReport) {
+        let backupPath = null;
+        if (shouldBackup) {
+            backupPath = backupStateFile(filePath);
+        }
+        const fieldInfo = conflictReport.conflictingFields.length > 0
+            ? ` in fields: ${conflictReport.conflictingFields.join(', ')}`
+            : '';
+        return {
+            data: null,
+            recovered: shouldBackup,
+            backupPath,
+            error: `${filePath}: git conflict markers detected${fieldInfo}`,
+        };
+    }
+    // Parse YAML
+    let data;
+    try {
+        data = parse(raw);
+    }
+    catch (err) {
+        let backupPath = null;
+        if (shouldBackup) {
+            backupPath = backupStateFile(filePath);
+        }
+        return {
+            data: null,
+            recovered: shouldBackup,
+            backupPath,
+            error: `${filePath}: YAML parse error: ${err.message}`,
+        };
+    }
+    // Validate schema
+    if (validate) {
+        const validationError = validate(data);
+        if (validationError) {
+            let backupPath = null;
+            if (shouldBackup) {
+                backupPath = backupStateFile(filePath);
+            }
+            return {
+                data: null,
+                recovered: shouldBackup,
+                backupPath,
+                error: `${filePath}: validation failed: ${validationError}`,
+            };
+        }
+    }
+    // Success
+    return {
+        data: data,
+        recovered: false,
+        backupPath: null,
+        error: null,
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helper: detect conflicts from already-read content
+// ---------------------------------------------------------------------------
+function detectConflictMarkersFromContent(content, filePath) {
+    const lines = content.split('\n');
+    const hasConflicts = lines.some((line) => CONFLICT_START.test(line) || CONFLICT_END.test(line));
+    if (!hasConflicts) {
+        return null;
+    }
+    const conflictingFields = extractConflictingFields(lines);
+    const resolutionSteps = buildResolutionSteps(filePath, conflictingFields);
+    return {
+        filePath,
+        conflictingFields,
+        resolutionSteps,
+    };
+}
+//# sourceMappingURL=state-recovery.js.map

package/dist/state/state-recovery.js.map

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

package/dist/state/transition-log.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Append-only NDJSON transition log writer and reader.
+ *
+ * The transitions.log file stores one JSON record per line (NDJSON format).
+ * Each record is a TransitionRecord capturing a phase transition event.
+ *
+ * Write semantics:
+ * - Uses O_WRONLY | O_APPEND | O_CREAT flags for atomic appends.
+ * - Concurrent appends from separate processes cannot corrupt existing lines.
+ *
+ * Read semantics:
+ * - File not found → empty array (no error).
+ * - Empty lines are skipped.
+ * - Malformed JSON lines are skipped with a warning to stderr.
+ *
+ * Requirements: 4.3, 4.4, 11.5
+ */
+import type { TransitionRecord } from '../core/types.js';
+/**
+ * Append a single transition record to the NDJSON log file.
+ *
+ * Creates the file (and parent directories) if it does not exist.
+ * Uses O_APPEND to guarantee atomic line appends even under concurrent writes.
+ *
+ * @param logPath - Absolute or relative path to the transitions.log file.
+ * @param record - The transition record to append.
+ */
+export declare function appendTransition(logPath: string, record: TransitionRecord): void;
+/**
+ * Read all transition records from the NDJSON log file.
+ *
+ * - Returns an empty array if the file does not exist.
+ * - Skips empty lines.
+ * - Skips malformed JSON lines (logs a warning to stderr).
+ *
+ * @param logPath - Absolute or relative path to the transitions.log file.
+ * @returns Array of parsed TransitionRecord entries.
+ */
+export declare function readTransitions(logPath: string): TransitionRecord[];
+//# sourceMappingURL=transition-log.d.ts.map

package/dist/state/transition-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-log.d.ts","sourceRoot":"","sources":["../../src/state/transition-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMzD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAShF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA6BnE"}

package/dist/state/transition-log.js

@@ -0,0 +1,83 @@
+/**
+ * Append-only NDJSON transition log writer and reader.
+ *
+ * The transitions.log file stores one JSON record per line (NDJSON format).
+ * Each record is a TransitionRecord capturing a phase transition event.
+ *
+ * Write semantics:
+ * - Uses O_WRONLY | O_APPEND | O_CREAT flags for atomic appends.
+ * - Concurrent appends from separate processes cannot corrupt existing lines.
+ *
+ * Read semantics:
+ * - File not found → empty array (no error).
+ * - Empty lines are skipped.
+ * - Malformed JSON lines are skipped with a warning to stderr.
+ *
+ * Requirements: 4.3, 4.4, 11.5
+ */
+import { readFileSync, openSync, writeSync, closeSync, constants, mkdirSync, } from 'node:fs';
+import { dirname } from 'node:path';
+// ---------------------------------------------------------------------------
+// Writer
+// ---------------------------------------------------------------------------
+/**
+ * Append a single transition record to the NDJSON log file.
+ *
+ * Creates the file (and parent directories) if it does not exist.
+ * Uses O_APPEND to guarantee atomic line appends even under concurrent writes.
+ *
+ * @param logPath - Absolute or relative path to the transitions.log file.
+ * @param record - The transition record to append.
+ */
+export function appendTransition(logPath, record) {
+    mkdirSync(dirname(logPath), { recursive: true });
+    const line = JSON.stringify(record) + '\n';
+    const fd = openSync(logPath, constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT);
+    try {
+        writeSync(fd, line);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+// ---------------------------------------------------------------------------
+// Reader
+// ---------------------------------------------------------------------------
+/**
+ * Read all transition records from the NDJSON log file.
+ *
+ * - Returns an empty array if the file does not exist.
+ * - Skips empty lines.
+ * - Skips malformed JSON lines (logs a warning to stderr).
+ *
+ * @param logPath - Absolute or relative path to the transitions.log file.
+ * @returns Array of parsed TransitionRecord entries.
+ */
+export function readTransitions(logPath) {
+    let raw;
+    try {
+        raw = readFileSync(logPath, 'utf8');
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            return [];
+        }
+        throw err;
+    }
+    const lines = raw.split('\n');
+    const records = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line === '')
+            continue;
+        try {
+            records.push(JSON.parse(line));
+        }
+        catch {
+            process.stderr.write(`transitions.log: skipping malformed line ${i + 1}: ${line.slice(0, 80)}\n`);
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=transition-log.js.map

package/dist/state/transition-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-log.js","sourceRoot":"","sources":["../../src/state/transition-log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,MAAwB;IACxE,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1F,IAAI,CAAC;QACH,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,EAAE;YAAE,SAAS;QAE1B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAqB,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4CAA4C,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}