AirCoding/AirPlan/TODO.md

AirCoding V1.0.0 Alpha — 技术债务与待办清单

生成于：2026-06-02 | 基于全阶段审计结果

P0 — Monorepo 骨架

• T-001 Monorepo 骨架 (Bun workspaces + Turborepo)
• T-002..014 合约源文件 (16 个文件)
• T-015 合约 barrel + 导入边界 lint
• TODO: 为所有包添加 tsconfig.json paths 别名

P1 — 存储、事件、制品

• T-101 DatabaseManager
• T-102 MigrationRunner (17 张表，缺 provider_configs + capability_registry)
• T-103..119 16 个仓库
• T-120 SessionStore 聚合
• T-121..124 事件系统 (SchemaRegistry, EventStore, EventBus, EventIngestor)
• T-125..129 Project/Session/Artifact/Evidence/Recovery
• TODO(P1): 向 MigrationRunner 添加 provider_configs 表（P3 需要）
• TODO(P1): 向 MigrationRunner 添加 capability_registry 表（P2 需要）
• TODO(P1): INV-1：验证所有 status 列的 UPDATE 只能通过 EventStore.project() 进行 — 5 个仓库已审计并修复
• TODO(P1): INV-2：外键关联断开 — 在应用层强制执行引用完整性

P2 — 工具、权限、能力

• T-201 PathClassifier (8 个路径类别)
• T-202 CommandRiskAnalyzer (10 个风险类别)
• T-203 SecretRedactor
• T-204 PermissionEngine (6 层评估)
• T-205 ToolRegistry (分支表)
• T-206..213 内置工具 (21 个工具定义)
• T-214 BuiltInToolRegistrar
• T-215 CapabilityManifestValidator
• T-216 CapabilityRegistry
• TODO(P2): 将 CapabilityRegistry 连接到 DoctorService 以进行 INV-4 合规

P3 — 提供者与上下文

• T-301 ModelConfigLoader
• T-302 CapabilityMatrix (与合约 ProviderCapabilityMatrix 不同的自定义类型)
• T-303 AnthropicCanonicalConverter
• T-304 AnthropicAdapter (移除了 implements ProviderAdapter — 签名不匹配)
• T-305 OpenAICompatibleAdapter (同上)
• T-306 ProviderManager (同步方法 vs 合约异步接口)
• T-307 PromptLayerLoader
• T-308 内置提示资源 (L0 + 5 个角色提示)
• T-309 CompactionPolicy
• T-310 ContextAssembler
• BUG(P3-1): CapabilityMatrix.ts：本地 ProviderCapability 类型与 contracts/src/provider.ts 完全无关——要么对齐要么移除
• BUG(P3-2): AnthropicAdapter.ts:70：多余的 from_provider 转换，将 CanonicalMessage[] 强制转换为 unknown[]
• TODO(P3): ContextAssembler.ts:146-149：L6（EvidenceStore）、L7/L8（SessionStore 消息/工具输出）是存根
• TODO(P3): runtime/src/index.ts 缺少 context/index.js 重新导出（已在 P4 修复中添加）

P4 — Worker IPC 与调度器

• T-401 WorkerProtocol (NDJSON 编码/解码，方向验证)
• T-402 WorkerProcess (stdout=协议，退出码 0-5)
• T-403 WorkerManager (spawn + 握手，cancel)
• T-404 WorkerRuntime (INV-3：仅通过 IPC call_tool)
• T-405..409 Worker 角色 (Executor, Reviewer, Debugger, Compactor, ExperienceMiner)
• T-410 worker 入口点 (main.ts)
• T-411 TaskGraph (可运行任务，依赖图，循环检测)
• T-412 WavePlanner (计划 waves，分配工作空间)
• T-413 RetryPlanner (指数退避的 retry 决策)
• T-414 WorkspaceManager (创建/合并/清理/GC)
• T-415 AgentMonitor (心跳 + 超时，INV-1 豁免)
• T-416 Scheduler (状态机，INV-5 从 SQLite 重建)
• T-417 Recovery (8 步序列，5 步是存根)
• T-418 worker-fixture E2E 测试 (存根)
• BUG(P4-1): Scheduler.ts:146：agent_id.split('_')[1] 无法提取 task_id — 已修复
• BUG(P4-2): Scheduler.ts:128-131：DISPATCHING 是无操作 — 已修复
• BUG(P4-3): Scheduler.ts：任务从未过渡到 'running' — 已修复（添加了 mark_terminal running + AgentMonitor 集成）
• BUG(P4-4): AgentMonitor.ts：remove() 从未被调用 — 已修复（添加了 lost agent 清理）
• BUG(P4-5): WorkerManager.ts:180-193：send_and_wait 是定时休眠，不是真正的等待 — 死代码
• BUG(P4-6): WorkspaceManager.ts：在合并逻辑运行之前设置状态 — 已修复 INV-1 注释

P5 — C++ 工具链

• T-501 DiagnosticParser (GCC/Clang 正则，确定性签名)
• T-502 CppProjectDetector (CMake/Make 检测)
• T-503 CMakeConfigurator (CMake+Ninja，compile_commands.json)
• T-504 CppBuilder (构建 + 解析诊断)
• T-505 CppTestRunner (ctest 运行 + 解析)
• T-506 CppcheckRunner (cppcheck 调用)
• T-507 ClangdClient (LSP 客户端存根)
• T-508 CppToolRegistrar + capability.ts
• BUG(P5-1): DiagnosticParser.ts:10：ParsedDiagnostic 不匹配合约的 Diagnostic 类型（缺少 diagnostic_id、created_at）
• BUG(P5-2): CppTestRunner.ts:55-58：parse_ctest_output 正则完全错误 — 将百分比误认为计数
• BUG(P5-3): CppcheckRunner.ts:34：execSync 命令注入漏洞 —— 用 execFileSync + args 数组替换
• BUG(P5-4): CMakeConfigurator.ts:39-44：execSync 命令注入漏洞
• BUG(P5-5): CppcheckRunner.ts:34：cppcheck 输出的正则表达式是 GCC 格式 — 与 cppcheck 格式不匹配
• BUG(P5-6): CppProjectDetector.ts:67：command_exists() 只检查 /usr/bin 和 /usr/local/bin
• BUG(P5-7): CppProjectDetector.ts:72：find_cpp_sources() 始终返回 []
• TODO(P5): ClangdClient.ts:26,35：两个方法都是存根 — 实现 LSP JSON-RPC 协议
• TODO(P5): 合约 Diagnostic 类型：对齐 ParsedDiagnostic 或迁移合约

P6 — 投影与 TUI

• T-601 ProjectionStore (hydration，应用事件，订阅)
• T-602 ProjectionClient + TuiApp
• T-603..610 8 个 TUI 组件
• BUG(P6-1): types.ts:10-35：SessionProjection/TaskProjection/AgentProjection 不匹配合约投影类型
• BUG(P6-2): PermissionPrompt.tsx:8-15：使用直接回调，不是 UiCommandChannel（违反 INV-3）
• BUG(P6-3): TuiApp.tsx:72-81：render() 输出到 console.log — 未使用 OpenTUI
• BUG(P6-4): TuiApp.tsx:72-81：render() 不委托给任何导入的组件（未使用的导入）
• TODO(P6): 集成 OpenTUI @opentui/* 渲染器（npm-dep，不要重新实现）
• TODO(P6): 添加 theme/ 和 keymap/ 目录（T-610）
• TODO(P6): 所有组件返回的是 string 而不是 JSX 元素 — 要么接受要么迁移到 React/JSX

P7 — Agent 集成

• T-701 MainAgent (状态机，意图分类)
• T-702 ArchitectureDesigner (影响评估，结果类别)
• T-703 DebugKnowledgeStore (INV-2 outbox 模型)
• T-704 LearnedMemoryStore (INV-2 outbox 模型)
• T-705 Role 集成 wiring
• T-706 E2E fixtures (direct-mode + architecture-gate)
• BUG(P7-1): MainAgent.ts:85-93：AWAITING_CONFIRMATION 从未被 handle_user_message 设置 — 确认门是死代码
• BUG(P7-2): wiring.ts:51-52,72-73：INV-2 outbox 事件有文档说明但从未发出 — 存根
• BUG(P7-3): DebugKnowledgeStore.ts:63-71：debug.record.created 事件从未发出
• BUG(P7-4): LearnedMemoryStore.ts:62-69：memory.promoted 事件从未发出
• BUG(P7-5): ArchitectureDesigner.ts:24：architecture.impact.completed 事件从未发出
• TODO(P7): 将 MainAgent 连接到 EventBus/Scheduler 以进行实际的事件驱动状态转换
• TODO(P7): 在 DebugKnowledgeStore/LearnedMemoryStore 中实现实际的 outbox 事件发出

P8 — CLI、Doctor、发布

• T-801 Logger + DeveloperLogEncryptor
• T-802 DoctorService
• T-803 RuntimeApp + ServiceRegistry + createRuntime + loadConfig
• T-804..808 CLI 命令 (run, init, doctor, provider, resume, compact, history, session, restore, e2e, release)
• T-809 CliEntrypoint
• BUG(P8-1): Logger.ts:36：air.developer.log 从未写入 — DeveloperLogEncryptor 已断开连接
• BUG(P8-2): DeveloperLogEncryptor.ts:32-33：声称 INV-3（使用 SecretRedactor）但从未导入/调用
• BUG(P8-3): DeveloperLogEncryptor.ts:22：回退加密密钥硬编码为 'dev-key'
• BUG(P8-4): RuntimeApp.ts:36-45 vs ServiceRegistry.ts:36-63：并行重复的服务图 — RuntimeApp 未使用 ServiceRegistry
• BUG(P8-5): RuntimeApp.ts:51-65：start() 在 doctor 检查后不启动任何子系统
• BUG(P8-6): RuntimeApp.ts:70-74：shutdown() 是存根 — 不刷新日志、关闭数据库或停止 worker
• BUG(P8-7): DoctorService.ts:38：没有 read_only 模式（实现计划要求）
• BUG(P8-8): DoctorService.ts:70-72：fix() 是存根 — 不安装依赖（违反 INV-4）
• BUG(P8-9): DoctorService.ts：5/7 检查是硬编码的 passed: true 存根
• BUG(P8-10): ServiceRegistry.ts：缺少 EventBus、EventIngestor、ToolRegistry、PermissionEngine、DatabaseManager
• BUG(P8-11): createRuntime.ts:24-25：会话/项目 ID 从 Date.now() 生成 — 不从 .air/shared/project.json 加载
• BUG(P8-12): init.ts:17-57：创建了 .air/local/ 但从未写入 config.json
• TODO(P8): 所有 CLI 命令：通过 RuntimeApp→ToolRegistry→PermissionEngine 路由副作用（INV-3）
• TODO(P8): 命令注入：审查所有 execSync 调用并用 execFileSync + args 数组替换
• TODO(P8): releaseCommand：带有实际验证套件的存根
• TODO(P8): e2eCommand：带有硬编码 ✅ 的存根 — 实现实际验证

跨领域问题

• TODO: 合约对齐：P5（Diagnostic, ProviderCapability），P6（投影类型），P7（事件），全部需要与 contracts 包重新同步
• TODO: INV-2 outbox：所有 4 个知识/调试存储声称 outbox 模式但实际上不发出事件 — 在 wiring 或存储层实现事件发出
• TODO: INV-3 副作用：CLI 命令（init、doctor）和 TUI（PermissionPrompt）绕过 ToolRegistry+PermissionEngine
• TODO: 常量枚举：capability.ts 使用了错误的枚举值（'toolchain'→已修复，'trusted'→已修复）
• TODO: 安全：所有 execSync 调用需要迁移到 execFileSync + args 数组以防止命令注入
• TODO: 测试：3/4 个 E2E 测试是存根或仅单元测试 — 实现完整的集成测试
• TODO: 文档：contracts 包需要为所有导出的类型提供 JSDoc