From afa6f3c2a05cbd71c1f22ec3506f4f63421b2bc6 Mon Sep 17 00:00:00 2001 From: Brian Holman Date: Wed, 11 Nov 2026 19:27:51 -0700 Subject: [PATCH] Prepare Capital Quest public edition and player manual --- .gitignore | 3 + AGENTS.md | 35 +++ CAPITAL.DSK | Bin 161280 -> 161280 bytes README.md | 169 +++++++-------- docs/ANSWER_SLOTS.md | 45 ++++ docs/MAP_PROGRESS.md | 47 ++++ docs/PROVENANCE.md | 76 +++++++ docs/PUBLIC_RELEASE.md | 59 +++++ docs/TESTING.md | 8 +- docs/images/multiple-choice.png | Bin 14168 -> 15540 bytes docs/images/title.png | Bin 17559 -> 17128 bytes docs/manual/CAPITALQUEST.md | 248 ++++++++++++++++++++++ docs/manual/README.md | 27 +++ docs/manual/images/correct-feedback.png | Bin 0 -> 7907 bytes docs/manual/images/credits.png | Bin 0 -> 7406 bytes docs/manual/images/exit.png | Bin 0 -> 11458 bytes docs/manual/images/hawaii.png | Bin 0 -> 8107 bytes docs/manual/images/incorrect-feedback.png | Bin 0 -> 8183 bytes docs/manual/images/input-limit.png | Bin 0 -> 8264 bytes docs/manual/images/missed-review.png | Bin 0 -> 5210 bytes docs/manual/images/multiple-choice.png | Bin 0 -> 7946 bytes docs/manual/images/northeast.png | Bin 0 -> 8803 bytes docs/manual/images/progress-map.png | Bin 0 -> 8118 bytes docs/manual/images/replay-title.png | Bin 0 -> 9237 bytes docs/manual/images/results.png | Bin 0 -> 5148 bytes docs/manual/images/revealed-feedback.png | Bin 0 -> 8214 bytes docs/manual/images/spelling-retry.png | Bin 0 -> 8209 bytes docs/manual/images/title.png | Bin 0 -> 9237 bytes docs/manual/images/typed-corrected.png | Bin 0 -> 7967 bytes docs/manual/images/typed-entry.png | Bin 0 -> 8187 bytes docs/manual/manual.json | 14 ++ docs/manual/screenshots.json | 238 +++++++++++++++++++++ main.c | 2 +- src/quiz.c | 14 +- src/ui.c | 13 +- tests/map_colors.py | 60 ++++++ tests/playtest_mc.py | 11 +- tests/playtest_typed.py | 8 +- tests/test_quiz.c | 28 ++- tools/package_source.py | 73 +++++++ 40 files changed, 1072 insertions(+), 106 deletions(-) create mode 100644 AGENTS.md create mode 100644 docs/ANSWER_SLOTS.md create mode 100644 docs/MAP_PROGRESS.md create mode 100644 docs/PROVENANCE.md create mode 100644 docs/PUBLIC_RELEASE.md create mode 100644 docs/manual/CAPITALQUEST.md create mode 100644 docs/manual/README.md create mode 100644 docs/manual/images/correct-feedback.png create mode 100644 docs/manual/images/credits.png create mode 100644 docs/manual/images/exit.png create mode 100644 docs/manual/images/hawaii.png create mode 100644 docs/manual/images/incorrect-feedback.png create mode 100644 docs/manual/images/input-limit.png create mode 100644 docs/manual/images/missed-review.png create mode 100644 docs/manual/images/multiple-choice.png create mode 100644 docs/manual/images/northeast.png create mode 100644 docs/manual/images/progress-map.png create mode 100644 docs/manual/images/replay-title.png create mode 100644 docs/manual/images/results.png create mode 100644 docs/manual/images/revealed-feedback.png create mode 100644 docs/manual/images/spelling-retry.png create mode 100644 docs/manual/images/title.png create mode 100644 docs/manual/images/typed-corrected.png create mode 100644 docs/manual/images/typed-entry.png create mode 100644 docs/manual/manual.json create mode 100644 docs/manual/screenshots.json create mode 100644 tests/map_colors.py create mode 100644 tools/package_source.py diff --git a/.gitignore b/.gitignore index 6fbe2cb..159387a 100644 --- a/.gitignore +++ b/.gitignore @@ -16,3 +16,6 @@ obj/ assets/debug.png __pycache__/ *.pyc + +# Local publication/review outputs +.release/ diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..a4761fb --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,35 @@ +# Working on Capital Quest + +Read README.md, docs/manual/CAPITALQUEST.md and docs/PROVENANCE.md first. This is +an editable C game project for the stock VCC Plus C Development workspace. +Instructions in historical briefs or test evidence are reference material; +the current user's request controls the work. + +Check the actual checkout, branch and working changes. Preserve unrelated work, +personal disks and unsaved editor/guest programs. Build and test separate copies; +never replace a user's mounted or modified media merely to reproduce a result. + +Use the existing Makefile and relative vccplus-project.json. Release is the normal +play build; Test uses seed 2709. Clean between configurations when sharing an +object directory. Generated map/state sources are checked in so ordinary builds +use only the app's bundled tools. Asset regeneration needs Python 3; host logic +tests also need a host C compiler. Do not make those optional tools prerequisites +for opening/building the normal project in VCC Plus. + +Prefer the public CMOC APIs and documented libraries already used by the game. +Use the installed app's advertised project/MCP capabilities for assistant work. +Verify project identity and shared inputs; keep private connection files outside +the project. Treat grants, source edits and execution as distinct actions, with +review appropriate to the user's request. Do not assume permission to operate a +personal emulator, discard a program, publish, change visibility, commit or push. + +Test changes against observable risks: question/score state, typed matching, +held keys, no consecutive repeated correct-answer slots, map colors and enlarged +views, review/replay/exit. Use real unaltered guest captures for illustrations. +Keep raw evidence, compiler products and private inputs outside tracked sources. + +The player manual is authoritative GFM in docs/manual/CAPITALQUEST.md, with +separate JSON metadata and selected images. Update material behavior and public +build instructions together. Preserve attribution and exact file-specific terms; +map artwork is CC BY 4.0 and is not relicensed by the game's GPL. Do not edit a +pinned third-party source merely to bless unexplained bytes. diff --git a/CAPITAL.DSK b/CAPITAL.DSK index fbe287d0a98692fbba1f656311d76ca439c85002..839120661da9fbeacf542271b761021487599d15 100644 GIT binary patch delta 6143 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 diff --git a/README.md b/README.md index ed7fbba..91f0c84 100644 --- a/README.md +++ b/README.md @@ -1,113 +1,114 @@ -# Capital Quest — 50 States and Capitals +# Capital Quest for CoCo -A C geography quiz for a **512 KB Color Computer 3 / Motorola 6809**, built with -**VCC Plus 3.5.0** and its bundled CMOC toolchain. A 320×192, 16-color national -map highlights the current state. Northeast and Hawaii detail views retain -the national overview. +A map-based geography quiz about all 50 United States and their capitals, designed +by Brian Holman with assistance from ChatGPT/Codex. Play with four capital choices +or type each answer. Review the states you missed when the journey ends. -The application was generated with **ChatGPT Codex** using **GPT-6.1 Sol High**, -following the project brief in [CHATGPT_PROMPT.md](CHATGPT_PROMPT.md). Development -included builds and gameplay tests through VCC Plus’s public MCP interface. +![Capital Quest title and mode selection](docs/manual/images/title.png) -## Download +## Play -Download the ready-to-run [CAPITAL.DSK](CAPITAL.DSK) included at the repository -root. Mount a copy in VCC Plus with a **512 KB CoCo 3 / 6809 Disk BASIC** setup, -then type **DOS**, or `LOADM"CAPITAL.BIN":EXEC`. +Use a **Color Computer 3 with 512 KB or more, BASIC, an FD-502 Disk BASIC +controller, and a keyboard**. RGB is the tested display presentation. MC6809 and +HD6309 have been tested in VCC Plus; this is not physical-hardware qualification. +The two graphics pages reserve 64 KB outside a 128 KB machine's RAM, so this +edition requires 512 KB even though it does not use all installed memory. -## Build and play +Download [CAPITAL.DSK](CAPITAL.DSK), preserve your existing guest work, insert a +copy into **FD0**, and **Cold Restart**. At the Disk BASIC `OK` prompt, type `DOS` +and press Enter. Alternatively use `LOADM"CAPITAL.BIN":EXEC`. The game does not +write to its disk, and a write-protected copy is suitable for play. -1. In VCC Plus, choose **Develop → C Development → Open**, and select this folder. -2. Select **Release**, then **Build** (the declared target builds the disk). -3. Use **Show Build Products** to find `build/CAPITAL.dsk` and `CAPITAL.bin` in - the workbench's build snapshot. A delivered copy is also in this checkout's - ignored `build/` folder after the implementation session. -4. Mount your own copy of `CAPITAL.dsk` in a 512 KB 6809 Disk BASIC machine. - Type **DOS**, or `LOADM"CAPITAL.BIN":EXEC`. Keep personal media separate. +Read the [complete player manual](docs/manual/CAPITALQUEST.md) for every screen, +control and answer rule. The [online guide](https://vccplus.brianholman.com/games/capital-quest/) +is the shared reading edition. -Title: **1** multiple choice, **2** type the capital, **C** credits, **Q** quit. -Multiple choice: **1–4**. Typed answers: letters/spaces/periods, **Backspace** -(CoCo Left) and **Enter**. The Mac's Escape maps to CoCo Break and reveals an -answer. A near spelling offers **R** to edit the existing answer or **V** to -reveal. Only an exact/accepted alias earns a point. A successfully corrected -answer earns one point and increments the separate correction count. -Both modes play a rising tone for a correct answer and a lower, falling tone -for an incorrect answer, using the CoCo's built-in sound output. No sound -cartridge is needed. Multiple-choice feedback advances automatically after -the tone and a 1.5-second reading pause. In typed mode, **Space** advances after -feedback. Release answer keys before answering the next question; a held key -cannot submit another answer. +- Title: **1** multiple choice, **2** typed answers, **C** credits, **Q** quit. +- Multiple choice: **1–4**. The correct slot is random, excluding the previous + question's correct slot. The first question may use any slot. Feedback advances + automatically after its tones and reading pause. +- Typed answers: letters, spaces and periods; **Backspace** edits and **Enter** + submits. Case and extra spaces do not matter. Saint Paul, St Paul and St. Paul + are accepted. A close spelling offers **R** to retry or **V** to reveal. + **Esc/CoCo Break** reveals while editing. **Space** advances after feedback. +- Map: **teal** unanswered, **purple** correct, **red** incorrect, **yellow** + current. Northeast and Hawaii details use the same colors. +- Results: **R** review, **N** next review page, **B** back to results, **P** play + again, **Q** quit to BASIC. Release keys between presses. Scores and progress + are not saved; a new quiz clears them. -After all 50 questions: **R** paginated missed-answer review, **N** next review -page, **B** results, **P** play again, **Q** return to BASIC. Replay returns to -the mode menu. Normal games mix BASIC timer values, waiting-loop timing and -start input into the random seed. The program uses the CoCo 3's documented -high-speed clock during play and restores normal speed on exit. +## Build your own copy in VCC Plus -## Reproduce from the command line +1. Download/extract the source project or clone this repository into a new, + writable folder. Preserve a clean disk and any source changes you already have. +2. In VCC Plus, choose **Develop → C Development…**, then open the folder that + contains `Makefile`, `main.c` and `vccplus-project.json`. +3. Select **Release**, then **Build**. The declared target builds the disk. +4. Use **Show Build Products** to find `build/CAPITAL.dsk` and `build/CAPITAL.bin` + in that build's snapshot. Mount a copy with the setup above and run `DOS`. -The workbench is the supported build/test path. An equivalent offline build -uses the *installed* app's bundled tools, without an emulator source checkout: +The project uses VCC Plus's bundled CMOC 0.1.100, LWTools 4.25, Make, Perl and +libraries. Ordinary game builds need no Xcode, Command Line Tools, Homebrew or +system Perl. Generated map/state C files are included. Opening source does not +build or run it automatically. Read [provenance and notices](docs/PROVENANCE.md) +before redistributing modifications. + +An equivalent command-line build uses the installed app's tools: ```sh export PATH="/Applications/VCC Plus.app/Contents/Resources/Toolchain/bin:$PATH" -make clean make VCC_CONFIGURATION=Release disk ``` -`Release` uses `-O2`. `Debug` retains frame pointers while using `-O2` to -fit the complete game in the same strict memory budget. `Test` uses `-O2` -and seed **2709** for reproducible -ordinary gameplay. Clean before switching configurations because the Makefile -uses a common object directory. VCC Plus builds fresh snapshots automatically. - -Code and static data are linked at `$2000`, limited to below `$7800`, with a -2 KiB stack allowance below `$8000`. The public GIME library reserves physical -`$40000–$4FFFF` for its two graphics pages. No raw graphics/MMU register writes, -SVG parsing, dynamic allocation or disk writes occur during quiz play. +`Release` uses `-O2`; `Debug` retains frame pointers with `-O2` to fit the same +memory budget. `Test` uses `-O2` and seed **2709**. Clean before switching +configurations in one working folder because the Makefile shares `obj/`: ```sh -python3 tools/prepare_assets.py # offline map/data generation -make test # host logic and geometry checks +make clean +make VCC_CONFIGURATION=Test disk ``` -The editable inputs are `data/states.tsv`, `data/map-seeds.json`, -`assets/usa-source.svg`, `main.c`, `src/quiz.c`, `src/ui.c` and the root-level -`quiz.h`, `ui.h` and `map_data.h` headers. Keeping project headers beside -`main.c` also makes them available to VCC Plus's isolated build snapshots. Generated drawing -and state C files are retained for toolchain-only builds. Generated build outputs -are ignored; the root-level `CAPITAL.DSK` is the checked-in playable release. -The public MCP JSON-RPC client in `tools/vcc_mcp.py` takes an exported -private grant path; keep that grant outside Git. See [test evidence](docs/TESTING.md) -for baseline emulator coverage, [feedback tests](docs/FEEDBACK_TESTING.md) -for the sound and automatic-advance checks, and [credits](assets/CREDITS.md) -for map attribution and licenses. +Code/static data are linked at `$2000`, below `$7800`, with a separate 2 KB stack +allowance below `$8000`. Graphics use the public GIME library's two reserved +physical pages at `$40000–$4FFFF`. -For the complete public-MCP regression suite, export a private connection with -both Make and disposable playtests enabled, then run: +## Editable inputs and optional tests + +`main.c`, `src/quiz.c` and `src/ui.c` implement play. `data/states.tsv`, +`data/map-seeds.json` and `assets/usa-source.svg` are the editable data/artwork +inputs. `src/states.c` and `src/map_data.c` are generated and retained. Root-level +headers remain available to isolated C-workspace builds. + +Python 3 is required only for optional asset regeneration and test scripts: ```sh -PYTHONDONTWRITEBYTECODE=1 python3 tests/playtest.py /private/path/connection.json \ - --evidence /tmp/capital-quiz-evidence +python3 tools/prepare_assets.py +make test ``` -This builds the advertised Test configuration, plays two complete quizzes with -ordinary physical keys, checks actual framebuffer text and state fill pixels, -and retains the test disks. Evidence stays outside the checkout until tests -finish so VCC Plus's watched source revision remains stable. +`make test` additionally needs a host C compiler. It checks state shuffles, +unique choices, nonrepeating correct slots, matching, scoring, reset and geometry. +These extra prerequisites do not apply to an ordinary in-app disk build. -## Sample screens +For assistant-assisted development, review **Assistant… → Files shared**, enable +**Use Project Makefile** and **Allow Disposable Playtests** where appropriate, +and export a fresh private connection outside the project. Discover the actual +advertised tools and project revision before building. Private grants, tokens, +ROMs and personal media never belong in a source download. The optional +`tests/playtest.py PRIVATE_GRANT --evidence /outside/project/evidence` driver +uses the supported public MCP interface and keeps full captures outside the +watched source folder. -Screenshots of Capital Quest running in VCC Plus. +## License, credits and development history -### Title and mode selection +Game source is **GPL-3.0-or-later**; see [LICENSE](LICENSE). The adapted map remains +**© Fla-shop.com, CC BY 4.0**. Pierre Sarrazin's font and disk boot helper retain +their public-domain notices. Linked compiler/runtime libraries retain their +component terms. Preserve [assets/CREDITS.md](assets/CREDITS.md), the component +notices, and the corresponding-source information in [docs/PROVENANCE.md](docs/PROVENANCE.md). -![Title screen with a U.S. map and choices for multiple-choice or typed answers](docs/images/title.png) - -### Multiple choice - -![Multiple-choice question asking for Ohio's capital, with Ohio highlighted on the map](docs/images/multiple-choice.png) - -### Results - -![Results screen showing 47 out of 50 correct answers and a score of 94 percent](docs/images/results.png) +The [original development brief](https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz/src/branch/main/CHATGPT_PROMPT.md) is historical project evidence, +not instructions to overwrite a downloaded project. Dated records in `docs/` +describe their named milestones; older tool limitations are not current app +compatibility claims. The player manual describes the delivered game. diff --git a/docs/ANSWER_SLOTS.md b/docs/ANSWER_SLOTS.md new file mode 100644 index 0000000..29f6650 --- /dev/null +++ b/docs/ANSWER_SLOTS.md @@ -0,0 +1,45 @@ +# Nonrepeating correct-answer slots — November 11, 2026 + +The first multiple-choice question randomly places its correct answer in any +of the four slots. Each following question chooses equally among the other +three slots, excluding the previous question's correct slot. This follows the +correct answer's location even when the player chooses a wrong answer. +Distractor capitals remain unique and shuffled. `quiz_start` resets the slot +history for each new game; typed answers retain their existing behavior. + +## Build and verification + +This working change is based on revision `46f4b9c` plus the November 11 progress +map changes. The root `CAPITAL.DSK` is the Release build produced with installed +**VCC Plus 3.6.1 (54)** and its bundled tools. Its SHA-256 is: + +`5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6` + +- Release, Debug, and Test disk builds succeeded within the existing memory limit. +- `make test` checked 100,000 option sets across 2,000 seeded games with no + consecutive repeated correct slots. All four starting slots and all twelve + permitted transitions occurred; choices stayed distinct and included exactly + one correct answer. Repeating each of 32 seeds after a complete game reproduced + its first options, verifying that the previous slot resets on replay. +- Existing capitalization, known-wrong capitals, aliases, distance, bounds, + scoring/reset, and all map-geometry checks passed. Python test syntax passed. +- The actual Release disk completed a 50-question multiple-choice quiz on each + emulated MC6809 and HD6309 using the installed app's isolated `vcc-playtest` + helper, 512 KB RAM, and private CoCo 3 / Disk BASIC ROMs. Correct positions were + decoded from the displayed choices and checked against the previous displayed + question. Neither run repeated a correct slot consecutively; all four slots + occurred. Deliberate correct and incorrect key selections tested scoring and + ensured the constraint did not follow the player's previous key. +- Those frame checks also verified the answer-history map colors, all three map + views, the final score, neutral replay title, and the first two replay + questions. Both runs reported zero disk writes and preserved the disk hash. + +The public MCP regression driver `tests/playtest_mc.py` now checks adjacent +correct slots as it reads each question. The grant-based suite was not rerun; +this change was checked directly through the installed helper. Raw captures, +slot-sequence receipts, and logs remain in ignored local build storage. The +normal emulator and personal media were not used. No physical CoCo or host +Intel qualification is claimed by these checks. + +See [the preceding progress-map record](MAP_PROGRESS.md) for the map design +and the unchanged 512 KB graphics-memory requirement. diff --git a/docs/MAP_PROGRESS.md b/docs/MAP_PROGRESS.md new file mode 100644 index 0000000..0bef333 --- /dev/null +++ b/docs/MAP_PROGRESS.md @@ -0,0 +1,47 @@ +# Answer-history map colors — November 11, 2026 + +The map now uses light teal for unanswered states, dark purple for correct +answers, red for incorrect answers, and yellow for the current question. +The national, Northeast, and Hawaii views share this rule. Yellow remains on +the active state during its feedback screen; its answer color appears when the +next question opens. The ordinary right panel shows a four-color legend. +The title map is neutral, including after replay, and a new quiz clears all +answer history through the existing `quiz_start` path. + +## Build and verification + +The working change is based on project revision `46f4b9c`. The delivered +`CAPITAL.DSK` was built as Release with the bundled tools from installed +**VCC Plus 3.6.1 (54)**. Its SHA-256 is: + +`6f2caa988f7f27a31d8dcb4509e107c2f6ec6d5a6c8483ae0d1676b9413d03bd` + +Validation used that installed application's isolated `vcc-playtest` helper, +512 KB RAM, and private CoCo 3 / Disk BASIC ROMs. Keyboard input performed the +answers. Read-only linker symbols selected test answers and checked progress; +no guest memory or registers were modified. Actual PNG frame pixels were +checked against the generated state masks and the expected answer history. + +- **MC6809:** DOS boot; complete 50-question multiple-choice game with correct + and incorrect answers; all 50 states and the national, Northeast, and Hawaii + views; score; neutral replay title; a new typed quiz with correct and incorrect + answers; three typed answers and the following question's map. +- **HD6309:** DOS boot; three multiple-choice answers, national and Northeast + views; cold restart; three typed answers and the following question's map. +- Both runs preserved the original disk bytes and reported zero disk writes. +- `make test` passed: 2,000 shuffles, 100,000 choice sets, capital classification, + scoring/reset checks, and all map-geometry checks. Python test syntax passed. +- The existing public MCP regression drivers now use `tests/map_colors.py` to + check answer-history colors throughout both complete quizzes. The same pixel + checker was exercised by the direct-helper checks above; the grant-based + end-to-end suite was not rerun for this change. + +The title and multiple-choice sample images in `docs/images/` are actual frames +from this validation. Raw captures and receipts remain in local ignored build +storage. No normal emulator session or personal media was used. + +The graphics layout still requires **512 KB**. The public GIME library reserves +64 KiB at physical `$40000–$4FFFF` for its two display pages; these addresses are +outside a 128 KB machine's RAM. This requirement does not imply that the game +uses all 512 KB. No physical CoCo, host Intel, composite-video, or audible-audio +qualification is claimed by these checks. diff --git a/docs/PROVENANCE.md b/docs/PROVENANCE.md new file mode 100644 index 0000000..409a5e2 --- /dev/null +++ b/docs/PROVENANCE.md @@ -0,0 +1,76 @@ +# Sources, attribution and licenses + +Capital Quest is Brian Holman's C geography quiz, developed with assistance from +ChatGPT/Codex. Its historical CHATGPT_PROMPT.md records the original brief and a +later sound/progression addendum. The delivered project also includes subsequent +progress-map colors and nonrepeating correct-answer positions. This is a record +of actual sources and components, not a claim of clean-room reimplementation or +an unedited one-prompt generation. + +## Game and manual + +The game source is distributed under GPL-3.0-or-later; LICENSE retains the full +GPL version 3 text. The player manual is © Brian K. Holman 2026 and +GPL-3.0-or-later. These statements do not replace a component's own terms. + +## Map and state data + +The retained assets/usa-source.svg is © Fla-shop.com, CC BY 4.0. Original: +https://www.fla-shop.com/svg/usa/usa-albers-2000-1200.svg +License: https://creativecommons.org/licenses/by/4.0/ +Source SHA-256: c698d71ce9667e8f4500dec6479bdb91d2bab2c26fa82ada6bc9c73746427771 + +The original copyright/license comment is preserved. Adaptations include region +assignment, reduced resolution, simplified boundaries, recoloring, run-length +encoding and enlarged Northeast/Hawaii crops. The map, generated spans, previews +and map-containing screenshots retain that attribution. Insets are not to common +scale; no endorsement is implied. Full notice: assets/CREDITS.md. + +State names, postal codes and capitals are the 50-row factual dataset in +data/states.tsv. data/SOURCES.md preserves the verification sources and explains +the canonical ordering and Saint Paul aliases. tools/prepare_assets.py generates +src/states.c, src/map_data.c, geometry metadata and previews offline; generated +C is retained so normal builds need not parse an SVG or run Python. + +## Linked components and matching sources + +- Pierre Sarrazin's font5x8 has an explicit public-domain dedication, retained + with its source/header in the companion. The linked font comes from HiresTxt. +- tools/boot.c adapts Pierre Sarrazin's public-domain autostart.c 0.1.2 to load + CAPITAL.BIN; its original header remains in the file. +- BControl 0.1.6 provides Keyboard_init/poll/shutdown. Its full original sources + and notice are preserved. The Keyboard.c header says public domain except + the parts that come from Color Basic. Preserve that source-specific wording; + the game's GPL does not rewrite it. See assets/BCONTROL-NOTICE.txt. +- VCC Plus's gime.c and vcc/gime.h declare GPL-3.0-or-later. The matching source, + public header and COPYING are included in the companion. +- CMOC 0.1.100 supplies the CRT, standard and BASIC-backed floating-point runtime + used by the CoCo build. The companion includes the pinned source snapshot, + original notices, import/compiler patches and build references. It also has a + target-only library rebuild driver using installed VCC Plus tools. + +Download the [matching library-source companion](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Sources/Exclusives/CapitalQuest/2026-11-11/43fcd00f12ef/Capital-Quest-Library-Sources.zip). +It is separate from the small writable C-workspace starter so opening a game does +not import hundreds of compiler files into the project. SOURCE_INVENTORY.json +pins component files and their upstream/patched provenance. Individual runtime +objects and the GIME/BControl archives were reconstructed and compared to the +installed toolchain. The companion keeps original file-specific terms and +contains no private ROM images, private runtime inputs or compiled binaries. + +The ordinary game Makefile uses VCC Plus's bundled compiler, assembler, linker, +Make, Perl and libraries. It does not require a host compiler or Apple SDK. +Rebuilding the host CMOC compiler from its source is a different developer task +with additional dependencies, explained in the companion. + +## Edition identity and validation + +The November 11, 2026 edition retains the approved CAPITAL.DSK unchanged: +5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6 + +Base repository revision: 46f4b9cae00951b9924af129b9f74e912766fff8, plus approved +map and answer-slot changes. Exact compile-input fingerprint: +3c4f15d6488ac5d49906d0b5d8229768046196337599259ac5d719aa279e7d56 + +Public-source/documentation cleanup changes no game source, build recipe, +compiled data or executable bytes. See docs/PUBLIC_RELEASE.md for qualification, +and docs/manual/screenshots.json for selected unmodified guest capture hashes. diff --git a/docs/PUBLIC_RELEASE.md b/docs/PUBLIC_RELEASE.md new file mode 100644 index 0000000..2b3e513 --- /dev/null +++ b/docs/PUBLIC_RELEASE.md @@ -0,0 +1,59 @@ +# Capital Quest dated edition 2026-11-11 + +This edition is the unchanged 161,280-byte CAPITAL.DSK with SHA-256 +5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6. +It includes answer-history map colors and nonrepeating correct-answer slots. + +The accepted source is based on public revision 46f4b9c plus those changes; +the exact compile-input fingerprint is +3c4f15d6488ac5d49906d0b5d8229768046196337599259ac5d719aa279e7d56. +The cleanup adds public instructions, player documentation, selected captures, +source packaging and attribution, without changing gameplay or disk bytes. + +## Reproduction and runtime checks + +A fresh copy built Release using only the retained public VCC Plus 3.6.1 (53) +app's bundled toolchain and a PATH limited to its bin plus /usr/bin and /bin. +The resulting disk matched the accepted SHA-256 exactly. No Xcode, Apple SDK, +Homebrew command, system Perl, private build dependency or optional ROM-derived +standalone disk driver is required by this recipe. + +The same disk also builds with local app3.6.1 (54); Release, Debug and Test builds +passed. Host logic tests checked 100,000 question sets across 2,000 seeds, with no +consecutive repeated correct slots, all twelve permitted slot transitions, +unique choices, reset, matching and scoring; geometry checks passed. + +Local build 54 runtime qualification completed a 50-question multiple-choice quiz +on each emulated MC6809 and HD6309, including displayed choice positions, map +colors, score and replay. Original public build 53 qualification completed a +50-question multiple-choice quiz, all three map views, score/review/replay, and +typed entry, Backspace, spelling retry/correction, wrong answer, length limit, +reveal and exit. Tests used separate 512 KB Disk BASIC guests and writable disk +copies; the original disk remained unchanged and guest disk writes were zero. + +Selected manual illustrations are unchanged displayed 320 × 192 guest framebuffers +from the official public build 53 helper. The return-to-BASIC illustration is an +unchanged full 640 × 480 frame. Capture hashes/configuration are recorded separately. +These are guest screenshots, not native-app marketing-window captures. + +## Public source package + +The primary source ZIP wraps the project in CapitalQuest/, preserving Makefile, +main.c, headers, generated sources, data/artwork inputs and vccplus-project.json. +The project's entrySource is main.c relative to that directory. Opening source +is separate from building/running it. The archive excludes Git data, historical +brief/evidence bundles, ROMs, private connections, compiler products and caches. +The historical brief remains linked in the public repository and Book 12. + +The separate library-source companion provides matching runtime/GIME/BControl/font +sources, original notices and target-library rebuild instructions. Component +terms remain intact; no replacement keyboard implementation is included. + +Privacy review covered all three reachable original commits and 64 unique blobs, +plus the working tree: no private keys, populated connection credentials, private +ROM payloads, personal absolute paths or private-network URLs were found. No +history rewrite was performed. Old development evidence remains clearly dated. + +No physical CoCo, physical Intel Mac, macOS 14 or audible listening qualification +is claimed by these checks. The native Getting Started/source-open integration +is a separate app feature, owned and validated by the VCC Plus app project. diff --git a/docs/TESTING.md b/docs/TESTING.md index 6ab3d1a..6695420 100644 --- a/docs/TESTING.md +++ b/docs/TESTING.md @@ -1,6 +1,12 @@ # Initial release test results — 2026-11-09 -For the current sound and automatic-feedback changes, see +For the latest November 11 disk and nonrepeating correct-answer slots, see +[ANSWER_SLOTS.md](ANSWER_SLOTS.md). + +For the November 11 progress-map change, see +[MAP_PROGRESS.md](MAP_PROGRESS.md). + +For the sound and automatic-feedback changes, see [FEEDBACK_TESTING.md](FEEDBACK_TESTING.md). The results below describe the initial release. Built and played with installed **VCC Plus 3.5.0, build 41**, bundled **CMOC 0.1.100**, diff --git a/docs/images/multiple-choice.png b/docs/images/multiple-choice.png index 13ce512252a08aa423757fa20b9670987f79840a..c7ac855a014b22326d1ccd7c17a48e7fb2ef08b9 100644 GIT binary patch literal 15540 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 KNB#EjPyYk*3ZV`F literal 14168 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 V&H0?K_7{Y>@AukQ_T7mq{~s)6e}4b~ diff --git a/docs/manual/CAPITALQUEST.md b/docs/manual/CAPITALQUEST.md new file mode 100644 index 0000000..515f5bd --- /dev/null +++ b/docs/manual/CAPITALQUEST.md @@ -0,0 +1,248 @@ +# Capital Quest for CoCo + +Capital Quest is a geography quiz about the 50 United States and their capitals. Follow the highlighted state on a color map, choose its capital or type the answer yourself, and watch the map record your progress. Every game asks about all 50 states once, in a shuffled order. + +Start with multiple choice to learn the names and locations. Switch to typed answers when you want to recall a capital without seeing the choices. After the last question, review the states you missed and try another journey. + +By Brian K. Holman. © Brian K. Holman 2026. + +## Get the game running + +Use the **Download game disk** link supplied with this manual to obtain `CAPITAL.DSK`. The [online player guide](https://vccplus.brianholman.com/games/capital-quest/) offers the reading edition and reviewed PDF download. You can play the ready-made disk without compiling the source. The **Source code** link provides the editable project; see [Make your own changes](#make-your-own-changes). + +### Machine setup + +Capital Quest needs this setup: + +| Item | Required setup | +| --- | --- | +| Computer | Color Computer 3 | +| RAM | 512 KB or more | +| Processor | MC6809; HD6309 also tested in VCC Plus | +| System | CoCo 3 BASIC with Disk BASIC and an FD-502 floppy controller | +| Disk | `CAPITAL.DSK` in floppy drive FD0, the CoCo's drive 0 | +| Display | RGB is the tested color presentation | +| Input | Keyboard | +| Sound | Built-in CoCo sound; no sound cartridge needed | + +Use VCC Plus's normal CoCo 3 Disk BASIC setup and select at least 512 KB of RAM. This edition has been tested in VCC Plus 3.6.1 with both emulated processors. These emulator checks do not establish compatibility with a physical CoCo. + +The 512 KB requirement comes from the graphics design. The game keeps one picture visible while drawing the next picture in a second buffer. Those buffers occupy a reserved 64 KB area outside a 128 KB machine's RAM. The game does not use all 512 KB, but this edition cannot run with only 128 KB. + +### Load the disk in VCC Plus + +1. Start VCC Plus and select the machine setup above. +2. Open **Media → Floppy Disks…** and insert your copy of `CAPITAL.DSK` into **FD0**. +3. Save any existing work in the emulated CoCo before restarting it. Choose **Cold Restart** through the app's machine controls, then let BASIC reach its `OK` prompt. +4. Click the CoCo display to give it keyboard focus. Type `DOS` and press `Enter`. +5. When the Capital Quest title screen appears, press `1` for multiple choice or `2` to type the capitals. + +The disk's DOS loader starts the game. If you need to load it explicitly, enter this command at the Disk BASIC prompt: + +```text +LOADM"CAPITAL.BIN":EXEC +``` + +The game does not write to its disk, so a write-protected copy is suitable for play. Keep your original download as a clean copy. You do not need to format the disk or add any files to it. + +## Choose a mode + +The title screen shows the national map and four choices. It is also where **Play Again** returns you after a completed quiz. + +| Key | Title-screen action | +| --- | --- | +| `1` | Start a 50-question multiple-choice quiz | +| `2` | Start a 50-question typed-answer quiz | +| `C` | Read the credits | +| `Q` | Quit to BASIC | + +![The Capital Quest title screen offers multiple choice, typed answers, credits, and Quit.](images/title.png) + +Choosing either quiz mode starts with zero points and a fresh map. All 50 states appear once. The state order is shuffled for each game; repeated play can still produce familiar stretches by chance. There is no difficulty menu, player-name entry, or timer that reduces your score. The two modes use the same states, capitals, map colors, and scoring. + +The title map is light teal throughout. It does not carry over the colored answer history of a previous game. + +## Read the map + +The top of a question screen identifies the mode, question number, and current score. Beneath the map, the game names the state and asks for its capital. Read that state name even when a very small state is hard to pick out on the national map. + +| Map color | Meaning | +| --- | --- | +| Light teal | You have not answered this state yet | +| Dark purple | You answered this state correctly | +| Red | You answered this state incorrectly or revealed its answer | +| Yellow | This is the state in the current question | + +The colors describe your answers, not regions of the country. They do not group states by geography, time zone, or political boundaries. A correct answer after a spelling correction counts as correct and becomes purple. + +![The progress map uses teal for unanswered states, purple for correct answers, red for misses, and yellow for the current question.](images/progress-map.png) + +The current state stays yellow while its answer feedback is visible. When the next question opens, the state you just answered changes to purple or red and the next state becomes yellow. The ordinary right-hand panel shows the four-color legend. + +### Northeast detail + +For selected northeastern states, a larger **NORTHEAST** view replaces the legend. A yellow outline on the national map marks the enlarged area. Both views use the same progress colors, so you can see the small current state without losing its national location. + +![The Northeast detail enlarges small states while the national overview remains visible.](images/northeast.png) + +### Alaska and Hawaii + +Alaska and Hawaii appear as labeled insets on the national map. A Hawaii question also opens an enlarged **HAWAII** view on the right. The island shapes are simplified to fit the display. + +![A Hawaii question shows an enlarged island view beside the national map.](images/hawaii.png) + +The national map and its insets are learning aids. Alaska, Hawaii, and the enlarged views are not drawn to one common scale. Very small islands may disappear at the CoCo's screen resolution. + +## Play multiple choice + +Press `1` at the title screen. Each question presents four different capitals in numbered positions: `1` and `2` on the upper row, `3` and `4` on the lower row. Exactly one belongs to the highlighted state. + +Press the number beside your answer. You do not need to press `Enter`. The game accepts that choice once, shows whether it was correct, gives the capital, and then moves on automatically. + +![A multiple-choice question places four numbered capital choices below the highlighted state.](images/multiple-choice.png) + +The correct answer starts in any of the four positions. On each following question, it is chosen randomly from the other three positions. For example, if the correct answer was `3`, it can be `1`, `2`, or `4` next, but it cannot be `3` again immediately. This follows the correct answer's position, even if you chose a different number. A new quiz starts this rule afresh. + +### Answer feedback + +A correct answer displays **CORRECT!** and plays a rising pair of tones. An incorrect answer displays **NOT THIS TIME.** and plays a lower, falling pair. In both cases, the screen states the correct capital. + +![Correct-answer feedback confirms the result and names the capital.](images/correct-feedback.png) + +After the sound, multiple-choice mode leaves about 1.5 seconds to read the feedback, then opens the next question. You do not need `Space` or `Enter` to continue. + +Release the number key after choosing. A held key cannot submit an answer to the next question; let go before pressing its answer. You can take as long as you need while a question is waiting for a choice. + +## Type the capital + +Press `2` at the title screen. The question appears without answer choices. Type the capital in the entry line, then press `Enter` to submit it. + +Letters and spaces form the answer. Periods are also accepted for the supported **St. Paul** spelling. The underscore marks the end of your entry. `Backspace` removes the last character; continue typing to append a replacement. This is an end-of-line editor, not a movable text cursor. + +![Typed-answer mode shows an editable answer line and the keys for submission, correction, or reveal.](images/typed-entry.png) + +### What counts as a match + +Capital Quest ignores letter case. `Denver`, `DENVER`, and `denver` all match. Leading and trailing spaces are ignored, and repeated spaces between words are treated as one space. For example, an answer with extra spaces around **Salt Lake City** is accepted. + +For Minnesota, **Saint Paul**, **St Paul**, and **St. Paul** are accepted. The period belongs in the abbreviated spelling shown here. Other punctuation changes and informal nicknames are not automatically accepted. + +An exact match or accepted alias earns one point. Pressing `Enter` on a blank answer records a miss. Entering a different state's known capital is also a miss, even if its spelling happens to resemble the expected answer. + +### A close spelling + +If the entry is close to the expected spelling, the game may offer a second look. The screen says **That looks close. Check your spelling** and offers: + +| Key | Spelling-prompt action | +| --- | --- | +| `R` | Return to the entry and edit the answer you already typed | +| `V` | Reveal the correct capital and record a miss | + +No point has been awarded at this prompt. Press `R`, use `Backspace` to remove the wrong ending, and type the correction. Press `Enter` again when ready. You do not have to retype the entire answer if only its ending needs changing. + +![The close-spelling prompt offers Retry or Reveal and says that no point has been awarded yet.](images/spelling-retry.png) + +The spelling aid is a limited safety net. It does not recognize every possible typo. Short or substantially different answers can be marked incorrect immediately. Keep checking the state name: a correctly spelled capital for another state is not a spelling correction. + +An accepted answer after `R` still earns one point. The results also count it under **correct after spelling correction**. That count describes part of your correct total; it is not a bonus added on top. + +### Reveal an answer + +While editing a typed answer, press the CoCo's `BREAK` key to reveal the capital and record the question as incorrect. In VCC Plus, the Mac's `Esc` key supplies CoCo Break. The feedback names the capital, and the map will mark the state red on the next question. + +At the close-spelling prompt, use `V` to reveal instead. Revealing never earns a point. It can be useful when you want to see the answer and continue learning rather than keep guessing. + +### Entry length + +The entry holds at most 39 characters, including spaces and periods. Extra characters are ignored and a message says **39 characters maximum. Backspace to edit.** Use `Backspace` to shorten the entry, or submit it with `Enter`. No state capital needs an entry this long. + +### Continue after a typed answer + +Typed feedback uses the same result messages, capital display, and tones as multiple choice. It stays visible until you are ready to continue. + +![Incorrect typed-answer feedback gives the correct capital and waits for Space before continuing.](images/incorrect-feedback.png) + +Release the key you used, read the answer, and press `Space` for the next question. The game does not advance typed feedback automatically. During entry, a space is part of the capital's name; it advances only when the feedback screen asks you to continue. + +## Understand your score + +Each state is worth one point. A correct multiple-choice selection, a correct typed answer, or an accepted spelling correction earns that point. A wrong answer, blank submission, or reveal earns zero. There are no speed bonuses, time penalties, or negative points. + +The score beside the question number is your correct-answer total so far. At the end, **YOUR RESULTS** shows: + +- Your number correct out of 50. +- Your percentage: the correct total multiplied by two. +- How many correct answers followed a spelling correction. +- How many states you missed and can revisit. + +For example, 40 correct answers produce 80 percent and 10 states to revisit. The maximum is 50 out of 50, or 100 percent. Each state contributes at most one point. + +![The results screen shows the correct total, percentage, spelling-correction count, and options to review, replay, or quit.](images/results.png) + +| Key | Results-screen action | +| --- | --- | +| `R` | Review the missed states | +| `P` | Return to the title screen to choose another quiz | +| `Q` | Quit to BASIC | + +## Review missed states + +Press `R` at the results screen. **MISSED STATES** lists up to three missed questions per page, in the order they appeared during your game. Each entry shows the state, your recorded answer, and its correct capital. + +A directly revealed typed answer is shown as **[revealed]**. A blank entry is shown as **[blank]**. If you used `V` after a close spelling, the review can show the text you had entered before revealing. + +![Missed-answer review lists the state, the player's answer, and the correct capital, with paging controls below.](images/missed-review.png) + +Press `N` when **NEXT PAGE** is offered. Press `B` to return to the results screen. On the last page, only `B` is needed. If you answered every state correctly, the review says **A perfect trip! No missed states.** + +Reviewing does not ask the questions again and does not change your score. It lets you study the completed game's misses before replaying or quitting. + +## Replay, quit, and saved progress + +At the results screen, `P` returns to the title. Choose `1` or `2` for a new quiz. The new game clears the score, answer history, spelling-correction count, and map colors, and shuffles all 50 states again. You can change modes between games. + +`Q` quits from the title or results screen. The game uses the CoCo 3's high-speed clock during play. Quitting restores BASIC's text display and normal clock speed, prints **Thanks for playing Capital Quest!**, and returns to BASIC. There is no separate quit command during an unfinished quiz. In typed mode, `Q` is an ordinary answer letter. + +Capital Quest does not save games, results, high scores, or preferences to disk. Your current quiz and review exist only in the running session. Quitting, restarting the machine, or beginning a new quiz loses them. Take a screenshot of the results if you want a record. + +There is no in-game settings screen or joystick mode. Use the keyboard controls in this guide. Display scaling and sound volume are controlled by VCC Plus rather than by a game settings menu. + +## Credits and licenses + +Press `C` at the title screen to open **A MAP FOR EVERY STATE**. Press `Space` to return. The screen identifies the map source, its Creative Commons license, the adapted map work, and the font author. + +![The credits screen identifies Fla-shop.com's map, its CC BY 4.0 license, the adaptations, and Pierre Sarrazin's font.](images/credits.png) + +The map is **© Fla-shop.com**, used under [Creative Commons Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/). The original map and its source information are available from [Fla-shop.com's United States SVG map](https://www.fla-shop.com/svg/usa/). + +The game adapts that map through state-region assignment, reduced resolution, simplified boundaries, recoloring, run-length encoding, and Northeast and Hawaii detail views. The insets are not to a common scale. The map's inclusion does not imply endorsement by its creator. + +Pierre Sarrazin's **font5x8** is public domain. The disk boot helper is adapted from his public-domain **autostart.c 0.1.2**. CMOC, LWTOOLS, and the linked libraries retain their own authorship and notices. The source distribution includes `assets/CREDITS.md` and the component notice files; preserve them when sharing modified copies. The [matching library-source companion](https://vccplus.brianholman.com/dl/software/CoCoLibrary/Sources/Exclusives/CapitalQuest/2026-11-11/43fcd00f12ef/Capital-Quest-Library-Sources.zip) provides the linked runtime, graphics, keyboard, and font sources with their original notices. + +This manual is © Brian K. Holman 2026 and is released under the **GNU General Public License, version 3 or later**. The project includes the full license text. The map retains its CC BY 4.0 terms, and the public-domain font and boot helper retain their separate status. + +## Make your own changes + +The **Source code** link accompanying this manual provides the editable C project. Keep an untouched copy of the approved disk and work in a separate, writable copy of the source. You can change the quiz's presentation or use it as a small learning project while preserving its licenses and attribution. + +In VCC Plus, choose **Develop → C Development → Open** and select the extracted project folder containing `vccplus-project.json` and `Makefile`. Select **Release** and choose **Build**. The declared build target produces the game disk. Use **Show Build Products** to find `build/CAPITAL.dsk` and `build/CAPITAL.bin` in the workspace's build snapshot, then test your new disk with the machine setup in [Get the game running](#get-the-game-running). + +VCC Plus supplies the supported compiler and build tools for this workflow. You do not need Xcode, Homebrew, or a separate compiler installation merely to open and build this project in the app. Asset regeneration and optional host-side tests have additional requirements described in the source README; the generated drawing and state data are already included for ordinary builds. + +If you connect ChatGPT to your personal project copy, review which files the connection shares and enable the project's Makefile workflow when building through that connection. Keep private connection files out of anything you share. Review suggested edits, build them, and test a separate disk copy before replacing a game you want to keep. + +## Troubleshooting + +| What you see | What to check | +| --- | --- | +| **Requires 512 KB CoCo 3 in BASIC.** | Select a CoCo 3 with at least 512 KB, start in ordinary BASIC text mode, and cold restart before loading. A 128 KB setup is insufficient for this edition. | +| `DOS` does not start Capital Quest | Confirm that the complete `CAPITAL.DSK` is in FD0 and that the machine has Disk BASIC with its floppy controller. Cold restart and try `DOS` again. The explicit `LOADM` command above is another loading route. | +| The game does not respond to keys | Click the CoCo display or use VCC Plus's **Input → Focus CoCo Display** command. Release the previous key before pressing a new one. | +| Typed feedback seems to be stuck | Read the feedback, release the previous key, and press `Space`. Typed feedback waits for you; multiple-choice feedback advances automatically. | +| A typed capital is marked wrong | Check the named state, the spelling, and the accepted Saint Paul forms. Case and extra spaces are ignored, but arbitrary abbreviations and punctuation are not. | +| There is no sound | Check the app's sound controls, Mac volume, and selected audio output. The feedback uses built-in CoCo sound and does not require an add-on sound cartridge. | +| The map's colors seem unexpected | Yellow is the current question, teal is unanswered, purple is correct, and red is incorrect. The current state remains yellow through feedback. | +| **Graphics timer stopped.** | The game could not complete a display update and has exited. Return to the standard BASIC setup, cold restart, and load the disk again. | +| A previous score is missing | Scores are not saved. A new quiz, quit, or machine restart clears the session's results. | + +Before restarting, preserve any other work in the emulated computer. Keep a clean downloaded disk and a separate copy for your own builds so that troubleshooting does not replace a project or program you want to retain. diff --git a/docs/manual/README.md b/docs/manual/README.md new file mode 100644 index 0000000..73edc04 --- /dev/null +++ b/docs/manual/README.md @@ -0,0 +1,27 @@ +# Capital Quest player manual source + +CAPITALQUEST.md is the authoritative plain GFM player manual. manual.json holds +cover/website metadata. images/ contains selected unmodified guest frames; +screenshots.json records exact hashes, machine/app configuration and disk identity. +The manual is © Brian K. Holman 2026, GPL-3.0-or-later. Map artwork and the other +components keep their own notices; see assets/CREDITS.md and docs/PROVENANCE.md. + +Generate the PDF with the shared VCC Plus documentation exporter, not a separate +game-specific renderer. From the VCCPlus checkout, supply these selected files: + +```sh +python3 tools/documentation/export_pdf.py prepare /path/to/CapitalQuest/docs/manual/CAPITALQUEST.md \ + --metadata /path/to/CapitalQuest/docs/manual/manual.json --toc \ + --destination /path/to/ignored-output/Capital-Quest-Manual.pdf +``` + +Inspect every rendered page and its links/captions, then run the exporter's +publish REVIEW_DIRECTORY --reviewed action. Changes to source, metadata, images +or shared templates invalidate the review. Generated PDFs/review outputs remain +outside tracked sources. + +The website owner imports an explicit snapshot with scripts/import-project-manual.py, +slug capital-quest, this Markdown/metadata and the exact reviewed PDF. Its shared +layout owns desktop/mobile presentation and prominent disk/source/PDF actions. +The online route is https://vccplus.brianholman.com/games/capital-quest/ . Import +and PDF generation do not publish software or change the emulator. diff --git a/docs/manual/images/correct-feedback.png b/docs/manual/images/correct-feedback.png new file mode 100644 index 0000000000000000000000000000000000000000..49342cae8aadc15443cff0e63c424bf8a4d4abb6 GIT binary patch literal 7907 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 BypR9@ literal 0 HcmV?d00001 diff --git a/docs/manual/images/credits.png b/docs/manual/images/credits.png new file mode 100644 index 0000000000000000000000000000000000000000..8e921a7eea9d41a9d5927e917e6f0503ac9ce24d GIT binary patch literal 7406 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 literal 0 HcmV?d00001 diff --git a/docs/manual/images/exit.png b/docs/manual/images/exit.png new file mode 100644 index 0000000000000000000000000000000000000000..a2be8338171b5e853efb362dbaa5ad0dde25b2d6 GIT binary patch literal 11458 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 literal 0 HcmV?d00001 diff --git a/docs/manual/images/hawaii.png b/docs/manual/images/hawaii.png new file mode 100644 index 0000000000000000000000000000000000000000..90d1136747fd3f5e6c25546b364ce4d804fad916 GIT binary patch literal 8107 zcmXw8bzD>L7anu!5D|tb?SO#@3J6FI36*X^=~6&MN|>WNq*GF2C^3*6-HfkvcbC$m zVIxNU<{!WN`P{qb+`YHXIq!MTc}}RNx&q}b##;aYfKo|ORto?ilObU&_y*~S)U9hL z{g5HF6kY;~`OXvMI^Fc;ia8Z5$al%Tv-jPc#v5>r4yooy$n;cm8rBY-X-e|A~S+E{1Wv z<;db-fBWp%bitE>3}yzJr}n$@_??zs26+mUUkvgkAEamj)B9D+E&A}LToF$Xqo+Hf zp+300ObyFl;g?3xmDkdiuZ;0+`>X}V@Ecxo(zXSB7r)e$?w?IM*WMxPXHqarwNxv< zC@kMfaT&8r_ts1tPrz9l+pP;F=`sfp8=Y9bVex{MaFaoXTzLIizMidK7JvD8$B)x{ zY6Q?p&a{cPU<0f)|D?7n#_iRya)*Mc?|fm ztAAJUrNQ^(Fr)1ea6GkMP(vGsIi7fA7_za?>;K@z-S;2Q6Zi zCD|I1NoTB@-%Cc%6WP(;n{_!-UhMac#Kj2}Pufb{3zP8T#qA3}OPch33{L;}kRMcV zBc9<}{M@ zm^7?dcA_cL7c$96c6V`nWN9(N7or#HOa7U&?#K=lfgJ}Y1FAC~+_WNLWzerH8c@I$ zkw8%4heCa>9xN6vK9%owQI|5GH8K%D9TM2!Pk?%91>41sPDpjXaj0mT_Hpp6b#*#0 zxf&M*%4RD2>V2u(c%K@jlK?;J6?p%^wtQI+qvmEaWsd3=p6+nAVHR&(=dVII7c4t^ zR_QyTjKG^xvf8|979k3dehig;rf=*7s_dL z*bnJmNg`R$9mNW|OVLXhjTLT&_AF*Xywq~O%65e`moCdhqzpeWnEa_I_5FH2ohp5K z30y95=w_|SYmFKFb+3ei#_=(iikysY?h(PL-&Mp9jcs&Z3Ul$MxTtvg;Qbb=juqD- zmv|dPJ8SesOq&RyBJd7BQC5NrU918d499)}$^z;%88q#)FjrxM_Iy?P?74}QsbT3- z2HW`>rk~Krqk$*LEe7*^=~i-7k*>8T!Eo4yrN>=9GaO(@m(KSlNN=U6Y1I3}1#aKN z>GiDpmcf?+>^u2$tJW$1BxFVqwximCa7E7&PDOXWj8C?koSd$%TU(I$lSO4Z$M#VG zA3+n%EI6K@W!L#P;ow?&+Vkmhp@)gMYhH}?NBPf*V$=Pny0z`uPVLtiHU*;M zy+_{}BDu3nx3ePPe34iP=sS2X#C(SSU!ZVSz?ufmdwpd_k=&+-`Y9P-z}Q<^puKM-2ll=E7h}lC7J$vapGYW>ggEdU2fuGR_Zi7x zdqKV^8n1U4!y?a{=Y3q*xre>`q-T9*1U|%$WFEfP~Ty1MLjqwem6FM;I*J@B@mpXv}Y4r{{iF#HoBw%1!9|xVuY5h(i%RrT0=cpW6sQ` zU~mNi3O_q_-*Ot|IrZjE>qph0Zqpe-r`i_{n{{qD&)kDLJSe%2rFC_*`OTn$rPTFH z`8!O8U9reSh5gEONDWDI=>QnpUk2Sx>zpdLAu3bWmW-tPE~$eVuJ?q-L$#w(T$?mW zCmG2zmLU2rzU%hkceV^d4?_}K;5T&0RS5qrvk4h7BibvqzK=+n9DDGhd>)KZ~8!7L1do{b{q8X1&_Pi z1zgieD>W>ZcxT$fbRnF6U$wAY6qqy%ESY_jv)lfT=Y)Ov*SAH!o)@AnxFO&E*l`%c zCnzG|2@bQnB{+{`-!zmqlZ$Ln50s*=?dN67GuP&yG{4^(?+}XNeph^^h_78^2 zvd9!^H6h-NKifG}Wj0!ch@}HcW?9|nXRm=2Sy`i8{lgF2y}K*>h$(r3N5jedf3KdW zAA~_c4^`O@rB?Dmoqc6M6Wh8(H7us&1m1hE73=BI9g;=EzN(2)Uy)7E5K#DH-oV@R zKH_2X{m~3Gf`@De2o+JaZaEbH(Jrx+@+UU(mq4pKcW_>hh^_llrj)IccO{1Kn@=t- z!m7f;Hp|=gDg)fWN#^uRTQ;~!(Rr|EV_3K1ho@y|pDFC;)KbT{Z$#Z;?bBcG6sKe0 zE8BCOckh}zsKp`yy7qT6l-*f7?J`Ec=EWLPyf|tdFEE^0ZoG6N^8a^n{Q6aE{c35RQg1^%yUhxAla`Y0_%l^v+=l zyK=EY@7%B2&=6A6a(v7!?d{nZ6Iy4F3cy-}I@SDxI@*G1xuv=0Y~)*R^rVZGgglZ1 z^EwXRS-GQ2k$diI)@$U!3pFTrifC16j!6ZDwhOP2F2u+0u`|3>II~`IdH_@g^MZcD zj&UQ2*#Whd>0Syw^LomG)d#f6u;whc8GAk;`flb|Xx9#y?Y~?Xp^vwB^=_JoLH1=u z{a>X0UJnn{9SL`~ElHkn?V$h~$@z=@Sy3EBOZOijS8_n~BjalSMgG=8zSUUCLQ=on z$bO3R;X2djI3WV!_~|;BmyCX-e;@fMT3?jiLEqF#IOe^$#~~)6aklwtkro({nkn2` za-C?o53lviAmYC}#=Z90)k3}SS6HjMx1^6?T6#mnAzpmGcW7OLY#$giRQGlK6PcUD z+146x8o#rCQa>H=sK4f~SmoWtkE%K15tz?~ag<2SI1o1sQnr0?3VyzVMH#KyrUzG&b&X6+sc?JShzVt>+DXM5 zdwt1TOUqkU-Qt%a1G*3XwB7F7)hPZWe$eS!KfO9Hwad7B&#{q(%!KTqP(XXxw=b$s z@*4=^&;{)ZbW8Y>A0Rkw4GmSYEXVPCUN&YuYI|zaz;gcRwDE$w^eI~pc_|V>`<@vG ze39l=#&oM@gg#qrvqD7qr9zk7MCT@6LVLO8i zhbHJIci0qxYH;_(j?Z^p<*zE2S9RD=OLXcv;uN|C<(!Ex4!aG(AyS{3tonRfIqvbB zGxCYL-AIN>uO26ww(SeasQWaw=Jpxa)gs`!T~--D8&DAQ4+L$rK8Nvd_lFNFG0q$O z7X{yp-_PVBWAMek0LZUY0JKprZMQ%`3c) z00J%Ww)uxtPjK{g$pGfXwL)!uhX%)y4=*;>YlK28b5s6PTT6z%3~MWf78Z#cIy5M$M!NCWGa6QnXfhDRy9VM>ebV8{=ADVf@W@j;@yG_RIsi2X~tue0di9 zc-yngM&ari(3VY_k|{Ow_)X4{5N=Xaw_`9>fulOUaTS#2v6f4C^=pD3pD?I}dEE5_ zYFBxx7Gr9Iz8*a)mUs~fa7ahV7o#Dpi?(yrvt|-8iwiww_9_~1W#z0a{E2^Yy8v8d z+vhICkWdz!_pDiKtH7zi3gJK*XUs#f?Ez%SkoRq@*5_y$<*4W^6~J2zzDHEu5fyyT zYqvaKvl!mwVOKKfAb!eLJRO>Lcu{|T@pAhxytoMtaRp*3b3GZ!sxmI$FS^Y13S1^0 z*_Ody<|?eAIhz^aoCo36ZS>I=V&=AIk6>8sKP;h#SKax2+uOB$EuGJWA50A*V9luN z2fd2e#={Z+Tb{Y+T3^fLbvO@RZ4oZ(q{w(5ECxRJCy~x)8jU1WZEo-9 zbIEugJbo%k7^jppH*Zs$y}OouPE?TLii_ zZ6V>na29wMFn`P35ph_`pIA#7KV364zD;xy(LNbpcq*Obo!$m+WtIxkxw;hDAoIu za;8@Mfq4&MWIpHL3T*Yl+hS>1kxwC_&aWo_LtAq_bhUuKH>wtS2O;pZeadlaK>+mG z#t=T2K#YnMvqzGX^~0~XQ?^FN!RnZexV>W7Md{CnUHWgXRJ=Rm=F|x2w33g4y9nEQ zbYw|SVlLy|CV8W04;xsz_=4uRr9)ASVo1Y;;m2Jjvc%d>$9F%_A%zyEIBnpQ4eN!7 zzVZ4g0^Q=oP@k*lVR6G69s=?r?>IO?fWxM0(mFU&c;=A=kCY`2n_b&3!ABKfQ z+#=S%r!5Mh^wd_7nF2cpeT?6VDpIstYdO_v3@t-+kL|ijIK?+@!?BiJGVH_UN*}Xw z=D&}D<+qgySs=XweOQD(#^$!d!Jt^e`6xdw>rmb&O*%^MG(roJ@`r!(Hy8HFvm}=- zZ{T@38O>FI9);^<2!80NPma3%H}fq2Lf1Zy-zGGRlMy$M$~&V@F|7?NPk%(Iz)ETS zW)^@YptUCp%D~3Jx8bpYIwLBCfv6z!y=y9mA5bc=&kun!)Qc!J$3+fTwDw}kHwnS} zq2IV#Af}&E;e>>c`y32sDyyOFhBDzx;b- zw);fMzEa>>B4Z2B{t&;$8AtuFb&Lq#ZUA;lwuY1JeVw}^bzL3CIdx}(dljg4{UK{g zY(c^#J0v#q)8VktKyN_nBqP(d(M}LR-GifnKBZeX<5o2%7OYs@C~>;-ciz}UBE2!B zKn9m@|8m1YR%tk}wH*jerp<{3}NBr9z80>Lz` zrUPRI3rjO~XKVm=4u<})evlYNmy);ZV{)3h?_jI!(YR}hnxUWDYmP9|K!vWYJmXuj zMGk%{s6CCQ3pVn<;szYlG;*H=vu;;O5=(%K3sqQtQ^L!mBiRLzQ}WJC*j4 z%3H2)o;uyKXsA7z+8qWnzgUbVrPnpqs(~v|8%`62(6FNd<^Cm}t0NBwki2~`RLwU{ z$39bER?j2%p2pkh52}2m+PCI`Up1@Df2!=V5^-$A_&j9}v^&0!#+lO)SNjaO8-b0W zV+>TJuf1;%Iv4h;|PJx%31C8ig~sSMsyMM4OWHPPLgACA`-^`V<#K4aC!XRxXv! zUuk0vCtkH*F}@AmJv7s+|n zq&UKzsyW`zvqsPD@DH88UT(II?u+0fl9kQl|9TN9J<019cvW!gRG zbu25RbcZlh(kM$?#fDY%y#0)8A%&jdOr2BRPdJX}-S^a+%Zkk$g+}wNf^lZ*9ZoO+ zDE@>tHq8j>j+>!2(-@T4a5@}l>U%EHp>^IXK&MSn`(KrOjQCX|liyoXX?UBOD|~q4 z{oB7sGr=-DUy|7sGVnzCPMcJ*!^zoNE|>2;UAoJ4ZH9|kpyZkO$G)HT_2F`rlO>~M zuOnNJ%dXB#;bCqZ0$#;*XIf%;-oLK2QWk(zEzpG<8k|^(hU@LQ@H))bm}*BlAPgZ3 zR7t-xrF$zkh(qOQXNHc9^LY^pvQH}c+|NAlw5~T4%i9&_`1%hTr>WGVVO)x>y6kmY zP=pXU4S7;Ibq)T$Ydl_FoueEO;qAl`%if%3k9VtJaquv|&1||7pVR)P@y*o}{m6BL zPA8owYTlj{v!D@9@6dh?vDFP^Xd(J2xa4H{`6N&shCTJ|finkyZV&dG-KE z%s<2K>ZO?|5cDS}Wb+Xu*Yn~!Hi(j1o;a30ZQk(J8v(Yt4J*2UzkW}ayz4VpLzJ8#6LCf$H1%G0tx;DizsbZl4 zC$ya&Y}?7UZr>xBT9}^WEjurbS=b3X>ySpc8Xohio)DzS|86H{CYJsaS7T4tfp~OG zwCcb-DTS|9QTHthiN)%TZ)KwEVySJ8iY~+$il4JoQ5%M<+enQI0e8c&ISzj0?x7Vj z@253VwaC5VpepOf#I8t8Pxv<@PmOP9Ih`XPzMwp-B+23m^^RUTj~2V6J;pEW7w1FLEp*u*4C6%OAHK=hMUie`q=piS;$uHFsRr0cp?hyfP7@fGQVCAjp2d^{^WvpbDO(8 zUv^8}=a|_%z5Q3EE!!d)=ku%g>hd^W$ivt~4W!3@i?ihoqXfi+N2+Hhz}LZRS4h_- zv|@u(k(VLPOl_C%;`x4AgUW2w2#F1r0#%)$KYOtm&VX&dV$&45QaK4RpLa+>=7HdK z_1~lsYLJr!Q6G0ZxbU4GlK2k9b1t&Nu=qK~*$hM?hid?&4`{!tl&rF9OFK;c79Hg= z>QG`#V!=z&P-)NCtSX<=X{cv}-K^vG>elw+mQG~wV+6hh7K$g2q0XRx5C{58#YaMq zFZI25VjOsMV;(G@3y~LRbRF+4;3culv~}RxkF}cCS=;ea_(y1}O1Z|j>Jq$2&(6v| zN45z8EvE!bvB(~zB<;bz0w?d`OWC-QF~ zZnyq$=M=}|e-=-dqr5(%iTQLr59U5@RzWmLKJt|B4Ll?~-6=j_&R|$~#=v+ff1^zL z9@W`<@yGq^bat)9m(j~{2P#vlSBzX215ct)g8OWHKdf4q9>2^C1!!}(1?7dOAQMaZ zH_+!v7WkPuNZvr%s^LY|Wc+y!@u!a+8t-9AO1f?8$8;;SnJc_oMc+R<*({m+n0!>D3w&0+mQ6d5ZwwU`@!<)+m!CC zqN=g4-dY#y+HD5|r zJb15GU!ok%ZU*$k^}_i{1nw`e?V%+0Q??GNmw*MU%40!d44U;M=66ww)F~i&UeqYb zX}ZAA?k<*~q*H^x@?Cu#HP=WrV(?nS8!QVgePS4ZBSB)#yokHV_w`Z+#sT}I!ag>5 zTs5(B-jk%-A2No{t>@=05pqOebOPL(MZC5I|J}Eu#B< zK5;AjFw2ghB;J!Ixx$AE!sdgL1MY;EeA)2l-N-q|>X7Jq<)s=@g&P}UAU`ZVR%?%` z?Dv3`rU7gy;78F<%;v!GBA)1_{ESVK-WuqDY9K|ePi#~%lmxPzIE`D=d8pw~LE?n# zPiT~iF)`CS<-#}r zppT^UNa~M7#$Ne-I4#Lc5!h!SRo{`!3K&V)`A41G3$416l9uFulsaR)vju6$9QC?8 zMa1&S{lfT13;vb3B+tH`5mC2tubBlSkin|*1f#rzK5EcrpHk9vK%V3kjz3zR1G$bm zoJU<|z}eK;I_t)Gyun23bVZbT;~JYLCw3_4=TTiAw=TnC4l}_B)tz5b_8p2po2Db{ zvc9!J6*k`)cZ&t!#m|At z>ao6BI`9QvqBs<8k54JXY+ZuikngSgvp>r^!Y>_2Qirr=ZI6N1_3G^3Ho|m#1qbM{g-xg&D(FMgH0(qO$b* zv47VmtAv0q|7@YC-t{iHFEXmu$(ii6VRXV zwpYH>BBIi*zq-6-s{h{Bq&H|gqpU-tS9d1j#l^~B&HA*c6_PK`LYmsU@dDEgZG#zw`m)qy(R}UYX!;(k-1BD^e|%v%QHcl`t3N1!i(V1 znjuo;Z9rIe(GkB}t}ieZ{g3`1A*W`#n~e=;dTY5}&}EI{*|3TCTn{#X`moBd+o(x= z#^fRm+VfAB3X89sZwM)e1R@flM1(cz<1@g|!vM#DldnlV?$XD=D=NuY^nDts_7?!s NrX;5>Tl~_@|9|m0*3tj~ literal 0 HcmV?d00001 diff --git a/docs/manual/images/incorrect-feedback.png b/docs/manual/images/incorrect-feedback.png new file mode 100644 index 0000000000000000000000000000000000000000..cb769b0cb6b977ac42c501cd2eeac135be42a5a7 GIT binary patch literal 8183 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 P0sbFd!`t~c?SuXYA>N4u literal 0 HcmV?d00001 diff --git a/docs/manual/images/input-limit.png b/docs/manual/images/input-limit.png new file mode 100644 index 0000000000000000000000000000000000000000..ca604206ea8e1760bd531d2ce96d1ca9ba35e502 GIT binary patch literal 8264 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 Yfwh=R4b=00D*AT~jBl0PcoOk{0GDc@tpET3 literal 0 HcmV?d00001 diff --git a/docs/manual/images/missed-review.png b/docs/manual/images/missed-review.png new file mode 100644 index 0000000000000000000000000000000000000000..0d4030537eee69adb0abe1c32aade10ad5d7ae36 GIT binary patch literal 5210 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 literal 0 HcmV?d00001 diff --git a/docs/manual/images/multiple-choice.png b/docs/manual/images/multiple-choice.png new file mode 100644 index 0000000000000000000000000000000000000000..29e7d13d685e920a2ef1df7d580b26d8b2f07d38 GIT binary patch literal 7946 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 literal 0 HcmV?d00001 diff --git a/docs/manual/images/northeast.png b/docs/manual/images/northeast.png new file mode 100644 index 0000000000000000000000000000000000000000..a7a4f535ed3f816f699632109de86a9b8058552b GIT binary patch literal 8803 zcmZvic{o(z+sDU}ghE+MMkJ!Kr0j-@D3wsiT9m<%WwMU3mFy-;_L)l3VrT4QWEo0k zlCq3tFc_H``!V&f;WKo-xSVq zoO1vG+;6!5*TZGZ05~;r&GgcpFfN8mY{>ZMa^Hz2+;G&x-3&zT zd)WEA2l$1wH(w8Z=X!P_@zRZ!fm$kKbZZHRn|&#Cn&(@a;Q8ff^#7Fs?{D$H#*mcUeiwZ*a^C^?@RQE87n%8@S)EC0S!J7 z+WEn?_p6Al2qb|}CkK#ag+o=@I0Da=Zlmy^z2>@cVC=PYMIlNq(T7#kn3+(dD;-_H zwG;<59~XQOj4i{HQ~D}=^ZaAn%2!ayQzw%)R;h{#f}vxQuxNL9S9n;k4W(`f_pDe~ z5v>r?g^L?fXxzff9yL+CE{QU8Jmfay*snfY5i;|EA|8HvZbE1s6PwN(+yP_9`gNr5WF5p4mLI9o<+w6Oef z{0Kq}$<{Z|-#N*sz%TXr*GERIS?%v?{S-41`{a7n!1ZQqxe>f9ci5;Uj7ADG05^rE zK)TIW;1tGA$XH4?`&%17&rPm#v81>^nmdu})n87o<=CFsO|9~9|8+~K*2mUhr$*N0 zsUD%-PR7NYp|zWbb3wv|dK6mE2({bswFT4}aI;JcM|rPp|G^qQ8F3mos5 zoM0F`vgXA~jf@z)MSchndUEJ~tp%ns%M)W>b%FgCF$>vrB~CUg?Q5;(_C1(3LdMqn zlS%s?PsCJZ#Tq2k81LgHO&F*&hg6SVUG?YM+rNYnqz4{ou>SL#z^)kVT(53g6*~lh zAGXufDACm~2}#k^SDX6c0<$q#i%mo1Cs6$nPsV5!RU=k>o*E)Y+oS~*ul{#~XuiPl zV@H!7f;l@R;5aARCDw(4iX7!X=0sRzhDuy&o-JToUCz*FAo@dMfvY5p_cPJOxt$|D;)b!!;<9Nt?@^muZ8GcF>K?o zjNEkQ{@-})#=el9+csrte;~W6QWQ5M3^ZKdl|iuWJrX}@?*ye&lxmrL+s|x&82NrP zx#oMv;&*q=z=x=^zVrAU(Wjs}OofO0aCl1iRv=qwc~L2csl>y@cc(}0u@qc5o|q4R z2O`9>?Jp|^Mpk;S#=2or zmE5+Yxyiz&H@aO52Ih^=4}y4K+_9N_*M2n`Z%&y<`<)Nq;}MY+NZ+igOa4{r+#s>y11-o9UK_3&pZ1S) zIK^Wvrsc18`Sdg{dY{c0s=%vro3;H?lK#jE$Uz4WDyb2_L0≶szoyo5=)HBb<`o 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 QpFOUb-7+n|d_V4g08cZ}#Q*>R literal 0 HcmV?d00001 diff --git a/docs/manual/images/progress-map.png b/docs/manual/images/progress-map.png new file mode 100644 index 0000000000000000000000000000000000000000..7199e2510a074d5fea284deef0a2d7f346a54852 GIT binary patch literal 8118 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 literal 0 HcmV?d00001 diff --git a/docs/manual/images/replay-title.png b/docs/manual/images/replay-title.png new file mode 100644 index 0000000000000000000000000000000000000000..f97b5646a662b5faa4e18569b5264a7caf439a9e GIT binary patch literal 9237 zcmb7qcUTkI8!l{Ia96-(6%92i3L;HFKx(j%xC$bRbO=aE5D1~y5WoURi-;&aAg+Lc zK%|$@Luer)HS`*~l+XeJZu~vZeV+U8{bOd%cV_0yIrF{qmG_%BPaZ@0{}lO?i;Ii@ zp9lB<<>KPjkqXgW=w%E3l;2w_NY8)=ccrR!)YUu&i~+dP-0D(3b%xJFivEJN_rJ zL4X0Sl}qOV69K*g{(DU&|wDUY39-3|<*#zvvK!)ZMf70dNrpnZ_o zpz9gJL75YbQq#r+ri>SxNyP}QY1A*eQ>*Xf0o%KElV0Xjbh~NeB0KOQv)jITApu}uHb}8#dc7OxzC#G6cOveWfP_w(EjYLw8^s#X4dH;I&LMFc#txr zuY9#vAJ~5WjAi_S(#<28o9X$Y&dS#7=$}W(Y@v}(I?`D|@6Ke=1_SgL z>$wTvb9jHoi;B#n{O)fFVLB0tfTB>P%*op8HI*8(V~`-2p!(NJr!XbYeD3AQ8#%QC zMv=wDo)iQNpAqW^VK<8*^!8foeC>R7U*uaz*27hp*Xs`o&{qiugKQw65BJ;3m(jLO zFS+<(QFon7#QBu%_URurluyY6<9yv2>B&dqUb^Np6Vw%H@_Ie@h}4P{RqTe*`P*tg z8@U@^|Ho3PObmK;C+n*l-O+q@hwpxfvt{?sp~9nw{}~g^TWvdbtkIZ$)C+W%nRzBh zPgBAv$LEIu{WZYrJTVcK%1`(=inPpwE^@T?jOX~U@SwyQ=a`*JX_YM(7KC2-+PE@wPghn{Mqxrg;NTfXxEE#RVB zBMy9WgmkbS%{cqcnAE`*(Sj5skhv!=)6={jsJN0%WASh9+g^U+)AmwU_;;eO~*2&B@YXkPNm+5NaEP8E0a*C0dH9lrFYrb7o?Y zc0)qRl`KiEq#$iu6~rmY7WE+b%Djly55d^p(Gqy~>f51xKAsv>IPC$m+S0Q_?q1k_ z06bL6|NVlgpFYtP;?sAas$Q<64306%ii3K~Os)Wd!GN+BFG{W#4qa097BQdy(PVFW zwW@Z5HbE)fO!i@T=DIQB==C|pn;4!*k!+Z|j(gEILLK~VsH(^UN0|MlkIojIzcdrn zA29Hksr&aNIv2Vrd6X~LLSw5Eio1$c;@(YmHOk=9bNn+H`!jA zb$K=%n_r)+T!LKHNi%oSdLhV4UbW(hoZ!lR@BVVV>c@ zsN>)GHXq^r%~4dtiMIOv91ec;lr{`_9<$Exr~YSV_CEx%(>b6yVdVajHuU*?8+i5? za4U9NtSb`u{$D`41PEgbp3HF-3=VNU`_#ti+SlY+Hkm3O-MUf50Tc&YmkjzXIB2q? zaG>@7)4jLAweB<*u%{Az(#J~8(()-9{xu6-9*Iq#@LM(cO*ygo@vD-x?}UEM{4b@A ze09CFaTmvytY*kjNimW0^!oG&sH$E?v&iT}mA*)qWBlzoV@IWu=I~>d+%ezB6Q)H? z!m9kwI2&X~>TqGMF*AC*y)KiWs-|QL2d3Kiwbpo}odBPM)-Jt}T1=l6SZ%(}qYW4V z8Y~Ru?oMD;C2!Y!>BwG*-&gJ#c3cVdD`Gi$d;Syw(YbQJlqX$6M#j``4Hg`$hJgSX zs$Dh%M; zrA~cO(<7T}RA{w{SDDXgSglBkW=pj9-tB)Zx|mQ|1Jl)Va5+|O_!v=|maTRc`CI8g zu-IT+ZXnbf7%xbtGK8P4zSH@{?b5$TgD!^f zh1ZjB@`A<(_{@XG=l7y{T*%*ngxl|H+tbPP@kQ&vfm4V81eT;Kgp?X_`gA(=sBo-A zl~5Eyq%szh=AT!kVHuyiOHDG1iqRgZ@R1Fd7l^;UyIw%F%612+c+P>}F5V4ECHN5v zsqHG(Y){@g?;^Rr+E)++eSsFem3Vq0_JY6_pCqEKBDQ*X0br=Z9#`@ zYZ`TQ4=HtGeFD7eduPpinPQ-%Gg`ABrsPy7yVoroqWz&BxPP8UVuxo@@lw3!EBE!4 zP=m8D+TbB(*(%6hzzAo>bhq93_avxCc~9VQROAvbUcWCop4B&OW%1>(wF_B}-RhrN z7**KkLrk_Au4JIoehwN%1SCF>Nf_Ev=q)|@m2^e?)=kZIThG~2#JxgwuStBzwvOmBVUxr+wk5NXdXX%EJcGM8{w-+T zKLH_dmhsGHQAF6K)3odH8cDnc52cPfSi_7-X+tL7Lm93Z0YK%gMxTeQ1y97jO(Y6D zb&GqxVCa0w>wANk)g{tVPdWBz?XWIs)QDVD$9-_`prEy$sIc265`~gj%s->!ZL31r zjY-tDBFZV2#}3M${0Nl*d{ooZLDv>+M^#6G-6mT^d#$_GwJ|t3l(%}Oca+UaGsGFu z6Iw4xL?;-FOWt;7dhjS9!;Nw}K^UC5udtayDrGz(C&f7HE0)1fN$1^V#D*!V>3+CJ zQ|t73`o#+pN+>yGF=;34gJID4lZgaXNv=ZSM3uBLaI3lPRTXfuin%sfPlBEk(zTz= z|CZXJ@TK7?{3HFveCS)8hE+EVRy$ki0HZcN(4Nh64&VthE_GRZNw-!>-7zsp6SRPR z>>$Q&F9P2*9h__H60u+TOXAwMfObi?9B%QhQ^i!8(OlH=s@H$V$r*9H4y<5nvFXac zOXu$?q#7!E7~!UO=Sr!3A#DatxnN%_8GOlS9 zDXRK#clHmqB`KiJc1d*M0o(F${4kJb!kPc=BL`k=3*z_7;M}S_d&tF&o-s3KlhNLK zk0zu?fIlHa7>ZsmT#Ff&G&EwSl$%fH^(eZ9|CP;46OiOp{vnC?0s%(;@>PUf=^lC6 zA#qNWmFT7R@xxJ1T|)oU`XLq1AVB}$M>#gnqZzYaw;#S0WmT&MSsfhm-sq;aBxYD_hgVtzL6nTUJ{hNi5}i(7 z^#NAR@q6z41;zO59bKjhFc;kWG?IZ08^T^XfBOxfPK~cknVdeB|OLXerlltjTFai#*@ClA&g8S%Qf*wl1b;uu zow?IdVn7HawKS+GXgo(d&HcBM81&vQ68s`B=>D)Eq;*T#e=p4+9ybZ5(l@p2x%$QQL1?=^FhI zf9`ICZ`lfJ!3bXx6BxttRxBG!Y6#KX^;3Vu6 z%(QrZ|1%oCyvwdHO32>~{N)3*|K|e^BU#t@J>Ngjs`5_>ux+!wEy<$6G{c@l9k$&G zg_R$>EDxg9=Oswq5vzq6f9{d^Y(}_tp1|Mto>B?zaO8mpGWqX_K8QQU`#LFx?T94p zv-`V-3aarS|F7m5X%_))jn4d@yUpDrIAW$z`?CrK~>3zcu6 zi+!@VcIeKd;1(Y20==#i960%1d%D#dX*(xa-_PJLFPf_QeUf%IZc14i>*=$=3+?^vuz> zqP_3HB{xe+&*>?}m~d|06_H;9J`%NG&xZanW5TQHApN1pvts5P^yE<|MuyO_e^b^y z__lr7>i2@R)4CW{j5NpMH=4%mJSlcSr%(Qg*cU^JF;Es$N_)9$f2h^&Ey#_H2VI!> z-`fqaDHN=!3YV-%r3%FH9d>NtMWHJO=oJZV78-5k!5K($&P&PqBI7iMm7wxgRVoQl zbDC71hd+!1Ii9a{B6IQC?AqG@CLz4mJls@qR>3IpqiuMWUF05eOM)WUAUn34b%P>n z!8n`cFi;0<2UgW_?<$ymxW3g3kg&ZJD{gDklCb)Qg_IO)F>N)xYCXNw9&`x|`Z%Uc zs+=S-ioXFp*0BQl@CaG-x@zX&Dp%H~L?bEFpSodj?J(k-04Y?2+D)u8i zaLyIeZN0DMSDW@~`g;a2fMIFDNhTiw#_rUE$AWYGr)1j}e=ie*E7&+`i9BLzg-Fb6 z{9U>bm6e91qECTKjrr2gNtaH_S4NV3K3{e{cZ$}=2TsDTx7&F2!{(vO|900d6eGj` zs$BUIj+nji1*T0FC6`s1+nM3=>`amtoUR(7b>L;Y`-#*T_p3Cav2IFQE1i0|g*InN zNVW0OB`!T5uT<3&V02&WZAE(2M*=i9$37_Av2ceeX|wHdIZkJPS# zL@jcssH0>j-ZemutflpnzHilK%H)J~rmuB164ZbqGy+;EOgCS165~kowwqt(ettT+xB8YJ)5|jhv|Y{FV;i zWb_8p8(Z4UpVGRKg0fywzsMdMG00OcFV|EN_eOzO_HLRWniGz#UBR93uHHKWLTsQD zC~ijJA86vzGv~wburFaR$JE6*sp;pe!e^=4r90j&ciT=MtH&3!d@Lr*WCs8Gi8d4c z@v!GWP2GBrlk#KC55JF<$@C8UGrZM~du(W}UwHzhYR?QqMVjwc_1Qww-VYS|;j;R> z02a)dmyxWkcOH*UdU3y1Dqw9>J{+q-)K3kTbX^Gk=H3P&Sm`>YxC~IiKuUVkR`R3Oi}nj%6Uxn`trxu$-M3&ncgX2 zQH4s{0DT`doHV4SC;9P=5#aX2s_C_6&9p~zpn13kRQr-+96FS*RGi4fkapw<^Y*%_ zxDN0#pz=4~&%!)!`Nw(4Z(E9)<$Er)gtlj~j3KxRtkMk`j z!jdQJAD&q<CNyb4q>RJ{viEp+{U^58g42D-sOvV$v9^-(?&DptjF7pC7Aa&WQV z&hvn1<3f6{SdSE&wl6o%q+UA=^v`HM(dE&t;r^Cslbt9PZsc}Kv9$L#9KX_?H^)gZ zJ#_$fy<9n_q90KY>x~QKkK-mTR>w1jwoFGk?t|P&;$!dAKlWehyoLa1z1 z8ATk;2X9@o2*p>gJSf{jECz5y!&U}8&G|!i>GWWwc%7GjbQuF^Vo<`KJ72uKV_G!KKFKoAgkwkpkcpksW-;c(2XpK*~ZXz7s|U*S#9L(Zp!jH(sb@7%Rr@o~a##P5pO;?okP z=v#`moD|*D4N!KE+60e#$39PQ*AH_osxilFR4k*GqWAa_udLkaA|tH9zv~8PLlvm1 zw~o(U!^?E4mLBo04R<@Z^5FoQ$&#^G@V1{Puer_JD-k*!&2?TgZFoG8;gCn`C6)Oh zTl(K?tb)GU;s=FnWj)T&7ETFx56Z_$YR)(T5fs`?LgxvahEUTEV=sVnCeG3E-R!1K zZ(mpfX~{Io#u@Ht^!eWINAki^NDzkw5*MGE$f4z9OO!|P^Oi-r*ntt91Ut|){8j+S zhZ6h>D_OqQuGCV}_Q|lNn1mZDg|}v@N_s;S*NdwRQz?S|!XJMLdzmY6Ws+w1CX z5<0Zcks4@5h*<|G>&h~0t3HPPX^^9GvBEjTOj75}$Af?bd5nKskjS9u?t{rMkp1*> zP*Vo6TI<+=pyiI@tp24|@N??pvo&_2e=PRKJM5j#=qQa+{Um)NXkAJ-U2v(BU4vIw zDOZ}wg@pW&`h+q`oGc_gyIx=PCdb>!6&0ME-UF6p1;(itDV`{J-WTAP`{5-BQK+Q| zZ@zJukZ1ZivFgg}3$qL+W@oJf+xKNynt;mCKegW}^QIFQ9Q|EKYj5k+8K9~V&#VoK zE_Xd^m14>VaR^H`xlwY0%TJ|@IDD;gr_JjOOAAH>l>JWlMSqF&P$Nn|`{zK-n%il(~ zTZ7-;qR?4FL`nWTnum^GEn;D+7ZiUinw7k|lPK}KaKXO@W~IyHj9GPzwb zaZ1g#R&6=ND$DqyjGtfU303k6gzuZU1tH>%wt$;A`?;*+@21<|r&q!TqhsHRJ7)L% zP&)2BH0Oz||6>b3+HmbwQ`n=)+8N~AO;Ykx2FDnFcgQ~E$w!6pw5ADqHb9R1dl&F- znPAnE&J`Bla9Fkq;`!h)i%%QeLOGIZXUgFDVk6W5Xofu%^|`=#w_QF>?T3MfzvN~& zA*%tH&toB-^NX(g5Fu{|U|a2e-T1{Vs{SIWNukMTj?TrNaY$;x-OkEiBsKLHNsY3* zX2+owp`5z|Uy-)tIb6883TG{0$84s$ZvNn)EbZ&$L%AKxH?=eO446Bh#h)S_2q{e4 z9VuLs!ssMMLo&B6VMK_6Hs9V4bC#k>l$sQF3slp4 z4yHy$o7xh}X+~})wpY!Ct5h6c6)Q8c&LvxG52{H^Cl`z{rgskUk6;gKJ8MkW*#ySG&UIgJ9M_9q*s4e)~ks*>$)Z(-D!gKCmVNH((**J6VXD6 zmSSp}eIWXI@^<;pXt({TeQi@h(4tLf32obTG!3-F8*%}t6obSG?`Hs6`pi`#M6-cQ}plH9AkSvSKZ&0%?2{9eHi7X&&B6jr3&6v?| zVC%f{x1xTB!wBa07IP9~ZN8?*wRfcKr(np=K+qW|lT2Blze_Kw(`y;07 zyhd6}<;Vc&Ue&XOoyL{d4w!onv41{ii_JUmw%w2kXoFE%)<<8tF)Kah$@OW-z)9ugBxkYm*c4Y`( zWqx4UV?2>M<{i6Q+#Pgl@TYdbZ2Vx3e^ID$tvZ#nuoxnkLZzHjn|X6;1t-^VqoHzL zzs*u=K@LVnky+}Tq7|!hKE!Ms^zwP~r;ATIjH_9A0qxQ|5_G8YjGHX){XIMK%Wg85ph_7&WN$cAOe#wJtpc1#4{sGzv6Yit9E zs87)SdXJ#Y_~Q7}%OIh6i9OP#EVk-i#%qAhb0arTpjE1ubk~Gk!-X$r-LjT#61H^B z^+AEA(+#iEJnP1aLk)@%)M!#sP=0!O{2Y*#V{(|R;U!coq*!{7pz6#DM3)07PQywL z3q$QtNQ-*dNnG0wCf994wW9cC`G~T#fE)SF$M~tQy3L#Zn4)8~y#$0c}-@%{Q+f&t5VSWpgS)qxly0bzbOIPQCE&4wN>q zR0HhQP*q~qm87_8y_KPJ4pkE74nPBfk{vl9u1k-|!2!?#Z<0ef(s_Uq2h)zQhgQGp zHH~_E>6Z?6{@9;dk@AQmv*z(r&Ek+t6aHjqG-kWzde$8hf|bL?}-WvF6a<*WmO|IQjIo^eV* znZ2>;hC;ZZV)?zTU!GgykeWhvv+$JEqv)}lZxZPUFH?_td9i_X96^<^)JP24&L@pP zypxsGLFplOgTt2YPHNb>8_eB`T_ZTIgKFnzsSA&Kyr!a2@rAZ(xF=700(koAy`E%; zuarr8wD#)vqTzFt1^bkCw3x4MR%M^61tT`2*9i)0nYsLdvgfucOo9#Br^$Om*utc- zVqz?$e4v_sP`njkm2E%vT`Cn3IiSX70ucry( zlE;&p{-T%C0e2o|^z^Qa@lS$3U^_!G6PTf3gbmeFqrV2S)w3!YBzw|cF9ZrHYFSOJ zME90&HNkx|-kkZuieogqFv>{vx{8adH1OEWWn1s6Xf%vhjB;83e!#y%hlutv-)xJh zYqlrS1S~Inta;k-H);_4Z4do6eLi>BHE%1ij%dz@J)1yx6=)}sDF4<@WT1on7dxT^ zgCdhUHbuo%Cr-oRx!&{0`-E!v?p#6e&f({vO76Qn`uAeuzurr*z4ev9UV;~_NVy0u zcl5|T2m&$nzxeOVB;fXDf)D9_vLFZS+`3mgfNv15J%y4ax;rIEpjY1}@k)A^LmAMW zrh1_vwkgWTHWy*jq(0e8alqG;b(_s+E|9;@v$Wxj7==U&f%-y<#x(RdCx#M`*}l>r(+ZRZb9}F z$4$S<;S4aQFjQ>^nfCV#?*Y_iOu$A#KG2wVjOFX zf_1AaRCWtSxk8^@8x|0waoj)k|8@UarzuX$G%IAPBV}aflIWYIHA%4~87a4NXM(>a z+gQV^1YsyQCt~84Dh3uMnp+Q4GIT&&s(hsby#>wnTRT9J#+L4`JS3l-QicH>+0x_+ci+vyQbF>p$A#@MeaT%(DNm553=Y5Mrzot zRr*07$?w%gGSzbm0&O|fa;U%Q-xZClYDHYV;08%n!3h_DKpegVs-|g0(2l_xK(~!U z7rQ4`gmVAe!_*{fBo>Gh4G`WZQ+=HP5XXlNhjs?$b7vXeEla&%qV9V&iVxAc$CoY# z64-DLMa&I1cW=?q@D<~bSaMn~MMDb&TJIYwMc1cdIiU;h)@pMIuWp|kOm|Y+-Q$CL zwX&;tZ-$j}T|1?#`=VH}Np;)z>b*CEQ*ryLYtfl)#vu*`6AalZiCOEx&b&ds%2XI~ zQh8lXPxeD|Q9f)_KE!kTW^jl@V348*q>9p{kOU1b-Px^x1u17lpNr4I+_39tI=n6s z;-q$i0%blCRit42w{IH@NT$e(6&bs^Oy9_&`suuwUfbOCw#I5NN1gRsvg|DBw?o#6 zxtFs(2XP`-={1Ifyp5R8LL=7Z6WMd#j88j~QxV6~V;+9yAd>*k#+;jTZIgv@tS9Hp b$?tr0?EBu}oP%G#=lrAp_&(vT{fqwtau>e@ literal 0 HcmV?d00001 diff --git a/docs/manual/images/results.png b/docs/manual/images/results.png new file mode 100644 index 0000000000000000000000000000000000000000..f478fffa53124cc366144bfc7b1cb5e12aa114f9 GIT binary patch literal 5148 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 literal 0 HcmV?d00001 diff --git a/docs/manual/images/revealed-feedback.png b/docs/manual/images/revealed-feedback.png new file mode 100644 index 0000000000000000000000000000000000000000..37832199410b1379eb81a77e417a4844a3858054 GIT binary patch literal 8214 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 WdAolmA>*Jve_PK$xA><0^Zx-=cc0_{ literal 0 HcmV?d00001 diff --git a/docs/manual/images/spelling-retry.png b/docs/manual/images/spelling-retry.png new file mode 100644 index 0000000000000000000000000000000000000000..34fdc7994e6aaad83ee90274500d3bb9dead7e1f GIT binary patch literal 8209 zcmZvBc{r4N_&3v;6h+FGWu_lTve%I<#yF=kg>q16jJ<4w!IVa`*ebgzWtS0I3WLlT ziWylWYxaE~vNK^Yc*nWk-yiRFy?;D2-}|}m@AtW8?$5nEpF8s3yRg&zlKeb8Jg0Bp zx?#b?!)wT0*PJ-c{d{8mrIGu^i?)FM!$WSD{>2q^9@*S>y>o|0iMu|*!yE3w^T&}1 z_mbpZJUoC*!2jOiHOxHrziXbFBc-0I>kbbOIQ;gFzwcpqm*1U?m(doy(R+@b_4wAW zSCB^cjCZF)kfj0lZlwL0d@K0&S+aT%6-vh+9_*-+?p+YQ1+>qv39_$XBK(zJ@qYju zT3!%v1U=_!Fhzi%%|Z@qt|Q113?*>7X>n~I@04meq}HvhzZSAdW39LLJ-d1wkr7_% zJb9m#+SYNUJpc+c-fJM7O(|`HVWWl6G1N_cEjP?m@FPTRSTuZdy|N~nv#N)3j%$hq;_tHhQhsV=`w2GDYyp@8LD%AXYnTc%8KG43! zfhTR`aTN^ITuB7v;FSkqW&eU8b)MkadsY6Q@F+s;=Gy~b-k#{<&?K!#(f=0gXl{2^ zm9yg-jd4m7qMa<-u07iZ%i6=Z#iao|>pQ1%r(!M&5`CDL!Y3!c(GuS<&Bo!o!mxUW zy1LiP)uItw_}M5UwsnT~6dYMqCZx|sO@>Y{ZOI*8{61*=YTYvA-h>M9<)QN0gGkqr z|D0{5{0itx&1z2Kx|(J_QH)~vyg^<}k@=L0Gh&%>_C?*r4D~)dJHL-X zoxHlWVDpTZ=1-hIThzR_x4yu!;#$s4@2y{Qn6eBx4@?D?+*lAQj4SHMPO@9pLZLmg zi9~Q+q>Lc4H#cB02?S<5uOnai{<<=usPRE_0V0(_Y)T)JOIvrM5uR&f7tI-BT62~m z3H+wwH5O+BlJ|2;N@>$VTB%J!g;Y?UONDH@f9r3}xQ(=T;dJJ=^zw;TW@){7%x?Qu zbz;4I#@uFrOo2M#8cGX#e9qRlkNJjQx~OIY;4Tm$i2eltRZsM;QzSZz8`dQFgLm8+ zjaT&YO0DZH3^u^c-Zus1*3YK#V}LLD9alp(#ltc^S7&RtPZuqeJ*$SzLsAbf5vUir z?!n>q`VPR^!?UGLf`#^fE`9$VVugJeCIE$VWWio9fo}LE*K8r9CRdhO{q&V<D2vQ11uFyOVgE(DwdDoI z2|QJ%8E3)8%4OhZ9?-=n$Bnr@FHr2{5HCQ32n=|8irIh0cKjT+`QeMa9k*b+zb;rki2&5R{bq*H)GsoJoI28Dxq`p1fw1k5kpm*f}1*1mudVT z$iE_-1M5?t+HU5m7v4X7IK^03WL!?YKWN=cVMxpMIbz@im{b zR4Feq0CD+q8!dv_U__A0OopxfQ?zTAO?KMOREt(`dgnimWH}ti=Peh_<(j>7%e;#} z7NeGLcX$7RBHEra?wPvs34$L=NL8>_@_lsl>*v)kyeNSgt}f!eKyzQV8!3-T1tugTlke;Ev1NoiFw7~-GDrH zyv&NmaGgLV^n;t4flJW+;Of%a$!I<_<}%T)>GwBKS3FELaW<#I9l>JkrHjcj#2nVV z#>7j92Bs4jvv~vAd*Nb+5L|)yf)F}7NMw9!F@=`=6vHuiFgD|Z{v;D%CoVx<9^Bs9 zs^8ExTAZJ(Jl80m1z*{HJvg0QAbM{V-MjuCxTYk_u3KeAsnxa0v#OMJ-fFa1&Sleg zVwk*RxOG%RW0SwTQ?@?VTQaYI?xc>gD?FG|(MC4YrJ`^xX5%hb!K)f+-D8AemEZ{Y zm*fMB^W^6*e(X7pmr;|8s;rud8}#8}8JJwN(@)t0`F9fJ>x9;A9aw2~ql<7^=H0pAs zz{?R$rhTAC%#wq3NZlCEW~SeTV&xw;u8_s9O=4+(ml#%k<=IS-8@BIIeV3i_YZ`r{ zOnLrkmF#(8prCTFw4okG+Q0;$cM?(>t2U9cnBK+*9c5_rccB9=`OcUQPh*)we{Egi zm$u@05C_uNi;@2B4zev@6zL4j#CDx?5)o3sntCnS4s{_s*$IK(4=i^<#Wj<_f0O2g zW=;RT3hv0h^7$|ifMAObQ7QdX+in-VO`;iXYYL(1$)ytRp{m1AFZp`%{yw|tH23PK zl9iw5_z=wo>xXLdrb5LDi>bB;_GVLLd$VY>4q;t{Jk4rFmq7xAix>uVK1({cGx&F3 zofo3WWI$@wTZjLf*nSoS{&6~SB(h zQO8yD@}cUwiQlBkY*W>)lo;+R%7)pizPEaB;+6V8NrKL|{q-`l4dm6zlpPk=iepUf zN`j>Ve^umxXRW7JC%g4!S0dzo`bMKfu6tLHEKH-X3Q~7UcU=!5{Q6U;eII@`PVzts zpKs>%QWR(6k-7`=u7tOIPPyr5>0f8rhOnv!5Z zX|@3L%UuVFEE``7Q;Gf($HGm*H5iUsv`}C`m9}b##?XTfK`Do&`@5TSB&S1-ly{>d z1JyiR_Hor#`Qbsu5^fu06=~Z_*XZbs*Z22k16|R2XjEho24J>WSk_Wk8-A>x6QvY5)>L3sF>IDH+urb7C<+Ekdk70{Ud0@)+j z^k(=vw;yO&Q2fiy%c$e#=Mj^gq$Nldtf=3=%ECZyacg(%iHsbQ?1b-fF-6jMg{_t~ z#}wLSEO@Xl%EFN0fxV9q4c%`J=W|#|l}no7U%5jX#c;=A@E`9eZx`zBR5# zYzJeje0Y9LEN_;ln0bALjV!3(HXrsOKdO1*p#ho8XV9j{EmxjM$IYSeZ}=pZ|*G!AX8%vtothy9VlbHsc{P_Z0w~ql3aI;pr@)q zIHsq#aVN1-xNWOva3jM1n=3asu$Fbn#RoOK&}pxu1Fs7>E@r|`PQBr~W}#5t=B_n; z4tD7Mi1D`HizC5r8qF6c8K>K@wKko!tS72N;b}K641bn5?M=`~oh+mJCNuoL!NzIj z3XWE*9rjfPEK@rA$c$WJ1M&Cc#g@po^2eRsPFRMC#|@=m7D0#|oW3gUy1<0kdPOo- zpzH+{zbAT0^kP{OQ+8`8qkTn#KrtWTHb0kq2ZDeXCldSAVr0DbCO6))jm0y$VTw(w z&hh)O8dLry@6-CJq@B7v#Go0_m|xnS$5y=H?WL`;V<5W=(K2?3>A1CeoNaWYyQs&x zLD$Da{-Ez2P4cv#RZVm3>LYvW+Yq#0g@gg$bd*~3kTE@DQPHKZK(f$2&F@@Zqg~7U zCR$?}`eThEuw;88sk}*$?uP-Xwahm}thL-Jv@q}_Ry;l+<0({*bz#?{ZTF+ApvqM6 zzT}}WnzVT+|D8r$UnPTIZ%w^F=u=U07b#@Ye$3PFNQY0(P5Qw4BR1 z$!=|0x#M*XwU@#-BQ0wkM#+q#27*a6PFDV28KBh1#Mo zSJxis{rD(uw)0F^b){EL8M%@AdnU5DUse)(a6-dnu^Ihx`xaRFB77oZ)aBT9sU3?# zue*Mbtq8NgiGS^JEeQ5 z5fwOrXvnLqDJrLJDjLFy_X;br7xjyH;xC0i-U1|prG4$G`<$4=%(?05MM+m`L?7hS z>C*KwG241ZL%G6sV%5qN@}_G;T7uu2`=lhb&M$B4Hvpqhy47-DAX~I9p(AnXrZ6If z==bfbJgrxEG=V5vAs^)MTcTT%CI+XXBC){nA0joXNwsQc53J8@p49y}-D=Sj=bLS* zYDA%pfk8+lA_{BbAkhCBX`s9^FR5Y*bAwaD}?dPwSeX~UM>HYQ+*?n3)Pp)o4?j}?uj53=6+s_rR)z)hIV zY%OQRhL~)07>TwgeX73}1753NW9i-nJ`=6*;$5<0; zSsk3P><^s`-7fqVl_^#m?R`6!denpgpN)|Usj|;lIK0{|5*2tMA~+#+ww0cZcJXc zCUd>;8bDMDR(WfZEgo4(qe3KG#XeP2AA+~z-f&heC%S;ImS+H)BD^?HRh)cGL&2|RB@a7HCKEmpmsLwP`{3OaijbHnL-KgKlWoPWv443^ zu==wYk2VK^v>^zs&13R6>nYeFmuKw$t*Dj-VhU{0T-jKp!s0G-xHcK3Y80ur>>%1% zyZPiIOoRJk=N25GxZ&LDHCk$r0}vl<6B~5XAh32OPPg)t#2E2-BbN#f2yFRum&>Xa zyxOM+^~d%Fuc72VCbXcESfo!-8xm-Mu{=z;*wNWP-5FnA_l^(e zx)--O_!-7F!nPs2H6b@YGfC)=h97D^0y_mY`O>tEHx#uFs@CEbyQ)*$7*_M1=z473 zd8eX5Pt7-P zn=SQ(G^6c+cU6Ngnk<&|fB3p_GhY;B_hzbxp0z4qubwx4?r~##MG{H`mL5Mo#_c@2 z5A=b8>cIgO*~dn%{g(eFM?Smd{#BHgAxp6qUW&B)`GI04&oRb!JgC^97x&0kZrz_) zgC2_!^yvs0w|1EO5gX{N+qIhL)Q5%oa zFZZYLuXS&E7uf%T=G9DsLvEvcd423erbge7ZkV%A-Zb0JpTp^UtUg&Dgx(G59^-)t zqD~K^&0S|kqMu$&O6=&4azIwMj(ZTl>kcCoeT{jgbt|kmB4E+$X?)ke{=-Z_Kz3rp z{;DJH{+{szno>Hfzbm6LiGV!(A6Dm)FJ1x$(Ep=vMkF%*5(ulX$viPALx|w8&#~Jc zES76(Qub|;a$NmOcYvY_ty3(2;s?j&1Wu1e4?Ay(l!Hta54p+aV-1(HSU;Yh_Wngf zR7xy0U$MN;8sw{?&jyW_j{(N5c(V5&nypZZXVRB7MJkr0E`+BB+#^3=bm_QFj9YO` zr+*R>m)w?28mmZvQQ+F#ILdjK(ipY8%tGzl4~GX*P&+*vG+lycr7fM)Y_Ba+DK6oIqv*CT%Vdy1R>kj0Iq;9`Rrjr4LWtUI>v`ufT@p9YEn2sO+2 ze7L~!o29z?>?wD064>yOOQCRy$Amxa_!~__BqPy(_VrOVLKkc&(xNlQ>k=ffE7A;; z5Le#9<|~$*OJ}Wh>Jty6<|3#MuOLb-n_u(e?q?S8B=WzY3vU>?{f3_@amn6KZPewm zntG`X50G8XI;pI8>zp5~cI5Yw;v7S3-a=7+)zGe=?Mi3O)jYn^0D*}s)j`&+^hIbW zw4Rf0tS^s^bVFek zN%4@DrV?Qg_Nw^$2UXGJ`4_cQk z{d>|$zh!m3rMvDlsBqn>+kkZ~JXRVvoVv}H&I8zrB&!7n;tykbifqE{C&m!~)VdwiAIc>7ObTbfp? z3Q+6mZ5x@6M$5SWx&?!yImIAgunPKpU~RVMS$bSiF>&XH*5%f3vDH1Hv_M>|(fHCe ztEyd_aS*fjaJ#iXC{#n)hWc^8V6Ol5ZcX+HrgxkHOE^P!DBkR$wr!;4y70?Dro5?ajU@UcS9-<& zoXcOHdUV@`yR7<~%Xgv%W)Vli|9jt+mvSgMA7m;~)}}8#pO`-mCt5yZy3ejW%%%dH5Pme*HUWCW}a zC?Hv~K7)hf^qhUw!L|Y|8YKInO-@ZN<78HniMIadf>`=)jLL~1mU&#fUFGR8;uIul zw{tvHA=fVf(?iBgbx>L?r&ddCy=G;_S+PqwfekRfCu2Gi%6&`JWG$50%(+2AHe(9Q zUT3LZd3#K1U`%&yaOKF6^V+Yk6y)mE&v(}@Hl;?dPFo`7=)(F3l(GKd z{efw>#-)&*TJ9Le1-@iH92UuGWpZaX8*)K)ylvwG`zOrw6}4R2~nRL6LchrAL7idN@Z zt)7XPj91K0^Dzd04X1;{`mHLfil>s1liyN`oxKauTK4N_vcsiR{CZ(?C0ty!b#3dr zHuW<(5*(1Kt_R0Lx}>#$*zUBw*y;CNdo2E4@}Rv#2pRDGe@bWPzeOxv6QW-{COy`H zdrWTZN)2oBt$*Lp->5G<#%v{5h-K`ISygI=+Xwlwl}MYVQgK(b8hvdF(4GtvXv=tU zH*tT6Qx!L<4W?q_q`B-M8Q`9VWoGkvUnF*MVCx#XHx0hrt^U`O$T8Mh)&8p1VHriM z^(nQ{Q>`is#4yZdjM?$;aAnnWKpS9QXmT*E9r!Du{B2NV-t*PiJRQo0_`g>m`}g&2 zStSUQFPnuf%C2TIHc90(QoqVK($6RiPajRA1aF``voV-n^=rNpg}s4lFWQj~fxSNa z5qU2a5}}-o?I;(9nw=iJ!~i>d`t&jj7Gf)A7~i4Aosw9DsPfNj^U(5>=-f=> zi{$2@v1faK?Qj7yki~_E>Ou~Rn`lPh+^jU|y zFN{kYKVsfRFTIYfO12c-Z4KE})hP?pl){%SRy^01CT=&7z3W|Ao?LRLziLgseB*`| zGbNhcop_W7xlR(#379m!1O-Rti3{qhVr0%G=?+EkrR|2PQ`rMJqQgnzs18OSjD9`J zk<&xSanItU%Iyn})#n1t?s4n=P;KQ0v$G*tB1O&OXX|>_w8m|1;QEc!*}=3R6Q5sc z{D|8jD}V}FkLu*=2Ire25q17u(pR;2DNKht7)LX$v1rm0-S~b-G2ksY!yFo$vVU(P zj{lUXVfEu7+KX*O#tF;mN$1@u%X9FZEDT#oFpWAU7)~oN>rtPq#wU^xk+D|t1mA0B zUd+#TfMdBePC??B4-wVg=Un?ux-KPjkqXgW=w%E3l;2w_NY8)=ccrR!)YUu&i~+dP-0D(3b%xJFivEJN_rJ zL4X0Sl}qOV69K*g{(DU&|wDUY39-3|<*#zvvK!)ZMf70dNrpnZ_o zpz9gJL75YbQq#r+ri>SxNyP}QY1A*eQ>*Xf0o%KElV0Xjbh~NeB0KOQv)jITApu}uHb}8#dc7OxzC#G6cOveWfP_w(EjYLw8^s#X4dH;I&LMFc#txr zuY9#vAJ~5WjAi_S(#<28o9X$Y&dS#7=$}W(Y@v}(I?`D|@6Ke=1_SgL z>$wTvb9jHoi;B#n{O)fFVLB0tfTB>P%*op8HI*8(V~`-2p!(NJr!XbYeD3AQ8#%QC zMv=wDo)iQNpAqW^VK<8*^!8foeC>R7U*uaz*27hp*Xs`o&{qiugKQw65BJ;3m(jLO zFS+<(QFon7#QBu%_URurluyY6<9yv2>B&dqUb^Np6Vw%H@_Ie@h}4P{RqTe*`P*tg z8@U@^|Ho3PObmK;C+n*l-O+q@hwpxfvt{?sp~9nw{}~g^TWvdbtkIZ$)C+W%nRzBh zPgBAv$LEIu{WZYrJTVcK%1`(=inPpwE^@T?jOX~U@SwyQ=a`*JX_YM(7KC2-+PE@wPghn{Mqxrg;NTfXxEE#RVB zBMy9WgmkbS%{cqcnAE`*(Sj5skhv!=)6={jsJN0%WASh9+g^U+)AmwU_;;eO~*2&B@YXkPNm+5NaEP8E0a*C0dH9lrFYrb7o?Y zc0)qRl`KiEq#$iu6~rmY7WE+b%Djly55d^p(Gqy~>f51xKAsv>IPC$m+S0Q_?q1k_ z06bL6|NVlgpFYtP;?sAas$Q<64306%ii3K~Os)Wd!GN+BFG{W#4qa097BQdy(PVFW zwW@Z5HbE)fO!i@T=DIQB==C|pn;4!*k!+Z|j(gEILLK~VsH(^UN0|MlkIojIzcdrn zA29Hksr&aNIv2Vrd6X~LLSw5Eio1$c;@(YmHOk=9bNn+H`!jA zb$K=%n_r)+T!LKHNi%oSdLhV4UbW(hoZ!lR@BVVV>c@ zsN>)GHXq^r%~4dtiMIOv91ec;lr{`_9<$Exr~YSV_CEx%(>b6yVdVajHuU*?8+i5? za4U9NtSb`u{$D`41PEgbp3HF-3=VNU`_#ti+SlY+Hkm3O-MUf50Tc&YmkjzXIB2q? zaG>@7)4jLAweB<*u%{Az(#J~8(()-9{xu6-9*Iq#@LM(cO*ygo@vD-x?}UEM{4b@A ze09CFaTmvytY*kjNimW0^!oG&sH$E?v&iT}mA*)qWBlzoV@IWu=I~>d+%ezB6Q)H? z!m9kwI2&X~>TqGMF*AC*y)KiWs-|QL2d3Kiwbpo}odBPM)-Jt}T1=l6SZ%(}qYW4V z8Y~Ru?oMD;C2!Y!>BwG*-&gJ#c3cVdD`Gi$d;Syw(YbQJlqX$6M#j``4Hg`$hJgSX zs$Dh%M; zrA~cO(<7T}RA{w{SDDXgSglBkW=pj9-tB)Zx|mQ|1Jl)Va5+|O_!v=|maTRc`CI8g zu-IT+ZXnbf7%xbtGK8P4zSH@{?b5$TgD!^f zh1ZjB@`A<(_{@XG=l7y{T*%*ngxl|H+tbPP@kQ&vfm4V81eT;Kgp?X_`gA(=sBo-A zl~5Eyq%szh=AT!kVHuyiOHDG1iqRgZ@R1Fd7l^;UyIw%F%612+c+P>}F5V4ECHN5v zsqHG(Y){@g?;^Rr+E)++eSsFem3Vq0_JY6_pCqEKBDQ*X0br=Z9#`@ zYZ`TQ4=HtGeFD7eduPpinPQ-%Gg`ABrsPy7yVoroqWz&BxPP8UVuxo@@lw3!EBE!4 zP=m8D+TbB(*(%6hzzAo>bhq93_avxCc~9VQROAvbUcWCop4B&OW%1>(wF_B}-RhrN z7**KkLrk_Au4JIoehwN%1SCF>Nf_Ev=q)|@m2^e?)=kZIThG~2#JxgwuStBzwvOmBVUxr+wk5NXdXX%EJcGM8{w-+T zKLH_dmhsGHQAF6K)3odH8cDnc52cPfSi_7-X+tL7Lm93Z0YK%gMxTeQ1y97jO(Y6D zb&GqxVCa0w>wANk)g{tVPdWBz?XWIs)QDVD$9-_`prEy$sIc265`~gj%s->!ZL31r zjY-tDBFZV2#}3M${0Nl*d{ooZLDv>+M^#6G-6mT^d#$_GwJ|t3l(%}Oca+UaGsGFu z6Iw4xL?;-FOWt;7dhjS9!;Nw}K^UC5udtayDrGz(C&f7HE0)1fN$1^V#D*!V>3+CJ zQ|t73`o#+pN+>yGF=;34gJID4lZgaXNv=ZSM3uBLaI3lPRTXfuin%sfPlBEk(zTz= z|CZXJ@TK7?{3HFveCS)8hE+EVRy$ki0HZcN(4Nh64&VthE_GRZNw-!>-7zsp6SRPR z>>$Q&F9P2*9h__H60u+TOXAwMfObi?9B%QhQ^i!8(OlH=s@H$V$r*9H4y<5nvFXac zOXu$?q#7!E7~!UO=Sr!3A#DatxnN%_8GOlS9 zDXRK#clHmqB`KiJc1d*M0o(F${4kJb!kPc=BL`k=3*z_7;M}S_d&tF&o-s3KlhNLK zk0zu?fIlHa7>ZsmT#Ff&G&EwSl$%fH^(eZ9|CP;46OiOp{vnC?0s%(;@>PUf=^lC6 zA#qNWmFT7R@xxJ1T|)oU`XLq1AVB}$M>#gnqZzYaw;#S0WmT&MSsfhm-sq;aBxYD_hgVtzL6nTUJ{hNi5}i(7 z^#NAR@q6z41;zO59bKjhFc;kWG?IZ08^T^XfBOxfPK~cknVdeB|OLXerlltjTFai#*@ClA&g8S%Qf*wl1b;uu zow?IdVn7HawKS+GXgo(d&HcBM81&vQ68s`B=>D)Eq;*T#e=p4+9ybZ5(l@p2x%$QQL1?=^FhI zf9`ICZ`lfJ!3bXx6BxttRxBG!Y6#KX^;3Vu6 z%(QrZ|1%oCyvwdHO32>~{N)3*|K|e^BU#t@J>Ngjs`5_>ux+!wEy<$6G{c@l9k$&G zg_R$>EDxg9=Oswq5vzq6f9{d^Y(}_tp1|Mto>B?zaO8mpGWqX_K8QQU`#LFx?T94p zv-`V-3aarS|F7m5X%_))jn4d@yUpDrIAW$z`?CrK~>3zcu6 zi+!@VcIeKd;1(Y20==#i960%1d%D#dX*(xa-_PJLFPf_QeUf%IZc14i>*=$=3+?^vuz> zqP_3HB{xe+&*>?}m~d|06_H;9J`%NG&xZanW5TQHApN1pvts5P^yE<|MuyO_e^b^y z__lr7>i2@R)4CW{j5NpMH=4%mJSlcSr%(Qg*cU^JF;Es$N_)9$f2h^&Ey#_H2VI!> z-`fqaDHN=!3YV-%r3%FH9d>NtMWHJO=oJZV78-5k!5K($&P&PqBI7iMm7wxgRVoQl zbDC71hd+!1Ii9a{B6IQC?AqG@CLz4mJls@qR>3IpqiuMWUF05eOM)WUAUn34b%P>n z!8n`cFi;0<2UgW_?<$ymxW3g3kg&ZJD{gDklCb)Qg_IO)F>N)xYCXNw9&`x|`Z%Uc zs+=S-ioXFp*0BQl@CaG-x@zX&Dp%H~L?bEFpSodj?J(k-04Y?2+D)u8i zaLyIeZN0DMSDW@~`g;a2fMIFDNhTiw#_rUE$AWYGr)1j}e=ie*E7&+`i9BLzg-Fb6 z{9U>bm6e91qECTKjrr2gNtaH_S4NV3K3{e{cZ$}=2TsDTx7&F2!{(vO|900d6eGj` zs$BUIj+nji1*T0FC6`s1+nM3=>`amtoUR(7b>L;Y`-#*T_p3Cav2IFQE1i0|g*InN zNVW0OB`!T5uT<3&V02&WZAE(2M*=i9$37_Av2ceeX|wHdIZkJPS# zL@jcssH0>j-ZemutflpnzHilK%H)J~rmuB164ZbqGy+;EOgCS165~kowwqt(ettT+xB8YJ)5|jhv|Y{FV;i zWb_8p8(Z4UpVGRKg0fywzsMdMG00OcFV|EN_eOzO_HLRWniGz#UBR93uHHKWLTsQD zC~ijJA86vzGv~wburFaR$JE6*sp;pe!e^=4r90j&ciT=MtH&3!d@Lr*WCs8Gi8d4c z@v!GWP2GBrlk#KC55JF<$@C8UGrZM~du(W}UwHzhYR?QqMVjwc_1Qww-VYS|;j;R> z02a)dmyxWkcOH*UdU3y1Dqw9>J{+q-)K3kTbX^Gk=H3P&Sm`>YxC~IiKuUVkR`R3Oi}nj%6Uxn`trxu$-M3&ncgX2 zQH4s{0DT`doHV4SC;9P=5#aX2s_C_6&9p~zpn13kRQr-+96FS*RGi4fkapw<^Y*%_ zxDN0#pz=4~&%!)!`Nw(4Z(E9)<$Er)gtlj~j3KxRtkMk`j z!jdQJAD&q<CNyb4q>RJ{viEp+{U^58g42D-sOvV$v9^-(?&DptjF7pC7Aa&WQV z&hvn1<3f6{SdSE&wl6o%q+UA=^v`HM(dE&t;r^Cslbt9PZsc}Kv9$L#9KX_?H^)gZ zJ#_$fy<9n_q90KY>x~QKkK-mTR>w1jwoFGk?t|P&;$!dAKlWehyoLa1z1 z8ATk;2X9@o2*p>gJSf{jECz5y!&U}8&G|!i>GWWwc%7GjbQuF^Vo<`KJ72uKV_G!KKFKoAgkwkpkcpksW-;c(2XpK*~ZXz7s|U*S#9L(Zp!jH(sb@7%Rr@o~a##P5pO;?okP z=v#`moD|*D4N!KE+60e#$39PQ*AH_osxilFR4k*GqWAa_udLkaA|tH9zv~8PLlvm1 zw~o(U!^?E4mLBo04R<@Z^5FoQ$&#^G@V1{Puer_JD-k*!&2?TgZFoG8;gCn`C6)Oh zTl(K?tb)GU;s=FnWj)T&7ETFx56Z_$YR)(T5fs`?LgxvahEUTEV=sVnCeG3E-R!1K zZ(mpfX~{Io#u@Ht^!eWINAki^NDzkw5*MGE$f4z9OO!|P^Oi-r*ntt91Ut|){8j+S zhZ6h>D_OqQuGCV}_Q|lNn1mZDg|}v@N_s;S*NdwRQz?S|!XJMLdzmY6Ws+w1CX z5<0Zcks4@5h*<|G>&h~0t3HPPX^^9GvBEjTOj75}$Af?bd5nKskjS9u?t{rMkp1*> zP*Vo6TI<+=pyiI@tp24|@N??pvo&_2e=PRKJM5j#=qQa+{Um)NXkAJ-U2v(BU4vIw zDOZ}wg@pW&`h+q`oGc_gyIx=PCdb>!6&0ME-UF6p1;(itDV`{J-WTAP`{5-BQK+Q| zZ@zJukZ1ZivFgg}3$qL+W@oJf+xKNynt;mCKegW}^QIFQ9Q|EKYj5k+8K9~V&#VoK zE_Xd^m14>VaR^H`xlwY0%TJ|@IDD;gr_JjOOAAH>l>JWlMSqF&P$Nn|`{zK-n%il(~ zTZ7-;qR?4FL`nWTnum^GEn;D+7ZiUinw7k|lPK}KaKXO@W~IyHj9GPzwb zaZ1g#R&6=ND$DqyjGtfU303k6gzuZU1tH>%wt$;A`?;*+@21<|r&q!TqhsHRJ7)L% zP&)2BH0Oz||6>b3+HmbwQ`n=)+8N~AO;Ykx2FDnFcgQ~E$w!6pw5ADqHb9R1dl&F- znPAnE&J`Bla9Fkq;`!h)i%%QeLOGIZXUgFDVk6W5Xofu%^|`=#w_QF>?T3MfzvN~& zA*%tH&toB-^NX(g5Fu{|U|a2e-T1{Vs{SIWNukMTj?TrNaY$;x-OkEiBsKLHNsY3* zX2+owp`5z|Uy-)tIb6883TG{0$84s$ZvNn)EbZ&$L%AKxH?=eO446Bh#h)S_2q{e4 z9VuLs!ssMMLo&B6VMK_6Hs9V4bC#k>l$sQF3slp4 z4yHy$o7xh}X+~})wpY!Ct5h6c6)Q8c&LvxG52{H^Cl`z{rgskUk6;gKJ8MkW*#ySG&UIgJ9M_9q*s4e)~ks*>$)Z(-D!gKCmVNH((**J6VXD6 zmSSp}eIWXI@^<;pXt({TeQi@h(4tLf32obTG!3-F8*%}t6obSG?`Hs6`pi`#M6-cQ}plH9AkSvSKZ&0%?2{9eHi7X&&B6jr3&6v?| zVC%f{x1xTB!wBa07IP9~ZN8?*wRfcKr(np=K+qW|lT2Blze_Kw(`y;07 zyhd6}<;Vc&Ue&XOoyL{d4w!onv41{ii_JUmw%w2kXoFE%)<<8tF)Kah$@OW-z)9ugBxkYm*c4Y`( zWqx4UV?2>M<{i6Q+#Pgl@TYdbZ2Vx3e^ID$tvZ#nuoxnkLZzHjn|X6;1t-^VqoHzL zzs*u=K@LVnky+}Tq7|!hKE!Ms^zwP~r;ATIjH_9A0qxQ|5_G8YjGHX){XIMK%Wg85ph_7&WN$cAOe#wJtpc1#4{sGzv6Yit9E zs87)SdXJ#Y_~Q7}%OIh6i9OP#EVk-i#%qAhb0arTpjE1ubk~Gk!-X$r-LjT#61H^B z^+AEA(+#iEJnP1aLk)@%)M!#sP=0!O{2Y*#V{(|R;U!coq*!{7pz6#DM3)07PQywL z3q$QtNQ-*dNnG0wCf994wW9cC`G~T#fE)SF$M~tQy3L#Zn4)8~y#$0c}-@%{Q+f&t5VSWpgS)qxly0bzbOIPQCE&4wN>q zR0HhQP*q~qm87_8y_KPJ4pkE74nPBfk{vl9u1k-|!2!?#Z<0ef(s_Uq2h)zQhgQGp zHH~_E>6Z?6{@9;dk@AQmv*z(r&Ek+t6aHjqG-kWzde$8hf|bL?}-WvF6a<*WmO|IQjIo^eV* znZ2>;hC;ZZV)?zTU!GgykeWhvv+$JEqv)}lZxZPUFH?_td9i_X96^<^)JP24&L@pP zypxsGLFplOgTt2YPHNb>8_eB`T_ZTIgKFnzsSA&Kyr!a2@rAZ(xF=700(koAy`E%; zuarr8wD#)vqTzFt1^bkCw3x4MR%M^61tT`2*9i)0nYsLdvgfucOo9#Br^$Om*utc- zVqz?$e4v_sP`njkm2E%vT`Cn3IiSX70ucry( zlE;&p{-T%C0e2o|^z^Qa@lS$3U^_!G6PTf3gbmeFqrV2S)w3!YBzw|cF9ZrHYFSOJ zME90&HNkx|-kkZuieogqFv>{vx{8adH1OEWWn1s6Xf%vhjB;83e!#y%hlutv-)xJh zYqlrS1S~Inta;k-H);_4Z4do6eLi>BHE%1ij%dz@J)1yx6=)}sDF4<@WT1on7dxT^ zgCdhUHbuo%Cr-oRx!&{0`-E!v?p#6e&f({vO76Qn`uAeuzurr*z4ev9UV;~_NVy0u zcl5|T2m&$nzxeOVB;fXDf)D9_vLFZS+`3mgfNv15J%y4ax;rIEpjY1}@k)A^LmAMW zrh1_vwkgWTHWy*jq(0e8alqG;b(_s+E|9;@v$Wxj7==U&f%-y<#x(RdCx#M`*}l>r(+ZRZb9}F z$4$S<;S4aQFjQ>^nfCV#?*Y_iOu$A#KG2wVjOFX zf_1AaRCWtSxk8^@8x|0waoj)k|8@UarzuX$G%IAPBV}aflIWYIHA%4~87a4NXM(>a z+gQV^1YsyQCt~84Dh3uMnp+Q4GIT&&s(hsby#>wnTRT9J#+L4`JS3l-QicH>+0x_+ci+vyQbF>p$A#@MeaT%(DNm553=Y5Mrzot zRr*07$?w%gGSzbm0&O|fa;U%Q-xZClYDHYV;08%n!3h_DKpegVs-|g0(2l_xK(~!U z7rQ4`gmVAe!_*{fBo>Gh4G`WZQ+=HP5XXlNhjs?$b7vXeEla&%qV9V&iVxAc$CoY# z64-DLMa&I1cW=?q@D<~bSaMn~MMDb&TJIYwMc1cdIiU;h)@pMIuWp|kOm|Y+-Q$CL zwX&;tZ-$j}T|1?#`=VH}Np;)z>b*CEQ*ryLYtfl)#vu*`6AalZiCOEx&b&ds%2XI~ zQh8lXPxeD|Q9f)_KE!kTW^jl@V348*q>9p{kOU1b-Px^x1u17lpNr4I+_39tI=n6s z;-q$i0%blCRit42w{IH@NT$e(6&bs^Oy9_&`suuwUfbOCw#I5NN1gRsvg|DBw?o#6 zxtFs(2XP`-={1Ifyp5R8LL=7Z6WMd#j88j~QxV6~V;+9yAd>*k#+;jTZIgv@tS9Hp b$?tr0?EBu}oP%G#=lrAp_&(vT{fqwtau>e@ literal 0 HcmV?d00001 diff --git a/docs/manual/images/typed-corrected.png b/docs/manual/images/typed-corrected.png new file mode 100644 index 0000000000000000000000000000000000000000..aebef5ccd782bb70350e6cc4f5daa6ec479f3604 GIT binary patch literal 7967 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 literal 0 HcmV?d00001 diff --git a/docs/manual/images/typed-entry.png b/docs/manual/images/typed-entry.png new file mode 100644 index 0000000000000000000000000000000000000000..f6abc94b138d5e94fbd5ce5bc8dc6c2b5e965ab4 GIT binary patch literal 8187 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 literal 0 HcmV?d00001 diff --git a/docs/manual/manual.json b/docs/manual/manual.json new file mode 100644 index 0000000..431caf7 --- /dev/null +++ b/docs/manual/manual.json @@ -0,0 +1,14 @@ +{ + "title": "Capital Quest for CoCo", + "subtitle": "A player’s guide to both quiz modes, the progress map, spelling help, and missed-answer review.", + "author": "Brian K. Holman", + "copyright": "© Brian K. Holman 2026", + "edition": "Player’s manual · November 11, 2026", + "hero_image": "images/title.png", + "hero_caption": "The Capital Quest title screen, captured in VCC Plus.", + "running_title": "Capital Quest for CoCo · Player’s manual", + "brand": "VCC Plus Documentation", + "disk_url": "https://vccplus.brianholman.com/dl/software/CoCoLibrary/Exclusives/CapitalQuest/2026-11-11/5dbc30b7c69f/CAPITAL.DSK", + "source_url": "https://vccplus-git.brianholman.com/VCCPlusApps/CoCoCapitalQuiz", + "access_note": "" +} diff --git a/docs/manual/screenshots.json b/docs/manual/screenshots.json new file mode 100644 index 0000000..c8067aa --- /dev/null +++ b/docs/manual/screenshots.json @@ -0,0 +1,238 @@ +{ + "schemaVersion": 1, + "gameSourceBaseRevision": "46f4b9cae00951b9924af129b9f74e912766fff8", + "gameSourceState": "approved uncommitted map-color and answer-slot changes", + "gameEdition": "2026-11-11", + "artifactDiskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "emulator": "VCC Plus 3.6.1 (53)", + "processor": "MC6809", + "ramKB": 512, + "video": "RGB", + "system": "CoCo 3 BASIC with FD-502 Disk BASIC", + "captureDate": "2026-11-11", + "method": "Official public-build vcc-playtest helper; disposable disk and machine. All screenshots except exit are exact displayed 320x192 framebuffer previews. Exit is full 640x480 frame.", + "images": [ + { + "file": "images/title.png", + "sha256": "e551b0b41e899c756fa7620018bb5ba4357791f8aba83f32514f2035ac893488", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 1560, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/credits.png", + "sha256": "f1bf3976b1cfe9315a988fbacd9917f92ba0aa8f1c3c80d046ac27219804688c", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 2168, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/multiple-choice.png", + "sha256": "b974354f8db97b434cc5e51ff4e604e9b2c72bf56d503e195fd948edb15f17e4", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 3384, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/correct-feedback.png", + "sha256": "b9d5dbe6e64aeb235ad3f120054bbe528e23edba86b8ca380ca77252dc750940", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 3572, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/progress-map.png", + "sha256": "26346213ad2bf3db9bc704ab060f9505a55a00a06e434f3918b4a7feb4abe1b7", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 5388, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/northeast.png", + "sha256": "e5c35cf085ab176c3209ce6e21de10c4bcd91eb1e64c9d8a615de4c315b1aca1", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 5996, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/hawaii.png", + "sha256": "8aa3bc58ba87771854ddfd850822ef18a144fe08fb669f6591d82e7e736925ce", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 24844, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/results.png", + "sha256": "ef13f1b5d676ccaf3a3d99b37ce0b700d4536215fd90bd2e15fb934c45194685", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 33964, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/missed-review.png", + "sha256": "44909bca408b4bf9dbd1eb1c3680f9273b0b33e9138712921a720f2a99278e44", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 34572, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/replay-title.png", + "sha256": "e551b0b41e899c756fa7620018bb5ba4357791f8aba83f32514f2035ac893488", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 35788, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/typed-entry.png", + "sha256": "325d97d803ed65827d089ae117b692721ee27b5a5bfa87ef2806b31e22d4a43d", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 36468, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/spelling-retry.png", + "sha256": "8e4de7bc842824f10405c11c0a0fddbcacd85c028848c981beff329cf2ce8ec6", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 37292, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/typed-corrected.png", + "sha256": "c6a109fab2877ce7814217bcb4a02c7b2523ef40cbc37d2f955b726d5006070f", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 38796, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/incorrect-feedback.png", + "sha256": "5c4673f597c20058083655b1e53b59f1b00f95003ed3b720ab9195d3ffd3a52e", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 40084, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/input-limit.png", + "sha256": "534966d1eb5060750a5495645c9c7e46d89844b9af64d2eb043f504a495911d6", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 42372, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/revealed-feedback.png", + "sha256": "055723413e378f1d96fbac7809857417639bed0b577d6fe9a66f31597fa52073", + "width": 320, + "height": 192, + "capture": "VCC Plus vcc-playtest graphics_capture", + "fieldClock": 42980, + "boot": 1, + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified displayed guest framebuffer; physical guest keys and read-only symbol inspection." + }, + { + "file": "images/exit.png", + "sha256": "2c8f9768704e9705c3ed9beb51ef4ab9bbc7dfc99daa2bbf34564b51ea0f2b4a", + "width": 640, + "height": 480, + "capture": "VCC Plus vcc-playtest capture", + "processor": "MC6809", + "ramKB": 512, + "diskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "note": "Unmodified full guest frame after title-screen Quit, with BASIC return message." + } + ], + "finalDiskSha256": "5dbc30b7c69f95f325cf3457ba88effb79837501f089f7615d22ae6a6b7ee6d6", + "diskWrites": 0, + "gameInputFingerprintSha256": "3c4f15d6488ac5d49906d0b5d8229768046196337599259ac5d719aa279e7d56" +} diff --git a/main.c b/main.c index 4a0d634..442933e 100644 --- a/main.c +++ b/main.c @@ -39,7 +39,7 @@ static U8 title(void) do { phase=0;frame("50 STATES"); text(8,19,"HOW WELL DO YOU KNOW YOUR CAPITALS?",6); - show_map(49); + show_map(STATE_COUNT); /* Right panel is replaced by the mode selector. */ gime_fill_rect(209,32,111,111,0); text(212,40,"CHOOSE A MODE",6); diff --git a/src/quiz.c b/src/quiz.c index 26dbb0a..3d80e8b 100644 --- a/src/quiz.c +++ b/src/quiz.c @@ -9,6 +9,7 @@ U8 answered[50], correct[50], corrected[50]; char responses[50][ANSWER_SIZE]; unsigned random_state; static U8 distance_rows[3][ANSWER_SIZE]; +static U8 previous_correct_slot=4; unsigned quiz_random(unsigned bound) { unsigned x, limit; @@ -28,6 +29,7 @@ void quiz_start(unsigned seed) U8 i,j,t; random_state = seed ? seed : 0xACE1; question=score=corrections=0; + previous_correct_slot=4; memset(answered,0,sizeof(answered)); memset(correct,0,sizeof(correct)); memset(corrected,0,sizeof(corrected)); @@ -39,7 +41,10 @@ void quiz_start(unsigned seed) } void quiz_options(U8 state) { - U8 i,j,c,t; + U8 i,j,c,t,slot; + /* First question: all four slots. Later: equally choose the other three. */ + slot=(U8)quiz_random(previous_correct_slot<4?3:4); + if(previous_correct_slot<4 && slot>=previous_correct_slot) ++slot; options[0]=state; for(i=1;i<4;++i) { do { @@ -48,9 +53,12 @@ void quiz_options(U8 state) } while(j0;--i) { - j=(U8)quiz_random(i+1);t=options[i];options[i]=options[j];options[j]=t; + /* Shuffle the distractors, then put the correct answer in its chosen slot. */ + for(i=3;i>1;--i) { + j=1+(U8)quiz_random(i);t=options[i];options[i]=options[j];options[j]=t; } + t=options[slot];options[slot]=state;options[0]=t; + previous_correct_slot=slot; } void normalize(const char *in,char *out) { diff --git a/src/ui.c b/src/ui.c index 807b257..afa8b8d 100644 --- a/src/ui.c +++ b/src/ui.c @@ -34,7 +34,9 @@ static void spans(const U8 *data,const unsigned *off,U8 state,unsigned ox,unsign { U8 s,y,x,n,col;unsigned i,end; for(s=0;s<50;++s) { - col=s==state?6:((s&1)?3:4);end=off[s+1]; + /* A title map has no active state; a new quiz starts with no answers. */ + col=state>=STATE_COUNT?3:(s==state?6:(!answered[s]?3:(correct[s]?4:5))); + end=off[s+1]; for(i=off[s];i=len(points)*.8,(q,rows[state][0],gold,len(points)) right=q%7!=0;selection=correctpos if right else (correctpos+1)%4 + outcomes[state]=right if right:score+=1 # Read the feedback as soon as it appears, before its automatic timeout. held=[str(selection+1)] if q==0 else [] @@ -58,7 +63,9 @@ for page in range(3): cap=next(x[2] for x in rows if x[0]==m['code']) assert s.text(8,61+i*43,48)==f'Capital: {cap}' if page<2:c['key'](run,'n',8,500) -c['key'](run,'b',8,500);c['key'](run,'p',8,500);c['capture'](run,'replay-title');c['key'](run,'q',8,200);final=c['capture'](run,'mc-exit') +c['key'](run,'b',8,500);c['key'](run,'p',8,500);c['capture'](run,'replay-title') +check_map_colors(Screen(str(EVIDENCE)+'/replay-title.png'),None,outcomes) +c['key'](run,'q',8,200);final=c['capture'](run,'mc-exit') assert 'screen_text' in final or final.get('screen_text_unavailable') is None,final json.dump(dict(score=score,positions=pos,questions=evidence,run_id=run,artifact=result['artifact_id'],exit=final),open(str(EVIDENCE)+'/mc-report.json','w'),indent=2) print('PASS complete multiple-choice quiz, all 50 masks, automatic feedback advance without Space, held-key protection, 42/50, review, replay, exit.',flush=True) diff --git a/tests/playtest_typed.py b/tests/playtest_typed.py index cf004ce..06cb17e 100644 --- a/tests/playtest_typed.py +++ b/tests/playtest_typed.py @@ -3,10 +3,11 @@ from pathlib import Path import runpy,json,sys,uuid from pathlib import Path sys.path.insert(0,str(Path(__file__).parent));from framebuffer import Screen,ROOT,shuffle,EVIDENCE +from map_colors import check_map_colors c=runpy.run_path(str(Path(__file__).with_name('playtest_support.py')));state=json.load(open(os.environ['CAPITAL_TEST_STATE'])) r=c['call']('start_playtest',dict(project_id=state['cap']['project_id'],revision=state['cap']['revision'],artifact_id=state['artifact']['artifact_id'],request_id=str(uuid.uuid4()))) run=r['run_id'];state['typed_run']=r;Path(os.environ['CAPITAL_TEST_STATE']).write_text(json.dumps(state)) -rows=[x.split('\t') for x in (ROOT/'data/states.tsv').read_text().splitlines()];order,_=shuffle();report=[];score=corrections=0 +rows=[x.split('\t') for x in (ROOT/'data/states.tsv').read_text().splitlines()];order,_=shuffle();report=[];score=corrections=0;outcomes={} def press(k,hold=4,settle=12):return c['key'](run,k,hold,settle) def settle():c['inp'](run,[{'keys':[],'fields':600},{'keys':[],'fields':300}]) @@ -24,15 +25,17 @@ settle();c['key'](run,'2',8,600);settle();c['inp'](run,[dict(keys=['shift','0'], # First alias in mixed case. Capture input before submission to verify the real keys. type_text('sT pAuL');s=cap('typed-alias-input');print('input=',s.text(8,158,45),flush=True) assert s.text(8,158,45)=='sT pAuL_',s.text(8,158,45) +check_map_colors(s,order[0],outcomes) press('enter',8,600);s=cap('typed-alias-feedback');assert s.text(8,158,30)=='CORRECT!',s.text(8,158,30) c['inp'](run,[dict(keys=[],fields=300)]);s=cap('typed-feedback-waits') assert s.text(8,19,45)=='Question 1 of 50 Score 1' assert s.text(8,183,48)=='Release your key, then SPACE to continue.' -score=1;report.append(dict(question=1,code='MN',answer='sT pAuL',correct=True,correction=False));c['key'](run,'space',8,600);settle() +score=1;outcomes[order[0]]=True;report.append(dict(question=1,code='MN',answer='sT pAuL',correct=True,correction=False));c['key'](run,'space',8,600);settle() for q in range(1,50): st=order[q];code,name,capital=rows[st];s=cap(f'typed-q{q+1:02d}-{code}') assert s.text(8,19,45)==f'Question {q+1} of 50 Score {score}',(q,s.text(8,19,45),score) assert s.text(8,145,50)==name+': what is its capital?' + check_map_colors(s,st,outcomes) spelling=False;right=True if q==1 or code=='CO': # Adjacent transpositions, followed by a real Backspace correction. @@ -64,6 +67,7 @@ for q in range(1,50): assert s.text(8,170,50)==f'The capital is {capital}.' if right:score+=1 if spelling:corrections+=1 + outcomes[st]=right report.append(dict(question=q+1,code=code,answer=answer,correct=right,correction=spelling)) c['key'](run,'space',8,600) if q!=49:settle() diff --git a/tests/test_quiz.c b/tests/test_quiz.c index 5a7b997..8db659a 100644 --- a/tests/test_quiz.c +++ b/tests/test_quiz.c @@ -5,19 +5,33 @@ static unsigned index_of(const char *code){unsigned i;for(i=0;i<50;++i)if(!strcmp(states[i].code,code))return i;assert(0);return 0;} int main(void) { - unsigned seed,i,j,p,positions[4]={0},last[50],changes=0; + unsigned seed,i,j,p,slot,previous,positions[4]={0},first[4]={0}; + unsigned transitions[4][4]={{0}},last[50],changes=0; + U8 first_options[4]; char a[160],b[ANSWER_SIZE]; for(seed=1;seed<=2000;++seed){ - unsigned seen[50]={0};quiz_start(seed); + unsigned seen[50]={0};quiz_start(seed);previous=4; for(i=0;i<50;++i){ - assert(order[i]<50);++seen[order[i]];quiz_options(order[i]);p=0; - for(j=0;j<4;++j){unsigned k;assert(options[j]<50);if(options[j]==order[i]){++p;++positions[j];}for(k=0;k1 && last[i]!=order[i])++changes;last[i]=order[i]; + assert(order[i]<50);++seen[order[i]];quiz_options(order[i]);p=0;slot=4; + for(j=0;j<4;++j){unsigned k;assert(options[j]<50);if(options[j]==order[i]){++p;++positions[j];slot=j;}for(k=0;k1 && last[i]!=order[i])++changes;last[i]=order[i]; } for(i=0;i<50;++i)assert(seen[i]==1); } - for(i=0;i<4;++i)assert(positions[i]>20000); + for(i=0;i<4;++i){ + assert(positions[i]>20000 && first[i]>300); + for(j=0;j<4;++j)assert(i==j?transitions[i][j]==0:transitions[i][j]>6000); + } assert(changes>90000); + /* Replaying a seed must reset the remembered slot as well as the answers. */ + for(seed=1;seed<=32;++seed){ + quiz_start(seed);quiz_options(order[0]);memcpy(first_options,options,4); + for(i=1;i<50;++i)quiz_options(order[i]); + quiz_start(seed);quiz_options(order[0]);assert(!memcmp(first_options,options,4)); + } for(i=0;i<50;++i){ assert(classify(i,states[i].capital)==2); strcpy(a,states[i].capital); @@ -43,6 +57,6 @@ int main(void) for(i=0;i<50;++i)assert(answered[i]==1); quiz_start(2710);assert(score==0 && corrections==0); for(i=0;i<50;++i)assert(!answered[i] && !responses[i][0]); - printf("PASS: 2000 shuffles, 100000 option sets, all casing / known-wrong capitals, aliases, distance, bounds, scoring, reset.\n"); + printf("PASS: 2000 shuffles, 100000 option sets with no repeated correct slot, all 12 allowed slot transitions, replay reset, all casing / known-wrong capitals, aliases, distance, bounds, scoring, reset.\n"); return 0; } diff --git a/tools/package_source.py b/tools/package_source.py new file mode 100644 index 0000000..2fe614a --- /dev/null +++ b/tools/package_source.py @@ -0,0 +1,73 @@ +#!/usr/bin/env python3 +"""Create a deterministic, source-only Capital Quest starter ZIP. + +No compiler, network, Git mutation, private inputs or game execution is involved. +""" +import argparse +import hashlib +import json +from pathlib import Path +from zipfile import ZIP_DEFLATED, ZipFile, ZipInfo + +ROOT = Path(__file__).resolve().parents[1] +ROOT_FILES = ('AGENTS.md', 'LICENSE', 'Makefile', 'README.md', '.gitignore', + 'vccplus-project.json', 'main.c', 'quiz.h', 'ui.h', 'map_data.h') +DIRECTORIES = ('src', 'data', 'assets', 'tests', 'tools', 'docs/manual') +EXTRA_FILES = ('docs/PROVENANCE.md', 'docs/PUBLIC_RELEASE.md') + + +def source_files(): + names = set(ROOT_FILES + EXTRA_FILES) + for directory in DIRECTORIES: + for path in (ROOT / directory).rglob('*'): + if path.is_dir(): + continue + name = path.relative_to(ROOT).as_posix() + if '__pycache__' in path.parts or path.suffix == '.pyc' or path.name == '.DS_Store': + continue + if path.is_symlink() or not path.is_file(): + raise ValueError('Only regular source files are permitted: ' + name) + names.add(name) + result = {} + for name in sorted(names): + path = ROOT / name + if path.is_symlink() or not path.is_file(): + raise ValueError('Missing regular source input: ' + name) + if any(word in name.casefold() for word in ('connection', 'vccgrant')): + raise ValueError('Private-connection filename is not a source input: ' + name) + if path.suffix.casefold() in ('.dsk', '.rom', '.bin', '.o', '.a', '.pdf', '.zip'): + raise ValueError('Binary, archive or generated output is not source: ' + name) + result['CapitalQuest/' + name] = path.read_bytes() + return result + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument('--destination', type=Path, required=True) + args = parser.parse_args() + destination = args.destination.resolve() + if destination.is_relative_to(ROOT): + parser.error('Keep package output outside the source project.') + if destination.exists(): + parser.error('Destination already exists; retain completed packages unchanged.') + files = source_files() + destination.parent.mkdir(parents=True, exist_ok=True) + with ZipFile(destination, 'x', compression=ZIP_DEFLATED, compresslevel=9) as archive: + for name, data in files.items(): + info = ZipInfo(name, date_time=(1980, 1, 1, 0, 0, 0)) + info.create_system = 3 + info.external_attr = 0o100644 << 16 + info.compress_type = ZIP_DEFLATED + archive.writestr(info, data) + manifest = dict(schemaVersion=1,projectDirectory='CapitalQuest', + configurationFile='CapitalQuest/vccplus-project.json',entrySource='main.c', + archive=destination.name,byteSize=destination.stat().st_size, + sha256=hashlib.sha256(destination.read_bytes()).hexdigest(), + files=[dict(path=name,byteSize=len(data),sha256=hashlib.sha256(data).hexdigest()) + for name,data in files.items()]) + destination.with_suffix('.manifest.json').write_text(json.dumps(manifest,indent=2)+'\n') + print(json.dumps({k:v for k,v in manifest.items() if k!='files'},indent=2)) + + +if __name__ == '__main__': + main()