@memtensor/memos-local-openclaw-plugin 1.0.4-beta.6 → 1.0.4-beta.7

package/src/storage/sqlite.ts

@@ -3,6 +3,7 @@ import { createHash } from "crypto";
 import * as fs from "fs";
 import * as path from "path";
 import type { Chunk, ChunkRef, DedupStatus, Task, TaskStatus, Skill, SkillStatus, SkillVisibility, SkillVersion, TaskSkillLink, TaskSkillRelation, Logger } from "../types";
+import type { SharedVisibility, UserInfo, UserRole, UserStatus } from "../sharing/types";
 
 export class SqliteStore {
   private db: Database.Database;
@@ -110,6 +111,8 @@ export class SqliteStore {
     this.migrateSkillVisibility();
     this.migrateSkillEmbeddingsAndFts();
     this.migrateFtsToTrigram();
+    this.migrateHubTables();
+    this.migrateLocalSharedTasksOwner();
     this.log.debug("Database schema initialized");
   }
 
@@ -117,6 +120,16 @@ export class SqliteStore {
     this.db.exec("CREATE INDEX IF NOT EXISTS idx_chunks_dedup_created ON chunks(dedup_status, created_at DESC)");
   }
 
+  private migrateLocalSharedTasksOwner(): void {
+    try {
+      const cols = this.db.prepare("PRAGMA table_info(local_shared_tasks)").all() as Array<{ name: string }>;
+      if (cols.length > 0 && !cols.some((c) => c.name === "original_owner")) {
+        this.db.exec("ALTER TABLE local_shared_tasks ADD COLUMN original_owner TEXT NOT NULL DEFAULT 'agent:main'");
+        this.log.info("Migrated: added original_owner column to local_shared_tasks");
+      }
+    } catch { /* table may not exist yet */ }
+  }
+
   private migrateOwnerFields(): void {
     const chunkCols = this.db.prepare("PRAGMA table_info(chunks)").all() as Array<{ name: string }>;
     if (!chunkCols.some((c) => c.name === "owner")) {
@@ -514,12 +527,13 @@ export class SqliteStore {
     ).run(toolName, Math.round(durationMs), success ? 1 : 0, Date.now());
   }
 
-  getToolMetrics(minutes: number): {
+  getToolMetrics(minutes: number, fromMs?: number, toMs?: number): {
     tools: string[];
     series: Array<{ minute: string; [tool: string]: number | string }>;
     aggregated: Array<{ tool: string; totalCalls: number; avgMs: number; p95Ms: number; errorCount: number }>;
   } {
-    const since = Date.now() - minutes * 60 * 1000;
+    const since = fromMs ?? (Date.now() - minutes * 60 * 1000);
+    const until = toMs ?? Date.now();
 
     const rows = this.db.prepare(
       `SELECT tool_name,
@@ -527,9 +541,9 @@ export class SqliteStore {
               success,
               strftime('%Y-%m-%d %H:%M', called_at/1000, 'unixepoch', 'localtime') as minute_key
        FROM tool_calls
-       WHERE called_at >= ?
+       WHERE called_at >= ? AND called_at <= ?
        ORDER BY called_at`,
-    ).all(since) as Array<{ tool_name: string; duration_ms: number; success: number; minute_key: string }>;
+    ).all(since, until) as Array<{ tool_name: string; duration_ms: number; success: number; minute_key: string }>;
 
     const toolSet = new Set<string>();
     const minuteMap = new Map<string, Map<string, { total: number; count: number }>>();
@@ -659,6 +673,238 @@ export class SqliteStore {
     };
   }
 
+
+  private migrateHubTables(): void {
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS client_hub_connection (
+        id           INTEGER PRIMARY KEY CHECK (id = 1),
+        hub_url      TEXT NOT NULL,
+        user_id      TEXT NOT NULL,
+        username     TEXT NOT NULL,
+        user_token   TEXT NOT NULL,
+        role         TEXT NOT NULL,
+        connected_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS local_shared_tasks (
+        task_id       TEXT PRIMARY KEY,
+        hub_task_id   TEXT NOT NULL,
+        visibility    TEXT NOT NULL DEFAULT 'public',
+        group_id      TEXT,
+        synced_chunks INTEGER NOT NULL DEFAULT 0,
+        shared_at     INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS local_shared_memories (
+        chunk_id        TEXT PRIMARY KEY REFERENCES chunks(id) ON DELETE CASCADE,
+        original_owner  TEXT NOT NULL,
+        shared_at       INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS hub_users (
+        id             TEXT PRIMARY KEY,
+        username       TEXT NOT NULL UNIQUE,
+        device_name    TEXT NOT NULL DEFAULT '',
+        role           TEXT NOT NULL,
+        status         TEXT NOT NULL,
+        token_hash     TEXT NOT NULL DEFAULT '',
+        created_at     INTEGER NOT NULL,
+        approved_at    INTEGER,
+        last_ip        TEXT NOT NULL DEFAULT '',
+        last_active_at INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS idx_hub_users_status ON hub_users(status);
+      CREATE INDEX IF NOT EXISTS idx_hub_users_role ON hub_users(role);
+
+      CREATE TABLE IF NOT EXISTS hub_tasks (
+        id             TEXT PRIMARY KEY,
+        source_task_id TEXT NOT NULL,
+        source_user_id TEXT NOT NULL,
+        title          TEXT NOT NULL,
+        summary        TEXT NOT NULL DEFAULT '',
+        group_id       TEXT,
+        visibility     TEXT NOT NULL,
+        created_at     INTEGER NOT NULL,
+        updated_at     INTEGER NOT NULL,
+        UNIQUE(source_user_id, source_task_id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_hub_tasks_visibility ON hub_tasks(visibility);
+      CREATE INDEX IF NOT EXISTS idx_hub_tasks_group ON hub_tasks(group_id);
+
+      CREATE TABLE IF NOT EXISTS hub_chunks (
+        id              TEXT PRIMARY KEY,
+        hub_task_id     TEXT NOT NULL REFERENCES hub_tasks(id) ON DELETE CASCADE,
+        source_chunk_id TEXT NOT NULL,
+        source_user_id  TEXT NOT NULL,
+        role            TEXT NOT NULL,
+        content         TEXT NOT NULL,
+        summary         TEXT NOT NULL DEFAULT '',
+        kind            TEXT NOT NULL DEFAULT 'paragraph',
+        created_at      INTEGER NOT NULL,
+        UNIQUE(source_user_id, source_chunk_id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_hub_chunks_task ON hub_chunks(hub_task_id);
+
+      CREATE TABLE IF NOT EXISTS hub_embeddings (
+        chunk_id    TEXT PRIMARY KEY REFERENCES hub_chunks(id) ON DELETE CASCADE,
+        vector      BLOB NOT NULL,
+        dimensions  INTEGER NOT NULL,
+        updated_at  INTEGER NOT NULL
+      );
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS hub_chunks_fts USING fts5(
+        summary,
+        content,
+        content='hub_chunks',
+        content_rowid='rowid',
+        tokenize='porter unicode61'
+      );
+
+      CREATE TRIGGER IF NOT EXISTS hub_chunks_ai AFTER INSERT ON hub_chunks BEGIN
+        INSERT INTO hub_chunks_fts(rowid, summary, content)
+        VALUES (new.rowid, new.summary, new.content);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS hub_chunks_ad AFTER DELETE ON hub_chunks BEGIN
+        INSERT INTO hub_chunks_fts(hub_chunks_fts, rowid, summary, content)
+        VALUES ('delete', old.rowid, old.summary, old.content);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS hub_chunks_au AFTER UPDATE ON hub_chunks BEGIN
+        INSERT INTO hub_chunks_fts(hub_chunks_fts, rowid, summary, content)
+        VALUES ('delete', old.rowid, old.summary, old.content);
+        INSERT INTO hub_chunks_fts(rowid, summary, content)
+        VALUES (new.rowid, new.summary, new.content);
+      END;
+
+      CREATE TABLE IF NOT EXISTS hub_skills (
+        id              TEXT PRIMARY KEY,
+        source_skill_id TEXT NOT NULL,
+        source_user_id  TEXT NOT NULL,
+        name            TEXT NOT NULL,
+        description     TEXT NOT NULL DEFAULT '',
+        version         INTEGER NOT NULL,
+        group_id        TEXT,
+        visibility      TEXT NOT NULL,
+        bundle          TEXT NOT NULL,
+        quality_score   REAL,
+        created_at      INTEGER NOT NULL,
+        updated_at      INTEGER NOT NULL,
+        UNIQUE(source_user_id, source_skill_id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_hub_skills_visibility ON hub_skills(visibility);
+      CREATE INDEX IF NOT EXISTS idx_hub_skills_group ON hub_skills(group_id);
+
+      CREATE TABLE IF NOT EXISTS hub_skill_embeddings (
+        skill_id     TEXT PRIMARY KEY REFERENCES hub_skills(id) ON DELETE CASCADE,
+        vector       BLOB NOT NULL,
+        dimensions   INTEGER NOT NULL,
+        updated_at   INTEGER NOT NULL
+      );
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS hub_skills_fts USING fts5(
+        name,
+        description,
+        content='hub_skills',
+        content_rowid='rowid',
+        tokenize='porter unicode61'
+      );
+
+      CREATE TRIGGER IF NOT EXISTS hub_skills_ai AFTER INSERT ON hub_skills BEGIN
+        INSERT INTO hub_skills_fts(rowid, name, description)
+        VALUES (new.rowid, new.name, new.description);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS hub_skills_ad AFTER DELETE ON hub_skills BEGIN
+        INSERT INTO hub_skills_fts(hub_skills_fts, rowid, name, description)
+        VALUES ('delete', old.rowid, old.name, old.description);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS hub_skills_au AFTER UPDATE ON hub_skills BEGIN
+        INSERT INTO hub_skills_fts(hub_skills_fts, rowid, name, description)
+        VALUES ('delete', old.rowid, old.name, old.description);
+        INSERT INTO hub_skills_fts(rowid, name, description)
+        VALUES (new.rowid, new.name, new.description);
+      END;
+
+      -- Independent shared memories (not tied to a task)
+      CREATE TABLE IF NOT EXISTS hub_memories (
+        id              TEXT PRIMARY KEY,
+        source_chunk_id TEXT NOT NULL,
+        source_user_id  TEXT NOT NULL,
+        role            TEXT NOT NULL,
+        content         TEXT NOT NULL,
+        summary         TEXT NOT NULL DEFAULT '',
+        kind            TEXT NOT NULL DEFAULT 'paragraph',
+        group_id        TEXT,
+        visibility      TEXT NOT NULL,
+        created_at      INTEGER NOT NULL,
+        updated_at      INTEGER NOT NULL,
+        UNIQUE(source_user_id, source_chunk_id)
+      );
+      CREATE INDEX IF NOT EXISTS idx_hub_memories_visibility ON hub_memories(visibility);
+      CREATE INDEX IF NOT EXISTS idx_hub_memories_group ON hub_memories(group_id);
+
+      CREATE TABLE IF NOT EXISTS hub_memory_embeddings (
+        memory_id    TEXT PRIMARY KEY REFERENCES hub_memories(id) ON DELETE CASCADE,
+        vector       BLOB NOT NULL,
+        dimensions   INTEGER NOT NULL,
+        updated_at   INTEGER NOT NULL
+      );
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS hub_memories_fts USING fts5(
+        summary,
+        content,
+        content='hub_memories',
+        content_rowid='rowid',
+        tokenize='porter unicode61'
+      );
+
+      CREATE TRIGGER IF NOT EXISTS hub_memories_ai AFTER INSERT ON hub_memories BEGIN
+        INSERT INTO hub_memories_fts(rowid, summary, content)
+        VALUES (new.rowid, new.summary, new.content);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS hub_memories_ad AFTER DELETE ON hub_memories BEGIN
+        INSERT INTO hub_memories_fts(hub_memories_fts, rowid, summary, content)
+        VALUES ('delete', old.rowid, old.summary, old.content);
+      END;
+
+      CREATE TRIGGER IF NOT EXISTS hub_memories_au AFTER UPDATE ON hub_memories BEGIN
+        INSERT INTO hub_memories_fts(hub_memories_fts, rowid, summary, content)
+        VALUES ('delete', old.rowid, old.summary, old.content);
+        INSERT INTO hub_memories_fts(rowid, summary, content)
+        VALUES (new.rowid, new.summary, new.content);
+      END;
+    `);
+
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS hub_notifications (
+        id          TEXT PRIMARY KEY,
+        user_id     TEXT NOT NULL,
+        type        TEXT NOT NULL,
+        resource    TEXT NOT NULL,
+        title       TEXT NOT NULL,
+        message     TEXT NOT NULL DEFAULT '',
+        read        INTEGER NOT NULL DEFAULT 0,
+        created_at  INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_hub_notif_user ON hub_notifications(user_id, read, created_at DESC);
+    `);
+
+    try {
+      const cols = this.db.prepare("PRAGMA table_info(hub_users)").all() as Array<{ name: string }>;
+      if (cols.length > 0 && !cols.some(c => c.name === "last_ip")) {
+        this.db.exec("ALTER TABLE hub_users ADD COLUMN last_ip TEXT NOT NULL DEFAULT ''");
+        this.log.info("Migrated: added last_ip column to hub_users");
+      }
+      if (cols.length > 0 && !cols.some(c => c.name === "last_active_at")) {
+        this.db.exec("ALTER TABLE hub_users ADD COLUMN last_active_at INTEGER");
+        this.log.info("Migrated: added last_active_at column to hub_users");
+      }
+    } catch { /* table may not exist yet */ }
+  }
+
   // ─── Write ───
 
   insertChunk(chunk: Chunk): void {
@@ -998,6 +1244,8 @@ export class SqliteStore {
       "skill_embeddings",
       "skill_versions",
       "skills",
+      "local_shared_memories",
+      "local_shared_tasks",
       "embeddings",
       "chunks",
       "tasks",
@@ -1414,6 +1662,628 @@ export class SqliteStore {
       .map(r => r.session_key);
   }
 
+  // ─── Hub / Client connection ───
+
+  setClientHubConnection(conn: ClientHubConnection): void {
+    this.db.prepare(`
+      INSERT INTO client_hub_connection (id, hub_url, user_id, username, user_token, role, connected_at)
+      VALUES (1, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        hub_url = excluded.hub_url,
+        user_id = excluded.user_id,
+        username = excluded.username,
+        user_token = excluded.user_token,
+        role = excluded.role,
+        connected_at = excluded.connected_at
+    `).run(conn.hubUrl, conn.userId, conn.username, conn.userToken, conn.role, conn.connectedAt);
+  }
+
+  getClientHubConnection(): ClientHubConnection | null {
+    const row = this.db.prepare('SELECT * FROM client_hub_connection WHERE id = 1').get() as ClientHubConnectionRow | undefined;
+    return row ? rowToClientHubConnection(row) : null;
+  }
+
+  clearClientHubConnection(): void {
+    this.db.prepare('DELETE FROM client_hub_connection WHERE id = 1').run();
+  }
+
+  // ─── Local Shared Tasks (client-side tracking) ───
+
+  markTaskShared(taskId: string, hubTaskId: string, syncedChunks: number, visibility: string, groupId?: string | null): void {
+    this.db.prepare(`
+      INSERT INTO local_shared_tasks (task_id, hub_task_id, visibility, group_id, synced_chunks, shared_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(task_id) DO UPDATE SET
+        hub_task_id = excluded.hub_task_id,
+        visibility = excluded.visibility,
+        group_id = excluded.group_id,
+        synced_chunks = excluded.synced_chunks,
+        shared_at = excluded.shared_at
+    `).run(taskId, hubTaskId, visibility, groupId ?? null, syncedChunks, Date.now());
+  }
+
+  unmarkTaskShared(taskId: string): void {
+    this.db.prepare('DELETE FROM local_shared_tasks WHERE task_id = ?').run(taskId);
+  }
+
+  getLocalSharedTask(taskId: string): { taskId: string; hubTaskId: string; visibility: string; groupId: string | null; syncedChunks: number; sharedAt: number } | null {
+    const row = this.db.prepare('SELECT * FROM local_shared_tasks WHERE task_id = ?').get(taskId) as any;
+    if (!row) return null;
+    return { taskId: row.task_id, hubTaskId: row.hub_task_id, visibility: row.visibility, groupId: row.group_id, syncedChunks: row.synced_chunks, sharedAt: row.shared_at };
+  }
+
+  listLocalSharedTasks(): Array<{ taskId: string; hubTaskId: string; visibility: string; groupId: string | null; syncedChunks: number }> {
+    const rows = this.db.prepare('SELECT task_id, hub_task_id, visibility, group_id, synced_chunks FROM local_shared_tasks').all() as any[];
+    return rows.map(r => ({ taskId: r.task_id, hubTaskId: r.hub_task_id, visibility: r.visibility, groupId: r.group_id, syncedChunks: r.synced_chunks }));
+  }
+
+  // ─── Local Shared Memories (client-side tracking) ───
+
+  markMemorySharedLocally(chunkId: string): { ok: boolean; owner?: string; originalOwner?: string; sharedAt?: number; reason?: string } {
+    const chunk = this.getChunk(chunkId);
+    if (!chunk) return { ok: false, reason: "not_found" };
+    if (chunk.owner === "public") {
+      const existing = this.getLocalSharedMemory(chunkId);
+      return {
+        ok: true,
+        owner: "public",
+        originalOwner: existing?.originalOwner ?? undefined,
+        sharedAt: existing?.sharedAt ?? undefined,
+      };
+    }
+
+    const sharedAt = Date.now();
+    this.db.transaction(() => {
+      this.db.prepare(`
+        INSERT INTO local_shared_memories (chunk_id, original_owner, shared_at)
+        VALUES (?, ?, ?)
+        ON CONFLICT(chunk_id) DO UPDATE SET
+          original_owner = excluded.original_owner,
+          shared_at = excluded.shared_at
+      `).run(chunkId, chunk.owner, sharedAt);
+      this.updateChunk(chunkId, { owner: "public" });
+    })();
+
+    return { ok: true, owner: "public", originalOwner: chunk.owner, sharedAt };
+  }
+
+  unmarkMemorySharedLocally(chunkId: string, fallbackOwner?: string): { ok: boolean; owner?: string; originalOwner?: string; reason?: string } {
+    const chunk = this.getChunk(chunkId);
+    if (!chunk) return { ok: false, reason: "not_found" };
+    if (chunk.owner !== "public") {
+      return { ok: true, owner: chunk.owner };
+    }
+
+    const existing = this.getLocalSharedMemory(chunkId);
+    const restoreOwner = existing?.originalOwner ?? fallbackOwner;
+    if (!restoreOwner || restoreOwner === "public") {
+      return { ok: false, reason: "original_owner_missing" };
+    }
+
+    this.db.transaction(() => {
+      this.updateChunk(chunkId, { owner: restoreOwner });
+      this.db.prepare("DELETE FROM local_shared_memories WHERE chunk_id = ?").run(chunkId);
+    })();
+
+    return { ok: true, owner: restoreOwner, originalOwner: restoreOwner };
+  }
+
+  getLocalSharedMemory(chunkId: string): { chunkId: string; originalOwner: string; sharedAt: number } | null {
+    const row = this.db.prepare("SELECT chunk_id, original_owner, shared_at FROM local_shared_memories WHERE chunk_id = ?").get(chunkId) as any;
+    if (!row) return null;
+    return {
+      chunkId: row.chunk_id,
+      originalOwner: row.original_owner,
+      sharedAt: row.shared_at,
+    };
+  }
+
+  // ─── Hub Users / Groups ───
+
+  upsertHubUser(user: HubUserRecord): void {
+    this.db.prepare(`
+      INSERT INTO hub_users (id, username, device_name, role, status, token_hash, created_at, approved_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        username = excluded.username,
+        device_name = excluded.device_name,
+        role = excluded.role,
+        status = excluded.status,
+        token_hash = excluded.token_hash,
+        created_at = excluded.created_at,
+        approved_at = excluded.approved_at
+    `).run(user.id, user.username, user.deviceName ?? "", user.role, user.status, user.tokenHash, user.createdAt, user.approvedAt);
+  }
+
+  getHubUser(userId: string): HubUserRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_users WHERE id = ?').get(userId) as HubUserRow | undefined;
+    if (!row) return null;
+    return rowToHubUser(row);
+  }
+
+  listHubUsers(status?: UserStatus): HubUserRecord[] {
+    const rows = status
+      ? this.db.prepare('SELECT * FROM hub_users WHERE status = ? ORDER BY created_at').all(status) as HubUserRow[]
+      : this.db.prepare('SELECT * FROM hub_users ORDER BY created_at').all() as HubUserRow[];
+    return rows.map(rowToHubUser);
+  }
+
+  deleteHubUser(userId: string, cleanResources = false): boolean {
+    if (cleanResources) {
+      this.db.prepare('DELETE FROM hub_tasks WHERE source_user_id = ?').run(userId);
+      this.db.prepare('DELETE FROM hub_skills WHERE source_user_id = ?').run(userId);
+      this.db.prepare('DELETE FROM hub_memories WHERE source_user_id = ?').run(userId);
+    }
+    const result = this.db.prepare('DELETE FROM hub_users WHERE id = ?').run(userId);
+    return result.changes > 0;
+  }
+
+  updateHubUserActivity(userId: string, ip: string): void {
+    this.db.prepare('UPDATE hub_users SET last_ip = ?, last_active_at = ? WHERE id = ?').run(ip, Date.now(), userId);
+  }
+
+  getHubUserContributions(): Record<string, { memoryCount: number; taskCount: number; skillCount: number }> {
+    const result: Record<string, { memoryCount: number; taskCount: number; skillCount: number }> = {};
+    const memRows = this.db.prepare('SELECT source_user_id, COUNT(*) as cnt FROM hub_memories GROUP BY source_user_id').all() as Array<{ source_user_id: string; cnt: number }>;
+    const taskRows = this.db.prepare('SELECT source_user_id, COUNT(*) as cnt FROM hub_tasks GROUP BY source_user_id').all() as Array<{ source_user_id: string; cnt: number }>;
+    const skillRows = this.db.prepare('SELECT source_user_id, COUNT(*) as cnt FROM hub_skills GROUP BY source_user_id').all() as Array<{ source_user_id: string; cnt: number }>;
+    for (const r of memRows) { if (!result[r.source_user_id]) result[r.source_user_id] = { memoryCount: 0, taskCount: 0, skillCount: 0 }; result[r.source_user_id].memoryCount = r.cnt; }
+    for (const r of taskRows) { if (!result[r.source_user_id]) result[r.source_user_id] = { memoryCount: 0, taskCount: 0, skillCount: 0 }; result[r.source_user_id].taskCount = r.cnt; }
+    for (const r of skillRows) { if (!result[r.source_user_id]) result[r.source_user_id] = { memoryCount: 0, taskCount: 0, skillCount: 0 }; result[r.source_user_id].skillCount = r.cnt; }
+    return result;
+  }
+
+  // ─── Hub Shared Data ───
+
+  upsertHubTask(task: HubTaskRecord): void {
+    this.db.prepare(`
+      INSERT INTO hub_tasks (id, source_task_id, source_user_id, title, summary, group_id, visibility, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(source_user_id, source_task_id) DO UPDATE SET
+        title = excluded.title,
+        summary = excluded.summary,
+        group_id = excluded.group_id,
+        visibility = excluded.visibility,
+        created_at = excluded.created_at,
+        updated_at = excluded.updated_at
+    `).run(task.id, task.sourceTaskId, task.sourceUserId, task.title, task.summary, task.groupId, task.visibility, task.createdAt, task.updatedAt);
+  }
+
+  getHubTaskBySource(sourceUserId: string, sourceTaskId: string): HubTaskRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_tasks WHERE source_user_id = ? AND source_task_id = ?').get(sourceUserId, sourceTaskId) as HubTaskRow | undefined;
+    return row ? rowToHubTask(row) : null;
+  }
+
+  getHubTaskById(taskId: string): HubTaskRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_tasks WHERE id = ?').get(taskId) as HubTaskRow | undefined;
+    return row ? rowToHubTask(row) : null;
+  }
+
+  upsertHubChunk(chunk: HubChunkUpsertInput): void {
+    if (!chunk.sourceTaskId) throw new Error("sourceTaskId is required for hub chunk upserts");
+    const taskId = this.resolveCanonicalHubTaskId(chunk.hubTaskId, chunk.sourceUserId, chunk.sourceTaskId);
+    this.db.prepare(`
+      INSERT INTO hub_chunks (id, hub_task_id, source_chunk_id, source_user_id, role, content, summary, kind, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(source_user_id, source_chunk_id) DO UPDATE SET
+        hub_task_id = excluded.hub_task_id,
+        role = excluded.role,
+        content = excluded.content,
+        summary = excluded.summary,
+        kind = excluded.kind,
+        created_at = excluded.created_at
+    `).run(chunk.id, taskId, chunk.sourceChunkId, chunk.sourceUserId, chunk.role, chunk.content, chunk.summary, chunk.kind, chunk.createdAt);
+  }
+
+  getHubChunkBySource(sourceUserId: string, sourceChunkId: string): HubChunkRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_chunks WHERE source_user_id = ? AND source_chunk_id = ?').get(sourceUserId, sourceChunkId) as HubChunkRow | undefined;
+    return row ? rowToHubChunk(row) : null;
+  }
+
+  deleteHubTaskBySource(sourceUserId: string, sourceTaskId: string): void {
+    this.db.prepare('DELETE FROM hub_tasks WHERE source_user_id = ? AND source_task_id = ?').run(sourceUserId, sourceTaskId);
+  }
+
+  upsertHubSkill(skill: HubSkillRecord): void {
+    this.db.prepare(`
+      INSERT INTO hub_skills (id, source_skill_id, source_user_id, name, description, version, group_id, visibility, bundle, quality_score, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(source_user_id, source_skill_id) DO UPDATE SET
+        name = excluded.name,
+        description = excluded.description,
+        version = excluded.version,
+        group_id = excluded.group_id,
+        visibility = excluded.visibility,
+        bundle = excluded.bundle,
+        quality_score = excluded.quality_score,
+        created_at = excluded.created_at,
+        updated_at = excluded.updated_at
+    `).run(skill.id, skill.sourceSkillId, skill.sourceUserId, skill.name, skill.description, skill.version, skill.groupId, skill.visibility, skill.bundle, skill.qualityScore, skill.createdAt, skill.updatedAt);
+  }
+
+  getHubSkillBySource(sourceUserId: string, sourceSkillId: string): HubSkillRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_skills WHERE source_user_id = ? AND source_skill_id = ?').get(sourceUserId, sourceSkillId) as HubSkillRow | undefined;
+    return row ? rowToHubSkill(row) : null;
+  }
+
+  getHubSkillById(skillId: string): HubSkillRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_skills WHERE id = ?').get(skillId) as HubSkillRow | undefined;
+    return row ? rowToHubSkill(row) : null;
+  }
+
+  upsertHubSkillEmbedding(skillId: string, vector: number[], sourceUserId: string, sourceSkillId: string): void {
+    if (!sourceUserId || !sourceSkillId) throw new Error("sourceUserId and sourceSkillId are required for hub skill embedding upserts");
+    const canonicalSkillId = this.resolveCanonicalHubSkillId(skillId, sourceUserId, sourceSkillId);
+    const buf = Buffer.allocUnsafe(vector.length * 4);
+    for (let i = 0; i < vector.length; i++) buf.writeFloatLE(vector[i], i * 4);
+    this.db.prepare(`
+      INSERT INTO hub_skill_embeddings (skill_id, vector, dimensions, updated_at)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(skill_id) DO UPDATE SET
+        vector = excluded.vector,
+        dimensions = excluded.dimensions,
+        updated_at = excluded.updated_at
+    `).run(canonicalSkillId, buf, vector.length, Date.now());
+  }
+
+  getHubSkillEmbedding(skillId: string): number[] | null {
+    const row = this.db.prepare('SELECT vector, dimensions FROM hub_skill_embeddings WHERE skill_id = ?').get(skillId) as { vector: Buffer; dimensions: number } | undefined;
+    if (!row) return null;
+    const out: number[] = [];
+    for (let i = 0; i < row.dimensions; i++) out.push(row.vector.readFloatLE(i * 4));
+    return out;
+  }
+
+  searchHubChunks(query: string, options?: { userId?: string; maxResults?: number }): Array<{ hit: HubSearchRow; rank: number }> {
+    const limit = options?.maxResults ?? 10;
+    const userId = options?.userId ?? "";
+    const rows = this.db.prepare(`
+      SELECT hc.id, hc.content, hc.summary, hc.role, hc.created_at, ht.title as task_title, ht.visibility, '' as group_name, hu.username as owner_name,
+             bm25(hub_chunks_fts) as rank
+      FROM hub_chunks_fts f
+      JOIN hub_chunks hc ON hc.rowid = f.rowid
+      JOIN hub_tasks ht ON ht.id = hc.hub_task_id
+      LEFT JOIN hub_users hu ON hu.id = ht.source_user_id
+      WHERE hub_chunks_fts MATCH ?
+      ORDER BY rank
+      LIMIT ?
+    `).all(sanitizeFtsQuery(query), limit) as HubSearchRow[];
+    return rows.map((row, idx) => ({ hit: row, rank: idx + 1 }));
+  }
+
+  upsertHubEmbedding(chunkId: string, vector: Float32Array): void {
+    const buf = Buffer.from(vector.buffer, vector.byteOffset, vector.byteLength);
+    this.db.prepare(`
+      INSERT INTO hub_embeddings (chunk_id, vector, dimensions, updated_at)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(chunk_id) DO UPDATE SET vector = excluded.vector, dimensions = excluded.dimensions, updated_at = excluded.updated_at
+    `).run(chunkId, buf, vector.length, Date.now());
+  }
+
+  getHubEmbedding(chunkId: string): Float32Array | null {
+    const row = this.db.prepare('SELECT vector, dimensions FROM hub_embeddings WHERE chunk_id = ?').get(chunkId) as { vector: Buffer; dimensions: number } | undefined;
+    if (!row) return null;
+    return new Float32Array(row.vector.buffer, row.vector.byteOffset, row.dimensions);
+  }
+
+  getVisibleHubEmbeddings(userId: string): Array<{ chunkId: string; vector: Float32Array }> {
+    const rows = this.db.prepare(`
+      SELECT he.chunk_id, he.vector, he.dimensions
+      FROM hub_embeddings he
+      JOIN hub_chunks hc ON hc.id = he.chunk_id
+      JOIN hub_tasks ht ON ht.id = hc.hub_task_id
+    `).all() as Array<{ chunk_id: string; vector: Buffer; dimensions: number }>;
+    return rows.map(r => ({
+      chunkId: r.chunk_id,
+      vector: new Float32Array(r.vector.buffer, r.vector.byteOffset, r.dimensions),
+    }));
+  }
+
+  getVisibleHubSearchHitByChunkId(chunkId: string, userId: string): HubSearchRow | null {
+    const row = this.db.prepare(`
+      SELECT hc.id, hc.content, hc.summary, hc.role, hc.created_at, ht.title as task_title, ht.visibility, '' as group_name, hu.username as owner_name,
+             0 as rank
+      FROM hub_chunks hc
+      JOIN hub_tasks ht ON ht.id = hc.hub_task_id
+      LEFT JOIN hub_users hu ON hu.id = ht.source_user_id
+      WHERE hc.id = ?
+      LIMIT 1
+    `).get(chunkId) as HubSearchRow | undefined;
+    return row ?? null;
+  }
+
+  getHubChunkById(chunkId: string): HubChunkRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_chunks WHERE id = ?').get(chunkId) as HubChunkRow | undefined;
+    return row ? rowToHubChunk(row) : null;
+  }
+
+  searchHubSkills(query: string, options?: { userId?: string; maxResults?: number }): Array<{ hit: HubSkillSearchRow; rank: number }> {
+    const limit = options?.maxResults ?? 10;
+    const userId = options?.userId ?? "";
+    const sanitized = sanitizeFtsQuery(query);
+    let rows: HubSkillSearchRow[];
+    if (sanitized) {
+      rows = this.db.prepare(`
+        SELECT hs.id, hs.name, hs.description, hs.version, hs.visibility, '' AS group_name, hu.username AS owner_name, hs.quality_score,
+               bm25(hub_skills_fts) as rank
+        FROM hub_skills_fts f
+        JOIN hub_skills hs ON hs.rowid = f.rowid
+        LEFT JOIN hub_users hu ON hu.id = hs.source_user_id
+        WHERE hub_skills_fts MATCH ?
+        ORDER BY rank
+        LIMIT ?
+      `).all(sanitized, limit) as HubSkillSearchRow[];
+    } else {
+      rows = this.db.prepare(`
+        SELECT hs.id, hs.name, hs.description, hs.version, hs.visibility, '' AS group_name, hu.username AS owner_name, hs.quality_score,
+               0 as rank
+        FROM hub_skills hs
+        LEFT JOIN hub_users hu ON hu.id = hs.source_user_id
+        ORDER BY hs.updated_at DESC
+        LIMIT ?
+      `).all(limit) as HubSkillSearchRow[];
+    }
+    return rows.map((row, idx) => ({ hit: row, rank: idx + 1 }));
+  }
+
+  deleteHubSkillBySource(sourceUserId: string, sourceSkillId: string): void {
+    this.db.prepare('DELETE FROM hub_skills WHERE source_user_id = ? AND source_skill_id = ?').run(sourceUserId, sourceSkillId);
+  }
+
+  listVisibleHubTasks(userId: string, limit = 40): Array<{ id: string; sourceTaskId: string; sourceUserId: string; title: string; summary: string; groupId: string | null; groupName: string | null; visibility: string; ownerName: string; chunkCount: number; createdAt: number; updatedAt: number }> {
+    const rows = this.db.prepare(`
+      SELECT t.*, u.username AS owner_name, NULL AS group_name,
+        (SELECT COUNT(*) FROM hub_chunks c WHERE c.hub_task_id = t.id) AS chunk_count
+      FROM hub_tasks t
+      LEFT JOIN hub_users u ON u.id = t.source_user_id
+      ORDER BY t.updated_at DESC
+      LIMIT ?
+    `).all(limit) as any[];
+    return rows.map(r => ({
+      id: r.id, sourceTaskId: r.source_task_id, sourceUserId: r.source_user_id,
+      title: r.title, summary: r.summary, groupId: r.group_id, groupName: r.group_name ?? null,
+      visibility: r.visibility, ownerName: r.owner_name ?? "unknown", chunkCount: r.chunk_count ?? 0,
+      createdAt: r.created_at, updatedAt: r.updated_at,
+    }));
+  }
+
+  listAllHubTasks(): Array<{ id: string; sourceTaskId: string; sourceUserId: string; title: string; summary: string; groupId: string | null; groupName: string | null; visibility: string; ownerName: string; chunkCount: number; createdAt: number; updatedAt: number }> {
+    const rows = this.db.prepare(`
+      SELECT t.*, u.username AS owner_name,
+        (SELECT COUNT(*) FROM hub_chunks c WHERE c.hub_task_id = t.id) AS chunk_count
+      FROM hub_tasks t
+      LEFT JOIN hub_users u ON u.id = t.source_user_id
+      ORDER BY t.updated_at DESC
+    `).all() as any[];
+    return rows.map(r => ({
+      id: r.id, sourceTaskId: r.source_task_id, sourceUserId: r.source_user_id,
+      title: r.title, summary: r.summary, groupId: r.group_id, groupName: null as string | null,
+      visibility: r.visibility, ownerName: r.owner_name ?? "unknown", chunkCount: r.chunk_count ?? 0,
+      createdAt: r.created_at, updatedAt: r.updated_at,
+    }));
+  }
+
+  deleteHubTaskById(taskId: string): boolean {
+    const info = this.db.prepare('DELETE FROM hub_tasks WHERE id = ?').run(taskId);
+    return info.changes > 0;
+  }
+
+  listVisibleHubSkills(userId: string, limit = 40): Array<{ id: string; sourceSkillId: string; sourceUserId: string; name: string; description: string; version: number; groupId: string | null; groupName: string | null; visibility: string; ownerName: string; qualityScore: number | null; createdAt: number; updatedAt: number }> {
+    const rows = this.db.prepare(`
+      SELECT s.*, u.username AS owner_name, NULL AS group_name
+      FROM hub_skills s
+      LEFT JOIN hub_users u ON u.id = s.source_user_id
+      ORDER BY s.updated_at DESC
+      LIMIT ?
+    `).all(limit) as any[];
+    return rows.map(r => ({
+      id: r.id, sourceSkillId: r.source_skill_id, sourceUserId: r.source_user_id,
+      name: r.name, description: r.description, version: r.version,
+      groupId: r.group_id, groupName: r.group_name ?? null, visibility: r.visibility,
+      ownerName: r.owner_name ?? "unknown", qualityScore: r.quality_score,
+      createdAt: r.created_at, updatedAt: r.updated_at,
+    }));
+  }
+
+  listAllHubSkills(): Array<{ id: string; sourceSkillId: string; sourceUserId: string; name: string; description: string; version: number; groupId: string | null; groupName: string | null; visibility: string; ownerName: string; qualityScore: number | null; createdAt: number; updatedAt: number }> {
+    const rows = this.db.prepare(`
+      SELECT s.*, u.username AS owner_name
+      FROM hub_skills s
+      LEFT JOIN hub_users u ON u.id = s.source_user_id
+      ORDER BY s.updated_at DESC
+    `).all() as any[];
+    return rows.map(r => ({
+      id: r.id, sourceSkillId: r.source_skill_id, sourceUserId: r.source_user_id,
+      name: r.name, description: r.description, version: r.version,
+      groupId: r.group_id, groupName: null as string | null, visibility: r.visibility,
+      ownerName: r.owner_name ?? "unknown", qualityScore: r.quality_score,
+      createdAt: r.created_at, updatedAt: r.updated_at,
+    }));
+  }
+
+  deleteHubSkillById(skillId: string): boolean {
+    const info = this.db.prepare('DELETE FROM hub_skills WHERE id = ?').run(skillId);
+    return info.changes > 0;
+  }
+
+  // ─── Hub Shared Memories (independent) ───
+
+  upsertHubMemory(memory: HubMemoryRecord): void {
+    this.db.prepare(`
+      INSERT INTO hub_memories (id, source_chunk_id, source_user_id, role, content, summary, kind, group_id, visibility, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(source_user_id, source_chunk_id) DO UPDATE SET
+        role = excluded.role,
+        content = excluded.content,
+        summary = excluded.summary,
+        kind = excluded.kind,
+        group_id = excluded.group_id,
+        visibility = excluded.visibility,
+        created_at = excluded.created_at,
+        updated_at = excluded.updated_at
+    `).run(memory.id, memory.sourceChunkId, memory.sourceUserId, memory.role, memory.content, memory.summary, memory.kind, memory.groupId, memory.visibility, memory.createdAt, memory.updatedAt);
+  }
+
+  getHubMemoryBySource(sourceUserId: string, sourceChunkId: string): HubMemoryRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_memories WHERE source_user_id = ? AND source_chunk_id = ?').get(sourceUserId, sourceChunkId) as HubMemoryRow | undefined;
+    return row ? rowToHubMemory(row) : null;
+  }
+
+  getHubMemoryById(memoryId: string): HubMemoryRecord | null {
+    const row = this.db.prepare('SELECT * FROM hub_memories WHERE id = ?').get(memoryId) as HubMemoryRow | undefined;
+    return row ? rowToHubMemory(row) : null;
+  }
+
+  deleteHubMemoryBySource(sourceUserId: string, sourceChunkId: string): void {
+    this.db.prepare('DELETE FROM hub_memories WHERE source_user_id = ? AND source_chunk_id = ?').run(sourceUserId, sourceChunkId);
+  }
+
+  deleteHubMemoryById(memoryId: string): boolean {
+    const info = this.db.prepare('DELETE FROM hub_memories WHERE id = ?').run(memoryId);
+    return info.changes > 0;
+  }
+
+  // ─── Hub Notifications ───
+
+  insertHubNotification(n: { id: string; userId: string; type: string; resource: string; title: string; message?: string }): void {
+    this.db.prepare(
+      'INSERT INTO hub_notifications (id, user_id, type, resource, title, message, read, created_at) VALUES (?, ?, ?, ?, ?, ?, 0, ?)'
+    ).run(n.id, n.userId, n.type, n.resource, n.title, n.message ?? '', Date.now());
+  }
+
+  listHubNotifications(userId: string, opts?: { unreadOnly?: boolean; limit?: number }): Array<{ id: string; userId: string; type: string; resource: string; title: string; message: string; read: boolean; createdAt: number }> {
+    const where = opts?.unreadOnly ? 'WHERE user_id = ? AND read = 0' : 'WHERE user_id = ?';
+    const limit = opts?.limit ?? 50;
+    const rows = this.db.prepare(`SELECT * FROM hub_notifications ${where} ORDER BY created_at DESC LIMIT ?`).all(userId, limit) as any[];
+    return rows.map(r => ({ id: r.id, userId: r.user_id, type: r.type, resource: r.resource, title: r.title, message: r.message, read: !!r.read, createdAt: r.created_at }));
+  }
+
+  countUnreadHubNotifications(userId: string): number {
+    const row = this.db.prepare('SELECT COUNT(*) AS cnt FROM hub_notifications WHERE user_id = ? AND read = 0').get(userId) as { cnt: number };
+    return row.cnt;
+  }
+
+  markHubNotificationsRead(userId: string, ids?: string[]): void {
+    if (ids && ids.length > 0) {
+      const placeholders = ids.map(() => '?').join(',');
+      this.db.prepare(`UPDATE hub_notifications SET read = 1 WHERE user_id = ? AND id IN (${placeholders})`).run(userId, ...ids);
+    } else {
+      this.db.prepare('UPDATE hub_notifications SET read = 1 WHERE user_id = ?').run(userId);
+    }
+  }
+
+  clearHubNotifications(userId: string): void {
+    this.db.prepare('DELETE FROM hub_notifications WHERE user_id = ?').run(userId);
+  }
+
+  upsertHubMemoryEmbedding(memoryId: string, vector: Float32Array): void {
+    const buf = Buffer.from(vector.buffer, vector.byteOffset, vector.byteLength);
+    this.db.prepare(`
+      INSERT INTO hub_memory_embeddings (memory_id, vector, dimensions, updated_at)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(memory_id) DO UPDATE SET vector = excluded.vector, dimensions = excluded.dimensions, updated_at = excluded.updated_at
+    `).run(memoryId, buf, vector.length, Date.now());
+  }
+
+  getHubMemoryEmbedding(memoryId: string): Float32Array | null {
+    const row = this.db.prepare('SELECT vector, dimensions FROM hub_memory_embeddings WHERE memory_id = ?').get(memoryId) as { vector: Buffer; dimensions: number } | undefined;
+    if (!row) return null;
+    return new Float32Array(row.vector.buffer, row.vector.byteOffset, row.dimensions);
+  }
+
+  searchHubMemories(query: string, options?: { userId?: string; maxResults?: number }): Array<{ hit: HubMemorySearchRow; rank: number }> {
+    const limit = options?.maxResults ?? 10;
+    const userId = options?.userId ?? "";
+    const sanitized = sanitizeFtsQuery(query);
+    if (!sanitized) return [];
+    const rows = this.db.prepare(`
+      SELECT hm.id, hm.content, hm.summary, hm.role, hm.created_at, hm.visibility, '' as group_name, hu.username as owner_name,
+             bm25(hub_memories_fts) as rank
+      FROM hub_memories_fts f
+      JOIN hub_memories hm ON hm.rowid = f.rowid
+      LEFT JOIN hub_users hu ON hu.id = hm.source_user_id
+      WHERE hub_memories_fts MATCH ?
+      ORDER BY rank
+      LIMIT ?
+    `).all(sanitized, limit) as HubMemorySearchRow[];
+    return rows.map((row, idx) => ({ hit: row, rank: idx + 1 }));
+  }
+
+  getVisibleHubMemoryEmbeddings(userId: string): Array<{ memoryId: string; vector: Float32Array }> {
+    const rows = this.db.prepare(`
+      SELECT hme.memory_id, hme.vector, hme.dimensions
+      FROM hub_memory_embeddings hme
+      JOIN hub_memories hm ON hm.id = hme.memory_id
+    `).all() as Array<{ memory_id: string; vector: Buffer; dimensions: number }>;
+    return rows.map(r => ({
+      memoryId: r.memory_id,
+      vector: new Float32Array(r.vector.buffer, r.vector.byteOffset, r.dimensions),
+    }));
+  }
+
+  getVisibleHubSearchHitByMemoryId(memoryId: string, userId: string): HubMemorySearchRow | null {
+    const row = this.db.prepare(`
+      SELECT hm.id, hm.content, hm.summary, hm.role, hm.created_at, hm.visibility, '' as group_name, hu.username as owner_name,
+             0 as rank
+      FROM hub_memories hm
+      LEFT JOIN hub_users hu ON hu.id = hm.source_user_id
+      WHERE hm.id = ?
+      LIMIT 1
+    `).get(memoryId) as HubMemorySearchRow | undefined;
+    return row ?? null;
+  }
+
+  listVisibleHubMemories(userId: string, limit = 40): Array<{ id: string; sourceChunkId: string; sourceUserId: string; role: string; summary: string; kind: string; groupId: string | null; groupName: string | null; visibility: string; ownerName: string; createdAt: number; updatedAt: number }> {
+    const rows = this.db.prepare(`
+      SELECT m.*, u.username AS owner_name, NULL AS group_name
+      FROM hub_memories m
+      LEFT JOIN hub_users u ON u.id = m.source_user_id
+      ORDER BY m.updated_at DESC
+      LIMIT ?
+    `).all(limit) as any[];
+    return rows.map(r => ({
+      id: r.id, sourceChunkId: r.source_chunk_id, sourceUserId: r.source_user_id,
+      role: r.role, summary: r.summary, kind: r.kind,
+      groupId: r.group_id, groupName: r.group_name ?? null, visibility: r.visibility,
+      ownerName: r.owner_name ?? "unknown", createdAt: r.created_at, updatedAt: r.updated_at,
+    }));
+  }
+
+  listAllHubMemories(): Array<{ id: string; sourceChunkId: string; sourceUserId: string; role: string; summary: string; kind: string; groupId: string | null; groupName: string | null; visibility: string; ownerName: string; createdAt: number; updatedAt: number }> {
+    const rows = this.db.prepare(`
+      SELECT m.*, u.username AS owner_name
+      FROM hub_memories m
+      LEFT JOIN hub_users u ON u.id = m.source_user_id
+      ORDER BY m.updated_at DESC
+    `).all() as any[];
+    return rows.map(r => ({
+      id: r.id, sourceChunkId: r.source_chunk_id, sourceUserId: r.source_user_id,
+      role: r.role, summary: r.summary, kind: r.kind,
+      groupId: r.group_id, groupName: null as string | null, visibility: r.visibility,
+      ownerName: r.owner_name ?? "unknown", createdAt: r.created_at, updatedAt: r.updated_at,
+    }));
+  }
+
+  private resolveCanonicalHubTaskId(taskId: string, sourceUserId: string, sourceTaskId?: string): string {
+    if (sourceTaskId) {
+      const bySource = this.db.prepare('SELECT id FROM hub_tasks WHERE source_user_id = ? AND source_task_id = ?').get(sourceUserId, sourceTaskId) as { id: string } | undefined;
+      if (!bySource) throw new Error(`source task not found for user=${sourceUserId} sourceTaskId=${sourceTaskId}`);
+      if (bySource.id != taskId) throw new Error(`mismatch between source task and hubTaskId: expected ${bySource.id}, got ${taskId}`);
+      return bySource.id;
+    }
+    throw new Error(`source task not found for user=${sourceUserId} taskId=${taskId}`);
+  }
+
+  private resolveCanonicalHubSkillId(skillId: string, sourceUserId?: string, sourceSkillId?: string): string {
+    if (sourceUserId && sourceSkillId) {
+      const bySource = this.db.prepare('SELECT id FROM hub_skills WHERE source_user_id = ? AND source_skill_id = ?').get(sourceUserId, sourceSkillId) as { id: string } | undefined;
+      if (!bySource) throw new Error(`source skill not found for user=${sourceUserId} sourceSkillId=${sourceSkillId}`);
+      if (bySource.id != skillId) throw new Error(`mismatch between source skill and skillId: expected ${bySource.id}, got ${skillId}`);
+      return bySource.id;
+    }
+    throw new Error(`source skill not found for skillId=${skillId}`);
+  }
+
   getSessionOwnerMap(sessionKeys: string[]): Map<string, string> {
     const result = new Map<string, string>();
     if (sessionKeys.length === 0) return result;
@@ -1591,6 +2461,291 @@ function rowToSkillVersion(row: SkillVersionRow): SkillVersion {
   };
 }
 
+
+interface ClientHubConnection {
+  hubUrl: string;
+  userId: string;
+  username: string;
+  userToken: string;
+  role: UserRole;
+  connectedAt: number;
+}
+
+interface ClientHubConnectionRow {
+  hub_url: string;
+  user_id: string;
+  username: string;
+  user_token: string;
+  role: string;
+  connected_at: number;
+}
+
+function rowToClientHubConnection(row: ClientHubConnectionRow): ClientHubConnection {
+  return {
+    hubUrl: row.hub_url,
+    userId: row.user_id,
+    username: row.username,
+    userToken: row.user_token,
+    role: row.role as UserRole,
+    connectedAt: row.connected_at,
+  };
+}
+
+interface HubUserRecord extends UserInfo {
+  tokenHash: string;
+  createdAt: number;
+  approvedAt: number | null;
+  lastIp: string;
+  lastActiveAt: number | null;
+}
+
+interface HubUserRow {
+  id: string;
+  username: string;
+  device_name: string;
+  role: string;
+  status: string;
+  token_hash: string;
+  created_at: number;
+  approved_at: number | null;
+  last_ip: string;
+  last_active_at: number | null;
+}
+
+function rowToHubUser(row: HubUserRow): HubUserRecord {
+  return {
+    id: row.id,
+    username: row.username,
+    deviceName: row.device_name || undefined,
+    role: row.role as UserRole,
+    status: row.status as UserStatus,
+    groups: [],
+    tokenHash: row.token_hash,
+    createdAt: row.created_at,
+    approvedAt: row.approved_at,
+    lastIp: row.last_ip || "",
+    lastActiveAt: row.last_active_at ?? null,
+  };
+}
+
+interface HubTaskRecord {
+  id: string;
+  sourceTaskId: string;
+  sourceUserId: string;
+  title: string;
+  summary: string;
+  groupId: string | null;
+  visibility: SharedVisibility;
+  createdAt: number;
+  updatedAt: number;
+}
+
+interface HubTaskRow {
+  id: string;
+  source_task_id: string;
+  source_user_id: string;
+  title: string;
+  summary: string;
+  group_id: string | null;
+  visibility: string;
+  created_at: number;
+  updated_at: number;
+}
+
+function rowToHubTask(row: HubTaskRow): HubTaskRecord {
+  return {
+    id: row.id,
+    sourceTaskId: row.source_task_id,
+    sourceUserId: row.source_user_id,
+    title: row.title,
+    summary: row.summary,
+    groupId: row.group_id,
+    visibility: row.visibility as SharedVisibility,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+  };
+}
+
+interface HubChunkUpsertInput {
+  id: string;
+  hubTaskId: string;
+  sourceTaskId: string;
+  sourceChunkId: string;
+  sourceUserId: string;
+  role: Chunk["role"];
+  content: string;
+  summary: string;
+  kind: Chunk["kind"];
+  createdAt: number;
+}
+
+interface HubChunkRecord {
+  id: string;
+  hubTaskId: string;
+  sourceChunkId: string;
+  sourceUserId: string;
+  role: Chunk["role"];
+  content: string;
+  summary: string;
+  kind: Chunk["kind"];
+  createdAt: number;
+}
+
+interface HubChunkRow {
+  id: string;
+  hub_task_id: string;
+  source_chunk_id: string;
+  source_user_id: string;
+  role: string;
+  content: string;
+  summary: string;
+  kind: string;
+  created_at: number;
+}
+
+function rowToHubChunk(row: HubChunkRow): HubChunkRecord {
+  return {
+    id: row.id,
+    hubTaskId: row.hub_task_id,
+    sourceChunkId: row.source_chunk_id,
+    sourceUserId: row.source_user_id,
+    role: row.role as Chunk["role"],
+    content: row.content,
+    summary: row.summary,
+    kind: row.kind as Chunk["kind"],
+    createdAt: row.created_at,
+  };
+}
+
+interface HubSkillRecord {
+  id: string;
+  sourceSkillId: string;
+  sourceUserId: string;
+  name: string;
+  description: string;
+  version: number;
+  groupId: string | null;
+  visibility: SharedVisibility;
+  bundle: string;
+  qualityScore: number | null;
+  createdAt: number;
+  updatedAt: number;
+}
+
+interface HubSkillRow {
+  id: string;
+  source_skill_id: string;
+  source_user_id: string;
+  name: string;
+  description: string;
+  version: number;
+  group_id: string | null;
+  visibility: string;
+  bundle: string;
+  quality_score: number | null;
+  created_at: number;
+  updated_at: number;
+}
+
+function rowToHubSkill(row: HubSkillRow): HubSkillRecord {
+  return {
+    id: row.id,
+    sourceSkillId: row.source_skill_id,
+    sourceUserId: row.source_user_id,
+    name: row.name,
+    description: row.description,
+    version: row.version,
+    groupId: row.group_id,
+    visibility: row.visibility as SharedVisibility,
+    bundle: row.bundle,
+    qualityScore: row.quality_score,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+  };
+}
+
+
+interface HubSkillSearchRow {
+  id: string;
+  name: string;
+  description: string;
+  version: number;
+  visibility: string;
+  group_name: string | null;
+  owner_name: string | null;
+  quality_score: number | null;
+}
+
+interface HubSearchRow {
+  id: string;
+  content: string;
+  summary: string;
+  role: string;
+  created_at: number;
+  task_title: string | null;
+  visibility: string;
+  group_name: string | null;
+  owner_name: string | null;
+  rank: number;
+}
+
+export interface HubMemoryRecord {
+  id: string;
+  sourceChunkId: string;
+  sourceUserId: string;
+  role: string;
+  content: string;
+  summary: string;
+  kind: string;
+  groupId: string | null;
+  visibility: SharedVisibility;
+  createdAt: number;
+  updatedAt: number;
+}
+
+interface HubMemoryRow {
+  id: string;
+  source_chunk_id: string;
+  source_user_id: string;
+  role: string;
+  content: string;
+  summary: string;
+  kind: string;
+  group_id: string | null;
+  visibility: string;
+  created_at: number;
+  updated_at: number;
+}
+
+function rowToHubMemory(row: HubMemoryRow): HubMemoryRecord {
+  return {
+    id: row.id,
+    sourceChunkId: row.source_chunk_id,
+    sourceUserId: row.source_user_id,
+    role: row.role,
+    content: row.content,
+    summary: row.summary,
+    kind: row.kind,
+    groupId: row.group_id,
+    visibility: row.visibility as SharedVisibility,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+  };
+}
+
+interface HubMemorySearchRow {
+  id: string;
+  content: string;
+  summary: string;
+  role: string;
+  created_at: number;
+  visibility: string;
+  group_name: string | null;
+  owner_name: string | null;
+  rank: number;
+}
+
+
 function contentHash(content: string): string {
   return createHash("sha256").update(content).digest("hex").slice(0, 16);
 }