march-cli 0.1.27 → 0.1.29

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

@@ -91,13 +91,14 @@ The user primarily asks for software engineering work: fixing bugs, adding behav
 </git_contract>
 
 <memory_system>
-- [memory_hint source="..."] blocks in recent_chat are lightweight recall hints matched from prior thinking output. Treat them as possibly relevant pointers, not as complete facts.
-- If a memory hint may help the current task, use memory_open(id) to read the full memory before relying on it. Ignore hints that are clearly unrelated or too low-value for the task.
+- [recall source="..."] blocks in recent_chat are lightweight recall hints matched from prior thinking output. Treat them as possibly relevant pointers, not as complete facts.
+- A recall hint's description may record key operational constraints, including when the full memory must be opened; factor those constraints into relevance before acting.
+- If a recall hint may help the current task, use memory_open(id) to read the full memory before relying on it. Ignore hints that are clearly unrelated or too low-value for the task.
 - 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, 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 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.
+- Unlike recall blocks, 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/main.mjs

@@ -37,6 +37,9 @@ import { registerSuperGrokOAuthProvider } from "./supergrok/oauth-provider.mjs";
 import { installNetworkEnvironment } from "./network/environment.mjs";
 import { runMemoryCommand } from "./memory/command.mjs";
 import { normalizeRemoteMemorySources } from "./memory/remote/config.mjs";
+import { resolveMemoryRoot } from "./memory/root.mjs";
+import { runBrowserCommand } from "./browser/cli/command.mjs";
+import { ensureBrowserDaemon } from "./browser/client/lifecycle.mjs";
 export async function run(argv) {
   const cwd = process.cwd();
   loadDotEnv(cwd);
@@ -49,6 +52,7 @@ export async function run(argv) {
   }
 
   const config = loadConfig(cwd);
+  const stateRoot = join(homedir(), ".march");
   const useRuntimeProcess = process.env.MARCH_RUNTIME_PROCESS !== "0";
   installNetworkEnvironment(config.network);
   if (args.command?.name === "login") {
@@ -70,11 +74,19 @@ export async function run(argv) {
     return 1;
   }
   if (args.command?.name === "memory") {
-    args.memoryRoot = resolveMemoryRoot(config.memoryRoot, join(homedir(), ".march"));
+    args.memoryRoot = resolveMemoryRoot(config.memoryRoot, stateRoot);
     return await runMemoryCommand(args, { homeDir: homedir() });
   }
-  const stateRoot = join(homedir(), ".march");
+  if (args.command?.name === "browser") {
+    try {
+      return await runBrowserCommand(args, { stateRoot });
+    } catch (err) {
+      process.stderr.write(`Error: ${err.message}\n`);
+      return 1;
+    }
+  }
   if (!existsSync(stateRoot)) mkdirSync(stateRoot, { recursive: true });
+  await ensureBrowserDaemon({ stateRoot }).catch(() => {});
   const logger = createLogger({ logDir: join(stateRoot, "logs") });
   installProcessLogHandlers(logger);
   logger.event("process.start", {
@@ -223,7 +235,6 @@ export async function run(argv) {
     modeState,
   });
 
-
   const startupResume = await resumeStartupSession({
     resumeId: args.resume,
     runner,
@@ -233,7 +244,6 @@ export async function run(argv) {
   });
   refreshStatusBar();
 
-
   if (args.prompt) {
     turnRunning = true;
     try {
@@ -285,10 +295,4 @@ export async function run(argv) {
   return 0;
 }
 
-function resolveMemoryRoot(configured, stateRoot) {
-  if (configured) return resolve(String(configured));
-  if (process.env.MARCH_MEMORY_ROOT) return resolve(process.env.MARCH_MEMORY_ROOT);
-  return resolve(stateRoot, "March Memories");
-}
-
 if (process.argv[1] === fileURLToPath(import.meta.url)) process.exitCode = await run(process.argv.slice(2));

package/src/memory/markdown/markdown-recall.mjs

@@ -2,7 +2,7 @@ import { expandTags, normalizeText } from "./markdown-format.mjs";
 
 export function formatRecallHints(source, hints = []) {
   if (!hints.length) return "";
-  const lines = [`[memory_hint source="${source}"]`];
+  const lines = [`[recall source="${source}"]`];
   for (const hint of hints) {
     lines.push(`- ${hint.id} | ${hint.name} | ${hint.description}`);
   }

package/src/memory/markdown-store.mjs

@@ -59,7 +59,7 @@ export class MarkdownMemoryStore {
           continue;
         }
         if (!parsed.frontmatter.description) {
-          diagnostics.push({ type: "warning", path, message: "Memory file is missing description; excluded from memory hint recall" });
+          diagnostics.push({ type: "warning", path, message: "Memory file is missing description; excluded from passive recall" });
         }
         const tags = normalizeTags(parsed.frontmatter.tags ?? []);
         const entry = {

package/src/memory/markdown-tools.mjs

@@ -37,9 +37,9 @@ export function createMarkdownMemoryTools(store, { remoteSources = [] } = {}) {
     defineTool({
       name: "memory_open",
       label: "Memory Open",
-      description: "Open a Markdown memory by id or by path. Use this after memory hint or memory_search when you need more context. Local memories may be edited with edit_file; remote memories are read-only.",
+      description: "Open a Markdown memory by id or by path. Use this after recall hint or memory_search when you need more context. Local memories may be edited with edit_file; remote memories are read-only.",
       parameters: Type.Object({
-        id: Type.Optional(Type.String({ description: "Local memory id from memory hint, e.g. mem_..." })),
+        id: Type.Optional(Type.String({ description: "Local memory id from recall hint, e.g. mem_..." })),
         source: Type.Optional(Type.String({ description: "Memory source: omitted/local or a remote memory name" })),
         path: Type.Optional(Type.String({ description: "Path returned by memory_search" })),
         line: Type.Optional(Type.Number({ description: "Open around this 1-based line number" })),
@@ -70,13 +70,13 @@ export function createMarkdownMemoryTools(store, { remoteSources = [] } = {}) {
       name: "memory_save",
       label: "Memory Save",
       description:
-        "Create a Markdown memory or update whole fields on an existing memory. For targeted edits to an existing memory body or frontmatter, use memory_open to get the path, then edit_file. Before creating a new memory, merge related updates into an existing memory when they share the same topic or decision thread. New memories require name, description, body, and at least one tag because memory hints only use tags. When updating by id, omitted fields keep their existing values; passing tags replaces the full tag list.",
+        "Create a Markdown memory or update whole fields on an existing memory. For targeted edits to an existing memory body or frontmatter, use memory_open to get the path, then edit_file. Before creating a new memory, merge related updates into an existing memory when they share the same topic or decision thread. New memories require name, description, body, and at least one tag because recall hints only use tags. When updating by id, omitted fields keep their existing values; passing tags replaces the full tag list.",
       parameters: Type.Object({
         id: Type.Optional(Type.String({ description: "Existing memory id to update. Omit to create a new memory." })),
         name: Type.Optional(Type.String({ description: "Memory name. Required when creating." })),
-        description: Type.Optional(Type.String({ description: "Short natural-language summary shown in memory hint. Required when creating." })),
+        description: Type.Optional(Type.String({ description: "Short natural-language summary shown in recall hint. Required when creating." })),
         body: Type.Optional(Type.String({ description: "Markdown memory body. Required when creating." })),
-        tags: Type.Optional(Type.Array(Type.String(), { description: "Tags used for memory hint. Required and non-empty when creating; replaces tags when updating. Prefer stable retrieval keys: project name, technology, feature/domain, user/person, and decision topic. Use lowercase kebab-case when possible. Examples: ['march-cli', 'tooling', 'permissions'], ['memory', 'sqlite-index']." })),
+        tags: Type.Optional(Type.Array(Type.String(), { description: "Tags used for recall hint. Required and non-empty when creating; replaces tags when updating. Prefer stable retrieval keys: project name, technology, feature/domain, user/person, and decision topic. Use lowercase kebab-case when possible. Examples: ['march-cli', 'tooling', 'permissions'], ['memory', 'sqlite-index']." })),
       }),
       execute: async (_toolCallId, params) => {
         try {

package/src/memory/root.mjs

@@ -0,0 +1,7 @@
+import { resolve } from "node:path";
+
+export function resolveMemoryRoot(configured, stateRoot) {
+  if (configured) return resolve(String(configured));
+  if (process.env.MARCH_MEMORY_ROOT) return resolve(process.env.MARCH_MEMORY_ROOT);
+  return resolve(stateRoot, "March Memories");
+}