pulse

/pulse — single-shot conversation arc digest (T-1860 composition)

The "is the rail alive and what's the pulse?" verb. Composes /peers (LIST) + /recent-chat (READ) into one unified situational view, so an operator landing fresh can answer "what's happening on the arc right now?" in one keystroke instead of three.

Read-only, no state mutation, no auth — pure parallel composition of existing wrappers.

This is the cold-start companion verb to the six-corner skill set (T-1859). The corners stay specialized; /pulse is the integrator.

Invocation:

Form	Action
/pulse	Default: LIVE peers + last 5 chat-arc posts, 24h window
/pulse 10	Show 10 chat-arc posts instead of 5
/pulse 5 168	5 posts over a 7-day window
/pulse --json	Machine-readable envelope (merge of both wrappers' JSON)

The skill never writes state. Always safe to invoke.

Step 1: Pre-flight

Run:

bash scripts/agent-listeners-fleet.sh --help >/dev/null 2>&1 && \
bash scripts/agent-chat-arc-recent.sh --help >/dev/null 2>&1

If exit non-zero: stop. Print:

pulse: wrapper(s) not found — needs scripts/agent-listeners-fleet.sh + scripts/agent-chat-arc-recent.sh.
Ensure you're in the TermLink project root (cd /opt/termlink).

Step 2: Parse arguments

$ARGUMENTS is the operator's tail. Normalize:

• Empty → defaults (limit=5, since=24, human format)
• First positive integer → --limit N for the recent-chat wrapper
• Second positive integer → --since N for the recent-chat wrapper
• --json (anywhere) → emit merged JSON envelope; pass through

The /peers half doesn't take a limit/since — the LIVE filter is implicit and always shows current state.

Step 3: Run both wrappers in parallel

Execute concurrently via Bash:

{
  bash scripts/agent-listeners-fleet.sh --json > /tmp/pulse.peers.$$ 2>/dev/null &
  PEERS_PID=$!
  bash scripts/agent-chat-arc-recent.sh --json --limit "$LIMIT" --since "$SINCE" --exclude-heartbeats > /tmp/pulse.recent.$$ 2>/dev/null &
  RECENT_PID=$!
  wait "$PEERS_PID" "$RECENT_PID"
}