Skip to content

ContextLattice v3.7.0 - Token Impact Ledger

Choose a tag to compare

View all tags
@sheawinkler sheawinkler released this 01 Jul 07:32
v3.7.0
d973890
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

ContextLattice v3.7.0

Release date: 2026-07-01

v3.7.0 turns the Token Impact Engine from a directional dashboard estimate into a durable prompt-economics proof surface. Context packs now report tokenizer-exact prompt deltas when the configured tokenizer is available, and the gateway persists compact token-impact rows so the proof survives restarts without storing raw prompts or source text.

Highlights

  • Adds tokenizer-exact context-pack accounting through the configured tiktoken encoding.
  • Keeps honest fallback metadata: if tokenizer accounting is unavailable, payloads explicitly report fallback estimation instead of pretending to be exact.
  • Persists compact token-impact samples in a bounded ledger with byte and sample caps.
  • Reloads persisted token-impact rows on gateway startup so aggregate prompt-economics telemetry survives restarts.
  • Upgrades /telemetry/token-impact to schema version 2 with exact_sample_count, tokenizer_exact, tokenizer_encoding, and storage status fields.
  • Updates the dashboard cockpit to label exact, sampled, and heuristic token savings separately.
  • Adds release-note hygiene checks so GitHub release notes reject machine-local paths before publishing.

Product Contract

ContextLattice can now show not just that memory was retrieved, but how much prompt surface the memory layer kept out of the agent call. The contract is intentionally strict:

  • No raw prompts or recalled source text are persisted in the token-impact ledger.
  • The ledger is bounded by size and sample-count limits.
  • Tokenizer-exact claims require a loaded tokenizer encoding.
  • Fallback rows remain visible as fallback rows.
  • Dashboard copy distinguishes exact token counts from sampled estimates and heuristic fallback.

Verification

  • Gateway tests passed with exact tokenizer accounting and persisted-ledger reload coverage.
  • Dashboard tests passed with tokenizer-exact calibration coverage.
  • Dashboard production build passed.
  • Live gateway and dashboard were rebuilt and restarted.
  • Live context-pack samples reported tokenizer_exact=true, estimate_method=tiktoken, and tokenizer_encoding=o200k_base.
  • Live telemetry reloaded persisted exact samples after a gateway restart.
  • Browser verification showed exact-token impact and the Prompt Economics Ledger with no console or network failures.
  • GitHub PR bodies and scanned release bodies were cleaned of machine-local paths.
  • Release-note hygiene check passed for the v3.7.0 notes.

Release Lineage

v3.7.0 builds on:

  • v3.6.0: public agent operating layer, release installer hygiene, impact-per-token context allocation, optional storage guard, and broader agent adoption surface.
  • v3.6.2: agent-actionable quickstart and current installer/tap documentation.
  • v3.6.3: dashboard auth boundary hardening for local OSS mode.
  • v3.7.0: tokenizer-exact prompt economics, bounded persisted token-impact ledger, and release-note path hygiene.
Assets 5
Loading