Sync source edition with VCC Plus 3.7.0 build 63

This commit is contained in:
Brian Holman committed 2026-11-14 01:43:46 -07:00
1 parent c652a5276d
commit b2ecec4d87
86 files changed
+10519 -472

No files matched your search

+17 -2
View File
@@ -58,6 +58,16 @@ just the value written to an MMU register. Installed RAM capacity is checked by
the emulator. The packed binary's transfer address is `entryPoint`; it can belong
to a loader outside the unpacked C modules.
Verification uses distinct evidence budgets: the manifest is at most 1 MiB;
retained compiler `.s` assembly is at most 32 MiB per file; other evidence files
(including listings, objects, linker maps, executable and raw images) are at most
8 MiB each. Unique retained evidence is capped at 128 MiB in total. Files are
verified in full against their hashes; oversized evidence is rejected rather
than truncated. Rejections identify the artifact path, observed size and byte
limit. Existing limits on manifest records, module/page ownership and listing
rows still apply. Large generated type records in assembly do not relax the
assembler-listing row limits or establish a source mapping by themselves.
Declare each linker section under one module. `codeSections` names executable,
immutable sections; mutable data and BSS belong in `sections` with their real page
assignments but are excluded from code guards. BSS needs no invented raw zeros.
@@ -65,8 +75,13 @@ A pure BSS module may omit `image` entirely when `codeSections` is empty;
its explicit page assignments and section ownership still apply. An initialized
section cannot use that omission to skip object byte verification.
Keep mutable bytes out of executable sections. Split modules when unrelated pages
need not remain mapped together. Different overlays may reuse a logical address
only with distinct physical ownership.
need not remain mapped together. Version 1 permits logical-address reuse with
distinct physical ownership. For code images that replace one another in the
same physical RAM, use the explicit version-2
overlay group and owner contract. Runtime inspection
requires complete loaded-code proof of exactly one owner; declaration alone
does not establish residency. Build catalogs list static candidates, while a
paused inspection reports current verified ownership and a residency fingerprint.
Hashes bind the declaration to one build. VCC Plus independently replays object
relocations against the raw module bytes and verifies live RAM before publishing
+15 -3
View File
@@ -37,7 +37,11 @@ its `VCCDBG1` type/storage records; retaining compiler-generated `.s` permits
verification of records too long for an assembler listing row. A useful Debug
compile uses `-O0 -fno-omit-frame-pointer`; optimized builds can legitimately
have fewer C statements or unavailable locals. No user Makefile is rewritten
merely to provide debugger metadata.
merely to provide debugger metadata. Banked evidence permits compiler `.s` files
up to 32 MiB while retaining 8 MiB limits for other evidence, the 1 MiB manifest
limit and the 128 MiB aggregate cap. Size failures name the artifact and exact
limit; hash, declared-output and symbolic-link checks still apply. No evidence
is truncated to make a source map appear verified.
For example, a normal recipe can compile and link with:
@@ -51,7 +55,11 @@ program.bin: obj/main.o
This fragment only illustrates retained evidence; disk construction and launch
commands remain the project's declared recipe. Packed, relocated or bank-switched
programs must supply the public version-1 [banked debug manifest](MCP_BANKED_PLAYTEST.md).
programs must supply the public [banked debug manifest](MCP_BANKED_PLAYTEST.md).
Version 1 preserves distinct physical ownership; version 2 supports explicitly
declared mutually exclusive code overlays. Discover
`banked_debug_manifest_versions` and `verified_code_overlays` through
`get_capabilities` before preparing that evidence.
Its hashes, unpacked images, section ownership and actual physical page identities
are required. It never falls back to a flat interpretation after verification
fails.
@@ -82,7 +90,11 @@ Locally configured watches retain their existing rules.
`read_debug_memory` accepts only ranges advertised by that immutable snapshot,
up to 256 bytes. Resume, input, step, restart, source/artifact changes and
connection revocation invalidate the applicable observation. Inspection performs
connection revocation invalidate the applicable observation. Owned memory and
call-context reads also compare a fresh complete capture, including verified
residency, registers, cycles and safe memory, even at the same field clock.
The residency fingerprint names a current proof rather than a monotonic guest
write counter; A→B→A still requires fresh capture validation. Inspection performs
no guest expressions, register writes, memory writes or side-effecting I/O reads.
A mismatched binary, object relocation, source identity or bank cannot produce a
verified snapshot merely because a requested function name exists.
+31
View File
@@ -0,0 +1,31 @@
# Capture feedback audio
The two short cues play through NSSound on the Mac only. They never enter the
emulator audio mixer, generated PCM, MCP audio capture or recorded movies.
They are not controlled by the separate Include CoCo Audio in Video preference.
Brian selected these effects on Pixabay. The same recordings are available from
their original creators on Freesound under **CC0 1.0**; the retained sources were
downloaded from the preview URLs linked by those original pages on November 13,
2026. These assets are public-domain dedications, separate from the GPL code and
the original VCC Plus artwork notice.
| Cue | Original creator and source | Retained preview |
| --- | --- | --- |
| Screenshot | [iPhone Camera Capture.wav — pooky1](https://freesound.org/people/pooky1/sounds/431588/) | https://cdn.freesound.org/previews/431/431588_2339776-hq.mp3 |
| Recording start | [Tape start .wav — sophiehall3535](https://freesound.org/people/sophiehall3535/sounds/245927/) | https://cdn.freesound.org/previews/245/245927_4361022-hq.mp3 |
Both source pages explicitly identify Creative Commons 0:
https://creativecommons.org/publicdomain/zero/1.0/
The selected Pixabay pages remain references:
https://pixabay.com/sound-effects/film-special-effects-iphone-camera-capture-6448/
https://pixabay.com/sound-effects/film-special-effects-tape-start-85778/
`prepare.py` decodes the retained previews, extracts 1.62–2.14 seconds of the tape
recording to remove the long lead-in and later sounds, downmixes to mono 44.1 kHz
16-bit WAV, normalizes the peak to 0.35 and applies five-millisecond edge fades.
The full shutter preview is retained in its cue. Source and output SHA-256 values
are recorded in `manifest.json`. Run `python3 docs/media/capture-sounds/prepare.py`
with ffmpeg available to reproduce the bundled WAV files. Application builds use
the prepared WAV files and require no audio download or ffmpeg.
+24
View File
@@ -0,0 +1,24 @@
{
"license": "CC0-1.0",
"reviewed": "2026-11-13",
"inputs": {
"shutter.mp3": {
"sha256": "e805680b4ee8a48bc537f266c866e74d60b076a76e52af3acbaacf77e8cb7392",
"bytes": 15600
},
"tape-start.mp3": {
"sha256": "ebbbb9d82d0ff2f84d48ae8228a2f635fe45b7816583393e77d079034230eac7",
"bytes": 50712
}
},
"outputs": {
"recording-start.wav": {
"sha256": "5b5ba2407a84e39cf04018c64acb48b690089cd32cec193920dcbf2cb4080aa7",
"bytes": 45908
},
"screenshot.wav": {
"sha256": "38bce90df26042fa70bb0a5dc33a5759867e0440de0a7acd4b8942cbcbdf239d",
"bytes": 48886
}
}
}
+40
View File
@@ -0,0 +1,40 @@
#!/usr/bin/env python3
"""Reproduce short host-only cues from the retained CC0 Freesound previews.
Requires ffmpeg; not needed to build or run VCC Plus.
"""
from pathlib import Path
import hashlib
import json
import struct
import subprocess
import wave
ROOT = Path(__file__).resolve().parents[3]
HERE = Path(__file__).resolve().parent
DEST = ROOT / "platforms/macos/Resources/CaptureSounds"
CLIPS = [("shutter.mp3", "screenshot.wav", None),
("tape-start.mp3", "recording-start.wav", "atrim=start=1.62:end=2.14,asetpts=PTS-STARTPTS")]
def build():
DEST.mkdir(parents=True, exist_ok=True)
for original, filename, trim in CLIPS:
command = ["ffmpeg", "-nostdin", "-v", "error", "-i", str(HERE / "source" / original)]
if trim:
command += ["-af", trim]
raw = subprocess.check_output(command + ["-ac", "1", "-ar", "44100", "-f", "f32le", "-"])
values = struct.unpack("<" + "f" * (len(raw) // 4), raw)
peak = max(abs(v) for v in values)
scale = 0.35 / max(peak, 0.000001)
fade = 221
samples = [round(v * scale * 32767 * min(1, i / fade, (len(values) - 1 - i) / fade))
for i, v in enumerate(values)]
with wave.open(str(DEST / filename), "wb") as output:
output.setparams((1, 2, 44100, 0, "NONE", "not compressed"))
output.writeframes(struct.pack("<" + "h" * len(samples), *samples))
print(filename, len(samples) / 44100, hashlib.sha256((DEST / filename).read_bytes()).hexdigest())
if __name__ == "__main__":
build()
Binary file not shown.
Binary file not shown.
+2 -2
View File
@@ -230,7 +230,7 @@
},
{
"path": "docs/development/MCP_BANKED_PLAYTEST.md",
"export_sha256": "fad90fcb7e5ca3670d803f02578e44e637b0b126f7716dc4198f253ea7eae3a6",
"export_sha256": "75f1b3c0977ffc536a0cb47f46f554c10c06a34d5b7a2a58458d997c1493c480",
"selected_headings": [
{
"heading": "Build evidence for packed programs",
@@ -306,7 +306,7 @@
},
{
"path": "docs/development/MCP_DEBUG_EVIDENCE.md",
"export_sha256": "79fe80ae2c40808e6da821bae1d2de1aa4c18b5f7e24b3a40707fdd473cf086e",
"export_sha256": "ddb8e4979b5573cff809a6fda8c9b961fcbd3dfc0fd7f8bce4dcd1814782e2f4",
"selected_headings": [
{
"heading": "Read the build evidence first",