forge-openclaw-plugin 0.2.19 → 0.2.21

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "skills": [
     "./skills"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "MIT",

package/server/migrations/015_multi_user_and_strategies.sql

@@ -0,0 +1,244 @@
+CREATE TABLE IF NOT EXISTS users (
+  id TEXT PRIMARY KEY,
+  kind TEXT NOT NULL CHECK (kind IN ('human', 'bot')),
+  handle TEXT NOT NULL UNIQUE,
+  display_name TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  accent_color TEXT NOT NULL DEFAULT '#c0c1ff',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS user_access_grants (
+  id TEXT PRIMARY KEY,
+  subject_user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  target_user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  access_level TEXT NOT NULL DEFAULT 'view',
+  config_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (subject_user_id, target_user_id, access_level)
+);
+
+CREATE TABLE IF NOT EXISTS entity_owners (
+  entity_type TEXT NOT NULL,
+  entity_id TEXT NOT NULL,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  role TEXT NOT NULL DEFAULT 'owner',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (entity_type, entity_id)
+);
+
+CREATE TABLE IF NOT EXISTS strategies (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  overview TEXT NOT NULL DEFAULT '',
+  end_state_description TEXT NOT NULL DEFAULT '',
+  status TEXT NOT NULL DEFAULT 'active',
+  target_goal_ids_json TEXT NOT NULL DEFAULT '[]',
+  target_project_ids_json TEXT NOT NULL DEFAULT '[]',
+  linked_entities_json TEXT NOT NULL DEFAULT '[]',
+  graph_json TEXT NOT NULL DEFAULT '{"nodes":[],"edges":[]}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_users_kind ON users(kind, display_name);
+CREATE INDEX IF NOT EXISTS idx_entity_owners_user ON entity_owners(user_id, entity_type, entity_id);
+CREATE INDEX IF NOT EXISTS idx_strategies_status ON strategies(status, updated_at DESC);
+
+INSERT OR IGNORE INTO users (
+  id,
+  kind,
+  handle,
+  display_name,
+  description,
+  accent_color,
+  created_at,
+  updated_at
+)
+VALUES (
+  'user_operator',
+  'human',
+  'operator',
+  'Operator',
+  'Primary human Forge operator.',
+  '#f4b97a',
+  CURRENT_TIMESTAMP,
+  CURRENT_TIMESTAMP
+);
+
+UPDATE users
+SET handle = COALESCE(
+      (
+        SELECT CASE
+          WHEN trim(lower(replace(replace(replace(operator_name, ' ', '_'), '-', '_'), '.', ''))) = '' THEN 'operator'
+          ELSE trim(lower(replace(replace(replace(operator_name, ' ', '_'), '-', '_'), '.', '')))
+        END
+        FROM app_settings
+        WHERE id = 1
+      ),
+      handle
+    ),
+    display_name = COALESCE(
+      (
+        SELECT CASE
+          WHEN trim(operator_name) = '' THEN 'Operator'
+          ELSE trim(operator_name)
+        END
+        FROM app_settings
+        WHERE id = 1
+      ),
+      display_name
+    ),
+    updated_at = CURRENT_TIMESTAMP
+WHERE id = 'user_operator';
+
+INSERT OR IGNORE INTO users (
+  id,
+  kind,
+  handle,
+  display_name,
+  description,
+  accent_color,
+  created_at,
+  updated_at
+)
+VALUES (
+  'user_forge_bot',
+  'bot',
+  'forge_bot',
+  'Forge Bot',
+  'Autonomous or semi-autonomous execution partner inside Forge.',
+  '#7dd3fc',
+  CURRENT_TIMESTAMP,
+  CURRENT_TIMESTAMP
+);
+
+INSERT OR IGNORE INTO users (
+  id,
+  kind,
+  handle,
+  display_name,
+  description,
+  accent_color,
+  created_at,
+  updated_at
+)
+SELECT
+  'user_human_' || lower(hex(substr(owner, 1, 16))),
+  'human',
+  trim(lower(replace(replace(replace(owner, ' ', '_'), '-', '_'), '.', ''))),
+  trim(owner),
+  'Backfilled from existing task ownership labels.',
+  '#f4b97a',
+  CURRENT_TIMESTAMP,
+  CURRENT_TIMESTAMP
+FROM tasks
+WHERE trim(owner) != ''
+  AND lower(trim(owner)) NOT IN (SELECT lower(display_name) FROM users)
+GROUP BY trim(owner);
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'goal', id, 'user_operator', 'owner', created_at, updated_at FROM goals;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'project', id, 'user_operator', 'owner', created_at, updated_at FROM projects;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT
+  'task',
+  tasks.id,
+  COALESCE(
+    (
+      SELECT users.id
+      FROM users
+      WHERE lower(users.display_name) = lower(trim(tasks.owner))
+         OR lower(users.handle) = lower(trim(replace(replace(replace(tasks.owner, ' ', '_'), '-', '_'), '.', '')))
+      ORDER BY CASE WHEN users.kind = 'human' THEN 0 ELSE 1 END, users.created_at
+      LIMIT 1
+    ),
+    'user_operator'
+  ),
+  'owner',
+  tasks.created_at,
+  tasks.updated_at
+FROM tasks;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'habit', id, 'user_operator', 'owner', created_at, updated_at FROM habits;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'tag', id, 'user_operator', 'owner', created_at, created_at FROM tags;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'note', id, 'user_operator', 'owner', created_at, updated_at FROM notes;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'insight', id, 'user_operator', 'owner', created_at, updated_at FROM insights;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'calendar_event', id, 'user_operator', 'owner', created_at, updated_at FROM calendar_events;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'work_block_template', id, 'user_operator', 'owner', created_at, updated_at FROM work_block_templates;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'task_timebox', id, 'user_operator', 'owner', created_at, updated_at FROM task_timeboxes;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'psyche_value', id, 'user_operator', 'owner', created_at, updated_at FROM psyche_values;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'behavior_pattern', id, 'user_operator', 'owner', created_at, updated_at FROM behavior_patterns;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'behavior', id, 'user_operator', 'owner', created_at, updated_at FROM psyche_behaviors;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'belief_entry', id, 'user_operator', 'owner', created_at, updated_at FROM belief_entries;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'mode_profile', id, 'user_operator', 'owner', created_at, updated_at FROM mode_profiles;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'mode_guide_session', id, 'user_operator', 'owner', created_at, updated_at FROM mode_guide_sessions;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'event_type', id, 'user_operator', 'owner', created_at, updated_at FROM event_types;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'emotion_definition', id, 'user_operator', 'owner', created_at, updated_at FROM emotion_definitions;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'trigger_report', id, 'user_operator', 'owner', created_at, updated_at FROM trigger_reports;
+
+INSERT OR IGNORE INTO entity_owners (entity_type, entity_id, user_id, role, created_at, updated_at)
+SELECT 'strategy', id, 'user_operator', 'owner', created_at, updated_at FROM strategies;
+
+INSERT OR IGNORE INTO user_access_grants (
+  id,
+  subject_user_id,
+  target_user_id,
+  access_level,
+  config_json,
+  created_at,
+  updated_at
+)
+SELECT
+  'grant_' || lower(hex(randomblob(8))),
+  subject_users.id,
+  target_users.id,
+  CASE
+    WHEN subject_users.id = target_users.id THEN 'manage'
+    ELSE 'view'
+  END,
+  CASE
+    WHEN subject_users.id = target_users.id THEN '{"self":true,"mutable":true}'
+    ELSE '{"discoverable":true,"linkedEntities":true}'
+  END,
+  CURRENT_TIMESTAMP,
+  CURRENT_TIMESTAMP
+FROM users AS subject_users
+CROSS JOIN users AS target_users;

package/server/migrations/016_health_companion.sql

@@ -0,0 +1,158 @@
+CREATE TABLE IF NOT EXISTS companion_pairing_sessions (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  label TEXT NOT NULL DEFAULT '',
+  pairing_token TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending',
+  capability_flags_json TEXT NOT NULL DEFAULT '[]',
+  device_name TEXT,
+  platform TEXT,
+  app_version TEXT,
+  api_base_url TEXT NOT NULL DEFAULT '',
+  last_seen_at TEXT,
+  last_sync_at TEXT,
+  last_sync_error TEXT,
+  paired_at TEXT,
+  expires_at TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_companion_pairing_token
+  ON companion_pairing_sessions(pairing_token);
+
+CREATE INDEX IF NOT EXISTS idx_companion_pairing_user
+  ON companion_pairing_sessions(user_id, status, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS health_import_runs (
+  id TEXT PRIMARY KEY,
+  pairing_session_id TEXT REFERENCES companion_pairing_sessions(id) ON DELETE SET NULL,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  source TEXT NOT NULL,
+  source_device TEXT NOT NULL DEFAULT '',
+  status TEXT NOT NULL DEFAULT 'completed',
+  payload_summary_json TEXT NOT NULL DEFAULT '{}',
+  imported_count INTEGER NOT NULL DEFAULT 0,
+  created_count INTEGER NOT NULL DEFAULT 0,
+  updated_count INTEGER NOT NULL DEFAULT 0,
+  merged_count INTEGER NOT NULL DEFAULT 0,
+  error_message TEXT,
+  imported_at TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_health_import_runs_user
+  ON health_import_runs(user_id, imported_at DESC);
+
+CREATE TABLE IF NOT EXISTS health_sleep_sessions (
+  id TEXT PRIMARY KEY,
+  external_uid TEXT NOT NULL,
+  pairing_session_id TEXT REFERENCES companion_pairing_sessions(id) ON DELETE SET NULL,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  source TEXT NOT NULL,
+  source_type TEXT NOT NULL DEFAULT 'healthkit',
+  source_device TEXT NOT NULL DEFAULT '',
+  started_at TEXT NOT NULL,
+  ended_at TEXT NOT NULL,
+  time_in_bed_seconds INTEGER NOT NULL DEFAULT 0,
+  asleep_seconds INTEGER NOT NULL DEFAULT 0,
+  awake_seconds INTEGER NOT NULL DEFAULT 0,
+  sleep_score REAL,
+  regularity_score REAL,
+  bedtime_consistency_minutes INTEGER,
+  wake_consistency_minutes INTEGER,
+  stage_breakdown_json TEXT NOT NULL DEFAULT '[]',
+  recovery_metrics_json TEXT NOT NULL DEFAULT '{}',
+  links_json TEXT NOT NULL DEFAULT '[]',
+  annotations_json TEXT NOT NULL DEFAULT '{}',
+  provenance_json TEXT NOT NULL DEFAULT '{}',
+  derived_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (user_id, source, external_uid)
+);
+
+CREATE INDEX IF NOT EXISTS idx_health_sleep_user
+  ON health_sleep_sessions(user_id, started_at DESC);
+
+CREATE TABLE IF NOT EXISTS health_workout_sessions (
+  id TEXT PRIMARY KEY,
+  external_uid TEXT NOT NULL,
+  pairing_session_id TEXT REFERENCES companion_pairing_sessions(id) ON DELETE SET NULL,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  source TEXT NOT NULL,
+  source_type TEXT NOT NULL DEFAULT 'healthkit',
+  workout_type TEXT NOT NULL,
+  source_device TEXT NOT NULL DEFAULT '',
+  started_at TEXT NOT NULL,
+  ended_at TEXT NOT NULL,
+  duration_seconds INTEGER NOT NULL DEFAULT 0,
+  active_energy_kcal REAL,
+  total_energy_kcal REAL,
+  distance_meters REAL,
+  step_count INTEGER,
+  exercise_minutes REAL,
+  average_heart_rate REAL,
+  max_heart_rate REAL,
+  subjective_effort INTEGER,
+  mood_before TEXT NOT NULL DEFAULT '',
+  mood_after TEXT NOT NULL DEFAULT '',
+  meaning_text TEXT NOT NULL DEFAULT '',
+  planned_context TEXT NOT NULL DEFAULT '',
+  social_context TEXT NOT NULL DEFAULT '',
+  links_json TEXT NOT NULL DEFAULT '[]',
+  tags_json TEXT NOT NULL DEFAULT '[]',
+  annotations_json TEXT NOT NULL DEFAULT '{}',
+  provenance_json TEXT NOT NULL DEFAULT '{}',
+  derived_json TEXT NOT NULL DEFAULT '{}',
+  generated_from_habit_id TEXT REFERENCES habits(id) ON DELETE SET NULL,
+  generated_from_check_in_id TEXT REFERENCES habit_check_ins(id) ON DELETE SET NULL,
+  reconciliation_status TEXT NOT NULL DEFAULT 'standalone',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (user_id, source, external_uid)
+);
+
+CREATE INDEX IF NOT EXISTS idx_health_workouts_user
+  ON health_workout_sessions(user_id, started_at DESC);
+
+CREATE TABLE IF NOT EXISTS health_daily_summaries (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  date_key TEXT NOT NULL,
+  summary_type TEXT NOT NULL,
+  metrics_json TEXT NOT NULL DEFAULT '{}',
+  derived_json TEXT NOT NULL DEFAULT '{}',
+  source TEXT NOT NULL DEFAULT 'derived',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (user_id, date_key, summary_type)
+);
+
+CREATE INDEX IF NOT EXISTS idx_health_daily_summaries_user
+  ON health_daily_summaries(user_id, date_key DESC, summary_type);
+
+ALTER TABLE habits
+  ADD COLUMN generated_health_event_template_json TEXT NOT NULL DEFAULT '{}';
+
+ALTER TABLE forge_events
+  ADD COLUMN place_label TEXT NOT NULL DEFAULT '';
+
+ALTER TABLE forge_events
+  ADD COLUMN place_address TEXT NOT NULL DEFAULT '';
+
+ALTER TABLE forge_events
+  ADD COLUMN place_timezone TEXT NOT NULL DEFAULT '';
+
+ALTER TABLE forge_events
+  ADD COLUMN place_latitude REAL;
+
+ALTER TABLE forge_events
+  ADD COLUMN place_longitude REAL;
+
+ALTER TABLE forge_events
+  ADD COLUMN place_source TEXT NOT NULL DEFAULT '';
+
+ALTER TABLE forge_events
+  ADD COLUMN place_external_id TEXT NOT NULL DEFAULT '';

package/server/migrations/016_strategy_contracts_and_user_graph.sql

@@ -0,0 +1,22 @@
+ALTER TABLE strategies ADD COLUMN is_locked INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE strategies ADD COLUMN locked_at TEXT;
+ALTER TABLE strategies ADD COLUMN locked_by_user_id TEXT REFERENCES users(id) ON DELETE SET NULL;
+
+CREATE INDEX IF NOT EXISTS idx_strategies_locked_by_user ON strategies(locked_by_user_id, updated_at DESC);
+
+DELETE FROM user_access_grants
+WHERE rowid NOT IN (
+  SELECT MIN(rowid)
+  FROM user_access_grants
+  GROUP BY subject_user_id, target_user_id
+);
+
+UPDATE user_access_grants
+SET access_level = 'manage',
+    config_json = CASE
+      WHEN subject_user_id = target_user_id THEN
+        '{"self":true,"mutable":true,"linkedEntities":true,"rights":{"discoverable":true,"canListUsers":true,"canReadProfile":true,"canReadEntities":true,"canSearchEntities":true,"canLinkEntities":true,"canAffectEntities":true,"canManageStrategies":true,"canCreateOnBehalf":true,"canViewMetrics":true,"canViewActivity":true}}'
+      ELSE
+        '{"self":false,"mutable":false,"linkedEntities":true,"rights":{"discoverable":true,"canListUsers":true,"canReadProfile":true,"canReadEntities":true,"canSearchEntities":true,"canLinkEntities":true,"canAffectEntities":true,"canManageStrategies":true,"canCreateOnBehalf":true,"canViewMetrics":true,"canViewActivity":true}}'
+    END,
+    updated_at = CURRENT_TIMESTAMP;

package/server/migrations/017_preferences.sql

@@ -0,0 +1,131 @@
+CREATE TABLE IF NOT EXISTS preference_profiles (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  domain TEXT NOT NULL,
+  default_context_id TEXT,
+  model_version TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (user_id, domain)
+);
+
+CREATE TABLE IF NOT EXISTS preference_contexts (
+  id TEXT PRIMARY KEY,
+  profile_id TEXT NOT NULL REFERENCES preference_profiles(id) ON DELETE CASCADE,
+  name TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  share_mode TEXT NOT NULL DEFAULT 'blended' CHECK (share_mode IN ('shared', 'isolated', 'blended')),
+  active INTEGER NOT NULL DEFAULT 1,
+  is_default INTEGER NOT NULL DEFAULT 0,
+  decay_days INTEGER NOT NULL DEFAULT 90,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS preference_items (
+  id TEXT PRIMARY KEY,
+  profile_id TEXT NOT NULL REFERENCES preference_profiles(id) ON DELETE CASCADE,
+  label TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  tags_json TEXT NOT NULL DEFAULT '[]',
+  feature_weights_json TEXT NOT NULL DEFAULT '{}',
+  source_entity_type TEXT,
+  source_entity_id TEXT,
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS pairwise_judgments (
+  id TEXT PRIMARY KEY,
+  profile_id TEXT NOT NULL REFERENCES preference_profiles(id) ON DELETE CASCADE,
+  context_id TEXT NOT NULL REFERENCES preference_contexts(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  left_item_id TEXT NOT NULL REFERENCES preference_items(id) ON DELETE CASCADE,
+  right_item_id TEXT NOT NULL REFERENCES preference_items(id) ON DELETE CASCADE,
+  outcome TEXT NOT NULL CHECK (outcome IN ('left', 'right', 'tie', 'skip')),
+  strength REAL NOT NULL DEFAULT 1,
+  response_time_ms INTEGER,
+  source TEXT NOT NULL DEFAULT 'ui',
+  reason_tags_json TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS absolute_signals (
+  id TEXT PRIMARY KEY,
+  profile_id TEXT NOT NULL REFERENCES preference_profiles(id) ON DELETE CASCADE,
+  context_id TEXT NOT NULL REFERENCES preference_contexts(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  item_id TEXT NOT NULL REFERENCES preference_items(id) ON DELETE CASCADE,
+  signal_type TEXT NOT NULL CHECK (signal_type IN ('favorite', 'veto', 'must_have', 'bookmark', 'neutral', 'compare_later')),
+  strength REAL NOT NULL DEFAULT 1,
+  source TEXT NOT NULL DEFAULT 'ui',
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS preference_item_scores (
+  id TEXT PRIMARY KEY,
+  profile_id TEXT NOT NULL REFERENCES preference_profiles(id) ON DELETE CASCADE,
+  context_id TEXT NOT NULL REFERENCES preference_contexts(id) ON DELETE CASCADE,
+  item_id TEXT NOT NULL REFERENCES preference_items(id) ON DELETE CASCADE,
+  latent_score REAL NOT NULL DEFAULT 0,
+  confidence REAL NOT NULL DEFAULT 0,
+  uncertainty REAL NOT NULL DEFAULT 1,
+  evidence_count INTEGER NOT NULL DEFAULT 0,
+  pairwise_wins INTEGER NOT NULL DEFAULT 0,
+  pairwise_losses INTEGER NOT NULL DEFAULT 0,
+  pairwise_ties INTEGER NOT NULL DEFAULT 0,
+  signal_count INTEGER NOT NULL DEFAULT 0,
+  conflict_count INTEGER NOT NULL DEFAULT 0,
+  status TEXT NOT NULL DEFAULT 'uncertain',
+  dominant_dimensions_json TEXT NOT NULL DEFAULT '[]',
+  explanation_json TEXT NOT NULL DEFAULT '[]',
+  manual_status TEXT,
+  manual_score REAL,
+  confidence_lock REAL,
+  bookmarked INTEGER NOT NULL DEFAULT 0,
+  compare_later INTEGER NOT NULL DEFAULT 0,
+  frozen INTEGER NOT NULL DEFAULT 0,
+  last_inferred_at TEXT NOT NULL,
+  last_judgment_at TEXT,
+  updated_at TEXT NOT NULL,
+  UNIQUE (context_id, item_id)
+);
+
+CREATE TABLE IF NOT EXISTS preference_dimension_summaries (
+  id TEXT PRIMARY KEY,
+  profile_id TEXT NOT NULL REFERENCES preference_profiles(id) ON DELETE CASCADE,
+  context_id TEXT NOT NULL REFERENCES preference_contexts(id) ON DELETE CASCADE,
+  dimension_id TEXT NOT NULL,
+  leaning REAL NOT NULL DEFAULT 0,
+  confidence REAL NOT NULL DEFAULT 0,
+  movement REAL NOT NULL DEFAULT 0,
+  context_sensitivity REAL NOT NULL DEFAULT 0,
+  evidence_count INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL,
+  UNIQUE (context_id, dimension_id)
+);
+
+CREATE TABLE IF NOT EXISTS preference_snapshots (
+  id TEXT PRIMARY KEY,
+  profile_id TEXT NOT NULL REFERENCES preference_profiles(id) ON DELETE CASCADE,
+  context_id TEXT NOT NULL REFERENCES preference_contexts(id) ON DELETE CASCADE,
+  summary_metrics_json TEXT NOT NULL DEFAULT '{}',
+  serialized_model_state_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_preference_profiles_user_domain
+  ON preference_profiles(user_id, domain);
+CREATE INDEX IF NOT EXISTS idx_preference_contexts_profile_active
+  ON preference_contexts(profile_id, active, is_default);
+CREATE INDEX IF NOT EXISTS idx_preference_items_profile
+  ON preference_items(profile_id, updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_pairwise_judgments_context_created
+  ON pairwise_judgments(context_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_absolute_signals_context_created
+  ON absolute_signals(context_id, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_preference_scores_context
+  ON preference_item_scores(context_id, status, confidence DESC, latent_score DESC);
+CREATE INDEX IF NOT EXISTS idx_preference_snapshots_context
+  ON preference_snapshots(context_id, created_at DESC);

package/server/migrations/018_preference_catalogs.sql

@@ -0,0 +1,31 @@
+CREATE TABLE IF NOT EXISTS preference_catalogs (
+  id TEXT PRIMARY KEY,
+  profile_id TEXT NOT NULL REFERENCES preference_profiles(id) ON DELETE CASCADE,
+  domain TEXT NOT NULL,
+  slug TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  source TEXT NOT NULL DEFAULT 'custom' CHECK (source IN ('seeded', 'custom')),
+  archived INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE (profile_id, slug)
+);
+
+CREATE TABLE IF NOT EXISTS preference_catalog_items (
+  id TEXT PRIMARY KEY,
+  catalog_id TEXT NOT NULL REFERENCES preference_catalogs(id) ON DELETE CASCADE,
+  label TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  tags_json TEXT NOT NULL DEFAULT '[]',
+  feature_weights_json TEXT NOT NULL DEFAULT '{}',
+  position INTEGER NOT NULL DEFAULT 0,
+  archived INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_preference_catalogs_profile
+  ON preference_catalogs(profile_id, archived, source, title);
+CREATE INDEX IF NOT EXISTS idx_preference_catalog_items_catalog
+  ON preference_catalog_items(catalog_id, archived, position, label);