How popla69/pic works
PIC is an in-process defensive framework that monitors application functions, evaluates telemetry for security and behavioral anomalies, and allows or blocks activity. The principal workflow is application call → CellAgent telemetry → BrainConnector → BrainCore decision, with state, trace, and signed audit persistence. Its documented adaptive learning, cryptographic validation, and real-world testbench are also represented. Edges reflect the excerpts, SOURCE INDEX references, or README; uninspected implementation details are omitted or left unconnected.
Main entry points: core.py BrainCore · integrated.py Integrated PIC · harness.py Test Harness · suite.py Test Suite
Components 27
Monitoring Runtime
- Integrated PIC
src/pic/integrated.py - CellAgent
src/pic/cellagent/agent.py - Brain Connector
src/pic/cellagent/brain_connector.py - Configuration
src/pic/config/loader.py - PII Redaction
src/pic/cellagent/redaction.py - Rate Limiting
src/pic/cellagent/rate_limiter.py
Detection Engine
- BrainCore
src/pic/brain/core.py - Anomaly Detection
src/pic/brain/detector.py - Baseline Profiling
src/pic/brain/profiler.py - Pattern Cache
src/pic/brain/pattern_cache.py - Event Normalization
src/pic/brain/normalizer.py - Security Validation
src/pic/brain/security_validator.py - Action Executor
src/pic/effector/executor.py
State and Security
- HMAC Crypto
src/pic/crypto/core.py - Baseline State
src/pic/storage/state_store.py - Event Traces
src/pic/storage/trace_store.py - Signed Audit Log
src/pic/storage/audit_store.py
Real-World Testbench
- Test Suite
src/pic/realworld/suite.py - Test Harness
src/pic/realworld/harness.py - Safety Controls
src/pic/realworld/safety.py - Sandbox
src/pic/realworld/sandbox.py - Test Reporting
src/pic/realworld/reporting.py - Attack Scenarios
src/pic/realworld/testers
Shared Data Models
- Telemetry Events
src/pic/models/events.py - Security Decisions
src/pic/models/decision.py - Signed Messages
src/pic/models/integration.py
Other components
- Application User
Connections 36
- Application User → Integrated PIC: starts monitoring
README.md - Integrated PIC → CellAgent: initializes
src/pic/integrated.py - Integrated PIC → BrainCore: initializes
src/pic/integrated.py - Integrated PIC → Brain Connector: connects
src/pic/integrated.py - Integrated PIC → Baseline State: initializes
src/pic/integrated.py - Integrated PIC → Signed Audit Log: initializes
src/pic/integrated.py - Integrated PIC → Event Traces: initializes
src/pic/integrated.py - CellAgent → Brain Connector: sends events
src/pic/cellagent/agent.py - CellAgent → PII Redaction: redacts data
src/pic/cellagent/agent.py - CellAgent → Rate Limiting: limits traffic
src/pic/cellagent/agent.py - Brain Connector → BrainCore: forwards events
src/pic/cellagent/brain_connector.py - BrainCore → Security Validation: validates signatures
src/pic/brain/core.py - BrainCore → Event Traces: stores events
src/pic/brain/core.py - BrainCore → Baseline State: reads baselines
src/pic/brain/core.py - BrainCore → Event Normalization: normalizes events
src/pic/brain/core.py - BrainCore → Anomaly Detection: detects anomalies
src/pic/brain/core.py - BrainCore → Baseline Profiling: profiles baselines
src/pic/brain/core.py - BrainCore → Pattern Cache: checks patterns
src/pic/brain/core.py - BrainCore → Action Executor: executes action
src/pic/brain/core.py - BrainCore → Signed Audit Log: logs decisions
src/pic/brain/core.py - Signed Audit Log → HMAC Crypto: signs entries
src/pic/storage/audit_store.py - BrainCore → Telemetry Events: processes events
src/pic/brain/core.py - BrainCore → Security Decisions: returns decisions
src/pic/brain/core.py - Brain Connector → Signed Messages: uses messages
src/pic/cellagent/brain_connector.py - Integrated PIC → Configuration: loads settings
src/pic/integrated.py - Test Suite → Test Harness: runs through
src/pic/realworld/suite.py - Test Suite → Safety Controls: applies controls
src/pic/realworld/suite.py - Test Suite → Sandbox: uses sandbox
src/pic/realworld/suite.py - Test Suite → Test Reporting: produces reports
src/pic/realworld/suite.py - Test Suite → Attack Scenarios: dispatches scenarios
src/pic/realworld/suite.py - Test Harness → Safety Controls: checks safety
src/pic/realworld/harness.py - Test Harness → Sandbox: uses sandbox
src/pic/realworld/harness.py - Test Harness → BrainCore: exercises engine
src/pic/realworld/harness.py - Test Harness → Baseline State: uses state
src/pic/realworld/harness.py - Test Harness → Signed Audit Log: uses audit log
src/pic/realworld/harness.py - Test Harness → Event Traces: uses traces
src/pic/realworld/harness.py