Publish Bone Quest player manual and release sources
This commit is contained in:
1 parent
2ceb44a48c
commit
ea87321e61
22 files changed
+996
-3
No files matched your search
@@ -0,0 +1,94 @@
|
||||
# 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.
|
||||
Reference in new issue
Block a user