@happyvertical/smrt-core 0.30.0

package/dist/system/schema.js

@@ -0,0 +1,271 @@
+const CREATE_SMRT_CONTEXTS_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_contexts (
+  id TEXT PRIMARY KEY,
+  owner_class TEXT NOT NULL,
+  owner_id TEXT NOT NULL,
+  scope TEXT NOT NULL,
+  key TEXT NOT NULL,
+  value TEXT,
+  metadata TEXT,
+  version INTEGER DEFAULT 1,
+  confidence REAL DEFAULT 1.0,
+  success_count INTEGER DEFAULT 0,
+  failure_count INTEGER DEFAULT 0,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  last_used_at TIMESTAMP,
+  expires_at TIMESTAMP,
+  UNIQUE(owner_class, owner_id, scope, key, version)
+);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_contexts_owner
+  ON _smrt_contexts(owner_class, owner_id);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_contexts_scope
+  ON _smrt_contexts(scope);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_contexts_confidence
+  ON _smrt_contexts(confidence);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_contexts_last_used
+  ON _smrt_contexts(last_used_at);
+`;
+const CREATE_SMRT_MIGRATIONS_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_migrations (
+  id TEXT PRIMARY KEY,
+  version TEXT NOT NULL UNIQUE,
+  applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  description TEXT,
+  checksum TEXT
+);
+`;
+const CREATE_SMRT_SCHEMA_MIGRATIONS_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_schema_migrations (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL UNIQUE,
+  version TEXT NOT NULL,
+  checksum TEXT NOT NULL,
+  applied_checksum TEXT,
+  applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  execution_time_ms INTEGER,
+  package_name TEXT,
+  source_file TEXT,
+  status TEXT NOT NULL DEFAULT 'pending',
+  error_message TEXT,
+  attempts INTEGER DEFAULT 0,
+  is_reversible INTEGER DEFAULT 1,
+  rolled_back_at TIMESTAMP,
+  applied_by TEXT,
+  batch INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_schema_migrations_status
+  ON _smrt_schema_migrations(status);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_schema_migrations_applied_at
+  ON _smrt_schema_migrations(applied_at);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_schema_migrations_batch
+  ON _smrt_schema_migrations(batch);
+`;
+const CREATE_SMRT_REGISTRY_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_registry (
+  class_name TEXT PRIMARY KEY,
+  schema_version TEXT,
+  fields TEXT,
+  relationships TEXT,
+  config TEXT,
+  manifest TEXT,
+  last_updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+`;
+const CREATE_SMRT_SIGNALS_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_signals (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  source_class TEXT,
+  source_id TEXT,
+  target_class TEXT,
+  target_id TEXT,
+  payload TEXT,
+  timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_signals_source
+  ON _smrt_signals(source_class, source_id);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_signals_type
+  ON _smrt_signals(type);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_signals_timestamp
+  ON _smrt_signals(timestamp);
+`;
+const CREATE_SMRT_EMBEDDINGS_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_embeddings (
+  id TEXT PRIMARY KEY,
+  object_class TEXT NOT NULL,
+  object_id TEXT NOT NULL,
+  field_name TEXT NOT NULL,
+  content_hash TEXT NOT NULL,
+  embedding TEXT NOT NULL,
+  model TEXT NOT NULL,
+  dimensions INTEGER NOT NULL,
+  provider TEXT,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE(object_class, object_id, field_name, model)
+);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_embeddings_object
+  ON _smrt_embeddings(object_class, object_id);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_embeddings_class
+  ON _smrt_embeddings(object_class);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_embeddings_hash
+  ON _smrt_embeddings(content_hash);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_embeddings_model
+  ON _smrt_embeddings(model);
+`;
+const CREATE_SMRT_DISPATCH_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_dispatch (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  source TEXT NOT NULL,
+  source_id TEXT,
+  payload TEXT,
+  status TEXT NOT NULL DEFAULT 'pending',
+  attempts INTEGER DEFAULT 0,
+  last_error TEXT,
+  processed_at TIMESTAMP,
+  processed_by TEXT,
+  target_subscriber TEXT,
+  correlation_id TEXT,
+  tenant_id TEXT,
+  metadata TEXT,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_status
+  ON _smrt_dispatch(status);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_tenant_id
+  ON _smrt_dispatch(tenant_id);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_type
+  ON _smrt_dispatch(type);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_source
+  ON _smrt_dispatch(source);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_created
+  ON _smrt_dispatch(created_at);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_target
+  ON _smrt_dispatch(target_subscriber);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_correlation
+  ON _smrt_dispatch(correlation_id);
+`;
+const CREATE_SMRT_DISPATCH_SUBSCRIPTIONS_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_dispatch_subscriptions (
+  id TEXT PRIMARY KEY,
+  signal_type TEXT NOT NULL,
+  subscriber TEXT NOT NULL,
+  handler TEXT NOT NULL DEFAULT 'handleDispatch',
+  delivery TEXT NOT NULL DEFAULT 'compete',
+  enabled INTEGER DEFAULT 1,
+  tenant_id TEXT,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Subscription identity is tenant-scoped (S5 #1398): the same
+-- (signal_type, subscriber) pair may exist independently in different tenants,
+-- so tenant B can no longer overwrite/delete/enable tenant A's subscription.
+-- A named UNIQUE index (rather than an inline UNIQUE constraint) is used so the
+-- compatibility migration can additively reshape existing tables. NULL tenant_id
+-- (global subscriptions) is deduped at the application layer by the NULL-aware
+-- upsert in @happyvertical/sql.
+CREATE UNIQUE INDEX IF NOT EXISTS uq_smrt_dispatch_subs_tenant_signal_subscriber
+  ON _smrt_dispatch_subscriptions(tenant_id, signal_type, subscriber);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_subscriber
+  ON _smrt_dispatch_subscriptions(subscriber);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_tenant_id
+  ON _smrt_dispatch_subscriptions(tenant_id);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_signal_type
+  ON _smrt_dispatch_subscriptions(signal_type);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_enabled
+  ON _smrt_dispatch_subscriptions(enabled);
+`;
+const CREATE_SMRT_AI_USAGE_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_ai_usage (
+  id TEXT PRIMARY KEY,
+  provider TEXT NOT NULL,
+  model TEXT NOT NULL,
+  operation TEXT NOT NULL,
+  prompt_tokens INTEGER,
+  completion_tokens INTEGER,
+  total_tokens INTEGER,
+  estimated_cost REAL,
+  duration INTEGER NOT NULL,
+  class_name TEXT,
+  tenant_id TEXT,
+  tags TEXT,
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_ai_usage_created
+  ON _smrt_ai_usage(created_at);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_ai_usage_class
+  ON _smrt_ai_usage(class_name);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_ai_usage_tenant
+  ON _smrt_ai_usage(tenant_id);
+
+CREATE INDEX IF NOT EXISTS idx_smrt_ai_usage_provider_model
+  ON _smrt_ai_usage(provider, model);
+`;
+const CREATE_SMRT_BACKFILLS_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_backfills (
+  name TEXT PRIMARY KEY,
+  applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  description TEXT,
+  package_name TEXT
+);
+`;
+const ALL_SYSTEM_TABLES = [
+  CREATE_SMRT_CONTEXTS_TABLE,
+  CREATE_SMRT_MIGRATIONS_TABLE,
+  CREATE_SMRT_SCHEMA_MIGRATIONS_TABLE,
+  CREATE_SMRT_BACKFILLS_TABLE,
+  CREATE_SMRT_REGISTRY_TABLE,
+  CREATE_SMRT_SIGNALS_TABLE,
+  CREATE_SMRT_EMBEDDINGS_TABLE,
+  CREATE_SMRT_DISPATCH_TABLE,
+  CREATE_SMRT_DISPATCH_SUBSCRIPTIONS_TABLE,
+  CREATE_SMRT_AI_USAGE_TABLE
+];
+const SMRT_SCHEMA_VERSION = "1.6.1";
+export {
+  ALL_SYSTEM_TABLES,
+  CREATE_SMRT_AI_USAGE_TABLE,
+  CREATE_SMRT_BACKFILLS_TABLE,
+  CREATE_SMRT_CONTEXTS_TABLE,
+  CREATE_SMRT_DISPATCH_SUBSCRIPTIONS_TABLE,
+  CREATE_SMRT_DISPATCH_TABLE,
+  CREATE_SMRT_EMBEDDINGS_TABLE,
+  CREATE_SMRT_MIGRATIONS_TABLE,
+  CREATE_SMRT_REGISTRY_TABLE,
+  CREATE_SMRT_SCHEMA_MIGRATIONS_TABLE,
+  CREATE_SMRT_SIGNALS_TABLE,
+  SMRT_SCHEMA_VERSION
+};
+//# sourceMappingURL=schema.js.map

package/dist/system/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sources":["../../src/system/schema.ts"],"sourcesContent":["/**\n * SMRT System Tables Schema\n *\n * System tables use _smrt_ prefix to avoid conflicts with user tables.\n * All system tables are created in the same database as user data.\n */\n\n/**\n * Context memory storage\n * Stores remembered context (learned strategies, patterns, selectors) for reuse\n */\nexport const CREATE_SMRT_CONTEXTS_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_contexts (\n  id TEXT PRIMARY KEY,\n  owner_class TEXT NOT NULL,\n  owner_id TEXT NOT NULL,\n  scope TEXT NOT NULL,\n  key TEXT NOT NULL,\n  value TEXT,\n  metadata TEXT,\n  version INTEGER DEFAULT 1,\n  confidence REAL DEFAULT 1.0,\n  success_count INTEGER DEFAULT 0,\n  failure_count INTEGER DEFAULT 0,\n  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  last_used_at TIMESTAMP,\n  expires_at TIMESTAMP,\n  UNIQUE(owner_class, owner_id, scope, key, version)\n);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_contexts_owner\n  ON _smrt_contexts(owner_class, owner_id);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_contexts_scope\n  ON _smrt_contexts(scope);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_contexts_confidence\n  ON _smrt_contexts(confidence);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_contexts_last_used\n  ON _smrt_contexts(last_used_at);\n`;\n\n/**\n * Schema version tracking\n * Records which SMRT framework versions have been applied\n */\nexport const CREATE_SMRT_MIGRATIONS_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_migrations (\n  id TEXT PRIMARY KEY,\n  version TEXT NOT NULL UNIQUE,\n  applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  description TEXT,\n  checksum TEXT\n);\n`;\n\n/**\n * Schema migration tracking\n * Tracks applied schema migrations for idempotency, audit, and rollback\n */\nexport const CREATE_SMRT_SCHEMA_MIGRATIONS_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_schema_migrations (\n  id TEXT PRIMARY KEY,\n  name TEXT NOT NULL UNIQUE,\n  version TEXT NOT NULL,\n  checksum TEXT NOT NULL,\n  applied_checksum TEXT,\n  applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  execution_time_ms INTEGER,\n  package_name TEXT,\n  source_file TEXT,\n  status TEXT NOT NULL DEFAULT 'pending',\n  error_message TEXT,\n  attempts INTEGER DEFAULT 0,\n  is_reversible INTEGER DEFAULT 1,\n  rolled_back_at TIMESTAMP,\n  applied_by TEXT,\n  batch INTEGER\n);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_schema_migrations_status\n  ON _smrt_schema_migrations(status);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_schema_migrations_applied_at\n  ON _smrt_schema_migrations(applied_at);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_schema_migrations_batch\n  ON _smrt_schema_migrations(batch);\n`;\n\n/**\n * Runtime object registry persistence\n * Stores metadata about registered SMRT objects for introspection\n */\nexport const CREATE_SMRT_REGISTRY_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_registry (\n  class_name TEXT PRIMARY KEY,\n  schema_version TEXT,\n  fields TEXT,\n  relationships TEXT,\n  config TEXT,\n  manifest TEXT,\n  last_updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n);\n`;\n\n/**\n * Signal history/audit log\n * Optional persistence of signals for debugging and auditing\n */\nexport const CREATE_SMRT_SIGNALS_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_signals (\n  id TEXT PRIMARY KEY,\n  type TEXT NOT NULL,\n  source_class TEXT,\n  source_id TEXT,\n  target_class TEXT,\n  target_id TEXT,\n  payload TEXT,\n  timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_signals_source\n  ON _smrt_signals(source_class, source_id);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_signals_type\n  ON _smrt_signals(type);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_signals_timestamp\n  ON _smrt_signals(timestamp);\n`;\n\n/**\n * Embedding storage for semantic search\n * Stores embedding vectors for SMRT objects to enable vector similarity search\n */\nexport const CREATE_SMRT_EMBEDDINGS_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_embeddings (\n  id TEXT PRIMARY KEY,\n  object_class TEXT NOT NULL,\n  object_id TEXT NOT NULL,\n  field_name TEXT NOT NULL,\n  content_hash TEXT NOT NULL,\n  embedding TEXT NOT NULL,\n  model TEXT NOT NULL,\n  dimensions INTEGER NOT NULL,\n  provider TEXT,\n  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  UNIQUE(object_class, object_id, field_name, model)\n);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_embeddings_object\n  ON _smrt_embeddings(object_class, object_id);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_embeddings_class\n  ON _smrt_embeddings(object_class);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_embeddings_hash\n  ON _smrt_embeddings(content_hash);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_embeddings_model\n  ON _smrt_embeddings(model);\n`;\n\n/**\n * Dispatch queue for inter-agent communication\n * Stores dispatch messages for asynchronous agent-to-agent signaling\n */\nexport const CREATE_SMRT_DISPATCH_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_dispatch (\n  id TEXT PRIMARY KEY,\n  type TEXT NOT NULL,\n  source TEXT NOT NULL,\n  source_id TEXT,\n  payload TEXT,\n  status TEXT NOT NULL DEFAULT 'pending',\n  attempts INTEGER DEFAULT 0,\n  last_error TEXT,\n  processed_at TIMESTAMP,\n  processed_by TEXT,\n  target_subscriber TEXT,\n  correlation_id TEXT,\n  tenant_id TEXT,\n  metadata TEXT,\n  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_status\n  ON _smrt_dispatch(status);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_tenant_id\n  ON _smrt_dispatch(tenant_id);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_type\n  ON _smrt_dispatch(type);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_source\n  ON _smrt_dispatch(source);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_created\n  ON _smrt_dispatch(created_at);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_target\n  ON _smrt_dispatch(target_subscriber);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_correlation\n  ON _smrt_dispatch(correlation_id);\n`;\n\n/**\n * Dispatch subscriptions for persistent handlers\n * Stores subscriptions to dispatch types for agent processing\n */\nexport const CREATE_SMRT_DISPATCH_SUBSCRIPTIONS_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_dispatch_subscriptions (\n  id TEXT PRIMARY KEY,\n  signal_type TEXT NOT NULL,\n  subscriber TEXT NOT NULL,\n  handler TEXT NOT NULL DEFAULT 'handleDispatch',\n  delivery TEXT NOT NULL DEFAULT 'compete',\n  enabled INTEGER DEFAULT 1,\n  tenant_id TEXT,\n  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n);\n\n-- Subscription identity is tenant-scoped (S5 #1398): the same\n-- (signal_type, subscriber) pair may exist independently in different tenants,\n-- so tenant B can no longer overwrite/delete/enable tenant A's subscription.\n-- A named UNIQUE index (rather than an inline UNIQUE constraint) is used so the\n-- compatibility migration can additively reshape existing tables. NULL tenant_id\n-- (global subscriptions) is deduped at the application layer by the NULL-aware\n-- upsert in @happyvertical/sql.\nCREATE UNIQUE INDEX IF NOT EXISTS uq_smrt_dispatch_subs_tenant_signal_subscriber\n  ON _smrt_dispatch_subscriptions(tenant_id, signal_type, subscriber);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_subscriber\n  ON _smrt_dispatch_subscriptions(subscriber);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_tenant_id\n  ON _smrt_dispatch_subscriptions(tenant_id);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_signal_type\n  ON _smrt_dispatch_subscriptions(signal_type);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_dispatch_subs_enabled\n  ON _smrt_dispatch_subscriptions(enabled);\n`;\n\n/**\n * AI usage telemetry storage\n * Stores normalized AI usage records for reporting and billing hooks\n */\nexport const CREATE_SMRT_AI_USAGE_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_ai_usage (\n  id TEXT PRIMARY KEY,\n  provider TEXT NOT NULL,\n  model TEXT NOT NULL,\n  operation TEXT NOT NULL,\n  prompt_tokens INTEGER,\n  completion_tokens INTEGER,\n  total_tokens INTEGER,\n  estimated_cost REAL,\n  duration INTEGER NOT NULL,\n  class_name TEXT,\n  tenant_id TEXT,\n  tags TEXT,\n  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP\n);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_ai_usage_created\n  ON _smrt_ai_usage(created_at);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_ai_usage_class\n  ON _smrt_ai_usage(class_name);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_ai_usage_tenant\n  ON _smrt_ai_usage(tenant_id);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_ai_usage_provider_model\n  ON _smrt_ai_usage(provider, model);\n`;\n\n/**\n * Data backfill tracking\n *\n * Distinct from `_smrt_schema_migrations` — backfills are app-specific\n * data corrections (slug rewrites, model splits, lookup-table seeds) that\n * don't have schema diffs or rollback semantics. Apps register backfills\n * by name and the tracker handles idempotency.\n */\nexport const CREATE_SMRT_BACKFILLS_TABLE = `\nCREATE TABLE IF NOT EXISTS _smrt_backfills (\n  name TEXT PRIMARY KEY,\n  applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,\n  description TEXT,\n  package_name TEXT\n);\n`;\n\n/**\n * All system table creation statements\n */\nexport const ALL_SYSTEM_TABLES = [\n  CREATE_SMRT_CONTEXTS_TABLE,\n  CREATE_SMRT_MIGRATIONS_TABLE,\n  CREATE_SMRT_SCHEMA_MIGRATIONS_TABLE,\n  CREATE_SMRT_BACKFILLS_TABLE,\n  CREATE_SMRT_REGISTRY_TABLE,\n  CREATE_SMRT_SIGNALS_TABLE,\n  CREATE_SMRT_EMBEDDINGS_TABLE,\n  CREATE_SMRT_DISPATCH_TABLE,\n  CREATE_SMRT_DISPATCH_SUBSCRIPTIONS_TABLE,\n  CREATE_SMRT_AI_USAGE_TABLE,\n];\n\n/**\n * Current SMRT system schema version\n */\nexport const SMRT_SCHEMA_VERSION = '1.6.1';\n"],"names":[],"mappings":"AAWO,MAAM,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqCnC,MAAM,+BAA+B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAcrC,MAAM,sCAAsC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkC5C,MAAM,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBnC,MAAM,4BAA4B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0BlC,MAAM,+BAA+B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiCrC,MAAM,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8CnC,MAAM,2CAA2C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwCjD,MAAM,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsCnC,MAAM,8BAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYpC,MAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAKO,MAAM,sBAAsB;"}

package/dist/system/types.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Type definitions for SMRT system tables
+ */
+/**
+ * Options for storing a note
+ */
+export interface NoteOptions {
+    /** Hierarchical scope (e.g., 'discovery/parser/domain.com') */
+    scope: string;
+    /** Normalized identifier (e.g., URL, entity ID) */
+    key: string;
+    /** Strategy data (regex patterns, selectors, etc.) */
+    value: any;
+    /** Additional metadata */
+    metadata?: NoteMetadata;
+    /** Confidence score (0.0 to 1.0) */
+    confidence?: number;
+    /** Strategy version number */
+    version?: number;
+    /** Expiration date */
+    expiresAt?: Date;
+}
+/**
+ * Note metadata structure
+ * Optimized for storing AI-learned strategies
+ */
+export interface NoteMetadata {
+    /** AI provider used for learning */
+    aiProvider?: string;
+    /** AI model used */
+    aiModel?: string;
+    /** Original AI confidence */
+    aiConfidence?: number;
+    /** Regex patterns */
+    patterns?: string[];
+    /** CSS selectors */
+    selectors?: string[];
+    /** Expected result count */
+    expectedCount?: number;
+    /** Hash of page HTML for change detection */
+    pageHash?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Importance score */
+    importance?: number;
+    /** Source of the strategy */
+    source?: string;
+    /** Version this replaces */
+    replacesVersion?: number;
+    /** Whether human reviewed */
+    humanReviewed?: boolean;
+    /** Reviewer identifier */
+    reviewedBy?: string;
+    /** Review notes */
+    reviewNotes?: string;
+    /** Allow any other properties */
+    [key: string]: any;
+}
+/**
+ * Options for recalling notes
+ */
+export interface RecallOptions {
+    /** Scope to search in */
+    scope: string;
+    /** Key to search for */
+    key: string;
+    /** Search parent scopes if not found */
+    includeAncestors?: boolean;
+    /** Search child scopes */
+    includeDescendants?: boolean;
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+    /** Only return highest version */
+    latestVersionOnly?: boolean;
+}
+/**
+ * Options for recalling multiple notes
+ */
+export interface RecallAllOptions {
+    /** Scope to search in (optional) */
+    scope?: string;
+    /** Search child scopes */
+    includeDescendants?: boolean;
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+    /** Only return highest versions */
+    latestVersionOnly?: boolean;
+}
+/**
+ * Options for forgetting notes
+ */
+export interface ForgetOptions {
+    /** Scope to delete from */
+    scope: string;
+    /** Key to delete */
+    key: string;
+}
+/**
+ * Options for forgetting a scope
+ */
+export interface ForgetScopeOptions {
+    /** Scope to delete */
+    scope: string;
+    /** Delete child scopes too */
+    includeDescendants?: boolean;
+}
+/**
+ * Discovery strategy structure (common use case)
+ */
+export interface DiscoveryStrategy {
+    /** Regex patterns */
+    patterns: string[];
+    /** CSS selectors */
+    selectors?: string[];
+    /** Expected result count */
+    expectedCount: number;
+    /** Strategy version */
+    version: number;
+    /** Confidence score */
+    confidence: number;
+}
+/**
+ * System table configuration
+ */
+export interface SystemTableConfig {
+    /** Enable signal history persistence */
+    persistSignalHistory?: boolean;
+    /** Note retention in days */
+    noteRetentionDays?: number;
+    /** Cleanup interval */
+    cleanupInterval?: 'hourly' | 'daily' | 'weekly' | 'never';
+    /** Archive confidence threshold */
+    archiveThreshold?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/system/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/system/types.ts"],"names":[],"mappings":"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"}

package/dist/system-fields.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Canonical SMRT system fields inherited from `SmrtObject`.
+ *
+ * These fields exist on every persistent object at runtime even when they are
+ * not declared in a child class manifest. Keep this definition lightweight:
+ * presence matters for metadata consumers, while schema generation still owns
+ * the exact SQL defaults and constraints for these columns.
+ */
+export declare const SMRT_SYSTEM_FIELDS: Readonly<{
+    id: Readonly<{
+        type: "text";
+        _meta: Readonly<{
+            __smrtSystemField: true;
+        }>;
+    }>;
+    slug: Readonly<{
+        type: "text";
+        _meta: Readonly<{
+            __smrtSystemField: true;
+        }>;
+    }>;
+    context: Readonly<{
+        type: "text";
+        _meta: Readonly<{
+            __smrtSystemField: true;
+        }>;
+    }>;
+    created_at: Readonly<{
+        type: "datetime";
+        _meta: Readonly<{
+            __smrtSystemField: true;
+        }>;
+    }>;
+    updated_at: Readonly<{
+        type: "datetime";
+        _meta: Readonly<{
+            __smrtSystemField: true;
+        }>;
+    }>;
+}>;
+export declare function isInjectedSmrtSystemField(field: any): boolean;
+export declare function cloneSmrtSystemFields(): Record<string, any>;
+export declare function prependSmrtSystemFields(fields: Map<string, any>): Map<string, any>;
+//# sourceMappingURL=system-fields.d.ts.map

package/dist/system-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-fields.d.ts","sourceRoot":"","sources":["../src/system-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB7B,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAE7D;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAW3D;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GACvB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAelB"}

package/dist/system-fields.js

@@ -0,0 +1,55 @@
+const SMRT_SYSTEM_FIELDS = Object.freeze({
+  id: Object.freeze({
+    type: "text",
+    _meta: Object.freeze({ __smrtSystemField: true })
+  }),
+  slug: Object.freeze({
+    type: "text",
+    _meta: Object.freeze({ __smrtSystemField: true })
+  }),
+  context: Object.freeze({
+    type: "text",
+    _meta: Object.freeze({ __smrtSystemField: true })
+  }),
+  created_at: Object.freeze({
+    type: "datetime",
+    _meta: Object.freeze({ __smrtSystemField: true })
+  }),
+  updated_at: Object.freeze({
+    type: "datetime",
+    _meta: Object.freeze({ __smrtSystemField: true })
+  })
+});
+function isInjectedSmrtSystemField(field) {
+  return Boolean(field?._meta?.__smrtSystemField);
+}
+function cloneSmrtSystemFields() {
+  const fields = {};
+  for (const [fieldName, fieldDef] of Object.entries(SMRT_SYSTEM_FIELDS)) {
+    fields[fieldName] = {
+      ...fieldDef,
+      _meta: { ...fieldDef._meta || {} }
+    };
+  }
+  return fields;
+}
+function prependSmrtSystemFields(fields) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const [fieldName, fieldDef] of Object.entries(cloneSmrtSystemFields())) {
+    merged.set(fieldName, fieldDef);
+  }
+  for (const [fieldName, fieldDef] of fields.entries()) {
+    if (isInjectedSmrtSystemField(fieldDef) && merged.has(fieldName)) {
+      continue;
+    }
+    merged.set(fieldName, fieldDef);
+  }
+  return merged;
+}
+export {
+  SMRT_SYSTEM_FIELDS,
+  cloneSmrtSystemFields,
+  isInjectedSmrtSystemField,
+  prependSmrtSystemFields
+};
+//# sourceMappingURL=system-fields.js.map

package/dist/system-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-fields.js","sources":["../src/system-fields.ts"],"sourcesContent":["/**\n * Canonical SMRT system fields inherited from `SmrtObject`.\n *\n * These fields exist on every persistent object at runtime even when they are\n * not declared in a child class manifest. Keep this definition lightweight:\n * presence matters for metadata consumers, while schema generation still owns\n * the exact SQL defaults and constraints for these columns.\n */\n\nexport const SMRT_SYSTEM_FIELDS = Object.freeze({\n  id: Object.freeze({\n    type: 'text',\n    _meta: Object.freeze({ __smrtSystemField: true }),\n  }),\n  slug: Object.freeze({\n    type: 'text',\n    _meta: Object.freeze({ __smrtSystemField: true }),\n  }),\n  context: Object.freeze({\n    type: 'text',\n    _meta: Object.freeze({ __smrtSystemField: true }),\n  }),\n  created_at: Object.freeze({\n    type: 'datetime',\n    _meta: Object.freeze({ __smrtSystemField: true }),\n  }),\n  updated_at: Object.freeze({\n    type: 'datetime',\n    _meta: Object.freeze({ __smrtSystemField: true }),\n  }),\n});\n\nexport function isInjectedSmrtSystemField(field: any): boolean {\n  return Boolean(field?._meta?.__smrtSystemField);\n}\n\nexport function cloneSmrtSystemFields(): Record<string, any> {\n  const fields: Record<string, any> = {};\n\n  for (const [fieldName, fieldDef] of Object.entries(SMRT_SYSTEM_FIELDS)) {\n    fields[fieldName] = {\n      ...fieldDef,\n      _meta: { ...(fieldDef._meta || {}) },\n    };\n  }\n\n  return fields;\n}\n\nexport function prependSmrtSystemFields(\n  fields: Map<string, any>,\n): Map<string, any> {\n  const merged = new Map<string, any>();\n\n  for (const [fieldName, fieldDef] of Object.entries(cloneSmrtSystemFields())) {\n    merged.set(fieldName, fieldDef);\n  }\n\n  for (const [fieldName, fieldDef] of fields.entries()) {\n    if (isInjectedSmrtSystemField(fieldDef) && merged.has(fieldName)) {\n      continue;\n    }\n    merged.set(fieldName, fieldDef);\n  }\n\n  return merged;\n}\n"],"names":[],"mappings":"AASO,MAAM,qBAAqB,OAAO,OAAO;AAAA,EAC9C,IAAI,OAAO,OAAO;AAAA,IAChB,MAAM;AAAA,IACN,OAAO,OAAO,OAAO,EAAE,mBAAmB,MAAM;AAAA,EAAA,CACjD;AAAA,EACD,MAAM,OAAO,OAAO;AAAA,IAClB,MAAM;AAAA,IACN,OAAO,OAAO,OAAO,EAAE,mBAAmB,MAAM;AAAA,EAAA,CACjD;AAAA,EACD,SAAS,OAAO,OAAO;AAAA,IACrB,MAAM;AAAA,IACN,OAAO,OAAO,OAAO,EAAE,mBAAmB,MAAM;AAAA,EAAA,CACjD;AAAA,EACD,YAAY,OAAO,OAAO;AAAA,IACxB,MAAM;AAAA,IACN,OAAO,OAAO,OAAO,EAAE,mBAAmB,MAAM;AAAA,EAAA,CACjD;AAAA,EACD,YAAY,OAAO,OAAO;AAAA,IACxB,MAAM;AAAA,IACN,OAAO,OAAO,OAAO,EAAE,mBAAmB,MAAM;AAAA,EAAA,CACjD;AACH,CAAC;AAEM,SAAS,0BAA0B,OAAqB;AAC7D,SAAO,QAAQ,OAAO,OAAO,iBAAiB;AAChD;AAEO,SAAS,wBAA6C;AAC3D,QAAM,SAA8B,CAAA;AAEpC,aAAW,CAAC,WAAW,QAAQ,KAAK,OAAO,QAAQ,kBAAkB,GAAG;AACtE,WAAO,SAAS,IAAI;AAAA,MAClB,GAAG;AAAA,MACH,OAAO,EAAE,GAAI,SAAS,SAAS,CAAA,EAAC;AAAA,IAAG;AAAA,EAEvC;AAEA,SAAO;AACT;AAEO,SAAS,wBACd,QACkB;AAClB,QAAM,6BAAa,IAAA;AAEnB,aAAW,CAAC,WAAW,QAAQ,KAAK,OAAO,QAAQ,sBAAA,CAAuB,GAAG;AAC3E,WAAO,IAAI,WAAW,QAAQ;AAAA,EAChC;AAEA,aAAW,CAAC,WAAW,QAAQ,KAAK,OAAO,WAAW;AACpD,QAAI,0BAA0B,QAAQ,KAAK,OAAO,IAAI,SAAS,GAAG;AAChE;AAAA,IACF;AACA,WAAO,IAAI,WAAW,QAAQ;AAAA,EAChC;AAEA,SAAO;AACT;"}

package/dist/table-cache.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cache for verified table existence checks.
+ *
+ * Prevents redundant `tableExists()` round-trips in `Collection.create()` and
+ * `SmrtObject.save()`. On high-latency connections (e.g. Postgres over Tailscale),
+ * each check adds ~100ms — this eliminates all but the first check per table per DB.
+ *
+ * Scoped per database URL to prevent cross-database contamination in multi-DB
+ * scenarios. For :memory: and JSON databases (which share URLs), the cache can
+ * be cleared via `resetVerifiedTables()` in test setup.
+ *
+ * @see https://github.com/happyvertical/smrt/issues/970
+ * @packageDocumentation
+ */
+/**
+ * Check if a table has been verified for a given database.
+ */
+export declare function isTableVerified(dbUrl: string, tableName: string): boolean;
+/**
+ * Mark a table as verified for a given database.
+ */
+export declare function markTableVerified(dbUrl: string, tableName: string): void;
+/**
+ * Clear all verified table caches.
+ * Call this in test setup to ensure isolation between test files.
+ */
+export declare function resetVerifiedTables(): void;
+//# sourceMappingURL=table-cache.d.ts.map

package/dist/table-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-cache.d.ts","sourceRoot":"","sources":["../src/table-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/table-cache.js

@@ -0,0 +1,21 @@
+const verifiedTablesByUrl = /* @__PURE__ */ new Map();
+function isTableVerified(dbUrl, tableName) {
+  return verifiedTablesByUrl.get(dbUrl)?.has(tableName) ?? false;
+}
+function markTableVerified(dbUrl, tableName) {
+  let tables = verifiedTablesByUrl.get(dbUrl);
+  if (!tables) {
+    tables = /* @__PURE__ */ new Set();
+    verifiedTablesByUrl.set(dbUrl, tables);
+  }
+  tables.add(tableName);
+}
+function resetVerifiedTables() {
+  verifiedTablesByUrl.clear();
+}
+export {
+  isTableVerified,
+  markTableVerified,
+  resetVerifiedTables
+};
+//# sourceMappingURL=table-cache.js.map

package/dist/table-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-cache.js","sources":["../src/table-cache.ts"],"sourcesContent":["/**\n * Cache for verified table existence checks.\n *\n * Prevents redundant `tableExists()` round-trips in `Collection.create()` and\n * `SmrtObject.save()`. On high-latency connections (e.g. Postgres over Tailscale),\n * each check adds ~100ms — this eliminates all but the first check per table per DB.\n *\n * Scoped per database URL to prevent cross-database contamination in multi-DB\n * scenarios. For :memory: and JSON databases (which share URLs), the cache can\n * be cleared via `resetVerifiedTables()` in test setup.\n *\n * @see https://github.com/happyvertical/smrt/issues/970\n * @packageDocumentation\n */\n\n/**\n * Map of dbUrl → Set<tableName>.\n * Keyed by table name (not class name) so STI classes sharing a table only check once.\n */\nconst verifiedTablesByUrl = new Map<string, Set<string>>();\n\n/**\n * Check if a table has been verified for a given database.\n */\nexport function isTableVerified(dbUrl: string, tableName: string): boolean {\n  return verifiedTablesByUrl.get(dbUrl)?.has(tableName) ?? false;\n}\n\n/**\n * Mark a table as verified for a given database.\n */\nexport function markTableVerified(dbUrl: string, tableName: string): void {\n  let tables = verifiedTablesByUrl.get(dbUrl);\n  if (!tables) {\n    tables = new Set();\n    verifiedTablesByUrl.set(dbUrl, tables);\n  }\n  tables.add(tableName);\n}\n\n/**\n * Clear all verified table caches.\n * Call this in test setup to ensure isolation between test files.\n */\nexport function resetVerifiedTables(): void {\n  verifiedTablesByUrl.clear();\n}\n"],"names":[],"mappings":"AAmBA,MAAM,0CAA0B,IAAA;AAKzB,SAAS,gBAAgB,OAAe,WAA4B;AACzE,SAAO,oBAAoB,IAAI,KAAK,GAAG,IAAI,SAAS,KAAK;AAC3D;AAKO,SAAS,kBAAkB,OAAe,WAAyB;AACxE,MAAI,SAAS,oBAAoB,IAAI,KAAK;AAC1C,MAAI,CAAC,QAAQ;AACX,iCAAa,IAAA;AACb,wBAAoB,IAAI,OAAO,MAAM;AAAA,EACvC;AACA,SAAO,IAAI,SAAS;AACtB;AAMO,SAAS,sBAA4B;AAC1C,sBAAoB,MAAA;AACtB;"}