loreforge 0.1.0-alpha.1

package/dist/evidence/git.js

@@ -0,0 +1,119 @@
+import { spawnSync } from "node:child_process";
+import { realpathSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { OpError } from "../core/errors.js";
+// Read-only Git discovery for project registration. Every subprocess is an
+// argument-array call with a controlled cwd and a timeout; user-supplied
+// paths are never executed as code and no shell is involved.
+export const GIT_TIMEOUT_MS = 10000;
+// Accepted Git HEAD shape: 40-hex SHA-1 or 64-hex SHA-256. Must stay
+// identical to HEAD_RE in src/core/schemas/common.ts (CONTRACT.md requires
+// "full 40- or 64-hex commit ID"); observation must not reject what the
+// schema accepts.
+const GIT_HEAD_RE = /^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$/;
+function runGit(cwd, args) {
+    try {
+        // --no-optional-locks keeps read-only observation from refreshing the
+        // user's index (e.g. after a mere mtime touch): status still reports
+        // correctly but never writes. This changes no user configuration.
+        const result = spawnSync("git", ["--no-optional-locks", ...args], {
+            cwd,
+            timeout: GIT_TIMEOUT_MS,
+            encoding: "utf8",
+            maxBuffer: 64 * 1024,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        if (result.error)
+            throw OpError.io("git subprocess failed");
+        return { status: result.status, stdout: typeof result.stdout === "string" ? result.stdout : "" };
+    }
+    catch (error) {
+        if (error instanceof OpError)
+            throw error;
+        throw OpError.io("git subprocess failed");
+    }
+}
+// Observe a checkout without modifying it. Any collection failure is CONFLICT
+// (the reported evidence cannot be accepted), never a completed task: callers
+// run this outside the write transaction and only persist inside it.
+export function observeCheckout(checkoutRoot, nowMs) {
+    let canonical;
+    try {
+        canonical = realpathSync(checkoutRoot);
+    }
+    catch {
+        throw OpError.conflict("could not collect Git observation for reported checkout");
+    }
+    const headProbe = runGit(canonical, ["rev-parse", "HEAD"]);
+    const head = headProbe.stdout.trim();
+    if (headProbe.status !== 0 || !GIT_HEAD_RE.test(head)) {
+        throw OpError.conflict("could not collect Git observation for reported checkout");
+    }
+    const statusProbe = runGit(canonical, ["status", "--porcelain"]);
+    if (statusProbe.status !== 0) {
+        throw OpError.conflict("could not collect Git observation for reported checkout");
+    }
+    return {
+        checkoutRoot: canonical,
+        head: head.toLowerCase(),
+        dirty: statusProbe.stdout.length > 0,
+        collectedAt: new Date(nowMs).toISOString(),
+    };
+}
+// Best-effort read of the registered project root for context snapshots. An
+// absent or unreadable root is null head/dirty plus a sanitized error, never
+// a failed context request. Never throws.
+export function observeCurrentGit(root, nowMs) {
+    const collectedAt = new Date(nowMs).toISOString();
+    const failure = { head: null, dirty: null, collectedAt, error: "could not read project Git state" };
+    let canonical;
+    try {
+        canonical = realpathSync(root);
+    }
+    catch {
+        return failure;
+    }
+    let headProbe;
+    let statusProbe;
+    try {
+        headProbe = runGit(canonical, ["rev-parse", "HEAD"]);
+        statusProbe = runGit(canonical, ["status", "--porcelain"]);
+    }
+    catch {
+        return failure;
+    }
+    const head = headProbe.stdout.trim();
+    if (headProbe.status !== 0 || !GIT_HEAD_RE.test(head) || statusProbe.status !== 0) {
+        return failure;
+    }
+    return { head: head.toLowerCase(), dirty: statusProbe.stdout.length > 0, collectedAt, error: null };
+}
+// Resolve a checkout root to its canonical project identity. Worktrees of one
+// repository share the same realpath Git common directory and therefore the
+// same project; distinct clones differ. Non-Git roots are VALIDATION, not IO:
+// the input path is well-formed but unacceptable in v0.1.
+export function discoverProject(root) {
+    let canonicalRoot;
+    try {
+        canonicalRoot = realpathSync(root);
+    }
+    catch {
+        throw OpError.validation("project root is not an accessible directory");
+    }
+    const probe = runGit(canonicalRoot, ["rev-parse", "--git-common-dir"]);
+    if (probe.status !== 0) {
+        throw OpError.validation("project root is not inside a Git repository");
+    }
+    const reported = probe.stdout.trim();
+    if (reported.length === 0) {
+        throw OpError.validation("project root is not inside a Git repository");
+    }
+    const joined = isAbsolute(reported) ? reported : resolve(canonicalRoot, reported);
+    try {
+        return { root: canonicalRoot, gitCommonDir: realpathSync(joined) };
+    }
+    catch {
+        throw OpError.validation("project root is not inside a Git repository");
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/evidence/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/evidence/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,2EAA2E;AAC3E,yEAAyE;AACzE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC,qEAAqE;AACrE,2EAA2E;AAC3E,wEAAwE;AACxE,kBAAkB;AAClB,MAAM,WAAW,GAAG,uCAAuC,CAAC;AAO5D,SAAS,MAAM,CAAC,GAAW,EAAE,IAAc;IACzC,IAAI,CAAC;QACH,sEAAsE;QACtE,qEAAqE;QACrE,kEAAkE;QAClE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,qBAAqB,EAAE,GAAG,IAAI,CAAC,EAAE;YAChE,GAAG;YACH,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,EAAE,GAAG,IAAI;YACpB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,KAAK;YAAE,MAAM,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC;QAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACnG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,OAAO;YAAE,MAAM,KAAK,CAAC;QAC1C,MAAM,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAYD,8EAA8E;AAC9E,8EAA8E;AAC9E,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,YAAoB,EAAE,KAAa;IACjE,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,CAAC,QAAQ,CAAC,yDAAyD,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,OAAO,CAAC,QAAQ,CAAC,yDAAyD,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACjE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,QAAQ,CAAC,yDAAyD,CAAC,CAAC;IACpF,CAAC;IACD,OAAO;QACL,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE;QACxB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACpC,WAAW,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;KAC3C,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,6EAA6E;AAC7E,0CAA0C;AAC1C,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAa;IAC3D,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,OAAO,GAAe,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;IAChH,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,SAAoD,CAAC;IACzD,IAAI,WAAsD,CAAC;IAC3D,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QACrD,WAAW,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClF,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACtG,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,CAAC,UAAU,CAAC,6CAA6C,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,OAAO,CAAC,UAAU,CAAC,6CAA6C,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,UAAU,CAAC,6CAA6C,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAClF,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,OAAO,CAAC,UAAU,CAAC,6CAA6C,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,32 @@
+/**
+ * Integrations module for Loreforge v0.1.
+ * Provides generic instruction snippet exports and provider metadata.
+ */
+export { generateInstructions, quoteShell } from "../cli/instructions.js";
+export const PROVIDER_INTEGRATIONS = [
+    {
+        provider: "Google Antigravity (AGY)",
+        modelReported: "Gemini 3.8 Flash (High)",
+        genericSnippetSupported: true,
+        nativeHooksStatus: "deferred",
+        localCliExecution: "exercised",
+        notes: "Local CLI execution verified via Node subprocess and development scripts."
+    },
+    {
+        provider: "Meta Muse",
+        modelReported: "Muse Spark 1.3 (xhigh requested)",
+        genericSnippetSupported: true,
+        nativeHooksStatus: "deferred",
+        localCliExecution: "exercised",
+        notes: "Core storage and schemas implemented concurrently."
+    },
+    {
+        provider: "Other AI CLIs (Codex, Claude, etc.)",
+        modelReported: "Unspecified / User-supplied",
+        genericSnippetSupported: true,
+        nativeHooksStatus: "unverified",
+        localCliExecution: "pending",
+        notes: "Callable from any standard POSIX shell using the lore CLI."
+    }
+];
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAW1E,MAAM,CAAC,MAAM,qBAAqB,GAAuC;IACvE;QACE,QAAQ,EAAE,0BAA0B;QACpC,aAAa,EAAE,yBAAyB;QACxC,uBAAuB,EAAE,IAAI;QAC7B,iBAAiB,EAAE,UAAU;QAC7B,iBAAiB,EAAE,WAAW;QAC9B,KAAK,EAAE,2EAA2E;KACnF;IACD;QACE,QAAQ,EAAE,WAAW;QACrB,aAAa,EAAE,kCAAkC;QACjD,uBAAuB,EAAE,IAAI;QAC7B,iBAAiB,EAAE,UAAU;QAC7B,iBAAiB,EAAE,WAAW;QAC9B,KAAK,EAAE,oDAAoD;KAC5D;IACD;QACE,QAAQ,EAAE,qCAAqC;QAC/C,aAAa,EAAE,6BAA6B;QAC5C,uBAAuB,EAAE,IAAI;QAC7B,iBAAiB,EAAE,YAAY;QAC/B,iBAAiB,EAAE,SAAS;QAC5B,KAAK,EAAE,4DAA4D;KACpE;CACF,CAAC"}

package/dist/storage/db.js

@@ -0,0 +1,239 @@
+import { DatabaseSync } from "node:sqlite";
+import { chmodSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { CoreOpenError } from "../core/contracts.js";
+import { OpError } from "../core/errors.js";
+import { MIGRATIONS } from "./schema.js";
+// Lifecycle: open, pragma setup, versioned migrations, short synchronous
+// transactions. SQLite work never spans an await or a subprocess.
+export const DB_FILENAME = "loreforge.sqlite3";
+export const LEGACY_DB_FILENAME = "company.sqlite3";
+export const BUSY_TIMEOUT_MS = 5000;
+// New homes use loreforge.sqlite3. An existing company.sqlite3 in the same
+// directory is opened as-is so the rename does not orphan prior state.
+export function resolveDbPath(home) {
+    const next = join(home, DB_FILENAME);
+    const legacy = join(home, LEGACY_DB_FILENAME);
+    if (existsSync(next))
+        return next;
+    if (existsSync(legacy))
+        return legacy;
+    return next;
+}
+export function databaseExists(home) {
+    return existsSync(join(home, DB_FILENAME)) || existsSync(join(home, LEGACY_DB_FILENAME));
+}
+function errcodeOf(error) {
+    if (typeof error === "object" && error !== null && "errcode" in error) {
+        const code = error.errcode;
+        return typeof code === "number" ? code : null;
+    }
+    return null;
+}
+function codeOf(error) {
+    if (typeof error === "object" && error !== null && "code" in error) {
+        const code = error.code;
+        return typeof code === "string" ? code : null;
+    }
+    return null;
+}
+// SQLITE_BUSY (5) and SQLITE_LOCKED (6) surface with a generic code, so match
+// the numeric errcode first and fall back to the lock message text.
+export function isBusyError(error) {
+    const errcode = errcodeOf(error);
+    if (errcode === 5 || errcode === 6)
+        return true;
+    if (codeOf(error) === "ERR_SQLITE_BUSY")
+        return true;
+    const message = error instanceof Error ? error.message : String(error);
+    return /database is (locked|busy)|database table is locked/i.test(message);
+}
+export function isSqliteError(error) {
+    if (errcodeOf(error) !== null)
+        return true;
+    const code = codeOf(error);
+    return code !== null && code.startsWith("ERR_SQLITE_");
+}
+// Convert a storage-layer throw into an operation error. OpError and
+// CoreOpenError pass through; lock contention becomes BUSY; other SQLite
+// faults become IO with a sanitized message; anything else rethrows for the
+// dispatcher's INTERNAL mapping.
+export function toOpError(error) {
+    if (error instanceof OpError || error instanceof CoreOpenError)
+        return error;
+    if (isBusyError(error))
+        return OpError.busy("database is locked by another process");
+    if (isSqliteError(error))
+        return OpError.io("database access failed");
+    return error instanceof Error ? error : new Error("unknown storage failure");
+}
+export function beginImmediate(db) {
+    try {
+        db.exec("BEGIN IMMEDIATE");
+    }
+    catch (error) {
+        throw toOpError(error);
+    }
+}
+// Short synchronous read transaction for multi-query snapshots. No writes,
+// no subprocesses, no awaits inside.
+export function withRead(db, work) {
+    try {
+        db.exec("BEGIN");
+    }
+    catch (error) {
+        throw toOpError(error);
+    }
+    try {
+        const result = work();
+        try {
+            db.exec("COMMIT");
+        }
+        catch (error) {
+            try {
+                db.exec("ROLLBACK");
+            }
+            catch {
+                // Best-effort; the COMMIT failure below is what matters.
+            }
+            throw toOpError(error);
+        }
+        return result;
+    }
+    catch (error) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch {
+            // Best-effort; the original error below is what matters.
+        }
+        throw toOpError(error);
+    }
+}
+// Short synchronous write transaction. Any error rolls back every effect;
+// the receipt row is written by the caller inside the same transaction.
+export function withWrite(db, work) {
+    beginImmediate(db);
+    try {
+        const result = work();
+        try {
+            db.exec("COMMIT");
+        }
+        catch (error) {
+            try {
+                db.exec("ROLLBACK");
+            }
+            catch {
+                // Rollback best-effort; the COMMIT failure below explains the state.
+            }
+            throw toOpError(error);
+        }
+        return result;
+    }
+    catch (error) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch {
+            // Best-effort; the original error below is what matters.
+        }
+        throw toOpError(error);
+    }
+}
+function migrate(db) {
+    beginImmediate(db);
+    try {
+        db.exec("CREATE TABLE IF NOT EXISTS schema_migrations (version INTEGER PRIMARY KEY, applied_at INTEGER NOT NULL) STRICT");
+        const rows = db
+            .prepare("SELECT version FROM schema_migrations ORDER BY version")
+            .all();
+        const applied = new Set(rows.map((row) => row.version));
+        for (const migration of MIGRATIONS) {
+            if (!applied.has(migration.version)) {
+                db.exec(migration.sql);
+                db.prepare("INSERT INTO schema_migrations (version, applied_at) VALUES (?, ?)").run(migration.version, Date.now());
+            }
+        }
+        db.exec("COMMIT");
+    }
+    catch (error) {
+        try {
+            db.exec("ROLLBACK");
+        }
+        catch {
+            // Best-effort; the migration error below is what matters.
+        }
+        if (error instanceof CoreOpenError)
+            throw error;
+        if (error instanceof OpError && error.code === "BUSY") {
+            throw new CoreOpenError("BUSY", "database is locked by another process");
+        }
+        throw new CoreOpenError("IO", "database migration failed");
+    }
+}
+// Short synchronous pause between startup retries. openDatabase is
+// synchronous, so this is a bounded Date.now wait, never an await and never
+// a subprocess.
+function sleepSync(ms) {
+    const end = Date.now() + ms;
+    while (Date.now() < end) {
+        // Intentional bounded wait for a racing peer to finish startup.
+    }
+}
+// Open (creating if needed) the state directory database. Throws CoreOpenError
+// with IO for access failures or BUSY when the startup lock cannot be
+// acquired within the busy timeout.
+//
+// Concurrent first opens race inside setup: PRAGMA journal_mode = WAL does
+// not honor the connection busy timeout, so the loser sees SQLITE_BUSY while
+// the winner migrates. Retry the whole setup on lock contention within the
+// busy budget; only exhausted contention becomes BUSY, never IO. Genuine
+// failures (unreadable directory, unopenable file, failed migration) still
+// fail fast with IO.
+export function openDatabase(home) {
+    try {
+        mkdirSync(home, { recursive: true, mode: 0o700 });
+        chmodSync(home, 0o700);
+    }
+    catch {
+        throw new CoreOpenError("IO", "cannot create state directory");
+    }
+    const path = resolveDbPath(home);
+    const deadline = Date.now() + BUSY_TIMEOUT_MS;
+    for (;;) {
+        let db;
+        try {
+            db = new DatabaseSync(path);
+        }
+        catch {
+            throw new CoreOpenError("IO", "cannot open database file");
+        }
+        try {
+            db.exec("PRAGMA foreign_keys = ON");
+            db.exec(`PRAGMA busy_timeout = ${BUSY_TIMEOUT_MS}`);
+            db.exec("PRAGMA journal_mode = WAL");
+            chmodSync(path, 0o600);
+            migrate(db);
+            return db;
+        }
+        catch (error) {
+            try {
+                db.close();
+            }
+            catch {
+                // Best-effort close before retrying or reporting the open failure.
+            }
+            const retryable = (error instanceof CoreOpenError && error.code === "BUSY") || isBusyError(error);
+            if (!retryable) {
+                if (error instanceof CoreOpenError)
+                    throw error;
+                throw new CoreOpenError("IO", "cannot initialize database");
+            }
+            if (Date.now() >= deadline) {
+                throw new CoreOpenError("BUSY", "database is locked by another process");
+            }
+            sleepSync(25);
+        }
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/storage/db.js.map

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

package/dist/storage/faults.js

@@ -0,0 +1,12 @@
+// Private test seam for transaction-recovery tests (A08). The injector runs
+// at named write boundaries inside the handoff transaction and throws to
+// simulate a crash between writes. Set only from tests; never wired to an
+// environment variable, CLI flag, or normal operation.
+let injector = null;
+export function setFaultInjector(next) {
+    injector = next;
+}
+export function faultBoundary(boundary) {
+    injector?.(boundary);
+}
+//# sourceMappingURL=faults.js.map

package/dist/storage/faults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faults.js","sourceRoot":"","sources":["../../src/storage/faults.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,yEAAyE;AACzE,0EAA0E;AAC1E,uDAAuD;AAIvD,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAE1C,MAAM,UAAU,gBAAgB,CAAC,IAA0B;IACzD,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC;AACvB,CAAC"}

package/dist/storage/receipts.js

@@ -0,0 +1,82 @@
+import { createHash } from "node:crypto";
+import { OpError } from "../core/errors.js";
+export function receiptIdentity(request) {
+    if (request.operation === "project.register" || request.operation === "agent.register") {
+        return { scope: "global", actorKey: "registration" };
+    }
+    const scoped = request;
+    return { scope: scoped.projectId, actorKey: scoped.actorId };
+}
+function stableStringify(value) {
+    if (value === null || value === undefined)
+        return "null";
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(",")}]`;
+    if (typeof value === "object") {
+        const record = value;
+        const keys = Object.keys(record).sort();
+        return `{${keys.map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`).join(",")}}`;
+    }
+    const text = JSON.stringify(value);
+    if (typeof text !== "string")
+        throw new Error("unserializable receipt payload");
+    return text;
+}
+// Canonical request hash over operation, project scope, actor, and validated
+// payload (defaults applied, object keys recursively sorted, array order
+// preserved). Computed before any observation or timestamp is added.
+export function canonicalHash(request) {
+    const identity = receiptIdentity(request);
+    return createHash("sha256")
+        .update(stableStringify({
+        actor: identity.actorKey,
+        operation: request.operation,
+        payload: request.payload,
+        scope: identity.scope,
+    }))
+        .digest("hex");
+}
+// Control-flow signal: our receipt insert lost a cross-process race. The
+// surrounding helper rolls back and retries once, then replays or conflicts
+// from a fresh read. Never surfaces as IO.
+export class ReceiptClashError extends Error {
+    constructor() {
+        super("mutation receipt already recorded");
+        this.name = "ReceiptClashError";
+    }
+}
+export function isReceiptPkClash(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return /UNIQUE constraint failed: mutation_receipts/.test(message);
+}
+export function findReceipt(db, scope, actorKey, requestId) {
+    const row = db
+        .prepare("SELECT operation, request_hash, response_json FROM mutation_receipts WHERE scope = ? AND actor_key = ? AND request_id = ?")
+        .get(scope, actorKey, requestId);
+    return row;
+}
+export function insertReceipt(db, scope, actorKey, requestId, operation, requestHash, responseJson, nowMs) {
+    db.prepare("INSERT INTO mutation_receipts (scope, actor_key, request_id, operation, request_hash, response_json, created_at) VALUES (?, ?, ?, ?, ?, ?, ?)").run(scope, actorKey, requestId, operation, requestHash, responseJson, nowMs);
+}
+function replayOrConflict(row, request, hash) {
+    if (row.operation === request.operation && row.request_hash === hash) {
+        return JSON.parse(row.response_json);
+    }
+    throw OpError.conflict("requestId was already used with a different operation or payload");
+}
+// Pre-transaction receipt check plus transactional recheck. Simple mutations
+// (no outside-transaction work) run entirely through withMutation; handlers
+// with outside work (Git collection) call readReceipt early and storeReceipt
+// inside their own transaction.
+export function readReceipt(db, request) {
+    const identity = receiptIdentity(request);
+    const row = findReceipt(db, identity.scope, identity.actorKey, request.requestId);
+    if (!row)
+        return undefined;
+    return replayOrConflict(row, request, canonicalHash(request));
+}
+export function storeReceipt(db, request, data, nowMs) {
+    const identity = receiptIdentity(request);
+    insertReceipt(db, identity.scope, identity.actorKey, request.requestId, request.operation, canonicalHash(request), JSON.stringify(data), nowMs);
+}
+//# sourceMappingURL=receipts.js.map

package/dist/storage/receipts.js.map

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

package/dist/storage/schema.js

@@ -0,0 +1,119 @@
+// Versioned additive migrations. Never DROP existing state; each version
+// applies once inside the startup transaction in db.ts.
+// v1 creates every logical table from CONTRACT.md in one additive step so
+// later milestones add behavior, not schema. Domains are still implemented
+// and tested one milestone at a time.
+const V001 = `
+CREATE TABLE projects (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  root TEXT NOT NULL,
+  git_common_dir TEXT NOT NULL UNIQUE,
+  created_at INTEGER NOT NULL
+) STRICT;
+
+CREATE TABLE agents (
+  id TEXT PRIMARY KEY,
+  display_name TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+) STRICT;
+
+CREATE TABLE tasks (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects (id),
+  title TEXT NOT NULL,
+  description TEXT NOT NULL,
+  status TEXT NOT NULL,
+  owner_id TEXT NULL REFERENCES agents (id),
+  claim_token TEXT NULL,
+  attempt INTEGER NOT NULL,
+  lease_until INTEGER NULL,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+) STRICT;
+CREATE INDEX tasks_by_project ON tasks (project_id, created_at DESC, id ASC);
+
+CREATE TABLE task_dependencies (
+  task_id TEXT NOT NULL REFERENCES tasks (id),
+  depends_on_task_id TEXT NOT NULL REFERENCES tasks (id),
+  PRIMARY KEY (task_id, depends_on_task_id)
+) STRICT;
+CREATE INDEX task_dependencies_by_parent ON task_dependencies (depends_on_task_id);
+
+CREATE TABLE handoffs (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects (id),
+  task_id TEXT NOT NULL REFERENCES tasks (id),
+  actor_id TEXT NOT NULL REFERENCES agents (id),
+  attempt INTEGER NOT NULL,
+  outcome TEXT NOT NULL,
+  summary TEXT NOT NULL,
+  evidence_json TEXT NOT NULL,
+  unresolved_json TEXT NOT NULL,
+  next_steps_json TEXT NOT NULL,
+  blocking_ids_json TEXT NOT NULL,
+  observed_checkout_root TEXT NOT NULL,
+  observed_head TEXT NOT NULL,
+  observed_dirty INTEGER NOT NULL,
+  observed_collected_at INTEGER NOT NULL,
+  created_at INTEGER NOT NULL,
+  UNIQUE (task_id, attempt)
+) STRICT;
+CREATE INDEX handoffs_by_task ON handoffs (task_id, created_at DESC, id ASC);
+
+CREATE TABLE questions (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects (id),
+  task_id TEXT NOT NULL REFERENCES tasks (id),
+  from_agent_id TEXT NOT NULL REFERENCES agents (id),
+  to_agent_id TEXT NOT NULL REFERENCES agents (id),
+  body TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+) STRICT;
+CREATE INDEX questions_by_task ON questions (task_id, created_at DESC, id ASC);
+
+CREATE TABLE answers (
+  question_id TEXT PRIMARY KEY REFERENCES questions (id),
+  id TEXT NOT NULL,
+  actor_id TEXT NOT NULL REFERENCES agents (id),
+  body TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+) STRICT;
+
+CREATE TABLE decisions (
+  id TEXT PRIMARY KEY,
+  project_id TEXT NOT NULL REFERENCES projects (id),
+  actor_id TEXT NOT NULL REFERENCES agents (id),
+  body TEXT NOT NULL,
+  paths_json TEXT NOT NULL,
+  supersedes_id TEXT NULL REFERENCES decisions (id),
+  superseded_by_id TEXT NULL REFERENCES decisions (id),
+  created_at INTEGER NOT NULL
+) STRICT;
+CREATE INDEX decisions_by_project ON decisions (project_id, created_at DESC, id ASC);
+
+CREATE TABLE inbox_events (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_id TEXT NOT NULL REFERENCES projects (id),
+  recipient_id TEXT NOT NULL REFERENCES agents (id),
+  kind TEXT NOT NULL,
+  question_id TEXT NOT NULL REFERENCES questions (id),
+  task_id TEXT NOT NULL REFERENCES tasks (id),
+  body TEXT NOT NULL,
+  created_at INTEGER NOT NULL
+) STRICT;
+CREATE INDEX inbox_by_recipient ON inbox_events (project_id, recipient_id, id ASC);
+
+CREATE TABLE mutation_receipts (
+  scope TEXT NOT NULL,
+  actor_key TEXT NOT NULL,
+  request_id TEXT NOT NULL,
+  operation TEXT NOT NULL,
+  request_hash TEXT NOT NULL,
+  response_json TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  PRIMARY KEY (scope, actor_key, request_id)
+) STRICT;
+`;
+export const MIGRATIONS = [{ version: 1, sql: V001 }];
+//# sourceMappingURL=schema.js.map

package/dist/storage/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/storage/schema.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wDAAwD;AAOxD,0EAA0E;AAC1E,2EAA2E;AAC3E,sCAAsC;AACtC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GZ,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAgB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC"}