memorix 1.2.0 → 1.2.2

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 (212) hide show
  1. package/CHANGELOG.md +30 -1
  2. package/README.md +18 -4
  3. package/README.zh-CN.md +18 -4
  4. package/TEAM.md +86 -86
  5. package/dist/cli/index.js +15919 -14055
  6. package/dist/cli/index.js.map +1 -1
  7. package/dist/index.js +1997 -1021
  8. package/dist/index.js.map +1 -1
  9. package/dist/maintenance-runner.d.ts +1 -1
  10. package/dist/maintenance-runner.js +8481 -8005
  11. package/dist/maintenance-runner.js.map +1 -1
  12. package/dist/memcode-runtime/CHANGELOG.md +30 -1
  13. package/dist/sdk.d.ts +7 -2
  14. package/dist/sdk.js +2022 -1024
  15. package/dist/sdk.js.map +1 -1
  16. package/dist/types.d.ts +49 -1
  17. package/dist/types.js.map +1 -1
  18. package/docs/1.2.2-MEMORY-CONTROL-PLANE.md +434 -0
  19. package/docs/AGENT_OPERATOR_PLAYBOOK.md +4 -0
  20. package/docs/API_REFERENCE.md +27 -5
  21. package/docs/DESIGN_DECISIONS.md +357 -357
  22. package/docs/DEVELOPMENT.md +4 -0
  23. package/docs/README.md +1 -1
  24. package/docs/SETUP.md +7 -1
  25. package/docs/dev-log/progress.txt +91 -11
  26. package/docs/knowledge/workflows/memorix-release.md +57 -0
  27. package/package.json +1 -1
  28. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  29. package/src/audit/index.ts +156 -156
  30. package/src/cli/command-guide.ts +192 -0
  31. package/src/cli/commands/audit-list.ts +89 -89
  32. package/src/cli/commands/audit.ts +9 -4
  33. package/src/cli/commands/background.ts +659 -659
  34. package/src/cli/commands/cleanup.ts +5 -1
  35. package/src/cli/commands/codegraph.ts +17 -8
  36. package/src/cli/commands/context.ts +3 -2
  37. package/src/cli/commands/doctor.ts +4 -2
  38. package/src/cli/commands/explain.ts +9 -3
  39. package/src/cli/commands/formation.ts +48 -48
  40. package/src/cli/commands/git-hook-install.ts +111 -111
  41. package/src/cli/commands/handoff.ts +75 -61
  42. package/src/cli/commands/hooks-status.ts +63 -63
  43. package/src/cli/commands/identity.ts +116 -0
  44. package/src/cli/commands/ingest-commit.ts +153 -153
  45. package/src/cli/commands/ingest-image.ts +71 -69
  46. package/src/cli/commands/ingest-log.ts +180 -180
  47. package/src/cli/commands/ingest.ts +44 -44
  48. package/src/cli/commands/integrate-shared.ts +15 -15
  49. package/src/cli/commands/knowledge.ts +40 -0
  50. package/src/cli/commands/lock.ts +93 -92
  51. package/src/cli/commands/memory.ts +58 -21
  52. package/src/cli/commands/message.ts +123 -118
  53. package/src/cli/commands/operator-shared.ts +98 -3
  54. package/src/cli/commands/poll.ts +74 -64
  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 +135 -121
  58. package/src/cli/commands/retention.ts +9 -4
  59. package/src/cli/commands/serve-http.ts +22 -43
  60. package/src/cli/commands/serve-shared.ts +118 -118
  61. package/src/cli/commands/session.ts +29 -3
  62. package/src/cli/commands/setup.ts +9 -3
  63. package/src/cli/commands/skills.ts +124 -119
  64. package/src/cli/commands/status.ts +4 -3
  65. package/src/cli/commands/task.ts +193 -184
  66. package/src/cli/commands/team.ts +14 -10
  67. package/src/cli/commands/transfer.ts +108 -55
  68. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  69. package/src/cli/identity.ts +89 -0
  70. package/src/cli/index.ts +96 -19
  71. package/src/cli/invocation.ts +115 -0
  72. package/src/cli/tui/ChatView.tsx +234 -234
  73. package/src/cli/tui/CommandBar.tsx +312 -312
  74. package/src/cli/tui/ContextRail.tsx +118 -118
  75. package/src/cli/tui/HeaderBar.tsx +72 -72
  76. package/src/cli/tui/LogoBanner.tsx +51 -51
  77. package/src/cli/tui/Sidebar.tsx +179 -179
  78. package/src/cli/tui/chat-service.ts +41 -18
  79. package/src/cli/tui/data.ts +23 -44
  80. package/src/cli/tui/index.ts +41 -41
  81. package/src/cli/tui/markdown-render.tsx +371 -371
  82. package/src/cli/tui/operator-context.ts +60 -0
  83. package/src/cli/tui/use-mouse.ts +157 -157
  84. package/src/cli/tui/useNavigation.ts +56 -56
  85. package/src/cli/tui/views/MemoryView.tsx +10 -8
  86. package/src/cli/update-checker.ts +211 -211
  87. package/src/cli/version.ts +7 -7
  88. package/src/cli/workbench.ts +1 -1
  89. package/src/codegraph/auto-context.ts +34 -17
  90. package/src/codegraph/context-pack.ts +1 -0
  91. package/src/codegraph/current-facts.ts +19 -1
  92. package/src/codegraph/project-context.ts +2 -0
  93. package/src/codegraph/task-lens.ts +49 -5
  94. package/src/compact/engine.ts +26 -10
  95. package/src/compact/index-format.ts +25 -2
  96. package/src/compact/token-budget.ts +74 -74
  97. package/src/dashboard/project-classification.ts +64 -64
  98. package/src/dashboard/server.ts +58 -52
  99. package/src/embedding/fastembed-provider.ts +142 -142
  100. package/src/embedding/transformers-provider.ts +111 -111
  101. package/src/git/extractor.ts +209 -209
  102. package/src/git/hooks-path.ts +85 -85
  103. package/src/hooks/admission.ts +117 -0
  104. package/src/hooks/handler.ts +98 -91
  105. package/src/hooks/pattern-detector.ts +173 -173
  106. package/src/hooks/significance-filter.ts +250 -250
  107. package/src/knowledge/claims.ts +51 -1
  108. package/src/knowledge/context-assembly.ts +97 -0
  109. package/src/knowledge/types.ts +1 -0
  110. package/src/knowledge/workflows.ts +34 -3
  111. package/src/knowledge/workset.ts +179 -10
  112. package/src/llm/memory-manager.ts +328 -328
  113. package/src/llm/provider.ts +885 -885
  114. package/src/llm/quality.ts +248 -248
  115. package/src/memory/admission.ts +57 -0
  116. package/src/memory/attribution-guard.ts +249 -249
  117. package/src/memory/auto-relations.ts +21 -0
  118. package/src/memory/consolidation.ts +13 -2
  119. package/src/memory/disclosure-policy.ts +140 -135
  120. package/src/memory/entity-extractor.ts +197 -197
  121. package/src/memory/export-import.ts +11 -3
  122. package/src/memory/formation/evaluate.ts +217 -217
  123. package/src/memory/formation/extract.ts +361 -361
  124. package/src/memory/formation/index.ts +417 -417
  125. package/src/memory/formation/resolve.ts +344 -344
  126. package/src/memory/formation/types.ts +315 -315
  127. package/src/memory/freshness.ts +122 -122
  128. package/src/memory/graph-context.ts +8 -2
  129. package/src/memory/graph-scope.ts +46 -0
  130. package/src/memory/graph.ts +197 -197
  131. package/src/memory/observations.ts +162 -4
  132. package/src/memory/quality-audit.ts +2 -0
  133. package/src/memory/refs.ts +94 -94
  134. package/src/memory/retention.ts +22 -2
  135. package/src/memory/secret-filter.ts +79 -79
  136. package/src/memory/session.ts +5 -2
  137. package/src/memory/visibility.ts +80 -0
  138. package/src/multimodal/image-loader.ts +143 -143
  139. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  140. package/src/orchestrate/adapters/claude.ts +111 -111
  141. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  142. package/src/orchestrate/adapters/codex.ts +41 -41
  143. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  144. package/src/orchestrate/adapters/gemini.ts +42 -42
  145. package/src/orchestrate/adapters/index.ts +73 -73
  146. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  147. package/src/orchestrate/adapters/opencode.ts +47 -47
  148. package/src/orchestrate/adapters/spawn-helper.ts +286 -286
  149. package/src/orchestrate/adapters/types.ts +77 -77
  150. package/src/orchestrate/capability-router.ts +284 -284
  151. package/src/orchestrate/context-compact.ts +188 -188
  152. package/src/orchestrate/cost-tracker.ts +219 -219
  153. package/src/orchestrate/error-recovery.ts +191 -191
  154. package/src/orchestrate/evidence.ts +140 -140
  155. package/src/orchestrate/ledger.ts +110 -110
  156. package/src/orchestrate/memorix-bridge.ts +378 -340
  157. package/src/orchestrate/output-budget.ts +80 -80
  158. package/src/orchestrate/permission.ts +152 -152
  159. package/src/orchestrate/pipeline-trace.ts +131 -131
  160. package/src/orchestrate/prompt-builder.ts +155 -155
  161. package/src/orchestrate/ring-buffer.ts +37 -37
  162. package/src/orchestrate/task-graph.ts +389 -389
  163. package/src/orchestrate/verify-gate.ts +33 -10
  164. package/src/orchestrate/worktree.ts +232 -232
  165. package/src/project/aliases.ts +374 -374
  166. package/src/project/detector.ts +268 -268
  167. package/src/rules/adapters/claude-code.ts +99 -99
  168. package/src/rules/adapters/codex.ts +97 -97
  169. package/src/rules/adapters/copilot.ts +124 -124
  170. package/src/rules/adapters/cursor.ts +114 -114
  171. package/src/rules/adapters/kiro.ts +126 -126
  172. package/src/rules/adapters/trae.ts +56 -56
  173. package/src/rules/adapters/windsurf.ts +83 -83
  174. package/src/rules/syncer.ts +235 -235
  175. package/src/runtime/control-plane-maintenance.ts +1 -0
  176. package/src/runtime/isolated-maintenance.ts +1 -0
  177. package/src/runtime/lifecycle.ts +18 -0
  178. package/src/runtime/maintenance-jobs.ts +1 -0
  179. package/src/runtime/maintenance-runner.ts +2 -0
  180. package/src/runtime/project-maintenance.ts +89 -0
  181. package/src/sdk.ts +334 -304
  182. package/src/search/intent-detector.ts +289 -289
  183. package/src/search/query-expansion.ts +52 -52
  184. package/src/server/formation-timeout.ts +27 -27
  185. package/src/server.ts +334 -93
  186. package/src/skills/mini-skills.ts +386 -386
  187. package/src/store/chat-store.ts +119 -119
  188. package/src/store/graph-store.ts +249 -249
  189. package/src/store/mini-skill-store.ts +349 -349
  190. package/src/store/orama-store.ts +61 -6
  191. package/src/store/persistence-json.ts +212 -212
  192. package/src/store/persistence.ts +291 -291
  193. package/src/store/project-affinity.ts +195 -195
  194. package/src/store/sqlite-db.ts +23 -1
  195. package/src/store/sqlite-store.ts +12 -2
  196. package/src/team/event-bus.ts +76 -76
  197. package/src/team/file-locks.ts +173 -173
  198. package/src/team/handoff.ts +168 -161
  199. package/src/team/messages.ts +203 -203
  200. package/src/team/poll.ts +132 -132
  201. package/src/team/tasks.ts +211 -211
  202. package/src/types.ts +51 -0
  203. package/src/wiki/generator.ts +2 -0
  204. package/src/workspace/mcp-adapters/codex.ts +191 -191
  205. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  206. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  207. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  208. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  209. package/src/workspace/mcp-adapters/trae.ts +134 -134
  210. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  211. package/src/workspace/sanitizer.ts +60 -60
  212. package/src/workspace/workflow-sync.ts +131 -131
@@ -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
+ }