Files
Quadrapassel/docs/IMPLEMENTATION_STATUS.md
T
Brian Holman 2e163049d1 Fix joystick fire ghost keys and independent axis arming
Filter keyboard rows grounded by joystick buttons before processing actions,
preventing right fire from acting as A/D/E and undoing its release rotation.
Arm X and Y independently so an uncentered vertical axis cannot block steering.

Reproduce both defects in host regressions, retain ordinary CMOC input APIs,
and update official project membership. Compact unchanged display data and make
render profiling optional to preserve the original memory and stack bounds.

Deliver QUADPSL02.DSK with fresh scores. Retire the old artifact from tracking
while leaving the loaded local disk untouched. Host suites, official Release
build and MC6809/512 KB keyboard/audio smoke checks pass. Actual joystick-port
confirmation and the reported normal-window buzz remain pending.
2026-11-11 13:27:18 -07:00

179 lines
11 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 joystick correction — build 02
QUADPSL02.DSK fixes shared fire/keyboard input lines and arms joystick axes
independently. Both reported failure patterns were reproduced in host regressions
and pass after correction. Standard CMOC APIs are retained. Official VCC Plus
3.6.1 (53) Release build and MC6809/512 KB keyboard/gameplay smoke checks pass;
physical joystick testing is still pending. Details, source references and final
identity: [JOYSTICK_FIX.md](JOYSTICK_FIX.md).
Clean disk SHA-256:
`4e3af2440a3195ee5864498e39a779362988257d8a39cfc1c413157ace287a3c`.
Code/constants end $7AF6, static data end $13F6; original stack/bounds retained.
The normal-window buzz remains open. Old personal score disks are untouched.
## Earlier 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.