latticesql 0.13.0 → 0.14.0

package/dist/cli.js

@@ -1821,6 +1821,114 @@ var Lattice = class {
   _inferFk(table) {
     return `${table}_id`;
   }
+  // -------------------------------------------------------------------------
+  // Report framework (v0.14+)
+  // -------------------------------------------------------------------------
+  /**
+   * Build a report by querying data from tables within a time window.
+   * Each section runs a filtered query and formats the results.
+   */
+  async buildReport(config) {
+    const notInit = this._notInitError();
+    if (notInit) return notInit;
+    const since = this._resolveSince(config.since);
+    const sections = [];
+    let allEmpty = true;
+    for (const section of config.sections) {
+      const cols = this._ensureColumnCache(section.query.table);
+      const hasTimestamp = cols.has("timestamp");
+      const conditions = [];
+      const params = [];
+      if (hasTimestamp) {
+        conditions.push("timestamp >= ?");
+        params.push(since);
+      }
+      if (cols.has("deleted_at")) {
+        conditions.push("deleted_at IS NULL");
+      }
+      if (section.query.filters) {
+        for (const f of section.query.filters) {
+          switch (f.op) {
+            case "eq":
+              conditions.push(`"${f.col}" = ?`);
+              params.push(f.val);
+              break;
+            case "ne":
+              conditions.push(`"${f.col}" != ?`);
+              params.push(f.val);
+              break;
+            case "gt":
+              conditions.push(`"${f.col}" > ?`);
+              params.push(f.val);
+              break;
+            case "gte":
+              conditions.push(`"${f.col}" >= ?`);
+              params.push(f.val);
+              break;
+            case "lt":
+              conditions.push(`"${f.col}" < ?`);
+              params.push(f.val);
+              break;
+            case "lte":
+              conditions.push(`"${f.col}" <= ?`);
+              params.push(f.val);
+              break;
+            case "like":
+              conditions.push(`"${f.col}" LIKE ?`);
+              params.push(f.val);
+              break;
+            case "isNull":
+              conditions.push(`"${f.col}" IS NULL`);
+              break;
+            case "isNotNull":
+              conditions.push(`"${f.col}" IS NOT NULL`);
+              break;
+            case "in": {
+              const arr = f.val;
+              if (arr.length > 0) {
+                conditions.push(`"${f.col}" IN (${arr.map(() => "?").join(", ")})`);
+                params.push(...arr);
+              }
+              break;
+            }
+          }
+        }
+      }
+      const where = conditions.length > 0 ? ` WHERE ${conditions.join(" AND ")}` : "";
+      const orderBy = section.query.orderBy ? ` ORDER BY "${section.query.orderBy}" ${section.query.orderDir === "desc" ? "DESC" : "ASC"}` : "";
+      const limit = section.query.limit ? ` LIMIT ${section.query.limit}` : "";
+      const rows = this._adapter.all(`SELECT * FROM "${section.query.table}"${where}${orderBy}${limit}`, params);
+      if (rows.length > 0) allEmpty = false;
+      let formatted = "";
+      if (section.format === "custom" && section.customFormat) {
+        formatted = section.customFormat(rows);
+      } else if (section.format === "counts" && section.query.groupBy) {
+        const groups = /* @__PURE__ */ new Map();
+        for (const row of rows) {
+          const type = String(row[section.query.groupBy] ?? "other");
+          const prefix = type.includes(".") ? type.split(".")[0] : type;
+          groups.set(prefix, (groups.get(prefix) ?? 0) + 1);
+        }
+        formatted = [...groups.entries()].map(([k, v]) => `${k}: ${v}`).join("\n");
+      } else if (section.format === "count_and_list") {
+        formatted = `Count: ${rows.length}
+` + rows.map((r) => `- ${r.summary ?? r.name ?? r.title ?? JSON.stringify(r)}`).join("\n");
+      } else {
+        formatted = rows.map((r) => `- ${r.summary ?? r.name ?? r.title ?? JSON.stringify(r)}`).join("\n");
+      }
+      sections.push({ name: section.name, rows, count: rows.length, formatted });
+    }
+    return { sections, isEmpty: allEmpty, since };
+  }
+  /** Parse duration shorthand ('8h', '24h', '7d') into ISO timestamp. */
+  _resolveSince(since) {
+    const match = since.match(/^(\d+)([hmd])$/);
+    if (!match) return since;
+    const [, numStr, unit] = match;
+    const num = parseInt(numStr, 10);
+    const ms = unit === "h" ? num * 36e5 : unit === "d" ? num * 864e5 : num * 6e4;
+    return new Date(Date.now() - ms).toISOString();
+  }
   query(table, opts = {}) {
     const notInit = this._notInitError();
     if (notInit) return notInit;

package/dist/index.cjs

@@ -1851,6 +1851,114 @@ var Lattice = class {
   _inferFk(table) {
     return `${table}_id`;
   }
+  // -------------------------------------------------------------------------
+  // Report framework (v0.14+)
+  // -------------------------------------------------------------------------
+  /**
+   * Build a report by querying data from tables within a time window.
+   * Each section runs a filtered query and formats the results.
+   */
+  async buildReport(config) {
+    const notInit = this._notInitError();
+    if (notInit) return notInit;
+    const since = this._resolveSince(config.since);
+    const sections = [];
+    let allEmpty = true;
+    for (const section of config.sections) {
+      const cols = this._ensureColumnCache(section.query.table);
+      const hasTimestamp = cols.has("timestamp");
+      const conditions = [];
+      const params = [];
+      if (hasTimestamp) {
+        conditions.push("timestamp >= ?");
+        params.push(since);
+      }
+      if (cols.has("deleted_at")) {
+        conditions.push("deleted_at IS NULL");
+      }
+      if (section.query.filters) {
+        for (const f of section.query.filters) {
+          switch (f.op) {
+            case "eq":
+              conditions.push(`"${f.col}" = ?`);
+              params.push(f.val);
+              break;
+            case "ne":
+              conditions.push(`"${f.col}" != ?`);
+              params.push(f.val);
+              break;
+            case "gt":
+              conditions.push(`"${f.col}" > ?`);
+              params.push(f.val);
+              break;
+            case "gte":
+              conditions.push(`"${f.col}" >= ?`);
+              params.push(f.val);
+              break;
+            case "lt":
+              conditions.push(`"${f.col}" < ?`);
+              params.push(f.val);
+              break;
+            case "lte":
+              conditions.push(`"${f.col}" <= ?`);
+              params.push(f.val);
+              break;
+            case "like":
+              conditions.push(`"${f.col}" LIKE ?`);
+              params.push(f.val);
+              break;
+            case "isNull":
+              conditions.push(`"${f.col}" IS NULL`);
+              break;
+            case "isNotNull":
+              conditions.push(`"${f.col}" IS NOT NULL`);
+              break;
+            case "in": {
+              const arr = f.val;
+              if (arr.length > 0) {
+                conditions.push(`"${f.col}" IN (${arr.map(() => "?").join(", ")})`);
+                params.push(...arr);
+              }
+              break;
+            }
+          }
+        }
+      }
+      const where = conditions.length > 0 ? ` WHERE ${conditions.join(" AND ")}` : "";
+      const orderBy = section.query.orderBy ? ` ORDER BY "${section.query.orderBy}" ${section.query.orderDir === "desc" ? "DESC" : "ASC"}` : "";
+      const limit = section.query.limit ? ` LIMIT ${section.query.limit}` : "";
+      const rows = this._adapter.all(`SELECT * FROM "${section.query.table}"${where}${orderBy}${limit}`, params);
+      if (rows.length > 0) allEmpty = false;
+      let formatted = "";
+      if (section.format === "custom" && section.customFormat) {
+        formatted = section.customFormat(rows);
+      } else if (section.format === "counts" && section.query.groupBy) {
+        const groups = /* @__PURE__ */ new Map();
+        for (const row of rows) {
+          const type = String(row[section.query.groupBy] ?? "other");
+          const prefix = type.includes(".") ? type.split(".")[0] : type;
+          groups.set(prefix, (groups.get(prefix) ?? 0) + 1);
+        }
+        formatted = [...groups.entries()].map(([k, v]) => `${k}: ${v}`).join("\n");
+      } else if (section.format === "count_and_list") {
+        formatted = `Count: ${rows.length}
+` + rows.map((r) => `- ${r.summary ?? r.name ?? r.title ?? JSON.stringify(r)}`).join("\n");
+      } else {
+        formatted = rows.map((r) => `- ${r.summary ?? r.name ?? r.title ?? JSON.stringify(r)}`).join("\n");
+      }
+      sections.push({ name: section.name, rows, count: rows.length, formatted });
+    }
+    return { sections, isEmpty: allEmpty, since };
+  }
+  /** Parse duration shorthand ('8h', '24h', '7d') into ISO timestamp. */
+  _resolveSince(since) {
+    const match = since.match(/^(\d+)([hmd])$/);
+    if (!match) return since;
+    const [, numStr, unit] = match;
+    const num = parseInt(numStr, 10);
+    const ms = unit === "h" ? num * 36e5 : unit === "d" ? num * 864e5 : num * 6e4;
+    return new Date(Date.now() - ms).toISOString();
+  }
   query(table, opts = {}) {
     const notInit = this._notInitError();
     if (notInit) return notInit;

package/dist/index.d.cts

@@ -859,6 +859,57 @@ interface SeedConfig {
     /** Organization ID for org-scoped tables. */
     orgId?: string;
 }
+/**
+ * A single section in a report.
+ */
+interface ReportSection {
+    /** Section name (used as key in result). */
+    name: string;
+    /** Query configuration. */
+    query: {
+        /** Table to query. */
+        table: string;
+        /** Additional filters beyond the time window. */
+        filters?: Filter[];
+        /** Group results by column value prefix (e.g., type prefix). */
+        groupBy?: string;
+        /** Order results. */
+        orderBy?: string;
+        /** Sort direction. */
+        orderDir?: 'asc' | 'desc';
+        /** Max rows. */
+        limit?: number;
+    };
+    /** Output format. */
+    format: 'count_and_list' | 'counts' | 'list' | 'custom';
+    /** Custom formatter (when format='custom'). */
+    customFormat?: (rows: Row[]) => string;
+}
+/**
+ * Configuration for {@link Lattice.buildReport}.
+ */
+interface ReportConfig {
+    /** Time window: ISO timestamp or shorthand ('8h', '24h', '7d'). */
+    since: string;
+    /** Report sections to generate. */
+    sections: ReportSection[];
+    /** Message when all sections are empty. */
+    emptyMessage?: string;
+}
+/**
+ * Result from {@link Lattice.buildReport}.
+ */
+interface ReportSectionResult {
+    name: string;
+    rows: Row[];
+    count: number;
+    formatted: string;
+}
+interface ReportResult {
+    sections: ReportSectionResult[];
+    isEmpty: boolean;
+    since: string;
+}
 /**
  * Context passed to write hook handlers.
  */
@@ -1015,6 +1066,13 @@ declare class Lattice {
     seed(config: SeedConfig): Promise<SeedResult>;
     /** Infer FK column name from table name (e.g., 'rule' → 'rule_id'). */
     private _inferFk;
+    /**
+     * Build a report by querying data from tables within a time window.
+     * Each section runs a filtered query and formats the results.
+     */
+    buildReport(config: ReportConfig): Promise<ReportResult>;
+    /** Parse duration shorthand ('8h', '24h', '7d') into ISO timestamp. */
+    private _resolveSince;
     query(table: string, opts?: QueryOptions): Promise<Row[]>;
     count(table: string, opts?: CountOptions): Promise<number>;
     render(outputDir: string): Promise<RenderResult>;
@@ -1509,4 +1567,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 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, InMemoryStateStore, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type LinkOptions, 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 SeedConfig, type SeedLinkSpec, type SeedResult, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type UpsertByNaturalKeyOptions, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, type WritebackStateStore, applyWriteEntry, createReadOnlyHeader, createSQLiteStateStore, 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, InMemoryStateStore, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type LinkOptions, 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 ReportConfig, type ReportResult, type ReportSection, type ReportSectionResult, type Row, type SecurityOptions, type SeedConfig, type SeedLinkSpec, type SeedResult, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type UpsertByNaturalKeyOptions, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, type WritebackStateStore, applyWriteEntry, createReadOnlyHeader, createSQLiteStateStore, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };

package/dist/index.d.ts

@@ -859,6 +859,57 @@ interface SeedConfig {
     /** Organization ID for org-scoped tables. */
     orgId?: string;
 }
+/**
+ * A single section in a report.
+ */
+interface ReportSection {
+    /** Section name (used as key in result). */
+    name: string;
+    /** Query configuration. */
+    query: {
+        /** Table to query. */
+        table: string;
+        /** Additional filters beyond the time window. */
+        filters?: Filter[];
+        /** Group results by column value prefix (e.g., type prefix). */
+        groupBy?: string;
+        /** Order results. */
+        orderBy?: string;
+        /** Sort direction. */
+        orderDir?: 'asc' | 'desc';
+        /** Max rows. */
+        limit?: number;
+    };
+    /** Output format. */
+    format: 'count_and_list' | 'counts' | 'list' | 'custom';
+    /** Custom formatter (when format='custom'). */
+    customFormat?: (rows: Row[]) => string;
+}
+/**
+ * Configuration for {@link Lattice.buildReport}.
+ */
+interface ReportConfig {
+    /** Time window: ISO timestamp or shorthand ('8h', '24h', '7d'). */
+    since: string;
+    /** Report sections to generate. */
+    sections: ReportSection[];
+    /** Message when all sections are empty. */
+    emptyMessage?: string;
+}
+/**
+ * Result from {@link Lattice.buildReport}.
+ */
+interface ReportSectionResult {
+    name: string;
+    rows: Row[];
+    count: number;
+    formatted: string;
+}
+interface ReportResult {
+    sections: ReportSectionResult[];
+    isEmpty: boolean;
+    since: string;
+}
 /**
  * Context passed to write hook handlers.
  */
@@ -1015,6 +1066,13 @@ declare class Lattice {
     seed(config: SeedConfig): Promise<SeedResult>;
     /** Infer FK column name from table name (e.g., 'rule' → 'rule_id'). */
     private _inferFk;
+    /**
+     * Build a report by querying data from tables within a time window.
+     * Each section runs a filtered query and formats the results.
+     */
+    buildReport(config: ReportConfig): Promise<ReportResult>;
+    /** Parse duration shorthand ('8h', '24h', '7d') into ISO timestamp. */
+    private _resolveSince;
     query(table: string, opts?: QueryOptions): Promise<Row[]>;
     count(table: string, opts?: CountOptions): Promise<number>;
     render(outputDir: string): Promise<RenderResult>;
@@ -1509,4 +1567,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 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, InMemoryStateStore, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type LinkOptions, 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 SeedConfig, type SeedLinkSpec, type SeedResult, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type UpsertByNaturalKeyOptions, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, type WritebackStateStore, applyWriteEntry, createReadOnlyHeader, createSQLiteStateStore, 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, InMemoryStateStore, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type LinkOptions, 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 ReportConfig, type ReportResult, type ReportSection, type ReportSectionResult, type Row, type SecurityOptions, type SeedConfig, type SeedLinkSpec, type SeedResult, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type UpsertByNaturalKeyOptions, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, type WritebackStateStore, applyWriteEntry, createReadOnlyHeader, createSQLiteStateStore, frontmatter, generateEntryId, generateWriteEntryId, manifestPath, markdownTable, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };

package/dist/index.js

@@ -1793,6 +1793,114 @@ var Lattice = class {
   _inferFk(table) {
     return `${table}_id`;
   }
+  // -------------------------------------------------------------------------
+  // Report framework (v0.14+)
+  // -------------------------------------------------------------------------
+  /**
+   * Build a report by querying data from tables within a time window.
+   * Each section runs a filtered query and formats the results.
+   */
+  async buildReport(config) {
+    const notInit = this._notInitError();
+    if (notInit) return notInit;
+    const since = this._resolveSince(config.since);
+    const sections = [];
+    let allEmpty = true;
+    for (const section of config.sections) {
+      const cols = this._ensureColumnCache(section.query.table);
+      const hasTimestamp = cols.has("timestamp");
+      const conditions = [];
+      const params = [];
+      if (hasTimestamp) {
+        conditions.push("timestamp >= ?");
+        params.push(since);
+      }
+      if (cols.has("deleted_at")) {
+        conditions.push("deleted_at IS NULL");
+      }
+      if (section.query.filters) {
+        for (const f of section.query.filters) {
+          switch (f.op) {
+            case "eq":
+              conditions.push(`"${f.col}" = ?`);
+              params.push(f.val);
+              break;
+            case "ne":
+              conditions.push(`"${f.col}" != ?`);
+              params.push(f.val);
+              break;
+            case "gt":
+              conditions.push(`"${f.col}" > ?`);
+              params.push(f.val);
+              break;
+            case "gte":
+              conditions.push(`"${f.col}" >= ?`);
+              params.push(f.val);
+              break;
+            case "lt":
+              conditions.push(`"${f.col}" < ?`);
+              params.push(f.val);
+              break;
+            case "lte":
+              conditions.push(`"${f.col}" <= ?`);
+              params.push(f.val);
+              break;
+            case "like":
+              conditions.push(`"${f.col}" LIKE ?`);
+              params.push(f.val);
+              break;
+            case "isNull":
+              conditions.push(`"${f.col}" IS NULL`);
+              break;
+            case "isNotNull":
+              conditions.push(`"${f.col}" IS NOT NULL`);
+              break;
+            case "in": {
+              const arr = f.val;
+              if (arr.length > 0) {
+                conditions.push(`"${f.col}" IN (${arr.map(() => "?").join(", ")})`);
+                params.push(...arr);
+              }
+              break;
+            }
+          }
+        }
+      }
+      const where = conditions.length > 0 ? ` WHERE ${conditions.join(" AND ")}` : "";
+      const orderBy = section.query.orderBy ? ` ORDER BY "${section.query.orderBy}" ${section.query.orderDir === "desc" ? "DESC" : "ASC"}` : "";
+      const limit = section.query.limit ? ` LIMIT ${section.query.limit}` : "";
+      const rows = this._adapter.all(`SELECT * FROM "${section.query.table}"${where}${orderBy}${limit}`, params);
+      if (rows.length > 0) allEmpty = false;
+      let formatted = "";
+      if (section.format === "custom" && section.customFormat) {
+        formatted = section.customFormat(rows);
+      } else if (section.format === "counts" && section.query.groupBy) {
+        const groups = /* @__PURE__ */ new Map();
+        for (const row of rows) {
+          const type = String(row[section.query.groupBy] ?? "other");
+          const prefix = type.includes(".") ? type.split(".")[0] : type;
+          groups.set(prefix, (groups.get(prefix) ?? 0) + 1);
+        }
+        formatted = [...groups.entries()].map(([k, v]) => `${k}: ${v}`).join("\n");
+      } else if (section.format === "count_and_list") {
+        formatted = `Count: ${rows.length}
+` + rows.map((r) => `- ${r.summary ?? r.name ?? r.title ?? JSON.stringify(r)}`).join("\n");
+      } else {
+        formatted = rows.map((r) => `- ${r.summary ?? r.name ?? r.title ?? JSON.stringify(r)}`).join("\n");
+      }
+      sections.push({ name: section.name, rows, count: rows.length, formatted });
+    }
+    return { sections, isEmpty: allEmpty, since };
+  }
+  /** Parse duration shorthand ('8h', '24h', '7d') into ISO timestamp. */
+  _resolveSince(since) {
+    const match = since.match(/^(\d+)([hmd])$/);
+    if (!match) return since;
+    const [, numStr, unit] = match;
+    const num = parseInt(numStr, 10);
+    const ms = unit === "h" ? num * 36e5 : unit === "d" ? num * 864e5 : num * 6e4;
+    return new Date(Date.now() - ms).toISOString();
+  }
   query(table, opts = {}) {
     const notInit = this._notInitError();
     if (notInit) return notInit;

package/package.json

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