# Release Notes: ZQK Knowledge Kernel v0.3.5

**Release Version**: `v0.3.5` (Release Candidate `v0.3.5-rc1`)  
**Target Date**: November 2026  
**Commit Range**: `v0.3.4..HEAD`  

---

## Highlights & Strategic Capabilities

The `v0.3.5` release delivers major advancements in vendor isolation adapter architecture, automated CI coverage aggregation, multi-scenario evaluation streaming, distributed consensus, and autonomous daemon overseer supervision:

### 1. Vendor Isolation Adapter Architecture & Third-Party Decoupling (`pkg/adapters/ide/`)
- **Pluggable Adapter Drivers**: Encapsulated Cursor, Claude Code, Cline, Windsurf, Antigravity, and generic IDE host integrations into decoupled drivers implementing standard adapter interfaces.
- **Zero Core Vendor Strings**: Completely refactored `pkg/mcp/install.go` to eliminate third-party product names, paths, and platform heuristics from core packages.
- **Fail-Closed Sovereignty**: Strict node sovereignty protection preventing unintended host-global MCP configuration overrides.

### 2. Automated CI Coverage Aggregation & Duplication Elimination Gate (`pkg/coverage/`)
- **Zero-Duplication Execution**: Eliminated redundant monolithic extended test runs in GitHub Actions CI, reducing PR feedback cycles by over 13 minutes per run.
- **100% Package Matrix Partitioning**: All 200+ packages in `pkg/` and `cmd/` are partitioned across 7 parallel matrix shards.
- **Consolidated Shard Rollup**: Deterministic coverage aggregation tool (`scripts/open-core/coverage-rollup`) merges parallel shard profiles and verifies cryptographic `.sha256` integrity.

### 3. Multi-Scenario Batch Evaluation Runner & Real-Time Telemetry Streaming (`pkg/eval/`)
- **High-Throughput Evaluation**: Parallel evaluation harness executing complex multi-step scenario matrices with sub-millisecond dispatch.
- **Live Telemetry Streaming**: Event-driven progress and scorecard emission for evaluating agent accuracy, cost, and latency budgets.

### 4. Multi-Agent Consensus Ledger & Epistemic Shockwave Settlement Invariants (`pkg/consensus/`)
- **Distributed Consensus**: Provable multi-seat consensus protocol managing concurrent agent updates to kernel state.
- **Epistemic Shockwave Settlement**: Idempotent lease transitions that propagate validated changes across the ontological DAG without race conditions.

### 5. Autonomous Daemon Overseer Supervision & Callback-Driven Wake Invariants (`pkg/daemon/`)
- **Watchdog Overseer**: Native host supervisor managing long-running kernel services with automatic crash recovery.
- **Reactive Wake Semantics**: Eliminated busy-waiting loops in favor of OS-level callback notifications and event-driven timers.

### 6. Automated Documentation Portal CI Invariant & Link Rot Sentinel
- **Continuous Doc Validation**: Every PR strictly verifies link integrity and markdown hygiene across all published documentation.
- **Link Sanitization**: Eradicated leaked developer workstation paths and unresolvable relative markdown references across 45 documentation files.
- **Canonical Install Dispatcher**: Restored root `install.sh` as a regular executable file (0755), eliminating curl pipe failures on raw GitHub mirrors.
- **Automated Deployment**: One-command portal builds and zero-downtime deployment to `docs.zqk.dev`.

### 7. Zero-Touch Container Packaging & Standalone Local Inference Swarms
- **Community Multi-Stage Dockerfile**: Slim, hardened Alpine container with non-root security context, embedded CA certificates, and health check inspection.
- **Standalone Local Inference Swarms**: Self-contained container variant bundling local llama.cpp / GGUF model runtimes (`Dockerfile.standalone`) with zero external API key requirements.
- **Production Validation**: Three-Fold verification suite ensuring zero hardcoded local assumptions and deterministic containerized test execution.

### 8. CI Matrix Fast-Fail Enforcement & Continuous Autonomous Loop Hardening
- **Runner Waste Elimination**: Codified `fail-fast: true` across all CI unit-test matrix shards in `.github/workflows/ci.yml`, preventing runaway runner consumption on partition failure.
- **Stage Status Notification Hooks**: Added reactive stage completion and failure notifications (`if: always()`) across pipeline partitions.
- **Strict Anti-Polling & In-Flight Pipelining Protocol**: Explicitly codified the Zero Polling Timers directive in `.agents/AGENTS.md` and onboarding payloads, mandating continuous forward pipelining without synthetic idle delays.

### 9. Teleological Contact Inhibition Gate & Swarm Neoplasia Prevention (`pkg/teleology/`)
- **Root Intent Membrane**: Fail-closed taxonomic domain validation during draft promotion (`zqk object draft promote`) and strategic alignment (`zqk system align`).
- **Neoplasia Prevention**: Refuses autonomous swarm drift into tangential, unapproved domains (e.g. synth racks in social media managers) even when graph pointers are attached.
- **Deterministic Rejection Receipts**: Emits normative `TELEOLOGICAL_DRIFT_REFUSED` done-gate receipts citing the root mission boundary (`MIS-*`).

### 10. Convergence Loop Anti-Gaming Metric Shield & Strategic Breadth Index (`pkg/antigaming/`)
- **Strategic Capability Breadth**: Incorporates domain diversity and milestone critical-path coverage into convergence evaluation (`zqk convergence measure`).
- **Diminishing Returns on Leaf Saturation**: Penalizes redundant leaf-package expansions to prevent metric inflation without architectural advancement.
- **External Integration Frontier Weighting**: Positive weighting for boundary controllers and external interfaces; flags and blocks isolated "mathematical silos".

---

## Community Issue Burndown & Bug Fixes

- **GH-1025**: Upgraded `github.com/spf13/pflag` to 1.1.0 and aligned CLI golden files.
- **GH-1033**: Resolved legacy mesh seat-worker unit garbage collection.
- **GH-1071**: RFC/Bug: Teleological Contact Inhibition Gate in Intake Membrane & Promotion Done-Gates.
- **GH-1072**: Feature: Convergence Loop Anti-Gaming Metric Shield (Strategic Capability Breadth vs. Algorithmic Siloing).
- **PR #1052**: Post-release telemetry and community adoption health monitoring.
- **PR #1053**: Automated documentation portal CI invariant and link rot sentinel.
- **PR #1054**: Autonomous daemon overseer supervision and callback-driven wake invariants.
- **PR #1055**: Multi-agent consensus ledger and epistemic shockwave settlement invariants.
- **PR #1056**: Multi-scenario batch evaluation runner and real-time telemetry streaming ADR.
- **PR #1057**: Vendor isolation adapter architecture and third-party decoupling invariants.
- **PR #1066**: Zero-touch container packaging and standalone local inference swarms.
- **PR #1067**: Public entity documentation link sanitization and canonical install dispatcher restoration.
- **PR #1068**: Test alignment for canonical regular-file install script dispatcher.
- **PR #1069**: CI matrix fast-fail enforcement, stage status notification hooks, and anti-idleness protocol codification.
- **PR #1070**: AST auditor verification refactor eliminating structural statement duplication in CI anti-idle test suites.

---

## Upgrade Guide

- **Zero Breaking Changes**: Fully backwards compatible with existing `.zqk/process` repositories and schemas.
- **Upgrade Command (Direct Domain)**:
  ```bash
  curl -fsSL https://zqk.dev/install.sh | bash
  ```
- **Fallback GitHub Raw Mirror**:
  ```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
  ```
