Add Bone Quest anatomy quiz for CoCo

This commit is contained in:
Brian Holman committed 2026-11-11 21:00:21 -07:00
commit 3cc37be5fb
50 files changed
+10146

No files matched your search

+70
View File
@@ -0,0 +1,70 @@
# Bone Quest anatomy bank
The quiz identifies **25 major bones or bone groups** in the supplied anterior
skeleton illustration. It does not ask separately about every individual bone
in the adult skeleton. Left and right counterparts share one topic. Vertebrae
are grouped by region; the bones of each wrist, palm, hand digits, rear foot,
mid-foot and toes are also grouped.
`data/bones.json` is the canonical ordered bank. `src/bones.c` contains three
runtime fields: displayed name, short location hint, and pipe-separated accepted
aliases. Stable codes remain in JSON; fixed topic order binds artwork, history
and questions. `tools/prepare_questions.py` regenerates the C table. Names are at
most 22 characters and hints at most 30 characters.
## Naming choices
- **Cranium** follows the illustration's labeled grouping above the separately
drawn mandible. **Skull** is accepted as the familiar introductory term. This
is not a quiz distinguishing all cranial and facial bones. The skull includes
the mandible in complete anatomical descriptions; the game treats the lower
jaw as its own highlighted topic.
- **Pelvic girdle** means the paired hip bones here. The sacrum and coccyx are
separate topics. Bare **pelvis** is deliberately not an accepted alias because
the complete bony pelvis includes those additional bones.
- **Finger phalanges** includes the thumb. **Toe phalanges** is a separate topic.
Bare **phalanges** is not accepted for either because it cannot distinguish
the hand from the foot. **Finger bones / hand phalanges** and **toe bones /
foot phalanges** are accepted respectively.
- **Radius** and **ulna** are distinguished using the anatomical position: the
radius lies on the thumb side and the ulna on the little-finger side.
**Tibia** and **fibula** use the inner and outer sides of the lower leg.
- **Sternum** is the whole breastbone topic, including its manubrium portion;
the manubrium is not a second overlapping answer.
- Common names such as collarbone, shoulder blade, breastbone, kneecap,
thighbone, shinbone and tailbone are accepted. A location hint is not
automatically an accepted answer. Names of body regions such as **forearm**
or **foot bones** are too broad to identify one highlighted topic.
Canonical names and aliases are unique after lowercasing and collapsing spaces.
Case and extra-space handling belongs to the shared quiz normalization; this
bank supplies no ambiguous duplicate alias. The data contains no treatment,
injury or diagnostic questions.
## Primary references checked
The following OpenStax *Anatomy and Physiology 2e* sections were consulted to
verify names, group boundaries and location facts on November 11, 2026:
- [The skull](https://openstax.org/books/anatomy-and-physiology-2e/pages/7-2-the-skull)
- [The vertebral column](https://openstax.org/books/anatomy-and-physiology-2e/pages/7-3-the-vertebral-column)
- [The thoracic cage](https://openstax.org/books/anatomy-and-physiology-2e/pages/7-4-the-thoracic-cage)
- [The pectoral girdle](https://openstax.org/books/anatomy-and-physiology-2e/pages/8-1-the-pectoral-girdle)
- [Bones of the upper limb](https://openstax.org/books/anatomy-and-physiology-2e/pages/8-2-bones-of-the-upper-limb)
- [The pelvic girdle and pelvis](https://openstax.org/books/anatomy-and-physiology-2e/pages/8-3-the-pelvic-girdle-and-pelvis)
- [Bones of the lower limb](https://openstax.org/books/anatomy-and-physiology-2e/pages/8-4-bones-of-the-lower-limb)
These are factual verification references. No textbook passages, assessments or
artwork are imported into the game. The concise location hints are written for
this quiz; they are not quotations from the textbook.
## Diagram provenance
The visual reference is [Human skeleton front en.svg](https://commons.wikimedia.org/wiki/File:Human_skeleton_front_en.svg)
by **Mariana Ruiz Villarreal (LadyofHats)**. The author released it into the
public domain. The original Wikimedia description distinguishes labels for
individual bones from labels for groups. Bone Quest uses its selected group
names while keeping a single stable topic for paired counterparts. The retained
source SVG and source-receipt.json belong to the artwork workflow; generated
geometry and any simplifications must preserve this attribution and explain
what was adapted.
+18
View File
@@ -0,0 +1,18 @@
# Bone Quest implementation
Working checklist:
- [x] Create private VCCPlusApps/BoneQuest repository and separate main checkout.
- [x] Adapt the supplied public-domain SVG into compact per-topic graphics.
- [x] Verify25 major bones/bone groups and accepted answer aliases.
- [x] Implement anatomy-specific layout, two modes, feedback/review/replay.
- [x] Build with stock VCC Plus tools and create BONEQ.DSK.
- [x] Run host/geometry and isolated6809/6309 gameplay checks.
- [x] Retain representative real screenshots and usable build/play instructions.
Foundation: Capital Quest, revision afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6,
GPL-3.0-or-later. Its geography assets/manuals are not used by Bone Quest.
Skeleton: Mariana Ruiz Villarreal (LadyofHats), Wikimedia Human_skeleton_front_en.svg,
author's public-domain dedication; original retained under assets/ with hash receipt.
The quiz covers named major bones and groups shown in the diagram, not 206
individually selectable bones. Paired left/right examples share one question.
+54
View File
@@ -0,0 +1,54 @@
[
{
"file": "docs/images/title.png",
"width": 640,
"height": 480,
"sha256": "c760e20e70c3063f2938acad87c80979ef8f795ff981bfa3eacb6fff5b3db9f3",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Scripted validation includes deliberate incorrect answers."
},
{
"file": "docs/images/multiple-choice.png",
"width": 640,
"height": 480,
"sha256": "a0f272e2e0355260e27bfef6b5021e4cb984e054eac9e39a0f910f05af66e3c5",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Scripted validation includes deliberate incorrect answers."
},
{
"file": "docs/images/typed-answer.png",
"width": 640,
"height": 480,
"sha256": "f44cd5b9493a2b4704532f444f4666b536db375e4b7a6338683bcade9246444d",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Scripted validation includes deliberate incorrect answers."
},
{
"file": "docs/images/results.png",
"width": 640,
"height": 480,
"sha256": "81839f1acdf3511d62c52fc6fdc53df138a5b86048563628b450df6ffe7c6297",
"emulator": "VCC Plus 3.6.1 (54)",
"processor": "MC6809",
"ramKB": 512,
"video": "RGB",
"diskSHA256": "cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66",
"capture": "Unmodified guest frame from isolated keyboard-driven playtest",
"note": "Scripted validation includes deliberate incorrect answers."
}
]
+64
View File
@@ -0,0 +1,64 @@
# Initial Bone Quest verification — November 11, 2026
## Built and delivered
The root BONEQ.DSK is a standard 35-track DECB image, 161,280 bytes, SHA-256:
`cf9b2da5842551d76b58c3be2064a78163536526826fca13ac7ee58c269e1e66`
Built with installed VCC Plus 3.6.1 (54), bundled CMOC 0.1.100 and LWTools 4.25.
Release, Debug and Test disk builds passed. Program/static storage ends at
$764E (Release),$7687 (Debug),$7653 (Test), below the $7800 limit and separate
2 KB stack reservation. Two graphics pages retain the public GIME512 KB contract.
Generated skeleton geometry occupies 5,975 bytes; ordinary builds do not run an
SVG renderer or need Python/Pillow/rsvg-convert.
## Logic and artwork
make test passed: 50,000 option sets across 2,000 games, all 25 topics once per game,
four distinct choices, no consecutive repeated correct slot, all permitted
slot transitions, replay reset, canonical names/common aliases, known-wrong
name/alias priority, spelling checks, scoring and duplicate-answer guards.
All 25 authoring topics/aliases agree exactly with generated C. The original SVG
hash matches its receipt. Six geometry views have bounded, disjoint spans;
each topic has nonempty overview coverage, with detailed small-bone views.
## Feedback audio
Separate bounded correct/incorrect feedback captures contained nonzero 44.1 kHz
stereo PCM (peak 16128). Capture began at the actual feedback phase, before the
tones; no microphone or host audio device was used. This establishes generated
guest signal, not audible listening or comprehensive frequency analysis.
## Actual gameplay
The actual Release disk completed a 25-question multiple-choice game AND a
25-question typed game on each emulated MC6809 and HD6309, with512 KB RAM,
CoCo 3 BASIC, FD-502 Disk BASIC and RGB video. Tests used isolated app-owned
machines and disposable disk copies; no personal emulator or desktop input
was controlled.
The driver decoded displayed text against the matching linked font and checked
the skeleton's actual pixels against the topic masks and answer history. It
verified question numbers, readable choices, current highlighting, purple/red
progress, no consecutive correct-slot repeats, held-key protection, deliberate
wrong answers, common aliases, case/spacing, spelling retry and Backspace,
33-character entry bounds, reveal, scores 20/25 (80%), one correction, paged
review, neutral replay title and clean return to BASIC. Both runs preserved the
disk hash and reported zero guest writes.
To repeat these developer checks, provide your own ROM paths explicitly:
```sh
python3 tests/playtest.py --rom /path/to/coco3.rom --disk-rom /path/to/disk11.rom
```
The harness uses the installed app's isolated helper and is qualified against
the build identified above; it is not a general alternate MCP server. Private
ROMs, raw captures, result JSON and build outputs stay ignored under test-output/.
Selected unchanged guest frames are retained in docs/images/ and identified by
docs/SCREENSHOTS.json. They are actual game frames, not native-window marketing
captures or mockups.
No physical CoCo, host Intel, macOS 14 or audible listening qualification is
claimed. Native editor/source-open UI is not exercised by the headless tests.
Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB