feat: 大规模清理 claude 的类型问题及依赖

Author: claude-code-best

CLAUDE.md

@@ -0,0 +1,115 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a **reverse-engineered / decompiled** version of Anthropic's official Claude Code CLI tool. The goal is to restore core functionality while trimming secondary capabilities. Many modules are stubbed or feature-flagged off. The codebase has ~1341 tsc errors from decompilation (mostly `unknown`/`never`/`{}` types) — these do **not** block Bun runtime execution.
+
+## Commands
+
+```bash
+# Install dependencies
+bun install
+
+# Dev mode (direct execution via Bun)
+bun run dev
+# equivalent to: bun run src/entrypoints/cli.tsx
+
+# Pipe mode
+echo "say hello" | bun run src/entrypoints/cli.tsx -p
+
+# Build (outputs dist/cli.js, ~25MB)
+bun run build
+```
+
+No test runner is configured. No linter is configured.
+
+## Architecture
+
+### Runtime & Build
+
+- **Runtime**: Bun (not Node.js). All imports, builds, and execution use Bun APIs.
+- **Build**: `bun build src/entrypoints/cli.tsx --outdir dist --target bun` — single-file bundle.
+- **Module system**: ESM (`"type": "module"`), TSX with `react-jsx` transform.
+- **Monorepo**: Bun workspaces — internal packages live in `packages/` resolved via `workspace:*`.
+
+### Entry & Bootstrap
+
+1. **`src/entrypoints/cli.tsx`** — True entrypoint. Injects runtime polyfills at the top:
+   - `feature()` always returns `false` (all feature flags disabled, skipping unimplemented branches).
+   - `globalThis.MACRO` — simulates build-time macro injection (VERSION, BUILD_TIME, etc.).
+   - `BUILD_TARGET`, `BUILD_ENV`, `INTERFACE_TYPE` globals.
+2. **`src/main.tsx`** — Commander.js CLI definition. Parses args, initializes services (auth, analytics, policy), then launches the REPL or runs in pipe mode.
+3. **`src/entrypoints/init.ts`** — One-time initialization (telemetry, config, trust dialog).
+
+### Core Loop
+
+- **`src/query.ts`** — The main API query function. Sends messages to Claude API, handles streaming responses, processes tool calls, and manages the conversation turn loop.
+- **`src/QueryEngine.ts`** — Higher-level orchestrator wrapping `query()`. Manages conversation state, compaction, file history snapshots, attribution, and turn-level bookkeeping. Used by the REPL screen.
+- **`src/screens/REPL.tsx`** — The interactive REPL screen (React/Ink component). Handles user input, message display, tool permission prompts, and keyboard shortcuts.
+
+### API Layer
+
+- **`src/services/api/claude.ts`** — Core API client. Builds request params (system prompt, messages, tools, betas), calls the Anthropic SDK streaming endpoint, and processes `BetaRawMessageStreamEvent` events.
+- Supports multiple providers: Anthropic direct, AWS Bedrock, Google Vertex, Azure.
+- Provider selection in `src/utils/model/providers.ts`.
+
+### Tool System
+
+- **`src/Tool.ts`** — Tool interface definition (`Tool` type) and utilities (`findToolByName`, `toolMatchesName`).
+- **`src/tools.ts`** — Tool registry. Assembles the tool list; some tools are conditionally loaded via `feature()` flags or `process.env.USER_TYPE`.
+- **`src/tools/<ToolName>/`** — Each tool in its own directory (e.g., `BashTool`, `FileEditTool`, `GrepTool`, `AgentTool`).
+- Tools define: `name`, `description`, `inputSchema` (JSON Schema), `call()` (execution), and optionally a React component for rendering results.
+
+### UI Layer (Ink)
+
+- **`src/ink.ts`** — Ink render wrapper with ThemeProvider injection.
+- **`src/ink/`** — Custom Ink framework (forked/internal): custom reconciler, hooks (`useInput`, `useTerminalSize`, `useSearchHighlight`), virtual list rendering.
+- **`src/components/`** — React components rendered in terminal via Ink. Key ones:
+  - `App.tsx` — Root provider (AppState, Stats, FpsMetrics).
+  - `Messages.tsx` / `MessageRow.tsx` — Conversation message rendering.
+  - `PromptInput/` — User input handling.
+  - `permissions/` — Tool permission approval UI.
+- Components use React Compiler runtime (`react/compiler-runtime`) — decompiled output has `_c()` memoization calls throughout.
+
+### State Management
+
+- **`src/state/AppState.tsx`** — Central app state type and context provider. Contains messages, tools, permissions, MCP connections, etc.
+- **`src/state/store.ts`** — Zustand-style store for AppState.
+- **`src/bootstrap/state.ts`** — Module-level singletons for session-global state (session ID, CWD, project root, token counts).
+
+### Context & System Prompt
+
+- **`src/context.ts`** — Builds system/user context for the API call (git status, date, CLAUDE.md contents, memory files).
+- **`src/utils/claudemd.ts`** — Discovers and loads CLAUDE.md files from project hierarchy.
+
+### Feature Flag System
+
+All `feature('FLAG_NAME')` calls come from `bun:bundle` (a build-time API). In this decompiled version, `feature()` is polyfilled to always return `false` in `cli.tsx`. This means all Anthropic-internal features (COORDINATOR_MODE, KAIROS, PROACTIVE, etc.) are disabled.
+
+### Stubbed/Deleted Modules
+
+| Module | Status |
+|--------|--------|
+| Computer Use (`@ant/*`) | Stub packages in `packages/@ant/` |
+| `*-napi` packages (audio, image, url, modifiers) | Stubs in `packages/` (except `color-diff-napi` which is fully implemented) |
+| Analytics / GrowthBook / Sentry | Empty implementations |
+| Magic Docs / Voice Mode / LSP Server | Removed |
+| Plugins / Marketplace | Removed |
+| MCP OAuth | Simplified |
+
+### Key Type Files
+
+- **`src/types/global.d.ts`** — Declares `MACRO`, `BUILD_TARGET`, `BUILD_ENV` and internal Anthropic-only identifiers.
+- **`src/types/internal-modules.d.ts`** — Type declarations for `bun:bundle`, `bun:ffi`, `@anthropic-ai/mcpb`.
+- **`src/types/message.ts`** — Message type hierarchy (UserMessage, AssistantMessage, SystemMessage, etc.).
+- **`src/types/permissions.ts`** — Permission mode and result types.
+
+## Working with This Codebase
+
+- **Don't try to fix all tsc errors** — they're from decompilation and don't affect runtime.
+- **`feature()` is always `false`** — any code behind a feature flag is dead code in this build.
+- **React Compiler output** — Components have decompiled memoization boilerplate (`const $ = _c(N)`). This is normal.
+- **`bun:bundle` import** — In `src/main.tsx` and other files, `import { feature } from 'bun:bundle'` works at build time. At dev-time, the polyfill in `cli.tsx` provides it.
+- **`src/` path alias** — tsconfig maps `src/*` to `./src/*`. Imports like `import { ... } from 'src/utils/...'` are valid.

package.json

@@ -18,111 +18,111 @@
         "@ant/computer-use-mcp": "workspace:*",
         "@ant/computer-use-swift": "workspace:*",
         "@anthropic-ai/bedrock-sdk": "^0.26.4",
-        "@anthropic-ai/claude-agent-sdk": "latest",
+        "@anthropic-ai/claude-agent-sdk": "^0.2.87",
         "@anthropic-ai/foundry-sdk": "^0.2.3",
-        "@anthropic-ai/mcpb": "latest",
-        "@anthropic-ai/sandbox-runtime": "latest",
-        "@anthropic-ai/sdk": "latest",
+        "@anthropic-ai/mcpb": "^2.1.2",
+        "@anthropic-ai/sandbox-runtime": "^0.0.44",
+        "@anthropic-ai/sdk": "^0.80.0",
         "@anthropic-ai/vertex-sdk": "^0.14.4",
-        "@aws-sdk/client-bedrock": "latest",
-        "@aws-sdk/client-bedrock-runtime": "latest",
+        "@aws-sdk/client-bedrock": "^3.1020.0",
+        "@aws-sdk/client-bedrock-runtime": "^3.1020.0",
         "@aws-sdk/client-sts": "^3.1020.0",
         "@aws-sdk/credential-provider-node": "^3.972.28",
-        "@aws-sdk/credential-providers": "latest",
+        "@aws-sdk/credential-providers": "^3.1020.0",
         "@azure/identity": "^4.13.1",
-        "@commander-js/extra-typings": "latest",
-        "@growthbook/growthbook": "latest",
-        "@modelcontextprotocol/sdk": "latest",
-        "@opentelemetry/api": "latest",
-        "@opentelemetry/api-logs": "latest",
-        "@opentelemetry/core": "latest",
-        "@opentelemetry/exporter-logs-otlp-grpc": "latest",
-        "@opentelemetry/exporter-logs-otlp-http": "latest",
+        "@commander-js/extra-typings": "^14.0.0",
+        "@growthbook/growthbook": "^1.6.5",
+        "@modelcontextprotocol/sdk": "^1.29.0",
+        "@opentelemetry/api": "^1.9.1",
+        "@opentelemetry/api-logs": "^0.214.0",
+        "@opentelemetry/core": "^2.6.1",
+        "@opentelemetry/exporter-logs-otlp-grpc": "^0.214.0",
+        "@opentelemetry/exporter-logs-otlp-http": "^0.214.0",
         "@opentelemetry/exporter-logs-otlp-proto": "^0.214.0",
-        "@opentelemetry/exporter-metrics-otlp-grpc": "latest",
-        "@opentelemetry/exporter-metrics-otlp-http": "latest",
+        "@opentelemetry/exporter-metrics-otlp-grpc": "^0.214.0",
+        "@opentelemetry/exporter-metrics-otlp-http": "^0.214.0",
         "@opentelemetry/exporter-metrics-otlp-proto": "^0.214.0",
-        "@opentelemetry/exporter-prometheus": "latest",
-        "@opentelemetry/exporter-trace-otlp-grpc": "latest",
-        "@opentelemetry/exporter-trace-otlp-http": "latest",
+        "@opentelemetry/exporter-prometheus": "^0.214.0",
+        "@opentelemetry/exporter-trace-otlp-grpc": "^0.214.0",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.214.0",
         "@opentelemetry/exporter-trace-otlp-proto": "^0.214.0",
-        "@opentelemetry/resources": "latest",
-        "@opentelemetry/sdk-logs": "latest",
-        "@opentelemetry/sdk-metrics": "latest",
-        "@opentelemetry/sdk-trace-base": "latest",
-        "@opentelemetry/semantic-conventions": "latest",
-        "@smithy/core": "latest",
-        "@smithy/node-http-handler": "latest",
-        "ajv": "latest",
-        "asciichart": "latest",
+        "@opentelemetry/resources": "^2.6.1",
+        "@opentelemetry/sdk-logs": "^0.214.0",
+        "@opentelemetry/sdk-metrics": "^2.6.1",
+        "@opentelemetry/sdk-trace-base": "^2.6.1",
+        "@opentelemetry/semantic-conventions": "^1.40.0",
+        "@smithy/core": "^3.23.13",
+        "@smithy/node-http-handler": "^4.5.1",
+        "ajv": "^8.18.0",
+        "asciichart": "^1.5.25",
         "audio-capture-napi": "workspace:*",
-        "auto-bind": "latest",
-        "axios": "latest",
-        "bidi-js": "latest",
+        "auto-bind": "^5.0.1",
+        "axios": "^1.14.0",
+        "bidi-js": "^1.0.3",
         "cacache": "^20.0.4",
-        "chalk": "latest",
-        "chokidar": "latest",
-        "cli-boxes": "latest",
+        "chalk": "^5.6.2",
+        "chokidar": "^5.0.0",
+        "cli-boxes": "^4.0.1",
         "cli-highlight": "^2.1.11",
-        "code-excerpt": "latest",
+        "code-excerpt": "^4.0.0",
         "color-diff-napi": "workspace:*",
-        "diff": "latest",
-        "emoji-regex": "latest",
-        "env-paths": "latest",
-        "execa": "latest",
-        "fflate": "latest",
-        "figures": "latest",
-        "fuse.js": "latest",
-        "get-east-asian-width": "latest",
-        "google-auth-library": "latest",
-        "highlight.js": "latest",
-        "https-proxy-agent": "latest",
-        "ignore": "latest",
+        "diff": "^8.0.4",
+        "emoji-regex": "^10.6.0",
+        "env-paths": "^4.0.0",
+        "execa": "^9.6.1",
+        "fflate": "^0.8.2",
+        "figures": "^6.1.0",
+        "fuse.js": "^7.1.0",
+        "get-east-asian-width": "^1.5.0",
+        "google-auth-library": "^10.6.2",
+        "highlight.js": "^11.11.1",
+        "https-proxy-agent": "^8.0.0",
+        "ignore": "^7.0.5",
         "image-processor-napi": "workspace:*",
-        "indent-string": "latest",
+        "indent-string": "^5.0.0",
         "jsonc-parser": "^3.3.1",
-        "lodash-es": "latest",
-        "lru-cache": "latest",
-        "marked": "latest",
+        "lodash-es": "^4.17.23",
+        "lru-cache": "^11.2.7",
+        "marked": "^17.0.5",
         "modifiers-napi": "workspace:*",
-        "p-map": "latest",
-        "picomatch": "latest",
+        "p-map": "^7.0.4",
+        "picomatch": "^4.0.4",
         "plist": "^3.1.0",
-        "proper-lockfile": "latest",
-        "qrcode": "latest",
-        "react": "latest",
+        "proper-lockfile": "^4.1.2",
+        "qrcode": "^1.5.4",
+        "react": "^19.2.4",
         "react-compiler-runtime": "^1.0.0",
-        "react-reconciler": "latest",
-        "semver": "latest",
+        "react-reconciler": "^0.33.0",
+        "semver": "^7.7.4",
         "sharp": "^0.34.5",
-        "shell-quote": "latest",
-        "signal-exit": "latest",
-        "stack-utils": "latest",
-        "strip-ansi": "latest",
-        "supports-hyperlinks": "latest",
-        "tree-kill": "latest",
+        "shell-quote": "^1.8.3",
+        "signal-exit": "^4.1.0",
+        "stack-utils": "^2.0.6",
+        "strip-ansi": "^7.2.0",
+        "supports-hyperlinks": "^4.4.0",
+        "tree-kill": "^1.2.2",
         "turndown": "^7.2.2",
-        "type-fest": "latest",
-        "undici": "latest",
+        "type-fest": "^5.5.0",
+        "undici": "^7.24.6",
         "url-handler-napi": "workspace:*",
-        "usehooks-ts": "latest",
-        "vscode-jsonrpc": "latest",
-        "vscode-languageserver-protocol": "latest",
-        "vscode-languageserver-types": "latest",
-        "wrap-ansi": "latest",
-        "ws": "latest",
-        "xss": "latest",
+        "usehooks-ts": "^3.1.1",
+        "vscode-jsonrpc": "^8.2.1",
+        "vscode-languageserver-protocol": "^3.17.5",
+        "vscode-languageserver-types": "^3.17.5",
+        "wrap-ansi": "^10.0.0",
+        "ws": "^8.20.0",
+        "xss": "^1.0.15",
         "yaml": "^2.8.3",
-        "zod": "latest"
+        "zod": "^4.3.6"
     },
     "devDependencies": {
         "@types/bun": "^1.3.11",
         "@types/cacache": "^20.0.1",
         "@types/plist": "^3.0.5",
-        "@types/react": "latest",
-        "@types/react-reconciler": "latest",
+        "@types/react": "^19.2.14",
+        "@types/react-reconciler": "^0.33.0",
         "@types/sharp": "^0.32.0",
         "@types/turndown": "^5.0.6",
-        "typescript": "latest"
+        "typescript": "^6.0.2"
     }
 }