boc/SIL/VISION.md

SIL Vision: Från Kodassistent till Systemkognitiv Plattform

"Grafen är inte ett analysverktyg — den är den gemensamma modellen som alla agenter arbetar utifrån."

---

Nuvarande Tillstånd (2026-06-30)

✅ Vad som finns

• Kunskapsgraf (JSON) med noder, kanter, confidence
• Graph Engine - Resonerar över grafen (impact, failure, blast radius)
• PR Analyzer - Analyserar PR:s mot grafen
• Auto-Updater - Uppdaterar grafen från verifierbara källor
• Observer - Skannar kod, git, miljövariabler
• Reality Check - Jämför Intended vs Actual vs Observed

🔄 Arbetsflöde idag

Användare frågar → Agent läser graf → Agent svarar

---

Målbild (6 månader)

🎯 Vision

Förändringsbegäran kommer in
        │
        ▼
┌─────────────────────────────┐
│  SIL analyserar påverkan    │
│  - Affärsprocesser          │
│  - Tekniska komponenter     │
│  - Risker                   │
│  - Tester                   │
└─────────────────────────────┘
        │
        ▼
┌─────────────────────────────┐
│  Plan genereras             │
│  - Steg-för-steg            │
│  - Beroenden                │
│  - Deployment-ordning       │
│  - Rollback-strategi        │
└─────────────────────────────┘
        │
        ▼
┌─────────────────────────────┐
│  Specialiserade agenter     │
│  genomför arbetet           │
│  - Kodändringar             │
│  - Tester                   │
│  - Dokumentation            │
└─────────────────────────────┘
        │
        ▼
┌─────────────────────────────┐
│  Verifiering                │
│  - Tester körs              │
│  - Graf uppdateras          │
│  - Reality check            │
└─────────────────────────────┘
        │
        ▼
   Förändring färdig

---

Arkitektur

┌─────────────────────────────────────────────────────────────┐
│                      AI-AGENTER                              │
│  Bernt (system) · CodeAgent (kod) · TestAgent (tester)     │
│  DocAgent (dok) · OpsAgent (drift) · SecAgent (säkerhet)   │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│              SYSTEM INTELLIGENCE LAYER (SIL)                 │
│                                                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │   OBSERVE   │  │   REASON    │  │   ACT       │         │
│  │             │  │             │  │             │         │
│  │ • Git       │  │ • Impact    │  │ • Plan      │         │
│  │ • AST       │  │ • Risk      │  │ • Execute   │         │
│  │ • DB Schema │  │ • Compliance│  │ • Verify    │         │
│  │ • K8s       │  │ • Conflict  │  │             │         │
│  │ • Metrics   │  │             │  │             │         │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘         │
│         │                │                │                 │
│         └────────────────┼────────────────┘                 │
│                          │                                  │
│                   ┌──────┴──────┐                          │
│                   │  CONFIDENCE  │                          │
│                   │   SYSTEM     │                          │
│                   │              │                          │
│                   │ • Source     │                          │
│                   │ • History    │                          │
│                   │ • Trust      │                          │
│                   └──────┬──────┘                          │
│                          │                                  │
│                   ┌──────┴──────┐                          │
│                   │ CONTINUOUS  │                          │
│                   │REALITY CHECK│                          │
│                   │              │                          │
│                   │ • Intended  │                          │
│                   │ • Actual    │                          │
│                   │ • Observed  │                          │
│                   └─────────────┘                          │
└──────────────────────┬──────────────────────────────────────┘
                       │
                       ▼
┌─────────────────────────────────────────────────────────────┐
│                    KNOWLEDGE GRAPH                           │
│                                                              │
│  Noder:                                                      │
│  • Services (Auth, Wallet, Mission, KYC)                    │
│  • APIs (endpoints, contracts)                              │
│  • Databases (tables, columns, constraints)                 │
│  • Business Processes (Onboarding, Mission Flow)            │
│  • Infrastructure (EC2, S3, Lambda, RDS)                    │
│  • Risks (Stripe down, DB failure, KYC fraud)               │
│  • Domains (users, missions, claims, submissions)           │
│                                                              │
│  Kanter (med confidence, source, history):                  │
│  • Service → calls → API                                    │
│  • API → uses → Database Table                              │
│  • Process → depends_on → Service                           │
│  • Risk → threatens → Component                             │
│                                                              │
│  Metadata per nod:                                          │
│  • Why? (business justification)                            │
│  • When? (creation date, commits)                          │
│  • Who? (owner, team)                                       │
│  • How? (implementation details)                            │
└─────────────────────────────────────────────────────────────┘

---

Implementation Roadmap

Fas 1: Foundation (NU - 2 veckor)

• Kunskapsgraf med confidence
• Graph engine (impact, failure, blast)
• PR analyzer
• Auto-updater (Git, AST, DB)
• Git webhook integration
• AST parser för Rust/TypeScript
• Database schema scanner

Fas 2: Intelligence (2-4 veckor)

• Plan generator
• Risk assessment engine
• Architecture compliance checker
• Conflict detection
• "Why?" metadata tracking
• ADR (Architecture Decision Records) integration

Fas 3: Autonomy (1-2 månader)

• Specialized agents (Code, Test, Doc, Ops, Sec)
• Agent coordination protocol
• Self-healing capabilities
• Automatic rollback
• Predictive alerting

Fas 4: Ecosystem (3-6 månader)

• Dashboard for humans
• API for external tools
• Multi-system federation
• Marketplace for agents

---

Konkreta Användningsfall

Use Case 1: "Lägg till Apple Pay"

Input: "Lägg till Apple Pay som betalningsmetod"

SIL Analysis:
  Påverkade komponenter:
    - Wallet Service (ny endpoint)
    - Auth Service (ny consent)
    - Database (ny tabell/kolumn)
    - Stripe (ny integration)
    
  Affärsprocesser:
    - Zoomer Onboarding (nytt steg)
    - Payout Flow (ny betalningsmetod)
    
  Risker:
    - PCI DSS compliance (high)
    - Apple Pay certificate expiry (medium)
    
  Tester:
    - Unit: ApplePayService
    - Integration: Wallet + Apple Pay
    - E2E: Full betalningsflöde
    - Security: PCI compliance scan
    
  Plan:
    1. Database migration
    2. Wallet Service (feature flag: apple_pay)
    3. Auth Service (ny consent)
    4. Frontend (ny UI)
    5. Integrationstester
    6. Canary deployment (5%)
    7. Full rollout
    
  Rollback:
    - Feature flag off
    - Database rollback script

Use Case 2: "Stripe är nere"

Input: Alert: Stripe API 500 errors

SIL Analysis:
  Impact:
    - Payout Service (down)
    - Wallet Service (degraded)
    - Zoomer Onboarding (blocked)
    
  Business Impact:
    - Zoomers kan inte få betalt
    - Kunder kan inte köpa credits
    - ~$X/minute i förlorad intäkt
    
  Automated Response:
    1. Skicka alert till OpsAgent
    2. Aktivera fallback: manuell payout queue
    3. Uppdatera status page
    4. Notifiera affected users
    5. Skapa incident record
    
  Recovery:
    1. Monitor Stripe status
    2. När Stripe uppe: processa queue
    3. Verifiera alla payouts
    4. Uppdatera grafen

Use Case 3: "Refactor Auth Service"

Input: PR #123 "Refactor Auth Service to use OAuth2"

SIL PR Analysis:
  Changed Components:
    - Auth Service (refactored)
    
  Impact Assessment:
    Direct:
      - Auth Service endpoints
      - JWT token format
      
    Indirect:
      - All services (auth middleware)
      - Frontend (login flow)
      - Mobile apps (token refresh)
      
  Breaking Changes:
    - JWT format change (affects all clients)
    - Session handling (affects active users)
    
  Required Actions:
    1. Update all service middleware
    2. Update frontend auth logic
    3. Migration: existing sessions
    4. Coordinate mobile app release
    
  Tests:
    - Unit: Auth Service (100% coverage)
    - Integration: All service-to-service calls
    - E2E: Full user flows
    - Load: Token validation performance
    
  Deployment:
    - Blue-green deployment
    - Session migration
    - Rollback: instant (keep old service running)

---

Teknisk Stack

Core

• Knowledge Graph: JSON/GraphQL/Neo4j
• Reasoning Engine: Node.js/TypeScript
• Observer: Rust (performance) + Node.js (integration)
• Storage: PostgreSQL (metadata) + S3 (artifacts)

Integration

• Git: Webhooks + polling
• CI/CD: GitHub Actions / AWS CodePipeline
• Monitoring: Prometheus + Grafana
• Alerting: PagerDuty + Slack

AI

• Primary: moonshot/kimi-k2.6 (via OpenClaw)
• Backup: Claude (complex reasoning)
• Embedding: Local (sentence-transformers)
• Vector DB: pgvector / Pinecone

---

Framgångsmått

Mått	Nu	6 månader
Graf coverage	60%	95%
Auto-updated nodes	20%	80%
PR analysis time	30 min	30 sek
Incident response	Manual	70% automated
Agent autonomy	Low	High
System understanding	Document-based	Model-based

---

Risker och Mitigation

Risk	Sannolikhet	Impact	Mitigation
Graf blir inaktuell	Medium	High	Auto-update + reality check
Felaktiga slutsatser	Low	High	Confidence system + human review
Prestanda	Medium	Medium	Caching + incremental updates
Adoption	Medium	High	Start with PR analysis

---

SIL Vision v0.1 Författare: Bernt (AI-agent) med vägledning från Erik Svensson Datum: 2026-06-30