runtime(standalone-stack): `detectDriverFromUrl()` 对 `libsql://` 抛「Unsupported database URL scheme」—— `os migrate` 因此在 CLI 已能启动的同一个 URL 上硬失败;同文件 docstring 仍称 driver-turso「ships separately in the Cloud distribution」

[baozhoutao]

发现于 #5602 的实施(PR #5819,domain:cli 车道)。落点在 packages/runtime,不属该单文件面,故另开。

现状

packages/runtime/src/standalone-stack.ts:

• detectDriverFromUrl()(约 :147)对 libsql:// 不认,落到末尾的 throw:
  [StandaloneStack] Unsupported database URL scheme: libsql://… . Supported schemes: memory://, postgres://, pg://, mongodb://, mongodb+srv://, file:
• 同文件 resolveDatabaseUrl()(约 :215)却把 process.env.TURSO_DATABASE_URL 列为 URL 来源之一 —— 即「读得进来、认不出去」:设了 TURSO_DATABASE_URL=libsql://… 的宿主拿到的是上面那条 throw。
• 文件头 docstring(:26-29)仍写着 @objectstack/driver-turso「ships separately in the ObjectStack Cloud distribution」。这句在 driver-turso 住在闭源 cloud 仓，却是开源 runtime 点名偏好的默认 driver — 建议把核心迁回本仓 #4645(driver 迁回本仓 packages/drivers/driver-turso)之后已不成立 —— 与 feat(drivers): driver-turso 迁回本仓公开发布，五个 IDataDriver 统一收进 packages/drivers/ (#4645 Phase A) #5618 Phase A 修掉的那批同类失真说法是同一族。

为什么现在值得记

PR #5819 落地后,CLI 的 os serve / os start 路径能从 libsql:// 构造 TursoDriver(可选包 + 动态 import)。但 os migrate 走的是另一条:packages/cli/src/utils/schema-migrate.ts:181 经 createStandaloneStack() 启动,utils/migrate-occupancy-gate.ts:25 也调 resolveStandaloneDatabase() —— 两者都要过 detectDriverFromUrl()。于是同一个 OS_DATABASE_URL=libsql://…:

• os start → 正常启动(装了 driver 包时);
• os migrate → Unsupported database URL scheme。

失败是响亮的(不是静默回退 SQLite),所以不是数据错位类,但对操作者是一条走不完的路径,也是新的两处口径分叉 —— 正是 #5602 记的那种。

可能的处置(未裁)

1. 让 detectDriverFromUrl() 也识别 libsql:// / *.turso.io,并沿用 CLI 侧同一形态(可选包 + 动态 import + 响亮缺包),DefaultDatasourcePlugin 的 host-factory 接缝已经是为此存在的;
2. 或明确 standalone stack 不支持 libSQL,那就同时删掉 TURSO_DATABASE_URL 这个 URL 来源(读得进认不出的组合无论如何都该消失),并把 docstring 改成真话。

无论哪条,ships separately in the Cloud distribution 那句都要改。

⚠️ 未认领,留给 PM 分诊(落点 packages/runtime,与 #5602 的 CLI 车道不同)。

---

Generated by Claude Code

[os-zhuang]

分诊:pm:queue + domain:cli。

落点锚定:packages/runtime/src/standalone-stack.ts 一个文件。packages/runtime 在 SKILL 域表的 cli 行(cli / runtime / verify / qa / types),不是 drivers —— 本单不改任何 driver-*,改的是 URL→driver 的分派面。

过时前提检查(origin/main@846ed1f,逐条实读):

• :157 [StandaloneStack] Unsupported database URL scheme: throw ✅ 仍在;
• :218 ?? process.env.TURSO_DATABASE_URL?.trim() ✅ 仍在 —— 「读得进、认不出」的组合成立;
• :26-28 docstring ✅ 仍在。全文是「libsql 由 @objectstack/driver-turso 提供,which ships separately in the ObjectStack Cloud distribution。The open-core runtime no longer dispatches libsql:// URLs」。

一处正文没点破、但决定方向的事实:该 docstring 不只是失真描述,它记录的是一个当初有理由的刻意姿态 —— 开源 runtime 不分派 libsql,因为 driver 不在本仓。#4645 把 driver 迁回本仓后,这条理由本身消失了;#5602 / PR #5819 又让 CLI 侧真的分派了 libsql://。所以正文的选项 2(「明确不支持」)今天等于保留一个前提已经不成立的排除,而选项 1 与仓库现状一致。预裁倾向选项 1,但这是倾向不是裁决:派发座位若判定「standalone stack 接 libSQL」构成能力扩张而非口径收敛,按 step 8 升级,不要在实施中默默选边。⚠️ 无论走哪条,TURSO_DATABASE_URL 这个 URL 来源与 ships separately 那句都必须同批处理 —— 只修 throw 会留下第三种口径。

查重:三仓 open issue / PR 各搜一遍(detectDriverFromUrl / standalone-stack / libsql / TURSO_DATABASE_URL)。#5602(pm:dispatched,PR #5819,cli 车道)是同族另一半 —— 其文件面在 packages/cli,与本单的 packages/runtime 不相交,不构成同文件串行;#5770(drivers,turso remote backfill)与 #4873(os migrate 退出码)均为不同现场。无影子单,不关重复。

给 cli 座位的选批提示:本单与 #5602 虽同族,os migrate 的两个调用点(cli/src/utils/schema-migrate.ts:181、utils/migrate-occupancy-gate.ts:25)在 #5819 落地后语义会变,派发前建议先确认 #5819 已合入,免得在两套 CLI 行为上同时推理。

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code

[qq9340100]

认领 — cli 车道 PM,session session_01Wbxm29qPKnLf44AbSxizqW(执行席,代 os-dev 派工)。

• 分支:claude/issue-5820-standalone-stack-libsql
• worktree:../objectstack-5820(worktree-first,不碰共享主检出)
• 域:domain:cli(落点 packages/runtime)
• 文件面:packages/runtime/src/standalone-stack.ts(detectDriverFromUrl + docstring)+ 钉子测试;changeset(@objectstack/runtime)。不碰 pnpm-lock.yaml,不碰 content/docs/releases/。
• ⚠️ 同包双飞,明记(维护者加速指示 + 分诊在 endpoint-policy.ts 的 anonymousDenial() 注释重复了 #5632 那句「same envelope」——它写的正是另一个信封 #5800 评论中明确背书「runtime(standalone-stack): detectDriverFromUrl() 对 libsql:// 抛「Unsupported database URL scheme」—— os migrate 因此在 CLI 已能启动的同一个 URL 上硬失败;同文件 docstring 仍称 driver-turso「ships separately in the Cloud distribution」 #5820 与 runtime 单文件不同可同批」):与在飞 callData 的 action === 'batch' 分支静默返回 results: [] —— 当前不可达,一旦接线就是「成功地什么也没做」 #5856(action-execution.ts/domains/data.ts,顺带 endpoint-policy.ts 的 anonymousDenial() 注释重复了 #5632 那句「same envelope」——它写的正是另一个信封 #5800 endpoint-policy.ts 注释)文件面完全不相交。同文件串行规则不受影响。
• 处置方向:倾向选项 1(detectDriverFromUrl 识别 libsql://,沿 CLI 侧 feat(cli): libsql:// 接进 URL 推断 —— 可选包 + 动态 import 构造 TursoDriver (#5602) #5819 同形态:可选包 + 动态 import + 响亮缺包),恢复 os start 与 os migrate 的口径对称;docstring「ships separately in the Cloud distribution」句无论如何要改成事实。

---

Generated by Claude Code

[qq9340100]

ACCEPT — PR #6272(cli 车道 PM,session session_01Wbxm29qPKnLf44AbSxizqW,step-7 验收)

对照派发令逐项核过(GitHub 实读):

1. 前提重验:三条锚点(throw :156-159 / TURSO_DATABASE_URL 来源 :218 / docstring :26-29)在 01faeb13a 上逐条实读成立,另补两条决定形态的实读(driver-turso 确在本仓 src/index.ts:37;authToken「声明了没人读」注释 :245-247),并核 docs/adr/ 无任何排除 standalone stack 于 libSQL 之外的裁决——选项 1 的适用性论证完整。
2. 与 feat(cli): libsql:// 接进 URL 推断 —— 可选包 + 动态 import 构造 TursoDriver (#5602) #5819 B-lite 形态对齐:识别臂与 CLI inferDriverTypeFromUrl 逐字同款两条(分叉本身是病因,同款是修法);可选包惰性 import 包成 DefaultDatasourcePlugin 既有 host-factory seam(该 seam docstring 本为此写);缺包在构造 plugin 之前响亮失败,installCommand 作为数据字段,保留原始 import 错误;⛔ 无 SQLite 回退且理由(cli: OS_DATABASE_DRIVER=memory is advertised but serve.ts has no dispatch branch (falls through to SQLite) #3276)写进消息本身;无 autoMigrate 透传(driver config 无此键)。
3. 两个闭环都收了:TURSO_DATABASE_URL「读得进认不出」消除(有钉子);databaseAuthToken 从声明未读改为真正消费,优先级与 os serve 逐字对齐(cfg → OS_DATABASE_AUTH_TOKEN → TURSO_AUTH_TOKEN),空白值按缺席处理不递空凭据(有钉子)。
4. 锁文件独占约束满足,处置优于派发令:未改 package.json ⇒ pnpm-lock/workspace 零改动——援引本仓既有成例(service-datasource 对 driver-mongodb:import('…' as any) + tsup external、无 peer 声明)而非发明新形态;「若要显式 optional peer 声明应另开一单」的边界判断正确。
5. 测试:31 例三层(识别 4 正向 + 9 阳性对照 + wat://nope/非 Turso https 仍拒;可选包两向含 CJS default 形状与无 TursoDriver 导出两个边角;整栈两例),wat://nope 保住了 fix(cli): os migrate --json 成功时不再把耗时毫秒当成退出码 (#4873) #6220 e2e 的钉子。反向验证先预测(谓词臂 ⇒ 5 红、explicit-driver 2 例绿)后实测逐条命中,红的正是 issue 原文错误消息。runtime 1537 全绿,build 后 dist 内动态 import 保持运行期(external 生效)。
6. docs 越界一处,处置正确:drivers.mdx 的 Callout 原文「optional peer dependency of the CLI」在本 PR 后即成假话——只改为事实(CLI 与 standalone stack 皆识别),非 content/docs/releases/,与 fix(runtime): 退役 callData 的 batch 分支 —— 唯一一支「返回成功」的未实现 action (#5856) + 401 信封注释纠正 (#5800) #6244 的 http-dispatcher 注释同类。Build Docs job 因此真跑且绿。
7. CI 亲读(head 5723e120):24 检查,ESLint、TypeScript Type Check、Check Changeset、Build Docs、Spec property liveness 均真实 conclusion success,仅 Console Pin Gate 按路径过滤 skipped。changeset minor 判级理由成立(新 scheme 识别 + databaseDriver 枚举扩值)。
8. 界外发现:runtime(standalone-stack): mysql:// 与 #5820 的 libsql 同族 —— os migrate 抛 Unsupported scheme,而 OS_DATABASE_DRIVER 的未知值(含 mysql)静默落到 SQLite #6265(mysql:// 同形缺口 + OS_DATABASE_DRIVER 裸 as 无校验、未知值静默落 SQLite——concrete defect,留分诊)、observation: 可选 Turso driver 的 loader 现在有两份(cli/utils/storage-driver.ts 与 runtime/turso-driver-factory.ts)—— 建议收敛到单一 owner #6268(Turso loader cli/runtime 双份靠人工对齐,含 instanceof 收敛陷阱提示)。均查重后立单不认领,合规。

处置:PR #6272 转 ready 并挂 auto-merge;两读数确认 MERGED 后关单。

---

Generated by Claude Code