Repository navigation
getting-started/for-developers 的 src/ 目录树仍画着 #512 删掉的 agents/，后缀表也仍列 *.agent.ts；docs-drift 的目录守卫看不到 content/docs #984
Description
Activity
🔒 认领(/pm-dispatch R34)— session
session_01VHrPAGEgFDoHjphqYG4BMa,分支claude/issue-984-for-developers-tree。文件面:
content/docs/getting-started/for-developers{,.zh-Hans,.zh-Hant}.mdx的目录树与后缀表(agents/ 目录、*.agent.ts 后缀——#512 已删)+test/docs-drift.test.ts的 TREE_DOCS 守卫扩面(让它看见这一页)——PR #987 刚改本页 :41(cubes/→datasets/),fresh main 重定位、零回退。裁定:①目录树与后缀表按 src/ 实况写实(逐目录核对);②守卫扩面遵循「测试语义零变化 + 新增覆盖」原则:TREE_DOCS 加入本页 + 正则适配(dev 立单时已记盲区成因:TREE_DOCS 只含维护者文档、正则要求 src/ 前缀),两阶段红→绿验证(改前文档对新守卫应红);③#595 不预判;三语同步;zh 内链不带锚。
Generated by Claude Code
✅ 验收通过 —— PR #991 已转 ready 并挂 auto-merge(CI 9/9 全绿实核,Playwright 迟到完成印证 dev 的 runner 拥塞判断)。
验收要点:
- 整树对账而非点名修补:18 目录逐一(1 幻影删、4 缺项补且注释按实况写、14 保持),同型第三处(Add an AI skill 指向 src/agents/)顺手抓出;后缀表不对称处理的边界如实说明。
- 守卫双轴扩面:文件轴 + 形态轴(treeSrcDirs 解析 ASCII 树,兼容两种树根);既有断言零改动;按页白名单而非遍历的取舍有实证(ai-skills.mdx:10 的合法否定式提及会被全量遍历误报)——守卫设计考虑了假阳性面。
- 红→绿两阶段(6 红恰为三语×2 断言)+ vacuity 反证(树重排则解析器报「解析不到」而非静默绿)——守卫自身的失灵模式也被钉住。
- docs(analytics): 把 analytics 落地页写实，并清掉散在 8 页上的 cube 词汇残留 (#976, #977) #987 落地行零回退;Playwright 拥塞的判断留证求核,姿势正确。
越界发现处置:#988(customization/index 同型残留:树+后缀表+:15 表格,且树另缺 5 目录)→ 标 pm:queue,R35 与 #612 同轮派发(其守卫扩面依赖本 PR 的两个列表,#991 已合并即解锁;#612 届时排除该页);守卫注释已预指 #988,修好即被覆盖——衔接设计到位。
Generated by Claude Code
来源：#977 实施（PR 见下）过程中的卫星命中。那一单只点了本页第 41 行的
cubes/，已随 PR 改为datasets/；同一段目录树里紧邻的另一条同型残留没有动，按 Prime Directive #10 另立。逐处
content/docs/getting-started/for-developers.mdx（三语同址，行号一致）：├── agents/ # AI agentssrc/agents/不存在。#512 移除了两个 app 自带的 copilot 与整个目录（能力面按 ADR-0063 §2 收敛为 skills-only），find src -name '*.agent.ts'零命中。docs-drift.test.ts的目录守卫注释里把这条写成已修完的历史，而它在本页仍然活着*.agent.ts顺带一提（同一段树，未逐行核）：该树画了
objects/ actions/ flows/ agents/ skills/ apps/,views/,pages/ dashboards/,reports/,datasets/ profiles/,sharing/ translations/ data/，而src/下真实还有hooks/、interfaces/、mappings/、docs/四个目录未出现。缺项和幻影不是同一类问题，是否要补由 triage 定。为什么没被守卫拦住
test/docs-drift.test.ts里的「maintainer docs do not point at directories that no longer exist」正是为这一类写的，它的注释甚至同时点名了src/agents/和src/cubes/。但它的扫描面TREE_DOCS只有 9 个维护者文档（README.md、AGENTS.md、docs/*），不含content/docs/下的产品文档；而且它的正则是\bsrc/([a-z][a-z0-9_]*)/，本页的树逐行写成├── agents/而没有src/前缀，即使把文件加进去也匹配不到。所以这是守卫的两层盲区叠在一起，不是它判错。修复面因此有两半：改文本，以及让守卫能看见这一页（要么把产品文档里的目录树纳入扫描面并解析 ASCII 树的条目，要么在本页把树写成守卫认得的形式）。
边界
src/cubes/目录的词汇残留散在 8 个页面上：cubes 页已收口，其余各页仍按旧口径写 #977 / 其 PR 行集互斥：那一单只动第 41 行的cubes/。Refs #977 #512