latticesql 0.5.4 → 0.5.5

package/dist/index.cjs

@@ -30,9 +30,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_ENTRY_TYPES: () => DEFAULT_ENTRY_TYPES,
+  DEFAULT_TYPE_ALIASES: () => DEFAULT_TYPE_ALIASES,
   Lattice: () => Lattice,
   READ_ONLY_HEADER: () => READ_ONLY_HEADER,
   applyWriteEntry: () => applyWriteEntry,
+  createReadOnlyHeader: () => createReadOnlyHeader,
   generateEntryId: () => generateEntryId,
   generateWriteEntryId: () => generateWriteEntryId,
   manifestPath: () => manifestPath,
@@ -1634,7 +1637,7 @@ function parseBlock(block) {
 
 // src/session/entries.ts
 var import_node_crypto4 = require("crypto");
-var VALID_TYPES = /* @__PURE__ */ new Set([
+var DEFAULT_ENTRY_TYPES = /* @__PURE__ */ new Set([
   "event",
   "learning",
   "status",
@@ -1644,7 +1647,7 @@ var VALID_TYPES = /* @__PURE__ */ new Set([
   "handoff",
   "write"
 ]);
-var TYPE_ALIASES = {
+var DEFAULT_TYPE_ALIASES = {
   task_completion: "event",
   completion: "event",
   heartbeat: "status",
@@ -1654,7 +1657,7 @@ var TYPE_ALIASES = {
   note: "event"
 };
 var FIELD_NAME_RE2 = /^[a-zA-Z0-9_]+$/;
-function parseSessionMD(content, startOffset = 0) {
+function parseSessionMD(content, startOffset = 0, options) {
   const entries = [];
   const errors = [];
   const text = content.slice(startOffset);
@@ -1710,7 +1713,7 @@ function parseSessionMD(content, startOffset = 0) {
     }
     const body = bodyLines.join("\n").trim();
     const rawType = headers["type"] ?? "";
-    const resolvedType = normalizeType(rawType);
+    const resolvedType = normalizeType(rawType, options);
     if (!resolvedType) {
       errors.push({ line: entryStartLine + 1, message: `Unknown entry type: ${rawType}` });
       continue;
@@ -1760,7 +1763,7 @@ function parseSessionMD(content, startOffset = 0) {
   }
   return { entries, errors, lastOffset: currentByteOffset };
 }
-function parseMarkdownEntries(content, agentName, startOffset = 0) {
+function parseMarkdownEntries(content, agentName, startOffset = 0, options) {
   const entries = [];
   const errors = [];
   const text = content.slice(startOffset);
@@ -1802,7 +1805,7 @@ function parseMarkdownEntries(content, agentName, startOffset = 0) {
       continue;
     }
     const rawType = bodyType ?? start.headingType ?? "event";
-    const resolvedType = normalizeType(rawType) ?? "event";
+    const resolvedType = normalizeType(rawType, options) ?? "event";
     const id = generateEntryId(start.timestamp, agentName, body);
     entries.push({
       id,
@@ -1825,13 +1828,25 @@ function validateEntryId(id, body) {
   const expectedHash = (0, import_node_crypto4.createHash)("sha256").update(body).digest("hex").slice(0, 6);
   return hash === expectedHash;
 }
-function normalizeType(raw) {
+function normalizeType(raw, options) {
   const lower = raw.toLowerCase().trim();
-  if (VALID_TYPES.has(lower)) return lower;
-  const normalized = lower.replace(/-/g, "_");
-  if (TYPE_ALIASES[normalized]) return TYPE_ALIASES[normalized];
-  for (const alias of Object.keys(TYPE_ALIASES)) {
-    if (normalized.startsWith(alias)) return TYPE_ALIASES[alias];
+  if (!lower) return null;
+  const validTypes = options?.validTypes === void 0 ? DEFAULT_ENTRY_TYPES : options.validTypes;
+  const aliases = options?.typeAliases === void 0 ? DEFAULT_TYPE_ALIASES : options.typeAliases;
+  if (validTypes === null) {
+    if (aliases) {
+      const normalized = lower.replace(/-/g, "_");
+      if (aliases[normalized]) return aliases[normalized];
+    }
+    return lower;
+  }
+  if (validTypes.has(lower)) return lower;
+  if (aliases) {
+    const normalized = lower.replace(/-/g, "_");
+    if (aliases[normalized]) return aliases[normalized];
+    for (const alias of Object.keys(aliases)) {
+      if (normalized.startsWith(alias)) return aliases[alias];
+    }
   }
   return null;
 }
@@ -1895,17 +1910,25 @@ function applyWriteEntry(db, entry) {
 }
 
 // src/session/constants.ts
-var READ_ONLY_HEADER = `<!-- READ ONLY \u2014 generated by lattice-sync. Do not edit directly.
+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 agents/shared/SESSION-FORMAT.md for the full spec. -->
+     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,
+  DEFAULT_TYPE_ALIASES,
   Lattice,
   READ_ONLY_HEADER,
   applyWriteEntry,
+  createReadOnlyHeader,
   generateEntryId,
   generateWriteEntryId,
   manifestPath,

package/dist/index.d.cts

@@ -896,9 +896,10 @@ declare function generateWriteEntryId(timestamp: string, agentName: string, op:
 declare function parseSessionWrites(content: string): SessionWriteParseResult;
 
 /**
- * A single parsed SESSION.md entry. Covers all entry types:
- * event, learning, status, correction, discovery, metric, handoff, write.
+ * A single parsed SESSION.md entry.
  *
+ * The `type` field holds the resolved entry type (from the built-in set or
+ * custom types supplied via {@link SessionParseOptions}).
  * When `type === 'write'`, the op/table/target/reason/fields fields are set.
  */
 interface SessionEntry {
@@ -929,6 +930,39 @@ interface ParseResult {
     /** Byte offset after the last fully parsed entry — used for incremental parsing. */
     lastOffset: number;
 }
+/**
+ * Options for {@link parseSessionMD} and {@link parseMarkdownEntries}.
+ *
+ * All fields are optional — omitting them preserves the default behaviour
+ * (built-in type set + built-in aliases), so existing callers are unaffected.
+ */
+interface SessionParseOptions {
+    /**
+     * Set of valid entry type names.
+     * - Omit (or `undefined`) → use {@link DEFAULT_ENTRY_TYPES}.
+     * - `null` → accept **any** type string without validation.
+     * - Provide a custom `Set<string>` to restrict to your own taxonomy.
+     */
+    validTypes?: Set<string> | null;
+    /**
+     * Map of non-standard type names to their canonical form.
+     * - Omit (or `undefined`) → use {@link DEFAULT_TYPE_ALIASES}.
+     * - `null` → disable alias resolution.
+     * - Provide a custom `Record<string, string>` for your own aliases.
+     */
+    typeAliases?: Record<string, string> | null;
+}
+/**
+ * Default set of valid entry types shipped with latticesql.
+ * Suitable for LLM-agent context systems; override via {@link SessionParseOptions.validTypes}.
+ */
+declare const DEFAULT_ENTRY_TYPES: ReadonlySet<string>;
+/**
+ * Default type aliases shipped with latticesql.
+ * Maps commonly-seen alternative names to their canonical type.
+ * Override via {@link SessionParseOptions.typeAliases}.
+ */
+declare const DEFAULT_TYPE_ALIASES: Readonly<Record<string, string>>;
 /**
  * Parse SESSION.md YAML-delimited entries starting at `startOffset` bytes.
  *
@@ -942,15 +976,18 @@ interface ParseResult {
  * Entry body text here.
  * ===
  * ```
+ *
+ * Pass {@link SessionParseOptions} to customise which entry types are accepted
+ * and how aliases are resolved. Defaults match the built-in type set.
  */
-declare function parseSessionMD(content: string, startOffset?: number): ParseResult;
+declare function parseSessionMD(content: string, startOffset?: number, options?: SessionParseOptions): ParseResult;
 /**
- * Parse free-form Markdown SESSION.md entries. Agents sometimes write entries
- * as `## {timestamp} — {description}` headings rather than YAML blocks.
+ * Parse free-form Markdown SESSION.md entries written as
+ * `## {timestamp} — {description}` headings rather than YAML blocks.
  *
  * Runs alongside `parseSessionMD`; the two parsers are merged by caller.
  */
-declare function parseMarkdownEntries(content: string, agentName: string, startOffset?: number): ParseResult;
+declare function parseMarkdownEntries(content: string, agentName: string, startOffset?: number, options?: SessionParseOptions): ParseResult;
 /**
  * Generate a content-addressed entry ID.
  * Format: `{timestamp}-{agentName}-{6-char-sha256-prefix}`
@@ -988,12 +1025,26 @@ type ApplyWriteResult = {
 declare function applyWriteEntry(db: Database.Database, entry: SessionWriteEntry): ApplyWriteResult;
 
 /**
- * Read-only header prepended to all Lattice-generated context files.
+ * Options for {@link createReadOnlyHeader}.
+ */
+interface ReadOnlyHeaderOptions {
+    /** Name shown as the generator (default: `"Lattice"`). */
+    generator?: string;
+    /** Where to find the SESSION.md format spec (default: `"the Lattice documentation"`). */
+    docsRef?: string;
+}
+/**
+ * Build a read-only header for Lattice-generated context files.
+ *
+ * The header tells consumers (human or LLM) that the file is auto-generated
+ * and that writes should go through SESSION.md instead.
+ */
+declare function createReadOnlyHeader(options?: ReadOnlyHeaderOptions): string;
+/**
+ * Default read-only header prepended to all Lattice-generated context files.
  *
- * Directs agents to SESSION.md for writes rather than editing generated files
- * directly. Include at the top of every rendered markdown context file so
- * agents see it at the start of their context window.
+ * For a customised header, use {@link createReadOnlyHeader} instead.
  */
-declare const READ_ONLY_HEADER = "<!-- READ ONLY \u2014 generated by lattice-sync. Do not edit directly.\n     To update data in Lattice: write entries to SESSION.md in this directory.\n     Format: type: write | op: create/update/delete | table: <name> | target: <id>\n     See agents/shared/SESSION-FORMAT.md for the full spec. -->\n\n";
+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, 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 Migration, type MultiTableDefinition, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WritebackDefinition, applyWriteEntry, generateEntryId, generateWriteEntryId, manifestPath, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, 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 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 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 StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, generateEntryId, generateWriteEntryId, manifestPath, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, validateEntryId, writeManifest };

package/dist/index.d.ts

@@ -896,9 +896,10 @@ declare function generateWriteEntryId(timestamp: string, agentName: string, op:
 declare function parseSessionWrites(content: string): SessionWriteParseResult;
 
 /**
- * A single parsed SESSION.md entry. Covers all entry types:
- * event, learning, status, correction, discovery, metric, handoff, write.
+ * A single parsed SESSION.md entry.
  *
+ * The `type` field holds the resolved entry type (from the built-in set or
+ * custom types supplied via {@link SessionParseOptions}).
  * When `type === 'write'`, the op/table/target/reason/fields fields are set.
  */
 interface SessionEntry {
@@ -929,6 +930,39 @@ interface ParseResult {
     /** Byte offset after the last fully parsed entry — used for incremental parsing. */
     lastOffset: number;
 }
+/**
+ * Options for {@link parseSessionMD} and {@link parseMarkdownEntries}.
+ *
+ * All fields are optional — omitting them preserves the default behaviour
+ * (built-in type set + built-in aliases), so existing callers are unaffected.
+ */
+interface SessionParseOptions {
+    /**
+     * Set of valid entry type names.
+     * - Omit (or `undefined`) → use {@link DEFAULT_ENTRY_TYPES}.
+     * - `null` → accept **any** type string without validation.
+     * - Provide a custom `Set<string>` to restrict to your own taxonomy.
+     */
+    validTypes?: Set<string> | null;
+    /**
+     * Map of non-standard type names to their canonical form.
+     * - Omit (or `undefined`) → use {@link DEFAULT_TYPE_ALIASES}.
+     * - `null` → disable alias resolution.
+     * - Provide a custom `Record<string, string>` for your own aliases.
+     */
+    typeAliases?: Record<string, string> | null;
+}
+/**
+ * Default set of valid entry types shipped with latticesql.
+ * Suitable for LLM-agent context systems; override via {@link SessionParseOptions.validTypes}.
+ */
+declare const DEFAULT_ENTRY_TYPES: ReadonlySet<string>;
+/**
+ * Default type aliases shipped with latticesql.
+ * Maps commonly-seen alternative names to their canonical type.
+ * Override via {@link SessionParseOptions.typeAliases}.
+ */
+declare const DEFAULT_TYPE_ALIASES: Readonly<Record<string, string>>;
 /**
  * Parse SESSION.md YAML-delimited entries starting at `startOffset` bytes.
  *
@@ -942,15 +976,18 @@ interface ParseResult {
  * Entry body text here.
  * ===
  * ```
+ *
+ * Pass {@link SessionParseOptions} to customise which entry types are accepted
+ * and how aliases are resolved. Defaults match the built-in type set.
  */
-declare function parseSessionMD(content: string, startOffset?: number): ParseResult;
+declare function parseSessionMD(content: string, startOffset?: number, options?: SessionParseOptions): ParseResult;
 /**
- * Parse free-form Markdown SESSION.md entries. Agents sometimes write entries
- * as `## {timestamp} — {description}` headings rather than YAML blocks.
+ * Parse free-form Markdown SESSION.md entries written as
+ * `## {timestamp} — {description}` headings rather than YAML blocks.
  *
  * Runs alongside `parseSessionMD`; the two parsers are merged by caller.
  */
-declare function parseMarkdownEntries(content: string, agentName: string, startOffset?: number): ParseResult;
+declare function parseMarkdownEntries(content: string, agentName: string, startOffset?: number, options?: SessionParseOptions): ParseResult;
 /**
  * Generate a content-addressed entry ID.
  * Format: `{timestamp}-{agentName}-{6-char-sha256-prefix}`
@@ -988,12 +1025,26 @@ type ApplyWriteResult = {
 declare function applyWriteEntry(db: Database.Database, entry: SessionWriteEntry): ApplyWriteResult;
 
 /**
- * Read-only header prepended to all Lattice-generated context files.
+ * Options for {@link createReadOnlyHeader}.
+ */
+interface ReadOnlyHeaderOptions {
+    /** Name shown as the generator (default: `"Lattice"`). */
+    generator?: string;
+    /** Where to find the SESSION.md format spec (default: `"the Lattice documentation"`). */
+    docsRef?: string;
+}
+/**
+ * Build a read-only header for Lattice-generated context files.
+ *
+ * The header tells consumers (human or LLM) that the file is auto-generated
+ * and that writes should go through SESSION.md instead.
+ */
+declare function createReadOnlyHeader(options?: ReadOnlyHeaderOptions): string;
+/**
+ * Default read-only header prepended to all Lattice-generated context files.
  *
- * Directs agents to SESSION.md for writes rather than editing generated files
- * directly. Include at the top of every rendered markdown context file so
- * agents see it at the start of their context window.
+ * For a customised header, use {@link createReadOnlyHeader} instead.
  */
-declare const READ_ONLY_HEADER = "<!-- READ ONLY \u2014 generated by lattice-sync. Do not edit directly.\n     To update data in Lattice: write entries to SESSION.md in this directory.\n     Format: type: write | op: create/update/delete | table: <name> | target: <id>\n     See agents/shared/SESSION-FORMAT.md for the full spec. -->\n\n";
+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, 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 Migration, type MultiTableDefinition, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type Row, type SecurityOptions, type SelfSource, type SessionEntry, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WritebackDefinition, applyWriteEntry, generateEntryId, generateWriteEntryId, manifestPath, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, 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 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 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 StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type WatchOptions, type WritebackDefinition, applyWriteEntry, createReadOnlyHeader, generateEntryId, generateWriteEntryId, manifestPath, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, validateEntryId, writeManifest };

package/dist/index.js

@@ -1585,7 +1585,7 @@ function parseBlock(block) {
 
 // src/session/entries.ts
 import { createHash as createHash3 } from "crypto";
-var VALID_TYPES = /* @__PURE__ */ new Set([
+var DEFAULT_ENTRY_TYPES = /* @__PURE__ */ new Set([
   "event",
   "learning",
   "status",
@@ -1595,7 +1595,7 @@ var VALID_TYPES = /* @__PURE__ */ new Set([
   "handoff",
   "write"
 ]);
-var TYPE_ALIASES = {
+var DEFAULT_TYPE_ALIASES = {
   task_completion: "event",
   completion: "event",
   heartbeat: "status",
@@ -1605,7 +1605,7 @@ var TYPE_ALIASES = {
   note: "event"
 };
 var FIELD_NAME_RE2 = /^[a-zA-Z0-9_]+$/;
-function parseSessionMD(content, startOffset = 0) {
+function parseSessionMD(content, startOffset = 0, options) {
   const entries = [];
   const errors = [];
   const text = content.slice(startOffset);
@@ -1661,7 +1661,7 @@ function parseSessionMD(content, startOffset = 0) {
     }
     const body = bodyLines.join("\n").trim();
     const rawType = headers["type"] ?? "";
-    const resolvedType = normalizeType(rawType);
+    const resolvedType = normalizeType(rawType, options);
     if (!resolvedType) {
       errors.push({ line: entryStartLine + 1, message: `Unknown entry type: ${rawType}` });
       continue;
@@ -1711,7 +1711,7 @@ function parseSessionMD(content, startOffset = 0) {
   }
   return { entries, errors, lastOffset: currentByteOffset };
 }
-function parseMarkdownEntries(content, agentName, startOffset = 0) {
+function parseMarkdownEntries(content, agentName, startOffset = 0, options) {
   const entries = [];
   const errors = [];
   const text = content.slice(startOffset);
@@ -1753,7 +1753,7 @@ function parseMarkdownEntries(content, agentName, startOffset = 0) {
       continue;
     }
     const rawType = bodyType ?? start.headingType ?? "event";
-    const resolvedType = normalizeType(rawType) ?? "event";
+    const resolvedType = normalizeType(rawType, options) ?? "event";
     const id = generateEntryId(start.timestamp, agentName, body);
     entries.push({
       id,
@@ -1776,13 +1776,25 @@ function validateEntryId(id, body) {
   const expectedHash = createHash3("sha256").update(body).digest("hex").slice(0, 6);
   return hash === expectedHash;
 }
-function normalizeType(raw) {
+function normalizeType(raw, options) {
   const lower = raw.toLowerCase().trim();
-  if (VALID_TYPES.has(lower)) return lower;
-  const normalized = lower.replace(/-/g, "_");
-  if (TYPE_ALIASES[normalized]) return TYPE_ALIASES[normalized];
-  for (const alias of Object.keys(TYPE_ALIASES)) {
-    if (normalized.startsWith(alias)) return TYPE_ALIASES[alias];
+  if (!lower) return null;
+  const validTypes = options?.validTypes === void 0 ? DEFAULT_ENTRY_TYPES : options.validTypes;
+  const aliases = options?.typeAliases === void 0 ? DEFAULT_TYPE_ALIASES : options.typeAliases;
+  if (validTypes === null) {
+    if (aliases) {
+      const normalized = lower.replace(/-/g, "_");
+      if (aliases[normalized]) return aliases[normalized];
+    }
+    return lower;
+  }
+  if (validTypes.has(lower)) return lower;
+  if (aliases) {
+    const normalized = lower.replace(/-/g, "_");
+    if (aliases[normalized]) return aliases[normalized];
+    for (const alias of Object.keys(aliases)) {
+      if (normalized.startsWith(alias)) return aliases[alias];
+    }
   }
   return null;
 }
@@ -1846,16 +1858,24 @@ function applyWriteEntry(db, entry) {
 }
 
 // src/session/constants.ts
-var READ_ONLY_HEADER = `<!-- READ ONLY \u2014 generated by lattice-sync. Do not edit directly.
+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 agents/shared/SESSION-FORMAT.md for the full spec. -->
+     See ${docsRef} for the SESSION.md format spec. -->
 
 `;
+}
+var READ_ONLY_HEADER = createReadOnlyHeader();
 export {
+  DEFAULT_ENTRY_TYPES,
+  DEFAULT_TYPE_ALIASES,
   Lattice,
   READ_ONLY_HEADER,
   applyWriteEntry,
+  createReadOnlyHeader,
   generateEntryId,
   generateWriteEntryId,
   manifestPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "latticesql",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Persistent structured memory for AI agent systems — SQLite ↔ LLM context bridge",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,11 +34,12 @@
     "lint:fix": "eslint src tests --fix",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
+    "check:generic": "bash scripts/check-generic.sh",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "docs": "typedoc --out docs-generated src/index.ts",
-    "prepublishOnly": "npm run build && npm run typecheck && npm test"
+    "prepublishOnly": "npm run check:generic && npm run build && npm run typecheck && npm test"
   },
   "dependencies": {
     "better-sqlite3": "^12.8.0",