latticesql 0.18.2 → 0.18.4

package/README.md

@@ -2012,6 +2012,14 @@ Three complete, commented examples are in [docs/examples/](./docs/examples/):
 
 ---
 
+## Staying up to date
+
+**CLI users:** The `lattice` CLI checks for new versions automatically and prints a notice when an update is available. Run `lattice update` to upgrade in place. Alternatively, use `npx lattice` to always run the latest version without a global install.
+
+**Library consumers:** By default, `npm install latticesql` adds a `^` semver range to your `package.json`, so patch and minor updates are picked up on your next `npm install`. For fully automated dependency updates, set up [Dependabot](https://docs.github.com/en/code-security/dependabot) or [Renovate](https://github.com/renovatebot/renovate) — they'll create PRs in your repo whenever a new version is published.
+
+---
+
 ## Contributing
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for dev setup, test commands, and contribution guidelines.

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { resolve as resolve3, dirname as dirname5 } from "path";
-import { readFileSync as readFileSync6 } from "fs";
+import { resolve as resolve4, dirname as dirname5 } from "path";
+import { readFileSync as readFileSync7 } from "fs";
+import { execSync } from "child_process";
 import { parse as parse2 } from "yaml";
 
 // src/codegen/generate.ts
@@ -493,7 +494,7 @@ var SchemaManager = class {
   applySchema(adapter) {
     for (const [name, def] of this._tables) {
       const pkCols = this._tablePK.get(name) ?? ["id"];
-      let constraints = def.tableConstraints ? [...def.tableConstraints] : [];
+      const constraints = def.tableConstraints ? [...def.tableConstraints] : [];
       if (pkCols.length > 1) {
         const alreadyHasPK = constraints.some((c) => c.toUpperCase().startsWith("PRIMARY KEY"));
         if (!alreadyHasPK) {
@@ -537,7 +538,7 @@ var SchemaManager = class {
   queryTable(adapter, name) {
     if (this._tables.has(name)) {
       const def = this._tables.get(name);
-      if (def.columns && "deleted_at" in def.columns) {
+      if (def?.columns && "deleted_at" in def.columns) {
         return adapter.all(`SELECT * FROM "${name}" WHERE deleted_at IS NULL`);
       }
       return adapter.all(`SELECT * FROM "${name}"`);
@@ -634,8 +635,8 @@ var Sanitizer = class {
 };
 
 // src/render/engine.ts
-import { join as join5 } from "path";
-import { mkdirSync as mkdirSync3 } from "fs";
+import { join as join5, basename, isAbsolute, resolve as resolve3 } from "path";
+import { mkdirSync as mkdirSync3, existsSync as existsSync5, copyFileSync } from "fs";
 
 // src/render/entity-query.ts
 var SAFE_COL_RE = /^[a-zA-Z0-9_]+$/;
@@ -721,7 +722,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
     case "self":
       return [entityRow];
     case "hasMany": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -733,7 +734,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "manyToMany": {
-      if (protection && protection.protectedTables.has(source.remoteTable)) {
+      if (protection?.protectedTables.has(source.remoteTable)) {
         if (source.remoteTable === protection.currentTable) return [entityRow];
         return [];
       }
@@ -759,7 +760,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "belongsTo": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -1175,6 +1176,22 @@ var RenderEngine = class {
         const slug = def.slug(entityRow);
         const entityDir = def.directory ? join5(outputDir, def.directory(entityRow)) : join5(outputDir, directoryRoot, slug);
         mkdirSync3(entityDir, { recursive: true });
+        if (def.attachFileColumn) {
+          const filePath = entityRow[def.attachFileColumn];
+          if (filePath && typeof filePath === "string" && filePath.length > 0) {
+            const absPath = isAbsolute(filePath) ? filePath : resolve3(outputDir, filePath);
+            if (existsSync5(absPath)) {
+              const destPath = join5(entityDir, basename(absPath));
+              if (!existsSync5(destPath)) {
+                try {
+                  copyFileSync(absPath, destPath);
+                  filesWritten.push(destPath);
+                } catch {
+                }
+              }
+            }
+          }
+        }
         const renderedFiles = /* @__PURE__ */ new Map();
         const entityFileHashes = {};
         const protection = protectedTables.size > 0 ? { protectedTables, currentTable: table } : void 0;
@@ -1224,7 +1241,7 @@ var RenderEngine = class {
 
 // src/reverse-sync/engine.ts
 import { join as join6 } from "path";
-import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync4 } from "fs";
 var ReverseSyncEngine = class {
   _schema;
   _adapter;
@@ -1276,7 +1293,7 @@ var ReverseSyncEngine = class {
           if (!fileInfo.hash) continue;
           const filePath = join6(entityDir, filename);
           result.filesScanned++;
-          if (!existsSync5(filePath)) continue;
+          if (!existsSync6(filePath)) continue;
           let currentContent;
           try {
             currentContent = readFileSync4(filePath, "utf8");
@@ -1376,8 +1393,8 @@ var SyncLoop = class {
 };
 
 // src/writeback/pipeline.ts
-import { readFileSync as readFileSync5, statSync as statSync2, existsSync as existsSync6, readdirSync as readdirSync2 } from "fs";
-import { join as join7, dirname as dirname4, basename } from "path";
+import { readFileSync as readFileSync5, statSync as statSync2, existsSync as existsSync7, readdirSync as readdirSync2 } from "fs";
+import { join as join7, dirname as dirname4, basename as basename2 } from "path";
 
 // src/writeback/state-store.ts
 var InMemoryStateStore = class {
@@ -1427,7 +1444,7 @@ var WritebackPipeline = class {
     let processed = 0;
     const store = def.stateStore ?? this._stateStore;
     for (const filePath of paths) {
-      if (!existsSync6(filePath)) continue;
+      if (!existsSync7(filePath)) continue;
       const stat = statSync2(filePath);
       const currentSize = stat.size;
       const storedOffset = store.getOffset(filePath);
@@ -1461,8 +1478,8 @@ var WritebackPipeline = class {
       return [pattern];
     }
     const dir = dirname4(pattern);
-    const filePattern = basename(pattern);
-    if (!existsSync6(dir)) return [];
+    const filePattern = basename2(pattern);
+    if (!existsSync7(dir)) return [];
     const regexStr = filePattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
     const regex = new RegExp(`^${regexStr}$`);
     return readdirSync2(dir).filter((f) => regex.test(f)).map((f) => join7(dir, f));
@@ -1774,9 +1791,7 @@ var Lattice = class {
           `Entity context "${table}" has encrypted: true but no encryptionKey was provided in Lattice options`
         );
       }
-      if (!this._encryptionKey) {
-        this._encryptionKey = deriveKey(this._encryptionKeyRaw);
-      }
+      this._encryptionKey ??= deriveKey(this._encryptionKeyRaw);
       const pragmaRows = this._adapter.all(`PRAGMA table_info("${table}")`);
       const allCols = pragmaRows.map((r) => r.name);
       const encCols = resolveEncryptedColumns(def.encrypted, allCols);
@@ -2605,6 +2620,49 @@ var Lattice = class {
   }
 };
 
+// src/update-check.ts
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4, existsSync as existsSync8 } from "fs";
+import { join as join8 } from "path";
+import { homedir } from "os";
+var ONE_DAY_MS = 864e5;
+function isNewer(latest, current) {
+  const a = latest.split(".").map(Number);
+  const b = current.split(".").map(Number);
+  for (let i = 0; i < Math.max(a.length, b.length); i++) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    if (av > bv) return true;
+    if (av < bv) return false;
+  }
+  return false;
+}
+async function checkForUpdate(pkgName, currentVersion) {
+  const cacheDir = join8(homedir(), `.${pkgName}`);
+  const cachePath = join8(cacheDir, "update-check.json");
+  try {
+    if (existsSync8(cachePath)) {
+      const cached = JSON.parse(readFileSync6(cachePath, "utf-8"));
+      if (Date.now() - cached.checked < ONE_DAY_MS) {
+        return isNewer(cached.latest, currentVersion) ? cached.latest : null;
+      }
+    }
+  } catch {
+  }
+  const res = await fetch(`https://registry.npmjs.org/${pkgName}/latest`, {
+    headers: { accept: "application/json" },
+    signal: AbortSignal.timeout(5e3)
+  });
+  if (!res.ok) return null;
+  const data = await res.json();
+  const latest = data.version;
+  try {
+    if (!existsSync8(cacheDir)) mkdirSync4(cacheDir, { recursive: true });
+    writeFileSync3(cachePath, JSON.stringify({ latest, checked: Date.now() }));
+  } catch {
+  }
+  return isNewer(latest, currentVersion) ? latest : null;
+}
+
 // src/cli.ts
 function parseArgs(argv) {
   let command;
@@ -2691,6 +2749,7 @@ function printHelp() {
       "  reconcile   Render + cleanup orphaned entity directories and files",
       "  status      Dry-run reconcile \u2014 show what would change without writing",
       "  watch       Poll for changes and re-render on each cycle",
+      "  update      Upgrade latticesql to the latest version",
       "",
       "Options (generate):",
       "  --config, -c <path>    Path to config file (default: ./lattice.config.yml)",
@@ -2728,20 +2787,40 @@ function printHelp() {
     ].join("\n")
   );
 }
-function printVersion() {
+function getVersion() {
   try {
     const pkgPath = new URL("../package.json", import.meta.url).pathname;
-    const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
-    console.log(pkg.version);
+    const pkg = JSON.parse(readFileSync7(pkgPath, "utf-8"));
+    return pkg.version;
+  } catch {
+    return "unknown";
+  }
+}
+function printVersion() {
+  console.log(getVersion());
+}
+async function runUpdate() {
+  const currentVersion = getVersion();
+  console.log(`Current version: ${currentVersion}`);
+  const latest = await checkForUpdate("latticesql", currentVersion);
+  if (!latest) {
+    console.log("Already up to date.");
+    return;
+  }
+  console.log(`Updating to ${latest}...`);
+  try {
+    execSync("npm install -g latticesql@latest", { stdio: "inherit" });
+    console.log(`Updated latticesql ${currentVersion} \u2192 ${latest}`);
   } catch {
-    console.log("unknown");
+    console.error("Update failed. Try running manually: npm install -g latticesql@latest");
+    process.exit(1);
   }
 }
 function runGenerate(args) {
-  const configPath = resolve3(args.config);
+  const configPath = resolve4(args.config);
   let raw;
   try {
-    raw = readFileSync6(configPath, "utf-8");
+    raw = readFileSync7(configPath, "utf-8");
   } catch {
     console.error(`Error: cannot read config file at "${configPath}"`);
     process.exit(1);
@@ -2758,7 +2837,7 @@ function runGenerate(args) {
     process.exit(1);
   }
   const configDir = dirname5(configPath);
-  const outDir = resolve3(args.out);
+  const outDir = resolve4(args.out);
   try {
     const result = generateAll({ config, configDir, outDir, scaffold: args.scaffold });
     console.log(`Generated ${String(result.filesWritten.length)} file(s):`);
@@ -2771,15 +2850,15 @@ function runGenerate(args) {
   }
 }
 async function runRender(args) {
-  const outputDir = resolve3(args.output);
+  const outputDir = resolve4(args.output);
   let parsed;
   try {
-    parsed = parseConfigFile(resolve3(args.config));
+    parsed = parseConfigFile(resolve4(args.config));
   } catch (e) {
     console.error(`Error: ${e.message}`);
     process.exit(1);
   }
-  const db = new Lattice({ config: resolve3(args.config) });
+  const db = new Lattice({ config: resolve4(args.config) });
   try {
     await db.init();
     const start = Date.now();
@@ -2798,8 +2877,8 @@ async function runRender(args) {
   void parsed;
 }
 async function runReconcile(args, isDryRun) {
-  const outputDir = resolve3(args.output);
-  const db = new Lattice({ config: resolve3(args.config) });
+  const outputDir = resolve4(args.output);
+  const db = new Lattice({ config: resolve4(args.config) });
   try {
     await db.init();
     const start = Date.now();
@@ -2858,8 +2937,8 @@ function formatTimestamp() {
   return `${hh}:${mm}:${ss}`;
 }
 async function runWatch(args) {
-  const outputDir = resolve3(args.output);
-  const db = new Lattice({ config: resolve3(args.config) });
+  const outputDir = resolve4(args.output);
+  const db = new Lattice({ config: resolve4(args.config) });
   try {
     await db.init();
   } catch (e) {
@@ -2908,6 +2987,19 @@ function main() {
     printHelp();
     process.exit(args.command === void 0 && !args.help ? 1 : 0);
   }
+  const version = getVersion();
+  if (version !== "unknown") {
+    checkForUpdate("latticesql", version).then((latest) => {
+      if (latest) {
+        process.on("exit", () => {
+          console.log(
+            `
+Update available: ${version} \u2192 ${latest} \u2014 run "lattice update" to upgrade`
+          );
+        });
+      }
+    }).catch(() => void 0);
+  }
   switch (args.command) {
     case "generate":
       runGenerate(args);
@@ -2924,6 +3016,9 @@ function main() {
     case "watch":
       void runWatch(args);
       break;
+    case "update":
+      void runUpdate();
+      break;
     default:
       console.error(`Unknown command: ${args.command}`);
       printHelp();

package/dist/index.cjs

@@ -246,7 +246,7 @@ var SchemaManager = class {
   applySchema(adapter) {
     for (const [name, def] of this._tables) {
       const pkCols = this._tablePK.get(name) ?? ["id"];
-      let constraints = def.tableConstraints ? [...def.tableConstraints] : [];
+      const constraints = def.tableConstraints ? [...def.tableConstraints] : [];
       if (pkCols.length > 1) {
         const alreadyHasPK = constraints.some((c) => c.toUpperCase().startsWith("PRIMARY KEY"));
         if (!alreadyHasPK) {
@@ -290,7 +290,7 @@ var SchemaManager = class {
   queryTable(adapter, name) {
     if (this._tables.has(name)) {
       const def = this._tables.get(name);
-      if (def.columns && "deleted_at" in def.columns) {
+      if (def?.columns && "deleted_at" in def.columns) {
         return adapter.all(`SELECT * FROM "${name}" WHERE deleted_at IS NULL`);
       }
       return adapter.all(`SELECT * FROM "${name}"`);
@@ -474,7 +474,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
     case "self":
       return [entityRow];
     case "hasMany": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -486,7 +486,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "manyToMany": {
-      if (protection && protection.protectedTables.has(source.remoteTable)) {
+      if (protection?.protectedTables.has(source.remoteTable)) {
         if (source.remoteTable === protection.currentTable) return [entityRow];
         return [];
       }
@@ -512,7 +512,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "belongsTo": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -935,6 +935,22 @@ var RenderEngine = class {
         const slug = def.slug(entityRow);
         const entityDir = def.directory ? (0, import_node_path4.join)(outputDir, def.directory(entityRow)) : (0, import_node_path4.join)(outputDir, directoryRoot, slug);
         (0, import_node_fs4.mkdirSync)(entityDir, { recursive: true });
+        if (def.attachFileColumn) {
+          const filePath = entityRow[def.attachFileColumn];
+          if (filePath && typeof filePath === "string" && filePath.length > 0) {
+            const absPath = (0, import_node_path4.isAbsolute)(filePath) ? filePath : (0, import_node_path4.resolve)(outputDir, filePath);
+            if ((0, import_node_fs4.existsSync)(absPath)) {
+              const destPath = (0, import_node_path4.join)(entityDir, (0, import_node_path4.basename)(absPath));
+              if (!(0, import_node_fs4.existsSync)(destPath)) {
+                try {
+                  (0, import_node_fs4.copyFileSync)(absPath, destPath);
+                  filesWritten.push(destPath);
+                } catch {
+                }
+              }
+            }
+          }
+        }
         const renderedFiles = /* @__PURE__ */ new Map();
         const entityFileHashes = {};
         const protection = protectedTables.size > 0 ? { protectedTables, currentTable: table } : void 0;
@@ -1818,9 +1834,7 @@ var Lattice = class {
           `Entity context "${table}" has encrypted: true but no encryptionKey was provided in Lattice options`
         );
       }
-      if (!this._encryptionKey) {
-        this._encryptionKey = deriveKey(this._encryptionKeyRaw);
-      }
+      this._encryptionKey ??= deriveKey(this._encryptionKeyRaw);
       const pragmaRows = this._adapter.all(`PRAGMA table_info("${table}")`);
       const allCols = pragmaRows.map((r) => r.name);
       const encCols = resolveEncryptedColumns(def.encrypted, allCols);
@@ -2661,7 +2675,7 @@ function fixSchemaConflicts(db, checks) {
   }
   if (tableExists(db, "__lattice_migrations")) {
     const versionCol = db.prepare('PRAGMA table_info("__lattice_migrations")').all().find((c) => c.name === "version");
-    if (versionCol && versionCol.type.toUpperCase().includes("INTEGER")) {
+    if (versionCol?.type.toUpperCase().includes("INTEGER")) {
       db.exec(
         'ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"'
       );

package/dist/index.d.cts

@@ -534,6 +534,24 @@ interface EntityContextDefinition {
     encrypted?: boolean | {
         columns: string[];
     };
+    /**
+     * Column name containing a file path. When set, the render pipeline
+     * copies the referenced file into each entity's rendered directory.
+     *
+     * If the path is relative, it's resolved from `outputDir`.
+     * If the file doesn't exist, it's silently skipped.
+     * The column value is updated to the new relative path after copy.
+     *
+     * @example
+     * ```ts
+     * db.defineEntityContext('files', {
+     *   slug: (r) => r.name,
+     *   attachFileColumn: 'file_path',  // copies file at row.file_path into entity dir
+     *   files: { 'FILE.md': { ... } },
+     * });
+     * ```
+     */
+    attachFileColumn?: string;
 }
 
 interface CleanupOptions {
@@ -1521,10 +1539,10 @@ declare function contentHash(content: string): string;
  * // Now safe to call lattice.init()
  * ```
  */
-declare function fixSchemaConflicts(db: Database.Database, checks: Array<{
+declare function fixSchemaConflicts(db: Database.Database, checks: {
     table: string;
     requiredColumns: string[];
-}>): void;
+}[]): void;
 
 /**
  * Derive a 256-bit AES key from a master password using scrypt.

package/dist/index.d.ts

@@ -534,6 +534,24 @@ interface EntityContextDefinition {
     encrypted?: boolean | {
         columns: string[];
     };
+    /**
+     * Column name containing a file path. When set, the render pipeline
+     * copies the referenced file into each entity's rendered directory.
+     *
+     * If the path is relative, it's resolved from `outputDir`.
+     * If the file doesn't exist, it's silently skipped.
+     * The column value is updated to the new relative path after copy.
+     *
+     * @example
+     * ```ts
+     * db.defineEntityContext('files', {
+     *   slug: (r) => r.name,
+     *   attachFileColumn: 'file_path',  // copies file at row.file_path into entity dir
+     *   files: { 'FILE.md': { ... } },
+     * });
+     * ```
+     */
+    attachFileColumn?: string;
 }
 
 interface CleanupOptions {
@@ -1521,10 +1539,10 @@ declare function contentHash(content: string): string;
  * // Now safe to call lattice.init()
  * ```
  */
-declare function fixSchemaConflicts(db: Database.Database, checks: Array<{
+declare function fixSchemaConflicts(db: Database.Database, checks: {
     table: string;
     requiredColumns: string[];
-}>): void;
+}[]): void;
 
 /**
  * Derive a 256-bit AES key from a master password using scrypt.

package/dist/index.js

@@ -179,7 +179,7 @@ var SchemaManager = class {
   applySchema(adapter) {
     for (const [name, def] of this._tables) {
       const pkCols = this._tablePK.get(name) ?? ["id"];
-      let constraints = def.tableConstraints ? [...def.tableConstraints] : [];
+      const constraints = def.tableConstraints ? [...def.tableConstraints] : [];
       if (pkCols.length > 1) {
         const alreadyHasPK = constraints.some((c) => c.toUpperCase().startsWith("PRIMARY KEY"));
         if (!alreadyHasPK) {
@@ -223,7 +223,7 @@ var SchemaManager = class {
   queryTable(adapter, name) {
     if (this._tables.has(name)) {
       const def = this._tables.get(name);
-      if (def.columns && "deleted_at" in def.columns) {
+      if (def?.columns && "deleted_at" in def.columns) {
         return adapter.all(`SELECT * FROM "${name}" WHERE deleted_at IS NULL`);
       }
       return adapter.all(`SELECT * FROM "${name}"`);
@@ -320,8 +320,8 @@ var Sanitizer = class {
 };
 
 // src/render/engine.ts
-import { join as join4 } from "path";
-import { mkdirSync as mkdirSync2 } from "fs";
+import { join as join4, basename, isAbsolute, resolve } from "path";
+import { mkdirSync as mkdirSync2, existsSync as existsSync4, copyFileSync } from "fs";
 
 // src/render/entity-query.ts
 var SAFE_COL_RE = /^[a-zA-Z0-9_]+$/;
@@ -407,7 +407,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
     case "self":
       return [entityRow];
     case "hasMany": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -419,7 +419,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "manyToMany": {
-      if (protection && protection.protectedTables.has(source.remoteTable)) {
+      if (protection?.protectedTables.has(source.remoteTable)) {
         if (source.remoteTable === protection.currentTable) return [entityRow];
         return [];
       }
@@ -445,7 +445,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "belongsTo": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -868,6 +868,22 @@ var RenderEngine = class {
         const slug = def.slug(entityRow);
         const entityDir = def.directory ? join4(outputDir, def.directory(entityRow)) : join4(outputDir, directoryRoot, slug);
         mkdirSync2(entityDir, { recursive: true });
+        if (def.attachFileColumn) {
+          const filePath = entityRow[def.attachFileColumn];
+          if (filePath && typeof filePath === "string" && filePath.length > 0) {
+            const absPath = isAbsolute(filePath) ? filePath : resolve(outputDir, filePath);
+            if (existsSync4(absPath)) {
+              const destPath = join4(entityDir, basename(absPath));
+              if (!existsSync4(destPath)) {
+                try {
+                  copyFileSync(absPath, destPath);
+                  filesWritten.push(destPath);
+                } catch {
+                }
+              }
+            }
+          }
+        }
         const renderedFiles = /* @__PURE__ */ new Map();
         const entityFileHashes = {};
         const protection = protectedTables.size > 0 ? { protectedTables, currentTable: table } : void 0;
@@ -917,7 +933,7 @@ var RenderEngine = class {
 
 // src/reverse-sync/engine.ts
 import { join as join5 } from "path";
-import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync3 } from "fs";
 var ReverseSyncEngine = class {
   _schema;
   _adapter;
@@ -969,7 +985,7 @@ var ReverseSyncEngine = class {
           if (!fileInfo.hash) continue;
           const filePath = join5(entityDir, filename);
           result.filesScanned++;
-          if (!existsSync4(filePath)) continue;
+          if (!existsSync5(filePath)) continue;
           let currentContent;
           try {
             currentContent = readFileSync3(filePath, "utf8");
@@ -1069,8 +1085,8 @@ var SyncLoop = class {
 };
 
 // src/writeback/pipeline.ts
-import { readFileSync as readFileSync4, statSync as statSync2, existsSync as existsSync5, readdirSync as readdirSync2 } from "fs";
-import { join as join6, dirname as dirname2, basename } from "path";
+import { readFileSync as readFileSync4, statSync as statSync2, existsSync as existsSync6, readdirSync as readdirSync2 } from "fs";
+import { join as join6, dirname as dirname2, basename as basename2 } from "path";
 
 // src/writeback/state-store.ts
 var InMemoryStateStore = class {
@@ -1176,7 +1192,7 @@ var WritebackPipeline = class {
     let processed = 0;
     const store = def.stateStore ?? this._stateStore;
     for (const filePath of paths) {
-      if (!existsSync5(filePath)) continue;
+      if (!existsSync6(filePath)) continue;
       const stat = statSync2(filePath);
       const currentSize = stat.size;
       const storedOffset = store.getOffset(filePath);
@@ -1210,8 +1226,8 @@ var WritebackPipeline = class {
       return [pattern];
     }
     const dir = dirname2(pattern);
-    const filePattern = basename(pattern);
-    if (!existsSync5(dir)) return [];
+    const filePattern = basename2(pattern);
+    if (!existsSync6(dir)) return [];
     const regexStr = filePattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
     const regex = new RegExp(`^${regexStr}$`);
     return readdirSync2(dir).filter((f) => regex.test(f)).map((f) => join6(dir, f));
@@ -1335,10 +1351,10 @@ ${body}`;
 
 // src/config/parser.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { resolve, dirname as dirname3 } from "path";
+import { resolve as resolve2, dirname as dirname3 } from "path";
 import { parse } from "yaml";
 function parseConfigFile(configPath) {
-  const absPath = resolve(configPath);
+  const absPath = resolve2(configPath);
   const configDir = dirname3(absPath);
   let raw;
   try {
@@ -1377,7 +1393,7 @@ function buildParsedConfig(raw, sourceName, configDir) {
     throw new Error(`Lattice: config.entities must be an object`);
   }
   const config = raw;
-  const dbPath = resolve(configDir, config.db);
+  const dbPath = resolve2(configDir, config.db);
   const tables = [];
   for (const [entityName, entityDef] of Object.entries(config.entities)) {
     const definition = entityToTableDef(entityName, entityDef);
@@ -1751,9 +1767,7 @@ var Lattice = class {
           `Entity context "${table}" has encrypted: true but no encryptionKey was provided in Lattice options`
         );
       }
-      if (!this._encryptionKey) {
-        this._encryptionKey = deriveKey(this._encryptionKeyRaw);
-      }
+      this._encryptionKey ??= deriveKey(this._encryptionKeyRaw);
       const pragmaRows = this._adapter.all(`PRAGMA table_info("${table}")`);
       const allCols = pragmaRows.map((r) => r.name);
       const encCols = resolveEncryptedColumns(def.encrypted, allCols);
@@ -2594,7 +2608,7 @@ function fixSchemaConflicts(db, checks) {
   }
   if (tableExists(db, "__lattice_migrations")) {
     const versionCol = db.prepare('PRAGMA table_info("__lattice_migrations")').all().find((c) => c.name === "version");
-    if (versionCol && versionCol.type.toUpperCase().includes("INTEGER")) {
+    if (versionCol?.type.toUpperCase().includes("INTEGER")) {
       db.exec(
         'ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"'
       );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "latticesql",
-  "version": "0.18.2",
+  "version": "0.18.4",
   "description": "Persistent structured memory for AI agent systems — SQLite ↔ LLM context bridge",
   "type": "module",
   "main": "./dist/index.js",