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,124 +0,0 @@
1
- export class GlossaryService {
2
- constructor(db, namespace = "") {
3
- this.db = db;
4
- this.namespace = namespace;
5
- this.fingerprint = null;
6
- this.automaton = null;
7
- }
8
-
9
- // ── Aho-Corasick automaton ────────────────────────────────────────
10
-
11
- #ensureAutomaton() {
12
- const fp = this.#computeFingerprint();
13
- if (fp === this.fingerprint && this.automaton) return;
14
- this.fingerprint = fp;
15
- this.automaton = this.#buildAutomaton();
16
- }
17
-
18
- #computeFingerprint() {
19
- const row = this.db.prepare(
20
- "SELECT COUNT(*) AS cnt, MAX(id) AS max_id FROM glossary_keywords WHERE namespace = ? OR namespace = 'global'"
21
- ).get(this.namespace);
22
- return `${row.cnt}:${row.max_id}`;
23
- }
24
-
25
- #buildAutomaton() {
26
- const keywords = this.db.prepare(
27
- "SELECT id, keyword, node_uuid FROM glossary_keywords WHERE namespace = ? OR namespace = 'global'"
28
- ).all(this.namespace);
29
-
30
- // Build trie
31
- const go = [new Map()];
32
- const fail = [0];
33
- const output = [new Map()];
34
-
35
- for (const kw of keywords) {
36
- let state = 0;
37
- for (const ch of kw.keyword) {
38
- let next = go[state].get(ch);
39
- if (next === undefined) {
40
- next = go.length;
41
- go.push(new Map());
42
- fail.push(0);
43
- output.push(new Map());
44
- go[state].set(ch, next);
45
- }
46
- state = next;
47
- }
48
- output[state].set(kw.id, kw.node_uuid);
49
- }
50
-
51
- // Build failure links (BFS)
52
- const queue = [];
53
- for (const [ch, next] of go[0]) {
54
- fail[next] = 0;
55
- queue.push(next);
56
- }
57
-
58
- while (queue.length > 0) {
59
- const r = queue.shift();
60
- for (const [ch, s] of go[r]) {
61
- queue.push(s);
62
- let f = fail[r];
63
- while (f > 0 && !go[f].has(ch)) f = fail[f];
64
- fail[s] = go[f].has(ch) ? go[f].get(ch) : 0;
65
- for (const [kwId, nodeUuid] of output[fail[s]]) {
66
- output[s].set(kwId, nodeUuid);
67
- }
68
- }
69
- }
70
-
71
- return { go, fail, output };
72
- }
73
-
74
- // ── Public API ─────────────────────────────────────────────────────
75
-
76
- addKeyword(keyword, nodeUuid, namespace = "") {
77
- this.db.prepare(
78
- "INSERT OR IGNORE INTO glossary_keywords (keyword, node_uuid, namespace) VALUES (?, ?, ?)"
79
- ).run(keyword, nodeUuid, namespace);
80
- this.fingerprint = null;
81
- }
82
-
83
- removeKeyword(keywordId) {
84
- this.db.prepare("DELETE FROM glossary_keywords WHERE id = ?").run(keywordId);
85
- this.fingerprint = null;
86
- }
87
-
88
- findInContent(content) {
89
- if (!content) return [];
90
- this.#ensureAutomaton();
91
- if (!this.automaton) return [];
92
-
93
- const { go, fail, output } = this.automaton;
94
- const matches = [];
95
- const seen = new Set();
96
- let state = 0;
97
-
98
- for (let i = 0; i < content.length; i++) {
99
- const ch = content[i];
100
- while (state > 0 && !go[state].has(ch)) state = fail[state];
101
- state = go[state].has(ch) ? go[state].get(ch) : 0;
102
-
103
- for (const [kwId, nodeUuid] of output[state]) {
104
- if (seen.has(kwId)) continue;
105
- seen.add(kwId);
106
- matches.push({ keyword_id: kwId, node_uuid: nodeUuid });
107
- }
108
- }
109
-
110
- return matches;
111
- }
112
-
113
- getAllKeywords() {
114
- return this.db.prepare(
115
- "SELECT * FROM glossary_keywords WHERE namespace = ? OR namespace = 'global' ORDER BY keyword"
116
- ).all(this.namespace);
117
- }
118
-
119
- getKeywordsForNode(nodeUuid) {
120
- return this.db.prepare(
121
- "SELECT * FROM glossary_keywords WHERE node_uuid = ? AND (namespace = ? OR namespace = 'global')"
122
- ).all(nodeUuid, this.namespace);
123
- }
124
- }
@@ -1,109 +0,0 @@
1
- import { ROOT_NODE_UUID } from "../database.mjs";
2
- import { escapeLikePath } from "./graph-path-utils.mjs";
3
- import {
4
- countPathsForEdge,
5
- insertPath,
6
- } from "./graph-primitives.mjs";
7
-
8
- export function deprecateNodeMemories(db, nodeUuid, successorId = null) {
9
- const conditions = ["node_uuid = ?", "deprecated = 0"];
10
- const params = [nodeUuid];
11
- if (successorId !== null) {
12
- conditions.push("id != ?");
13
- params.push(successorId);
14
- }
15
- const ids = db.prepare(
16
- `SELECT id FROM memories WHERE ${conditions.join(" AND ")}`
17
- ).all(...params).map(r => r.id);
18
-
19
- if (ids.length > 0) {
20
- const placeholders = ids.map(() => "?").join(",");
21
- db.prepare(
22
- `UPDATE memories SET deprecated = 1, migrated_to = ? WHERE id IN (${placeholders})`
23
- ).run(successorId, ...ids);
24
- }
25
- return ids;
26
- }
27
-
28
- export function cascadeCreatePaths(db, nodeUuid, domain, basePath, namespace = "", visited = new Set()) {
29
- if (visited.has(nodeUuid)) return;
30
- visited.add(nodeUuid);
31
- try {
32
- const childEdges = db.prepare(
33
- "SELECT * FROM edges WHERE parent_uuid = ?"
34
- ).all(nodeUuid);
35
- for (const edge of childEdges) {
36
- const childPath = `${basePath}/${edge.name}`;
37
- insertPath(db, namespace, domain, childPath, edge.id, edge.child_uuid);
38
- cascadeCreatePaths(db, edge.child_uuid, domain, childPath, namespace, visited);
39
- }
40
- } finally {
41
- visited.delete(nodeUuid);
42
- }
43
- }
44
-
45
- export function deleteSubtreePaths(db, domain, path, namespace = "") {
46
- const safe = escapeLikePath(path);
47
- const rows = db.prepare(`
48
- SELECT namespace, domain, path, edge_id, node_uuid
49
- FROM paths
50
- WHERE namespace = ? AND domain = ? AND (path = ? OR path LIKE ? ESCAPE '\\')
51
- `).all(namespace, domain, path, `${safe}/%`);
52
-
53
- for (const row of rows) {
54
- db.prepare(
55
- "DELETE FROM paths WHERE namespace = ? AND domain = ? AND path = ?"
56
- ).run(row.namespace, row.domain, row.path);
57
- }
58
- return rows;
59
- }
60
-
61
- export function cascadeDeleteEdge(db, edge) {
62
- const edgePaths = db.prepare(
63
- "SELECT * FROM paths WHERE edge_id = ?"
64
- ).all(edge.id);
65
-
66
- for (const path of edgePaths) {
67
- deleteSubtreePaths(db, path.domain, path.path, path.namespace);
68
- }
69
- db.prepare("DELETE FROM edges WHERE id = ?").run(edge.id);
70
- }
71
-
72
- export function cascadeDeleteNode(db, nodeUuid) {
73
- if (nodeUuid === ROOT_NODE_UUID) return null;
74
-
75
- const edges = db.prepare(
76
- "SELECT * FROM edges WHERE parent_uuid = ? OR child_uuid = ?"
77
- ).all(nodeUuid, nodeUuid);
78
- for (const edge of edges) {
79
- cascadeDeleteEdge(db, edge);
80
- }
81
-
82
- db.prepare("DELETE FROM memories WHERE node_uuid = ?").run(nodeUuid);
83
- db.prepare("DELETE FROM glossary_keywords WHERE node_uuid = ?").run(nodeUuid);
84
- db.prepare("DELETE FROM nodes WHERE uuid = ?").run(nodeUuid);
85
- return { deleted: nodeUuid };
86
- }
87
-
88
- export function gcEdgeIfPathless(db, edge) {
89
- if (countPathsForEdge(db, edge.id) > 0) return null;
90
- db.prepare("DELETE FROM edges WHERE id = ?").run(edge.id);
91
- return { edge_id: edge.id, parent_uuid: edge.parent_uuid, child_uuid: edge.child_uuid };
92
- }
93
-
94
- export function gcNodeSoft(db, nodeUuid) {
95
- if (nodeUuid === ROOT_NODE_UUID) return;
96
-
97
- const row = db.prepare(
98
- "SELECT COUNT(*) AS cnt FROM paths WHERE node_uuid = ?"
99
- ).get(nodeUuid);
100
- if (row.cnt > 0) return;
101
-
102
- const incoming = db.prepare("SELECT * FROM edges WHERE child_uuid = ?").all(nodeUuid);
103
- for (const edge of incoming) gcEdgeIfPathless(db, edge);
104
-
105
- const outgoing = db.prepare("SELECT * FROM edges WHERE parent_uuid = ?").all(nodeUuid);
106
- for (const edge of outgoing) cascadeDeleteEdge(db, edge);
107
-
108
- deprecateNodeMemories(db, nodeUuid);
109
- }
@@ -1,73 +0,0 @@
1
- import { ROOT_NODE_UUID } from "../database.mjs";
2
-
3
- export function getGraphDiagnostics(db, namespace = "", daysStale = 30, maxChildren = 10) {
4
- const cutoff = new Date(Date.now() - daysStale * 86400000).toISOString();
5
-
6
- const allRows = db.prepare(`
7
- SELECT p.domain, p.path, p.node_uuid, n.created_at, n.last_accessed_at,
8
- e.priority, m.id AS memory_id
9
- FROM paths p
10
- JOIN edges e ON p.edge_id = e.id
11
- JOIN nodes n ON n.uuid = e.child_uuid
12
- JOIN memories m ON m.node_uuid = n.uuid AND m.deprecated = 0
13
- WHERE p.namespace = ?
14
- `).all(namespace);
15
-
16
- const staleNodes = {};
17
- for (const row of allRows) {
18
- const effective = row.last_accessed_at ?? row.created_at ?? cutoff;
19
- if (effective >= cutoff) continue;
20
- const staleDays = Math.round((Date.now() - new Date(effective).getTime()) / 86400000);
21
- const key = row.node_uuid;
22
- if (!staleNodes[key] || (row.priority ?? 999) < (staleNodes[key].priority ?? 999)) {
23
- staleNodes[key] = {
24
- uuid: row.node_uuid,
25
- uri: `${row.domain}://${row.path}`,
26
- created_at: row.created_at,
27
- last_accessed_at: row.last_accessed_at,
28
- stale_days: staleDays,
29
- priority: row.priority,
30
- title: row.path.split("/").pop(),
31
- memory_id: row.memory_id,
32
- };
33
- }
34
- }
35
-
36
- const crowdedRows = db.prepare(`
37
- SELECT e.parent_uuid, COUNT(DISTINCT e.child_uuid) AS child_count
38
- FROM edges e
39
- JOIN paths p ON p.edge_id = e.id
40
- WHERE p.namespace = ?
41
- GROUP BY e.parent_uuid
42
- HAVING child_count > ?
43
- `).all(namespace, maxChildren);
44
-
45
- const crowdedParents = {};
46
- for (const row of crowdedRows) {
47
- if (row.parent_uuid === ROOT_NODE_UUID) {
48
- crowdedParents[row.parent_uuid] = {
49
- uuid: row.parent_uuid,
50
- uri: "core://",
51
- title: "(root)",
52
- child_count: row.child_count,
53
- };
54
- } else {
55
- const p = db.prepare(
56
- "SELECT domain, path FROM paths WHERE node_uuid = ? AND namespace = ? LIMIT 1"
57
- ).get(row.parent_uuid, namespace);
58
- if (p) {
59
- crowdedParents[row.parent_uuid] = {
60
- uuid: row.parent_uuid,
61
- uri: `${p.domain}://${p.path}`,
62
- title: p.path.split("/").pop(),
63
- child_count: row.child_count,
64
- };
65
- }
66
- }
67
- }
68
-
69
- return {
70
- stale_nodes: Object.values(staleNodes).sort((a, b) => (a.last_accessed_at ?? a.created_at ?? "").localeCompare(b.last_accessed_at ?? b.created_at ?? "")),
71
- crowded_nodes: Object.values(crowdedParents).sort((a, b) => b.child_count - a.child_count),
72
- };
73
- }
@@ -1,50 +0,0 @@
1
- import { deleteSubtreePaths, gcEdgeIfPathless, gcNodeSoft } from "./graph-cascades.mjs";
2
- import { escapeLikePath, graphUri } from "./graph-path-utils.mjs";
3
- import { resolveGraphPath } from "./graph-primitives.mjs";
4
-
5
- export function removeGraphPath(db, path, domain = "core", namespace = "") {
6
- if (path === "") throw new Error("Cannot remove root path.");
7
-
8
- const target = resolveGraphPath(db, path, domain, namespace);
9
- if (!target) throw new Error(`Path '${graphUri(domain, path)}' not found`);
10
-
11
- const targetNodeUuid = target.node_uuid;
12
- const targetEdge = target.edge;
13
- if (!targetEdge) throw new Error(`Path '${domain}://${path}' has no edge.`);
14
-
15
- const wouldOrphan = findWouldOrphanChildren(db, { path, domain, namespace, targetNodeUuid });
16
- if (wouldOrphan.length > 0) {
17
- const details = wouldOrphan.map(e => `'${e.name}' (${e.child_uuid.slice(0, 8)}...)`).join(", ");
18
- throw new Error(`Cannot remove '${graphUri(domain, path)}': children would become unreachable: ${details}`);
19
- }
20
-
21
- deleteSubtreePaths(db, domain, path, namespace);
22
- gcEdgeIfPathless(db, targetEdge);
23
- gcNodeSoft(db, targetNodeUuid);
24
- return { deleted: graphUri(domain, path) };
25
- }
26
-
27
- function findWouldOrphanChildren(db, { path, domain, namespace, targetNodeUuid }) {
28
- const childEdges = db.prepare("SELECT * FROM edges WHERE parent_uuid = ?").all(targetNodeUuid);
29
- const wouldOrphan = [];
30
- const safe = escapeLikePath(path);
31
-
32
- for (const childEdge of childEdges) {
33
- const surviving = db.prepare(`
34
- SELECT COUNT(*) AS cnt FROM paths
35
- WHERE node_uuid = ?
36
- AND NOT (domain = ? AND (path = ? OR path LIKE ? ESCAPE '\\'))
37
- `).get(childEdge.child_uuid, domain, path, `${safe}/%`);
38
- if (surviving.cnt > 0) continue;
39
-
40
- const targetSurviving = db.prepare(`
41
- SELECT * FROM paths
42
- WHERE node_uuid = ? AND namespace = ?
43
- AND NOT (domain = ? AND (path = ? OR path LIKE ? ESCAPE '\\'))
44
- ORDER BY CASE WHEN domain = ? THEN 0 ELSE 1 END, path
45
- LIMIT 1
46
- `).get(targetNodeUuid, namespace, domain, path, `${safe}/%`, domain);
47
- if (!targetSurviving) wouldOrphan.push(childEdge);
48
- }
49
- return wouldOrphan;
50
- }
@@ -1,17 +0,0 @@
1
- export function escapeLikePath(path) {
2
- return String(path).replace(/[%_]/g, "\\$&");
3
- }
4
-
5
- export function graphUri(domain, path) {
6
- return `${domain}://${path}`;
7
- }
8
-
9
- export function leafName(path) {
10
- return String(path).split("/").pop();
11
- }
12
-
13
- export function pathExists(db, namespace, domain, path) {
14
- return Boolean(db.prepare(
15
- "SELECT 1 FROM paths WHERE namespace = ? AND domain = ? AND path = ?"
16
- ).get(namespace, domain, path));
17
- }
@@ -1,103 +0,0 @@
1
- import { ROOT_NODE_UUID } from "../database.mjs";
2
-
3
- export function ensureNode(db, nodeUuid) {
4
- const existing = db.prepare("SELECT uuid FROM nodes WHERE uuid = ?").get(nodeUuid);
5
- if (!existing) {
6
- db.prepare("INSERT INTO nodes (uuid) VALUES (?)").run(nodeUuid);
7
- }
8
- return nodeUuid;
9
- }
10
-
11
- export function insertMemory(db, nodeUuid, content, deprecated = false) {
12
- const result = db.prepare(
13
- "INSERT INTO memories (node_uuid, content, deprecated) VALUES (?, ?, ?)"
14
- ).run(nodeUuid, content, deprecated ? 1 : 0);
15
- return { id: Number(result.lastInsertRowid), node_uuid: nodeUuid, content, deprecated: deprecated ? 1 : 0 };
16
- }
17
-
18
- export function getOrCreateEdge(db, parentUuid, childUuid, name, priority = 0, disclosure = null) {
19
- const existing = db.prepare(
20
- "SELECT id, parent_uuid, child_uuid, name, priority, disclosure FROM edges WHERE parent_uuid = ? AND child_uuid = ?"
21
- ).get(parentUuid, childUuid);
22
-
23
- if (existing) return { edge: existing, created: false };
24
-
25
- const result = db.prepare(
26
- "INSERT INTO edges (parent_uuid, child_uuid, name, priority, disclosure) VALUES (?, ?, ?, ?, ?)"
27
- ).run(parentUuid, childUuid, name, priority, disclosure);
28
- const edge = {
29
- id: Number(result.lastInsertRowid), parent_uuid: parentUuid, child_uuid: childUuid,
30
- name, priority, disclosure,
31
- };
32
- return { edge, created: true };
33
- }
34
-
35
- export function insertPath(db, namespace, domain, path, edgeId, nodeUuid) {
36
- db.prepare(
37
- "INSERT OR IGNORE INTO paths (namespace, domain, path, edge_id, node_uuid) VALUES (?, ?, ?, ?, ?)"
38
- ).run(namespace, domain, path, edgeId, nodeUuid);
39
- }
40
-
41
- export function resolveGraphPath(db, path, domain = "core", namespace = "") {
42
- if (path === "") {
43
- return { node_uuid: ROOT_NODE_UUID, edge: null, path_obj: null };
44
- }
45
- const row = db.prepare(`
46
- SELECT p.namespace, p.domain, p.path, p.edge_id, p.node_uuid,
47
- e.parent_uuid, e.child_uuid, e.name, e.priority, e.disclosure
48
- FROM paths p
49
- JOIN edges e ON p.edge_id = e.id
50
- WHERE p.namespace = ? AND p.domain = ? AND p.path = ?
51
- `).get(namespace, domain, path);
52
-
53
- if (!row) return null;
54
- return {
55
- path_obj: { namespace: row.namespace, domain: row.domain, path: row.path, edge_id: row.edge_id, node_uuid: row.node_uuid },
56
- edge: { id: row.edge_id, parent_uuid: row.parent_uuid, child_uuid: row.child_uuid, name: row.name, priority: row.priority, disclosure: row.disclosure },
57
- node_uuid: row.node_uuid,
58
- };
59
- }
60
-
61
- export function countPathsForEdge(db, edgeId) {
62
- const row = db.prepare("SELECT COUNT(*) AS cnt FROM paths WHERE edge_id = ?").get(edgeId);
63
- return row.cnt;
64
- }
65
-
66
- export function countMemoriesForNode(db, nodeUuid) {
67
- const row = db.prepare("SELECT COUNT(*) AS cnt FROM memories WHERE node_uuid = ?").get(nodeUuid);
68
- return row.cnt;
69
- }
70
-
71
- export function getNextChildNumber(db, parentUuid, namespace) {
72
- const rows = db.prepare(`
73
- SELECT e.name FROM edges e
74
- JOIN paths p ON p.edge_id = e.id
75
- WHERE e.parent_uuid = ? AND p.namespace = ?
76
- `).all(parentUuid, namespace);
77
- let maxNum = 0;
78
- for (const row of rows) {
79
- const num = parseInt(row.name, 10);
80
- if (!Number.isNaN(num) && num > maxNum) maxNum = num;
81
- }
82
- return maxNum + 1;
83
- }
84
-
85
- export function wouldCreateCycle(db, parentUuid, childUuid) {
86
- if (parentUuid === ROOT_NODE_UUID) return false;
87
- if (parentUuid === childUuid) return true;
88
-
89
- const visited = new Set([childUuid]);
90
- const queue = [childUuid];
91
- while (queue.length > 0) {
92
- const current = queue.shift();
93
- const rows = db.prepare("SELECT child_uuid FROM edges WHERE parent_uuid = ?").all(current);
94
- for (const row of rows) {
95
- if (row.child_uuid === parentUuid) return true;
96
- if (!visited.has(row.child_uuid)) {
97
- visited.add(row.child_uuid);
98
- queue.push(row.child_uuid);
99
- }
100
- }
101
- }
102
- return false;
103
- }
@@ -1,159 +0,0 @@
1
- import { ROOT_NODE_UUID } from "../database.mjs";
2
-
3
- export function getMemoryByPath(db, path, domain = "core", namespace = "") {
4
- if (path === "") {
5
- return {
6
- id: 0, node_uuid: ROOT_NODE_UUID,
7
- content: `Root node for domain '${domain}'.`,
8
- priority: 0, disclosure: null, deprecated: false,
9
- created_at: null, domain, path: "", alias_count: 0,
10
- };
11
- }
12
-
13
- const row = db.prepare(`
14
- SELECT m.id, m.node_uuid, m.content, m.deprecated, m.created_at,
15
- e.priority, e.disclosure, p.domain, p.path
16
- FROM paths p
17
- JOIN edges e ON p.edge_id = e.id
18
- JOIN memories m ON m.node_uuid = e.child_uuid AND m.deprecated = 0
19
- WHERE p.namespace = ? AND p.domain = ? AND p.path = ?
20
- ORDER BY m.created_at DESC
21
- LIMIT 1
22
- `).get(namespace, domain, path);
23
-
24
- if (!row) return null;
25
-
26
- const totalPaths = countIncomingPaths(db, row.node_uuid, namespace);
27
- const aliasCount = Math.max(0, totalPaths - 1);
28
-
29
- return {
30
- id: row.id, node_uuid: row.node_uuid, content: row.content,
31
- priority: row.priority, disclosure: row.disclosure,
32
- deprecated: !!row.deprecated, created_at: row.created_at,
33
- domain: row.domain, path: row.path, alias_count: aliasCount,
34
- };
35
- }
36
-
37
- export function getChildren(db, nodeUuid = ROOT_NODE_UUID, contextDomain = null, contextPath = null, namespace = "") {
38
- const rows = db.prepare(`
39
- SELECT DISTINCT e.id AS edge_id, e.child_uuid, e.name, e.priority, e.disclosure,
40
- m.content, m.id AS memory_id
41
- FROM edges e
42
- JOIN paths p ON p.edge_id = e.id
43
- JOIN memories m ON m.node_uuid = e.child_uuid AND m.deprecated = 0
44
- WHERE e.parent_uuid = ? AND p.namespace = ?
45
- ORDER BY e.priority ASC, e.name
46
- `).all(nodeUuid, namespace);
47
-
48
- const childUuids = [...new Set(rows.map(r => r.child_uuid))];
49
- const edgeIds = [...new Set(rows.map(r => r.edge_id))];
50
-
51
- const approxChildrenMap = {};
52
- if (childUuids.length > 0) {
53
- const placeholders = childUuids.map(() => "?").join(",");
54
- const counts = db.prepare(`
55
- SELECT e.parent_uuid, COUNT(DISTINCT e.id)
56
- FROM edges e
57
- JOIN paths p ON p.edge_id = e.id
58
- WHERE e.parent_uuid IN (${placeholders}) AND p.namespace = ?
59
- GROUP BY e.parent_uuid
60
- `).all(...childUuids, namespace);
61
- for (const c of counts) {
62
- approxChildrenMap[c[0]] = c[1];
63
- }
64
- }
65
-
66
- const pathsByEdgeId = {};
67
- if (edgeIds.length > 0) {
68
- const placeholders = edgeIds.map(() => "?").join(",");
69
- const pathRows = db.prepare(`
70
- SELECT * FROM paths WHERE namespace = ? AND edge_id IN (${placeholders})
71
- `).all(namespace, ...edgeIds);
72
- for (const p of pathRows) {
73
- if (!pathsByEdgeId[p.edge_id]) pathsByEdgeId[p.edge_id] = [];
74
- pathsByEdgeId[p.edge_id].push(p);
75
- }
76
- }
77
-
78
- const prefix = contextPath ? `${contextPath}/` : null;
79
- const seen = new Set();
80
- const children = [];
81
-
82
- for (const row of rows) {
83
- if (seen.has(row.child_uuid)) continue;
84
- seen.add(row.child_uuid);
85
-
86
- const allPaths = pathsByEdgeId[row.edge_id] ?? [];
87
- if (nodeUuid === ROOT_NODE_UUID && contextDomain) {
88
- if (!allPaths.some(p => p.domain === contextDomain)) continue;
89
- }
90
-
91
- const pathObj = pickBestPath(allPaths, contextDomain, prefix);
92
- if (!pathObj) continue;
93
-
94
- children.push({
95
- node_uuid: row.child_uuid,
96
- edge_id: row.edge_id,
97
- name: row.name,
98
- domain: pathObj.domain,
99
- path: pathObj.path,
100
- content_snippet: (row.content ?? "").slice(0, 100) + ((row.content ?? "").length > 100 ? "..." : ""),
101
- priority: row.priority,
102
- disclosure: row.disclosure,
103
- approx_children_count: approxChildrenMap[row.child_uuid] ?? 0,
104
- });
105
- }
106
-
107
- return children;
108
- }
109
-
110
- export function getRecentMemories(db, limit = 10, namespace = "") {
111
- const rows = db.prepare(`
112
- SELECT m.id AS memory_id, m.created_at, e.priority, e.disclosure, p.domain, p.path
113
- FROM paths p
114
- JOIN edges e ON p.edge_id = e.id
115
- JOIN memories m ON m.node_uuid = e.child_uuid AND m.deprecated = 0
116
- WHERE p.namespace = ?
117
- ORDER BY m.created_at DESC
118
- `).all(namespace);
119
-
120
- const seen = new Set();
121
- const memories = [];
122
- for (const row of rows) {
123
- if (seen.has(row.memory_id)) continue;
124
- seen.add(row.memory_id);
125
- memories.push({
126
- memory_id: row.memory_id,
127
- uri: `${row.domain}://${row.path}`,
128
- priority: row.priority,
129
- disclosure: row.disclosure,
130
- created_at: row.created_at,
131
- });
132
- if (memories.length >= limit) break;
133
- }
134
- return memories;
135
- }
136
-
137
- function countIncomingPaths(db, nodeUuid, namespace = "") {
138
- const row = db.prepare(
139
- "SELECT COUNT(*) AS cnt FROM paths WHERE node_uuid = ? AND namespace = ?"
140
- ).get(nodeUuid, namespace);
141
- return row.cnt;
142
- }
143
-
144
- function pickBestPath(paths, contextDomain, prefix) {
145
- if (paths.length === 0) return null;
146
- if (paths.length === 1) return paths[0];
147
-
148
- if (contextDomain && prefix) {
149
- for (const p of paths) {
150
- if (p.domain === contextDomain && p.path.startsWith(prefix)) return p;
151
- }
152
- }
153
- if (contextDomain) {
154
- for (const p of paths) {
155
- if (p.domain === contextDomain) return p;
156
- }
157
- }
158
- return paths[0];
159
- }