memorix 1.6.1 → 1.6.3

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 (122) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/TEAM.md +86 -86
  3. package/dist/cli/index.js +2582 -1845
  4. package/dist/index.js +1355 -683
  5. package/dist/maintenance-runner.js +1621 -1096
  6. package/dist/media-audio-runner.js +1612 -1088
  7. package/dist/media-video-runner.js +1612 -1088
  8. package/dist/memcode-runtime/CHANGELOG.md +35 -0
  9. package/dist/sdk.js +2007 -1396
  10. package/dist/vector-backfill-runner.js +1610 -1086
  11. package/docs/DESIGN_DECISIONS.md +357 -357
  12. package/docs/PERFORMANCE.md +15 -0
  13. package/package.json +2 -1
  14. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  15. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  16. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  17. package/plugins/copilot/memorix/plugin.json +1 -1
  18. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  19. package/plugins/omp/memorix/package.json +1 -1
  20. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  21. package/plugins/pi/memorix/package.json +1 -1
  22. package/server.json +2 -2
  23. package/src/audit/index.ts +156 -156
  24. package/src/cli/commands/background.ts +51 -5
  25. package/src/cli/commands/formation.ts +48 -48
  26. package/src/cli/commands/git-hook-install.ts +111 -111
  27. package/src/cli/commands/handoff.ts +54 -54
  28. package/src/cli/commands/hooks-status.ts +63 -63
  29. package/src/cli/commands/ingest.ts +44 -44
  30. package/src/cli/commands/integrate-shared.ts +15 -15
  31. package/src/cli/commands/lock.ts +82 -82
  32. package/src/cli/commands/message.ts +104 -104
  33. package/src/cli/commands/operator-shared.ts +18 -11
  34. package/src/cli/commands/poll.ts +58 -58
  35. package/src/cli/commands/reasoning.ts +118 -118
  36. package/src/cli/commands/serve-http.ts +29 -7
  37. package/src/cli/commands/serve-shared.ts +49 -6
  38. package/src/cli/commands/serve.ts +4 -0
  39. package/src/cli/commands/skills.ts +114 -114
  40. package/src/cli/commands/task.ts +167 -167
  41. package/src/cli/commands/transfer.ts +47 -47
  42. package/src/cli/index.ts +406 -406
  43. package/src/cli/tui/ChatView.tsx +234 -234
  44. package/src/cli/tui/CommandBar.tsx +312 -312
  45. package/src/cli/tui/ContextRail.tsx +118 -118
  46. package/src/cli/tui/HeaderBar.tsx +72 -72
  47. package/src/cli/tui/LogoBanner.tsx +51 -51
  48. package/src/cli/tui/index.ts +41 -41
  49. package/src/cli/version.ts +7 -7
  50. package/src/cli/workbench.ts +1 -1
  51. package/src/dashboard/project-classification.ts +64 -64
  52. package/src/embedding/api-provider.ts +503 -27
  53. package/src/embedding/provider.ts +20 -3
  54. package/src/git/hooks-path.ts +85 -85
  55. package/src/hooks/lifecycle.ts +1 -0
  56. package/src/hooks/pattern-detector.ts +173 -173
  57. package/src/hooks/significance-filter.ts +250 -250
  58. package/src/llm/memory-manager.ts +328 -328
  59. package/src/llm/quality.ts +248 -248
  60. package/src/memory/attribution-guard.ts +249 -249
  61. package/src/memory/disclosure-policy.ts +135 -135
  62. package/src/memory/entity-extractor.ts +197 -197
  63. package/src/memory/formation/evaluate.ts +217 -217
  64. package/src/memory/freshness.ts +122 -122
  65. package/src/memory/graph.ts +197 -197
  66. package/src/memory/observations.ts +68 -18
  67. package/src/memory/refs.ts +94 -94
  68. package/src/memory/secret-filter.ts +79 -79
  69. package/src/memory/session.ts +13 -3
  70. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  71. package/src/orchestrate/adapters/claude.ts +111 -111
  72. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  73. package/src/orchestrate/adapters/codex.ts +41 -41
  74. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  75. package/src/orchestrate/adapters/gemini.ts +42 -42
  76. package/src/orchestrate/adapters/index.ts +73 -73
  77. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  78. package/src/orchestrate/adapters/opencode.ts +47 -47
  79. package/src/orchestrate/adapters/types.ts +77 -77
  80. package/src/orchestrate/capability-router.ts +284 -284
  81. package/src/orchestrate/cost-tracker.ts +219 -219
  82. package/src/orchestrate/error-recovery.ts +191 -191
  83. package/src/orchestrate/evidence.ts +140 -140
  84. package/src/orchestrate/ledger.ts +110 -110
  85. package/src/orchestrate/memorix-bridge.ts +343 -343
  86. package/src/orchestrate/output-budget.ts +80 -80
  87. package/src/orchestrate/permission.ts +152 -152
  88. package/src/orchestrate/pipeline-trace.ts +131 -131
  89. package/src/orchestrate/prompt-builder.ts +155 -155
  90. package/src/orchestrate/ring-buffer.ts +37 -37
  91. package/src/orchestrate/task-graph.ts +389 -389
  92. package/src/project/aliases.ts +374 -374
  93. package/src/project/launch-root.ts +115 -0
  94. package/src/rules/adapters/trae.ts +56 -56
  95. package/src/rules/syncer.ts +235 -235
  96. package/src/runtime/isolated-maintenance.ts +12 -1
  97. package/src/sdk.ts +12 -8
  98. package/src/search/query-expansion.ts +52 -52
  99. package/src/server/formation-timeout.ts +27 -27
  100. package/src/server.ts +38 -5
  101. package/src/skills/mini-skills.ts +386 -386
  102. package/src/store/chat-store.ts +119 -119
  103. package/src/store/graph-store.ts +249 -249
  104. package/src/store/mini-skill-store.ts +349 -349
  105. package/src/store/obs-store.ts +2 -2
  106. package/src/store/orama-store.ts +21 -3
  107. package/src/store/persistence-json.ts +212 -212
  108. package/src/store/persistence.ts +291 -291
  109. package/src/store/project-affinity.ts +195 -195
  110. package/src/store/sqlite-db.ts +2 -0
  111. package/src/store/sqlite-store.ts +19 -4
  112. package/src/team/event-bus.ts +76 -76
  113. package/src/team/handoff.ts +161 -161
  114. package/src/team/poll.ts +132 -132
  115. package/src/workspace/mcp-adapters/codex.ts +191 -191
  116. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  117. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  118. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  119. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  120. package/src/workspace/mcp-adapters/trae.ts +134 -134
  121. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  122. package/src/workspace/sanitizer.ts +60 -60
@@ -1,191 +1,191 @@
1
- import type { MCPConfigAdapter, MCPServerEntry } from '../../types.js';
2
- import { homedir } from 'node:os';
3
- import { join } from 'node:path';
4
-
5
- /**
6
- * Codex MCP config adapter.
7
- * Format: TOML file at ~/.codex/config.toml or .codex/config.toml (project-level)
8
- *
9
- * Structure:
10
- * [mcp_servers.<name>]
11
- * command = "npx"
12
- * args = ["-y", "memorix-mcp"]
13
- * url = "https://..." # for HTTP servers
14
- *
15
- * [mcp_servers.<name>.env]
16
- * KEY = "value"
17
- *
18
- * We implement a lightweight TOML parser (no external deps) sufficient
19
- * for MCP server config blocks. This avoids adding a TOML dependency.
20
- */
21
- export class CodexMCPAdapter implements MCPConfigAdapter {
22
- readonly source = 'codex' as const;
23
-
24
- parse(content: string): MCPServerEntry[] {
25
- if (!content.trim()) return [];
26
-
27
- const servers: MCPServerEntry[] = [];
28
- const lines = content.split('\n');
29
-
30
- let currentServer: string | null = null;
31
- let isEnvBlock = false;
32
- const serverMap = new Map<
33
- string,
34
- { command: string; args: string[]; env: Record<string, string>; url?: string; enabled?: boolean }
35
- >();
36
-
37
- for (const rawLine of lines) {
38
- const line = rawLine.trim();
39
-
40
- // Skip comments and empty lines
41
- if (!line || line.startsWith('#')) continue;
42
-
43
- // Match [mcp_servers.<name>.env]
44
- const envMatch = line.match(/^\[mcp_servers\.([^.\]]+)\.env\]$/);
45
- if (envMatch) {
46
- currentServer = envMatch[1];
47
- isEnvBlock = true;
48
- if (!serverMap.has(currentServer)) {
49
- serverMap.set(currentServer, { command: '', args: [], env: {} });
50
- }
51
- continue;
52
- }
53
-
54
- // Match [mcp_servers.<name>]
55
- const serverMatch = line.match(/^\[mcp_servers\.([^.\]]+)\]$/);
56
- if (serverMatch) {
57
- currentServer = serverMatch[1];
58
- isEnvBlock = false;
59
- if (!serverMap.has(currentServer)) {
60
- serverMap.set(currentServer, { command: '', args: [], env: {} });
61
- }
62
- continue;
63
- }
64
-
65
- // Any other section header resets context
66
- if (line.startsWith('[')) {
67
- currentServer = null;
68
- isEnvBlock = false;
69
- continue;
70
- }
71
-
72
- // Parse key = value within current server block
73
- if (currentServer) {
74
- const kvMatch = line.match(/^(\w+)\s*=\s*(.+)$/);
75
- if (!kvMatch) continue;
76
-
77
- const key = kvMatch[1];
78
- const rawValue = kvMatch[2].trim();
79
- const entry = serverMap.get(currentServer)!;
80
-
81
- if (isEnvBlock) {
82
- entry.env[key] = this.parseTomlString(rawValue);
83
- } else if (key === 'command') {
84
- entry.command = this.parseTomlString(rawValue);
85
- } else if (key === 'args') {
86
- entry.args = this.parseTomlArray(rawValue);
87
- } else if (key === 'url') {
88
- entry.url = this.parseTomlString(rawValue);
89
- } else if (key === 'enabled') {
90
- entry.enabled = rawValue === 'true';
91
- }
92
- }
93
- }
94
-
95
- for (const [name, entry] of serverMap) {
96
- servers.push({
97
- name,
98
- command: entry.command,
99
- args: entry.args,
100
- ...(Object.keys(entry.env).length > 0 ? { env: entry.env } : {}),
101
- ...(entry.url ? { url: entry.url } : {}),
102
- });
103
- }
104
-
105
- return servers;
106
- }
107
-
108
- generate(servers: MCPServerEntry[]): string {
109
- const blocks: string[] = [];
110
-
111
- for (const s of servers) {
112
- const lines: string[] = [];
113
- lines.push(`[mcp_servers.${s.name}]`);
114
-
115
- if (s.url) {
116
- lines.push(`url = ${this.toTomlString(s.url)}`);
117
- } else {
118
- lines.push(`command = ${this.toTomlString(s.command)}`);
119
- lines.push(`args = [${s.args.map((a) => this.toTomlString(a)).join(', ')}]`);
120
- }
121
-
122
- if (s.env && Object.keys(s.env).length > 0) {
123
- lines.push('');
124
- lines.push(`[mcp_servers.${s.name}.env]`);
125
- for (const [key, value] of Object.entries(s.env)) {
126
- lines.push(`${key} = ${this.toTomlString(value)}`);
127
- }
128
- }
129
-
130
- blocks.push(lines.join('\n'));
131
- }
132
-
133
- return blocks.join('\n\n') + '\n';
134
- }
135
-
136
- getConfigPath(projectRoot?: string): string {
137
- if (projectRoot) {
138
- return join(projectRoot, '.codex', 'config.toml');
139
- }
140
- return join(homedir(), '.codex', 'config.toml');
141
- }
142
-
143
- // ---- TOML helpers ----
144
-
145
- private parseTomlString(raw: string): string {
146
- const trimmed = raw.trim();
147
- if (
148
- (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
149
- (trimmed.startsWith("'") && trimmed.endsWith("'"))
150
- ) {
151
- return trimmed.slice(1, -1);
152
- }
153
- return trimmed;
154
- }
155
-
156
- private parseTomlArray(raw: string): string[] {
157
- const trimmed = raw.trim();
158
- if (!trimmed.startsWith('[') || !trimmed.endsWith(']')) return [];
159
- const inner = trimmed.slice(1, -1);
160
- const result: string[] = [];
161
- // Simple CSV parse respecting quotes
162
- let current = '';
163
- let inQuote = false;
164
- let quoteChar = '';
165
- for (const ch of inner) {
166
- if (inQuote) {
167
- if (ch === quoteChar) {
168
- inQuote = false;
169
- } else {
170
- current += ch;
171
- }
172
- } else if (ch === '"' || ch === "'") {
173
- inQuote = true;
174
- quoteChar = ch;
175
- } else if (ch === ',') {
176
- const val = current.trim();
177
- if (val) result.push(val);
178
- current = '';
179
- } else {
180
- current += ch;
181
- }
182
- }
183
- const last = current.trim();
184
- if (last) result.push(last);
185
- return result;
186
- }
187
-
188
- private toTomlString(value: string): string {
189
- return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
190
- }
191
- }
1
+ import type { MCPConfigAdapter, MCPServerEntry } from '../../types.js';
2
+ import { homedir } from 'node:os';
3
+ import { join } from 'node:path';
4
+
5
+ /**
6
+ * Codex MCP config adapter.
7
+ * Format: TOML file at ~/.codex/config.toml or .codex/config.toml (project-level)
8
+ *
9
+ * Structure:
10
+ * [mcp_servers.<name>]
11
+ * command = "npx"
12
+ * args = ["-y", "memorix-mcp"]
13
+ * url = "https://..." # for HTTP servers
14
+ *
15
+ * [mcp_servers.<name>.env]
16
+ * KEY = "value"
17
+ *
18
+ * We implement a lightweight TOML parser (no external deps) sufficient
19
+ * for MCP server config blocks. This avoids adding a TOML dependency.
20
+ */
21
+ export class CodexMCPAdapter implements MCPConfigAdapter {
22
+ readonly source = 'codex' as const;
23
+
24
+ parse(content: string): MCPServerEntry[] {
25
+ if (!content.trim()) return [];
26
+
27
+ const servers: MCPServerEntry[] = [];
28
+ const lines = content.split('\n');
29
+
30
+ let currentServer: string | null = null;
31
+ let isEnvBlock = false;
32
+ const serverMap = new Map<
33
+ string,
34
+ { command: string; args: string[]; env: Record<string, string>; url?: string; enabled?: boolean }
35
+ >();
36
+
37
+ for (const rawLine of lines) {
38
+ const line = rawLine.trim();
39
+
40
+ // Skip comments and empty lines
41
+ if (!line || line.startsWith('#')) continue;
42
+
43
+ // Match [mcp_servers.<name>.env]
44
+ const envMatch = line.match(/^\[mcp_servers\.([^.\]]+)\.env\]$/);
45
+ if (envMatch) {
46
+ currentServer = envMatch[1];
47
+ isEnvBlock = true;
48
+ if (!serverMap.has(currentServer)) {
49
+ serverMap.set(currentServer, { command: '', args: [], env: {} });
50
+ }
51
+ continue;
52
+ }
53
+
54
+ // Match [mcp_servers.<name>]
55
+ const serverMatch = line.match(/^\[mcp_servers\.([^.\]]+)\]$/);
56
+ if (serverMatch) {
57
+ currentServer = serverMatch[1];
58
+ isEnvBlock = false;
59
+ if (!serverMap.has(currentServer)) {
60
+ serverMap.set(currentServer, { command: '', args: [], env: {} });
61
+ }
62
+ continue;
63
+ }
64
+
65
+ // Any other section header resets context
66
+ if (line.startsWith('[')) {
67
+ currentServer = null;
68
+ isEnvBlock = false;
69
+ continue;
70
+ }
71
+
72
+ // Parse key = value within current server block
73
+ if (currentServer) {
74
+ const kvMatch = line.match(/^(\w+)\s*=\s*(.+)$/);
75
+ if (!kvMatch) continue;
76
+
77
+ const key = kvMatch[1];
78
+ const rawValue = kvMatch[2].trim();
79
+ const entry = serverMap.get(currentServer)!;
80
+
81
+ if (isEnvBlock) {
82
+ entry.env[key] = this.parseTomlString(rawValue);
83
+ } else if (key === 'command') {
84
+ entry.command = this.parseTomlString(rawValue);
85
+ } else if (key === 'args') {
86
+ entry.args = this.parseTomlArray(rawValue);
87
+ } else if (key === 'url') {
88
+ entry.url = this.parseTomlString(rawValue);
89
+ } else if (key === 'enabled') {
90
+ entry.enabled = rawValue === 'true';
91
+ }
92
+ }
93
+ }
94
+
95
+ for (const [name, entry] of serverMap) {
96
+ servers.push({
97
+ name,
98
+ command: entry.command,
99
+ args: entry.args,
100
+ ...(Object.keys(entry.env).length > 0 ? { env: entry.env } : {}),
101
+ ...(entry.url ? { url: entry.url } : {}),
102
+ });
103
+ }
104
+
105
+ return servers;
106
+ }
107
+
108
+ generate(servers: MCPServerEntry[]): string {
109
+ const blocks: string[] = [];
110
+
111
+ for (const s of servers) {
112
+ const lines: string[] = [];
113
+ lines.push(`[mcp_servers.${s.name}]`);
114
+
115
+ if (s.url) {
116
+ lines.push(`url = ${this.toTomlString(s.url)}`);
117
+ } else {
118
+ lines.push(`command = ${this.toTomlString(s.command)}`);
119
+ lines.push(`args = [${s.args.map((a) => this.toTomlString(a)).join(', ')}]`);
120
+ }
121
+
122
+ if (s.env && Object.keys(s.env).length > 0) {
123
+ lines.push('');
124
+ lines.push(`[mcp_servers.${s.name}.env]`);
125
+ for (const [key, value] of Object.entries(s.env)) {
126
+ lines.push(`${key} = ${this.toTomlString(value)}`);
127
+ }
128
+ }
129
+
130
+ blocks.push(lines.join('\n'));
131
+ }
132
+
133
+ return blocks.join('\n\n') + '\n';
134
+ }
135
+
136
+ getConfigPath(projectRoot?: string): string {
137
+ if (projectRoot) {
138
+ return join(projectRoot, '.codex', 'config.toml');
139
+ }
140
+ return join(homedir(), '.codex', 'config.toml');
141
+ }
142
+
143
+ // ---- TOML helpers ----
144
+
145
+ private parseTomlString(raw: string): string {
146
+ const trimmed = raw.trim();
147
+ if (
148
+ (trimmed.startsWith('"') && trimmed.endsWith('"')) ||
149
+ (trimmed.startsWith("'") && trimmed.endsWith("'"))
150
+ ) {
151
+ return trimmed.slice(1, -1);
152
+ }
153
+ return trimmed;
154
+ }
155
+
156
+ private parseTomlArray(raw: string): string[] {
157
+ const trimmed = raw.trim();
158
+ if (!trimmed.startsWith('[') || !trimmed.endsWith(']')) return [];
159
+ const inner = trimmed.slice(1, -1);
160
+ const result: string[] = [];
161
+ // Simple CSV parse respecting quotes
162
+ let current = '';
163
+ let inQuote = false;
164
+ let quoteChar = '';
165
+ for (const ch of inner) {
166
+ if (inQuote) {
167
+ if (ch === quoteChar) {
168
+ inQuote = false;
169
+ } else {
170
+ current += ch;
171
+ }
172
+ } else if (ch === '"' || ch === "'") {
173
+ inQuote = true;
174
+ quoteChar = ch;
175
+ } else if (ch === ',') {
176
+ const val = current.trim();
177
+ if (val) result.push(val);
178
+ current = '';
179
+ } else {
180
+ current += ch;
181
+ }
182
+ }
183
+ const last = current.trim();
184
+ if (last) result.push(last);
185
+ return result;
186
+ }
187
+
188
+ private toTomlString(value: string): string {
189
+ return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
190
+ }
191
+ }
@@ -1,105 +1,105 @@
1
- import type { MCPConfigAdapter, MCPServerEntry } from '../../types.js';
2
- import { homedir } from 'node:os';
3
- import { join } from 'node:path';
4
-
5
- /**
6
- * VS Code Copilot MCP config adapter.
7
- *
8
- * Supports two config locations / formats:
9
- *
10
- * 1. Workspace-level (preferred, new):
11
- * Path: .vscode/mcp.json
12
- * Format: { "servers": { [name]: { command, args, env?, url? } } }
13
- *
14
- * 2. Global (legacy, still scanned):
15
- * Path: %APPDATA%/Code/User/settings.json
16
- * Format: { "mcp": { "servers": { [name]: { command, args, env? } } } }
17
- *
18
- * parse() auto-detects which format is provided.
19
- * generate() always outputs the new .vscode/mcp.json format.
20
- * getConfigPath(projectRoot) returns workspace path; getConfigPath() returns global path.
21
- */
22
- export class CopilotMCPAdapter implements MCPConfigAdapter {
23
- readonly source = 'copilot' as const;
24
-
25
- parse(content: string): MCPServerEntry[] {
26
- try {
27
- const config = JSON.parse(content);
28
-
29
- // Auto-detect format:
30
- // 1. mcp.json format: { "servers": { ... } }
31
- // 2. settings.json format: { "mcp": { "servers": { ... } } }
32
- const servers = config?.servers ?? config?.mcp?.servers ?? {};
33
-
34
- return Object.entries(servers).map(([name, entry]: [string, any]) => {
35
- const result: MCPServerEntry = {
36
- name,
37
- command: entry.command ?? '',
38
- args: entry.args ?? [],
39
- };
40
-
41
- if (entry.type) {
42
- // VS Code mcp.json supports "type" field (e.g., "http", "stdio")
43
- // Map to url for HTTP types
44
- if ((entry.type === 'http' || entry.type === 'sse') && entry.url) {
45
- result.url = entry.url;
46
- }
47
- } else if (entry.url) {
48
- result.url = entry.url;
49
- }
50
-
51
- if (entry.env && typeof entry.env === 'object' && Object.keys(entry.env).length > 0) {
52
- result.env = entry.env;
53
- }
54
-
55
- if (entry.headers && typeof entry.headers === 'object' && Object.keys(entry.headers).length > 0) {
56
- result.headers = entry.headers;
57
- }
58
-
59
- return result;
60
- });
61
- } catch {
62
- return [];
63
- }
64
- }
65
-
66
- generate(servers: MCPServerEntry[]): string {
67
- const mcpServers: Record<string, any> = {};
68
- for (const s of servers) {
69
- const entry: Record<string, any> = {};
70
- if (s.url) {
71
- entry.type = 'http';
72
- entry.url = s.url;
73
- if (s.headers && Object.keys(s.headers).length > 0) {
74
- entry.headers = s.headers;
75
- }
76
- } else {
77
- entry.command = s.command;
78
- entry.args = s.args;
79
- }
80
- if (s.env && Object.keys(s.env).length > 0) {
81
- entry.env = s.env;
82
- }
83
- mcpServers[s.name] = entry;
84
- }
85
-
86
- // Output the new .vscode/mcp.json format: { "servers": { ... } }
87
- return JSON.stringify({ servers: mcpServers }, null, 2);
88
- }
89
-
90
- getConfigPath(projectRoot?: string): string {
91
- if (projectRoot) {
92
- // Workspace-level: .vscode/mcp.json (new official format)
93
- return join(projectRoot, '.vscode', 'mcp.json');
94
- }
95
- // Global: VS Code user settings path (legacy, for scan fallback)
96
- const home = homedir();
97
- if (process.platform === 'win32') {
98
- return join(home, 'AppData', 'Roaming', 'Code', 'User', 'settings.json');
99
- } else if (process.platform === 'darwin') {
100
- return join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json');
101
- } else {
102
- return join(home, '.config', 'Code', 'User', 'settings.json');
103
- }
104
- }
105
- }
1
+ import type { MCPConfigAdapter, MCPServerEntry } from '../../types.js';
2
+ import { homedir } from 'node:os';
3
+ import { join } from 'node:path';
4
+
5
+ /**
6
+ * VS Code Copilot MCP config adapter.
7
+ *
8
+ * Supports two config locations / formats:
9
+ *
10
+ * 1. Workspace-level (preferred, new):
11
+ * Path: .vscode/mcp.json
12
+ * Format: { "servers": { [name]: { command, args, env?, url? } } }
13
+ *
14
+ * 2. Global (legacy, still scanned):
15
+ * Path: %APPDATA%/Code/User/settings.json
16
+ * Format: { "mcp": { "servers": { [name]: { command, args, env? } } } }
17
+ *
18
+ * parse() auto-detects which format is provided.
19
+ * generate() always outputs the new .vscode/mcp.json format.
20
+ * getConfigPath(projectRoot) returns workspace path; getConfigPath() returns global path.
21
+ */
22
+ export class CopilotMCPAdapter implements MCPConfigAdapter {
23
+ readonly source = 'copilot' as const;
24
+
25
+ parse(content: string): MCPServerEntry[] {
26
+ try {
27
+ const config = JSON.parse(content);
28
+
29
+ // Auto-detect format:
30
+ // 1. mcp.json format: { "servers": { ... } }
31
+ // 2. settings.json format: { "mcp": { "servers": { ... } } }
32
+ const servers = config?.servers ?? config?.mcp?.servers ?? {};
33
+
34
+ return Object.entries(servers).map(([name, entry]: [string, any]) => {
35
+ const result: MCPServerEntry = {
36
+ name,
37
+ command: entry.command ?? '',
38
+ args: entry.args ?? [],
39
+ };
40
+
41
+ if (entry.type) {
42
+ // VS Code mcp.json supports "type" field (e.g., "http", "stdio")
43
+ // Map to url for HTTP types
44
+ if ((entry.type === 'http' || entry.type === 'sse') && entry.url) {
45
+ result.url = entry.url;
46
+ }
47
+ } else if (entry.url) {
48
+ result.url = entry.url;
49
+ }
50
+
51
+ if (entry.env && typeof entry.env === 'object' && Object.keys(entry.env).length > 0) {
52
+ result.env = entry.env;
53
+ }
54
+
55
+ if (entry.headers && typeof entry.headers === 'object' && Object.keys(entry.headers).length > 0) {
56
+ result.headers = entry.headers;
57
+ }
58
+
59
+ return result;
60
+ });
61
+ } catch {
62
+ return [];
63
+ }
64
+ }
65
+
66
+ generate(servers: MCPServerEntry[]): string {
67
+ const mcpServers: Record<string, any> = {};
68
+ for (const s of servers) {
69
+ const entry: Record<string, any> = {};
70
+ if (s.url) {
71
+ entry.type = 'http';
72
+ entry.url = s.url;
73
+ if (s.headers && Object.keys(s.headers).length > 0) {
74
+ entry.headers = s.headers;
75
+ }
76
+ } else {
77
+ entry.command = s.command;
78
+ entry.args = s.args;
79
+ }
80
+ if (s.env && Object.keys(s.env).length > 0) {
81
+ entry.env = s.env;
82
+ }
83
+ mcpServers[s.name] = entry;
84
+ }
85
+
86
+ // Output the new .vscode/mcp.json format: { "servers": { ... } }
87
+ return JSON.stringify({ servers: mcpServers }, null, 2);
88
+ }
89
+
90
+ getConfigPath(projectRoot?: string): string {
91
+ if (projectRoot) {
92
+ // Workspace-level: .vscode/mcp.json (new official format)
93
+ return join(projectRoot, '.vscode', 'mcp.json');
94
+ }
95
+ // Global: VS Code user settings path (legacy, for scan fallback)
96
+ const home = homedir();
97
+ if (process.platform === 'win32') {
98
+ return join(home, 'AppData', 'Roaming', 'Code', 'User', 'settings.json');
99
+ } else if (process.platform === 'darwin') {
100
+ return join(home, 'Library', 'Application Support', 'Code', 'User', 'settings.json');
101
+ } else {
102
+ return join(home, '.config', 'Code', 'User', 'settings.json');
103
+ }
104
+ }
105
+ }