Skip to content

feat: add Terra task agent and upstream-aligned Beads guidance for 2.1.0 - #44

Merged
snarkipus merged 2 commits into
mainfrom
openspec/add-terra-task-agent
Nov 10, 2026
Merged

snarkipus merged 2 commits into
mainfrom
openspec/add-terra-task-agent

Conversation

@snarkipus

Copy link
Copy Markdown
Owner

Summary

  • Prepare @snarkipus/opencode-beads 2.1.0 with additive terra: true support: beads-task-agent-terra uses openai/gpt-6.1-terra / medium. The model-inheriting default and Luna Max remain unchanged, and both opt-in profiles can coexist.
  • Reconcile packaged and injected Beads guidance: clear field roles, incremental append checkpoints, deliberate replacement handoffs, and initial claim versus resuming an existing assignment. Preserve the existing typed API and permissioned direct-shell replacement route.
  • Include attributed pinned upstream examples and the MIT notice. Add upstream LICENSE monitoring coverage without advancing the existing broad monitoring baseline or changing advisory workflow behavior.
  • Synchronize the accepted profile requirement into canonical workflow-access and archive the completed specification change. Reconcile release metadata and user documentation.

No dependency, supported host range, minimum Beads version, permission mechanism or operator-installation change is included.

Verification

  • Local full suite: 224 tests, zero failures, 12,180 assertions; focused regressions demonstrated RED before implementation.
  • Typecheck, exact provided-archive package smoke, strict specifications and staged whitespace checks.
  • Archive rehearsed in an owned disposable Git snapshot, then exact validated bytes integrated; one requirement and five scenarios added, prior canonical content and task identities/checkmarks preserved.
  • Native OpenCode 2.2.6 parent-to-Terra read-only qualification; actual child route, Beads read, unchanged parent route and fixture verified. Durable qualification record.
  • One staged plugin-only create / append-checkpoint / replacement-handoff observation, with real executor attribution, independent readbacks and owned-resource cleanup. Its first replacement attempt was invalidated by a disposable permission matcher's omission of supported narrowing guards; the failed observation, deterministic fixture correction and one same-session continuation are retained separately. This is not claimed as a clean first-attempt pass.
  • Same independent Claude Opus 5.5 reviewer accepted the expanded source-plus-qualification delta: Standards READY, Spec READY, final READY; no material blockers. Optional wording advice remains nonblocking.
  • Commit tree matches the validated index. All 32 packed files remain byte-identical to the accepted archive, SHA-256 2472b61fcfe3a9f0169ed8b5c73a660154100db6f1027dd10fc823796ee5b9af.

Hosted CI is verified separately on this PR's exact head; local checks do not substitute for it. The existing snapshot-recovery limitation remains unresolved and documented.

Scope and release boundary

This PR publishes the reviewed source candidate for integration. It does not authorize merge, a tag/GitHub release/npm publication or consumer activation. The maintainer cuts the GitHub release after an authorized merge through the existing trusted-publishing workflow. Release tracking remains open until publication and fresh-consumer verification are accepted.

Add the opt-in Terra Medium task agent without replacing Luna or the
model-inheriting default. Reconcile packaged and injected Beads writing,
checkpoint and handoff guidance with attributed upstream excerpts.

Synchronize the accepted named-profile requirement into workflow-access
and archive the completed Terra specification change.

Validated with 224 tests / 12,180 assertions, typecheck, exact-package
smoke, strict specs and whitespace checks. Native Terra and staged
writing/handoff qualification plus final Opus 5.5 review are accepted;
the disclosed fixture matcher correction is retained in the evidence.

No consumer activation or release publication is included.
@snarkipus
snarkipus merged commit 6c12779 into main Nov 10, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant