loki-mode 11.142.0 → 11.143.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/autonomy/lib/backlog.py +1 -1
  4. package/autonomy/loki +1 -1
  5. package/dashboard/__init__.py +1 -1
  6. package/docs/CLI-REFERENCE.md +1 -1
  7. package/docs/INSTALLATION.md +1 -1
  8. package/docs/dev/architecture-reference.md +3 -0
  9. package/docs/environment-variables.md +3 -1
  10. package/docs/v10/GUIDE.md +1 -1
  11. package/loki-ts/dist/loki.js +1789 -1785
  12. package/mcp/__init__.py +1 -1
  13. package/package.json +2 -2
  14. package/packages/control-plane/dist/server.js +336 -152
  15. package/plugins/loki-mode/.claude-plugin/plugin.json +1 -1
  16. package/scripts/verify-pr-sandbox.sh +1 -1
  17. package/web-app/dist/assets/{AdminPage-DyMZec5q.js → AdminPage-Bfyaout3.js} +1 -1
  18. package/web-app/dist/assets/{Avatar-COqdNbsk.js → Avatar-B4M87e2A.js} +1 -1
  19. package/web-app/dist/assets/{Badge-MAPrG4YW.js → Badge-BdWo4Pis.js} +1 -1
  20. package/web-app/dist/assets/{Button-CCiLxPzL.js → Button-ga7zrGds.js} +1 -1
  21. package/web-app/dist/assets/{CockpitPage-CC65JqZo.js → CockpitPage-BCPdCf3y.js} +1 -1
  22. package/web-app/dist/assets/{ComparePage-D8jLo09H.js → ComparePage-ei74A2H-.js} +1 -1
  23. package/web-app/dist/assets/{ErrorBoundary-DSe6Jio9.js → ErrorBoundary-DOksQdek.js} +1 -1
  24. package/web-app/dist/assets/{EvidenceReceiptPanel-C2AkMLOP.js → EvidenceReceiptPanel-BejiJCuC.js} +1 -1
  25. package/web-app/dist/assets/{GitHubIssuesPanel-xCJ1P7Zg.js → GitHubIssuesPanel-B4SLdG6W.js} +1 -1
  26. package/web-app/dist/assets/{GitHubPRsPanel-2AY8_R8P.js → GitHubPRsPanel-DUfmJ8-D.js} +1 -1
  27. package/web-app/dist/assets/{HomePage-DOf4taLJ.js → HomePage-DLOrsiAX.js} +2 -2
  28. package/web-app/dist/assets/{LoginPage-C0wwSd39.js → LoginPage-CYX6EhD1.js} +1 -1
  29. package/web-app/dist/assets/{MagicPage-BD3E-KJd.js → MagicPage-B9V-H8rJ.js} +1 -1
  30. package/web-app/dist/assets/{MetricsPage-qarlBbRU.js → MetricsPage-DxR4dA3v.js} +1 -1
  31. package/web-app/dist/assets/{NotFoundPage-BtrUhTdf.js → NotFoundPage-62GUMrsu.js} +1 -1
  32. package/web-app/dist/assets/{ProjectPage-D4WKVQ7S.js → ProjectPage-aRlMvuO3.js} +3 -3
  33. package/web-app/dist/assets/{ProjectsPage-jCrAWz4h.js → ProjectsPage-DlsVYWSU.js} +1 -1
  34. package/web-app/dist/assets/{SettingsPage-B4pPpffz.js → SettingsPage-CYBOAzSl.js} +1 -1
  35. package/web-app/dist/assets/{ShowcasePage-DOjR7Ex-.js → ShowcasePage-Cp9h_ikU.js} +1 -1
  36. package/web-app/dist/assets/{SystemSettingsPage-95JqUbHx.js → SystemSettingsPage-Bi8O5KM1.js} +1 -1
  37. package/web-app/dist/assets/{TeamsPage-yt8gvIKl.js → TeamsPage-CvKAy4VC.js} +1 -1
  38. package/web-app/dist/assets/{TemplatesPage-DoUDJ9ub.js → TemplatesPage-DgZ8R3cj.js} +1 -1
  39. package/web-app/dist/assets/{TerminalOutput-1rC0J4Bk.js → TerminalOutput-BXzQQ3ao.js} +1 -1
  40. package/web-app/dist/assets/{activity-Cl3Uec2Y.js → activity-wbwzJg71.js} +1 -1
  41. package/web-app/dist/assets/{bell-DtNdQWzd.js → bell-CU-k59mu.js} +1 -1
  42. package/web-app/dist/assets/{bot-DDpmlSz3.js → bot-nRo4H6pJ.js} +1 -1
  43. package/web-app/dist/assets/{check-BMbCof2H.js → check-BsSag1UJ.js} +1 -1
  44. package/web-app/dist/assets/{chevron-left-ByTbAUwf.js → chevron-left-CZr4us96.js} +1 -1
  45. package/web-app/dist/assets/{circle-alert-Bn9aE4IN.js → circle-alert-C2EwgqPt.js} +1 -1
  46. package/web-app/dist/assets/{clock-SBTAfWqd.js → clock-B1jzN_2i.js} +1 -1
  47. package/web-app/dist/assets/{cloud-ChyNGWkw.js → cloud-Bmbi0qzP.js} +1 -1
  48. package/web-app/dist/assets/{code-xml-DI_krPD4.js → code-xml-VGyACVgD.js} +1 -1
  49. package/web-app/dist/assets/{database-Wd5ifrBK.js → database-CWmwrahT.js} +1 -1
  50. package/web-app/dist/assets/{dollar-sign-C_lCtKRp.js → dollar-sign-CTuJpB-U.js} +1 -1
  51. package/web-app/dist/assets/{file-code-corner-qM8aq8IB.js → file-code-corner-CEKoA1FQ.js} +1 -1
  52. package/web-app/dist/assets/{file-plus-C6LCrbiu.js → file-plus-wJZDaswJ.js} +1 -1
  53. package/web-app/dist/assets/{globe-CDZS309O.js → globe-CWQQ1FMq.js} +1 -1
  54. package/web-app/dist/assets/{hammer-Cyaf53eE.js → hammer-CGzn_YVi.js} +1 -1
  55. package/web-app/dist/assets/{index-D0a1MQnH.js → index-D7HK6vkd.js} +3 -3
  56. package/web-app/dist/assets/{layers-DG1AyE8w.js → layers-Db1BfC4Q.js} +1 -1
  57. package/web-app/dist/assets/{loader-circle-D5yySgBF.js → loader-circle-C0gn8jcq.js} +1 -1
  58. package/web-app/dist/assets/{lock-CJy7cTHd.js → lock-wrIkF7MN.js} +1 -1
  59. package/web-app/dist/assets/{package-C7i6KmVK.js → package-DhSgTaXb.js} +1 -1
  60. package/web-app/dist/assets/{plus-rqC7IjWg.js → plus-CdbYe7om.js} +1 -1
  61. package/web-app/dist/assets/{refresh-cw-CtIjcJKv.js → refresh-cw-JNwtW3Ws.js} +1 -1
  62. package/web-app/dist/assets/{rotate-ccw-CAmSTk-m.js → rotate-ccw-Dld_mqp3.js} +1 -1
  63. package/web-app/dist/assets/{scroll-text-C300cwvb.js → scroll-text-DWs72mdn.js} +1 -1
  64. package/web-app/dist/assets/{server-CgwnLQuj.js → server-CucPfvl_.js} +1 -1
  65. package/web-app/dist/assets/{shield-alert-Cu4nt6vg.js → shield-alert-D3IjFaYW.js} +1 -1
  66. package/web-app/dist/assets/{thumbs-up-8OQoTJWS.js → thumbs-up-CHz4RJSh.js} +1 -1
  67. package/web-app/dist/assets/{trash-2-CIgxRV_x.js → trash-2-B6cfWy3k.js} +1 -1
  68. package/web-app/dist/assets/{trending-down-CelWNzAc.js → trending-down-CfrEdZcD.js} +1 -1
  69. package/web-app/dist/assets/{trending-up-B-mBwFXP.js → trending-up-Dn4jQ0v5.js} +1 -1
  70. package/web-app/dist/assets/{upload-BkfzF_e_.js → upload-BIHmbeaS.js} +1 -1
  71. package/web-app/dist/assets/{usePolling-CtnMxKVF.js → usePolling-BpfFN5gC.js} +1 -1
  72. package/web-app/dist/assets/{user-BvZ0JmEO.js → user--rB-Jk_0.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.142.0
6
+ # Loki Mode v11.143.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.142.0 | [Autonomi](https://www.autonomi.dev/) flagship product | core skill**
464
+ **v11.143.0 | [Autonomi](https://www.autonomi.dev/) flagship product | core skill**
package/VERSION CHANGED
@@ -1 +1 @@
1
- 11.142.0
1
+ 11.143.0
@@ -483,7 +483,7 @@ def main(argv):
483
483
  say("backlog: %s %-9s %s | %s" % (i["label"], c, i["title"], why))
484
484
  if a.dry_run:
485
485
  n_of = lambda c: sum(1 for i in issues if klass[i["key"]][0] == c) # noqa: E731
486
- n_large = sum(1 for i in issues if i["split"] and klass[i["key"]][0] == "implement" and klass[i["key"]][1].startswith("large ("))
486
+ n_large = sum(1 for i in issues if i["split"] and klass[i["key"]][0] == "implement" and klass[i["key"]][1].endswith("runs split into slices")) # WHOLE-FIRST: only a reason that says so counts
487
487
  if issues:
488
488
  say("backlog: dry run: %d would run%s, %d would get a drafted spec, %d need a human; nothing launched"
489
489
  % (n_of("implement"), " (%d split into slices)" % n_large if n_large else "", n_of("spec"), n_of("human")))
package/autonomy/loki CHANGED
@@ -14643,7 +14643,7 @@ cmd_backlog() {
14643
14643
  echo ""
14644
14644
  echo "Run from a checkout of owner/repo (for Jira or Linear, the checkout the work lands in)."
14645
14645
  echo "Each issue runs in its own worktree on loki/backlog-N. Jira and Linear use the credentials in docs/trackers.md."
14646
- echo "Triage: implement issues run, and a large one is split into slices that each run on their own;"
14646
+ echo "Triage: implement issues run; a large one runs as one whole-issue run on Sonnet and stronger models, split into slices on Haiku;"
14647
14647
  echo "vague or ambiguous (spec) issues get .loki/specs/<slug>.md and the command to run it;"
14648
14648
  echo "human issues are listed with the reason. Label loki:implement|loki:spec|loki:human forces a class;"
14649
14649
  echo "LOKI_TRIAGE=0 runs every issue untriaged."
@@ -7,6 +7,6 @@ Modules:
7
7
  control: Session control helpers (status, atomic writes, origin check)
8
8
  """
9
9
 
10
- __version__ = "11.142.0"
10
+ __version__ = "11.143.0"
11
11
 
12
12
  __all__ = ["__version__"]
@@ -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.142.0. Do not edit by hand.
3
+ Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.143.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.142.0
5
+ **Version:** v11.143.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
 
@@ -191,6 +191,9 @@ 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_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
+ - `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
+ - `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.
194
197
  - `LOKI_E10_OWN_BY_PATH` -- on by default, `0` restores collateralTests' stem rule (acc-154; `loki-ts/src/engine10/stages/verify.ts` ownTests). Of the relevant tests (always selected, A-114), the task's own (never excused as red on base, and the ones that decide a quick verify, `keep`, `targets0`, `targetNames`) are only a test file the task names, or a test path-paired with a named non-test file the diff changed: the same covered stem, in that file's directory or its `__tests__`, `tests` or `test` subdirectory. A named file the diff did not edit is a reference, so its tests are collateral (base comparison, COLLATERAL_RED cap). Before it, a named `X/page.tsx`, or a reference "is not modified" or "following the pattern in", made every same-stem test in the repo the task's own (FireLater#24).
195
198
  - `LOKI_E10_TOUCHED_BASE_RED` -- on by default, `0` opts out (acc-154; `loki-ts/src/runner/repo_profile.ts` touchedRedOnBase, `stages/verify.ts` editedTestTitles). A test file the diff edited is excused (pre_red, never decisive, disclosed on the receipt's baseline line, never a cap) only when the environment is as intake left it (envChangedSince), every comparable failing id is red in the intake profile of this exact base commit with the same error lines, and no failing id is a case the diff added or whose body it edited (a changed line counts as editing the case above it only when it sits deeper than that case's title, so a top-level import edits none). A previously green id that now fails, a new error under an old id, or a failing added or edited case keeps it blocking. Before it, FireLater#24's one added assertion in a Sidebar.test.tsx with 19 base-red tests made the whole file the slice's failure.
196
199
  - `LOKI_E10_COLLATERAL_BASELINE` -- on by default, `0` opts out (acc-154, fix D; `loki-ts/src/runner/repo_profile.ts` collateralOnBaseline, `stages/verify.ts`). A collateral test (relevant, not the task's own) is pre-existing at once, with no COLLATERAL_RED cap and no fix round, only when the environment is as intake left it, the test file is unedited, no changed file is its path-paired source, and every comparable failing id with its error lines equals this base commit's intake profile. A changed paired source, a new failing id, or the same id with another error keeps the cap and the fix round. Before it, FireLater#24's collateral page tests cost a fix round each slice and capped VERIFIED although they matched base exactly.
@@ -28,7 +28,9 @@ 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_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) 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. |
31
+ | `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
+ | `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
+ | `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. |
32
34
  | `LOKI_SPLIT_ONE_PR` | `1` | A split issue ends in ONE pull request for the issue, not one per slice. Each slice still runs and verifies on its own branch; at the end Loki builds `loki/<issue>-combined` from the issue's base, one commit per slice (`<slice id>: <slice title>`) in dependency order, reruns every slice's sealed tests plus the tests the combined change impacts, seals one combined receipt that lists each slice's verdict (the combined verdict is the weakest slice's, lowered by anything the combined tree breaks), and opens one PR with a section per slice. A merge conflict between slices gets one resolve session; if it still conflicts, that slice (and the slices stacked on it) opens its own PR and the `Combined:` line says why. `0` opens one PR per slice, as before. |
33
35
  | `LOKI_SPLIT_ONE_PR_MAX_FILES` | `150` | When the combined diff of a split issue touches more files than this, the slices open one PR each instead of one combined PR, and the reason is printed. |
34
36
  | `LOKI_SPLIT_MAX_SLICES` | `8` | The most slices one split may have (at least 2, at most 32). A split over the cap is re-asked once with the limit. |
package/docs/v10/GUIDE.md CHANGED
@@ -413,7 +413,7 @@ While it runs, `loki backlog` prints one line per state change (queued, running
413
413
 
414
414
  Before anything runs, `loki backlog` triages every issue into one of three classes, each printed with a one-line reason (`--dry-run` prints only this and launches nothing):
415
415
 
416
- - `implement`: a concrete target (a file, function, value or expected result), or a large issue. Only these run. Large has one definition, the same one `loki start owner/repo#N` uses: an epic label (`epic`, `umbrella`, `tracking` or `meta`), or at least two of 4 or more solution parts, 4 or more acceptance criteria, and both a backend and a frontend named. A large issue is split into slices that each run on their own (the reason says `runs split into slices`). Slices that do not depend on each other run at the same time (up to 4; `LOKI_EPIC_PARALLEL=1` runs them one at a time), and a slice that fails or reports a spec conflict skips only the slices built on it. The issue normally ends in one pull request, with one commit per slice. A slice that conflicts and cannot be resolved, with the slices built on it, opens its own pull request; a refused push or a combined diff over `LOKI_SPLIT_ONE_PR_MAX_FILES` files (default 150) opens one pull request per slice instead, and the summary row says how many and why (`LOKI_SPLIT_ONE_PR=0` always opens one per slice).
416
+ - `implement`: a concrete target (a file, function, value or expected result), or a large issue. Only these run. Large has one definition, the same one `loki start owner/repo#N` uses: an epic label (`epic`, `umbrella`, `tracking` or `meta`), or at least two of 4 or more solution parts, 4 or more acceptance criteria, and both a backend and a frontend named. A large issue runs as one whole-issue run on Sonnet and stronger models (the reason says `runs as one run`). On a run that implements on Haiku, and with `LOKI_ISSUE_WHOLE_FIRST=0`, it is split up front into slices that each run on their own (the reason then says `runs split into slices`). Slices that do not depend on each other run at the same time (up to 4; `LOKI_EPIC_PARALLEL=1` runs them one at a time), and a slice that fails or reports a spec conflict skips only the slices built on it. The issue normally ends in one pull request, with one commit per slice. A slice that conflicts and cannot be resolved, with the slices built on it, opens its own pull request; a refused push or a combined diff over `LOKI_SPLIT_ONE_PR_MAX_FILES` files (default 150) opens one pull request per slice instead, and the summary row says how many and why (`LOKI_SPLIT_ONE_PR=0` always opens one per slice).
417
417
  - `spec`: vague or ambiguous (no concrete target named, or an ambiguity score at the threshold). Loki drafts `.loki/specs/<slug>.md` with `loki plan --spec`, runs nothing, and prints `loki start --spec .loki/specs/<slug>.md` to run after you edit or approve it.
418
418
  - `human`: the issue touches secrets, production or a destructive operation. Never run headless; listed with the reason. Repos without tests, UI work and infra work still run: Loki writes its own tests and verifies once at the end.
419
419