Skip to main content

Module cycle_packet_cache

Module cycle_packet_cache 

Source
Expand description

Cycle-scoped packet reuse cache (#gpackreuse).

Caches graph/context packets across a single agent-doc cycle so that repeated tsift CLI invocations sharing the same source/document/staged-diff watermarks skip redundant computation and report stable packet ids.

Packet kinds:

  • evidence: graph-db evidence reports keyed by packet_id
  • context_pack: context-pack reports keyed by watermark triple
  • impact: impact reports keyed by source watermark + revision
  • conflict_matrix: conflict-matrix reports keyed by prepared inputs + targets

Spec: see specs/graph.md § “Cycle Packet Cache”.

Structs§

CyclePacketCacheEntry
CyclePacketCacheEvictionReport
CyclePacketCacheHitReport

Enums§

CyclePacketKind

Constants§

CYCLE_PACKET_CACHE_DEFAULT_MAX_BYTES
CYCLE_PACKET_CACHE_DEFAULT_TTL_SECS
CYCLE_PACKET_CACHE_VERSION

Functions§

build_cache_hit_report
cycle_packet_cache_dir
cycle_packet_cache_evict
cycle_packet_cache_path
cycle_packet_cache_stats
cycle_packet_evidence_key
cycle_packet_read_cache
cycle_packet_watermark_key
cycle_packet_write_cache