@ovav/pi-memory

OVAV MEMORY v3 — Proactive memory injection + governance layer for pi coding agent

@ovav/pi-memory turns pi into a governed, self-aware coding agent with:

• Proactive memory injection — Cells are injected before_agent_start when error patterns are detected
• LiveProfiler signal detection — RETRY_LOOP (3-4 errors), ERROR_LOOP (5+), EDIT_BURST (4+ writes)
• F0-F5 governance validators — architecture, infrastructure, roles, security, integration gates
• PermissionGate — blocks dangerous commands (rm -rf, chmod 777, credential exfil)
• AuditLogger — full event stream to .ovav/audit/
• Privacy tags — SECRET / SENSITIVE / PROJECT / PUBLIC cell classification

Install

# From git
pi install git:github.com/ovav-systems/ovav

# Or copy extension manually
cp src/extensions/ovav-memory.ts ~/.pi/agent/extensions/ovav-memory.ts

Requires: pi ≥ 0.84, Node.js ≥ 20

Quick start

pi
# Extension auto-loads. OVAV MEMORY v3 shows notification on session start.

Tools

| Tool | Description | |------|-------------| | ovav_validate | Run F0-F5 governance validators | | ovav_daily | Daily governance brief | | ovav_next_work | Next recommended work item | | ovav_check_integrity | System integrity check |

Architecture

~/.pi/agent/extensions/
└── ovav-memory.ts        ← Extension entry point

.ovav/runtime/livemem/cells/  ← Cell storage (one JSON per cell)
.ovav/audit/                   ← Audit event stream

Memory flow

tool_call / tool_result
       ↓
   LiveProfiler (5-min sliding window)
       ↓
   Detector (classifies signal, looks up Cell)
       ↓
   before_agent_start injects Cell summary
       ↓
   LLM receives: <ovav_memory_inject>...</ovav_memory_inject>

Signal thresholds

| Signal | Trigger | |--------|---------| | RETRY_LOOP | 3-4 errors in window | | ERROR_LOOP | 5+ errors in window | | EDIT_BURST | 4+ writes in window | | CONTEXT_PRESS | 3+ reads in window |

Cell weight

• Initial weight: 0.5
• Injection helps → +0.1 (max 1.0)
• Injection doesn't help → -0.05 (min 0.0)
• Cells below 0.6 weight are not injected (configurable)

Governance validators

| Gate | Checks | |------|--------| | F0 | Plan exists, VERSION consistent | | F1 | Architecture: .gitignore, go.mod, VERSION, internal/ boundaries | | F2 | Roles: service areas in caps.yaml | | F3 | Security: no plaintext secrets, no exfil patterns | | F4 | Integration: runs all gates, computes HEALTHY/DEGRADED/CRITICAL |

Privacy

Cells are tagged:

• PUBLIC — safe to inject in any scope
• PROJECT — only in project scope
• SENSITIVE — only in project scope with confirmation
• SECRET — never injected automatically

Configuration

// In extension: OVAVMemory accepts config
const ovav = new OVAVMemory({
  projectPath: process.cwd(),
  harnessScope: "pi",
  minWeight: 0.6,  // minimum cell weight to inject
});

License

MIT — OVAV Systems