march-cli 0.1.23 → 0.1.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (237) hide show
  1. package/README.md +1 -1
  2. package/README.zh.md +1 -1
  3. package/bin/march.mjs +13 -13
  4. package/package.json +49 -43
  5. package/src/agent/command-exec-tool.mjs +172 -172
  6. package/src/agent/context-stats-tool.mjs +57 -57
  7. package/src/agent/editing/cohesion-warning.mjs +57 -0
  8. package/src/agent/editing/diff-apply.mjs +28 -28
  9. package/src/agent/editing/diff-format.mjs +57 -57
  10. package/src/agent/editing/lsp-report.mjs +69 -69
  11. package/src/agent/file-edit-tool.mjs +277 -262
  12. package/src/agent/file-tools/read-file-tool.mjs +112 -112
  13. package/src/agent/file-tools/read-image-tool.mjs +76 -76
  14. package/src/agent/model-payload-dumper.mjs +208 -208
  15. package/src/agent/pi-session/pi-session-sidecar-failure.mjs +10 -10
  16. package/src/agent/provider/payload-messages.mjs +138 -138
  17. package/src/agent/runner/codex-large-context-guard.mjs +87 -87
  18. package/src/agent/runner/codex-transport-compression.mjs +180 -180
  19. package/src/agent/runner/codex-transport-debug.mjs +113 -113
  20. package/src/agent/runner/codex-websocket-event-debug.mjs +130 -130
  21. package/src/agent/runner/fast-model.mjs +36 -36
  22. package/src/agent/runner/runner-cleanup.mjs +12 -12
  23. package/src/agent/runner/runner-init.mjs +15 -15
  24. package/src/agent/runner/runner-session-state.mjs +40 -40
  25. package/src/agent/runner/runner-utils.mjs +24 -24
  26. package/src/agent/runner.mjs +299 -299
  27. package/src/agent/runtime/ipc/ipc-peer.mjs +99 -99
  28. package/src/agent/runtime/ipc/process-ipc-transport.mjs +16 -16
  29. package/src/agent/runtime/remote-runner-client.mjs +73 -73
  30. package/src/agent/runtime/remote-ui-client.mjs +20 -20
  31. package/src/agent/runtime/runner-ipc-target.mjs +125 -125
  32. package/src/agent/runtime/runner-process-client.mjs +47 -47
  33. package/src/agent/runtime/runner-process-entry.mjs +11 -11
  34. package/src/agent/runtime/runner-process-factory.mjs +111 -108
  35. package/src/agent/runtime/runner-runtime-host.mjs +79 -79
  36. package/src/agent/runtime/runtime-factory.mjs +42 -42
  37. package/src/agent/runtime/runtime-host.mjs +34 -34
  38. package/src/agent/runtime/ui-event-bridge.mjs +95 -95
  39. package/src/agent/screen-tools/list-windows-tool.mjs +39 -39
  40. package/src/agent/screen-tools/screen-tool.mjs +49 -49
  41. package/src/agent/screen-tools/windows-screen.mjs +133 -133
  42. package/src/agent/session/session-auto-name.mjs +41 -41
  43. package/src/agent/session/session-binding.mjs +12 -12
  44. package/src/agent/session/session-options.mjs +47 -47
  45. package/src/agent/tool-names.mjs +1 -1
  46. package/src/agent/tool-result.mjs +3 -3
  47. package/src/agent/tool-summary.mjs +112 -112
  48. package/src/agent/tools.mjs +58 -58
  49. package/src/agent/turn/turn-events.mjs +111 -111
  50. package/src/agent/turn/turn-logging.mjs +30 -30
  51. package/src/agent/turn/turn-runner.mjs +196 -196
  52. package/src/agent/vision-capability.mjs +14 -14
  53. package/src/auth/login-command.mjs +90 -90
  54. package/src/auth/storage.mjs +34 -34
  55. package/src/cli/args.mjs +96 -79
  56. package/src/cli/commands/copy-command.mjs +87 -87
  57. package/src/cli/commands/export-command.mjs +206 -206
  58. package/src/cli/commands/extensions-command.mjs +53 -53
  59. package/src/cli/commands/help-command.mjs +7 -7
  60. package/src/cli/commands/model-command.mjs +141 -141
  61. package/src/cli/commands/paste-image-command.mjs +43 -43
  62. package/src/cli/commands/provider-command.mjs +59 -59
  63. package/src/cli/commands/status-command.mjs +196 -194
  64. package/src/cli/commands/thinking-command.mjs +87 -87
  65. package/src/cli/fallback-ui.mjs +156 -156
  66. package/src/cli/input/attachment-tokens.mjs +20 -20
  67. package/src/cli/input/autocomplete.mjs +74 -74
  68. package/src/cli/input/external-editor.mjs +39 -39
  69. package/src/cli/input/file-search/index.mjs +160 -160
  70. package/src/cli/input/history-store.mjs +35 -35
  71. package/src/cli/input/image-clipboard.mjs +55 -55
  72. package/src/cli/input/keybinding-dispatch.mjs +76 -76
  73. package/src/cli/input/keybindings.mjs +96 -96
  74. package/src/cli/input/mode-state.mjs +43 -43
  75. package/src/cli/input/prompt-templates.mjs +84 -84
  76. package/src/cli/input/select-with-keyboard.mjs +86 -86
  77. package/src/cli/permissions.mjs +103 -103
  78. package/src/cli/repl-commands.mjs +86 -86
  79. package/src/cli/repl-loop.mjs +183 -183
  80. package/src/cli/selector-list.mjs +21 -21
  81. package/src/cli/session/pi-session-switch-command.mjs +41 -41
  82. package/src/cli/session/session-command.mjs +23 -23
  83. package/src/cli/session/session-list-command.mjs +68 -68
  84. package/src/cli/session/session-name-command.mjs +26 -26
  85. package/src/cli/session/session-source-command.mjs +89 -89
  86. package/src/cli/session/session-switch-command.mjs +1 -1
  87. package/src/cli/shell/shell-command.mjs +55 -55
  88. package/src/cli/shell/shell-drawer-controls.mjs +33 -33
  89. package/src/cli/shell/shell-drawer.mjs +192 -192
  90. package/src/cli/shell/shell-split-layout.mjs +70 -70
  91. package/src/cli/slash-commands.mjs +192 -192
  92. package/src/cli/startup/create-runtime-runner.mjs +61 -61
  93. package/src/cli/startup/runtime-close.mjs +23 -23
  94. package/src/cli/startup/startup-banner.mjs +71 -71
  95. package/src/cli/startup/startup-session.mjs +51 -51
  96. package/src/cli/status-line-updater.mjs +75 -75
  97. package/src/cli/tool-output.mjs +9 -9
  98. package/src/cli/tui/editor/external-editor-runner.mjs +24 -24
  99. package/src/cli/tui/input/mouse-selection-controller.mjs +91 -91
  100. package/src/cli/tui/input/mouse-tracking.mjs +20 -20
  101. package/src/cli/tui/layout/main-pane-layout.mjs +47 -47
  102. package/src/cli/tui/layout/safe-render-boundary.mjs +46 -46
  103. package/src/cli/tui/markdown-renderer.mjs +285 -285
  104. package/src/cli/tui/output/scroll-state.mjs +79 -79
  105. package/src/cli/tui/output/text-line-renderer.mjs +50 -50
  106. package/src/cli/tui/output/tool-card-renderer.mjs +59 -59
  107. package/src/cli/tui/output/visible-lines.mjs +8 -8
  108. package/src/cli/tui/output-buffer.mjs +293 -293
  109. package/src/cli/tui/permission-request-ui.mjs +18 -18
  110. package/src/cli/tui/recall-rendering.mjs +28 -25
  111. package/src/cli/tui/render/render-scheduler.mjs +26 -26
  112. package/src/cli/tui/render/stream-delta-buffer.mjs +46 -46
  113. package/src/cli/tui/select/editor-select-list.mjs +111 -111
  114. package/src/cli/tui/selection-screen.mjs +269 -269
  115. package/src/cli/tui/status/retry-status.mjs +72 -72
  116. package/src/cli/tui/status/spinner-status.mjs +42 -42
  117. package/src/cli/tui/status/status-bar.mjs +225 -225
  118. package/src/cli/tui/syntax/highlighting.mjs +260 -260
  119. package/src/cli/tui/syntax/languages.mjs +91 -91
  120. package/src/cli/tui/syntax/tree-sitter/bash.highlights.scm +261 -261
  121. package/src/cli/tui/syntax/tree-sitter/c.highlights.scm +341 -341
  122. package/src/cli/tui/syntax/tree-sitter/cpp.highlights.scm +268 -268
  123. package/src/cli/tui/syntax/tree-sitter/csharp.highlights.scm +577 -577
  124. package/src/cli/tui/syntax/tree-sitter/css.highlights.scm +109 -109
  125. package/src/cli/tui/syntax/tree-sitter/diff.highlights.scm +49 -49
  126. package/src/cli/tui/syntax/tree-sitter/go.highlights.scm +254 -254
  127. package/src/cli/tui/syntax/tree-sitter/html.highlights.scm +13 -13
  128. package/src/cli/tui/syntax/tree-sitter/java.highlights.scm +330 -330
  129. package/src/cli/tui/syntax/tree-sitter/json.highlights.scm +38 -38
  130. package/src/cli/tui/syntax/tree-sitter/php.highlights.scm +203 -203
  131. package/src/cli/tui/syntax/tree-sitter/python.highlights.scm +137 -137
  132. package/src/cli/tui/syntax/tree-sitter/ruby.highlights.scm +309 -309
  133. package/src/cli/tui/syntax/tree-sitter/rust.highlights.scm +531 -531
  134. package/src/cli/tui/syntax/tree-sitter/toml.highlights.scm +39 -39
  135. package/src/cli/tui/syntax/tree-sitter/tsx.highlights.scm +35 -35
  136. package/src/cli/tui/syntax/tree-sitter/typescript.highlights.scm +35 -35
  137. package/src/cli/tui/syntax/tree-sitter/yaml.highlights.scm +99 -99
  138. package/src/cli/tui/tool-rendering.mjs +87 -87
  139. package/src/cli/tui/tui-diff-rendering.mjs +157 -157
  140. package/src/cli/tui/tui-handlers.mjs +111 -111
  141. package/src/cli/tui/tui-input-controller.mjs +61 -61
  142. package/src/cli/tui/ui-theme.mjs +157 -157
  143. package/src/cli/ui.mjs +297 -297
  144. package/src/config/config-json.mjs +108 -84
  145. package/src/config/dotenv.mjs +20 -20
  146. package/src/config/features.mjs +75 -75
  147. package/src/config/loader.mjs +156 -143
  148. package/src/config/settings-command.mjs +97 -97
  149. package/src/context/engine.mjs +199 -198
  150. package/src/context/injections.mjs +26 -26
  151. package/src/context/profiles.mjs +39 -39
  152. package/src/context/project-context.mjs +20 -20
  153. package/src/context/session-status.mjs +25 -17
  154. package/src/context/shell-layers.mjs +23 -23
  155. package/src/context/system-core/base.md +50 -50
  156. package/src/context/system-core/prompts/deepseek-v4-pro.md +3 -3
  157. package/src/context/system-core/prompts/default.md +3 -3
  158. package/src/context/system-core.mjs +35 -35
  159. package/src/debug/logger.mjs +141 -141
  160. package/src/debug/model-context-dumper.mjs +52 -52
  161. package/src/extensions/discovery.mjs +40 -40
  162. package/src/extensions/lifecycle-adapter.mjs +210 -210
  163. package/src/extensions/lifecycle-manifest.mjs +69 -69
  164. package/src/image-gen/index.mjs +7 -7
  165. package/src/image-gen/provider.mjs +231 -231
  166. package/src/image-gen/tool.mjs +84 -84
  167. package/src/lsp/client.mjs +257 -257
  168. package/src/lsp/diagnostic-store.mjs +42 -42
  169. package/src/lsp/diagnostics-format.mjs +72 -72
  170. package/src/lsp/managed-node-server.mjs +99 -99
  171. package/src/lsp/path-match.mjs +10 -10
  172. package/src/lsp/server-definitions.mjs +188 -188
  173. package/src/lsp/servers.mjs +165 -165
  174. package/src/lsp/service.mjs +110 -110
  175. package/src/lsp/status-message.mjs +9 -9
  176. package/src/lsp/typescript-project-resolver.mjs +186 -186
  177. package/src/main.mjs +294 -299
  178. package/src/mcp/client.mjs +195 -195
  179. package/src/mcp/config.mjs +130 -130
  180. package/src/mcp/index.mjs +48 -48
  181. package/src/mcp/tools.mjs +98 -98
  182. package/src/memory/command.mjs +120 -0
  183. package/src/memory/markdown/markdown-delete.mjs +23 -23
  184. package/src/memory/markdown/markdown-format.mjs +128 -128
  185. package/src/memory/markdown/markdown-recall.mjs +28 -28
  186. package/src/memory/markdown/ripgrep.mjs +16 -16
  187. package/src/memory/markdown/sqlite-index.mjs +87 -87
  188. package/src/memory/markdown-store.mjs +272 -286
  189. package/src/memory/markdown-tools.mjs +174 -103
  190. package/src/memory/remote/client.mjs +68 -0
  191. package/src/memory/remote/config.mjs +52 -0
  192. package/src/memory/remote/server.mjs +99 -0
  193. package/src/memory/search.mjs +183 -0
  194. package/src/network/environment.mjs +131 -131
  195. package/src/notification/desktop-notifier.mjs +262 -262
  196. package/src/platform/open-file.mjs +28 -28
  197. package/src/platform/spawn-command.mjs +27 -27
  198. package/src/provider/accept-command.mjs +89 -89
  199. package/src/provider/command.mjs +21 -21
  200. package/src/provider/config-command.mjs +129 -129
  201. package/src/provider/custom-provider.mjs +113 -113
  202. package/src/provider/hosted-tools.mjs +111 -111
  203. package/src/provider/presets.mjs +72 -72
  204. package/src/provider/share-command.mjs +79 -79
  205. package/src/provider/share-payload.mjs +52 -52
  206. package/src/session/attachment-display.mjs +16 -16
  207. package/src/session/attachment-references.mjs +65 -65
  208. package/src/session/attachments.mjs +140 -140
  209. package/src/session/persist.mjs +1 -1
  210. package/src/session/pi-manager.mjs +34 -34
  211. package/src/session/session-utils.mjs +16 -16
  212. package/src/session/sidecar-sync.mjs +19 -19
  213. package/src/session/sidecar.mjs +69 -69
  214. package/src/session/transcript.mjs +83 -83
  215. package/src/session/tree.mjs +42 -42
  216. package/src/shell/cli-runtime.mjs +11 -11
  217. package/src/shell/hints.mjs +12 -12
  218. package/src/shell/node-pty-adapter.mjs +81 -81
  219. package/src/shell/runtime-state.mjs +126 -126
  220. package/src/shell/runtime.mjs +252 -252
  221. package/src/shell/screen-buffer.mjs +136 -136
  222. package/src/shell/tool-read.mjs +74 -74
  223. package/src/shell/tools.mjs +299 -299
  224. package/src/supergrok/actions/image-generate.mjs +60 -60
  225. package/src/supergrok/actions/search.mjs +78 -78
  226. package/src/supergrok/auth.mjs +36 -36
  227. package/src/supergrok/constants.mjs +18 -18
  228. package/src/supergrok/oauth-provider.mjs +278 -278
  229. package/src/supergrok/provider.mjs +35 -35
  230. package/src/supergrok/response.mjs +76 -76
  231. package/src/supergrok/tool.mjs +61 -61
  232. package/src/text/ansi.mjs +3 -3
  233. package/src/web/config-command.mjs +43 -43
  234. package/src/web/fetch.mjs +78 -78
  235. package/src/web/presets.mjs +16 -16
  236. package/src/web/search.mjs +83 -83
  237. package/src/web/tools.mjs +107 -107
package/src/main.mjs CHANGED
@@ -1,299 +1,294 @@
1
- import { homedir } from "node:os";
2
- import { join, resolve, basename, relative } from "node:path";
3
- import { existsSync, mkdirSync } from "node:fs";
4
- import { fileURLToPath } from "node:url";
5
- import { parseCliArgs, showHelp } from "./cli/args.mjs";
6
- import { createUI } from "./cli/ui.mjs";
7
- import { createPermissionController, MODE } from "./cli/permissions.mjs";
8
- import { loadKeybindings } from "./cli/input/keybindings.mjs";
9
- import { createInputHistoryStore } from "./cli/input/history-store.mjs";
10
- import { createModeState } from "./cli/input/mode-state.mjs";
11
- import { loadPromptTemplates } from "./cli/input/prompt-templates.mjs";
12
- import { runInteractiveRepl, runSingleShotPrompt } from "./cli/repl-loop.mjs";
13
- import { closeMarchRuntime } from "./cli/startup/runtime-close.mjs";
14
- import { createStatusLineUpdater } from "./cli/status-line-updater.mjs";
15
- import { wireTuiHandlers } from "./cli/tui/tui-handlers.mjs";
16
- import { createMarchAuthStorage } from "./auth/storage.mjs";
17
- import { runLoginCommand } from "./auth/login-command.mjs";
18
- import { createRuntimeRunner } from "./cli/startup/create-runtime-runner.mjs";
19
- import { createCliShellRuntime } from "./shell/cli-runtime.mjs";
20
- import { MarkdownMemoryStore } from "./memory/markdown-store.mjs";
21
- import { createMarkdownMemoryTools } from "./memory/markdown-tools.mjs";
22
- import { loadDotEnv } from "./config/dotenv.mjs";
23
- import { loadConfig } from "./config/loader.mjs";
24
- import { discoverProjectExtensionPaths } from "./extensions/discovery.mjs";
25
- import { loadProjectLifecycleHookManifests } from "./extensions/lifecycle-manifest.mjs";
26
- import { loadOrCreateProjectId, resumeStartupSession } from "./cli/startup/startup-session.mjs";
27
- import { formatStartupBanner } from "./cli/startup/startup-banner.mjs";
28
- import { initializeMcp } from "./mcp/index.mjs";
29
- import { createWebToolsFromConfig } from "./web/tools.mjs";
30
- import { createModelContextDumper } from "./debug/model-context-dumper.mjs";
31
- import { createLogger, installProcessLogHandlers } from "./debug/logger.mjs";
32
- import { defaultProfilePaths, ensureProfileFiles } from "./context/profiles.mjs";
33
- import { runProviderCommand } from "./provider/command.mjs";
34
- import { runWebSearchConfigCommand } from "./web/config-command.mjs";
35
- import { createDesktopTurnNotifier } from "./notification/desktop-notifier.mjs";
36
- import { registerSuperGrokOAuthProvider } from "./supergrok/oauth-provider.mjs";
37
- import { installNetworkEnvironment } from "./network/environment.mjs";
38
-
39
- export async function run(argv) {
40
- const cwd = process.cwd();
41
- loadDotEnv(cwd);
42
- registerSuperGrokOAuthProvider();
43
-
44
- const args = parseCliArgs(argv);
45
- if (args.help) {
46
- showHelp();
47
- return 0;
48
- }
49
-
50
- const config = loadConfig(cwd);
51
- const useRuntimeProcess = process.env.MARCH_RUNTIME_PROCESS !== "0";
52
- installNetworkEnvironment(config.network);
53
- if (args.command?.name === "login") {
54
- try {
55
- return await runLoginCommand({
56
- providerId: args.command.args[0] ?? args.provider,
57
- });
58
- } catch (err) {
59
- process.stderr.write(`Error: ${err.message}\n`);
60
- return 1;
61
- }
62
- }
63
- if (args.command?.name === "provider") {
64
- return await runProviderCommand(args);
65
- }
66
- if (args.command?.name === "websearch") {
67
- if (args.providerConfig) return await runWebSearchConfigCommand({ homeDir: homedir() });
68
- process.stderr.write("Usage: march websearch --config\n");
69
- return 1;
70
- }
71
-
72
- const stateRoot = join(homedir(), ".march");
73
- if (!existsSync(stateRoot)) mkdirSync(stateRoot, { recursive: true });
74
- const logger = createLogger({ logDir: join(stateRoot, "logs") });
75
- installProcessLogHandlers(logger);
76
- logger.event("process.start", {
77
- cwd,
78
- argv,
79
- version: process.version,
80
- platform: process.platform,
81
- logPath: logger.path,
82
- });
83
-
84
- const provider = args.provider ?? config.provider ?? null;
85
- const serviceTier = config.serviceTier ?? null;
86
- const model = args.model ?? config.model ?? null;
87
- const extensionPaths = [
88
- ...discoverProjectExtensionPaths(cwd),
89
- ...args.extensions.map((extensionPath) => resolve(cwd, extensionPath)),
90
- ];
91
- const lifecycleManifests = loadProjectLifecycleHookManifests(cwd);
92
- const keybindingConfig = loadKeybindings(cwd);
93
- const promptTemplateConfig = loadPromptTemplates(cwd);
94
- const authConfig = createMarchAuthStorage({ provider: provider ?? "deepseek", providers: config.providers, cwd });
95
-
96
- if (!authConfig.hasAuth) {
97
- process.stderr.write("Error: no providers configured. Run: march provider --config\n");
98
- return 1;
99
- }
100
-
101
- const projectMarchDir = resolve(cwd, ".march");
102
- if (!existsSync(projectMarchDir)) mkdirSync(projectMarchDir, { recursive: true });
103
- const inputHistoryStore = createInputHistoryStore({ path: join(projectMarchDir, "input-history.json") });
104
- const modeState = createModeState();
105
- const namespace = loadOrCreateProjectId(projectMarchDir);
106
- const memoryRoot = resolveMemoryRoot(config.memoryRoot, stateRoot);
107
- const profilePaths = defaultProfilePaths();
108
- ensureProfileFiles(profilePaths);
109
- const memoryStore = new MarkdownMemoryStore({ root: memoryRoot });
110
- const memoryTools = createMarkdownMemoryTools(memoryStore);
111
- const currentProject = basename(cwd);
112
- const shellRuntime = args.shellRuntime ? createCliShellRuntime({ cwd }) : null;
113
-
114
- const mcpInit = useRuntimeProcess
115
- ? { clientManager: null, mcpTools: [], mcpInjections: [], errors: [] }
116
- : await initializeMcp({ projectDir: cwd });
117
- const { clientManager: mcpClientManager, mcpTools, mcpInjections } = mcpInit;
118
- for (const { server, error } of mcpInit.errors) {
119
- if (args.json) {
120
- // errors will be surfaced in diagnostics via runner status
121
- } else {
122
- process.stderr.write(`[mcp] ${server}: ${error}\n`);
123
- }
124
- }
125
-
126
- const webTools = createWebToolsFromConfig(config);
127
- const turnNotifier = createDesktopTurnNotifier({
128
- enabled: Boolean(config.notifications?.turnEnd),
129
- config: config.notifications,
130
- });
131
-
132
- // Permission controller
133
- const permissionMode = args.permissionMode ?? MODE.BYPASS;
134
- const permissionController = createPermissionController({ mode: permissionMode });
135
-
136
- // Session persistence — always pi mode
137
- const usePiSessions = true;
138
- const usePiRuntimeHost = true;
139
- const sessionSource = "pi";
140
- const sessionsRoot = join(projectMarchDir, "sessions");
141
- const sessionState = {
142
- sessionId: args.resume ?? Date.now().toString(36),
143
- sessionDir: null,
144
- };
145
- sessionState.sessionDir = join(sessionsRoot, sessionState.sessionId);
146
- const contextDumpRoot = resolve(projectMarchDir, "context-dumps", sessionState.sessionId);
147
- const modelContextDumper = createModelContextDumper({
148
- enabled: args.dumpContext,
149
- rootDir: contextDumpRoot,
150
- });
151
-
152
- const ui = createUI({
153
- json: args.json,
154
- cwd,
155
- keybindings: keybindingConfig.keybindings,
156
- promptTemplates: promptTemplateConfig.templates,
157
- shellRuntime,
158
- historyStore: inputHistoryStore,
159
- });
160
-
161
- // Esc to abort current turn
162
- let turnRunning = false;
163
- let refreshStatusBar = null;
164
-
165
- const runnerOptions = {
166
- cwd,
167
- modelId: model,
168
- provider,
169
- serviceTier,
170
- providers: config.providers,
171
- config,
172
- stateRoot,
173
- memoryRoot,
174
- profilePaths,
175
- namespace,
176
- projectMarchDir,
177
- extensionPaths,
178
- permissionMode,
179
- shellRuntime: Boolean(shellRuntime),
180
- lifecycleHooks: lifecycleManifests.hooks,
181
- lifecycleDiagnostics: lifecycleManifests.diagnostics,
182
- modelContextDumper: {
183
- enabled: args.dumpContext,
184
- rootDir: contextDumpRoot,
185
- },
186
- };
187
-
188
- const runner = await createRuntimeRunner({
189
- useRuntimeProcess,
190
- runnerOptions,
191
- ui,
192
- memoryStore,
193
- memoryTools,
194
- shellRuntime,
195
- mcpTools,
196
- mcpInjections,
197
- mcpClientManager,
198
- webTools,
199
- usePiSessions,
200
- usePiRuntimeHost,
201
- authStorage: authConfig.authStorage,
202
- permissionController,
203
- modelContextDumper,
204
- turnNotifier,
205
- logger,
206
- refreshStatusBar: (...args) => refreshStatusBar?.(...args),
207
- });
208
-
209
- refreshStatusBar = createStatusLineUpdater({
210
- ui,
211
- runner,
212
- sessionState,
213
- sessionSource,
214
- getMode: () => modeState.get(),
215
- });
216
- const initialContextTokens = typeof runner.estimateContextTokens === "function"
217
- ? await runner.estimateContextTokens("")
218
- : null;
219
- refreshStatusBar(initialContextTokens ? { contextTokens: initialContextTokens } : undefined);
220
-
221
- wireTuiHandlers({
222
- ui,
223
- runner,
224
- sessionState,
225
- projectMarchDir,
226
- refreshStatusBar,
227
- isTurnRunning: () => turnRunning,
228
- modeState,
229
- });
230
-
231
- // Resume session
232
- const startupResume = await resumeStartupSession({
233
- resumeId: args.resume,
234
- runner,
235
- sessionState,
236
- projectMarchDir,
237
- ui,
238
- });
239
- refreshStatusBar();
240
-
241
- // Single-shot mode
242
- if (args.prompt) {
243
- turnRunning = true;
244
- try {
245
- await runSingleShotPrompt({
246
- prompt: args.prompt,
247
- runner,
248
- memoryStore,
249
- currentProject,
250
- ui,
251
- sessionState,
252
- refreshStatusBar,
253
- modeState,
254
- });
255
- } finally {
256
- turnRunning = false;
257
- await closeMarchRuntime({ runner, memoryStore, ui, logger, blankLine: true });
258
- }
259
- logger.event("process.exit", { code: 0 });
260
- return 0;
261
- }
262
-
263
- const dumpContextPath = args.dumpContext ? relative(cwd, contextDumpRoot) : null;
264
- if (startupResume.transcriptTurns?.length > 0) ui.restoreTranscript?.(startupResume.transcriptTurns);
265
- for (const line of formatStartupBanner({ cwd, modelId: runner.engine.modelId, thinkingLevel: runner.engine.thinkingLevel, mode: modeState.get(), dumpContextPath })) ui.writeln(line);
266
- try {
267
- await runInteractiveRepl({
268
- cwd,
269
- args,
270
- ui,
271
- runner,
272
- memoryStore,
273
- currentProject,
274
- sessionState,
275
- sessionsRoot,
276
- projectMarchDir,
277
- sessionSource,
278
- extensionPaths,
279
- keybindingConfig,
280
- promptTemplateConfig,
281
- renderStartupBanner: () => formatStartupBanner({ cwd, modelId: runner.engine.modelId, thinkingLevel: runner.engine.thinkingLevel, mode: modeState.get(), dumpContextPath }),
282
- refreshStatusBar,
283
- setTurnRunning: (value) => { turnRunning = value; },
284
- modeState,
285
- });
286
- } finally {
287
- await closeMarchRuntime({ runner, memoryStore, ui, logger });
288
- }
289
- logger.event("process.exit", { code: 0 });
290
- return 0;
291
- }
292
-
293
- function resolveMemoryRoot(configured, stateRoot) {
294
- if (configured) return resolve(String(configured));
295
- if (process.env.MARCH_MEMORY_ROOT) return resolve(process.env.MARCH_MEMORY_ROOT);
296
- return resolve(stateRoot, "March Memories");
297
- }
298
-
299
- if (process.argv[1] === fileURLToPath(import.meta.url)) process.exitCode = await run(process.argv.slice(2));
1
+ import { homedir } from "node:os";
2
+ import { join, resolve, basename, relative } from "node:path";
3
+ import { existsSync, mkdirSync } from "node:fs";
4
+ import { fileURLToPath } from "node:url";
5
+ import { parseCliArgs, showHelp } from "./cli/args.mjs";
6
+ import { createUI } from "./cli/ui.mjs";
7
+ import { createPermissionController, MODE } from "./cli/permissions.mjs";
8
+ import { loadKeybindings } from "./cli/input/keybindings.mjs";
9
+ import { createInputHistoryStore } from "./cli/input/history-store.mjs";
10
+ import { createModeState } from "./cli/input/mode-state.mjs";
11
+ import { loadPromptTemplates } from "./cli/input/prompt-templates.mjs";
12
+ import { runInteractiveRepl, runSingleShotPrompt } from "./cli/repl-loop.mjs";
13
+ import { closeMarchRuntime } from "./cli/startup/runtime-close.mjs";
14
+ import { createStatusLineUpdater } from "./cli/status-line-updater.mjs";
15
+ import { wireTuiHandlers } from "./cli/tui/tui-handlers.mjs";
16
+ import { createMarchAuthStorage } from "./auth/storage.mjs";
17
+ import { runLoginCommand } from "./auth/login-command.mjs";
18
+ import { createRuntimeRunner } from "./cli/startup/create-runtime-runner.mjs";
19
+ import { createCliShellRuntime } from "./shell/cli-runtime.mjs";
20
+ import { MarkdownMemoryStore } from "./memory/markdown-store.mjs";
21
+ import { createMarkdownMemoryTools } from "./memory/markdown-tools.mjs";
22
+ import { loadDotEnv } from "./config/dotenv.mjs";
23
+ import { loadConfig } from "./config/loader.mjs";
24
+ import { discoverProjectExtensionPaths } from "./extensions/discovery.mjs";
25
+ import { loadProjectLifecycleHookManifests } from "./extensions/lifecycle-manifest.mjs";
26
+ import { loadOrCreateProjectId, resumeStartupSession } from "./cli/startup/startup-session.mjs";
27
+ import { formatStartupBanner } from "./cli/startup/startup-banner.mjs";
28
+ import { initializeMcp } from "./mcp/index.mjs";
29
+ import { createWebToolsFromConfig } from "./web/tools.mjs";
30
+ import { createModelContextDumper } from "./debug/model-context-dumper.mjs";
31
+ import { createLogger, installProcessLogHandlers } from "./debug/logger.mjs";
32
+ import { defaultProfilePaths, ensureProfileFiles } from "./context/profiles.mjs";
33
+ import { runProviderCommand } from "./provider/command.mjs";
34
+ import { runWebSearchConfigCommand } from "./web/config-command.mjs";
35
+ import { createDesktopTurnNotifier } from "./notification/desktop-notifier.mjs";
36
+ import { registerSuperGrokOAuthProvider } from "./supergrok/oauth-provider.mjs";
37
+ import { installNetworkEnvironment } from "./network/environment.mjs";
38
+ import { runMemoryCommand } from "./memory/command.mjs";
39
+ import { normalizeRemoteMemorySources } from "./memory/remote/config.mjs";
40
+ export async function run(argv) {
41
+ const cwd = process.cwd();
42
+ loadDotEnv(cwd);
43
+ registerSuperGrokOAuthProvider();
44
+
45
+ const args = parseCliArgs(argv);
46
+ if (args.help) {
47
+ showHelp();
48
+ return 0;
49
+ }
50
+
51
+ const config = loadConfig(cwd);
52
+ const useRuntimeProcess = process.env.MARCH_RUNTIME_PROCESS !== "0";
53
+ installNetworkEnvironment(config.network);
54
+ if (args.command?.name === "login") {
55
+ try {
56
+ return await runLoginCommand({
57
+ providerId: args.command.args[0] ?? args.provider,
58
+ });
59
+ } catch (err) {
60
+ process.stderr.write(`Error: ${err.message}\n`);
61
+ return 1;
62
+ }
63
+ }
64
+ if (args.command?.name === "provider") {
65
+ return await runProviderCommand(args);
66
+ }
67
+ if (args.command?.name === "websearch") {
68
+ if (args.providerConfig) return await runWebSearchConfigCommand({ homeDir: homedir() });
69
+ process.stderr.write("Usage: march websearch --config\n");
70
+ return 1;
71
+ }
72
+ if (args.command?.name === "memory") {
73
+ args.memoryRoot = resolveMemoryRoot(config.memoryRoot, join(homedir(), ".march"));
74
+ return await runMemoryCommand(args, { homeDir: homedir() });
75
+ }
76
+ const stateRoot = join(homedir(), ".march");
77
+ if (!existsSync(stateRoot)) mkdirSync(stateRoot, { recursive: true });
78
+ const logger = createLogger({ logDir: join(stateRoot, "logs") });
79
+ installProcessLogHandlers(logger);
80
+ logger.event("process.start", {
81
+ cwd,
82
+ argv,
83
+ version: process.version,
84
+ platform: process.platform,
85
+ logPath: logger.path,
86
+ });
87
+
88
+ const provider = args.provider ?? config.provider ?? null;
89
+ const serviceTier = config.serviceTier ?? null;
90
+ const model = args.model ?? config.model ?? null;
91
+ const extensionPaths = [
92
+ ...discoverProjectExtensionPaths(cwd),
93
+ ...args.extensions.map((extensionPath) => resolve(cwd, extensionPath)),
94
+ ];
95
+ const lifecycleManifests = loadProjectLifecycleHookManifests(cwd);
96
+ const keybindingConfig = loadKeybindings(cwd);
97
+ const promptTemplateConfig = loadPromptTemplates(cwd);
98
+ const authConfig = createMarchAuthStorage({ provider: provider ?? "deepseek", providers: config.providers, cwd });
99
+
100
+ if (!authConfig.hasAuth) {
101
+ process.stderr.write("Error: no providers configured. Run: march provider --config\n");
102
+ return 1;
103
+ }
104
+
105
+ const projectMarchDir = resolve(cwd, ".march");
106
+ if (!existsSync(projectMarchDir)) mkdirSync(projectMarchDir, { recursive: true });
107
+ const inputHistoryStore = createInputHistoryStore({ path: join(projectMarchDir, "input-history.json") });
108
+ const modeState = createModeState();
109
+ const namespace = loadOrCreateProjectId(projectMarchDir);
110
+ const memoryRoot = resolveMemoryRoot(config.memoryRoot, stateRoot);
111
+ const profilePaths = defaultProfilePaths();
112
+ ensureProfileFiles(profilePaths);
113
+ const memoryStore = new MarkdownMemoryStore({ root: memoryRoot });
114
+ const remoteMemorySources = normalizeRemoteMemorySources(config);
115
+ const memoryTools = createMarkdownMemoryTools(memoryStore, { remoteSources: remoteMemorySources });
116
+ const currentProject = basename(cwd);
117
+ const shellRuntime = args.shellRuntime ? createCliShellRuntime({ cwd }) : null;
118
+
119
+ const mcpInit = useRuntimeProcess
120
+ ? { clientManager: null, mcpTools: [], mcpInjections: [], errors: [] }
121
+ : await initializeMcp({ projectDir: cwd });
122
+ const { clientManager: mcpClientManager, mcpTools, mcpInjections } = mcpInit;
123
+ for (const { server, error } of mcpInit.errors) {
124
+ if (args.json) {
125
+ // errors will be surfaced in diagnostics via runner status
126
+ } else {
127
+ process.stderr.write(`[mcp] ${server}: ${error}\n`);
128
+ }
129
+ }
130
+
131
+ const webTools = createWebToolsFromConfig(config);
132
+ const turnNotifier = createDesktopTurnNotifier({ enabled: Boolean(config.notifications?.turnEnd), config: config.notifications });
133
+ const permissionMode = args.permissionMode ?? MODE.BYPASS;
134
+ const permissionController = createPermissionController({ mode: permissionMode });
135
+ const usePiSessions = true;
136
+ const usePiRuntimeHost = true;
137
+ const sessionSource = "pi";
138
+ const sessionsRoot = join(projectMarchDir, "sessions");
139
+ const sessionState = {
140
+ sessionId: args.resume ?? Date.now().toString(36),
141
+ sessionDir: null,
142
+ };
143
+ sessionState.sessionDir = join(sessionsRoot, sessionState.sessionId);
144
+ const contextDumpRoot = resolve(projectMarchDir, "context-dumps", sessionState.sessionId);
145
+ const modelContextDumper = createModelContextDumper({
146
+ enabled: args.dumpContext,
147
+ rootDir: contextDumpRoot,
148
+ });
149
+
150
+ const ui = createUI({
151
+ json: args.json,
152
+ cwd,
153
+ keybindings: keybindingConfig.keybindings,
154
+ promptTemplates: promptTemplateConfig.templates,
155
+ shellRuntime,
156
+ historyStore: inputHistoryStore,
157
+ });
158
+
159
+ // Esc to abort current turn
160
+ let turnRunning = false;
161
+ let refreshStatusBar = null;
162
+
163
+ const runnerOptions = {
164
+ cwd,
165
+ modelId: model,
166
+ provider,
167
+ serviceTier,
168
+ providers: config.providers,
169
+ config,
170
+ stateRoot,
171
+ memoryRoot,
172
+ profilePaths,
173
+ namespace,
174
+ projectMarchDir,
175
+ extensionPaths,
176
+ permissionMode,
177
+ shellRuntime: Boolean(shellRuntime),
178
+ lifecycleHooks: lifecycleManifests.hooks,
179
+ lifecycleDiagnostics: lifecycleManifests.diagnostics,
180
+ modelContextDumper: { enabled: args.dumpContext, rootDir: contextDumpRoot },
181
+ remoteMemorySources,
182
+ };
183
+ const runner = await createRuntimeRunner({
184
+ useRuntimeProcess,
185
+ runnerOptions,
186
+ ui,
187
+ memoryStore,
188
+ memoryTools,
189
+ shellRuntime,
190
+ mcpTools,
191
+ mcpInjections,
192
+ mcpClientManager,
193
+ webTools,
194
+ usePiSessions,
195
+ usePiRuntimeHost,
196
+ authStorage: authConfig.authStorage,
197
+ permissionController,
198
+ modelContextDumper,
199
+ turnNotifier,
200
+ logger,
201
+ refreshStatusBar: (...args) => refreshStatusBar?.(...args),
202
+ });
203
+
204
+ refreshStatusBar = createStatusLineUpdater({
205
+ ui,
206
+ runner,
207
+ sessionState,
208
+ sessionSource,
209
+ getMode: () => modeState.get(),
210
+ });
211
+ const initialContextTokens = typeof runner.estimateContextTokens === "function"
212
+ ? await runner.estimateContextTokens("")
213
+ : null;
214
+ refreshStatusBar(initialContextTokens ? { contextTokens: initialContextTokens } : undefined);
215
+
216
+ wireTuiHandlers({
217
+ ui,
218
+ runner,
219
+ sessionState,
220
+ projectMarchDir,
221
+ refreshStatusBar,
222
+ isTurnRunning: () => turnRunning,
223
+ modeState,
224
+ });
225
+
226
+
227
+ const startupResume = await resumeStartupSession({
228
+ resumeId: args.resume,
229
+ runner,
230
+ sessionState,
231
+ projectMarchDir,
232
+ ui,
233
+ });
234
+ refreshStatusBar();
235
+
236
+
237
+ if (args.prompt) {
238
+ turnRunning = true;
239
+ try {
240
+ await runSingleShotPrompt({
241
+ prompt: args.prompt,
242
+ runner,
243
+ memoryStore,
244
+ currentProject,
245
+ ui,
246
+ sessionState,
247
+ refreshStatusBar,
248
+ modeState,
249
+ });
250
+ } finally {
251
+ turnRunning = false;
252
+ await closeMarchRuntime({ runner, memoryStore, ui, logger, blankLine: true });
253
+ }
254
+ logger.event("process.exit", { code: 0 });
255
+ return 0;
256
+ }
257
+
258
+ const dumpContextPath = args.dumpContext ? relative(cwd, contextDumpRoot) : null;
259
+ if (startupResume.transcriptTurns?.length > 0) ui.restoreTranscript?.(startupResume.transcriptTurns);
260
+ for (const line of formatStartupBanner({ cwd, modelId: runner.engine.modelId, thinkingLevel: runner.engine.thinkingLevel, mode: modeState.get(), dumpContextPath })) ui.writeln(line);
261
+ try {
262
+ await runInteractiveRepl({
263
+ cwd,
264
+ args,
265
+ ui,
266
+ runner,
267
+ memoryStore,
268
+ currentProject,
269
+ sessionState,
270
+ sessionsRoot,
271
+ projectMarchDir,
272
+ sessionSource,
273
+ extensionPaths,
274
+ keybindingConfig,
275
+ promptTemplateConfig,
276
+ renderStartupBanner: () => formatStartupBanner({ cwd, modelId: runner.engine.modelId, thinkingLevel: runner.engine.thinkingLevel, mode: modeState.get(), dumpContextPath }),
277
+ refreshStatusBar,
278
+ setTurnRunning: (value) => { turnRunning = value; },
279
+ modeState,
280
+ });
281
+ } finally {
282
+ await closeMarchRuntime({ runner, memoryStore, ui, logger });
283
+ }
284
+ logger.event("process.exit", { code: 0 });
285
+ return 0;
286
+ }
287
+
288
+ function resolveMemoryRoot(configured, stateRoot) {
289
+ if (configured) return resolve(String(configured));
290
+ if (process.env.MARCH_MEMORY_ROOT) return resolve(process.env.MARCH_MEMORY_ROOT);
291
+ return resolve(stateRoot, "March Memories");
292
+ }
293
+
294
+ if (process.argv[1] === fileURLToPath(import.meta.url)) process.exitCode = await run(process.argv.slice(2));