@ddtcorex/dsh-maestro-memory 1.0.1

package/lib/storage/atomic-store.js

@@ -0,0 +1,582 @@
+/**
+ * Atomic file store for Maestro memory — per-directory lock, temp-write/rename,
+ * reread validation, backups, duplicate detection.
+ *
+ * Each mutation:
+ *  1. Acquires a same-directory lock file (.maestro.lock) with stale detection
+ *     (mtime timeout + pid liveness via kill(pid,0)).
+ *  2. Validates the on-disk content round-trips through parseEntries/serializeEntries.
+ *     Non-canonical files are backed up to `<file>.bak.<timestamp>` before the
+ *     operation is refused (drift guard).
+ *  3. Checks for exact duplicates (ID-stripped) so re-adds are no-ops.
+ *  4. Writes to a same-directory temp file (`.<uuid>.tmp`, mode 0o600, flag wx),
+ *     fsyncs the temp, renames atomically over the target, fsyncs the parent
+ *     directory on POSIX, then rereads and validates the result.
+ *  5. Cleans up the temp file on any failure; the previous file is never
+ *     clobbered on error.
+ *
+ * Uses only `node:fs` / `node:fs/promises` atomic primitives: open(wx),
+ * writeFile, fsync, rename, unlink. No third-party dependencies.
+ *
+ * @module storage/atomic-store
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { mkdir, open, readFile, rename, rm, stat, writeFile, } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Delimiter + parse/serialize (pure, no I/O)
+// ---------------------------------------------------------------------------
+/** Entry delimiter, byte-compatible with Hermes MEMORY.md / USER.md. */
+export const ENTRY_DELIMITER = '\n§\n';
+/**
+ * Split raw file text into trimmed, non-empty entries.
+ * @param text - raw file content
+ * @returns entries
+ */
+export function parseEntries(text) {
+    return text
+        .split(ENTRY_DELIMITER)
+        .map((e) => e.trim())
+        .filter((e) => e.length > 0);
+}
+/**
+ * Serialize entries into canonical file text.
+ * @param entries - entries to serialize
+ * @returns canonical file content (entries joined by delimiter + trailing newline)
+ */
+export function serializeEntries(entries) {
+    return entries.length === 0 ? '' : entries.join(ENTRY_DELIMITER) + '\n';
+}
+/**
+ * Whether raw text is the canonical serialization of its own entries.
+ * Blank / whitespace-only text counts as canonical (empty store).
+ * @param text - raw file content
+ * @returns true when round-tripping preserves the text
+ */
+export function isCanonical(text) {
+    return text.trim() === '' || serializeEntries(parseEntries(text)) === text;
+}
+// ---------------------------------------------------------------------------
+// Duplicate detection (ID-aware)
+// ---------------------------------------------------------------------------
+/** Regex for cross-device entry ID prefix (space after colon allowed, case-insensitive). */
+const ENTRY_ID_RE = /^\[id:\s*[0-9a-f]{8}\]\s*/i;
+/**
+ * Strip the `[id:xxxxxxxx]` prefix from an entry, if present.
+ * @param entry - full entry text
+ * @returns text without the ID prefix
+ */
+export function stripEntryId(entry) {
+    return String(entry).replace(ENTRY_ID_RE, '');
+}
+/**
+ * Check whether `candidate` already exists in `entries`, comparing after
+ * stripping IDs so a re-add with a new random ID is still detected as a
+ * duplicate (IDs are random per write, direct includes would never hit).
+ * @param entries - existing entries
+ * @param candidate - new entry text
+ * @returns true when a duplicate exists
+ */
+export function isDuplicate(entries, candidate) {
+    const needle = stripEntryId(candidate);
+    return entries.some((e) => stripEntryId(e) === needle);
+}
+/**
+ * Find the exact index of `exact` in `entries`, ID-immune (strip-and-compare).
+ * Returns -1 when not found or when multiple hits make the match ambiguous.
+ * @param entries - existing entries
+ * @param exact - full entry text to find
+ * @returns index or -1
+ */
+export function findExactIndex(entries, exact) {
+    const target = stripEntryId(exact);
+    let found = -1;
+    for (let i = 0; i < entries.length; i++) {
+        if (stripEntryId(entries[i]) === target) {
+            if (found !== -1)
+                return -1; // ambiguous
+            found = i;
+        }
+    }
+    return found;
+}
+// ---------------------------------------------------------------------------
+// Lock (per-directory)
+// ---------------------------------------------------------------------------
+/** A lock file older than this is considered abandoned (stale). */
+export const STALE_LOCK_MS = 10_000;
+/** How long to keep waiting for the lock before failing. */
+export const LOCK_TIMEOUT_MS = 5_000;
+/** Spin interval while waiting for the lock. */
+export const LOCK_RETRY_MS = 25;
+/** Lock file name inside each directory. */
+export const LOCK_FILE = '.maestro.lock';
+/** Directories whose lock this process currently holds (reentrancy guard). */
+const heldLocks = new Set();
+/** Lock file content: pid + timestamp for stale detection. */
+function lockJson() {
+    return JSON.stringify({ pid: process.pid, at: Date.now() });
+}
+/**
+ * Determine whether a lock is stale (exported for tests): mtime timeout or
+ * the pid inside the lock file is no longer alive (killed / power loss ->
+ * stale immediately without waiting for timeout).
+ * @param lockPath - lock file path
+ * @returns true when stale
+ */
+export function isStaleLock(lockPath) {
+    try {
+        const info = statSync(lockPath);
+        try {
+            const owner = JSON.parse(readFileSync(lockPath, 'utf8'));
+            if (typeof owner.pid === 'number') {
+                try {
+                    process.kill(owner.pid, 0);
+                    return false; // owner alive -> valid
+                }
+                catch {
+                    return true; // owner dead
+                }
+            }
+        }
+        catch {
+            // old-format / unparseable -> fall back to mtime
+        }
+        return Date.now() - info.mtimeMs > STALE_LOCK_MS;
+    }
+    catch {
+        return false;
+    }
+}
+/** Async variant of stale check for the async lock path. */
+export async function isStaleLockAsync(lockPath) {
+    try {
+        const info = await stat(lockPath);
+        try {
+            const owner = JSON.parse(await readFile(lockPath, 'utf8'));
+            if (typeof owner.pid === 'number') {
+                try {
+                    process.kill(owner.pid, 0);
+                    return false;
+                }
+                catch {
+                    return true;
+                }
+            }
+        }
+        catch {
+            // fall back to mtime
+        }
+        return Date.now() - info.mtimeMs > STALE_LOCK_MS;
+    }
+    catch {
+        return false;
+    }
+}
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Acquire the directory lock synchronously, run `fn`, release.
+ * Reentrant within this process (outer section remains exclusive vs others).
+ * @param dir - directory whose lock to take
+ * @param fn - critical section
+ * @returns section result
+ */
+export function withLockSync(dir, fn) {
+    if (heldLocks.has(dir))
+        return fn();
+    const lockPath = join(dir, LOCK_FILE);
+    mkdirSync(dir, { recursive: true });
+    const deadline = Date.now() + LOCK_TIMEOUT_MS;
+    for (;;) {
+        let acquired = false;
+        try {
+            const fd = openSync(lockPath, 'wx');
+            try {
+                writeFileSync(lockPath, lockJson());
+            }
+            finally {
+                closeSync(fd);
+            }
+            acquired = true;
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'EEXIST')
+                throw error;
+        }
+        if (acquired)
+            break;
+        if (isStaleLock(lockPath))
+            rmSync(lockPath, { force: true });
+        if (Date.now() >= deadline)
+            throw new Error('atomic-store: timed out waiting for directory lock');
+        sleepSync(LOCK_RETRY_MS);
+    }
+    heldLocks.add(dir);
+    try {
+        return fn();
+    }
+    finally {
+        heldLocks.delete(dir);
+        rmSync(lockPath, { force: true });
+    }
+}
+/**
+ * Acquire the directory lock asynchronously, run `fn`, release.
+ * Reentrant within this process.
+ * @param dir - directory whose lock to take
+ * @param fn - critical section (may be async)
+ * @returns section result
+ */
+export async function withLock(dir, fn) {
+    if (heldLocks.has(dir))
+        return await fn();
+    const lockPath = join(dir, LOCK_FILE);
+    await mkdir(dir, { recursive: true });
+    const deadline = Date.now() + LOCK_TIMEOUT_MS;
+    for (;;) {
+        let acquired = false;
+        try {
+            const handle = await open(lockPath, 'wx', 0o600);
+            try {
+                await handle.writeFile(lockJson(), 'utf8');
+            }
+            finally {
+                await handle.close();
+            }
+            acquired = true;
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'EEXIST')
+                throw error;
+        }
+        if (acquired)
+            break;
+        if (await isStaleLockAsync(lockPath))
+            await rm(lockPath, { force: true });
+        if (Date.now() >= deadline)
+            throw new Error('atomic-store: timed out waiting for directory lock');
+        await sleep(LOCK_RETRY_MS);
+    }
+    heldLocks.add(dir);
+    try {
+        return await fn();
+    }
+    finally {
+        heldLocks.delete(dir);
+        await rm(lockPath, { force: true });
+    }
+}
+// ---------------------------------------------------------------------------
+// Backups
+// ---------------------------------------------------------------------------
+/**
+ * Create a backup of `filePath` at `<file>.bak.<timestamp>`.
+ * Returns the backup path, or null when the source does not exist.
+ * @param filePath - file to back up
+ * @returns backup path or null
+ */
+export function createBackupSync(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    const backupPath = `${filePath}.bak.${Date.now()}`;
+    const data = readFileSync(filePath);
+    writeFileSync(backupPath, data);
+    return backupPath;
+}
+/**
+ * Async backup.
+ * @param filePath - file to back up
+ * @returns backup path or null
+ */
+export async function createBackup(filePath) {
+    try {
+        const data = await readFile(filePath);
+        const backupPath = `${filePath}.bak.${Date.now()}`;
+        // Create backup atomically; if it exists, bump timestamp
+        await writeFile(backupPath, data, { flag: 'wx', mode: 0o600 });
+        return backupPath;
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+// ---------------------------------------------------------------------------
+// Atomic write: temp-write / rename / reread validation
+// ---------------------------------------------------------------------------
+/** fsync a POSIX directory so a just-renamed entry is crash-durable. */
+/* v8 ignore start -- Windows rejects O_RDONLY directory opens */
+async function fsyncDirectory(dir) {
+    if (process.platform === 'win32')
+        return;
+    const handle = await open(dir, 'r');
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+function fsyncDirectorySync(dir) {
+    if (process.platform === 'win32')
+        return;
+    const fd = openSync(dir, 'r');
+    try {
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/* v8 ignore stop */
+/**
+ * Durably replace `filePath` with `content` via same-directory temp file,
+ * fsync, atomic rename, directory fsync, and reread validation.
+ * @param filePath - absolute target file path
+ * @param content - full new file content
+ */
+export async function writeAtomic(filePath, content) {
+    const dir = dirname(filePath);
+    await mkdir(dir, { recursive: true });
+    const tmp = join(dir, `.${randomUUID()}.tmp`);
+    try {
+        const handle = await open(tmp, 'wx', 0o600);
+        try {
+            await handle.writeFile(content, 'utf8');
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        await rename(tmp, filePath);
+        await fsyncDirectory(dir);
+        // Reread validation: ensure the file now contains exactly what we wrote.
+        const reread = await readFile(filePath, 'utf8');
+        if (reread !== content) {
+            throw new Error(`atomic-store: reread validation failed for ${filePath} (expected ${content.length} chars, got ${reread.length})`);
+        }
+    }
+    catch (error) {
+        await rm(tmp, { force: true });
+        throw error;
+    }
+}
+/**
+ * Synchronous atomic write (same guarantees, blocking).
+ * @param filePath - absolute target file path
+ * @param content - full new file content
+ */
+export function writeAtomicSync(filePath, content) {
+    const dir = dirname(filePath);
+    mkdirSync(dir, { recursive: true });
+    const tmp = join(dir, `.${randomUUID()}.tmp`);
+    try {
+        const fd = openSync(tmp, 'wx', 0o600);
+        try {
+            writeFileSync(tmp, content, 'utf8');
+            fsyncSync(fd);
+        }
+        finally {
+            closeSync(fd);
+        }
+        renameSync(tmp, filePath);
+        fsyncDirectorySync(dir);
+        // Reread validation
+        const reread = readFileSync(filePath, 'utf8');
+        if (reread !== content) {
+            throw new Error(`atomic-store: reread validation failed for ${filePath}`);
+        }
+    }
+    catch (error) {
+        rmSync(tmp, { force: true });
+        throw error;
+    }
+}
+// ---------------------------------------------------------------------------
+// High-level entry helpers (lock + backup + duplicate detection + atomic write)
+// ---------------------------------------------------------------------------
+/**
+ * Read entries from `filePath`. Missing file yields [].
+ * @param filePath - file to read
+ * @returns parsed entries
+ */
+export function readEntriesSync(filePath) {
+    try {
+        return parseEntries(readFileSync(filePath, 'utf8'));
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT')
+            return [];
+        throw error;
+    }
+}
+/**
+ * Async read entries.
+ * @param filePath - file to read
+ * @returns parsed entries
+ */
+export async function readEntries(filePath) {
+    try {
+        return parseEntries(await readFile(filePath, 'utf8'));
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT')
+            return [];
+        throw error;
+    }
+}
+/**
+ * Append `entry` to `filePath` atomically, with duplicate detection and
+ * drift-guard backup.
+ *
+ * - Acquires per-directory lock.
+ * - Validates existing content is canonical; if not, backs up and throws.
+ * - Checks for duplicate (ID-stripped); returns `{duplicate:true}` without writing.
+ * - Writes via temp+rename+reread.
+ *
+ * @param filePath - target file
+ * @param entry - entry to append (already trimmed)
+ * @returns result
+ */
+export async function appendEntryAtomic(filePath, entry) {
+    const dir = dirname(filePath);
+    return withLock(dir, async () => {
+        // Drift guard: read raw and validate
+        let raw = '';
+        try {
+            raw = await readFile(filePath, 'utf8');
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'ENOENT')
+                throw error;
+            raw = '';
+        }
+        if (raw !== '' && !isCanonical(raw)) {
+            const backup = await createBackup(filePath);
+            return { ok: false, error: `drift: non-canonical content backed up to ${backup}`, backup: backup ?? undefined };
+        }
+        const entries = parseEntries(raw);
+        if (isDuplicate(entries, entry)) {
+            return { ok: true, duplicate: true, entries };
+        }
+        const next = [...entries, entry];
+        const content = serializeEntries(next);
+        await writeAtomic(filePath, content);
+        return { ok: true, entries: next };
+    });
+}
+/**
+ * Synchronous variant of appendEntryAtomic.
+ * @param filePath - target file
+ * @param entry - entry to append
+ * @returns result
+ */
+export function appendEntryAtomicSync(filePath, entry) {
+    const dir = dirname(filePath);
+    return withLockSync(dir, () => {
+        let raw = '';
+        try {
+            raw = readFileSync(filePath, 'utf8');
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'ENOENT')
+                throw error;
+            raw = '';
+        }
+        if (raw !== '' && !isCanonical(raw)) {
+            const backup = createBackupSync(filePath);
+            return { ok: false, error: `drift: non-canonical content backed up to ${backup}`, backup: backup ?? undefined };
+        }
+        const entries = parseEntries(raw);
+        if (isDuplicate(entries, entry)) {
+            return { ok: true, duplicate: true, entries };
+        }
+        const next = [...entries, entry];
+        const content = serializeEntries(next);
+        writeAtomicSync(filePath, content);
+        return { ok: true, entries: next };
+    });
+}
+/**
+ * Replace or remove via atomic write with drift guard and backup.
+ * Caller provides the next entries array; this validates, backs up on drift, and writes.
+ * @param filePath - target file
+ * @param nextEntries - complete new entries array
+ * @returns result
+ */
+export async function writeEntriesAtomic(filePath, nextEntries) {
+    const dir = dirname(filePath);
+    return withLock(dir, async () => {
+        let raw = '';
+        try {
+            raw = await readFile(filePath, 'utf8');
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'ENOENT')
+                throw error;
+            raw = '';
+        }
+        if (raw !== '' && !isCanonical(raw)) {
+            const backup = await createBackup(filePath);
+            return { ok: false, error: `drift: non-canonical content backed up to ${backup}`, backup: backup ?? undefined };
+        }
+        const content = serializeEntries(nextEntries);
+        await writeAtomic(filePath, content);
+        return { ok: true, entries: nextEntries };
+    });
+}
+/**
+ * Synchronous variant.
+ * @param filePath - target file
+ * @param nextEntries - complete new entries array
+ * @returns result
+ */
+export function writeEntriesAtomicSync(filePath, nextEntries) {
+    const dir = dirname(filePath);
+    return withLockSync(dir, () => {
+        let raw = '';
+        try {
+            raw = readFileSync(filePath, 'utf8');
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'ENOENT')
+                throw error;
+            raw = '';
+        }
+        if (raw !== '' && !isCanonical(raw)) {
+            const backup = createBackupSync(filePath);
+            return { ok: false, error: `drift: non-canonical content backed up to ${backup}`, backup: backup ?? undefined };
+        }
+        const content = serializeEntries(nextEntries);
+        writeAtomicSync(filePath, content);
+        return { ok: true, entries: nextEntries };
+    });
+}
+// ---------------------------------------------------------------------------
+// Utility: project hash (re-export for layout consumers)
+// ---------------------------------------------------------------------------
+/**
+ * Stable 12-hex project hash for a cwd.
+ * @param cwd - working directory
+ * @returns 12-char hash
+ */
+export function projectHash(cwd) {
+    return createHash('sha1').update(cwd).digest('hex').slice(0, 12);
+}
+//# sourceMappingURL=atomic-store.js.map

package/lib/storage/atomic-store.js.map

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

package/lib/storage/layout.d.ts

@@ -0,0 +1,81 @@
+/**
+ * storage/layout.ts — path resolution for five memory files, four todo files,
+ * archives, metadata, and legacy project hash.
+ * Pure, no Cordis import. Uses node:path + node:crypto.
+ */
+/** Resolve the canonical memories root: config.memoryDir or ~/.dsh/memories */
+export declare function resolveMemoryRoot(memoryDir: string | null | undefined): string;
+/** 12-hex project hash for a cwd (sha1(cwd).slice(0,12)) */
+export declare function projectHash(cwd: string): string;
+/** Legacy alias — same as projectHash, explicit for spec compliance. */
+export declare const legacyProjectHash: typeof projectHash;
+export declare function globalMemoryPath(root: string): string;
+export declare function userMemoryPath(root: string): string;
+export declare function globalArchivePath(root: string): string;
+export declare function userArchivePath(root: string): string;
+export declare function suggestionsPath(root: string): string;
+export declare function dailyDir(root: string): string;
+export declare function dailyPath(root: string, date: string): string;
+export declare function dailyTodoPath(root: string, date: string): string;
+export declare function projectDir(root: string, cwd: string): string;
+export declare function projectMemoryPath(root: string, cwd: string): string;
+export declare function projectKeyPath(root: string, cwd: string): string;
+export declare function projectKeyArchivePath(root: string, cwd: string): string;
+export declare function projectTodoPath(root: string, cwd: string): string;
+export declare function lifeTodoPath(root: string): string;
+export declare function workTodoPath(root: string): string;
+export declare function maestroMetaDir(root: string): string;
+export declare function schemaPath(root: string): string;
+export declare function journalPath(root: string): string;
+export declare function backupsDir(root: string): string;
+export declare function todoArchivePath(root: string): string;
+export declare function backupManifestPath(root: string, runId: string): string;
+export declare function backupFilesDirPath(root: string, runId: string): string;
+/**
+ * Resolve all five memory files at once (pure).
+ */
+export declare function allMemoryPaths(root: string, cwd: string, date: string): {
+    memory: string;
+    user: string;
+    daily: string;
+    project: string;
+    key: string;
+};
+/**
+ * Resolve all four todo files at once (pure).
+ */
+export declare function allTodoPaths(root: string, cwd: string, date: string): {
+    life: string;
+    work: string;
+    project: string;
+    daily: string;
+};
+/**
+ * Resolve all archive files at once (pure).
+ */
+export declare function allArchivePaths(root: string, cwd: string): {
+    memory: string;
+    user: string;
+    key: string;
+    todo: string;
+};
+/**
+ * Resolve metadata files at once (pure).
+ */
+export declare function allMetadataPaths(root: string, runId?: string): {
+    metaDir: string;
+    schema: string;
+    journal: string;
+    backupsDir: string;
+    backupManifest: string | undefined;
+    backupFilesDir: string | undefined;
+};
+export declare const resolveMemoryFiles: typeof allMemoryPaths;
+export declare const resolveTodoFiles: typeof allTodoPaths;
+export declare const resolveArchiveFiles: typeof allArchivePaths;
+export declare const resolveMetadataFiles: typeof allMetadataPaths;
+export declare const getMemoryPaths: typeof allMemoryPaths;
+export declare const getTodoPaths: typeof allTodoPaths;
+export declare const getArchivePaths: typeof allArchivePaths;
+export declare const getMetadataPaths: typeof allMetadataPaths;
+//# sourceMappingURL=layout.d.ts.map