torben/chemenu

1 Fork 0

Files

T

History

torbenandClaude Sonnet 5.5 db09e89223

CI / verify (push) Successful in 8m17s

Details

CI / pwsh (push) Successful in 2m54s

Details

Release / converters (push) Successful in 28s

Details

Release / release (push) Successful in 36s

Details

Release / wiki-mirror (push) Skipped

Details

tools: Export - include "all" wählt die ganze KB, index: true schreibt index.md und INDEX.md in den Zielordner (#217 ); 10.1.0-beta.21

Files changed:
- CHANGES.md
- VERSION
- docs/how-to/export-to-a-synced-folder.md
- docs/reference/commands/exports.md
- docs/reference/configuration.md
- raw/CONTRACT.md
- tools/CONTRACT.md
- tools/README.md
- tools/chemenu/catalog.py
- tools/chemenu/commands/export_cmd.py
- tools/chemenu/commands/index_build.py
- tools/chemenu/config_shapes.py
- tools/chemenu/export_index.py
- tools/chemenu/guideline_export.py
- tools/chemenu/page_export.py
- tools/chemenu/tests/test_config_shapes.py
- tools/chemenu/tests/test_export_run.py
- tools/chemenu/tests/test_index_build.py

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2

2026-10-16 15:44:21 +02:00

back-up-to-a-synced-folder.md

tools: Export- und Eingangsordner im Backup-Ziel - Überschneidungsregel nur noch auf <ziel>/git und den eigenen Maschinenordner, Laufzeitprüfung auf Vorfahren in upload collect und export run (#216 ); 10.1.0-beta.16

2026-10-16 11:19:12 +02:00

browse-with-obsidian.md

feat: docs/ carries the operator's how-to guides, a configuration reference and the architecture and telemetry explanations carved out of README.md, INSTALL.md, INSTALL-MCP.md and EVALS.md; the last two retired (#190 )

2026-10-07 05:13:56 +02:00

capture-repository-docs.md

wiki-ingest: ein Lauf endet nach einer Quelle mit Stopp und /clear-Empfehlung - keine Schleife über mehrere Einträge im selben Kontext; Subagents für den Ingest verworfen, capture-session delegiert nicht mehr; gates.md: neuer Lauf auf ausdrücklichen Wunsch ist eine Einheitsgrenze (#219 ); 10.1.0-beta.13

2026-10-15 23:32:11 +02:00

collect-from-a-synced-folder.md

2026-10-16 11:19:12 +02:00

export-guidelines.md

export: export run writes selected kb/ pages as a derived, read-only version into configured target folders (markdown and command handlers, manifest, after_publish), raw accept also refuses manifest-listed files, doctor checks the section (#214 ); 10.0.0-beta.13

2026-10-13 05:53:48 +02:00

export-to-a-synced-folder.md

tools: Export - include "all" wählt die ganze KB, index: true schreibt index.md und INDEX.md in den Zielordner (#217 ); 10.1.0-beta.21

2026-10-16 15:44:21 +02:00

fetch-pages-behind-a-login.md

raw: fetch behind a login - raw login stores the user's session as a secret outside the tree, fetch.routes sends a host through it or to an external fetcher, a handler's render goes through the optional browser component (preflight --with browser) (#169 ); 10.0.0-beta.8

2026-10-11 20:50:23 +02:00

ingest-a-source.md

2026-10-15 23:32:11 +02:00

maintain-the-wiki.md

docs: maintain-the-wiki names the synced-folder backup for an instance without a git server, and what a failed machine-data backup after a push means (#186 close)

2026-10-12 19:58:14 +02:00

query-the-wiki.md

wiki-query: Wortlaut geführt in der Rohdatei nachlesen - neuer Schritt 4 über Seite, Source-Seite, raw_files: und Gliederung im Kopf der Ableitung bis zum Zeilenbereich, nie Suche in raw/; ohne Gliederung ganz unter der Längenschwelle, darüber Hinweis auf neue Ableitung; Zitat in Originalsprache mit Seitenzahl, Auszeichnungen nicht als Wortlaut, Gestrichenes benannt; Antwort nur in der Rohdatei benennt die Lücke. kb/CONTRACT.md: Qualitätsziel gilt der Substanz (#227 ); 10.1.0-beta.11

2026-10-15 22:11:33 +02:00

README.md

2026-10-13 05:53:48 +02:00

run-the-weekly-review.md

settings: the four per-feature files .wikitool-remotes/-telemetry/-upload/-tasks.json move into the three tiers and disappear; new command config migrate; 10.0.0-beta.1 (#208 )

2026-10-11 06:54:35 +02:00

set-up-the-mcp-server.md

intake: several configured intake channels (mcp, folder, command) all end in quarantine/ (was mcp-upload/), and upload collect pulls the synced-folder and command channels into it (#213 ); 10.0.0-beta.11

2026-10-12 22:04:18 +02:00

trace-and-score-sessions.md

settings: the four per-feature files .wikitool-remotes/-telemetry/-upload/-tasks.json move into the three tiers and disappear; new command config migrate; 10.0.0-beta.1 (#208 )

2026-10-11 06:54:35 +02:00

troubleshoot.md

tools/bugreport: --bundle/--chronology tauscht die Chronologie eines vorhandenen Bündels - Geheimnisse, Titelschutz und Pseudonyme wie beim Sammeln, kein wikitool-Aufruf, kein zweites Bündel; bug-report.md prüft die Chronologie vor dem Sammeln und nennt den Austausch als Entscheidungspunkt (#220 ); 10.1.0-beta.15

2026-10-16 06:50:53 +02:00

update-an-instance.md

docs: the update how-to says the 10.0.0 settings migration is owed per checkout, so a second clone runs config migrate after its pull (#208 close)

2026-10-11 10:23:05 +02:00

use-1password-for-settings.md

docs: settings pull-through after #207 - secrets file path on Windows and with XDG in the 1Password how-to; 1Password approval is per terminal session, not per value

2026-10-10 18:10:07 +02:00

write-a-site-handler.md

sites: raw fetch --scope fetches a page and the subpages its site handler offers as one bundle in incoming/<stem>/, with robots.txt, max_pages and pause_seconds; 10.0.0-beta.6

2026-10-11 18:36:10 +02:00

README.md

How-to guides

Task-oriented pages for the operator of an instance: one goal per page - upgrade an instance, set up the MCP read server, run a weekly review - with the steps a human takes and the sentence handed to the agent. A how-to guide never retells an agent's procedure: the steps an agent runs live in instructions/, and a guide here says what to prepare, what to ask for and where the agent stops.

Working with the wiki:

Ingest a source - a file, a folder, a web page, or a document submitted through the MCP server
Write a site handler - teach raw fetch how a website serves its pages
Fetch pages behind a login - with your own session, through a browser, or through a fetch program of your own
Capture documentation from a git repository - and keep it current
Export guidelines to captured repositories
Export to a synced folder - a read-only version of selected pages for a reader outside the repository, OneDrive and Microsoft 365 included
Query the wiki - asking, and searching yourself
Maintain the wiki - lint, provenance, and the gates on the way to a publish
Run the weekly review - commitments in a task tracker against the project pages
Browse the wiki in Obsidian - and how pages are named

Running the instance:

Update an instance - to a newer release of the stack
Troubleshoot an instance
Set up the MCP read server - for a consumer that is not a terminal on this machine
Trace and score agent sessions
Use 1Password for settings - secrets and private values out of the tree, on the desktop and in CI
Collect documents from a synced folder - a folder OneDrive and the like fill, or a program of your own, as an intake channel into the quarantine
Back up to a synced folder - OneDrive and the like as the backup of an instance without a git server, and restoring from it

Installing a new instance is INSTALL.md at the repository root.