@lovrabet/rabetbase-cli 2.5.3-beta.1 → 2.5.3-beta.3

package/skills/rabetbase/references/rabetbase-instant-api-policy.md

@@ -12,29 +12,114 @@
 
 `init`、`pull`、`validate` 和 `publish` 只使用该路径，不提供 `--file`。目标应用来自当前工作区、`--app <name>` 或 `--appcode <code>`。策略不存入 `.rabetbase.json` 或运行态 app-config。
 
-`version` 固定为字符串 `"1"`，表示 JSON 结构版本。`revision` 是服务端发布历史版本，首次发布为 1，后续发布和回滚递增；两者含义不同。
+`version` 是 JSON 结构版本：`"1"` 保持精确匹配兼容，`"2"` 支持通配选择和排除项；新版 CLI 的 `init` 默认创建版本 2。`revision` 是服务端发布历史版本，首次发布为 1，后续发布和回滚递增；两者含义不同。
 
 ## 配置结构
 
+### 先取得真实 Dataset 选择器
+
+策略匹配的是平台 Dataset，不是前端 SDK 的变量名。编辑前按下面顺序取得当前应用的事实：
+
+```bash
+# 更新当前应用的本地模型事实；多应用项目显式选择目标
+rabetbase api pull --appcode <appCode> --yes --format compress
+
+# 对将被规则覆盖的 Dataset 确认真实 code、字段和支持的操作
+rabetbase dataset detail --appcode <appCode> --code <datasetCode> --format compress
+```
+
+`api pull` 生成的模型条目包含 `datasetCode`、可选 `tableName` 和 SDK `alias`。规则中优先只写这个 `datasetCode`；**不能**写 `alias`。例如模型中的 `alias: "brand"` 只是 SDK 调用名，不是策略选择器。只有无法取得 code 的兼容场景才使用 `tableName`；若两者同时填写，服务端要求它们解析为同一个 Dataset。
+
+认证不可用、`api pull` 失败或模型文件明显过期时，停止配置并先恢复认证；不要根据业务名称、SDK alias 或旧截图猜测 `datasetCode`。
+
+### Dataset 选择器规则
+
+| 场景 | 合法写法 | 约束 |
+| --- | --- | --- |
+| v1/v2 的精确 Dataset | `{ "datasetCode": "<real-dataset-code>" }` | 首选；code 来自当前应用的 `api pull` 或 `dataset detail` |
+| v1/v2 的精确物理表 | `{ "tableName": "<real-table-name>" }` | 可用作兼容选择器；不能填 SDK alias |
+| v1/v2 双字段精确选择 | `{ "datasetCode": "…", "tableName": "…" }` | 两值必须解析为同一个 Dataset；已知 code 时不要冗余填写 tableName |
+| 仅 v2 的全部 Dataset | `{ "datasetCode": "*" }` | `datasets` 的唯一元素；不能附带 `tableName`，也不能与精确选择器混用 |
+
+`{ "tableName": "*" }` 在任何版本都不支持。版本 1 只接受上面的精确选择器，不能使用 Dataset/API 通配或 `excludes`。
+
+### 顶层字段
+
+| 字段 | 必填 | 取值 / 约束 | 作用 |
+| --- | --- | --- | --- |
+| `version` | 是 | `"1"` 或 `"2"`；新文件使用 `"2"` | JSON 结构版本，不是服务端发布 revision |
+| `appCode` | 是 | 必须等于当前命令解析出的应用 | 防止跨应用误发布 |
+| `defaults.instantApi` | 是 | `"allow"` 或 `"deny"` | 没有任何规则命中时的最终动作；不能是 `"route"` |
+| `rules` | 否 | 规则数组；缺省或空数组表示全部使用默认动作 | 对特定 Dataset + API 组合覆盖默认动作 |
+
+### 规则字段
+
+| 字段 | 必填 | 取值 / 约束 |
+| --- | --- | --- |
+| `name` | 是 | 稳定、可读的规则标识，方便审阅和版本回溯 |
+| `description` | 否 | 说明规则的业务目的和影响范围 |
+| `datasets` | 是 | 非空数组；每项优先仅 `{ "datasetCode": "<real-dataset-code>" }` |
+| `apis` | 是 | 非空数组，每项是独立 API 名；不能把多个 API 拼为一个逗号字符串 |
+| `action` | 是 | `"allow"`、`"deny"` 或 `"route"` |
+| `backendFunction` | 条件必填 | 仅 `action: "route"` 时填写；必须是同一应用的普通 `ENDPOINT`，不能是 Personal Backend Function |
+| `excludes` | 仅 v2 可用 | 从本规则的 Dataset × API 匹配集合中扣除的数组；每项都要有 `datasets` 和 `apis`，且不得超出父规则范围 |
+
+支持的 API 名称为：`getSelectOptions`、`getList`、`excelExport`、`filter`、`aggregate`、`getOne`、`getOneOrigin`、`create`、`batchCreate`、`update`、`delete`。
+
+规则数组**没有优先级**。服务端会先按每条规则的 Dataset × API 组合（扣除 `excludes` 后）计算覆盖范围；仍有重叠就校验失败，而不是“后一条覆盖前一条”。未被任何规则覆盖的组合回退到 `defaults.instantApi`。
+
+### 精确匹配示例
+
+下面的 `<real-dataset-code>` 必须替换为刚由 `api pull` 得到的 code，不能替换成 alias 或展示名称：
+
+```json
+{
+  "version": "2",
+  "appCode": "app-example",
+  "defaults": { "instantApi": "allow" },
+  "rules": [
+    {
+      "name": "deny-sensitive-export",
+      "description": "禁止敏感数据集通过 Instant API 导出",
+      "datasets": [{ "datasetCode": "<real-dataset-code>" }],
+      "apis": ["excelExport"],
+      "action": "deny"
+    }
+  ]
+}
+```
+
+这是默认放行下的最小收紧方式：仅该 Dataset 的 `excelExport` 被禁止，其他组合继续由默认动作处理。
+
+### 版本 2 通配与排除示例
+
 ```json
 {
-  "version": "1",
+  "version": "2",
   "appCode": "app-example",
   "defaults": {
     "instantApi": "allow"
   },
   "rules": [
     {
-      "name": "route-student-filter",
-      "description": "学生筛选交给业务 Backend Function",
-      "datasets": [
+      "name": "route-all-except-student-create",
+      "description": "除学生新增外，全部数据集操作交给统一 Backend Function",
+      "datasets": [{"datasetCode": "*"}],
+      "apis": ["*"],
+      "excludes": [
         {
-          "datasetCode": "student23"
+          "datasets": [{"datasetCode": "student23"}],
+          "apis": ["create"]
         }
       ],
-      "apis": ["filter"],
       "action": "route",
-      "backendFunction": "filterStudents"
+      "backendFunction": "unifiedGateway"
+    },
+    {
+      "name": "allow-student-create",
+      "datasets": [{"datasetCode": "student23"}],
+      "apis": ["create"],
+      "action": "allow"
     }
   ]
 }
@@ -43,8 +128,13 @@
 - `defaults.instantApi` 只允许 `allow` 或 `deny`，不能是 `route`。
 - `rules[].action` 允许 `allow`、`deny`、`route`。
 - `route` 必须填写 `backendFunction`；其他 action 禁止填写。
-- `datasets[]` 至少填写 `datasetCode` 或 `tableName`；建议优先使用稳定的 `datasetCode`。两者同时填写时必须指向同一 Dataset。
-- 同一个 `datasetCode + api` 只能命中一条规则；重复覆盖会校验失败。
+- `datasets[]` 至少填写 `datasetCode` 或 `tableName`；已知 code 时只填写稳定的 `datasetCode`。两者同时填写时必须指向同一 Dataset。
+- 版本 1 只支持精确匹配，不允许 `*` 或 `excludes`。
+- 版本 2 的全部数据集写为 `datasets: [{"datasetCode":"*"}]`。通配项必须是数组唯一元素且不能包含 `tableName`；不支持 `tableName: "*"`。
+- 版本 2 的全部 API 写为 `apis: ["*"]`，`"*"` 必须是数组唯一元素。
+- `excludes[]` 每项包含 `datasets` 和 `apis`，表示从父规则中扣除两者笛卡尔积；排除范围不能超出父规则。
+- 被排除的组合可以由后续其他规则处理；没有其他规则时执行 `defaults.instantApi`。
+- 排除后仍重复的 `datasetCode + api` 会校验失败，规则数组顺序不表示优先级。
 - `apis` 的每个元素是一个独立值。`["filter,create"]` 或包含中文逗号的 `["filter，create"]` 都不是两个 API。
 - 支持的 API：`getSelectOptions`、`getList`、`excelExport`、`filter`、`aggregate`、`getOne`、`getOneOrigin`、`create`、`batchCreate`、`update`、`delete`。
 
@@ -70,7 +160,7 @@ rabetbase instant-api-policy publish --expected-revision 0 --change-summary "ini
 rabetbase instant-api-policy publish --expected-revision 0 --change-summary "initial policy" --yes --format compress
 ```
 
-`init --default-action deny` 可以创建默认禁止草稿。`init` 和 `pull` 遇到不同的既有文件时停止；只有 `--force --yes` 可以替换。
+`init --default-action deny` 可以创建版本 2 的默认禁止草稿。`init` 和 `pull` 遇到不同的既有文件时停止；只有 `--force --yes` 可以替换。已有版本 1 文件仍可继续校验和发布。
 
 `validate` 调用服务端完整校验，返回 `configHash` 和 `normalizedConfig`，但不发布、不生成 revision。Dataset、API、规则重叠以及 Backend Function 合法性以该结果为准。
 
@@ -90,3 +180,5 @@ rabetbase instant-api-policy rollback --revision 2 --expected-revision 5 --chang
 回滚不会把 revision 倒退，也不会覆盖历史。例如当前 revision 为 5，恢复 revision 2 后会生成新的 revision 6。
 
 发布和回滚最多提交一次。CLI 随后读取当前策略，要求 configHash 匹配且 revision 推进。响应丢失但回读可以证明结果时返回 verified；证据不足时停止并提示执行 `current`，不得自动重提。Runtime 最迟约 30 秒感知新策略。
+
+数据集通配项按应用当前有效数据集展开；应用新增数据集后，会在 Runtime 策略缓存刷新时自动进入通配规则范围。

package/skills/rabetbase/references/rabetbase-notification-config-list.md

@@ -7,6 +7,7 @@
 ```bash
 rabetbase notification config-list --format compress
 rabetbase notification config-list --type EMAIL --format compress
+rabetbase notification config-list --all --format compress
 rabetbase notification config-list --type EMAIL --appcode app-xxxxx --format json
 ```
 
@@ -20,6 +21,8 @@ rabetbase notification config-list --type EMAIL --appcode app-xxxxx --format jso
 
 类型值使用大写。
 
+`--all` 会分别查询 `EMAIL`、`FEISHU`、`DINGTALK`、`WECOM`、`WEBHOOK`，合并为同一份安全摘要。`--all` 与 `--type` 互斥；不传二者时继续保持默认 `EMAIL` 行为。
+
 ## 输出
 
 ```json
@@ -45,6 +48,20 @@ rabetbase notification config-list --type EMAIL --appcode app-xxxxx --format jso
 }
 ```
 
+`--all` 输出使用 `data.channelTypes` 代替单个 `data.channelType`，`configs` 为五种类型结果的合并列表：
+
+```json
+{
+  "ok": true,
+  "data": {
+    "appCode": "app-xxxxx",
+    "channelTypes": ["EMAIL", "FEISHU", "DINGTALK", "WECOM", "WEBHOOK"],
+    "count": 2,
+    "configs": []
+  }
+}
+```
+
 CLI 只输出用于选择配置的安全字段，不输出：
 
 * `channelConfig`

package/skills/rabetbase/references/rabetbase-project-create.md

@@ -51,8 +51,8 @@ rabetbase project create my-project --appcode <code>
 **关键边界：**
 
 - 当前目录非空时不得覆盖、移动或删除已有内容，应报告冲突。
-- `needsAgentMerge` 只表示已有 TypeScript 被保留，是检查提示，不代表必须改写文件；仅在模型事实存在差异时合并。
-- `--force --yes` 只用于首次脚手架拉取明确失败，或用户明确要求放弃本地定制的场景。
+- `needsProjectUpgrade` 表示模型事实已刷新，但已有项目尚未安装稳定源码入口；新建项目模板正常不会出现该状态。
+- `--force --yes` 在注册表模式只用于确认远端空清单，不用于源码迁移。
 - 此意图只授权本地工程创建与平台事实读取，不授权修改线上业务数据或平台资源。
 
 `api pull` 的单应用/项目应用清单输出结构见 [`rabetbase-api-pull.md`](rabetbase-api-pull.md)，TypeScript 合并规则见 [`sdk-client-generation.md`](../guides/sdk-client-generation.md)。Agent 可根据实际输出选择检查、修复和验证方式。
@@ -70,7 +70,7 @@ rabetbase project create my-project --appcode <code>
 - 交互与非交互模式使用同一创建流程，都会安装依赖、格式化代码并写入项目配置
 - 项目模板从 CDN 下载并校验 SHA-256；CDN 不可用、模板不兼容或校验失败时命令停止，修复后重试
 - 新项目中的 `.rabetbase.json` **只继承**全局中的少量偏好及 `region` / Domain 路由配置，**不会**把全局的 `apps` / `defaultApp` 复制进新项目
-- `src/api/sdk-config.ts` 与 `rabetbase.domain-routing.json` 只生成浏览器可公开的最终路由，不会写入 `cookie`、`accessKey` 等认证配置；`rabetbase run start|dev|build|preview` 会在执行脚本前刷新公开 Domain 快照，也可用 [`project domain-routing-sync`](rabetbase-project-domain-routing-sync.md) 立即显式刷新。`api.ts` / `client.ts` 仅在缺失时由 CLI 写脚手架，已有文件按 [`sdk-client-generation.md`](../guides/sdk-client-generation.md) 更新；若项目创建时首次拉取失败，按 CLI 提示执行 `rabetbase api pull --force --yes` 完成占位脚手架初始化
+- `src/api/sdk-config.ts` 与 `rabetbase.domain-routing.json` 只生成浏览器可公开的最终路由，不会写入 `cookie`、`accessKey` 等认证配置；`rabetbase run start|dev|build|preview` 会在执行脚本前刷新公开 Domain 快照，也可用 [`project domain-routing-sync`](rabetbase-project-domain-routing-sync.md) 立即显式刷新。新项目模板已经包含稳定 `api.ts` / `client.ts`；若首次拉取失败，修复登录或连接后执行普通 `rabetbase api pull --format compress` 刷新占位注册表
 
 | 当前有效路由 | `src/api/sdk-config.ts` |
 |--------------|-------------------------|

package/skills/rabetbase/references/rabetbase-project-upgrade.md

@@ -1,6 +1,8 @@
 # project upgrade
 
-从 lovrabet-cli 迁移到 rabetbase-cli。
+升级已有项目的 SDK 依赖与应用源码结构。新项目继续使用 `project create`；Dataset 事实刷新继续使用 `api pull`。
+
+`.lovrabet.json`、`.lovrabet/` 与 Lovrabet Skill 属于 Lovrabet 运行态 CLI，可与 Rabetbase 项目配置和源码共存。该命令不会读取、迁移、改写或删除这些运行态资产。
 
 ## 命令
 
@@ -8,6 +10,9 @@
 # 交互模式（先分析 → 展示报告 → 确认 → 执行）
 rabetbase project upgrade
 
+# 只查看完整迁移计划，不写文件
+rabetbase project upgrade --dry-run
+
 # 自动模式（跳过确认）
 rabetbase project upgrade --yes
 ```
@@ -17,27 +22,33 @@ rabetbase project upgrade --yes
 | Flag | 类型 | 必填 | 默认 | 说明 |
 |------|------|------|------|------|
 | `--yes` | boolean | 否 | `false` | 跳过确认提示，直接执行 |
+| `--dry-run` | boolean | 否 | `false` | 只输出依赖和源码升级计划 |
 
 ## 执行流程
 
-两阶段模式：先分析 → 展示报告 → 确认 → 执行 6 步：
+两阶段模式：先分析 → 展示报告 → 确认 → 执行 2 步：
 
 | 步骤 | 操作 | 说明 |
 |------|------|------|
-| 1 | 配置文件迁移 | 旧配置（`.lovrabet.json` 等）→ `.rabetbase.json`，旧文件备份为 `.bak` |
-| 2 | 删除 `.lovrabet/` | 移除旧的工作目录 |
-| 3 | 删除旧 IDE skill 文件 | 移除 `.cursor/rules/lovrabet_rules.mdc`、`.claude/skills/lovrabet` 等 |
-| 4 | 清理 MCP 配置 | 从 `.cursor/mcp.json` 移除引用 `@lovrabet/dataset-mcp-server` 的条目 |
-| 5 | 移除旧 skill | 清理旧的 Lovrabet Skill 安装记录 |
-| 6 | 安装新 skill | `npx skills add lovrabet/rabetbase -g -y` |
+| 1 | 升级 SDK 依赖 | 将已有 `@lovrabet/sdk` 依赖更新到当前维护版本 |
+| 2 | 升级应用源码 | 迁移稳定 API 入口、模型注册表、运行时选择器和项目 Domain 路由 |
+
+## 源码迁移安全规则
+
+- 先执行 `rabetbase project upgrade --dry-run`；确认 `apiArchitecture.groups[].files[]` 的动作后再正式执行。
+- 缺失文件直接创建；可识别的旧 CLI 生成文件先备份到 `.rabetbase/project-upgrade/api-model-registry-v2/backups/` 再替换。
+- 发现业务定制的 `api.ts` / `client.ts` 时不覆盖原文件，在 `candidates/` 下写入候选文件，并返回 `manualMergeRequired: true`。
+- 旧 `api.ts` 中可识别的 Dataset 事实迁入 `models.generated.ts`，迁移后再运行 `rabetbase api pull --format compress` 刷新远端事实。
+- 多个未配置 `apiGroup` 且共用同一 `apiDir` 的历史 profile 保留 `[name-]api.ts` / `[name-]client.ts`，不会被静默归并。
+- 命令可重复执行；已是最新稳定入口时不重复改写。
 
 ## 分析报告
 
 执行前会扫描并展示：
-- 旧配置文件路径和待迁移字段
-- 旧文件/目录列表
-- MCP 配置中待清理的条目
-- 是否需要 skill 替换
+- `@lovrabet/sdk` 是否需要更新
+- 每个 API 目录的 profile、文件动作、备份或候选文件路径
+
+不会把 `.lovrabet.json`、`.lovrabet/`、Lovrabet Skill 或 Lovrabet 的 IDE 配置列为待清理项。
 
 ## 输出
 
@@ -49,7 +60,7 @@ rabetbase project upgrade --yes
 ## 触发方式
 
 - 手动执行：`rabetbase project upgrade`
-- 显式执行：`rabetbase project upgrade` 检测并迁移旧配置
+- 已有应用需要采用当前源码架构：先 `rabetbase project upgrade --dry-run`，再正式升级
 
 ## 参考
 

package/skills/rabetbase.manifest.json

@@ -2,10 +2,11 @@
   "schemaVersion": 1,
   "name": "rabetbase",
   "packageName": "@lovrabet/rabetbase-cli",
-  "packageVersion": "2.5.3-beta.1",
-  "skillVersion": "2.5.3-beta.1",
+  "packageVersion": "2.5.3-beta.3",
+  "skillVersion": "2.5.3-beta.3",
   "files": [
     "SKILL.md",
+    "guides/approval-flow-development-workflow.md",
     "guides/backend-function.md",
     "guides/best-practices.md",
     "guides/bff-creation-workflow.md",
@@ -22,6 +23,7 @@
     "guides/sql-mybatis.md",
     "guides/troubleshooting.md",
     "guides/typescript-sdk.md",
+    "knowledge/approval-flow/config-json-schema.md",
     "knowledge/components.md",
     "knowledge/custom-page/generation-standards.md",
     "knowledge/custom-page/page-templates.md",
@@ -46,6 +48,7 @@
     "references/rabetbase-bff-delete.md",
     "references/rabetbase-bff-detail.md",
     "references/rabetbase-bff-list.md",
+    "references/rabetbase-bff-logs.md",
     "references/rabetbase-bff-pull.md",
     "references/rabetbase-bff-push.md",
     "references/rabetbase-bff-save.md",
@@ -58,6 +61,7 @@
     "references/rabetbase-database-template.md",
     "references/rabetbase-dataset-business-group-update.md",
     "references/rabetbase-dataset-business-groups.md",
+    "references/rabetbase-dataset-cross-relations.md",
     "references/rabetbase-dataset-delete.md",
     "references/rabetbase-dataset-detail.md",
     "references/rabetbase-dataset-extend-update.md",
@@ -85,6 +89,9 @@
     "references/rabetbase-deployment-sync-all.md",
     "references/rabetbase-doctor.md",
     "references/rabetbase-file.md",
+    "references/rabetbase-flow-commands.md",
+    "references/rabetbase-flow-resources.md",
+    "references/rabetbase-flow-runtime-boundary.md",
     "references/rabetbase-init.md",
     "references/rabetbase-instant-api-policy.md",
     "references/rabetbase-issue-report.md",
@@ -140,5 +147,5 @@
     "references/rabetbase-user-account.md",
     "references/rabetbase-workspace.md"
   ],
-  "digest": "737d15dee0512e879514bb4ab5e657b2e817656ba483dd285f5fbfe59adabc05"
+  "digest": "fb687c0d57936cfcba5e4f4d395e8695309e549ce848c5834befbade117e83e8"
 }

package/templates/README.md

@@ -52,12 +52,24 @@ node lib/cli.js project create template-verify --template-source templates/proje
 模板同步完成后，更新模板自身的 `package.json#version`，再生成待发布的 CDN 资产：
 
 ```bash
+# 正式模板：更新顶层 projectTemplate
 npm run sync:cdn
+
+# beta 模板：只更新 beta.projectTemplate
+npm run sync:cdn:beta
+
+# 只读校验：发布门禁会按目标自动执行其中一条
+npm run check:cdn
+npm run check:cdn:beta
 ```
 
-该命令会在 `dist/rabetbase-cli/templates/projects/` 下生成
-`sub-app-react-demo.zip`，并把版本、文件名、大小和 SHA-256 写入现有
-`dist/rabetbase-cli/config/index.json`。ZIP 使用固定地址，每次发布直接覆盖。
+两个命令都只从同一个正式模板真源生成产物，并写入同一个
+`dist/rabetbase-cli/config/index.json`。正式模板使用顶层 `projectTemplate` 和
+`sub-app-react-demo.zip`；beta 模板使用 `beta.projectTemplate` 和
+`sub-app-react-demo-beta.zip`，两条发布通道互不覆盖。旧 CLI 继续读取顶层字段；
+新版 beta CLI 在 beta 描述缺失时兼容回退到顶层正式模板。
+`check:cdn` / `check:cdn:beta` 在系统临时目录重建 ZIP，只读比对模板描述和仓内归档，
+不会改动 `cdn/` 或 `dist/`。
 
 ### 模板结构
 
@@ -81,7 +93,7 @@ npm run sync:cdn
 ## 注意事项
 
 - `templates/projects/sub-app-react-demo/` 是项目模板真源，不是独立 Git 仓，也不是外部仓快照
-- `rabetbase project create` 从 CDN 下载 ZIP，然后更新 `package.json` 与 `.rabetbase.json`；此仓库模板不进入 npm 发布包
+- `rabetbase project create` 从 CDN 下载 ZIP，然后更新 `package.json` 与 `.rabetbase.json`；正式 CLI 读取顶层模板，beta CLI 优先读取 `beta.projectTemplate`；此仓库模板不进入 npm 发布包
 - 模板文件名必须兼容 Windows、macOS 和 Linux；禁止符号链接、大小写冲突路径和 Windows 保留名称
 - 有 AppCode 时，CLI 会重新生成 `src/api/api.ts` 和 `src/api/client.ts`
 - 项目模板中不要保留真实 AppCode、真实数据集模型、`.git`、`node_modules`、`dist` 或个人配置

package/templates/generate-api/model-runtime.ts.tpl

@@ -0,0 +1,101 @@
+/**
+ * Profile-aware model selection generated by Rabetbase CLI.
+ * Do not add application-specific Dataset codes to this file.
+ */
+
+import type { ModelsConfig } from "@lovrabet/sdk";
+
+interface ModelProfile {
+  appCode: string;
+  runtimeDomain: string;
+}
+
+interface ModelEntryMetadata {
+  alias: string;
+  tableName: string;
+  name: string;
+}
+
+type ModelEntry = ModelEntryMetadata &
+  (
+    | { datasetCode: string; datasetCodes?: never }
+    | { datasetCode?: never; datasetCodes: Record<string, string> }
+  );
+
+interface ModelRegistry {
+  defaultProfile: string;
+  profiles: Record<string, ModelProfile>;
+  models: readonly ModelEntry[];
+}
+
+function normalizeDomain(value: string | undefined): string | undefined {
+  return value?.trim().replace(/\/+$/, "");
+}
+
+function injectedRuntimeDomain(): string | undefined {
+  if (typeof window === "undefined") return undefined;
+  const globalWindow = window as Window & {
+    __GLOBAL__?: {
+      deploymentConfig?: { RUNTIME_API_DOMAIN?: string };
+    };
+  };
+  return normalizeDomain(
+    globalWindow.__GLOBAL__?.deploymentConfig?.RUNTIME_API_DOMAIN,
+  );
+}
+
+function selectProfile(
+  registry: ModelRegistry,
+  projectRuntimeDomain: string,
+): readonly [string, ModelProfile] {
+  const runtimeDomain =
+    injectedRuntimeDomain() ?? normalizeDomain(projectRuntimeDomain);
+  const matches = Object.entries(registry.profiles).filter(
+    ([, profile]) => normalizeDomain(profile.runtimeDomain) === runtimeDomain,
+  );
+
+  if (matches.length > 1) {
+    throw new Error(
+      `Multiple Lovrabet model profiles match Runtime Domain "${runtimeDomain}". ` +
+        "Give each profile a distinct Runtime Domain.",
+    );
+  }
+  if (matches.length === 1) return matches[0]!;
+
+  throw new Error(
+    `No Lovrabet model profile matches Runtime Domain "${runtimeDomain ?? "(not set)"}". ` +
+      "Run `rabetbase api pull` after verifying the current project routing.",
+  );
+}
+
+export function resolveActiveModelConfig(
+  registry: ModelRegistry,
+  projectRuntimeDomain: string,
+): {
+  profileName: string;
+  appCode: string;
+  runtimeDomain: string;
+  modelsConfig: ModelsConfig;
+} {
+  const [profileName, profile] = selectProfile(registry, projectRuntimeDomain);
+  const models = registry.models.flatMap((model) => {
+    const datasetCode = model.datasetCode ?? model.datasetCodes?.[profileName];
+    return datasetCode
+      ? [
+          {
+            datasetCode,
+            tableName: model.tableName,
+            name: model.name,
+            alias: model.alias,
+          },
+        ]
+      : [];
+  });
+
+  return {
+    profileName,
+    appCode: profile.appCode,
+    runtimeDomain: profile.runtimeDomain,
+    modelsConfig: { appCode: profile.appCode, models },
+  };
+}

package/templates/generate-api/profile-api.ts.tpl

@@ -0,0 +1,21 @@
+/**
+ * Stable Lovrabet SDK model entrypoint.
+ * Generated by Rabetbase CLI.
+ */
+
+import { registerModels, CONFIG_NAMES } from "@lovrabet/sdk";
+import projectRouting from "{ProjectRoutingImport}";
+import { LOVRABET_MODEL_REGISTRY } from "./models.generated";
+import { resolveActiveModelConfig } from "./model-runtime";
+
+const activeModelConfig = resolveActiveModelConfig(
+  LOVRABET_MODEL_REGISTRY,
+  projectRouting.domains.runtime,
+);
+
+export const LOVRABET_PROFILE_NAME = activeModelConfig.profileName;
+export const LOVRABET_APP_CODE = activeModelConfig.appCode;
+export const LOVRABET_RUNTIME_DOMAIN = activeModelConfig.runtimeDomain;
+export const LOVRABET_MODELS_CONFIG = activeModelConfig.modelsConfig;
+
+registerModels(LOVRABET_MODELS_CONFIG, CONFIG_NAMES.DEFAULT);

package/templates/generate-api/profile-client.ts.tpl

@@ -0,0 +1,14 @@
+/**
+ * Stable Lovrabet SDK client entrypoint.
+ * Generated by Rabetbase CLI.
+ */
+
+import { createClient, CONFIG_NAMES } from "@lovrabet/sdk";
+import { LOVRABET_RUNTIME_DOMAIN } from "./api";
+import { LOVRABET_SDK_CONFIG } from "./sdk-config";
+
+export const lovrabetClient = createClient({
+  apiConfigName: CONFIG_NAMES.DEFAULT,
+  ...LOVRABET_SDK_CONFIG,
+  runtimeDomain: LOVRABET_RUNTIME_DOMAIN,
+});