Skip to content

CBA-KB v2.1.4 Engine Release

Choose a tag to compare

@SkyOneBranch SkyOneBranch released this 13 Nov 05:45
· 27 commits to main since this release
ac6ffc9

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 commit ac6ffc9bb31dd5bb69c785c7a73549b7f85b639e (PR #245 merge commit; parents: main be172d49d2b23a7be4a0c858315480b3e101cc9e + PR head d35f3ee54054cfa383fb6047ca6f27644bc4d31d).
  • Git tree: 55fcabfab2151310d0f4b3bb97b24bc4b876e1a8.
  • Issue / PR: Issue #244 (REQ-214) / PR #245 (FINAL_TIER=T2, Bot-authored, independent Round 2 Q2 PASS by Muse Spark 1.3 at 2026-11-13T01:45:10Z bound to d35f3ee54054cfa383fb6047ca6f27644bc4d31d, Human Approve & Merge, post-merge main push CI green: Offline tests Run 43356023158 & lacd-verify Run 43356023519).
  • 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 integrity 141 files / 2006 functions / 5258 asserts / 6 skips / 0 xfails).
  • Package version vs Tag (v2.1.0–v2.1.3 precedent): source package version remains 2.0.2 (pyproject.toml and src/cba_kb/__init__.py untouched per public readiness contract). Tag v2.1.4 is the Engine Release version identifier.

Delivered Engine hardening (Scheme B: P0-1 + P0-2 + P1-1 + P1-2)

  • P0-1 — Local vs CI PYTHONPATH parity: pyproject.toml [tool.pytest.ini_options].pythonpath and Makefile PYTHONPATH include . alongside src and legacy, 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 descriptor fsync after os.replace (best-effort where unsupported), with drive_resilience._wal_write() delegating to common.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-byte build_slice() output and fail-closed rejection order.
  • P1-1 — Canonical JSON consolidation, zero-deepcopy validation, scoped rate-limiting & single-scan ledger append:
    • common provides canonical_json_str, canonical_json_bytes(*, trailing_newline=False), and sha256_hex, delegated to by kc_projection, evidence_ledger, ingestion, and document_lane with zero digest drift.
    • kc_current.SimulatedCurrentStore.validate() binds canonical snapshot bytes directly without copy.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_REQUEST bleed 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 default entries() and verify() preserve full secret scanning.
  • P1-2 — Search $O(|Q|)$ term matching, lock-safe persistent revocation, non-truncating file_lock & PR CI deduplication:
    • drive_search_index.search_index() computes matched_terms in $O(|Q|)$ lookups without full vocabulary iteration; revoke_grant_persistent() serializes load-modify-save under file_lock(index_path), while drive_plan._apply_plan_resilient() dispatches _revoke_grant_unlocked() under its already-held sorted ExitStack lock (preventing nested POSIX flock self-deadlock while preserving concurrent writer serialization).
    • drive_resilience.file_lock() opens .lock files in non-truncating "a" mode; .github/workflows/offline-tests.yml skips the duplicate regression step on pull_request events while preserving full tests/ + legacy/ PR parity and push-to-main regression coverage.

Honest boundaries

  • Pure technical substrate & concurrency hardening release: zero new product features, zero schema/digest changes.
  • Production current pointer was not modified; no real Drive writes were performed.
  • REQ-212 open obligations (#235, #237) and v2.1.3 post-launch client observation items remain independent and untouched.