Skip to content

v0.16.19

Choose a tag to compare

@deviate-dv8 deviate-dv8 released this 10 Nov 05:26
· 117 commits to main since this release
  • 0.16.19 (b9b18e6)
  • waygraph install sets up what the project's config requires, on this machine, after npm install: Chromium and every browser its playwright section names (with the project's own Playwright, never removing another project's browsers), its browser extensions, its demo's voice (Kokoro's environment and model), and what those read, listed in .env.example and .env. What it can't install (ffmpeg for a voice-over, a voice whose setup failed) is named at the end, after the rest, and it exits 1. It does only what's missing; --update fetches everything again, --with-deps adds the browsers' system packages. Replaces waygraph extensions install (a row on the deprecated page). init, the scaffold, the quickstart, the README, saucedemo and the CI recipe say npx waygraph install; Waygraph UI's Project page has it as a button. Tests, project guide (a new machine, a new teammate), CLI reference, usage. And a lint fix in a Waygraph UI test (c4f887f)
  • waygraph extensions install lists what it sets up can read in the project's .env.example and .env (made when missing): blank and commented under a header (# OPENAI_API_KEY= for openAIVoice(), # WAYGRAPH_CACHE_DIR= for Kokoro and browser extensions); a variable a file already names is left as it is, so a second install adds nothing. saucedemo and the quickstart keep .env files out of git too. Test, config reference, demo guide (502ffe9)
  • The scaffold has a .env.example: what a project reads from .env (BASE_URL, WAYGRAPH_MAIL_URL, OPENAI_API_KEY for a voice), each commented out with what it's for. Its .gitignore keeps every .env file but that one out of git. init names both from their dotless template files. Test, config reference (6bc8deb)
  • The voice is in the config: saucedemo's demo speaks with kokoroVoice() (steps too), and the scaffold shows the line. A machine without it records silent and says once to run waygraph extensions install. Each waygraph pins the Kokoro it sets up (kokoro-onnx and soundfile versions, the model release), stamped in installed.json: after an upgrade that moves it, a recording says it's another version, and extensions install replaces it (a new environment, the new model, the old one removed). Demo guide (where it's stored, not set up, a new version), tests (8bcd11e)
  • Demos speak with Kokoro: kokoroVoice() is a natural local voice (af_heart by default; voice, speed, lang), its model loaded once in one Python process kept for the recording. It's heavy, so it isn't part of waygraph's install: waygraph extensions install sets it up once per machine in waygraph's cache (a Python environment through uv when there is one, kokoro-onnx, and the model), as it does browser extensions; without it, a recording says to run that. Lines get a breath between them, and with steps: true the steps' descriptions are made while the first steps play. Tests, demo guide, CLI reference, usage (61df26e)
  • Demos can speak: demo.voice gives a recorded demo (--video) a voice-over. Each new caption and slide is spoken as it shows (and with steps: true, each step's description), one line at a time; auto-advance waits for a line to end, so the voice is never cut off. The recording gets the speech as its audio track (ffmpeg) and its subtitles beside it (
  • Playwright no longer runs the node:test unit files: the local project's testIgnore replaced the top-level one, so tests/unit was imported into the workers, where video-dir's HOME change made later tests miss the browser (d1b6e39)
  • saucedemo: its account keeps its session 9 minutes (ttl), under Sauce Demo's 10, so later runs and test workers reuse it (13edeae)
  • Accounts can say how long a session lasts: account(name, { signIn, ttl: "15m" }) ("30s", "2h", "1d", or ms). A session older than its ttl signs in again; one still good is saved (.waygraph/sessions/, WAYGRAPH_SESSIONS; one file per account, site and person, readable only by its owner), so later runs and every test worker start signed in until it runs out. Without a ttl a session lasts the process and is never saved. --fresh-sessions (run, demo, test) signs every account in again and saves the new sessions. Quickstart ignores .waygraph/. Tests, flows guide, CLI reference, env reference, convention skill, ROADMAP (c6ca2cc)
  • The manifest links each Block to its code and selectors: source (the lines that define it, for Read Blocks and flows too), checks (its precondition and verify Traits as data, "dynamic" when a function builds them) and selectors (the selector-file entries its definition reads), plus every entry of the project's selector files (_sel.ts, *.sel.ts), read from the source. Waygraph UI: a map page's panel puts what matters first (what the page shows, what you can do there, the ways in and out, what's expected, its selectors; its flows last, failing first) in sections with counts, and opens a Block for its checks, selectors and code; the Blocks page opens a Block the same way and lists every selector with the Blocks that read it; the Flows page is a list by folder, failing first, filtered by outcome. Pages load on hover and show a stale manifest while a new one is read; run logs are parsed again only when they change. A run's video plays on its page and downloads, its trace downloads, and Settings can record a video for plays. Docs (UI guide, manifest reference), ROADMAP, tests (c42df1d)
  • A read check the page doesn't show the key for says what its namespace showed instead (no value for login.sent; the page shows login.emailError "Could not send the link..."), not only that nothing was read. Reads guide, test (70ff282)

Full changes: v0.16.18...v0.16.19