diff --git a/bin/__pycache__/webhook_health_dashboard.cpython-312.pyc b/bin/__pycache__/webhook_health_dashboard.cpython-312.pyc new file mode 100644 index 0000000..6850fca Binary files /dev/null and b/bin/__pycache__/webhook_health_dashboard.cpython-312.pyc differ diff --git a/help.html b/help.html new file mode 100644 index 0000000..77173f1 --- /dev/null +++ b/help.html @@ -0,0 +1,488 @@ + + + + + + +Help — The Nexus + + + + + + + +
+ + +
+ ← Back to The Nexus +

THE NEXUS — Help

+

Navigation guide, controls, and system reference for Timmy's sovereign home-world.

+
+ + +
+
+ ◈ + Navigation Controls +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
WASD
Move forward / left / backward / right
Mouse
Look around — click the canvas to capture the pointer
V
Toggle navigation mode: Walk → Fly → Orbit
F
Enter nearby portal (when portal hint is visible)
E
Read nearby vision point (when vision hint is visible)
Enter
Focus / unfocus chat input
Esc
Release pointer lock / close overlays
+
+
+ + +
+
+ ⬡ + Timmy Chat Commands +
+
+
+
+ System Status + Quick action — asks Timmy for a live system health summary. +
+
+ Agent Check + Quick action — lists all active agents and their current state. +
+
+ Portal Atlas + Quick action — opens the full portal map overlay. +
+
+ Help + Quick action — requests navigation assistance from Timmy. +
+
+ Free-form text + Type anything in the chat bar and press Enter or → to send. Timmy processes all natural-language input. +
+
+
+
+ + +
+
+ 🌐 + Portal Atlas +
+
+
+

Portals are gateways to external systems and game-worlds. Walk up to a glowing portal in the Nexus and press F to activate it, or open the Portal Atlas (top-right button) for a full map view.

+

Portal status indicators:

+
+
+
+ + ONLINE + Portal is live and will redirect immediately on activation. +
+
+ + STANDBY + Portal is reachable but destination system may be idle. +
+
+ + OFFLINE / UNLINKED + Destination not yet connected. Activation shows an error card. +
+
+
+
+ + +
+
+ ▦ + HUD Panels +
+
+
+
+ Symbolic Engine + Live feed from Timmy's rule-based reasoning layer. +
+
+ Blackboard + Shared working memory used across all cognitive subsystems. +
+
+ Symbolic Planner + Goal decomposition and task sequencing output. +
+
+ Case-Based Reasoner + Analogical reasoning — matches current situation to past cases. +
+
+ Neuro-Symbolic Bridge + Translation layer between neural inference and symbolic logic. +
+
+ Meta-Reasoning + Timmy reflecting on its own thought process and confidence. +
+
+ Sovereign Health + Core vitals: memory usage, heartbeat interval, alert flags. +
+
+ Adaptive Calibrator + Live tuning of response thresholds and behavior weights. +
+
+
+
+ + +
+
+ ◉ + System Information +
+
+
+

The Nexus is Timmy's canonical sovereign home-world — a local-first 3D space that serves as both a training ground and a live visualization surface for the Timmy AI system.

+

The WebSocket gateway (server.py) runs on port 8765 and bridges Timmy's cognition layer, game-world connectors, and the browser frontend. The HERMES indicator in the HUD shows live connectivity status.

+

Source code and issue tracker: Timmy_Foundation/the-nexus

+
+
+
+ + + + +
+ + + diff --git a/tests/test_help_page.py b/tests/test_help_page.py new file mode 100644 index 0000000..b8a107e --- /dev/null +++ b/tests/test_help_page.py @@ -0,0 +1,42 @@ +"""Tests for the /help page. Refs: #833 (Missing /help page).""" +from pathlib import Path + + +def test_help_html_exists() -> None: + assert Path("help.html").exists(), "help.html must exist to resolve /help 404" + + +def test_help_html_is_valid_html() -> None: + content = Path("help.html").read_text() + assert "" in content + assert "" in content + + +def test_help_page_has_required_sections() -> None: + content = Path("help.html").read_text() + + # Navigation controls section + assert "Navigation Controls" in content + + # Chat commands section + assert "Chat" in content + + # Portal reference + assert "Portal" in content + + # Back link to home + assert 'href="/"' in content + + +def test_help_page_links_back_to_home() -> None: + content = Path("help.html").read_text() + assert 'href="/"' in content, "help page must have a link back to the main Nexus world" + + +def test_help_page_has_keyboard_controls() -> None: + content = Path("help.html").read_text() + # Movement keys are listed individually as elements + for key in ["W", "A", "S", "D", + "Mouse", "Enter", "Esc"]: + assert key in content, f"help page must document the {key!r} control"