Files
werkbaum/docs/CHANGELOG.md
T
mhoennigandClaude Opus 5 36b78efa53 lean-path: Angefangenes liegt auf dem Pfad (SPEC §9, D61)
Eine Zugabe (`+`) fällt aus dem günstigsten Pfad — außer sie ist
realisiert und noch nicht erledigt (`[~]`/`[/]`). Angefangene Arbeit ist
die offene Front, und seit D46 zeigt der Pfad genau die; bisher führte
der Von-Station-zu-Station-Knopf nie dorthin, wo gearbeitet wird.
Erledigte Zugaben bleiben draußen: dort ist nichts mehr zu tun, und was
darunter offen blieb, ist mit ihnen zusammen entbehrlich (§3).

Dabei die fehlende Hälfte von D46 gefunden: SPEC §9 sagt seit jeher
„eine bereits realisierte Alternative gewinnt", umgesetzt war das aber
nur über die Kosten — und die sind allein bei `[x]`/`[^]` null. Ein
`[~]`-Zweig verlor damit gegen eine unangetastete billigere, obwohl die
XOR-Regel gerade ihn als die realisierte Alternative ausweist.
`chosenPool()` schränkt die Wahlmenge auf die realisierten ein; unter
mehreren entscheiden wieder die Kosten. Nebengewinn: eine entschiedene
Gruppe ist keine freie Variable mehr und verkleinert die Suche (D42).

10 neue Tests; Gegenprobe geführt (jede Regel einzeln herausgenommen
lässt genau die nach ihr benannten Zusicherungen fallen). Der
mitgelieferte Plan ändert sich nicht — er hat keine angefangene Zugabe.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-24 14:11:38 +02:00

5.0 KiB

Changelog

What changed, newest first. This file feeds the What's new popup in the editor (the star in the header, D58): every ## YYYY-MM-DD heading opens a day, every bullet under it becomes one note. Anything else here — like this paragraph — is read by people, not by the build.

English, deliberately. The project's documentation is German (CLAUDE.md), but this file is shown inside the product, whose interface speaks nine languages. Like the shipped plan and llms.md it is a delivered artefact with a worldwide audience (D22, D43). Keep the notes short — one line, what changed, from the reader's side rather than the commit's. Backticks become code in the popup; no other markup is honoured, so write plain sentences.

The node highlighting per day does not come from here: it is computed from the git history of docs/examples/werkbaum.werkbaum. A day can therefore carry a link without having a note (someone forgot to write one) — but never the reverse.

2026-08-24

  • An optional node (+) joins the cheapest path while it is being worked on — started work is the open front
  • Fix: a started alternative lost its |/= group to an untouched cheaper one, although the choice was already made
  • A node written as an id alone (- #US-123) is now titled by that id, instead of being ignored
  • A line ending in a space and \ continues on the next line, so a long node no longer has to fit into one
  • A star in the header opens What's new: the changes of the last few days, and a link per day that shows the nodes it touched in the diagram
  • A warning triangle replaces the question mark as the pointer over faulty line numbers
  • The node window replaces the browser tooltip everywhere — at the pointer, on keyboard focus and on touch
  • A # button in the diagram header puts node IDs in front of the titles
  • Typing #.kc under #prod-stage now expands to #prod-stage.kc when you leave the line
  • A camera button next to the history saves a snapshot on demand
  • Fix: the manual snapshot button confirmed without saving anything while nothing had changed yet
  • Warning line numbers carry their message as a tooltip
  • llms.txt now points at the notation guide, and llms.md is served as UTF-8

2026-08-23

  • Every node of the shipped Werkbaum plan carries an ID and a description
  • One button steps from station to station along the cheapest path
  • The cheapest path shows the open front: what is done costs nothing any more
  • A new document starts by asking for its name
  • The text area no longer wraps lines — the indentation keeps carrying the hierarchy
  • Node IDs read #auth: Title now, with an optional separating colon
  • Fold marks moved behind the status box, so the boxes stay aligned
  • Fix: the document and download menus open again on small screens

2026-08-22

  • Node IDs (#auth) name a node across the whole document
  • Dependencies (:#auth,#api) point across the tree, cycles allowed
  • The node colour shows the effective status — what a node waits for holds it back
  • Dependency links are drawn as thin dotted curves behind the nodes
  • Subtrees fold and unfold, in the diagram and as > / < in the text
  • Exactly-one groups (=) with a "1" plaque on the collector rail
  • Node descriptions, as " lines or as blocks behind a --- divider
  • The cheapest path counts shared dependencies once — and says so when it has to guess
  • "Restore original" brings a shipped document back to the delivered state
  • llms.md explains the notation to AI agents

2026-08-16

  • The example plan is called werkbaum.werkbaum and describes Werkbaum itself

2026-08-05

  • Line numbers next to the text, warnings marked in the strip
  • Alt+click in the text centres the node of the caret line

2026-07-30

  • The focus mark !!! got a teal crown of its own
  • Research on updating by itself: what an Etherpad instance can and cannot do
  • An IntelliJ plugin recorded as an idea in the plan

2026-07-27

  • + marks an optional node — an extra, neither required nor an alternative
  • Consecutive optional leaves cascade into a staircase instead of taking a column each
  • "What's new" highlights what went into production since your last visit
  • A shared Etherpad can be watched, embedded and reloaded

2026-07-25

  • The notation text can be loaded from a URL with ?sourceUrl=

2026-07-23

  • Several documents side by side, switched from the editor's title bar
  • The interface language follows the browser, German as the fallback
  • High risk [!] carries a warning triangle

2026-07-22

  • IBM Plex is embedded locally — no request to Google, no IP address to third parties
  • Zoom controls for the diagram
  • Accessibility: spoken labels per node, focus order, live region for warnings

2026-07-21

  • First version: text notation, parser, and a diagram in three layout modes
  • Status boxes, t-shirt sizes, people tags, bare URLs and %% comments
  • The cheapest path through the tree, with a metro-style line through the open leaves
  • Print stylesheet and SVG/PNG export of the diagram