How samarvscode/agentaegis_v2.0---universal-cognitive-interceptor-and-vetting-harness works
AgentAegis is a lifecycle interception and vetting harness for autonomous coding agents. Its principal workflow is: an agent proposes a tool action, the installed lifecycle hook runs deterministic safety and cycle checks, gathers bounded workspace/session context for semantic review when needed, and permits or vetoes execution. Post-tool events update session and decision telemetry; completion hooks run test and claim-to-disk reconciliation before semantic acceptance. README documents these major capabilities; sampled source confirms the coordinator and key module responsibilities, but not every internal dispatch.
Main entry points: interceptor.js Hook coordinator · acceptance-gate.js Acceptance gate · state-collector.js Context collector · jev-client.js Jev decision client
Components 18
Lifecycle control
- Hook coordinator
harness/interceptor.js - Hook installer
harness/install.js
Safety and context
- Sensitive guard
harness/sensitive-guard.js - Jev decision client
harness/jev-client.js - Cycle detector
harness/cycle-detector.js - Edit variance
harness/diff-variance.js - Code law linter
harness/core-laws-linter.js - Context collector
harness/state-collector.js - Workspace detector
harness/manifest-sniffer.js
Completion verification
- Acceptance gate
harness/acceptance-gate.js - Runner parser
harness/runner-parser.js
Session and audit
- Session state
harness/cycle-detector.js - Decision tracker
harness/decision-tracker.js
Other components
- Coding agent
- Lifecycle hooks
- Project test runner
- Workspace and disk
- TypeSafe Jev
Connections 20
- Coding agent → Lifecycle hooks: sends events
- Lifecycle hooks → Hook coordinator: invokes hooks
- Hook installer → Lifecycle hooks: configures hooks
- Hook coordinator → Sensitive guard: checks actions
- Hook coordinator → Cycle detector: checks repetition
- Cycle detector → Edit variance: classifies edits
- Hook coordinator → Code law linter: lints artifacts
- Hook coordinator → Context collector: builds context
- Context collector → Workspace detector: detects ecosystem
- Context collector → Workspace and disk: reads workspace
- Hook coordinator → Jev decision client: requests review
- Acceptance gate → Project test runner: runs tests
- Acceptance gate → Runner parser: parses output
- Acceptance gate → Workspace and disk: reconciles claims
- Acceptance gate → Jev decision client: requests approval
- Jev decision client → TypeSafe Jev: sends decisions
- Hook coordinator → Acceptance gate: gates completion
- Hook coordinator → Session state: loads and saves
- Acceptance gate → Session state: loads telemetry
- Hook coordinator → Decision tracker: records decisions