Integrate CoCo Letters with VCC Plus and verified board startup

Add project library bindings, delivered CoCoLetters.DSK, actual board screenshots and installed build-43 public-MCP validation. Preserve upstream application sources and original notices.
This commit is contained in:
Brian Holman committed 2026-11-09 23:39:35 -07:00
1 parent 4cedb2d94a
commit a1b27b2233
12 files changed
+478 -32

No files matched your search

+41
View File
@@ -0,0 +1,41 @@
# Source provenance
## Original package
- Original author: **Pierre Sarrazin**.
- Package: **coco-letters 0.1.0**.
- [Project page](http://sarrazip.com/dev/coco-letters.html).
- [Source archive](http://sarrazip.com/dev/coco-letters-0.1.0.tar.gz).
- Archive SHA-256: `ad7c7771845e1a35014644fb562634a558abee632e1d7738683db6e9e9e46b94`.
The VCCPlus source manifest records the historical download URL
`http://gvlsywt.cluster051.hosting.ovh.net/dev/coco-letters-0.1.0.tar.gz` with
the same archive SHA-256. The local `.tgz` filename does not represent a separate
version.
The checksum identifies the imported archive bytes, not an independent
proof of authenticity. Original file-specific license notices remain in effect.
## Git history and VCC Plus integration
The original distribution was a source archive. The initial commit,
`4cedb2d94ac8dc531c29a1310c1fcafdea0a6943`, imports its 29 original regular files before
integration. The original README is preserved byte-for-byte in `UPSTREAM_README.md`.
The integration retains the application C/header sources and original notices.
The adapted Makefile binds supported target libraries and disk support, while
`Makefile.orig` preserves the upstream recipe. `vccplus-project.json` declares
bundled decbfile, bcontrol, bsound and standalone-driver bindings and selects
the `all` disk target with a `DOS` launcher.
The top-level `CoCoLetters.DSK` is an intentional playable artifact. Generated object,
map/listing and incidental binary outputs are excluded. The public README,
actual screenshot and [validation record](VALIDATION.md) document the completed
installed build-43 public MCP build and observed run. Source import and later
hosting/avatar changes are separate events. The original archive and earlier
local project were not modified by this import.
## License scope
The application is licensed under **GPL-3.0-or-later**, except where individual
files state otherwise. Fonts, loader and word-list files retain their separate
public-domain notices. See [COPYING](COPYING) and the original source notices.
+36
View File
@@ -0,0 +1,36 @@
# Word Game
Copyright © 2026 Pierre Sarrazin <http://sarrazip.com/>
License: GNU GPL v3 or later, except where stated otherwise.
See file COPYING.
Home page: <http://sarrazip.com/dev/FIXME.html>
Insert the floppy disk that contains this game in drive 0,
then type DOS and press the Enter key.
# Requirements
## Hardware
* CoCo 3.
* RGB monitor.
* Floppy disk controller.
## Software
These libraries are needed to build this game from its source code:
* decbfile (>= 0.1.13)
* bcontrol (>= 0.1.6) (keyboard and joystick support)
* bsound (>= 0.1.4) (sound)
They can be obtained from the CMOC Home Page.
# Version history
0.1.0 20??-FIXME First public release.
+59
View File
@@ -0,0 +1,59 @@
# CoCo Letters installed-app validation
Verified **November 9, 2026** through the installed VCC Plus public MCP build
and disposable-playtest interface. The selected build and displayed state are
qualified below; this is not a full gameplay or regression-suite claim.
## Configuration
- VCC Plus **3.5.0 build 43**, bundled compiler/Make/disk tools.
- An isolated native copy of the installed app preserved the active CoCoMan
workspace. Its emulator code was unchanged; the bundle identity was changed
and the copy was ad-hoc signed for isolation.
- **Release**, **512 KB RAM**, **MC6809**, **Disk BASIC**.
- Approved Make recipe: `Makefile`; public build action: `disk`; target: `all`.
- Declared launch command: `DOS`.
- Declared bundled dependencies: decbfile, bcontrol, bsound and the separately
noticed standalone disk driver. The ordinary decbfile API and that optional
driver have distinct licensing notices.
## Build evidence
- Project ID: `27785999-3B78-416C-B286-F9E2FAF5B032`; source revision: `1`.
- Recipe ID: `717d0162c8a46ecbef1293e05748f9e7dea29911e997a5957f459ee96e068638`.
- Build ID: `0BD54AB7-4D5C-4C59-9F42-F751BE0A258A`; result: **succeeded**.
- Artifact ID: `276C97BD-F7E1-40B5-8A57-5357BB2F86C1`.
- `letters.bin`: **21,935 bytes**; SHA-256
`f26daa69d04abb84478f1ff6ae3490b82afe50c640354d29f596113cbf0c82e7`.
- `coco-letters-0.1.0.dsk`: **161,280 bytes**; SHA-256
`0b65f3b084063df01e34fee50d077f8108c0faa1c75fae95d6fdfde37648164e`.
The delivered `CoCoLetters.DSK` is byte-identical to the verified disk output.
No compiler warnings appeared in the available build log.
## Execution and screenshot
The dictionary loaded, then the RGB monitor (**R**), easy difficulty (**E**)
and user-first-turn (**U**) options reached the actual board and letter rack.
The 640 × 480 capture shows the user’s turn and starting-square instructions.
This goes beyond the earlier dictionary-loading screen; no word placement,
scoring, AI response or complete game was tested.
Dictionary loading was allowed an additional 3,000 video fields before the
RGB/easy/user-first selections. The MCP-owned run was `E5035C2A-A55C-4148-AAF1-4EE266A2DB28`. At gameplay capture it
had reached **4,332 video fields**, with **90,624 disk-read bytes**,
**0 disk writes**, and the same disk SHA-256 as the verified artifact.
The run was then stopped and its test disk retained by VCC Plus.
[The gameplay screenshot](screenshots/gameplay.png) is the actual **640 × 480**
framebuffer returned by MCP. SHA-256:
`9b293eaceead927f2e0745d7a32ae22b64ae48137eab62250829a9407f1ff804`.
The running.png image is the same board capture, replacing the initial loader-progress image.
## Scope
This establishes a fresh Release disk build, successful disk startup and the
specific displayed states and bounded inputs above. It does not claim full
rules/scoring/gameplay coverage, HD6309 execution, Intel/Rosetta qualification,
physical CoCo hardware or audible audio. No private connection grant or raw
host log is included.
Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB