@gopherine/obsidian-mcp 0.1.1

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 (223) hide show
  1. package/CHANGELOG.md +60 -0
  2. package/LICENSE +661 -0
  3. package/README.md +235 -0
  4. package/dist/cli.d.ts +2 -0
  5. package/dist/cli.js +805 -0
  6. package/dist/cli.js.map +1 -0
  7. package/dist/commands/brainstorm.d.ts +9 -0
  8. package/dist/commands/brainstorm.js +37 -0
  9. package/dist/commands/brainstorm.js.map +1 -0
  10. package/dist/commands/brainstorm.test.d.ts +1 -0
  11. package/dist/commands/brainstorm.test.js +110 -0
  12. package/dist/commands/brainstorm.test.js.map +1 -0
  13. package/dist/commands/context.d.ts +18 -0
  14. package/dist/commands/context.js +88 -0
  15. package/dist/commands/context.js.map +1 -0
  16. package/dist/commands/context.test.d.ts +1 -0
  17. package/dist/commands/context.test.js +230 -0
  18. package/dist/commands/context.test.js.map +1 -0
  19. package/dist/commands/decide.d.ts +12 -0
  20. package/dist/commands/decide.js +40 -0
  21. package/dist/commands/decide.js.map +1 -0
  22. package/dist/commands/decide.test.d.ts +1 -0
  23. package/dist/commands/decide.test.js +109 -0
  24. package/dist/commands/decide.test.js.map +1 -0
  25. package/dist/commands/graph.d.ts +15 -0
  26. package/dist/commands/graph.js +89 -0
  27. package/dist/commands/graph.js.map +1 -0
  28. package/dist/commands/graph.test.d.ts +1 -0
  29. package/dist/commands/graph.test.js +215 -0
  30. package/dist/commands/graph.test.js.map +1 -0
  31. package/dist/commands/init.d.ts +11 -0
  32. package/dist/commands/init.js +256 -0
  33. package/dist/commands/init.js.map +1 -0
  34. package/dist/commands/learn.d.ts +25 -0
  35. package/dist/commands/learn.js +92 -0
  36. package/dist/commands/learn.js.map +1 -0
  37. package/dist/commands/learn.test.d.ts +1 -0
  38. package/dist/commands/learn.test.js +241 -0
  39. package/dist/commands/learn.test.js.map +1 -0
  40. package/dist/commands/prune.d.ts +58 -0
  41. package/dist/commands/prune.js +246 -0
  42. package/dist/commands/prune.js.map +1 -0
  43. package/dist/commands/read.d.ts +8 -0
  44. package/dist/commands/read.js +7 -0
  45. package/dist/commands/read.js.map +1 -0
  46. package/dist/commands/read.test.d.ts +1 -0
  47. package/dist/commands/read.test.js +48 -0
  48. package/dist/commands/read.test.js.map +1 -0
  49. package/dist/commands/resume.d.ts +20 -0
  50. package/dist/commands/resume.js +138 -0
  51. package/dist/commands/resume.js.map +1 -0
  52. package/dist/commands/resume.test.d.ts +1 -0
  53. package/dist/commands/resume.test.js +243 -0
  54. package/dist/commands/resume.test.js.map +1 -0
  55. package/dist/commands/search.d.ts +8 -0
  56. package/dist/commands/search.js +25 -0
  57. package/dist/commands/search.js.map +1 -0
  58. package/dist/commands/search.test.d.ts +1 -0
  59. package/dist/commands/search.test.js +61 -0
  60. package/dist/commands/search.test.js.map +1 -0
  61. package/dist/commands/session.d.ts +22 -0
  62. package/dist/commands/session.js +79 -0
  63. package/dist/commands/session.js.map +1 -0
  64. package/dist/commands/session.test.d.ts +1 -0
  65. package/dist/commands/session.test.js +185 -0
  66. package/dist/commands/session.test.js.map +1 -0
  67. package/dist/commands/skill/index.d.ts +30 -0
  68. package/dist/commands/skill/index.js +61 -0
  69. package/dist/commands/skill/index.js.map +1 -0
  70. package/dist/commands/skill/index.test.d.ts +1 -0
  71. package/dist/commands/skill/index.test.js +137 -0
  72. package/dist/commands/skill/index.test.js.map +1 -0
  73. package/dist/commands/skill/install.d.ts +14 -0
  74. package/dist/commands/skill/install.js +107 -0
  75. package/dist/commands/skill/install.js.map +1 -0
  76. package/dist/commands/skill/install.test.d.ts +1 -0
  77. package/dist/commands/skill/install.test.js +225 -0
  78. package/dist/commands/skill/install.test.js.map +1 -0
  79. package/dist/commands/skill/list.d.ts +6 -0
  80. package/dist/commands/skill/list.js +5 -0
  81. package/dist/commands/skill/list.js.map +1 -0
  82. package/dist/commands/skill/list.test.d.ts +1 -0
  83. package/dist/commands/skill/list.test.js +101 -0
  84. package/dist/commands/skill/list.test.js.map +1 -0
  85. package/dist/commands/skill/schema.d.ts +27 -0
  86. package/dist/commands/skill/schema.js +55 -0
  87. package/dist/commands/skill/schema.js.map +1 -0
  88. package/dist/commands/skill/schema.test.d.ts +1 -0
  89. package/dist/commands/skill/schema.test.js +142 -0
  90. package/dist/commands/skill/schema.test.js.map +1 -0
  91. package/dist/commands/skill/validate.d.ts +10 -0
  92. package/dist/commands/skill/validate.js +39 -0
  93. package/dist/commands/skill/validate.js.map +1 -0
  94. package/dist/commands/skill/validate.test.d.ts +1 -0
  95. package/dist/commands/skill/validate.test.js +171 -0
  96. package/dist/commands/skill/validate.test.js.map +1 -0
  97. package/dist/commands/task.d.ts +34 -0
  98. package/dist/commands/task.js +160 -0
  99. package/dist/commands/task.js.map +1 -0
  100. package/dist/commands/task.test.d.ts +1 -0
  101. package/dist/commands/task.test.js +395 -0
  102. package/dist/commands/task.test.js.map +1 -0
  103. package/dist/commands/todo.d.ts +15 -0
  104. package/dist/commands/todo.js +99 -0
  105. package/dist/commands/todo.js.map +1 -0
  106. package/dist/commands/todo.test.d.ts +1 -0
  107. package/dist/commands/todo.test.js +324 -0
  108. package/dist/commands/todo.test.js.map +1 -0
  109. package/dist/commands/write.d.ts +12 -0
  110. package/dist/commands/write.js +40 -0
  111. package/dist/commands/write.js.map +1 -0
  112. package/dist/commands/write.test.d.ts +1 -0
  113. package/dist/commands/write.test.js +79 -0
  114. package/dist/commands/write.test.js.map +1 -0
  115. package/dist/config.d.ts +15 -0
  116. package/dist/config.js +48 -0
  117. package/dist/config.js.map +1 -0
  118. package/dist/config.test.d.ts +1 -0
  119. package/dist/config.test.js +147 -0
  120. package/dist/config.test.js.map +1 -0
  121. package/dist/core/executor.d.ts +11 -0
  122. package/dist/core/executor.js +42 -0
  123. package/dist/core/executor.js.map +1 -0
  124. package/dist/core/executor.test.d.ts +1 -0
  125. package/dist/core/executor.test.js +206 -0
  126. package/dist/core/executor.test.js.map +1 -0
  127. package/dist/core/middleware/error-handler.d.ts +2 -0
  128. package/dist/core/middleware/error-handler.js +29 -0
  129. package/dist/core/middleware/error-handler.js.map +1 -0
  130. package/dist/core/middleware/index.d.ts +2 -0
  131. package/dist/core/middleware/index.js +3 -0
  132. package/dist/core/middleware/index.js.map +1 -0
  133. package/dist/core/middleware/logging.d.ts +2 -0
  134. package/dist/core/middleware/logging.js +18 -0
  135. package/dist/core/middleware/logging.js.map +1 -0
  136. package/dist/core/registry.d.ts +12 -0
  137. package/dist/core/registry.js +407 -0
  138. package/dist/core/registry.js.map +1 -0
  139. package/dist/core/registry.test.d.ts +1 -0
  140. package/dist/core/registry.test.js +162 -0
  141. package/dist/core/registry.test.js.map +1 -0
  142. package/dist/core/types.d.ts +38 -0
  143. package/dist/core/types.js +2 -0
  144. package/dist/core/types.js.map +1 -0
  145. package/dist/integration/coordination.test.d.ts +1 -0
  146. package/dist/integration/coordination.test.js +286 -0
  147. package/dist/integration/coordination.test.js.map +1 -0
  148. package/dist/integration/project-artifacts.test.d.ts +1 -0
  149. package/dist/integration/project-artifacts.test.js +275 -0
  150. package/dist/integration/project-artifacts.test.js.map +1 -0
  151. package/dist/integration/registry-graph.test.d.ts +1 -0
  152. package/dist/integration/registry-graph.test.js +157 -0
  153. package/dist/integration/registry-graph.test.js.map +1 -0
  154. package/dist/integration/vault-lifecycle.test.d.ts +1 -0
  155. package/dist/integration/vault-lifecycle.test.js +183 -0
  156. package/dist/integration/vault-lifecycle.test.js.map +1 -0
  157. package/dist/lib/auto-number.d.ts +10 -0
  158. package/dist/lib/auto-number.js +33 -0
  159. package/dist/lib/auto-number.js.map +1 -0
  160. package/dist/lib/auto-number.test.d.ts +1 -0
  161. package/dist/lib/auto-number.test.js +88 -0
  162. package/dist/lib/auto-number.test.js.map +1 -0
  163. package/dist/lib/escape-regex.d.ts +4 -0
  164. package/dist/lib/escape-regex.js +7 -0
  165. package/dist/lib/escape-regex.js.map +1 -0
  166. package/dist/lib/escape-regex.test.d.ts +1 -0
  167. package/dist/lib/escape-regex.test.js +27 -0
  168. package/dist/lib/escape-regex.test.js.map +1 -0
  169. package/dist/lib/frontmatter.d.ts +34 -0
  170. package/dist/lib/frontmatter.js +74 -0
  171. package/dist/lib/frontmatter.js.map +1 -0
  172. package/dist/lib/frontmatter.test.d.ts +1 -0
  173. package/dist/lib/frontmatter.test.js +192 -0
  174. package/dist/lib/frontmatter.test.js.map +1 -0
  175. package/dist/lib/project-detector.d.ts +12 -0
  176. package/dist/lib/project-detector.js +123 -0
  177. package/dist/lib/project-detector.js.map +1 -0
  178. package/dist/lib/project-detector.test.d.ts +1 -0
  179. package/dist/lib/project-detector.test.js +117 -0
  180. package/dist/lib/project-detector.test.js.map +1 -0
  181. package/dist/lib/safe-external-path.d.ts +10 -0
  182. package/dist/lib/safe-external-path.js +46 -0
  183. package/dist/lib/safe-external-path.js.map +1 -0
  184. package/dist/lib/safe-external-path.test.d.ts +1 -0
  185. package/dist/lib/safe-external-path.test.js +99 -0
  186. package/dist/lib/safe-external-path.test.js.map +1 -0
  187. package/dist/lib/search-engine.d.ts +19 -0
  188. package/dist/lib/search-engine.js +157 -0
  189. package/dist/lib/search-engine.js.map +1 -0
  190. package/dist/lib/search-engine.test.d.ts +1 -0
  191. package/dist/lib/search-engine.test.js +120 -0
  192. package/dist/lib/search-engine.test.js.map +1 -0
  193. package/dist/lib/session-registry.d.ts +59 -0
  194. package/dist/lib/session-registry.js +230 -0
  195. package/dist/lib/session-registry.js.map +1 -0
  196. package/dist/lib/session-registry.test.d.ts +1 -0
  197. package/dist/lib/session-registry.test.js +199 -0
  198. package/dist/lib/session-registry.test.js.map +1 -0
  199. package/dist/lib/skill-registry.d.ts +13 -0
  200. package/dist/lib/skill-registry.js +76 -0
  201. package/dist/lib/skill-registry.js.map +1 -0
  202. package/dist/lib/token-estimator.d.ts +19 -0
  203. package/dist/lib/token-estimator.js +58 -0
  204. package/dist/lib/token-estimator.js.map +1 -0
  205. package/dist/lib/token-estimator.test.d.ts +1 -0
  206. package/dist/lib/token-estimator.test.js +65 -0
  207. package/dist/lib/token-estimator.test.js.map +1 -0
  208. package/dist/lib/vault-fs.d.ts +39 -0
  209. package/dist/lib/vault-fs.js +183 -0
  210. package/dist/lib/vault-fs.js.map +1 -0
  211. package/dist/lib/vault-fs.test.d.ts +1 -0
  212. package/dist/lib/vault-fs.test.js +210 -0
  213. package/dist/lib/vault-fs.test.js.map +1 -0
  214. package/dist/mcp-server.d.ts +2 -0
  215. package/dist/mcp-server.js +385 -0
  216. package/dist/mcp-server.js.map +1 -0
  217. package/dist/test-helpers.d.ts +20 -0
  218. package/dist/test-helpers.js +46 -0
  219. package/dist/test-helpers.js.map +1 -0
  220. package/dist/test-helpers.test.d.ts +1 -0
  221. package/dist/test-helpers.test.js +90 -0
  222. package/dist/test-helpers.test.js.map +1 -0
  223. package/package.json +72 -0
@@ -0,0 +1,40 @@
1
+ import { serializeFrontmatter, createFrontmatter } from "../lib/frontmatter.js";
2
+ import { resolveProject } from "../config.js";
3
+ import { getNextNumber, slugify } from "../lib/auto-number.js";
4
+ export async function decideCommand(args, ctx) {
5
+ const projectSlug = await resolveProject(ctx.vaultPath, args.project);
6
+ const decisionsDir = `projects/${projectSlug}/decisions`;
7
+ const nextNumber = await getNextNumber(ctx.vaultFs, decisionsDir);
8
+ const paddedNumber = String(nextNumber).padStart(3, "0");
9
+ const slug = slugify(args.title);
10
+ const filename = `${paddedNumber}-${slug}.md`;
11
+ const filePath = `${decisionsDir}/${filename}`;
12
+ const fm = createFrontmatter({
13
+ type: "adr",
14
+ project: projectSlug,
15
+ status: "active",
16
+ tags: [],
17
+ });
18
+ const body = `
19
+ # ADR-${paddedNumber}: ${args.title}
20
+
21
+ ## Context
22
+
23
+ ${args.context}
24
+
25
+ ## Decision
26
+
27
+ ${args.decision}
28
+
29
+ ## Alternatives Considered
30
+
31
+ ${args.alternatives ?? "None documented."}
32
+
33
+ ## Consequences
34
+
35
+ ${args.consequences ?? "To be evaluated."}
36
+ `.trimStart();
37
+ await ctx.vaultFs.write(filePath, serializeFrontmatter(fm, body));
38
+ return { path: filePath, decision_number: nextNumber };
39
+ }
40
+ //# sourceMappingURL=decide.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decide.js","sourceRoot":"","sources":["../../src/commands/decide.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAOC,EACD,GAAmB;IAEnB,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAEtE,MAAM,YAAY,GAAG,YAAY,WAAW,YAAY,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,GAAG,YAAY,IAAI,IAAI,KAAK,CAAC;IAC9C,MAAM,QAAQ,GAAG,GAAG,YAAY,IAAI,QAAQ,EAAE,CAAC;IAE/C,MAAM,EAAE,GAAG,iBAAiB,CAAC;QAC3B,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG;QACP,YAAY,KAAK,IAAI,CAAC,KAAK;;;;EAIjC,IAAI,CAAC,OAAO;;;;EAIZ,IAAI,CAAC,QAAQ;;;;EAIb,IAAI,CAAC,YAAY,IAAI,kBAAkB;;;;EAIvC,IAAI,CAAC,YAAY,IAAI,kBAAkB;CACxC,CAAC,SAAS,EAAE,CAAC;IAEZ,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IAElE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,109 @@
1
+ import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
2
+ import { mkdir, rm } from "fs/promises";
3
+ import { homedir } from "os";
4
+ import { join } from "path";
5
+ import { decideCommand } from "./decide.js";
6
+ import { VaultFS } from "../lib/vault-fs.js";
7
+ function createCommandContext(vaultFs, overrides) {
8
+ return {
9
+ vaultFs,
10
+ vaultPath: vaultFs.root,
11
+ sessionRegistry: {},
12
+ config: {},
13
+ log: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
14
+ ...overrides,
15
+ };
16
+ }
17
+ describe("decideCommand", () => {
18
+ let vaultRoot;
19
+ let vaultFs;
20
+ let ctx;
21
+ beforeEach(async () => {
22
+ vaultRoot = join(homedir(), `.vault-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
23
+ await mkdir(vaultRoot, { recursive: true });
24
+ vaultFs = new VaultFS(vaultRoot);
25
+ ctx = createCommandContext(vaultFs);
26
+ });
27
+ afterEach(async () => {
28
+ await rm(vaultRoot, { recursive: true, force: true });
29
+ });
30
+ describe("create ADR", () => {
31
+ it("creates ADR with auto-numbering", async () => {
32
+ await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
33
+ await mkdir(join(vaultRoot, "projects/test-project/decisions"), { recursive: true });
34
+ const result = await decideCommand({
35
+ title: "Use TypeScript",
36
+ context: "We need type safety",
37
+ decision: "Adopt TypeScript for all new code",
38
+ project: "test-project",
39
+ }, ctx);
40
+ expect(result.decision_number).toBe(1);
41
+ expect(result.path).toBe("projects/test-project/decisions/001-use-typescript.md");
42
+ const content = await vaultFs.read(result.path);
43
+ expect(content).toContain("type: adr");
44
+ expect(content).toContain("project: test-project");
45
+ expect(content).toContain("status: active");
46
+ expect(content).toContain("# ADR-001: Use TypeScript");
47
+ expect(content).toContain("We need type safety");
48
+ expect(content).toContain("Adopt TypeScript for all new code");
49
+ });
50
+ it("increments ADR number for subsequent decisions", async () => {
51
+ await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
52
+ await mkdir(join(vaultRoot, "projects/test-project/decisions"), { recursive: true });
53
+ const result1 = await decideCommand({
54
+ title: "First Decision",
55
+ context: "Context 1",
56
+ decision: "Decision 1",
57
+ project: "test-project",
58
+ }, ctx);
59
+ const result2 = await decideCommand({
60
+ title: "Second Decision",
61
+ context: "Context 2",
62
+ decision: "Decision 2",
63
+ project: "test-project",
64
+ }, ctx);
65
+ expect(result1.decision_number).toBe(1);
66
+ expect(result2.decision_number).toBe(2);
67
+ });
68
+ it("includes alternatives and consequences when provided", async () => {
69
+ await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
70
+ await mkdir(join(vaultRoot, "projects/test-project/decisions"), { recursive: true });
71
+ const result = await decideCommand({
72
+ title: "Database Choice",
73
+ context: "Need a database",
74
+ decision: "Use PostgreSQL",
75
+ alternatives: "Considered MySQL and MongoDB",
76
+ consequences: "Requires DevOps expertise",
77
+ project: "test-project",
78
+ }, ctx);
79
+ const content = await vaultFs.read(result.path);
80
+ expect(content).toContain("Considered MySQL and MongoDB");
81
+ expect(content).toContain("Requires DevOps expertise");
82
+ });
83
+ it("uses defaults for missing alternatives and consequences", async () => {
84
+ await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
85
+ await mkdir(join(vaultRoot, "projects/test-project/decisions"), { recursive: true });
86
+ const result = await decideCommand({
87
+ title: "Simple Decision",
88
+ context: "Simple context",
89
+ decision: "Simple decision",
90
+ project: "test-project",
91
+ }, ctx);
92
+ const content = await vaultFs.read(result.path);
93
+ expect(content).toContain("None documented.");
94
+ expect(content).toContain("To be evaluated.");
95
+ });
96
+ it("slugifies title correctly", async () => {
97
+ await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
98
+ await mkdir(join(vaultRoot, "projects/test-project/decisions"), { recursive: true });
99
+ const result = await decideCommand({
100
+ title: "Use React & TypeScript!",
101
+ context: "Context",
102
+ decision: "Decision",
103
+ project: "test-project",
104
+ }, ctx);
105
+ expect(result.path).toContain("use-react-typescript");
106
+ });
107
+ });
108
+ });
109
+ //# sourceMappingURL=decide.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"decide.test.js","sourceRoot":"","sources":["../../src/commands/decide.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import type { CommandContext } from "../core/types.js";
2
+ import { type SearchResult } from "../lib/search-engine.js";
3
+ export interface GraphResult {
4
+ note: string;
5
+ outgoing: string[];
6
+ backlinks: string[];
7
+ }
8
+ export declare function graphRelatedCommand(args: {
9
+ path: string;
10
+ hops?: number;
11
+ } | undefined, ctx: CommandContext): Promise<GraphResult>;
12
+ export declare function graphCrossProjectCommand(args: {
13
+ query: string;
14
+ limit?: number;
15
+ } | undefined, ctx: CommandContext): Promise<Record<string, SearchResult[]>>;
@@ -0,0 +1,89 @@
1
+ import { VaultError } from "../lib/vault-fs.js";
2
+ import { searchText } from "../lib/search-engine.js";
3
+ function extractWikilinks(content) {
4
+ const links = [];
5
+ const regex = /\[\[([^\]|]+)(?:\|[^\]]+)?\]\]/g;
6
+ let match;
7
+ while ((match = regex.exec(content)) !== null) {
8
+ links.push(match[1]);
9
+ }
10
+ return [...new Set(links)];
11
+ }
12
+ export async function graphRelatedCommand(args = {}, ctx) {
13
+ const { path, hops = 1 } = args;
14
+ const vaultFs = ctx.vaultFs;
15
+ const vaultPath = ctx.vaultPath;
16
+ const content = await vaultFs.read(path);
17
+ const outgoing = extractWikilinks(content);
18
+ const noteName = path.replace(/\.md$/, "");
19
+ const backlinks = [];
20
+ try {
21
+ const results = await searchText(vaultPath, `[[${noteName}`, { limit: 50 });
22
+ for (const result of results) {
23
+ if (result.path !== path) {
24
+ backlinks.push(result.path);
25
+ }
26
+ }
27
+ }
28
+ catch (e) {
29
+ if (e instanceof VaultError && e.code === "FILE_NOT_FOUND") { /* expected */ }
30
+ else if (e instanceof Error && e.message.includes("search")) { /* search engine error */ }
31
+ else
32
+ throw e;
33
+ }
34
+ if (hops > 1) {
35
+ const secondHopOutgoing = new Set();
36
+ const secondHopBacklinks = new Set();
37
+ for (const link of [...outgoing, ...backlinks].slice(0, 10)) {
38
+ const linkPath = link.endsWith(".md") ? link : `${link}.md`;
39
+ try {
40
+ const linkContent = await vaultFs.read(linkPath);
41
+ for (const subLink of extractWikilinks(linkContent)) {
42
+ if (subLink !== noteName && !outgoing.includes(subLink)) {
43
+ secondHopOutgoing.add(subLink);
44
+ }
45
+ }
46
+ }
47
+ catch (e) {
48
+ if (e instanceof VaultError && e.code === "FILE_NOT_FOUND") { /* expected */ }
49
+ else
50
+ throw e;
51
+ }
52
+ const linkName = link.replace(/\.md$/, "");
53
+ try {
54
+ const blResults = await searchText(vaultPath, `[[${linkName}`, { limit: 20 });
55
+ for (const r of blResults) {
56
+ if (r.path !== path && !backlinks.includes(r.path)) {
57
+ secondHopBacklinks.add(r.path);
58
+ }
59
+ }
60
+ }
61
+ catch (e) {
62
+ if (e instanceof VaultError && e.code === "FILE_NOT_FOUND") { /* expected */ }
63
+ else if (e instanceof Error && e.message.includes("search")) { /* search engine error */ }
64
+ else
65
+ throw e;
66
+ }
67
+ }
68
+ return {
69
+ note: path,
70
+ outgoing: [...new Set([...outgoing, ...secondHopOutgoing])],
71
+ backlinks: [...new Set([...backlinks, ...secondHopBacklinks])],
72
+ };
73
+ }
74
+ return { note: path, outgoing, backlinks: [...new Set(backlinks)] };
75
+ }
76
+ export async function graphCrossProjectCommand(args = {}, ctx) {
77
+ const { query, limit = 20 } = args;
78
+ const results = await searchText(ctx.vaultPath, query, { limit });
79
+ const grouped = {};
80
+ for (const result of results) {
81
+ const parts = result.path.split("/");
82
+ const project = parts[0] === "projects" && parts.length > 1 ? parts[1] : "_shared";
83
+ if (!grouped[project])
84
+ grouped[project] = [];
85
+ grouped[project].push(result);
86
+ }
87
+ return grouped;
88
+ }
89
+ //# sourceMappingURL=graph.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAqB,MAAM,yBAAyB,CAAC;AAQxE,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,iCAAiC,CAAC;IAChD,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAGI,EAAS,EACb,GAAmB;IAEnB,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAChC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAEhC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,KAAK,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACzB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,IAAI,CAAC,YAAY,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;aACzE,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,yBAAyB,CAAC,CAAC;;YACrF,MAAM,CAAC,CAAC;IACf,CAAC;IAED,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACb,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;QAC5C,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE7C,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC;YAC5D,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjD,KAAK,MAAM,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;oBACpD,IAAI,OAAO,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;wBACxD,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,YAAY,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;;oBACzE,MAAM,CAAC,CAAC;YACf,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,KAAK,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9E,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;oBAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;wBACnD,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,YAAY,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC;qBACzE,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,yBAAyB,CAAC,CAAC;;oBACrF,MAAM,CAAC,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC;YAC3D,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,kBAAkB,CAAC,CAAC,CAAC;SAC/D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAGI,EAAS,EACb,GAAmB;IAEnB,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAElE,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7C,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,215 @@
1
+ import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
2
+ import { mkdir, rm } from "fs/promises";
3
+ import { homedir } from "os";
4
+ import { join } from "path";
5
+ import { graphRelatedCommand, graphCrossProjectCommand } from "./graph.js";
6
+ import { VaultFS } from "../lib/vault-fs.js";
7
+ function createCommandContext(vaultFs, overrides) {
8
+ return {
9
+ vaultFs,
10
+ vaultPath: vaultFs.root,
11
+ sessionRegistry: {},
12
+ config: {},
13
+ log: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
14
+ ...overrides,
15
+ };
16
+ }
17
+ describe("graph commands", () => {
18
+ let vaultRoot;
19
+ let vaultFs;
20
+ let ctx;
21
+ beforeEach(async () => {
22
+ vaultRoot = join(homedir(), `.vault-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
23
+ await mkdir(vaultRoot, { recursive: true });
24
+ vaultFs = new VaultFS(vaultRoot);
25
+ ctx = createCommandContext(vaultFs);
26
+ });
27
+ afterEach(async () => {
28
+ await rm(vaultRoot, { recursive: true, force: true });
29
+ });
30
+ describe("extractWikilinks", () => {
31
+ it("extracts simple wikilinks", async () => {
32
+ await vaultFs.write("note.md", `---
33
+ type: note
34
+ ---
35
+
36
+ # Note
37
+
38
+ Link to [[other-note]] and [[another-note]].
39
+ `);
40
+ const result = await graphRelatedCommand({ path: "note.md" }, ctx);
41
+ expect(result.outgoing).toContain("other-note");
42
+ expect(result.outgoing).toContain("another-note");
43
+ });
44
+ it("extracts wikilinks with aliases", async () => {
45
+ await vaultFs.write("note.md", `---
46
+ type: note
47
+ ---
48
+
49
+ Link to [[target|display text]].
50
+ `);
51
+ const result = await graphRelatedCommand({ path: "note.md" }, ctx);
52
+ expect(result.outgoing).toContain("target");
53
+ });
54
+ it("deduplicates wikilinks", async () => {
55
+ await vaultFs.write("note.md", `---
56
+ type: note
57
+ ---
58
+
59
+ Link to [[same-note]] twice: [[same-note]].
60
+ `);
61
+ const result = await graphRelatedCommand({ path: "note.md" }, ctx);
62
+ expect(result.outgoing.filter(l => l === "same-note")).toHaveLength(1);
63
+ });
64
+ it("returns empty array when no wikilinks", async () => {
65
+ await vaultFs.write("note.md", `---
66
+ type: note
67
+ ---
68
+
69
+ # Note with no links
70
+ `);
71
+ const result = await graphRelatedCommand({ path: "note.md" }, ctx);
72
+ expect(result.outgoing).toEqual([]);
73
+ });
74
+ });
75
+ describe("backlinks", () => {
76
+ it("finds backlinks to note", async () => {
77
+ await vaultFs.write("target.md", `---
78
+ type: note
79
+ ---
80
+
81
+ # Target Note
82
+ `);
83
+ await vaultFs.write("source.md", `---
84
+ type: note
85
+ ---
86
+
87
+ Link to [[target]] here.
88
+ `);
89
+ const result = await graphRelatedCommand({ path: "target.md" }, ctx);
90
+ expect(result.backlinks).toContain("source.md");
91
+ });
92
+ it("excludes self-references from backlinks", async () => {
93
+ await vaultFs.write("note.md", `---
94
+ type: note
95
+ ---
96
+
97
+ Link to [[note]] itself.
98
+ `);
99
+ const result = await graphRelatedCommand({ path: "note.md" }, ctx);
100
+ expect(result.backlinks).not.toContain("note.md");
101
+ });
102
+ it("finds backlinks with .md extension in link", async () => {
103
+ await vaultFs.write("target.md", `---
104
+ type: note
105
+ ---
106
+
107
+ # Target
108
+ `);
109
+ await vaultFs.write("source.md", `---
110
+ type: note
111
+ ---
112
+
113
+ Link to [[target.md]].
114
+ `);
115
+ const result = await graphRelatedCommand({ path: "target.md" }, ctx);
116
+ expect(result.backlinks).toContain("source.md");
117
+ });
118
+ });
119
+ describe("hops", () => {
120
+ it("returns single hop by default", async () => {
121
+ await vaultFs.write("a.md", `---
122
+ type: note
123
+ ---
124
+
125
+ [[b]]
126
+ `);
127
+ await vaultFs.write("b.md", `---
128
+ type: note
129
+ ---
130
+
131
+ [[c]]
132
+ `);
133
+ await vaultFs.write("c.md", `---\ntype: note\n---\n# C`);
134
+ const result = await graphRelatedCommand({ path: "a.md", hops: 1 }, ctx);
135
+ expect(result.outgoing).toContain("b");
136
+ expect(result.outgoing).not.toContain("c");
137
+ });
138
+ it("returns second hop when hops > 1", async () => {
139
+ await vaultFs.write("a.md", `---
140
+ type: note
141
+ ---
142
+
143
+ [[b]]
144
+ `);
145
+ await vaultFs.write("b.md", `---
146
+ type: note
147
+ ---
148
+
149
+ [[c]]
150
+ `);
151
+ await vaultFs.write("c.md", `---\ntype: note\n---\n# C`);
152
+ const result = await graphRelatedCommand({ path: "a.md", hops: 2 }, ctx);
153
+ expect(result.outgoing).toContain("b");
154
+ expect(result.outgoing).toContain("c");
155
+ });
156
+ it("finds second hop backlinks", async () => {
157
+ await vaultFs.write("a.md", `---\ntype: note\n---\n[[b]]`);
158
+ await vaultFs.write("b.md", `---\ntype: note\n---\n# B`);
159
+ await vaultFs.write("c.md", `---\ntype: note\n---\n[[b]]`);
160
+ const result = await graphRelatedCommand({ path: "a.md", hops: 2 }, ctx);
161
+ // c.md links to b.md, which is linked from a.md
162
+ expect(result.backlinks.length).toBeGreaterThanOrEqual(0);
163
+ });
164
+ });
165
+ describe("graphCrossProjectCommand", () => {
166
+ it("groups results by project", async () => {
167
+ await mkdir(join(vaultRoot, "projects/proj-a"), { recursive: true });
168
+ await mkdir(join(vaultRoot, "projects/proj-b"), { recursive: true });
169
+ await vaultFs.write("projects/proj-a/note.md", `---
170
+ type: note
171
+ ---
172
+
173
+ API endpoint documentation
174
+ `);
175
+ await vaultFs.write("projects/proj-b/note.md", `---
176
+ type: note
177
+ ---
178
+
179
+ API client implementation
180
+ `);
181
+ const result = await graphCrossProjectCommand({ query: "API", limit: 10 }, ctx);
182
+ // Results should be grouped
183
+ expect(typeof result).toBe("object");
184
+ });
185
+ it("uses _shared for non-project files", async () => {
186
+ await vaultFs.write("shared-note.md", `---
187
+ type: note
188
+ ---
189
+
190
+ Shared API documentation
191
+ `);
192
+ const result = await graphCrossProjectCommand({ query: "API", limit: 10 }, ctx);
193
+ expect(result["_shared"] || result["shared-note"]).toBeDefined;
194
+ });
195
+ it("respects limit parameter", async () => {
196
+ for (let i = 0; i < 30; i++) {
197
+ await vaultFs.write(`note-${i}.md`, `---
198
+ type: note
199
+ ---
200
+
201
+ Test content ${i}
202
+ `);
203
+ }
204
+ const result = await graphCrossProjectCommand({ query: "Test", limit: 5 }, ctx);
205
+ const totalResults = Object.values(result).flat().length;
206
+ expect(totalResults).toBeLessThanOrEqual(5);
207
+ });
208
+ });
209
+ describe("error handling", () => {
210
+ it("throws for non-existent file", async () => {
211
+ await expect(graphRelatedCommand({ path: "nonexistent.md" }, ctx)).rejects.toThrow();
212
+ });
213
+ });
214
+ });
215
+ //# sourceMappingURL=graph.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph.test.js","sourceRoot":"","sources":["../../src/commands/graph.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ interface InitResult {
2
+ draft_context_md: string;
3
+ detected_tech_stack: string[];
4
+ slug: string;
5
+ }
6
+ /**
7
+ * Scan a git repo and generate a draft context.md.
8
+ * Does NOT write to vault — returns the draft as a string.
9
+ */
10
+ export declare function initCommand(projectPath: string, slug?: string): Promise<InitResult>;
11
+ export {};