ADR 0192: a tools bundle declares what it is given, and the runtime hands it to that bundle alone; research 020 graduated; design 38 WP4b #321

2026-10-03T13:18:32Z

mesh-admin commented

2026-10-03 13:18:32 +00:00

Graduates research 020 (playbook 02). Decided: a tools bundle declares env on its artifact — paths and constants with the composer's references (${dir:…}, ${port:…}), never a secret's content; the controller composes it per bundle per machine beside the bundle's archive, restart-on included; the runtime hands each bundle its own environment (the contributor's argument for an imported bundle, the child's environment for a launched one) and keeps them apart. Options 2–4 (runtime-derived convention, asking over the bus, each module its own way) rejected with reasons. Checks table names the catalogue check, the composition test, the two-bundle isolation test and the live proof.

Design 38 gains WP4b — every tool container moves — with the build order and the proof. Research 020 closed as graduated, became: set. Checks pass.

Graduates research 020 (playbook 02). Decided: a tools bundle declares `env` on its artifact — paths and constants with the composer's references (`${dir:…}`, `${port:…}`), never a secret's content; the controller composes it per bundle per machine beside the bundle's archive, `restart-on` included; the runtime hands each bundle its own environment (the contributor's argument for an imported bundle, the child's environment for a launched one) and keeps them apart. Options 2–4 (runtime-derived convention, asking over the bus, each module its own way) rejected with reasons. Checks table names the catalogue check, the composition test, the two-bundle isolation test and the live proof. Design 38 gains WP4b — every tool container moves — with the build order and the proof. Research 020 closed as graduated, `became:` set. Checks pass.

mesh-admin added 1 commit 2026-10-03 13:18:33 +00:00

ADR 0192: a tools bundle declares what it is given, and the runtime hands it to that bundle alone; research 020 graduated; design 38 WP4b 4c1ad0ed45

mesh-admin merged commit c5778f4366 into main

2026-10-03 13:18:41 +00:00

mesh-admin deleted branch decision/0192-what-a-bundled-tool-is-given

2026-10-03 13:18:41 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: novox/hq#321