Link-Disziplin & xref-Auto-Scan (Referenzen sichtbar/automatisch machen) #4

New Issue

2026-08-29T22:02:41Z

torben commented

2026-08-29 22:02:41 +00:00

Abgezweigt von: #2 ("Personalization Plane: USER.md + SOUL.md ("Thoth") aus gbrain-Analyse übernehmen")
Session-Tag: perplexity-gbrain-personalization-2026-08-23

Kontext

Zwei gbrain-inspirierte Punkte aus #2, die beide um dasselbe Problem kreisen – Referenzen entstehen zu unsichtbar bzw. zu manuell – aber unterschiedliche Dateien anfassen. Deshalb hier gebündelt, technisch aber zwei separate Änderungen.

a) Link-Disziplin (gbrain: `brain-link-discipline`)

instructions/publish-cycle.md endet mit wikitool publish --message "...", gibt aber nirgends einen Permalink/HTML-URL der betroffenen Seite an den Nutzer zurück. gbrains Regel: nach jedem Schreibvorgang den funktionierenden Link in derselben Antwort mitliefern.

Vorschlag: Ergänzung in publish-cycle.md (oder direkt in wiki-manage/wiki-ingest SKILL.md): nach new/touch/publish den Permalink der betroffenen Seite(n) explizit in der Abschlussmeldung nennen.

b) xref-Auto-Scan (gbrain: Auto-Link, "zero LLM calls")

tools/chemenu/commands/xref.py (add/remove/link-source) ist bereits rein regelbasiert (Regex-Ops auf Frontmatter/Body, keine LLM-Calls im Tool selbst) – das war schon in Ordnung. Die eigentliche Lücke: anders als gbrains Auto-Link erkennt nichts automatisch bekannte Entity-Titel in neuem raw/-Content. Die Erkennung, welche Seiten verlinkt werden sollen, macht weiterhin der Agent von Hand (Schritt 8 in wiki-ingest/SKILL.md).

Vorschlag: neuer deterministischer Befehl wikitool xref scan <raw-datei-oder-text> – gleicht Text gegen Titel/Aliase aus kb/index.md ab (String-/Regex-Matching, kein LLM-Call) und schlägt xref add/link-source-Aufrufe vor, statt dass der Agent den Text manuell nach bekannten Namen durchsucht.

Scope

Beide Änderungen sind rein additiv (neue Sektion in einer Instruction-Datei, neuer Unterbefehl) und betreffen keine bestehenden Contracts oder Invarianten.

Nächste Schritte

Permalink-Regel in publish-cycle.md oder den betroffenen SKILL.md-Dateien ergänzen
xref scan als neuen Typer-Befehl in commands/xref.py entwerfen (Signatur, Matching-Strategie: exakter Titel vs. Alias-Liste)
Beide Änderungen gegen tools/wikitool docs verify bzw. bestehende Tests laufen lassen, bevor Merge

Pfade nachgezogen 2026-09-04 (#29): tools/wiki_tools/commands/xref.py → tools/chemenu/commands/xref.py. instructions/publish-cycle.md, kb/index.md und wiki-ingest/SKILL.md geprüft, existieren unverändert.

**Abgezweigt von:** #2 ("Personalization Plane: USER.md + SOUL.md (\"Thoth\") aus gbrain-Analyse übernehmen") **Session-Tag:** `perplexity-gbrain-personalization-2026-08-23` ## Kontext Zwei gbrain-inspirierte Punkte aus #2, die beide um dasselbe Problem kreisen – Referenzen entstehen zu unsichtbar bzw. zu manuell – aber unterschiedliche Dateien anfassen. Deshalb hier gebündelt, technisch aber zwei separate Änderungen. ### a) Link-Disziplin (gbrain: `brain-link-discipline`) `instructions/publish-cycle.md` endet mit `wikitool publish --message "..."`, gibt aber nirgends einen Permalink/HTML-URL der betroffenen Seite an den Nutzer zurück. gbrains Regel: nach jedem Schreibvorgang den funktionierenden Link in derselben Antwort mitliefern. **Vorschlag:** Ergänzung in `publish-cycle.md` (oder direkt in `wiki-manage`/`wiki-ingest` SKILL.md): nach `new`/`touch`/`publish` den Permalink der betroffenen Seite(n) explizit in der Abschlussmeldung nennen. ### b) xref-Auto-Scan (gbrain: Auto-Link, "zero LLM calls") `tools/chemenu/commands/xref.py` (`add`/`remove`/`link-source`) ist bereits rein regelbasiert (Regex-Ops auf Frontmatter/Body, keine LLM-Calls im Tool selbst) – das war schon in Ordnung. Die eigentliche Lücke: anders als gbrains Auto-Link erkennt nichts automatisch bekannte Entity-Titel in neuem `raw/`-Content. Die *Erkennung*, welche Seiten verlinkt werden sollen, macht weiterhin der Agent von Hand (Schritt 8 in `wiki-ingest/SKILL.md`). **Vorschlag:** neuer deterministischer Befehl `wikitool xref scan <raw-datei-oder-text>` – gleicht Text gegen Titel/Aliase aus `kb/index.md` ab (String-/Regex-Matching, kein LLM-Call) und schlägt `xref add`/`link-source`-Aufrufe vor, statt dass der Agent den Text manuell nach bekannten Namen durchsucht. ## Scope Beide Änderungen sind rein additiv (neue Sektion in einer Instruction-Datei, neuer Unterbefehl) und betreffen keine bestehenden Contracts oder Invarianten. ## Nächste Schritte - [ ] Permalink-Regel in `publish-cycle.md` oder den betroffenen SKILL.md-Dateien ergänzen - [ ] `xref scan` als neuen Typer-Befehl in `commands/xref.py` entwerfen (Signatur, Matching-Strategie: exakter Titel vs. Alias-Liste) - [ ] Beide Änderungen gegen `tools/wikitool docs verify` bzw. bestehende Tests laufen lassen, bevor Merge --- *Pfade nachgezogen 2026-09-04 (#29): `tools/wiki_tools/commands/xref.py` → `tools/chemenu/commands/xref.py`. `instructions/publish-cycle.md`, `kb/index.md` und `wiki-ingest/SKILL.md` geprüft, existieren unverändert.*

torben referenced this issue

2026-08-29 22:04:53 +00:00

Personalization Plane: USER.md/SOUL.md ("Thoth") als Setup-Schritt + Doctor-Check, nicht als Distributionsinhalt #2

torben referenced this issue

2026-08-29 22:05:07 +00:00

Personalization Plane: USER.md/SOUL.md ("Thoth") als Setup-Schritt + Doctor-Check, nicht als Distributionsinhalt #2

torben referenced this issue

2026-08-30 20:29:08 +00:00

Personalization Plane: USER.md/SOUL.md ("Thoth") als Setup-Schritt + Doctor-Check, nicht als Distributionsinhalt #2

torben added the prio/waiting size/M labels 2026-08-31 06:56:47 +00:00

torben referenced this issue

2026-09-01 15:22:23 +00:00