poimen-memory/MONITORING_AGENT_TASKS.md

# Monitoring Agent: Implementation Tasks

**Milestone**: `monitoring-agent`
**Status**: 🔧 Not started
**Duration**: 4-6 weeks
**Effort**: ~1,500 LOC

---

## Phase 1: Temporal Setup (3-5 days)

### Task 1.1: Deploy Temporal Server in K8s
- [ ] StatefulSet configuration (persistence)
- [ ] PostgreSQL event log backend
- [ ] ElasticSearch for visibility
- [ ] K8s manifests in `k8s/temporal/`
- [ ] Health checks + readiness probes
- **Effort**: 150 LOC | **Time**: 2 days
- **Dependencies**: None
- **Blocks**: Phase 2

### Task 1.2: Add Temporal SDK to Rust Project
- [ ] Add `temporal-rust-sdk` to `Cargo.toml`
- [ ] Create `crates/mem-temporal/` workspace crate
- [ ] Worker registration + gRPC connection
- [ ] Activity executor setup
- [ ] Workflow executor setup
- **Effort**: 200 LOC | **Time**: 1 day
- **Dependencies**: 1.1
- **Blocks**: Phase 2

### Task 1.3: Temporal Configuration + Secrets
- [ ] Environment variables (TEMPORAL_HOST, TEMPORAL_NAMESPACE)
- [ ] Worker identity configuration
- [ ] Task queue setup (synthesis-queue, compaction-queue)
- **Effort**: 50 LOC | **Time**: 4 hours
- **Dependencies**: 1.1, 1.2
- **Blocks**: Phase 2

---

## Phase 2: Agent Workflows (1-2 weeks)

### Task 2.1: Synthesis Workflow Definition
- [ ] `crates/mem-temporal/src/workflows/synthesis_workflow.rs`
- [ ] Workflow orchestration logic
- [ ] Activity composition (health check → synthesis → logging → metrics)
- [ ] Retry policies (exponential backoff, max 5 retries)
- [ ] Heartbeat configuration (every 10s)
- **Effort**: 200 LOC | **Time**: 3 days
- **Dependencies**: 1.2, 1.3
- **Blocks**: 2.3, 2.4

### Task 2.2: Synthesis Activities (5 activities)
- [ ] `MonitorMemoryHealth` activity
  - GET /health check
  - Latency measurement
  - Failure detection
  
- [ ] `ExecuteSynthesis` activity
  - POST /memory/synthesize call
  - LLM integration
  - Heartbeat emission
  
- [ ] `LogSynthesisResult` activity
  - POST /memory/ingest (audit)
  - Temporal audit trail
  
- [ ] `UpdateCacheMetrics` activity
  - Metric recording
  - Performance tracking
  
- [ ] `CoordinateCompaction` activity
  - Signal to compaction agent
  - Readiness check
  
- **Effort**: 250 LOC | **Time**: 4 days
- **Dependencies**: 2.1
- **Blocks**: 2.3

### Task 2.3: Compaction Workflow Definition
- [ ] `crates/mem-temporal/src/workflows/compaction_workflow.rs`
- [ ] 4-stage orchestration (identify → dedup → gc → invalidate)
- [ ] Failure handling + rollback strategy
- **Effort**: 150 LOC | **Time**: 2 days
- **Dependencies**: 1.2, 1.3
- **Blocks**: 2.4

### Task 2.4: Compaction Activities (4 activities)
- [ ] `IdentifyDuplicates` activity
- [ ] `DeduplicateEdges` activity
- [ ] `GarbageCollection` activity
- [ ] `InvalidateCache` activity
- **Effort**: 200 LOC | **Time**: 3 days
- **Dependencies**: 2.3
- **Blocks**: Integration tests

### Task 2.5: Worker + Task Queue Registration
- [ ] Activity worker setup
- [ ] Workflow worker setup
- [ ] Task queue polling
- [ ] Namespace configuration
- **Effort**: 100 LOC | **Time**: 1 day
- **Dependencies**: 2.1-2.4
- **Blocks**: Phase 3

---

## Phase 3: Agent Self-Awareness (2-3 weeks)

### Task 3.1: AGENT_PROMPT Entity Type
- [ ] Schema: New entity type in memory_entity
- [ ] Repository: `synthesis_cache_repo.rs` (get_agent_prompt)
- [ ] Migration: Add to entity type enum
- [ ] Activity: Load prompt on agent startup
- **Effort**: 100 LOC | **Time**: 1 day
- **Dependencies**: Memory service
- **Blocks**: 3.2

### Task 3.2: AGENT_SKILL Linking
- [ ] Edge type: agent → skill relationships
- [ ] Repository methods: link_agent_to_skill, get_agent_skills
- [ ] Confidence tracking per skill
- [ ] Success rate calculation
- **Effort**: 80 LOC | **Time**: 1 day
- **Dependencies**: 3.1
- **Blocks**: 3.4

### Task 3.3: AGENT_PERFORMANCE Metrics
- [ ] Entity type: Temporal metrics
- [ ] Repository: Store + query metrics
- [ ] Activity: Log performance data post-execution
- [ ] Time window filtering (last_7_days, last_30_days)
- **Effort**: 120 LOC | **Time**: 2 days
- **Dependencies**: 3.1
- **Blocks**: 3.4

### Task 3.4: Agent Decision Tracking + Learning
- [ ] Edge type: agent_decision_outcome
- [ ] Decision logging (parameter, value, confidence before)
- [ ] Outcome recording (result, metric)
- [ ] Confidence evolution (update after outcome)
- [ ] Learning loop in agent code
- **Effort**: 200 LOC | **Time**: 3 days
- **Dependencies**: 3.1-3.3
- **Blocks**: 3.5

### Task 3.5: Agent Audit Trail Integration
- [ ] Dual audit: Temporal history + Memory entities
- [ ] Query interface for reviewers
- [ ] Temporal CLI integration
- [ ] Retention policy (365 days)
- **Effort**: 100 LOC | **Time**: 1 day
- **Dependencies**: 3.1-3.4
- **Blocks**: Testing

---

## Testing & Documentation

### Task 4.1: Integration Tests
- [ ] Workflow execution end-to-end
- [ ] Activity retry behavior
- [ ] Heartbeat detection
- [ ] Failure recovery
- [ ] State replay on restart
- **Effort**: 300 LOC | **Time**: 3 days
- **Dependencies**: Phase 2 complete
- **Blocks**: Integration

### Task 4.2: Monitoring & Observability
- [ ] Temporal UI setup (temporal.riotpiao.com)
- [ ] Prometheus metrics export
- [ ] Alerting rules (workflow timeout, activity failure)
- [ ] Grafana dashboards
- **Effort**: 150 LOC | **Time**: 2 days
- **Dependencies**: Phase 1 complete
- **Blocks**: Production

### Task 4.3: Documentation
- [ ] Agent architecture diagram
- [ ] Workflow execution flow
- [ ] Operational runbook
- [ ] Troubleshooting guide
- **Effort**: 50 LOC | **Time**: 1 day
- **Dependencies**: All phases
- **Blocks**: Release

---

## Credentials Status

✅ **SOPS Encrypted**: `k8s/app/memory-agent-secrets.enc.yaml`
- CLIENT_ID: `memory-agent`
- CLIENT_SECRET: Encrypted
- TOKEN_URL: `https://authentik.riotpiao.com/application/o/token/`
- AUTHENTIK_ISSUER: `https://authentik.riotpiao.com/application/o/memory-agent/`

✅ **JWT Auth Verified**: `memory-agent` credentials working
- Test result: Token obtained successfully
- Expiry: 1 hour (3600s)
- Scopes: Default (sufficient for LLM operations)

---

## Timeline

```
Week 1 (Phase 1):        Temporal setup
Week 2-3 (Phase 2):      Agent workflows
Week 4-5 (Phase 3):      Self-awareness
Week 6 (Testing + Docs): Integration + release
```

**Start Date**: TBD
**Target End Date**: TBD (+4-6 weeks)