agentworkshop 0.8.1 → 0.8.3

package/server/services/workshop/db/channel-member.repo.ts

@@ -1,122 +1,122 @@
-/**
- * ChannelMember 仓储 —— v17 群成员(channel_members)。
- *
- * 语义要点(主计划 §3.2 / §13.7):
- * - user_id 是**全局用户系统**的 id(server/repositories/user.repository),
- *   不是本库遗留 users 表;因此不做外键(跨库/跨语义)。
- * - owner 必须有且只有一条 active owner 记录;owner 不允许 leave(服务层强制)。
- * - 退出/移除 → status 置 left/removed;重新加入 → generation +1(旧审批资格不恢复)。
- * - status: active(可读/发言/审批) | pending(owner_approve 待批) | left | removed
- */
-import type { DatabaseSync } from 'node:sqlite'
-import type { ChannelMemberRow } from './database'
-
-const COLS = 'channel_id AS channelId, user_id AS userId, role, status, generation, joined_at AS joinedAt, left_at AS leftAt'
-
-export type ChannelMemberStatus = 'active' | 'pending' | 'left' | 'removed'
-export type ChannelMemberRole = 'owner' | 'member'
-
-export interface ChannelMemberUpsertInput {
-  channelId: string
-  userId: string
-  role?: ChannelMemberRole
-  status?: ChannelMemberStatus
-  joinedAt?: string
-}
-
-export type ChannelMemberRepo = ReturnType<typeof createChannelMemberRepo>
-
-export function createChannelMemberRepo(db: DatabaseSync) {
-  const selectOne = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? AND user_id = ?`)
-  const selectByChannel = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? ORDER BY joined_at ASC`)
-  const selectActiveByChannel = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? AND status = 'active' ORDER BY joined_at ASC`)
-  const selectByChannelStatus = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? AND status = ? ORDER BY joined_at ASC`)
-  const selectActiveByUser = db.prepare(`SELECT ${COLS} FROM channel_members WHERE user_id = ? AND status = 'active' ORDER BY joined_at ASC`)
-  const selectOwners = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? AND role = 'owner' AND status = 'active'`)
-
-  /**
-   * 幂等写入(加入/批准/回填共用):
-   * - 无行 → INSERT(status 缺省 active,generation=1)
-   * - 已有行 → UPDATE role/status/joined_at;若原 status 不是 active 则 generation+1
-   *   (退出/被移除后重新加入 = 新代数,旧 HITL 审批资格不恢复)。
-   */
-  const upsert = (input: ChannelMemberUpsertInput): ChannelMemberRow => {
-    const now = input.joinedAt ?? new Date().toISOString()
-    const role = input.role ?? 'member'
-    const status = input.status ?? 'active'
-    const existing = selectOne.get(input.channelId, input.userId) as unknown as ChannelMemberRow | undefined
-    if (!existing) {
-      db.prepare(
-        `INSERT INTO channel_members (channel_id, user_id, role, status, generation, joined_at, left_at)
-         VALUES (?, ?, ?, ?, 1, ?, ?)`,
-      ).run(input.channelId, input.userId, role, status, now, status === 'active' ? null : now)
-    }
-    else {
-      const bump = existing.status !== 'active' && status === 'active' ? 1 : 0
-      db.prepare(
-        `UPDATE channel_members SET role = ?, status = ?, generation = generation + ?, joined_at = ?, left_at = ? WHERE channel_id = ? AND user_id = ?`,
-      ).run(role, status, bump, now, status === 'active' ? null : now, input.channelId, input.userId)
-    }
-    return selectOne.get(input.channelId, input.userId) as unknown as ChannelMemberRow
-  }
-
-  return {
-    /** 幂等 upsert(见上);返回落库后的行 */
-    upsert,
-
-    /** 确保 owner 成员记录存在且为 active owner(创建/迁移/认领后调用) */
-    ensureOwner(channelId: string, userId: string): ChannelMemberRow {
-      return upsert({ channelId, userId, role: 'owner', status: 'active' })
-    },
-
-    findOne(channelId: string, userId: string): ChannelMemberRow | undefined {
-      return (selectOne.get(channelId, userId) as unknown as ChannelMemberRow | undefined) ?? undefined
-    },
-
-    /** 是否为 active 成员(owner 或 member 皆算) */
-    isActiveMember(channelId: string, userId: string): boolean {
-      const row = selectOne.get(channelId, userId) as unknown as ChannelMemberRow | undefined
-      return !!row && row.status === 'active'
-    },
-
-    /** 是否为 active owner */
-    isActiveOwner(channelId: string, userId: string): boolean {
-      const row = selectOne.get(channelId, userId) as unknown as ChannelMemberRow | undefined
-      return !!row && row.status === 'active' && row.role === 'owner'
-    },
-
-    listByChannel(channelId: string): ChannelMemberRow[] {
-      return selectByChannel.all(channelId) as unknown as ChannelMemberRow[]
-    },
-
-    listActiveByChannel(channelId: string): ChannelMemberRow[] {
-      return selectActiveByChannel.all(channelId) as unknown as ChannelMemberRow[]
-    },
-
-    listByChannelStatus(channelId: string, status: ChannelMemberStatus): ChannelMemberRow[] {
-      return selectByChannelStatus.all(channelId, status) as unknown as ChannelMemberRow[]
-    },
-
-    listActiveByUser(userId: string): ChannelMemberRow[] {
-      return selectActiveByUser.all(userId) as unknown as ChannelMemberRow[]
-    },
-
-    listActiveOwners(channelId: string): ChannelMemberRow[] {
-      return selectOwners.all(channelId) as unknown as ChannelMemberRow[]
-    },
-
-    /** 置为 left(本人退出)/ removed(owner 移除);未命中返回 false */
-    setStatus(channelId: string, userId: string, status: 'left' | 'removed'): boolean {
-      const now = new Date().toISOString()
-      return db.prepare(
-        `UPDATE channel_members SET status = ?, left_at = ? WHERE channel_id = ? AND user_id = ? AND status IN ('active', 'pending')`,
-      ).run(status, now, channelId, userId).changes > 0
-    },
-
-    /** owner 转移:旧 owner 降为 member,新 owner 升为 owner(同一事务由调用方保证) */
-    transferOwner(channelId: string, fromUserId: string, toUserId: string): void {
-      db.prepare(`UPDATE channel_members SET role = 'member' WHERE channel_id = ? AND user_id = ? AND role = 'owner'`).run(channelId, fromUserId)
-      upsert({ channelId, userId: toUserId, role: 'owner', status: 'active' })
-    },
-  }
-}
+/**
+ * ChannelMember 仓储 —— v17 群成员(channel_members)。
+ *
+ * 语义要点(主计划 §3.2 / §13.7):
+ * - user_id 是**全局用户系统**的 id(server/repositories/user.repository),
+ *   不是本库遗留 users 表;因此不做外键(跨库/跨语义)。
+ * - owner 必须有且只有一条 active owner 记录;owner 不允许 leave(服务层强制)。
+ * - 退出/移除 → status 置 left/removed;重新加入 → generation +1(旧审批资格不恢复)。
+ * - status: active(可读/发言/审批) | pending(owner_approve 待批) | left | removed
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import type { ChannelMemberRow } from './database'
+
+const COLS = 'channel_id AS channelId, user_id AS userId, role, status, generation, joined_at AS joinedAt, left_at AS leftAt'
+
+export type ChannelMemberStatus = 'active' | 'pending' | 'left' | 'removed'
+export type ChannelMemberRole = 'owner' | 'member'
+
+export interface ChannelMemberUpsertInput {
+  channelId: string
+  userId: string
+  role?: ChannelMemberRole
+  status?: ChannelMemberStatus
+  joinedAt?: string
+}
+
+export type ChannelMemberRepo = ReturnType<typeof createChannelMemberRepo>
+
+export function createChannelMemberRepo(db: DatabaseSync) {
+  const selectOne = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? AND user_id = ?`)
+  const selectByChannel = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? ORDER BY joined_at ASC`)
+  const selectActiveByChannel = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? AND status = 'active' ORDER BY joined_at ASC`)
+  const selectByChannelStatus = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? AND status = ? ORDER BY joined_at ASC`)
+  const selectActiveByUser = db.prepare(`SELECT ${COLS} FROM channel_members WHERE user_id = ? AND status = 'active' ORDER BY joined_at ASC`)
+  const selectOwners = db.prepare(`SELECT ${COLS} FROM channel_members WHERE channel_id = ? AND role = 'owner' AND status = 'active'`)
+
+  /**
+   * 幂等写入(加入/批准/回填共用):
+   * - 无行 → INSERT(status 缺省 active,generation=1)
+   * - 已有行 → UPDATE role/status/joined_at;若原 status 不是 active 则 generation+1
+   *   (退出/被移除后重新加入 = 新代数,旧 HITL 审批资格不恢复)。
+   */
+  const upsert = (input: ChannelMemberUpsertInput): ChannelMemberRow => {
+    const now = input.joinedAt ?? new Date().toISOString()
+    const role = input.role ?? 'member'
+    const status = input.status ?? 'active'
+    const existing = selectOne.get(input.channelId, input.userId) as unknown as ChannelMemberRow | undefined
+    if (!existing) {
+      db.prepare(
+        `INSERT INTO channel_members (channel_id, user_id, role, status, generation, joined_at, left_at)
+         VALUES (?, ?, ?, ?, 1, ?, ?)`,
+      ).run(input.channelId, input.userId, role, status, now, status === 'active' ? null : now)
+    }
+    else {
+      const bump = existing.status !== 'active' && status === 'active' ? 1 : 0
+      db.prepare(
+        `UPDATE channel_members SET role = ?, status = ?, generation = generation + ?, joined_at = ?, left_at = ? WHERE channel_id = ? AND user_id = ?`,
+      ).run(role, status, bump, now, status === 'active' ? null : now, input.channelId, input.userId)
+    }
+    return selectOne.get(input.channelId, input.userId) as unknown as ChannelMemberRow
+  }
+
+  return {
+    /** 幂等 upsert(见上);返回落库后的行 */
+    upsert,
+
+    /** 确保 owner 成员记录存在且为 active owner(创建/迁移/认领后调用) */
+    ensureOwner(channelId: string, userId: string): ChannelMemberRow {
+      return upsert({ channelId, userId, role: 'owner', status: 'active' })
+    },
+
+    findOne(channelId: string, userId: string): ChannelMemberRow | undefined {
+      return (selectOne.get(channelId, userId) as unknown as ChannelMemberRow | undefined) ?? undefined
+    },
+
+    /** 是否为 active 成员(owner 或 member 皆算) */
+    isActiveMember(channelId: string, userId: string): boolean {
+      const row = selectOne.get(channelId, userId) as unknown as ChannelMemberRow | undefined
+      return !!row && row.status === 'active'
+    },
+
+    /** 是否为 active owner */
+    isActiveOwner(channelId: string, userId: string): boolean {
+      const row = selectOne.get(channelId, userId) as unknown as ChannelMemberRow | undefined
+      return !!row && row.status === 'active' && row.role === 'owner'
+    },
+
+    listByChannel(channelId: string): ChannelMemberRow[] {
+      return selectByChannel.all(channelId) as unknown as ChannelMemberRow[]
+    },
+
+    listActiveByChannel(channelId: string): ChannelMemberRow[] {
+      return selectActiveByChannel.all(channelId) as unknown as ChannelMemberRow[]
+    },
+
+    listByChannelStatus(channelId: string, status: ChannelMemberStatus): ChannelMemberRow[] {
+      return selectByChannelStatus.all(channelId, status) as unknown as ChannelMemberRow[]
+    },
+
+    listActiveByUser(userId: string): ChannelMemberRow[] {
+      return selectActiveByUser.all(userId) as unknown as ChannelMemberRow[]
+    },
+
+    listActiveOwners(channelId: string): ChannelMemberRow[] {
+      return selectOwners.all(channelId) as unknown as ChannelMemberRow[]
+    },
+
+    /** 置为 left(本人退出)/ removed(owner 移除);未命中返回 false */
+    setStatus(channelId: string, userId: string, status: 'left' | 'removed'): boolean {
+      const now = new Date().toISOString()
+      return db.prepare(
+        `UPDATE channel_members SET status = ?, left_at = ? WHERE channel_id = ? AND user_id = ? AND status IN ('active', 'pending')`,
+      ).run(status, now, channelId, userId).changes > 0
+    },
+
+    /** owner 转移:旧 owner 降为 member,新 owner 升为 owner(同一事务由调用方保证) */
+    transferOwner(channelId: string, fromUserId: string, toUserId: string): void {
+      db.prepare(`UPDATE channel_members SET role = 'member' WHERE channel_id = ? AND user_id = ? AND role = 'owner'`).run(channelId, fromUserId)
+      upsert({ channelId, userId: toUserId, role: 'owner', status: 'active' })
+    },
+  }
+}

package/server/services/workshop/db/channel.repo.ts

@@ -1,203 +1,203 @@
-/**
- * Channel 仓储:channels 表 CRUD(含 workspace 工作目录、scenario_prompt 场景指令)。
- * 工厂接收 DatabaseSync(依赖注入),不持有任何单例。
- *
- * v17:新增群聊维度列(visibility / join_policy / approval_policy / chat_enabled / version)。
- * 迁移语义:既有行一律 private + owner_approve + owner_only + chat_enabled=0,
- * 即**不改变任何既有可见性/权限行为**;开启群聊必须由 owner 显式设置。
- */
-import { randomUUID } from 'node:crypto'
-import type { DatabaseSync } from 'node:sqlite'
-import type { ChannelRow } from './database'
-
-/** 查询列(蛇形列名 → 驼峰行字段) */
-const COLS = 'id, name, description, scenario_prompt AS scenarioPrompt, llm_json AS llmJson, lead_agent_id AS leadAgentId, workspace, enabled, owner_user_id AS ownerUserId, visibility, join_policy AS joinPolicy, approval_policy AS approvalPolicy, chat_enabled AS chatEnabled, version, line_id AS lineId, created_at AS createdAt, updated_at AS updatedAt'
-
-export interface ChannelCreateInput {
-  name: string
-  description?: string
-  /** channel 级作业场景 prompt(注入全部成员 harness) */
-  scenarioPrompt?: string
-  workspace?: string
-  /** 归属用户(null = 遗留公共) */
-  ownerUserId?: string | null
-  /** v17 可见性(缺省 private) */
-  visibility?: string
-  /** v17 加入策略(缺省 owner_approve) */
-  joinPolicy?: string
-  /** v17 HITL 审批策略(缺省 owner_only) */
-  approvalPolicy?: string
-  /** v17 群聊开关(缺省 0 = 未开启) */
-  chatEnabled?: number
-}
-
-export interface ChannelPatch {
-  name?: string
-  description?: string
-  scenarioPrompt?: string
-  leadAgentId?: string | null
-  workspace?: string
-  enabled?: number
-  /** channel 级默认 LLM(v11;null=清除);成员 config 未显式指定 model/provider 时注入 */
-  llm?: { provider?: string, model?: string, effort?: string } | null
-  /** v17 群聊维度 */
-  visibility?: string
-  joinPolicy?: string
-  approvalPolicy?: string
-  chatEnabled?: number
-  /** v17 遗留 Channel 显式认领(admin 专用路径;置 null 需显式传 null) */
-  ownerUserId?: string | null
-}
-
-export type ChannelRepo = ReturnType<typeof createChannelRepo>
-
-export function createChannelRepo(db: DatabaseSync) {
-  const insert = db.prepare(
-    `INSERT INTO channels (id, name, description, scenario_prompt, lead_agent_id, workspace, enabled, owner_user_id, visibility, join_policy, approval_policy, chat_enabled, version, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-  )
-  const selectAll = db.prepare(`SELECT ${COLS} FROM channels ORDER BY createdAt ASC`)
-  const selectByOwner = db.prepare(`SELECT ${COLS} FROM channels WHERE owner_user_id = ? OR owner_user_id IS NULL ORDER BY createdAt ASC`)
-  const selectById = db.prepare(`SELECT ${COLS} FROM channels WHERE id = ?`)
-  /** 群聊/成员可见的解析入口:owner 或 active 成员(member/owner) */
-  const selectVisibleToUser = db.prepare(
-    `SELECT ${COLS} FROM channels c
-     WHERE c.owner_user_id = ?
-        OR EXISTS (SELECT 1 FROM channel_members m
-                   WHERE m.channel_id = c.id AND m.user_id = ? AND m.status = 'active')
-     ORDER BY c.created_at ASC`,
-  )
-  /** 公开可发现:*仅* 已开启群聊的 public Channel(不含 owner=NULL 遗留行) */
-  const selectDiscoverable = db.prepare(
-    `SELECT ${COLS} FROM channels
-     WHERE visibility = 'public' AND chat_enabled = 1 AND owner_user_id IS NOT NULL
-     ORDER BY created_at ASC`,
-  )
-  const updateStmt = db.prepare(
-    `UPDATE channels SET name = ?, description = ?, scenario_prompt = ?, llm_json = ?, lead_agent_id = ?, workspace = ?, enabled = ?, owner_user_id = ?, visibility = ?, join_policy = ?, approval_policy = ?, chat_enabled = ?, version = ?, updated_at = ? WHERE id = ?`,
-  )
-  const removeStmt = db.prepare(`DELETE FROM channels WHERE id = ?`)
-
-  return {
-    /** 创建 channel(description/scenarioPrompt 缺省空串,enabled=1,leadAgentId=null,workspace=空串) */
-    create(input: ChannelCreateInput): ChannelRow {
-      const now = new Date().toISOString()
-      const row: ChannelRow = {
-        id: randomUUID(),
-        name: input.name,
-        description: input.description ?? '',
-        scenarioPrompt: input.scenarioPrompt ?? '',
-        // INSERT 不含该列 → 落库取列默认(llm_json TEXT NOT NULL DEFAULT '',见 database.ts v11);
-        // 返回的内存行按同一事实补该列,使 create() 的返回值与随后 findById() 读到的行形状一致。
-        llmJson: '',
-        leadAgentId: null,
-        workspace: input.workspace ?? '',
-        enabled: 1,
-        ownerUserId: input.ownerUserId ?? null,
-        visibility: input.visibility ?? 'private',
-        joinPolicy: input.joinPolicy ?? 'owner_approve',
-        approvalPolicy: input.approvalPolicy ?? 'owner_only',
-        chatEnabled: input.chatEnabled ?? 0,
-        version: 1,
-        lineId: '',
-        createdAt: now,
-        updatedAt: now,
-      }
-      insert.run(
-        row.id, row.name, row.description, row.scenarioPrompt, row.leadAgentId, row.workspace, row.enabled, row.ownerUserId,
-        row.visibility, row.joinPolicy, row.approvalPolicy, row.chatEnabled, row.version, row.createdAt, row.updatedAt,
-      )
-      return row
-    },
-
-    list(): ChannelRow[] {
-      return selectAll.all() as unknown as ChannelRow[]
-    },
-
-    /** 按 owner 过滤(含 NULL 遗留公共行;用户视角列表) */
-    listForOwner(ownerUserId: string): ChannelRow[] {
-      return selectByOwner.all(ownerUserId) as unknown as ChannelRow[]
-    },
-
-    /**
-     * v17:用户可见 Channel = 本人 owner 的 + 本人 active 成员的 + 公开可发现的。
-     * 这是**读取**视角;写/管理仍必须走 requireChannelOwner。
-     */
-    listVisibleToUser(userId: string): ChannelRow[] {
-      const owned = selectVisibleToUser.all(userId, userId) as unknown as ChannelRow[]
-      const seen = new Set(owned.map(c => c.id))
-      const extra: ChannelRow[] = []
-      for (const c of selectDiscoverable.all() as unknown as ChannelRow[]) {
-        if (!seen.has(c.id)) {
-          seen.add(c.id)
-          extra.push(c)
-        }
-      }
-      return [...owned, ...extra]
-    },
-
-    /** v17:公开可发现清单(已开启群聊的 public Channel) */
-    listDiscoverable(): ChannelRow[] {
-      return selectDiscoverable.all() as unknown as ChannelRow[]
-    },
-
-    findById(id: string): ChannelRow | undefined {
-      return selectById.get(id) as unknown as ChannelRow | undefined
-    },
-
-    /**
-     * 局部更新;未命中返回 undefined。
-     * v17:非群聊字段变更不动 version;群聊维度(visibility/joinPolicy/approvalPolicy/chatEnabled)
-     * 任一变化 → version +1(供 PATCH 乐观锁)。
-     */
-    update(id: string, patch: ChannelPatch): ChannelRow | undefined {
-      const current = selectById.get(id) as unknown as ChannelRow | undefined
-      if (!current) return undefined
-      const nextVisibility = patch.visibility ?? current.visibility
-      const nextJoin = patch.joinPolicy ?? current.joinPolicy
-      const nextApproval = patch.approvalPolicy ?? current.approvalPolicy
-      const nextChatEnabled = patch.chatEnabled ?? current.chatEnabled
-      const groupChatChanged
-        = nextVisibility !== current.visibility
-          || nextJoin !== current.joinPolicy
-          || nextApproval !== current.approvalPolicy
-          || nextChatEnabled !== current.chatEnabled
-      const next: ChannelRow = {
-        ...current,
-        name: patch.name ?? current.name,
-        description: patch.description ?? current.description,
-        scenarioPrompt: patch.scenarioPrompt ?? current.scenarioPrompt,
-        llmJson: patch.llm !== undefined ? JSON.stringify(patch.llm) : current.llmJson,
-        leadAgentId: patch.leadAgentId !== undefined ? patch.leadAgentId : current.leadAgentId,
-        workspace: patch.workspace ?? current.workspace,
-        enabled: patch.enabled ?? current.enabled,
-        ownerUserId: patch.ownerUserId !== undefined ? patch.ownerUserId : current.ownerUserId,
-        visibility: nextVisibility,
-        joinPolicy: nextJoin,
-        approvalPolicy: nextApproval,
-        chatEnabled: nextChatEnabled,
-        version: current.version + (groupChatChanged ? 1 : 0),
-        updatedAt: new Date().toISOString(),
-      }
-      updateStmt.run(
-        next.name, next.description, next.scenarioPrompt, next.llmJson, next.leadAgentId, next.workspace, next.enabled,
-        next.ownerUserId, next.visibility, next.joinPolicy, next.approvalPolicy, next.chatEnabled, next.version,
-        next.updatedAt, id,
-      )
-      return next
-    },
-
-    remove(id: string): void {
-      removeStmt.run(id)
-    },
-
-    /** v18:绑定/解绑产线(lineId=''=解绑)。只读扩权面:成员可读该线日志/配方/历史/状态;写仍走节点授权。 */
-    setLine(id: string, lineId: string): ChannelRow | undefined {
-      const current = selectById.get(id) as unknown as ChannelRow | undefined
-      if (!current) return undefined
-      db.prepare('UPDATE channels SET line_id = ?, updated_at = ? WHERE id = ?')
-        .run(lineId, new Date().toISOString(), id)
-      return { ...current, lineId, updatedAt: new Date().toISOString() }
-    },
-  }
-}
+/**
+ * Channel 仓储:channels 表 CRUD(含 workspace 工作目录、scenario_prompt 场景指令)。
+ * 工厂接收 DatabaseSync(依赖注入),不持有任何单例。
+ *
+ * v17:新增群聊维度列(visibility / join_policy / approval_policy / chat_enabled / version)。
+ * 迁移语义:既有行一律 private + owner_approve + owner_only + chat_enabled=0,
+ * 即**不改变任何既有可见性/权限行为**;开启群聊必须由 owner 显式设置。
+ */
+import { randomUUID } from 'node:crypto'
+import type { DatabaseSync } from 'node:sqlite'
+import type { ChannelRow } from './database'
+
+/** 查询列(蛇形列名 → 驼峰行字段) */
+const COLS = 'id, name, description, scenario_prompt AS scenarioPrompt, llm_json AS llmJson, lead_agent_id AS leadAgentId, workspace, enabled, owner_user_id AS ownerUserId, visibility, join_policy AS joinPolicy, approval_policy AS approvalPolicy, chat_enabled AS chatEnabled, version, line_id AS lineId, created_at AS createdAt, updated_at AS updatedAt'
+
+export interface ChannelCreateInput {
+  name: string
+  description?: string
+  /** channel 级作业场景 prompt(注入全部成员 harness) */
+  scenarioPrompt?: string
+  workspace?: string
+  /** 归属用户(null = 遗留公共) */
+  ownerUserId?: string | null
+  /** v17 可见性(缺省 private) */
+  visibility?: string
+  /** v17 加入策略(缺省 owner_approve) */
+  joinPolicy?: string
+  /** v17 HITL 审批策略(缺省 owner_only) */
+  approvalPolicy?: string
+  /** v17 群聊开关(缺省 0 = 未开启) */
+  chatEnabled?: number
+}
+
+export interface ChannelPatch {
+  name?: string
+  description?: string
+  scenarioPrompt?: string
+  leadAgentId?: string | null
+  workspace?: string
+  enabled?: number
+  /** channel 级默认 LLM(v11;null=清除);成员 config 未显式指定 model/provider 时注入 */
+  llm?: { provider?: string, model?: string, effort?: string } | null
+  /** v17 群聊维度 */
+  visibility?: string
+  joinPolicy?: string
+  approvalPolicy?: string
+  chatEnabled?: number
+  /** v17 遗留 Channel 显式认领(admin 专用路径;置 null 需显式传 null) */
+  ownerUserId?: string | null
+}
+
+export type ChannelRepo = ReturnType<typeof createChannelRepo>
+
+export function createChannelRepo(db: DatabaseSync) {
+  const insert = db.prepare(
+    `INSERT INTO channels (id, name, description, scenario_prompt, lead_agent_id, workspace, enabled, owner_user_id, visibility, join_policy, approval_policy, chat_enabled, version, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+  )
+  const selectAll = db.prepare(`SELECT ${COLS} FROM channels ORDER BY createdAt ASC`)
+  const selectByOwner = db.prepare(`SELECT ${COLS} FROM channels WHERE owner_user_id = ? OR owner_user_id IS NULL ORDER BY createdAt ASC`)
+  const selectById = db.prepare(`SELECT ${COLS} FROM channels WHERE id = ?`)
+  /** 群聊/成员可见的解析入口:owner 或 active 成员(member/owner) */
+  const selectVisibleToUser = db.prepare(
+    `SELECT ${COLS} FROM channels c
+     WHERE c.owner_user_id = ?
+        OR EXISTS (SELECT 1 FROM channel_members m
+                   WHERE m.channel_id = c.id AND m.user_id = ? AND m.status = 'active')
+     ORDER BY c.created_at ASC`,
+  )
+  /** 公开可发现:*仅* 已开启群聊的 public Channel(不含 owner=NULL 遗留行) */
+  const selectDiscoverable = db.prepare(
+    `SELECT ${COLS} FROM channels
+     WHERE visibility = 'public' AND chat_enabled = 1 AND owner_user_id IS NOT NULL
+     ORDER BY created_at ASC`,
+  )
+  const updateStmt = db.prepare(
+    `UPDATE channels SET name = ?, description = ?, scenario_prompt = ?, llm_json = ?, lead_agent_id = ?, workspace = ?, enabled = ?, owner_user_id = ?, visibility = ?, join_policy = ?, approval_policy = ?, chat_enabled = ?, version = ?, updated_at = ? WHERE id = ?`,
+  )
+  const removeStmt = db.prepare(`DELETE FROM channels WHERE id = ?`)
+
+  return {
+    /** 创建 channel(description/scenarioPrompt 缺省空串,enabled=1,leadAgentId=null,workspace=空串) */
+    create(input: ChannelCreateInput): ChannelRow {
+      const now = new Date().toISOString()
+      const row: ChannelRow = {
+        id: randomUUID(),
+        name: input.name,
+        description: input.description ?? '',
+        scenarioPrompt: input.scenarioPrompt ?? '',
+        // INSERT 不含该列 → 落库取列默认(llm_json TEXT NOT NULL DEFAULT '',见 database.ts v11);
+        // 返回的内存行按同一事实补该列,使 create() 的返回值与随后 findById() 读到的行形状一致。
+        llmJson: '',
+        leadAgentId: null,
+        workspace: input.workspace ?? '',
+        enabled: 1,
+        ownerUserId: input.ownerUserId ?? null,
+        visibility: input.visibility ?? 'private',
+        joinPolicy: input.joinPolicy ?? 'owner_approve',
+        approvalPolicy: input.approvalPolicy ?? 'owner_only',
+        chatEnabled: input.chatEnabled ?? 0,
+        version: 1,
+        lineId: '',
+        createdAt: now,
+        updatedAt: now,
+      }
+      insert.run(
+        row.id, row.name, row.description, row.scenarioPrompt, row.leadAgentId, row.workspace, row.enabled, row.ownerUserId,
+        row.visibility, row.joinPolicy, row.approvalPolicy, row.chatEnabled, row.version, row.createdAt, row.updatedAt,
+      )
+      return row
+    },
+
+    list(): ChannelRow[] {
+      return selectAll.all() as unknown as ChannelRow[]
+    },
+
+    /** 按 owner 过滤(含 NULL 遗留公共行;用户视角列表) */
+    listForOwner(ownerUserId: string): ChannelRow[] {
+      return selectByOwner.all(ownerUserId) as unknown as ChannelRow[]
+    },
+
+    /**
+     * v17:用户可见 Channel = 本人 owner 的 + 本人 active 成员的 + 公开可发现的。
+     * 这是**读取**视角;写/管理仍必须走 requireChannelOwner。
+     */
+    listVisibleToUser(userId: string): ChannelRow[] {
+      const owned = selectVisibleToUser.all(userId, userId) as unknown as ChannelRow[]
+      const seen = new Set(owned.map(c => c.id))
+      const extra: ChannelRow[] = []
+      for (const c of selectDiscoverable.all() as unknown as ChannelRow[]) {
+        if (!seen.has(c.id)) {
+          seen.add(c.id)
+          extra.push(c)
+        }
+      }
+      return [...owned, ...extra]
+    },
+
+    /** v17:公开可发现清单(已开启群聊的 public Channel) */
+    listDiscoverable(): ChannelRow[] {
+      return selectDiscoverable.all() as unknown as ChannelRow[]
+    },
+
+    findById(id: string): ChannelRow | undefined {
+      return selectById.get(id) as unknown as ChannelRow | undefined
+    },
+
+    /**
+     * 局部更新;未命中返回 undefined。
+     * v17:非群聊字段变更不动 version;群聊维度(visibility/joinPolicy/approvalPolicy/chatEnabled)
+     * 任一变化 → version +1(供 PATCH 乐观锁)。
+     */
+    update(id: string, patch: ChannelPatch): ChannelRow | undefined {
+      const current = selectById.get(id) as unknown as ChannelRow | undefined
+      if (!current) return undefined
+      const nextVisibility = patch.visibility ?? current.visibility
+      const nextJoin = patch.joinPolicy ?? current.joinPolicy
+      const nextApproval = patch.approvalPolicy ?? current.approvalPolicy
+      const nextChatEnabled = patch.chatEnabled ?? current.chatEnabled
+      const groupChatChanged
+        = nextVisibility !== current.visibility
+          || nextJoin !== current.joinPolicy
+          || nextApproval !== current.approvalPolicy
+          || nextChatEnabled !== current.chatEnabled
+      const next: ChannelRow = {
+        ...current,
+        name: patch.name ?? current.name,
+        description: patch.description ?? current.description,
+        scenarioPrompt: patch.scenarioPrompt ?? current.scenarioPrompt,
+        llmJson: patch.llm !== undefined ? JSON.stringify(patch.llm) : current.llmJson,
+        leadAgentId: patch.leadAgentId !== undefined ? patch.leadAgentId : current.leadAgentId,
+        workspace: patch.workspace ?? current.workspace,
+        enabled: patch.enabled ?? current.enabled,
+        ownerUserId: patch.ownerUserId !== undefined ? patch.ownerUserId : current.ownerUserId,
+        visibility: nextVisibility,
+        joinPolicy: nextJoin,
+        approvalPolicy: nextApproval,
+        chatEnabled: nextChatEnabled,
+        version: current.version + (groupChatChanged ? 1 : 0),
+        updatedAt: new Date().toISOString(),
+      }
+      updateStmt.run(
+        next.name, next.description, next.scenarioPrompt, next.llmJson, next.leadAgentId, next.workspace, next.enabled,
+        next.ownerUserId, next.visibility, next.joinPolicy, next.approvalPolicy, next.chatEnabled, next.version,
+        next.updatedAt, id,
+      )
+      return next
+    },
+
+    remove(id: string): void {
+      removeStmt.run(id)
+    },
+
+    /** v18:绑定/解绑产线(lineId=''=解绑)。只读扩权面:成员可读该线日志/配方/历史/状态;写仍走节点授权。 */
+    setLine(id: string, lineId: string): ChannelRow | undefined {
+      const current = selectById.get(id) as unknown as ChannelRow | undefined
+      if (!current) return undefined
+      db.prepare('UPDATE channels SET line_id = ?, updated_at = ? WHERE id = ?')
+        .run(lineId, new Date().toISOString(), id)
+      return { ...current, lineId, updatedAt: new Date().toISOString() }
+    },
+  }
+}