weichen/Agent-System-Backend
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Port the IAM permission-management API from the abandoned iam-perm-ux branch #240

Merged
weichen merged 6 commits from fix/iam-perm-ux-port into main 2026-10-21 15:38:14 +00:00
Conversation 0 Commits 6 Files Changed 9
+2680
weichen commented 2026-10-21 15:14:03 +00:00
Owner
Copy Link
Copy Source

fix/iam-perm-ux-port 任务卡

任务主记录：<Issue/PR 链接，或注明"本文件随 PR 描述维护">。
状态：进行中；owner：weichen

基线与授权

  • 权威仓：ssh://git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Backend.git；root_target：main；immediate_target：main
  • branch_kind：standalone；initiative_id：
  • R0（initial_main_sha）：01f4c47a2b5798c9b43fffb9e298aa87138a1537；工作区：/home/weichen/projects/Agent-System-Backend-wt-fix-iam-perm-ux-port（worktree）；分支：fix/iam-perm-ux-port
  • 父任务信息（仅子任务填写）：无
  • accepting_requirements：false
  • 需求分流：verdict=NEW；selected_initiative=无；候选=无；理由=no accepting initiative；triage 收据=/tmp/be-triage-iam-perm-ux-20261021.json；receipt_sha256=bb4a700446f22b5799e94f1c6efa488c4a30b65814a457b76ab41d30b0dc5038；requirement_sha256=9495f0dc1c3cbf04feb6c712bfa93c6bbb6803801285a518ae9f309c74ec836b
  • 授权与交付终点：把仅存在于被放弃分支 feature/iam-perm-ux-backend 的权限管理 API 移植到当前 main，使其可从主干维护与调用。冲突一律以 main 现状裁决，不照搬旧实现；不得绕过 main 的账户作用域写入围栏与授权检查；不得新增范围外功能或 schema 迁移。
  • 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md；外部 Agent 一单元一新进程/会话/工作区）

目标与非目标

目标：main 此前不具备七个权限管理入口（PatchRolePermissionsBatch、PreviewRolePermissions、AssignUserRolesBatch、PreviewUserRoleAssignments、ListRoleMembersForActor、ActiveRolesForUsers、CreateRoleCopyAndAssign）与配套类型（RoleBinding、PolicyReceipt、RoleAdminView、CapabilityAssociation、RoleAuthorityImport*、RoleCreate/RolePatch、RolePermissionChange/Conflict）。本任务把这些能力移植到当前 main（其间 Backend 已合入 #228、#234），并保留其安全语义。

非目标：不整条合并/cherry-pick 旧分支（其基线早于 #228/#234）；不新增范围外功能；不做无关重构；除移植确需新表外不改 schema；不改 Makefile/CI/子模块/文档。

Agent 实施收据

按根目录 AGENT-EXECUTION.md 路由；外部 Agent 一单元一新进程/会话/隔离工作区。实施、修复与测试必须通过登记的候选执行；未配置或候选安全耗尽停在 unavailable/blocked，禁止 host 隐式代写。

单元 ID 预期范围 角色 候选顺序 attempt CLI/模型 终态 transport fallback 源码外收据路径
待定义 — NOT_RUN NOT_RUN NOT_RUN NOT_RUN NOT_RUN NOT_RUN NOT_RUN —

复用材料（task-start 自动检索结果摘录）

  • 相关近期提交：<git log -- 命中；无则写无>。
  • 相关经验条目：<检索命中；无则写无>。

同步记录

节点 sync_base_sha tested_head_sha checked_at 结果
启动 <HEAD> <日期时间> <一致/已同步>
验收前 <填写> <填写> <填写> <填写>

字段没有发生的写"无"，不省略。本卡与 PR 描述同源：开 PR 时将"目标与非目标、结果与验证、影响与剩余项"复制进 PR 描述，不另写第二份。

交付调度（有多个就绪任务时）

  • 调度记录 / entry_id / 当前 attempt_id：<平台或调度服务链接及标识；未入队写无>。
  • 入队源 HEAD / owner / 依赖：<完整 SHA、身份、依赖或无>。
  • 固定候选引用：<调度尝试中的 base/head、组件与配置；未固定写无>。
  • 窗口、最终 CI、Review 与真实合入结果：<引用调度记录及原始证据，不复制全队列>。

定义见 合入调度与 CI 分配。本段在候选固定前整理；固定后先使用源码之外的记录保存运行结果，再按项目闭合流程回填。

结果与验证（完成后填写）

  • 结果：七个权限管理入口（PatchRolePermissionsBatch、PreviewRolePermissions、AssignUserRolesBatch、PreviewUserRoleAssignments、ListRoleMembersForActor、ActiveRolesForUsers、CreateRoleCopyAndAssign）与配套类型（RoleBinding、PolicyReceipt、RoleAdminView、CapabilityAssociation、RoleAuthorityImport*、RoleCreate/RolePatch、RolePermissionChange/Conflict）全部移植到当前 main 的角色/权限模型上，8 文件 / +2184 行。移植首版并未编译通过（role_policy.go:2394 向 upsertRolePermissionsTx 传参错位：空 map 当 current、slice 当 after），已由独立 repair 单元按 main 的差量语义修正。
  • 验证：PASS——gofmt -l 干净；go build ./... 与 go vet ./internal/store/ ./internal/server/ ./internal/authz/... 均无输出（宿主独立执行）；go test -count=1 ./internal/store/ ./internal/server/ ./internal/authz/... 全绿（store 13.3s / server 29.5s / catalog ok）；独立 Review PASS、无阻塞项，逐 API 核对安全语义。
  • 影响与剩余项：只新增能力面，不改 schema（移植未引入新表），不改 Makefile/CI/子模块；未新增范围外功能。非阻塞遗留：Review 指出 PostgreSQL 下不同角色跨 batch 处理的潜在 lock-ordering 风险，以及若干测试缺口，两者已记入报告留作后续增量。
时间(UTC) 命令 被测 HEAD exit 来源 摘要/位置
<时间> <命令；由项目 evidence 工具写入，无工具时附命令+对象 SHA+输出 digest 并标 SELF> <HEAD> GATE/REPLAY/SELF <摘要/位置>

回收（task-finish）

  • 合入核对：<分支已包含于目标分支的核对输出>。
  • 未跟踪/ignored 文件处置：<归档/可再生/存疑 逐项；无则写无>。
  • 回收动作：<worktree remove、分支删除、prune；放弃路径注明原因>。
# fix/iam-perm-ux-port 任务卡 任务主记录：<Issue/PR 链接，或注明"本文件随 PR 描述维护">。 状态：进行中；owner：weichen ## 基线与授权 - 权威仓：ssh://git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Backend.git；root_target：main；immediate_target：main - branch_kind：standalone；initiative_id： - R0（initial_main_sha）：01f4c47a2b5798c9b43fffb9e298aa87138a1537；工作区：/home/weichen/projects/Agent-System-Backend-wt-fix-iam-perm-ux-port（worktree）；分支：fix/iam-perm-ux-port - 父任务信息（仅子任务填写）：无 - accepting_requirements：false - 需求分流：verdict=NEW；selected_initiative=无；候选=无；理由=no accepting initiative；triage 收据=/tmp/be-triage-iam-perm-ux-20261021.json；receipt_sha256=bb4a700446f22b5799e94f1c6efa488c4a30b65814a457b76ab41d30b0dc5038；requirement_sha256=9495f0dc1c3cbf04feb6c712bfa93c6bbb6803801285a518ae9f309c74ec836b - 授权与交付终点：把仅存在于被放弃分支 feature/iam-perm-ux-backend 的权限管理 API 移植到当前 main，使其可从主干维护与调用。冲突一律以 main 现状裁决，不照搬旧实现；不得绕过 main 的账户作用域写入围栏与授权检查；不得新增范围外功能或 schema 迁移。 - 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md；外部 Agent 一单元一新进程/会话/工作区） ## 目标与非目标 目标：main 此前不具备七个权限管理入口（PatchRolePermissionsBatch、PreviewRolePermissions、AssignUserRolesBatch、PreviewUserRoleAssignments、ListRoleMembersForActor、ActiveRolesForUsers、CreateRoleCopyAndAssign）与配套类型（RoleBinding、PolicyReceipt、RoleAdminView、CapabilityAssociation、RoleAuthorityImport*、RoleCreate/RolePatch、RolePermissionChange/Conflict）。本任务把这些能力移植到当前 main（其间 Backend 已合入 #228、#234），并保留其安全语义。 非目标：不整条合并/cherry-pick 旧分支（其基线早于 #228/#234）；不新增范围外功能；不做无关重构；除移植确需新表外不改 schema；不改 Makefile/CI/子模块/文档。 ## Agent 实施收据 按根目录 AGENT-EXECUTION.md 路由；外部 Agent 一单元一新进程/会话/隔离工作区。实施、修复与测试必须通过登记的候选执行；未配置或候选安全耗尽停在 unavailable/blocked，禁止 host 隐式代写。 | 单元 ID | 预期范围 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 | |---|---|---|---|---|---|---|---|---|---| | 待定义 | — | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | NOT_RUN | — | ## 复用材料（task-start 自动检索结果摘录） - 相关近期提交：<git log -- <paths> 命中；无则写无>。 - 相关经验条目：<检索命中；无则写无>。 ## 同步记录 | 节点 | sync_base_sha | tested_head_sha | checked_at | 结果 | |---|---|---|---|---| | 启动 | <R0> | <HEAD> | <日期时间> | <一致/已同步> | | 验收前 | <填写> | <填写> | <填写> | <填写> | 字段没有发生的写"无"，不省略。本卡与 PR 描述同源：开 PR 时将"目标与非目标、结果与验证、影响与剩余项"复制进 PR 描述，不另写第二份。 ## 交付调度（有多个就绪任务时） - 调度记录 / entry_id / 当前 attempt_id：<平台或调度服务链接及标识；未入队写无>。 - 入队源 HEAD / owner / 依赖：<完整 SHA、身份、依赖或无>。 - 固定候选引用：<调度尝试中的 base/head、组件与配置；未固定写无>。 - 窗口、最终 CI、Review 与真实合入结果：<引用调度记录及原始证据，不复制全队列>。 定义见 [合入调度与 CI 分配](../standards/merge-queue.md)。本段在候选固定前整理；固定后先使用源码之外的记录保存运行结果，再按项目闭合流程回填。 ## 结果与验证（完成后填写） - 结果：七个权限管理入口（PatchRolePermissionsBatch、PreviewRolePermissions、AssignUserRolesBatch、PreviewUserRoleAssignments、ListRoleMembersForActor、ActiveRolesForUsers、CreateRoleCopyAndAssign）与配套类型（RoleBinding、PolicyReceipt、RoleAdminView、CapabilityAssociation、RoleAuthorityImport*、RoleCreate/RolePatch、RolePermissionChange/Conflict）全部移植到当前 main 的角色/权限模型上，8 文件 / +2184 行。移植首版并未编译通过（role_policy.go:2394 向 upsertRolePermissionsTx 传参错位：空 map 当 current、slice 当 after），已由独立 repair 单元按 main 的差量语义修正。 - 验证：PASS——gofmt -l 干净；go build ./... 与 go vet ./internal/store/ ./internal/server/ ./internal/authz/... 均无输出（宿主独立执行）；go test -count=1 ./internal/store/ ./internal/server/ ./internal/authz/... 全绿（store 13.3s / server 29.5s / catalog ok）；独立 Review PASS、无阻塞项，逐 API 核对安全语义。 - 影响与剩余项：只新增能力面，不改 schema（移植未引入新表），不改 Makefile/CI/子模块；未新增范围外功能。非阻塞遗留：Review 指出 PostgreSQL 下不同角色跨 batch 处理的潜在 lock-ordering 风险，以及若干测试缺口，两者已记入报告留作后续增量。 | 时间(UTC) | 命令 | 被测 HEAD | exit | 来源 | 摘要/位置 | |---|---|---|---|---|---| | <时间> | <命令；由项目 evidence 工具写入，无工具时附命令+对象 SHA+输出 digest 并标 SELF> | <HEAD> | <exit> | GATE/REPLAY/SELF | <摘要/位置> | ## 回收（task-finish） - 合入核对：<分支已包含于目标分支的核对输出>。 - 未跟踪/ignored 文件处置：<归档/可再生/存疑 逐项；无则写无>。 - 回收动作：<worktree remove、分支删除、prune；放弃路径注明原因>。
weichen added 5 commits 2026-10-21 15:14:04 +00:00
chore(task): start fix/iam-perm-ux-port 2d1e5f5b16
agent-exec transport 64b951970cf4308149cee90d2ab93fbb/078c7847c409 76abebe790
agent-exec transport 362d13b3c56f54861bc1cae9cd38cc36/2b675cb19c4f f10fb2e65c
agent-exec transport 5aab730b1b5c159f2ce8f0cf9b2c50b5/5dfb74fd02f1 53e78ffb73
Record port scope, build fix and PASS review for the IAM permission API
governance / governance (pull_request) Successful in 29s
Details
ci / vet-and-test (pull_request) Successful in 1m31s
Details
c5a599e28d 
Why: the port's authorization boundary, the build correction and the review
verdict must be recorded before delivery.

Evidence:
  /tmp/be-iam-perm-ux-impl-r1-20261021.json: pi, success (port)
  /tmp/be-iam-perm-ux-buildfix-r2-20261021.json: pi, success (build fix;
    r1 failed-unknown produced no record so nothing was imported)
  /tmp/be-iam-perm-ux-review-r1-20261021.json: pi, PASS, no blockers
  Host-side checks on the final head: gofmt -l clean; go build ./... and
  go vet on store/server/authz silent; go test on those packages green.

Impact: card metadata only.
Refs: fix/iam-perm-ux-port; backup /home/weichen/projects/backups/iam-perm-ux-20261021T140345Z
weichen added 1 commit 2026-10-21 15:15:07 +00:00
Merge remote-tracking branch 'origin/main' into fix/iam-perm-ux-port
governance / governance (pull_request) Successful in 23s
Details
ci / vet-and-test (pull_request) Successful in 1m42s
Details
4a8cc0170b
weichen merged commit 16538f1c46 into main 2026-10-21 15:38:14 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
weichen
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: weichen/Agent-System-Backend#240