thatgfsj-code 1.0.3 → 2.2.9

package/.nwt/meta.json

@@ -0,0 +1,5 @@
+{
+  "version": "2.0.0",
+  "created": "2026-07-06T19:29:58.147Z",
+  "description": "NeuroWeave Timeline - Project evolution memory"
+}

package/CHANGELOG.md

@@ -0,0 +1,244 @@
+# Changelog
+
+All notable changes to **Thatgfsj Code** are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/) and the project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## [2.2.8 / 产品 0.4.5] - 2026-07-06  - 边界测试驱动的 5 处修复
+
+> 双版本号方案:
+>
+> | 位置 | 版本 | 含义 |
+> |---|---|---|
+> | `package.json` `"version"` | `2.2.8` | npm 包版本,正常递增 (+0.0.1) |
+> | `src/cmd/index.tsx` `.version(...)` | `0.4.5` | **产品版本** (`gfcode --version` 看到的) |
+
+### Fixed (边界测试 `tests/edge-*.mjs` 捕获的真实 bug)
+
+**Bug 1: ToolCall 在 `result === null` 时误渲染** — 旧代码
+`tool.result !== undefined ? ... : null` 把 `null` 当有效结果,空字符串
+被显示。改成 `tool.result !== undefined && tool.result !== null`,
+`null` 现在进入 pending 状态,显示 ⏳ running。
+
+**Bug 2: `SessionManager.truncate(N)` 不生效** — compactor 的
+`preserveRecent` 默认 10,比 `maxMessages` 大,所以 `truncate(2)`
+触发 compact 时,`others.length <= preserveRecent` 分支返回原消息。
+改成 `truncate(N)` 时同步 `preserveRecent = N - 1`,让 max 边界真
+的生效。
+
+**Bug 3: thinking 正则漏掉 `<thinking>` delimiter** — 用户实际会话
+里模型用的是 `<thinking>...</thinking>` 不是 `<<<think>...</think>`。
+加上 `<thinking>` / `<THINK>` / `[think]` 三种额外格式,总共 6 个
+delimiter。
+
+**Bug 4: pollution 过滤 STRONG 模式过宽** — `/\[已中断\]/` 在消息
+**任何位置** 都触发 drop,导致 300 字的中段提到这个标记的合法
+解释型消息被误删。改成所有 STRONG 也受 length/question/temporal
+三个门控,长消息中段出现的引用不会被误杀。
+
+**Bug 5: 1.0.4 源码里没有 `npm test` script** — `prepublishOnly`
+引用了它,但 1.0.4 tarball 缺这个 script,导致 release 后用户跑
+`npm test` 会失败。加上 npm test 聚合脚本 + `prepublishOnly`
+显式跑 build + test。
+
+### Added
+
+- **5 套边界测试** (`tests/edge-*.mjs`),共 **118 个用例**,覆盖
+  - thinking compression: 嵌套 delimiter、无 closing tag、大小写、
+    whitespace-only、超长输入、混合 `bcdf` (Case O)
+  - pollution filter: 大小写、unicode 变种、`?` / 中文 `？` 时间
+    副词、`null byte`、markdown 装饰
+  - ToolCall 渲染: `null` vs `undefined`, `\\r\\n`, 10000 字符
+    单行,边界 8/9 行
+  - SessionManager: 空 user msg、1MB msg、`getMessages()` 不可变性、
+    `truncate(N)` 边界
+  - CLI 参数: -V, --version, -h, --show-thinking, -m, -i, 1000 char
+    prompt, unicode prompt, 含 shell 元字符的 prompt
+- **`npm test`** 脚本 (聚合 8 套测试, 181 / 181 pass)
+- **`prepublishOnly`** (build + test,确保发布前必过)
+- **`tests/` 加入 `.gitignore`** — 之前的 tarball 误把 dev-time
+  smoke 测试发到 npm 了
+
+### Test Summary
+
+```
+smoke-thinking:    28 / 28  pass
+smoke-tool:        18 / 18  pass
+smoke-pollution:   17 / 17  pass
+edge-thinking:     28 / 28  pass
+edge-tool:         25 / 25  pass
+edge-pollution:    23 / 23  pass
+edge-session:      27 / 27  pass
+edge-cli:          15 / 15  pass
+                  ────────────────
+total:           181 / 181  pass
+```
+
+---
+
+## [2.2.7 / 产品 0.4.4] - 2026-07-06  - 烟囱测试驱动的 anti-pollution 过滤收紧
+
+> 双版本号方案:
+>
+> | 位置 | 版本 | 含义 |
+> |---|---|---|
+> | `package.json` `"version"` | `2.2.7` | npm 包版本,正常递增 (+0.0.1) |
+> | `src/cmd/index.tsx` `.version(...)` | `0.4.4` | **产品版本** (`gfcode --version` 看到的) |
+
+### Fixed
+
+**Pollution 过滤误杀正常对话** — v2.2.4 引入的 anti-pollution 过滤
+(`SessionManager.looksPolluted`) 有两条过宽的模式:
+
+- `/\u5df2\u4e2d\u65ad[^\n]{0,40}/` — 把所有包含"已中断"字样的中文
+  都当污染,包括 `我看到这个进程已中断了` 这种合法对话
+- `/response (was )?truncated/i` — 把所有提到"response truncated"的句子
+  都当污染,包括用户问 `Why was the response truncated last time?`
+
+烟囱测试 `tests/smoke-pollution.mjs` 直接捕获了这两个误杀。
+
+### 修复策略 — 两层模式分级
+
+```
+STRONG (always drop):
+  [已中断]              必有方括号,模型原样输出
+  [interrupted]         English 等价
+
+WEAK (drop only when ALL gates pass):
+  ^...\[已中断\]       行首标记 (带可选 markdown 装饰)
+  ^...\[interrupted\]   行首标记
+  \bresponse (was )?(truncated|cut off|interrupted)\b
+  \boutput (was )?(truncated|cut off|interrupted)\b
+
+  + 消息长度 < 200 字符 (截断的响应通常较短)
+  + 不以 ? 结尾 (疑问句是用户讨论过往行为)
+  + 不包含 "last time" / "earlier" / "before" / "previously" / "yesterday"
+    (时间副词表明用户在回顾过去,不是污染)
+```
+
+### Smoke 测试新增
+
+- `tests/smoke-thinking.mjs` — 28 个用例覆盖 `splitThinking` / `compressThinking`
+  所有边缘情况 (空输入、多 delimiter、Chinese/English 混合、tag 跨行)
+- `tests/smoke-tool.mjs` — 18 个用例覆盖 ToolCall 渲染路径 (空结果、
+  pending、截断计数、错误、超长单行)
+- `tests/smoke-pollution.mjs` — 17 个用例覆盖 anti-pollution 过滤的
+  drop / keep 双向场景
+
+### Test summary (本 patch 后)
+```
+thinking:   28 / 28 pass
+tool:       18 / 18 pass
+pollution:  17 / 17 pass
+total:      63 / 63 pass
+```
+
+---
+
+## [2.2.6 / 产品 0.4.3] - 2026-07-06  - 修复工具结果不显示
+
+> 双版本号方案:
+>
+> | 位置 | 版本 | 含义 |
+> |---|---|---|
+> | `package.json` `"version"` | `2.2.6` | npm 包版本,正常递增 (+0.0.1) |
+> | `src/cmd/index.tsx` `.version(...)` | `0.4.3` | **产品版本** (`gfcode --version` 看到的) |
+
+### Fixed
+
+**Bug: 工具调用结果不显示** — 在 1.0.4 源码栈下用户报告"⚙ shell date" 这条
+命令发起后,**结果完全看不到**,只看到 AI 后续的文字回复 ("好嘞，那我给你
+演示一组工具——并行调用"). 模型明明看到了工具结果 (因为它的后续回复引用了
+结果),但 UI 上不显示结果文本。
+
+通过代码 review + 单测复现,定位到三个潜在原因,全部修复:
+
+1. **`src/tui/components/ToolCall.tsx`** — `tool.result ? ... : null` 用 truthy
+   判断,**空字符串结果被当 falsy 跳过渲染**。改成 `tool.result !== undefined ? ... : null`。
+   同样修复: `wrap="truncate"` 在 Ink 里会把超长行**静默切掉不显示**,
+   改成 `wrap="wrap"` 让长行自动换行。还把 `result.truncated` 的指示从
+   模糊的 `"..."` 改成 `(+N more lines)` 显示实际被截掉的行数。
+2. **加 ⏳ pending 指示器** — 工具调用发起到结果返回之间的中间状态,
+   之前没有视觉反馈,看起来像是"卡住了"。现在显示 `⏳ running...`
+3. **`src/tui/hooks/useChat.ts`** — 流结束 push 到 messages 时,assemble
+   一个 `[tool: name → result]` 摘要附加到 assistant 的 content 里。
+   这是 belt-and-suspenders 兜底: 即使 Ink 的 `<ToolCall/>` 渲染路径
+   因为任何边缘 case 失败 (例如太长的输出 wrap 问题),用户依然能在
+   AI 的文字回复里看到工具结果。
+
+### 仍然不修的 (但要意识到)
+- 用户的 paste 里还有另一条命令 `echo "=== 当前时间 ===" && date && echo
+  "=== 系统信息 ===" && system` — 这里 `system` 不是合法命令,
+  会返回错误。这不是代码 bug,是用户/模型自己写的命令有问题。本次 patch
+  不修改这个。
+
+### 不在本次范围
+- Anthropic / Gemini provider 的 `delta.tool_calls` 流式解析 (仍是 TODO)
+- 工具输入参数命名前缀 (`command` vs `cmd` 不一致) — 下次 patch
+
+---
+
+## [2.2.5 / 产品 0.4.2] - 2026-07-06  - 压缩 <think> 思考块 (类似 opencode)
+
+> 双版本号方案:
+>
+> | 位置 | 版本 | 含义 |
+> |---|---|---|
+> | `package.json` `"version"` | `2.2.5` | npm 包版本,正常递增 (+0.0.1) |
+> | `src/cmd/index.tsx` `.version(...)` | `0.4.2` | **产品版本** (`gfcode --version` 看到的) |
+
+### Fixed
+
+**Bug: 思考过程太长,刷屏** — 在 1.0.4 源码栈下,即使是"非推理"模型
+(Qwen / DeepSeek-V3 chat / Kimi 等) 也会在回复里发整段 `<think>...</think>`
+块,经常是几十行内部独白。这块内容对用户来说没有可读价值,只
+是噪音 — 用户在 v2.2.4 的会话日志里能看到这问题特别严重。
+
+参考 opencode 的做法 (`packages/opencode/src/session/prompt.ts:244`
+里的 `<think>[\s\S]*?<\/think>` 正则),引入压缩模式:
+
+- 新文件 `src/utils/thinking.ts`,导出三个 helper:
+  - `splitThinking(content)` — 把 `<think>...` / `<reasoning>...</reasoning>` /
+    `[THINK]...[/THINK]` 三种块格式剥离开,返回 `{thinking, conclusion,
+    thinkingLines, thinkingHint}`。
+  - `summarizeThinking(split)` — 输出 `💭 thought for N lines: <first hint>`
+    单行摘要。
+  - `compressThinking(content, showThinking)` — `showThinking=false` 时把
+    思考块压成一行 + 结论;`showThinking=true` 时原样返回。
+- 三个调用点全部接入压缩:
+  - `src/cmd/index.tsx`: 流式阶段**不**实时打印 AI 文字 (避免半个 <think>
+    块被切到屏幕上),流结束后用 `splitThinking + summarizeThinking` 输出
+    一行摘要 + 结论。**持久化时只保存结论**,让 history 不被思考块撑大。
+  - `src/app/index.ts:runPrompt`: 持久化前 `compressThinking(fullResponse,
+    showThinking)`。
+  - `src/tui/hooks/useChat.ts`: 同上,持久化 + 显示内容都走压缩。
+
+### Added
+
+- **CLI flag `--show-thinking`**: 在命令行下开启完整思考块显示 (调试用)
+- **`App.showThinking` 字段**: 默认 `false`,可通过 REPL 命令切换
+- **REPL 命令 `/thinking on|off`** (中文别名 `/思考`): 在 Ink TUI 模式下
+  切换思考块显示
+
+### 设计选择
+
+为什么不沿用 opencode 的"协议级分离 reasoning"?
+- opencode 把 reasoning 当成单独的 stream part 处理 (`MessageV2.ReasoningPart`),
+  那需要模型支持 reasoning API (Anthropic extended thinking / OpenAI o1-style)。
+- 我们用的多数 provider (Qwen / DeepSeek / Kimi) 把 reasoning 直接当作
+  content 的一部分输出,所以必须在**显示层**做正则剥离。
+
+为什么不实时 (mid-stream) 压缩?
+- 流式 chunk 是任意切分的,`<think>` 标签可能跨 chunk。实时检测需要
+  state machine,延迟和边界处理都很脆弱。
+- 流结束后压缩更可靠,而且不影响用户对结论的实时阅读(用户其实只在乎结论)。
+
+### 不在本次范围
+- `/thinking` 命令目前是全局开关,不支持 per-message 切换
+- 没有提供"展开"按钮 — 用户要看完整内容只能 `--show-thinking` 跑一遍
+- 持久化时去掉了 thinking 内容,这意味着**重放历史时也看不到完整思考**;
+  这是有意为之 (context window 优先),如需调试可以 `app.showThinking = true` 后
+  重新发起对话
+- Anthropic / Gemini SSE tool_call 流式解析 仍是 TODO
+
+---

package/DEVELOPMENT.md

@@ -0,0 +1,286 @@
+# Development Guide — Thatgfsj Code
+
+This document is for contributors / maintainers. End users should read
+[`README.md`](./README.md) instead.
+
+---
+
+## 1. Overview
+
+**Thatgfsj Code** is a Claude Code–style interactive AI coding assistant that
+runs entirely in your terminal. It is written in TypeScript, published as an
+ESM npm package, distributed under MIT, and targets **Node.js ≥ 18**.
+
+The tool exposes:
+
+- A non-interactive single-shot CLI (`gfcode "..."`).
+- An interactive REPL (`gfcode` with no args).
+- Subcommands: `init`, `explain`, `debug`, `chat`, `template`.
+
+The release pipeline is: **bug fix → docs → smoke test → git commit + tag →
+push → GitHub release → `npm publish`**. Everything in `src/` compiles to
+`dist/` via `tsc`; the `package.json` `files` whitelist decides what ships
+in the npm tarball.
+
+---
+
+## 2. Architecture
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                         src/index.ts                          │
+│   CLI entry · commander program · subcommand dispatch         │
+│   (init / explain / debug / chat / template / default REPL)  │
+└─────────────────────────┬────────────────────┬───────────────┘
+                          │                    │
+              ┌───────────▼──────────┐ ┌───────▼─────────────┐
+              │   AI Engine + Tools  │ │      REPL Loop       │
+              │ src/core/ai-engine   │ │ src/repl/{loop,...}  │
+              │ src/tools/{file,…}   │ │ @inquirer/input      │
+              └───────────┬──────────┘ └───────┬─────────────┘
+                          │                    │
+              ┌───────────▼────────────────────▼───────────────┐
+              │        Core / Utils / Agent / MCP              │
+              │ src/core/{config,session,types,subagent,…}     │
+              │ src/utils/{diff-preview,memory,project-…}     │
+              │ src/agent/{core,intent,streaming}             │
+              │ src/mcp/client.ts                              │
+              └────────────────────────────────────────────────┘
+```
+
+### Module responsibilities
+
+| Layer     | Files                                        | Job                                                                |
+|-----------|----------------------------------------------|--------------------------------------------------------------------|
+| Entry     | `src/index.ts`                               | commander program, subcommand handlers, REPL bootstrap             |
+| REPL      | `src/repl/{input,output,loop,welcome}.ts`    | interactive prompt, ANSI output, SIGINT, welcome/init wizard       |
+| Core      | `src/core/{ai-engine,config,session,…}.ts`   | AI provider abstraction, config loading, session state            |
+| Tools     | `src/tools/{file,shell,git,search}.ts`       | file I/O, shell exec, git ops, code search                         |
+| Agent     | `src/agent/{core,intent,streaming}.ts`       | intent classification, agent loop, streamed terminal output        |
+| Utils     | `src/utils/{diff-preview,memory,…}.ts`       | side-effect-free helpers                                           |
+| MCP       | `src/mcp/client.ts`                          | Model Context Protocol stdio client                                |
+
+### Data flow on a single prompt
+
+```
+User ──▶ commander ──▶ executeTask(prompt)
+                       │
+                       ├─▶ ConfigManager.load()         (process.env + ~/.thatgfsj/config.json)
+                       │
+                       ├─▶ AIEngine.chatStream(messages) ──▶ provider base URL /v1/chat/completions
+                       │                                  or Anthropic /messages
+                       │                                  or Gemini :generateContent
+                       │
+                       └─▶ process.stdout.write(chunks) ──▶ terminal (scrollable history)
+```
+
+---
+
+## 3. Build & install
+
+### Prerequisites
+
+- Node.js ≥ 18 (project uses native `fetch`, `AbortController`, top-level `await`,
+  `node --test`).
+- npm ≥ 9 (so `npm publish` understands the `files` whitelist).
+- Git (for the install scripts and during release).
+
+### Local development
+
+```bash
+git clone https://github.com/Thatgfsj/thatgfsj-code.git
+cd thatgfsj-code
+npm install
+npm run build           # produces ./dist
+npm test                # node --test tests/
+npm start               # node dist/index.js (interactive REPL)
+npm run dev             # tsc && node dist/index.js
+
+# Optional: link globally so `gfcode` is in your PATH
+npm link
+```
+
+`npm install` after cloning will trigger `prepublishOnly` if you have it
+configured (we do). Always run `npm run build` after editing source so the
+`dist/` matches `src/`.
+
+### Platform notes
+
+- **Windows**: `src/index.ts` invokes `chcp 65001` synchronously before any
+  output to force UTF-8 in the legacy Windows console. Done via
+  `createRequire(import.meta.url)` so it works under `"type": "module"`.
+- **Numeric keypad arrows**: the REPL uses `@inquirer/input` instead of Node's
+  built-in `readline.question()` because the latter doesn't reliably translate
+  numeric-keypad ANSI escape sequences on Windows terminals (Bug #1 history).
+- **Streaming output**: `process.stdout.write` directly, never `rl.question`
+  inside the loop — the latter would reset the terminal and lose scrollback.
+
+---
+
+## 4. Adding a provider
+
+1. Add the env-var map to `src/core/config.ts` (`envKeys`).
+2. Add a `*_MODELS` array to `src/repl/welcome.ts` and wire it through
+   `getModelsForProvider()` and `interactiveSetup()` (numbered choice).
+3. Update `WelcomeScreen.hasApiKey()` in `src/repl/welcome.ts` to include the
+   new env-var name.
+4. If the provider uses a non-OpenAI request format, extend the dispatcher
+   in `src/core/ai-engine.ts::streamRequest`.
+5. Update `docs/API_KEY_GUIDE.md` and `README.md`'s provider list.
+
+No other files should care about the specific provider.
+
+---
+
+## 5. Adding a built-in CLI command
+
+`src/index.ts` is the single `commander` program. Register a new command
+**before** `program.parse(process.argv)`:
+
+```ts
+program
+  .command('foo')
+  .description('...')
+  .argument('<bar>', '...')
+  .action(async (bar) => { /* ... */ });
+```
+
+For REPL-internal slash-style commands (visible only inside the interactive
+loop), add a new `case` to `src/repl/loop.ts::handleCommand`.
+
+### Built-in REPL commands (current)
+
+| Command          | Behavior                                                                         |
+| ---------------- | -------------------------------------------------------------------------------- |
+| `help`           | Show built-in command list                                                       |
+| `exit` / `quit`  | Leave the REPL                                                                   |
+| `clear`          | Clear the screen                                                                 |
+| `context`        | Show the current project context                                                 |
+| `history`        | Show the command history for this session                                         |
+| `tools`          | List registered tools                                                            |
+| `models`         | Read-only listing of the current provider's models                               |
+| `providers`      | Read-only listing of all providers                                               |
+| `/model`         | **Interactive picker — actually switches the active model** for the current provider. Persists to `~/.thatgfsj/config.json` and calls `AIEngine.updateConfig()`. |
+| `/provider`      | **Interactive picker — switches provider + chains into `/model`** for the new one. Warns if the corresponding env-var / saved API key is missing. |
+| `Ctrl+C`         | Aborts the in-flight stream once, exits after two empty-prompt cancels.          |
+
+Both `/model` and `/provider` accept either a numeric index or the exact
+provider/model id; pressing Enter with no input keeps the current value. After
+a switch, `REPLLoop` injects a one-line `[system: ... switched to ...]`
+message into the session so the LLM can see the change in the next turn.
+
+---
+
+## 6. Adding a tool
+
+Tools implement the `Tool` interface declared in `src/core/types.ts`:
+
+```ts
+export interface Tool {
+  name: string;
+  description: string;
+  parameters: ToolParameter[];
+  execute(params: any, ctx: ToolContext): Promise<ToolResult>;
+}
+```
+
+Steps:
+1. Create `src/tools/<name>.ts` exporting a class implementing `Tool`.
+2. Register it in `src/tools/index.ts::getBuiltInTools()` so both the REPL
+   `REPLLoop.init` and `executeTask` pick it up automatically.
+
+> **Known limitation (0.2.2):** `src/core/ai-engine.ts::extractToolCalls`
+> currently returns `undefined`. Tools are registered but never actually
+> invoked from a streamed response. Wiring this up requires parsing each
+> provider's native `tool_calls` delta and is tracked under "Unreleased" in
+> `CHANGELOG.md`. Until then, `ToolRegistry` is a forward-compatible seam.
+
+---
+
+## 7. MCP integration
+
+`src/mcp/client.ts` defines a small stdio MCP client. It spawns a child
+process and exchanges JSON-RPC via newline-delimited messages. The current
+shape is intentionally minimal — see the file for the protocol mapping.
+
+---
+
+## 8. Cross-platform & UX details
+
+- **Encoding**: Windows-only `chcp 65001` in `src/index.ts:9-15`. Skipped
+  silently if it fails.
+- **Color**: `chalk` v5 is ESM-only; the project is `"type": "module"` so
+  this is fine.
+- **Spinner**: `ora` v7 with `dots` spinner; cyan.
+- **History**: local to a single REPL session (not persisted across runs).
+
+---
+
+## 9. Tests
+
+```bash
+npm test                # runs node --test tests/  (full TAP output)
+npm run test:silent     # dot reporter, for noisy CI logs
+```
+
+Tests live in `tests/` and use Node's built-in `node:test` runner — no
+vitest / jest dev-dep. They cover:
+
+- Smoke tests of the compiled `dist/index.js` binary (`--version`, `--help`,
+  subcommand empty-arg guards, `bash -n install.sh`).
+- Boundary tests of pure modules (`SessionManager`, `DiffPreview`,
+  `REPLOutput`) — empty input, unicode, CRLF, very long input.
+- No network. No mocked API keys. No shell-out side-effects other than the
+  install script's `bash -n` parse-check.
+
+CI integration: if you set this up later, run `npm test && npm run build`
+in the job; the `prepublishOnly` script already chains them.
+
+---
+
+## 10. Release process
+
+1. Edit `package.json` `version` (semver).
+2. Add a new section at the top of `CHANGELOG.md`.
+3. `npm test && npm run build` locally — make sure both are green.
+4. `git add -A && git commit -m "release: vX.Y.Z"`
+5. `git tag vX.Y.Z`
+6. `git push origin main --follow-tags`
+7. `gh release create vX.Y.Z --title "vX.Y.Z" --notes-file CHANGELOG.md`
+   (the section for the new version is the top entry; trim if needed).
+8. `npm publish --access public` (a `prepublishOnly` step in `package.json`
+   re-runs tests + build, so you can't accidentally publish a stale build).
+
+### Semver policy
+
+- **patch** (`Z`): bug fixes, docs, refactors, no public API change.
+- **minor** (`Y`): new public command, new provider, new tool.
+- **major** (`X`): breaking change to the CLI surface or the JS API surface
+  (currently no JS API is stable).
+
+---
+
+## 11. Troubleshooting
+
+### `ReferenceError: require is not defined`
+
+You're editing TypeScript and accidentally called `require(...)` outside of a
+`createRequire(import.meta.url)` shim. The project is ESM. Use `import x from 'y'`
+at the top of the file.
+
+### `npm publish` ships no `dist/`
+
+You forgot to run `npm run build` (or the `prepublishOnly` script was
+removed). The `files` whitelist in `package.json` requires the `dist/`
+directory to exist locally when publishing.
+
+### `gfcode --version` shows the wrong number
+
+Edit it in `package.json` only — `src/index.ts` and `src/repl/output.ts` both
+read `VERSION` from `package.json` via `import pkg from '../package.json' …`.
+
+### REPL keypresses / Ctrl+C misbehave on Windows
+
+Make sure you're on Windows Terminal or any TTY that emits ANSI escape
+sequences natively. The legacy `cmd.exe` console has incomplete ANSI
+support — upgrade to Windows Terminal or use PowerShell.

package/dist/app/index.d.ts

@@ -18,6 +18,12 @@ export declare class App {
     hooks: HookManager;
     prompts: SystemPromptBuilder;
     skills: SkillRegistry;
+    /**
+     * v2.2.5 (product 0.4.2): toggle <think> block compression. Default
+     * true. Toggled by `--show-thinking` on the CLI or `/thinking on|off`
+     * in the REPL.
+     */
+    showThinking: boolean;
     private constructor();
     static create(): Promise<App>;
     /**
@@ -27,6 +33,14 @@ export declare class App {
     streamResponse(messages?: ChatMessage[]): AsyncGenerator<string, void>;
     /**
      * Run a single prompt (non-interactive mode)
+     *
+     * v2.2.4 (port from v2.1.0): persistence of the assistant message
+     * uses addMessageSafe, which drops the message if it contains
+     * pollution markers like "[已中断]".
+     *
+     * v2.2.5 (product 0.4.2): persistence also strips <think> blocks
+     * (and similar reasoning delimiters) when showThinking is false,
+     * so the conversation log stays compact.
      */
     runPrompt(prompt: string): Promise<string>;
 }

package/dist/app/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AAE7D,qBAAa,GAAG;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC;IAEtB,OAAO;WAkBM,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;IA+BnC;;;OAGG;IACI,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC;IAO7E;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBjD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AAE7D,qBAAa,GAAG;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAS;IAE9B,OAAO;WAkBM,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;IA+BnC;;;OAGG;IACI,cAAc,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC;IAO7E;;;;;;;;;;OAUG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAsBjD"}

package/dist/app/index.js

@@ -9,6 +9,7 @@ import { ToolRegistry } from '../tools/index.js';
 import { HookManager } from '../hooks/index.js';
 import { SystemPromptBuilder } from '../prompts/index.js';
 import { SkillRegistry } from '../skills/index.js';
+import { compressThinking } from '../utils/thinking.js';
 export class App {
     config;
     llm;
@@ -17,6 +18,12 @@ export class App {
     hooks;
     prompts;
     skills;
+    /**
+     * v2.2.5 (product 0.4.2): toggle <think> block compression. Default
+     * true. Toggled by `--show-thinking` on the CLI or `/thinking on|off`
+     * in the REPL.
+     */
+    showThinking = false;
     constructor(config, llm, session, tools, hooks, prompts, skills) {
         this.config = config;
         this.llm = llm;
@@ -63,6 +70,14 @@ export class App {
     }
     /**
      * Run a single prompt (non-interactive mode)
+     *
+     * v2.2.4 (port from v2.1.0): persistence of the assistant message
+     * uses addMessageSafe, which drops the message if it contains
+     * pollution markers like "[已中断]".
+     *
+     * v2.2.5 (product 0.4.2): persistence also strips <think> blocks
+     * (and similar reasoning delimiters) when showThinking is false,
+     * so the conversation log stays compact.
      */
     async runPrompt(prompt) {
         this.session.addMessage('user', prompt);
@@ -74,14 +89,15 @@ export class App {
             }
         }
         catch (err) {
-            // Re-throw after saving partial response
-            if (fullResponse) {
-                this.session.addMessage('assistant', fullResponse);
-            }
+            // Re-throw without persisting partial response. Persisting
+            // truncated output here was the source of the [已中断] loop in
+            // v2.2.3.
             throw err;
         }
         console.log();
-        this.session.addMessage('assistant', fullResponse);
+        // v2.2.5: compress <think> blocks before persisting.
+        const toPersist = compressThinking(fullResponse, this.showThinking);
+        this.session.addMessageSafe('assistant', toPersist);
         return fullResponse;
     }
 }

package/dist/app/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"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"}

package/dist/cmd/index.d.ts

@@ -1,6 +1,27 @@
 #!/usr/bin/env node
 /**
  * Thatgfsj Code - CLI Entry Point
+ *
+ * v2.2.4 (product 0.4.1): three concrete fixes for the bugs visible
+ * in the 2.2.3 (product 0.4.0) session log:
+ *
+ *   1. Encoding: chcp 65001 used to be wrapped in a silent try/catch,
+ *      and stdout never had its default encoding set. On Windows this
+ *      caused Chinese characters from tool output to render as
+ *      mojibake (ļ ʹ ϵͳ Ƿ ...).
+ *
+ *   2. [已中断] hallucination loop: 1.0.4's SessionManager had no
+ *      anti-pollution filter. When the user pressed Ctrl+C mid-
+ *      stream, the truncated assistant message (containing the
+ *      model's literal "[已中断]" marker) got persisted to history.
+ *      On the next turn, the model saw that and kept echoing it.
+ *      v2.1.0 had the right fix (_wasAborted flag + filter) — we
+ *      port it back here.
+ *
+ *   3. Tool output visual: 1.0.4 printed `@@TOOL@@{...}` markers
+ *      inline with text, no separator, no truncation. Long tool
+ *      output (registry dumps, dir listings) bled into the next
+ *      AI message. Add separator + truncation + color separation.
  */
 export {};
 //# sourceMappingURL=index.d.ts.map