archgen-mcp 0.0.6 → 0.1.0

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 (59) hide show
  1. package/README.md +14 -9
  2. package/assets/briefs/investigate.md +16 -17
  3. package/assets/briefs/review.md +41 -29
  4. package/assets/briefs/survey.md +17 -20
  5. package/assets/briefs/verifier.md +52 -40
  6. package/assets/harness-mcp.json +285 -55
  7. package/assets/platform-capabilities.json +387 -71
  8. package/assets/references/artifact-templates.md +68 -219
  9. package/assets/references/interview.md +83 -199
  10. package/assets/references/mcp-and-skills.md +35 -125
  11. package/assets/references/orchestration.md +96 -209
  12. package/assets/references/platforms.md +41 -108
  13. package/assets/skill-registry.json +10 -1
  14. package/assets/templates/adr.md +3 -3
  15. package/assets/templates/architecture.yaml +31 -28
  16. package/assets/templates/edge-matrix.md +8 -8
  17. package/assets/templates/mermaid.md +3 -10
  18. package/assets/templates/prd.md +15 -15
  19. package/assets/templates/tasks.yaml +25 -18
  20. package/bin/archgen-mcp.mjs +6 -4
  21. package/package.json +2 -2
  22. package/src/cli.mjs +1 -2
  23. package/src/context.mjs +55 -45
  24. package/src/core/brief-context.mjs +106 -0
  25. package/src/core/brief-scope.mjs +218 -0
  26. package/src/core/briefs.mjs +121 -0
  27. package/src/core/codegraph-manager.mjs +124 -48
  28. package/src/core/compat.mjs +13 -3
  29. package/src/core/doc-navigator.mjs +127 -24
  30. package/src/core/errors.mjs +1 -1
  31. package/src/core/fs-safety.mjs +98 -10
  32. package/src/core/graph.mjs +8 -3
  33. package/src/core/harness-wiring.mjs +194 -37
  34. package/src/core/jsonc-config.mjs +706 -0
  35. package/src/core/mcp-server-manager.mjs +2 -3
  36. package/src/core/plan-coverage.mjs +43 -6
  37. package/src/core/plan-grapher.mjs +13 -5
  38. package/src/core/platform-caps.mjs +9 -2
  39. package/src/core/resume-snapshot.mjs +16 -4
  40. package/src/core/scope.mjs +39 -5
  41. package/src/core/skill-manager.mjs +181 -13
  42. package/src/core/skill-roots.mjs +92 -0
  43. package/src/core/status-mutator.mjs +34 -3
  44. package/src/core/tokens.mjs +78 -0
  45. package/src/core/validator.mjs +16 -3
  46. package/src/core/verifier.mjs +3 -9
  47. package/src/core/worker-contract.mjs +161 -20
  48. package/src/core/yaml.mjs +31 -6
  49. package/src/server.mjs +0 -3
  50. package/src/tools/_register.mjs +5 -4
  51. package/src/tools/codegraph.mjs +0 -2
  52. package/src/tools/docs.mjs +6 -6
  53. package/src/tools/help.mjs +18 -35
  54. package/src/tools/plan.mjs +58 -7
  55. package/src/tools/setup.mjs +7 -3
  56. package/src/tools/skills.mjs +67 -5
  57. package/src/tools/tasks.mjs +82 -23
  58. package/src/core/ui-channel.mjs +0 -171
  59. package/src/tools/ui.mjs +0 -67
package/assets/harness-mcp.json CHANGED
@@ -15,7 +15,7 @@
15
15
  "mcp (opencode), context_servers (zed). Codex CLI uses TOML ([mcp_servers.<id>]).",
16
16
  "",
17
17
  "COMMAND SHAPE: the server entries below are the ones the official installers",
18
- "write — keep them byte-compatible, or the MCP server never connects.",
18
+ "write \u2014 keep them byte-compatible, or the MCP server never connects.",
19
19
  "The CodeGraph server also runs a FILE WATCHER, so the index stays live after",
20
20
  "the one-time init; nothing is re-indexed by hand.",
21
21
  "",
@@ -25,135 +25,365 @@
25
25
  ],
26
26
  "package": "@colbymchenry/codegraph",
27
27
  "entries": {
28
- "stdio": { "type": "stdio", "command": "codegraph", "args": ["serve", "--mcp"] },
29
- "stdioNoType": { "command": "codegraph", "args": ["serve", "--mcp"] },
30
- "opencodeLocal": { "type": "local", "command": ["codegraph", "serve", "--mcp"], "enabled": true }
28
+ "stdio": {
29
+ "type": "stdio",
30
+ "command": "codegraph",
31
+ "args": [
32
+ "serve",
33
+ "--mcp"
34
+ ]
35
+ },
36
+ "stdioNoType": {
37
+ "command": "codegraph",
38
+ "args": [
39
+ "serve",
40
+ "--mcp"
41
+ ]
42
+ },
43
+ "opencodeLocal": {
44
+ "type": "local",
45
+ "command": [
46
+ "codegraph",
47
+ "serve",
48
+ "--mcp"
49
+ ],
50
+ "disabled": false
51
+ }
31
52
  },
32
53
  "npxEntries": {
33
- "stdio": { "type": "stdio", "command": "npx", "args": ["-y", "@colbymchenry/codegraph", "serve", "--mcp"] },
34
- "stdioNoType": { "command": "npx", "args": ["-y", "@colbymchenry/codegraph", "serve", "--mcp"] },
35
- "opencodeLocal": { "type": "local", "command": ["npx", "-y", "@colbymchenry/codegraph", "serve", "--mcp"], "enabled": true }
54
+ "stdio": {
55
+ "type": "stdio",
56
+ "command": "npx",
57
+ "args": [
58
+ "-y",
59
+ "@colbymchenry/codegraph",
60
+ "serve",
61
+ "--mcp"
62
+ ]
63
+ },
64
+ "stdioNoType": {
65
+ "command": "npx",
66
+ "args": [
67
+ "-y",
68
+ "@colbymchenry/codegraph",
69
+ "serve",
70
+ "--mcp"
71
+ ]
72
+ },
73
+ "opencodeLocal": {
74
+ "type": "local",
75
+ "command": [
76
+ "npx",
77
+ "-y",
78
+ "@colbymchenry/codegraph",
79
+ "serve",
80
+ "--mcp"
81
+ ],
82
+ "disabled": false
83
+ }
36
84
  },
37
85
  "archgenPackage": "archgen-mcp",
38
86
  "archgenEntries": {
39
- "stdio": { "type": "stdio", "command": "archgen-mcp", "args": [] },
40
- "stdioNoType": { "command": "archgen-mcp", "args": [] },
41
- "opencodeLocal": { "type": "local", "command": ["archgen-mcp"], "enabled": true }
87
+ "stdio": {
88
+ "type": "stdio",
89
+ "command": "archgen-mcp",
90
+ "args": []
91
+ },
92
+ "stdioNoType": {
93
+ "command": "archgen-mcp",
94
+ "args": []
95
+ },
96
+ "opencodeLocal": {
97
+ "type": "local",
98
+ "command": [
99
+ "archgen-mcp"
100
+ ],
101
+ "disabled": false
102
+ }
42
103
  },
43
104
  "archgenNpxEntries": {
44
- "stdio": { "type": "stdio", "command": "npx", "args": ["-y", "archgen-mcp"] },
45
- "stdioNoType": { "command": "npx", "args": ["-y", "archgen-mcp"] },
46
- "opencodeLocal": { "type": "local", "command": ["npx", "-y", "archgen-mcp"], "enabled": true }
105
+ "stdio": {
106
+ "type": "stdio",
107
+ "command": "npx",
108
+ "args": [
109
+ "-y",
110
+ "archgen-mcp"
111
+ ]
112
+ },
113
+ "stdioNoType": {
114
+ "command": "npx",
115
+ "args": [
116
+ "-y",
117
+ "archgen-mcp"
118
+ ]
119
+ },
120
+ "opencodeLocal": {
121
+ "type": "local",
122
+ "command": [
123
+ "npx",
124
+ "-y",
125
+ "archgen-mcp"
126
+ ],
127
+ "disabled": false
128
+ }
47
129
  },
48
130
  "harnesses": {
49
131
  "claude": {
50
132
  "label": "Claude Code",
51
133
  "codegraphTarget": "claude",
52
- "detectHome": [".claude", ".claude.json"],
53
- "detectProject": [".claude", ".mcp.json"],
134
+ "detectHome": [
135
+ ".claude",
136
+ ".claude.json"
137
+ ],
138
+ "detectProject": [
139
+ ".claude",
140
+ ".mcp.json"
141
+ ],
54
142
  "configs": {
55
- "global": { "path": "~/.claude.json", "key": "mcpServers", "entry": "stdio" },
56
- "project": { "path": ".mcp.json", "key": "mcpServers", "entry": "stdio" }
143
+ "global": {
144
+ "path": "~/.claude.json",
145
+ "format": "json",
146
+ "key": "mcpServers",
147
+ "entry": "stdio"
148
+ },
149
+ "project": {
150
+ "path": ".mcp.json",
151
+ "format": "json",
152
+ "key": "mcpServers",
153
+ "entry": "stdio"
154
+ }
57
155
  }
58
156
  },
59
157
  "cursor": {
60
158
  "label": "Cursor",
61
159
  "codegraphTarget": "cursor",
62
- "detectHome": [".cursor"],
63
- "detectProject": [".cursor"],
160
+ "detectHome": [
161
+ ".cursor"
162
+ ],
163
+ "detectProject": [
164
+ ".cursor"
165
+ ],
64
166
  "configs": {
65
- "global": { "path": "~/.cursor/mcp.json", "key": "mcpServers", "entry": "stdio" },
66
- "project": { "path": ".cursor/mcp.json", "key": "mcpServers", "entry": "stdio" }
167
+ "global": {
168
+ "path": "~/.cursor/mcp.json",
169
+ "format": "json",
170
+ "key": "mcpServers",
171
+ "entry": "stdio"
172
+ },
173
+ "project": {
174
+ "path": ".cursor/mcp.json",
175
+ "format": "json",
176
+ "key": "mcpServers",
177
+ "entry": "stdio"
178
+ }
67
179
  }
68
180
  },
69
181
  "opencode": {
70
182
  "label": "OpenCode",
71
183
  "codegraphTarget": "opencode",
72
- "detectHome": [".config/opencode"],
73
- "detectProject": [".opencode", "opencode.json", "opencode.jsonc"],
74
- "_note": "OpenCode's global config is JSONC (opencode.jsonc) — codegraph's own installer writes it correctly; our writer refuses non-JSON files on purpose, so this entry is a fallback only.",
184
+ "detectHome": [
185
+ ".config/opencode"
186
+ ],
187
+ "detectProject": [
188
+ ".opencode",
189
+ "opencode.json",
190
+ "opencode.jsonc"
191
+ ],
192
+ "_note": "OpenCode's global config is JSONC (opencode.jsonc) \u2014 codegraph's own installer writes it correctly; our writer refuses non-JSON files on purpose, so this entry is a fallback only.",
75
193
  "configs": {
76
- "global": { "path": "~/.config/opencode/opencode.json", "key": "mcp", "entry": "opencodeLocal" },
77
- "project": { "path": "opencode.json", "key": "mcp", "entry": "opencodeLocal" }
194
+ "global": {
195
+ "path": "~/.config/opencode/opencode.json",
196
+ "format": "json",
197
+ "key": "mcp.servers",
198
+ "entry": "opencodeLocal"
199
+ },
200
+ "project": {
201
+ "path": "opencode.json",
202
+ "format": "json",
203
+ "key": "mcp.servers",
204
+ "entry": "opencodeLocal"
205
+ }
78
206
  }
79
207
  },
80
208
  "codex": {
81
209
  "label": "Codex CLI",
82
210
  "codegraphTarget": "codex",
83
- "detectHome": [".codex"],
84
- "detectProject": [".codex"],
211
+ "detectHome": [
212
+ ".codex"
213
+ ],
214
+ "detectProject": [
215
+ ".codex"
216
+ ],
85
217
  "configs": {
86
- "global": { "path": "~/.codex/config.toml", "format": "toml", "key": "mcp_servers.codegraph", "entry": "toml" },
87
- "project": { "path": ".codex/config.toml", "format": "toml", "key": "mcp_servers.codegraph", "entry": "toml" }
218
+ "global": {
219
+ "path": "~/.codex/config.toml",
220
+ "format": "toml",
221
+ "entry": "stdioNoType"
222
+ },
223
+ "project": {
224
+ "path": ".codex/config.toml",
225
+ "format": "toml",
226
+ "entry": "stdioNoType"
227
+ }
88
228
  }
89
229
  },
90
230
  "gemini": {
91
231
  "label": "Gemini CLI",
92
232
  "codegraphTarget": "gemini",
93
- "detectHome": [".gemini"],
94
- "detectProject": [".gemini"],
233
+ "detectHome": [
234
+ ".gemini"
235
+ ],
236
+ "detectProject": [
237
+ ".gemini"
238
+ ],
95
239
  "configs": {
96
- "global": { "path": "~/.gemini/settings.json", "key": "mcpServers", "entry": "stdio" },
97
- "project": { "path": ".gemini/settings.json", "key": "mcpServers", "entry": "stdio" }
240
+ "global": {
241
+ "path": "~/.gemini/settings.json",
242
+ "format": "json",
243
+ "key": "mcpServers",
244
+ "entry": "stdio"
245
+ },
246
+ "project": {
247
+ "path": ".gemini/settings.json",
248
+ "format": "json",
249
+ "key": "mcpServers",
250
+ "entry": "stdio"
251
+ }
98
252
  }
99
253
  },
100
254
  "antigravity": {
101
255
  "label": "Antigravity",
102
256
  "codegraphTarget": "antigravity",
103
- "detectHome": [".gemini/config"],
104
- "detectProject": [".agents/mcp_config.json"],
257
+ "detectHome": [
258
+ ".gemini/config"
259
+ ],
260
+ "detectProject": [
261
+ ".agents/mcp_config.json"
262
+ ],
105
263
  "configs": {
106
- "global": { "path": "~/.gemini/config/mcp_config.json", "key": "mcpServers", "entry": "stdio" },
107
- "project": { "path": ".agents/mcp_config.json", "key": "mcpServers", "entry": "stdio" }
264
+ "global": {
265
+ "path": "~/.gemini/config/mcp_config.json",
266
+ "format": "json",
267
+ "key": "mcpServers",
268
+ "entry": "stdio"
269
+ },
270
+ "project": {
271
+ "path": ".agents/mcp_config.json",
272
+ "format": "json",
273
+ "key": "mcpServers",
274
+ "entry": "stdio"
275
+ }
108
276
  }
109
277
  },
110
278
  "kiro": {
111
279
  "label": "Kiro",
112
280
  "codegraphTarget": "kiro",
113
- "detectHome": [".kiro"],
114
- "detectProject": [".kiro"],
281
+ "detectHome": [
282
+ ".kiro"
283
+ ],
284
+ "detectProject": [
285
+ ".kiro"
286
+ ],
115
287
  "configs": {
116
- "global": { "path": "~/.kiro/settings/mcp.json", "key": "mcpServers", "entry": "stdioNoType" },
117
- "project": { "path": ".kiro/settings/mcp.json", "key": "mcpServers", "entry": "stdioNoType" }
288
+ "global": {
289
+ "path": "~/.kiro/settings/mcp.json",
290
+ "format": "json",
291
+ "key": "mcpServers",
292
+ "entry": "stdioNoType"
293
+ },
294
+ "project": {
295
+ "path": ".kiro/settings/mcp.json",
296
+ "format": "json",
297
+ "key": "mcpServers",
298
+ "entry": "stdioNoType"
299
+ }
118
300
  }
119
301
  },
120
302
  "windsurf": {
121
303
  "label": "Windsurf",
122
304
  "codegraphTarget": null,
123
- "detectHome": [".codeium/windsurf"],
124
- "detectProject": [".windsurf"],
305
+ "detectHome": [
306
+ ".codeium/windsurf"
307
+ ],
308
+ "detectProject": [
309
+ ".windsurf"
310
+ ],
125
311
  "configs": {
126
- "global": { "path": "~/.codeium/windsurf/mcp_config.json", "key": "mcpServers", "entry": "stdioNoType" }
312
+ "global": {
313
+ "path": "~/.codeium/windsurf/mcp_config.json",
314
+ "format": "json",
315
+ "key": "mcpServers",
316
+ "entry": "stdioNoType"
317
+ }
127
318
  }
128
319
  },
129
320
  "vscode": {
130
321
  "label": "VS Code / Copilot",
131
322
  "codegraphTarget": null,
132
323
  "detectHome": [],
133
- "detectProject": [".vscode", ".github/copilot-instructions.md"],
324
+ "detectProject": [
325
+ ".vscode",
326
+ ".github/copilot-instructions.md"
327
+ ],
134
328
  "configs": {
135
- "project": { "path": ".vscode/mcp.json", "key": "servers", "entry": "stdio" }
329
+ "project": {
330
+ "path": ".vscode/mcp.json",
331
+ "format": "json",
332
+ "key": "servers",
333
+ "entry": "stdio"
334
+ }
136
335
  }
137
336
  },
138
337
  "zed": {
139
338
  "label": "Zed",
140
339
  "codegraphTarget": null,
141
- "detectHome": [".config/zed"],
142
- "detectProject": [".zed"],
340
+ "detectHome": [
341
+ ".config/zed"
342
+ ],
343
+ "detectProject": [
344
+ ".zed"
345
+ ],
143
346
  "configs": {
144
- "global": { "path": "~/.config/zed/settings.json", "key": "context_servers", "entry": "stdioNoType" },
145
- "project": { "path": ".zed/settings.json", "key": "context_servers", "entry": "stdioNoType" }
347
+ "global": {
348
+ "path": "~/.config/zed/settings.json",
349
+ "format": "json",
350
+ "key": "context_servers",
351
+ "entry": "stdioNoType"
352
+ },
353
+ "project": {
354
+ "path": ".zed/settings.json",
355
+ "format": "json",
356
+ "key": "context_servers",
357
+ "entry": "stdioNoType"
358
+ }
146
359
  }
147
360
  },
148
361
  "trae": {
149
362
  "label": "Trae",
150
363
  "codegraphTarget": null,
151
- "detectHome": [".trae"],
152
- "detectProject": [".trae"],
364
+ "detectHome": [
365
+ ".trae"
366
+ ],
367
+ "detectProject": [
368
+ ".trae"
369
+ ],
153
370
  "configs": {
154
- "project": { "path": ".trae/mcp.json", "key": "mcpServers", "entry": "stdioNoType" }
371
+ "project": {
372
+ "path": ".trae/mcp.json",
373
+ "format": "json",
374
+ "key": "mcpServers",
375
+ "entry": "stdioNoType"
376
+ }
155
377
  }
156
378
  }
157
379
  },
158
- "codegraphNativeTargets": ["claude", "cursor", "opencode", "codex", "gemini", "antigravity", "kiro"]
380
+ "codegraphNativeTargets": [
381
+ "claude",
382
+ "cursor",
383
+ "opencode",
384
+ "codex",
385
+ "gemini",
386
+ "antigravity",
387
+ "kiro"
388
+ ]
159
389
  }