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

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

## P0 — Monorepo 骨架

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

## P1 — 存储、事件、制品

- [x] T-101 DatabaseManager
- [x] T-102 MigrationRunner (17 张表，缺 provider_configs + capability_registry)
- [x] T-103..119 16 个仓库
- [x] T-120 SessionStore 聚合
- [x] T-121..124 事件系统 (SchemaRegistry, EventStore, EventBus, EventIngestor)
- [x] 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 — 工具、权限、能力

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

## P3 — 提供者与上下文

- [x] T-301 ModelConfigLoader
- [x] T-302 CapabilityMatrix (与合约 ProviderCapabilityMatrix 不同的自定义类型)
- [x] T-303 AnthropicCanonicalConverter
- [x] T-304 AnthropicAdapter (移除了 `implements ProviderAdapter` — 签名不匹配)
- [x] T-305 OpenAICompatibleAdapter (同上)
- [x] T-306 ProviderManager (同步方法 vs 合约异步接口)
- [x] T-307 PromptLayerLoader
- [x] T-308 内置提示资源 (L0 + 5 个角色提示)
- [x] T-309 CompactionPolicy
- [x] 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 与调度器

- [x] T-401 WorkerProtocol (NDJSON 编码/解码，方向验证)
- [x] T-402 WorkerProcess (stdout=协议，退出码 0-5)
- [x] T-403 WorkerManager (spawn + 握手，cancel)
- [x] T-404 WorkerRuntime (INV-3：仅通过 IPC call_tool)
- [x] T-405..409 Worker 角色 (Executor, Reviewer, Debugger, Compactor, ExperienceMiner)
- [x] T-410 worker 入口点 (main.ts)
- [x] T-411 TaskGraph (可运行任务，依赖图，循环检测)
- [x] T-412 WavePlanner (计划 waves，分配工作空间)
- [x] T-413 RetryPlanner (指数退避的 retry 决策)
- [x] T-414 WorkspaceManager (创建/合并/清理/GC)
- [x] T-415 AgentMonitor (心跳 + 超时，INV-1 豁免)
- [x] T-416 Scheduler (状态机，INV-5 从 SQLite 重建)
- [x] T-417 Recovery (8 步序列，5 步是存根)
- [x] 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++ 工具链

- [x] T-501 DiagnosticParser (GCC/Clang 正则，确定性签名)
- [x] T-502 CppProjectDetector (CMake/Make 检测)
- [x] T-503 CMakeConfigurator (CMake+Ninja，compile_commands.json)
- [x] T-504 CppBuilder (构建 + 解析诊断)
- [x] T-505 CppTestRunner (ctest 运行 + 解析)
- [x] T-506 CppcheckRunner (cppcheck 调用)
- [x] T-507 ClangdClient (LSP 客户端存根)
- [x] 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

- [x] T-601 ProjectionStore (hydration，应用事件，订阅)
- [x] T-602 ProjectionClient + TuiApp
- [x] 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 集成

- [x] T-701 MainAgent (状态机，意图分类)
- [x] T-702 ArchitectureDesigner (影响评估，结果类别)
- [x] T-703 DebugKnowledgeStore (INV-2 outbox 模型)
- [x] T-704 LearnedMemoryStore (INV-2 outbox 模型)
- [x] T-705 Role 集成 wiring
- [x] 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、发布

- [x] T-801 Logger + DeveloperLogEncryptor
- [x] T-802 DoctorService
- [x] T-803 RuntimeApp + ServiceRegistry + createRuntime + loadConfig
- [x] T-804..808 CLI 命令 (run, init, doctor, provider, resume, compact, history, session, restore, e2e, release)
- [x] 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