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
@@ -1,282 +0,0 @@
1
- import { randomUUID } from "node:crypto";
2
- import { ROOT_NODE_UUID } from "./database.mjs";
3
- import {
4
- getChildren,
5
- getMemoryByPath,
6
- getRecentMemories,
7
- } from "./graph/graph-read.mjs";
8
- import { getGraphDiagnostics } from "./graph/graph-diagnostics.mjs";
9
- import {
10
- cascadeCreatePaths,
11
- cascadeDeleteNode,
12
- deprecateNodeMemories,
13
- } from "./graph/graph-cascades.mjs";
14
- import { removeGraphPath } from "./graph/graph-path-removal.mjs";
15
- import {
16
- graphUri,
17
- leafName,
18
- pathExists,
19
- } from "./graph/graph-path-utils.mjs";
20
- import {
21
- ensureNode,
22
- getNextChildNumber,
23
- getOrCreateEdge,
24
- insertMemory,
25
- insertPath,
26
- resolveGraphPath,
27
- wouldCreateCycle,
28
- } from "./graph/graph-primitives.mjs";
29
-
30
- export class GraphService {
31
- constructor(db, { changesetStore = null, searchIndexer = null, namespace = "" } = {}) {
32
- this.db = db;
33
- this.changesetStore = changesetStore;
34
- this.searchIndexer = searchIndexer;
35
- this.namespace = namespace;
36
- }
37
-
38
- /**
39
- * Resolve namespace: explicit arg takes precedence, then instance default.
40
- */
41
- #ns(explicit = undefined) {
42
- return explicit !== undefined ? explicit : this.namespace;
43
- }
44
-
45
- // ═══════════════════════════════════════════════════════════════════
46
- // Read Operations
47
- // ═══════════════════════════════════════════════════════════════════
48
-
49
- getMemoryByPath(path, domain = "core", namespace = "") {
50
- return getMemoryByPath(this.db, path, domain, namespace);
51
- }
52
-
53
- getChildren(nodeUuid = ROOT_NODE_UUID, contextDomain = null, contextPath = null, namespace = "") {
54
- return getChildren(this.db, nodeUuid, contextDomain, contextPath, this.#ns(namespace));
55
- }
56
-
57
- getRecentMemories(limit = 10, namespace = "") {
58
- return getRecentMemories(this.db, limit, namespace);
59
- }
60
-
61
- resolvePath(path, domain = "core", namespace = "") {
62
- return resolveGraphPath(this.db, path, domain, namespace);
63
- }
64
-
65
- getPathsForNode(nodeUuid, namespace = "") {
66
- return this.db.prepare(
67
- "SELECT * FROM paths WHERE node_uuid = ? AND namespace = ?"
68
- ).all(nodeUuid, namespace);
69
- }
70
-
71
- getCurrentMemory(nodeUuid) {
72
- return this.db.prepare(
73
- "SELECT * FROM memories WHERE node_uuid = ? AND deprecated = 0 ORDER BY id DESC LIMIT 1"
74
- ).get(nodeUuid);
75
- }
76
-
77
- touchNode(nodeUuid) {
78
- this.db.prepare(
79
- "UPDATE nodes SET last_accessed_at = datetime('now') WHERE uuid = ?"
80
- ).run(nodeUuid);
81
- }
82
-
83
- getDiagnostics(namespace = "", daysStale = 30, maxChildren = 10) {
84
- return getGraphDiagnostics(this.db, namespace, daysStale, maxChildren);
85
- }
86
-
87
- cascadeDeleteNode(nodeUuid) {
88
- return cascadeDeleteNode(this.db, nodeUuid);
89
- }
90
-
91
- #createEdgeWithPaths(parentUuid, childUuid, name, domain, path, priority = 0, disclosure = null, namespace = "") {
92
- const { edge, created } = getOrCreateEdge(this.db, parentUuid, childUuid, name, priority, disclosure);
93
- insertPath(this.db, namespace, domain, path, edge.id, childUuid);
94
- cascadeCreatePaths(this.db, childUuid, domain, path, namespace);
95
- return { edge, edge_id: edge.id, edge_created: created };
96
- }
97
-
98
- // ═══════════════════════════════════════════════════════════════════
99
- // Public Write API
100
- // ═══════════════════════════════════════════════════════════════════
101
-
102
- createMemory(parentPath, content, priority, { title = null, disclosure = null, domain = "core", namespace = "" } = {}) {
103
- const parentUuid = parentPath === ""
104
- ? ROOT_NODE_UUID
105
- : resolveGraphPath(this.db, parentPath, domain, namespace)?.node_uuid;
106
-
107
- if (!parentUuid && parentPath !== "") {
108
- throw new Error(`Parent '${domain}://${parentPath}' does not exist.`);
109
- }
110
-
111
- const finalPath = title
112
- ? (parentPath ? `${parentPath}/${title}` : title)
113
- : `${parentPath ? parentPath + "/" : ""}${getNextChildNumber(this.db, parentUuid, this.#ns(namespace))}`;
114
-
115
- if (pathExists(this.db, namespace, domain, finalPath)) throw new Error(`Path '${graphUri(domain, finalPath)}' already exists`);
116
-
117
- const newUuid = randomUUID();
118
- ensureNode(this.db, newUuid);
119
- const memory = insertMemory(this.db, newUuid, content);
120
- const edgeName = title ?? leafName(finalPath);
121
-
122
- const created = this.#createEdgeWithPaths(parentUuid, newUuid, edgeName, domain, finalPath, priority, disclosure, namespace);
123
-
124
- if (this.changesetStore) {
125
- this.changesetStore.record({ memoryId: memory.id, nodeUuid: newUuid, beforeContent: null, afterContent: content });
126
- }
127
- if (this.searchIndexer) {
128
- this.searchIndexer.index(newUuid, content, namespace);
129
- }
130
-
131
- return {
132
- id: memory.id, node_uuid: newUuid, domain, path: finalPath,
133
- uri: graphUri(domain, finalPath), priority,
134
- };
135
- }
136
-
137
- updateMemory(path, { content = null, priority = null, disclosure = null, domain = "core", namespace = "" } = {}) {
138
- if (path === "") throw new Error("Cannot update the root node.");
139
- if (content === null && priority === null && disclosure === null) {
140
- throw new Error("At least one of content, priority, or disclosure must be set.");
141
- }
142
-
143
- const resolved = resolveGraphPath(this.db, path, domain, namespace);
144
- if (!resolved || !resolved.edge) {
145
- throw new Error(`Path '${graphUri(domain, path)}' not found`);
146
- }
147
-
148
- const { edge, node_uuid: nodeUuid } = resolved;
149
- let oldMemoryId = null;
150
- let newMemoryId = null;
151
-
152
- // Get current memory
153
- const currentMem = this.db.prepare(
154
- "SELECT id FROM memories WHERE node_uuid = ? AND deprecated = 0 ORDER BY created_at DESC LIMIT 1"
155
- ).get(nodeUuid);
156
- oldMemoryId = currentMem?.id ?? null;
157
-
158
- // Update edge metadata
159
- if (priority !== null) {
160
- this.db.prepare("UPDATE edges SET priority = ? WHERE id = ?").run(priority, edge.id);
161
- }
162
- if (disclosure !== null) {
163
- this.db.prepare("UPDATE edges SET disclosure = ? WHERE id = ?").run(disclosure, edge.id);
164
- }
165
-
166
- // Content change → new memory version
167
- if (content !== null) {
168
- const newMem = insertMemory(this.db, nodeUuid, content, false);
169
- newMemoryId = newMem.id;
170
- deprecateNodeMemories(this.db, nodeUuid, newMemoryId);
171
- this.db.prepare(
172
- "UPDATE memories SET deprecated = 0, migrated_to = NULL WHERE id = ?"
173
- ).run(newMemoryId);
174
-
175
- // Record changeset + re-index
176
- if (this.changesetStore) {
177
- const oldContent = oldMemoryId
178
- ? this.db.prepare("SELECT content FROM memories WHERE id = ?").get(oldMemoryId)?.content ?? null
179
- : null;
180
- this.changesetStore.record({ memoryId: newMemoryId, nodeUuid, beforeContent: oldContent, afterContent: content });
181
- }
182
- if (this.searchIndexer) {
183
- this.searchIndexer.index(nodeUuid, content, namespace);
184
- }
185
- }
186
-
187
- return {
188
- domain, path, uri: graphUri(domain, path),
189
- old_memory_id: oldMemoryId, new_memory_id: newMemoryId ?? oldMemoryId, node_uuid: nodeUuid,
190
- };
191
- }
192
-
193
- rollbackToMemory(targetMemoryId) {
194
- const target = this.db.prepare("SELECT * FROM memories WHERE id = ?").get(targetMemoryId);
195
- if (!target) throw new Error(`Memory ID ${targetMemoryId} not found`);
196
-
197
- if (!target.deprecated) {
198
- return { restored_memory_id: targetMemoryId, was_already_active: true };
199
- }
200
-
201
- deprecateNodeMemories(this.db, target.node_uuid, targetMemoryId);
202
- this.db.prepare(
203
- "UPDATE memories SET deprecated = 0, migrated_to = NULL WHERE id = ?"
204
- ).run(targetMemoryId);
205
-
206
- return { restored_memory_id: targetMemoryId, node_uuid: target.node_uuid };
207
- }
208
-
209
- addPath(newPath, targetPath, { newDomain = "core", targetDomain = "core", priority = 0, disclosure = null, namespace = "" } = {}) {
210
- if (newPath === "") throw new Error("Cannot create alias at root path.");
211
-
212
- const target = resolveGraphPath(this.db, targetPath, targetDomain, namespace);
213
- if (!target) throw new Error(`Target '${graphUri(targetDomain, targetPath)}' not found`);
214
-
215
- const parentUuid = newPath.includes("/")
216
- ? resolveGraphPath(this.db, newPath.substring(0, newPath.lastIndexOf("/")), newDomain, namespace)?.node_uuid ?? ROOT_NODE_UUID
217
- : ROOT_NODE_UUID;
218
-
219
- if (pathExists(this.db, namespace, newDomain, newPath)) throw new Error(`Path '${graphUri(newDomain, newPath)}' already exists`);
220
-
221
- if (wouldCreateCycle(this.db, parentUuid, target.node_uuid)) {
222
- throw new Error(`Cannot create alias: would create a cycle.`);
223
- }
224
-
225
- const result = this.#createEdgeWithPaths(
226
- parentUuid, target.node_uuid,
227
- leafName(newPath), newDomain, newPath,
228
- priority, disclosure ?? target.edge?.disclosure, namespace,
229
- );
230
-
231
- return {
232
- new_uri: graphUri(newDomain, newPath),
233
- target_uri: graphUri(targetDomain, targetPath),
234
- node_uuid: target.node_uuid,
235
- edge_id: result.edge_id, edge_created: result.edge_created,
236
- };
237
- }
238
-
239
- removePath(path, domain = "core", namespace = "") {
240
- return removeGraphPath(this.db, path, domain, namespace);
241
- }
242
-
243
- restorePath(path, domain, nodeUuid, { parentUuid = null, priority = 0, disclosure = null, namespace = "" } = {}) {
244
- if (path === "") throw new Error("Cannot restore root path.");
245
-
246
- // Check node exists and has an active memory
247
- const node = this.db.prepare("SELECT uuid FROM nodes WHERE uuid = ?").get(nodeUuid);
248
- if (!node) throw new Error(`Node '${nodeUuid}' not found`);
249
-
250
- const activeMem = this.db.prepare(
251
- "SELECT id FROM memories WHERE node_uuid = ? AND deprecated = 0"
252
- ).get(nodeUuid);
253
- if (!activeMem) {
254
- const latest = this.db.prepare(
255
- "SELECT id FROM memories WHERE node_uuid = ? ORDER BY created_at DESC LIMIT 1"
256
- ).get(nodeUuid);
257
- if (!latest) throw new Error(`Node '${nodeUuid}' has no memory versions`);
258
- this.db.prepare(
259
- "UPDATE memories SET deprecated = 0, migrated_to = NULL WHERE id = ?"
260
- ).run(latest.id);
261
- }
262
-
263
- if (pathExists(this.db, namespace, domain, path)) throw new Error(`Path '${graphUri(domain, path)}' already exists`);
264
-
265
- if (!parentUuid) {
266
- if (path.includes("/")) {
267
- const parentPath = path.substring(0, path.lastIndexOf("/"));
268
- const parent = resolveGraphPath(this.db, parentPath, domain, namespace);
269
- parentUuid = parent?.node_uuid ?? ROOT_NODE_UUID;
270
- } else {
271
- parentUuid = ROOT_NODE_UUID;
272
- }
273
- }
274
-
275
- const edgeName = leafName(path);
276
- const { edge } = getOrCreateEdge(this.db, parentUuid, nodeUuid, edgeName, priority, disclosure);
277
- insertPath(this.db, namespace, domain, path, edge.id, nodeUuid);
278
-
279
- return { uri: graphUri(domain, path), node_uuid: nodeUuid };
280
- }
281
- }
282
-
@@ -1,142 +0,0 @@
1
- export class SearchIndexer {
2
- constructor(db) {
3
- this.db = db;
4
- this.#ensureSchema();
5
- }
6
-
7
- #ensureSchema() {
8
- this.db.exec(`
9
- CREATE VIRTUAL TABLE IF NOT EXISTS search_fts USING fts5(
10
- node_uuid,
11
- namespace,
12
- content,
13
- tokenize = 'porter unicode61'
14
- );
15
- `);
16
- }
17
-
18
- /**
19
- * Index a memory's content for full-text search.
20
- * Replaces any existing entry for the same (node_uuid, namespace).
21
- */
22
- index(nodeUuid, content, namespace = "") {
23
- this.remove(nodeUuid, namespace);
24
- this.db.prepare(
25
- "INSERT INTO search_fts (node_uuid, namespace, content) VALUES (?, ?, ?)",
26
- ).run(nodeUuid, namespace, content);
27
- }
28
-
29
- /**
30
- * Remove a document from the FTS index.
31
- */
32
- remove(nodeUuid, namespace = "") {
33
- this.db.prepare(
34
- "DELETE FROM search_fts WHERE node_uuid = ? AND namespace = ?",
35
- ).run(nodeUuid, namespace);
36
- }
37
-
38
- /**
39
- * Full-text search with ranking.
40
- * Returns matching node UUIDs, ranked by relevance.
41
- */
42
- search(query, { namespace = "", limit = 20, offset = 0 } = {}) {
43
- // Sanitize FTS5 query: escape special chars, wrap in quotes for phrase matching
44
- const sanitized = query.replace(/["*()]/g, "").trim();
45
- if (!sanitized) return [];
46
-
47
- const ftsQuery = sanitized.split(/\s+/).map(w => `"${w}"`).join(" OR ");
48
-
49
- let sql;
50
- let params;
51
- if (namespace) {
52
- sql = `
53
- SELECT node_uuid, namespace, content,
54
- rank AS score,
55
- snippet(search_fts, 1, '<mark>', '</mark>', '...', 32) AS snippet
56
- FROM search_fts
57
- WHERE search_fts MATCH ? AND namespace = ?
58
- ORDER BY rank
59
- LIMIT ? OFFSET ?
60
- `;
61
- params = [ftsQuery, namespace, limit, offset];
62
- } else {
63
- sql = `
64
- SELECT node_uuid, namespace, content,
65
- rank AS score,
66
- snippet(search_fts, 1, '<mark>', '</mark>', '...', 32) AS snippet
67
- FROM search_fts
68
- WHERE search_fts MATCH ?
69
- ORDER BY rank
70
- LIMIT ? OFFSET ?
71
- `;
72
- params = [ftsQuery, limit, offset];
73
- }
74
-
75
- return this.db.prepare(sql).all(...params);
76
- }
77
-
78
- /**
79
- * Quick count of indexed documents.
80
- */
81
- count(namespace = "") {
82
- if (namespace) {
83
- return this.db.prepare("SELECT COUNT(*) AS cnt FROM search_fts WHERE namespace = ?").get(namespace).cnt;
84
- }
85
- return this.db.prepare("SELECT COUNT(*) AS cnt FROM search_fts").get().cnt;
86
- }
87
-
88
- /**
89
- * Delete all entries for a namespace.
90
- */
91
- clearNamespace(namespace) {
92
- const result = this.db.prepare("DELETE FROM search_fts WHERE namespace = ?").run(namespace);
93
- return result.changes;
94
- }
95
-
96
- /**
97
- * Rebuild the FTS index from the search_documents table.
98
- */
99
- rebuildFromDocuments() {
100
- this.db.exec("DELETE FROM search_fts");
101
- const docs = this.db.prepare("SELECT * FROM search_documents").all();
102
- const insert = this.db.prepare(
103
- "INSERT INTO search_fts (node_uuid, namespace, content) VALUES (?, ?, ?)",
104
- );
105
- for (const doc of docs) {
106
- insert.run(doc.node_uuid, doc.namespace, doc.content);
107
- }
108
- return docs.length;
109
- }
110
-
111
- /**
112
- * Suggest completions based on prefix matching.
113
- */
114
- suggest(prefix, { namespace = "", limit = 8 } = {}) {
115
- const sanitized = prefix.replace(/[*"]/g, "").trim();
116
- if (!sanitized || sanitized.length < 2) return [];
117
-
118
- let sql;
119
- let params;
120
- if (namespace) {
121
- sql = `
122
- SELECT DISTINCT content
123
- FROM search_fts
124
- WHERE search_fts MATCH ? AND namespace = ?
125
- ORDER BY rank
126
- LIMIT ?
127
- `;
128
- params = [`"${sanitized}"*`, namespace, limit];
129
- } else {
130
- sql = `
131
- SELECT DISTINCT content
132
- FROM search_fts
133
- WHERE search_fts MATCH ?
134
- ORDER BY rank
135
- LIMIT ?
136
- `;
137
- params = [`"${sanitized}"*`, limit];
138
- }
139
-
140
- return this.db.prepare(sql).all(...params).map(r => r.content);
141
- }
142
- }
@@ -1,86 +0,0 @@
1
- export class ChangesetStore {
2
- constructor(db) {
3
- this.db = db;
4
- this.#ensureSchema();
5
- }
6
-
7
- #ensureSchema() {
8
- this.db.exec(`
9
- CREATE TABLE IF NOT EXISTS changesets (
10
- id INTEGER PRIMARY KEY AUTOINCREMENT,
11
- memory_id INTEGER NOT NULL REFERENCES memories(id),
12
- node_uuid TEXT NOT NULL REFERENCES nodes(uuid),
13
- before_content TEXT,
14
- after_content TEXT,
15
- created_at TEXT NOT NULL DEFAULT (datetime('now'))
16
- );
17
- CREATE INDEX IF NOT EXISTS idx_changesets_node ON changesets(node_uuid);
18
- CREATE INDEX IF NOT EXISTS idx_changesets_memory ON changesets(memory_id);
19
- `);
20
- }
21
-
22
- /**
23
- * Record a before/after snapshot for a memory update.
24
- * @param {number} memoryId - the NEW memory id
25
- * @param {string} nodeUuid
26
- * @param {string|null} beforeContent - previous content (null if creation)
27
- * @param {string} afterContent - new content
28
- */
29
- record({ memoryId, nodeUuid, beforeContent, afterContent }) {
30
- const result = this.db.prepare(
31
- "INSERT INTO changesets (memory_id, node_uuid, before_content, after_content) VALUES (?, ?, ?, ?)",
32
- ).run(memoryId, nodeUuid, beforeContent ?? null, afterContent);
33
- return { id: Number(result.lastInsertRowid), memory_id: memoryId, node_uuid: nodeUuid };
34
- }
35
-
36
- /**
37
- * Get all changesets for a node, most recent first.
38
- */
39
- getHistory(nodeUuid, limit = 50) {
40
- return this.db.prepare(
41
- "SELECT * FROM changesets WHERE node_uuid = ? ORDER BY id DESC LIMIT ?",
42
- ).all(nodeUuid, limit);
43
- }
44
-
45
- /**
46
- * Get the most recent changesets across all nodes.
47
- */
48
- getRecent(limit = 30) {
49
- return this.db.prepare(
50
- "SELECT * FROM changesets ORDER BY id DESC LIMIT ?",
51
- ).all(limit);
52
- }
53
-
54
- /**
55
- * Get a specific changeset by id.
56
- */
57
- getById(id) {
58
- return this.db.prepare("SELECT * FROM changesets WHERE id = ?").get(id);
59
- }
60
-
61
- /**
62
- * Get the diff summary for a changeset — useful for display.
63
- */
64
- diff(changeset) {
65
- const before = changeset.before_content ?? "";
66
- const after = changeset.after_content ?? "";
67
- if (!before) return { type: "create", linesAdded: after.split("\n").length };
68
- if (!after) return { type: "delete", linesRemoved: before.split("\n").length };
69
-
70
- const beforeLines = before.split("\n");
71
- const afterLines = after.split("\n");
72
- const added = afterLines.filter((l) => !before.includes(l)).length;
73
- const removed = beforeLines.filter((l) => !after.includes(l)).length;
74
- return { type: "update", linesAdded: Math.max(0, afterLines.length - beforeLines.length), linesRemoved: Math.max(0, beforeLines.length - afterLines.length), changedLines: added + removed };
75
- }
76
-
77
- /**
78
- * Delete changesets older than the given number of days.
79
- */
80
- pruneOlderThan(days) {
81
- const result = this.db.prepare(
82
- "DELETE FROM changesets WHERE created_at < datetime('now', ?)",
83
- ).run(`-${days} days`);
84
- return result.changes;
85
- }
86
- }
@@ -1,120 +0,0 @@
1
- import { ROOT_NODE_UUID } from "./database.mjs";
2
-
3
- export class SystemViews {
4
- constructor(db, graph, glossaryService, namespace = "") {
5
- this.db = db;
6
- this.graph = graph;
7
- this.glossarySvc = glossaryService;
8
- this.namespace = namespace;
9
- }
10
-
11
- /**
12
- * system://boot — children of the root node (project boot entries).
13
- */
14
- boot() {
15
- const children = this.graph.getChildren(ROOT_NODE_UUID, null, null, this.namespace);
16
- return children.map(c => ({
17
- name: c.name,
18
- node_uuid: c.node_uuid,
19
- priority: c.priority,
20
- disclosure: c.disclosure,
21
- content: c.content_snippet ?? null,
22
- }));
23
- }
24
-
25
- /**
26
- * system://index — all paths with their node UUIDs, grouped by domain.
27
- */
28
- index() {
29
- const rows = this.db.prepare(
30
- "SELECT domain, path, node_uuid, namespace FROM paths WHERE namespace = ? OR namespace = 'global' ORDER BY domain, path",
31
- ).all(this.namespace);
32
- const domains = {};
33
- for (const row of rows) {
34
- const d = row.domain || "core";
35
- if (!domains[d]) domains[d] = [];
36
- domains[d].push({ path: row.path, node_uuid: row.node_uuid, namespace: row.namespace });
37
- }
38
- return domains;
39
- }
40
-
41
- /**
42
- * system://recent — most recently updated memories.
43
- */
44
- recent(limit = 20) {
45
- return this.graph.getRecentMemories(limit, this.namespace);
46
- }
47
-
48
- /**
49
- * system://glossary — all glossary keywords with linked nodes.
50
- */
51
- glossaryList() {
52
- return this.glossarySvc.getAllKeywords();
53
- }
54
-
55
- /**
56
- * system://diagnostic — health and stats overview.
57
- */
58
- diagnostic() {
59
- const ns = this.namespace;
60
- const nodeCount = this.db.prepare("SELECT COUNT(*) AS cnt FROM nodes").get().cnt;
61
- const memoryCount = this.db.prepare("SELECT COUNT(DISTINCT m.id) AS cnt FROM memories m JOIN paths p ON p.node_uuid = m.node_uuid WHERE m.deprecated = 0 AND (p.namespace = ? OR p.namespace = 'global')").get(ns).cnt;
62
- const deprecatedCount = this.db.prepare("SELECT COUNT(*) AS cnt FROM memories WHERE deprecated = 1").get().cnt;
63
- const edgeCount = this.db.prepare("SELECT COUNT(DISTINCT e.id) AS cnt FROM edges e JOIN paths p ON p.edge_id = e.id WHERE p.namespace = ? OR p.namespace = 'global'").get(ns).cnt;
64
- const pathCount = this.db.prepare("SELECT COUNT(*) AS cnt FROM paths WHERE namespace = ? OR namespace = 'global'").get(ns).cnt;
65
- const keywordCount = this.db.prepare("SELECT COUNT(*) AS cnt FROM glossary_keywords WHERE namespace = ? OR namespace = 'global'").get(ns).cnt;
66
- const ftsCount = this.#ftsCount();
67
- const changesetCount = this.#changesetCount();
68
-
69
- // Stale nodes: no access in 30 days
70
- const cutoff = new Date(Date.now() - 30 * 86400000).toISOString();
71
- const staleNodes = this.db.prepare(
72
- "SELECT COUNT(*) AS cnt FROM nodes WHERE last_accessed_at IS NOT NULL AND last_accessed_at < ?",
73
- ).get(cutoff).cnt;
74
-
75
- // Orphan nodes: nodes with no paths pointing to them
76
- const orphanNodes = this.db.prepare(`
77
- SELECT COUNT(*) AS cnt FROM nodes n
78
- WHERE n.uuid != ?
79
- AND NOT EXISTS (SELECT 1 FROM paths WHERE node_uuid = n.uuid)
80
- AND NOT EXISTS (SELECT 1 FROM edges WHERE child_uuid = n.uuid)
81
- `).get(ROOT_NODE_UUID).cnt;
82
-
83
- // Version chain depth stats
84
- const versionStats = this.db.prepare(`
85
- SELECT MAX(vc) AS max_depth, AVG(vc) AS avg_depth
86
- FROM (SELECT COUNT(*) AS vc FROM memories GROUP BY node_uuid)
87
- `).get();
88
-
89
- return {
90
- counts: {
91
- nodes: nodeCount,
92
- memories: memoryCount,
93
- deprecated_memories: deprecatedCount,
94
- edges: edgeCount,
95
- paths: pathCount,
96
- keywords: keywordCount,
97
- fts_documents: ftsCount,
98
- changesets: changesetCount,
99
- },
100
- health: {
101
- stale_nodes: staleNodes,
102
- orphan_nodes: orphanNodes,
103
- max_version_depth: versionStats.max_depth ?? 0,
104
- avg_version_depth: Math.round((versionStats.avg_depth ?? 0) * 100) / 100,
105
- },
106
- };
107
- }
108
-
109
- #ftsCount() {
110
- try {
111
- return this.db.prepare("SELECT COUNT(*) AS cnt FROM search_fts").get().cnt;
112
- } catch { return 0; }
113
- }
114
-
115
- #changesetCount() {
116
- try {
117
- return this.db.prepare("SELECT COUNT(*) AS cnt FROM changesets").get().cnt;
118
- } catch { return 0; }
119
- }
120
- }