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.
This commit is contained in:
@@ -0,0 +1,58 @@
|
||||
---
|
||||
type: types/instruction.md
|
||||
name: publish-cycle
|
||||
description: 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
|
||||
|
||||
1. **Rebuild the provenance index** - after any change to a source page or an inline citation:
|
||||
|
||||
```bash
|
||||
tools/wikitool sources rebuild-index
|
||||
```
|
||||
|
||||
2. **Rebuild the catalog** - after any page was added, removed, renamed, or had its
|
||||
summary/date changed:
|
||||
|
||||
```bash
|
||||
tools/wikitool index rebuild
|
||||
```
|
||||
|
||||
This regenerates `kb/index.md` and every `kb/**/INDEX.md`. Never edit those by hand.
|
||||
|
||||
3. **Append the audit entry** - one per operation:
|
||||
|
||||
```bash
|
||||
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.
|
||||
|
||||
4. **Publish:**
|
||||
|
||||
```bash
|
||||
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](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](bootstrap.md)), and changes to the CLI
|
||||
or a contract need `tools/wikitool docs verify`.
|
||||
Reference in New Issue
Block a user