loki-mode 7.5.7 → 7.5.9

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 (26) hide show
  1. package/README.md +14 -10
  2. package/SKILL.md +54 -11
  3. package/VERSION +1 -1
  4. package/autonomy/app-runner.sh +31 -5
  5. package/autonomy/run.sh +31 -9
  6. package/autonomy/sandbox.sh +13 -1
  7. package/dashboard/__init__.py +1 -1
  8. package/dashboard/server.py +32 -19
  9. package/docs/INSTALLATION.md +16 -10
  10. package/docs/architecture/ADR-001-runtime-migration.md +26 -4
  11. package/docs/architecture/STATE-MACHINES.md +57 -0
  12. package/loki-ts/dist/loki.js +148 -148
  13. package/mcp/__init__.py +1 -1
  14. package/mcp/server.py +38 -8
  15. package/package.json +2 -2
  16. package/references/core-workflow.md +4 -0
  17. package/references/deployment.md +6 -0
  18. package/references/memory-system.md +1 -1
  19. package/references/production-patterns.md +6 -0
  20. package/references/prompt-repetition.md +2 -2
  21. package/references/quality-control.md +6 -0
  22. package/skills/00-index.md +1 -1
  23. package/skills/agents.md +2 -2
  24. package/skills/healing.md +16 -0
  25. package/skills/providers.md +1 -1
  26. package/skills/quality-gates.md +18 -0
package/docs/architecture/STATE-MACHINES.md CHANGED
@@ -8,6 +8,63 @@ triggers and persistence, and source file references (file:line).
8
8
 
9
9
  ---
10
10
 
11
+ ## Verification status
12
+
13
+ **Last verified:** 2026-03-03 against v6.6.1 codebase (council-reviewed, merged via PR #49).
14
+
15
+ **Current codebase:** v7.5.7 (2026-04-29). This document has NOT been re-verified
16
+ end-to-end against v7.5.x. Treat shape/semantics as authoritative; treat line
17
+ numbers as approximate. See "Known drift" and "Known additions" sections below
18
+ before relying on any specific `file:line` reference.
19
+
20
+ This is a council-reviewed document. Per the audit guidance (2026-04-29), line
21
+ numbers are NOT being silently rewritten throughout. Drift is recorded here so
22
+ readers can spot-check before trusting a citation.
23
+
24
+ ### Known additions since last verify (v6.7.0 -> v7.5.7)
25
+
26
+ These components exist in v7.5.x but are NOT yet documented in the sections
27
+ below. They should be added when this doc is next re-verified end-to-end:
28
+
29
+ - **Phase 1 override council** (v7.5.x). Specialized council that fires when a
30
+ Phase 1 (archaeology / planning) gate would otherwise block, allowing a
31
+ reviewed override path. Belongs in section 7 (Quality Gates) or alongside
32
+ section 3 (Completion Council).
33
+ - **File-lock primitive** (`atomic.ts withFileLockSync`, v7.5.x). Atomic
34
+ filesystem coordination primitive used by the Bun runtime. Belongs in section
35
+ 1 (Master State File Index) -- documents the locking contract for all `.loki/`
36
+ state files.
37
+ - **Gate-failure escalation ladder** (v7.5.x). Multi-tier escalation when a
38
+ quality gate fails repeatedly. Belongs in section 7 (Quality Gates).
39
+
40
+ ### Known drift (line numbers, sampled 2026-04-29 against v7.5.7)
41
+
42
+ Sampled spot-checks against the live source. The function/file is correct in
43
+ every case below; only the line number drifted. Verify with `grep -n` before
44
+ citing.
45
+
46
+ | Section | Citation in doc | Actual location (v7.5.7) | Delta |
47
+ |---|---|---|---|
48
+ | 2.1 | `run.sh:7380` (`run_autonomous`) | `run.sh:10253` | +2873 |
49
+ | 2.2 | `run.sh:1325` (`get_rarv_tier`) | `run.sh:1484` | +159 |
50
+ | 2.4 | `run.sh:8059` / `run.sh:10419` (`check_human_intervention`) | `run.sh:11262` | +843 to +3203 |
51
+ | 3.1 | `completion-council.sh:1359` (`council_should_stop`) | `completion-council.sh:1605` | +246 |
52
+ | 13 | `run.sh:6464` (`create_checkpoint`) | `run.sh:6943` | +479 |
53
+ | 14 | `run.sh:1229` (`detect_complexity`) | `run.sh:1338` | +109 |
54
+
55
+ Drift trend: `autonomy/run.sh` and `autonomy/completion-council.sh` have grown
56
+ roughly 800-3000 lines per minor release. **For navigation, prefer `grep -n
57
+ '^<function_name>()'` over the line numbers below.** The function names and
58
+ file paths in this document remain authoritative.
59
+
60
+ Note: a meaningful share of orchestration logic now lives in the Bun runtime
61
+ under `loki-ts/src/` (Phases 4-5 of ADR-001). This document still describes the
62
+ bash route, which is the legacy fallback gated behind `LOKI_LEGACY_BASH=1`.
63
+ When Phase 6 ships (bash sunset), this document will need to be re-pointed at
64
+ the TypeScript implementation.
65
+
66
+ ---
67
+
11
68
  ## Table of Contents
12
69
 
13
70
  1. [Master State File Index](#1-master-state-file-index)