@henols/vice-mcp 1.0.0 → 1.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 (28) hide show
  1. package/THIRD-PARTY-NOTICES.md +6 -4
  2. package/anno-cli.ts +1 -1
  3. package/anno-store.ts +1 -1
  4. package/backend-detect.mts +143 -19
  5. package/build.ts +42 -1
  6. package/evid-ingest.ts +7 -3
  7. package/host-tool-client.ts +7 -3
  8. package/package.json +3 -1
  9. package/prerequisites.json +416 -0
  10. package/prg-image.ts +1 -1
  11. package/repo-root.ts +19 -8
  12. package/resources/backend-detect.mjs +90 -18
  13. package/resources/broker-launch.mjs +11 -2
  14. package/resources/ghidra-project.mjs +2 -2
  15. package/resources/host-tool.mjs +306 -82
  16. package/resources/prerequisites.json +416 -0
  17. package/resources/tool-location.mjs +750 -0
  18. package/resources/vice-broker.mjs +85 -12
  19. package/stock-checkpoints.ts +2 -2
  20. package/stock-connect.ts +12 -10
  21. package/stock-execution.ts +4 -2
  22. package/stock-memory-search.ts +3 -2
  23. package/stock-protocol.ts +60 -28
  24. package/stock-registers.ts +3 -1
  25. package/text-protocol.ts +6 -3
  26. package/textmon-profile.ts +8 -3
  27. package/version.ts +34 -246
  28. package/vice-proxy.ts +23 -23
package/resources/prerequisites.json ADDED
@@ -0,0 +1,416 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "tools": {
4
+ "x64sc": {
5
+ "id": "x64sc",
6
+ "location": {
7
+ "envVar": "VICE_BIN",
8
+ "fileOverridable": true
9
+ },
10
+ "kind": "executable",
11
+ "unblocks": {
12
+ "skills": [
13
+ "c64-program-recon",
14
+ "c64-ram-capture",
15
+ "vice-wedge-triage"
16
+ ],
17
+ "mcp": [
18
+ "c1541.bam",
19
+ "c1541.dir",
20
+ "c1541.entry",
21
+ "c1541.chain",
22
+ "c1541.read",
23
+ "petcat.decode"
24
+ ]
25
+ },
26
+ "remedies": {
27
+ "linux": [
28
+ {
29
+ "ecosystem": "debian-trixie",
30
+ "text": "sudo apt install vice (enable the contrib component first — VICE ships there, not main; a stock debian:trixie installation has no vice candidate until it is)",
31
+ "provenance": "carried",
32
+ "source": "README.md:101"
33
+ },
34
+ {
35
+ "ecosystem": "debian-forky",
36
+ "text": "sudo apt install vice (same contrib-component requirement as trixie)",
37
+ "provenance": "carried",
38
+ "source": "README.md:102"
39
+ },
40
+ {
41
+ "ecosystem": "ubuntu-2510",
42
+ "text": "sudo apt install vice (enable multiverse first)",
43
+ "provenance": "carried",
44
+ "source": "README.md:103"
45
+ },
46
+ {
47
+ "ecosystem": "arch",
48
+ "text": "sudo pacman -S vice",
49
+ "provenance": "carried",
50
+ "source": "README.md:104"
51
+ },
52
+ {
53
+ "ecosystem": "fedora-rpmfusion",
54
+ "text": "enable RPM Fusion Non-Free, then sudo dnf install vice",
55
+ "provenance": "carried",
56
+ "source": "README.md:105"
57
+ },
58
+ {
59
+ "ecosystem": "alpine-edge",
60
+ "text": "enable the edge/testing repo, then apk add vice",
61
+ "provenance": "carried",
62
+ "source": "README.md:106"
63
+ },
64
+ {
65
+ "ecosystem": "homebrew",
66
+ "text": "brew install vice",
67
+ "provenance": "carried",
68
+ "source": "README.md:107"
69
+ }
70
+ ],
71
+ "darwin": [
72
+ {
73
+ "ecosystem": "homebrew",
74
+ "text": "brew install vice",
75
+ "provenance": "carried",
76
+ "source": "README.md:107"
77
+ }
78
+ ],
79
+ "win32": [
80
+ {
81
+ "ecosystem": "windows-official",
82
+ "text": "download the GTK3/SDL2 win64 zip",
83
+ "provenance": "carried",
84
+ "source": "README.md:108"
85
+ }
86
+ ]
87
+ }
88
+ },
89
+ "c1541": {
90
+ "id": "c1541",
91
+ "location": {
92
+ "fileOverridable": true
93
+ },
94
+ "kind": "executable",
95
+ "unblocks": {
96
+ "skills": [
97
+ "c64-disk-access"
98
+ ],
99
+ "mcp": [
100
+ "c1541.bam",
101
+ "c1541.dir",
102
+ "c1541.entry",
103
+ "c1541.chain",
104
+ "c1541.read"
105
+ ]
106
+ },
107
+ "remedies": {
108
+ "linux": [
109
+ {
110
+ "ecosystem": "debian-trixie",
111
+ "text": "sudo apt install vice (enable the contrib component first — VICE ships there, not main; a stock debian:trixie installation has no vice candidate until it is)",
112
+ "provenance": "carried",
113
+ "source": "README.md:101"
114
+ },
115
+ {
116
+ "ecosystem": "debian-forky",
117
+ "text": "sudo apt install vice (same contrib-component requirement as trixie)",
118
+ "provenance": "carried",
119
+ "source": "README.md:102"
120
+ },
121
+ {
122
+ "ecosystem": "ubuntu-2510",
123
+ "text": "sudo apt install vice (enable multiverse first)",
124
+ "provenance": "carried",
125
+ "source": "README.md:103"
126
+ },
127
+ {
128
+ "ecosystem": "arch",
129
+ "text": "sudo pacman -S vice",
130
+ "provenance": "carried",
131
+ "source": "README.md:104"
132
+ },
133
+ {
134
+ "ecosystem": "fedora-rpmfusion",
135
+ "text": "enable RPM Fusion Non-Free, then sudo dnf install vice",
136
+ "provenance": "carried",
137
+ "source": "README.md:105"
138
+ },
139
+ {
140
+ "ecosystem": "alpine-edge",
141
+ "text": "enable the edge/testing repo, then apk add vice",
142
+ "provenance": "carried",
143
+ "source": "README.md:106"
144
+ },
145
+ {
146
+ "ecosystem": "homebrew",
147
+ "text": "brew install vice",
148
+ "provenance": "carried",
149
+ "source": "README.md:107"
150
+ }
151
+ ],
152
+ "darwin": [
153
+ {
154
+ "ecosystem": "homebrew",
155
+ "text": "brew install vice",
156
+ "provenance": "carried",
157
+ "source": "README.md:107"
158
+ }
159
+ ],
160
+ "win32": [
161
+ {
162
+ "ecosystem": "windows-official",
163
+ "text": "download the GTK3/SDL2 win64 zip",
164
+ "provenance": "carried",
165
+ "source": "README.md:108"
166
+ }
167
+ ]
168
+ }
169
+ },
170
+ "petcat": {
171
+ "id": "petcat",
172
+ "location": {
173
+ "fileOverridable": true
174
+ },
175
+ "kind": "executable",
176
+ "unblocks": {
177
+ "skills": [
178
+ "c64-petcat",
179
+ "c64-program-recon"
180
+ ],
181
+ "mcp": [
182
+ "petcat.decode"
183
+ ]
184
+ },
185
+ "remedies": {
186
+ "linux": [
187
+ {
188
+ "ecosystem": "debian-trixie",
189
+ "text": "sudo apt install vice (enable the contrib component first — VICE ships there, not main; a stock debian:trixie installation has no vice candidate until it is)",
190
+ "provenance": "carried",
191
+ "source": "README.md:101"
192
+ },
193
+ {
194
+ "ecosystem": "debian-forky",
195
+ "text": "sudo apt install vice (same contrib-component requirement as trixie)",
196
+ "provenance": "carried",
197
+ "source": "README.md:102"
198
+ },
199
+ {
200
+ "ecosystem": "ubuntu-2510",
201
+ "text": "sudo apt install vice (enable multiverse first)",
202
+ "provenance": "carried",
203
+ "source": "README.md:103"
204
+ },
205
+ {
206
+ "ecosystem": "arch",
207
+ "text": "sudo pacman -S vice",
208
+ "provenance": "carried",
209
+ "source": "README.md:104"
210
+ },
211
+ {
212
+ "ecosystem": "fedora-rpmfusion",
213
+ "text": "enable RPM Fusion Non-Free, then sudo dnf install vice",
214
+ "provenance": "carried",
215
+ "source": "README.md:105"
216
+ },
217
+ {
218
+ "ecosystem": "alpine-edge",
219
+ "text": "enable the edge/testing repo, then apk add vice",
220
+ "provenance": "carried",
221
+ "source": "README.md:106"
222
+ },
223
+ {
224
+ "ecosystem": "homebrew",
225
+ "text": "brew install vice",
226
+ "provenance": "carried",
227
+ "source": "README.md:107"
228
+ }
229
+ ],
230
+ "darwin": [
231
+ {
232
+ "ecosystem": "homebrew",
233
+ "text": "brew install vice",
234
+ "provenance": "carried",
235
+ "source": "README.md:107"
236
+ }
237
+ ],
238
+ "win32": [
239
+ {
240
+ "ecosystem": "windows-official",
241
+ "text": "download the GTK3/SDL2 win64 zip",
242
+ "provenance": "carried",
243
+ "source": "README.md:108"
244
+ }
245
+ ]
246
+ }
247
+ },
248
+ "acme": {
249
+ "id": "acme",
250
+ "location": {
251
+ "envVar": "ACME_BIN",
252
+ "fileOverridable": true
253
+ },
254
+ "kind": "executable",
255
+ "unblocks": {
256
+ "skills": [
257
+ "acme-build"
258
+ ],
259
+ "mcp": [
260
+ "acme.build"
261
+ ]
262
+ },
263
+ "remedies": {
264
+ "linux": [
265
+ {
266
+ "ecosystem": "ubuntu",
267
+ "text": "sudo apt-get install -y acme",
268
+ "provenance": "measured",
269
+ "source": ".github/workflows/ci.yml:78"
270
+ },
271
+ {
272
+ "ecosystem": "debian",
273
+ "text": "sudo apt-get install -y acme",
274
+ "provenance": "carried",
275
+ "source": ".github/workflows/ci.yml:48"
276
+ }
277
+ ],
278
+ "universal": [
279
+ {
280
+ "ecosystem": "generic",
281
+ "text": "Install ACME.",
282
+ "provenance": "carried",
283
+ "source": "src/skills/acme-build/SKILL.md:254"
284
+ }
285
+ ]
286
+ }
287
+ },
288
+ "acme-lib": {
289
+ "id": "acme-lib",
290
+ "location": {
291
+ "envVar": "ACME",
292
+ "fileOverridable": true
293
+ },
294
+ "kind": "directory",
295
+ "marker": "cbm/c64/vic.a",
296
+ "unblocks": {
297
+ "skills": [
298
+ "acme-build"
299
+ ],
300
+ "mcp": [
301
+ "acme.build"
302
+ ]
303
+ },
304
+ "remedies": {
305
+ "universal": [
306
+ {
307
+ "ecosystem": "generic",
308
+ "text": "export ACME=<dir holding cbm/c64/vic.a>.",
309
+ "provenance": "carried",
310
+ "source": "src/skills/acme-build/SKILL.md:255"
311
+ }
312
+ ]
313
+ }
314
+ },
315
+ "ghidra": {
316
+ "id": "ghidra",
317
+ "location": {
318
+ "envVar": "GHIDRA_HOME",
319
+ "fileOverridable": true
320
+ },
321
+ "kind": "directory",
322
+ "marker": "support/analyzeHeadless",
323
+ "unblocks": {
324
+ "skills": [
325
+ "c64-program-recon"
326
+ ],
327
+ "mcp": [
328
+ "ghidra.analyze",
329
+ "ghidra.installExtension"
330
+ ]
331
+ },
332
+ "remedies": {
333
+ "universal": [
334
+ {
335
+ "ecosystem": "generic",
336
+ "text": "Set the GHIDRA_HOME environment variable to name a Ghidra installation directory.",
337
+ "provenance": "carried",
338
+ "source": "src/mcp/vice/host-tool.mts:1352"
339
+ }
340
+ ]
341
+ }
342
+ },
343
+ "dxa": {
344
+ "id": "dxa",
345
+ "location": {
346
+ "fileOverridable": false,
347
+ "reason": "dxa is vendored and built by this project, so an override could only select a binary it did not build and did not pin."
348
+ },
349
+ "kind": "executable",
350
+ "unblocks": {
351
+ "skills": [
352
+ "routine-queue-walker"
353
+ ],
354
+ "mcp": [
355
+ "dxa.disassemble"
356
+ ]
357
+ },
358
+ "remedies": {
359
+ "universal": [
360
+ {
361
+ "ecosystem": "generic",
362
+ "text": "bash vendor/dxa/build.bash build",
363
+ "provenance": "carried",
364
+ "source": "src/mcp/vice/host-tool.mts:1472"
365
+ }
366
+ ]
367
+ }
368
+ },
369
+ "node": {
370
+ "id": "node",
371
+ "versionFloor": ">=24.0.0",
372
+ "location": {
373
+ "fileOverridable": false,
374
+ "reason": "vice-launcher.sh is bash and reads VICE_BROKER_NODE before any working Node exists to parse JSON with."
375
+ },
376
+ "kind": "executable",
377
+ "unblocks": {
378
+ "skills": [
379
+ "acme-build",
380
+ "c64-disk-access",
381
+ "c64-memory-mapping",
382
+ "c64-petcat",
383
+ "c64-program-recon",
384
+ "c64-provenance-diff",
385
+ "c64-ram-capture",
386
+ "routine-queue-walker",
387
+ "vice-wedge-triage"
388
+ ],
389
+ "mcp": [
390
+ "acme.build",
391
+ "ghidra.analyze",
392
+ "oracle.probe",
393
+ "oracle.run",
394
+ "dxa.disassemble",
395
+ "ghidra.installExtension",
396
+ "c1541.bam",
397
+ "c1541.dir",
398
+ "c1541.entry",
399
+ "c1541.chain",
400
+ "c1541.read",
401
+ "petcat.decode"
402
+ ]
403
+ },
404
+ "remedies": {
405
+ "universal": [
406
+ {
407
+ "ecosystem": "generic",
408
+ "text": "Install Node >= v24 and put it on PATH, or set VICE_BROKER_NODE to an absolute path to one.",
409
+ "provenance": "carried",
410
+ "source": "src/mcp/vice/resources/vice-launcher.sh:219"
411
+ }
412
+ ]
413
+ }
414
+ }
415
+ }
416
+ }