2 Commits

• feat: agent description compression with lazy loading (#696)

  * feat: add agent description compression with lazy loading (#491)
  
  Agent descriptions consume ~26k tokens (121KB across 27 agents). This adds
  a compression library with three modes:
  - catalog: metadata only (~2-3k tokens) for agent selection
  - summary: metadata + first paragraph (~4-5k tokens) for routing
  - full: no compression, for when agent is invoked
  
  Includes lazy-load function to fetch full agent body on demand.
  21 tests covering parsing, compression, filtering, and real agents dir.
  
  * fix: update JSDoc to include all stats fields in buildAgentCatalog
  
  Add compressedBytes and mode to the documented return type, matching
  the actual implementation.

  Affaan Mustafa · 2026-03-20 03:53:22 -07:00
  bea68549c5
• feat: agent compression, inspection logic, governance hooks (#491, #485, #482) (#688)

  Implements three roadmap features:
  
  - Agent description compression (#491): New `agent-compress` module with
    catalog/summary/full compression modes and lazy-loading. Reduces ~26k
    token agent descriptions to ~2-3k catalog entries for context efficiency.
  
  - Inspection logic (#485): New `inspection` module that detects recurring
    failure patterns in skill_runs. Groups by skill + normalized failure
    reason, generates structured reports with suggested remediation actions.
    Configurable threshold (default: 3 failures).
  
  - Governance event capture hook (#482): PreToolUse/PostToolUse hook that
    detects secrets, policy violations, approval-required commands, and
    elevated privilege usage. Gated behind ECC_GOVERNANCE_CAPTURE=1 flag.
    Writes to governance_events table via JSON-line stderr output.
  
  59 new tests (16 + 16 + 27), all passing.

  Affaan Mustafa · 2026-03-20 01:38:13 -07:00
  0b0b66c02f