latticesql 0.6.0 → 0.7.0

package/dist/cli.js

@@ -716,6 +716,19 @@ function resolveEntitySource(source, entityRow, entityPk, adapter) {
     }
     case "custom":
       return source.query(entityRow, adapter);
+    case "enriched": {
+      const enriched = { ...entityRow };
+      for (const [key, lookup] of Object.entries(source.include)) {
+        const fieldName = `_${key}`;
+        if (lookup.type === "custom") {
+          enriched[fieldName] = JSON.stringify(lookup.query(entityRow, adapter));
+        } else {
+          const resolved = resolveEntitySource(lookup, entityRow, entityPk, adapter);
+          enriched[fieldName] = JSON.stringify(resolved);
+        }
+      }
+      return [enriched];
+    }
   }
 }
 function truncateContent(content, budget) {
@@ -928,7 +941,8 @@ var RenderEngine = class {
         mkdirSync3(entityDir, { recursive: true });
         const renderedFiles = /* @__PURE__ */ new Map();
         for (const [filename, spec] of Object.entries(def.files)) {
-          const source = def.sourceDefaults && spec.source.type !== "self" && spec.source.type !== "custom" ? { ...def.sourceDefaults, ...spec.source } : spec.source;
+          const mergeDefaults = def.sourceDefaults && spec.source.type !== "self" && spec.source.type !== "custom" && spec.source.type !== "enriched";
+          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);

package/dist/index.cjs

@@ -458,6 +458,19 @@ function resolveEntitySource(source, entityRow, entityPk, adapter) {
     }
     case "custom":
       return source.query(entityRow, adapter);
+    case "enriched": {
+      const enriched = { ...entityRow };
+      for (const [key, lookup] of Object.entries(source.include)) {
+        const fieldName = `_${key}`;
+        if (lookup.type === "custom") {
+          enriched[fieldName] = JSON.stringify(lookup.query(entityRow, adapter));
+        } else {
+          const resolved = resolveEntitySource(lookup, entityRow, entityPk, adapter);
+          enriched[fieldName] = JSON.stringify(resolved);
+        }
+      }
+      return [enriched];
+    }
   }
 }
 function truncateContent(content, budget) {
@@ -670,7 +683,8 @@ var RenderEngine = class {
         (0, import_node_fs4.mkdirSync)(entityDir, { recursive: true });
         const renderedFiles = /* @__PURE__ */ new Map();
         for (const [filename, spec] of Object.entries(def.files)) {
-          const source = def.sourceDefaults && spec.source.type !== "self" && spec.source.type !== "custom" ? { ...def.sourceDefaults, ...spec.source } : spec.source;
+          const mergeDefaults = def.sourceDefaults && spec.source.type !== "self" && spec.source.type !== "custom" && spec.source.type !== "enriched";
+          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);

package/dist/index.d.cts

@@ -167,8 +167,57 @@ interface CustomSource {
     type: 'custom';
     query: (row: Row, adapter: StorageAdapter) => Row[];
 }
+/**
+ * Sub-lookup definition for an {@link EnrichedSource}.
+ * Each lookup resolves related rows and attaches them to the entity row
+ * as a `_key` JSON string field.
+ *
+ * Declarative lookups reuse the same types as file sources (with all
+ * query options). Custom lookups provide full control.
+ */
+type EnrichmentLookup = ({
+    as?: string;
+} & Omit<HasManySource, 'type'> & {
+    type: 'hasMany';
+}) | ({
+    as?: string;
+} & Omit<ManyToManySource, 'type'> & {
+    type: 'manyToMany';
+}) | ({
+    as?: string;
+} & Omit<BelongsToSource, 'type'> & {
+    type: 'belongsTo';
+}) | {
+    type: 'custom';
+    query: (row: Row, adapter: StorageAdapter) => Row[];
+};
+/**
+ * Start with the entity's own row (like `self`) and attach related data
+ * as JSON string fields.  Each key in `include` becomes a `_key` field
+ * on the returned row, containing `JSON.stringify(resolvedRows)`.
+ *
+ * Use when a single file needs the entity's own data plus related lists
+ * (e.g. an org profile that includes its agents and projects).
+ *
+ * @example
+ * ```ts
+ * source: {
+ *   type: 'enriched',
+ *   include: {
+ *     agents:   { type: 'hasMany', table: 'agents', foreignKey: 'org_id', softDelete: true },
+ *     projects: { type: 'hasMany', table: 'projects', foreignKey: 'org_id', softDelete: true },
+ *   },
+ * }
+ * // Result: [{ ...entityRow, _agents: '[...]', _projects: '[...]' }]
+ * ```
+ */
+interface EnrichedSource {
+    type: 'enriched';
+    /** Named lookups whose results are attached as `_key` JSON fields. */
+    include: Record<string, EnrichmentLookup>;
+}
 /** Union of all supported source types for {@link EntityFileSpec}. */
-type EntityFileSource = SelfSource | HasManySource | ManyToManySource | BelongsToSource | CustomSource;
+type EntityFileSource = SelfSource | HasManySource | ManyToManySource | BelongsToSource | CustomSource | EnrichedSource;
 /**
  * Specification for a single file generated inside an entity's directory.
  *
@@ -1147,4 +1196,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 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 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 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 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

@@ -167,8 +167,57 @@ interface CustomSource {
     type: 'custom';
     query: (row: Row, adapter: StorageAdapter) => Row[];
 }
+/**
+ * Sub-lookup definition for an {@link EnrichedSource}.
+ * Each lookup resolves related rows and attaches them to the entity row
+ * as a `_key` JSON string field.
+ *
+ * Declarative lookups reuse the same types as file sources (with all
+ * query options). Custom lookups provide full control.
+ */
+type EnrichmentLookup = ({
+    as?: string;
+} & Omit<HasManySource, 'type'> & {
+    type: 'hasMany';
+}) | ({
+    as?: string;
+} & Omit<ManyToManySource, 'type'> & {
+    type: 'manyToMany';
+}) | ({
+    as?: string;
+} & Omit<BelongsToSource, 'type'> & {
+    type: 'belongsTo';
+}) | {
+    type: 'custom';
+    query: (row: Row, adapter: StorageAdapter) => Row[];
+};
+/**
+ * Start with the entity's own row (like `self`) and attach related data
+ * as JSON string fields.  Each key in `include` becomes a `_key` field
+ * on the returned row, containing `JSON.stringify(resolvedRows)`.
+ *
+ * Use when a single file needs the entity's own data plus related lists
+ * (e.g. an org profile that includes its agents and projects).
+ *
+ * @example
+ * ```ts
+ * source: {
+ *   type: 'enriched',
+ *   include: {
+ *     agents:   { type: 'hasMany', table: 'agents', foreignKey: 'org_id', softDelete: true },
+ *     projects: { type: 'hasMany', table: 'projects', foreignKey: 'org_id', softDelete: true },
+ *   },
+ * }
+ * // Result: [{ ...entityRow, _agents: '[...]', _projects: '[...]' }]
+ * ```
+ */
+interface EnrichedSource {
+    type: 'enriched';
+    /** Named lookups whose results are attached as `_key` JSON fields. */
+    include: Record<string, EnrichmentLookup>;
+}
 /** Union of all supported source types for {@link EntityFileSpec}. */
-type EntityFileSource = SelfSource | HasManySource | ManyToManySource | BelongsToSource | CustomSource;
+type EntityFileSource = SelfSource | HasManySource | ManyToManySource | BelongsToSource | CustomSource | EnrichedSource;
 /**
  * Specification for a single file generated inside an entity's directory.
  *
@@ -1147,4 +1196,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 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 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 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 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

@@ -402,6 +402,19 @@ function resolveEntitySource(source, entityRow, entityPk, adapter) {
     }
     case "custom":
       return source.query(entityRow, adapter);
+    case "enriched": {
+      const enriched = { ...entityRow };
+      for (const [key, lookup] of Object.entries(source.include)) {
+        const fieldName = `_${key}`;
+        if (lookup.type === "custom") {
+          enriched[fieldName] = JSON.stringify(lookup.query(entityRow, adapter));
+        } else {
+          const resolved = resolveEntitySource(lookup, entityRow, entityPk, adapter);
+          enriched[fieldName] = JSON.stringify(resolved);
+        }
+      }
+      return [enriched];
+    }
   }
 }
 function truncateContent(content, budget) {
@@ -614,7 +627,8 @@ var RenderEngine = class {
         mkdirSync2(entityDir, { recursive: true });
         const renderedFiles = /* @__PURE__ */ new Map();
         for (const [filename, spec] of Object.entries(def.files)) {
-          const source = def.sourceDefaults && spec.source.type !== "self" && spec.source.type !== "custom" ? { ...def.sourceDefaults, ...spec.source } : spec.source;
+          const mergeDefaults = def.sourceDefaults && spec.source.type !== "self" && spec.source.type !== "custom" && spec.source.type !== "enriched";
+          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);

package/package.json

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