Files
Quadrapassel/docs/IMPLEMENTATION_STATUS.md
T
Brian Holman d412e35c4e Implement CoCo 3 Quadrapassel and deliver build 01
Add gameplay, keyboard/joystick controls, disk-backed high scores and settings,
standard CMOC effects, and the approved C graphics renderer. Include the clearer
attributed font, title/credits updates, source-verified Modern and Classic (40.2)
scoring, meaningful regression fixtures, and recorded guest validation.

Deliver QUADPSL01.DSK with fresh high scores. Retain source, licenses and selected
guest evidence; exclude personal disks, private connections and build scratch.

Host rules/input/persistence/video checks and memory guards pass. Official
512 KB playtests pass the recorded checks; actual 128 KB/physical joystick
qualification and the normal-window buzzing retest remain pending.
2026-11-11 03:14:14 -07:00

165 lines
10 KiB
Markdown

# CoCo 3 implementation status — November 11, 2026
The current disk contains a playable CoCo 3 game with standard CMOC sound,
settings and disk-backed high scores. Actual 128 KB qualification remains
pending; CoCo 2 adaptation is deferred at Brian's direction.
## Current numbered delivery
Brian requested `QUADPSLxx.DSK` with a two-digit build number and fresh high
scores. The first is **QUADPSL01.DSK**, byte-identical to the clean official
artifact below. No QPSAVE files are included; old personal score disks remain
untouched. The next changed delivery is 02. See [BUILDS.md](BUILDS.md).
## Current title, scoring-label and audio follow-up
The standard Release candidate now has an eight-pixel gap before the title
copyright, the credits entry `Brian Holman - Mac & Coco`, and explicit
**Scoring Rules: Modern / Classic (40.2)**. Keep high scores is the default;
no personal records were erased. Inspection of Brian's supplied Mac source
confirmed the existing scoring formulas, including the Classic 40.2 bottom-row
bonus. All 25 cases also pass through actual piece drops.
Official build 51, project revision 2, build
`DFDE8C57-3165-44B5-9027-E8B2F16DDF28`, artifact
`BB277DE8-07A2-437B-9998-FFD1FB2C36C5`, zero diagnostics.
Clean disk SHA-256:
`4ac171e87c51dfd99b302b9e035a91a59c030144e5ae0661a6d2dfc84ba3a63f`.
Code/constants end $7AF4; static data end $13DE. The normal-window buzz persists
in Brian's prior candidate after restart and stops when paused; it remains
unconfirmed fixed. An extra standard-library mute after input sampling passes
worker silence/effect checks. Details, captures and score-preservation proof:
[TITLE_AND_SCORING_UPDATE.md](TITLE_AND_SCORING_UPDATE.md).
## Previous font candidate
The November 11 font/border/copyright candidate passed an official VCC Plus
3.6.0 (51) Release build and MC6809 / 512 KB disposable playtest. The font uses
Pierre Sarrazin's public-domain CardGame data, with attribution. Modern outlines
are dark gray while the background stays black. Title text is
`(c) 2026 Brian Holman`, displayed in the font's uppercase character set.
- Project `84772EFC-B651-4A98-B09E-932247575EA7`, revision 1.
- Build `FAD8FBEA-F07D-4FE8-AE45-E569EEA5E5CC`, artifact
`4566B606-6576-482A-BA3E-BCC673EC729B`; no compiler diagnostics.
- Binary 26,589 bytes, SHA-256
`9eec745d50544884d74211492f0118360d79212f05864d9e81fa43a1a56ed041`.
- Pristine DSK SHA-256
`12f0ee508d5b48bbbe44d1f2b701eb31ae5bd5d3cbb863e1005540524d5dbfb3`.
- Code/constants end $7AFE; static data end $13DD. Existing limits and
1,024-byte stack reserve retained. Further growth needs compaction.
- Pixel tests compare against the unmodified upstream font; palette, all seven
Modern tile colors, Plain/Clean behavior and edge-cell clipping pass under
AddressSanitizer/UndefinedBehaviorSanitizer.
- Actual title, settings and gameplay framebuffer captures inspected. Hold/drop
exercised; a normal settings save wrote the disposable disk successfully.
- Captured idle audio is zero in both channels; movement has a brief effect and
silent final 500 ms. Owned run stopped.
- New private disk copy preserves both existing high-score files byte-for-byte.
Details, screenshots, saved-disk identity and remaining limits:
[FONT_UPDATE.md](FONT_UPDATE.md). Persistence code and gameplay rules are unchanged;
prior cold-boot score evidence below remains applicable to that unchanged code.
Actual 128 KB and physical joystick qualification remain pending.
## Previous audio candidate — November 10 build identity
- Base Git revision: `8a4b44bc7358b1a999296d14d8c5272e57b65992`, main, with
uncommitted implementation. No implementation commit or push was requested.
- Official application: VCC Plus 3.5.5 (48), supported C-project MCP connection.
- Previous code build: project revision 16, Release,
build `CFC0A2F2-9247-4B1C-9CF8-8CC1AFE896B6`,
artifact `261716EE-81C8-487D-A7BF-E5C9F51BC044`.
- Binary: 26,370 bytes,
SHA-256 `5c9f3be05fde79e09a5a583740e676f2fb06eddc136dd9d419f62f12da6bebfe`.
- Previous pristine `Quadrapassel.DSK`: 161,280 bytes,
SHA-256 `d23bc2a1aa60970becaf7ff8be064efc8ea47a5043adf9661d9a6c22bcedfd9b`.
This matched that official MCP artifact, not a saved playtest copy.
- Linked code/constants end at $7AE8 (24 bytes before the enforced $7B00 limit).
Writable static data ends at $1318 (232 bytes before $1400). The stack reserve
is 1,024 bytes; detailed contract and qualification limits are in MEMORY_LAYOUT.md.
- The pristine disk has 50 free granules and no save files. Two 35-sector save
files need four granules each. DOS loader tracks are reserved by the template.
## Implemented
- All 28 piece states, safe above-board behavior, specified kicks, gravity,
hard/soft drop, persistent Hold swap, shadow and simultaneous compaction.
- Modern/Classic 32-bit saturating scoring, level transitions and Relaxed mode.
- Version-1 xorshift32 seeded stream, inverse-square balancing, prefill and
Difficult Pieces metric/selection. Difficult search is currently synchronous.
- Keyboard controls and a one-button joystick input state machine, settings,
seed editor, pause/actions/confirmation screens, score browser and initials.
- Code-drawn title and cached tiles; menu focus updates without full redraws.
Scene text is a bounded, checksummed disk asset sharing the display cache.
- Standard CardGame `initSound`/`beep` effects, with the standard bsound mute
helper closing audio around joystick sampling and between effects. No custom driver.
- Versioned QPSAVE0.DAT/QPSAVE1.DAT store for all 34 categories, ten records each,
initials and scoring-rule markers. CRC/range/length validation, generation
selection, older-slot recovery, header-last commits and readback verification.
Only those two named files are written; errors are visible and play can continue.
## Evidence and limits
| Check | Result |
| --- | --- |
| Host rule fixtures, sanitizer build | Passed: 28 states, all kick fixtures, bounds/top-out, compaction, 25 scoring cases, gravity, Hold, RNG/prefill and Difficult metrics |
| Host input fixtures, sanitizer build | Passed: repeat/conflicts/edges, fire timing, hysteresis, diagonal and disconnected-stick keyboard behavior |
| Host persistence fixtures, sanitizer build | Passed: 34 categories, stable ties, rule markers, 32-bit values, CRC, read-only reset, all 36 logical torn-write boundaries and recovery |
| Official Release build and memory bounds | Passed, final build above, no compiler diagnostics |
| MC6809 / 512 KB | Passed: DOS title, gameplay, movement/rotation/Hold/hard drop, settings, cached settings redraw and fast menu focus |
| Settings save and cold-boot reload | Passed on revision 12: Sound OFF and Custom Seed ON reloaded from the same disposable disk |
| Earned high score save and cold-boot reload | Passed on revision 12: seed zero, 12 authored placements, one line/40 points, initials BRH, Modern marker in difficulty-0 Normal category; survived another cold boot |
| Clean BASIC return and manual fallback | Passed on revision 13: Quit returned OK; PCLEAR1, LOADM"QUAD.BIN", EXEC reached the title |
| HD6309 / 512 KB | Revision 16 idle/effect audio checks and prior title/gameplay framebuffer smoke passed in reset emulation mode; not a native-mode qualification |
| Physical CoCo 3 / 512 KB | Brian reported successful gameplay on November 11, 2026 ("It worked great"); RAM confirmed as 512 KB. Exact disk hash, CPU upgrade status and individual audio/save/joystick checks were not specified |
| CoCo 3 / 128 KB | Pending actual application/manual test; MCP workers remain fixed at 512 KB |
| Physical joystick ports and joystick-only usability | Pending; logical fixtures/neutral samples are not physical-port passes |
| Guest read-only/corrupt media and interrupted FAT/directory writes | Pending; logical host fault tests do not establish these physical disk cases |
| Direct guest audio, idle/mute and bounded effects | Passed captured windows on 6809 and 6309; actual-app reported noise retest pending; see AUDIO_VALIDATION.md |
| Current input/render latency, sound-on worst case, clears and Difficult search | Not fully qualified; earlier renderer probe timing is not a complete-game timing pass |
| PAL/50 Hz, physical Intel, CoCo 2 | Not qualified by these runs |
| Debug/Probe configurations with the final split layout | Not qualified; use Release for this disk |
The earned-score run was `9AFA5124-4FDE-4E3D-95EE-228FCE945951`.
Its retained writable disk SHA-256 is
`44ca3987b8d3a1e02ee41f1a0de8bd587be5a6835f8bdc5186b22138e6be0355`.
That disk is separate from the pristine deliverable. All owned runs are stopped.
Final menu/cache and 6309 changes did not alter the validated persistence codec.
## Capture interpretation
Presented-frame PNGs sometimes omitted unchanged screen content during these
runs. The supported paused `capture_playtest_graphics` preview showed the title,
HUD/frame and cached settings intact in the current physical HSCREEN 2 buffer.
Visual verification therefore uses these direct guest-framebuffer previews in
addition to ordinary screenshots. No emulator internals were inspected and no
emulator change is required for the current disk.
Selected evidence is under docs/screenshots/, including
high-score-saved-512k.png, high-score-reloaded-512k.png,
title-clean-512k.png, gameplay-framebuffer-512k.png,
settings-cached-framebuffer-512k.png and
gameplay-6309-framebuffer-512k.png. Reference art is not runtime evidence.
Next qualification: follow TESTING_128K.md, measure complete-game latency and
Difficult search separately, then physical joystick/read-only/fault cases.
Further feature growth needs code compaction before exceeding the enforced limit.
## Latest user feedback and sound correction
Brian reported good keyboard pacing, then constant audio noise even while idle.
The standard-library audio routing correction and direct MCP stereo WAV checks
are recorded in [AUDIO_VALIDATION.md](AUDIO_VALIDATION.md). The isolated worker
did not reproduce the original constant noise; the actual application needs a
retest. The save codec and gameplay rules were not changed.
## November 11 — physical CoCo 3 playtest
Brian reported playing Quadrapassel successfully on a real Color Computer 3
and described it as working great. He confirmed the RAM size as **512 KB**.
This is user-reported physical-hardware gameplay evidence, separate from the
isolated emulator runs. It does not establish a 128 KB pass or separate passes
for the audio correction, persistence, joystick ports or every game option.
The exact tested disk/build and detailed machine configuration were not supplied.