latticesql 0.18.2 → 0.18.3

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { resolve as resolve3, dirname as dirname5 } from "path";
+import { resolve as resolve4, dirname as dirname5 } from "path";
 import { readFileSync as readFileSync6 } from "fs";
 import { parse as parse2 } from "yaml";
 
@@ -634,8 +634,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_]+$/;
@@ -1175,6 +1175,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 +1240,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 +1292,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 +1392,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 +1443,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 +1477,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));
@@ -2738,7 +2754,7 @@ function printVersion() {
   }
 }
 function runGenerate(args) {
-  const configPath = resolve3(args.config);
+  const configPath = resolve4(args.config);
   let raw;
   try {
     raw = readFileSync6(configPath, "utf-8");
@@ -2758,7 +2774,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 +2787,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 +2814,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 +2874,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) {

package/dist/index.cjs

@@ -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;

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 {

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 {

package/dist/index.js

@@ -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_]+$/;
@@ -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);

package/package.json

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