seeing

name	seeing
description	Golden path /see — refresh stale score snapshots and identify canvases needing MER capture.
user-invocable	true
allowed-tools	Read, Write, Glob, Grep, Edit, Bash, Skill

/see — Refresh Score Snapshots

Golden path command that identifies stale canvases and refreshes their score API snapshots. Surfaces canvases missing MER (Most Engaged Response) data.

---

Chain

1. Preflight: gp_check_score_api
2. Stale detection: identify canvases with score_snapshot.captured_at older than stale_snapshot_hours
3. Refresh: for each stale canvas, pull fresh score API snapshot, update canvas frontmatter
4. MER check: identify canvases missing MER sections → suggest MER capture
5. Status + suggest next

---

Execution

source scripts/observer/golden-path-lib.sh
gp_status_header "see"

# Step 1: Score API preflight
if ! gp_check_score_api; then
  gp_status_fail "score-api" "unreachable — showing staleness ages without refreshing"
  # Degrade: just show how stale each canvas is
fi

# Step 2: Find stale canvases
stale_count=0
refreshed_count=0
for canvas in $(gp_list_canvases); do
  # Extract captured_at from frontmatter
  # Compare against current time - stale_snapshot_hours
  # If stale: refresh via score-api-query.sh, update frontmatter
done

if [[ "$refreshed_count" -gt 0 ]]; then
  gp_status_ok "refresh" "${refreshed_count} canvases refreshed"
else
  gp_status_skip "refresh" "all snapshots current"
fi

# Step 3: MER check
missing_mer=0
for canvas in $(gp_list_canvases); do
  # Check if canvas has MER section
done
if [[ "$missing_mer" -gt 0 ]]; then
  gp_status_ok "mer-check" "${missing_mer} canvases need MER capture"
else
  gp_status_skip "mer-check" "all canvases have MERs"
fi

gp_progression_summary
gp_suggest_next "see"
gp_status_footer

Truenames Chained

Truename	Purpose
score-api-query.sh	Fetch fresh score snapshots
/observe	Update canvas frontmatter