latticesql 0.8.0 → 0.10.0

package/dist/cli.js

@@ -757,6 +757,165 @@ function truncateContent(content, budget) {
   return content.slice(0, budget) + "\n\n*[truncated \u2014 context budget exceeded]*";
 }
 
+// src/render/markdown.ts
+function frontmatter(fields) {
+  const lines = [`generated_at: "${(/* @__PURE__ */ new Date()).toISOString()}"`];
+  for (const [key, val] of Object.entries(fields)) {
+    lines.push(typeof val === "string" ? `${key}: "${val}"` : `${key}: ${String(val)}`);
+  }
+  return `---
+${lines.join("\n")}
+---
+
+`;
+}
+function markdownTable(rows, columns) {
+  if (rows.length === 0 || columns.length === 0) return "";
+  const header = "| " + columns.map((c) => c.header).join(" | ") + " |";
+  const separator = "| " + columns.map(() => "---").join(" | ") + " |";
+  const body = rows.map((row) => {
+    const cells = columns.map((col) => {
+      const raw = row[col.key];
+      return col.format ? col.format(raw, row) : String(raw ?? "");
+    });
+    return "| " + cells.join(" | ") + " |";
+  });
+  return [header, separator, ...body].join("\n") + "\n";
+}
+
+// src/session/constants.ts
+function createReadOnlyHeader(options) {
+  const generator = options?.generator ?? "Lattice";
+  const docsRef = options?.docsRef ?? "the Lattice documentation";
+  return `<!-- READ ONLY \u2014 generated by ${generator}. Do not edit directly.
+     To update data in Lattice: write entries to SESSION.md in this directory.
+     Format: type: write | op: create/update/delete | table: <name> | target: <id>
+     See ${docsRef} for the SESSION.md format spec. -->
+
+`;
+}
+var READ_ONLY_HEADER = createReadOnlyHeader();
+
+// src/render/entity-templates.ts
+var DEFAULT_HEADER = createReadOnlyHeader();
+function compileEntityRender(spec) {
+  if (typeof spec === "function") return spec;
+  return compileTemplate(spec);
+}
+function compileTemplate(tmpl) {
+  switch (tmpl.template) {
+    case "entity-table":
+      return compileEntityTable(tmpl);
+    case "entity-profile":
+      return compileEntityProfile(tmpl);
+    case "entity-sections":
+      return compileEntitySections(tmpl);
+  }
+}
+function compileEntityTable(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    let md = DEFAULT_HEADER;
+    md += frontmatter(tmpl.frontmatter ?? {});
+    md += `# ${tmpl.heading}
+
+`;
+    if (data.length === 0) {
+      md += tmpl.emptyMessage ?? "*No data.*\n";
+    } else {
+      md += markdownTable(data, tmpl.columns);
+    }
+    return md;
+  };
+}
+function compileEntityProfile(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    const r = data[0];
+    if (!r) return "";
+    let md = DEFAULT_HEADER;
+    if (tmpl.frontmatter) {
+      const fm = typeof tmpl.frontmatter === "function" ? tmpl.frontmatter(r) : tmpl.frontmatter;
+      md += frontmatter(fm);
+    } else {
+      md += frontmatter({});
+    }
+    const heading = typeof tmpl.heading === "function" ? tmpl.heading(r) : tmpl.heading;
+    md += `# ${heading}
+
+`;
+    for (const field of tmpl.fields) {
+      const val = r[field.key];
+      if (val === null || val === void 0) continue;
+      const formatted = field.format ? field.format(val, r) : String(val);
+      if (formatted) {
+        md += `**${field.label}:** ${formatted}
+`;
+      }
+    }
+    if (tmpl.sections) {
+      for (const section of tmpl.sections) {
+        const rawJson = r[`_${section.key}`];
+        if (!rawJson) continue;
+        if (section.condition && !section.condition(r)) continue;
+        const items = JSON.parse(rawJson);
+        if (items.length === 0) continue;
+        const sectionHeading = typeof section.heading === "function" ? section.heading(r) : section.heading;
+        md += `
+## ${sectionHeading}
+
+`;
+        if (section.render === "table" && section.columns) {
+          md += markdownTable(items, section.columns);
+        } else if (section.render === "list" && section.formatItem) {
+          for (const item of items) {
+            md += `- ${section.formatItem(item)}
+`;
+          }
+        } else if (typeof section.render === "function") {
+          md += section.render(items);
+        }
+      }
+    }
+    return md;
+  };
+}
+function compileEntitySections(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    let md = DEFAULT_HEADER;
+    md += frontmatter(tmpl.frontmatter ?? {});
+    md += `# ${tmpl.heading}
+
+`;
+    if (data.length === 0) {
+      md += tmpl.emptyMessage ?? "*No data.*\n";
+      return md;
+    }
+    for (const row of data) {
+      md += `## ${tmpl.perRow.heading(row)}
+`;
+      if (tmpl.perRow.metadata?.length) {
+        const parts = tmpl.perRow.metadata.map((m) => {
+          const val = row[m.key];
+          const formatted = m.format ? m.format(val) : String(val ?? "");
+          return `**${m.label}:** ${formatted}`;
+        }).filter(Boolean);
+        if (parts.length > 0) {
+          md += parts.join(" | ") + "\n";
+        }
+      }
+      if (tmpl.perRow.body) {
+        md += `
+${tmpl.perRow.body(row)}
+`;
+      }
+      md += "\n";
+    }
+    return md;
+  };
+}
+
 // src/lifecycle/cleanup.ts
 import { join as join4 } from "path";
 import { existsSync as existsSync4, readdirSync, unlinkSync, rmdirSync, statSync } from "fs";
@@ -966,7 +1125,8 @@ var RenderEngine = class {
           const source = mergeDefaults ? { ...def.sourceDefaults, ...spec.source } : spec.source;
           const rows = resolveEntitySource(source, entityRow, entityPk, this._adapter);
           if (spec.omitIfEmpty && rows.length === 0) continue;
-          const content = truncateContent(spec.render(rows), spec.budget);
+          const renderFn = compileEntityRender(spec.render);
+          const content = truncateContent(renderFn(rows), spec.budget);
           renderedFiles.set(filename, content);
           const filePath = join5(entityDir, filename);
           if (atomicWrite(filePath, content)) {
@@ -1229,6 +1389,7 @@ var Lattice = class {
   _renderHandlers = [];
   _writebackHandlers = [];
   _errorHandlers = [];
+  _writeHooks = [];
   constructor(pathOrConfig, options = {}) {
     let dbPath;
     let configTables;
@@ -1288,6 +1449,14 @@ var Lattice = class {
     this._schema.defineEntityContext(table, def);
     return this;
   }
+  /**
+   * Register a write hook that fires after insert/update/delete operations.
+   * Hooks run synchronously after the DB write and audit emit.
+   */
+  defineWriteHook(hook) {
+    this._writeHooks.push(hook);
+    return this;
+  }
   defineWriteback(def) {
     this._writeback.define(def);
     return this;
@@ -1337,6 +1506,7 @@ var Lattice = class {
     const rawPk = rowWithPk[pkCol];
     const pkValue = rawPk != null ? String(rawPk) : "";
     this._sanitizer.emitAudit(table, "insert", pkValue);
+    this._fireWriteHooks(table, "insert", rowWithPk, pkValue);
     return Promise.resolve(pkValue);
   }
   upsert(table, row) {
@@ -1390,6 +1560,7 @@ var Lattice = class {
     this._adapter.run(`UPDATE "${table}" SET ${setCols} WHERE ${clause}`, values);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "update", auditId);
+    this._fireWriteHooks(table, "update", sanitized, auditId, Object.keys(sanitized));
     return Promise.resolve();
   }
   delete(table, id) {
@@ -1399,6 +1570,7 @@ var Lattice = class {
     this._adapter.run(`DELETE FROM "${table}" WHERE ${clause}`, params);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "delete", auditId);
+    this._fireWriteHooks(table, "delete", { id: auditId }, auditId);
     return Promise.resolve();
   }
   get(table, id) {
@@ -1636,6 +1808,22 @@ var Lattice = class {
     return { clauses, params };
   }
   /** Returns a rejected Promise if not initialized; null if ready. */
+  _fireWriteHooks(table, op, row, pk, changedColumns) {
+    for (const hook of this._writeHooks) {
+      if (hook.table !== table) continue;
+      if (!hook.on.includes(op)) continue;
+      if (op === "update" && hook.watchColumns && changedColumns) {
+        if (!hook.watchColumns.some((c) => changedColumns.includes(c))) continue;
+      }
+      try {
+        const ctx = { table, op, row, pk };
+        if (changedColumns) ctx.changedColumns = changedColumns;
+        hook.handler(ctx);
+      } catch (err) {
+        for (const h of this._errorHandlers) h(err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  }
   _notInitError() {
     if (!this._initialized) {
       return Promise.reject(

package/dist/index.cjs

@@ -499,6 +499,172 @@ function truncateContent(content, budget) {
   return content.slice(0, budget) + "\n\n*[truncated \u2014 context budget exceeded]*";
 }
 
+// src/render/markdown.ts
+function frontmatter(fields) {
+  const lines = [`generated_at: "${(/* @__PURE__ */ new Date()).toISOString()}"`];
+  for (const [key, val] of Object.entries(fields)) {
+    lines.push(typeof val === "string" ? `${key}: "${val}"` : `${key}: ${String(val)}`);
+  }
+  return `---
+${lines.join("\n")}
+---
+
+`;
+}
+function markdownTable(rows, columns) {
+  if (rows.length === 0 || columns.length === 0) return "";
+  const header = "| " + columns.map((c) => c.header).join(" | ") + " |";
+  const separator = "| " + columns.map(() => "---").join(" | ") + " |";
+  const body = rows.map((row) => {
+    const cells = columns.map((col) => {
+      const raw = row[col.key];
+      return col.format ? col.format(raw, row) : String(raw ?? "");
+    });
+    return "| " + cells.join(" | ") + " |";
+  });
+  return [header, separator, ...body].join("\n") + "\n";
+}
+function slugify(name) {
+  return name.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/\u0131/g, "i").replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+}
+function truncate(content, maxChars, notice = "\n\n*[truncated \u2014 context budget exceeded]*") {
+  if (content.length <= maxChars) return content;
+  return content.slice(0, maxChars) + notice;
+}
+
+// src/session/constants.ts
+function createReadOnlyHeader(options) {
+  const generator = options?.generator ?? "Lattice";
+  const docsRef = options?.docsRef ?? "the Lattice documentation";
+  return `<!-- READ ONLY \u2014 generated by ${generator}. Do not edit directly.
+     To update data in Lattice: write entries to SESSION.md in this directory.
+     Format: type: write | op: create/update/delete | table: <name> | target: <id>
+     See ${docsRef} for the SESSION.md format spec. -->
+
+`;
+}
+var READ_ONLY_HEADER = createReadOnlyHeader();
+
+// src/render/entity-templates.ts
+var DEFAULT_HEADER = createReadOnlyHeader();
+function compileEntityRender(spec) {
+  if (typeof spec === "function") return spec;
+  return compileTemplate(spec);
+}
+function compileTemplate(tmpl) {
+  switch (tmpl.template) {
+    case "entity-table":
+      return compileEntityTable(tmpl);
+    case "entity-profile":
+      return compileEntityProfile(tmpl);
+    case "entity-sections":
+      return compileEntitySections(tmpl);
+  }
+}
+function compileEntityTable(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    let md = DEFAULT_HEADER;
+    md += frontmatter(tmpl.frontmatter ?? {});
+    md += `# ${tmpl.heading}
+
+`;
+    if (data.length === 0) {
+      md += tmpl.emptyMessage ?? "*No data.*\n";
+    } else {
+      md += markdownTable(data, tmpl.columns);
+    }
+    return md;
+  };
+}
+function compileEntityProfile(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    const r = data[0];
+    if (!r) return "";
+    let md = DEFAULT_HEADER;
+    if (tmpl.frontmatter) {
+      const fm = typeof tmpl.frontmatter === "function" ? tmpl.frontmatter(r) : tmpl.frontmatter;
+      md += frontmatter(fm);
+    } else {
+      md += frontmatter({});
+    }
+    const heading = typeof tmpl.heading === "function" ? tmpl.heading(r) : tmpl.heading;
+    md += `# ${heading}
+
+`;
+    for (const field of tmpl.fields) {
+      const val = r[field.key];
+      if (val === null || val === void 0) continue;
+      const formatted = field.format ? field.format(val, r) : String(val);
+      if (formatted) {
+        md += `**${field.label}:** ${formatted}
+`;
+      }
+    }
+    if (tmpl.sections) {
+      for (const section of tmpl.sections) {
+        const rawJson = r[`_${section.key}`];
+        if (!rawJson) continue;
+        if (section.condition && !section.condition(r)) continue;
+        const items = JSON.parse(rawJson);
+        if (items.length === 0) continue;
+        const sectionHeading = typeof section.heading === "function" ? section.heading(r) : section.heading;
+        md += `
+## ${sectionHeading}
+
+`;
+        if (section.render === "table" && section.columns) {
+          md += markdownTable(items, section.columns);
+        } else if (section.render === "list" && section.formatItem) {
+          for (const item of items) {
+            md += `- ${section.formatItem(item)}
+`;
+          }
+        } else if (typeof section.render === "function") {
+          md += section.render(items);
+        }
+      }
+    }
+    return md;
+  };
+}
+function compileEntitySections(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    let md = DEFAULT_HEADER;
+    md += frontmatter(tmpl.frontmatter ?? {});
+    md += `# ${tmpl.heading}
+
+`;
+    if (data.length === 0) {
+      md += tmpl.emptyMessage ?? "*No data.*\n";
+      return md;
+    }
+    for (const row of data) {
+      md += `## ${tmpl.perRow.heading(row)}
+`;
+      if (tmpl.perRow.metadata?.length) {
+        const parts = tmpl.perRow.metadata.map((m) => {
+          const val = row[m.key];
+          const formatted = m.format ? m.format(val) : String(val ?? "");
+          return `**${m.label}:** ${formatted}`;
+        }).filter(Boolean);
+        if (parts.length > 0) {
+          md += parts.join(" | ") + "\n";
+        }
+      }
+      if (tmpl.perRow.body) {
+        md += `
+${tmpl.perRow.body(row)}
+`;
+      }
+      md += "\n";
+    }
+    return md;
+  };
+}
+
 // src/lifecycle/cleanup.ts
 var import_node_path3 = require("path");
 var import_node_fs3 = require("fs");
@@ -708,7 +874,8 @@ var RenderEngine = class {
           const source = mergeDefaults ? { ...def.sourceDefaults, ...spec.source } : spec.source;
           const rows = resolveEntitySource(source, entityRow, entityPk, this._adapter);
           if (spec.omitIfEmpty && rows.length === 0) continue;
-          const content = truncateContent(spec.render(rows), spec.budget);
+          const renderFn = compileEntityRender(spec.render);
+          const content = truncateContent(renderFn(rows), spec.budget);
           renderedFiles.set(filename, content);
           const filePath = (0, import_node_path4.join)(entityDir, filename);
           if (atomicWrite(filePath, content)) {
@@ -1196,6 +1363,7 @@ var Lattice = class {
   _renderHandlers = [];
   _writebackHandlers = [];
   _errorHandlers = [];
+  _writeHooks = [];
   constructor(pathOrConfig, options = {}) {
     let dbPath;
     let configTables;
@@ -1255,6 +1423,14 @@ var Lattice = class {
     this._schema.defineEntityContext(table, def);
     return this;
   }
+  /**
+   * Register a write hook that fires after insert/update/delete operations.
+   * Hooks run synchronously after the DB write and audit emit.
+   */
+  defineWriteHook(hook) {
+    this._writeHooks.push(hook);
+    return this;
+  }
   defineWriteback(def) {
     this._writeback.define(def);
     return this;
@@ -1304,6 +1480,7 @@ var Lattice = class {
     const rawPk = rowWithPk[pkCol];
     const pkValue = rawPk != null ? String(rawPk) : "";
     this._sanitizer.emitAudit(table, "insert", pkValue);
+    this._fireWriteHooks(table, "insert", rowWithPk, pkValue);
     return Promise.resolve(pkValue);
   }
   upsert(table, row) {
@@ -1357,6 +1534,7 @@ var Lattice = class {
     this._adapter.run(`UPDATE "${table}" SET ${setCols} WHERE ${clause}`, values);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "update", auditId);
+    this._fireWriteHooks(table, "update", sanitized, auditId, Object.keys(sanitized));
     return Promise.resolve();
   }
   delete(table, id) {
@@ -1366,6 +1544,7 @@ var Lattice = class {
     this._adapter.run(`DELETE FROM "${table}" WHERE ${clause}`, params);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "delete", auditId);
+    this._fireWriteHooks(table, "delete", { id: auditId }, auditId);
     return Promise.resolve();
   }
   get(table, id) {
@@ -1603,6 +1782,22 @@ var Lattice = class {
     return { clauses, params };
   }
   /** Returns a rejected Promise if not initialized; null if ready. */
+  _fireWriteHooks(table, op, row, pk, changedColumns) {
+    for (const hook of this._writeHooks) {
+      if (hook.table !== table) continue;
+      if (!hook.on.includes(op)) continue;
+      if (op === "update" && hook.watchColumns && changedColumns) {
+        if (!hook.watchColumns.some((c) => changedColumns.includes(c))) continue;
+      }
+      try {
+        const ctx = { table, op, row, pk };
+        if (changedColumns) ctx.changedColumns = changedColumns;
+        hook.handler(ctx);
+      } catch (err) {
+        for (const h of this._errorHandlers) h(err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  }
   _notInitError() {
     if (!this._initialized) {
       return Promise.reject(
@@ -1641,39 +1836,6 @@ var Lattice = class {
   }
 };
 
-// src/render/markdown.ts
-function frontmatter(fields) {
-  const lines = [`generated_at: "${(/* @__PURE__ */ new Date()).toISOString()}"`];
-  for (const [key, val] of Object.entries(fields)) {
-    lines.push(typeof val === "string" ? `${key}: "${val}"` : `${key}: ${String(val)}`);
-  }
-  return `---
-${lines.join("\n")}
----
-
-`;
-}
-function markdownTable(rows, columns) {
-  if (rows.length === 0 || columns.length === 0) return "";
-  const header = "| " + columns.map((c) => c.header).join(" | ") + " |";
-  const separator = "| " + columns.map(() => "---").join(" | ") + " |";
-  const body = rows.map((row) => {
-    const cells = columns.map((col) => {
-      const raw = row[col.key];
-      return col.format ? col.format(raw, row) : String(raw ?? "");
-    });
-    return "| " + cells.join(" | ") + " |";
-  });
-  return [header, separator, ...body].join("\n") + "\n";
-}
-function slugify(name) {
-  return name.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/\u0131/g, "i").replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-function truncate(content, maxChars, notice = "\n\n*[truncated \u2014 context budget exceeded]*") {
-  if (content.length <= maxChars) return content;
-  return content.slice(0, maxChars) + notice;
-}
-
 // src/session/parser.ts
 var import_node_crypto3 = require("crypto");
 function generateWriteEntryId(timestamp, agentName, op, table, target) {
@@ -2058,19 +2220,6 @@ function applyWriteEntry(db, entry) {
     return { ok: false, reason: `DB error: ${message}` };
   }
 }
-
-// src/session/constants.ts
-function createReadOnlyHeader(options) {
-  const generator = options?.generator ?? "Lattice";
-  const docsRef = options?.docsRef ?? "the Lattice documentation";
-  return `<!-- READ ONLY \u2014 generated by ${generator}. Do not edit directly.
-     To update data in Lattice: write entries to SESSION.md in this directory.
-     Format: type: write | op: create/update/delete | table: <name> | target: <id>
-     See ${docsRef} for the SESSION.md format spec. -->
-
-`;
-}
-var READ_ONLY_HEADER = createReadOnlyHeader();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_ENTRY_TYPES,

package/dist/index.d.cts

@@ -266,14 +266,89 @@ type EntityFileSource = SelfSource | HasManySource | ManyToManySource | BelongsT
  * }
  * ```
  */
+/** Column spec for entity-table template (reuses MarkdownTableColumn). */
+interface EntityTableColumn {
+    key: string;
+    header: string;
+    format?: (val: unknown, row: Row) => string;
+}
+/**
+ * Render a heading + GFM table. Auto-prepends read-only header + frontmatter.
+ */
+interface EntityTableTemplate {
+    template: 'entity-table';
+    heading: string;
+    columns: EntityTableColumn[];
+    emptyMessage?: string;
+    frontmatter?: Record<string, string | number | boolean>;
+    beforeRender?: (rows: Row[]) => Row[];
+}
+/**
+ * Field spec for entity-profile template.
+ */
+interface EntityProfileField {
+    key: string;
+    label: string;
+    format?: (val: unknown, row: Row) => string;
+}
+/**
+ * Section spec for entity-profile template (renders enriched JSON arrays).
+ */
+interface EntityProfileSection {
+    /** Key of the enriched field (e.g. 'agents' → reads row._agents). */
+    key: string;
+    heading: string | ((row: Row) => string);
+    condition?: (row: Row) => boolean;
+    render: 'table' | 'list' | ((items: Row[]) => string);
+    columns?: EntityTableColumn[];
+    formatItem?: (item: Row) => string;
+}
+/**
+ * Render entity profile: heading + field-value pairs + optional enriched sections.
+ */
+interface EntityProfileTemplate {
+    template: 'entity-profile';
+    heading: string | ((row: Row) => string);
+    fields: EntityProfileField[];
+    sections?: EntityProfileSection[];
+    frontmatter?: Record<string, string | number | boolean> | ((row: Row) => Record<string, string | number | boolean>);
+    beforeRender?: (rows: Row[]) => Row[];
+}
+/**
+ * Per-row section spec for entity-sections template.
+ */
+interface EntitySectionPerRow {
+    heading: (row: Row) => string;
+    metadata?: Array<{
+        key: string;
+        label: string;
+        format?: (val: unknown) => string;
+    }>;
+    body?: (row: Row) => string;
+}
+/**
+ * Render per-row sections: heading + metadata key-value + body text per row.
+ */
+interface EntitySectionsTemplate {
+    template: 'entity-sections';
+    heading: string;
+    perRow: EntitySectionPerRow;
+    emptyMessage?: string;
+    frontmatter?: Record<string, string | number | boolean>;
+    beforeRender?: (rows: Row[]) => Row[];
+}
+/** Union of all entity render template types. */
+type EntityRenderTemplate = EntityTableTemplate | EntityProfileTemplate | EntitySectionsTemplate;
+/** Accepted values for EntityFileSpec.render — function or template object. */
+type EntityRenderSpec = ((rows: Row[]) => string) | EntityRenderTemplate;
 interface EntityFileSpec {
     /** Determines what rows are passed to {@link render}. */
     source: EntityFileSource;
     /**
      * Converts the resolved rows into the file's markdown content.
-     * For `self` sources, `rows` is always a single-element array.
+     * Accepts a function `(rows) => string` or a declarative template object.
      */
-    render: (rows: Row[]) => string;
+    render: EntityRenderSpec;
     /**
      * Maximum number of characters allowed in the rendered output.
      * Content exceeding this limit is truncated with a notice appended.
@@ -674,6 +749,45 @@ interface AuditEvent {
     id: string;
     timestamp: string;
 }
+/**
+ * Context passed to write hook handlers.
+ */
+interface WriteHookContext {
+    /** Table that was modified. */
+    table: string;
+    /** The operation that triggered the hook. */
+    op: 'insert' | 'update' | 'delete';
+    /** The row data (for insert: full row; for update: changed fields; for delete: { id }). */
+    row: Row;
+    /** Primary key value(s) of the affected row. */
+    pk: string;
+    /** For updates: the column names that were changed. */
+    changedColumns?: string[];
+}
+/**
+ * A write hook fires after insert/update/delete operations.
+ *
+ * @example
+ * ```ts
+ * db.defineWriteHook({
+ *   table: 'agents',
+ *   on: ['insert', 'update'],
+ *   watchColumns: ['team_id'],
+ *   handler: (ctx) => { denormalizeTeamFields(ctx.pk); },
+ * });
+ * ```
+ */
+interface WriteHook {
+    /** Table the hook fires on. */
+    table: string;
+    /** Operations that trigger the hook. */
+    on: Array<'insert' | 'update' | 'delete'>;
+    /** Only fire on update when these columns changed. Omit = fire on any change. */
+    watchColumns?: string[];
+    /** Handler function. Runs synchronously after the DB write. */
+    handler: (ctx: WriteHookContext) => void;
+}
+
 interface ReconcileOptions {
     /** Remove entity directories whose slug is no longer in the DB. Default: true. */
     removeOrphanedDirectories?: boolean;
@@ -726,10 +840,16 @@ declare class Lattice {
     private readonly _renderHandlers;
     private readonly _writebackHandlers;
     private readonly _errorHandlers;
+    private readonly _writeHooks;
     constructor(pathOrConfig: string | LatticeConfigInput, options?: LatticeOptions);
     define(table: string, def: TableDefinition): this;
     defineMulti(name: string, def: MultiTableDefinition): this;
     defineEntityContext(table: string, def: EntityContextDefinition): this;
+    /**
+     * Register a write hook that fires after insert/update/delete operations.
+     * Hooks run synchronously after the DB write and audit emit.
+     */
+    defineWriteHook(hook: WriteHook): this;
     defineWriteback(def: WritebackDefinition): this;
     init(options?: InitOptions): Promise<void>;
     close(): void;
@@ -775,6 +895,7 @@ declare class Lattice {
      */
     private _buildFilters;
     /** Returns a rejected Promise if not initialized; null if ready. */
+    private _fireWriteHooks;
     private _notInitError;
     /**
      * Returns a rejected Promise if any of the given column names are not present
@@ -1230,4 +1351,4 @@ declare function createReadOnlyHeader(options?: ReadOnlyHeaderOptions): string;
  */
 declare const READ_ONLY_HEADER: string;
 
-export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileSource, type EntityFileSpec, type Filter, type FilterOp, type HasManyRelation, type HasManySource, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };
+export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };

package/dist/index.d.ts

@@ -266,14 +266,89 @@ type EntityFileSource = SelfSource | HasManySource | ManyToManySource | BelongsT
  * }
  * ```
  */
+/** Column spec for entity-table template (reuses MarkdownTableColumn). */
+interface EntityTableColumn {
+    key: string;
+    header: string;
+    format?: (val: unknown, row: Row) => string;
+}
+/**
+ * Render a heading + GFM table. Auto-prepends read-only header + frontmatter.
+ */
+interface EntityTableTemplate {
+    template: 'entity-table';
+    heading: string;
+    columns: EntityTableColumn[];
+    emptyMessage?: string;
+    frontmatter?: Record<string, string | number | boolean>;
+    beforeRender?: (rows: Row[]) => Row[];
+}
+/**
+ * Field spec for entity-profile template.
+ */
+interface EntityProfileField {
+    key: string;
+    label: string;
+    format?: (val: unknown, row: Row) => string;
+}
+/**
+ * Section spec for entity-profile template (renders enriched JSON arrays).
+ */
+interface EntityProfileSection {
+    /** Key of the enriched field (e.g. 'agents' → reads row._agents). */
+    key: string;
+    heading: string | ((row: Row) => string);
+    condition?: (row: Row) => boolean;
+    render: 'table' | 'list' | ((items: Row[]) => string);
+    columns?: EntityTableColumn[];
+    formatItem?: (item: Row) => string;
+}
+/**
+ * Render entity profile: heading + field-value pairs + optional enriched sections.
+ */
+interface EntityProfileTemplate {
+    template: 'entity-profile';
+    heading: string | ((row: Row) => string);
+    fields: EntityProfileField[];
+    sections?: EntityProfileSection[];
+    frontmatter?: Record<string, string | number | boolean> | ((row: Row) => Record<string, string | number | boolean>);
+    beforeRender?: (rows: Row[]) => Row[];
+}
+/**
+ * Per-row section spec for entity-sections template.
+ */
+interface EntitySectionPerRow {
+    heading: (row: Row) => string;
+    metadata?: Array<{
+        key: string;
+        label: string;
+        format?: (val: unknown) => string;
+    }>;
+    body?: (row: Row) => string;
+}
+/**
+ * Render per-row sections: heading + metadata key-value + body text per row.
+ */
+interface EntitySectionsTemplate {
+    template: 'entity-sections';
+    heading: string;
+    perRow: EntitySectionPerRow;
+    emptyMessage?: string;
+    frontmatter?: Record<string, string | number | boolean>;
+    beforeRender?: (rows: Row[]) => Row[];
+}
+/** Union of all entity render template types. */
+type EntityRenderTemplate = EntityTableTemplate | EntityProfileTemplate | EntitySectionsTemplate;
+/** Accepted values for EntityFileSpec.render — function or template object. */
+type EntityRenderSpec = ((rows: Row[]) => string) | EntityRenderTemplate;
 interface EntityFileSpec {
     /** Determines what rows are passed to {@link render}. */
     source: EntityFileSource;
     /**
      * Converts the resolved rows into the file's markdown content.
-     * For `self` sources, `rows` is always a single-element array.
+     * Accepts a function `(rows) => string` or a declarative template object.
      */
-    render: (rows: Row[]) => string;
+    render: EntityRenderSpec;
     /**
      * Maximum number of characters allowed in the rendered output.
      * Content exceeding this limit is truncated with a notice appended.
@@ -674,6 +749,45 @@ interface AuditEvent {
     id: string;
     timestamp: string;
 }
+/**
+ * Context passed to write hook handlers.
+ */
+interface WriteHookContext {
+    /** Table that was modified. */
+    table: string;
+    /** The operation that triggered the hook. */
+    op: 'insert' | 'update' | 'delete';
+    /** The row data (for insert: full row; for update: changed fields; for delete: { id }). */
+    row: Row;
+    /** Primary key value(s) of the affected row. */
+    pk: string;
+    /** For updates: the column names that were changed. */
+    changedColumns?: string[];
+}
+/**
+ * A write hook fires after insert/update/delete operations.
+ *
+ * @example
+ * ```ts
+ * db.defineWriteHook({
+ *   table: 'agents',
+ *   on: ['insert', 'update'],
+ *   watchColumns: ['team_id'],
+ *   handler: (ctx) => { denormalizeTeamFields(ctx.pk); },
+ * });
+ * ```
+ */
+interface WriteHook {
+    /** Table the hook fires on. */
+    table: string;
+    /** Operations that trigger the hook. */
+    on: Array<'insert' | 'update' | 'delete'>;
+    /** Only fire on update when these columns changed. Omit = fire on any change. */
+    watchColumns?: string[];
+    /** Handler function. Runs synchronously after the DB write. */
+    handler: (ctx: WriteHookContext) => void;
+}
+
 interface ReconcileOptions {
     /** Remove entity directories whose slug is no longer in the DB. Default: true. */
     removeOrphanedDirectories?: boolean;
@@ -726,10 +840,16 @@ declare class Lattice {
     private readonly _renderHandlers;
     private readonly _writebackHandlers;
     private readonly _errorHandlers;
+    private readonly _writeHooks;
     constructor(pathOrConfig: string | LatticeConfigInput, options?: LatticeOptions);
     define(table: string, def: TableDefinition): this;
     defineMulti(name: string, def: MultiTableDefinition): this;
     defineEntityContext(table: string, def: EntityContextDefinition): this;
+    /**
+     * Register a write hook that fires after insert/update/delete operations.
+     * Hooks run synchronously after the DB write and audit emit.
+     */
+    defineWriteHook(hook: WriteHook): this;
     defineWriteback(def: WritebackDefinition): this;
     init(options?: InitOptions): Promise<void>;
     close(): void;
@@ -775,6 +895,7 @@ declare class Lattice {
      */
     private _buildFilters;
     /** Returns a rejected Promise if not initialized; null if ready. */
+    private _fireWriteHooks;
     private _notInitError;
     /**
      * Returns a rejected Promise if any of the given column names are not present
@@ -1230,4 +1351,4 @@ declare function createReadOnlyHeader(options?: ReadOnlyHeaderOptions): string;
  */
 declare const READ_ONLY_HEADER: string;
 
-export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileSource, type EntityFileSpec, type Filter, type FilterOp, type HasManyRelation, type HasManySource, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };
+export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };

package/dist/index.js

@@ -443,6 +443,172 @@ function truncateContent(content, budget) {
   return content.slice(0, budget) + "\n\n*[truncated \u2014 context budget exceeded]*";
 }
 
+// src/render/markdown.ts
+function frontmatter(fields) {
+  const lines = [`generated_at: "${(/* @__PURE__ */ new Date()).toISOString()}"`];
+  for (const [key, val] of Object.entries(fields)) {
+    lines.push(typeof val === "string" ? `${key}: "${val}"` : `${key}: ${String(val)}`);
+  }
+  return `---
+${lines.join("\n")}
+---
+
+`;
+}
+function markdownTable(rows, columns) {
+  if (rows.length === 0 || columns.length === 0) return "";
+  const header = "| " + columns.map((c) => c.header).join(" | ") + " |";
+  const separator = "| " + columns.map(() => "---").join(" | ") + " |";
+  const body = rows.map((row) => {
+    const cells = columns.map((col) => {
+      const raw = row[col.key];
+      return col.format ? col.format(raw, row) : String(raw ?? "");
+    });
+    return "| " + cells.join(" | ") + " |";
+  });
+  return [header, separator, ...body].join("\n") + "\n";
+}
+function slugify(name) {
+  return name.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/\u0131/g, "i").replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+}
+function truncate(content, maxChars, notice = "\n\n*[truncated \u2014 context budget exceeded]*") {
+  if (content.length <= maxChars) return content;
+  return content.slice(0, maxChars) + notice;
+}
+
+// src/session/constants.ts
+function createReadOnlyHeader(options) {
+  const generator = options?.generator ?? "Lattice";
+  const docsRef = options?.docsRef ?? "the Lattice documentation";
+  return `<!-- READ ONLY \u2014 generated by ${generator}. Do not edit directly.
+     To update data in Lattice: write entries to SESSION.md in this directory.
+     Format: type: write | op: create/update/delete | table: <name> | target: <id>
+     See ${docsRef} for the SESSION.md format spec. -->
+
+`;
+}
+var READ_ONLY_HEADER = createReadOnlyHeader();
+
+// src/render/entity-templates.ts
+var DEFAULT_HEADER = createReadOnlyHeader();
+function compileEntityRender(spec) {
+  if (typeof spec === "function") return spec;
+  return compileTemplate(spec);
+}
+function compileTemplate(tmpl) {
+  switch (tmpl.template) {
+    case "entity-table":
+      return compileEntityTable(tmpl);
+    case "entity-profile":
+      return compileEntityProfile(tmpl);
+    case "entity-sections":
+      return compileEntitySections(tmpl);
+  }
+}
+function compileEntityTable(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    let md = DEFAULT_HEADER;
+    md += frontmatter(tmpl.frontmatter ?? {});
+    md += `# ${tmpl.heading}
+
+`;
+    if (data.length === 0) {
+      md += tmpl.emptyMessage ?? "*No data.*\n";
+    } else {
+      md += markdownTable(data, tmpl.columns);
+    }
+    return md;
+  };
+}
+function compileEntityProfile(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    const r = data[0];
+    if (!r) return "";
+    let md = DEFAULT_HEADER;
+    if (tmpl.frontmatter) {
+      const fm = typeof tmpl.frontmatter === "function" ? tmpl.frontmatter(r) : tmpl.frontmatter;
+      md += frontmatter(fm);
+    } else {
+      md += frontmatter({});
+    }
+    const heading = typeof tmpl.heading === "function" ? tmpl.heading(r) : tmpl.heading;
+    md += `# ${heading}
+
+`;
+    for (const field of tmpl.fields) {
+      const val = r[field.key];
+      if (val === null || val === void 0) continue;
+      const formatted = field.format ? field.format(val, r) : String(val);
+      if (formatted) {
+        md += `**${field.label}:** ${formatted}
+`;
+      }
+    }
+    if (tmpl.sections) {
+      for (const section of tmpl.sections) {
+        const rawJson = r[`_${section.key}`];
+        if (!rawJson) continue;
+        if (section.condition && !section.condition(r)) continue;
+        const items = JSON.parse(rawJson);
+        if (items.length === 0) continue;
+        const sectionHeading = typeof section.heading === "function" ? section.heading(r) : section.heading;
+        md += `
+## ${sectionHeading}
+
+`;
+        if (section.render === "table" && section.columns) {
+          md += markdownTable(items, section.columns);
+        } else if (section.render === "list" && section.formatItem) {
+          for (const item of items) {
+            md += `- ${section.formatItem(item)}
+`;
+          }
+        } else if (typeof section.render === "function") {
+          md += section.render(items);
+        }
+      }
+    }
+    return md;
+  };
+}
+function compileEntitySections(tmpl) {
+  return (rows) => {
+    const data = tmpl.beforeRender ? tmpl.beforeRender(rows) : rows;
+    let md = DEFAULT_HEADER;
+    md += frontmatter(tmpl.frontmatter ?? {});
+    md += `# ${tmpl.heading}
+
+`;
+    if (data.length === 0) {
+      md += tmpl.emptyMessage ?? "*No data.*\n";
+      return md;
+    }
+    for (const row of data) {
+      md += `## ${tmpl.perRow.heading(row)}
+`;
+      if (tmpl.perRow.metadata?.length) {
+        const parts = tmpl.perRow.metadata.map((m) => {
+          const val = row[m.key];
+          const formatted = m.format ? m.format(val) : String(val ?? "");
+          return `**${m.label}:** ${formatted}`;
+        }).filter(Boolean);
+        if (parts.length > 0) {
+          md += parts.join(" | ") + "\n";
+        }
+      }
+      if (tmpl.perRow.body) {
+        md += `
+${tmpl.perRow.body(row)}
+`;
+      }
+      md += "\n";
+    }
+    return md;
+  };
+}
+
 // src/lifecycle/cleanup.ts
 import { join as join3 } from "path";
 import { existsSync as existsSync3, readdirSync, unlinkSync, rmdirSync, statSync } from "fs";
@@ -652,7 +818,8 @@ var RenderEngine = class {
           const source = mergeDefaults ? { ...def.sourceDefaults, ...spec.source } : spec.source;
           const rows = resolveEntitySource(source, entityRow, entityPk, this._adapter);
           if (spec.omitIfEmpty && rows.length === 0) continue;
-          const content = truncateContent(spec.render(rows), spec.budget);
+          const renderFn = compileEntityRender(spec.render);
+          const content = truncateContent(renderFn(rows), spec.budget);
           renderedFiles.set(filename, content);
           const filePath = join4(entityDir, filename);
           if (atomicWrite(filePath, content)) {
@@ -1140,6 +1307,7 @@ var Lattice = class {
   _renderHandlers = [];
   _writebackHandlers = [];
   _errorHandlers = [];
+  _writeHooks = [];
   constructor(pathOrConfig, options = {}) {
     let dbPath;
     let configTables;
@@ -1199,6 +1367,14 @@ var Lattice = class {
     this._schema.defineEntityContext(table, def);
     return this;
   }
+  /**
+   * Register a write hook that fires after insert/update/delete operations.
+   * Hooks run synchronously after the DB write and audit emit.
+   */
+  defineWriteHook(hook) {
+    this._writeHooks.push(hook);
+    return this;
+  }
   defineWriteback(def) {
     this._writeback.define(def);
     return this;
@@ -1248,6 +1424,7 @@ var Lattice = class {
     const rawPk = rowWithPk[pkCol];
     const pkValue = rawPk != null ? String(rawPk) : "";
     this._sanitizer.emitAudit(table, "insert", pkValue);
+    this._fireWriteHooks(table, "insert", rowWithPk, pkValue);
     return Promise.resolve(pkValue);
   }
   upsert(table, row) {
@@ -1301,6 +1478,7 @@ var Lattice = class {
     this._adapter.run(`UPDATE "${table}" SET ${setCols} WHERE ${clause}`, values);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "update", auditId);
+    this._fireWriteHooks(table, "update", sanitized, auditId, Object.keys(sanitized));
     return Promise.resolve();
   }
   delete(table, id) {
@@ -1310,6 +1488,7 @@ var Lattice = class {
     this._adapter.run(`DELETE FROM "${table}" WHERE ${clause}`, params);
     const auditId = typeof id === "string" ? id : JSON.stringify(id);
     this._sanitizer.emitAudit(table, "delete", auditId);
+    this._fireWriteHooks(table, "delete", { id: auditId }, auditId);
     return Promise.resolve();
   }
   get(table, id) {
@@ -1547,6 +1726,22 @@ var Lattice = class {
     return { clauses, params };
   }
   /** Returns a rejected Promise if not initialized; null if ready. */
+  _fireWriteHooks(table, op, row, pk, changedColumns) {
+    for (const hook of this._writeHooks) {
+      if (hook.table !== table) continue;
+      if (!hook.on.includes(op)) continue;
+      if (op === "update" && hook.watchColumns && changedColumns) {
+        if (!hook.watchColumns.some((c) => changedColumns.includes(c))) continue;
+      }
+      try {
+        const ctx = { table, op, row, pk };
+        if (changedColumns) ctx.changedColumns = changedColumns;
+        hook.handler(ctx);
+      } catch (err) {
+        for (const h of this._errorHandlers) h(err instanceof Error ? err : new Error(String(err)));
+      }
+    }
+  }
   _notInitError() {
     if (!this._initialized) {
       return Promise.reject(
@@ -1585,39 +1780,6 @@ var Lattice = class {
   }
 };
 
-// src/render/markdown.ts
-function frontmatter(fields) {
-  const lines = [`generated_at: "${(/* @__PURE__ */ new Date()).toISOString()}"`];
-  for (const [key, val] of Object.entries(fields)) {
-    lines.push(typeof val === "string" ? `${key}: "${val}"` : `${key}: ${String(val)}`);
-  }
-  return `---
-${lines.join("\n")}
----
-
-`;
-}
-function markdownTable(rows, columns) {
-  if (rows.length === 0 || columns.length === 0) return "";
-  const header = "| " + columns.map((c) => c.header).join(" | ") + " |";
-  const separator = "| " + columns.map(() => "---").join(" | ") + " |";
-  const body = rows.map((row) => {
-    const cells = columns.map((col) => {
-      const raw = row[col.key];
-      return col.format ? col.format(raw, row) : String(raw ?? "");
-    });
-    return "| " + cells.join(" | ") + " |";
-  });
-  return [header, separator, ...body].join("\n") + "\n";
-}
-function slugify(name) {
-  return name.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/\u0131/g, "i").replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-function truncate(content, maxChars, notice = "\n\n*[truncated \u2014 context budget exceeded]*") {
-  if (content.length <= maxChars) return content;
-  return content.slice(0, maxChars) + notice;
-}
-
 // src/session/parser.ts
 import { createHash as createHash2 } from "crypto";
 function generateWriteEntryId(timestamp, agentName, op, table, target) {
@@ -2002,19 +2164,6 @@ function applyWriteEntry(db, entry) {
     return { ok: false, reason: `DB error: ${message}` };
   }
 }
-
-// src/session/constants.ts
-function createReadOnlyHeader(options) {
-  const generator = options?.generator ?? "Lattice";
-  const docsRef = options?.docsRef ?? "the Lattice documentation";
-  return `<!-- READ ONLY \u2014 generated by ${generator}. Do not edit directly.
-     To update data in Lattice: write entries to SESSION.md in this directory.
-     Format: type: write | op: create/update/delete | table: <name> | target: <id>
-     See ${docsRef} for the SESSION.md format spec. -->
-
-`;
-}
-var READ_ONLY_HEADER = createReadOnlyHeader();
 export {
   DEFAULT_ENTRY_TYPES,
   DEFAULT_TYPE_ALIASES,

package/package.json

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