Update Python library to support AI Dark Factory agent requirements

[kimiko-terraphim]

Background

Building an AI Dark Factory with 10 specialized agents maintaining a Gitea fork. Each agent needs to capture learnings and interact with the Terraphim knowledge graph.

Current State

• terraphim-agent CLI (Rust) works well: search, learn capture, query, list
• Python wrapper needed for agent integration
• Current Python bindings limited

Requirements

1. Agent Learning Capture

Each of 10 agents needs:

2. Knowledge Graph Operations

3. Multi-Agent Coordination

4. Learning Audit

Agent-Specific Requirements

Agent	Primary Use	Special Needs
Security Sentinel	CVE patterns	Vulnerability node types
Upstream Sync	Merge strategies	Git operation patterns
Extension Architect	AI optimizations	Model performance data
Test Guardian	Flaky test causes	Test pattern nodes
Code Reviewer	Security anti-patterns	Code pattern nodes
Scenario Tester	Chaos recovery	Failure pattern nodes
Product Development	Feature prioritization	Compound-RICE data
Release Engineer	Deployment patterns	Canary/rollback data
Market Research	Content performance	Engagement pattern nodes
Meta-Coordinator	Coordination patterns	Escalation pattern nodes

Proposed API Design

Implementation Notes

1. Backend: Can wrap existing Rust CLI via subprocess or use direct bindings
2. Storage: JSONL files in /data/kg/ with optional graph database
3. Performance: Agents run locally, low latency required (< 100ms)
4. Concurrency: Multiple agents may write simultaneously

Acceptance Criteria

• AgentLearning class functional for all 10 agents
• KnowledgeGraph add_node/search working
• MultiAgentCoordination broadcast working
• LearningAudit spot_check working
• Documentation with examples
• Unit tests covering all classes

Timeline

Needed for AI Dark Factory Week 2-3 implementation.

Related

• AI Dark Factory plan: https://github.com/AlexMikhalev/cto-executive-system/blob/main/projects/ai-dark-factory-gitea-fork.md
• terraphim-agent CLI reference: https://github.com/AlexMikhalev/cto-executive-system/blob/main/docs/terraphim-agent-command-reference.md