march-cli 0.1.10 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "march-cli",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "March CLI — terminal-native coding agent with context reconstruction",
   "type": "module",
   "main": "./src/main.mjs",

package/src/cli/commands/status-command.mjs

@@ -1,6 +1,6 @@
 import { spawnSync } from "node:child_process";
 import { MODES, formatModeLabel } from "../input/mode-state.mjs";
-import { accent, text, PREFIX, R } from "../tui/ui-theme.mjs";
+import { PREFIX, R } from "../tui/ui-theme.mjs";
 
 export function statusCommand({
   runner,
@@ -23,11 +23,6 @@ export function statusCommand({
 
 export function statusBarLine({
   runner,
-  sessionState,
-  sessionSource = "pi",
-  extensionDiagnostics = [],
-  lifecycleState = null,
-  gitBranch = getGitBranch(runner.engine.cwd),
   mode = MODES.DO,
   contextTokens = null,
   activity = null,
@@ -35,12 +30,6 @@ export function statusBarLine({
 }) {
   return formatStatusBarLine({
     engine: runner.engine,
-    sessionState,
-    sessionStats: runner.getSessionStats?.() ?? null,
-    sessionSource,
-    extensionDiagnostics,
-    lifecycleState,
-    gitBranch,
     mode,
     contextTokens,
     activity,

package/src/cli/shell/shell-drawer.mjs

@@ -137,7 +137,7 @@ export class ShellDrawer {
 
   getOutputLines(shellId = this.getSelectedShell()?.id) {
     if (!shellId || !this.shellRuntime) return [];
-    const snapshot = this.shellRuntime.snapshotShell(shellId);
+    const snapshot = this.shellRuntime.snapshotShellScreen?.(shellId) ?? this.shellRuntime.snapshotShell(shellId);
     return formatAnsiLines(snapshot);
   }
 

package/src/cli/tui/output/visible-lines.mjs

@@ -0,0 +1,8 @@
+export function sliceLinesWithTail(baseLines, tailLine, range) {
+  if (!range) return tailLine == null ? baseLines : [...baseLines, tailLine];
+
+  const { start, end } = range;
+  const visible = baseLines.slice(start, Math.min(end, baseLines.length));
+  if (tailLine != null && end > baseLines.length) visible.push(tailLine);
+  return visible;
+}

package/src/cli/tui/output-buffer.mjs

@@ -4,6 +4,7 @@ import { renderMarkdown, renderStreamingMarkdown } from "./markdown-renderer.mjs
 import { renderEditDiffBlock } from "./tui-diff-rendering.mjs";
 import { OutputScrollState } from "./output/scroll-state.mjs";
 import { appendTextLines, wrapLine } from "./output/text-line-renderer.mjs";
+import { sliceLinesWithTail } from "./output/visible-lines.mjs";
 
 const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
@@ -72,6 +73,7 @@ export class OutputBuffer {
     this.overlayStatus = null;
     this.scrollState = new OutputScrollState();
     this._segmentLinesCache = new Map();
+    this._baseLinesCache = new Map();
   }
 
   get scrollOffset() {
@@ -89,6 +91,7 @@ export class OutputBuffer {
     this.overlayStatus = null;
     this.scrollState.clear();
     this._segmentLinesCache = new Map();
+    this._baseLinesCache = new Map();
   }
 
   write(text) {
@@ -101,6 +104,7 @@ export class OutputBuffer {
 
   _writeText(text, markdown) {
     this.overlayStatus = null;
+    this._invalidateBaseLines();
     const current = this.currentText.at(-1);
     if (current.markdown !== markdown && current.text !== "") {
       this.currentText.push({ text: "", markdown });
@@ -114,6 +118,7 @@ export class OutputBuffer {
 
   writeln(text) {
     this.overlayStatus = null;
+    this._invalidateBaseLines();
     this.currentText[this.currentText.length - 1].text += text;
     this.currentText.push({ text: "", markdown: false });
   }
@@ -122,6 +127,7 @@ export class OutputBuffer {
     const current = this.currentText.at(-1);
     if (!current || current.text === "") return false;
     this.currentText.push({ text: "", markdown: false });
+    this._invalidateBaseLines();
     return true;
   }
 
@@ -141,12 +147,14 @@ export class OutputBuffer {
     if (lastIdx >= 0) this._activeThinking.content[lastIdx] += parts[0];
     else this._activeThinking.content.push(parts[0]);
     for (let i = 1; i < parts.length; i++) this._activeThinking.content.push(parts[i]);
+    this._invalidateBaseLines();
   }
 
   endThinking(tokens) {
     if (this._activeThinking) {
       this._activeThinking.tokens = tokens;
       this._activeThinking = null;
+      this._invalidateSegmentLines();
     }
   }
 
@@ -166,10 +174,12 @@ export class OutputBuffer {
 
   setOverlayStatus(lines) {
     this.overlayStatus = Array.isArray(lines) ? { type: "status", lines } : null;
+    this._invalidateBaseLines();
   }
 
   clearOverlayStatus() {
     this.overlayStatus = null;
+    this._invalidateBaseLines();
   }
 
   sealCurrentText() {
@@ -232,34 +242,33 @@ export class OutputBuffer {
 
   _invalidateSegmentLines() {
     this._segmentLinesCache.clear();
+    this._invalidateBaseLines();
+  }
+
+  _invalidateBaseLines() {
+    this._baseLinesCache.clear();
   }
 
   render(width) {
-    const allLines = this._computeLines(width);
-    this._cachedTotalLines = allLines.length;
-    this.scrollState.setTotalLines(allLines.length);
-    const range = this.scrollState.sliceRange();
-    if (!range) return allLines;
-    const { start, end } = range;
-    return allLines.slice(start, end);
+    const baseLines = this._renderBaseLines(width);
+    const tailLine = this.spinning ? this._spinnerLine() : null;
+    this.scrollState.setTotalLines(baseLines.length + (tailLine == null ? 0 : 1));
+    return sliceLinesWithTail(baseLines, tailLine, this.scrollState.sliceRange());
+  }
+
+  _spinnerLine() {
+    return brightBlack(`${SPINNER_FRAMES[this.spinnerIdx]} ${this.spinnerText}`);
   }
 
-  _computeLines(width) {
+  _renderBaseLines(width) {
+    const cached = this._baseLinesCache.get(width);
+    if (cached) return cached;
     const lines = [...this._renderCachedSegmentLines(width)];
     const dynamicStart = this._cachedSegmentPrefixCount();
-    for (const seg of this.segments.slice(dynamicStart)) {
-      for (const line of renderBlock(seg, width)) lines.push(line);
-    }
-    for (const block of currentTextToBlocks(this.currentText, false, this.currentTextCache)) {
-      for (const line of renderBlock(block, width)) lines.push(line);
-    }
-    if (this.overlayStatus) {
-      for (const line of renderBlock(this.overlayStatus, width)) lines.push(line);
-    }
-    if (this.spinning) {
-      const frame = SPINNER_FRAMES[this.spinnerIdx];
-      lines.push(brightBlack(`${frame} ${this.spinnerText}`));
-    }
+    for (const seg of this.segments.slice(dynamicStart)) for (const line of renderBlock(seg, width)) lines.push(line);
+    for (const block of currentTextToBlocks(this.currentText, false, this.currentTextCache)) for (const line of renderBlock(block, width)) lines.push(line);
+    if (this.overlayStatus) for (const line of renderBlock(this.overlayStatus, width)) lines.push(line);
+    this._baseLinesCache.set(width, lines);
     return lines;
   }
 

package/src/cli/tui/render/stream-delta-buffer.mjs

@@ -0,0 +1,46 @@
+export function createStreamDeltaBuffer({
+  writeText,
+  writeThinking,
+  renderSoon,
+  delayMs = 16,
+  setTimeoutImpl = setTimeout,
+  clearTimeoutImpl = clearTimeout,
+} = {}) {
+  const queued = [];
+  let timer = null;
+
+  function append(kind, delta) {
+    if (!delta) return;
+    const last = queued.at(-1);
+    if (last?.kind === kind) last.text += delta;
+    else queued.push({ kind, text: delta });
+    schedule();
+  }
+
+  function schedule() {
+    if (timer) return;
+    timer = setTimeoutImpl(() => flush(), delayMs);
+    timer.unref?.();
+  }
+
+  function flush({ notify = true } = {}) {
+    if (timer) {
+      clearTimeoutImpl(timer);
+      timer = null;
+    }
+    if (!queued.length) return false;
+    const batch = queued.splice(0);
+    for (const item of batch) {
+      if (item.kind === "thinking") writeThinking(item.text);
+      else writeText(item.text);
+    }
+    if (notify) renderSoon();
+    return true;
+  }
+
+  return {
+    text: (delta) => append("text", delta),
+    thinking: (delta) => append("thinking", delta),
+    flush,
+  };
+}

package/src/cli/tui/selection-screen.mjs

@@ -10,16 +10,19 @@ export class ScreenSelection {
     this.anchor = null;
     this.focus = null;
     this.lines = [];
+    this._plainLines = [];
     this.viewport = { topRow: 0, leftCol: 0, width: Infinity, height: 0 };
   }
 
   setLines(lines) {
-    this.lines = lines.map((line) => stripAnsi(line));
+    this.lines = [...lines];
+    this._plainLines = [];
     this.viewport = { topRow: 0, leftCol: 0, width: Infinity, height: this.lines.length };
   }
 
   setViewport({ topRow = 0, leftCol = 0, width = Infinity, lines = [] } = {}) {
-    this.lines = lines.map((line) => stripAnsi(line));
+    this.lines = lines;
+    this._plainLines = [];
     this.viewport = {
       topRow: Math.max(0, Math.trunc(topRow)),
       leftCol: Math.max(0, Math.trunc(leftCol)),
@@ -68,7 +71,7 @@ export class ScreenSelection {
     if (!range) return "";
     const selected = [];
     for (let row = range.start.row; row <= range.end.row; row += 1) {
-      const line = this.lines[row] ?? "";
+      const line = this._plainLine(row);
       const startCol = row === range.start.row ? range.start.col : 0;
       const endCol = row === range.end.row ? range.end.col : visibleWidth(line);
       selected.push(sliceColumns(line, startCol, endCol));
@@ -81,7 +84,7 @@ export class ScreenSelection {
     if (!range) return lines;
     return lines.map((line, row) => {
       if (row < range.start.row || row > range.end.row) return line;
-      const plain = stripAnsi(line);
+      const plain = this._plainLine(row);
       const startCol = row === range.start.row ? range.start.col : 0;
       const endCol = row === range.end.row ? range.end.col : visibleWidth(plain);
       if (endCol <= startCol) return line;
@@ -89,6 +92,11 @@ export class ScreenSelection {
     });
   }
 
+  _plainLine(row) {
+    if (this._plainLines[row] == null) this._plainLines[row] = stripAnsi(this.lines[row] ?? "");
+    return this._plainLines[row];
+  }
+
   range() {
     if (!this.anchor || !this.focus) return null;
     const [start, end] = comparePoints(this.anchor, this.focus) <= 0

package/src/cli/ui.mjs

@@ -24,6 +24,7 @@ import { writeMemoryHint } from "./tui/recall-rendering.mjs";
 import { writeToolEnd, writeToolStart } from "./tui/tool-rendering.mjs";
 import { EDITOR_THEME, brightBlack } from "./tui/ui-theme.mjs";
 import { createRenderScheduler } from "./tui/render/render-scheduler.mjs";
+import { createStreamDeltaBuffer } from "./tui/render/stream-delta-buffer.mjs";
 import { writeTranscriptToOutput } from "../session/transcript.mjs";
 
 export { buildMarchCommands, MarchAutocompleteProvider } from "./input/autocomplete.mjs";
@@ -61,8 +62,9 @@ export function createTuiUI({
   let toolsExpanded = false;
   const activeToolBlocks = [];
   const renderScheduler = createRenderScheduler({ requestRender: () => tui.requestRender() });
-  const requestRender = renderScheduler.renderNow;
-
+  const streamDeltas = createStreamDeltaBuffer({ writeText: (delta) => output.writeMarkdown(delta), writeThinking: (delta) => output.appendThinking(delta), renderSoon: renderScheduler.renderSoon });
+  const flushStreamDeltas = () => streamDeltas.flush({ notify: false });
+  const requestRender = () => { flushStreamDeltas(); renderScheduler.renderNow(); };
   const spinnerStatus = createSpinnerStatusController({ output, requestRender });
   const retryStatus = createRetryStatusController({ output, requestRender, stopSpinner: spinnerStatus.stop });
   const shellDrawerControls = createShellDrawerControls({ shellDrawer, output, requestRender });
@@ -169,12 +171,10 @@ export function createTuiUI({
       retryStatus.stop(); output.startThinking(); requestRender();
     },
 
-    thinkingDelta: (delta) => {
-      output.appendThinking(delta);
-      renderScheduler.renderSoon();
-    },
+    thinkingDelta: (delta) => streamDeltas.thinking(delta),
 
     thinkingEnd: (tokens) => {
+      flushStreamDeltas();
       output.endThinking(tokens);
       requestRender();
     },
@@ -186,7 +186,7 @@ export function createTuiUI({
     toggleLastThinking: () => false,
 
     toolStart: (name, args) => {
-      ensureStarted(); retryStatus.stop(); spinnerStatus.stop(); activeToolBlocks.push(writeToolStart({ output, name, args })); requestRender();
+      ensureStarted(); flushStreamDeltas(); retryStatus.stop(); spinnerStatus.stop(); activeToolBlocks.push(writeToolStart({ output, name, args })); requestRender();
     },
 
     toolEnd: (name, isError, result) => {
@@ -194,30 +194,26 @@ export function createTuiUI({
     },
 
     textDelta: (delta) => {
-      ensureStarted(); retryStatus.stop(); spinnerStatus.stop();
-      output.writeMarkdown(delta);
-      renderScheduler.renderSoon();
+      ensureStarted(); retryStatus.stop(); spinnerStatus.stop(); streamDeltas.text(delta);
     },
     assistantReplyEnd: () => {
       ensureStarted();
+      flushStreamDeltas();
       const changed = output.ensureNewline();
       if (output.sealCurrentText() || changed) requestRender();
     },
     status: (text) => {
-      ensureStarted(); retryStatus.stop(); spinnerStatus.stop(); output.setOverlayStatus([brightBlack(`● ${text}`)]); requestRender();
+      ensureStarted(); flushStreamDeltas(); retryStatus.stop(); spinnerStatus.stop(); output.setOverlayStatus([brightBlack(`● ${text}`)]); requestRender();
     },
     memoryHint: ({ hints }) => {
-      ensureStarted(); retryStatus.stop(); spinnerStatus.stop(); output.ensureNewline(); writeMemoryHint({ output, hints }); requestRender();
+      ensureStarted(); flushStreamDeltas(); retryStatus.stop(); spinnerStatus.stop(); output.ensureNewline(); writeMemoryHint({ output, hints }); requestRender();
     },
 
     clearOutput: () => {
-      ensureStarted(); spinnerStatus.stop(); retryStatus.stop(); output.clear(); requestRender();
+      ensureStarted(); flushStreamDeltas(); spinnerStatus.stop(); retryStatus.stop(); output.clear(); requestRender();
     },
-
     restoreTranscript: (turns) => {
-      ensureStarted(); spinnerStatus.stop(); retryStatus.stop(); output.clear();
-      writeTranscriptToOutput(output, turns);
-      requestRender();
+      ensureStarted(); flushStreamDeltas(); spinnerStatus.stop(); retryStatus.stop(); output.clear(); writeTranscriptToOutput(output, turns); requestRender();
     },
 
     setStatusBar: (text) => {
@@ -229,6 +225,7 @@ export function createTuiUI({
     },
 
     turnEnd: () => {
+      flushStreamDeltas();
       const changed = output.ensureNewline();
       if (output.sealCurrentText() || changed) requestRender();
     },
@@ -238,6 +235,7 @@ export function createTuiUI({
 
     editDiff: (path, diffLines) => {
       ensureStarted();
+      flushStreamDeltas();
       spinnerStatus.stop();
       writeEditDiff({ output, path, diffLines });
       requestRender();
@@ -278,6 +276,7 @@ export function createTuiUI({
     toggleShellDrawer: () => shellDrawerControls.toggle(),
     requestExit: () => inputController.requestExit(),
     close: async () => {
+      flushStreamDeltas();
       renderScheduler.clearPending();
       spinnerStatus.stop();
       retryStatus.stop();

package/src/context/system-core/base.md

@@ -58,7 +58,7 @@ The user primarily asks for software engineering work: fixing bugs, adding behav
 - To edit an existing memory, use memory_open(id) to get its path, then edit_file with mode="patch" for targeted edits.
 - Use memory_save() to create memories or update whole fields. Before creating a new memory, first search/open related memories and merge updates into an existing memory when they share the same topic, project, or decision thread; prefer modifying the existing memory file over creating a scattered new one. Tags are the primary retrieval key for future recall. Prefer lowercase kebab-case tags like 'march-cli', 'tooling', 'permissions'.
 - When learning multiple related external workflows or skills, maintain memory as an evolving domain library: start with the specific source name when only one item exists, then rename and rewrite the memory title/description as the scope grows; merge new related learnings into the same memory, preserving each source's unique traits while distilling reusable principles.
-- Distinguish "migrating a Skill to memory" from "learning a Skill": migration preserves the complete Skill folder under memory_root/skills/ and creates a memory index with purpose, source, entry files, and local path; learning only reads and internalizes the Skill's methods, scenarios, and principles into ordinary memory without copying source files. Infer the action from the user's wording, and ask when ambiguous.
+- Distinguish "migrating a Skill to memory" from "learning a Skill": migration preserves the complete Skill folder under memory_root/skills/ and creates a memory entry as its index; that memory should describe what the Skill is for and reference the copied Skill folder path so future recall knows how to use it. Learning only reads and internalizes the Skill's methods, scenarios, and principles into ordinary memory without copying source files. Infer the action from the user's wording, and ask when ambiguous.
 - Unlike memory hints, this system-core center is always visible in every model call. Only update the center for instructions that must always be followed; use memory for contextual, project-specific, or recall-dependent knowledge.
 - If execution takes a meaningful detour, create or update a memory after the task. A detour means the initial plan or assumption failed, multiple approaches were tried, and the final successful path contains reusable project knowledge. Record the failed assumption, what was tried, and the successful approach. Prefer updating an existing related memory over creating a new one.
 </memory_system>

package/src/shell/runtime.mjs

@@ -10,7 +10,6 @@ import {
   normalizeSize,
   publicShell,
   requireShell,
-  stripAnsi,
   touch,
   uniqueName,
 } from "./runtime-state.mjs";
@@ -194,6 +193,14 @@ export function createShellRuntime({
     };
   }
 
+  function snapshotShellScreen(id) {
+    const shell = requireShell(shells, id);
+    return {
+      shell: publicShell(shell),
+      screen: shell.screen?.snapshot?.() ?? null,
+    };
+  }
+
   function clearShell(id) {
     const shell = requireShell(shells, id);
     shell.rawChunks = [];
@@ -238,6 +245,7 @@ export function createShellRuntime({
     getShell,
     searchShell,
     snapshotShell,
+    snapshotShellScreen,
     clearShell,
     dispose,
   };