Knobwerk

Release Notes

Version history for the interactive manual.

v0.13.0

Current2026-08-09

中文・日本語 everywhere, and the manual talks to the panel

Every Tonverk parameter description now reads natively in Chinese and Japanese, lessons are fully localized, and every key name printed in the manual text is now a link that lights up that key on the interactive panel.

Added
  • ·All 393 Tonverk parameter descriptions translated into Chinese and Japanese — the parameter table, panel inspector, and tutor cards now read natively (device tokens stay English, as printed on the hardware). The translations are also indexed for semantic search, so Chinese/Japanese parameter queries improve too.
  • ·Learning-path lessons fully localized into Chinese and Japanese (all 3 lessons, 24 steps).
  • ·Manual reader → panel: key names printed in the manual ([FUNC], [YES], [UP]…) are now links — click one and the interactive panel opens with that key pulsing and its inspector card ready. About 1,900 links across the manual.
  • ·Feedback form gains a "Search found nothing / wrong results" category — real failed queries feed the retrieval test set.
  • ·Maintainer tooling: an LLM-judge QA suite for the AI tutor (npm run eval:tutor, bring-your-own-key) scoring correctness, citations, and no-invented-MIDI against a 20-question set.
Changed
  • ·Baseline security hardening: strict transport and content-type headers, clickjacking protection, and a search-query length cap.

v0.12.0

2026-08-09

Knobwerk — a real name and a real home

The project moves to knobwerk.com under its new name, Knobwerk (knob + werk — gear culture, no trademarks harmed). Every page now carries proper search-engine metadata in all three languages, and old links redirect.

Added
  • ·Full SEO: per-page titles and descriptions on every route (manual sections, procedures, parameters, concepts, lessons…), canonical URLs, English/Chinese/Japanese hreflang alternates, OpenGraph cards, a ~2,900-URL sitemap, and robots.txt.
  • ·Clear non-affiliation notice in the footer in all three languages.
Changed
  • ·The site is now Knobwerk at https://www.knobwerk.com — the old vercel.app address redirects permanently. "Elektron" now appears only where it describes the hardware itself.

v0.11.0

2026-07-31

Learning paths, a tutor that demonstrates, and the full concepts set

The interactive manual now teaches: guided lessons with progress tracking, an AI tutor that shows parameters on a live panel inside the chat, two new concept playgrounds (per-track scale and the 16-track signal flow), and documented manual errata surfaced right where you read.

Added
  • ·Learning paths: three guided Tonverk lessons — first pattern, sequencer movement, sound shaping — each step linking a playable procedure, a manual section, or a knob on the interactive panel, with progress kept in your browser.
  • ·The AI tutor can now demonstrate: when it explains a parameter it embeds the live panel in the chat — right track, machine, page, and knob selected — instead of describing it in words.
  • ·Concepts: a per-track LENGTH & SCALE playground (watch tracks drift apart and realign — polymeter, with only the manual's own four SCALE values) and a clickable 16-track signal-flow map (audio → bus → send FX → mixer → outputs, every arrow grounded in the routing parameters).
  • ·Errata callouts: 9 documented errors in the printed manual (swapped memorize/recall keys, reversed FADE polarity, missing minus signs…) now appear as marked notes on the 15 affected manual sections.
Fixed
  • ·The interactive panel no longer shifts vertically when the inspector below it grows or shrinks — the page is top-anchored now.

v0.10.1

2026-07-31

Procedure screens on the panel + beta badges

Procedure playback now renders each step's screen state inside the device's actual display — the same live screen the interactive panel uses — instead of a detached mockup below the controls. Non-Tonverk devices are marked beta at their entry points.

Changed
  • ·Procedure player: the per-step screen (parameter page with the highlighted knob, or menu screens like MICRO TIMING) now appears on the panel's own display, exactly where it would be on the hardware. On phones, a readable copy still renders below the panel.
  • ·Syntakt, Digitone II, and Digitakt II are labeled beta on the device picker and the device switcher — active development currently focuses on the Tonverk.

v0.10.0

2026-07-28

Semantic search — ask in your own words, or in 中文/日本語

Manual search gains an optional semantic mode that understands meaning rather than keywords: paraphrased questions and Chinese/Japanese queries now find the right sections, procedures, and parameters. Runs entirely in your browser — no server, no account.

Added
  • ·Semantic search toggle on the search page (Tonverk): downloads a compact multilingual model once (~110 MB, cached), then fuses meaning-based rankings with keyword results locally. Chinese/Japanese queries went from unusable to finding the right procedure in the top 3 over 80% of the time on our measurement set; sections the keyword engine misses appear with a "matched by meaning" note.
  • ·The AI tutor's manual search silently upgrades to the same hybrid ranking whenever the semantic model is already loaded.
  • ·Data integrity: the semantic index carries a checksum of its source data and the validators fail loudly if they drift apart.

v0.9.1

2026-07-28

Concept playgrounds, mod-destination badges, parameters everywhere linked

Two interactive playgrounds teach parameter locks and trig conditions by doing; every knob that an LFO can modulate now says so in the panel inspector; and the parameters table links every row to the interactive panel and its procedures.

Added
  • ·Concepts page (Tonverk): a parameter-lock playground — place trigs, hold one and turn the knob to give that step its own value, then run the sequencer and watch — and a trig-condition simulator that runs four pattern cycles and shows exactly which trigs fire (FILL, PRE, 1ST, A:B conditions plus the separate PROB probability roll, reproducible by seed). Every parameter name, range, and condition comes from the compiled manual data; the demos reproduce the manual's own worked examples. Linked from Get Started.
  • ·Mod-destination badges: the panel inspector marks every parameter that Appendix B lists as an LFO/Mod-Envelope modulation destination, with availability notes. Built on a curated, fully verified mapping of all 163 Appendix-B rows — no fuzzy matching; rows the manual itself leaves ambiguous are documented rather than guessed.
  • ·Parameters table: every row now links "Show on panel" (opens the interactive panel on that knob) and the procedures that use the parameter.

v0.9.0

2026-07-28

Real search, wired to the panel

Manual search now understands multi-word and paraphrased queries instead of exact substrings, results unify sections, parameters, and procedures — and a parameter hit opens the interactive panel with the right machine assigned, the page on screen, and the knob selected.

Added
  • ·Unified search results: matching parameters and procedures appear above the section list, ranked by the same engine.
  • ·"Show on panel" on parameter hits: opens the Tonverk interactive panel pre-set to that parameter — track type and machine assigned (including the MIDI machine view), page on screen, knob slot selected, inspector populated. Settings/setup parameters open their menu screens.
Changed
  • ·The search engine is a real lexical index (MiniSearch) over each section's own cleaned text: multi-word queries score per word with field boosts (titles first), common vocabulary maps to the manual's terms (p-lock, cutoff, sometimes…), quoted queries still require the exact phrase, and verb forms match via careful fuzzy rules. Measured on the golden set: paraphrased section queries went from 0% to 60% top-3 recall, procedure queries from 44% to 89%, with exact-term queries improving too.
  • ·The tutor's find_procedures and find_parameters rank with the same engine.

v0.8.1

2026-07-28

Tutor retrieval hardening

The AI tutor searches and cites the manual more reliably: search results and section reads now serve each section's own cleaned text, the tutor can walk the manual tree instead of re-searching, and citations that don't match a real section get flagged.

Added
  • ·Citation check in the tutor: section references (§x.y) in answers are verified against the device's manual index — a citation that doesn't exist gets a subtle "unverified" mark (display-only).
  • ·Manual-section reads return previous/next/subsection links so the tutor can navigate the manual tree, plus continuation offsets for long sections.
Changed
  • ·Manual search results now include PDF pages, a relevance score, and snippets taken from each section's own text; hits that only matched a neighboring section's spillover are flagged. Tool payloads are capped (top-5 by default) to keep BYOK conversations lean.
Fixed
  • ·Reading a manual section through the tutor returned the raw page text, which bleeds into neighboring sections that share a PDF page — it now returns the section's own cleaned text.

v0.8.0

2026-07-28

Tonverk interactive panel

The Tonverk front panel becomes a live device: click keys to operate it — switch tracks, browse parameter pages, assign machines from the manual's own menus — with the screen rendered from the compiled parameter data and an inspector that links everything to procedures and manual sections.

Added
  • ·Tonverk interactive panel on the device home page: [TRK] + trig key switches between all 16 tracks, parameter-page keys and [UP]/[DOWN] cycle the TRIG/SRC/FLTR/AMP/FX/MOD pages, [FUNC] shows the second-function layer, and FUNC + [SRC]/[FX] opens the MACHINE assignment menus (Appendix A order, [YES] assigns) — including the MIDI machine flipping a track to its MIDI parameter pages. Everything on the simulated screen comes from the compiled parameter data.
  • ·Panel inspector: clicking an encoder shows the full parameter record (description, range, CC/NRPN address, manual-section link); clicking any key shows its FUNC function, the procedures that use it, and the manual sections that explain it — all clickable.
  • ·Retrieval quality baseline: a golden-query evaluation harness (npm run eval:retrieval) now measures manual search before any retrieval change lands. The baseline confirms exact terms work while paraphrased and Chinese/Japanese queries fail — the roadmap targets published in docs/RAG_PLAN.md.
Fixed
  • ·Syntakt MIDI control: the FLTR1 FREQ and RESO knobs now resolve to their documented CC addresses (74/75) — the manual names the appendix rows "Filter Frequency" and "Resonance", which the on-screen-name lookup missed.

v0.7.0

2026-07-10

Digitakt II: full device support

The fourth and final device of the current lineup: the Digitakt II (OS 1.15A) joins with its complete interactive manual — 124 manual sections, 252 parameters, 82 procedures with zh/ja translations, panel demos, and Web MIDI control.

Added
  • ·Digitakt II device: manual browser (124 sections), 252 parameters across all track pages, send FX/mixer pages, and every SRC/FLTR machine (ONESHOT, WERP, STRETCH, REPITCH, SLICE, GRID, MIDI; MULTI-MODE, LOWPASS 4, EQ, COMB-, COMB+, LEGACY), 82 step-by-step procedures with Simplified Chinese and Japanese translations, LFO modulation destinations, and the AI tutor.
  • ·Digitakt II panel: interactive front-panel with all 52 controls, traced from the manual's vector illustration and overlay-verified; knob slot layouts read from the manual's LCD screenshots rather than prose order.
  • ·Digitakt II MIDI control: full Appendix B coverage (144 addresses) with SRC and FLTR machine pickers. Parameter-name resolution is scoped per page to the matching appendix group, so same-named parameters (e.g. three different "Attack Time" rows) always reach the right CC/NRPN.
Changed
  • ·The About page lists the Digitakt II alongside the Tonverk, Syntakt, and Digitone II (all three languages).

v0.6.3

2026-07-06

Machine pages in MIDI control for Syntakt & Digitone II

The MIDI control grid can now reach the synth-machine parameter pages on the Syntakt and Digitone II — previously only the Tonverk's machines were selectable.

Fixed
  • ·MIDI control: the Syntakt's SYN machine page (42 machines) and the Digitone II's SYN1–SYN4 and FLTR machine pages are now selectable from machine pickers, with every knob resolved to its data-entry-knob CC. Previously these pages never appeared because the machine selector only understood the Tonverk's page layout.
  • ·MIDI control: parameter pages now follow each device's hardware page order; the Tonverk's SETUP/SETTINGS pages sort at the end of the list instead of the front.
  • ·The About page now lists the Digitone II alongside the Tonverk and Syntakt (all three languages).

v0.6.2

2026-06-21

Mobile polish

Tidy up the header on phones and move the language picker into a compact menu.

Changed
  • ·The language switcher is now a globe-icon menu instead of three inline links.
  • ·On phones, the device-section navigation collapses into a menu button and the header no longer overflows — pages render at full device width.

v0.6.1

2026-06-21

Digitone II depth

Round out the Digitone II: arpeggiator / voice / setup parameters, LFO modulation destinations in the tutor, and Chinese / Japanese Get Started pages.

Added
  • ·Digitone II arpeggiator, voice-setup, and preset-setup / portamento settings in the parameter browser (22 menu parameters).
  • ·The AI tutor can now list the Digitone II's LFO modulation destinations (Appendix D).
  • ·Chinese (中文) and Japanese (日本語) translations of the Digitone II "Get Started" guide pages.

v0.6.0

2026-06-21

Elektron Digitone II added

Add the Elektron Digitone II (OS 1.10D) as a third device — its full interactive manual, FM-aware MIDI engine, and trilingual procedures, selectable from the device picker.

Added
  • ·The Elektron Digitone II (OS 1.10D), selectable from the device picker: 130 manual sections, 167 MIDI addresses, 278 parameters, and 85 procedures — every record audited against the official manual (0 corrections).
  • ·Interactive Digitone II front panel, screen mockup, step-by-step procedure player, parameter browser, and full-text manual search.
  • ·Web MIDI engine for the Digitone II with its per-parameter CC/NRPN addresses and the FM TONE / FM DRUM / WAVETONE / SWARMER machine parameter pages.
  • ·Chinese (中文) and Japanese (日本語) translations of all 85 Digitone II procedures.

v0.5.0

2026-06-18

Feedback

Add a feedback form so you can report a manual error, a bug, or a suggestion from any page.

Added
  • ·Feedback form in the "More" menu — pick a category (manual error / bug / suggestion / other), write a note, and optionally leave an email for a reply. The current device, page, and app version are attached automatically to help us locate the issue.
  • ·Submissions go to a hosted form endpoint (Formspree); no cookies, no tracking, and no account needed.

v0.4.1

2026-06-17

Syntakt app polish

Activate the Syntakt translations that shipped in 0.4.0, make the AI tutor speak per-device, and add visitor analytics.

Added
  • ·Privacy-friendly Vercel Web Analytics for visitor and page-view counts (no cookies, no personal data).
Fixed
  • ·Chinese and Japanese translations of the Syntakt procedures are now active in the app — they were compiled in 0.4.0 but not wired into the interface.
  • ·The AI tutor now describes the active device correctly: its tools reference the right manual, OS version, parameter / procedure counts, and track layout instead of always citing the Tonverk.
  • ·Tutor example prompts and the About page no longer assume the Tonverk.

v0.4.0

2026-06-14

Elektron Syntakt added

Add the Elektron Syntakt (OS 1.40A) as a second device — its full interactive manual, MIDI engine, and trilingual procedures, selectable from the device picker.

Added
  • ·The Elektron Syntakt (OS 1.40A), selectable from the device picker: 135 manual sections, 107 MIDI addresses, 465 parameters, and 53 procedures — every record audited against the official manual.
  • ·Interactive Syntakt front panel, screen mockup, step-by-step procedure player, parameter browser, and full-text manual search.
  • ·Web MIDI engine for the Syntakt with its per-parameter CC/NRPN addresses and machine parameter pages.
  • ·Chinese (中文) and Japanese (日本語) translations of all 53 Syntakt procedures.

v0.3.0

2026-06-14

Multi-device architecture

Restructure the app around devices so more Elektron manuals can be added. Tonverk content is unchanged, now served under a device path.

Added
  • ·Device picker at the language root; per-device home and pages under /[lang]/[device]/.
  • ·Device registry binding each device to its data and MIDI profile, plus a device switcher in the header.
  • ·Pipeline stages and validators take a --device flag; source PDFs now live in docs/.
Changed
  • ·All Tonverk data moved under data/tonverk/; MIDI resolution is now a per-device profile (DeviceMidiProfile).
  • ·URLs moved from /[lang]/… to /[lang]/[device]/… — old links are not redirected.

v0.2.0

2026-06-14

Project process & meta pages

Set up release tracking and project-level pages, ahead of multi-device support.

Added
  • ·"More" menu in the top navigation, with an About page and this Release Notes page.
  • ·Release history rendered from a single structured source (src/content/releases.json), with a generated CHANGELOG.md.
  • ·Project versioning, starting at 0.2.0.

v0.1.0

2026-06-12

Tonverk Interactive Manual — initial release

First public release: a complete interactive rebuild of the Elektron Tonverk user manual (OS 1.3.3).

Added
  • ·Manual data layer compiled from the official PDF: 145 sections, 166 MIDI addresses, 393 parameters, 118 procedures, 71 panel elements — every record audited against the manual.
  • ·Interactive front-panel SVG, screen mockup, and a step-by-step procedure player.
  • ·Parameter browser, procedure library, and full-text manual search.
  • ·Web MIDI engine with the Tonverk CC/NRPN address resolver and a manual knob grid.
  • ·Bring-your-own-key AI tutor (OpenRouter and Anthropic) grounded in the compiled manual.
  • ·Trilingual UI (English, 中文, 日本語) and a ⌘K command palette.