torben/chemenu

Fork 0

Files

T

torben 18ae28f918

CI / verify (push) Failing after 32s

Details

Release / release (push) Successful in 38s

Details

Chemenu 2.1.0 - deterministischer Wissenskompiler

Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki:
raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht
tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren
Grenzen in Code durchgesetzt sind statt im Prompt.

Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige
Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses
Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44
Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist.

Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den
Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er
dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs.

Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte.
Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet -
siehe NOTICE.

2026-09-01 16:26:14 +02:00

1.8 KiB

Raw Blame History

type, name, description

type	name	description
types/instruction.md	publish-cycle	Close out a change to the wiki - rebuild the provenance index and catalog, append the audit entry, and publish.

Close out a change

Run after any change to pages under kb/, in this order. The order matters: the catalog is built from page frontmatter, and the audit entry should describe a tree that is already consistent.

Steps

Rebuild the provenance index - after any change to a source page or an inline citation:
```
tools/wikitool sources rebuild-index
```
Rebuild the catalog - after any page was added, removed, renamed, or had its summary/date changed:
```
tools/wikitool index rebuild
```
This regenerates kb/index.md and every kb/**/INDEX.md. Never edit those by hand.
Append the audit entry - one per operation:
```
tools/wikitool log append --op ingest|query|lint|create|update|delete|rename \
  --title "<what>" --body "<outcome>"
```
This is the one non-idempotent step. If a previous run's outcome is uncertain, read the tail of kb/log.md before repeating it.

Publish:

tools/wikitool publish --message "<op>: <description>"

Decision points

Ten or more files changed? publish exits 42. Show the user its output and stop; see gates.md.
Query or lint pass? Neither auto-publishes. Run publish only if asked to.
Nothing under kb/ changed? Skip steps 1 and 2; a change to tools/ or instructions/ does not affect the catalog.

Scope

This is the close-out for wiki content. Changes to skills also need tools/wikitool instructions sync (see bootstrap.md), and changes to the CLI or a contract need tools/wikitool docs verify.

1.8 KiB Raw Blame History

Close out a change

Steps

Decision points

Scope

1.8 KiB

Raw Blame History