Files
Agent-System/.doc/ops/short-term/2026-09-20-project-trace-index-t2.md
T
weichenandCursor ae86b47f6f docs(ops): record the stage backtrack implementation slices
The slices share feature/stage-backtrack-impl. Migration 00059 is not applied to the running environments yet.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-20 15:35:22 +00:00

2.1 KiB

title, status, created, updated, owner, branch, worktree, mutex
title status created updated owner branch worktree mutex
T2 项目追踪索引 done 2026-09-20 2026-09-20 Cursor-Auto feature/stage-backtrack-impl - trace-index

T2 项目追踪索引

目标

落地五表追踪索引,把 UR/RS/REQ/TC 投影成项目级条目,并提供「需求与影响」页的第一版。

范围

  • 迁移:project_trace_items、project_trace_item_revisions、project_trace_edges、project_trace_edge_decisions、project_trace_index_state。
  • 从已批准或已提交文档块抽取显式编号;无类型正文 ID 只做候选。
  • 项目页:覆盖健康、待处理影响、按种类筛选的条目列表。
  • 留存按设计 §9 执行:record,修复重放须保留决议。

非目标

  • 不做深度 3 多跳和候选确认 UI(T3)。
  • 不做阶段再打开(B1)。
  • 不签 D7 对话 ADR,不提供物理删除。
  • 首期页面验收范围是 main 与 software_delivery 上能看见条目;rdev 抽取可运行,但不作为本片放量条件。

步骤

  1. 实现落在 feature/stage-backtrack-impl。
  2. 迁移 00059 与只追加修订。
  3. 显式键投影与索引水位。
  4. 项目页只读列表;不可见文档只计数量。

验收标准

  • 同一业务键在同一项目内 upsert,不复制多套身份。跨项目键互不影响。单测 TestIndex_SameSnapshotDoesNotDuplicateRevision。
  • 同一 snapshot、同一 hash、同一抽取器版本不写第二份修订。
  • RedactItems 不返回不可见文档陈述。裁决不因管理员身份放行,仍走 CanDecide。
  • 00059 Down 不含 DROP/DELETE/TRUNCATE。单测 TestMigrationDownKeepsDecisionLedger。

相关链接

证据 / 备注

D7 追踪分类已定,本片不再等待对话留存签字。对话 ADR 本身仍 pending。