Skip to content

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 and package-lock.json agree. This docs correction does not bump or rebuild the package; prepack built the published tarball from the tagged release commit.
  • rc-0.1.0-rc.2 is an evidence tag, not the release tag. It points at d74fc3d, 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 at a0c39c0 is separately PASS, and the 2.2.7 soak at b194b95 still describes the 2.2.x workload.
  • The public prerelease is cut. Tag v0.1.0-rc.2 is on release commit ccd13eb; npm serves 0.1.0-rc.2. The release workflow published with --tag next, but npm requires latest and rejects deleting it, so both latest and next point at the RC while it is the only version. Pin the exact version; a stable release will move latest.
  • 0.1.0 is not cut. A final stable version is a separate decision after this candidate has run. The published RC owns latest only 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.

CheckResultDetails
Clean install at a0c39c0PASSIsolated OpenCode 2.2.7 / Node 26.12.1: 507,907 bytes; six native server tools, installed TUI route, and /ensemble loaded.
Clean install at b194b95PASS124 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 a0c39c0PASSOpenCode 2.2.7 and 2.3.0; fake 416 s on each host.
4-hour soak on OpenCode 2.2.7PASS240 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.0PASS240 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)PASS1.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 smokePASSOpenCode 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 list reported ensemble.v2 0.1.0-rc.2 from 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.
  • /ensemble rendered ENSEMBLE │ no workspace with 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:

WorkflowResultNotes
VerifyPASSverify, live-fake, live-native, live-multilocation, and latency-smoke green.
CompatibilityPASSOpenCode 2.2.6, 2.2.7, and 2.3.0 green.
DocsPASSDocumentation check green.
Node MatrixPASSNode 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 ​

TicketResultEvidenceNotes
#269 MIT license and package identityPASSrecordMIT text, scoped @heyimteee/ensemble name, public publish metadata, runtime-only contents allowlist.
#270 Clean-install release candidateFAIL for 0.1.0-rc.1; supersededrecordServer install passed; the source TUI entry failed to load. The failure motivated the built package and is not hidden.
#271 Security and privacy auditPASSrecordThreat model, permission review, accepted risks, Dependabot, production audit clean, handoff symlink containment fix.
#272 Data retention/export/delete and roster disclosurePASSrecordScoped data.export/data.delete, retention policy, and AGENTS v7 title/role disclosure guidance.
#273 Backup/restore and upgrade/rollbackPASS for state rollback; package downgrade PENDINGrecordVersioned 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 templatesPASSrecordSupport channel, response targets, incident runbook, support matrix, issue/PR forms with redaction rules.
#275 Release workflow, branch protection, and provenancePASSrecordApplied 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 policyPASS for 4h on 2.2.7 and 2.3.0record, soak recordSoak 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 SSHPASS / CLOSEDrecordInstalled 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-offPASS for release; announcement PENDINGsign-off, notes, launch planVersion 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 pluginPASSrecordSolid-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 packagePASSrecordBuild produces server, TUI, and RPC entries; exports point at dist; pack guard passes.
#281 Interrupted init leaves the AGENTS.md block in placePASSrecordSIGKILL 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 decorationPASSrecordWork card, borders, statusline, and backgrounds resolve to default foreground with no background.
#283 Work feed after service restartPASSrecordFeed reconnects from durable state with one group header and one card, no manual reload.
#284 NO_COLOR transcript colorsPASSrecordAgent author and Markdown scopes resolve to default foreground with no background; control run keeps color.
#285 CI live jobs omit the dist buildPASS / CLOSEDissue, CI sectionRelease-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.0PASS / CLOSEDissue, 2.3.0 sectionSupported range `2.2.6
#287 Harden live TUI readinessPASS / CLOSEDrecord, CI sectionHarness 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.2 package installs from the public npm registry on OpenCode 2.2.7 and 2.3.0 / Node 26.12.1. opencode plugin list reports ensemble.v2 0.1.0-rc.2 from the public package source; the record reports server/TUI/RPC true and active; one host turn reports ensembleToolCount 6; /ensemble renders with no plugin failure. The final-tip loopback install at a0c39c0 passed at 507,907 bytes; the earlier b194b95 install passed at 124 runtime files and 507,824 bytes.
  • The public GitHub release v0.1.0-rc.2 exists and is marked prerelease, with the tarball, CycloneDX SBOM, CHANGELOG, and release notes attached. npm serves 0.1.0-rc.2; both latest and next point at it because it is the only published version and npm requires latest.
  • The final-tip local deterministic fake E2E passes on OpenCode 2.2.7 and 2.3.0 with fake 416 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 stayed INSERT │ COMPOSER │ Group chat; mode/focus were unchanged. Automatic copy-on-release is not claimed because Ghostty copy-on-select is 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 b194b95 passes 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 a7f1eb3 is 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 verify and npm run docs:check pass on this branch (2,121 tests); the release gate is the green required CI at a7f1eb3.

What is pending or not claimed ​

  1. 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.
  2. The launch announcement has not been made. It is a separate decision; the release itself is published.
  3. The prerelease owns npm latest. Both latest and next point at 0.1.0-rc.2 because it is the only version. npm requires latest and rejects deleting it (E400). Pin the exact version; a stable release will move latest.
  4. Automatic copy-on-release is not claimed. The 1.7 mouse pass used Shift+drag plus explicit copy; Ghostty copy-on-select is off. This is a host preference, not Ensemble behavior.
  5. 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.
  6. Herdr prefix ownership is inconclusive host evidence, not a checklist FAIL. No Ensemble key was observed to be intercepted.
  7. Git-spec installs fail upstream in OpenCode 2.2.7 during Git dependency preparation. Use the npm package.
  8. Windows and WSL are out of scope and untested.
  9. macOS size-matrix load probe is Linux /proc-only. Exact sizes pass with the load probe skipped; Braille rendering depends on terminal font fallback.
  10. No telemetry is claimed. Diagnostics are local and must be redacted before sharing.

Release gates ​

GateStatus
MIT license and package identityPASS
Runtime-only package contentsPASS
Clean install through opencode plugin addPASS 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, /ensemblePASS
Security and privacy auditPASS
Data export/delete and retention policyPASS
Backup/restore and state rollback rehearsalPASS
Support intake and incident runbookPASS
Release workflow, publish, and provenancePASS
Required CI at a7f1eb3PASS (first attempt, no rerun)
macOS install/TUI/fake E2E/full checklistPASS
macOS mouse drag (1.7)PASS (Shift+drag + explicit copy)
Automatic copy-on-releaseNOT CLAIMED (host preference)
macOS/Herdr on OpenCode 2.3.0NOT CLAIMED
Real package downgrade rehearsalPENDING (no previous version)
Public tag, publish, attestation, GitHub releasePASS
Public-registry install smoke (2.2.7 and 2.3.0)PASS
npm latest/next behaviorPASS with caveat (both point at the RC)
AnnouncementPENDING / not claimed
4-hour soak on OpenCode 2.2.7PASS
4-hour soak on OpenCode 2.3.0PASS

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.

sh
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 extracted

Required 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):

sh
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 failures

Post-publish public smoke, recorded on OpenCode 2.2.7 and 2.3.0 with Node 26.12.1:

sh
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 failure

Each 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).

Released under the MIT License.