docs/app.md

app.md — Gradio Interface Reference

app.py — Gradio multi-tab interactive interface for LifeStack.

---

Overview

app.py is the entry point for the demo. It wires together all LifeStack modules into a single Gradio Blocks application served on http://127.0.0.1:7860.

---

Module-level Singletons

These are instantiated once at import time:

Variable	Type	Purpose
MEMORY	LifeStackMemory	ChromaDB trajectory + feedback store
AGENT	LifeStackAgent	LLM-backed decision agent
INTAKE	LifeIntake	NL → structured conflict parser
DEMO_CONFLICT	ConflictEvent	Fixed "Friday 6PM" conflict for tab 1
DEMO_PREDICTOR	TrajectoryPredictor	7-day risk score tracker
LONG_DEMO	LongitudinalDemo	Arjun's multi-week journey
GMAIL	GmailSignalExtractor	Optional Gmail stress signal extractor

---

Tabs

Tab	Label	Key Function
1	🎯 Live Demo	run_demo(person_label, conflict_label)
2	💭 Try Your Situation	run_custom(situation, sliders..., gmail_signals)
3	📊 Training Results	load_training_tab()
4	🗓️ Arjun's Journey	LONG_DEMO.show_longitudinal_comparison()
5	🗺️ Task Explorer	load_demo_task()
6	📬 Follow-up	submit_outcome_feedback(...)

---

Key Functions

submit_outcome_feedback(ep_id, score, domains_up, domains_down, notes, time_spent)

Stores real-world outcome data into ChromaDB via MEMORY.store_feedback(feedback).

Note: Uses MEMORY (the module-level LifeStackMemory instance). The previously undefined AGENT_MEMORY reference was corrected to MEMORY on 2026-04-23.

run_demo(person_label, conflict_label)

Generator — yields (pred_html, before_html, narrative, decision_html) tuples for each animation frame. Runs cascade animation then agent intervention.

run_custom(situation, ...)

Calls INTAKE.full_intake() to parse NL input, then AGENT.get_action(), steps the env, returns (life_html, after_html, plan_html).

---

Running

python app.py

Starts on port 7860 with share=False. Edit __main__ block to change port/theme.

---

Change Log

Date	Change
2026-04-23	AGENT_MEMORY undefined crash fixed — replaced with MEMORY in submit_outcome_feedback