docs(kit): pin core 1.19.0; teach the public demo's module members #17

wtclaude · 2026-10-26T05:58:50-05:00

wtclaude commented

2026-10-26 05:58:50 -05:00

Step 3 of website/DEMO_MODE.md §10 (RunicGateway/website#222): the kit's paragraph on the demo, and the core-ref.json re-pin.

The pin moves from 6890a74 (1.17.0) to 69998ec (1.19.0, website#224), past 1.18.0 (website#223). Both versions are the public demo, and the chapters were read again for each.

What changed

Chapter 2 gains a section, On a public demo site (1.18.0):
- demoLocks in module.json: writes only, under your mounts, validated on every boot;
- ctx.demoMode, for a lock a route list cannot express (and for the rare read that must be hidden);
- api.onDemoSeed: upsert, never insert;
- lock at the server, never in the UI;
- the coreApi floor.
Chapter 2's call count becomes twenty, since onDemoSeed is the new call.
Chapter 5 gains a paragraph on an event action's demoRefuses (1.19.0) and a line in the action listing:
- the sentence is shown to the author as written;
- it is a pure check that fails closed;
- check again in perform();
- it needs ^1.19.0.
template/module.json: coreApi becomes ^1.19.0, for the equality check only. The template declares none of the new members.
ci/core-ref.json: the new sha and a dated why entry.

One note on scope. §10 asked for a paragraph on demoLocks and ctx.demoMode. onDemoSeed (DM15) and demoRefuses (DM18) were decided after §10 was written, and both are in the versions this pin crosses, so they are taught too.

The only other core change in the window, website#221, is a wording fix on core's Teams panel. A module sees none of it.

Verified at the new pin

checkCoreApi (^1.19.0 = 1.19.0), checkLinks, checkRenameSites and checkChapterPaths all pass. Script tests: 10 and 11 pass.
Template: check:imports, client build, check:externals and check:swagger pass. Tests: server 82, client 20 pass.
Real core load. The template was loaded as examplegame into core at 69998ec through core's own loader, once with DEMO_MODE unset and once with it true. It registered both times.
node -p "require('./ci/core-ref.json').ref" parses.
AI-assisted: written with Claude Code (Claude Opus 5.5).

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

Step 3 of `website/DEMO_MODE.md` §10 (RunicGateway/website#222): the kit's paragraph on the demo, and the `core-ref.json` re-pin. The pin moves from `6890a74` (1.17.0) to **`69998ec`** (1.19.0, website#224), past 1.18.0 (website#223). Both versions are the public demo, and the chapters were read again for each. ## What changed - **Chapter 2** gains a section, *On a public demo site* (1.18.0): - `demoLocks` in `module.json`: writes only, under your mounts, validated on every boot; - `ctx.demoMode`, for a lock a route list cannot express (and for the rare read that must be hidden); - `api.onDemoSeed`: upsert, never insert; - lock at the server, never in the UI; - the `coreApi` floor. - Chapter 2's call count becomes **twenty**, since `onDemoSeed` is the new call. - **Chapter 5** gains a paragraph on an event action's `demoRefuses` (1.19.0) and a line in the action listing: - the sentence is shown to the author as written; - it is a pure check that fails closed; - check again in `perform()`; - it needs `^1.19.0`. - `template/module.json`: `coreApi` becomes `^1.19.0`, for the equality check only. The template declares none of the new members. - `ci/core-ref.json`: the new sha and a dated `why` entry. **One note on scope.** §10 asked for a paragraph on `demoLocks` and `ctx.demoMode`. `onDemoSeed` (DM15) and `demoRefuses` (DM18) were decided after §10 was written, and both are in the versions this pin crosses, so they are taught too. The only other core change in the window, website#221, is a wording fix on core's Teams panel. A module sees none of it. ## Verified at the new pin - `checkCoreApi` (`^1.19.0` = 1.19.0), `checkLinks`, `checkRenameSites` and `checkChapterPaths` all pass. Script tests: 10 and 11 pass. - Template: `check:imports`, client build, `check:externals` and `check:swagger` pass. Tests: **server 82, client 20** pass. - **Real core load.** The template was loaded as `examplegame` into core at `69998ec` through core's own loader, once with `DEMO_MODE` unset and once with it `true`. It registered both times. - `node -p "require('./ci/core-ref.json').ref"` parses. - [x] AI-assisted: written with Claude Code (Claude Opus 5.5). 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

wtclaude added 1 commit 2026-10-26 05:58:52 -05:00

docs(kit): pin core 1.19.0; teach the public demo's module members

PR Checks / prose (pull_request) Successful in 10s

Details

PR Checks / template (pull_request) Successful in 44s

Details

00f5234f97

The pin moves from 6890a74 (1.17.0) to 69998ec (1.19.0, website#224),
past 1.18.0 (website#223). Both are the public demo (DEMO_MODE.md §10
step 3). The chapters were read again for both versions:

- Chapter 2: a new section on a public demo site, covering demoLocks in
  module.json, ctx.demoMode and api.onDemoSeed (1.18.0). The call count
  becomes twenty.
- Chapter 5: a paragraph on an event action's demoRefuses (1.19.0), and
  a line in the action listing.

The one other core change in the window (website#221) is a wording fix
on core's Teams panel and nothing a module sees. The template declares
none of the new members, so template/module.json's coreApi becomes
^1.19.0 for the equality check only.

Checks run at the new pin:
- checkCoreApi, links, rename sites and chapter paths all pass, and so
  do the script tests (10 and 11).
- The template's imports, build, externals and swagger checks pass.
- Tests pass: server 82, client 20.
- The template was loaded as `examplegame` into a real core at this ref
  through core's own loader, with DEMO_MODE unset and with it true, and
  it registered both times.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

wtclaude referenced this pull request from RunicGateway/docs

2026-10-26 05:59:26 -05:00

docs(website): demo mode step 3 built (kit re-pin to 1.19.0) #381

whitlocktech merged commit 045679bbbc into main

2026-10-26 06:02:56 -05:00

whitlocktech deleted branch docs/core-1.19.0

2026-10-26 06:02:57 -05:00

whitlocktech referenced this issue from a commit

2026-10-26 06:02:57 -05:00

Merge pull request 'docs(kit): pin core 1.19.0; teach the public demo's module members' (#17) from docs/core-1.19.0 into main

Sign in to join this conversation.