status

/volley:status

Read-only inspection of the Volley state. Never modifies anything.

Steps for Claude

1. Verify .volley/ exists. If not, tell user to run /volley:setup first and stop.

2. Read STATE. Source the lib and read all four keys. If any key read fails (missing file, missing key, or malformed STATE), report the error to the user verbatim and stop - do NOT continue with empty/default values.

   . "${CLAUDE_PLUGIN_ROOT}/scripts/lib.sh"
   ACTIVE=$(volley_state_get .volley/STATE ACTIVE) || exit 1
   TASK=$(volley_state_get .volley/STATE TASK) || exit 1
   SINCE=$(volley_state_get .volley/STATE SINCE) || exit 1
   PID=$(volley_state_get .volley/STATE PID) || exit 1
   AGE=$(volley_state_lock_age .volley/STATE) || exit 1
   

3. Check PID liveness if ACTIVE=codex.

   if [ "$ACTIVE" = "codex" ] && [ "$PID" != "0" ]; then
     if volley_state_pid_alive "$PID"; then PID_STATUS="alive"; else PID_STATUS="DEAD"; fi
   else
     PID_STATUS="n/a"
   fi
   

4. List recent .volley/ artifacts. If no artifacts exist yet, show (no review artifacts yet) instead of a blank section.

   ARTIFACTS=$(ls -lt .volley/*.md 2>/dev/null | head -5)
   [ -z "$ARTIFACTS" ] && ARTIFACTS="(no review artifacts yet)"
   

5. Read continuity config for the report (non-mutating). If .volley/config.json exists, parse it (host JSON, no jq) and resolve the review/implementation model + reasoningEffort (inherit → show "Codex default"). If .volley/local.json exists, note whether repo identity matches (volley_repo_identity_matches) and which roles have a stored thread/session id (presence only - never print the id or any secret). Absent files → report "defaults / not initialized".

6. Report to user. Format like this:

   Volley Status
   ──────────
   Active actor:  <ACTIVE>
   Current task:  <TASK>
   Lock since:    <SINCE>  (<AGE>s ago)
   Recorded PID:  <PID>  (<PID_STATUS>)
   
   Continuity
   ──────────
   Review model:  <model / Codex default>  (effort: <effort>)
   Impl model:    <model / Codex default>  (effort: <effort>)
   Repo identity: <match | mismatch → will rehydrate | not initialized>
   Saved threads: planReview=<yes/no> prReview=<yes/no> implementation=<yes/no>
   Local state:   .volley/local.json   Checkpoint: <managedCheckpoint path>
   
   Recent artifacts:
   <ls output>