315b0bd80e
- 25 stub files: types/tools, types/utils, contextCollapse, mcpSkills, etc. - 11 reused from chore/bridge-green, 14 created from scratch - All stubs documented in docs/devlog/02-tsc-stubs.md - Build passes, tests not regressed
189 lines
10 KiB
Markdown
189 lines
10 KiB
Markdown
# TSC Stubs 记录
|
||
|
||
> 创建日期: 2026-06-07
|
||
> 关联计划: docs/plans/tsc-decompile-fix-plan.md
|
||
> 阶段: Phase 1 — 消除 "Cannot find module" 类型错误
|
||
|
||
## 成果总结
|
||
|
||
- **创建 stub 数**: 25 个
|
||
- **消除 "Cannot find module" 错误**: 75 个全部消除（75 → 0）
|
||
- **构建状态**: bun run build 通过 ✅
|
||
- **剩余 TS 错误**: 204 个（均为类型不匹配、属性不存在、变量未定义等其他错误类型）
|
||
|
||
## Stub 清单
|
||
|
||
### src/types/tools.ts
|
||
- **引用方**: 17 个文件（Tool.ts, BashModeProgress.tsx, sdkEventQueue.ts, processBashCommand.tsx, sdkProgress.ts, AgentTool.tsx, AgentTool/UI.tsx, MCPTool.ts, MCPTool/UI.tsx, PowerShellTool.tsx, PowerShellTool/UI.tsx, SkillTool.ts, TaskOutputTool.tsx, WebSearchTool.ts, BashTool.tsx ×2）
|
||
- **导出内容**: AgentToolProgress, BashProgress, MCPProgress, REPLToolProgress, SkillToolProgress, TaskOutputProgress, ToolProgressData, WebSearchProgress, ShellProgress, PowerShellProgress, SdkWorkflowProgress
|
||
- **补全优先级**: **高** — 这些类型被工具系统广泛引用，需要从上游恢复具体字段定义
|
||
- **备注**: 当前所有类型均为 `Record<string, unknown>`。bridge-green 版本同样是 `any` 类型的自动生成 stub
|
||
|
||
### src/types/utils.ts
|
||
- **引用方**: 16 个文件（AppStateStore.ts, Tool.ts, taskStatusUtils.tsx, 各 task dialog, messageQueueManager.ts, mappers.ts, messages.ts, 各 MonitorMcpTask dialog）
|
||
- **导出内容**: DeepImmutable<T>, Permutations<T>
|
||
- **补全优先级**: **高** — DeepImmutable 用于工具权限上下文类型
|
||
- **备注**: 当前为 identity passthrough。bridge-green 版本同样是 `any` 类型的自动生成 stub
|
||
|
||
### src/services/contextCollapse/operations.ts
|
||
- **引用方**: 2 个文件（context.tsx, context-noninteractive.ts — 通过动态 `require()`）
|
||
- **导出内容**: projectView(messages: Message[]) => Message[]
|
||
- **补全优先级**: **中** — 仅在 CONTEXT_COLLAPSE feature flag 启用时被调用
|
||
- **备注**: bridge-green 版本也是 no-op stub，导出为空
|
||
|
||
### src/commands/peers/index.ts
|
||
- **引用方**: 1 个文件（commands.ts — 动态 import）
|
||
- **导出内容**: default export (空对象)
|
||
- **补全优先级**: **低** — peer 功能被 feature-gated
|
||
- **备注**: bridge-green 版本也是空 stub
|
||
|
||
### src/commands/fork/index.ts
|
||
- **引用方**: 1 个文件（commands.ts — 动态 import）
|
||
- **导出内容**: default export (空对象)
|
||
- **补全优先级**: **低** — fork 功能被 feature-gated
|
||
- **备注**: bridge-green 版本也是空 stub
|
||
|
||
### src/components/messages/UserGitHubWebhookMessage.tsx
|
||
- **引用方**: 1 个文件（UserTextMessage.tsx — 通过动态 `require()`，KAIROS_GITHUB_WEBHOOKS feature flag）
|
||
- **导出内容**: UserGitHubWebhookMessage (React 组件，渲染 null)
|
||
- **补全优先级**: **低** — 仅在 KAIROS_GITHUB_WEBHOOKS 启用时使用
|
||
- **备注**: bridge-green 版本不存在此文件
|
||
|
||
### src/components/messages/UserForkBoilerplateMessage.tsx
|
||
- **引用方**: 1 个文件（UserTextMessage.tsx — 通过动态 `require()`，FORK_SUBAGENT feature flag）
|
||
- **导出内容**: UserForkBoilerplateMessage (React 组件，渲染 null)
|
||
- **补全优先级**: **低** — 仅在 FORK_SUBAGENT 启用时使用
|
||
- **备注**: bridge-green 版本不存在此文件
|
||
|
||
### src/components/messages/UserCrossSessionMessage.tsx
|
||
- **引用方**: 1 个文件（UserTextMessage.tsx — 通过动态 `require()`，UDS_INBOX feature flag）
|
||
- **导出内容**: UserCrossSessionMessage (React 组件，渲染 null)
|
||
- **补全优先级**: **低** — 仅在 UDS_INBOX 启用时使用
|
||
- **备注**: bridge-green 版本不存在此文件
|
||
|
||
### src/services/compact/snipProjection.ts
|
||
- **引用方**: 3 个文件（Message.tsx, QueryEngine.ts, messages.ts — 通过动态 `require()`，HISTORY_SNIP feature flag）
|
||
- **导出内容**: isSnipBoundaryMessage(message) => boolean, projectSnippedView(messages) => Message[]
|
||
- **补全优先级**: **中** — 历史对话压缩功能
|
||
- **备注**: bridge-green 版本也是 no-op stub
|
||
|
||
### src/components/messages/SnipBoundaryMessage.tsx
|
||
- **引用方**: 1 个文件（Message.tsx — 通过动态 `require()`，HISTORY_SNIP feature flag）
|
||
- **导出内容**: SnipBoundaryMessage (React 组件，渲染 null)
|
||
- **补全优先级**: **低** — 仅在 HISTORY_SNIP 启用时使用
|
||
- **备注**: bridge-green 版本不存在此文件
|
||
|
||
### src/components/permissions/ReviewArtifactPermissionRequest/ReviewArtifactPermissionRequest.tsx
|
||
- **引用方**: 1 个文件（PermissionRequest.tsx — 通过动态 `require()`，REVIEW_ARTIFACT feature flag）
|
||
- **导出内容**: ReviewArtifactPermissionRequest (React 组件，渲染 null)
|
||
- **补全优先级**: **低** — 仅在 REVIEW_ARTIFACT 启用时使用
|
||
- **备注**: bridge-green 版本不存在此文件
|
||
|
||
### src/environment-runner/main.ts
|
||
- **引用方**: 1 个文件（entrypoints/cli.tsx — 动态 import）
|
||
- **导出内容**: environmentRunnerMain(args: string[]) => Promise<void>
|
||
- **补全优先级**: **低** — BYOC runner，feature-gated
|
||
- **备注**: bridge-green 版本也是 no-op stub
|
||
|
||
### src/self-hosted-runner/main.ts
|
||
- **引用方**: 1 个文件（entrypoints/cli.tsx — 动态 import）
|
||
- **导出内容**: selfHostedRunnerMain(args: string[]) => Promise<void>
|
||
- **补全优先级**: **低** — BYOC runner，feature-gated
|
||
- **备注**: bridge-green 版本也是 no-op stub
|
||
|
||
### src/services/contextCollapse/persist.ts
|
||
- **引用方**: 3 个文件（ResumeConversation.tsx, sessionRestore.ts ×2 — 动态 `require()`）
|
||
- **导出内容**: restoreFromEntries(...args) => void
|
||
- **补全优先级**: **中** — 会话恢复功能
|
||
- **备注**: bridge-green 版本也是 no-op stub
|
||
|
||
### src/memdir/memoryShapeTelemetry.ts
|
||
- **引用方**: 2 个文件（findRelevantMemories.ts, sessionFileAccessHooks.ts — 动态 `require()`，MEMORY_SHAPE_TELEMETRY feature flag）
|
||
- **导出内容**: logMemoryRecallShape, logMemoryWriteShape
|
||
- **补全优先级**: **低** — 仅用于 telemetry/analytics
|
||
- **备注**: bridge-green 版本也是 no-op stub
|
||
|
||
### src/skills/mcpSkills.ts
|
||
- **引用方**: 2 个文件（services/mcp/client.ts, useManageMCPConnections.ts — 动态 `require()`，MCP_SKILLS feature flag）
|
||
- **导出内容**: fetchMcpSkillsForClient (返回 Promise<Command[]>)
|
||
- **补全优先级**: **中** — MCP 技能发现功能
|
||
- **备注**: bridge-green 版本也是 stub，带 cache map
|
||
|
||
### src/services/skillSearch/signals.ts
|
||
- **引用方**: 2 个文件（prefetch.ts, attachments.ts — 直接 import type）
|
||
- **导出内容**: DiscoverySignal (type)
|
||
- **补全优先级**: **中** — 技能搜索系统的基础类型
|
||
- **备注**: bridge-green 版本为 `any` 类型 stub，当前为完整对象类型
|
||
|
||
### src/tasks/design-system/Byline.tsx
|
||
- **引用方**: 2 个文件（MonitorMcpDetailDialog.tsx, WorkflowDetailDialog.tsx）
|
||
- **导出内容**: Byline (React 组件)
|
||
- **补全优先级**: **低** — MonitorMcpTask 仅在 monitor 模式下使用
|
||
- **备注**: bridge-green 版本不存在
|
||
|
||
### src/tasks/design-system/Dialog.tsx
|
||
- **引用方**: 2 个文件（MonitorMcpDetailDialog.tsx, WorkflowDetailDialog.tsx）
|
||
- **导出内容**: Dialog (React 组件)
|
||
- **补全优先级**: **低** — MonitorMcpTask 仅在 monitor 模式下使用
|
||
- **备注**: bridge-green 版本不存在
|
||
|
||
### src/tasks/design-system/KeyboardShortcutHint.tsx
|
||
- **引用方**: 2 个文件（MonitorMcpDetailDialog.tsx, WorkflowDetailDialog.tsx）
|
||
- **导出内容**: KeyboardShortcutHint (React 组件)
|
||
- **补全优先级**: **低** — MonitorMcpTask 仅在 monitor 模式下使用
|
||
- **备注**: bridge-green 版本不存在
|
||
|
||
### src/tools/ToolSearchTool/constants.ts
|
||
- **引用方**: 1 个文件（prompt.ts — 直接 import）
|
||
- **导出内容**: TOOL_SEARCH_TOOL_NAME = 'ToolSearch'
|
||
- **补全优先级**: **高** — ToolSearch 工具需要此常量
|
||
- **备注**: 此文件内容从 bridge-green 版本直接复制，是真实实现
|
||
|
||
### src/utils/toolSearch.ts
|
||
- **引用方**: 1 个文件（ToolSearchTool.ts — 直接 import）
|
||
- **导出内容**: isToolSearchEnabledOptimistic() => boolean
|
||
- **补全优先级**: **高** — ToolSearch 工具需要此函数判断是否启用 ToolSearch
|
||
- **备注**: bridge-green 版本有完整实现（~400 行），当前仅导出最小接口
|
||
|
||
### src/types/messageQueueTypes.ts
|
||
- **引用方**: 3 个文件（logs.ts, messageQueueManager.ts, sessionStorage.ts）
|
||
- **导出内容**: QueueOperation, QueueOperationMessage
|
||
- **补全优先级**: **高** — 消息队列系统的基础类型
|
||
- **备注**: bridge-green 版本也是 stub，内容基本一致
|
||
|
||
### src/utils/postCommitAttribution.ts
|
||
- **引用方**: 1 个文件（worktree.ts — 动态 import()，COMMIT_ATTRIBUTION feature flag）
|
||
- **导出内容**: installPrepareCommitMsgHook
|
||
- **补全优先级**: **低** — 仅在 COMMIT_ATTRIBUTION 启用时使用
|
||
- **备注**: bridge-green 版本也是 no-op stub
|
||
|
||
## 补全优先级排序
|
||
|
||
### 高优先级（需要尽快恢复真实实现）
|
||
1. **src/types/tools.ts** — 17 处引用，工具系统核心类型
|
||
2. **src/types/utils.ts** — 16 处引用，类型工具
|
||
3. **src/utils/toolSearch.ts** — ToolSearch 工具依赖
|
||
4. **src/types/messageQueueTypes.ts** — 消息队列系统类型
|
||
5. **src/tools/ToolSearchTool/constants.ts** — 常量（已为真实值）
|
||
|
||
### 中优先级（feature-gated 但有多个引用）
|
||
6. **src/services/contextCollapse/operations.ts** — feature: CONTEXT_COLLAPSE
|
||
7. **src/services/contextCollapse/persist.ts** — 会话恢复
|
||
8. **src/services/compact/snipProjection.ts** — feature: HISTORY_SNIP
|
||
9. **src/skills/mcpSkills.ts** — feature: MCP_SKILLS
|
||
10. **src/services/skillSearch/signals.ts** — 技能搜索
|
||
|
||
### 低优先级（feature-gated，单引用或少使用）
|
||
11. — 25. 其余所有 stub（主要在 feature flag 保护下，运行时不会被调用）
|
||
|
||
## 未消除的错误
|
||
|
||
所有 75 个 "Cannot find module" 错误已全部消除。剩余的 204 个 TS 错误属于其他类型：
|
||
- `TS2322: Type 'X' is not assignable to type 'Y'`
|
||
- `TS2339: Property 'X' does not exist on type 'Y'`
|
||
- `TS2304: Cannot find name 'X'`
|
||
- `TS2345: Argument of type 'X' is not assignable to parameter of type 'Y'`
|
||
- 等
|
||
|
||
这些将在后续阶段（Phase 2+）中逐步处理。
|