loki-mode 11.143.0 → 11.144.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/SKILL.md +2 -2
  2. package/VERSION +1 -1
  3. package/dashboard/__init__.py +1 -1
  4. package/docs/ARCHITECTURE.md +5 -6
  5. package/docs/CLI-REFERENCE.md +1 -1
  6. package/docs/INSTALLATION.md +1 -1
  7. package/docs/TESTING.md +1 -1
  8. package/docs/dev/architecture-reference.md +4 -0
  9. package/docs/dev/release-checklist.md +2 -2
  10. package/docs/environment-variables.md +2 -0
  11. package/docs/v10/GUIDE.md +2 -3
  12. package/loki-ts/dist/loki.js +1798 -1789
  13. package/mcp/__init__.py +1 -1
  14. package/package.json +2 -2
  15. package/packages/control-plane/dist/server.js +2065 -1817
  16. package/plugins/loki-mode/.claude-plugin/plugin.json +1 -1
  17. package/web-app/dist/assets/{AdminPage-Bfyaout3.js → AdminPage-DbH5UGUB.js} +1 -1
  18. package/web-app/dist/assets/{Avatar-B4M87e2A.js → Avatar-DDDRreMf.js} +1 -1
  19. package/web-app/dist/assets/{Badge-BdWo4Pis.js → Badge-keUySv6q.js} +1 -1
  20. package/web-app/dist/assets/{Button-ga7zrGds.js → Button-B0VwDcEe.js} +1 -1
  21. package/web-app/dist/assets/{CockpitPage-BCPdCf3y.js → CockpitPage-xhnfgUs9.js} +1 -1
  22. package/web-app/dist/assets/{ComparePage-ei74A2H-.js → ComparePage-S8wqTiHb.js} +1 -1
  23. package/web-app/dist/assets/{ErrorBoundary-DOksQdek.js → ErrorBoundary-C7kcvRwe.js} +1 -1
  24. package/web-app/dist/assets/{EvidenceReceiptPanel-BejiJCuC.js → EvidenceReceiptPanel-pEiN-C4u.js} +1 -1
  25. package/web-app/dist/assets/{GitHubIssuesPanel-B4SLdG6W.js → GitHubIssuesPanel-DTIMWNDX.js} +1 -1
  26. package/web-app/dist/assets/{GitHubPRsPanel-DUfmJ8-D.js → GitHubPRsPanel-Brzi3w1V.js} +1 -1
  27. package/web-app/dist/assets/{HomePage-DLOrsiAX.js → HomePage-Cy3z6Qn8.js} +2 -2
  28. package/web-app/dist/assets/{LoginPage-CYX6EhD1.js → LoginPage-CUE-CwkD.js} +1 -1
  29. package/web-app/dist/assets/{MagicPage-B9V-H8rJ.js → MagicPage-CqtINBPy.js} +1 -1
  30. package/web-app/dist/assets/{MetricsPage-DxR4dA3v.js → MetricsPage-DQCWeFlA.js} +1 -1
  31. package/web-app/dist/assets/{NotFoundPage-62GUMrsu.js → NotFoundPage-BA1MqN6l.js} +1 -1
  32. package/web-app/dist/assets/{ProjectPage-aRlMvuO3.js → ProjectPage-Cxcx0V8O.js} +3 -3
  33. package/web-app/dist/assets/{ProjectsPage-DlsVYWSU.js → ProjectsPage-DdUdvtjK.js} +1 -1
  34. package/web-app/dist/assets/{SettingsPage-CYBOAzSl.js → SettingsPage-I7PVb5wn.js} +1 -1
  35. package/web-app/dist/assets/{ShowcasePage-Cp9h_ikU.js → ShowcasePage-DHrNop3J.js} +1 -1
  36. package/web-app/dist/assets/{SystemSettingsPage-Bi8O5KM1.js → SystemSettingsPage-CNVdXQOz.js} +1 -1
  37. package/web-app/dist/assets/{TeamsPage-CvKAy4VC.js → TeamsPage-BJ1hSoZz.js} +1 -1
  38. package/web-app/dist/assets/{TemplatesPage-DgZ8R3cj.js → TemplatesPage-DuCIT8M9.js} +1 -1
  39. package/web-app/dist/assets/{TerminalOutput-BXzQQ3ao.js → TerminalOutput-CKew5YmS.js} +1 -1
  40. package/web-app/dist/assets/{activity-wbwzJg71.js → activity-X_sIluZD.js} +1 -1
  41. package/web-app/dist/assets/{bell-CU-k59mu.js → bell-1x4qAMba.js} +1 -1
  42. package/web-app/dist/assets/{bot-nRo4H6pJ.js → bot-D2DF_VYf.js} +1 -1
  43. package/web-app/dist/assets/{check-BsSag1UJ.js → check-Qht2HACJ.js} +1 -1
  44. package/web-app/dist/assets/{chevron-left-CZr4us96.js → chevron-left-_uYpkUq-.js} +1 -1
  45. package/web-app/dist/assets/{circle-alert-C2EwgqPt.js → circle-alert-YPaRiMsJ.js} +1 -1
  46. package/web-app/dist/assets/{clock-B1jzN_2i.js → clock-Cwk21p0_.js} +1 -1
  47. package/web-app/dist/assets/{cloud-Bmbi0qzP.js → cloud-DhHbq4bj.js} +1 -1
  48. package/web-app/dist/assets/{code-xml-VGyACVgD.js → code-xml-DS3Em8bd.js} +1 -1
  49. package/web-app/dist/assets/{database-CWmwrahT.js → database-BIa54kdE.js} +1 -1
  50. package/web-app/dist/assets/{dollar-sign-CTuJpB-U.js → dollar-sign-BalXn2oH.js} +1 -1
  51. package/web-app/dist/assets/{file-code-corner-CEKoA1FQ.js → file-code-corner-amORiznL.js} +1 -1
  52. package/web-app/dist/assets/{file-plus-wJZDaswJ.js → file-plus-DHJBZCsC.js} +1 -1
  53. package/web-app/dist/assets/{globe-CWQQ1FMq.js → globe-CeOKEwI7.js} +1 -1
  54. package/web-app/dist/assets/{hammer-CGzn_YVi.js → hammer-C7vs3Bds.js} +1 -1
  55. package/web-app/dist/assets/{index-D7HK6vkd.js → index-BtO8IJSL.js} +3 -3
  56. package/web-app/dist/assets/{layers-Db1BfC4Q.js → layers-Dycr1A4N.js} +1 -1
  57. package/web-app/dist/assets/{loader-circle-C0gn8jcq.js → loader-circle-OP-zgDuf.js} +1 -1
  58. package/web-app/dist/assets/{lock-wrIkF7MN.js → lock-5bs89wOo.js} +1 -1
  59. package/web-app/dist/assets/{package-DhSgTaXb.js → package-EhRpZQ-4.js} +1 -1
  60. package/web-app/dist/assets/{plus-CdbYe7om.js → plus-Dy5O2_nt.js} +1 -1
  61. package/web-app/dist/assets/{refresh-cw-JNwtW3Ws.js → refresh-cw-BUMYlYZm.js} +1 -1
  62. package/web-app/dist/assets/{rotate-ccw-Dld_mqp3.js → rotate-ccw-CGRS25sv.js} +1 -1
  63. package/web-app/dist/assets/{scroll-text-DWs72mdn.js → scroll-text-8Wgg1Lbl.js} +1 -1
  64. package/web-app/dist/assets/{server-CucPfvl_.js → server-COT4dK2-.js} +1 -1
  65. package/web-app/dist/assets/{shield-alert-D3IjFaYW.js → shield-alert-9IDjzX-A.js} +1 -1
  66. package/web-app/dist/assets/{thumbs-up-CHz4RJSh.js → thumbs-up-qETqqDxw.js} +1 -1
  67. package/web-app/dist/assets/{trash-2-B6cfWy3k.js → trash-2-DUncVSUn.js} +1 -1
  68. package/web-app/dist/assets/{trending-down-CfrEdZcD.js → trending-down-DDYwKmCB.js} +1 -1
  69. package/web-app/dist/assets/{trending-up-Dn4jQ0v5.js → trending-up-CFw4DBaE.js} +1 -1
  70. package/web-app/dist/assets/{upload-BIHmbeaS.js → upload-CL55EDB7.js} +1 -1
  71. package/web-app/dist/assets/{usePolling-BpfFN5gC.js → usePolling-DnTTT7O0.js} +1 -1
  72. package/web-app/dist/assets/{user--rB-Jk_0.js → user-C5FKVYyb.js} +1 -1
  73. package/web-app/dist/index.html +1 -1
package/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: loki-mode
3
3
  description: Runs an autonomous software factory that knows what it is supposed to deliver and proves it did, with a signed receipt. Use when the user says Loki Mode or asks to build, fix or verify software autonomously.
4
4
  ---
5
5
 
6
- # Loki Mode v11.143.0
6
+ # Loki Mode v11.144.0
7
7
 
8
8
  **Current entry points (Loki 10 engine):** `loki "<task>"`, `loki owner/repo#N` and `loki quick "<task>"` run the Loki 10 engine and end with a signed receipt (`loki verify`). `loki backlog owner/repo --all` runs many issues in parallel. Guide: `docs/v10/GUIDE.md`. The skill instructions below, and `loki start`, describe the previous bash loop. PRD-file starts (`loki start ./prd.md`) and the opencode provider still run on it until FC38-SWEEP ports them; the legacy-engine command and the LOKI_ENGINE switch remain removed. Prefer `loki owner/repo#N` for issues.
9
9
 
@@ -461,4 +461,4 @@ Implemented, planned and deprecated items, with the version each landed in: `CHA
461
461
 
462
462
  ---
463
463
 
464
- **v11.143.0 | [Autonomi](https://www.autonomi.dev/) flagship product | core skill**
464
+ **v11.144.0 | [Autonomi](https://www.autonomi.dev/) flagship product | core skill**
package/VERSION CHANGED
@@ -1 +1 @@
1
- 11.143.0
1
+ 11.144.0
@@ -7,6 +7,6 @@ Modules:
7
7
  control: Session control helpers (status, atomic writes, origin check)
8
8
  """
9
9
 
10
- __version__ = "11.143.0"
10
+ __version__ = "11.144.0"
11
11
 
12
12
  __all__ = ["__version__"]
@@ -243,9 +243,8 @@ templates/ 21 PRD templates (saas, cli, discord-bot, ...)
243
243
  agents/ Agent registry: types.json, hub install, managed registry
244
244
  benchmarks/ benchmark harnesses
245
245
  plugins/ Claude Code plugin packaging
246
- .github/workflows/ release.yml, converge-dist-tags.yml,
247
- sdk-freshness.yml, pr-fast.yml (runs
248
- scripts/local-ci.sh on every PR and push)
246
+ .github/workflows/ release.yml, converge-dist-tags.yml
247
+ (distribution only; tests run locally)
249
248
  SKILL.md Slim core skill (progressive disclosure entry)
250
249
  CLAUDE.md Project + agent operating instructions
251
250
  VERSION / package.json Single source of version truth
@@ -324,9 +323,9 @@ docker/ Container distribution (Dockerfiles, compose)
324
323
  TS providers module.
325
324
  - **Docker / Docker Compose** for distribution and for the multi-service,
326
325
  12-factor stacks Loki generates (web + database + cache with healthchecks).
327
- - **GitHub Actions** (`.github/workflows/`): `release.yml` (multi-channel
328
- release), `converge-dist-tags.yml`, `sdk-freshness.yml` and `pr-fast.yml`,
329
- which runs the hermetic tests (`scripts/local-ci.sh`) on every PR and push.
326
+ - **GitHub Actions** (`.github/workflows/`): distribution only, `release.yml`
327
+ (multi-channel release) and `converge-dist-tags.yml`. The hermetic tests
328
+ (`scripts/local-ci.sh`) run locally.
330
329
 
331
330
  ---
332
331
 
@@ -1,6 +1,6 @@
1
1
  # CLI reference
2
2
 
3
- Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.143.0. Do not edit by hand.
3
+ Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.144.0. Do not edit by hand.
4
4
  Hidden and legacy-only commands are omitted; see `docs/CLI-INVENTORY.md` for the full inventory.
5
5
 
6
6
  | Command | Description |
@@ -2,7 +2,7 @@
2
2
 
3
3
  Loki Mode, by [Autonomi](https://www.autonomi.dev/), turns a spec or an issue into a verified pull request with a receipt you can check. This page covers installing it, a first run, and the options around it.
4
4
 
5
- **Version:** v11.143.0
5
+ **Version:** v11.144.0
6
6
 
7
7
  **Engine note:** `loki start` is the primary command. `loki start`, `loki "<task>"`, `loki owner/repo#N` and `loki quick` all run the Loki 10 engine, whatever the flag order or input form (PRD file, issue ref, task or one-word brief). The previous loop runs only on `--engine legacy`, `LOKI_ENGINE=legacy`, or for one call when a flag Loki 10 cannot honor is present. See the [user guide](v10/GUIDE.md) and the [5-minute quickstart](QUICKSTART.md).
8
8
 
package/docs/TESTING.md CHANGED
@@ -9,7 +9,7 @@ bash scripts/local-ci.sh # all tests, cheap on
9
9
  LOCAL_CI_ONLY=hygiene,pack-contents bash scripts/local-ci.sh # a subset
10
10
  ```
11
11
 
12
- `npm test` runs the same command. The same script runs in GitHub Actions (`.github/workflows/pr-fast.yml`). One-time setup for `dist-freshness`: `bun install --cwd loki-ts --frozen-lockfile`.
12
+ `npm test` runs the same command. GitHub Actions runs no test workflow; this script is the only test gate. One-time setup for `dist-freshness`: `bun install --cwd loki-ts --frozen-lockfile`.
13
13
 
14
14
  ## What each test guards
15
15
 
@@ -191,6 +191,10 @@ These knobs together implement the RARV-C (closure) loop: findings -> override c
191
191
  - `LOKI_E10_LINT_MISSING_DISCLOSE` -- on by default, `0` opts out (acc-150; `loki-ts/src/engine10/stages/verify.ts` lintFallbacks in runLintChecks, `stages/seal.ts` missingLintChecks). When ruff cannot be started, verify retries it the way the repo's own tooling would without a global install: `uvx ruff`, then the repo virtualenv's `python -m ruff`. A lint check (`lint:*`) whose tool still could not be started (skip_code `tool_not_on_path`) leaves the verdict inputs and is disclosed as "linter not installed, not run (disclosed, does not cap)". A linter that runs and reports violations still caps, and a missing test runner is never disclosed this way.
192
192
  - `LOKI_E10_PROOF_COMPILED_BUDGET` -- on by default, `0` opts out (acc-152; `loki-ts/src/util/mutation_proof.ts` proofBudgetS / warmGoBuild). The fail-then-pass proof of a compiled stack (go, cargo, maven, gradle, javac, dotnet tests) gets the 40 s cap (MAX_TOTAL_S, inside seal's 60 s limit) by default instead of 30 s. An explicit LOKI_MUTATION_PROOF_TIMEOUT_S or caller budget still wins. For go, the base worktree's test packages are compiled once (`go test -run ^$ -count=1 ./<pkg>`, no test runs) inside the same deadline before the timed runs. It only grants time; what counts as proof is unchanged. Before it, go-chi/chi's cold go build took 32 s of the 30 s budget and a real fail-then-pass read "inconclusive (timeout)".
193
193
  - `LOKI_E10_NAMED_EXACT` -- on by default, `0` opts out (acc-154; `loki-ts/src/engine10/sizing.ts` namedFiles, used by sizing and by verify's task-named tests). A basename every mention of which sits inside a spelled path names only the files those paths spell, even when the spelled file does not exist yet. A bare mention ("fix page.tsx") keeps naming every file with that basename. Before it, FireLater#24's task spelled `.../search/page.tsx` and named all 54 `page.tsx` files and 46 `page.test.tsx` files in the repo.
194
+ - `LOKI_E10_PROVE_BY_RUNNING` -- on by default, `0` opts out of everything below (Q1 F5 and candidate 1; `loki-ts/src/e10ext/context.ts` issueRules, PROVE_BY_RUNNING_BLOCK, TAKE_THE_TIME_LINE, DELIVER_EACH_LINE, proveByRunningBlock; `engine10/types.ts` ISSUE_FINISH_LINE and issueRunBrief; `engine10/stages/implement.ts`; `engine10/machine.ts`). Scope: an issue run (intake source `issue`) on the claude provider, implement stage only. (1) Rules: fixedRules(env, true) is today's rules constant with `- Never leave a long-lived server running.` and `- Never kill processes.` replaced by ISSUE_RULE_LINE (start the repository's own services and throwaway dependencies, stop each by its recorded process id, never signal another process) and FINISH_LINE replaced by ISSUE_FINISH_LINE (the same three endings plus `LOKI_UNFINISHED: <what is left>`, and `LOKI_SPEC_CONFLICT` only for a contradicting test); the brief's closing finish line and the S1b continue brief use ISSUE_FINISH_LINE too. Each is a constant, so the prefix stays cache-stable within issue runs. (2) Per-task part: the prove-by-running block (run the change the way its caller does; no fixed port; tried-first rule for anything that cannot be run), the take-the-time line, the deliver-each line and the environment card line. (3) No time-budget sentence (machine.ts withTimeNote is skipped); the stage limit is enforced as before. LOKI_UNFINISHED needs no parser change: session.ts finishLineOf reads only the three finish lines, so S1b resumes such a reply and seals it `incomplete` (PARTIAL, diff and PR kept, the reply's own text in NOT PROVEN). A text goal, opencode, the fix stage and every other stage keep today's constants and briefs byte for byte.
195
+ - Q1 run scratch (no own knob; candidate 1 scope, `LOKI_E10_PROVE_BY_RUNNING=0` opts out; `loki-ts/src/runner/worker_proc.ts` createSessionScratch, cleanupSessionScratch, ownedProcesses, cleanupScratchRecord, cleanupStaleScratches). Before implement the harness makes /tmp/lk-XXXXXX (mode 700, a marker holding its own path) and writes `<runDir>/scratch.json` (dir, since, nonce, worker pid); the implement session and its resumes get LOKI_SCRATCH, LOKI_SCRATCH_SINCE, TMPDIR and LOKI_RUN_OWNER (scratchSessionEnv). Ownership is proven by the harness: a process of this user started at or after `since` is the run's when LOKI_RUN_OWNER=<nonce> is in its environment (`ps eww` on macOS, /proc/PID/environ on linux; only a match is kept), its resolved working directory (lsof cwd or /proc) or an absolute command-line path resolves inside the scratch directory, or its parent is the run's. A path in the work tree is never evidence; the session's `<dir>/pids` is a hint only, and a listed pid that is not proven is left alone and reported (`left running, not proven ours`). Each signal is sent only after the pid's start time (lstartEpoch, one or two spaces before a single-digit day) is read again and found unchanged: TERM, about 2 s, KILL; the scan repeats until nothing owned is alive, and only then is the directory removed (else kept, with the reason). Runs after implement and its resumes, in a process exit hook, in the supervisor after the worker exits (any stop path), and at the next run's start for a record whose worker pid is gone. Measured on macOS with real binaries: a pg_ctl postmaster and npm exec tsx with its node children carry the nonce; `redis-server --daemonize yes` loses it and is found only by a --dir in scratch; platform binaries such as /bin/sleep hide their environment from ps. tests/min/scratch-real-services.sh (non-hermetic, not in local-ci) runs the real pg_ctl, redis and tsx cases. The host guard has no scratch allowances.
196
+ - `LOKI_E10_ENV_CARD` -- on by default, `0` opts out (candidate 1; `loki-ts/src/util/stack_tools.ts` neededServices, detectServiceBinaries, envCardLine, envCard; issue runs on claude with LOKI_E10_PROVE_BY_RUNNING on). Before implement, no model call, no network: the services the repository mentions (pg, postgres, psycopg, asyncpg, pgx; redis, ioredis; mysql, mariadb; mongodb, mongoose in package.json, requirements, pyproject, go.mod, docker-compose, compose or .env.example, up to two directories down) are looked up on PATH, then in Homebrew kegs `/opt/homebrew/opt/<keg>/bin` and `/usr/local/opt/<keg>/bin`, `/usr/lib/postgresql/<v>/bin` and `/Applications/Postgres.app/Contents/Versions/<v>/bin` (newest version wins). Each found off PATH is appended (never prepended) to the PATH of the implement session and its resumes only (SessionRunOptions.pathAppend, session.ts childEnv), and one `Available on this machine: ...` line joins the per-task brief. `<runDir>/env-card.json` and one `env.card` event record what was found; no env value is stored. Any error gives no card. `LOKI_E10_ENV_CARD_ROOTS` (colon list) replaces the off-PATH locations, for tests.
197
+ - F3 reviewer UNMET cap (no knob; Q1 F3; `loki-ts/src/engine10/stages/xreview.ts` isUnmetNote and parseReview, `stages/seal.ts` openNotes). A cross-review reason that says an asked-for line is unmet (`UNMET: ...`, the form util/intent_card.ts asks for) becomes an open note at seal, which caps VERIFIED at PARTIAL. parseReview sorts UNMET reasons ahead of the others before its 5-reason cap, so one written sixth is kept. The review levels, when the review runs and its prompt are unchanged; a run with no review is unchanged.
194
198
  - `LOKI_RERUN_GUARD` -- on by default, `0` opts out (Q1 F4; `loki-ts/src/commands/issues_run.ts` openLokiPrGuard, called by `engine10/supervisor.ts` right after the issue fetch, before startIssueEpic and any session). It lists the open pull requests with the same `gh pr list` and coveredIssues rule `loki issues run` dedupes by, and stops (exit 2) when one whose head is a `loki/` branch owned by the origin's owner covers the issue. A list that cannot be read stops the run (fail closed). It is skipped with `--no-pr`, when gh is not ready (publish already falls back to no PR) and when the origin is not a GitHub remote: a local mirror publishes `local://` branches, so no GitHub pull request can be duplicated and the hermetic tests and local-mirror runs are unaffected. It never writes to the pull request.
195
199
  - `LOKI_E10_CONTINUE_MAX` (default 4, `0` turns the resume off, at most 10) and `LOKI_E10_CONTINUE_MAX_USD` (default 1.00) -- Q1 S1b, claude provider only (CLI and SDK routes; opencode is unchanged). `loki-ts/src/engine10/session.ts` finishLineOf sets `markers.finishLine` from the last non-empty line of a session's final text (a literal `LOKI_DONE`, `LOKI_ALREADY_DONE:` or `LOKI_SPEC_CONFLICT:` line; a finish line quoted earlier or any other `LOKI_` token is not one); `markers.done` and its readers are unchanged. An implement session without a finish line is resumed in the same session through resumeWith (`util/conflict_resume.ts` resumeToFinish, suffix `-k<n>`), before the follow-up gates and the `-rv` turn, while each resume changes the tree (anti_loop.ts treeFingerprint), RESUME_MIN_LEFT_S holds, the count is under LOKI_E10_CONTINUE_MAX and the run's measured spend is under LOKI_E10_CONTINUE_MAX_USD (unmeasured spend, as on the CLI invoker, leaves only the count). The brief says the summary request is over, quotes the reply's last lines, names plan-scope files not in the tree and ends with FINISH_LINE. Each resume emits `s1b.resumed` {resume, iteration_id, compactions, finish_line}. A session still unfinished gets implement exit `incomplete`: no follow-up gate runs on it, the diff and the PR are kept, and seal adds `implement ended without a finish line (<why> after <n> resumes): <outstanding>` to the open notes, which caps VERIFIED at PARTIAL. The implement record carries `finish` {continues, ended, outstanding, spent_usd, compactions} only when S1b fired; compactions come from the SDK stream's system/compact_boundary (sdk_stream_parser.ts) and are null on the CLI route. Each resume is a new query, so the Haiku session caps (effort_policy.ts: implement 45 turns, 160K new tokens) start from zero per resume.
196
200
  - `LOKI_ISSUE_WHOLE_FIRST` -- unset: on for Sonnet and stronger models, off for a run that implements on Haiku (`loki-ts/src/util/claude_model.ts` haikuRun; LOKI_ROUTER=1, whose plan may route implement to Haiku later, is not covered); `1` forces it on any model, `0` opts out (Q1 S1; `loki-ts/src/features/decompose.ts` issueWholeFirst, read by `engine10/supervisor.ts` before startIssueEpic and by `features/triage.ts`). An issue run from `loki start owner/repo#N` (so also every `loki backlog` and `loki issues run` child) never asks for the up-front MASS-2 split: the issue runs as one whole-issue run on the same path `LOKI_UNIT_ID=whole` took (sized as before, plan kept for a large issue, Wall off by default). `0` restores the split. The per-model rule lives in issueWholeFirst.
@@ -5,7 +5,7 @@ Release steps and local CI details for maintainers.
5
5
  ## Local CI Before Every Push
6
6
 
7
7
  `bash scripts/local-ci.sh` runs the hermetic tests under `tests/min/` (see `docs/TESTING.md`); it
8
- is the pre-push gate and the same command runs in `.github/workflows/pr-fast.yml`. `.githooks/pre-push`
8
+ is the pre-push gate and the only test gate (GitHub runs distribution workflows only). `.githooks/pre-push`
9
9
  enforces the repo-identity check, `bash -n` on `autonomy/run.sh` and `autonomy/loki`, the secret scan,
10
10
  and the red-main warning; a push is not "done" until `git ls-remote origin refs/heads/main` matches
11
11
  the local HEAD. `scripts/release.sh` runs no test gate: run `bash scripts/local-ci.sh` before
@@ -113,7 +113,7 @@ create tags.
113
113
 
114
114
  Run the engine end-to-end check alone with `cd loki-ts && bun run test:engine10` (it runs `tests/min/engine10-e2e-stub.sh` through `scripts/local-ci.sh`).
115
115
 
116
- `release.sh --ship` refuses with exit 6 (SHIP_CI_NOT_GREEN) unless the latest completed GitHub CI run (`PR fast tier`, `required-ci`; LOKI_RELEASE_CI_WORKFLOWS) on HEAD, or on its parent when HEAD has none, succeeded. A gh error or a timeout (LOKI_RELEASE_CI_TIMEOUT_S, default 30) also refuses. Push the release candidate and wait for its CI first. `bash scripts/release.sh --check-ci` runs the same check alone. Main's PR fast tier was red from acc-154 through v11.141.0, a CI-only timeout that local gates never saw.
116
+ `release.sh --ship` requires no GitHub CI run by default: the gate is one full `bash scripts/local-ci.sh` on the release SHA. To require one again, set LOKI_RELEASE_CI_WORKFLOWS to a comma list of workflow names; `--ship` then refuses with exit 6 (SHIP_CI_NOT_GREEN) unless the latest completed run of each on HEAD, or on its parent when HEAD has none, succeeded, and a gh error or a timeout (LOKI_RELEASE_CI_TIMEOUT_S, default 30) also refuses. `bash scripts/release.sh --check-ci` runs the same check alone.
117
117
 
118
118
  Before pushing the release commit, run `bash scripts/release.sh --check-clean`: it exits 1 naming any tracked file (for example a stamped `loki-ts/dist/loki.js.map`) the commit left modified; `--bump-only` prints the "stage these files:" list.
119
119
 
@@ -28,6 +28,8 @@ with nowhere to look them up.
28
28
  | `LOKI_AUTO_CONFIRM` | unset | `true`/`false` to control prompts. Takes precedence over `CI`. |
29
29
  | `LOKI_CONFIG_DUMP` | `0` | `1` prints the resolved configuration and exits **without starting a run or spending anything**. |
30
30
  | `LOKI_KEEP_RUN_BRANCH` | unset | When a Loki 10 run ends, Loki returns your checkout to the branch you started from (only when it has no uncommitted changes; otherwise it prints how to return), removes the run's leftover temporary worktrees, and deletes the `loki/e10-*` run branch. A branch that was pushed is simply deleted; an unpushed one is first saved as a git bundle in `.loki/runs/<run-id>/branch.bundle` (with `branch.json` holding the branch name and head SHA), and the summary prints the restore command `git fetch .loki/runs/<run-id>/branch.bundle <branch>:<branch>`. If the bundle cannot be written, the branch is kept. Run branches left by earlier runs are saved and removed the same way at the end of the next run (bundles without a run directory go to `.loki/runs/legacy-branches/`). A run that passed but published nothing (no remote, or `--no-pr`) keeps its branch checked out, a run you can still resume keeps its branch, and a live run's branch or a branch checked out in any worktree is never touched; branches not named `loki/e10-*` are never touched. `1` turns all of this off and keeps every run branch, as before. Independently of this setting, session id files are written in the run directory instead of loose in `.loki/`, and the next run moves older loose ones there. |
31
+ | `LOKI_E10_PROVE_BY_RUNNING` | `1` | On an issue run with the Claude provider, the implement session may start the repository's own services (and must stop what it started), is asked to prove the change by running it the way its real caller does, to finish every item the issue lists or end with `LOKI_UNFINISHED: <what is left>`, and gets no time-budget sentence. `0` leaves the issue-run brief as before. |
32
+ | `LOKI_E10_ENV_CARD` | `1` | On an issue run with the Claude provider, database and cache servers the repository needs (Postgres, Redis, MySQL or MariaDB, MongoDB) that are installed off PATH, for example as a Homebrew keg-only package, are added to the end of the implement session's PATH and named in its brief. `0` turns this off. |
31
33
  | `LOKI_RERUN_GUARD` | `1` | Before any model call, `loki start owner/repo#N` stops when an open Loki pull request from the same owner already covers the issue, and prints its URL. It never closes, edits or comments on that pull request. If the open pull requests cannot be listed it stops too. Skipped with `--no-pr` and when the origin is not on GitHub (a local mirror). `0` starts the run anyway. |
32
34
  | `LOKI_ISSUE_WHOLE_FIRST` | unset (on for Sonnet and stronger models, off on Haiku) | `loki start owner/repo#N` (and the runs `loki backlog` and `loki issues run` start) runs the issue as one whole-issue run and never splits it up front, whatever its size, on Sonnet and stronger models. A run that implements on Haiku (`--session-model haiku` or `small`, `--haiku`, a Haiku model override) keeps the up-front split of a large issue. `1` forces the whole-issue run on any model; `0` restores the split everywhere. Sizing, the plan and the checks are unchanged. |
33
35
  | `LOKI_EPIC_PARALLEL` | provider slots, at most 4 (claude 4, opencode 1) | How many slices of a split issue (`loki start owner/repo#N` on a large issue under `LOKI_ISSUE_WHOLE_FIRST=0`) run at once. Slices with no dependency run at the same time, each in its own worktree; a slice that depends on another waits for it and starts on its branch. `1` runs them one at a time. A failing or spec-conflicting slice skips only the slices that depend on it. Slices share one `--max-cost` cap, which can be passed by up to (slices in flight - 1) session costs because each running session sees the cap at its next cost event. |
package/docs/v10/GUIDE.md CHANGED
@@ -154,9 +154,8 @@ becomes owner/repo#123 from the checkout's origin ("#N" needs a GitHub origin;
154
154
  quote it, since an unquoted # starts a shell comment). Loki prints a `goal:`
155
155
  line when it read a ref. Extra words ("fix #123 and add a test") keep the goal
156
156
  as text, and LOKI_GOAL_REF=0 turns the reading off. The run itself asks
157
- nothing: headless intake records its assumptions in the receipt. The only
158
- terminal prompt is the optional rating after VERIFIED (LOKI_SATISFACTION=0
159
- turns it off). Models and --deep are not auto-picked yet.
157
+ nothing: headless intake records its assumptions in the receipt, and no
158
+ rating prompt follows a VERIFIED run. Models and --deep are not auto-picked yet.
160
159
 
161
160
  bin/loki routes GitHub, GitLab (`.../-/issues/N`) and Jira
162
161
  (`.../browse/KEY`) issue URLs to the v10 engine, and the issue-fetch step