set-rpe

Set RPE

Records perceived effort and subjective notes for any Strava activity. Thin wrapper over scripts/fitness-lab.ts rpe, which validates the RPE, resolves latest if needed, and does the atomic upsert into state/activity-notes.json.

Usage

/claude-code-fitness-hermit:set-rpe <activity-id|latest> <rpe> [notes...]

Steps

1. Parse arguments:

   • First arg: activity ID (integer) or the literal string latest.
   • Second arg: RPE (must be an integer 1–10).
   • Remaining args: optional free-text notes.
   • If any required arg is missing, respond with the usage line and stop (the script also rejects an out-of-range RPE with a fetch error and exit 1).

2. Run the script:

   bun ${CLAUDE_PLUGIN_ROOT}/scripts/fitness-lab.ts rpe <activity-id|latest> <rpe> [notes...]
   

   The script writes {rpe, notes, recorded_at} keyed by activity ID (notes is null when none were provided) and emits {activity_id, written:true, previous:{…}|null}. On {"error":"strava_auth",…} (only reachable via latest, which resolves the ID from Strava) relay the message verbatim; on {"error":"fetch",…} report it and stop.

3. Confirm from the returned JSON:

   • If previous is null: "Saved RPE <rpe>/10 for activity <activity_id>."
   • If previous is present: "Updated RPE for activity <activity_id>. (was: RPE <previous.rpe>/10 — <previous.notes>)"