Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Nested lingtai-portal-guide reference for portal lifecycle-state interpretation, heartbeat staleness, recording, and tape reconstruction behavior.
.claude/skills/lingtai-ai-portal-guide-lifecycle-and-recording/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-20 | ✗→✓ | ▲ Improved | -60% | 0% |
| case-14 | ✗→✓ | ▲ Improved | -80% | 0% |
| case-01 | ✗→✓ | ▲ Improved | -43% | 0% |
| case-02 | ✗→✓ | ▲ Improved | -48% | 0% |
| case-03 | ✗→✓ | ▲ Improved | -30% | 0% |
This is a nested lingtai-portal-guide reference. It covers how the portal interprets agent lifecycle states and how it records/rebuilds topology history.
| State | Meaning | |-------|---------| | ACTIVE | Agent is running and processing | | IDLE | Agent is running but waiting for input | | STUCK | Agent encountered an error or is unresponsive | | ASLEEP | Agent is in sleep mode (.sleep signal or explicit lifecycle transition) | | SUSPENDED | Agent process is not running (no heartbeat) |
Heartbeat is the portal's liveness ground truth. BuildNetwork() currently calls IsAlive(..., 2.0), so if an agent has a state in .agent.json but its .agent.heartbeat is older than about 2 seconds, the portal reports it as SUSPENDED regardless of the stored state.
The portal starts recording immediately on launch: a background goroutine calls BuildNetwork() every 3 seconds and appends the result as a JSONL line to topology.jsonl. This tape grows indefinitely.
On startup, if the tape needs reconstruction (missing, empty, or old format), the portal rebuilds it from replay chunks. While that runs, .lingtai/.portal/reconstruct.progress may contain a transient current/total progress string, which the /api/topology/progress endpoint parses and exposes to the browser UI.
A manual POST /api/topology/rebuild instead reconstructs from source data and rewrites the replay chunks. The topology-and-api reference documents both endpoints' exact response shapes.
Other measured skills in the registry, with their headline benchmark lift.