context-governor 0.2.0

Crate-agnostic governed context compaction with receipts, exact fallback references, and recall quality filters
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# context-governor architecture

`context-governor` is a deterministic prompt-level context engine for agents.

```text
transcript
  |
  v
classify messages
  |-- authority class: active task / evidence / summary-ok / quarantine
  |-- content kind: json / diff / cargo output / shell log / markdown / rust / prose
  v
allocate budget
  |-- soft_warn: preserve safety, warn on overflow
  |-- hard_cascade: shrink/remove summary before exceeding budget
  |-- fail_closed: refuse if exact-preserve content cannot fit
  v
compact prompt
  |-- exact high-risk messages
  |-- structured anchor summary
  |-- content-aware previews
  v
receipt + fallback store
  |-- BLAKE3 transcript hashes
  |-- allocation plan
  |-- exact fallback refs
  |-- structured loss report
  |-- optional memory sink records
```

Core invariants:

1. Latest user message is active task, not historical context.
2. Summaries are reference-only background.
3. Exact fallback is retained for summarized, omitted, and quarantined records.
4. The receipt says what was kept, summarized, archived, omitted, quarantined, and recoverable.
5. Budget overflow must be explicit: warning, hard cascade, or fail-closed error.

Non-goals:

- no provider KV-cache compression
- no hosted-model context-window extension
- no learned compression claim
- no semantic-memory network calls in the core crate

Adapters own host-specific transport. The core crate owns deterministic governance.