wiki-query: Wortlaut geführt in der Rohdatei nachlesen – über Seite, Source-Seite und Gliederung, nie freies Suchen in raw/
#227
Reference in new issue
Block a user
Abgespalten aus #224 (Entscheidung E1 = Variante (b), 2026-10-13). Drittes und letztes Glied der Kette „Große Dokumente“. Baut auf der Gliederung mit Zeilennummern im Kopf von
derived.mdaus #225 (ausgeliefert in 10.1.0-beta.1) und der Längenschwelle aus #226 (ausgeliefert in 10.1.0-beta.10) auf.Ergebnis
Ausgeliefert in 10.1.0-beta.11, Commit
ca12c54. Verifiziert lokal durchpytest(3080 passed),instructions verifyunddocs verify, auf dem Commit durch die CI-Läufe 733 und 734, beide grün. Abschlussprüfung: kein weiteres Dokument (Contracts,COLLECTION.md, Ingest-Anweisungen,docs/) widerspricht der Änderung.Ausgangslage (vor diesem Paket)
kb/CONTRACT.mdZ. 7–8 lautete: „a page should answer a future question without re-reading the source it came from. If answering still requires the raw file, the page is incomplete.“wiki-querysagte nichts überraw/;searchistrgüberkb/.Bei Regelwerken und Anleitungen zielt die typische Frage aber auf den Wortlaut („Was sagt Regel 16:3e genau?“, „Welcher Wert steht in Tabelle 4 der Anleitung?“). Eine Seite, die jeden Wortlaut trägt, wäre eine Kopie des Dokuments. Eine Seite, die ihn nicht trägt, machte die Antwort unvollständig.
Eine Fußnote (
cite add) nennt Source-Seite und ggf. Datei (--file), aber keine Seitenzahl. Das gilt weiterhin (siehe unten); ohne Hilfe hätte eine Query 96 Seiten lesen müssen, um einen Absatz zu zitieren. Die Gliederung aus #225 ist diese Hilfe.Entscheidung (E1 b): geführtes Nachlesen
kb/-Seite. Die Rohdatei wird nur gelesen, um den Wortlaut zu zitieren oder eine Angabe der Seite zu prüfen – nie als Ersatz für eine Seite, die zur Frage nichts sagt. Erreicht wird sie nur von einer Seite aus, mindestens der Source-Seite des Dokuments; ein Dokument, zu dem keine Seite führt, ist eines, zu dem das Wiki schweigt.sources:→ Source-Seite → derenraw_files:→ Kopf vonderived.md(Gliederung mit Seite und Zeile, #225) → nur den Zeilenbereich des passenden Abschnitts lesen. Keinrg/grep/searchüberraw/. Zeilenbereich (beim Bau festgelegt): von derlinedes Eintrags bis vor den nächsten Eintrag gleicher oder höherer Ebene auf einer späteren Seite, der letzte bis Dateiende; ein Eintrag ohne Seite/Zeile wird über den umschließenden erreicht.wc -mgegen den Wert ausraw derive -h), darf er ganz gelesen werden. Darüber sagt die Antwort, dass der Wortlaut nicht gezielt erreichbar ist, und nennt den Weg: eine neue Ableitung des Originals (raw derive, neue Ausgabe perraw accept --replaces).<!-- page N -->-Marke oberhalb). Auszeichnungen ausraw derive(~~…~~,**…**,*…*; Form nach #231) werden beim Zitieren nicht als Wortlaut ausgegeben; eine Durchstreichung wird als gestrichener Text benannt.wiki-managezu schließen. Sie schreibt nichts selbst (Hard rule „read-only“ bleibt).cite add(z. B.--at "S. 39"): nicht Teil dieses Pakets. Der Weg über die Gliederung reicht für gegliederte Dokumente; erweist er sich beim ersten echten Regelwerk als zu grob, folgt ein eigenes Issue.Abweichung beim Bau: Der Entwurf stützte die Originalsprache des Zitats auf
kb/CONVENTIONS.md§ Language. Dieser Abschnitt sagt über Zitate nichts (er bindet Seitentext).wiki-querybegründet es deshalb mit dem Gegenüber: Die Antwort folgtAGENTS.md§ Conversation language, das Zitat wird nicht übersetzt.Geänderte Dateien
kb/CONTRACT.md: Qualitätsziel präzisiert – Substanz auf der Seite, Wortlaut darf geführt nachgelesen werden; eine Antwort nur in der Rohdatei zeigt weiter eine unvollständige Seite.instructions/wiki-query/SKILL.md: neuer Schritt 4 (der feste Weg, Fall ohne Gliederung, Zitieren und Auszeichnungen); alte Schritte 4–7 → 5–8, Verweise in Hard rule und Decision points nachgezogen; zwei neue Decision points („Wortlaut gefragt?“, „Antwort nur in der Rohdatei?“); „wikitool commands used“ unverändert.docs/explanation/pipeline-rationale.md: Absatz, warum das Qualitätsziel der Substanz gilt und das Nachlesen nur über den festen Weg geht.docs/how-to/query-the-wiki.md: Abschnitt „Asking for the exact wording“; der MCP-Absatz nennt die eine Abweichung (Wortlaut nur, wo eine Seite ihn trägt).AGENTS.md(keine Regel schließt den Rohzugriff aus),raw/CONTRACT.md(keine widersprechende Aussage).Akzeptanzkriterien
kb/CONTRACT.mderlaubt das geführte Nachlesen ausdrücklich und hält zugleich fest, dass eine Antwort, die nur in der Rohdatei steht, eine unvollständige Seite anzeigt.wiki-querybeschreibt den Weg Seite → Source-Seite →raw_files:→ Gliederung → Zeilenbereich, und verbietet ausdrücklich das Durchsuchen vonraw/.wiki-querysagt, wie Auszeichnungen ausraw derivebeim Zitieren behandelt werden (nicht als Wortlaut, Durchstreichung benannt).instructions verify,docs verifygrün (lokal vor dem Publish; CI-Läufe 733/734 grün).Versionsteil
MINOR. Drop-in:
kb/CONTRACT.mdwird ausgeliefert und lockert eine Regel, ohne dass bestehender Inhalt sich ändern muss; kein Befehl, kein Feld, keine Migration. Der Kandidat stand bereits auf 10.1.0 (MINOR), daher nur 10.1.0-beta.10 → beta.11.Kette
Kette „Große Dokumente“
Changelog: Blocker präzisiert: #225 ist geschlossen;
status/blockedbleibt, jetzt wegen der Längenschwelle aus #226, die der Fall „ohne Gliederung“ braucht. Neu: ein Kriterium, wie Auszeichnungen ausraw derive(~~,**,*; Form nach #231) beim Zitieren behandelt werden. Eine Durchstreichung ist bei Regelwerken gestrichener Wortlaut und darf nicht als geltender Text zitiert werden.status/blockedabgenommen: #226 (letzter offener Blocker) ist geschlossen und ausgeliefert in 10.1.0-beta.10. Für den Fall „ohne Gliederung“: Die Längenschwelle ist dieCHECK-Zeile vonraw derive/raw fetchbzw.long:inraw pending; der Wert steht inraw derive -h(KonstanteLONG_TEXT_CHARSintools/chemenu/commands/raw/_common.py), gezählt in Zeichen der.mdwie geschrieben – darauf verweisen, nicht den Wert wiederholen.Changelog: Gebaut und veröffentlicht in 10.1.0-beta.11 (
ca12c54), CI-Läufe 733/734 grün.wiki-queryhat einen neuen Schritt 4 (geführtes Nachlesen über Seite → Source-Seite →raw_files:→ Gliederung → Zeilenbereich, nie Suche inraw/), zwei neue Decision points;kb/CONTRACT.mdpräzisiert das Qualitätsziel auf die Substanz. Doku:pipeline-rationale.md(Begründung),query-the-wiki.md(Abschnitt zum Wortlaut, MCP-Abweichung). Eine Abweichung vom Entwurf: Die Originalsprache des Zitats stützt sich nicht aufkb/CONVENTIONS.md§ Language (sagt nichts über Zitate), sondern auf den Gegensatz zuAGENTS.md§ Conversation language. Festgelegt beim Bau: die Regel für das Ende des Zeilenbereichs eines Gliederungseintrags.Changelog: Abgeschlossen. Body in den Endzustand gebracht: Ausgangslage in der Vergangenheit, Abschnitt „Ergebnis“ mit Version, Commit und den CI-Läufen. Bei der Abschlussprüfung widerspricht kein weiteres Dokument der Änderung (Contracts,
COLLECTION.md, Ingest-Anweisungen,docs/); kein eigener Durchzug, kein weiterer Bump. Kette „Große Dokumente“ ist damit vollständig.