Files
BoneQuest/docs/PUBLIC_RELEASE.md

95 lines
5.8 KiB
Markdown

# Bone Quest dated edition 2026-11-11
Brian approved the complete Bone Quest release treatment, including the online
manual, PDF, native disk and editable sources. Getting Started integration is
queued for a later VCC Plus build; this game publication does not require a new
emulator build or a new VCC Plus product release.
The accepted game implementation is revision
`2ceb44a48ce45382ab5a531a1db9341de69ca6ca`. The approved 161,280-byte BONEQ.DSK
has SHA-256 `373a3f387daf541b1eb4edd3421a125dd57094e600ee48d162802ac22f65ceba`.
Documentation, public-source cleanup and packaging preserve those exact bytes.
The release descriptor records the final source/documentation commit.
## Game and graphics qualification
The Release disk completed both 28-question modes on emulated MC6809 and HD6309
with 512 KB RAM, RGB and FD-502 Disk BASIC. Actual displayed text and all six
skeleton/detail views were checked against the questions/history. This includes
nonrepeating correct slots, white normal/correct structures, red misses, yellow
current structures, aliases, spelling retry, Backspace, blank-answer reveal,
33-character entry bounds, scoring, missed-answer review, replay and exit.
Sixteen targeted global-exit scenarios across both CPUs verified Q/q, native
Escape/Break and ASCII 27, questions, spelling, both feedback paths, credits
and title; full rounds also quit directly from missed review. Disk writes were
zero and the loaded disk identity stayed unchanged.
Host logic checked 56,000 option sets over 2,000 complete shuffles, all permitted
slot transitions, matching/scoring/reset and generated table/geometry identity.
The unchanged graphics fixture qualified packed edges, bank seams, five-bank
pages, front-to-back copy, hidden edits staying hidden, clipping, MMU restoration
and BASIC return on both guest CPUs. Missing/wrong-size/wrong-checksum artwork
returned cleanly to BASIC. The [dated verification receipt](https://vccplus-git.brianholman.com/VCCPlusApps/BoneQuest/src/branch/main/docs/VERIFICATION.json)
remains in the public repository; raw private-input runs stay outside the starter.
Program/static storage ends at $73FD in Release, $745B in Debug and $7402 in Test,
below $7800 with a separate 2 KB stack. Optional authoring dependencies are not
needed by normal builds. Separate correct/incorrect feedback captures contain
nonzero guest signal; audible listening is not claimed.
## Reproduction and source packages
The source starter wraps the selected project in BoneQuest/, preserving the
Makefile, root headers, main.c, generated C metadata, BONES.DAT, original SVG,
authored data, conversion scripts, notices, useful optional tests and complete
player manual. Its configuration is BoneQuest/vccplus-project.json; entrySource
is main.c relative to that directory. The original .gitattributes keeps the SVG
byte contract and DAT binary treatment. The prebuilt disk is distributed
separately rather than imported into the editable starter.
The separate matching library-source companion preserves compiler/runtime,
keyboard, font, bank/input and ROM-backed DECB sources with exact file notices,
source hashes and target-only reconstruction instructions. Its rebuilt used
archives/objects match the installed build 54 toolchain; see PROVENANCE.md.
The complete custom graphics implementation remains in the game source package.
No ROM, standalone Disk BASIC-derived driver or replacement keyboard is added.
The reproducible release tool is tools/package_release.py. It accepts reviewed
source, the frozen library-source preparation directory, a reviewed PDF and the
final source revision, then writes deterministic native/source/library ZIPs,
cover/hero copies, the source member manifest, exclusive-title.json and
ARTIFACTS.json. The native ZIP contains the exact BONEQ.DSK and NOTICE.txt.
Every delivery URL is content addressed using its actual hash. The approved disk
is checked before packaging. Optional --qualify builds the extracted source with
the installed bundled tools in separate Release/Debug/Test output directories;
Release must reproduce the approved disk byte for byte.
The normal build uses CMOC 0.1.100, LWTools 4.25, Make, Perl and libraries supplied
by VCC Plus. Qualification limits PATH to that toolchain plus /usr/bin:/bin and
disables host SDK/developer-tool lookup. Python/Pillow/rsvg-convert authoring,
Xcode, Homebrew and a host C compiler are not ordinary build prerequisites.
Python is needed only to run the optional packaging/test drivers themselves.
The retained official VCC Plus 3.6.2 (55) app was inspected read-only. Its nine
relevant runtime/library artifacts are byte-identical to the qualified build 54
inputs. A clean extracted starter built all three configurations using the
public build 55 toolchain; Release reproduced the approved disk exactly, with
the same Release/Debug/Test program ends recorded above. No host app was rebuilt
or installed. Full gameplay qualification remains the build 54 checks described
above; the public 55 check establishes ordinary source-build reproduction.
## Manual and publication boundaries
The authoritative GFM player guide is docs/manual/BONEQUEST.md with metadata
and selected unmodified guest captures. Its online route is
https://vccplus.brianholman.com/games/bone-quest/ . The PDF uses the shared VCC Plus
manual exporter and visual review procedure. The website owns import, upload and
publication; validated receipts identify what is actually hosted. The final
source commit, public repository and download records are distinct from a local
build. Native Getting Started changes are queued for the app owner and must
preserve existing writable cached media and restart safeguards.
No physical CoCo, physical Intel Mac, macOS 14, native-window/source-open workflow
or audible listening qualification is claimed here. Public guest captures do
not imply native marketing-window verification.