95 lines
5.8 KiB
Markdown
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.
|