TerminalBasic/openspec/changes/archive/2026-09-07-phase-5-07-hilfesystem/verification.md

Verification Report: phase-5-07-hilfesystem

Stand: 2026-09-07. Proposal, Design, neun Aufgaben sowie vier Anforderungen mit sechs Szenarien wurden gegen den aktuellen Code und ausführbare Tests geprüft.

Ergebnis

Dimension	Ergebnis
Completeness	9/9 Aufgaben; 4/4 Anforderungen umgesetzt
Correctness	6/6 Szenarien zugeordnet und geprüft
Coherence	Eingebettete docs als einzige Textquelle; vorhandene App-, Fenster-, Designer- und Renderingpfade
Offene Befunde	0 CRITICAL, 0 WARNING, 0 SUGGESTION

Anforderungen und Szenarien

Implementierung: crates/tb-ide/src/help.rs, Dispatcher in app.rs, Renderaufruf in render.rs, Property-Kontext in designer.rs. Neue Nachweise: crates/tb-ide/tests/help.rs.

Requirement / Scenario	Implementierung und Nachweis
Mitgelieferte Dokumente / Start außerhalb des Repositorys	DOCUMENTS bindet elf aktuelle docs-Dateien und den verlinkten PLAN direkt per include_str! ein. Catalog erzeugt Index und Contents aus diesen Seiten. help_works_from_a_directory_without_checkout startet den Testprozess in einem temporären Verzeichnis ohne docs; offline_help_child öffnet dort dieselbe App, alle Hilfe-Einstiege sowie Sprach-, Bibliotheks-, Forms-, IDE-Referenz und Tutorial mit TestBackend. Der normale tb-Einstieg benutzt diese App unabhängig vom Arbeitsverzeichnis.
Markdown / Schmales Hilfefenster	Page::parse verarbeitet CommonMark einschließlich Tabellen mit pulldown-cmark; layout berechnet Fließtextzeilen anhand der Zellbreite. Code und Tabellen behalten ihre vollständigen Zeichen und sind horizontal scrollbar. Position speichert Seite, Block, Zeichenoffset und Linkfokus. markdown_blocks_escapes_links_and_unicode_layout prüft Listen, Formatierung, Escapes, Links, Unicode und verlustfreie Blockprojektion bei vier Breiten. code_and_tables_remain_reachable_after_resize_and_horizontal_scroll und links_history_resize_scroll_and_focus_use_real_events prüfen schmale TestBackend-Fenster, echte Scrolltasten und Resize bei erhaltenem Leseanker und Linkfokus.
Kontextsensitive Themenwahl / Property und BASIC-Funktion	token_at, normalize, Catalog::search, help_context und design_help_context verbinden BASIC-Tokens samt Typsuffix mit Dokumentabschnitten und Designerklasse/-eigenschaft. command_target bildet konkrete Befehls-IDs ab. context_functions_properties_commands_and_unknown_queries prüft F1 auf lEfT$, Form.Caption im aktiven Property-Wertfeld, den fokussierten Save-Project-Menübefehl, Mehrdeutigkeit und unbekanntes Suchwort. every_command_and_forms_alias_resolves_and_invalid_alias_fails prüft alle Menübefehle beider Modi und alle Properties der 19 Forms-Klassen.
Links und Verlauf / Rücksprung mit Leseposition	Help::visit, follow, back, focus_link, help_key halten Navigation und Fenstersitzung zusammen. links_history_resize_scroll_and_focus_use_real_events folgt nach Scrollen per Enter einem Link und stellt mit Alt+F1 exakt Seite, Offset und Linkfokus wieder her. Esc restauriert das vorherige Fenster; help_preserves_fullscreen_and_does_not_modify_designer_or_source prüft zusätzlich Output-Vollbild, Designerzustand und Suchergebnis-Rücksprünge.
Links und Verlauf / Grenze des Verlaufs	Help::visit hält maximal 20 Rücksprungzustände. twenty_back_steps_end_of_contents_and_all_entries führt 25 Wechsel und anschließend die letzten 20 Rücksprünge aus. Weiteres Zurück verändert keinen Zustand und zeigt den Grenzhinweis. Ctrl+F1 folgt der Contents-Dateireihenfolge und bleibt am Ende mit Hinweis stehen.
Hilfe-Einstiege / Tutorial folgen	Alle sieben Help-Einstiege sind angebunden; About zeigt die gebaute Paketversion und Autoren. twenty_back_steps_end_of_contents_and_all_entries bedient Menüs und Shortcuts. docs/tutorial.md wurde gegen New Project/Form, Toolbox-Platzierung, Caption/F2, F12-Ereignisauswahl, Startdatei, F9/F8/F5 und die vorhandenen Designer-/Debugger-/Ausführungstests abgeglichen. Alle Tutorialverweise werden durch Catalog::validate geprüft. Der zusätzliche durchgehende Tutorial-/Designer-Abnahmelauf bleibt gemäß Aufgabe 3.3 in Change 08.

Weitere Vertragsprüfungen

• catalog_links_and_missing_targets_are_checked prüft sämtliche internen Kataloglinks und Überschriftenanker. Absichtlich fehlende Dateien, Anker, ungültige Prozentkodierungen und Pfade außerhalb des Katalogs schlagen fehl. Doppelte Überschriften einschließlich Namenskollisionen erhalten eindeutige Anker.
• Kontextaliasse werden durch dieselbe Zielauflösung geprüft; ein absichtlich falscher Befehlsanker erzeugt einen Fehler. Klasse und Property stammen aus der vorhandenen Forms-Metadatenquelle, die Texte weiterhin aus docs.
• right_click_configuration_and_external_link_follow prüft den Optionsschalter, sichtbare externe URLs und Enter auf einem externen Ziel. Es erfolgt kein Shell-Auftrag; die Hilfe besitzt keinen Datei-, Prozess- oder Netzwerkpfad. Die bestehende App-Regression belegt weiterhin Rechtsklick-Zustellung an ein laufendes BASIC-Programm mit Output-Fokus.
• Index sortiert Themen und Abschnitte alphabetisch, Contents bildet die Dokument-/Überschriftenhierarchie ab. Suche ohne Treffer erhält das Suchwort und bietet Index/Contents an; Mehrdeutigkeit erzeugt eine bedienbare Linkliste.
• docs/hilfe.md, docs/tastatur.md und docs/tutorial.md sind normale eingebettete Markdown-Seiten. Es gibt weder eine zweite Referenzsammlung noch externe Renderer. Die Build-Abhängigkeit pulldown-cmark 0.13.4 wurde nach Prüfung der CommonMark-/Tabellen-API und MIT-Lizenz ohne Default-Features aufgenommen. Darstellungsbreiten und Fenster verwenden vorhandene Bibliotheken.

Behobene Befunde

• Frühes Rechtsklick-Routing fing anfangs Programmmauseingaben ab. Kontext-Hilfe respektiert jetzt den laufenden Output-Fokus; die bisherige App-Regression besteht.
• Hilfe aus Output-Vollbild wurde vom Vollbild verdeckt. Öffnen und Schließen sichern und restaurieren nun auch diesen Fokuszustand.
• Allgemeine Menügruppen waren für einzelne Befehle zu ungenau. Eine exhaustive Zuordnung der konkreten Befehls-IDs verweist auf die jeweiligen Bedienabschnitte; der Katalogtest sichert die Ziele ab.
• Einfache Überschriftenzähler konnten bei einem bereits vorhandenen Suffix kollidieren. Eine Menge der vergebenen Anker verhindert solche Kollisionen.
• Benachbarte Inline-Spans gleichen Stils werden zusammengefasst, damit kombinierende Unicode-Zeichen bei der Terminaldarstellung zusammenbleiben.
• Die bisherige Phase-07-Platzhalterdarstellung und die vollständig überholte Feature-Phasen-Sperre wurden entfernt. Hilfe und Bedienungsübersicht zeigen den implementierten Stand; die native Exporterzeugung bleibt Phase 6.

Abschlussprüfungen

• cargo test -p tb-ide: 79 Tests bestanden, keine Fehler oder Ignore-Fälle; zusätzlich ein erfolgreicher Offline-Kindprozess mit derselben Hilfe-App. Enthalten sind elf Hilfetests sowie alle bestehenden App-, Dokument-, Editor-, Designer-, Debugger- und Ausführungstests.
• cargo clippy --workspace --all-targets -- -D warnings: bestanden.
• cargo fmt --all -- --check: bestanden.
• git diff --check: bestanden.
• openspec validate --all --strict: 23/23 gültig. Bestehende INFO-Hinweise zu langen Anforderungstexten sind keine Validierungsfehler.

Keine Prüfdimension des Changes wurde ausgelassen. Der zusätzliche Gesamtweg in Change 08 gehört wie geplant zur späteren Phasenabnahme. Es bestehen keine offenen Befunde; der Change ist zur Synchronisierung und Archivierung bereit.