Skip to content

Refresh the Spiral deck and show it on GitHub Pages - #66

Merged
XiangpengHao merged 5 commits into
mainfrom
slides-refresh
Nov 18, 2026
Merged

XiangpengHao merged 5 commits into
mainfrom
slides-refresh

Conversation

@XiangpengHao

@XiangpengHao XiangpengHao commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

The deck in doc/08-spiral-presentation was last touched on Nov 2. Since then t4 gained a persistence log, shared mode and on-demand cache files, and replaced Kismet in Spiral, so several slides had become wrong. This PR brings the repo copy in line with the published deck (the claude.ai Slides artifact), including edits made in the deck editor, and adds a viewer so GitHub Pages can show it.

Fixed

  • "The cache keeps nothing across a restart" (lifecycle notes): the disk tier now survives a restart within one boot.
  • "Shared mode in progress" (t4 vs foyer): built; one owner serves the rest.
  • "Preallocated" cache files: sized at start, allocated as blocks are written.
  • Kismet described as Spiral's current cache: t4 replaces it.
  • Stale source paths in speaker notes (cache_files.rs, get_queue).

Added

  • Disk cache persisted across restarts: a diagram of the batch write, the log append, and the replay.
  • Multi-process mode: Python applications, each with its own t4, one of which owns the cache files.
  • How t4 is checked: Verus proofs, seeded shuttle schedules, weekly fuzzing.
  • Section 3 renamed "tiered cache"; closing slide trimmed to the title and the spiraldb/t4 link; cover title and dates updated. Spiral benchmark numbers are deliberately left out.

GitHub Pages

  • doc/08-spiral-presentation/index.html renders the slide files as they are: deck.json's order, each 1920×1080 slide scaled to the window, arrows/space/click/swipe to step, #slide-N links, x-connector drawn as SVG lines, magic transitions as moves of same-id elements, speaker notes behind s. Acid Grotesk (the design system's licensed face) isn't published; Inter stands in.
  • .github/workflows/slides.yml deploys that folder on pushes to main that touch it, or by hand.
  • Before merging: set Settings → Pages → Source to "GitHub Actions", or the deploy step fails. The site will be public, like the repo; 16 slides carry an "INTERNAL" footer and the speaker notes are readable (press s).

Repo tidy

  • .claude/ and .impeccable/ are no longer tracked (per-machine tool state) and are now ignored. Merging this deletes .claude/launch.json and .impeccable/config.json from checkouts that pull it.

Note for the talk: the multi-process slide presents the Python client as the case it fits. Doc 10 lists Studio and spiral connect as the processes sharing a cache today; the speaker notes say to confirm what the Python client turns on.

No Rust changes.

Fix claims the code has outgrown (a restart keeps nothing, shared mode
in progress, preallocated cache files, Kismet as Spiral's cache, stale
source paths), fill in the closing slide, and add slides for the disk
tier across restarts, one cache shared by a Python application's
processes, and how t4 is checked. Section 3 is now the tiered cache.
Synced from the published deck, edits made there included.
Comment fixes and editor changes since the last sync: a diagram for
the persistence slide, a shared-mode slide drawn as Python applications
each holding a t4, a simpler closing slide, and the cover and chart
titles edited in the deck.
White at 72% on the deck's blue composites to 5.05:1; the checker
reads the alpha color without blending it.
Both hold per-machine tool settings (a preview launch config pointing at
a scratch directory, design-hook ignores), not project files.
doc/08-spiral-presentation/index.html renders the Slides-artifact files
in place: deck.json's order, each slide scaled to the window, arrow keys
and clicks to step, x-connector drawn as SVG lines, magic transitions as
moves of same-id elements, speaker notes behind "s". The slides
workflow deploys that folder to Pages on pushes to main that touch it.
@XiangpengHao XiangpengHao changed the title Refresh the Spiral deck: persistence, shared mode, how t4 is checked Refresh the Spiral deck and show it on GitHub Pages Nov 18, 2026
@XiangpengHao
XiangpengHao merged commit 724793c into main Nov 18, 2026
8 checks passed
@XiangpengHao
XiangpengHao deleted the slides-refresh branch November 18, 2026 19:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant