loki-mode 11.128.2 → 11.129.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.
- package/README.md +1 -0
- package/SKILL.md +3 -3
- package/VERSION +1 -1
- package/autonomy/lib/help-core.sh +30 -42
- package/autonomy/lib/workspace.py +292 -19
- package/autonomy/lib/workspace_comment.py +40 -11
- package/autonomy/loki +97 -159
- package/autonomy/route.sh +3 -2
- package/autonomy/trigger-server.py +373 -32
- package/bin/loki +77 -14
- package/completions/_loki +11 -142
- package/completions/loki.bash +4 -2
- package/dashboard/__init__.py +1 -1
- package/docs/CLI-CORE-VERBS.md +61 -37
- package/docs/CLI-INVENTORY.md +152 -153
- package/docs/CLI-REFERENCE.md +20 -166
- package/docs/DEPLOYMENT.md +38 -3
- package/docs/INSTALLATION.md +7 -1
- package/docs/KNOWN-ISSUES.md +1 -1
- package/docs/PROOF-PASSPORT.md +21 -0
- package/docs/WORKSPACES.md +27 -0
- package/docs/cost-controls.md +74 -12
- package/docs/dev/architecture-reference.md +2 -2
- package/docs/environment-variables.md +7 -0
- package/docs/merge-queue.md +44 -3
- package/docs/sentry-intake.md +1 -1
- package/docs/slack.md +1 -1
- package/docs/v10/GUIDE.md +22 -4
- package/loki-ts/dist/loki.js +1510 -1465
- package/mcp/__init__.py +1 -1
- package/memory/knowledge_graph.py +442 -56
- package/package.json +2 -2
- package/packages/control-plane/dist/server.js +1901 -1585
- package/plugins/loki-mode/.claude-plugin/plugin.json +1 -1
- package/schemas/loki-yaml.schema.json +1 -0
- package/web-app/dist/assets/{AdminPage-B-9a_urH.js → AdminPage-uxbsIyND.js} +1 -1
- package/web-app/dist/assets/{Avatar-DWFQPBje.js → Avatar-5GhUf4pP.js} +1 -1
- package/web-app/dist/assets/{Badge-CuLYjGKc.js → Badge-93rdLyl8.js} +1 -1
- package/web-app/dist/assets/{Button-Cws5TOeA.js → Button-C94f2_e6.js} +1 -1
- package/web-app/dist/assets/{CockpitPage-CCT1U0rq.js → CockpitPage-C8cDx1mp.js} +1 -1
- package/web-app/dist/assets/{ComparePage-ChcsGaeo.js → ComparePage-BU7VVcVf.js} +1 -1
- package/web-app/dist/assets/{ErrorBoundary-C5Mz6Y_d.js → ErrorBoundary-Bn81ZPkG.js} +1 -1
- package/web-app/dist/assets/{EvidenceReceiptPanel-jXRFyeG-.js → EvidenceReceiptPanel-CVqzhxXI.js} +1 -1
- package/web-app/dist/assets/{GitHubIssuesPanel-C_YjFJSB.js → GitHubIssuesPanel-i1Yjc0mH.js} +1 -1
- package/web-app/dist/assets/{GitHubPRsPanel-B3bRY_lb.js → GitHubPRsPanel-eoXw0hiw.js} +1 -1
- package/web-app/dist/assets/{HomePage-JLwBDYu8.js → HomePage-Cv_BXFF9.js} +2 -2
- package/web-app/dist/assets/{LoginPage-BcDvWJr1.js → LoginPage-CWYdAQSQ.js} +1 -1
- package/web-app/dist/assets/{MagicPage-Bj3qzygY.js → MagicPage-5r2ci7MS.js} +1 -1
- package/web-app/dist/assets/{MetricsPage-9k0NVtge.js → MetricsPage-C37jE1uR.js} +1 -1
- package/web-app/dist/assets/{NotFoundPage-D81Z_SCM.js → NotFoundPage-CuBrziZd.js} +1 -1
- package/web-app/dist/assets/{ProjectPage-D9CkJI0B.js → ProjectPage-59GLzJlR.js} +3 -3
- package/web-app/dist/assets/{ProjectsPage-vxSmYYzh.js → ProjectsPage-DgDtFRNm.js} +1 -1
- package/web-app/dist/assets/{SettingsPage-Cd2AS1Sg.js → SettingsPage-DjMSy-kZ.js} +1 -1
- package/web-app/dist/assets/{ShowcasePage-DOZCRLg5.js → ShowcasePage-DESkYmrG.js} +1 -1
- package/web-app/dist/assets/{SystemSettingsPage-wl2UO5DF.js → SystemSettingsPage-d5jFreyF.js} +1 -1
- package/web-app/dist/assets/{TeamsPage-CA9FPLPm.js → TeamsPage-BEVAkxj3.js} +1 -1
- package/web-app/dist/assets/{TemplatesPage-DLRTBM8i.js → TemplatesPage-DeK9wx22.js} +1 -1
- package/web-app/dist/assets/{TerminalOutput-RqmPEs4o.js → TerminalOutput-2vwck437.js} +1 -1
- package/web-app/dist/assets/{activity-CoyjHBZ4.js → activity-XgL1xWCM.js} +1 -1
- package/web-app/dist/assets/{bell-Dn2BCsQu.js → bell-EXDsjrzh.js} +1 -1
- package/web-app/dist/assets/{bot-CNqPuD8h.js → bot-B9I58zKH.js} +1 -1
- package/web-app/dist/assets/{check-BWAwFpe2.js → check-DgLUYM2x.js} +1 -1
- package/web-app/dist/assets/{chevron-left-BgTjvxLB.js → chevron-left-BhHLpt7K.js} +1 -1
- package/web-app/dist/assets/{circle-alert-CIYxFeDp.js → circle-alert-rgioMmC9.js} +1 -1
- package/web-app/dist/assets/{clock-Dj6DRvL7.js → clock-BO__fq1n.js} +1 -1
- package/web-app/dist/assets/{cloud-DZBvW6-f.js → cloud-iLJ3RtJs.js} +1 -1
- package/web-app/dist/assets/{code-xml-B0sAmzAO.js → code-xml-BFYU6YlU.js} +1 -1
- package/web-app/dist/assets/{database-BkO44OAR.js → database-CXDLeUh_.js} +1 -1
- package/web-app/dist/assets/{dollar-sign-ChTZgVxB.js → dollar-sign-C9Jbgo-O.js} +1 -1
- package/web-app/dist/assets/{file-code-corner-CQSIiG1T.js → file-code-corner-CNPi6dkK.js} +1 -1
- package/web-app/dist/assets/{file-plus-BAV2KC_M.js → file-plus-DAc0Sd1J.js} +1 -1
- package/web-app/dist/assets/{globe-TUNeqVA9.js → globe-DN0njo3S.js} +1 -1
- package/web-app/dist/assets/{hammer-CMD4wrup.js → hammer-CnpZO-SH.js} +1 -1
- package/web-app/dist/assets/{index-B5lRV-ZJ.js → index-BHwx0KjF.js} +3 -3
- package/web-app/dist/assets/{layers-BxXkAn6j.js → layers-_kP2XVgZ.js} +1 -1
- package/web-app/dist/assets/{loader-circle-CE46Yvcr.js → loader-circle-CcupfVc5.js} +1 -1
- package/web-app/dist/assets/{lock-3uBPp5eV.js → lock-D3I89F_A.js} +1 -1
- package/web-app/dist/assets/{package-DjPZ3DLs.js → package-BMz7_qR6.js} +1 -1
- package/web-app/dist/assets/{plus-D8v6ZCYM.js → plus-3rKyjjc7.js} +1 -1
- package/web-app/dist/assets/{refresh-cw-BSPJHBul.js → refresh-cw-DGI9P9uf.js} +1 -1
- package/web-app/dist/assets/{rotate-ccw-D0u6PH4j.js → rotate-ccw-CEIZqe5z.js} +1 -1
- package/web-app/dist/assets/{scroll-text-Dcwu9apa.js → scroll-text-CBQ5ISFk.js} +1 -1
- package/web-app/dist/assets/{server-pd5YWyJw.js → server-DOr9ns7A.js} +1 -1
- package/web-app/dist/assets/{shield-alert-C3TqM2Xm.js → shield-alert-pcQbbyMb.js} +1 -1
- package/web-app/dist/assets/{thumbs-up-U1Wkm_Rg.js → thumbs-up-Q7fwPWa9.js} +1 -1
- package/web-app/dist/assets/{trash-2-BspH7NSu.js → trash-2-D81689SS.js} +1 -1
- package/web-app/dist/assets/{trending-down-DNg_ybr3.js → trending-down-8b0O5hb9.js} +1 -1
- package/web-app/dist/assets/{trending-up-CYzIu-lq.js → trending-up-CD0tv_w5.js} +1 -1
- package/web-app/dist/assets/{upload-ChhyDeon.js → upload-CphI5Pe_.js} +1 -1
- package/web-app/dist/assets/{usePolling-ClMveR0q.js → usePolling-yhGOhxnY.js} +1 -1
- package/web-app/dist/assets/{user-BlFXAv0-.js → user-CXM61B6o.js} +1 -1
- package/web-app/dist/index.html +1 -1
package/docs/CLI-INVENTORY.md
CHANGED
|
@@ -2,166 +2,165 @@
|
|
|
2
2
|
|
|
3
3
|
Generated from `loki-ts/src/cli/registry.ts` by `bun loki-ts/scripts/gen-cli-modern-doc.ts`. Do not edit by hand; the registry guard fails when this file is stale.
|
|
4
4
|
|
|
5
|
-
Classes: KEEP
|
|
5
|
+
Classes: KEEP (the 11 commands in `loki --help` and completions), HIDE (keeps working, never shown: machine consumers, CI, dev and enterprise ops), FOLD (behavior moves into the command in the Replacement column; the old name stays a hidden alias that runs unchanged; the replacement may not exist yet), REMOVED (no dependent found; hidden now, exits 2 with the replacement once its removal slice lands).
|
|
6
6
|
|
|
7
7
|
## Counts
|
|
8
8
|
|
|
9
|
-
- KEEP
|
|
10
|
-
-
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
- Total rows:
|
|
9
|
+
- KEEP: 12
|
|
10
|
+
- HIDE: 41
|
|
11
|
+
- FOLD: 26
|
|
12
|
+
- REMOVED: 65
|
|
13
|
+
- Total rows: 144
|
|
14
14
|
- Registry paths (commands and nested subcommands): 215
|
|
15
15
|
|
|
16
16
|
## Commands
|
|
17
17
|
|
|
18
|
-
| Command | Where dispatched | Class | Reason |
|
|
19
|
-
| --- | --- | --- | --- |
|
|
20
|
-
| version | loki-ts/src/cli.ts |
|
|
21
|
-
| status | bun route, bash fallthrough |
|
|
22
|
-
| stats | loki-ts/src/cli.ts |
|
|
23
|
-
| doctor | bun route, bash fallthrough | KEEP
|
|
24
|
-
| provider | bun route, bash fallthrough |
|
|
25
|
-
| memory | bun route, bash fallthrough |
|
|
26
|
-
| rollback | bun route, bash fallthrough |
|
|
27
|
-
| backup | autonomy/loki |
|
|
28
|
-
| restore | autonomy/loki |
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
| wiki | bun route, bash fallthrough |
|
|
32
|
-
| control | bun route, bash fallthrough | KEEP
|
|
33
|
-
| runs | loki-ts/src/cli.ts |
|
|
34
|
-
| intent | loki-ts/src/cli.ts |
|
|
35
|
-
| kpis | loki-ts/src/cli.ts |
|
|
36
|
-
| report | bun route, bash fallthrough |
|
|
37
|
-
| trust | bun route, bash fallthrough |
|
|
38
|
-
| crash | bun route, bash fallthrough |
|
|
39
|
-
| contract | loki-ts/src/cli.ts |
|
|
40
|
-
| start | bun route, bash fallthrough |
|
|
41
|
-
| slack | loki-ts/src/cli.ts |
|
|
42
|
-
| queue | loki-ts/src/cli.ts |
|
|
43
|
-
| issues | loki-ts/src/cli.ts |
|
|
44
|
-
| undo | loki-ts/src/cli.ts | KEEP
|
|
45
|
-
| verify-pr | loki-ts/src/cli.ts |
|
|
46
|
-
| answer | loki-ts/src/cli.ts |
|
|
47
|
-
| engine10 | loki-ts/src/cli.ts |
|
|
48
|
-
| internal
|
|
49
|
-
| completion
|
|
50
|
-
| __complete
|
|
51
|
-
| help | autonomy/loki |
|
|
52
|
-
| chat | autonomy/loki | KEEP
|
|
53
|
-
| edit | autonomy/loki |
|
|
54
|
-
| diff | autonomy/loki |
|
|
55
|
-
| models | autonomy/loki |
|
|
56
|
-
| setup | autonomy/loki |
|
|
57
|
-
| quick | autonomy/loki |
|
|
58
|
-
| quickstart | autonomy/loki |
|
|
59
|
-
| init | autonomy/loki |
|
|
60
|
-
| template | autonomy/loki |
|
|
61
|
-
| verify | autonomy/loki |
|
|
62
|
-
| keys | autonomy/loki |
|
|
63
|
-
| review | autonomy/loki |
|
|
64
|
-
| dashboard | autonomy/loki |
|
|
65
|
-
| config | autonomy/loki |
|
|
66
|
-
| mcp | autonomy/loki |
|
|
67
|
-
| acp | autonomy/loki |
|
|
68
|
-
| stop | autonomy/loki | KEEP
|
|
69
|
-
| pause | bun route, bash fallthrough |
|
|
70
|
-
| resume | bun route, bash fallthrough |
|
|
71
|
-
| cancel | bun route, bash fallthrough |
|
|
72
|
-
| why | autonomy/loki |
|
|
73
|
-
| next | autonomy/loki |
|
|
74
|
-
| logs | autonomy/loki |
|
|
75
|
-
| ship | autonomy/loki |
|
|
76
|
-
| deploy | autonomy/loki | KEEP
|
|
77
|
-
| import | autonomy/loki |
|
|
78
|
-
| github | autonomy/loki |
|
|
79
|
-
| issue | autonomy/loki |
|
|
80
|
-
| ci | autonomy/loki |
|
|
81
|
-
| modernize | bun route, bash fallthrough |
|
|
82
|
-
| share | autonomy/loki |
|
|
83
|
-
| assets | autonomy/loki |
|
|
84
|
-
| export | autonomy/loki |
|
|
85
|
-
| notify | autonomy/loki |
|
|
86
|
-
| tour | autonomy/loki |
|
|
87
|
-
| wow | autonomy/loki |
|
|
88
|
-
| try | autonomy/loki |
|
|
89
|
-
| factory | autonomy/loki |
|
|
90
|
-
| welcome | autonomy/loki |
|
|
91
|
-
| onboard | autonomy/loki |
|
|
92
|
-
| setup-skill | autonomy/loki |
|
|
93
|
-
| self-update | autonomy/loki |
|
|
94
|
-
| self_update | autonomy/loki |
|
|
95
|
-
| update | autonomy/loki |
|
|
96
|
-
| remote | autonomy/loki |
|
|
97
|
-
| rc | autonomy/loki |
|
|
98
|
-
| cockpit | autonomy/loki |
|
|
99
|
-
| code | autonomy/loki |
|
|
100
|
-
| context | autonomy/loki |
|
|
101
|
-
| ctx | autonomy/loki |
|
|
102
|
-
| secrets | autonomy/loki |
|
|
103
|
-
| api | autonomy/loki |
|
|
104
|
-
| sandbox | autonomy/loki |
|
|
105
|
-
| docker | autonomy/loki |
|
|
106
|
-
| web | autonomy/loki |
|
|
107
|
-
| preview | autonomy/loki |
|
|
108
|
-
| telemetry | autonomy/loki |
|
|
109
|
-
| otel | autonomy/loki |
|
|
110
|
-
| syslog | autonomy/loki |
|
|
111
|
-
| explain | autonomy/loki |
|
|
112
|
-
| docs | autonomy/loki |
|
|
113
|
-
| test | autonomy/loki |
|
|
114
|
-
| bench | autonomy/loki |
|
|
115
|
-
| voice | autonomy/loki |
|
|
116
|
-
| own | autonomy/loki |
|
|
117
|
-
| handoff | autonomy/loki |
|
|
118
|
-
| secure | autonomy/loki |
|
|
119
|
-
| compliance | autonomy/loki |
|
|
120
|
-
| enterprise | autonomy/loki |
|
|
121
|
-
| projects | autonomy/loki |
|
|
122
|
-
| audit | autonomy/loki |
|
|
123
|
-
| cost | autonomy/loki |
|
|
124
|
-
| metrics | autonomy/loki |
|
|
125
|
-
| sentrux | autonomy/loki |
|
|
126
|
-
| magic | autonomy/loki |
|
|
127
|
-
| estimate | autonomy/loki |
|
|
128
|
-
| plan | autonomy/loki |
|
|
129
|
-
| grill | autonomy/loki |
|
|
130
|
-
| spec | autonomy/loki |
|
|
131
|
-
|
|
|
132
|
-
|
|
|
133
|
-
|
|
|
134
|
-
|
|
|
135
|
-
|
|
|
136
|
-
|
|
|
137
|
-
|
|
|
138
|
-
|
|
|
139
|
-
|
|
|
140
|
-
|
|
|
141
|
-
|
|
|
142
|
-
|
|
|
143
|
-
|
|
|
144
|
-
|
|
|
145
|
-
|
|
|
146
|
-
|
|
|
147
|
-
|
|
|
148
|
-
|
|
|
149
|
-
|
|
|
150
|
-
|
|
|
151
|
-
|
|
|
152
|
-
|
|
|
153
|
-
|
|
|
154
|
-
|
|
|
155
|
-
|
|
|
156
|
-
|
|
|
157
|
-
|
|
|
158
|
-
|
|
|
159
|
-
|
|
|
160
|
-
|
|
|
161
|
-
|
|
|
162
|
-
|
|
|
163
|
-
|
|
|
164
|
-
| open | autonomy/loki | DELETE | Alias; use dashboard open |
|
|
18
|
+
| Command | Where dispatched | Class | Reason | Replacement |
|
|
19
|
+
| --- | --- | --- | --- | --- |
|
|
20
|
+
| version | loki-ts/src/cli.ts | HIDE | Bun-native, no legacy dependency | |
|
|
21
|
+
| status | bun route, bash fallthrough | KEEP | Reads both engines; fold legacy fields into the v10 view | |
|
|
22
|
+
| stats | loki-ts/src/cli.ts | HIDE | Deprecated alias; use report session | |
|
|
23
|
+
| doctor | bun route, bash fallthrough | KEEP | Core onboarding gate | |
|
|
24
|
+
| provider | bun route, bash fallthrough | FOLD | Provider-agnostic core | loki config set provider NAME |
|
|
25
|
+
| memory | bun route, bash fallthrough | HIDE | Memory still carries legacy store paths | |
|
|
26
|
+
| rollback | bun route, bash fallthrough | FOLD | Checkpoint restore is engine-neutral | loki undo <run> |
|
|
27
|
+
| backup | autonomy/loki | HIDE | Enterprise retention and backup (D99 item 7) | |
|
|
28
|
+
| restore | autonomy/loki | HIDE | Enterprise retention and backup (D99 item 7) | |
|
|
29
|
+
| receipt | bun route, bash fallthrough | KEEP | The Evidence Receipt | |
|
|
30
|
+
| proof | bun route, bash fallthrough | KEEP | Alias of receipt | |
|
|
31
|
+
| wiki | bun route, bash fallthrough | REMOVED | Bun-native knowledge feature | Use: loki chat |
|
|
32
|
+
| control | bun route, bash fallthrough | KEEP | D56 control plane, on by default | |
|
|
33
|
+
| runs | loki-ts/src/cli.ts | REMOVED | R100-008: one list over the loki projects registry | Use: loki status (this repo) or loki control serve (all projects) |
|
|
34
|
+
| intent | loki-ts/src/cli.ts | REMOVED | Read-only intent view | Use: loki status <run> |
|
|
35
|
+
| kpis | loki-ts/src/cli.ts | HIDE | Bun-native KPI report | |
|
|
36
|
+
| report | bun route, bash fallthrough | HIDE | Mixed route; only kpis is Bun | |
|
|
37
|
+
| trust | bun route, bash fallthrough | FOLD | Trust trajectory surface | loki status --json |
|
|
38
|
+
| crash | bun route, bash fallthrough | HIDE | Local-only crash plumbing | |
|
|
39
|
+
| contract | loki-ts/src/cli.ts | HIDE | v10 delivery contract | |
|
|
40
|
+
| start | bun route, bash fallthrough | KEEP | One engine (engine10); flags still legacy-shaped | |
|
|
41
|
+
| slack | loki-ts/src/cli.ts | HIDE | Bun-native integration | |
|
|
42
|
+
| queue | loki-ts/src/cli.ts | FOLD | Governor-aware batch of issue-mode runs | loki start owner/repo#1 owner/repo#2 |
|
|
43
|
+
| issues | loki-ts/src/cli.ts | FOLD | Mass issue pickup on the T7 queue | loki start owner/repo --label L --limit N --parallel K |
|
|
44
|
+
| undo | loki-ts/src/cli.ts | KEEP | UNDO-1/2: --plan is read-only, apply behind LOKI_UNDO=1 | |
|
|
45
|
+
| verify-pr | loki-ts/src/cli.ts | FOLD | VPR-2: fail-to-pass check, LOKI_VERIFY_PR=1 | loki verify <PR url> |
|
|
46
|
+
| answer | loki-ts/src/cli.ts | FOLD | v10 blocked-run flow | loki start --answer "<text>" |
|
|
47
|
+
| engine10 | loki-ts/src/cli.ts | HIDE | The v10 engine | |
|
|
48
|
+
| internal | loki-ts/src/cli.ts | HIDE | Hidden plumbing | |
|
|
49
|
+
| completion | loki-ts/src/cli.ts | HIDE | Hidden plumbing; completions install themselves | |
|
|
50
|
+
| __complete | loki-ts/src/cli.ts | HIDE | Hidden plumbing for generated completions | |
|
|
51
|
+
| help | autonomy/loki | HIDE | Core | |
|
|
52
|
+
| chat | autonomy/loki | KEEP | Provider-neutral conversational verb | |
|
|
53
|
+
| edit | autonomy/loki | FOLD | Provider-neutral single-edit verb | loki "<change>" --no-pr |
|
|
54
|
+
| diff | autonomy/loki | REMOVED | Passes extra args to git diff | Use: loki status <run> |
|
|
55
|
+
| models | autonomy/loki | FOLD | Provider-neutral model tiers | loki config list |
|
|
56
|
+
| setup | autonomy/loki | FOLD | Onboarding gate | loki doctor --fix |
|
|
57
|
+
| quick | autonomy/loki | FOLD | Routes to the v10 lean path by default | loki "<task>" --no-pr |
|
|
58
|
+
| quickstart | autonomy/loki | FOLD | Onboarding path | loki "<idea>" in an empty folder |
|
|
59
|
+
| init | autonomy/loki | REMOVED | Templates predate v10 | Use: loki "<idea>" in an empty folder |
|
|
60
|
+
| template | autonomy/loki | REMOVED | Engine-neutral | Use: loki start "<one-line goal>" |
|
|
61
|
+
| verify | autonomy/loki | KEEP | Legacy proof vs v10 verify split | |
|
|
62
|
+
| keys | autonomy/loki | FOLD | Receipt signing | loki receipt key |
|
|
63
|
+
| review | autonomy/loki | HIDE | Gates are legacy-shaped | |
|
|
64
|
+
| dashboard | autonomy/loki | FOLD | Overlaps Control Plane | loki control serve |
|
|
65
|
+
| config | autonomy/loki | KEEP | Mixed legacy keys | |
|
|
66
|
+
| mcp | autonomy/loki | HIDE | Engine-neutral | |
|
|
67
|
+
| acp | autonomy/loki | HIDE | Engine-neutral | |
|
|
68
|
+
| stop | autonomy/loki | KEEP | Session control | |
|
|
69
|
+
| pause | bun route, bash fallthrough | REMOVED | Session control; Bun writes the Loki 10 run request, bash keeps the legacy PAUSE file | Use: loki stop --graceful |
|
|
70
|
+
| resume | bun route, bash fallthrough | FOLD | Session control; Bun clears a Loki 10 pause, bash keeps the legacy resume | loki start |
|
|
71
|
+
| cancel | bun route, bash fallthrough | REMOVED | Session control; Loki 10 only | Use: loki stop --graceful |
|
|
72
|
+
| why | autonomy/loki | FOLD | Outcome explainer | loki status |
|
|
73
|
+
| next | autonomy/loki | REMOVED | Guided flow | Use: loki status |
|
|
74
|
+
| logs | autonomy/loki | REMOVED | Engine-neutral | Use: loki status |
|
|
75
|
+
| ship | autonomy/loki | REMOVED | Delivery | Use: loki deploy |
|
|
76
|
+
| deploy | autonomy/loki | KEEP | Delivery | |
|
|
77
|
+
| import | autonomy/loki | REMOVED | Spec intake | Use: loki start <ref or file> |
|
|
78
|
+
| github | autonomy/loki | HIDE | Integration | |
|
|
79
|
+
| issue | autonomy/loki | REMOVED | Issue-mode | Use: loki start owner/repo#N |
|
|
80
|
+
| ci | autonomy/loki | HIDE | Engine-neutral | |
|
|
81
|
+
| modernize | bun route, bash fallthrough | HIDE | Routed to engine10 modernize | |
|
|
82
|
+
| share | autonomy/loki | REMOVED | Engine-neutral | Use: loki receipt share |
|
|
83
|
+
| assets | autonomy/loki | REMOVED | Engine-neutral | Use: loki chat |
|
|
84
|
+
| export | autonomy/loki | REMOVED | Duplicates report export | Use: loki verify <run> --sarif or loki status --json |
|
|
85
|
+
| notify | autonomy/loki | REMOVED | Engine-neutral | Use: loki status |
|
|
86
|
+
| tour | autonomy/loki | FOLD | Onboarding | loki start outside a repo |
|
|
87
|
+
| wow | autonomy/loki | FOLD | Onboarding: loki tour --live | loki start outside a repo |
|
|
88
|
+
| try | autonomy/loki | REMOVED | Onboarding: never touches your checkout | Use: loki start <repo url> --no-pr from a fresh clone |
|
|
89
|
+
| factory | autonomy/loki | FOLD | propose, execute, operate unchanged | loki start -v |
|
|
90
|
+
| welcome | autonomy/loki | REMOVED | Onboarding | Use: loki doctor |
|
|
91
|
+
| onboard | autonomy/loki | REMOVED | Overlaps wiki | Use: loki chat |
|
|
92
|
+
| setup-skill | autonomy/loki | REMOVED | Setup | Use: loki doctor --fix |
|
|
93
|
+
| self-update | autonomy/loki | HIDE | Maintenance | |
|
|
94
|
+
| self_update | autonomy/loki | HIDE | Alias of self-update | |
|
|
95
|
+
| update | autonomy/loki | HIDE | Alias of self-update | |
|
|
96
|
+
| remote | autonomy/loki | REMOVED | Engine-neutral | Use: loki status |
|
|
97
|
+
| rc | autonomy/loki | REMOVED | Alias of remote | |
|
|
98
|
+
| cockpit | autonomy/loki | REMOVED | Engine-neutral | Use: loki control serve |
|
|
99
|
+
| code | autonomy/loki | REMOVED | Overlaps wiki | Use: loki chat |
|
|
100
|
+
| context | autonomy/loki | REMOVED | Engine-neutral | Use: loki chat |
|
|
101
|
+
| ctx | autonomy/loki | REMOVED | Alias of context | |
|
|
102
|
+
| secrets | autonomy/loki | HIDE | Security | |
|
|
103
|
+
| api | autonomy/loki | REMOVED | Engine-neutral | Use: loki control serve |
|
|
104
|
+
| sandbox | autonomy/loki | HIDE | Isolation | |
|
|
105
|
+
| docker | autonomy/loki | HIDE | Isolation | |
|
|
106
|
+
| web | autonomy/loki | HIDE | Overlaps Control Plane UI | |
|
|
107
|
+
| preview | autonomy/loki | REMOVED | Delivery | Use: loki deploy |
|
|
108
|
+
| telemetry | autonomy/loki | REMOVED | Privacy surface | Use: loki config set telemetry off |
|
|
109
|
+
| otel | autonomy/loki | REMOVED | Alias of telemetry | |
|
|
110
|
+
| syslog | autonomy/loki | HIDE | Legacy log paths | |
|
|
111
|
+
| explain | autonomy/loki | REMOVED | Knowledge | Use: loki chat |
|
|
112
|
+
| docs | autonomy/loki | FOLD | Core | loki help |
|
|
113
|
+
| test | autonomy/loki | HIDE | Legacy runner | |
|
|
114
|
+
| bench | autonomy/loki | HIDE | Engine-neutral | |
|
|
115
|
+
| voice | autonomy/loki | REMOVED | Experimental | Use: loki start |
|
|
116
|
+
| own | autonomy/loki | REMOVED | Legacy handoff | Use: loki chat |
|
|
117
|
+
| handoff | autonomy/loki | REMOVED | Alias of own | |
|
|
118
|
+
| secure | autonomy/loki | REMOVED | Security | Use: loki doctor |
|
|
119
|
+
| compliance | autonomy/loki | HIDE | Enterprise | |
|
|
120
|
+
| enterprise | autonomy/loki | HIDE | Enterprise | |
|
|
121
|
+
| projects | autonomy/loki | REMOVED | Engine-neutral | Use: loki control serve |
|
|
122
|
+
| audit | autonomy/loki | HIDE | Enterprise | |
|
|
123
|
+
| cost | autonomy/loki | REMOVED | Duplicates report cost | Use: loki start --dry-run (before) and loki status <run> (after) |
|
|
124
|
+
| metrics | autonomy/loki | HIDE | Duplicates report metrics | |
|
|
125
|
+
| sentrux | autonomy/loki | REMOVED | Legacy gate input | Use: loki start |
|
|
126
|
+
| magic | autonomy/loki | HIDE | Legacy UI generator | |
|
|
127
|
+
| estimate | autonomy/loki | FOLD | Estimates the legacy PRD flow | loki start <PRD> --dry-run |
|
|
128
|
+
| plan | autonomy/loki | FOLD | Legacy PRD flow | loki start <PRD> --dry-run |
|
|
129
|
+
| grill | autonomy/loki | REMOVED | Legacy PRD flow | Loki 10 checks the spec itself; run: loki start <PRD> --dry-run |
|
|
130
|
+
| spec | autonomy/loki | REMOVED | Legacy PRD flow | Loki 10 checks the spec itself; run: loki start <PRD> --dry-run |
|
|
131
|
+
| backlog | autonomy/loki | FOLD | Drives legacy RARV per issue | loki start owner/repo --label L --parallel K |
|
|
132
|
+
| workspace | autonomy/loki | HIDE | Control Plane spawns workspace run; users get it via start --workspace | |
|
|
133
|
+
| council | autonomy/loki | REMOVED | Legacy RARV gate | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
134
|
+
| compound | autonomy/loki | REMOVED | Legacy memory pipeline | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
135
|
+
| cluster | autonomy/loki | REMOVED | Legacy RARV | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
136
|
+
| optimize | autonomy/loki | REMOVED | Legacy RARV | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
137
|
+
| ultracode | autonomy/loki | REMOVED | Legacy Claude-only | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
138
|
+
| monitor | autonomy/loki | REMOVED | Legacy engine state | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
139
|
+
| watch | autonomy/loki | REMOVED | PRD flow | Rerun with: loki start <PRD> |
|
|
140
|
+
| watchdog | autonomy/loki | REMOVED | Legacy engine | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
141
|
+
| cleanup | autonomy/loki | REMOVED | Legacy run.sh orphans | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
142
|
+
| state | autonomy/loki | REMOVED | Legacy engine | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
143
|
+
| agent | autonomy/loki | REMOVED | Legacy engine | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
144
|
+
| agents | autonomy/loki | HIDE | Custom child agents are still read by reviewers | |
|
|
145
|
+
| trigger | autonomy/loki | HIDE | Event automation server (FR03 extends it) | |
|
|
146
|
+
| failover | autonomy/loki | REMOVED | Legacy engine | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
147
|
+
| reset | autonomy/loki | REMOVED | Legacy engine | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
148
|
+
| merge | autonomy/loki | HIDE | Control Plane merge list and run | |
|
|
149
|
+
| heal | autonomy/loki | HIDE | Referenced by docs; no engine10 consumer verified | |
|
|
150
|
+
| migrate | autonomy/loki | REMOVED | Superseded by modernize | Use: loki "modernize <what> to <target>" |
|
|
151
|
+
| dogfood | autonomy/loki | REMOVED | Legacy engine | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
152
|
+
| steer | autonomy/loki | FOLD | Session control | loki chat --attach |
|
|
153
|
+
| outcomes | autonomy/loki | REMOVED | Legacy outcome store | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
154
|
+
| worktree | autonomy/loki | REMOVED | Legacy parallel mode | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
155
|
+
| wt | autonomy/loki | REMOVED | Alias of worktree | |
|
|
156
|
+
| checkpoint | autonomy/loki | REMOVED | Legacy engine | Use: loki undo |
|
|
157
|
+
| cp | autonomy/loki | REMOVED | Alias of checkpoint | |
|
|
158
|
+
| analyze | autonomy/loki | REMOVED | Legacy analyze flow | It drove the removed legacy loop; use: loki start "<goal>" |
|
|
159
|
+
| demo | autonomy/loki | FOLD | Legacy engine demo | loki start outside a repo |
|
|
160
|
+
| run | autonomy/loki | FOLD | Alias; use start | loki start |
|
|
161
|
+
| trust-metrics | autonomy/loki | REMOVED | Alias; use trust detail | Use: loki status --json |
|
|
162
|
+
| serve | autonomy/loki | REMOVED | Alias; use api start | Use: loki control serve |
|
|
163
|
+
| open | autonomy/loki | REMOVED | Alias; use dashboard open | Use: loki control serve |
|
|
165
164
|
|
|
166
165
|
## Registry gaps (nested paths dispatched but not yet in the registry)
|
|
167
166
|
|
package/docs/CLI-REFERENCE.md
CHANGED
|
@@ -1,119 +1,26 @@
|
|
|
1
1
|
# CLI reference
|
|
2
2
|
|
|
3
|
-
Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.
|
|
3
|
+
Generated from `loki-ts/src/cli/registry.ts` by `scripts/generate-stale-zero.sh` for v11.129.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 |
|
|
7
7
|
| --- | --- |
|
|
8
|
-
| `loki version` | Show version |
|
|
9
|
-
| `loki status` | Show current run status, and what the next loki start will do with an interrupted run |
|
|
10
|
-
| `loki doctor` | System prerequisites health check; --json, --fix, --requirements, --repo (repo profile with a 0-100 readiness score and fixes) |
|
|
11
|
-
| `loki provider` | Show, list or set the AI provider |
|
|
12
|
-
| `loki provider show` | Show current provider |
|
|
13
|
-
| `loki provider list` | List providers and install status |
|
|
14
|
-
| `loki provider set` | Switch the active provider |
|
|
15
|
-
| `loki provider info` | Provider details; --json prints the capability contract |
|
|
16
|
-
| `loki provider matrix` | Capability matrix per provider and engine |
|
|
17
|
-
| `loki memory` | Cross-project learnings |
|
|
18
|
-
| `loki memory list` | All learnings |
|
|
19
|
-
| `loki memory index` | Show or rebuild the memory index |
|
|
20
|
-
| `loki memory learn` | Learn lessons from a merged PR's review comments |
|
|
21
|
-
| `loki memory lessons` | List PR review lessons with uses and outcomes |
|
|
22
|
-
| `loki memory brief` | Print the lessons and learnings block an engine10 run injects |
|
|
23
|
-
| `loki memory show` | Show one learning |
|
|
24
|
-
| `loki memory search` | Search learnings |
|
|
25
|
-
| `loki memory stats` | Memory statistics |
|
|
26
|
-
| `loki memory consolidate` | Episodic-to-semantic pipeline |
|
|
27
|
-
| `loki memory compound` | Compound learnings |
|
|
28
|
-
| `loki rollback` | Restore .loki/ state from a checkpoint |
|
|
29
|
-
| `loki rollback list` | List checkpoints |
|
|
30
|
-
| `loki rollback show` | Show a checkpoint |
|
|
31
|
-
| `loki rollback to` | Restore a checkpoint |
|
|
32
|
-
| `loki rollback latest` | Restore the latest checkpoint |
|
|
33
|
-
| `loki rollback deploy` | Print the provider rollback command for the last deploy (read-only) |
|
|
34
|
-
| `loki backup` | Back up dashboard state (audit log, checkpoint) with a sha256 manifest |
|
|
35
|
-
| `loki restore` | Restore dashboard state from a verified backup archive |
|
|
36
|
-
| `loki proof` (alias: `receipt`) | Inspect and share proof-of-run receipts |
|
|
37
|
-
| `loki proof list` | List receipts |
|
|
38
|
-
| `loki proof show` | Show a receipt |
|
|
39
|
-
| `loki proof open` | Open a receipt |
|
|
40
|
-
| `loki proof share` | Share a receipt |
|
|
41
|
-
| `loki proof badge` | Print the Verified by Loki badge |
|
|
42
|
-
| `loki proof md` | Print badge markdown for a README |
|
|
43
|
-
| `loki proof bundle` | Write a self-verifying receipt bundle |
|
|
44
|
-
| `loki wiki` | Cited codebase wiki and Q&A |
|
|
45
|
-
| `loki wiki generate` | Generate the wiki |
|
|
46
|
-
| `loki wiki show` | Show a section |
|
|
47
|
-
| `loki wiki ask` | Ask a question |
|
|
48
|
-
| `loki control` | Control Plane (serve, backfill, prune, stop, status) |
|
|
49
|
-
| `loki control serve` | Run the control plane and UI |
|
|
50
|
-
| `loki control backfill` | Ship DIR/.loki/runs to the control plane |
|
|
51
|
-
| `loki control prune` | Delete matching runs |
|
|
52
|
-
| `loki control stop` | Stop the running control plane |
|
|
53
|
-
| `loki control status` | Show control plane reachability |
|
|
54
|
-
| `loki runs` | List runs across registered projects |
|
|
55
|
-
| `loki intent` | Show a past run's intent card |
|
|
56
|
-
| `loki intent show` | Print the intent card and answer |
|
|
57
|
-
| `loki kpis` | KPI snapshot (alias of report kpis) |
|
|
58
|
-
| `loki report` | Reporting: kpis, session, metrics, cost, export, share, dogfood, release-notes |
|
|
59
|
-
| `loki report kpis` | Canonical KPI snapshot |
|
|
60
|
-
| `loki report session` | Session report |
|
|
61
|
-
| `loki report metrics` | Metrics report |
|
|
62
|
-
| `loki report cost` | Cost report |
|
|
63
|
-
| `loki report export` | Export session |
|
|
64
|
-
| `loki report share` | Share a report |
|
|
65
|
-
| `loki report dogfood` | Dogfood report |
|
|
66
|
-
| `loki report release-notes` | Changes in a <from>..<to> range |
|
|
67
|
-
| `loki trust` | Trust trajectory from proof history |
|
|
68
|
-
| `loki trust detail` | Trust metrics detail |
|
|
69
|
-
| `loki crash` | Inspect or submit scrubbed crash reports |
|
|
70
|
-
| `loki crash list` | List stored crash reports |
|
|
71
|
-
| `loki crash show` | Show one scrubbed crash report |
|
|
72
|
-
| `loki crash submit` | Submit a scrubbed crash report |
|
|
73
|
-
| `loki crash help` | Show crash usage |
|
|
74
|
-
| `loki contract` | Print the spec delivery contract |
|
|
75
8
|
| `loki start` | Run the autonomous build (a `jira:KEY` or `linear:KEY` ref also writes the outcome back to that ticket, see docs/trackers.md); an interrupted or cancelled run is offered for resume or a fresh start, and --fresh skips the offer |
|
|
76
|
-
| `loki slack` | Slack inbound handler |
|
|
77
|
-
| `loki slack serve` | Serve the Slack handler |
|
|
78
|
-
| `loki queue` | Overnight issue queue with a morning digest |
|
|
79
|
-
| `loki queue add` | Queue issue refs |
|
|
80
|
-
| `loki queue list` | Show the queue |
|
|
81
|
-
| `loki queue remove` | Take issue refs out of the queue |
|
|
82
|
-
| `loki queue clear` | Empty the queue |
|
|
83
|
-
| `loki queue run` | Process the queue |
|
|
84
|
-
| `loki issues` | Run every open issue in a repo and open PRs |
|
|
85
|
-
| `loki issues run` | Triage and run open issues; split too-large ones into stacked PRs |
|
|
86
|
-
| `loki undo` | Plan or apply an undo of a run |
|
|
87
|
-
| `loki verify-pr` | Verify a PR against its linked issue in a sandbox |
|
|
88
|
-
| `loki verify-pr respond` | Fix open review comments on the PR branch, one commit each, reply with the sha |
|
|
89
|
-
| `loki answer` | Answer a BLOCKED run; it continues under the same run id |
|
|
90
|
-
| `loki engine10` | v10 engine router |
|
|
91
|
-
| `loki engine10 run` | Run the v10 engine |
|
|
92
|
-
| `loki engine10 status` | v10 status |
|
|
93
|
-
| `loki engine10 verify` | v10 verify |
|
|
94
|
-
| `loki engine10 keys` | v10 keys |
|
|
95
|
-
| `loki engine10 dashboard` | v10 dashboard |
|
|
96
|
-
| `loki engine10 modernize` | v10 modernize |
|
|
97
|
-
| `loki help` | Show help |
|
|
98
9
|
| `loki chat` | Interactive chat with the active provider |
|
|
99
|
-
| `loki
|
|
100
|
-
| `loki diff` | Show what the last run changed |
|
|
101
|
-
| `loki models` | Show per-provider model routes |
|
|
102
|
-
| `loki setup` | Guided first-run setup wizard |
|
|
103
|
-
| `loki quick` | One small task |
|
|
104
|
-
| `loki quickstart` | Guided first build |
|
|
105
|
-
| `loki init` | Scaffold from a template |
|
|
106
|
-
| `loki template` | Manage PRD templates |
|
|
10
|
+
| `loki status` | Show current run status, and what the next loki start will do with an interrupted run |
|
|
107
11
|
| `loki verify` | Deterministic PR verification |
|
|
108
|
-
| `loki
|
|
109
|
-
| `loki
|
|
110
|
-
| `loki
|
|
111
|
-
| `loki
|
|
112
|
-
| `loki
|
|
113
|
-
| `loki
|
|
114
|
-
| `loki
|
|
115
|
-
| `loki
|
|
116
|
-
| `loki
|
|
12
|
+
| `loki receipt` (alias: `proof`) | Inspect and share proof-of-run receipts |
|
|
13
|
+
| `loki receipt list` | List receipts |
|
|
14
|
+
| `loki receipt show` | Show a receipt |
|
|
15
|
+
| `loki receipt open` | Open a receipt |
|
|
16
|
+
| `loki receipt share` | Share a receipt |
|
|
17
|
+
| `loki receipt badge` | Print the Verified by Loki badge |
|
|
18
|
+
| `loki receipt md` | Print badge markdown for a README |
|
|
19
|
+
| `loki receipt bundle` | Write a self-verifying receipt bundle |
|
|
20
|
+
| `loki stop` | Stop execution immediately |
|
|
21
|
+
| `loki undo` | Plan or apply an undo of a run |
|
|
22
|
+
| `loki deploy` | Deploy the built product |
|
|
23
|
+
| `loki doctor` | System prerequisites health check; --json, --fix, --requirements, --repo (repo profile with a 0-100 readiness score and fixes) |
|
|
117
24
|
| `loki config` | Manage configuration |
|
|
118
25
|
| `loki config show` | Show config |
|
|
119
26
|
| `loki config list` | List config (alias of show) |
|
|
@@ -122,62 +29,9 @@ Hidden and legacy-only commands are omitted; see `docs/CLI-INVENTORY.md` for the
|
|
|
122
29
|
| `loki config path` | Print config path |
|
|
123
30
|
| `loki config set` | Set a value |
|
|
124
31
|
| `loki config get` | Get a value |
|
|
125
|
-
| `loki
|
|
126
|
-
| `loki
|
|
127
|
-
| `loki
|
|
128
|
-
| `loki
|
|
129
|
-
| `loki
|
|
130
|
-
| `loki
|
|
131
|
-
| `loki cancel` | Cancel the active Loki 10 run at the next stage boundary |
|
|
132
|
-
| `loki why` | Explain how the last run ended |
|
|
133
|
-
| `loki next` | Run the right next step |
|
|
134
|
-
| `loki logs` | Tail recent log output |
|
|
135
|
-
| `loki ship` | Ship the verified result |
|
|
136
|
-
| `loki deploy` | Deploy the built product |
|
|
137
|
-
| `loki import` | Import issues or specs |
|
|
138
|
-
| `loki github` | GitHub integration |
|
|
139
|
-
| `loki issue` | Work an issue |
|
|
140
|
-
| `loki ci` | CI helpers |
|
|
141
|
-
| `loki modernize` | Code modernization |
|
|
142
|
-
| `loki share` | Share a run |
|
|
143
|
-
| `loki assets` | Export team assets |
|
|
144
|
-
| `loki assets export` | Export shareable assets |
|
|
145
|
-
| `loki export` | Export session data |
|
|
146
|
-
| `loki notify` | Notifications |
|
|
147
|
-
| `loki notify desktop` | Send a desktop notification (macOS or Linux notify-send) |
|
|
148
|
-
| `loki tour` | See a sample result |
|
|
149
|
-
| `loki wow` | Tiny real task, or the offline sample |
|
|
150
|
-
| `loki try` | Try Loki on a public repo in a temp clone, keep only the receipt |
|
|
151
|
-
| `loki factory` | loki start with the autonomy policy printed |
|
|
152
|
-
| `loki welcome` | First-run opener |
|
|
153
|
-
| `loki onboard` | Onboard to a codebase |
|
|
154
|
-
| `loki setup-skill` | Install the skill symlinks |
|
|
155
|
-
| `loki self-update` (alias: `self_update`, `update`) | Update Loki |
|
|
156
|
-
| `loki remote` (alias: `rc`) | Remote session |
|
|
157
|
-
| `loki cockpit` | Live multi-repo cockpit |
|
|
158
|
-
| `loki code` | Code intelligence |
|
|
159
|
-
| `loki context` (alias: `ctx`) | Cross-project context |
|
|
160
|
-
| `loki secrets` | Secrets handling |
|
|
161
|
-
| `loki api` | Dashboard HTTP API |
|
|
162
|
-
| `loki sandbox` | Docker sandbox |
|
|
163
|
-
| `loki docker` | Docker helpers |
|
|
164
|
-
| `loki web` | Web UI |
|
|
165
|
-
| `loki preview` | Preview the built app |
|
|
166
|
-
| `loki telemetry` (alias: `otel`) | Telemetry controls |
|
|
167
|
-
| `loki syslog` | System log forwarding |
|
|
168
|
-
| `loki explain` | Explain code |
|
|
169
|
-
| `loki docs` | Open docs |
|
|
170
|
-
| `loki test` | Run project tests |
|
|
171
|
-
| `loki bench` | Benchmarks |
|
|
172
|
-
| `loki voice` | Voice input |
|
|
173
|
-
| `loki own` (alias: `handoff`) | Hand off ownership |
|
|
174
|
-
| `loki secure` | Security scan |
|
|
175
|
-
| `loki compliance` | Compliance reports |
|
|
176
|
-
| `loki enterprise` | Enterprise features |
|
|
177
|
-
| `loki projects` | Project registry |
|
|
178
|
-
| `loki audit` | Audit log |
|
|
179
|
-
| `loki cost` | Cost report |
|
|
180
|
-
| `loki metrics` | Metrics |
|
|
181
|
-
| `loki sentrux` | Architecture sensor |
|
|
182
|
-
| `loki magic` | Magic modules |
|
|
183
|
-
| `loki steer` | Nudge a running build |
|
|
32
|
+
| `loki control` | Control Plane (serve, backfill, prune, stop, status) |
|
|
33
|
+
| `loki control serve` | Run the control plane and UI |
|
|
34
|
+
| `loki control backfill` | Ship DIR/.loki/runs to the control plane |
|
|
35
|
+
| `loki control prune` | Delete matching runs |
|
|
36
|
+
| `loki control stop` | Stop the running control plane |
|
|
37
|
+
| `loki control status` | Show control plane reachability |
|
package/docs/DEPLOYMENT.md
CHANGED
|
@@ -107,21 +107,24 @@ In the repository: **Settings -> Webhooks -> Add webhook**.
|
|
|
107
107
|
Now the part that decides what your deployment costs. Tick:
|
|
108
108
|
|
|
109
109
|
- **Issues** -- an issue being opened starts a build.
|
|
110
|
-
- **Workflow runs** -- a failed CI run starts a repair build.
|
|
110
|
+
- **Workflow runs** -- a failed CI run on the default branch starts a repair build.
|
|
111
|
+
- **Pull request reviews** -- a "changes requested" review from an owner, member or
|
|
112
|
+
collaborator runs `loki verify-pr respond` on the PR (optional).
|
|
111
113
|
|
|
112
114
|
Leave **Pull requests** unticked unless you have decided you want it. See
|
|
113
115
|
below.
|
|
114
116
|
|
|
115
117
|
### 4. What actually fires
|
|
116
118
|
|
|
117
|
-
Only these
|
|
119
|
+
Only these combinations do anything. Every other event and action is
|
|
118
120
|
logged and ignored.
|
|
119
121
|
|
|
120
122
|
| Event | Action | What runs |
|
|
121
123
|
|---|---|---|
|
|
122
124
|
| `issues` | `opened` | `loki start owner/repo#N --pr` |
|
|
123
125
|
| `pull_request` | `synchronize` | `loki start owner/repo#N` |
|
|
124
|
-
| `workflow_run` | `completed` with `conclusion=failure
|
|
126
|
+
| `workflow_run` | `completed` with `conclusion=failure`, on the repository's default branch | `loki start --brief <CI brief> --pr` (once per red commit) |
|
|
127
|
+
| `pull_request_review` | `submitted` with state `changes_requested`, trusted reviewer, open same-repo PR | `loki verify-pr respond owner/repo#N` on a fresh clone of the PR branch |
|
|
125
128
|
|
|
126
129
|
The trigger server runs each of these starts in the foreground on the Loki 10 engine (Wall and VERIFIED apply). A run longer than the dispatch wait window is reaped in the background and its job status stays unknown until it exits.
|
|
127
130
|
|
|
@@ -251,6 +254,38 @@ no live run is skipped with nothing written. Subscribe the webhook to "Issue
|
|
|
251
254
|
comments" to use it. The `issues` `opened` trigger applies the same author gate;
|
|
252
255
|
set `LOKI_TRIGGER_ALLOW_ANY_ISSUE_AUTHOR=1` to let any author start a build.
|
|
253
256
|
|
|
257
|
+
### Auto-pause and trigger health
|
|
258
|
+
|
|
259
|
+
Every trigger source counts its own runs: `issues`, `pull_request`, `ci`
|
|
260
|
+
(workflow_run), `review`, `sentry`, `slack`, `linear`, `jira`, `teams` and `jobs`.
|
|
261
|
+
A run counts as failed when it exits non-zero or cannot be launched. Exit 130 and
|
|
262
|
+
143 (cancelled) are ignored. For `loki start` runs, exit 0 means VERIFIED or
|
|
263
|
+
ALREADY_SATISFIED; a BLOCKED, PARTIAL, STALLED or budget stop counts as a failure.
|
|
264
|
+
Detached runs are counted too, when they exit.
|
|
265
|
+
|
|
266
|
+
After `LOKI_TRIGGER_PAUSE_AFTER` consecutive failed runs from one source (default
|
|
267
|
+
3, `0` turns pausing off but keeps counting) that source pauses itself: further
|
|
268
|
+
events from it are logged as paused and nothing is launched. The `jobs` source
|
|
269
|
+
(direct `POST /jobs`) never auto-pauses, since each caller already gets a per-job
|
|
270
|
+
status.
|
|
271
|
+
|
|
272
|
+
```
|
|
273
|
+
loki trigger status # per source: runs, passed, consecutive failures,
|
|
274
|
+
# median seconds trigger-to-exit, active or PAUSED
|
|
275
|
+
loki trigger resume <source> # also clears the failure count
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
Resume while the source is idle: a resume that lands in the same millisecond as a
|
|
279
|
+
finishing run can be overwritten. State lives in `.loki/triggers/health.json`;
|
|
280
|
+
`GET /status` shows the same counters under `triggers`, and the old
|
|
281
|
+
`enabled_events` field (never enforced) is gone.
|
|
282
|
+
|
|
283
|
+
Not covered yet: `loki slack serve` mentions (a separate server that does not
|
|
284
|
+
report to this registry), red CI on pull request branches (use `loki merge watch`),
|
|
285
|
+
and review comments that are not attached to an inline thread (`verify-pr respond`
|
|
286
|
+
fixes unresolved inline threads only). The CI repair starts from the checkout the trigger server runs in and does not
|
|
287
|
+
fetch first, so keep that checkout on the default branch and up to date.
|
|
288
|
+
|
|
254
289
|
## Triggers that do not exist yet
|
|
255
290
|
|
|
256
291
|
Documented so you do not go looking for them:
|