session-retention-debug

Diagnose and validate server session retention/reconnect behavior for TermLink. Use when checking session idle aging, retention TTL impact, active connection counts, and cleanup behavior via /api/sess

SKILL.mdskills/session-retention-debug/SKILL.md

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

activeConnections changes 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/sessions snapshots.

Related in testing

frontend-testing-langgenius-dify

Generate Vitest + React Testing Library tests for Dify frontend components, hooks, and utilities. Triggers on testing, s...

skill-creator-langgenius-dify

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an exist...

browser-use-browser-use-browser-use

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs...