Render structured regulation citations in the audit workspace and cockpit reader #109

Merged
weichen merged 4 commits from feature/regulations-kb-citations into main 2026-10-18 11:03:21 +00:00
Owner

法规结构化引用前端呈现(U7) 任务卡

任务主记录:本文件随 PR 描述维护(PR 链接见下方“结果与验证”)。
状态:进行中;owner:weichen。

基线与授权

  • 权威仓:weichen/Agent-System-Frontend;root_target:main;immediate_target:main
  • branch_kind:standalone;initiative_id:无(跨仓大任务 Agent-System-Dev feature/regulations-kb 的 U7 前端子交付,Dev PR #614 登记)
  • R0(initial_main_sha):0459567(origin/main);工作区:/home/weichen/projects/Agent-System-Frontend-wt-feature-regulations-kb-citations(worktree);分支:feature/regulations-kb-citations
  • 父任务信息(仅子任务填写):无
  • accepting_requirements:false
  • 需求分流:verdict=JOIN(由 Dev 大任务承接);selected_initiative=Agent-System-Dev feature/regulations-kb;理由=计划 U7 前端范围
  • 授权与交付终点:owner 以 /goal 授权按法规知识库计划全部实施;终点为本 PR 合入 main,再由 RDM/Dev 组合钉住。
  • 实施执行:agent-per-unit(配置:AGENT-EXECUTION.md;外部 Agent 一单元一新进程/会话/工作区)

目标与非目标

目标:按 Dev 规格 docs/superpowers/specs/2026-10-18-regulations-citation-contract.md 第 5、6 节,在审计工作区新增“法规核验”树(rdm.inspect.tree kind=regs)与批/引用详情;驾驶舱阅读器把正文中的 [cit-…] 渲染为编号引用标记并可展开元数据与原文片段;未核验、无效与待复核状态清晰区分。

非目标:不改 RDM 写路径与命令;不改设计令牌;不做部署。

Agent 实施收据

单元 ID 预期范围 角色 候选顺序 attempt CLI/模型 终态 transport fallback 源码外收据路径
frontend-u7-regulation-citations src/、test/ implementation cursor→antigravity→pi 1(35d799203497) cursor / not-observable(新进程,fresh_session=true) success 6a3f244(apply 快进,run 4cf12d61) 否 /tmp/regkb-u7fe-receipt.json

同步记录

节点 sync_base_sha tested_head_sha checked_at 结果
启动 0459567 0459567 2026-10-18 一致
验收前 0459567(origin/main) 6a3f244 2026-10-18 一致,无需同步

结果与验证(完成后填写)

  • 结果:新增 src/regCitations.ts(契约类型、[cit-…] 标记解析与编号、状态/过期/省略原因文案、样式档、审计树请求参数)与 src/components/RegCitation.tsx(编号标记、引用卡片、引用清单,折叠用 @ui Collapsible,正文与片段仅作文本渲染);审计工作区新增“法规核验”树(证据批→引用)与批/引用详情(状态、原因、腿状态、封存、引用元数据、受披露约束的片段);驾驶舱阅读器正文渲染引用标记与引用清单。只有 verified 且未过期显示为有效依据,其余状态与无效引用使用明确的未核验/无效样式。样式只用令牌(src/reg-citations.css)。
  • 验证:host 在临时 Dev 组合布局(modules/ui c918747)重跑 bash /tmp/regkb-fe-verify.sh all(SELF):vitest 37 文件 345 用例通过(含 design-guard 与新增 reg-citations 测试),knip 未用导出 50 ≤ 51,tsc -b 与 vite build 通过,日志 /tmp/regkb-u7fe-verify.log;git diff --check 通过。权威结论以 PR HEAD CI 与 Dev 组合 make test 为准。
  • Review:host 独立审阅实施 diff(未复用实施会话):未使用 dangerouslySetInnerHTML 与 <details>,外链仅 http(s),字段名与 RDM U6 JSON 一致;无阻塞项。
  • 影响与剩余项:数据由 RDM U7(rdm.inspect.tree kind=regs、rdm.inspect.object、rdm.cockpit.node citations)提供;RDM 未提供时界面为空态,不影响既有标签页。Dev 组合 pin 在 U8 推进。
# 法规结构化引用前端呈现(U7) 任务卡 任务主记录:本文件随 PR 描述维护(PR 链接见下方“结果与验证”)。 状态:进行中;owner:weichen。 ## 基线与授权 - 权威仓:weichen/Agent-System-Frontend;root_target:main;immediate_target:main - branch_kind:standalone;initiative_id:无(跨仓大任务 Agent-System-Dev `feature/regulations-kb` 的 U7 前端子交付,Dev PR #614 登记) - R0(initial_main_sha):0459567(origin/main);工作区:/home/weichen/projects/Agent-System-Frontend-wt-feature-regulations-kb-citations(worktree);分支:feature/regulations-kb-citations - 父任务信息(仅子任务填写):无 - accepting_requirements:false - 需求分流:verdict=JOIN(由 Dev 大任务承接);selected_initiative=Agent-System-Dev feature/regulations-kb;理由=计划 U7 前端范围 - 授权与交付终点:owner 以 /goal 授权按法规知识库计划全部实施;终点为本 PR 合入 main,再由 RDM/Dev 组合钉住。 - 实施执行:agent-per-unit(配置:AGENT-EXECUTION.md;外部 Agent 一单元一新进程/会话/工作区) ## 目标与非目标 目标:按 Dev 规格 `docs/superpowers/specs/2026-10-18-regulations-citation-contract.md` 第 5、6 节,在审计工作区新增“法规核验”树(`rdm.inspect.tree kind=regs`)与批/引用详情;驾驶舱阅读器把正文中的 `[cit-…]` 渲染为编号引用标记并可展开元数据与原文片段;未核验、无效与待复核状态清晰区分。 非目标:不改 RDM 写路径与命令;不改设计令牌;不做部署。 ## Agent 实施收据 | 单元 ID | 预期范围 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 | |---|---|---|---|---|---|---|---|---|---| | frontend-u7-regulation-citations | src/、test/ | implementation | cursor→antigravity→pi | 1(35d799203497) | cursor / not-observable(新进程,fresh_session=true) | success | 6a3f244(apply 快进,run 4cf12d61) | 否 | /tmp/regkb-u7fe-receipt.json | ## 同步记录 | 节点 | sync_base_sha | tested_head_sha | checked_at | 结果 | |---|---|---|---|---| | 启动 | 0459567 | 0459567 | 2026-10-18 | 一致 | | 验收前 | 0459567(origin/main) | 6a3f244 | 2026-10-18 | 一致,无需同步 | ## 结果与验证(完成后填写) - 结果:新增 `src/regCitations.ts`(契约类型、`[cit-…]` 标记解析与编号、状态/过期/省略原因文案、样式档、审计树请求参数)与 `src/components/RegCitation.tsx`(编号标记、引用卡片、引用清单,折叠用 @ui Collapsible,正文与片段仅作文本渲染);审计工作区新增“法规核验”树(证据批→引用)与批/引用详情(状态、原因、腿状态、封存、引用元数据、受披露约束的片段);驾驶舱阅读器正文渲染引用标记与引用清单。只有 verified 且未过期显示为有效依据,其余状态与无效引用使用明确的未核验/无效样式。样式只用令牌(`src/reg-citations.css`)。 - 验证:host 在临时 Dev 组合布局(modules/ui c918747)重跑 `bash /tmp/regkb-fe-verify.sh all`(SELF):vitest 37 文件 345 用例通过(含 design-guard 与新增 reg-citations 测试),knip 未用导出 50 ≤ 51,`tsc -b` 与 `vite build` 通过,日志 /tmp/regkb-u7fe-verify.log;`git diff --check` 通过。权威结论以 PR HEAD CI 与 Dev 组合 `make test` 为准。 - Review:host 独立审阅实施 diff(未复用实施会话):未使用 dangerouslySetInnerHTML 与 `<details>`,外链仅 http(s),字段名与 RDM U6 JSON 一致;无阻塞项。 - 影响与剩余项:数据由 RDM U7(`rdm.inspect.tree kind=regs`、`rdm.inspect.object`、`rdm.cockpit.node` citations)提供;RDM 未提供时界面为空态,不影响既有标签页。Dev 组合 pin 在 U8 推进。
weichen added 3 commits 2026-10-18 10:58:57 +00:00
Why: U7 frontend rendering of structured regulation citations needs a task record.
Evidence: Card only.
Impact: None on code.
Refs: Agent-System-Dev docs/superpowers/specs/2026-10-18-regulations-citation-contract.md
Co-authored-by: Cursor <cursoragent@cursor.com>
Record regulation citation frontend results in the task card
governance / governance (pull_request) Successful in 18s
a9e2c3fa25
Why: Task card is the PR description.
Evidence: vitest, knip, tsc and vite build passed in the composed layout (SELF); CI pending.
Impact: Card only.
Refs: Agent-System-Dev PR #614
Co-authored-by: Cursor <cursoragent@cursor.com>
weichen added 1 commit 2026-10-18 10:59:02 +00:00
Close the regulation citation frontend task card before merge
governance / governance (pull_request) Successful in 17s
7050c91334
Why: Cards close and archive in the merging PR.
Evidence: Status, PR link and archive move only.
Impact: Card only.
Refs: https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Frontend/pulls/109
Co-authored-by: Cursor <cursoragent@cursor.com>
weichen merged commit 2d65a819f1 into main 2026-10-18 11:03:21 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: weichen/Agent-System-Frontend#109