Public release readiness — parent #268 verification
Status: RELEASED. 0.1.0-rc.2 is live on npm and as GitHub prerelease v0.1.0-rc.2; the public-registry install smoke passes. Date: 2026-11-17 Spec: #268 Release ticket: #278 Released package: @heyimteee/ensemble@0.1.0-rc.2 Public release: https://github.com/heyimteee/ensemble/releases/tag/v0.1.0-rc.2 npm dist-tags: latest: 0.1.0-rc.2, next: 0.1.0-rc.2 Final-tip runtime evidence: b194b95 (2.2.7 install, fake E2E, 4-hour soak; includes #281–#284) Final-tip install and support check: a0c39c0 (2.2.7 install, OpenCode 2.3.0 Linux support; includes #285 and #286) Integration tip for required checks: a7f1eb3 (includes #287; Verify, Compatibility, Docs, and Node Matrix green on the first attempt, no rerun) Release closeout tip: 7efd9a6 (merge of closed #277; docs-only after a7f1eb3) macOS install check: 70f3da7 build; full macOS/Herdr checklist PASS on OpenCode 2.2.7; automatic copy-on-release and macOS 2.3.0 are not claimed Verification tag: rc-0.1.0-rc.2 at d74fc3d (pre-fix evidence base; not a publish source) Public version/tag: 0.1.0-rc.2 / v0.1.0-rc.2; release commit ccd13eb; main 76e5b07
This record documents the released state for #268. It does not close #278 or #268. Every verification gate is PASS, the public release exists, and the public-registry install smoke passes; the launch announcement remains a separate, unclaimed decision.
Version and tag decision
- The released version is
0.1.0-rc.2. package version andpackage-lock.jsonagree. This docs correction does not bump or rebuild the package;prepackbuilt the published tarball from the tagged release commit. rc-0.1.0-rc.2is an evidence tag, not the release tag. It points atd74fc3d, which predates the #281–#284 fixes. It is useful as a base for comparison only. Do not publish from it.- The product runtime under test is unchanged from
b194b95. #285 changes the CI workflows and contract checker; #286 adds the OpenCode 2.3.0 host range, compatibility matrix entry, and harness adjustments; #287 hardens the live TUI readiness and test ordering with no product runtime change. The final-tip install ata0c39c0is separately PASS, and the 2.2.7 soak atb194b95still describes the 2.2.x workload. - The public prerelease is cut. Tag
v0.1.0-rc.2is on release commitccd13eb; npm serves0.1.0-rc.2. The release workflow published with--tag next, but npm requireslatestand rejects deleting it, so bothlatestandnextpoint at the RC while it is the only version. Pin the exact version; a stable release will movelatest. 0.1.0is not cut. A final stable version is a separate decision after this candidate has run. The published RC ownslatestonly because no other version exists.
Final-tip evidence
The final-tip checks include loopback-registry and fake-provider checks, plus the post-publish public-registry smoke. b194b95 supplies the earlier 2.2.7 install and soak; a0c39c0 supplies the final-tip install, the 2.3.0 support checks, and the 2.2.7/2.3.0 fake E2E; the released tarball installs from npm on 2.2.7 and 2.3.0.
| Check | Result | Details |
|---|---|---|
Clean install at a0c39c0 | PASS | Isolated OpenCode 2.2.7 / Node 26.12.1: 507,907 bytes; six native server tools, installed TUI route, and /ensemble loaded. |
Clean install at b194b95 | PASS | 124 runtime files, 507,824 bytes; plugin list reported ensemble.v2 0.1.0-rc.2 from the package; six tools, TUI route, and /ensemble loaded. |
Deterministic fake E2E at a0c39c0 | PASS | OpenCode 2.2.7 and 2.3.0; fake 416 s on each host. |
| 4-hour soak on OpenCode 2.2.7 | PASS | 240 samples over 14,439 s, 5,234 messages, 0 failures; baseline/tail/peak RSS 672.8/1,010.09/1,153.89 MiB; growth 92.59 MiB/h (gate 256) and 18.71 MiB/1k messages (gate 64); queue/native settled, no findings. |
| 4-hour soak on OpenCode 2.3.0 | PASS | 240 samples over 14,439 s, 5,240 messages, 0 failures; baseline/tail/peak RSS 688.91/1,034.59/1,229.56 MiB; growth 94.89 MiB/h (gate 256) and 19.14 MiB/1k messages (gate 64); queue/native settled, no findings. |
| Full macOS checklist (#277) | PASS | 1.7 pane-bounded Shift+drag over the composer marker, explicit copy_to_clipboard, statusline/mode/focus unchanged. Automatic copy-on-release is not claimed (Ghostty copy-on-select off). |
| Public-registry install smoke | PASS | OpenCode 2.2.7 and 2.3.0, Node 26.12.1; @heyimteee/ensemble@0.1.0-rc.2 from npm; six tools, TUI route, /ensemble with no plugin failure. See Public-registry smoke. |
Both soak runs are recorded in the soak record. The 2.3.0 run predates the formal host-range merge but is now a supported-host result.
Public-registry smoke
After the release, opencode plugin add @heyimteee/ensemble@0.1.0-rc.2 was run from the public npm registry on OpenCode 2.2.7 and 2.3.0 with Node 26.12.1. On both hosts:
opencode plugin listreportedensemble.v2 0.1.0-rc.2from the public package source.- The plugin record matched the package source target and version, reported server/TUI/RPC true and active, and loaded its entrypoint from the public plugin cache, never the repository.
- One host turn reported
ensembleToolCount 6. /ensemblerenderedENSEMBLE │ no workspacewith no plugin failure.- Each version used isolated HOME/XDG/project/cache roots; services were stopped and directories removed. Both repositories were clean afterward.
The public install supersedes the loopback-registry proof for the released artifact. The GitHub release v0.1.0-rc.2 is marked prerelease and carries the tarball, CycloneDX SBOM, CHANGELOG, and release notes.
OpenCode 2.3.0 support (#286)
#286 merged at a0c39c0. The supported range is now 2.2.6 || 2.2.7 || 2.3.0; the compatibility matrix and required contexts include 2.3.0, and ruleset 27380159 was updated with the OpenCode 2.3.0 context.
On Linux, OpenCode 2.3.0 passes the host probe 14/14, the size matrix, the deterministic fake E2E (416 s), and the loopback install. OpenCode 2.2.7 fake E2E still passes at 416 s. macOS/Herdr remains verified on 2.2.7 only; 2.3.0 macOS is not claimed.
The required CI at a7f1eb3 is green for all three host versions, first attempt, with no job rerun.
#286 also updates the canonical README, support matrix, implementation note, compatibility page, and docs-check fixtures at a0c39c0. This release-docs branch records the release evidence and does not duplicate those canonical edits; they resolve when #286 is in the merge base.
Live TUI readiness (#287)
#287 merged at a7f1eb3 and is closed. The root cause was a harness false positive, not lost input: after Backspace the command line was :setting; retyping s restored the previous :settings pane, so live_type saw no pane change and reported typed text did not reach the TUI: s. The fix waits for :settings to disappear before retyping and gates input on a rendered statusline. live_open_ensemble now forces the configured geometry and waits for the statusline before returning. There is no product runtime change, and the fix is covered by 2,121 tests.
Required CI at a7f1eb3
At a7f1eb3, every required workflow is green on the first attempt with no job rerun:
| Workflow | Result | Notes |
|---|---|---|
| Verify | PASS | verify, live-fake, live-native, live-multilocation, and latency-smoke green. |
| Compatibility | PASS | OpenCode 2.2.6, 2.2.7, and 2.3.0 green. |
| Docs | PASS | Documentation check green. |
| Node Matrix | PASS | Node matrix green. |
The earlier a0c39c0 Compatibility failure and the 4ccc410 job reruns are superseded by this run. 4ccc410 was green after one rerun of failed jobs on Verify and Compatibility (filtering spawned fd per keystroke (13 -> 14) and typed text did not reach the TUI: s); that history is retained for traceability, not as current release evidence.
Readiness list
| Ticket | Result | Evidence | Notes |
|---|---|---|---|
| #269 MIT license and package identity | PASS | record | MIT text, scoped @heyimteee/ensemble name, public publish metadata, runtime-only contents allowlist. |
| #270 Clean-install release candidate | FAIL for 0.1.0-rc.1; superseded | record | Server install passed; the source TUI entry failed to load. The failure motivated the built package and is not hidden. |
| #271 Security and privacy audit | PASS | record | Threat model, permission review, accepted risks, Dependabot, production audit clean, handoff symlink containment fix. |
| #272 Data retention/export/delete and roster disclosure | PASS | record | Scoped data.export/data.delete, retention policy, and AGENTS v7 title/role disclosure guidance. |
| #273 Backup/restore and upgrade/rollback | PASS for state rollback; package downgrade PENDING | record | Versioned backup, automatic rollback slot, injected-failure rehearsal, doctor on restored state. No previous public package exists to rehearse a real downgrade. |
| #274 Operations runbook, support intake, and templates | PASS | record | Support channel, response targets, incident runbook, support matrix, issue/PR forms with redaction rules. |
| #275 Release workflow, branch protection, and provenance | PASS | record | Applied main ruleset, tag-only publish, token-free dry run, provenance, SBOM, changelog-based GitHub release. Published v0.1.0-rc.2; npm has both latest and next at the RC. |
| #276 Scale/soak and no-telemetry policy | PASS for 4h on 2.2.7 and 2.3.0 | record, soak record | Soak harness, operating envelope, redacted local support bundle, no telemetry. The enforced 4-hour gate passed on both supported hosts at b194b95. |
| #277 macOS/Herdr verification via SSH | PASS / CLOSED | record | Installed package, six tools, TUI route, full manual checklist including 1.7 pane-bounded Shift+drag with explicit copy, fake E2E, size matrix. No checklist item unrun. Automatic copy-on-release is not claimed (Ghostty copy-on-select off); Herdr prefix control inconclusive. Closed at 7efd9a6. |
| #278 Changelog, release notes, and launch sign-off | PASS for release; announcement PENDING | sign-off, notes, launch plan | Version decision, changelog, public notes, sign-offs, launch plan, and this record. The tag, publish, provenance, GitHub release, and public-registry smoke are complete; the announcement is a separate decision. |
| #279 Built package for the installed TUI plugin | PASS | record | Solid-compiled dist, 121 built JS files, runtime dependencies resolve from the plugin cache, installed TUI route and /ensemble pass. |
| #280 Build the server and TUI for the production package | PASS | record | Build produces server, TUI, and RPC entries; exports point at dist; pack guard passes. |
| #281 Interrupted init leaves the AGENTS.md block in place | PASS | record | SIGKILL mid-init restores byte-identical prior content, clears restorePending, and removes .ensemble/init.json; no-prior-file case passes. |
| #282 NO_COLOR Work and Braille decoration | PASS | record | Work card, borders, statusline, and backgrounds resolve to default foreground with no background. |
| #283 Work feed after service restart | PASS | record | Feed reconnects from durable state with one group header and one card, no manual reload. |
| #284 NO_COLOR transcript colors | PASS | record | Agent author and Markdown scopes resolve to default foreground with no background; control run keeps color. |
#285 CI live jobs omit the dist build | PASS / CLOSED | issue, CI section | Release-blocking CI regression: after the built-package flip, live jobs and compatibility ran npm ci without npm run build. Fixed at 4ccc410 by building dist in the live-host action and compatibility workflow; the contract test requires the build. |
| #286 Support OpenCode 2.3.0 | PASS / CLOSED | issue, 2.3.0 section | Supported range `2.2.6 |
| #287 Harden live TUI readiness | PASS / CLOSED | record, CI section | Harness false positive after Backspace (:setting → retype s → :settings restored) and header-only readiness. Statusline-gated open, configured geometry, deterministic retype ordering. No product runtime change; 2,121 tests. |
Closed child and follow-up tickets represented above: #269–#277 and #279–#287. #278 remains open. #268 closes only after the final release record and the remaining announcement decision.
What is proven
- The published
0.1.0-rc.2package installs from the public npm registry on OpenCode 2.2.7 and 2.3.0 / Node 26.12.1.opencode plugin listreportsensemble.v2 0.1.0-rc.2from the public package source; the record reports server/TUI/RPC true and active; one host turn reportsensembleToolCount 6;/ensemblerenders with no plugin failure. The final-tip loopback install ata0c39c0passed at 507,907 bytes; the earlierb194b95install passed at 124 runtime files and 507,824 bytes. - The public GitHub release
v0.1.0-rc.2exists and is marked prerelease, with the tarball, CycloneDX SBOM, CHANGELOG, and release notes attached. npm serves0.1.0-rc.2; bothlatestandnextpoint at it because it is the only published version and npm requireslatest. - The final-tip local deterministic fake E2E passes on OpenCode 2.2.7 and 2.3.0 with
fake416 s on each host. OpenCode 2.3.0 also passes the host probe 14/14, the size matrix, and the loopback install (#286). - The fixed runtime (#281–#284) was rebuilt and installed on macOS through the same path, loads the TUI in Herdr/Ghostty, and passes the deterministic fake E2E and size matrix (#277).
- The full manual macOS checklist passes, with no unrun item: items 1.1–1.10, including 1.7 pane-bounded Shift+drag over the composer marker followed by explicit
copy_to_clipboard; sections 2–9 cover Cmd+C/Cmd+V, init lifecycle, palette, motion, Work cards, toast, reduced motion,NO_COLOR, and v7 dispatch groups. The statusline stayedINSERT │ COMPOSER │ Group chat; mode/focus were unchanged. Automatic copy-on-release is not claimed because Ghosttycopy-on-selectis off. - The #281–#284 fixes were re-verified on the installed macOS candidate without screenshots or pointer input; 1.7 is recorded from the real pointer session.
- The enforced 4-hour soak at
b194b95passes on both supported hosts. OpenCode 2.2.7: 240 samples, 14,439 s, 5,234 messages, 0 failures, 92.59 MiB/h and 18.71 MiB/1k messages. OpenCode 2.3.0: 240 samples, 5,240 messages, 0 failures, 94.89 MiB/h and 19.14 MiB/1k messages. Both had settled queue/native state and no findings. - Required CI at
a7f1eb3is green on the first attempt with no job rerun: Verify (verify,live-fake,live-native,live-multilocation,latency-smoke), Compatibility (OpenCode 2.2.6, 2.2.7, and 2.3.0), Docs, and Node Matrix. npm run verifyandnpm run docs:checkpass on this branch (2,121 tests); the release gate is the green required CI ata7f1eb3.
What is pending or not claimed
- A real package downgrade has not been rehearsed, because there is no previous public version. State rollback is rehearsed. This is the only inherent release gap.
- The launch announcement has not been made. It is a separate decision; the release itself is published.
- The prerelease owns npm
latest. Bothlatestandnextpoint at0.1.0-rc.2because it is the only version. npm requireslatestand rejects deleting it (E400). Pin the exact version; a stable release will movelatest. - Automatic copy-on-release is not claimed. The 1.7 mouse pass used Shift+drag plus explicit copy; Ghostty
copy-on-selectis off. This is a host preference, not Ensemble behavior. - macOS/Herdr on OpenCode 2.3.0 is not claimed. macOS/Herdr is verified on 2.2.7 only; the 2.3.0 support claim is Linux-verified.
- Herdr prefix ownership is inconclusive host evidence, not a checklist FAIL. No Ensemble key was observed to be intercepted.
- Git-spec installs fail upstream in OpenCode 2.2.7 during Git dependency preparation. Use the npm package.
- Windows and WSL are out of scope and untested.
- macOS size-matrix load probe is Linux
/proc-only. Exact sizes pass with the load probe skipped; Braille rendering depends on terminal font fallback. - No telemetry is claimed. Diagnostics are local and must be redacted before sharing.
Release gates
| Gate | Status |
|---|---|
| MIT license and package identity | PASS |
| Runtime-only package contents | PASS |
Clean install through opencode plugin add | PASS for a0c39c0 (0.1.0-rc.2) |
| Final-tip deterministic fake E2E (OpenCode 2.2.7 and 2.3.0) | PASS |
| OpenCode 2.3.0 support (#286, Linux) | PASS |
| Live TUI readiness (#287) | PASS |
Six native tools, TUI route, /ensemble | PASS |
| Security and privacy audit | PASS |
| Data export/delete and retention policy | PASS |
| Backup/restore and state rollback rehearsal | PASS |
| Support intake and incident runbook | PASS |
| Release workflow, publish, and provenance | PASS |
Required CI at a7f1eb3 | PASS (first attempt, no rerun) |
| macOS install/TUI/fake E2E/full checklist | PASS |
| macOS mouse drag (1.7) | PASS (Shift+drag + explicit copy) |
| Automatic copy-on-release | NOT CLAIMED (host preference) |
| macOS/Herdr on OpenCode 2.3.0 | NOT CLAIMED |
| Real package downgrade rehearsal | PENDING (no previous version) |
| Public tag, publish, attestation, GitHub release | PASS |
| Public-registry install smoke (2.2.7 and 2.3.0) | PASS |
npm latest/next behavior | PASS with caveat (both point at the RC) |
| Announcement | PENDING / not claimed |
| 4-hour soak on OpenCode 2.2.7 | PASS |
| 4-hour soak on OpenCode 2.3.0 | PASS |
Commands run for this record
Environment: Node 26.12.1, npm 12.2.1, Linux Debian 13, OpenCode 2.2.7 and 2.3.0 for the installed checks.
npm run verify # PASS: 2,121 tests, 0 failed/skipped
npm run docs:check # PASS: contract v7; OpenCode 2.2.6, 2.2.7, 2.3.0; Node >=22.23.4
node --experimental-strip-types scripts/release-guard.mjs \
--event workflow_dispatch --ref refs/heads/main \
--manifest package.json --changelog CHANGELOG.md \
--out /tmp/opencode/ensemble-278-release-notes.md
# PASS: manual dispatch -> 0.1.0-rc.2 (dry run, next); notes extractedRequired CI at a7f1eb3 was read from GitHub Actions (this docs-only pass did not rerun CI): Verify, Compatibility, Docs, and Node Matrix are green on the first attempt, with no job rerun. The earlier a0c39c0 Compatibility failure and the 4ccc410 reruns are superseded by this run and are recorded in the CI section.
Final-tip evidence, recorded from the verification runs (this docs-only pass did not rerun it):
OPENCODE_BIN=<opencode-2.2.7>/bin/opencode npm run test:install:rc
# PASS: 507,907 bytes; six tools, TUI route, /ensemble
ENSEMBLE_LIVE_REQUIRE=1 npm run test:live:fake:all
# PASS on 2.2.7 and 2.3.0: fake 416 s on each host
ENSEMBLE_SOAK_OUT=<soak-out> npm run soak
# PASS on 2.2.7: 240 samples, 14,439 s, 5,234 messages, 0 failures
# PASS on 2.3.0: 240 samples, 14,439 s, 5,240 messages, 0 failuresPost-publish public smoke, recorded on OpenCode 2.2.7 and 2.3.0 with Node 26.12.1:
opencode plugin add @heyimteee/ensemble@0.1.0-rc.2
opencode plugin list
# ensemble.v2 0.1.0-rc.2 from @heyimteee/ensemble@0.1.0-rc.2
# plugin record: package source target/version match; server/tui/rpc true; active
# entrypoint: public plugin cache, never the repository
# host turn: ensembleToolCount 6
# TUI: /ensemble -> ENSEMBLE | no workspace; no plugin failureEach version used isolated HOME/XDG/project/cache roots; services were stopped and directories removed. The macOS checklist and 2.3.0 macOS/Herdr check were not rerun in this docs pass; their results are linked above.
Privacy and skips
No registry credential, real model, real workspace, screenshot, pointer input, host name, user name, private path, conversation content, or credential is included. The macOS re-verification used SSH, a detached tmux pane, RPC snapshots, and filesystem reads only. The public smoke installed the published package from the public registry; it did not use a repository link.
Skipped by design: Windows/WSL, OpenCode/Node versions outside the supported set, real model acceptance, package downgrade (no previous version), and macOS/Herdr on 2.3.0 (not claimed).