From 2b2e862d836e7be7c2a382b6a9b885a7f489631f Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 25 Oct 2026 12:56:45 -0700 Subject: [PATCH 1/2] docs(seats): explain CLI release and seat restart path MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Written by Nib, a Commonly agent — https://commonly.me/v2/pods/6addd51a7f8fc798a6f68063 Co-authored-by: nib Agent-Model: codex/gpt-6.1-sol/medium --- packages/seats/README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/packages/seats/README.md b/packages/seats/README.md index 990cbab2c0..989e2913d6 100644 --- a/packages/seats/README.md +++ b/packages/seats/README.md @@ -4,6 +4,20 @@ The adapters that run an agent CLI as a supervised seat: one prompt in, one CLI It is private and is not published on its own. `@commonlyai/cli` depends on it as `file:../packages/seats` and lists it in `bundleDependencies`, so it ships inside the CLI tarball. +## Release path + +- A push to `main` touching `cli/` or `packages/seats/` triggers + [npm publish](../../.github/workflows/npm-publish.yml). If the packed files changed, + it publishes the next CLI patch with seats bundled ([CLI package](../../cli/package.json)). + [Deploy Dev](../../.github/workflows/deploy-dev.yml) builds service images separately. +- The publish job assigns the version. PRs leave version lines alone + ([version guard](../../.github/workflows/package-version-guard.yml), TASK-466). +- Fleet seats use a pinned CLI. Update that pin and restart the seat to load a release. + Publishing to npm does not update an already running seat. +- Check the running wrapper's CLI path and the live spawn argv to see what it runs + ([diagnosis guide](../../docs/runbooks/diagnosing-a-silent-seat.md#2-read-the-live-spawn--the-prompt-is-in-argv)). + The registry describes configuration; it does not prove what was loaded. + **Rule:** nothing here imports Commonly code. An adapter that needs Commonly policy (the memory preamble, the legacy sandbox-trust names, the fleet seat-model switch) takes it as a host object through its factory, for example `createHermesAdapter(host)`. The CLI binds that host in `cli/src/lib/adapters/.js`. `cli/__tests__/seats-package.test.mjs` enforces the import rule and checks that the tarball carries every source file. The extraction plan is D62, extract-in-place. From 5b5dbbc385a7af725a6d51af9b6857050cd80d19 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 25 Oct 2026 12:58:15 -0700 Subject: [PATCH 2/2] docs(seats): locate operator pins and clarify manual deploy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Written by Nib, a Commonly agent — https://commonly.me/v2/pods/6addd51a7f8fc798a6f68063 Co-authored-by: nib Agent-Model: codex/gpt-6.1-sol/medium --- packages/seats/README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/packages/seats/README.md b/packages/seats/README.md index 989e2913d6..a69a9db15b 100644 --- a/packages/seats/README.md +++ b/packages/seats/README.md @@ -9,11 +9,12 @@ It is private and is not published on its own. `@commonlyai/cli` depends on it a - A push to `main` touching `cli/` or `packages/seats/` triggers [npm publish](../../.github/workflows/npm-publish.yml). If the packed files changed, it publishes the next CLI patch with seats bundled ([CLI package](../../cli/package.json)). - [Deploy Dev](../../.github/workflows/deploy-dev.yml) builds service images separately. + [Deploy Dev](../../.github/workflows/deploy-dev.yml) is manually dispatched and builds service images separately. - The publish job assigns the version. PRs leave version lines alone ([version guard](../../.github/workflows/package-version-guard.yml), TASK-466). -- Fleet seats use a pinned CLI. Update that pin and restart the seat to load a release. - Publishing to npm does not update an already running seat. +- Operator-pinned fleet seats select their CLI path in each seat's local `run.sh` launcher, + outside this repo. Update that pin and restart the seat to load a release. + Global CLI installs must be upgraded too; publishing does not update a running seat. - Check the running wrapper's CLI path and the live spawn argv to see what it runs ([diagnosis guide](../../docs/runbooks/diagnosing-a-silent-seat.md#2-read-the-live-spawn--the-prompt-is-in-argv)). The registry describes configuration; it does not prove what was loaded.