memorix 1.4.3 → 1.4.4

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 (144) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +11 -4
  3. package/README.zh-CN.md +7 -1
  4. package/TEAM.md +86 -86
  5. package/assets/star-history-dark.svg +8 -8
  6. package/assets/star-history-light.svg +8 -8
  7. package/assets/star-history.json +16 -2
  8. package/dist/cli/index.js +194 -109
  9. package/dist/cli/memcode.js +0 -0
  10. package/dist/index.js +39 -12
  11. package/dist/maintenance-runner.js +9 -7
  12. package/dist/media-audio-runner.js +9 -7
  13. package/dist/media-video-runner.js +9 -7
  14. package/dist/memcode/index.js +9 -7
  15. package/dist/memcode-runtime/CHANGELOG.md +19 -0
  16. package/dist/sdk.js +38 -11
  17. package/dist/vector-backfill-runner.js +9 -7
  18. package/docs/AGENT_OPERATOR_PLAYBOOK.md +3 -3
  19. package/docs/API_REFERENCE.md +9 -5
  20. package/docs/CONFIGURATION.md +15 -5
  21. package/docs/DESIGN_DECISIONS.md +357 -357
  22. package/docs/DEVELOPMENT.md +2 -2
  23. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +3 -3
  24. package/docs/MODULES.md +1 -1
  25. package/docs/README.md +1 -1
  26. package/docs/SETUP.md +3 -3
  27. package/docs/hooks-architecture.md +2 -1
  28. package/llms-full.txt +4 -4
  29. package/llms.txt +2 -2
  30. package/package.json +1 -1
  31. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  32. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  33. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  34. package/plugins/copilot/memorix/plugin.json +1 -1
  35. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  36. package/plugins/omp/memorix/package.json +1 -1
  37. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  38. package/plugins/pi/memorix/package.json +1 -1
  39. package/server.json +2 -2
  40. package/src/audit/index.ts +156 -156
  41. package/src/cli/commands/audit-list.ts +89 -89
  42. package/src/cli/commands/formation.ts +48 -48
  43. package/src/cli/commands/git-hook-install.ts +111 -111
  44. package/src/cli/commands/handoff.ts +54 -54
  45. package/src/cli/commands/hooks-status.ts +63 -63
  46. package/src/cli/commands/ingest.ts +44 -44
  47. package/src/cli/commands/integrate-shared.ts +15 -15
  48. package/src/cli/commands/lock.ts +82 -82
  49. package/src/cli/commands/media-image.ts +27 -0
  50. package/src/cli/commands/media.ts +8 -1
  51. package/src/cli/commands/memory.ts +44 -34
  52. package/src/cli/commands/message.ts +104 -104
  53. package/src/cli/commands/operator-shared.ts +62 -18
  54. package/src/cli/commands/poll.ts +58 -58
  55. package/src/cli/commands/purge-all-memory.ts +85 -85
  56. package/src/cli/commands/purge-project-memory.ts +83 -83
  57. package/src/cli/commands/reasoning.ts +118 -118
  58. package/src/cli/commands/skills.ts +114 -114
  59. package/src/cli/commands/task.ts +167 -167
  60. package/src/cli/commands/transfer.ts +47 -47
  61. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  62. package/src/cli/tui/ChatView.tsx +234 -234
  63. package/src/cli/tui/CommandBar.tsx +312 -312
  64. package/src/cli/tui/ContextRail.tsx +118 -118
  65. package/src/cli/tui/HeaderBar.tsx +72 -72
  66. package/src/cli/tui/LogoBanner.tsx +51 -51
  67. package/src/cli/tui/Sidebar.tsx +179 -179
  68. package/src/cli/tui/index.ts +41 -41
  69. package/src/cli/tui/markdown-render.tsx +371 -371
  70. package/src/cli/tui/use-mouse.ts +157 -157
  71. package/src/cli/tui/useNavigation.ts +56 -56
  72. package/src/cli/version.ts +7 -7
  73. package/src/cli/workbench.ts +1 -1
  74. package/src/dashboard/project-classification.ts +64 -64
  75. package/src/git/hooks-path.ts +85 -85
  76. package/src/hooks/pattern-detector.ts +173 -173
  77. package/src/hooks/significance-filter.ts +250 -250
  78. package/src/llm/memory-manager.ts +328 -328
  79. package/src/llm/provider.ts +885 -885
  80. package/src/llm/quality.ts +248 -248
  81. package/src/media/minimax.ts +9 -1
  82. package/src/memory/attribution-guard.ts +249 -249
  83. package/src/memory/disclosure-policy.ts +135 -135
  84. package/src/memory/entity-extractor.ts +197 -197
  85. package/src/memory/formation/evaluate.ts +217 -217
  86. package/src/memory/formation/extract.ts +361 -361
  87. package/src/memory/formation/index.ts +417 -417
  88. package/src/memory/formation/resolve.ts +344 -344
  89. package/src/memory/formation/types.ts +315 -315
  90. package/src/memory/freshness.ts +122 -122
  91. package/src/memory/graph.ts +197 -197
  92. package/src/memory/refs.ts +94 -94
  93. package/src/memory/secret-filter.ts +79 -79
  94. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  95. package/src/orchestrate/adapters/claude.ts +111 -111
  96. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  97. package/src/orchestrate/adapters/codex.ts +41 -41
  98. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  99. package/src/orchestrate/adapters/gemini.ts +42 -42
  100. package/src/orchestrate/adapters/index.ts +73 -73
  101. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  102. package/src/orchestrate/adapters/opencode.ts +47 -47
  103. package/src/orchestrate/adapters/types.ts +77 -77
  104. package/src/orchestrate/capability-router.ts +284 -284
  105. package/src/orchestrate/context-compact.ts +188 -188
  106. package/src/orchestrate/cost-tracker.ts +219 -219
  107. package/src/orchestrate/error-recovery.ts +191 -191
  108. package/src/orchestrate/evidence.ts +140 -140
  109. package/src/orchestrate/ledger.ts +110 -110
  110. package/src/orchestrate/memorix-bridge.ts +343 -343
  111. package/src/orchestrate/output-budget.ts +80 -80
  112. package/src/orchestrate/permission.ts +152 -152
  113. package/src/orchestrate/pipeline-trace.ts +131 -131
  114. package/src/orchestrate/prompt-builder.ts +155 -155
  115. package/src/orchestrate/ring-buffer.ts +37 -37
  116. package/src/orchestrate/task-graph.ts +389 -389
  117. package/src/project/aliases.ts +374 -374
  118. package/src/rules/adapters/trae.ts +56 -56
  119. package/src/rules/syncer.ts +235 -235
  120. package/src/search/query-expansion.ts +52 -52
  121. package/src/server/formation-timeout.ts +27 -27
  122. package/src/server.ts +23 -1
  123. package/src/skills/mini-skills.ts +386 -386
  124. package/src/store/chat-store.ts +119 -119
  125. package/src/store/graph-store.ts +249 -249
  126. package/src/store/mini-skill-store.ts +349 -349
  127. package/src/store/persistence-json.ts +212 -212
  128. package/src/store/persistence.ts +291 -291
  129. package/src/store/project-affinity.ts +195 -195
  130. package/src/team/event-bus.ts +76 -76
  131. package/src/team/file-locks.ts +173 -173
  132. package/src/team/handoff.ts +161 -161
  133. package/src/team/messages.ts +203 -203
  134. package/src/team/poll.ts +132 -132
  135. package/src/team/tasks.ts +211 -211
  136. package/src/workspace/mcp-adapters/codex.ts +191 -191
  137. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  138. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  139. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  140. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  141. package/src/workspace/mcp-adapters/trae.ts +134 -134
  142. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  143. package/src/workspace/sanitizer.ts +60 -60
  144. package/dist/memcode-runtime/docs/images/exy.png +0 -0
@@ -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
+ }