Skip to content

[chore] 死代码与重复实现清理(manifest-compiler / doc-graph-extractor / utils 垫片 / legacy hook 子命令等) #86

Description

@jeff-r2026

近期多 PR 合入后积累了一批未接入主流程的模块与重复实现,建议清理以降低维护成本。

明确未接入主流程(建议删除或接线)

  • src/wiki-engine/manifest-compiler.ts:注释称由 teamai codebase --compile 调用,但该子命令不存在src/codebase-cmd.ts--compile 分支),全库无 import。
  • src/wiki-engine/doc-graph-extractor.ts:仅被单测引用,未接入 extract/import 任何流程。
  • src/utils/source-conflict.tsrecordSourceUpdate:生产路径只 source-marks.jsonl、从不写入(codebase-lint 侧),多源冲突检测实际拿不到数据。
  • 死导出函数:buildCodeGraphIndex / writeCodeGraphsrc/wiki-engine/code-knowledge/code-graph.ts)、scanInterfacesFromFactsinterface-scanner.ts)、fromLegacyConfidencereconciler-v2-types.ts:18)——均无生产调用。
  • save-session 命令链(src/session-collector.ts + index.ts:482-488):无 push --sessions 落地路径,与 contribute-check 职责重叠,仅测试调用。

重复实现 / 兼容垫片(可删,需改测试 import)

  • src/utils/gf-cli.tssrc/utils/repo-url.ts:只是 re-export src/providers/tgit/*,仅测试还在引用。
  • 双轨产物并存:docs/team-codebase/(旧扁平 MD)vs teamwiki/(新图谱);import-mr 仍调旧的 applyCodebaseSuggestions,而 CI 已切换到 teamwiki(src/ci/extract-mr.ts:16 注释 vs src/import-mr.ts:389),行为不一致。
  • 9 个 legacy hidden hook 子命令(track/mr-hint/auto-recall 等)在 hook-dispatch 统一后仅为旧 settings 兼容(src/hooks.ts:24src/index.ts:445-724),迁移期结束后可移除注册。
  • @deprecated CodeGraphIndex 别名仍被 codebase-wiki-lint.ts import(src/wiki-engine/code-knowledge/code-graph.ts:17),可渐进 rename 为 GraphIndex

建议

分批清理:先删纯死代码(manifest-compiler / doc-graph-extractor / 死导出函数),再收敛重复(utils 垫片、codebase 双轨),最后在 hook 迁移完成后移除 legacy 子命令注册。

严重程度:低(技术债,不影响功能)。

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions