docs(forge): fix ci-log source ordering and binary path claim

docs/tools/forge.md

@@ -1,8 +1,8 @@
 # hive-forge CLI
 
 `hive-forge` is the Forgejo API wrapper available in every agent
-container (installed via `nix/agent-modules/forge.nix`; lives in `/hive-forge`
+container (installed via `nix/agent-modules/forge.nix`, on `PATH` as a
-as a proper Rust binary). Use it instead of ad-hoc curl pipelines.
+proper Rust binary). Use it instead of ad-hoc curl pipelines.
 
 ## Credentials and repo defaults
 
@@ -253,18 +253,21 @@ to discover valid label names before triaging or to audit the label set.
 - `ci-log --run <n> [--job i] [--step i] [--attempt n]` prints a CI
   run's job step logs. `<n>` is the run number from the run-page URL
   (same value `artifact-get` takes; `pr-status` surfaces it as a CI
-  context's target_url). Two log sources are tried in order: first the
+  context's target_url). Two log sources, tried in **completeness
-  web run-view **streamer** the run page polls (rich per-step framing,
+  order**: the **durable persisted-log download** the run page's "view
-  honors `--step`) — but that reads the live `act_runner` task record,
+  raw logs" link uses (`…/runs/<n>/jobs/<job>/attempt/<a>/logs`, a flat
-  which Forgejo prunes once a run completes; then, when the streamer is
+  whole-job log) is tried first — complete once it exists, which covers
-  pruned (500 / no lines), the **durable persisted-log download** the
+  any run that has already finished; it's only absent while the job is
-  run page's "view raw logs" link uses
+  still running, in which case the verb falls back to the web run-view
-  (`…/runs/<n>/jobs/<job>/attempt/<a>/logs`), a flat whole-job log that
+  **streamer** the run page polls (rich per-step framing, but only a
-  survives the prune (`--step` is not honored on this path). So quick /
+  snapshot of the live `act_runner` task record, so a still-buffering
-  older runs that the streamer can no longer serve still print instead
+  multi-minute phase can come back thin). Passing `--step` reverses
-  of erroring. `--job` selects the job (0-based, default 0); `--attempt`
+  that order — only the streamer honors per-step framing (the persisted
-  picks the run attempt for the durable path (default 1; re-runs
+  log is flat), so `--step` goes straight to the streamer and an
-  increment it). `--json` wraps the output.
+  out-of-range index surfaces as a hard error instead of silently
+  falling back. `--job` selects the job (0-based, default 0);
+  `--attempt` picks the run attempt for the durable path (default 1;
+  re-runs increment it). `--json` wraps the output.
 - `ci-rerun` re-runs CI without pushing an empty commit (the old
   retrigger path, which littered PR history). Forgejo has no token-usable
   REST endpoint to re-run an _existing_ run (the run-page rerun buttons