Recover

# Executable spec for the /recover skill — session-context recovery (driving-adapter).
# /recover reconstructs where a session left off: the rpi lifecycle phase from
# .agents/rpi/phased-state.json, the claimed/ready work from bd, and recent git state — rendered
# as a recovery dashboard (or JSON). Hexagon: driving-adapter; consumes bd + rpi; produces
# .agents/rpi/*.md. (soc-qk4b)

Feature: Recover reconstructs in-progress session context
  As an agent resuming after a break or compaction
  I want the prior session's lifecycle phase and claimed work surfaced
  So that I continue where I left off instead of starting cold

  Scenario: the rpi lifecycle phase is detected
    When /recover runs
    Then it reads .agents/rpi/phased-state.json (when present) and reports the current phase

  Scenario: claimed and ready work is surfaced from bd
    When /recover runs
    Then it reports in-progress and ready issues from bd

  Scenario: recent git state is included
    When /recover runs
    Then it shows the current branch, recent commits, and uncommitted changes

  Scenario: machine-readable output on demand
    When /recover --json runs
    Then it emits the recovery state as structured JSON


#!/usr/bin/env bash
set -euo pipefail
SKILL_DIR="$(cd "$(dirname "$0")/.." && pwd)"
PASS=0; FAIL=0

check() { if bash -c "$2"; then echo "PASS: $1"; PASS=$((PASS + 1)); else echo "FAIL: $1"; FAIL=$((FAIL + 1)); fi; }

check "SKILL.md exists" "[ -f '$SKILL_DIR/SKILL.md' ]"
check "SKILL.md has YAML frontmatter" "head -1 '$SKILL_DIR/SKILL.md' | grep -q '^---$'"
check "SKILL.md has name: recover" "grep -q '^name: recover' '$SKILL_DIR/SKILL.md'"
check "SKILL.md mentions compaction" "grep -qi 'compaction' '$SKILL_DIR/SKILL.md'"
check "SKILL.md mentions context recovery" "grep -qi 'context.*recovery\|recovery.*context\|recover.*context' '$SKILL_DIR/SKILL.md'"
check "SKILL.md has tier: session when metadata is present" "! grep -q '^metadata:' '$SKILL_DIR/SKILL.md' || grep -q '^[[:space:]]*tier:[[:space:]]*session' '$SKILL_DIR/SKILL.md'"

echo ""; echo "Results: $PASS passed, $FAIL failed"
[ $FAIL -eq 0 ] && exit 0 || exit 1


---
name: recover
description: Recover session context.
practices:
- sre
- legacy-code-seams
- pragmatic-programmer
hexagonal_role: driving-adapter
consumes:
- bd
- rpi
produces:
- .agents/rpi/*.md
context_rel: []
skill_api_version: 1
context:
  window: inherit
  intent:
    mode: none
  intel_scope: none
metadata:
  tier: session
  dependencies: []
output_contract: 'stdout: recovered context summary'
---
# /recover — Context Recovery After Compaction

> **Purpose:** Help you get back up to speed after context compaction. Detects in-progress work (RPI runs, evolve cycles), loads relevant knowledge, and summarizes what you were doing and what's next. AgentOps 3.0's default recovery path is explicit (`ao session bootstrap`, `ao codex start` / `ao codex stop`); Codex native hooks are opt-in compatibility, not assumed.

**YOU MUST EXECUTE THIS WORKFLOW. Do not just describe it.**

**CLI dependencies:** gt, ao, bd — all optional. Shows what's available, skips what isn't.

---

## Quick Start

```bash
/recover              # Full recovery dashboard
/recover --json       # Machine-readable JSON output
ao codex status       # Codex hookless lifecycle health
ao codex start        # Rebuild startup context explicitly in Codex
```

---

## Execution Steps

### Step 1: Detect In-Progress Sessions (Parallel)

Run ALL of the following in parallel bash calls:

**Call 1 — RPI Phased State:**
```bash
if [ -f .agents/rpi/phased-state.json ]; then
  echo "=== RPI_STATE ==="
  cat .agents/rpi/phased-state.json
else
  echo "RPI_STATE=NONE"
fi
```

**Call 2 — Evolve Cycle History:**
```bash
if [ -f .agents/evolve/cycle-history.jsonl ]; then
  echo "=== EVOLVE_STATE ==="
  tail -3 .agents/evolve/cycle-history.jsonl
else
  echo "EVOLVE_STATE=NONE"
fi
```

**Call 3 — Git Recent Changes:**
```bash
echo "=== GIT_STATUS ==="
git status --short

echo "=== G