@lovrabet/rabetbase-cli 2.5.2-beta.4 → 2.5.2-beta.6

package/skills/rabetbase/references/rabetbase-deployment-sync.md

@@ -1,100 +0,0 @@
-# rabetbase deployment sync
-
-将当前应用中的少量研发元数据同步到独立部署系统。命令只同步显式给出的业务编码，支持 `dataset`、`bff`、`sql`。
-
-需要同步当前应用中服务端支持的全部研发元数据时，不要猜测或枚举资源类型和编码，改用本文后半部分的 `deployment sync-all`。
-
-## 使用前确认
-
-- 已完成 rabetbase 认证，并明确目标应用的 `appCode`。
-- 从可信事实中取得业务编码，不猜测 DatasetCode、function name 或 sqlCode。
-- Agent 只提供下方列出的业务参数。
-- 服务端会检查 appCode 白名单；未开启时正常跳过，不属于异常或无权限。
-- 一次命令最多 100 个编码；CLI 串行处理，不并发执行。
-
-## 先预览
-
-```sh
-rabetbase deployment sync \
-  --appcode <appCode> \
-  --type dataset \
-  --codes <code1,code2> \
-  --dry-run \
-  --format compress
-```
-
-检查 `data.selector.bizType` 和 `data.selector.bizCodes`；dry-run 不发起同步请求。
-
-## 正式执行
-
-复用已审阅的参数，移除 `--dry-run` 并追加 `--confirm`。CI 或非交互环境还需要全局 `--yes`：
-
-```sh
-rabetbase deployment sync \
-  --appcode <appCode> \
-  --type dataset \
-  --codes <code1,code2> \
-  --confirm \
-  --yes \
-  --format compress
-```
-
-## 参数约束
-
-- `--type dataset|bff|sql`：同步资源类型。
-- `--codes`：逗号分隔；命令 trim、过滤空项并按首次出现顺序去重，最多 100 个。
-- Agent 只提供 `--type`、`--codes` 和执行确认。
-
-## 结果与失败处理
-
-- 退出码 `0`：服务端没有返回 `FAILED`；`SKIPPED`、`UNCHANGED` 等 no-op action 或空 items 均表示无需执行，不作为异常。
-- 退出码 `1`：至少一个条目为 `FAILED`。读取结构化输出的 `data.items[]`，只人工处理明确失败的 code，不自动重提整批。
-- 退出码 `2`：写请求响应丢失或响应无法证明结果。同步可能已经生效；先人工核对目标部署，再决定后续处理，禁止直接重试。
-
-Dataset 同步会逐项处理 Dataset 元数据，不是跨资源原子事务。命令当前不提供目标端只读回查；部署后的业务可用性仍需单独验收。
-
-## 日常 BFF / SQL push 自动同步
-
-存在实际变更且主 push 成功后，CLI 自动提交精确同步意图；服务端原子检查 appCode 白名单并处理目标。未开启时返回成功空结果，表示无需执行，不是异常或无权限。
-
-- `bff push` 只同步当前 push 中上传成功且完成缓存清理的 function name。
-- `sql push` 只同步当前 push 中成功写入的 sqlCode；未变化项不触发同步。
-- 主 push 或 BFF 缓存清理失败时不调用同步接口。
-- dry-run 展示服务端托管的同步意图和精确 code，但不调用 `/sync`。
-- Dataset 没有统一 push 入口，继续使用显式 `deployment sync --type dataset`；不要在 `dataset generate-status` 等只读命令中触发同步。
-- 主 push 成功但后置同步失败时，不声称回滚主操作；按 `data.deploymentSync.recoveryCommand` 人工处理。
-- `partial_failure`、`failed`、`outcome_unknown` 均不得自动重试。
-
-## 应用范围同步
-
-用户明确要求同步当前应用全部已支持研发元数据时，先预览：
-
-```sh
-rabetbase deployment sync-all \
-  --appcode <appCode> \
-  --dry-run \
-  --format compress
-```
-
-经用户确认后，复用预览中的 appCode 提交：
-
-```sh
-rabetbase deployment sync-all \
-  --appcode <appCode> \
-  --confirm \
-  --yes \
-  --format compress
-```
-
-- `outcome=not_needed`：服务端判定当前应用无需同步，属于正常完成，不解释为异常或无权限。
-- `outcome=submitted`：保存 `jobId`，再用 `deployment sync-status` 查询同一任务。
-- 提交结果未知：不得再次执行 `sync-all`；先用 `deployment sync-jobs` 查找近期任务。
-
-任务查询：
-
-```sh
-rabetbase deployment sync-status --job-id <jobId> --format compress
-rabetbase deployment sync-jobs --appcode <appCode> --format compress
-```
-
-只根据 `isTerminal` 判断是否已知终态；若为 `null`，保留服务端状态并交给用户判断。逐项资源类型和 action 都是服务端开放字符串，Agent 不建立枚举闭集，也不因新值自动重提。