fix(sqlite): scan json text columns safely

Author: ZaneL1u

.planning/STATE.md

@@ -4,8 +4,8 @@ milestone: v4.2.0
 milestone_name: 容器合并 · SQLite 迁移 · 配置统一
 status: Awaiting next milestone
 stopped_at: Phase 58 context gathered
-last_updated: "2026-07-08T18:47:40+08:00"
-last_activity: 2026-07-08 — Completed quick task 260708-q1b: 降低 VNC 与 Chromium 默认资源占用
+last_updated: "2026-07-09T15:02:05+08:00"
+last_activity: 2026-07-09 — Completed quick task 260709-kqq: 修复 SQLite JSON TEXT 扫描失败
 progress:
   total_phases: 5
   completed_phases: 1
@@ -28,7 +28,7 @@ See: .planning/PROJECT.md (updated 2026-05-14)
 Phase: Milestone v4.2.0 complete
 Plan: —
 Status: Awaiting next milestone
-Last activity: 2026-07-08 — Completed quick task 260708-q1b: 降低 VNC 与 Chromium 默认资源占用
+Last activity: 2026-07-09 — Completed quick task 260709-kqq: 修复 SQLite JSON TEXT 扫描失败
 
 ## Accumulated Context
 
@@ -81,6 +81,7 @@ v3.6 关键技术决策（已落地，可作为后续里程碑参考）：
 | 260602 | 规则导入导出按钮 | 2026-06-02 | pending | [260602-rules-import-export](./quick/260602-rules-import-export/) |
 | 260707-qw2 | VNC 状态展示、启动重启控制、容器内自动拉起与 Chromium 窗口适配 | 2026-07-07 | pending | [260707-qw2-vnc-chromium](./quick/260707-qw2-vnc-chromium/) |
 | 260708-q1b | 降低 VNC 与 Chromium 默认资源占用 | 2026-07-08 | pending | [260708-q1b-vnc-chromium-vnc](./quick/260708-q1b-vnc-chromium-vnc/) |
+| 260709-kqq | 修复 SQLite JSON TEXT 扫描失败 | 2026-07-09 | pending | [260709-kqq-bypass-preset-rules-sqlite](./quick/260709-kqq-bypass-preset-rules-sqlite/) |
 
 ### Roadmap Evolution
 

.planning/quick/260709-kqq-bypass-preset-rules-sqlite/260709-kqq-PLAN.md

@@ -0,0 +1,13 @@
+# Quick Task 260709-kqq: 修复 bypass preset rules SQLite 扫描失败
+
+## Goal
+
+修复生产环境 `list bypass presets failed` 反复报错，原因是 SQLite `TEXT` JSON 列不能直接扫描到 `json.RawMessage`。
+
+## Tasks
+
+1. 用真实 SQLite migration 写回归测试，复现 `host_bypass_presets.rules` 扫描失败。
+2. 梳理同类 JSON TEXT 字段，避免只修 `rules` 单点。
+3. 增加通用 JSON 文本扫描 helper，并更新 bypass preset / snapshot / audit log 扫描路径。
+4. 跑 repository 相关测试和格式检查。
+5. 说明这类错误与 managed CPU、VNC/SSH 不可连接之间的可能关系与部署动作。

.planning/quick/260709-kqq-bypass-preset-rules-sqlite/260709-kqq-SUMMARY.md

@@ -0,0 +1,36 @@
+---
+status: complete
+phase: quick-260709-kqq
+subsystem: sqlite, repository, bypass, runtime
+tags: [sqlite, json, bypass, egress, host-lifecycle]
+---
+
+# Quick Task 260709-kqq: 修复 bypass preset rules SQLite 扫描失败 Summary
+
+## 结果
+
+- 修复 SQLite `TEXT` JSON 列直接扫描到 `json.RawMessage` 失败的问题。
+- 新增 `jsonText` 扫描 helper，支持 `string`、`[]byte`、`NULL` 三种 SQLite 返回形态。
+- `host_bypass_presets.rules`、bypass snapshot JSON、bypass audit log JSON 改为先扫描到 `jsonText`。
+- `hosts.host_mounts` 与 `egress_ips.proxy_config` 的读取路径也改为 `jsonText`，避免主机详情、VNC/SSH 控制、`prepare_host` 读取出口配置时踩同类问题。
+- 新增真实 SQLite migration 回归测试，覆盖 bypass preset、host mounts、egress proxy config 与 `GetEgressIPByHost`。
+
+## 根因
+
+`database/sql` 不能把驱动返回的 `string` 直接写入 `*json.RawMessage`，线上错误：
+
+`unsupported Scan, storing driver.Value type string into type *json.RawMessage`
+
+对应字段是 SQLite `TEXT` JSON 列，不是 Go 原生 JSON 类型。
+
+## 验证
+
+- `go test ./internal/store/repository -run 'Test(BypassRepository_ListPresetsScansSQLiteTextRules|Repository_ScansSQLiteTextJSONForHostAndEgress)' -count=1` 通过。
+- `go test ./internal/store/repository -count=1` 通过。
+- `go test ./internal/runtime/tasks -count=1` 通过。
+- `go test ./internal/controlplane/http -count=1` 通过。
+- `go test ./... -count=1` 通过。
+
+## 说明
+
+这会停止 `/v1/admin/bypass/presets` 反复 500 与日志刷屏。由于 `prepare_host` 会读取 `egress_ips.proxy_config`，同类扫描失败也可能导致主机准备失败，进而表现为 VNC 和 SSH 都连不上。修复部署后，已有失败任务需要重新触发主机 prepare/start/rebuild。

internal/store/repository/json_scan.go

@@ -0,0 +1,36 @@
+package repository
+
+import (
+	"encoding/json"
+	"fmt"
+)
+
+// jsonText scans SQLite TEXT/NULL JSON columns into bytes before callers decode
+// them into typed fields. database/sql cannot scan a driver string directly into
+// json.RawMessage because RawMessage is a named []byte type.
+type jsonText []byte
+
+func (j *jsonText) Scan(value any) error {
+	switch v := value.(type) {
+	case nil:
+		*j = nil
+		return nil
+	case string:
+		*j = append((*j)[:0], v...)
+		return nil
+	case []byte:
+		*j = append((*j)[:0], v...)
+		return nil
+	default:
+		return fmt.Errorf("unsupported JSON text source type %T", value)
+	}
+}
+
+func (j jsonText) RawMessage() json.RawMessage {
+	if len(j) == 0 {
+		return nil
+	}
+	out := make([]byte, len(j))
+	copy(out, j)
+	return json.RawMessage(out)
+}