@vincemakes/kiso-code 0.1.28 → 0.1.30

package/dist/chat.d.ts

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — the interactive REPL (chat), the run consumer
+ * The ergonomics batch B4 (pure move) — the interactive REPL (chat), the run consumer
  * (consumeRun — the single renderer of a run's event stream), the
  * approval-moment mini-diff, the status spinner, and the context
  * estimates. All bodies moved verbatim from index.ts.
@@ -8,7 +8,7 @@ import { type RunUsage } from "@vincemakes/kiso-tui";
 import type { AgentSession } from "@vincemakes/kiso-runtime";
 import { type LineInput } from "./state.js";
 /**
- * 手感批 C8 — the /compact auto-trigger, OPT-IN (default off: only an
+ * The ergonomics batch C8 — the /compact auto-trigger, OPT-IN (default off: only an
  * explicit KISO_AUTO_COMPACT=<ratio> enables it — the CLI never defaults
  * it on). After every completed turn the ~ctx ratio is checked; at/over
  * thresholdRatio the /compact full path runs (the same dispatch — same
@@ -21,14 +21,14 @@ export interface AutoCompact {
 /** Parse KISO_AUTO_COMPACT — an invalid value is OFF, never a crash. */
 export declare function autoCompactFromEnv(): AutoCompact | undefined;
 /**
- * C 区: the model window in tokens — env (KISO_CONTEXT_WINDOW) beats the
- * config window (合并轮 B), both beat the 200k default. The microcompact
+ * C area: the model window in tokens — env (KISO_CONTEXT_WINDOW) beats the
+ * config window (merge round B), both beat the 200k default. The microcompact
  * threshold is derived from it (50%), and the status line's ~ctx estimate
  * is measured against it — one source of truth for the window.
  */
 export declare function contextWindowTokens(): number;
 /**
- * B 区: approximate context ratio — chars/4 of the projected messages vs
+ * B area: approximate context ratio — chars/4 of the projected messages vs
  * the model window. Marked ~ everywhere it is shown; no counting API.
  */
 export declare function estimateCtxRatio(session: AgentSession): number;

package/dist/chat.js

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — the interactive REPL (chat), the run consumer
+ * The ergonomics batch B4 (pure move) — the interactive REPL (chat), the run consumer
  * (consumeRun — the single renderer of a run's event stream), the
  * approval-moment mini-diff, the status spinner, and the context
  * estimates. All bodies moved verbatim from index.ts.
@@ -13,7 +13,7 @@ import { CANCELLED, agentModel, body, bodyLog, configuredWindow, dock } from "./
 import { ask, pendingAsk, resolveUncertains } from "./trust-ui.js";
 import { FauxExhaustionError, failOnFauxExhaustion } from "./faux-glue.js";
 import { MODES, getMode, setMode } from "./mode.js";
-/** B 区: default context window for the ~ctx estimate (config overridable). */
+/** B area: default context window for the ~ctx estimate (config overridable). */
 const DEFAULT_CONTEXT_WINDOW = 200_000;
 /** Parse KISO_AUTO_COMPACT — an invalid value is OFF, never a crash. */
 export function autoCompactFromEnv() {
@@ -26,8 +26,8 @@ export function autoCompactFromEnv() {
     return { thresholdRatio: ratio };
 }
 /**
- * C 区: the model window in tokens — env (KISO_CONTEXT_WINDOW) beats the
- * config window (合并轮 B), both beat the 200k default. The microcompact
+ * C area: the model window in tokens — env (KISO_CONTEXT_WINDOW) beats the
+ * config window (merge round B), both beat the 200k default. The microcompact
  * threshold is derived from it (50%), and the status line's ~ctx estimate
  * is measured against it — one source of truth for the window.
  */
@@ -39,7 +39,7 @@ export function contextWindowTokens() {
     return Number.isFinite(window) && window > 0 ? window : DEFAULT_CONTEXT_WINDOW;
 }
 /**
- * B 区: approximate context ratio — chars/4 of the projected messages vs
+ * B area: approximate context ratio — chars/4 of the projected messages vs
  * the model window. Marked ~ everywhere it is shown; no counting API.
  */
 export function estimateCtxRatio(session) {
@@ -94,11 +94,39 @@ function approvalDiff(name, input) {
     }
 }
 /**
- * 手感批 C5 — the translation layer: the tui renders its OWN data shape
+ * The ergonomics batch C5 — the translation layer: the tui renders its OWN data shape
  * (RenderInput, zero kiso-core imports); the CLI translates its Event
  * stream here. Events without a render (stop, expired, resolved, …) → null,
  * and the consumer skips them — the pipe bytes stay identical.
  */
+/**
+ * round 6 (the todo round): translate a do-not-compact-tagged tool result whose
+ * content follows the todo echo contract (a [todo] header line + one
+ * `[pending|active|done] text` line per item) into the checklist cell's
+ * structured items. Null = not a checklist — the ordinary result cell
+ * renders. Keyed on the TAG (what the extension declared), never on a
+ * tool name; the parse is graceful so a foreign tagged result still
+ * renders normally.
+ */
+function parseChecklist(tags, content) {
+    if (!(tags ?? []).includes("do-not-compact"))
+        return null;
+    const items = [];
+    let header = "";
+    for (const line of content.split("\n")) {
+        const head = /^\[todo\] (.*)$/.exec(line);
+        if (head !== null) {
+            header = head[1];
+            continue;
+        }
+        const m = /^\[(pending|active|done)\] (.*)$/.exec(line);
+        if (m !== null)
+            items.push({ text: m[2], status: m[1] });
+    }
+    if (items.length === 0)
+        return null;
+    return { header, items };
+}
 function toRenderInput(ev) {
     switch (ev.type) {
         case "user_input":
@@ -152,7 +180,7 @@ export async function consumeRun(session, run, input, turnNo, faux, liveInput, s
     try {
         for await (const ev of run) {
             last = ev;
-            // v2a (双回显): the interactive echo was already rendered by the
+            // v2a (the double echo): the interactive echo was already rendered by the
             // input source — rendering the event again is the double echo.
             // v2b: DOCKED — the echo lives in the input row (H), NOT the body;
             // the body render is the ONLY visible copy of the sent line.
@@ -191,6 +219,14 @@ export async function consumeRun(session, run, input, turnNo, faux, liveInput, s
                 case "tool_result": {
                     const text = typeof ev.content === "string" ? ev.content : "";
                     body.toolResult(ev.callId, { content: text, isError: ev.isError });
+                    // round 6 (the todo round): a result tagged do-not-compact whose content
+                    // follows the checklist shape also renders as the durable
+                    // checklist cell (the CLI translates Event → the tui's own
+                    // shape; a non-matching parse falls back to the ordinary
+                    // result cell — never hide information).
+                    const checklist = parseChecklist(ev.tags, text);
+                    if (checklist !== null)
+                        body.checklist(checklist.header, checklist.items);
                     break;
                 }
                 case "text_delta":
@@ -204,7 +240,7 @@ export async function consumeRun(session, run, input, turnNo, faux, liveInput, s
                     statusCb?.(usage, estimateCtxRatio(session));
                     break;
                 case "uncertain_pending":
-                    // 裁决 #12 (ADR-0038): the ⚠ line is pure INFORMATION now — the
+                    // ruling #12 (ADR-0038): the ⚠ line is pure INFORMATION now — the
                     // approval chain guards retries, and the human question belongs
                     // only to the crash window's recovery flow (resolveUncertains).
                     body.notice(`⚠ ${escapeTerminal(ev.name)} FAILED — the side effect may have applied. ${escapeTerminal(ev.error)}`);
@@ -220,7 +256,7 @@ export async function consumeRun(session, run, input, turnNo, faux, liveInput, s
                     const decisionId = ev.decisionId;
                     const answer = await ask(input, `approve ${escapeTerminal(name)}? (y/n) `);
                     if (answer === CANCELLED) {
-                        // 十: a cancellation is a CONSERVATIVE denial, explicitly
+                        // round 10: a cancellation is a CONSERVATIVE denial, explicitly
                         // distinguished from the user typing "n".
                         body.notice("[approval cancelled — treated as a denial]");
                         await session.approve(decisionId, false);
@@ -293,17 +329,17 @@ export async function chat(session, faux, input, autoCompact) {
                 stopSpinner();
                 paintIdle();
                 currentRun = null;
-                // 八: a faux script that ran out of declared turns exits
+                // round 8: a faux script that ran out of declared turns exits
                 // loudly with a non-zero status — never a silent status 0.
-                // 第四轮(对抗): the exhaustion is a CONTROLLED rejection of
+                // round 4 (adversarial): the exhaustion is a CONTROLLED rejection of
                 // this turn's promise — it propagates through the chain to
                 // chat to main's finally/catch, never an orphaned
                 // unhandled rejection from the IIFE.
                 failOnFauxExhaustion(last, faux, input);
-                // 八: after EVERY turn the prompt is re-armed — the human
+                // round 8: after EVERY turn the prompt is re-armed — the human
                 // never types blind after the first turn.
                 input.prompt();
-                // 手感批 C8: the opt-in auto-compact — checked AFTER the
+                // the ergonomics batch C8: the opt-in auto-compact — checked AFTER the
                 // turn ended (the run's terminal is in the log, the ratio
                 // is post-run).
                 await maybeAutoCompact();
@@ -326,7 +362,7 @@ export async function chat(session, faux, input, autoCompact) {
     });
     input.onSigint(() => {
         if (currentRun) {
-            // 八: Ctrl+C cancels BOTH the pending question (if one is
+            // round 8: Ctrl+C cancels BOTH the pending question (if one is
             // awaiting a line) and the run — the run then writes its unique
             // aborted terminal, which the consumer keeps consuming.
             console.log("\n[aborting run]");
@@ -359,7 +395,7 @@ export async function chat(session, faux, input, autoCompact) {
             currentRun.abort();
         }
     });
-    // 第五轮(P1-11): the PERSISTENT line listener is installed BEFORE the
+    // round 5 (P1-11): the PERSISTENT line listener is installed BEFORE the
     // startup recovery — a cancelled question's re-emitted "line" needs a
     // listener from the very first instant, or the input is silently lost.
     // Turns are SERIALIZED on a chain — piped lines arrive faster than
@@ -369,7 +405,7 @@ export async function chat(session, faux, input, autoCompact) {
     const chainRef = { current: Promise.resolve() };
     let replReady = false;
     const queuedLines = [];
-    // B 区: user-turn counter for the status line. /last and /think read
+    // B area: user-turn counter for the status line. /last and /think read
     // the body (the ToolCell / ThinkingCell final states).
     let turnNo = 0;
     // v2a: the last line THIS process's readline consumed — the double-echo
@@ -419,7 +455,7 @@ export async function chat(session, faux, input, autoCompact) {
         submitTurn,
         estimateCtx: () => estimateCtxRatio(session),
     };
-    // 手感批 C8: the auto-compact check — the /compact FULL path via the
+    // the ergonomics batch C8: the auto-compact check — the /compact FULL path via the
     // shared dispatch (same notices, same chain ordering, same mid-run
     // refusal — the isRunning guard here only avoids the refusal's noise).
     // The appended segment is NOT awaited here on purpose: from inside a
@@ -446,7 +482,7 @@ export async function chat(session, faux, input, autoCompact) {
     // Recovery first: a session with a dangling pause or uncertain
     // executions must resolve them BEFORE the REPL accepts new turns —
     // otherwise the interrupted run dangles while a new one starts.
-    // 八: the startup resume is bound to currentRun — Ctrl+C during it
+    // round 8: the startup resume is bound to currentRun — Ctrl+C during it
     // aborts the recovery, exactly like the interactive turns.
     await resolveUncertains(session, input, () => cancelled);
     if (!cancelled) {
@@ -456,7 +492,7 @@ export async function chat(session, faux, input, autoCompact) {
         const last = await consumeRun(session, recoveryRun, input, turnNo, faux, liveInput, statusCb);
         currentRun = null;
         failOnFauxExhaustion(last, faux, input);
-        maybeAutoCompact(); // 手感批 C8: the recovery run ended too — same check (awaited by the exit re-await)
+        maybeAutoCompact(); // the ergonomics batch C8: the recovery run ended too — same check (awaited by the exit re-await)
     }
     if (cancelled) {
         input.close();
@@ -477,7 +513,7 @@ export async function chat(session, faux, input, autoCompact) {
     input.prompt();
     await input.closed;
     await chainRef.current; // never exit while a turn is in flight
-    // 手感批 C8: the auto-compact may have appended ITS segment inside the
+    // the ergonomics batch C8: the auto-compact may have appended ITS segment inside the
     // turn (the check runs at the turn's end, after the exit-await above
     // already captured the chain) — re-await once so the summarize either
     // runs before the exit or the chain is already settled. One level is

package/dist/config.d.ts

@@ -1,5 +1,5 @@
 /**
- * 合并轮 B — the config surface (schema v1).
+ * Merge round B — the config surface (schema v1).
  *
  * Two files: the user config `~/.kiso/config.json` and the project config
  * `<cwd>/.kiso/config.json` (an artifact of the E3 trust package — a

package/dist/config.js

@@ -1,5 +1,5 @@
 /**
- * 合并轮 B — the config surface (schema v1).
+ * Merge round B — the config surface (schema v1).
  *
  * Two files: the user config `~/.kiso/config.json` and the project config
  * `<cwd>/.kiso/config.json` (an artifact of the E3 trust package — a

package/dist/dispatch.d.ts

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — the ONE dispatcher: slash commands, exit, and
+ * The ergonomics batch B4 (pure move) — the ONE dispatcher: slash commands, exit, and
  * turns. The bodies moved verbatim from chat()'s closure; chat provides
  * the context (the chain, the run state, the prompt arming).
  */

package/dist/dispatch.js

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — the ONE dispatcher: slash commands, exit, and
+ * The ergonomics batch B4 (pure move) — the ONE dispatcher: slash commands, exit, and
  * turns. The bodies moved verbatim from chat()'s closure; chat provides
  * the context (the chain, the run state, the prompt arming).
  */
@@ -48,7 +48,7 @@ export function dispatch(line, ctx) {
         return;
     }
     if (trimmed === "/last") {
-        // B 区/v2d: print the FULL input/output of the most recent tool
+        // B area/v2d: print the FULL input/output of the most recent tool
         // call — the body holds it (the ToolCell's final state). Runs on
         // the chain: after any in-flight turn completes.
         ctx.chainRef.current = ctx.chainRef.current.then(async () => {
@@ -67,7 +67,7 @@ export function dispatch(line, ctx) {
         return;
     }
     if (trimmed === "/status") {
-        // B 区: session id, durable event count, and the ~ context
+        // B area: session id, durable event count, and the ~ context
         // estimate — all read straight from the live session, nothing
         // stored separately. Runs on the chain after any in-flight turn.
         ctx.chainRef.current = ctx.chainRef.current.then(async () => {
@@ -104,7 +104,7 @@ export function dispatch(line, ctx) {
         return;
     }
     if (trimmed === "/model" || trimmed.startsWith("/model ")) {
-        // 合并轮 B: /model lists the profiles (with availability — the
+        // merge round B: /model lists the profiles (with availability — the
         // config never stores keys, only apiKeyEnv NAMES; an unset env
         // marks the profile unavailable, never a crash) and switches the
         // session's adapter — the NEXT turn uses it (session.setAdapter),

package/dist/faux-glue.d.ts

@@ -1,12 +1,12 @@
 /**
- * 手感批 B4 (pure move) — the faux-mode glue: the durable script position
+ * The ergonomics batch B4 (pure move) — the faux-mode glue: the durable script position
  * (fauxSkip), the script sources (env override + the built-in demo), and
  * the exhaustion guard. All bodies moved verbatim from index.ts.
  */
 import type { FauxScript } from "@vincemakes/kiso-evals";
 import { type LineInput } from "./state.js";
 /**
- * E 区: how many faux-script turns a session has already consumed. The faux
+ * E area: how many faux-script turns a session has already consumed. The faux
  * provider's script counter is per-process, so a FRESH process that resumes
  * a session would restart the script at turn 0 — re-issuing the first
  * scripted call instead of continuing the trajectory. The session log is
@@ -18,7 +18,7 @@ import { type LineInput } from "./state.js";
  */
 export declare function fauxSkip(id: string): number;
 /**
- * E 区: KISO_FAUX_SCRIPT=<path> overrides the demo script with a JSON
+ * E area: KISO_FAUX_SCRIPT=<path> overrides the demo script with a JSON
  * FauxScript file — the kill -9 e2e drives the CLI through an exact
  * multi-tool trajectory. Absent → the built-in demo script.
  */
@@ -27,10 +27,10 @@ export declare function readFauxScript(): FauxScript;
  * The keyless demo script: tours the tools so `kiso chat` exercises them.
  * FOUR turns: each user turn consumes two model rounds (call → result →
  * summary), so at least two consecutive user turns work in one process
- * (F 组).
+ * (F group).
  */
 export declare function fauxScript(): FauxScript;
-/** 十: a faux-mode run whose scripted turns are exhausted must NOT print a
+/** round 10: a faux-mode run whose scripted turns are exhausted must NOT print a
  * provider error and exit 0 — the honest outcome is a loud message and a
  * non-zero exit. Thrown as a CONTROLLED exception (never process.exit):
  * the REPL closes, the error propagates through main's finally (so

package/dist/faux-glue.js

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — the faux-mode glue: the durable script position
+ * The ergonomics batch B4 (pure move) — the faux-mode glue: the durable script position
  * (fauxSkip), the script sources (env override + the built-in demo), and
  * the exhaustion guard. All bodies moved verbatim from index.ts.
  */
@@ -8,7 +8,7 @@ import { escapeTerminal } from "@vincemakes/kiso-tui";
 import { SessionStore } from "@vincemakes/kiso-runtime";
 import { sessionsDir } from "./state.js";
 /**
- * E 区: how many faux-script turns a session has already consumed. The faux
+ * E area: how many faux-script turns a session has already consumed. The faux
  * provider's script counter is per-process, so a FRESH process that resumes
  * a session would restart the script at turn 0 — re-issuing the first
  * scripted call instead of continuing the trajectory. The session log is
@@ -28,7 +28,7 @@ export function fauxSkip(id) {
         events.filter((e) => e.type === "tool_call_end" && !results.has(e.callId)).length);
 }
 /**
- * E 区: KISO_FAUX_SCRIPT=<path> overrides the demo script with a JSON
+ * E area: KISO_FAUX_SCRIPT=<path> overrides the demo script with a JSON
  * FauxScript file — the kill -9 e2e drives the CLI through an exact
  * multi-tool trajectory. Absent → the built-in demo script.
  */
@@ -51,13 +51,13 @@ export function readFauxScript() {
  * The keyless demo script: tours the tools so `kiso chat` exercises them.
  * FOUR turns: each user turn consumes two model rounds (call → result →
  * summary), so at least two consecutive user turns work in one process
- * (F 组).
+ * (F group).
  */
 export function fauxScript() {
     return [
         {
             events: [
-                // 自举 P1: a multi-delta thinking block — renders as ONE
+                // bootstrap P1: a multi-delta thinking block — renders as ONE
                 // streaming segment, not one line per token.
                 { type: "thinking", text: "Let me think about" },
                 { type: "thinking", text: " the workspace" },
@@ -88,7 +88,7 @@ export function fauxScript() {
         },
     ];
 }
-/** 十: a faux-mode run whose scripted turns are exhausted must NOT print a
+/** round 10: a faux-mode run whose scripted turns are exhausted must NOT print a
  * provider error and exit 0 — the honest outcome is a loud message and a
  * non-zero exit. Thrown as a CONTROLLED exception (never process.exit):
  * the REPL closes, the error propagates through main's finally (so

package/dist/index.d.ts

@@ -15,21 +15,21 @@
  * append-only JSONL. Write/edit/shell tools sit behind the approval policy:
  * the run pauses, asks, and resumes — durably (ADR-0024).
  *
- * 手感批 B4 (pure move): the interactive pieces live beside this file —
+ * The ergonomics batch B4 (pure move): the interactive pieces live beside this file —
  * chat.ts (the REPL + consumeRun), dispatch.ts (the slash dispatcher),
  * resume.ts, trust-ui.ts (the question surface + E3 merges), faux-glue.ts
  * (the scripted-model plumbing), state.ts (the shared process state).
- * index.ts keeps the entry: banner, input sources, the A 区 prompt,
+ * index.ts keeps the entry: banner, input sources, the A area prompt,
  * makeAgent, and main.
  */
 export { applyProjectMerges } from "./trust-ui.js";
 /**
- * A 区: read the FIRST present instruction file (AGENTS.md preferred) and
+ * A area: read the FIRST present instruction file (AGENTS.md preferred) and
  * return it as an injected section, or "" when none exists. Truncated at
  * 8KB with an explicit note. Pure — read once per session, so the prompt
  * is byte-stable for the session's lifetime.
  */
 export declare function readProjectInstructions(cwd: string): string;
-/** A 区: the session's system prompt — the constant plus any project
+/** A area: the session's system prompt — the constant plus any project
  *  instructions found in the workspace. Deterministic per cwd. */
 export declare function composeSystemPrompt(cwd: string): string;

package/dist/index.js

@@ -15,11 +15,11 @@
  * append-only JSONL. Write/edit/shell tools sit behind the approval policy:
  * the run pauses, asks, and resumes — durably (ADR-0024).
  *
- * 手感批 B4 (pure move): the interactive pieces live beside this file —
+ * The ergonomics batch B4 (pure move): the interactive pieces live beside this file —
  * chat.ts (the REPL + consumeRun), dispatch.ts (the slash dispatcher),
  * resume.ts, trust-ui.ts (the question surface + E3 merges), faux-glue.ts
  * (the scripted-model plumbing), state.ts (the shared process state).
- * index.ts keeps the entry: banner, input sources, the A 区 prompt,
+ * index.ts keeps the entry: banner, input sources, the A area prompt,
  * makeAgent, and main.
  */
 import { readFileSync, rmSync } from "node:fs";
@@ -38,9 +38,9 @@ import { autoCompactFromEnv, chat, contextWindowTokens } from "./chat.js";
 import { loadProjectConfig, loadUserConfig, mergeConfigs, resolveAutoCompact, resolveContextWindow, resolveModel } from "./config.js";
 import { resume } from "./resume.js";
 // The moved exports stay reachable from this entry — the test imports
-// (project-trust, coding-agent) never change (B4: 断言零改动).
+// (project-trust, coding-agent) never change (B4: zero assertion changes).
 export { applyProjectMerges } from "./trust-ui.js";
-/** 横幅: the block-letter logo (design fixed). TTY only — pipes, e2e
+/** The banner: the block-letter logo (design fixed). TTY only — pipes, e2e
  *  drivers, and CI see byte-for-byte the old output; the extensions line
  *  merges into the third row on TTY and stays a standalone line off-TTY.
  *  v2a: the logo rows stay dim; the TAGLINE (row 2) is the blue identity
@@ -178,7 +178,7 @@ function bannerExtensionText() {
     if (total === 0)
         return "";
     const parts = [];
-    // 0.1.26 (MCP 懒连接): an extension with a live `connecting` flag shows
+    // 0.1.26 (MCP lazy connection): an extension with a live `connecting` flag shows
     // its in-flight state in the banner — "mcp (connecting…)".
     const label = (e) => e.connecting === true ? `${e.name} (connecting…)` : e.name;
     if (userExtensions.length > 0)
@@ -200,8 +200,8 @@ function extensionsBanner() {
     bodyLog(`${text}\n`);
 }
 /**
- * A 区: the coding-agent system prompt — ONE constant, byte-stable for the
- * session's lifetime (D 区). Kept under ~80 lines; no template engine.
+ * A area: the coding-agent system prompt — ONE constant, byte-stable for the
+ * session's lifetime (D area). Kept under ~80 lines; no template engine.
  */
 const SYSTEM_PROMPT = `You are kiso, a coding agent. You work in a workspace
 directory and change code with tools. Be concise: answer in a few lines
@@ -227,12 +227,12 @@ Tool discipline:
 Workflow: understand the request, find the relevant code, make the
 smallest change that works, then verify with a command (tests/build).
 Report what you did in one or two lines per change.`;
-/** The project-instructions file names, in priority order (A 区). */
+/** The project-instructions file names, in priority order (A area). */
 const INSTRUCTION_FILES = ["AGENTS.md", "CLAUDE.md"];
 /** Hard cap for injected instructions — truncate and say so. */
 const INSTRUCTION_MAX = 8 * 1024;
 /**
- * A 区: read the FIRST present instruction file (AGENTS.md preferred) and
+ * A area: read the FIRST present instruction file (AGENTS.md preferred) and
  * return it as an injected section, or "" when none exists. Truncated at
  * 8KB with an explicit note. Pure — read once per session, so the prompt
  * is byte-stable for the session's lifetime.
@@ -251,7 +251,7 @@ export function readProjectInstructions(cwd) {
     }
     return "";
 }
-/** A 区: the session's system prompt — the constant plus any project
+/** A area: the session's system prompt — the constant plus any project
  *  instructions found in the workspace. Deterministic per cwd. */
 export function composeSystemPrompt(cwd) {
     const injected = readProjectInstructions(cwd);
@@ -273,7 +273,7 @@ async function makeAgent(fauxSkipTurns = 0, input, modelFlag) {
     else {
         setExtensionLists(user, [], user);
     }
-    // 合并轮 B — the config surface: user config + (trusted) project config,
+    // merge round B — the config surface: user config + (trusted) project config,
     // resolved with flags > env > project > user > default. The CLI never
     // imports provider SDKs directly — the runtime's lazy provider
     // resolution owns them (a config profile only ever NAMES an env var for
@@ -312,7 +312,7 @@ async function makeAgent(fauxSkipTurns = 0, input, modelFlag) {
             const extra = modeSystemPrompt();
             return extra === undefined ? sp : `${sp}\n\n${extra}`;
         })(),
-        // C 区: microcompact is ON by default in the product — threshold =
+        // C area: microcompact is ON by default in the product — threshold =
         // half the model window (KISO_CONTEXT_WINDOW override included;
         // 200k window → 100k tokens). Long sessions compact old read/list/
         // search/shell outputs instead of silently growing past the window.
@@ -337,7 +337,7 @@ async function main() {
     // first makeAgent (the tier extensions read `current` live). The flag
     // is stripped from the positional args, so it works in any position.
     const args = process.argv.slice(2);
-    // 合并轮 B: --model <profile|provider/model> — the top of the model
+    // merge round B: --model <profile|provider/model> — the top of the model
     // precedence chain; the value flows into makeAgent's config resolution.
     let modelFlag;
     const modelArgIdx = args.indexOf("--model");
@@ -366,7 +366,7 @@ async function main() {
         setMode(modeFromEnv() ?? loadUserConfig()?.mode ?? "default");
     }
     const [command, arg] = args;
-    // 八: faux mode is the keyless demo script — an exhausted script must
+    // round 8: faux mode is the keyless demo script — an exhausted script must
     // exit non-zero, never masquerade as a successful provider run. The
     // verdict comes from makeAgent's config resolution now (a config
     // profile can provide a real model with no OPENAI_* env).
@@ -387,7 +387,7 @@ async function main() {
         onDock: () => dock.redraw(), // v2d-B: the freeze scrolls the dock up — re-pin it
     }));
     try {
-        // 合并轮 B: the project config's mode applies AFTER the trust gate
+        // merge round B: the project config's mode applies AFTER the trust gate
         // (its verdict decides whether the project config exists at all) —
         // unless a higher layer (--mode flag / KISO_MODE) already decided.
         const applyConfigMode = () => {
@@ -403,7 +403,7 @@ async function main() {
                 // v2b: the dock (TTY only) wraps the whole session — the
                 // trust question, the banner, the body, and the input line.
                 dock.enter();
-                // E 区: a resumed session continues the script at its durable
+                // E area: a resumed session continues the script at its durable
                 // position — never restarts it (fauxSkip).
                 const agent = await makeAgent(fauxSkip(id), input, modelFlag);
                 applyConfigMode();
@@ -450,7 +450,7 @@ async function main() {
             }
             case undefined:
             default: {
-                // A 区: no subcommand (or any non-command first argument) IS
+                // A area: no subcommand (or any non-command first argument) IS
                 // chat — the first argument is the session id.
                 const id = command ?? new Date().toISOString().replace(/[:.]/g, "-").slice(0, 16);
                 dock.enter();
@@ -466,14 +466,14 @@ async function main() {
     finally {
         body.close(); // flush the pending frame, stop the heartbeat
         input.close();
-        // E 组: every normal and abnormal exit releases the fds and writer
+        // E group: every normal and abnormal exit releases the fds and writer
         // locks — no lock file is left behind.
         agent?.close();
         // v2b: the dock tears down on EVERY exit path — CSI r resets the
         // scroll region, the cursor lands at the input line, no broken
         // terminal (kill -9 excepted; `reset` saves it).
         dock.exit();
-        // 发现#8 (P1): extension dispose runs on the same exit path — a
+        // finding #8 (P1): extension dispose runs on the same exit path — a
         // dispose failure prints one line and NEVER changes the exit code.
         await disposeExtensions(loadedExtensions);
         // E3: the merged mcp/skills temp artifacts are best-effort removed on
@@ -491,7 +491,7 @@ async function main() {
 main()
     .then(() => process.exit(0))
     .catch((err) => {
-    // 十: top-level errors are terminal-escaped. v2a: the exit is EXPLICIT
+    // round 10: top-level errors are terminal-escaped. v2a: the exit is EXPLICIT
     // — natural drain is racy on a TTY (readline leaves the stdio handles
     // active and the loop sometimes never drains). main's finally already
     // ran (agent.close, dispose, temp cleanup) — nothing is skipped, no

package/dist/mode.d.ts

@@ -15,7 +15,7 @@ export declare const MODES: readonly Mode[];
 export declare function getMode(): Mode;
 export declare function setMode(m: Mode): void;
 /** The startup mode from env: KISO_MODE, or undefined when unset (the
- *  config layer's mode then applies — 合并轮 B; the --mode flag is
+ *  config layer's mode then applies — merge round B; the --mode flag is
  *  applied by main before the first makeAgent and wins over everything). */
 export declare function modeFromEnv(): Mode | undefined;
 /** The five built-in mode tiers as chain extensions — named "mode:<tier>"

package/dist/mode.js

@@ -21,7 +21,7 @@ export function setMode(m) {
     current = m;
 }
 /** The startup mode from env: KISO_MODE, or undefined when unset (the
- *  config layer's mode then applies — 合并轮 B; the --mode flag is
+ *  config layer's mode then applies — merge round B; the --mode flag is
  *  applied by main before the first makeAgent and wins over everything). */
 export function modeFromEnv() {
     const raw = process.env.KISO_MODE;

package/dist/resume.d.ts

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — resume: the RECOVERY flow (Area 2/7). The body
+ * The ergonomics batch B4 (pure move) — resume: the RECOVERY flow (Area 2/7). The body
  * moved verbatim from index.ts.
  */
 import type { AgentSession } from "@vincemakes/kiso-runtime";
@@ -8,7 +8,7 @@ import { type LineInput } from "./state.js";
  * Resume = the RECOVERY flow (Area 2/7): uncertain executions are decided,
  * the interrupted run is continued via session.resume() — never faked with
  * a new prompt. An optional prompt afterwards starts a genuinely new turn.
- * E 组: SIGINT aborts the run being resumed; every exit path closes the
+ * E group: SIGINT aborts the run being resumed; every exit path closes the
  * session store so no lock is left behind.
  */
 export declare function resume(session: AgentSession, prompt: string | undefined, faux: boolean, input: LineInput): Promise<void>;

package/dist/resume.js

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — resume: the RECOVERY flow (Area 2/7). The body
+ * The ergonomics batch B4 (pure move) — resume: the RECOVERY flow (Area 2/7). The body
  * moved verbatim from index.ts.
  */
 import { kUnit } from "@vincemakes/kiso-tui";
@@ -12,7 +12,7 @@ import { consumeRun, estimateCtxRatio, startStatusSpinner } from "./chat.js";
  * Resume = the RECOVERY flow (Area 2/7): uncertain executions are decided,
  * the interrupted run is continued via session.resume() — never faked with
  * a new prompt. An optional prompt afterwards starts a genuinely new turn.
- * E 组: SIGINT aborts the run being resumed; every exit path closes the
+ * E group: SIGINT aborts the run being resumed; every exit path closes the
  * session store so no lock is left behind.
  */
 export async function resume(session, prompt, faux, input) {
@@ -59,15 +59,15 @@ export async function resume(session, prompt, faux, input) {
     };
     input.onSigint(() => {
         if (currentRun) {
-            // 八: Ctrl+C cancels the pending question AND the run.
+            // round 8: Ctrl+C cancels the pending question AND the run.
             console.log("\n[aborting run]");
             pendingAsk?.();
             currentRun.abort();
         }
         else if (!cancelled) {
-            // 第四轮(对抗): also unblock a pending startup question — the
+            // round 4 (adversarial): also unblock a pending startup question — the
             // readline close alone would leave ask() hanging forever.
-            // 第五轮(P2-2): the cancellation is recorded so the recovery is
+            // round 5 (P2-2): the cancellation is recorded so the recovery is
             // NOT started afterwards — Ctrl+C exits cleanly.
             cancelled = true;
             console.log("\n[exit requested]");

package/dist/state.d.ts

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 — the CLI's shared process state. The module split (dispatch/
+ * The ergonomics batch B4 — the CLI's shared process state. The module split (dispatch/
  * chat/resume/trust-ui/faux-glue) is a PURE MOVE: every piece that more
  * than one module touches lives here as a live ESM binding. index.ts
  * creates the mutable ones (setBody / setAgentModel / setExtensionLists);
@@ -7,7 +7,7 @@
  */
 import { Dock, type Body } from "@vincemakes/kiso-tui";
 import type { KisoExtension } from "@vincemakes/kiso-runtime";
-/** 发现#11: KISO_HOME is the ONE root — every default path derives from
+/** finding #11: KISO_HOME is the ONE root — every default path derives from
  *  it (sessions, trust, extensions, mcp config, skills). The dedicated
  *  env vars (KISO_EXTENSIONS_DIR / KISO_MCP_CONFIG / KISO_SKILLS_DIR)
  *  still override their own path; nothing hard-codes ~/.kiso anymore. */
@@ -52,19 +52,19 @@ export declare function bodyLog(text: string): void;
 /** The model name for the status bar — set by makeAgent. */
 export declare let agentModel: string;
 export declare function setAgentModel(value: string): void;
-/** 合并轮 B: whether the agent runs on the faux provider (no real key) —
+/** merge round B: whether the agent runs on the faux provider (no real key) —
  *  set inside makeAgent, read by main for chat/resume's exhaustion check. */
 export declare let currentFaux: boolean;
 export declare function setCurrentFaux(value: boolean): void;
-/** 合并轮 B: the merged config (user + trusted project) as resolved by the
+/** merge round B: the merged config (user + trusted project) as resolved by the
  *  LAST makeAgent — /model and autoCompact resolve against it. */
 export declare let mergedConfig: import("./config.js").KisoConfig;
 export declare function setMergedConfig(value: import("./config.js").KisoConfig): void;
-/** 合并轮 B: the resolved context window (env > config.contextWindow) —
+/** merge round B: the resolved context window (env > config.contextWindow) —
  *  chat.ts's contextWindowTokens() consults it before the env. */
 export declare let configuredWindow: number | undefined;
 export declare function setConfiguredWindow(value: number | undefined): void;
-/** 合并轮 B: the merged config (user + trusted project) + the current
+/** merge round B: the merged config (user + trusted project) + the current
  *  model's NAME — /model lists and switches against them. */
 export declare let configModels: Readonly<Record<string, import("./config.js").ModelProfile>>;
 export declare function setConfigModels(models: Readonly<Record<string, import("./config.js").ModelProfile>>): void;
@@ -85,7 +85,7 @@ export declare function setExtensionLists(user: readonly KisoExtension[], projec
 export declare const mergedTempPaths: string[];
 /** The CLI's own version — read from the package.json next to the build. */
 export declare const VERSION: string;
-/** 十: a question cancelled by Ctrl+C — NEVER the empty string, which is a
+/** round 10: a question cancelled by Ctrl+C — NEVER the empty string, which is a
  *  real user answer (the empty line). The empty answer and the cancellation
  *  are distinct facts. */
 export declare const CANCELLED: unique symbol;

package/dist/state.js

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 — the CLI's shared process state. The module split (dispatch/
+ * The ergonomics batch B4 — the CLI's shared process state. The module split (dispatch/
  * chat/resume/trust-ui/faux-glue) is a PURE MOVE: every piece that more
  * than one module touches lives here as a live ESM binding. index.ts
  * creates the mutable ones (setBody / setAgentModel / setExtensionLists);
@@ -10,7 +10,7 @@ import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Dock } from "@vincemakes/kiso-tui";
-/** 发现#11: KISO_HOME is the ONE root — every default path derives from
+/** finding #11: KISO_HOME is the ONE root — every default path derives from
  *  it (sessions, trust, extensions, mcp config, skills). The dedicated
  *  env vars (KISO_EXTENSIONS_DIR / KISO_MCP_CONFIG / KISO_SKILLS_DIR)
  *  still override their own path; nothing hard-codes ~/.kiso anymore. */
@@ -46,25 +46,25 @@ export let agentModel = "faux";
 export function setAgentModel(value) {
     agentModel = value;
 }
-/** 合并轮 B: whether the agent runs on the faux provider (no real key) —
+/** merge round B: whether the agent runs on the faux provider (no real key) —
  *  set inside makeAgent, read by main for chat/resume's exhaustion check. */
 export let currentFaux = true;
 export function setCurrentFaux(value) {
     currentFaux = value;
 }
-/** 合并轮 B: the merged config (user + trusted project) as resolved by the
+/** merge round B: the merged config (user + trusted project) as resolved by the
  *  LAST makeAgent — /model and autoCompact resolve against it. */
 export let mergedConfig = {};
 export function setMergedConfig(value) {
     mergedConfig = value;
 }
-/** 合并轮 B: the resolved context window (env > config.contextWindow) —
+/** merge round B: the resolved context window (env > config.contextWindow) —
  *  chat.ts's contextWindowTokens() consults it before the env. */
 export let configuredWindow;
 export function setConfiguredWindow(value) {
     configuredWindow = value;
 }
-/** 合并轮 B: the merged config (user + trusted project) + the current
+/** merge round B: the merged config (user + trusted project) + the current
  *  model's NAME — /model lists and switches against them. */
 export let configModels = {};
 export function setConfigModels(models) {
@@ -102,7 +102,7 @@ export const VERSION = (() => {
         return "?";
     }
 })();
-/** 十: a question cancelled by Ctrl+C — NEVER the empty string, which is a
+/** round 10: a question cancelled by Ctrl+C — NEVER the empty string, which is a
  *  real user answer (the empty line). The empty answer and the cancellation
  *  are distinct facts. */
 export const CANCELLED = Symbol("kiso-question-cancelled");

package/dist/trust-ui.d.ts

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — the human-facing question UI: the E3 project
+ * The ergonomics batch B4 (pure move) — the human-facing question UI: the E3 project
  * trust gate (ADR-0037), the mcp/skills env merges, the generic ask()
  * (approvals, trust, uncertain resolutions), and the uncertain-execution
  * decisions. All bodies moved verbatim from index.ts.
@@ -17,7 +17,7 @@ export declare function interactivePrompt(): string;
  * forever: approvals auto-deny and uncertain executions auto-abandon, both
  * printed loudly — never silently ignored, never hung (Area 7).
  *
- * 八/十: the question is ABORTABLE — a pending rl.question is registered in
+ * rounds 8/10: the question is ABORTABLE — a pending rl.question is registered in
  * `pendingAsk` and the SIGINT handler resolves it with the CANCELLED
  * sentinel. The rl.question callback is NOT left dangling: an input that
  * arrives after the cancellation is re-emitted as a fresh "line" — it

package/dist/trust-ui.js

@@ -1,5 +1,5 @@
 /**
- * 手感批 B4 (pure move) — the human-facing question UI: the E3 project
+ * The ergonomics batch B4 (pure move) — the human-facing question UI: the E3 project
  * trust gate (ADR-0037), the mcp/skills env merges, the generic ask()
  * (approvals, trust, uncertain resolutions), and the uncertain-execution
  * decisions. All bodies moved verbatim from index.ts.
@@ -24,7 +24,7 @@ export function interactivePrompt() {
  * forever: approvals auto-deny and uncertain executions auto-abandon, both
  * printed loudly — never silently ignored, never hung (Area 7).
  *
- * 八/十: the question is ABORTABLE — a pending rl.question is registered in
+ * rounds 8/10: the question is ABORTABLE — a pending rl.question is registered in
  * `pendingAsk` and the SIGINT handler resolves it with the CANCELLED
  * sentinel. The rl.question callback is NOT left dangling: an input that
  * arrives after the cancellation is re-emitted as a fresh "line" — it
@@ -91,7 +91,7 @@ export async function resolveProjectTrust(input) {
     const artifacts = await projectArtifacts(process.cwd());
     if (artifacts === null)
         return null; // no .kiso artifacts — nothing to gate
-    // 合并轮 B: projectTrust "never" (user config) — the gate auto-refuses:
+    // merge round B: projectTrust "never" (user config) — the gate auto-refuses:
     // no ask, no record, nothing loads. There is deliberately no "always".
     if (resolveProjectTrustPolicy(loadUserConfig() ?? {}) === "never") {
         bodyLog(`[project .kiso] projectTrust: never — ${artifacts.root} not loaded`);
@@ -214,7 +214,7 @@ export async function resolveUncertains(session, input, isCancelled) {
     for (const uncertain of session.uncertainExecutions()) {
         const answer = await ask(input, `⚠ interrupted execution: ${escapeTerminal(uncertain.name)} (${uncertain.executionId}) — did it apply? (r)erun / (a)bandon: `);
         if (isCancelled() || answer === CANCELLED) {
-            // 十: a cancellation NEVER records a verdict — the execution
+            // round 10: a cancellation NEVER records a verdict — the execution
             // stays uncertain and durable; no rerun/abandoned is fabricated.
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-code",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "kiso CLI — the coding-agent reference product: kiso chat / kiso resume / kiso sessions.",
   "type": "module",
   "license": "MIT",
@@ -18,13 +18,13 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@vincemakes/kiso-core": "0.1.28",
-    "@vincemakes/kiso-evals": "0.1.28",
-    "@vincemakes/kiso-provider-anthropic": "0.1.28",
-    "@vincemakes/kiso-provider-openai": "0.1.28",
-    "@vincemakes/kiso-runtime": "0.1.28",
-    "@vincemakes/kiso-tools-node": "0.1.28",
-    "@vincemakes/kiso-tui": "0.1.28"
+    "@vincemakes/kiso-core": "0.1.29",
+    "@vincemakes/kiso-evals": "0.1.29",
+    "@vincemakes/kiso-provider-anthropic": "0.1.29",
+    "@vincemakes/kiso-provider-openai": "0.1.29",
+    "@vincemakes/kiso-runtime": "0.1.29",
+    "@vincemakes/kiso-tools-node": "0.1.29",
+    "@vincemakes/kiso-tui": "0.1.29"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",