Files
boocode/openspec/changes/archived/2026-06-07-port-audit-parlant-patterns/proposal.md
indifferentketchup c935687725 chore(openspec): drop 9 superseded proposals + 11 stub archive files
Drop 9 batch proposals that are superseded by the boocode-lift-analysis
(boocontext-audit, conductor upgrades, self-healing/verify-gate skills):
add-3tier-memory, import-llm-evaluator, import-pregel-engine, plugin-platform,
conductor-evolution, code-intelligence-upgrade, dev-workflow, ui-overhaul,
agent-reliability.

Delete 11 stub archive files (49-66B each, 'Status: Shipped. Archived.' only)
that provide zero documentation value over the existing CHANGELOG.md + git tags.
2026-06-07 22:15:38 +00:00

2.1 KiB
Raw Blame History

Why

The audit-harness (hooks + skills + AuditContext) and Parlant (GuidelineStore + Journey engine) provide two proven patterns for agent session management. audit-harness solves context-window loss through persistent audit trails, graded recovery, and structured commands (/start → /end → /recover → /report-daily). Parlant solves behavioral consistency through a versioned guideline document store with tag/label-based retrieval, journey-based SOPs, and backtrack detection.

Porting these patterns into boocode's agent ecosystem gives every agent working in this repo persistent session management, cross-session user correction awareness, and behavioral guideline enforcement — without building any of it from scratch.

What Changes

New Capabilities

  • Data Directory Convention: .boo/runs/ directory with buffer files, session dirs, .current_session handshake, unified index.json. AUDIT_DOT_DIR env var for platform override.

  • Session Lifecycle Commands: /start creates named audit sessions with auto-recovery (L0+L2). /end flushes buffers, runs integrity checks, generates session_summary.md. /recover graded context loading (L0L3). /report-daily aggregates all sessions into a 7-section report; /report-daily review also runs morning self-review.

  • User Correction Tracking: Structured user_correction records with original_claim/correction/principle_extracted/persisted_to. Auto-detected on /end. Correction-as-precedent enforcement when agent actions contradict prior corrections.

  • Behavioral Guidelines Store: Versioned GuidelineDocumentStore ported from Parlant with condition+action+description content model, tag/label filtering, and content-based find_guideline(). Journey → guideline auto-projection (SOP nodes → guidelines with follow-up edges). Journey backtrack detection batch.

Dependencies

  • Existing audit-harness patterns (audit-context.py, hooks, skills) reference implementation.
  • Parlant's GuidelineStore (guidelines.py) and JourneyStore (journeys.py) reference implementation.
  • No new external services. File-based JSONL storage (audit-harness pattern).