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.
  • 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