latticesql 1.16.4 → 1.16.5

package/README.md

@@ -191,6 +191,7 @@ new Lattice(config: LatticeConfigInput, options?: LatticeOptions)
 interface LatticeOptions {
   wal?: boolean; // WAL journal mode (default: true — recommended for concurrent reads)
   busyTimeout?: number; // SQLite busy_timeout in ms (default: 5000)
+  renderSkipsEmpty?: boolean; // Skip the read + write for spec-less tables on render() (default: false)
   security?: {
     sanitize?: boolean; // Strip control characters from string inputs (default: true)
     auditTables?: string[]; // Tables that emit 'audit' events on write

package/dist/cli.js

@@ -2608,20 +2608,25 @@ function cleanupEntityContexts(outputDir, entityContexts, currentSlugsByTable, m
 }
 
 // src/render/engine.ts
+var NOOP_RENDER = () => "";
 var RenderEngine = class {
   _schema;
   _adapter;
   _getTaskContext;
-  constructor(schema, adapter, getTaskContext) {
+  /** When true, skip the read + write for spec-less (no-op render) tables. */
+  _skipEmpty;
+  constructor(schema, adapter, getTaskContext, options) {
     this._schema = schema;
     this._adapter = adapter;
     this._getTaskContext = getTaskContext ?? (() => "");
+    this._skipEmpty = options?.skipEmpty ?? false;
   }
   async render(outputDir) {
     const start = Date.now();
     const filesWritten = [];
     const counters = { skipped: 0 };
     for (const [name, def] of this._schema.getTables()) {
+      if (this._skipEmpty && def.render === NOOP_RENDER) continue;
       let rows = await this._schema.queryTable(this._adapter, name);
       if (def.relevanceFilter) {
         const ctx = this._getTaskContext();
@@ -4353,7 +4358,9 @@ var Lattice = class _Lattice {
     this._adapter = options.adapter ?? buildAdapter(dbPath, options);
     this._schema = new SchemaManager();
     this._sanitizer = new Sanitizer(options.security);
-    this._render = new RenderEngine(this._schema, this._adapter, () => this._taskContext);
+    this._render = new RenderEngine(this._schema, this._adapter, () => this._taskContext, {
+      skipEmpty: options.renderSkipsEmpty ?? false
+    });
     this._reverseSync = new ReverseSyncEngine(this._schema, this._adapter);
     this._reverseSeedEngine = new ReverseSeedEngine(this._schema, this._adapter);
     this._loop = new SyncLoop(this._render);
@@ -4474,7 +4481,7 @@ var Lattice = class _Lattice {
         table,
         this._schema,
         this._adapter
-      ) : () => "",
+      ) : NOOP_RENDER,
       outputFile: def.outputFile ?? `.schema-only/${table}.md`,
       ...renderTemplateName ? { _renderTemplateName: renderTemplateName } : {}
     };

package/dist/index.cjs

@@ -2039,20 +2039,25 @@ function cleanupEntityContexts(outputDir, entityContexts, currentSlugsByTable, m
 }
 
 // src/render/engine.ts
+var NOOP_RENDER = () => "";
 var RenderEngine = class {
   _schema;
   _adapter;
   _getTaskContext;
-  constructor(schema, adapter, getTaskContext) {
+  /** When true, skip the read + write for spec-less (no-op render) tables. */
+  _skipEmpty;
+  constructor(schema, adapter, getTaskContext, options) {
     this._schema = schema;
     this._adapter = adapter;
     this._getTaskContext = getTaskContext ?? (() => "");
+    this._skipEmpty = options?.skipEmpty ?? false;
   }
   async render(outputDir) {
     const start = Date.now();
     const filesWritten = [];
     const counters = { skipped: 0 };
     for (const [name, def] of this._schema.getTables()) {
+      if (this._skipEmpty && def.render === NOOP_RENDER) continue;
       let rows = await this._schema.queryTable(this._adapter, name);
       if (def.relevanceFilter) {
         const ctx = this._getTaskContext();
@@ -4386,7 +4391,9 @@ var Lattice = class _Lattice {
     this._adapter = options.adapter ?? buildAdapter(dbPath, options);
     this._schema = new SchemaManager();
     this._sanitizer = new Sanitizer(options.security);
-    this._render = new RenderEngine(this._schema, this._adapter, () => this._taskContext);
+    this._render = new RenderEngine(this._schema, this._adapter, () => this._taskContext, {
+      skipEmpty: options.renderSkipsEmpty ?? false
+    });
     this._reverseSync = new ReverseSyncEngine(this._schema, this._adapter);
     this._reverseSeedEngine = new ReverseSeedEngine(this._schema, this._adapter);
     this._loop = new SyncLoop(this._render);
@@ -4507,7 +4514,7 @@ var Lattice = class _Lattice {
         table,
         this._schema,
         this._adapter
-      ) : () => "",
+      ) : NOOP_RENDER,
       outputFile: def.outputFile ?? `.schema-only/${table}.md`,
       ...renderTemplateName ? { _renderTemplateName: renderTemplateName } : {}
     };

package/dist/index.d.cts

@@ -746,6 +746,16 @@ interface LatticeOptions {
      * backends, or pre-opened connections.
      */
     adapter?: StorageAdapter;
+    /**
+     * When true, `render()` skips both the full-table read and the file write
+     * for tables registered without a `render` spec — those compile to a no-op
+     * that would only emit an empty `.schema-only/<table>.md`. Off by default,
+     * preserving the original behavior (the table is still scanned and an empty
+     * schema-only file written). Enable this to avoid reading large tables off
+     * the wire just to produce empty files. Tables with an explicit `render`
+     * (or `outputFile`) are unaffected.
+     */
+    renderSkipsEmpty?: boolean;
 }
 /**
  * Retention policy for the change log.

package/dist/index.d.ts

@@ -746,6 +746,16 @@ interface LatticeOptions {
      * backends, or pre-opened connections.
      */
     adapter?: StorageAdapter;
+    /**
+     * When true, `render()` skips both the full-table read and the file write
+     * for tables registered without a `render` spec — those compile to a no-op
+     * that would only emit an empty `.schema-only/<table>.md`. Off by default,
+     * preserving the original behavior (the table is still scanned and an empty
+     * schema-only file written). Enable this to avoid reading large tables off
+     * the wire just to produce empty files. Tables with an explicit `render`
+     * (or `outputFile`) are unaffected.
+     */
+    renderSkipsEmpty?: boolean;
 }
 /**
  * Retention policy for the change log.

package/dist/index.js

@@ -1907,20 +1907,25 @@ function cleanupEntityContexts(outputDir, entityContexts, currentSlugsByTable, m
 }
 
 // src/render/engine.ts
+var NOOP_RENDER = () => "";
 var RenderEngine = class {
   _schema;
   _adapter;
   _getTaskContext;
-  constructor(schema, adapter, getTaskContext) {
+  /** When true, skip the read + write for spec-less (no-op render) tables. */
+  _skipEmpty;
+  constructor(schema, adapter, getTaskContext, options) {
     this._schema = schema;
     this._adapter = adapter;
     this._getTaskContext = getTaskContext ?? (() => "");
+    this._skipEmpty = options?.skipEmpty ?? false;
   }
   async render(outputDir) {
     const start = Date.now();
     const filesWritten = [];
     const counters = { skipped: 0 };
     for (const [name, def] of this._schema.getTables()) {
+      if (this._skipEmpty && def.render === NOOP_RENDER) continue;
       let rows = await this._schema.queryTable(this._adapter, name);
       if (def.relevanceFilter) {
         const ctx = this._getTaskContext();
@@ -4262,7 +4267,9 @@ var Lattice = class _Lattice {
     this._adapter = options.adapter ?? buildAdapter(dbPath, options);
     this._schema = new SchemaManager();
     this._sanitizer = new Sanitizer(options.security);
-    this._render = new RenderEngine(this._schema, this._adapter, () => this._taskContext);
+    this._render = new RenderEngine(this._schema, this._adapter, () => this._taskContext, {
+      skipEmpty: options.renderSkipsEmpty ?? false
+    });
     this._reverseSync = new ReverseSyncEngine(this._schema, this._adapter);
     this._reverseSeedEngine = new ReverseSeedEngine(this._schema, this._adapter);
     this._loop = new SyncLoop(this._render);
@@ -4383,7 +4390,7 @@ var Lattice = class _Lattice {
         table,
         this._schema,
         this._adapter
-      ) : () => "",
+      ) : NOOP_RENDER,
       outputFile: def.outputFile ?? `.schema-only/${table}.md`,
       ...renderTemplateName ? { _renderTemplateName: renderTemplateName } : {}
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "latticesql",
-  "version": "1.16.4",
+  "version": "1.16.5",
   "description": "Persistent structured memory for AI agent systems — pluggable SQLite or Postgres backend, LLM context bridge",
   "type": "module",
   "main": "./dist/index.js",