@pennixrv/trellis-core 0.6.45 → 0.7.0-beta.5

package/dist/mem/internal/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/mem/internal/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,IAAI,QAAe,CAAC;AACjC,eAAO,MAAM,eAAe,QAAyC,CAAC;AACtE,eAAO,MAAM,cAAc,QAAwC,CAAC;AACpE;2CAC2C;AAC3C,eAAO,MAAM,QAAQ,QAAsD,CAAC;AAC5E;;4DAE4D;AAC5D,eAAO,MAAM,aAAa,QAAuC,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CA8BnD;AASD,eAAO,MAAM,YAAY,QAExB,CAAC;AACF,eAAO,MAAM,WAAW,QAGvB,CAAC;AAiBF;;;+EAG+E;AAC/E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;8CAC8C;AAC9C,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;wEACwE;AACxE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBrD;AAED;4EAC4E;AAC5E,wBAAiB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAkBxD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/mem/internal/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,IAAI,QAAe,CAAC;AACjC,eAAO,MAAM,eAAe,QAAyC,CAAC;AACtE,eAAO,MAAM,cAAc,QAAwC,CAAC;AACpE;2CAC2C;AAC3C,eAAO,MAAM,QAAQ,QAAsD,CAAC;AAC5E;;4DAE4D;AAC5D,eAAO,MAAM,aAAa,QAAuC,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAYxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAUnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CA8BnD;AASD,eAAO,MAAM,YAAY,QAExB,CAAC;AACF,eAAO,MAAM,WAAW,QAGvB,CAAC;AAiBF;;;+EAG+E;AAC/E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;8CAC8C;AAC9C,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;wEACwE;AACxE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBrD;AAED;4EAC4E;AAC5E,wBAAiB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAkBxD"}

package/dist/mem/internal/paths.js

@@ -38,6 +38,51 @@ export function opencodeDataDir() {
         return path.join(xdg, "opencode");
     return path.join(HOME, ".local", "share", "opencode");
 }
+/**
+ * Cognition Devin CLI data root (terminal agent, not Devin Desktop / Cascade
+ * and not Factory Droid):
+ *   - Unix: `$XDG_DATA_HOME/devin/cli`, else `~/.local/share/devin/cli`
+ *   - Windows: `%APPDATA%\devin\cli` (official logs path; falls back to
+ *     `~/AppData/Roaming` when `APPDATA` is unset)
+ *
+ * Read per call so tests (and a caller that sets `XDG_DATA_HOME` / `APPDATA`)
+ * see their own value. `os.platform()` is also read per call, matching
+ * `HOME` reflecting a mocked `os.homedir()`.
+ */
+export function devinCliDataDir() {
+    if (os.platform() === "win32") {
+        const appData = process.env.APPDATA?.trim();
+        const base = appData && appData.length > 0
+            ? appData
+            : path.join(HOME, "AppData", "Roaming");
+        return path.join(base, "devin", "cli");
+    }
+    const xdg = process.env.XDG_DATA_HOME?.trim();
+    if (xdg)
+        return path.join(xdg, "devin", "cli");
+    return path.join(HOME, ".local", "share", "devin", "cli");
+}
+/**
+ * Resolve the Devin CLI session database (`sessions.db`), or `undefined`
+ * when `DEVIN_DB_PATH=:memory:` (no file to read).
+ *
+ *   1. `DEVIN_DB_PATH` — absolute path used as-is, `~/` expanded, relative
+ *      name joined to the data dir, `:memory:` meaning there is no file.
+ *   2. `<data>/sessions.db` — Cognition's default store. Missing file is a
+ *      normal empty result; the adapter checks existence.
+ */
+export function devinCliDbPath() {
+    const override = process.env.DEVIN_DB_PATH?.trim();
+    if (override) {
+        if (override === ":memory:")
+            return undefined;
+        const expanded = expandHome(override);
+        return path.isAbsolute(expanded)
+            ? expanded
+            : path.join(devinCliDataDir(), expanded);
+    }
+    return path.join(devinCliDataDir(), "sessions.db");
+}
 /**
  * Resolve the OpenCode session database, or `undefined` when this machine has
  * none (a normal empty result, not an error).

package/dist/mem/internal/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/mem/internal/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACpE;2CAC2C;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAC5E;;4DAE4D;AAC5D,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,KAAK,UAAU;YAAE,OAAO,SAAS,CAAC;QAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE3C,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,MAAqD,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,IAAI,OAAO,GAAG,MAAM,CAAC,OAAO;gBAAE,MAAM,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACtE,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,EAAE,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CACpC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CACnE,CAAC;AACF,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CACnC,OAAO,CAAC,GAAG,CAAC,2BAA2B;IACrC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CACtC,CAAC;AAEF,SAAS,wBAAwB,CAAC,YAAoB;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5E,MAAM,UAAU,GAAI,GAAgC,CAAC,UAAU,CAAC;QAChE,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;YAAE,OAAO,SAAS,CAAC;QAC3E,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC9B,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;+EAG+E;AAC/E,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;8CAC8C;AAC9C,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;wEACwE;AACxE,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC;IACpF,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC;IACjE,MAAM,iBAAiB,GAAG,wBAAwB,CAChD,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CACzC,CAAC;IACF,IAAI,iBAAiB;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrD,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,kBAAkB,GAAG,wBAAwB,CACjD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CACrD,CAAC;QACF,IAAI,kBAAkB;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;4EAC4E;AAC5E,MAAM,SAAS,CAAC,CAAC,OAAO,CAAC,IAAY;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO;IACjC,MAAM,KAAK,GAAa,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM;QAC7B,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,CAAC,WAAW,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBAC9B,IAAI,CAAC,CAAC,MAAM,EAAE;gBAAE,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/mem/internal/paths.ts"],"names":[],"mappings":"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"}

package/dist/mem/internal/sqlite-adapter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Shared SQLite adapter kit for mem readers (OpenCode, ZCode, Devin CLI).
+ *
+ * Schema contract, structured warnings, one-slot prepare/release, and a
+ * scan visitor that never retains raw rows. Platform files own path, table
+ * mapping, and dialogue cleaning — not another copy of these helpers.
+ *
+ * Access is always through `sqlite-readonly.ts`. No native module, WASM
+ * blob, system `sqlite3`, or `better-sqlite3`.
+ */
+import type { MemWarning } from "../types.js";
+import { SqliteParseError, type SqliteReadOnly, type SqliteRow, type SqliteTableInfo } from "./sqlite-readonly.js";
+/** Schema mismatch (missing table / column). Distinct from a truncated file. */
+export declare class SqliteSchemaError extends SqliteParseError {
+    constructor(message: string);
+}
+export interface SqliteWarningCopy {
+    unreadableCode: string;
+    snapshotUnstableCode: string;
+    /** Omit for ZCode: schema errors degrade to `unreadableCode`. */
+    schemaUnsupportedCode?: string;
+    writingMessage: (dbPath: string) => string;
+    unreadableMessage: (dbPath: string, error: SqliteParseError) => string;
+    unsupportedMessage?: (dbPath: string, error: SqliteParseError) => string;
+}
+/** Record one degradation per condition per command. */
+export declare function pushSqliteWarning(warnings: MemWarning[], dbPath: string, error: SqliteParseError, copy: SqliteWarningCopy): void;
+export declare function findTable(db: SqliteReadOnly, name: string): SqliteTableInfo;
+/** True when `CREATE TABLE` sql declares a column of this exact name.
+ * Line comments (`-- ...`) sit between columns in some live schemas (Devin
+ * CLI) and must not hide the next name. */
+export declare function declaresColumn(table: SqliteTableInfo, name: string): boolean;
+export declare function requireColumns(table: SqliteTableInfo, names: readonly string[]): void;
+export declare function requireOneOfColumns(table: SqliteTableInfo, candidates: readonly string[]): string;
+/** Re-check the first decoded row; CREATE TABLE parse and rows can disagree. */
+export declare function requireRowColumns(rows: readonly SqliteRow[] | SqliteRow, tableName: string, names: readonly string[]): void;
+/** Visit every row and always return false so `scanTable` retains nothing. */
+export declare function scanAndDiscard(db: SqliteReadOnly, tableName: string, visit: (row: SqliteRow) => void): void;
+export declare function withSqliteDb<T>(dbPath: string, warnings: MemWarning[], copy: SqliteWarningCopy, fallback: T, run: (db: SqliteReadOnly) => T): T;
+/** One-slot search-scoped store. Extract reuses it when the path matches. */
+export declare function createSqlitePreparedStore<T>(): {
+    prepare: (dbPath: string, load: () => T) => void;
+    release: () => void;
+    get: (dbPath: string) => T | undefined;
+};
+//# sourceMappingURL=sqlite-adapter.d.ts.map

package/dist/mem/internal/sqlite-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-adapter.d.ts","sourceRoot":"","sources":["../../../src/mem/internal/sqlite-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAEL,gBAAgB,EAGhB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAE9B,gFAAgF;AAChF,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,KAAK,MAAM,CAAC;IACvE,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,KAAK,MAAM,CAAC;CAC1E;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,UAAU,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAiBN;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAM3E;AAED;;2CAE2C;AAC3C,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO5E;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,IAAI,CAON;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,CAQR;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,IAAI,CASN;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAC5B,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,GAC9B,IAAI,CAKN;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,UAAU,EAAE,EACtB,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,CAAC,EACX,GAAG,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,CAAC,GAC7B,CAAC,CAcH;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,CAAC,KAAK;IAC9C,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;CACxC,CAaA"}

package/dist/mem/internal/sqlite-adapter.js

@@ -0,0 +1,116 @@
+/**
+ * Shared SQLite adapter kit for mem readers (OpenCode, ZCode, Devin CLI).
+ *
+ * Schema contract, structured warnings, one-slot prepare/release, and a
+ * scan visitor that never retains raw rows. Platform files own path, table
+ * mapping, and dialogue cleaning — not another copy of these helpers.
+ *
+ * Access is always through `sqlite-readonly.ts`. No native module, WASM
+ * blob, system `sqlite3`, or `better-sqlite3`.
+ */
+import * as fs from "node:fs";
+import { openSqliteReadOnly, SqliteParseError, SqliteSnapshotUnstableError, stripSqlLineComments, } from "./sqlite-readonly.js";
+/** Schema mismatch (missing table / column). Distinct from a truncated file. */
+export class SqliteSchemaError extends SqliteParseError {
+    constructor(message) {
+        super(message);
+        this.name = "SqliteSchemaError";
+    }
+}
+/** Record one degradation per condition per command. */
+export function pushSqliteWarning(warnings, dbPath, error, copy) {
+    const code = error instanceof SqliteSnapshotUnstableError
+        ? copy.snapshotUnstableCode
+        : error instanceof SqliteSchemaError && copy.schemaUnsupportedCode
+            ? copy.schemaUnsupportedCode
+            : copy.unreadableCode;
+    if (warnings.some((warning) => warning.code === code))
+        return;
+    const message = code === copy.snapshotUnstableCode
+        ? copy.writingMessage(dbPath)
+        : code === copy.schemaUnsupportedCode
+            ? (copy.unsupportedMessage?.(dbPath, error) ??
+                copy.unreadableMessage(dbPath, error))
+            : copy.unreadableMessage(dbPath, error);
+    warnings.push({ code, message });
+}
+export function findTable(db, name) {
+    const table = db.listTables().find((item) => item.name === name);
+    if (!table) {
+        throw new SqliteSchemaError(`missing table: ${name}`);
+    }
+    return table;
+}
+/** True when `CREATE TABLE` sql declares a column of this exact name.
+ * Line comments (`-- ...`) sit between columns in some live schemas (Devin
+ * CLI) and must not hide the next name. */
+export function declaresColumn(table, name) {
+    const sql = stripSqlLineComments(table.sql);
+    const pattern = new RegExp(`(?:\\(|,)\\s*["\`\\[]?${name}(?:["\`\\]]|\\b)`, "i");
+    return pattern.test(sql);
+}
+export function requireColumns(table, names) {
+    const missing = names.filter((name) => !declaresColumn(table, name));
+    if (missing.length > 0) {
+        throw new SqliteSchemaError(`table ${table.name} is missing column(s): ${missing.join(", ")}`);
+    }
+}
+export function requireOneOfColumns(table, candidates) {
+    const found = candidates.find((name) => declaresColumn(table, name));
+    if (!found) {
+        throw new SqliteSchemaError(`table ${table.name} has none of the expected column(s): ${candidates.join(" / ")}`);
+    }
+    return found;
+}
+/** Re-check the first decoded row; CREATE TABLE parse and rows can disagree. */
+export function requireRowColumns(rows, tableName, names) {
+    const first = Array.isArray(rows) ? rows[0] : rows;
+    if (!first)
+        return;
+    const missing = names.filter((name) => !(name in first));
+    if (missing.length > 0) {
+        throw new SqliteSchemaError(`table ${tableName} is missing column(s): ${missing.join(", ")}`);
+    }
+}
+/** Visit every row and always return false so `scanTable` retains nothing. */
+export function scanAndDiscard(db, tableName, visit) {
+    db.scanTable(tableName, (row) => {
+        visit(row);
+        return false;
+    });
+}
+export function withSqliteDb(dbPath, warnings, copy, fallback, run) {
+    if (!fs.existsSync(dbPath))
+        return fallback;
+    try {
+        const db = openSqliteReadOnly(dbPath);
+        try {
+            return run(db);
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (error) {
+        if (!(error instanceof SqliteParseError))
+            throw error;
+        pushSqliteWarning(warnings, dbPath, error, copy);
+        return fallback;
+    }
+}
+/** One-slot search-scoped store. Extract reuses it when the path matches. */
+export function createSqlitePreparedStore() {
+    let slot = null;
+    return {
+        prepare(dbPath, load) {
+            slot = { dbPath, store: load() };
+        },
+        release() {
+            slot = null;
+        },
+        get(dbPath) {
+            return slot?.dbPath === dbPath ? slot.store : undefined;
+        },
+    };
+}
+//# sourceMappingURL=sqlite-adapter.js.map

package/dist/mem/internal/sqlite-adapter.js.map

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

package/dist/mem/internal/sqlite-readonly.d.ts

@@ -61,6 +61,9 @@ export declare class SqliteParseError extends Error {
 export declare class SqliteSnapshotUnstableError extends SqliteParseError {
     constructor(mainPath: string);
 }
+/** Strip `-- line comments` so a comma on the previous line still reveals
+ * the next column. Live Devin CLI `CREATE TABLE` SQL uses that layout. */
+export declare function stripSqlLineComments(sql: string): string;
 /**
  * Open a SQLite database file for read-only access. Automatically loads the
  * sibling `<db>-wal` file when present so active WAL-mode databases (e.g.

package/dist/mem/internal/sqlite-readonly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-readonly.d.ts","sourceRoot":"","sources":["../../../src/mem/internal/sqlite-readonly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH;;;iFAGiF;AACjF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,UAAU,IAAI,eAAe,EAAE,CAAC;IAChC;sEACkE;IAClE,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,GACtC,SAAS,EAAE,CAAC;IACf,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAID;6EAC6E;AAC7E,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBADxB,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,gBAAgB;gBACnD,QAAQ,EAAE,MAAM;CAM7B;AAyxBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CA2HnE;AAED;;uBAEuB;AACvB,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,SAAS,EAAE,CAWb"}
+{"version":3,"file":"sqlite-readonly.d.ts","sourceRoot":"","sources":["../../../src/mem/internal/sqlite-readonly.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH;;;iFAGiF;AACjF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,UAAU,IAAI,eAAe,EAAE,CAAC;IAChC;sEACkE;IAClE,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,GACtC,SAAS,EAAE,CAAC;IACf,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAID;6EAC6E;AAC7E,qBAAa,gBAAiB,SAAQ,KAAK;IAGvC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;gBADxB,OAAO,EAAE,MAAM,EACN,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED;;;;GAIG;AACH,qBAAa,2BAA4B,SAAQ,gBAAgB;gBACnD,QAAQ,EAAE,MAAM;CAM7B;AAq1BD;0EAC0E;AAC1E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAID;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CA8KnE;AAED;;uBAEuB;AACvB,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,SAAS,EAAE,CAWb"}

package/dist/mem/internal/sqlite-readonly.js

@@ -177,16 +177,18 @@ function equalBytes(a, b) {
     }
     return true;
 }
+function stampFromStat(stat) {
+    return {
+        size: stat.size,
+        mtimeMs: stat.mtimeMs,
+        ctimeMs: stat.ctimeMs,
+        dev: stat.dev,
+        ino: stat.ino,
+    };
+}
 function fileStamp(path) {
     try {
-        const stat = fs.statSync(path);
-        return {
-            size: stat.size,
-            mtimeMs: stat.mtimeMs,
-            ctimeMs: stat.ctimeMs,
-            dev: stat.dev,
-            ino: stat.ino,
-        };
+        return stampFromStat(fs.statSync(path));
     }
     catch (error) {
         const code = error.code;
@@ -195,6 +197,9 @@ function fileStamp(path) {
         throw error;
     }
 }
+function fileDescriptorStamp(fd) {
+    return stampFromStat(fs.fstatSync(fd));
+}
 function sameStamp(a, b) {
     if (a === null || b === null)
         return a === b;
@@ -270,6 +275,7 @@ function captureSnapshot(mainPath) {
     const shmPath = mainPath + "-shm";
     let lastError;
     for (let attempt = 0; attempt < SNAPSHOT_ATTEMPTS; attempt++) {
+        let mainFd = null;
         try {
             const shmBefore = readWalIndexPrefix(shmPath);
             const mainBefore = fileStamp(mainPath);
@@ -277,7 +283,7 @@ function captureSnapshot(mainPath) {
             if (mainBefore === null) {
                 throw new SqliteParseError(`cannot read db file: ${mainPath}`);
             }
-            const mainBytes = fs.readFileSync(mainPath);
+            mainFd = fs.openSync(mainPath, "r");
             const walBytes = readOptionalFile(walPath);
             const mainAfter = fileStamp(mainPath);
             const walAfter = fileStamp(walPath);
@@ -285,13 +291,22 @@ function captureSnapshot(mainPath) {
             if (!sameStamp(mainBefore, mainAfter) ||
                 !sameStamp(walBefore, walAfter) ||
                 !equalBytes(shmBefore, shmAfter)) {
+                fs.closeSync(mainFd);
+                mainFd = null;
                 lastError = new SqliteSnapshotUnstableError(mainPath);
                 continue;
             }
             const walIndex = walBytes === null ? null : parseWalIndexHeader(shmAfter);
-            return { mainBytes, walBytes, walIndex };
+            return {
+                mainFd,
+                mainStamp: mainAfter ?? mainBefore,
+                walBytes,
+                walIndex,
+            };
         }
         catch (error) {
+            if (mainFd !== null)
+                fs.closeSync(mainFd);
             lastError = error;
         }
     }
@@ -394,7 +409,7 @@ function loadWal(walBytes, expectedPageSize, walIndex) {
     }
     return { pageMap };
 }
-function makePageSource(mainBytes, header, wal) {
+function makePageSource(snapshot, header, wal) {
     return {
         pageSize: header.pageSize,
         getPage(pgno) {
@@ -406,14 +421,46 @@ function makePageSource(mainBytes, header, wal) {
             }
             const start = (pgno - 1) * header.pageSize;
             const end = start + header.pageSize;
-            if (end > mainBytes.length) {
+            if (end > snapshot.mainStamp.size) {
                 // Page lives beyond the main file and has no WAL copy — treat as empty.
                 return new Uint8Array(header.pageSize);
             }
-            return mainBytes.subarray(start, end);
+            const page = new Uint8Array(header.pageSize);
+            const bytesRead = readExactly(snapshot.mainFd, page, start);
+            if (bytesRead !== header.pageSize) {
+                throw new SqliteParseError(`short read for SQLite page ${pgno}`);
+            }
+            return page;
         },
     };
 }
+function readExactly(fd, target, position) {
+    let offset = 0;
+    while (offset < target.length) {
+        const bytesRead = fs.readSync(fd, target, offset, target.length - offset, position + offset);
+        if (bytesRead === 0)
+            break;
+        offset += bytesRead;
+    }
+    return offset;
+}
+function readMainHeader(snapshot) {
+    const bytes = new Uint8Array(DB_HEADER_SIZE);
+    const bytesRead = readExactly(snapshot.mainFd, bytes, 0);
+    if (bytesRead !== DB_HEADER_SIZE) {
+        throw new SqliteParseError("SQLite database header is truncated");
+    }
+    return bytes;
+}
+function isMainSnapshotStable(mainPath, snapshot) {
+    try {
+        return (sameStamp(snapshot.mainStamp, fileStamp(mainPath)) &&
+            sameStamp(snapshot.mainStamp, fileDescriptorStamp(snapshot.mainFd)));
+    }
+    catch {
+        return false;
+    }
+}
 /** Decode a record body (the payload of a table-leaf cell) into an array of
  * JS values. Serial type reference: https://www.sqlite.org/fileformat2.html
  * section 2.1. Only TEXT / INTEGER / NULL / float / BLOB are handled. The
@@ -613,11 +660,12 @@ function decodeLeafCell(page, cellOff, src, header, td) {
  * not columns.
  */
 function parseColumnNames(sql) {
-    const open = sql.indexOf("(");
-    const close = sql.lastIndexOf(")");
+    const cleaned = stripSqlLineComments(sql);
+    const open = cleaned.indexOf("(");
+    const close = cleaned.lastIndexOf(")");
     if (open < 0 || close < 0 || close <= open)
         return null;
-    const body = sql.slice(open + 1, close);
+    const body = cleaned.slice(open + 1, close);
     const segments = splitTopLevelCommas(body);
     const cols = [];
     for (const seg of segments) {
@@ -661,6 +709,11 @@ function firstIdentifier(piece) {
 function isConstraintKeyword(id) {
     return /^(primary|unique|check|foreign|constraint)$/i.test(id);
 }
+/** Strip `-- line comments` so a comma on the previous line still reveals
+ * the next column. Live Devin CLI `CREATE TABLE` SQL uses that layout. */
+export function stripSqlLineComments(sql) {
+    return sql.replace(/--[^\n]*/g, " ");
+}
 // ---------- public entry ----------
 /**
  * Open a SQLite database file for read-only access. Automatically loads the
@@ -672,13 +725,53 @@ function isConstraintKeyword(id) {
  */
 export function openSqliteReadOnly(mainPath) {
     const snapshot = captureSnapshot(mainPath);
-    const { mainBytes } = snapshot;
-    if (mainBytes.length < DB_HEADER_SIZE) {
-        throw new SqliteParseError(`db file too small: ${mainPath}`);
+    let closed = false;
+    let header;
+    let src;
+    try {
+        if (snapshot.mainStamp.size < DB_HEADER_SIZE) {
+            throw new SqliteParseError(`db file too small: ${mainPath}`);
+        }
+        header = parseDbHeader(readMainHeader(snapshot));
+        const wal = loadWal(snapshot.walBytes, header.pageSize, snapshot.walIndex);
+        src = makePageSource(snapshot, header, wal);
+        if (!isMainSnapshotStable(mainPath, snapshot)) {
+            throw new SqliteSnapshotUnstableError(mainPath);
+        }
+    }
+    catch (error) {
+        fs.closeSync(snapshot.mainFd);
+        throw error instanceof SqliteParseError
+            ? error
+            : new SqliteParseError(`cannot read db file: ${mainPath}`, error);
+    }
+    function assertOpen() {
+        if (closed)
+            throw new SqliteParseError("SQLite reader is closed");
+    }
+    function assertMainSnapshotStable() {
+        if (!isMainSnapshotStable(mainPath, snapshot)) {
+            throw new SqliteSnapshotUnstableError(mainPath);
+        }
+    }
+    function readStable(read) {
+        assertOpen();
+        try {
+            const value = read();
+            assertMainSnapshotStable();
+            return value;
+        }
+        catch (error) {
+            if (error instanceof SqliteSnapshotUnstableError)
+                throw error;
+            if (!isMainSnapshotStable(mainPath, snapshot)) {
+                throw new SqliteSnapshotUnstableError(mainPath);
+            }
+            throw error instanceof SqliteParseError
+                ? error
+                : new SqliteParseError(`failed reading SQLite snapshot: ${mainPath}`, error);
+        }
     }
-    const header = parseDbHeader(mainBytes);
-    const wal = loadWal(snapshot.walBytes, header.pageSize, snapshot.walIndex);
-    const src = makePageSource(mainBytes, header, wal);
     // Column-name cache: tableName → column list (or null).
     const columnCache = new Map();
     function readSqliteMaster() {
@@ -708,11 +801,12 @@ export function openSqliteReadOnly(mainPath) {
     function rowidAliasIndex(table, columns) {
         if (!table.sql || !columns)
             return -1;
-        const open = table.sql.indexOf("(");
-        const close = table.sql.lastIndexOf(")");
+        const cleaned = stripSqlLineComments(table.sql);
+        const open = cleaned.indexOf("(");
+        const close = cleaned.lastIndexOf(")");
         if (open < 0 || close < 0)
             return -1;
-        const body = table.sql.slice(open + 1, close);
+        const body = cleaned.slice(open + 1, close);
         const segments = splitTopLevelCommas(body);
         let idx = 0;
         for (const seg of segments) {
@@ -734,46 +828,51 @@ export function openSqliteReadOnly(mainPath) {
     return {
         dbPath: mainPath,
         listTables() {
-            return readSqliteMaster();
+            return readStable(readSqliteMaster);
         },
         scanTable(tableName, predicate) {
-            let table;
-            try {
-                table = readSqliteMaster().find((t) => t.name === tableName);
-                if (!table || table.rootPgno <= 0)
-                    return [];
-                const columns = columnsFor(table);
-                const aliasIdx = rowidAliasIndex(table, columns);
-                const rows = [];
-                visitTableBtree(src, table.rootPgno, header.textEncoding, header, ({ rowid, values }) => {
-                    const row = {};
-                    for (let i = 0; i < values.length; i++) {
-                        const key = columns?.[i] ?? `col${i}`;
-                        // INTEGER PRIMARY KEY columns store NULL in the record; the real
-                        // value is the cell rowid. Splice it in so callers see the integer.
-                        if (i === aliasIdx && values[i] === null) {
-                            row[key] = rowid;
-                        }
-                        else {
-                            row[key] = values[i];
+            return readStable(() => {
+                let table;
+                try {
+                    table = readSqliteMaster().find((t) => t.name === tableName);
+                    if (!table || table.rootPgno <= 0)
+                        return [];
+                    const columns = columnsFor(table);
+                    const aliasIdx = rowidAliasIndex(table, columns);
+                    const rows = [];
+                    visitTableBtree(src, table.rootPgno, header.textEncoding, header, ({ rowid, values }) => {
+                        const row = {};
+                        for (let i = 0; i < values.length; i++) {
+                            const key = columns?.[i] ?? `col${i}`;
+                            // INTEGER PRIMARY KEY columns store NULL in the record; the real
+                            // value is the cell rowid. Splice it in so callers see the integer.
+                            if (i === aliasIdx && values[i] === null) {
+                                row[key] = rowid;
+                            }
+                            else {
+                                row[key] = values[i];
+                            }
                         }
-                    }
-                    if (!predicate || predicate(row))
-                        rows.push(row);
-                });
-                return rows;
-            }
-            catch (e) {
-                // Wrap any non-SqliteParseError (e.g. RangeError from a truncated
-                // float64, TypeError from a bad cell pointer) so the adapter's single
-                // catch on SqliteParseError degrades cleanly instead of crashing CLI.
-                throw e instanceof SqliteParseError
-                    ? e
-                    : new SqliteParseError(`failed reading table "${tableName}"`, e);
-            }
+                        if (!predicate || predicate(row))
+                            rows.push(row);
+                    });
+                    return rows;
+                }
+                catch (error) {
+                    // Wrap any non-SqliteParseError (e.g. RangeError from a truncated
+                    // float64, TypeError from a bad cell pointer) so the adapter's single
+                    // catch on SqliteParseError degrades cleanly instead of crashing CLI.
+                    throw error instanceof SqliteParseError
+                        ? error
+                        : new SqliteParseError(`failed reading table "${tableName}"`, error);
+                }
+            });
         },
         close() {
-            // Nothing to release — we read the whole file into memory at open time.
+            if (closed)
+                return;
+            closed = true;
+            fs.closeSync(snapshot.mainFd);
         },
     };
 }