@sjawhar/pi-legion 10.7.2 → 10.8.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/dist/legion.js
CHANGED
|
@@ -16171,7 +16171,7 @@ function ompCapabilityHost() {
|
|
|
16171
16171
|
// package.json
|
|
16172
16172
|
var package_default = {
|
|
16173
16173
|
name: "@sjawhar/pi-legion",
|
|
16174
|
-
version: "10.
|
|
16174
|
+
version: "10.8.0",
|
|
16175
16175
|
license: "Apache-2.0",
|
|
16176
16176
|
type: "module",
|
|
16177
16177
|
omp: {
|
|
@@ -16183,7 +16183,7 @@ var package_default = {
|
|
|
16183
16183
|
]
|
|
16184
16184
|
},
|
|
16185
16185
|
legion: {
|
|
16186
|
-
daemonApiVersion:
|
|
16186
|
+
daemonApiVersion: 30
|
|
16187
16187
|
},
|
|
16188
16188
|
repository: {
|
|
16189
16189
|
type: "git",
|
|
@@ -16461,8 +16461,11 @@ var LegionControllerSecretResponse = exports_external.strictObject({
|
|
|
16461
16461
|
designGate: exports_external.enum(["root-issues", "off"])
|
|
16462
16462
|
});
|
|
16463
16463
|
var LegionControllerCredentialResponse = exports_external.strictObject({
|
|
16464
|
-
|
|
16465
|
-
|
|
16464
|
+
owners: exports_external.record(nonEmptyString, exports_external.strictObject({
|
|
16465
|
+
hosts: nonEmptyString,
|
|
16466
|
+
config: nonEmptyString
|
|
16467
|
+
})),
|
|
16468
|
+
default: nonEmptyString,
|
|
16466
16469
|
app: exports_external.enum(["implement", "review"]),
|
|
16467
16470
|
expiresAt: timestamp
|
|
16468
16471
|
});
|
|
@@ -16,13 +16,15 @@ The Legion extension registers this session with the daemon as the controller an
|
|
|
16
16
|
`legion-<project>-controller` during session startup. Do not handle a wake unless that startup
|
|
17
17
|
succeeded.
|
|
18
18
|
|
|
19
|
-
The session's `gh` acts as the review App's bot account (`gh api graphql -f query='{viewer{login}}'`
|
|
20
|
-
`
|
|
21
|
-
|
|
22
|
-
through
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
19
|
+
The session's `gh` acts as the review App's bot account (`gh api graphql -f query='{viewer{login}}'`
|
|
20
|
+
names it) from `LEGION_GH_OWNERS_DIR`, one read-only directory per GitHub owner of the project,
|
|
21
|
+
which Legion refreshes every minute (the daemon through the controller pod's role Secret, `legion
|
|
22
|
+
controller start` through its own loop). That `gh` is Legion's wrapper: it reads with the token of
|
|
23
|
+
the owner a command names (`-R owner/repo`, `repos/owner/repo` in `gh api`, a GitHub URL) and with
|
|
24
|
+
the first owner's (`GH_CONFIG_DIR`) otherwise, so name the repository. Against a daemon with no
|
|
25
|
+
GitHub App, `legion controller start` says so when it starts (`[legion] the daemon has no GitHub
|
|
26
|
+
App to act as; the controller's gh acts as nobody`), and `gh` acts as nobody. The controller reads
|
|
27
|
+
Dispatch and the daemon's state, and applies its controller
|
|
26
28
|
capability, through the `legion` tool alone: `op: "read_state"` returns the daemon's whole state
|
|
27
29
|
(`issues.<KEY>.phase`, `issues.<KEY>.holdReason`, `issues.<KEY>.architect`, `admission.cap`,
|
|
28
30
|
`admission.active`, `admission.waiting`, `capabilities[]`, `daemon.project`), and `op: "set_status"`
|
|
@@ -58,7 +60,7 @@ The command checks that `LEGION_PROJECT` is the daemon's project, registers this
|
|
|
58
60
|
daemon, and claims the Envoy role for it; the `legion` tool's controller operations then work in
|
|
59
61
|
this session, each `set_status` minting its grant in-process from the registration's secret. A
|
|
60
62
|
takeover session gets no token file from Legion: `legion controller start` and the pod write
|
|
61
|
-
`
|
|
63
|
+
`LEGION_GH_OWNERS_DIR`'s tokens, but a hand-started session's `gh` is what its environment gives it.
|
|
62
64
|
The takeover moves the role and the daemon's recorded session id to this session. Never pass a
|
|
63
65
|
secret as a command argument or copy it into a transcript. The Envoy
|
|
64
66
|
registration heartbeat keeps the role afterwards, so `/legion-claim-controller` is the manual
|
|
@@ -198,21 +198,21 @@ Your pane's `gh` and `git` already carry your role's GitHub identity; invoke Git
|
|
|
198
198
|
gh <gh args…>
|
|
199
199
|
```
|
|
200
200
|
|
|
201
|
-
How `gh` works in a worker pane. `
|
|
202
|
-
`hosts.yml
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
`
|
|
208
|
-
|
|
201
|
+
How `gh` works in a worker pane. `LEGION_GH_OWNERS_DIR` holds one read-only gh directory per
|
|
202
|
+
GitHub owner of the project (`hosts.yml`, an App installation token, and `config.yml`), which the
|
|
203
|
+
daemon rewrites in place so no token expires under you: your issue's owner's, which `GH_CONFIG_DIR`
|
|
204
|
+
names, holds your role's App token; every other owner's the same App's, read-only. Your `gh` picks
|
|
205
|
+
the directory of the owner a command names (`-R owner/repo`, `repos/owner/repo` in `gh api`, a
|
|
206
|
+
GitHub URL), your issue's owner's otherwise, so name the repository whenever it is not your
|
|
207
|
+
issue's; `git` picks by the remote URL's owner (`!legion git-credential`). `GH_TOKEN`,
|
|
208
|
+
`GITHUB_TOKEN` and `GH_HOST` are empty so nothing outranks the files. Never run `gh auth login`,
|
|
209
|
+
`gh auth switch`, `gh auth setup-git`, `gh config set` or `gh alias set`: there is no login state
|
|
210
|
+
to create. One rule nothing enforces: **Legion's issues live on Dispatch, never on
|
|
209
211
|
GitHub issues** — no `gh issue` write and no non-GET `gh api` call to an `/issues` path
|
|
210
212
|
(pull-request conversation comments live on that path too; edit them with `gh pr comment`); use
|
|
211
213
|
`dispatch message` or `dispatch comment` on your `LEGION_ISSUE`. The `legion` tool's own daemon
|
|
212
214
|
calls carry a credential of their own, minted in-process; `gh` and `git` never see it, and you
|
|
213
|
-
never `cat`, `echo`, copy, or `export` a token
|
|
214
|
-
background job in your pane inherits the same `GH_CONFIG_DIR` and so the same credential, for as
|
|
215
|
-
long as it runs.
|
|
215
|
+
never `cat`, `echo`, copy, or `export` a token; a `task` subagent or background job inherits them.
|
|
216
216
|
|
|
217
217
|
**Other credentials your pod may already carry.** Before reporting that a read is unreachable,
|
|
218
218
|
check for them rather than assuming none exist: `AGENT_SECRETS_URL` and `AGENT_SECRETS_KEY_DIR`
|
|
@@ -265,8 +265,8 @@ The implementer opens the pull request. After its implementation commit and veri
|
|
|
265
265
|
pushes the issue branch under this exact name with the one push procedure every role uses
|
|
266
266
|
(*Every role pushes its own commits*, below).
|
|
267
267
|
|
|
268
|
-
|
|
269
|
-
|
|
268
|
+
`jj git push` authenticates as your role's App through the clone's `!legion git-credential`, from
|
|
269
|
+
the file your `gh` reads for your issue's repository. Never handle a token.
|
|
270
270
|
|
|
271
271
|
Then open the pull request with `gh pr create`. The PR body **must** contain the
|
|
272
272
|
line `Dispatch: <KEY>` — the daemon's fallback link from a PR to its Dispatch issue when the
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sjawhar/pi-legion",
|
|
3
|
-
"version": "10.
|
|
3
|
+
"version": "10.8.0",
|
|
4
4
|
"license": "Apache-2.0",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"omp": {
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
]
|
|
13
13
|
},
|
|
14
14
|
"legion": {
|
|
15
|
-
"daemonApiVersion":
|
|
15
|
+
"daemonApiVersion": 30
|
|
16
16
|
},
|
|
17
17
|
"repository": {
|
|
18
18
|
"type": "git",
|