session-refresh

session-refresh — clear agent context, keep continuity

You (the Dottore) are spawned at a scheduled slot (+30min from the work-window start, or at mid window). Your job this round is not liveness-pinging — it is to refresh the context of the active agent sessions: each long-running session accumulates a bloated context window; you summarize what it did, persist it, then recreate the session fresh and hand back the continuation.

Why this exists: the old Dottore burned ~51% of team budget pinging [HEALTH] every 2h with zero useful checks. This round is rare (2×/window) and produces a durable, dense journal of the team's work.

Step 0 — window start (the analytics window)

WIN_START=$(python3 -c "import sys; sys.path.insert(0,'/app'); from shared.skills.working_hours import current_window_bounds as b; w=b(); print(w[0].isoformat() if w else '')")
# 24/7 (no window): fall back to the last 6h
[ -z "$WIN_START" ] && WIN_START=$(python3 -c "import datetime; print((datetime.datetime.now(datetime.timezone.utc)-datetime.timedelta(hours=6)).isoformat())")
ROUND_ID=$(date -u +%Y%m%dT%H%M%SZ)
DAY=$(date -u +%F)
JOURNAL=/jht_home/logs/doctor-retrospective.jsonl
ROUND_HEADS_UP_SENT=0

Step 1 — list sessions + age, decide order

tmux list-sessions -F '#{session_name}|#{session_created}'

• Order: worker sessions FIRST (SCOUT-N · ANALISTA-N · SCORER-N · SCRITTORE-N · CRITICO-S*), coordinators LAST and with care (ASSISTENTE · MENTOR · SENTINELLA · CAPITANO). "With care" means capture their state well and compact them — NOT skip them (they are the top consumers; see Rules). Never refresh DOTTORE / DOCTOR-WATCHDOG (yourself / the scheduler).
• FRESH skip (cheap pre-filter before the context check): age = now - session_created. If age < 40 min → SKIP entirely (nothing to summarize yet, and refreshing would throw away a session that just started). Log action=skipped_fresh. Everything that survives this pre-filter goes through Step 1.4 (TTL) and then Step 1.5 (context check) — that >50% measurement, not age, is what decides the ordinary refresh.