Skip to content

Release Notes — HELIX v0.3.3

Example from HELIX’s own docs. This generated page comes from docs/helix/. Use it to see the method in practice; start with the artifact-type catalog for reusable templates. Historical plans and reports may describe retired architecture.

Release Notes — HELIX v0.3.3

Release Scope

  • Release identifier or version: v0.3.3
  • Release date: 2026-04 (operator-driven; tag commit 0db3ea8)
  • Rollout window or environment: HELIX plugin (consumed by users via repo tag) and the public website at https://documentdrivendx.github.io/helix/
  • Release owner: HELIX maintainer cutting the tag
  • Source commit or build: 0db3ea8 (tag v0.3.3)

Audience and Channels

AudienceWhy they careDelivery channel
HELIX plugin usersNew CI behavior and review-threshold knob affect day-to-day queue-drain outputPlugin repo tag; release notes in docs/helix/05-deploy/release-notes.md
Website readersPublic docs at documentdrivendx.github.io/helix/ updated to the tagGitHub Pages rebuild; release-notes page
HELIX maintainersTest-suite stability changes need to be folded into local development practiceRepo issues and the HELIX commit workflow

Highlights

  • CI stability: skill packaging tests now filter spurious DDx update notices that were causing intermittent CI red without indicating a real regression.
  • Review-threshold knob: A configurable threshold gates how aggressively the queue-drain loop triggers periodic alignment, giving operators more control over review cadence on long-running queues.
  • Plugin manifest correctness: A dangling hooks reference in .claude-plugin/plugin.json was removed; fresh plugin installs no longer emit a manifest-validation warning.

Changes and Fixes

New or Improved

AreaWhat changedWho is affected
Queue drain--review-threshold accepted to tune periodic-alignment cadenceOperators running long queue-drain sessions
CISkill packaging tests filter DDx update notices from harness output before assertionsHELIX maintainers and contributors
Tracker / forgeForge-agent discovery tracker issue added to capture follow-up workHELIX maintainers

Fixes

Issue or symptomResolutionUser or operator impact
Intermittent CI red on skill packaging tests from DDx update bannersBanner filter applied before stdout assertionsStable green CI; no operator action
Manifest validation warning on plugin installDangling hooks reference removed from .claude-plugin/plugin.jsonFresh installs are clean

Breaking Changes and Required Actions

There are no breaking changes in v0.3.3. No operator action is required.

Migration or Rollback Guidance

Upgrade or Migration

  1. Pull the new tag: git fetch --tags && git checkout v0.3.3 in your HELIX checkout (or repoint your plugin install at the new tag).
  2. Re-run ddx install helix --local . --force to refresh the local skill installation.
  3. No tracker or schema migration is required — .ddx/beads.jsonl is forward-compatible.

Rollback or Hold Guidance

  • Pause rollout when: a downstream consumer reports --review-threshold parsing errors, or when bash tests/validate-skills.sh regresses against the new tag in CI.
  • Roll back using: git checkout v0.3.2 and re-run ddx install helix --local . --force. The previous tag is fully compatible with the current .ddx/beads.jsonl schema.
  • Ask for help in: the HELIX repo issue tracker.

Known Issues and Support

IssueWho is affectedWorkaround or next step
Forge-agent discovery is tracked as a follow-up bead but not yet implementedOperators wanting auto-discovery of forge agentsContinue using explicit agent configuration; track the linked tracker issue

References