@awebai/oats 0.69.21 → 0.69.23
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/bin/oats.mjs +131 -23
- package/docs/capabilities.md +12 -2
- package/docs/capability-manifest.schema.json +1 -1
- package/docs/container.md +290 -5
- package/docs/design/2026-11-18-kernel-test-ownership.md +82 -0
- package/docs/design/2026-11-19-aweb-suite-retirement.md +123 -0
- package/docs/design/2026-11-19-sandboxes.md +878 -0
- package/docs/design/README.md +3 -0
- package/docs/desktop-cli-api.md +416 -72
- package/docs/desktop.md +377 -148
- package/docs/implementation.md +15 -2
- package/docs/integrations.md +3 -3
- package/docs/knowledge-capability-authoring.md +10 -7
- package/docs/knowledge-reference/acceptance.md +21 -19
- package/docs/knowledge-reference/adoption.md +18 -4
- package/docs/knowledge-reference/model.md +11 -9
- package/docs/knowledge-reference/package-craft.md +2 -2
- package/docs/knowledge-reference/proposal.md +117 -0
- package/docs/knowledge-reference/provider-mapping.md +10 -10
- package/docs/knowledge-reference/reader-capture.md +26 -22
- package/docs/knowledge-theory.md +1 -1
- package/docs/knowledge.md +5 -5
- package/docs/official-catalog.md +47 -4
- package/docs/packages.md +13 -13
- package/docs/release-lane.md +8 -6
- package/docs/release-notes/v0.69.22.md +221 -0
- package/docs/release-notes/v0.69.23.md +231 -0
- package/docs/servers.md +10 -6
- package/docs/souls-and-instances.md +51 -22
- package/docs/tui.md +48 -7
- package/docs/upgrading.md +17 -5
- package/docs/workspaces.md +2 -2
- package/lib/argv.mjs +6 -2
- package/lib/capability-contract.mjs +2 -2
- package/lib/command-flags.mjs +39 -2
- package/lib/core.mjs +25 -14
- package/lib/instance-board.mjs +337 -0
- package/lib/instance-events.mjs +48 -10
- package/lib/instance-lifecycle.mjs +19 -15
- package/lib/instance-listing.mjs +18 -10
- package/lib/instance-related-work.mjs +143 -0
- package/lib/kernel-features.mjs +4 -1
- package/lib/servers.mjs +123 -13
- package/package-catalog.json +3 -3
- package/package.json +1 -1
- package/packages/client/above-tested.mjs +3 -2
- package/packages/client/capability-list.mjs +69 -0
- package/packages/client/capability-origin.mjs +54 -0
- package/packages/client/cli-adapter.mjs +9 -1
- package/packages/client/deployment-data.mjs +7 -2
- package/packages/client/deployment-panel.mjs +4 -1
- package/packages/client/home-board.mjs +50 -0
- package/packages/client/instance-pin.mjs +28 -0
- package/packages/client/instance-record-outcome.mjs +31 -0
- package/packages/client/instance-tree.mjs +96 -24
- package/packages/client/keymap.mjs +16 -3
- package/packages/client/mail-contract.mjs +130 -0
- package/packages/client/panel-views.mjs +7 -7
- package/packages/client/related-work.mjs +84 -0
- package/packages/client/remote-roster.mjs +11 -3
- package/packages/client/roster-sections.mjs +10 -7
- package/packages/client/soul-role.mjs +44 -0
- package/packages/client/waiting-on-you.mjs +10 -0
- package/packages/client/workspace-cli.mjs +13 -2
- package/packages/tui/lib/actions.mjs +11 -4
- package/packages/tui/lib/client.mjs +3 -1
- package/packages/tui/lib/main.mjs +16 -2
- package/packages/tui/lib/model.mjs +48 -5
- package/packages/tui/lib/store.mjs +28 -2
- package/skills/oats-getting-started/SKILL.md +97 -24
- package/docs/knowledge-reference/harvester.md +0 -109
- package/lib/instance-same-work.mjs +0 -67
- package/packages/client/same-work.mjs +0 -49
package/docs/container.md
CHANGED
|
@@ -19,7 +19,9 @@ container is one trust group ([trust-model.md](trust-model.md)):
|
|
|
19
19
|
rewrite the launch configurations in `/state/deploy` and the schedule
|
|
20
20
|
registry in `/state/home`, rewrite the wake registrations under
|
|
21
21
|
`/state/home/.config/aw/wake`, and stop sshd, `oats host run`, the wake
|
|
22
|
-
broker or its supervisor.
|
|
22
|
+
broker or its supervisor. With an optional child, each agent can also
|
|
23
|
+
reach every loopback port the child holds
|
|
24
|
+
([An optional child](#an-optional-child)).
|
|
23
25
|
- **It holds one team, never several.** Agents that must not be able to read
|
|
24
26
|
each other's identities or affect each other's work get separate
|
|
25
27
|
containers. Nothing in OATS makes sharing one safe.
|
|
@@ -106,7 +108,9 @@ the UID-only form proves startup and SSH support, not token access.
|
|
|
106
108
|
| Container path | Host ownership and mode | Access |
|
|
107
109
|
| --- | --- | --- |
|
|
108
110
|
| `/state` | Runtime UID:GID, 0700 | Read/write; persistent |
|
|
111
|
+
| `/outbox` (optional) | Runtime UID:dedicated outbox-GID, 2750 (setgid); operator-owned parent | Read/write export queue shared with every agent |
|
|
109
112
|
| `/work` (optional) | Runtime UID:GID, 0700 | Read/write |
|
|
113
|
+
| `/inputs` (optional) | Operator-provisioned directory, readable by runtime UID:GID | Read-only; shared with every agent in the trust group |
|
|
110
114
|
| `/etc/agent-login` | root:runtime-GID, 0750; `claude-token` root:runtime-GID, 0440 | Read-only |
|
|
111
115
|
| `/etc/agent-ssh/authorized_keys` | root-owned regular file, 0644 | Read-only |
|
|
112
116
|
| `/etc/resolv.conf` | Operator-provided resolver file | Read-only |
|
|
@@ -139,6 +143,9 @@ Supply these plain variables to the bundle's env file:
|
|
|
139
143
|
| `AGENT_UID`, `AGENT_GID` | Runtime IDs; both default to 20001. |
|
|
140
144
|
| `TEAM_STATE_DIR` | Absolute host directory for `/state`. |
|
|
141
145
|
| `TEAM_WORK_DIR` | Optional absolute host directory for `/work`. |
|
|
146
|
+
| `TEAM_INPUT_DIR` | Optional absolute host directory for `/inputs`; selects `compose.agent.inputs.yaml`. |
|
|
147
|
+
| `TEAM_OUTBOX_DIR` | Optional absolute host export-queue directory for `/outbox`; selects `compose.agent.outbox.yaml`. |
|
|
148
|
+
| `TEAM_OUTBOX_GID` | Dedicated non-root numeric supplementary group for `/outbox`, distinct from `AGENT_GID`; required with `TEAM_OUTBOX_DIR`. |
|
|
142
149
|
| `TEAM_LOGIN_DIR` | Absolute host directory containing `claude-token`. |
|
|
143
150
|
| `AUTHORIZED_KEYS_FILE` | Absolute host public-key file. |
|
|
144
151
|
| `RESOLV_CONF_FILE` | Absolute host resolver file; always required. |
|
|
@@ -147,6 +154,7 @@ Supply these plain variables to the bundle's env file:
|
|
|
147
154
|
| `AGENT_CA_FILE` | Optional absolute public PEM path from `agents.caFile`; selects `compose.agent.trust.yaml`. |
|
|
148
155
|
| `AGENT_MIRRORS_DIR` | Optional absolute mirror directory from `agents.mirrorsDir`; selects `compose.agent.mirrors.yaml`. |
|
|
149
156
|
| `AGENTS_NETWORK`, `AGENT_IP` | Installer-created external network and container address. |
|
|
157
|
+
| `AGENT_CHILD` | Optional; the name of the declared child, when the derived image's fragment is included, for acceptance. `AGENT_IMAGE` is then that derived image. |
|
|
150
158
|
|
|
151
159
|
The bundle owns the network, resolver, forwarder, firewall and their bypass
|
|
152
160
|
checks. The agent service publishes no ports and sets no DNS or extra-hosts
|
|
@@ -176,10 +184,15 @@ start with the same approved anchors.
|
|
|
176
184
|
A successful probe using an explicit CA does not establish that the
|
|
177
185
|
real broker trusts it; prove that through the deployment's HTTPS registry.
|
|
178
186
|
|
|
187
|
+
A derived image that declares a child ships a fragment of its own. Include it
|
|
188
|
+
only for a team that runs that child. It sets exactly one fixed environment
|
|
189
|
+
entry, `AGENT_CHILD: "<name>"`, and adds no mount, port, network or
|
|
190
|
+
capability ([An optional child](#an-optional-child)).
|
|
191
|
+
|
|
179
192
|
Include `compose.agent.mirrors.yaml` only when `agents.mirrorsDir` is configured.
|
|
180
193
|
The operator provisions and refreshes the bare mirrors outside the container,
|
|
181
194
|
with no repository credentials, and the fragment mounts them read-only at
|
|
182
|
-
`/mirrors`. Keep
|
|
195
|
+
`/mirrors`. Keep all optional input sources outside every agent-writable bind
|
|
183
196
|
source, including symlink aliases: run acceptance on the Docker engine host so
|
|
184
197
|
it can resolve the actual sources. A CA file with multiple hardlinks is refused,
|
|
185
198
|
since a read-only bind cannot protect another writable link to the same file.
|
|
@@ -213,6 +226,71 @@ the override: the base has no `/work` mount. With multiple Compose files,
|
|
|
213
226
|
paths resolve relative to the first file; use absolute host paths. Container
|
|
214
227
|
down/upgrade preserves `/state`; the operator owns provisioning and rollback.
|
|
215
228
|
|
|
229
|
+
For provider input folders, provision one readable host directory outside every
|
|
230
|
+
agent-writable bind source, including symlink aliases. Set `TEAM_INPUT_DIR`
|
|
231
|
+
and append `-f container/agent/compose.agent.inputs.yaml` to both Compose
|
|
232
|
+
commands above. For example, with the bundle's other plain variables supplied:
|
|
233
|
+
|
|
234
|
+
```sh
|
|
235
|
+
TEAM_INPUT_DIR=/srv/example-team/inputs docker compose -p "oats-team-${TEAM}" \
|
|
236
|
+
--env-file <plain-env-file> -f compose.yaml \
|
|
237
|
+
-f container/agent/compose.agent.yaml \
|
|
238
|
+
-f container/agent/compose.agent.inputs.yaml up -d
|
|
239
|
+
```
|
|
240
|
+
|
|
241
|
+
The operator creates and populates the directory first; a missing source fails
|
|
242
|
+
startup without creating a host directory. The fragment adds only a read-only
|
|
243
|
+
bind at `/inputs`. Omit the fragment and unset `TEAM_INPUT_DIR` to run the base
|
|
244
|
+
without `/inputs`; pass the same reviewed variables to `accept.sh`.
|
|
245
|
+
Acceptance checks the running container's exact approved mounts, its environment
|
|
246
|
+
against the reviewed image, directory readability and a refused write. It also
|
|
247
|
+
checks that the base has no `/inputs`. Team-image CI exercises both forms and
|
|
248
|
+
checks missing-source startup failure without host-path creation, using a
|
|
249
|
+
synthetic input directory readable by the agent group and a private outbox
|
|
250
|
+
subdirectory, with no publisher credentials. Credential scans cover these trees
|
|
251
|
+
as the agent, since root without DAC capabilities cannot read their private
|
|
252
|
+
subdirectories.
|
|
253
|
+
|
|
254
|
+
The input folder is ambient to the container's trust group: every agent in the
|
|
255
|
+
container can read everything in it. If only one agent may read an input, that
|
|
256
|
+
agent needs its own container. Publication happens at a connector or job boundary
|
|
257
|
+
outside the agent container. Publisher credentials stay outside it too. This fragment
|
|
258
|
+
provides a generic bind only; provider authorization and publication are separate
|
|
259
|
+
integration concerns.
|
|
260
|
+
|
|
261
|
+
For an export queue, the operator provisions `TEAM_OUTBOX_DIR` under an
|
|
262
|
+
operator-owned parent, with ownership `AGENT_UID:TEAM_OUTBOX_GID` and mode
|
|
263
|
+
2750 (setgid). Keep its resolved source separate from `/state`, optional
|
|
264
|
+
`/work`, and all read-only input sources. Supply a dedicated non-root numeric
|
|
265
|
+
`TEAM_OUTBOX_GID` distinct from `AGENT_GID` and append
|
|
266
|
+
`-f container/agent/compose.agent.outbox.yaml` to both Compose commands.
|
|
267
|
+
For example, with both optional folders:
|
|
268
|
+
|
|
269
|
+
```sh
|
|
270
|
+
TEAM_INPUT_DIR=/srv/example-team/inputs \
|
|
271
|
+
TEAM_OUTBOX_DIR=/srv/example-team/outbox TEAM_OUTBOX_GID=20002 \
|
|
272
|
+
docker compose -p "oats-team-${TEAM}" --env-file <plain-env-file> \
|
|
273
|
+
-f compose.yaml -f container/agent/compose.agent.yaml \
|
|
274
|
+
-f container/agent/compose.agent.inputs.yaml \
|
|
275
|
+
-f container/agent/compose.agent.outbox.yaml up -d
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
The outbox fragment adds only a read/write `/outbox` bind and its numeric
|
|
279
|
+
supplementary group; it does not alter `/state` or the entrypoint's umask
|
|
280
|
+
077. Files inherit the directory's outbox group. The integrations submit
|
|
281
|
+
helper makes reports and manifests 0640; OATS does not set publication modes.
|
|
282
|
+
Acceptance creates and removes its own probe, checks its group, and checks
|
|
283
|
+
that `/state` remains 0700. CI also checks that the base has no `/outbox`
|
|
284
|
+
and that a missing source fails startup without creating a host directory.
|
|
285
|
+
Omit the fragment and unset both outbox variables when no queue is needed.
|
|
286
|
+
|
|
287
|
+
The outbox is an export queue, not an isolation boundary: every agent in the
|
|
288
|
+
container can write and read it. Durable work stays in `/state`. The publisher
|
|
289
|
+
reads the outbox read-only in its own namespace; the publisher and its ledger
|
|
290
|
+
are outside OATS. No publisher mount or credentials are added to the agent
|
|
291
|
+
container. The exact approved writable binds are `/state`, optional `/work`
|
|
292
|
+
and optional `/outbox`.
|
|
293
|
+
|
|
216
294
|
The image account and the runtime NSS entry use `/bin/bash` as the login shell.
|
|
217
295
|
This lets OATS capture a fresh login environment rather than inheriting the tmux
|
|
218
296
|
creator's environment after a failed shell capture.
|
|
@@ -447,7 +525,7 @@ container may do. Give them an identity with the write role only on the
|
|
|
447
525
|
knowledge repository, its token in a file named by
|
|
448
526
|
`settings.oats.okf.github-token-file`, and keep the identity that merges to
|
|
449
527
|
the accepted branch outside the container. oats.okf's
|
|
450
|
-
[Bringing up a deployment's knowledge store](https://github.com/oats-project/oats-okf/blob/v6.
|
|
528
|
+
[Bringing up a deployment's knowledge store](https://github.com/oats-project/oats-okf/blob/v6.3.0/README.md#bringing-up-a-deployments-knowledge-store)
|
|
451
529
|
(oats.okf 6.2 and later) has each step; run its
|
|
452
530
|
`oats okf setup --check` in the container to check them.
|
|
453
531
|
|
|
@@ -525,7 +603,9 @@ What the image's files fix for that:
|
|
|
525
603
|
run alone and keeps the wake broker alive until host run finishes stopping
|
|
526
604
|
the agents. Then it stops sshd and the broker in parallel, allowing sshd three seconds
|
|
527
605
|
and the broker six seconds before escalation. The broker budget preserves
|
|
528
|
-
its channel children's five-second delivery drain. A
|
|
606
|
+
its channel children's five-second delivery drain. A declared child is
|
|
607
|
+
stopped in that same step, with its declared `stopMs` (at most eight
|
|
608
|
+
seconds), so it runs until host run has stopped the agents. A broker or
|
|
529
609
|
host-run exit is reported and drains the other children before a nonzero
|
|
530
610
|
container exit, so
|
|
531
611
|
the restart policy can restart it. The broker runs as the agent uid; its
|
|
@@ -575,6 +655,190 @@ or, in the container, `oats schedule host install --register-only --dir
|
|
|
575
655
|
systemd user manager. The registry is in `/state/home`, so it persists
|
|
576
656
|
across container runs.
|
|
577
657
|
|
|
658
|
+
<!-- docs/release-notes/v0.69.22.md links here under this section's former
|
|
659
|
+
name, "A bb server for the team": the anchor keeps those links whole. -->
|
|
660
|
+
<a id="a-bb-server-for-the-team"></a>
|
|
661
|
+
## An optional child
|
|
662
|
+
|
|
663
|
+
A derived image can add one more supervised process to the team container:
|
|
664
|
+
a server its agents use on loopback, say. The base image runs none. The
|
|
665
|
+
mechanism has two halves, and they belong to different people:
|
|
666
|
+
|
|
667
|
+
- **The declaration is the image's.** A derived image holds one file,
|
|
668
|
+
`/etc/agent-child.json`, that says what to run. It is root's file on the
|
|
669
|
+
read-only root, so only an image build can write it.
|
|
670
|
+
- **The switch is the deployment's.** The Compose fragment that ships with
|
|
671
|
+
the derived image sets one fixed environment entry,
|
|
672
|
+
`AGENT_CHILD: "<name>"`. Without it nothing starts, and a declaration in
|
|
673
|
+
the image is inert: the supervisor reads no file and runs as it does on the
|
|
674
|
+
base image.
|
|
675
|
+
|
|
676
|
+
One child, not a list: a second one is a new decision.
|
|
677
|
+
|
|
678
|
+
The image that runs a [bb](https://github.com/get-bb/bb) server this way,
|
|
679
|
+
its relay and its operator docs live in
|
|
680
|
+
[oats-project/oats-bb](https://github.com/oats-project/oats-bb); this
|
|
681
|
+
repository holds no product's image. bb, the optional child that oats-bb
|
|
682
|
+
ships, is documented
|
|
683
|
+
[there](https://github.com/oats-project/oats-bb/blob/main/container/README.md):
|
|
684
|
+
the threads of one bb can write each other's storage, and bb's sandboxed
|
|
685
|
+
modes are not a security boundary. `AGENT_BB`, `container/agent-bb`,
|
|
686
|
+
`compose.agent.bb.yaml` and the relay shipped in 0.69.22 as experimental,
|
|
687
|
+
with no compatibility promise, and are gone without an alias: a container
|
|
688
|
+
that still sets `AGENT_BB` is refused at start with a line naming
|
|
689
|
+
`AGENT_CHILD`.
|
|
690
|
+
|
|
691
|
+
**A child's loopback ports are reachable by every agent in the container.**
|
|
692
|
+
Whatever the child serves there, with whatever login it does or does not
|
|
693
|
+
ask for, belongs to the container's one trust group
|
|
694
|
+
([One team, one trust group](#one-team-one-trust-group)). The service still
|
|
695
|
+
publishes no port.
|
|
696
|
+
|
|
697
|
+
### The declaration
|
|
698
|
+
|
|
699
|
+
`/etc/agent-child.json` is JSON of at most 16 KiB, with a closed grammar:
|
|
700
|
+
every key below is required unless marked, and an unknown key is refused.
|
|
701
|
+
|
|
702
|
+
```json
|
|
703
|
+
{ "name": "example",
|
|
704
|
+
"command": ["/usr/local/bin/example-server", "--bind", "127.0.0.1"],
|
|
705
|
+
"env": { "EXAMPLE_TELEMETRY": "false" },
|
|
706
|
+
"envFromFile": { "EXAMPLE_TOKEN": "/etc/agent-login/example-token" },
|
|
707
|
+
"ready": { "url": "http://127.0.0.1:39000/status", "field": "ready" },
|
|
708
|
+
"listen": [39000],
|
|
709
|
+
"version": { "command": ["/usr/local/bin/example", "--version"], "file": "/opt/agent-child/version" },
|
|
710
|
+
"stopMs": 5000 }
|
|
711
|
+
```
|
|
712
|
+
|
|
713
|
+
| Key | Grammar | Meaning |
|
|
714
|
+
| --- | --- | --- |
|
|
715
|
+
| `name` | 1 to 20 lowercase letters, digits or dashes; not `broker`, `sshd`, `host-run`, `status` or `supervisor`, the base's own names in the log | What the supervisor's lines call the child, and the value `AGENT_CHILD` must have. |
|
|
716
|
+
| `command` | A non-empty array of strings; `command[0]` an absolute path that exists and whose real path is outside `/state`, `/work`, `/tmp`, `/run`, `/outbox` and `/dev/shm` | The child's argv, exactly. No shell. The supervisor resolves `command[0]` once, at start, refuses a file inside a writable mount, and runs that resolved file under its declared name at the start and at every restart, so a link on the way that an agent could re-point is never followed again. |
|
|
717
|
+
| `env` | An object of strings; names match `[A-Z_][A-Z0-9_]*` | Literal variables added to the child's environment. May be `{}`. |
|
|
718
|
+
| `envFromFile` | Optional. An object of variable name to a file directly under `/etc/agent-login/`; names as for `env`, and no name in both | Variables whose value is the file's content, read once at start ([below](#envfromfile)). |
|
|
719
|
+
| `ready.url` | `http://127.0.0.1:<port>/<path>`, the port one of `listen`; the path of letters, digits and `._~/?&=%-` | Where the supervisor asks whether the child is ready. |
|
|
720
|
+
| `ready.field` | A letter or underscore, then letters, digits or underscores; at most 64 characters | The top-level field of the JSON answer that must be `true`. |
|
|
721
|
+
| `listen` | A non-empty array of distinct ports from 1024 to 65535, without 2222 | The loopback TCP ports the child holds. Acceptance requires each. |
|
|
722
|
+
| `version.command` | A non-empty array of strings; `command[0]` an absolute path | A command that prints the child's version. |
|
|
723
|
+
| `version.file` | An absolute path | A file the image writes at build time with that same version: one printable line of at most 64 characters, in a file of at most 256 bytes. Acceptance compares the two, so it needs no checkout of the image's repository. |
|
|
724
|
+
| `stopMs` | A whole number from 1000 to 8000 | How long the child gets after SIGTERM before SIGKILL. |
|
|
725
|
+
|
|
726
|
+
Neither `env` nor `envFromFile` may set `PATH`, `HOME`, `LD_PRELOAD`,
|
|
727
|
+
`NSS_WRAPPER_PASSWD`, `NSS_WRAPPER_GROUP`, `NODE_OPTIONS` or `AGENT_CHILD`:
|
|
728
|
+
the image, the entrypoint and the switch set those.
|
|
729
|
+
|
|
730
|
+
Nothing else is declarable. The order, the start timeout, the restart policy
|
|
731
|
+
and the process group are the base image's
|
|
732
|
+
([What the supervisor does](#what-the-supervisor-does)).
|
|
733
|
+
|
|
734
|
+
### envFromFile
|
|
735
|
+
|
|
736
|
+
One rule for every entry. The supervisor reads each file once, before any
|
|
737
|
+
child starts:
|
|
738
|
+
|
|
739
|
+
- **No such file:** the child starts without that variable, even when the
|
|
740
|
+
supervisor's own environment holds one of that name: an `envFromFile`
|
|
741
|
+
name comes from its file or not at all.
|
|
742
|
+
- **Empty after trimming:** the same, with one line that names the variable.
|
|
743
|
+
- **Any other read error:** the start is refused.
|
|
744
|
+
- **Whitespace or a NUL byte inside the trimmed value** (a second line, a
|
|
745
|
+
space, a tab, a file saved as UTF-16):
|
|
746
|
+
the start is refused with `the file for <VARIABLE> must hold its value on
|
|
747
|
+
one line`. A file with two lines is never passed on in part.
|
|
748
|
+
|
|
749
|
+
The value reaches the declared child's environment and nothing else: no
|
|
750
|
+
line the supervisor writes, no argument, no other child. The child reads its
|
|
751
|
+
environment when it starts, so after replacing a file under the login mount,
|
|
752
|
+
restart the container ([After changing a credential](#after-changing-a-credential)).
|
|
753
|
+
Every agent can already read the login mount.
|
|
754
|
+
|
|
755
|
+
### What the supervisor does
|
|
756
|
+
|
|
757
|
+
With `AGENT_CHILD` set, the supervisor reads the declaration once, before
|
|
758
|
+
any child, and then:
|
|
759
|
+
|
|
760
|
+
1. Starts the wake broker and waits for it, as on the base image.
|
|
761
|
+
2. Asks `ready.url` once, for at most a second. Whatever accepts that
|
|
762
|
+
connection before the child exists is another process, whether it answers
|
|
763
|
+
ready, not ready or nothing, and refuses the start. A refused connection
|
|
764
|
+
is the only pass: an attempt that cannot tell whether anybody listens
|
|
765
|
+
refuses the start too.
|
|
766
|
+
3. Starts the child: the resolved `command[0]` with argv exactly `command`,
|
|
767
|
+
the supervisor's own environment without the `envFromFile` names, plus
|
|
768
|
+
`env`, plus the `envFromFile` values that were read, in a process group
|
|
769
|
+
of its own.
|
|
770
|
+
4. Asks `ready.url` until it answers 200 with JSON whose top-level
|
|
771
|
+
`ready.field` is `true` while the child it started is still alive, for up
|
|
772
|
+
to 30 seconds. It then writes `agent-supervisor: <name> ready (<field>:
|
|
773
|
+
true)`.
|
|
774
|
+
5. Starts sshd and `oats host run`.
|
|
775
|
+
|
|
776
|
+
On SIGTERM, host run goes first, and the child keeps running while host run
|
|
777
|
+
stops the agents. Then sshd, the broker and the child are stopped side by
|
|
778
|
+
side; the child gets SIGTERM and `stopMs` before SIGKILL.
|
|
779
|
+
|
|
780
|
+
The stop budget holds for whatever an image declares, since `stopMs` is
|
|
781
|
+
capped: at most 35 seconds for host run (10 + 5 + 20), then the slowest of
|
|
782
|
+
sshd (3 seconds), the broker (6) and the child (at most 8), 43 seconds in
|
|
783
|
+
all inside the 50-second stop grace. `test/agent-container.test.mjs` pins
|
|
784
|
+
that sum against the supervisor's exported budgets, the cap and the Compose
|
|
785
|
+
file, with 5 seconds to spare.
|
|
786
|
+
|
|
787
|
+
### When it fails
|
|
788
|
+
|
|
789
|
+
Each refusal at start is one fixed line on standard error, exit 1, before
|
|
790
|
+
any child starts. A line names the key at fault and never a value from the
|
|
791
|
+
file.
|
|
792
|
+
|
|
793
|
+
- **`AGENT_CHILD` on an image without a declaration**, the base image
|
|
794
|
+
included: `AGENT_CHILD needs an image that declares a child in
|
|
795
|
+
/etc/agent-child.json`. Select the derived image with `AGENT_IMAGE`.
|
|
796
|
+
- **A declaration that is not the image's own file:** a symlink, not a
|
|
797
|
+
regular file, not owned by uid 0, or writable by its group or by others.
|
|
798
|
+
Over 16 KiB, or not JSON, is refused too. The supervisor runs as the
|
|
799
|
+
agent, so the file must be readable by everyone (mode 0644 or 0444): one
|
|
800
|
+
it cannot open is refused with `/etc/agent-child.json could not be read
|
|
801
|
+
(<code>)`.
|
|
802
|
+
- **A declaration outside the grammar:** `/etc/agent-child.json: <key>
|
|
803
|
+
<what it must be>`, for an unknown or missing key and for every value the
|
|
804
|
+
table above rules out.
|
|
805
|
+
- **A `name` that differs from `AGENT_CHILD`.** The fragment and the image
|
|
806
|
+
must be the same product's.
|
|
807
|
+
- **A command that does not exist, or resolves under a writable mount.**
|
|
808
|
+
- **An `envFromFile` file that cannot be read, or holds whitespace inside
|
|
809
|
+
its value** ([above](#envfromfile)).
|
|
810
|
+
- **`AGENT_BB` set to anything:** `AGENT_BB is gone: use an image that
|
|
811
|
+
declares its child and AGENT_CHILD (the bb image now lives in
|
|
812
|
+
oats-project/oats-bb)`.
|
|
813
|
+
- **The child is not ready.** A child that exits before it is ready, 30
|
|
814
|
+
seconds without a ready answer (one that arrives later does not count), or
|
|
815
|
+
anything listening on `ready.url` before the child starts
|
|
816
|
+
fails the container start: neither sshd nor host run starts, the exit is
|
|
817
|
+
nonzero and the restart policy starts the container again.
|
|
818
|
+
- **The child ends later.** That is not a container failure. The supervisor
|
|
819
|
+
writes `agent-supervisor: <name> exited (<code or signal>)`, sends SIGKILL
|
|
820
|
+
to what is left of the child's process group, and starts the child again
|
|
821
|
+
after 1 second, doubling to 60 seconds, and from 1 second again once a
|
|
822
|
+
child has stayed up five minutes. sshd, the broker, host run and the
|
|
823
|
+
agents keep running.
|
|
824
|
+
- **Stopping.** A child that had to be killed after `stopMs`, or that ended
|
|
825
|
+
while host run was still stopping agents, makes the stop a failed one. A
|
|
826
|
+
restart that was pending at SIGTERM starts no further child.
|
|
827
|
+
|
|
828
|
+
### Limits
|
|
829
|
+
|
|
830
|
+
The child counts toward the container's limits. A derived image's docs say
|
|
831
|
+
what to add to `AGENT_MEMORY` and `AGENT_PIDS` for it.
|
|
832
|
+
|
|
833
|
+
### What was run
|
|
834
|
+
|
|
835
|
+
Run on amd64, in the base image and a fixture derived image
|
|
836
|
+
(`test/fixtures/agent-child`) under the Compose flags: the build, the child
|
|
837
|
+
ready at start between the broker and sshd, a restart after `kill` and after
|
|
838
|
+
`kill -9`, the ordered `docker stop`, and acceptance with and without
|
|
839
|
+
`AGENT_CHILD`. **NOT RUN:** arm64; any real product's image, which its own
|
|
840
|
+
repository proves.
|
|
841
|
+
|
|
578
842
|
## Acceptance and evidence
|
|
579
843
|
|
|
580
844
|
The host needs Docker and Node 22.5+. Export the same plain variables used for
|
|
@@ -607,7 +871,18 @@ variables. It resolves `AGENT_IMAGE` independently and requires that image's
|
|
|
607
871
|
ID, reference and start command, and its complete environment (printing only
|
|
608
872
|
names of differing variables). Other comparisons include supplementary
|
|
609
873
|
groups, namespace overrides, sysctls, published ports, resolver overrides
|
|
610
|
-
and the single network/address.
|
|
874
|
+
and the single network/address. With `AGENT_CHILD=<name>` exported it admits
|
|
875
|
+
that one environment entry and reads `/etc/agent-child.json` from the
|
|
876
|
+
running container. It requires the file to be a regular file owned by root,
|
|
877
|
+
not a symlink and not writable by its group, by others or by the agent, to
|
|
878
|
+
pass the supervisor's grammar and to declare that name. It reads the
|
|
879
|
+
container's listening TCP sockets and requires every declared `listen` port
|
|
880
|
+
on loopback and nothing beyond loopback except sshd's port 2222. It runs
|
|
881
|
+
`version.command` in the container, requires its output to equal the
|
|
882
|
+
trimmed content of `version.file`, and reports that version. Without
|
|
883
|
+
`AGENT_CHILD`, a container that has it set is refused. A container that has
|
|
884
|
+
`AGENT_BB`, or an image that sets `AGENT_CHILD` itself, is refused either
|
|
885
|
+
way. The stop timeout must be 50 seconds and the
|
|
611
886
|
healthcheck the service file's, so a container made before either was set
|
|
612
887
|
is refused until it is recreated. The OCI runtime must match the daemon's
|
|
613
888
|
independently read default; shared memory stays at Docker's 64 MiB default,
|
|
@@ -706,6 +981,16 @@ network and fixture paths on success or failure. This is image acceptance;
|
|
|
706
981
|
it provisions no seat or inference token. The script's `NOT RUN` items
|
|
707
982
|
remain outside this check.
|
|
708
983
|
|
|
984
|
+
The same job then proves the optional child with a fixture derived image,
|
|
985
|
+
`test/fixtures/agent-child`: a dependency-free Node HTTP server on one
|
|
986
|
+
loopback port, its declaration and its version file. It builds that image
|
|
987
|
+
from the image it just accepted, with no registry in between, and runs the
|
|
988
|
+
same fixture and the same unmodified acceptance once more with
|
|
989
|
+
`AGENT_CHILD` set: alone, then with the inputs and the outbox fragments. It
|
|
990
|
+
also requires acceptance without `AGENT_CHILD` to refuse that container.
|
|
991
|
+
The fixture is outside `container/agent`, so it is never in the base
|
|
992
|
+
image's build context, and it is not exported or published.
|
|
993
|
+
|
|
709
994
|
The `publish-team-image` job in
|
|
710
995
|
[Release](../.github/workflows/release.yml) waits for the existing `publish`
|
|
711
996
|
job, so npm publication and the GitHub Release precede the image. Its
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Kernel test ownership and real-path evidence
|
|
2
|
+
|
|
3
|
+
K2 of the second systemic review, findings 13.14, 13.16 and 13.21. This
|
|
4
|
+
records explicit removals and replacements; it does not claim a source-text
|
|
5
|
+
match proved behaviour.
|
|
6
|
+
|
|
7
|
+
## Removed optional native tests
|
|
8
|
+
|
|
9
|
+
These three tests ran a provider or `aw` directly, never kernel consumption:
|
|
10
|
+
|
|
11
|
+
- `test/oats-aweb-hook-1-10.test.mjs`, “real aw fixture: unattached grant
|
|
12
|
+
home reports the released custody locator error”.
|
|
13
|
+
- `test/oats-aweb-hook-1-13.test.mjs`, “real aw 1.36.33 custody preflight
|
|
14
|
+
reports needs-configuration instead of faking a pass”.
|
|
15
|
+
- The same file's “real aw fixture: unattached grant home reports the released
|
|
16
|
+
custody locator error”.
|
|
17
|
+
|
|
18
|
+
Ordinary kernel CI provisioned neither `AW_REAL_CLI_BIN` nor
|
|
19
|
+
`AW_REAL_GRANT_FIXTURE`, so these were normally skipped, not successful native
|
|
20
|
+
regressions. The locator case was also duplicated inside the kernel. The
|
|
21
|
+
provider package owns these native paths. All three have released counterparts
|
|
22
|
+
at `v1.43.0` (commit `00f60a241cfb5bc5aa6acbf1ebcb111756ee8fa0`), in its
|
|
23
|
+
[`test/oats-aweb-hook-1-13.test.mjs`](https://github.com/awebai/oats-aweb/blob/v1.43.0/test/oats-aweb-hook-1-13.test.mjs):
|
|
24
|
+
|
|
25
|
+
| Removed kernel case | Released covering test |
|
|
26
|
+
| --- | --- |
|
|
27
|
+
| hook-1-10 unattached locator | “real aw fixture: unattached grant home reports the released custody locator error” (line 212) |
|
|
28
|
+
| hook-1-13 custody preflight | “real aw at the floor: custody preflight reports needs-configuration instead of faking a pass” (line 194) |
|
|
29
|
+
| hook-1-13 unattached locator | The same released locator test (line 212) |
|
|
30
|
+
|
|
31
|
+
The outcome assertions match the released source, independently checked with
|
|
32
|
+
`git show v1.43.0:test/oats-aweb-hook-1-13.test.mjs`. Their removal makes no
|
|
33
|
+
claim that those package opt-ins run in CI. Admission floors differ: the
|
|
34
|
+
released custody test accepts 1.36.32+ and its locator test 1.36.13+, while
|
|
35
|
+
the removed kernel copies required 1.36.33+. Future kernel tests titled `real aw`/`real-aw` fail
|
|
36
|
+
the root gate if skipped; the count, file and title are reported.
|
|
37
|
+
|
|
38
|
+
No version-named suite is retired by this change. Their substantive provider
|
|
39
|
+
assertions must be transferred and present in the pinned mirrored release,
|
|
40
|
+
and K1's kernel retire-hook contract test must land, before that retirement.
|
|
41
|
+
|
|
42
|
+
## Removed provider-source checks from the steward guidance test
|
|
43
|
+
|
|
44
|
+
The following checks read implementation text in the provider mirror. They
|
|
45
|
+
were removed because they did not execute the advertised behaviour:
|
|
46
|
+
|
|
47
|
+
- Literal spelling of the setup check's `console.log(JSON.stringify(...))`.
|
|
48
|
+
- Literal `predictedTeam` assignment and signup return-object spelling.
|
|
49
|
+
- Presence of the setup policy/default-preservation throw statements.
|
|
50
|
+
|
|
51
|
+
These groups are the content at lines 136–138, 152–153 and 227–229 of the
|
|
52
|
+
spec's pinned source, kernel `3a5503c2993a307a0bb48d0b41dcab7d175adc27`.
|
|
53
|
+
Their line numbers moved in later main commits. Other provider-source checks
|
|
54
|
+
(the four-code loop, root construction, invite output and floor extraction)
|
|
55
|
+
remain; this change claims no blanket conversion of the steward file.
|
|
56
|
+
|
|
57
|
+
The prose test “getting-started: a join never runs aw team ensure”, at the
|
|
58
|
+
original 3a5503c2 lines 541–549, remains. It guards the documented workflow
|
|
59
|
+
contract in [the getting-started skill](../../skills/oats-getting-started/SKILL.md):
|
|
60
|
+
team creation belongs only to step 5 for a new workspace; joining an existing
|
|
61
|
+
workspace must not create a second team. The broker-before-spawn and later
|
|
62
|
+
souls.launch/reviewer-model guidance guards also remain, separately; the
|
|
63
|
+
launch-preference contract is documented in
|
|
64
|
+
[the launch preference design](2026-09-28-soul-launch-preference.md).
|
|
65
|
+
|
|
66
|
+
## Container checks
|
|
67
|
+
|
|
68
|
+
The entrypoint test now checks command/argument structure (one final `exec`
|
|
69
|
+
to the installed supervisor, NSS export and host-key command) and the Docker
|
|
70
|
+
`COPY` instruction, instead of matching word fragments.
|
|
71
|
+
|
|
72
|
+
The auth test invokes the real acceptance orchestration through an injected
|
|
73
|
+
Docker subprocess boundary. Its strict double returns nonzero and prints
|
|
74
|
+
unexpected argv. It checks the complete emitted Claude command, scratch-cwd
|
|
75
|
+
program and absence of a Docker `--workdir` pointing at the instance. This
|
|
76
|
+
pins orchestration argv; it captures and asserts the simulated report rather
|
|
77
|
+
than printing fixture PASS receipts, and does not claim Docker accepted it. Team-image CI
|
|
78
|
+
owns real image/container acceptance. Production still defaults to
|
|
79
|
+
`spawnSync`, and the CLI calls the orchestration exactly as before.
|
|
80
|
+
|
|
81
|
+
The provider's `test/kernel-module-boundary.test.mjs` remains a legitimate
|
|
82
|
+
static module boundary check and is not removed or weakened by this work.
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# K2 retirement audit against oats.aweb v1.44.0
|
|
2
|
+
|
|
3
|
+
Release: `v1.44.0`, peeled commit `5d1c6720bdf60a16379f8486c7d3f6f972294279`.
|
|
4
|
+
Transfer merge: `dc90c9556e58d03a80da9c5b3e6ed6139f22471e`; `git merge-base --is-ancestor dc90c955 v1.44.0` exits 0 in the owned `.work-aweb-audit` tree.
|
|
5
|
+
Original assertion inventory: kernel `3a5503c2993a307a0bb48d0b41dcab7d175adc27`.
|
|
6
|
+
Released transfer manifest: [docs/kernel-test-transfer.md](https://github.com/awebai/oats-aweb/blob/v1.44.0/docs/kernel-test-transfer.md) (17 + 11 + 9 + 19 = 56 rows).
|
|
7
|
+
This is a static assertion match, not a run of provider tests or a claim about a CI result. Of the 47 original rows in hook-1-10, hook-1-12 and hook-1-13, three native opt-ins were already removed by PR #1992; this change retires the other 44. Hook-1-12-1's nine rows remain under the hold below.
|
|
8
|
+
|
|
9
|
+
Package test files below are at that exact released commit. Titles/behaviour identify cases independently of line shifts. `hook13` means `test/oats-aweb-hook-1-13.test.mjs`; other short names are files under `test/` with `.test.mjs` suffix. The old kernel files run provider binaries directly and never the kernel hook runner.
|
|
10
|
+
|
|
11
|
+
## hook-1-10 — 17 rows
|
|
12
|
+
|
|
13
|
+
| Original line | Released covering assertion or explicit retirement reason |
|
|
14
|
+
| --- | --- |
|
|
15
|
+
| 145 | hook13 normal global grants: scopes, custody-before-mint order, socket/team/cwd/env and written grant home. Old brief spelling is superseded by current messaging text. |
|
|
16
|
+
| 165 | hook13 attachment verification failure vectors: mismatch/missing socket fails, revokes actual fake-service grant and removes home. |
|
|
17
|
+
| 177 | hook13 fresh launch renewal: new home/locator, written grant, old grant revoke and service state. |
|
|
18
|
+
| 192 | hook13 recorded-final-locator readiness: wrong/newer unattached home cannot override selected locator. Old unconditional ready expectation is superseded because broker evidence is now required. |
|
|
19
|
+
| 209 | resident-journey printedStepsJourney: minted disposable grant copied without socket_path, real custody status exits nonzero with missing locator. Replaces external optional fixture. |
|
|
20
|
+
| 222 | 1-18 session runtime matrix, fatal register/refused transition and retire deregister; new “an unrecognized delivery setting uses the channel route for Claude” covers fallback explicitly. |
|
|
21
|
+
| 255 | 1-18 codex/claude/pi transitions, registration-state assertions, refusal to leave two paths and side-effect-free preview cases. |
|
|
22
|
+
| 292 | 1-17-4 killed/deadline mint returns confirmed identity for compensation; killed-mint-240 retains intent cleanup/redaction. Old test never invoked kernel compensation. |
|
|
23
|
+
| 304 | 1-17-4 “retire recovers an alias missing from meta from the workspace binding”: exact delete argv uses recovered alias. |
|
|
24
|
+
| 317 | 1-17-4 alias-held first/retry receipts and successful self-delete retry: aliasReusable, persisted completion, exactly one delete. Old arbitrary native reason spelling is superseded by current native reason handling. |
|
|
25
|
+
| 341 | 1-17-4 alias-held refusal, no meta, redaction and --name remedy; killed-mint-240 covers refusal intent removal. |
|
|
26
|
+
| 356 | oats-aweb 64/65-character alias test plus 1-17-4 exactly one init --join-from from home: exact argv and absence of separate token/invite route. |
|
|
27
|
+
| 389 | retained-seat-killed-spawn-228 “retained authority closure, copy exclusions, command sequence and lock do not depend on a spawner PID”; copied bytes, exclusions, lock.home/no pid, no API-key leak/no mint. retained-seat-modes checks private directories and files at all nested depths plus source unchanged; lock-227/-236/restart-226 own takeover/source retention. Old check --online tuple intentionally superseded by native status/whoami (#276). |
|
|
28
|
+
| 439 | retained-seat-killed-spawn-228 rollback vector “a status pointing elsewhere”: second connect in original cwd, copied state and lock absent, source key preserved. |
|
|
29
|
+
| 457 | Same test vector “a whoami with another DID”: same restoration/cleanup assertions. |
|
|
30
|
+
| 469 | retained-seat-restart-226 local identity and no grant/custody calls; 1-14 retained retirement drops lock while preserving retained primary. |
|
|
31
|
+
| 484 | retained-seat-killed-spawn-228 vector “wake registration refused after connect”: restore original binding, remove copied authority/lock, preserve source. |
|
|
32
|
+
|
|
33
|
+
## hook-1-12 — 11 rows
|
|
34
|
+
|
|
35
|
+
| Original line | Released covering assertion or explicit retirement reason |
|
|
36
|
+
| --- | --- |
|
|
37
|
+
| 126 | 1-17-4 byte-for-byte local spawn output across runtime/delivery and 1-18 channel matrix cover metadata/env/launch. |
|
|
38
|
+
| 141 | hook13 parameterized “global spawn refuses missing resident name” and “unresolved resident”: fatal remedy before mint. |
|
|
39
|
+
| 156 | hook13 “global spawn refuses retained source in global mode before mint”: both configuration keys in warning, no mint. |
|
|
40
|
+
| 167 | hook13 legacy grant receipt: full explicit scopes/90m TTL, seat/global metadata, env, exact mint and wake tuples, custody cwd/no inherited identity home. |
|
|
41
|
+
| 193 | hook13 wrong minted team, both successful/failed compensation: service team/status, retained seat receipt, truthful live-grant metadata/remedy, team-qualified revoke cwd/no caller identity. |
|
|
42
|
+
| 209 | hook13 global post-mint wake-register failure: actual revoked service state, absent grant metadata/home, retained seat receipt, correct custody cwd/env. |
|
|
43
|
+
| 223 | hook13 no-JSON mint, revoke failure=false: id recovered from grant.yaml, exact team-qualified revoke/custody cwd/env, actual revoked state, home removed, truthful warning. |
|
|
44
|
+
| 237 | Same no-JSON case failure=true: actual active state, compensation grant metadata and remedy, home removed, no false revoked claim. The transfer preserves the current removal policy; it does not endorse a new policy. |
|
|
45
|
+
| 250 | hook13 global retire uses custody, caller identity cleared, exact revoke, wake deregister and identityRevoked. |
|
|
46
|
+
| 267 | hook13 uncertain-revoke show-status revoked/active vectors: show invoked for current team/id; retired/identityRevoked only on revoked, active fails and warns. |
|
|
47
|
+
| 281 | hook13 missing-id retire now uses documented nothing-to-delete; never-grant failed revoke covers finite expiry and never-grant remedy plus successful retry. Old nothing-to-revoke assertion is deliberately rejected by K1's kernel contract. The base also asserted hookCleanupComplete against the real mirror answer; that kernel integration survives in test/aweb-mirror-retire-contract.test.mjs, while K1's lifecycle runner test remains unchanged. |
|
|
48
|
+
|
|
49
|
+
## hook-1-12-1 — 9 rows retained
|
|
50
|
+
|
|
51
|
+
**Hold:** this entire file remains unchanged at the pin merge. Its current
|
|
52
|
+
base test at lines 217–222 was adapted for oats-aweb#286: the onboarding menu
|
|
53
|
+
must show `--invite-stdin` and must never show `--invite <token>`. Released
|
|
54
|
+
v1.44.0 emits that menu but has no test of these two menu assertions. The
|
|
55
|
+
original audit keyed to 3a5503c2 incorrectly classified this adapted current
|
|
56
|
+
behaviour as obsolete prose. Retire this file only after the package carries
|
|
57
|
+
those assertions in a released version and the kernel pins it. The parent
|
|
58
|
+
owns that provider follow-up (decision `6403afb0-8600-4c17-972f-595818e6b90c`).
|
|
59
|
+
The other eight rows are retained with it until that gate is satisfied.
|
|
60
|
+
|
|
61
|
+
| Original line | Released covering assertion or explicit retirement reason |
|
|
62
|
+
| --- | --- |
|
|
63
|
+
| 115 | oats-aweb roots[team] before root/workspace primary spawn: selected authority, one mint from new home, .aw env, no separate invite/join. |
|
|
64
|
+
| 144 | oats-aweb explicitly selected empty root: refuses rather than falling back to working workspace root, names selected root/current setup remedy, no init. Old classic/bounded prose is obsolete. |
|
|
65
|
+
| 167 | oats-aweb authority discovery does not walk above workspace: ancestor authority cannot mint. |
|
|
66
|
+
| 191 | 1-14 classic OATS environment refuses spawn/setup/binding before any aw call. |
|
|
67
|
+
| 205 | RETAIN: current base #286 menu assertions require --invite-stdin and forbid --invite <token>; no released v1.44.0 menu test pins them. Other setup acts cover missing team/root but do not cover this token-hygiene menu contract. |
|
|
68
|
+
| 224 | workspace-readiness-wire binding-less check pins ready result and read-only wake read; no-team readiness/spawn test pins actionable failure. Retire old combined error ordering: current no-team result and broker prerequisites supersede it. |
|
|
69
|
+
| 254 | 1-15 unmapped default refuses both spawn and binding; no init or team calls/active-team fallback. |
|
|
70
|
+
| 277 | 1-15 removed settings.team refuses spawn and binding with zero native effects. |
|
|
71
|
+
| 298 | setup-team-roots / setup-invite-56 / 1-21 current invite combinations cover explicit deployment/join and token redaction. Retire old argument/help prose where current native invite inspection now supports token-only joining; no old refusal is claimed as still required. |
|
|
72
|
+
|
|
73
|
+
## hook-1-13 — 19 rows
|
|
74
|
+
|
|
75
|
+
| Original line | Released covering assertion or explicit retirement reason |
|
|
76
|
+
| --- | --- |
|
|
77
|
+
| 164 | hook13 normal grants scopes, custody ordering, socket/team/cwd/env and materialized home. |
|
|
78
|
+
| 185 | hook13 reviewer/default/explicit scopes and unknown profile refusal. |
|
|
79
|
+
| 207 | hook13 typed custody failure/status/errors and serve remedy before mint. |
|
|
80
|
+
| 219 | hook13 grant-status endpoint readiness, missing readiness compatibility, required certificate. |
|
|
81
|
+
| 242 | hook13 real floor custody preflight case: explicit Claude runtime, native needs-configuration/custody_unavailable and no grant minted. v1.44.0 CI unit job provisions AW_REAL_CLI_BIN and zero-skips gate; this audit does not claim a CI run succeeded. |
|
|
82
|
+
| 260 | resident-journey real minted missing-socket case, as hook10:209; removes duplicate external fixture. |
|
|
83
|
+
| 271 | hook13 missing E2EE ops refuses; explicit e2ee:false permits signing-only with warning. |
|
|
84
|
+
| 287 | hook13 single aw floor refuses old binary before mint, always passes team. |
|
|
85
|
+
| 305 | hook13 all attachment verification failures revoke service grant and remove home. |
|
|
86
|
+
| 326 | hook13 missing preflight socket refuses before mint/home creation. |
|
|
87
|
+
| 337 | hook13 grant.yaml alias overrides mint alias, resident fallback only when both absent. |
|
|
88
|
+
| 352 | hook13 recorded-final-locator readiness supersedes old ready-without-broker assertion, as hook10:192. |
|
|
89
|
+
| 372 | hook13 renewal off retains locator/metadata, session env and registration on existing grant. |
|
|
90
|
+
| 386 | hook13 local renew=launch retains local identity env and delivery without grant renewal. |
|
|
91
|
+
| 398 | hook13 fresh renewal writes new home, emits exact locator and revokes old grant. |
|
|
92
|
+
| 416 | hook13 mint failure keeps old home/locator/grant and warns without old revoke. |
|
|
93
|
+
| 432 | hook13 failed attachment/missing preflight keeps old grant; any failed newly minted grant is revoked/removed. |
|
|
94
|
+
| 461 | hook13 old revoke failure warns truthfully and keeps newly active grant/home. |
|
|
95
|
+
| 474 | hook13 retire current grant id and every .aweb-identity directory; additional custody cwd/env/wake tuple in transferred retire test. |
|
|
96
|
+
|
|
97
|
+
## Satisfied retirement gates
|
|
98
|
+
|
|
99
|
+
K1 #1950 merged as 6b69263e66bdb29f802c7f4b8aef75edfe057bc4. Keep `test/retire-hook-contract.test.mjs` unchanged; it exercises kernel consumption in ordinary retire, rollback, quarantine retry and outstanding hook debt.
|
|
100
|
+
OATS #1989 merged as `6d3d282ede454567232c7ec0fca978773c03b84a`, this
|
|
101
|
+
branch's ancestor. The branch is rebased onto PR #1992 merge
|
|
102
|
+
`e98b719563c24733322b77926b57e676f223970a`. The catalog pins `v1.44.0`. A read-only Git-object comparison
|
|
103
|
+
matched all 70 mirrored blobs, their executable modes/symlink targets and the
|
|
104
|
+
complete file/directory set to that release. No mirror bytes were edited.
|
|
105
|
+
|
|
106
|
+
This change removes exactly three direct-provider suites:
|
|
107
|
+
`test/oats-aweb-hook-1-10.test.mjs`, `test/oats-aweb-hook-1-12.test.mjs`,
|
|
108
|
+
`test/oats-aweb-hook-1-13.test.mjs`.
|
|
109
|
+
`test/oats-aweb-hook-1-12-1.test.mjs` remains unchanged under the hold above.
|
|
110
|
+
The table above records every source test, its released covering case or
|
|
111
|
+
specific superseded/prose reason, and the hold for the uncovered menu case. The released package retains the regression
|
|
112
|
+
coverage; no direct-provider suite is renamed as kernel integration evidence.
|
|
113
|
+
Release-lane adaptations outside the retired files remain, as does K1's kernel
|
|
114
|
+
contract test. The new mirror/classifier test retains the base-state bridge
|
|
115
|
+
and rejects any native aw call at its boundary. No production code or deployment contract changes.
|
|
116
|
+
|
|
117
|
+
The maintainer authorized retirement after both merges and this released-row
|
|
118
|
+
match (parent decisions `cef42455-e66b-405e-87bc-a2edd82f2695` and
|
|
119
|
+
`e55641a6-1e17-4b71-98a4-6436c1293b0d`). The pre-deletion plan and complete
|
|
120
|
+
row table were sent as `4b923d01-236a-4c44-8a03-2c268f42a684`.
|
|
121
|
+
Full CI was not run locally; it runs after parent acceptance and PR creation.
|
|
122
|
+
|
|
123
|
+
The r1 findings were accepted in parent decision `6403afb0-8600-4c17-972f-595818e6b90c`: split the retirement, keep the current token-hygiene test until released coverage, and preserve the real mirror/classifier bridge in a small kernel test.
|