@henols/vice-mcp 0.2.1 → 0.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.
- package/README.md +2 -1
- package/THIRD-PARTY-NOTICES.md +1 -24
- package/{r2000-acme-ident.ts → anno-acme-ident.ts} +13 -13
- package/anno-cli.ts +1465 -0
- package/{r2000-confidence.ts → anno-confidence.ts} +22 -22
- package/anno-coverage.ts +2465 -0
- package/{r2000-d64.ts → anno-d64.ts} +5 -5
- package/anno-derive.ts +590 -0
- package/anno-details.ts +169 -0
- package/anno-enum-gen.ts +533 -0
- package/anno-export-asm.ts +1310 -0
- package/anno-index.ts +150 -0
- package/{r2000-memmap-render.ts → anno-memmap-render.ts} +236 -95
- package/{r2000-regbits-gen.ts → anno-regbits-gen.ts} +20 -15
- package/{r2000-regbits.json → anno-regbits.json} +2 -2
- package/anno-register.ts +240 -0
- package/anno-store.ts +3486 -0
- package/anno-symbols.ts +266 -0
- package/anno-tools.ts +2111 -0
- package/anno-types.ts +1636 -0
- package/block-class.ts +201 -0
- package/build.ts +1 -1
- package/capability-registry.ts +3 -1
- package/disasm-decoder.ts +14 -14
- package/disasm-opcodes.ts +4 -4
- package/disasm-renderer.ts +2 -2
- package/hostpath.ts +1 -1
- package/install-resources.ts +1 -1
- package/package.json +23 -17
- package/prg-image.ts +119 -0
- package/repo-root.ts +20 -5
- package/resources/broker-launch.mjs +8 -4
- package/resources/vice-launcher.sh +3 -3
- package/stock-address.ts +5 -5
- package/stock-cia.ts +2 -2
- package/stock-condition.ts +7 -7
- package/stock-connect.ts +1 -1
- package/stock-dispatch.ts +35 -5
- package/stock-execution.ts +5 -3
- package/stock-input.ts +9 -9
- package/stock-machine.ts +17 -6
- package/stock-protocol.ts +16 -11
- package/stock-registers.ts +54 -29
- package/stock-sprites.ts +3 -3
- package/stock-symbols.ts +9 -9
- package/stock-timing.ts +1 -1
- package/stock-vicii.ts +1 -1
- package/version.ts +1 -1
- package/vice-proxy.ts +68 -46
- package/r2000-cli.ts +0 -1103
- package/r2000-enum-gen.ts +0 -574
- package/r2000-launch.ts +0 -357
- package/r2000-mcp-client.ts +0 -596
- package/r2000-project.ts +0 -190
- package/r2000-symbols.ts +0 -388
- package/r2000-tools.ts +0 -914
- package/r2000-verify.ts +0 -184
package/README.md
CHANGED
|
@@ -50,6 +50,7 @@ VICE MCP server.
|
|
|
50
50
|
| `VICE_MCP_HOST` | Host to reach the VICE MCP server on. |
|
|
51
51
|
| `VICE_SKIP_RESOURCE_INSTALL=1` | Disable deploying host launcher scripts into `<project>/tools/`. |
|
|
52
52
|
| `MASTRA_TELEMETRY_DISABLED=1` | Disable Mastra telemetry. |
|
|
53
|
+
| `VICE_LIVE_STOCK_BIN` | Absolute path to a genuinely unpatched stock VICE binary; opts `stock-live.test.ts` in (default-skipped). |
|
|
53
54
|
|
|
54
55
|
## Development
|
|
55
56
|
|
|
@@ -64,7 +65,7 @@ export CONTAINER_WORKSPACE_PATH="$(git rev-parse --show-toplevel)"
|
|
|
64
65
|
export HOST_WORKSPACE_PATH="/host$(git rev-parse --show-toplevel)"
|
|
65
66
|
```
|
|
66
67
|
|
|
67
|
-
`npm run test:automated` is the subset of `npm test` that excludes the
|
|
68
|
+
`npm run test:automated` is the subset of `npm test` that excludes the nine
|
|
68
69
|
manual-only files (see `test-gate.mjs`'s own header).
|
|
69
70
|
|
|
70
71
|
```sh
|
package/THIRD-PARTY-NOTICES.md
CHANGED
|
@@ -72,32 +72,9 @@ availability gate; CI installs it via `apt-get install -y acme` in
|
|
|
72
72
|
`.github/workflows/ci.yml`'s `build` job). **No ACME source, header, data
|
|
73
73
|
table or output is included in this repository or in the published
|
|
74
74
|
package**, so ACME's licence does not attach to anything shipped. ACME never
|
|
75
|
-
appears in
|
|
75
|
+
appears in `src/mcp/vice/package.json`'s `files[]`, `dependencies`, or
|
|
76
76
|
`devDependencies` — it is an apt/CI-installed tool, never an npm package.
|
|
77
77
|
|
|
78
|
-
## Build/CI tools — not incorporated: regenerator2000
|
|
79
|
-
|
|
80
|
-
regenerator2000 is invoked as an **external CLI subprocess** (Phase 10's
|
|
81
|
-
`R2000-09` bootstrap and `R2000-06` reassembly proof) against a real,
|
|
82
|
-
locally-installed `regenerator2000` binary. **No regenerator2000 source,
|
|
83
|
-
data table, or output is included in this repository or in either
|
|
84
|
-
published package**, so its licence does not attach to anything shipped.
|
|
85
|
-
|
|
86
|
-
Its licence is **`MIT OR Apache-2.0`** — dual, at the user's option —
|
|
87
|
-
confirmed from the crate's own crates.io licence field, with both
|
|
88
|
-
`LICENSE-MIT` and `LICENSE-APACHE` shipping in the crate. (Do not read this
|
|
89
|
-
as Apache-2.0 alone: that stale, single-licence claim is what `R2000-03`'s
|
|
90
|
-
own requirement text and `.planning/notes/regenerator2000-integration.md`
|
|
91
|
-
still carried before Phase 10 corrected it here.)
|
|
92
|
-
|
|
93
|
-
Verified version `0.9.20`, published 2026-07-11 by `ricardoquesada`
|
|
94
|
-
(matching the linked GitHub repository owner), checked 2026-08-20 — so this
|
|
95
|
-
provenance claim is re-checkable against a specific release.
|
|
96
|
-
|
|
97
|
-
regenerator2000 never appears in `.claude/mcp/vice/package.json`'s
|
|
98
|
-
`files[]`, `dependencies`, or `devDependencies` — it is a `cargo
|
|
99
|
-
install`-provided tool, never an npm package.
|
|
100
|
-
|
|
101
78
|
## Explicitly NOT a source: VICE
|
|
102
79
|
|
|
103
80
|
VICE is GPL-2 and this repository is MIT. **No opcode fact, protocol
|
|
@@ -1,29 +1,29 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
//
|
|
2
|
+
// anno-acme-ident.ts -- the ONE authoritative place in this repo for the
|
|
3
3
|
// ACME identifier policy (T-11-ENUM-NAME / T-11-NAME-INJECT): what makes a
|
|
4
4
|
// string a legal ACME symbol/label name, and the single check function that
|
|
5
5
|
// decides it.
|
|
6
6
|
//
|
|
7
|
-
// WHY THIS MODULE EXISTS: this policy started life inside
|
|
7
|
+
// WHY THIS MODULE EXISTS: this policy started life inside anno-enum-gen.ts,
|
|
8
8
|
// consumed only by its own `createOrUpdateEnum()`/`sanitizeVariantMap()`.
|
|
9
9
|
// T-11-NAME-INJECT widened the finding to a SECOND entry route --
|
|
10
|
-
// `
|
|
11
|
-
// `importLabels()` in
|
|
12
|
-
// imports `
|
|
13
|
-
// import the policy back from `
|
|
10
|
+
// `anno_set_label_name` (both outer and batch-inner) in anno-tools.ts, and
|
|
11
|
+
// `importLabels()` in anno-symbols.ts -- and `anno-enum-gen.ts` statically
|
|
12
|
+
// imports `runAnnoTool` FROM `anno-tools.ts`, so `anno-tools.ts` cannot
|
|
13
|
+
// import the policy back from `anno-enum-gen.ts` without forming a module
|
|
14
14
|
// cycle. This module has no import from anywhere else in this repo, so
|
|
15
15
|
// every one of those consumers (and any future one) can import it directly.
|
|
16
16
|
//
|
|
17
17
|
// WHAT THIS IS THE ONE AUTHORITATIVE PLACE FOR: `MAX_ACME_IDENTIFIER_LENGTH`,
|
|
18
18
|
// `ACME_IDENT_RE`, `ACME_RESERVED_MNEMONICS` and `assertLegalAcmeIdentifier()`
|
|
19
19
|
// -- the complete, only definition of "legal ACME identifier" in this repo.
|
|
20
|
-
// `
|
|
20
|
+
// `anno-enum-gen.ts` re-exports `assertLegalAcmeIdentifier` /
|
|
21
21
|
// `MAX_ACME_IDENTIFIER_LENGTH` from here so its own existing consumers and
|
|
22
22
|
// tests keep their current import path; it does not hold a second copy.
|
|
23
23
|
//
|
|
24
24
|
// WHAT NOT TO DO, named concretely:
|
|
25
25
|
// - Never add a second identifier regex anywhere in this repo. The
|
|
26
|
-
// `
|
|
26
|
+
// `anno-regbits-gen.ts` / `anno-regbits.test.ts` copies of
|
|
27
27
|
// `ACME_IDENT_RE` predate this module and are out of this plan's scope
|
|
28
28
|
// (260821-a86) to consolidate -- but no NEW copy should be added; import
|
|
29
29
|
// this module's `assertLegalAcmeIdentifier()` instead.
|
|
@@ -34,8 +34,8 @@
|
|
|
34
34
|
// caller-visible name must never diverge from what actually gets
|
|
35
35
|
// exported into ACME source.
|
|
36
36
|
// - Never import anything from this repo into this module. It must stay
|
|
37
|
-
// importable by both `
|
|
38
|
-
// imports `
|
|
37
|
+
// importable by both `anno-tools.ts` and `anno-enum-gen.ts` (which
|
|
38
|
+
// imports `runAnnoTool` FROM `anno-tools.ts`) without a cycle.
|
|
39
39
|
export const MAX_ACME_IDENTIFIER_LENGTH = 200;
|
|
40
40
|
|
|
41
41
|
const ACME_IDENT_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
@@ -65,15 +65,15 @@ const ACME_RESERVED_MNEMONICS: ReadonlySet<string> = new Set([
|
|
|
65
65
|
* `ACME_RESERVED_MNEMONICS`'s own header comment for how that specific list
|
|
66
66
|
* was measured, not assumed).
|
|
67
67
|
*
|
|
68
|
-
* T-11-ENUM-NAME (the highest-value threat in this phase):
|
|
68
|
+
* T-11-ENUM-NAME (the highest-value threat in this phase): The external analyser
|
|
69
69
|
* validates only the ENUM name server-side
|
|
70
70
|
* (`app_state.rs:443`, `validate_new_enum_name`) and performs ZERO
|
|
71
71
|
* validation on variant names -- they flow straight into
|
|
72
72
|
* `format!("{}_{}", enum_name, variant)` at export time
|
|
73
73
|
* (`formatter_acme.rs:367-369`). This function is called on BOTH the enum
|
|
74
74
|
* name and every variant name, and is called BEFORE any
|
|
75
|
-
* `
|
|
76
|
-
* `
|
|
75
|
+
* `anno_create_project_enum`/`anno_update_project_enum` call reaches
|
|
76
|
+
* `runAnnoTool()` -- proven zero-spawn in `anno-enum-gen.test.ts`.
|
|
77
77
|
*/
|
|
78
78
|
export function assertLegalAcmeIdentifier(id: string, what: string): void {
|
|
79
79
|
if (id.length === 0) {
|