feat(sleep): SkillOpt-Sleep plugin update (preview) — engine robustness + scheduling

Updates the SkillOpt-Sleep plugin on top of the current main. User-facing and
engine improvements since the initial drop:

* Command renamed /sleep -> /skillopt-sleep across Claude Code + Codex shells;
  refreshed plugin READMEs and install scripts.
* Built-in scheduling (skillopt_sleep/scheduler.py + __main__): schedule /
  unschedule the nightly cycle without external cron wiring.
* Backend robustness: bounded retry with backoff (no more silent empty-string
  on transient 429/timeout), content-filter-safe rollout prompt, an
  output-contract guardrail that rejects edits violating the task's required
  format, and a per-sample cache key so repeated dream rollouts are independent
  samples (fixes degenerate single-sample reflection).
* consolidate / rollout / replay: parallel multi-rollout dreaming, gate-mode
  controls, TaskRecord.system framing field.

Scope: this commit ships only the plugin engine + shells. Research/benchmark
harnesses and their data are intentionally not included; the public package
has no dependency on them (the one research-evaluator import is now guarded).
Marked as an early preview in the README; we'll keep iterating.

99/99 unit tests pass.

Co-Authored-By: Claude Opus 4 <noreply@anthropic.com>

plugins/claude-code/README.md

@@ -27,7 +27,7 @@ harvest ~/.claude transcripts → mine recurring tasks → replay offline
    → consolidate (reflect → bounded edit → GATE) → stage proposal → (you) adopt
 ```
 
-Nothing live is modified until **you** run `/sleep adopt` (the Dreams "review,
+Nothing live is modified until **you** run `/skillopt-sleep adopt` (the Dreams "review,
 then adopt or discard" contract). Every adopt backs up the prior file first.
 
 ## Install
@@ -44,7 +44,7 @@ cd SkillOpt
 /plugin install skillopt-sleep@skillopt-sleep
 
 # 3) verify
-/sleep status
+/skillopt-sleep status
 ```
 
 The plugin's bundled runner (`scripts/sleep.sh`) auto-selects a Python ≥ 3.10
@@ -56,10 +56,10 @@ they shell out to the CLIs you already have.
 
 ```bash
 # from inside any project you use with Claude Code:
-/sleep dry-run     # safe preview: what it would learn, no changes staged
-/sleep run         # full cycle: stages a reviewed proposal (still no live edits)
-/sleep status      # see history + the latest staged proposal
-/sleep adopt       # apply the staged proposal to CLAUDE.md / SKILL.md (with backup)
+/skillopt-sleep dry-run     # safe preview: what it would learn, no changes staged
+/skillopt-sleep run         # full cycle: stages a reviewed proposal (still no live edits)
+/skillopt-sleep status      # see history + the latest staged proposal
+/skillopt-sleep adopt       # apply the staged proposal to CLAUDE.md / SKILL.md (with backup)
 ```
 
 Or call the engine directly (Python ≥ 3.10):

plugins/claude-code/commands/skillopt-sleep.md

@@ -1,10 +1,10 @@
 ---
-description: Run or manage the SkillOpt-Sleep self-evolution cycle (review past sessions, replay tasks offline, consolidate validated memory + skills)
-argument-hint: "[run | dry-run | status | adopt | harvest] (default: status)"
+description: Run or manage the SkillOpt-Sleep self-evolution cycle (review past sessions, replay tasks offline, consolidate validated memory + skills; can also schedule nightly runs)
+argument-hint: "[run | dry-run | status | adopt | harvest | schedule | unschedule] (default: status)"
 allowed-tools: Bash, Read
 ---
 
-# /sleep — SkillOpt-Sleep nightly self-evolution
+# /skillopt-sleep — SkillOpt-Sleep nightly self-evolution
 
 You are driving **SkillOpt-Sleep**: a tool that lets this user's Claude agent
 improve offline by reviewing past sessions, replaying recurring tasks, and
@@ -27,16 +27,19 @@ The engine is the `skillopt_sleep` Python package in this repo. Use the
 
 `<action>` is one of:
 
-| action    | what it does |
-|-----------|--------------|
-| `status`  | show how many nights have run + the latest staged proposal (READ-ONLY) |
-| `dry-run` | harvest → mine → replay → report, but **stage nothing** (safe preview) |
-| `run`     | full cycle: also **stage** a reviewed proposal (still does NOT touch live files) |
-| `adopt`   | apply the latest staged proposal to live `CLAUDE.md` / `SKILL.md` (backs up first) |
-| `harvest` | debug: print the recurring tasks mined from recent sessions |
+| action       | what it does |
+|--------------|--------------|
+| `status`     | show how many nights have run + the latest staged proposal (READ-ONLY) |
+| `dry-run`    | harvest → mine → replay → report, but **stage nothing** (safe preview) |
+| `run`        | full cycle: also **stage** a reviewed proposal (still does NOT touch live files) |
+| `adopt`      | apply the latest staged proposal to live `CLAUDE.md` / `SKILL.md` (backs up first) |
+| `harvest`    | debug: print the recurring tasks mined from recent sessions |
+| `schedule`   | install a nightly cron entry for this project (`--hour --minute`, off-:00 by default) |
+| `unschedule` | remove the nightly cron entry (`--all` to remove every managed entry) |
 
-Default backend is `mock` (deterministic, no API spend). To use real Anthropic
-budget for genuine improvement, add `--backend anthropic`.
+Default backend is `mock` (deterministic, no API spend). To use real budget for
+genuine improvement, add `--backend claude` or `--backend codex`. To steer what
+the optimizer writes, add `--preferences "<your house rules>"`.
 
 ## Steps to follow
 
@@ -47,7 +50,7 @@ budget for genuine improvement, add `--backend anthropic`.
    - the gate decision (accept/reject) and the exact edits it proposes
    - where the proposal is staged
 3. **For `run` that produced an accepted proposal:** tell the user the diff is
-   staged and that **nothing live changed yet**. Offer to run `/sleep adopt`.
+   staged and that **nothing live changed yet**. Offer to run `/skillopt-sleep adopt`.
 4. **For `adopt`:** confirm which live files were updated and that backups were
    written under the staging dir's `backup/`.
 5. **Never** edit `CLAUDE.md` or `SKILL.md` yourself — only the `adopt` action

plugins/claude-code/scripts/install-cron.sh

@@ -17,7 +17,7 @@ cat <<EOF
 # ── SkillOpt-Sleep nightly cycle ────────────────────────────────────────────
 # Review past sessions, replay tasks, stage validated memory/skill updates.
 # Runs at ${HOUR}:$(printf '%02d' $MIN) local every day. Output goes to the project's
-# .skillopt-sleep/ dir; nothing live is changed until you run '/sleep adopt'
+# .skillopt-sleep/ dir; nothing live is changed until you run '/skillopt-sleep adopt'
 # (unless you pass --auto-adopt below).
 #
 # Copy the next line into 'crontab -e':

plugins/claude-code/skills/skillopt-sleep/SKILL.md

@@ -41,7 +41,7 @@ Trigger when the user wants any of:
 
 ## How to drive it
 
-Prefer the `/sleep` command. Under the hood it calls the bundled runner:
+Prefer the `/skillopt-sleep` command. Under the hood it calls the bundled runner:
 
 ```bash
 "${CLAUDE_PLUGIN_ROOT}/scripts/sleep.sh" status                       # what's happened