Session Retention Debug
Use this skill to validate the server-side session retention requirement and observe lifecycle behavior.
Run commands from repository root:
E:\coding\TermLink
Quick Start
- Snapshot current sessions:
powershell -ExecutionPolicy Bypass -File ./skills/session-retention-debug/scripts/inspect-sessions.ps1 -BaseUrl http://127.0.0.1:3000 -User admin -Pass admin
- Monitor changes continuously:
powershell -ExecutionPolicy Bypass -File ./skills/session-retention-debug/scripts/watch-sessions.ps1 -BaseUrl http://127.0.0.1:3000 -User admin -Pass admin -IntervalSec 10
What It Verifies
activeConnectionschanges correctly when clients connect/disconnect.- Idle sessions are retained rather than immediately removed.
- Session aging (
lastActiveAt) can be observed over time for TTL validation. - Capacity pressure behavior can be observed by tracking total sessions.
Rules
- Always target a specific environment via
-BaseUrl. - Use authenticated calls when
AUTH_ENABLED=true. - Do not infer retention from UI only; verify with
/api/sessionssnapshots.