latticesql 0.8.0 → 0.9.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)) {

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)) {
@@ -1641,39 +1808,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 +2192,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.
@@ -1230,4 +1305,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 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.
@@ -1230,4 +1305,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 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)) {
@@ -1585,39 +1752,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 +2136,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.9.0",
   "description": "Persistent structured memory for AI agent systems — SQLite ↔ LLM context bridge",
   "type": "module",
   "main": "./dist/index.js",