41 Releases 41 Tags

RSS Feed

• v9.0.0 7cfafd75b2

  Compare

  v9.0.0 Stable

  torben released this 2026-10-09 15:39:33 +00:00 | 56 commits to main since this release

  9.0.0 - 2026-10-09 - Docs sorted into four areas, generated references, raw derive for real documents

  Author: Torben Nehmer

  Breaking Change: The seven pages that sat directly in docs/ now live in docs/explanation/, with nothing left at the old paths. An instance's own kb/CONVENTIONS.md still links ../docs/language-boundaries.md, so docs verify reports a dead link after the upgrade until the required migration document rewrites the path - step 12 of the upgrade.

  Migration: required - instructions/migrations/9.0.0-docs-diataxis.md

  High impact

  • docs/ sorted into tutorials, how-to, reference and explanation plus an unshipped docs/dev/; explanation pages moved, developer guide moved and translated, human docs English

  Medium impact

  • Changelog kompakt: ein Absatz pro Thema, Größenbudget, Migrationsverweis
  • docs reference: human command reference under docs/reference/, generated from the command records
  • docs reference: skill catalogue and page types under docs/reference/, generated from the shipped defaults in the origin repo only
  • docs/: how-to guides, configuration reference and two explanation pages carved out of README.md, INSTALL.md, INSTALL-MCP.md and EVALS.md; the last two retired
  • INSTALL.md is an English installation tutorial; new tutorial from a first source to a first answer with a shipped sample; README.md a landing page
  • Die Formen der vier handgeschriebenen .wikitool-*.json stehen je in einem Datensatz (config_shapes), aus dem Lader, doctor und die Konfigurationsreferenz lesen
  • Gate-Liste: AGENTS.md § Gates ist die eine Liste (mit Rebase-Review Gate), cli_contract.GATES hält sie, docs verify vergleicht beide
  • Asset-Preflight: Verschieben aus dem Entpackordner wird bis ca. 30 s wiederholt, nennt die Systemmeldung und rollt nach endgültigem Scheitern zurück
  • raw derive reads PDF-free documents: Office files and mail become a folder with the original and a derived text
  • raw derive unpacks ZIP archives and mails with attachments into a folder
  • raw derive reads PDF and Outlook MSG through lazily imported packages; doctor shows each import filter
  • raw derive (Mail): ein Platzhalter-Plaintext (unter 10 % des HTML-Texts) verdrängt den HTML-Text nicht mehr, und die zweite Fassung des Mailtexts wird kein Anhang (#204)

  Low impact

  • version bump: Abschlussmeldung nennt Stichpunkt oder Themenabsatz statt pauschal Prosa
  • AGENTS.md routing line and a toc.py docstring describe docs/ as the whole human documentation
  • tools/README.md module tree names reference_doc.py and the fourth view cli_contract renders
  • Rebase-Review Gate: Anzeigename in Hilfe- und Fehlertexten von sync und publish angeglichen
  • tools/README.md: Asset-Modus beschreibt Entpacken in den eigenen Ordner, Wiederholung und Zurückrollen
  • Gitea-Wiki als generierter Spiegel von docs/: Konverter, Push-Skript, Workflows
  • raw pending names only the raw fetch pair as a bundle; a derived document is a folder
  • raw derive writes an Excel file's sheets as tab-separated files with a formula list; derived.md becomes the overview (#202)
  • testfiles: real documents get short names and a source table, personal data is replaced by same-length filler, and the derive test now compares the sheet TSVs (#203)

  This release reorganises the stack's human documentation and teaches raw derive real-world documents. docs/ is now sorted into tutorials, how-to guides, reference and explanation, with the developer guide in an unshipped docs/dev/; the command, skill and page-type references are generated from the shipped records, the root documents shrink to a landing page and an English installation tutorial, and docs/ is mirrored into the Gitea wiki. The explanation pages moved, so an instance runs the required migration document to repair the one path its kb/CONVENTIONS.md links. raw derive now turns Office files, mail with attachments, ZIP archives, PDF, Outlook MSG and Excel sheets into a folder with the original and a derived text. Smaller changes: the shapes of the four hand-written .wikitool-*.json files live in one record, AGENTS.md § Gates is the single gate list, and the asset preflight retries a blocked move.

  Tutorials: installation in English, and a first source to a first answer (#191)

  INSTALL.md stays at the root and is now the English installation tutorial, the first one docs/tutorials/README.md lists; its generated prerequisites lists and setup-question markers are unchanged, and docs verify's finding for a missing question names the English section "What the agent asks you". The new docs/tutorials/first-source-to-first-answer.md walks a fresh instance through one ingest and two questions, one the wiki answers with citations and one it has no source for, using docs/tutorials/sample-source.md, a short made-up note that ships with every instance. README.md's "Your first ingestion" is a link to it, which finishes README.md as a landing page.

  The root documents split into docs/ pages (#190)

  The task and explanation parts of README.md, INSTALL.md, INSTALL-MCP.md and EVALS.md are now single English pages: eleven how-to guides under docs/how-to/ (ingest, capture, guideline export, query, maintenance, weekly review, Obsidian, updating an instance, troubleshooting, the MCP read server, tracing and scoring sessions), docs/reference/configuration.md, and docs/explanation/architecture.md and telemetry-and-evaluation.md. A guide says what to prepare, what to tell the agent and where it stops; it links an agent's procedure instead of retelling it. INSTALL-MCP.md and EVALS.md are gone from the root and from dist export, so an upgrade removes them as retired; README.md is a landing page, and INSTALL.md keeps only the installation itself. Pointers in messages and command records, among them version check's, name the new pages.

  Doku-Gerüst nach Diátaxis unter docs/ (#187)

  docs/ hat vier Bereiche – tutorials/, how-to/, reference/, explanation/, je mit einer
  README.md – und docs/dev/, das dist export wie instructions/dev/ weglässt. Die sieben
  Erklärseiten liegen jetzt unter docs/explanation/, ohne Stub am alten Ort; DEVELOPMENT.md ist
  als docs/dev/development.md englisch. docs verify meldet jede Datei, die direkt in docs/ oder
  außerhalb der fünf Bereiche liegt. AGENTS.md § File naming legt fest, dass die menschliche Doku
  des Stacks englisch ist, unabhängig von language:. Das bestehende kb/CONVENTIONS.md einer
  Instanz verlinkt noch den alten Pfad, deshalb führt das Pflicht-Migrationsdokument ihn nach.

  Changelog-Einträge mit Größenbudget und Migrationsverweis (#184)

  Ein Eintrag bekommt ###-Abschnitte pro Thema statt pro Bump; eine kleinere Änderung steht nur
  als Bump-Titel in der Liste. docs verify und version release halten den obersten Eintrag bei
  höchstens 32 000 Bytes und jeden ###-Abschnitt bei genau einem Absatz von höchstens 1 000 Bytes,
  die Überschrift nicht mitgezählt; ältere Einträge bleiben ungeprüft. Zielt ein erforderliches
  Migrationsdokument auf die Basis des Kandidaten, schreibt jeder version bump die Zeile
  **Migration:** required - <pfad> anstelle von none required, und docs verify meldet einen
  grenzüberschreitenden Eintrag, der sein Dokument nicht nennt. Die Formregeln stehen nur noch in
  instructions/dev/version-parts.md.

  Generierte Referenz für Menschen unter docs/reference/ (#188, #189, #193)

  wikitool docs reference [--apply] erzeugt aus den Kommando-Datensätzen eine Seite je Gruppe samt
  Übersicht und exit-codes.md, ohne die an Agenten gerichteten Reaktionen. skills.md und
  page-types.md beschreiben die ausgelieferten Vorgaben und entstehen nur im Ursprungs-Repo. Die
  Formen von .wikitool-telemetry.json, -remotes, -upload und -tasks stehen je in einem
  Datensatz in config_shapes.py; die Lader lesen daraus Felder, Defaults und Expected:-Texte bei
  unveränderter Akzeptanz, und configuration.md trägt je Datei eine generierte Region, auch in einer
  Instanz. doctor warnt bei einer Telemetrie-Datei, die still anders gelesen wird. docs verify
  meldet veraltete Regionen.

  ---

  This note is a snapshot of the CHANGES.md entry as it stood when the tag was cut, and
  is never edited afterwards. The maintained version of this text - including any later
  correction - is the entry for this version in CHANGES.md in the repository.

  Downloads

  • chemenu-stack-9.0.0.tar.gz
    923 KiB

    2026-10-09 15:39:33 +00:00
  • chemenu-stack-9.0.0.tar.gz.sha256
    93 B

    2026-10-09 15:39:33 +00:00
  • preflight.md
    9.0 KiB

    2026-10-09 15:39:33 +00:00
  • preflight.ps1
    41 KiB

    2026-10-09 15:39:33 +00:00
  • preflight.sh
    31 KiB

    2026-10-09 15:39:33 +00:00
  • setup-instance.md
    20 KiB

    2026-10-09 15:39:33 +00:00
  • Source Code (ZIP)
  • Source Code (TAR.GZ)