Sync VCC Plus 3.7.1 build 67 source

Refresh reviewed MCP output export, four-drive owned playtests, bounded BASIC readiness, and pinned CMOC 0.1.101 source/patches. Preserve independent source-edition identity, empty libraries, notices and privacy boundaries.

Validated 74 export/privacy checks, pinned dependency sources, and an independent unsigned universal Release build. A subsequent documentation-only correction removes an excluded qualification link; all build inputs remain identical.
This commit is contained in:
Brian Holman committed 2026-11-17 08:42:27 -07:00
1 parent 4abc194001
commit 5534005799
54 files changed
+2950 -435

No files matched your search

+9 -2
View File
@@ -7,7 +7,7 @@
| Tool or directory | Purpose |
| --- | --- |
| `bin/make` | GNU Make 4.4.1: ordinary, recursive, incremental and parallel Makefile builds. |
| `bin/cmoc`, `libexec/cmoc` | Relocatable wrapper/native CMOC 0.1.100 compiler. |
| `bin/cmoc`, `libexec/cmoc` | Relocatable wrapper/native CMOC 0.1.101 compiler in the development source tree. |
| `bin/cpp`, `bin/mcpp` | Native CMOC adapter and mcpp 2.7.2 preprocessor. |
| `bin/lwasm`, `bin/lwlink`, `bin/lwar` | LWTools 4.25 assembler, linker and archive tool. |
| `bin/writecocofile` | CMOC's native disk-image insertion utility. |
@@ -23,10 +23,17 @@ The compiler wrapper creates a temporary space-free alias for target headers/lib
The maintained `cmoc-make-dependencies.patch` escapes generated Make dependency targets/prerequisites and decodes quoted preprocessor paths in both CMOC readers. The adapter quotes raw path characters emitted by mcpp. This covers real SDK header paths inside a relocated `VCC Plus.app`, including parent directories containing spaces, quotes, `#` and `$`. `verify-runtime.py` exercises both `--deps-only` and `--deps`, automatic inclusion/regeneration, changed-header rebuilding and no-op builds on both architectures.
The bundled CMOC 0.1.100 optimizer preserves accumulator-indexed addresses when simplifying byte subtraction and comparisons. The runtime manifest records `vccIndexedByteSubtractionFix: 1`. The change takes effect when a project is recompiled. [Compiler patch and regression](../../tools/toolchain/patches/README.md)
The CMOC 0.1.101 development optimizer preserves accumulator-indexed addresses when simplifying byte subtraction and comparisons. The runtime manifest records `vccIndexedByteSubtractionFix: 1`. The change takes effect when a project is recompiled. [Compiler patch and regression](../../tools/toolchain/patches/README.md)
The runtime manifest records `vccAddZeroFlagsFix: 1` for correct logical negation of integer results at `-O2`. Recompile existing guest programs to pick up the fix. [Logical negation regression](../../tools/toolchain/patches/README.md)
CMOC 0.1.101 provides upstream `writecocofile --allocate-before-dir`: try free
granules 33 down to 0, then 34 through 67. The VCC Plus `--allocate-forward`
compatibility alias retains ascending 0-through-67 allocation. Both can continue
above the directory. Existing recipes that depend on the earlier VCC Plus layout
must select the explicit forward alias; do not assume the identical old option
name preserves physical layout. The last allocation option wins.
App staging adds a deterministic payload hash to the installed manifest. Workspace caches therefore invalidate when the compiler, helpers or headers change, even with the same upstream version.
Native project builds pass `MAKE=make` with the bundled tools first on PATH. This keeps recursive `$(MAKE)` recipes working when the actual application path contains spaces. The runtime regression includes a recursive child Makefile.
+7 -5
View File
@@ -117,7 +117,7 @@ Use the live tool catalog and `get_capabilities` as the contract:
| --- | --- |
| `list_playtest_disks` | List retained primary boot disks scoped to the current project, with opaque IDs, hashes and artifact provenance. |
| `list_playtest_media` (fresh media grant) | List the current artifact's reviewed disk products and, optionally, an owned run's private copies and compatible retained histories. |
| `exchange_playtest_media` (fresh media grant) | Insert/eject a listed private FD0 copy at a paused, idle guest without reset or time advance; retain the old bytes before replacement. |
| `exchange_playtest_media` (fresh media grant) | Insert/eject a listed private copy at a paused, idle guest without reset or time advance; fresh multi-drive grants select FD0–FD3 and insert-time protection; retain old bytes before replacement. |
| `start_playtest` | Supply current project, revision, artifact and request IDs. Optionally select `processor: "MC6809"` (default) or `"HD6309"`, a retained disk by ID and exact hash, or name `stop_function` with `stop_kind: "c_line"` (default) or `"function_entry"`. |
| `playtest_input` | Send steps of named physical `keys` held for `fields`, with optional complete standard `joysticks` snapshots on fresh joystick grants. Omitted ports center and release. |
| `get_playtest_input` (toolset 9 joystick grant) | Read actual owned input and clock without advancing; input receipts also carry per-step delivery traces. |
@@ -128,14 +128,16 @@ Use the live tool catalog and `get_capabilities` as the contract:
| `get_debug_snapshot` | At a verified C or function stop, read its honest stop kind, module/physical identity, registers, permitted memory ranges and named watches. |
| `read_debug_memory` | Read an advertised range from the same immutable stopped snapshot, up to 256 bytes. |
| `get_call_context` (fresh toolset 10) | Read exactly 64 bytes at the paused owned guest’s actual S, with caller/integer-argument interpretation only where compiled evidence proves it. Supply the same run and snapshot IDs. |
| `restart_playtest` | Cold restart the owned machine, retain its writable disk, and repeat the boot commands. |
| `stop_playtest` | End the worker and retain its test disk in the app's development results. |
| `restart_playtest` | Cold restart the owned machine, preserve all selected drives/copies/protection, and repeat the boot commands. |
| `stop_playtest` | Freeze and independently retain every test disk before ending the worker. |
[Bounded call context](MCP_CALL_CONTEXT.md) explains raw versus proven values, fresh grants and snapshot invalidation.
Disk exchange covers `playtestDisks` declarations,
private writable sets, correct/wrong/empty media tests and explicit multi-disk
resumption. `restart_playtest` keeps the currently inserted disk; it does not
choose the primary disk automatically.
resumption, four-drive receipts and transferred-byte activity. Fresh multi-drive
grants use toolset 13+ with `playtestMultiDrive: true`; older media grants keep
FD0-only behavior. `restart_playtest` preserves the mount map rather than moving
the primary disk to FD0; ensure the intended boot disk is present there.
Development [debug evidence and diagnostics](MCP_DEBUG_EVIDENCE.md) extend these
receipts to ordinary verified custom-Make artifacts. Flat code uses verified
+59 -13
View File
@@ -5,6 +5,9 @@ A fresh C connection with **Allow Disposable Playtests** can advertise
`exchange_playtest_media` tools. Check live discovery and `get_capabilities`
before planning exchanges. Existing connections keep their original schemas;
new tools require a newly reviewed connection and a restarted client helper.
Fresh multi-drive grants additionally declare strict Boolean
`playtestMultiDrive: true` with toolset 13 or later. Legacy media grants retain
their FD0-only schema; an app update does not expand an old connection.
This feature operates only on an owned disposable guest, never the ordinary
shared run or personal mounted media.
@@ -61,11 +64,32 @@ counts and a truncation flag identify omitted history. `list_playtest_disks`
keeps its older primary-boot-disk-only contract. Additional world/data disks
are not advertised as primary boot selections.
The drive is **FD0**. No tool accepts a host pathname, another drive number,
arbitrary bytes, another project's disks or a personal guest. Product IDs bind
On a fresh multi-drive connection, `exchange_playtest_media` accepts integer
`drive` 0–3 for **FD0–FD3**; omission means FD0. Legacy media connections remain
FD0-only. No tool accepts a host pathname, arbitrary bytes, another project's
disks or a personal guest. Product IDs bind
to the current artifact, not just a filename. Listing and insertion recheck the
project/revision/artifact and any retained disk's exact provenance and bytes.
## Read a coherent four-drive receipt
Fresh multi-drive results carry `media_contract_version: 2` and a `drives` array
with exactly four bounded observations. Each row identifies numeric `drive`,
`label` (`FD0` through `FD3`), `inserted`/`disk_present`, current `media_id`, byte
count, original/current hashes, generation, dirty state and effective protection.
The host associates the row with product/base provenance, media key and available
retained identities. A media inventory row's nullable `drive` identifies current
placement; product identity remains independent of placement.
`disk_reads` and `disk_writes` count guest-transferred data bytes over the worker's
lifetime. `mount_read_bytes` and `mount_write_bytes` reset at a media-generation
change. They are not counts of completed Save commands. Use guest save/reload,
exact before/after hashes and the relevant generation's activity together. A
rewritten identical value can have activity without a changed content hash.
Read-only listing/capture does not advance emulation. Established top-level disk
fields continue to describe FD0; top-level retained primary fields still identify
the reviewed primary product even when it was moved to another drive.
## Exchange at a guest prompt
1. Boot the primary disk through the project's declared commands.
@@ -75,16 +99,30 @@ project/revision/artifact and any retained disk's exact provenance and bytes.
4. Insert a listed private copy with its exact current hash:
```json
{"run_id":"<owned run>","request_id":"insert-data-1","action":"insert","media_id":"<listed media ID>","media_sha256":"<listed current SHA-256>"}
{"run_id":"<owned run>","request_id":"insert-data-1","action":"insert","drive":1,"media_id":"<listed media ID>","media_sha256":"<listed current SHA-256>"}
```
To leave FD0 empty, omit both selection fields:
This example leaves Home in FD0 and inserts Data in FD1. To leave FD1 empty,
omit both selection fields and name that drive:
```json
{"run_id":"<owned run>","request_id":"eject-data-1","action":"eject"}
{"run_id":"<owned run>","request_id":"eject-data-1","action":"eject","drive":1}
```
An exchange also requires an idle floppy controller. A paused CPU or stopped
`drive` must be a whole number from 0 through 3; booleans, fractional numbers and
out-of-range values are refused. A fresh multi-drive insert also accepts strict
Boolean `write_protected`. Omission preserves that copy's current setting; false
cannot remove format-imposed protection. Eject forbids this option and the
media/hash insertion fields. Protection belongs to the private copy and survives
exchange, restart and retention independently of its content hash.
The same writable private copy cannot be mounted in two drives at once. Eject
then insert to move it; matching bytes alone do not make two independent copies
the same object. An exchange affects only its target drive and never changes
BASIC's current/default drive.
An exchange also requires an idle shared floppy controller, including activity
associated with a different drive. A paused CPU or stopped
motor alone does not prove an incomplete guest transaction has finished. The
app refuses an exchange while a command is pending; it never cancels the guest's
disk I/O to force a swap. Continue through the guest's normal recovery path and
@@ -97,14 +135,16 @@ provenance, stale-ownership or retention refusal before commit leaves the old
paused disk and its dirty bytes intact. The same private copy is reused when switching back.
Exchanges do not reset the guest, advance its field clock, type keys or modify
RAM/registers. The response reports `previous_media`, retained snapshot identity,
RAM/registers. The response reports `target_drive`, `previous_media`, retained snapshot identity,
new selection, `media_generation`, hashes, dirty state and the unchanged clock,
with `guest_advanced: false` and `guest_reset: false`. Normal input resumes the
guest so it can read the newly inserted disk itself. Capture the framebuffer
and inspect the game's response; a successful mount is not proof that the game
accepted the media.
Reuse a request ID only with the identical selection. The cached receipt prevents
Reuse a request ID only with the identical selection, target drive and explicit
protection choice. An omitted drive and explicit drive 0 are normalized to the
same selection. The cached receipt prevents
a retry from performing another exchange; different arguments conflict. Exchanges
consume the existing owned mutation-request budget, not emulated fields. The
normal input, audio, startup and ownership limits remain in force.
@@ -142,12 +182,18 @@ place; do not create another request to repeat an uncertain operation in that ru
## Save, restart and retain every disk
For a one-drive application, insert Home at its save prompt, use its real Save
command, then insert Data to continue. `restart_playtest` cold-boots the currently
inserted private disk through the declared commands; it keeps all the other
private copies and their changes. Insert the boot disk first when the current
data disk cannot boot. Restart does not automatically choose another disk.
command, then insert Data to continue. A multi-drive application can instead
keep Home in FD0 and Data in FD1 and decide its own save routing.
`restart_playtest` cold-boots through the declared commands while preserving
all current drive assignments, bytes and protection. Ensure FD0 contains the
intended boot disk before a DOS boot. Restart does not secretly move the primary
product to FD0 or choose a bootable disk. Startup mount maps are not part of
this interface: insert into other drives through explicit paused exchanges.
`stop_playtest` retains every disk in the owned set, even when FD0 is empty.
`stop_playtest` freezes the mounted state coherently and drains the four drives
through separate bounded exports before worker exit. It retains every disk in
the owned set, including ejected copies and when FD0 is empty. A combined reply
does not concatenate four full disk images across the 1 MiB transport limit.
`retained_media` returns an individual immutable disk ID/hash and product
provenance for each. The established top-level `retained_disk_id` and
`retained_disk_sha256` refer to the primary Home copy. Cleanup remains possible
+2 -2
View File
@@ -140,7 +140,7 @@
},
{
"path": "docs/development/CMOC_RUNTIME.md",
"export_sha256": "c76871a76088b08e8c47110f596631f0cc426a73adb75f956c0abe508a6de9f7",
"export_sha256": "2f253b1f8ece8da50d23899f51b23d8877a371dd4a82d84c54027a5d1012017a",
"selected_headings": [
{
"heading": "Runtime contract",
@@ -230,7 +230,7 @@
},
{
"path": "docs/development/MCP_BANKED_PLAYTEST.md",
"export_sha256": "75f1b3c0977ffc536a0cb47f46f554c10c06a34d5b7a2a58458d997c1493c480",
"export_sha256": "2e45126b15ecdd309993c96fbeac28401d5462e83b7bf05b6d02a21fd1bfcede",
"selected_headings": [
{
"heading": "Build evidence for packed programs",