Open-Core vs. Enterprise Slicing & Boundary Audit
Subject: Open-Core vs. Enterprise Slicing and Decoupling Verification
Auditor: Community Architecture & QA Verification
Standard: Apache-2.0 Open-Core Clean Boundary
Timestamp: 2026-10-06
1. Executive Summary
As part of the Core Kernel hardening and adoption preparation initiative, this audit validates the structural decoupling between the open-source Core Knowledge Kernel (zqk) and downstream Enterprise capabilities. The goal is ensuring the public open-core candidate is 100% self-contained, compiles cleanly in pure Go without unconfigured private dependencies, enforces strict boundaries, and never leaks proprietary enterprise modules or credentials.
All three verification criteria were formally tested and verified:
- Static Floor Invariant (
CRIT-OPEN-CORE-PAYLOAD-001): The open-core repository contains zero forbidden enterprise packages or unconfigured private artifacts. Verified via./scripts/open-core/check-public-release-payload.sh(POLICE PASS). - Operational Proof (
CRIT-OPEN-CORE-GATES-002): Standalone portable packaging and release gate verification passes in pure Go. Verified via./scripts/open-core/test-public-release-gates.sh(100% test pass rate across all packages). - Negative Boundary (
CRIT-OPEN-CORE-ENTITLEMENTS-003): Incompatible enterprise-only commands fail closed with structured exit codes and informative diagnostic upgrade instructions. Verified viapkg/entitlementsunit tests.
2. Feature Slicing: Open-Core vs. Enterprise Boundary Matrix
The architectural boundary separating Core Open-Source and Commercial Enterprise is codified below:
graph TD
subgraph Open-Core ["ZQK Open-Core (Apache 2.0 / Permissive)"]
K1["Local Knowledge Kernel & CAS Membrane"]
K2["ZPARQL Graph Query Engine & Traversal"]
K3["Single-Project Process Engine & WAL"]
K4["Ambient Daemon (Local Project FS Watcher)"]
K5["Local Task Scheduler & Cron Runner"]
K6["CLI Command Taxonomy (zqk do, zqk test, zqk query)"]
K7["Community Personas, Skills, and Policy Packs"]
end
subgraph Enterprise ["ZQK Enterprise (Commercial Extension)"]
E1["Autonomous Multi-Project Agent Mesh"]
E2["Cross-Workspace Federated CAS Replication"]
E3["Enterprise Messaging Bridges (Slack, Teams Ingress)"]
E4["Distributed Streaming Spine (Kafka, Kinesis Drivers)"]
E5["Cloud RBAC, Keycloak SSO, & Team Fleet Governance"]
E6["Elevated Internal Object Direct Manipulation (--internal)"]
E7["Unbounded Autonomous Evolution Loops (> 3 candidates)"]
end
Open-Core -->|Foundation for| Enterprise
Boundary Taxonomy Table
| Capability Domain | Open-Core Kernel (zqk) |
Enterprise Edition (zqke) |
Rationale / Boundary Invariant |
|---|---|---|---|
| Object Graph & CAS | Single-workspace content-addressable storage, ZPARQL pattern matching, local schema validation | Cross-cluster replication, distributed CAS sync, multi-tenant partitioning | Open-core provides total sovereignty for solo developers and local agent swarms. |
| Agent Orchestration | Local subagent dispatch (zqk do, zqk agent orchestrate), token-budgeted AST verification |
Cross-node agent mesh, remote worker seat pooling, enterprise fleet metrics | Solo agents run fast locally; team and infrastructure fleets run in enterprise. |
| Messaging & Ingest | Local CLI interaction, file-based feeds, stdin/stdout streaming | Webhooks, Slack/Teams bridges (FeedSenderMessagingBridge), signed remote events |
Commercial organizations require third-party communication integration. |
| Storage & Streams | Local WAL files, SQLite/flat-file indices, atomic rename filesystem CAS | Apache Kafka, AWS Kinesis, Postgres-backed enterprise event spine | Lightweight zero-dependency Go deployment for public users. |
| Entitlements Gate | Community tier enforced (CommunityChecker), fail-closed on enterprise features |
Cryptographically signed Ed25519 JWT licenses (EnterpriseChecker) |
Features requiring enterprise license emit clear upgrade instructions. |
3. Discovered Defects & Remediations Applied
During this audit cycle, two high-severity defects were uncovered and remediated:
Defect 1: macOS /private/var Symlink Collision in Project Nesting Validation
- Symptom: Greenfield initialization tests (
TestInit_Greenfield_NoEnvVars) failed withcannot initialize project: nested project root prohibited: ".../001" is nested inside ancestor project root "/private/var/folders/.../T". - Root Cause: On macOS,
/varis a symlink to/private/var.os.TempDir()returns/var/folders/..., whilefilepath.Absevaluates to/private/var/folders/.... The string comparisond == pinisIgnoredNestedProjectRootfailed to match, incorrectly recognizing the system temporary folder as an enclosing project root. - Remedy: Added
filepath.EvalSymlinks(tempDir)toisIgnoredNestedProjectRootinpkg/paths/project_root.go. Tested cleanly against all temp dir paths.
Defect 2: Promote Target Status Overshoot
- Symptom: Invoking
zqk object promote <id> --to <target_status>ignored--toduring candidate probing, evaluating terminal states (archived) and failing prematurely when intermediate hops were requested. - Root Cause: In
cmd/zqk/object/promote.go,promoteTargetprobed the full list of reachable transitions without capping probe candidates at--to. - Remedy: Filtered
probeOrderso that candidate evaluation is strictly bounded by thetargetPercentcorresponding to--to.
4. Verification Evidence & Release Gate Signoff
-
Check Public Release Payload:
bash ./scripts/open-core/check-public-release-payload.sh # Result: POLICE PASS, 0 forbidden packages, 0 private leakages. -
File Descriptor Hygiene:
bash ./scripts/open-core/check-process-fd-leaks.sh # Result: All running ZQK processes verified < 100 open file descriptors (healthy). -
Full Public Release Gates:
bash ./scripts/open-core/test-public-release-gates.sh # Result: PUBLIC RELEASE GATES: PASS across all packages (399s storage, 117s system, 0 flakes). -
Clean Decoupling Verification:
bash go test -v ./pkg/entitlements ./pkg/community # Result: All boundary tests pass.
5. Architectural Recommendations for Next Cycles
- Default
config/ambient.yamlgeneration inzqk init: Greenfield project creation should seed a minimalconfig/ambient.yamlspecifying directory ignore lists (src/,tests/,node_modules/,.venv/) to protect macOS users from Darwin kqueue file descriptor spikes. - Command Alias Ergonomics: Add
zqk planas a canonical alias forzqk pplan. - Async Spinners for Long CLI Operations: Commands exceeding 200ms must integrate
cli.BindAsyncProgressto provide responsive console feedback.