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.goto 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/andcmd/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.sha256integrity.
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.shas 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: trueacross 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.mdand 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_REFUSEDdone-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/pflagto 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/processrepositories 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