march-cli 0.1.21 → 0.1.23

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