Skip to the content.

Self-Tax Trend — fak’s own overhead and net effect, tracked over time

What this is. The living trend companion to the self-tax row in BENCHMARK-AUTHORITY.md. It tracks fak’s own mediation overhead — and the cases where that mediation makes work faster — as a dated series, net-true-labeled, every point tracing to a committed artifact and a reproduce command like every other authority row.

Epic: L5/T12 of #1147 (#1169). Design note (survey, maturity ladder, full DoD, per-ticket specs): docs/notes/self-tax-performance-assurance-tracking-1147.md. Anchor standard: net-true-value Question #2 (net-of-introduced-cost).

Snapshot date: 2026-06-28 Status: Living document — append a row when a new self-tax point lands.

Why a self-tax trend exists

fak inserts itself into the hot path of every tool call, result, turn, and commit. Each insertion has a cost — latency, tokens, wall-clock — and sometimes it removes cost (reuse it would otherwise redo). The security floor already proves a bad call can’t get through. This trend is the dual read-out: it proves a good call doesn’t get slower than its budget — and names it when fak made the work faster.

The honest shape is two-directional. fak’s tax is workload-dependent: a measurable cost on a tool-light task (nothing to reuse, only mediation to pay for), a measurable saving on a reuse-heavy task (prefill not redone, net of the tokens mediation adds). A single average would hide both; this trend reports the signed points and lets the workload speak.

A budget is an envelope with a stated scope, not a promise of zero cost — a gate that costs 8% and saves 40% is a net win, and this plane says so rather than redding on the 8% alone (epic non-goal (c)).

The trend (signed: + = cost added, = cost removed)

Every row’s number is already a committed entry in the Authority; this doc is the fold over them that makes the self-tax direction legible as one series. Provenance is labeled per the standard: WITNESSED (fak measured it itself), OBSERVED (provider-relayed), MODELED (computed from a stated model).

First committed Surface (lifecycle stage) Self-tax point Sign Provenance Artifact Reproduce
2026-06-26 adjudication read-path floor (every tool call) ~0.55 ns/op · 0 allocs · FLAT N=1→1000 drivers + (floor) WITNESSED internal/abi/registry_scaling_test.go go test ./internal/abi -bench BenchmarkRegistryReadScaling -benchmem
2026-06-20 pure-kernel decide — canonical allow (Submit) 362 ns/op allow (560–605 ns w/ ArgPredicates) + WITNESSED experiments/mac-m3pro-kernel-20260620/kernel-latency-mac-m3pro-20260620.json go test -bench per the M3 Pro Authority row
epic #607 (Regime A) vDSO self-ablation, tau2-airline smoke (frozen trace) tokens 937→417 = −520 tok (engine_calls 12→5, vdso_hits 0→7) (net saving) WITNESSED experiments/ablate/tau2-smoke-vdso-ablation.json (doc: docs/benchmarks/ABLATE-RESULTS.md) go run ./cmd/fak ablate --trace testdata/tau2/tau2-smoke.json --sweep vdso
epic #607 (Regime B, #623) cross-agent bare claude vs fak guard -- claude (pong, tool-light) total-ingested 1.56× = +28,986 tok (5/5 ALLOW, 0 deny) + (net cost) WITNESSED (kernel counters) experiments/ablate/cross-agent-pong-opus.json (doc: docs/benchmarks/ABLATE-RESULTS.md) python tools/cross_agent_ablate.py report --reps <reps.json>
2026-06-28 net-true improvement detector (decode reuse) net_tokens = local-reuse ⊕ provider-reuse − mediation-tax → positive on a reuse-favorable trace (net saving) WITNESSED ⊕ OBSERVED − MODELED design note §9 (…self-tax-performance-assurance-tracking-1147.md) curl -s localhost:PORT/metrics \| grep -E 'kv_prefix_reused_tokens_total\|inference_cached_prompt_tokens_total' (§9.4)

How to read a signed point

The series is the witness for the epic’s net-true claim: fak is not silently degrading performance (the + floors are small and flat), and it detects when it improves performance (the rows), each net of its own cost.

Honesty fences

Appending a point (keeping it living)

  1. Land the new self-tax measurement as a committed artifact (a JSON under experiments/… or a bench/test witness) with its own reproduce command — the same discipline as any Authority row.
  2. Add one signed row above: first-committed date, surface, the number, its sign, its WITNESSED/OBSERVED/MODELED label, the artifact path, and the reproduce command.
  3. Bump the Snapshot date, and update the self-tax row in BENCHMARK-AUTHORITY.md if the headline snapshot changed.

Verification