outerloop-science 0.2.0rc2__tar.gz → 0.2.0rc3__tar.gz

{outerloop_science-0.2.0rc2 → outerloop_science-0.2.0rc3}/CHANGELOG.md

@@ -20,12 +20,26 @@ launch arrays in parallel. The board shows running GPU jobs. `OUTERLOOP_LOCAL_GP
 overrides GPU detection; `0` disables allocation. Submissions still wait for all
 tasks to finish.
 
+### Added
+
+- `OUTERLOOP_TICK_HOST=login` (or `--tick-host login`) runs a niced foreground tick loop against Slurm, with one tick lease per state root.
+- `OUTERLOOP_QOS` sets the QOS for every submitted Slurm job.
+- `OUTERLOOP_APPTAINER_BIN` selects the container executable on compute nodes.
+- `<root>/HOLD_LAUNCHES` holds fresh kernel launches while existing runs, wake delivery, and the tick chain continue; remove the file to resume.
+
 ### Removed
 
 - The pre-rename names are gone. The `AUTORESEARCH_*` environment names are no longer read by the package, the `.env` reader, the chain or the deploy step. `~/.config/autoresearch/`, `.autoresearch.yaml`, the `.autoresearch` channel directory, the `~/.autoresearch` local root default and `~/autoresearch-images` are no longer looked for. The `autoresearch-resident` and `autoresearch-tick` job names are no longer recognized. The `harness_key` file, the `*_HARNESS_KEY_FILE` setting and the `climb_job_id` record field are gone. Before upgrading, rename the `.env` keys, the config directory and the image directory. Cancel a resident or chain still queued under an old job name (`scancel --name autoresearch-resident`, or `scancel --name autoresearch-tick`) before running `outerloop start`: the guard against two loops on one root knows only the current name. Old `autoresearch:` comment markers are still recognized.
 
 ### Fixed
 
+- `outerloop start` refuses to run when the configured author's CLI is missing: it checks the recorded path, else PATH, else `~/.local/bin`, and names the install command and `outerloop init --force`.
+
+- Ending line snapshots push once, with the kernel's GitHub auth. Without auth nothing is pushed and the log says so. A refused push is retried only when the remote line moved.
+- PRs under `merge: auto` say why self-merge is waiting, and the publish records and logs the bless decision.
+
+- A timed-out local job could leave its GPUs reserved until the next submit; they are now released once its process group is gone.
+
 - The tick log says why a blessed PR is not merged yet (a message waits for the author, the run sleeps on jobs, the base moved, and so on), one line per sweep.
 - Runs retain their hypothesis through review. The status strip and sibling view carry it with the PR link, and the brief asks authors to check the view, refreshed at every wake, before choosing a direction and before submitting.
 

{outerloop_science-0.2.0rc2 → outerloop_science-0.2.0rc3}/CITATION.cff

@@ -13,5 +13,5 @@ authors:
 repository-code: "https://github.com/outerloop-science/outerloop"
 url: "https://outerloop.science"
 license: Apache-2.0
-version: 0.2.0rc2
-date-released: "2026-09-14"
+version: 0.2.0rc3
+date-released: "2026-09-15"

{outerloop_science-0.2.0rc2 → outerloop_science-0.2.0rc3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: outerloop-science
-Version: 0.2.0rc2
+Version: 0.2.0rc3
 Summary: Autonomous research agents that improve the benchmark you point them at, one verified pull request at a time
 Project-URL: Homepage, https://outerloop.science
 Project-URL: Repository, https://github.com/outerloop-science/outerloop

{outerloop_science-0.2.0rc2 → outerloop_science-0.2.0rc3}/docs/install.md

@@ -295,6 +295,25 @@ says so — rerun `outerloop init --force` online, or set the login in the
 
 ### 2c. Run the loop
 
+**Host prerequisites for model backends.** From the outerloop checkout:
+
+- Claude, as author or reviewer: the Claude Code CLI ([official
+  setup](https://code.claude.com/docs/en/setup)); install with
+  `curl -fsSL https://claude.ai/install.sh | bash`.
+- Codex, as author or reviewer: the pinned Codex CLI; install with
+  `bash scripts/install_codex.sh`.
+- Hermes, as reviewer only (not an author backend): the pinned hermes-agent
+  source checkout, run through `uv`; install with `bash scripts/install_hermes.sh`.
+
+Install the selected backend before setup. `init` records the absolute Claude
+or Codex path found on PATH (or in `~/.local/bin`) as `OUTERLOOP_<BACKEND>_BIN`.
+`start` checks only the configured author's CLI: the recorded path takes
+precedence, otherwise it searches PATH, then `~/.local/bin`. A missing or non-executable CLI stops
+launch before any job runs. After installing or moving it, run
+`outerloop init --force` to record its path again. `--dry-run` prints the launch
+command without checking the CLI. For Hermes, set `REVIEW_HERMES_REPO` to the installed checkout (the installer
+defaults to `~/hermes-agent`); contained review sessions bind its source read-only.
+
 The quickest path is the guided setup:
 
 ```bash
@@ -321,7 +340,7 @@ that can reach GitHub and your LLM provider works.
   you start it again. On a headless machine start it under `nohup` or in a
   tmux window, or as a user service.
 
-**Updates.** A Slurm deployment runs from a checkout, and
+**Updates.** A resident Slurm deployment runs from a checkout, and
 `OUTERLOOP_AUTO_UPDATE` in `.env` says whether the deploy step moves it. `off`,
 the default, leaves the checkout alone: you upgrade when you choose, and the
 loop keeps running the code you validated. `release` moves it to the newest
@@ -334,6 +353,44 @@ the installed package, which has no such policy: run `outerloop upgrade` to move
 it to the newest release (add `--pre` to track pre-releases), then start it
 again. That is `pip install --upgrade outerloop-science` under one verb.
 
+#### Login-node loop
+
+Use this when no Slurm partition can start a resident tick within your cadence
+and the site permits a long-lived process on the login node. In
+`~/.config/outerloop/.env`, set:
+
+```bash
+OUTERLOOP_TICK_HOST=login
+OUTERLOOP_QOS=priority
+OUTERLOOP_APPTAINER_BIN=/cm/local/apps/apptainer/current/bin/apptainer
+```
+
+Run `outerloop start` from your checkout with the usual shared `OUTERLOOP_ROOT`.
+`--tick-host login` overrides the environment, which overrides `.env`.
+`resident` is the default on Slurm; local compute still runs locally.
+The login loop requires `sbatch` on PATH, runs in the foreground at nice +10,
+and submits compute to Slurm. QOS applies to all submitted jobs; the Apptainer
+path is used on compute nodes. The tick only checks the image file exists and
+does not run Apptainer on the login node. Empty QOS uses Slurm's default;
+an empty binary setting uses `apptainer`.
+
+Only one loop may own a state root. Every foreground loop, local or login,
+holds the root's `TICK` lease (holder `host:pid`, heartbeat and the holder's
+cadence written each tick); a file lock refuses a second loop while the owner
+runs. `outerloop start` refuses any loop while the lease is held, and a login
+loop while a resident chain is queued or running; a resident submission that
+finds the lease taken meanwhile withdraws its job, and a login loop that
+finds a resident queued after taking the lease stops. After a crash the next
+start on the same host takes the lease at once, and a start from another
+host once the heartbeat is three of the holder's cadences old (file locks may
+not reach across nodes); a loop whose record was overwritten from another
+node stops at its next heartbeat. Ctrl-C or SIGTERM releases the lease. Use
+tmux or a user service if the process should survive your terminal.
+
+The login loop does **not auto-update**, even with `OUTERLOOP_AUTO_UPDATE=main`.
+To restart or upgrade: stop the process, run `git pull`, run `uv sync`, then
+run `outerloop start` again. Settings from `.env` are exported only at launch.
+
 ### Upgrading
 
 1. Run `outerloop upgrade` (add `--pre` for pre-releases).
@@ -397,13 +454,20 @@ lesser of 10 minutes and half the cadence), and `OUTERLOOP_MAX_JOB_MINUTES` caps
 the walltime the tick requests for the climb and author-sleep wake jobs it sizes
 (clamped under a code ceiling).
 
-**Two operator switches.** `touch <root>/PAUSE` pauses the loop; `touch
-<root>/DISARM_WAKE` stops parked runs from being woken, by the sweep and by a
-wake job a park already queued, until the file is removed. Both are read at
-every tick and by every wake, no restart: the sentinel is the switch.
-(`OUTERLOOP_DISPATCH_WAKE=0` in the environment that starts the loop or the
-chain does the same; it is not read from `.env`.) Wakes are on by default: a
-loop that cannot wake strands every parked run without a word.
+**Three operator switches.** `touch <root>/PAUSE` stops tick work except the
+heartbeat; jobs already running continue. The resident chain drains on it (it
+cancels its successor and exits), so after `rm <root>/PAUSE` run `outerloop
+start` there; the per-tick chain and the local loop resume on their own at the
+next tick.
+`touch <root>/DISARM_WAKE` stops wake delivery by the sweep and by queued wake
+jobs until `rm <root>/DISARM_WAKE`, while fresh launches, ending records, and
+the chain keep running (the starting environment's `OUTERLOOP_DISPATCH_WAKE=0`
+also disarms wakes; it is not read from `.env`).
+`touch <root>/HOLD_LAUNCHES` stops fresh intake, self-initiated, and steward runs
+until `rm <root>/HOLD_LAUNCHES`, with no chain restart, while the sweep, wake and
+message delivery, GitHub polling, self-merge sweep, board, and ending records
+continue; existing runs keep spending, including their panels, author sessions,
+and the authors' own `launch` submissions.
 
 **Local mode without an image.** On a machine with no Apptainer image,
 `OUTERLOOP_COMPUTE=local` still runs. Sessions run under the harness's own

{outerloop_science-0.2.0rc2 → outerloop_science-0.2.0rc3}/scripts/tick_chain.sbatch

@@ -52,6 +52,8 @@ done
 # partition may be a comma-list like "a,b"), pass them through.
 acct_arg=""
 [ -n "${OUTERLOOP_ACCOUNT:-}" ] && acct_arg="--account=${OUTERLOOP_ACCOUNT}"
+qos_arg=""
+[ -n "${OUTERLOOP_QOS:-}" ] && qos_arg="--qos=${OUTERLOOP_QOS}"
 part_arg=""
 [ -n "${OUTERLOOP_PARTITION:-}" ] && part_arg="--partition=${OUTERLOOP_PARTITION}"
 
@@ -104,7 +106,7 @@ while [ "$i" -le "$need" ]; do
             || date -r "$begin_epoch" +%Y-%m-%dT%H:%M:%S)
     for attempt in 1 2 3; do
         if sbatch --dependency=singleton --begin="$begin" \
-                  ${acct_arg:+"$acct_arg"} ${part_arg:+"$part_arg"} \
+                  ${acct_arg:+"$acct_arg"} ${part_arg:+"$part_arg"} ${qos_arg:+"$qos_arg"} \
                   "${OUTERLOOP_HOME:-}/scripts/tick_chain.sbatch"; then
             break
         fi

{outerloop_science-0.2.0rc2 → outerloop_science-0.2.0rc3}/scripts/tick_deploy.sh

@@ -195,6 +195,7 @@ if [ -n "$ENV_TRUSTED" ]; then
                   OUTERLOOP_TARGET \
                   OUTERLOOP_GITHUB_APP_FILE OUTERLOOP_BOT_LOGIN OUTERLOOP_BOT_ALIASES \
                   OUTERLOOP_GPU_PARTITION OUTERLOOP_GPU_ACCOUNT \
+                  OUTERLOOP_QOS OUTERLOOP_APPTAINER_BIN \
                   OUTERLOOP_IMAGE \
                   OUTERLOOP_PANEL OUTERLOOP_PANEL_KEY_FILE \
                   OUTERLOOP_PANEL_CODEX_KEY_FILE \

{outerloop_science-0.2.0rc2 → outerloop_science-0.2.0rc3}/scripts/tick_resident.sh

@@ -45,13 +45,15 @@ submit_successor() {
     # them only when set.
     local acct_arg=""
     [ -n "${OUTERLOOP_ACCOUNT:-}" ] && acct_arg="--account=${OUTERLOOP_ACCOUNT}"
+    local qos_arg=""
+    [ -n "${OUTERLOOP_QOS:-}" ] && qos_arg="--qos=${OUTERLOOP_QOS}"
     local part_arg=""
     [ -n "${OUTERLOOP_PARTITION:-}" ] && part_arg="--partition=${OUTERLOOP_PARTITION}"
     local out="" attempt
     for attempt in 1 2 3; do
         if out=$(sbatch --parsable --dependency="$dep" --time="$resident_minutes" \
                     --job-name="$RESIDENT_JOB_NAME" --export=ALL \
-                    ${acct_arg:+"$acct_arg"} ${part_arg:+"$part_arg"} \
+                    ${acct_arg:+"$acct_arg"} ${part_arg:+"$part_arg"} ${qos_arg:+"$qos_arg"} \
                     "$shim" 2>/dev/null); then
             printf '%s' "${out%%;*}"
             return 0

{outerloop_science-0.2.0rc2 → outerloop_science-0.2.0rc3}/src/outerloop/__init__.py

@@ -1,3 +1,3 @@
 """Outerloop: autonomous research agents that improve a benchmark on your own code."""
 
-__version__ = "0.2.0rc2"
+__version__ = "0.2.0rc3"