v2.1.0

Added

• Optional terra: true profile registers beads-task-agent-terra on openai/gpt-6.1-terra#medium, with the same scope-bounded guidance, permissions, step cap, actor attribution and Beads context eligibility as the existing task agents. The default agent still inherits its model; Luna Max is unchanged and both optional profiles can coexist. Provider access remains external; no silent fallback or model-quality guarantee is added.

Changed

• Align issue-writing and deliberate handoff guidance with attributed Beads excerpts; monitor the upstream license alongside the existing source inventory.
• Document native Claude Code and Codex Beads onboarding for orchestrated work: retain verified native integration, confirm actual context delivery and bind execution authority to the assigned Bead.
• Reconcile the validated Beads CLI baseline to 1.3.4 while preserving minimum 1.3.1, and add independent daily/manual advisory upstream-source comparison. These maintenance changes were already delivered on main; they do not introduce runtime repair or automatic adoption.

Compatibility and installation

• OpenCode >=2.2.6 <2.3; qualified host: 2.2.6.
• Beads minimum 1.3.1; validated CLI 1.3.4.
• Install @snarkipus/opencode-beads@2.1.0; enable terra: true only if you want the optional Terra Medium agent and have provider access. Luna remains supported.
• User guide · Terra qualification.

The documented historical-snapshot recovery limitation after native compaction and an incompatible model switch remains unresolved; Beads tracker data is unaffected. See OpenCode #57424.

v2.0.0

Changed

• Graduate the qualified native Beads integration from beta to the stable line: eleven permissioned operations, 29 workflow commands plus oc-beads:diagnostics, packaged guidance and scope-bounded task execution.
• Breaking: require OpenCode >=2.2.6 <2.3; upgrade OpenCode before selecting 2.0.0. No parallel 2.1 compatibility layer or automatic migration is provided; existing exact 1.x/beta pins remain available. Beads minimum remains 1.3.1.
• Reflect actual request capabilities: native composition when available, directly exposed Beads leaves when execute is unavailable, and independently permissioned direct shell. Preserve per-operation rejection, actor attribution and Stop/Cancel.

Fixed

• Restore durable workflow and once-captured diagnostic instructions after OpenCode 2.2 projects messages without metadata: resolve one native current-context snapshot map by retained user-message ID, with location/cancellation/generation checks and no new cache or side store.
• Reconcile README installation, migration and compatibility guidance with the accepted exact OpenCode 2.2.6 qualification. Runtime and packaged guidance are unchanged from the final Opus-reviewed candidate; version/README metadata create a new release artifact.

Known limitations

• Native compaction followed by switching to a model unable to replay the native window can leave older command instructions or captured diagnostics inaccessible. Report unavailable guidance instead of reconstructing it; Beads issue data is unaffected. Upstream #57424 / opencode-beads-o66 remain unresolved.
• A declined nested operation need not end the entire composition; later operations retain independent permissions. Explicit Stop/Cancel is the cancellation boundary.

Compatibility and verification

• Requires OpenCode >=2.2.6 <2.3 and Beads >=1.3.1. Upgrade OpenCode before selecting the new plugin pin.
• Exact OpenCode2.2.6 native and one genuine-model workflow were qualified; final source and metadata gates passed Claude Opus5.5 review. Release runtime/guidance is unchanged from that qualified candidate.
• Existing exact1.x/beta pins remain available. Stable npm latest becomes2.0.0; next stays1.1.0-beta.5.
• No operator installation/activation is performed by this release. Snapshot availability deficiency o66/#57424 remains unresolved.

Source: a493652
Preparation: #41

v1.1.0-beta.5 — compact diagnostics and loaded plugin identity

Diagnostics without the instruction wall

• /oc-beads:diagnostics now keeps visible history compact, capturing its dynamic read-only report once in durable metadata and delivering it through the existing primary/compaction hooks.
• Diagnostics includes the loaded plugin package name/version from its own manifest and requests plugin/OpenCode identity near the start of the answer. A shared version label is not a unique canary build fingerprint.
• Preserve native inputs/delivery, replay, safe probes, uncertainty and unload behavior. The other 29 workflow payloads and all other runtime modules/assets are unchanged from beta.4.

Verification: regression RED→GREEN; 214 tests; typecheck; installed-package smoke; provider serializer/replay checks; strict specs; Linux, Windows and security CI. No new genuine-model/UI qualification campaign was run for this bounded correction.

Update

Replace the existing Beads plugin entry with @snarkipus/opencode-beads@1.1.0-beta.5 and relaunch the intended instance. Do not retain duplicate entries. OpenCode >=2.1.1 <2.2 and Beads >=1.3.1 remain required.

This is an opt-in npm next prerelease. Stable latest remains 1.0.2; publishing does not change running installations.

v1.1.0-beta.4 — compact native workflow history

Compact native workflow history

All 29 /oc-beads:<workflow> commands now keep user history compact and natural while delivering the full workflow instructions through native context hooks. Single-line free text stays beside the command; multiline text stays beneath it, without implementation-facing headings.

• Preserve command-specific behavior, supporting guidance, native inputs/delivery, permissions and actual executor attribution.
• Preserve the eleven native code-mode operations and legacy sync snapshot compatibility.
• Keep oc-beads:diagnostics on its distinct dynamic observed-report path.
• Retain independent Opus plan/source READY reviews and the corrected bounded native code-mode append/readback evidence.
• Fix cross-platform test fixture path canonicalization without changing production behavior or regenerating semantic baseline hashes.

Install / update

Use the exact project-local plugin entry:

{
  "plugins": ["@snarkipus/opencode-beads@1.1.0-beta.4"]
}

Replace an existing Beads entry; do not load the canary and registry package together. OpenCode >=2.1.1 <2.2 and Beads >=1.3.1 remain required.

This is an opt-in prerelease published to npm next. Stable latest remains 1.0.2. Publishing does not update any running installation automatically.

v1.1.0-beta.3 — actionable workflow commands

Slash commands that perform the requested action

This beta makes a sufficiently specified /oc-beads:* invocation request its advertised bounded operation. In particular, bare /oc-beads:sync performs ordinary supported synchronization using existing configuration and --no-adopt, instead of stopping at a help summary. Explicit explanation requests stay read-only, missing inputs trigger focused clarification, and real host permissions, project restrictions, mode flags, actor attribution and parent acceptance still apply. Missing remotes do not authorize provisioning; conflict choices and unrelated repairs are not implicit.

Also aligns command purposes and seven supporting-resource mappings. QuickStart remains supported. All eleven native Beads code-mode operations, 29 workflow commands plus diagnostics, and 17 resource links remain; no code-mode executor was removed or replaced.

Validation

• Independent Opus implementation review READY; original findings and corrected recheck are committed.
• Five bounded genuine-model behavioral cases accepted. This is representative evidence, not universal command reliability certification.
• 205 tests, typecheck, packed public entrypoint smoke, strict specs and Linux/Windows/security CI passed.
• Release-only metadata changes preserve evaluated source and assets.

Opt-in beta

Published as @snarkipus/opencode-beads@1.1.0-beta.3 under npm next. Stable latest remains 1.0.2. Select the exact beta.3 pin explicitly in the existing OpenCode plugin configuration; this release does not edit configuration, initialize a Beads store, restart a runtime or update an existing installation for you.

PR: #35

v1.1.0-beta.2 — command clarity

Command-clarity evaluation update

• Renamed: /oc-beads:status → /oc-beads:diagnostics, without an alias. Use /oc-beads:stats for the issue-database overview. User-defined old-name overrides are untouched; no configuration migration.
• Clarified semantic issue compaction versus Dolt-history/conversation compaction, explicit mode/actor authority, pre-compaction restore display versus --apply, current quickstart help and Dolt-remote versus federation synchronization.
• Preserved all 29 workflow stems, 30 package commands, 17 resource links, native code-mode tools and existing permission/identity/lifecycle behavior.

Install by changing the existing OpenCode plugin entry to @snarkipus/opencode-beads@1.1.0-beta.2. OpenCode >=2.1.1 <2.2, Beads >=1.3.1.

Published to next only; latest remains 1.0.2. Source/parent checks: 201 tests, typecheck, package callbacks and strict specs; hosted Linux/Windows/security checks passed. No fresh live-host/model qualification claimed; prior accepted evidence is reused. No operator installation or restart is performed by this release.

v1.1.0-beta.1 — code-mode evaluation beta

Opt-in evaluation beta for OpenCode >=2.1.1 <2.2 (exact 2.1.1 accepted baseline) and Beads >=1.3.1.

The normal public plugin entrypoint enables eleven native Beads code-mode operations, 30 native workflows and packaged guidance with 17 resource links. Select @snarkipus/opencode-beads@1.1.0-beta.1 or @snarkipus/opencode-beads@next after publication. Stable @latest remains 1.0.2.

Native permissions, executor attribution, migration guard, cancellation and partial/uncertain outcomes are preserved. Plain decline of a nested permission request does not stop the entire composition; use explicit Stop/Cancel. Bounded prior acceptance is retained; no token-saving, cross-provider checkpoint portability or multi-hour reliability claim is made.

v1.0.2

What's Changed

• fix: close the 1.0.1 review findings by @snarkipus in #24
• docs: describe opencode-beads as an independent project by @snarkipus in #25
• 🔖 bump version 1.0.1 -> 1.0.2 by @snarkipus in #26

Full Changelog: v1.0.1...v1.0.2

v1.0.1

What's Changed

• chore: load the published 1.0.0 plugin in this repo's OpenCode config by @snarkipus in #20
• docs: add CI, release, npm, and zizmor badges to the README by @snarkipus in #21
• docs: align the README with the 1.0.0 implementation by @snarkipus in #22
• 🔖 bump version 1.0.0 -> 1.0.1 by @snarkipus in #23

Full Changelog: v1.0.0...v1.0.1

v1.0.0

What's Changed

• sync: beads v1.3.0 by @github-actions[bot] in #9
• Port opencode-beads to OpenCode V2 (1.0.0) by @snarkipus in #11
• chore: remove the retired NPM_TOKEN publish bootstrap by @snarkipus in #12
• refactor!: retire upstream Beads vendoring and own the task agent by @snarkipus in #13
• feat: minimize bd's AGENTS.md sections while prime is attached by @snarkipus in #14
• feat: match bd setup claude's install shape and watch for upstream pre-emption by @snarkipus in #15
• feat: re-prime resumed sessions after an idle gap by @snarkipus in #16
• feat: enforce the worker contract with OpenCode permissions, steps, and compaction by @snarkipus in #17
• feat: add the stealth option and tell the agent when bd prime fails by @snarkipus in #18
• docs: record Claude Code parity on OpenCode 2.0.26 by @snarkipus in #19

Full Changelog: v0.10.0...v1.0.0