march-cli 0.1.21 → 0.1.22

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 (242) hide show
  1. package/bin/march.mjs +13 -13
  2. package/package.json +43 -43
  3. package/src/agent/command-exec-tool.mjs +172 -168
  4. package/src/agent/context-stats-tool.mjs +57 -57
  5. package/src/agent/editing/diff-apply.mjs +28 -28
  6. package/src/agent/editing/diff-format.mjs +57 -57
  7. package/src/agent/editing/lsp-report.mjs +69 -69
  8. package/src/agent/file-edit-tool.mjs +262 -262
  9. package/src/agent/file-tools/read-file-tool.mjs +112 -112
  10. package/src/agent/file-tools/read-image-tool.mjs +76 -76
  11. package/src/agent/model-payload-dumper.mjs +208 -208
  12. package/src/agent/pi-session/pi-session-sidecar-failure.mjs +10 -10
  13. package/src/agent/provider/payload-messages.mjs +138 -138
  14. package/src/agent/runner/codex-large-context-guard.mjs +87 -87
  15. package/src/agent/runner/codex-transport-compression.mjs +180 -180
  16. package/src/agent/runner/codex-transport-debug.mjs +113 -113
  17. package/src/agent/runner/codex-websocket-event-debug.mjs +130 -130
  18. package/src/agent/runner/fast-model.mjs +36 -36
  19. package/src/agent/runner/runner-cleanup.mjs +12 -12
  20. package/src/agent/runner/runner-init.mjs +15 -15
  21. package/src/agent/runner/runner-session-state.mjs +40 -40
  22. package/src/agent/runner/runner-utils.mjs +24 -24
  23. package/src/agent/runner.mjs +299 -299
  24. package/src/agent/runtime/ipc/ipc-peer.mjs +99 -99
  25. package/src/agent/runtime/ipc/process-ipc-transport.mjs +16 -16
  26. package/src/agent/runtime/remote-runner-client.mjs +73 -73
  27. package/src/agent/runtime/remote-ui-client.mjs +20 -20
  28. package/src/agent/runtime/runner-ipc-target.mjs +125 -125
  29. package/src/agent/runtime/runner-process-client.mjs +47 -47
  30. package/src/agent/runtime/runner-process-entry.mjs +11 -11
  31. package/src/agent/runtime/runner-process-factory.mjs +108 -108
  32. package/src/agent/runtime/runner-runtime-host.mjs +79 -79
  33. package/src/agent/runtime/runtime-factory.mjs +42 -42
  34. package/src/agent/runtime/runtime-host.mjs +34 -34
  35. package/src/agent/runtime/ui-event-bridge.mjs +95 -95
  36. package/src/agent/screen-tools/list-windows-tool.mjs +39 -39
  37. package/src/agent/screen-tools/screen-tool.mjs +49 -49
  38. package/src/agent/screen-tools/windows-screen.mjs +133 -133
  39. package/src/agent/session/session-auto-name.mjs +41 -41
  40. package/src/agent/session/session-binding.mjs +12 -12
  41. package/src/agent/session/session-options.mjs +47 -47
  42. package/src/agent/tool-names.mjs +1 -1
  43. package/src/agent/tool-result.mjs +3 -3
  44. package/src/agent/tool-summary.mjs +112 -112
  45. package/src/agent/tools.mjs +58 -58
  46. package/src/agent/turn/turn-events.mjs +111 -111
  47. package/src/agent/turn/turn-logging.mjs +30 -30
  48. package/src/agent/turn/turn-runner.mjs +196 -196
  49. package/src/agent/vision-capability.mjs +14 -14
  50. package/src/auth/login-command.mjs +90 -90
  51. package/src/auth/storage.mjs +34 -34
  52. package/src/cli/args.mjs +79 -79
  53. package/src/cli/commands/copy-command.mjs +87 -87
  54. package/src/cli/commands/export-command.mjs +206 -206
  55. package/src/cli/commands/extensions-command.mjs +53 -53
  56. package/src/cli/commands/help-command.mjs +7 -7
  57. package/src/cli/commands/model-command.mjs +141 -141
  58. package/src/cli/commands/paste-image-command.mjs +43 -43
  59. package/src/cli/commands/provider-command.mjs +59 -59
  60. package/src/cli/commands/status-command.mjs +194 -194
  61. package/src/cli/commands/thinking-command.mjs +87 -87
  62. package/src/cli/fallback-ui.mjs +156 -156
  63. package/src/cli/input/attachment-tokens.mjs +20 -20
  64. package/src/cli/input/autocomplete.mjs +74 -106
  65. package/src/cli/input/external-editor.mjs +39 -39
  66. package/src/cli/input/file-search/index.mjs +160 -0
  67. package/src/cli/input/history-store.mjs +35 -35
  68. package/src/cli/input/image-clipboard.mjs +55 -55
  69. package/src/cli/input/keybinding-dispatch.mjs +76 -76
  70. package/src/cli/input/keybindings.mjs +96 -96
  71. package/src/cli/input/mode-state.mjs +43 -43
  72. package/src/cli/input/prompt-templates.mjs +84 -84
  73. package/src/cli/input/select-with-keyboard.mjs +86 -86
  74. package/src/cli/permissions.mjs +103 -103
  75. package/src/cli/repl-commands.mjs +86 -86
  76. package/src/cli/repl-loop.mjs +183 -183
  77. package/src/cli/selector-list.mjs +21 -21
  78. package/src/cli/session/pi-session-switch-command.mjs +41 -41
  79. package/src/cli/session/session-command.mjs +23 -23
  80. package/src/cli/session/session-list-command.mjs +68 -68
  81. package/src/cli/session/session-name-command.mjs +26 -26
  82. package/src/cli/session/session-source-command.mjs +89 -89
  83. package/src/cli/session/session-switch-command.mjs +1 -1
  84. package/src/cli/shell/shell-command.mjs +55 -55
  85. package/src/cli/shell/shell-drawer-controls.mjs +33 -33
  86. package/src/cli/shell/shell-drawer.mjs +192 -192
  87. package/src/cli/shell/shell-split-layout.mjs +70 -70
  88. package/src/cli/slash-commands.mjs +192 -192
  89. package/src/cli/startup/create-runtime-runner.mjs +61 -61
  90. package/src/cli/startup/runtime-close.mjs +23 -23
  91. package/src/cli/startup/startup-banner.mjs +71 -71
  92. package/src/cli/startup/startup-session.mjs +51 -51
  93. package/src/cli/status-line-updater.mjs +75 -75
  94. package/src/cli/tool-output.mjs +9 -9
  95. package/src/cli/tui/editor/external-editor-runner.mjs +24 -24
  96. package/src/cli/tui/input/mouse-selection-controller.mjs +91 -91
  97. package/src/cli/tui/input/mouse-tracking.mjs +20 -20
  98. package/src/cli/tui/layout/main-pane-layout.mjs +47 -47
  99. package/src/cli/tui/layout/safe-render-boundary.mjs +46 -46
  100. package/src/cli/tui/markdown-renderer.mjs +285 -285
  101. package/src/cli/tui/output/scroll-state.mjs +79 -79
  102. package/src/cli/tui/output/text-line-renderer.mjs +50 -50
  103. package/src/cli/tui/output/tool-card-renderer.mjs +59 -59
  104. package/src/cli/tui/output/visible-lines.mjs +8 -8
  105. package/src/cli/tui/output-buffer.mjs +293 -293
  106. package/src/cli/tui/permission-request-ui.mjs +18 -18
  107. package/src/cli/tui/recall-rendering.mjs +25 -25
  108. package/src/cli/tui/render/render-scheduler.mjs +26 -26
  109. package/src/cli/tui/render/stream-delta-buffer.mjs +46 -46
  110. package/src/cli/tui/select/editor-select-list.mjs +111 -111
  111. package/src/cli/tui/selection-screen.mjs +269 -269
  112. package/src/cli/tui/status/retry-status.mjs +72 -72
  113. package/src/cli/tui/status/spinner-status.mjs +42 -42
  114. package/src/cli/tui/status/status-bar.mjs +225 -225
  115. package/src/cli/tui/syntax/highlighting.mjs +260 -260
  116. package/src/cli/tui/syntax/languages.mjs +91 -91
  117. package/src/cli/tui/syntax/tree-sitter/bash.highlights.scm +261 -261
  118. package/src/cli/tui/syntax/tree-sitter/c.highlights.scm +341 -341
  119. package/src/cli/tui/syntax/tree-sitter/cpp.highlights.scm +268 -268
  120. package/src/cli/tui/syntax/tree-sitter/csharp.highlights.scm +577 -577
  121. package/src/cli/tui/syntax/tree-sitter/css.highlights.scm +109 -109
  122. package/src/cli/tui/syntax/tree-sitter/diff.highlights.scm +49 -49
  123. package/src/cli/tui/syntax/tree-sitter/go.highlights.scm +254 -254
  124. package/src/cli/tui/syntax/tree-sitter/html.highlights.scm +13 -13
  125. package/src/cli/tui/syntax/tree-sitter/java.highlights.scm +330 -330
  126. package/src/cli/tui/syntax/tree-sitter/json.highlights.scm +38 -38
  127. package/src/cli/tui/syntax/tree-sitter/php.highlights.scm +203 -203
  128. package/src/cli/tui/syntax/tree-sitter/python.highlights.scm +137 -137
  129. package/src/cli/tui/syntax/tree-sitter/ruby.highlights.scm +309 -309
  130. package/src/cli/tui/syntax/tree-sitter/rust.highlights.scm +531 -531
  131. package/src/cli/tui/syntax/tree-sitter/toml.highlights.scm +39 -39
  132. package/src/cli/tui/syntax/tree-sitter/tsx.highlights.scm +35 -35
  133. package/src/cli/tui/syntax/tree-sitter/typescript.highlights.scm +35 -35
  134. package/src/cli/tui/syntax/tree-sitter/yaml.highlights.scm +99 -99
  135. package/src/cli/tui/tool-rendering.mjs +87 -87
  136. package/src/cli/tui/tui-diff-rendering.mjs +157 -157
  137. package/src/cli/tui/tui-handlers.mjs +111 -111
  138. package/src/cli/tui/tui-input-controller.mjs +61 -61
  139. package/src/cli/tui/ui-theme.mjs +157 -157
  140. package/src/cli/ui.mjs +297 -297
  141. package/src/config/config-json.mjs +84 -84
  142. package/src/config/dotenv.mjs +20 -20
  143. package/src/config/features.mjs +75 -75
  144. package/src/config/loader.mjs +143 -143
  145. package/src/config/settings-command.mjs +97 -97
  146. package/src/context/engine.mjs +198 -198
  147. package/src/context/injections.mjs +26 -26
  148. package/src/context/profiles.mjs +39 -39
  149. package/src/context/project-context.mjs +20 -20
  150. package/src/context/session-status.mjs +17 -17
  151. package/src/context/shell-layers.mjs +23 -23
  152. package/src/context/system-core/base.md +65 -65
  153. package/src/context/system-core/prompts/deepseek-v4-pro.md +3 -3
  154. package/src/context/system-core/prompts/default.md +3 -3
  155. package/src/context/system-core.mjs +35 -35
  156. package/src/debug/logger.mjs +141 -141
  157. package/src/debug/model-context-dumper.mjs +52 -52
  158. package/src/extensions/discovery.mjs +40 -40
  159. package/src/extensions/lifecycle-adapter.mjs +210 -210
  160. package/src/extensions/lifecycle-manifest.mjs +69 -69
  161. package/src/image-gen/index.mjs +7 -7
  162. package/src/image-gen/provider.mjs +231 -231
  163. package/src/image-gen/tool.mjs +84 -84
  164. package/src/lsp/client.mjs +257 -257
  165. package/src/lsp/diagnostic-store.mjs +42 -42
  166. package/src/lsp/diagnostics-format.mjs +72 -72
  167. package/src/lsp/managed-node-server.mjs +99 -99
  168. package/src/lsp/path-match.mjs +10 -10
  169. package/src/lsp/server-definitions.mjs +188 -188
  170. package/src/lsp/servers.mjs +165 -165
  171. package/src/lsp/service.mjs +110 -110
  172. package/src/lsp/status-message.mjs +9 -9
  173. package/src/lsp/typescript-project-resolver.mjs +186 -186
  174. package/src/main.mjs +299 -299
  175. package/src/mcp/client.mjs +195 -195
  176. package/src/mcp/config.mjs +130 -130
  177. package/src/mcp/index.mjs +48 -48
  178. package/src/mcp/tools.mjs +98 -98
  179. package/src/memory/database.mjs +219 -219
  180. package/src/memory/glossary.mjs +124 -124
  181. package/src/memory/graph/graph-cascades.mjs +109 -109
  182. package/src/memory/graph/graph-diagnostics.mjs +73 -73
  183. package/src/memory/graph/graph-path-removal.mjs +50 -50
  184. package/src/memory/graph/graph-path-utils.mjs +17 -17
  185. package/src/memory/graph/graph-primitives.mjs +103 -103
  186. package/src/memory/graph/graph-read.mjs +159 -159
  187. package/src/memory/graph.mjs +282 -282
  188. package/src/memory/markdown/markdown-delete.mjs +23 -23
  189. package/src/memory/markdown/markdown-format.mjs +128 -128
  190. package/src/memory/markdown/markdown-recall.mjs +28 -28
  191. package/src/memory/markdown/ripgrep.mjs +16 -16
  192. package/src/memory/markdown/sqlite-index.mjs +87 -87
  193. package/src/memory/markdown-store.mjs +286 -286
  194. package/src/memory/markdown-tools.mjs +103 -103
  195. package/src/memory/search.mjs +142 -142
  196. package/src/memory/snapshot.mjs +86 -86
  197. package/src/memory/system-views.mjs +120 -120
  198. package/src/memory/tools.mjs +282 -282
  199. package/src/network/environment.mjs +131 -131
  200. package/src/notification/desktop-notifier.mjs +262 -262
  201. package/src/platform/open-file.mjs +28 -28
  202. package/src/platform/spawn-command.mjs +27 -27
  203. package/src/provider/accept-command.mjs +89 -89
  204. package/src/provider/command.mjs +21 -21
  205. package/src/provider/config-command.mjs +129 -129
  206. package/src/provider/custom-provider.mjs +113 -113
  207. package/src/provider/hosted-tools.mjs +111 -111
  208. package/src/provider/presets.mjs +72 -72
  209. package/src/provider/share-command.mjs +79 -79
  210. package/src/provider/share-payload.mjs +52 -52
  211. package/src/session/attachment-display.mjs +16 -16
  212. package/src/session/attachment-references.mjs +65 -65
  213. package/src/session/attachments.mjs +140 -140
  214. package/src/session/persist.mjs +1 -1
  215. package/src/session/pi-manager.mjs +34 -34
  216. package/src/session/session-utils.mjs +16 -16
  217. package/src/session/sidecar-sync.mjs +19 -19
  218. package/src/session/sidecar.mjs +69 -69
  219. package/src/session/transcript.mjs +83 -83
  220. package/src/session/tree.mjs +42 -42
  221. package/src/shell/cli-runtime.mjs +11 -11
  222. package/src/shell/hints.mjs +12 -12
  223. package/src/shell/node-pty-adapter.mjs +81 -81
  224. package/src/shell/runtime-state.mjs +126 -126
  225. package/src/shell/runtime.mjs +252 -252
  226. package/src/shell/screen-buffer.mjs +136 -136
  227. package/src/shell/tool-read.mjs +74 -74
  228. package/src/shell/tools.mjs +299 -299
  229. package/src/supergrok/actions/image-generate.mjs +60 -60
  230. package/src/supergrok/actions/search.mjs +78 -78
  231. package/src/supergrok/auth.mjs +36 -36
  232. package/src/supergrok/constants.mjs +18 -18
  233. package/src/supergrok/oauth-provider.mjs +278 -278
  234. package/src/supergrok/provider.mjs +35 -35
  235. package/src/supergrok/response.mjs +76 -76
  236. package/src/supergrok/tool.mjs +61 -61
  237. package/src/text/ansi.mjs +3 -3
  238. package/src/web/config-command.mjs +43 -43
  239. package/src/web/fetch.mjs +78 -78
  240. package/src/web/presets.mjs +16 -16
  241. package/src/web/search.mjs +83 -83
  242. package/src/web/tools.mjs +107 -107
package/src/main.mjs CHANGED
@@ -1,299 +1,299 @@
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
+
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));