Repository navigation
CBA-KB v2.1.4 Engine Release
CBA-KB Engine v2.1.4 — Engine-only Release
Scope: Engine code only. This Release publishes the v2.1.4 (REQ-214) local Engine deterministic substrate, concurrency/locking, and CI/test parity hardening. Zero new product features, zero external contract/CLI/error-code changes, and zero canonical digest changes are introduced. It does NOT authorize formal data release, Identity release, Production current pointer changes, or any real Drive write. REQ-212 leftover obligations (#235, #237) and v2.1.3 post-launch observation items remain independently tracked.
Release identity
- Tag:
v2.1.4(annotated,4adba304…), target commitac6ffc9bb31dd5bb69c785c7a73549b7f85b639e(PR #245 merge commit; parents:mainbe172d49d2b23a7be4a0c858315480b3e101cc9e+ PR headd35f3ee54054cfa383fb6047ca6f27644bc4d31d). - Git tree:
55fcabfab2151310d0f4b3bb97b24bc4b876e1a8. - Issue / PR: Issue #244 (
REQ-214) / PR #245 (FINAL_TIER=T2, Bot-authored, independent Round 2 Q2PASSbyMuse Spark 1.3at2026-11-13T01:45:10Zbound tod35f3ee54054cfa383fb6047ca6f27644bc4d31d, Human Approve & Merge, post-mergemainpush CI green:Offline testsRun43356023158&lacd-verifyRun43356023519). - Frozen Q1 specification SHA-256:
598536dea1410f9b8169c3bbf3fce59dfe9b12961d8cfd216feb16589489e33d; frozen acceptance suite SHA-256:652f482212506be7c19e5c9b40872b59579af331128b3072653d8d1a83f2ee7d(zero post-freeze modifications; zero edits to 139 pre-existing test files; test integrity141files /2006functions /5258asserts /6skips /0xfails). - Package version vs Tag (
v2.1.0–v2.1.3precedent): source package version remains2.0.2(pyproject.tomlandsrc/cba_kb/__init__.pyuntouched per public readiness contract). Tagv2.1.4is the Engine Release version identifier.
Delivered Engine hardening (Scheme B: P0-1 + P0-2 + P1-1 + P1-2)
-
P0-1 — Local vs CI
PYTHONPATHparity:pyproject.toml[tool.pytest.ini_options].pythonpathandMakefilePYTHONPATHinclude.alongsidesrcandlegacy, allowing clean repository-root module resolution without external environment injection. -
P0-2 — Crash-durable atomic writes & single-pass slice catalog:
-
common.atomic()performs parent-directory descriptorfsyncafteros.replace(best-effort where unsupported), withdrive_resilience._wal_write()delegating tocommon.atomic(). -
kc_slices.build_slice_catalog()validates canonical(provider, competition)records in a single pass ($O(N + K)$ instead of $O(K \cdot N)$) while preserving byte-for-bytebuild_slice()output and fail-closed rejection order.
-
-
P1-1 — Canonical JSON consolidation, zero-
deepcopyvalidation, scoped rate-limiting & single-scan ledger append:-
commonprovidescanonical_json_str,canonical_json_bytes(*, trailing_newline=False), andsha256_hex, delegated to bykc_projection,evidence_ledger,ingestion, anddocument_lanewith zero digest drift. -
kc_current.SimulatedCurrentStore.validate()binds canonical snapshot bytes directly withoutcopy.deepcopy(snap)while preserving tamper rejection (COMMIT_VALIDATION_STALE). -
identity_web_evidence.fetch_official_resource(..., rate_limit_state=None)scopes rate-limiting per call by default (removing unused global_DOMAIN_LAST_REQUESTbleed while retaining intra-call redirect/retry throttling and optional shared state). -
evidence_ledger.RuntimeEvidenceLedger.entries(*, scan_secrets=True)reads each entry file once;append()scans the new entry once and verifies hash-chain continuity under lock, while defaultentries()andverify()preserve full secret scanning.
-
-
P1-2 — Search
$O(|Q|)$ term matching, lock-safe persistent revocation, non-truncatingfile_lock& PR CI deduplication:-
drive_search_index.search_index()computesmatched_termsin$O(|Q|)$ lookups without full vocabulary iteration;revoke_grant_persistent()serializes load-modify-save underfile_lock(index_path), whiledrive_plan._apply_plan_resilient()dispatches_revoke_grant_unlocked()under its already-held sortedExitStacklock (preventing nested POSIXflockself-deadlock while preserving concurrent writer serialization). -
drive_resilience.file_lock()opens.lockfiles in non-truncating"a"mode;.github/workflows/offline-tests.ymlskips the duplicate regression step onpull_requestevents while preserving fulltests/ + legacy/PR parity andpush-to-mainregression coverage.
-
Honest boundaries
- Pure technical substrate & concurrency hardening release: zero new product features, zero schema/digest changes.
- Production
currentpointer was not modified; no real Drive writes were performed. REQ-212open obligations (#235,#237) andv2.1.3post-launch client observation items remain independent and untouched.