# Release Notes: ZQK Knowledge Kernel v0.3.3

**Release Version**: `v0.3.3` (Release Candidate `v0.3.3-rc1`)  
**Target Date**: November 2026  
**Commit Range**: `v0.3.2..HEAD`  
**Milestone**: `MIL-001` (Cycle 78)  

---

## Highlights & Strategic Capabilities

The `v0.3.3` release of ZQK represents a landmark evolution in agentic software engineering and persistent Knowledge Kernel orchestration. Spanning over 30 engineering cycles and resolving all outstanding community GitHub issues, `v0.3.3` introduces transformative capabilities across multi-agent consensus, automated evaluation benchmarks, robust system daemon supervision, and high-performance parallel coverage consolidation.

### 1. Parallel Matrix Coverage Consolidation (Cycle 77, #1044)
- **Zero-Duplication Shard Rollup**: Eliminates wasteful 10-minute duplicate CI test runs by consolidating multi-shard coverage profiles directly in Go (`pkg/coverage`).
- **Atomic Statement Deduplication**: Correctly aggregates shared package executions across matrix jobs with sub-millisecond block normalization.
- **Fail-Closed Gate**: Enforces a strict 80% coverage threshold across all open-core packages directly in CI without redundant workflow runs.

### 2. Multi-Agent Consensus Ledger & Epistemic Shockwave Settlement (Cycle 76, #1043)
- **Append-Only Consensus Ledger**: SHA-256 hash chaining with deterministic chronological ordering prevents multi-agent split-brain conditions.
- **Quorum-Based Settlement**: Automatic shockwave event distribution and state reconciliation across autonomous swarm members.

### 3. Convergence Policy Orchestrator & Autonomous Remediation Engine (Cycle 75, #1041)
- **Shift-Left Auto-Remediation**: Detects policy discrepancies and auto-synthesizes remediation tasks before failures escalate.
- **Loop Prevention**: Exponential backoff and cyclic trigger detection ensure self-healing routines never destabilize the repository.

### 4. Evaluation Benchmark Regression Gates & Quality Circuit Breaker (Cycle 74, #1040)
- **Continuous Scorecard Verification**: Evaluates model performance and scenario completion against historical baselines.
- **Circuit Breaker Gate**: Rejects any commit or prompt mutation that degrades established model benchmarks.

### 5. Autonomous Daemon Overseer Supervision & Callback-Driven Wake Invariants (Cycle 73, #1039)
- **Self-Healing Daemons**: The `Overseer` monitors all background system daemons (`scheduler`, `ambient`, `steward`, `privileged-writer`) under systemd and launchd supervision.
- **Callback-Driven Reactive Wake**: Eliminates polling loops; agents wake reactively upon daemon event signals.

### 6. Modular Language Bundles & Pluggable Verification (Cycle 62, #1024)
- Modular language bundle runtime supporting Go, TypeScript, Python, and Rust verification suites out of the box.

---

## Community Issue Burndown & Bug Fixes

- **GH-1000**: Fixed `zqk system check` pre-commit timeout on large repositories with layered indexing.
- **GH-1001**: Added explicit requirement validation on `zqk new priority_plan --req`.
- **GH-1002**: Automatic TTL expiration and lease reaping in scheduler daemon.
- **GH-1003**: Supported batch criteria evaluation in test runner CLI.
- **GH-1005**: Fixed CAS index key synchronization bug during requirement creation.
- **GH-1014**: Enforced fail-closed commit hash existence check in `zqk agent next`.
- **GH-1018**: Configurable timeout and chunking for high-volume kernel object validation.
- **GH-1019**: Prevented deadlock in `zqk object update --unset-field` cache eviction.
- **GH-1025**: Upgraded `github.com/spf13/pflag` from 1.0.10 to 1.1.0 and aligned golden CLI test files.
- **GH-1033**: Automated hostservice GC cleanup for legacy mesh seat-worker units.

---

## Upgrade Guide & Breaking Changes

- **Zero Breaking Changes**: Fully backwards compatible with existing `.zqk/process` repositories and schemas.
- **Upgrade Command**:
  ```bash
  curl -fsSL https://raw.githubusercontent.com/zqk-os/zqk/main/scripts/install.sh | bash
  ```
- **Post-Upgrade Verification**:
  ```bash
  zqk system check --refresh-cache
  zqk workflow whats-next
  ```

---

## Verification & Artifact Sign-off

- Comprehensive verification matrix available at [`docs/quality/COMMUNITY_ISSUE_VERIFICATION_MATRIX.md`](../quality/COMMUNITY_ISSUE_VERIFICATION_MATRIX.md).
- All public release payload, tree police, and test gates verified passing.
