c64-kb 0.17.0 → 0.17.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/CHANGELOG.md +43 -1
  2. package/README.md +345 -438
  3. package/VERSION +2 -2
  4. package/dist/server/tools-lookup.js +1 -1
  5. package/dist/server/tools-maintenance.js +1 -1
  6. package/dist/server/tools-recipes.js +2 -2
  7. package/dist/server/tools-recipes.js.map +1 -1
  8. package/dist/server/tools-runtime.js +1 -1
  9. package/dist/tools/run-game.js +3 -3
  10. package/dist/tools/run-game.js.map +1 -1
  11. package/docs/ARCHITECTURE.md +71 -50
  12. package/docs/CONVENTIONS-archetypes.md +9 -9
  13. package/docs/CONVENTIONS-failures.md +7 -7
  14. package/docs/CONVENTIONS-hardware-reference.md +8 -12
  15. package/docs/CONVENTIONS-pitfalls.md +22 -21
  16. package/docs/CONVENTIONS-recipes.md +16 -17
  17. package/docs/CONVENTIONS-techniques.md +19 -19
  18. package/docs/CONVENTIONS-toolchain-reference.md +10 -10
  19. package/docs/ONTOLOGY.md +20 -20
  20. package/docs/art/art-production-reference.md +45 -45
  21. package/docs/art/asset-pipelines.md +66 -72
  22. package/docs/c64-failure-patterns.md +75 -78
  23. package/docs/demo-design/demo-composition.md +5 -6
  24. package/docs/demo-design/demo-design-philosophy.md +193 -229
  25. package/docs/demo-design/intro-cracktro-patterns.md +92 -111
  26. package/docs/game-design/c64-game-archetypes.md +37 -37
  27. package/docs/game-design/designs/falling-blocks.md +2 -2
  28. package/docs/game-design/designs/platformer-scaffold.md +2 -2
  29. package/docs/game-design/designs/simple-shmup.md +2 -2
  30. package/docs/game-design/enemy-behaviour-and-difficulty.md +21 -22
  31. package/docs/game-design/game-design-patterns.md +47 -49
  32. package/docs/game-design/game-structure.md +11 -12
  33. package/docs/game-design/production-planning.md +5 -6
  34. package/docs/game-design/reference-game-sources.md +2 -2
  35. package/docs/music/music-production-reference.md +144 -169
  36. package/docs/runtime/sim6502-reference.md +2 -2
  37. package/docs/runtime/vice-mcp-reference.md +1 -1
  38. package/docs/workflow/agent-harness.md +6 -6
  39. package/package.json +3 -2
  40. package/docs/figures/fig6-architecture.png +0 -0
  41. package/docs/figures/fig7-ontology.png +0 -0
package/CHANGELOG.md CHANGED
@@ -5,7 +5,49 @@ Entries below start at the first public audit; earlier history is in git.
5
5
 
6
6
  ## Unreleased
7
7
 
8
- Data 771, schema 31, tools 2.3.1, package 0.17.0.
8
+ Data 773, schema 31, tools 2.3.2, package 0.17.1.
9
+
10
+ **Plain prose, batch 1 of #56 (data 773).** The design, art, music,
11
+ workflow, game-design and root pages lost their machine-written wording:
12
+ reversal openers, importance claims, metaphors, editorial adjectives,
13
+ scaffolding and em-dash asides. `npm run check:prose` passed on all 26
14
+ pages (every code block, table row, heading and metadata line unchanged;
15
+ every number, hex value, code span, link and acronym still there as often
16
+ as before). A clean ingest gives the same 925 nodes and 5,403 edges, every
17
+ node property and edge identical; 46 of 50 top-5 search results for ten
18
+ queries on these pages are unchanged. The pass found about 40 claims that
19
+ look wrong; they were not changed and are listed in #57 and #58.
20
+
21
+ **Stale pages and tool descriptions found by the README audit (data 772,
22
+ tools 2.3.2).**
23
+ - `docs/ARCHITECTURE.md`: counts removed; the CLI list, node labels,
24
+ derived edges and analytics location brought up to date; the
25
+ verification section now covers verify:recipes, claims-watch,
26
+ verify:templates, CI and releases.
27
+ - Tool descriptions: `c64_search` said the corpus had no cartridge pages
28
+ (it has cartridges, the REU and the 1541); `c64_recipes_for` called its
29
+ technique filter a no-op (it matches a Technique name through
30
+ IMPLEMENTS); `c64_run_game` said it kills any x64sc (only the one on
31
+ monitor port 6502), assumed x64sc on PATH, and cited a `loop/` directory
32
+ that does not exist; `c64_report_gap` promised a dashboard nothing
33
+ tracks.
34
+ - Licence fields: sim6502 is GPL-3.0 on GitHub, not MIT; simen/vice-mcp
35
+ states no licence, and the page said MIT. The sim6502 page now says its
36
+ VICE backend's `barryw/vice-mcp` is a VICE fork, not the MCP bridge
37
+ `c64_run_game` drives.
38
+ - `agent-harness.md` said claims-watch was not on the branch; it is.
39
+ CLAUDE.md said CI runs every gate but the ingest; it runs neither
40
+ verify:templates nor anything Oscar64.
41
+ - `docs/figures/fig6-architecture.png` and `fig7-ontology.png` removed:
42
+ they showed stale counts and nothing linked them.
43
+
44
+ **Package 0.17.1.** The first release published by
45
+ `.github/workflows/release.yml` through npm trusted publishing, with
46
+ provenance; 0.17.0 (2026-09-24) was published by hand. Since 0.17.0 it
47
+ carries the plainer README, prose batch 1 of #56 and the corrected tool
48
+ descriptions (tools 2.3.2). Trusted publisher on npm:
49
+ `bdgscotland/c64-kb`, `release.yml`, environment `npm`, which only `v*`
50
+ tags can use and which needs the maintainer's approval.
9
51
 
10
52
  **Licence pass before npm publishing (data 771).** A measured check of
11
53
  `docs/` found no copied prose (runs of 25 or more words shared with 108