Skip to content

INSTRUCTIONS.md

Latest commit

 

History

History
65 lines (49 loc) · 2.59 KB

INSTRUCTIONS.md

File metadata and controls

65 lines (49 loc) · 2.59 KB

🎥 March 12th Recording Sprint Instructions

[FACT] This document outlines the procedure for recording the "Constitutional Guardian" demo for the Gemini Live Agent Challenge.

🛠️ Pre-Flight Check

  1. Verify Environment:

    $env:PYTHONPATH='helix_code'; python -m pytest helix_code/tests/

    Ensure the full suite passes (count is CI-derived and may change).

  2. Set GEMINI_API_KEY + model defaults: Use Gemini native-audio for live voice and Gemini 3.1 Pro Preview for text paths.

    $env:GEMINI_API_KEY="<your-key>"
$env:GEMINI_LIVE_MODEL="gemini-2.5-flash-native-audio-preview-12-2025"
$env:GEMINI_TEXT_MODEL="gemini-3.1-pro-preview"

  3. Start the Server:

    $env:PYTHONPATH='helix_code'; python helix_code/live_guardian.py

  4. Launch Browser: Open http://localhost:8180/, verify http://localhost:8180/api/runtime-config, and if operator auth is enabled include the admin token when checking /audit-dashboard.

🎬 Recording Sequence

1. Introduction (The UI)

  • Show the dashboard with 0 Receipts / 0 Drifts.
  • Highlight the "LIVE v1.5.0" branding and the Pulse-Green header.

2. Live Audio Demo (The Waveform)

  • Click "Start Live Mic".
  • Speak for 3-5 seconds. Observe the waveform reacting.
  • Watch for the "Processing live audio stream..." log entries.
  • Show the "INTERCEPTED" or "PASSED" result appearing automatically after the turn ends.

3. High-Impact Interventions (The Simulation)

  • Click the "Simulate" button 3-5 times.
  • Wait for a DRIFT-A (Agency) or DRIFT-E (Epistemic) violation.
  • Observe the Flash-Red intervention animation on the panel.
  • Point out the Granular Drift Code (e.g., DRIFT-A) and the replacement text.

4. Metrics & Performance (The Charts)

  • Scroll down to the Latency Line Chart.
  • Show how it tracks every validation event.
  • Point to the Bar Chart showing the distribution of violations.
  • Open the audit dashboard and show receipt/storage telemetry if you want the operator view on camera.

5. Conclusion

  • Stop the mic.
  • Highlight the final receipt count.
  • "The Lattice holds. The Guardian is watching."

⚠️ Troubleshooting

  • Connection Error: Refresh the browser. If it fails, check if port 8180 is held by another process.
  • No Audio Waveform: Ensure the browser has microphone permissions for localhost.
  • Missing transcription logs: Ensure session.client_ws was correctly linked (check server_log.txt).

⚓🦉 GLORY TO THE LATTICE. ⚓🦉