march-cli 0.1.1 → 0.1.3

package/package.json

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

package/src/agent/runner.mjs

@@ -27,7 +27,7 @@ export { installModelPayloadDumper } from "./model-payload-dumper.mjs";
 export { createDefaultSessionManager, resolveRunnerSessionManager } from "./runner/runner-init.mjs";
 export { getRunnerSessionStats, syncEngineSessionState } from "./runner/runner-session-state.mjs";
 
-export async function createRunner({ cwd, modelId = null, provider = null, providers = {}, stateRoot, ui, memoryStore = null, memoryTools = [], shellRuntime = null, mcpTools = [], mcpInjections = [], mcpClientManager = null, webTools = [], namespace = "", sessionManager = null, useRuntimeHost = false, projectMarchDir = null, syncPiSidecar = false, extensionPaths = [], lifecycleHooks = [], lifecycleDiagnostics = [], authStorage = null, permissionController = null, modelContextDumper = null, turnNotifier = null, onModelPayload = null, createAgentSessionImpl = createAgentSession, createAgentSessionRuntimeImpl, createRuntimeServices, createRuntimeSessionFromServices, maxTurns, trimBatch, serviceTier = null }) {
+export async function createRunner({ cwd, modelId = null, provider = null, providers = {}, stateRoot, ui, memoryRoot = null, memoryStore = null, memoryTools = [], shellRuntime = null, mcpTools = [], mcpInjections = [], mcpClientManager = null, webTools = [], namespace = "", sessionManager = null, useRuntimeHost = false, projectMarchDir = null, syncPiSidecar = false, extensionPaths = [], lifecycleHooks = [], lifecycleDiagnostics = [], authStorage = null, permissionController = null, modelContextDumper = null, turnNotifier = null, onModelPayload = null, createAgentSessionImpl = createAgentSession, createAgentSessionRuntimeImpl, createRuntimeServices, createRuntimeSessionFromServices, maxTurns, trimBatch, serviceTier = null }) {
   if (!useRuntimeHost && extensionPaths.length > 0) {
     throw new Error("--extension requires the default pi runtime host path");
   }
@@ -47,7 +47,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
     retry: { enabled: true, maxRetries: 3, baseDelayMs: 2000 },
   });
   const lspService = new LspService({ cwd });
-  const engine = new ContextEngine({ cwd, modelId, provider, namespace, shellRuntime, lspService, injections: mcpInjections, maxTurns, trimBatch });
+  const engine = new ContextEngine({ cwd, modelId, provider, namespace, memoryRoot, shellRuntime, lspService, injections: mcpInjections, maxTurns, trimBatch });
   const resolvedSessionManager = resolveRunnerSessionManager(cwd, sessionManager);
   const sessionBinding = createSessionBinding(null);
   let currentModelCallKind = "model";

package/src/agent/turn/turn-runner.mjs

@@ -29,6 +29,7 @@ export async function runRunnerTurn({
       if (hints.length > 0) {
         midTurnRecallHints.push(...hints);
         onMidTurnRecallHints?.(hints);
+        ui.memoryHint?.({ source: "assistant", hints });
       }
     }
   });
@@ -51,8 +52,8 @@ export async function runRunnerTurn({
 
     closeAssistantReply({ ui, state: turnState });
     const assistantRecallHints = flushAssistantRecall({ memoryStore, engine, turnState, currentProject });
+    engine.setPendingAssistantRecallHints?.(assistantRecallHints);
     const recordedAssistantRecallHints = uniqueHints([...midTurnRecallHints, ...assistantRecallHints]);
-    ui.memoryHint?.({ source: "assistant", hints: recordedAssistantRecallHints });
 
     engine.recordTurn({
       userMessage: userMessage ?? prompt.slice(0, 300),

package/src/cli/repl-loop.mjs

@@ -18,16 +18,21 @@ export async function runSingleShotPrompt({
   modeState = null,
 }) {
   memoryStore.beginTurn();
+  const carryoverAlreadyRendered = runner.engine.hasRenderedPendingAssistantRecallHints?.() ?? false;
+  const carryoverRecallHints = runner.engine.takePendingAssistantRecallHints?.() ?? [];
   const userRecallHints = memoryStore.recallForUser(prompt, { currentProject, excludedIds: runner.engine.getRecentRecallMemoryIds?.() ?? [] });
   const recallBlock = formatRecallHints("user", userRecallHints);
+  const carryoverRecallBlock = formatRecallHints("assistant", carryoverRecallHints);
   const shellHints = formatShellHints(runner.shellRuntime);
   const modePrompt = appendModeReminder(prompt, modeState?.get?.());
-  const fullPrompt = appendPromptBlocks(modePrompt, recallBlock, shellHints);
+  const fullPrompt = appendPromptBlocks(modePrompt, recallBlock, carryoverRecallBlock, shellHints);
   ui.writeln(formatUserDisplayMessage(prompt));
   ui.memoryHint?.({ source: "user", hints: userRecallHints });
+  if (carryoverRecallHints.length > 0 && !carryoverAlreadyRendered) ui.memoryHint?.({ source: "assistant", hints: carryoverRecallHints });
   refreshStatusBar.startWorking?.();
   try {
     await runner.runTurn(fullPrompt, prompt, { userRecallHints, currentProject });
+    renderPendingAssistantRecallPreview({ runner, ui });
   } finally {
     refreshStatusBar.stopWorking?.();
     memoryStore.endTurn();
@@ -126,17 +131,22 @@ function handleInlineCommand(trimmed, { cwd, ui, lastInlineShellCommand }) {
 
 async function runReplTurn({ prompt, args, runner, memoryStore, currentProject, ui, refreshStatusBar, setTurnRunning, modeState = null }) {
   memoryStore.beginTurn();
+  const carryoverAlreadyRendered = runner.engine.hasRenderedPendingAssistantRecallHints?.() ?? false;
+  const carryoverRecallHints = runner.engine.takePendingAssistantRecallHints?.() ?? [];
   const userRecallHints = memoryStore.recallForUser(prompt, { currentProject, excludedIds: runner.engine.getRecentRecallMemoryIds?.() ?? [] });
   const recallBlock = formatRecallHints("user", userRecallHints);
+  const carryoverRecallBlock = formatRecallHints("assistant", carryoverRecallHints);
   const shellHints = formatShellHints(runner.shellRuntime);
   const modePrompt = appendModeReminder(prompt, modeState?.get?.());
-  const fullPrompt = appendPromptBlocks(modePrompt, recallBlock, shellHints);
+  const fullPrompt = appendPromptBlocks(modePrompt, recallBlock, carryoverRecallBlock, shellHints);
   try {
     ui.writeln(formatUserDisplayMessage(prompt));
     ui.memoryHint?.({ source: "user", hints: userRecallHints });
+    if (carryoverRecallHints.length > 0 && !carryoverAlreadyRendered) ui.memoryHint?.({ source: "assistant", hints: carryoverRecallHints });
     setTurnRunning(true);
     refreshStatusBar.startWorking?.();
     await runner.runTurn(fullPrompt, prompt, { userRecallHints, currentProject });
+    renderPendingAssistantRecallPreview({ runner, ui });
     ui.writeln("");
   } catch (err) {
     ui.writeln(`Error: ${err.message}`);
@@ -155,3 +165,11 @@ export function formatUserDisplayMessage(prompt) {
 function appendPromptBlocks(prompt, ...blocks) {
   return [prompt, ...blocks.filter(Boolean)].join("\n\n");
 }
+
+function renderPendingAssistantRecallPreview({ runner, ui }) {
+  if (runner.engine.hasRenderedPendingAssistantRecallHints?.()) return;
+  const hints = runner.engine.peekPendingAssistantRecallHints?.() ?? [];
+  if (hints.length === 0) return;
+  ui.memoryHint?.({ source: "assistant", hints });
+  runner.engine.markPendingAssistantRecallHintsRendered?.();
+}

package/src/cli/tui/markdown-renderer.mjs

@@ -167,6 +167,12 @@ function appendWrappedRuns(lines, runs, width, indent = 0, firstPrefix = null) {
   const maxWidth = Math.max(1, width);
   for (const run of runs) {
     for (const ch of run.text) {
+      if (ch === "\n") {
+        lines.push(current);
+        current = restPrefix;
+        currentWidth = visibleWidth(restPrefix);
+        continue;
+      }
       const charWidth = visibleWidth(ch);
       if (currentWidth + charWidth > maxWidth && currentWidth > visibleWidth(stripAnsi(prefix))) {
         lines.push(current);

package/src/config/loader.mjs

@@ -49,7 +49,7 @@ function mergeLayers(layers) {
     maxTurns: null,
     trimBatch: null,
     memoryRoot: null,
-    notifications: { turnEnd: false },
+    notifications: { turnEnd: true },
   };
 
   for (const layer of layers) {

package/src/context/engine.mjs

@@ -6,12 +6,15 @@ import { buildProjectContext } from "./project-context.mjs";
 import { formatRecallHints } from "../memory/markdown-store.mjs";
 
 export class ContextEngine {
-  constructor({ cwd, modelId, provider = "deepseek", thinkingLevel = "medium", namespace = "", shellRuntime = null, lspService = null, injections = [], maxTurns, trimBatch }) {
+  constructor({ cwd, modelId, provider = "deepseek", thinkingLevel = "medium", namespace = "", memoryRoot = null, shellRuntime = null, lspService = null, injections = [], maxTurns, trimBatch }) {
     this.cwd = cwd;
+    this.memoryRoot = memoryRoot;
     this.modelId = modelId;
     this.provider = provider;
     this.thinkingLevel = thinkingLevel;
     this.turns = [];
+    this.pendingAssistantRecallHints = [];
+    this.pendingAssistantRecallHintsRendered = false;
     this.sessionName = "";
     this.toolDefs = [];
     this.namespace = namespace;
@@ -85,6 +88,30 @@ export class ContextEngine {
     return ids;
   }
 
+  setPendingAssistantRecallHints(hints = []) {
+    this.pendingAssistantRecallHints = uniqueHints(hints);
+    this.pendingAssistantRecallHintsRendered = false;
+  }
+
+  peekPendingAssistantRecallHints() {
+    return this.pendingAssistantRecallHints;
+  }
+
+  hasRenderedPendingAssistantRecallHints() {
+    return this.pendingAssistantRecallHintsRendered;
+  }
+
+  markPendingAssistantRecallHintsRendered() {
+    if (this.pendingAssistantRecallHints.length > 0) this.pendingAssistantRecallHintsRendered = true;
+  }
+
+  takePendingAssistantRecallHints() {
+    const hints = this.pendingAssistantRecallHints;
+    this.pendingAssistantRecallHints = [];
+    this.pendingAssistantRecallHintsRendered = false;
+    return hints;
+  }
+
   resolvePath(raw) {
     return resolve(this.cwd, raw);
   }
@@ -106,9 +133,15 @@ export class ContextEngine {
   restoreSession(data, _pool, { replace = false } = {}) {
     if (replace) {
       this.turns = [];
+      this.pendingAssistantRecallHints = [];
+      this.pendingAssistantRecallHintsRendered = false;
       this.sessionName = "";
     }
     if (data.turns) this.turns = data.turns;
+    if (Array.isArray(data.pendingAssistantRecallHints)) {
+      this.pendingAssistantRecallHints = uniqueHints(data.pendingAssistantRecallHints);
+      this.pendingAssistantRecallHintsRendered = false;
+    }
     if (typeof data.sessionName === "string") this.sessionName = data.sessionName;
     this.setRuntimeState(data);
   }
@@ -116,7 +149,7 @@ export class ContextEngine {
   // ── Private layers ──────────────────────────────────────────────────
 
   #buildSessionIdentity() {
-    return buildSessionIdentity({ cwd: this.cwd, workspaceRoot: this.cwd });
+    return buildSessionIdentity({ cwd: this.cwd, workspaceRoot: this.cwd, memoryRoot: this.memoryRoot });
   }
 
   #buildRecentChat() {
@@ -146,3 +179,14 @@ function appendCurrentUser(recentChat, userMessage) {
   const currentUser = String(userMessage ?? "").trimEnd();
   return `${recentChat}\n\n[current_user]\n${currentUser}`;
 }
+
+function uniqueHints(hints = []) {
+  const seen = new Set();
+  const unique = [];
+  for (const hint of hints) {
+    if (!hint?.id || seen.has(hint.id)) continue;
+    seen.add(hint.id);
+    unique.push(hint);
+  }
+  return unique;
+}

package/src/context/session-status.mjs

@@ -1,15 +1,17 @@
 export function buildSessionIdentity({
   cwd,
   workspaceRoot = cwd,
+  memoryRoot = null,
   platform = process.platform,
 } = {}) {
   const shellInfo = platform === "win32"
     ? "shells: powershell (recommended), bash (Git Bash)"
     : "shell: bash";
+  const memoryInfo = memoryRoot ? `memory_root: ${memoryRoot}\n` : "";
 
   return `[session_identity]
 cwd: ${cwd}
 workspace_root: ${workspaceRoot}
-platform: ${platform}
+${memoryInfo}platform: ${platform}
 ${shellInfo}`;
 }

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

@@ -56,5 +56,5 @@ The user primarily asks for software engineering work: fixing bugs, adding behav
 - [memory_hint source="..."] blocks in recent_chat show memory hints matched from your thinking output. Use memory_open(id) to read the full content.
 - Use memory_search(query) for full-text search across all memories.
 - 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, merge related updates into an existing memory when they share the same topic or decision thread. Tags are the primary retrieval key for future recall. Prefer lowercase kebab-case tags like 'march-cli', 'tooling', 'permissions'.
+- 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'.
 </memory_system>

package/src/main.mjs

@@ -155,6 +155,7 @@ export async function run(argv) {
     providers: config.providers,
     stateRoot,
     ui,
+    memoryRoot,
     memoryStore,
     memoryTools,
     shellRuntime,

package/src/notification/desktop-notifier.mjs

@@ -25,7 +25,7 @@ export async function sendDesktopNotification({ platform = process.platform, spa
 
   const safeTitle = normalizeNotificationText(title) || "March";
   const safeMessage = normalizeNotificationText(message) || "Turn finished";
-  const script = buildWindowsBalloonScript({ title: safeTitle, message: safeMessage });
+  const script = buildWindowsNotificationScript({ title: safeTitle, message: safeMessage });
 
   try {
     const child = spawnProcess("powershell.exe", [
@@ -63,6 +63,38 @@ export function buildWindowsBalloonScript({ title, message, timeoutMs = DEFAULT_
   ].join("; ");
 }
 
+export function buildWindowsNotificationScript({ title, message, timeoutMs = DEFAULT_BALLOON_TIMEOUT_MS }) {
+  const toastXml = escapePowerShellDoubleQuotedString(buildToastXml({ title, message }));
+  const balloonScript = buildWindowsBalloonScript({ title, message, timeoutMs });
+  return [
+    "try {",
+    "[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] > $null",
+    "[Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime] > $null",
+    "$xml = New-Object Windows.Data.Xml.Dom.XmlDocument",
+    `$xml.LoadXml("${toastXml}")`,
+    "$toast = [Windows.UI.Notifications.ToastNotification]::new($xml)",
+    "[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('PowerShell').Show($toast)",
+    "} catch {",
+    balloonScript,
+    "}",
+  ].join("; ");
+}
+
+function buildToastXml({ title, message }) {
+  return `<toast><visual><binding template="ToastGeneric"><text>${escapeXmlText(title)}</text><text>${escapeXmlText(message)}</text></binding></visual></toast>`;
+}
+
+function escapeXmlText(text) {
+  return String(text)
+    .replaceAll("&", "&amp;")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;");
+}
+
+function escapePowerShellDoubleQuotedString(text) {
+  return String(text).replace(/[`"$]/g, "`$&");
+}
+
 function defaultTurnTitle(status) {
   return status === "error" ? "March turn failed" : "March is ready";
 }

package/src/session/sidecar.mjs

@@ -22,6 +22,7 @@ export function captureContextSidecar(engine, metadata = {}) {
     sessionName: engine.sessionName ?? "",
     thinkingLevel: engine.thinkingLevel,
     namespace: engine.namespace,
+    pendingAssistantRecallHints: engine.pendingAssistantRecallHints ?? [],
     turns: engine.turns,
   };
 }