Note identity migration is v27 after login_keys took v26
ci / test-pg (pull_request) Failing after 1m23s
ci / test (pull_request) Successful in 3m9s

Why: Backend #170 rebased; design doc still said v26.
Evidence: local unittest identity+backup OK after task-sync.
Impact: docs/recovery/u1-identity-manifest.md §5.2 version note.
Refs: Backend PR #170; Dev PR #426
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-10-12 05:07:25 +00:00
co-authored by Cursor
parent dfa77d5b94
commit aef689f9e7
+1 -1
View File
@@ -53,7 +53,7 @@
- 解析:CLI 显式覆盖(仅 `listen.*`、`program.source` 等白名单字段)> manifest > 环境变量(迁移后仅作显式 override 记录,不再隐式成为下次事实)。
- 启动校验(全部通过才 exec):
1. schema/revision 合法且 revision ≥ 在位值;
2. **DB marker**:PG 专用表 `agent_system_identity(instance_id, dbref, schema_version, created_at)`;SQLite 同表(Backend migration v26)。首建:`svc init` 或 start 路径上的幂等 `identity ensure`(仅表空插入;已有行不一致 fail-closed,不改 instance_id)。常规启动 `identity verify` + serve 在 `AGENT_SYSTEM_INSTANCE_ID` 下二次门禁;缺失/不匹配即阻塞(I4)。与 serve `--instance`(runs 进程标识)无关。
2. **DB marker**:PG 专用表 `agent_system_identity(instance_id, dbref, schema_version, created_at)`;SQLite 同表(Backend migration v27;v26 为 login_keys)。首建:`svc init` 或 start 路径上的幂等 `identity ensure`(仅表空插入;已有行不一致 fail-closed,不改 instance_id)。常规启动 `identity verify` + serve 在 `AGENT_SYSTEM_INSTANCE_ID` 下二次门禁;缺失/不匹配即阻塞(I4)。与 serve `--instance`(runs 进程标识)无关。
3. **数据根 marker**:`<data_root>/.agentx/data-marker.json`(instance_id + roots 清单摘要);不匹配/丢失阻塞。
4. `dsn_ref` 指向文件存在且权限 ≤0600。
- 显式入口:`svc init`(首次:创建 manifest+双 marker,要求目标为空);`svc restore`(灾难恢复:新目标装配 manifest+marker,走 U6 验证合同)。`start` 永不隐式 init。