deel-local-cli 1.1.0 → 1.2.0

package/README.en.md

@@ -53,6 +53,7 @@ Zero dependencies · Node 20+ · Exactly one place your source can go
 - [Simple vs developer](#simple-vs-developer)
 - [Tools](#tools)
 - [Korean text and Excel](#korean-text-and-excel)
+- [Serving what you built](#serving-what-you-built)
 - [Skills and plugins](#skills-and-plugins)
 - [Reasoning effort](#reasoning-effort)
 - [Auto-compaction](#auto-compaction)
@@ -63,6 +64,9 @@ Zero dependencies · Node 20+ · Exactly one place your source can go
 - [Configuration](#configuration)
 - [Troubleshooting](#troubleshooting)
 - [Development](#development)
+- [Release notes](#release-notes)
+
+Each section is open at the summary. Click **▸ More** to unfold the detail behind it.
 
 ---
 
@@ -203,6 +207,9 @@ $ deel scan
 
 Switch with `/model` mid-conversation — **the conversation carries over.**
 
+<details>
+<summary><b>More</b> — It adapts to whatever model is attached · Small windows get a smaller fixed share · On startup it reads what kind of project this folder is</summary>
+
 ### It adapts to whatever model is attached
 
 If you move between models, any number tuned for one of them is wrong for all the others.
@@ -333,6 +340,8 @@ can be recovered with one `Glob`; "tests run with `npm test`" requires opening
 
 7ms on a folder with 600 files (`test/project.test.js`).
 
+</details>
+
 ---
 
 ## Slash commands
@@ -348,6 +357,8 @@ Names follow Claude Code / Codex conventions.
 | `/out [number\|auto]` | Cap on a **single reply** — raise it when large files get cut |
 | `/compact` | Summarise and fold older turns |
 | `/clear` | Clear the conversation (keeps link and rules) |
+| `/thread [new\|fork\|close\|n]` | Conversation threads — side work in its own context. Link and undo stay shared |
+| `/learned [clear]` | What deel has picked up on its own — commands that work here, this model's habits |
 | `/model` | Switch connection / model |
 | `/think <level>` | Reasoning level (`off·low·medium·high·max`) |
 | `/think 배분 <profile>` | Per-stage profile (`even·save·deep`) |
@@ -359,6 +370,7 @@ Names follow Claude Code / Codex conventions.
 | `/level [level]` | How much to show (`쉬움` simple · `개발자` developer) |
 | `/undo [turns]` | Revert file changes |
 | `/diff [file]` | Files changed this session, and the changed lines |
+| `/preview [folder\|file\|off]` | Serve what you built, right here — a browser opens with it |
 | `/tools` | Available tools |
 | `/skills [query\|all\|off]` | Browse, search, load skills |
 | `/plugin [install\|remove\|pack]` | Manage plugins |
@@ -390,6 +402,9 @@ the conversation.
 
 Korean IME composition, paste, `Ctrl+A/E` and backspace all keep working.
 
+<details>
+<summary><b>More</b> — Attaching a file with @ · Interrupting</summary>
+
 ### Attaching a file with `@`
 
 Write `@` followed by a path and that file is sent along with your message.
@@ -448,6 +463,8 @@ session. Tools already running finish; **tools not yet started never run.**
 
 Pressing Ctrl+C again on an empty line quits.
 
+</details>
+
 ---
 
 ## Work modes
@@ -476,6 +493,9 @@ Don't confuse this with `/mode`. They are separate axes:
 If you have explicitly set `/think` or `/mode`, your choice wins. A work mode never
 overrides something a person chose.
 
+<details>
+<summary><b>More</b> — Switching by itself (Auto mode)</summary>
+
 ### Switching by itself (Auto mode)
 
 You start in **Auto**. Nothing has been decided about what kind of work is coming.
@@ -518,6 +538,8 @@ A `~` in the status line means it switched by itself; no `~` means you chose it.
 
 Choosing a mode yourself **pins** it. `/auto` (or `/work auto`) hands the wheel back.
 
+</details>
+
 ---
 
 ## Simple vs developer
@@ -539,6 +561,9 @@ Two things matter here:
 - **Beginners do not get fewer safeguards.** Undo, workspace scope and dangerous-command
   blocking are identical. A beginner needs the undo more, not less.
 
+<details>
+<summary><b>More</b> — The input box · You don't have to type the whole command · The box stays while it works · The picture on the left moves too and 1 more</summary>
+
 ### The input box
 
 Launched in a terminal, **the conversation scrolls normally and an input box is pinned at
@@ -652,21 +677,46 @@ more than a blank screen. One turn reads like this:
 (turning it over)       (looking at files)     (writing code)    (writing the answer)
 ```
 
-| Activity | Phrases |
-|---|---|
-| Thinking | 머리 굴리는 중 · 어떻게 할지 궁리하는 중 · 수 읽는 중 · 따져 보는 중 |
-| `Read` `Grep` `Glob` | 파일 들여다보는 중 · 코드 훑는 중 · 어디 있나 뒤지는 중 · 단서 찾는 중 |
-| `Write` `Edit` `Append` | 코드 짜는 중 · 고쳐 넣는 중 · 손보는 중 · 한 줄씩 옮기는 중 |
-| `Bash` | 명령 돌리는 중 · 터미널 두드리는 중 · 결과 기다리는 중 |
-| `WebFetch` | 문서 찾아보는 중 · 읽어 오는 중 |
-| Answering | 답 쓰는 중 · 정리해서 말하는 중 |
-| **Past 45 seconds** | 아직 하는 중 · 조금만 더 · 생각보다 오래 걸리는 중 |
+The phrases are Korean, because the interface is. Here is what each set means:
+
+| Activity | On screen | Roughly |
+|---|---|---|
+| Thinking | 머리 굴리는 중 · 어떻게 할지 궁리하는 중 · 수 읽는 중 · 따져 보는 중 | turning it over · working out how · reading ahead · weighing it up |
+| `Read` `Grep` `Glob` | 파일 들여다보는 중 · 코드 훑는 중 · 어디 있나 뒤지는 중 · 단서 찾는 중 | looking at files · skimming code · hunting for where it is · looking for a clue |
+| `Write` `Edit` `Append` | 코드 짜는 중 · 고쳐 넣는 중 · 손보는 중 · 한 줄씩 옮기는 중 | writing code · patching it in · touching it up · moving it a line at a time |
+| `Bash` | 명령 돌리는 중 · 터미널 두드리는 중 · 결과 기다리는 중 | running a command · at the terminal · waiting on output |
+| `WebFetch` | 문서 찾아보는 중 · 읽어 오는 중 | looking up docs · fetching |
+| Answering | 답 쓰는 중 · 정리해서 말하는 중 | writing the answer · putting it together |
+| **Past 45 seconds** | 아직 하는 중 · 조금만 더 · 생각보다 오래 걸리는 중 | still going · nearly there · taking longer than expected |
 
 Within a category the phrase advances every 4 seconds — text frozen for 30 seconds reads as
 hung too. On the right: **elapsed time**, and while the model is reasoning, **how many
 characters of thinking have arrived**. One number that genuinely increases is what turns
 "still alive" from a claim into a fact.
 
+### The picture on the left moves too
+
+What spins next to the phrase is not a spinner — it is **a small drawing of the work being
+done right now**.
+
+| Doing | One cycle | The picture |
+|---|---|---|
+| Thinking | `⠀⠶⠀` `⠰⣿⠆` `⢾⣿⡷` `⠰⣿⠆` | swells and shrinks |
+| Reading | `⠉⠉⠉` `⠒⠒⠒` `⠤⠤⠤` `⣀⣀⣀` | a scanning line travels down |
+| Writing | `⡼⠭⠧` `⠼⡯⠧` `⠼⠿⡧` `⠼⡭⠧` | **a laptop typing** |
+| Commands | `⠉⠀⠀` `⠉⠈⠀` `⠛⠊⠀` `⠿⠮⠄` | output piles up a line at a time |
+| Answering | `⠉⠀⠀` `⠛⠉⠀` `⠿⠛⠉` `⣿⠿⠛` | text fills up |
+| Web | `⣀⣀⣀` `⣤⣀⣀` `⣶⣤⣀` `⣿⣶⣤` | signal bars grow |
+| Compacting | `⣿⣿⣿` `⣶⣶⣶` `⣤⣤⣤` `⣀⣀⣀` | pressed down into one line |
+| Past 45 seconds | `⠶⠀⠀` `⠰⠆⠀` `⠀⠶⠀` `⠀⠰⠆` | back and forth — "waiting" |
+
+Braille only. One braille cell is **2 wide by 4 dots tall**, so three cells make a 6×4 grid
+that is exactly three columns in any terminal. Emoji and `●` `▪` include glyphs that East
+Asian locales measure as two columns, which knocks the border out of line every 90ms.
+
+If the drawing does not render, or you use a screen reader, `DEEL_NO_MOTION=1` turns it off
+and you get the old single-cell spinner.
+
 ### What gets asked, and what just happens
 
 Whether your files change **with or without being asked** is the one thing that has to be
@@ -706,6 +756,8 @@ press only makes it ask more; it never drops you into "changes files unasked" in
 > approval indicator off the line entirely. Now **the model name shortens first** — you
 > already know what you are running; whether your files change unasked is what you need now.
 
+</details>
+
 ---
 
 ## Tools
@@ -736,6 +788,9 @@ Seven tools here are not in Claude Code — `Append`, `Recall`, `Remember`, `Out
 so a test stops you every time the list grows (`test/loop.test.js`). The last four earned
 their cost; here is why.
 
+<details>
+<summary><b>More</b> — Outline · Verify · Task · Commands that never finish and 9 more</summary>
+
 ### Seeing a project's shape cheaply — `Outline`
 
 There used to be only two ways to understand someone else's code. `Glob` gives you paths;
@@ -1126,10 +1181,18 @@ last edit did. That original state comes from the earliest undo snapshot.
 `/diff` is **in the simple level's command list.** As long as `auto` edits without asking,
 a beginner needs a way to see what changed more than anyone.
 
+</details>
+
 ---
 
 ## Korean text and Excel
 
+**A file saved as CP949 is written back as CP949.** The encoding is never changed.
+Excel (`.xlsx`) is read as CSV — read-only.
+
+<details>
+<summary><b>More</b> — Encoding · Excel</summary>
+
 ### Encoding — written back the way it was read
 
 Corporate documents are often not UTF-8. Files saved by old Windows Notepad in a legacy
@@ -1200,6 +1263,55 @@ Extracted intermediate files are deleted after use.
 > to do instead. Round-tripping a file with formatting, formulas and charts through CSV
 > always loses something. Better not to write than to write knowing you'll lose data.
 
+</details>
+
+---
+
+## Serving what you built
+
+```
+❯ /preview
+
+  ▶ Serving  http://127.0.0.1:56801/
+  showing .
+  Edit a file and the page reloads by itself.
+  Only this machine can open it (127.0.0.1). No other PC can see it.
+  Stop with /preview off  · it shuts down when deel exits.
+```
+
+A browser opens with it. `/preview <folder>` picks what to serve, `/preview off` stops it.
+
+**This is not the same as double-clicking the file (`file://`).** Under `file://` everything
+below is blocked — and the error only shows up in the console while the page stays blank, so
+you end up suspecting your own code. This is a real HTTP server, so it all works:
+
+| | `file://` | `/preview` |
+|---|---|---|
+| `<script type="module">` · `import` | blocked (CORS) | **works** |
+| `fetch('./data.json')` | blocked | **works** |
+| `new Worker(...)` | blocked | **works** |
+| `WebAssembly.compileStreaming` | blocked (MIME) | **works** |
+| textures · `getImageData` | tainted canvas | **works** |
+| `.glb` / `.gltf` (Three.js) | no MIME type → silently not drawn | **works** |
+
+All seven were run in a real Chrome and confirmed **7/7**.
+
+Apps with a router (React Router and friends) get the first page back when you reload on a
+deep link. Never for requests with an extension (`app.js`) though — returning HTML for a
+missing script dies with `Unexpected token '<'`, which hides the real cause (a typo in a filename).
+
+### It opens exactly as much as it says
+
+Starting a server means opening your disk to somebody else.
+
+- Bound to **`127.0.0.1` only**. `0.0.0.0` is not available at all — on an office network
+  that would let anyone read your source.
+- Port **0** (the kernel hands out a free one). A fixed port steals someone else's.
+- Paths cannot leave the working scope. `../` · `%2e%2e` · double encoding · absolute paths ·
+  null bytes · symlinks — eight of these are held shut by tests.
+- **It only serves.** `POST` · `PUT` · `DELETE` are refused with 405.
+- It shuts down when `deel` exits.
+
 ---
 
 ## Skills and plugins
@@ -1215,6 +1327,9 @@ plugins  ~/.claude/plugins/**   ~/.deel/plugins/**
 
 Reads the Claude Code format: `SKILL.md` with YAML front matter, `commands/*.md`, `$ARGUMENTS`.
 
+<details>
+<summary><b>More</b> — Loaded in three stages · Fetching plugins · Deliberately not included</summary>
+
 ### Loaded in three stages
 
 Loading everything would blow the context window.
@@ -1247,6 +1362,8 @@ with a licence table — ready to hand to a security reviewer.
 | sub-agents | Doubles model calls against a gateway quota |
 | MCP | A separate protocol; a project of its own |
 
+</details>
+
 ---
 
 ## Reasoning effort
@@ -1295,6 +1412,9 @@ That second-to-last line exists for a reason: **when all three caps are equal, i
 only thing that says whether that is correct.** A low known cap makes them equal, and that
 is fine. For a while all three read `16,384` always — which meant the table said nothing.
 
+<details>
+<summary><b>More</b> — Context length is read off the model · /out · Truncated tool calls</summary>
+
 ### Context length is read off the model
 
 This one number sizes the whole program: how many files fit in one read, when the
@@ -1428,6 +1548,8 @@ One silently swallowed value produced all of that. What happens now:
 spinning one. What is counted here is not steps but **how many times the same tool failed for
 the same reason.**
 
+</details>
+
 ---
 
 ## Auto-compaction
@@ -1495,6 +1617,9 @@ The model sees it as `mcp__wiki__search`. `/mcp` shows what is attached.
 **Dependencies stay at zero.** The stdio transport is nothing but newline-delimited JSON-RPC
 2.0 over a child process's stdin/stdout, so `child_process` and `JSON` cover it. No SDK.
 
+<details>
+<summary><b>More</b> — But this is somebody else's program</summary>
+
 ### But this is somebody else's program
 
 This project exists because unapproved software is blocked. Turning on MCP carelessly would
@@ -1514,6 +1639,8 @@ One server crashing, hanging, or talking nonsense does not affect the others. Fa
 swallowed — the reason appears in the header, because a silent drop leaves "why is that tool
 missing?" unanswerable.
 
+</details>
+
 ---
 
 ## Safety
@@ -1543,6 +1670,9 @@ Undo history stores whole file contents, so repeated edits to large files add up
 it keeps the **most recent 50 turns** and drops the rest. What you just did is always
 undoable; `/status` shows how large the history currently is.
 
+<details>
+<summary><b>More</b> — Files removed through Bash come back too · What it will not read</summary>
+
 ### Files removed through `Bash` come back too
 
 The safety net covered `Write` and `Edit` only. But a model moving a file reaches for
@@ -1611,6 +1741,8 @@ the read guard look at the same set. They used to be two copies, and two copies
 comes when only one of them learns a new name — a folder that is skipped while walking but
 readable if you name it directly, which is very hard to explain.
 
+</details>
+
 ---
 
 ## Corporate review package
@@ -1641,6 +1773,9 @@ The bundled review sheet contains:
 It is generated by scanning the source, not written by hand — hand-written sheets drift from reality.
 Use `deel audit` to read it without building a zip.
 
+<details>
+<summary><b>More</b> — Diagnosing a corporate gateway</summary>
+
 ### Diagnosing a corporate gateway
 
 ```bash
@@ -1662,12 +1797,17 @@ Hand over `report.txt` alone — plain text, no colour codes.
 
 Verdict is one of **ready · limited · blocked · unreachable**.
 
+</details>
+
 ---
 
 ## Configuration
 
 Stored in `~/.deel/config.json`. A `.deel/config.json` in the project folder takes precedence.
 
+<details>
+<summary><b>More</b> — Supported servers · Environment variables · Flags · Project rules</summary>
+
 ### Supported servers
 
 | | Example address |
@@ -1712,6 +1852,8 @@ deel --no-tui            Turn the input box off; plain scrolling view (see below
 If the working folder has `DEEL.md`, `CLAUDE.md` or `AGENTS.md`, it is loaded as project rules.
 `/init` scaffolds one.
 
+</details>
+
 ---
 
 ## Troubleshooting
@@ -1777,6 +1919,9 @@ so one run tells you everything.
 | `no-bundle` | 12 | Nothing foreign in the published package; test-file hygiene |
 | `edit-bench` | 20 cases | Edit success rate |
 
+<details>
+<summary><b>More</b> — Coverage · Layout</summary>
+
 ### Coverage
 
 ```bash
@@ -1797,6 +1942,199 @@ Currently **92% overall** (7,056 of 7,646 lines). Three files are deliberately l
 | `repl.js` | 77% | The keypress paths — Shift+Tab, Ctrl+C, password entry, paste. Reaching them needs a pty, and a pty is a dependency. What the screen *prints* is measured instead, as a value (`ui` and `tui` suites) |
 | `plugins/manage.js` | 79% | The GitHub download path. **Tests not reaching the network** matters more. Folder installs are covered |
 
+### Layout
+
+```
+bin/deel.js              entry point
+src/
+  repl.js                the conversation screen — what a person faces
+  oneshot.js             run once and exit (-p)
+  commands.js            35 slash commands
+  setup.js               first-run connection setup
+  config.js              reading and writing config
+
+  ui/ansi.js             colour · East Asian width
+  ui/screen.js           picking a screen (line mode / box mode)
+  ui/inputbox.js         the box at the bottom — overwrite-in-place, cursor position
+  ui/status.js           status line — model, context, mode, approvals
+  ui/working.js          working phrases — they follow what is happening
+  ui/motion.js           the braille drawing next to the phrase
+  ui/approve.js          approval mode display (auto / risky only / everything)
+  ui/diff.js             showing what changed, where it changed
+  ui/wrap.js             wrapping to width without breaking colour
+  ui/level.js            simple vs developer
+
+  agent/loop.js          the agent loop
+  agent/session.js       conversation state + context accounting
+  agent/modes.js         work modes (auto · code · plan · architect · debug · ask · orchestrator)
+  agent/route.js         picking the mode from what was said
+  agent/effort.js        per-stage reasoning effort
+  agent/budget.js        shares that follow the window — lines read, description length, steps
+  agent/project.js       working out what kind of project this folder is
+  agent/compact.js       summarising compaction
+  agent/store.js         saving and resuming conversations
+  agent/recall.js        searching past conversations (no index, within budget)
+  agent/memory.js        what outlives the conversation
+  agent/mention.js       attaching files with `@`
+
+  backend/http.js        the single HTTP layer (the only door out)
+  backend/detect.js      protocol and auth detection
+  backend/adapter.js     absorbing OpenAI/Ollama differences + streaming parser
+  backend/ctxsize.js     reading context length off the model
+  backend/probe.js       8 diagnostic checks
+  backend/scan.js        scanning for local servers
+  backend/mcp.js         attaching outside tools (MCP, stdio)
+
+  tools/index.js         15 tools
+  tools/edit-match.js    staged-relaxation edit matching
+  tools/outline.js       a file's shape, cheaply
+  tools/verify.js        checking what was built
+  tools/task.js          splitting big work off
+  tools/jobs.js          commands that run in the background
+  tools/todo.js          checklists
+  tools/webfetch.js      reading the web (read-only)
+  tools/encoding.js      writing back in the encoding it was read in
+  tools/xlsx.js          Excel → CSV (written here)
+
+  preview/serve.js       serving what you built (127.0.0.1 only)
+  skills/discover.js     finding skills, commands and plugins on the machine
+  plugins/manage.js      installing, removing and packing plugins
+  pack/zip.js            ZIP writing (written here, keeps non-ASCII names)
+  pack/tar.js            TAR reading (written here)
+  pack/selfpack.js       review dossier + source bundle
+
+  safety/network.js      the lock on the way out
+  safety/guard.js        working scope + dangerous-command blocking
+  safety/undo.js         snapshots and undo
+  safety/audit.js        recording what happened, and when
+test/                    tests (excluded from the published package)
+```
+
+</details>
+
+---
+
+## Release notes
+
+<details>
+<summary><b>▸ 1.2.0 — so the conversation doesn't break</b> · what changed in six places</summary>
+
+<br>
+
+| | Before | After |
+|---|---|---|
+| Resuming | a conversation cut mid-tool-call **would not reopen** | unmatched calls are cleared, then it opens |
+| Counting tokens | it guessed, and stayed wrong | it corrects itself against the server |
+| Making room | summarising arrived at turn 49 | it holds out to turn **102** |
+| Side questions | piled up in the main context | live in their own thread |
+| Yesterday's lesson | vanished when you quit | carries over to the next session |
+| The answer on screen | `**bold**` showed up as characters | it is drawn |
+
+<br>
+
+#### 1. A conversation cut mid-tool-call would not reopen
+
+Close the window or hit <kbd>Ctrl</kbd>+<kbd>C</kbd> while a tool is running and the saved conversation keeps **a call with no result under it**. Reopen it with `--resume` and the server rejects the mismatch with a 400 — the conversation was written down perfectly well, and you still could not carry on.
+
+Now the pairs are checked before it opens. Calls with no result go, results with no parent go, and **whatever the model said stays.**
+
+```
+$ deel --resume 20260826-140217
+
+  ✓ 20260826-140217 — 메시지 48개를 이어 받았습니다.
+  중단된 도구 호출 2개를 걷어냈습니다 — 그때 하던 일은 다시 시켜 주세요.
+```
+
+#### 2. It misjudged the room left
+
+Token counts are estimated from character counts. Mix Korean, code and JSON and that estimate drifts from the truth — so deel folded early with room to spare, or did not fold when there was none and the server refused.
+
+It now **corrects the multiplier against what the server actually reports** with every answer. One line at the foot of `/context`:
+
+```
+  서버가 알려 준 실제값에 맞춰 +12% 보정했습니다 (7번 재봄).
+```
+
+The multiplier is kept per model, so **the next session starts from it** instead of measuring again from scratch.
+
+#### 3. Summarising arrived too early
+
+At 80% of the window, earlier turns get folded into a summary. That **cannot be undone**, and the file contents the reasoning rested on are gone with it.
+
+There is now a step before it. At 55%, **only older tool results** are folded — the four most recent are left alone, and nothing the model or you said is touched at all.
+
+```
+  ◲ 오래된 도구 결과 6개를 접었습니다 (2,148 토큰을 비움)
+```
+
+What was there is left in its place:
+
+```
+  (접힘) Read(src/runner.js) — 61줄. 자리를 비우려고 내용을 접었습니다. 필요하면 다시 읽으세요.
+```
+
+Measured by streaming the same conversation through: summarising is pushed from **turn 49 to turn 102 — 2.1×**.
+
+#### 4. Side questions polluted the main line
+
+"Just check this one thing" piles into the main context and stays there long after the checking is done.
+
+```
+/thread new 로그확인
+  ⑂ 로그확인 갈래로 왔습니다. 빈 대화입니다
+  본줄기로 돌아가려면 /thread 1
+```
+
+`fork` carries the conversation so far with you. What threads **keep apart is the messages, the token count and the checklist**; what they **share is the connection, undo and the audit log** — a file changed inside a thread still comes back with `/undo`. The `⑂` marker appears in the status line only once there is more than one thread.
+
+#### 5. Yesterday's lesson vanished when you quit
+
+deel could work out that `pnpm` is not on this machine, and lose it the moment you quit. Tomorrow it calls it again, fails again, works around it again.
+
+```
+/learned
+── 겪어 본 것 ──────────────────────────────────────
+
+  이 폴더에서 돌려 본 명령
+    ✓ npm test                 됨 12 · 안 됨 0
+    ✗ pnpm                     됨 0 · 안 됨 3
+
+  이 모델에 대해  qwen2.5-coder:7b
+    같이 걸어 본 걸음             86
+    인자가 잘림                   14  (16%)
+    토큰 추정 보정             ×1.12
+
+  이 중 프롬프트에 실리는 것
+  - 여기서 되는 명령: `npm test`
+  - 이 PC 에서 안 되는 명령(다시 부르지 마라): `pnpm`
+```
+
+**This is not training.** It does not touch the model and it does not hoard conversations — that would only eat context. It counts, and it carries over **only what it has seen twice**, all of it **within 220 tokens**. Something seen once may be a coincidence, and writing a coincidence down as fact sends the model around a road that actually works.
+
+Commands that work live with the folder (`.deel/배운것.json`); the model's habits live in the config folder. So **move the folder and what it learned about the model comes along.** `/learned 지우기` empties it whenever you want.
+
+#### 6. The answer showed up as raw characters
+
+The model speaks Markdown and the screen did not know it, so asterisks, backticks and hashes came through mixed into the prose. You had to re-read it in your head to see what was a heading and what was code.
+
+```
+before                                 after
+▌ ## 고친 것                           ▌ ▍ 고친 것
+▌ **src/runner.js** 의 `console.log`   ▌ src/runner.js 의 console.log
+▌ - [ ] 남은 것: `src/worker.js`       ▌ ☐ 남은 것: src/worker.js
+▌ ```js                                ▌ ┌──────────────── js
+▌ log.info('시작', { id })             ▌ │ log.info('시작', { id })
+▌ |---|---|                            ▌ ┼────────┼─────────┼
+```
+
+Answers arrive in fragments, so a line can only be drawn **once it ends**. But a whole paragraph on one line would leave the screen still for seconds — so once a line grows past the screen width, everything up to there is **streamed raw**. Looking alive comes before looking neat.
+
+<br>
+
+Tests 2,532 → **2,578** · 48/48 files. Earlier releases are in the [tags](https://github.com/jysvai/deel-local-cli/tags).
+
+</details>
+
 ---
 
 ## Licence