aif

AIF V4: Deterministic Version Control & State Checkpoints for LLMs & Agents

Operational guide for deterministic, model-agnostic, local-first version control and state checkpoints using the compiled aif Rust engine (AIF\x04).

---

When to Use

• Session Start: Always run on turn 1 to recall high-importance architectural context and active task states.
• Before Complex or Risky Tasks: Write scratch state to protect in-flight progress against unexpected cancellation or user interrupts (Ctrl+C).
• End of Every Turn: Persist cognitive decisions, API changes, bug fixes, and milestones into orbital rings.
• Cross-Project Inquiries: Query connected repositories through the synaptic bridge (bridge_nexus.ai).
• Memory Maintenance: Apply temporal decay and reweight obsolete or elevated memories.

When NOT to Use

• Casual conversational banter or one-word clarifying questions with no state change.
• Environments where aif binary is unavailable and cannot be built.
• Scratch or temporary sandboxes where persistence across sessions is explicitly not desired.

---

Orbital Gravity Rings

Memories are partitioned into three concentric rings based on cognitive score ($S_{attn}$):

1. Red Core (INT16_CORE / FP16_RAW, $S_{attn} \ge 0.70$):
   • High-importance architectural decisions, schemas, and interrupted checkpoints ([PAUSED_MID_TASK]).
   • Preloaded on boot recall and synchronized to bridge_nexus.ai.
2. Black Middle Ring (INT8_RING, $0.30 \le S_{attn} < 0.70$):
   • Standard turn summaries and implementation notes.
   • Stop words pruned to conserve tokens while preserving semantic intent.
3. Blue Outer Crust (INT2_CRUST, $S_{attn} < 0.30$):
   • Ultra-compact gist summaries and decayed memories.

---

Execution Workflow

+--------------------------------------------------------------------------------+
| 1. Boot Recall      -->  aif recall --core-and-bridge                          |
| 2. In-Flight Work   -->  aif scratch "<active goal and variables>"             |
| 3. Turn Commit      -->  aif note --importance <0.0-1.0> --summary "<action>"  |
| 4. Cross-Project    -->  aif bridge --query "<topic>"                          |
| 5. Maintenance      -->  aif optimize --delta 0.05                             |
+--------------------------------------------------------------------------------+