SESSION CONTEXT
Documentation for Sessions
Session 10 Context
Quick Reference
| Item | Value |
|---|---|
| Session Number | 10 |
| Started | December 17, 2025 |
| Status | Active |
| Focus | Production Readiness |
Critical Files
Session Management
docs/data/sessionID.json # Current active session
docs/data/complete_session_history.json # All sessions index
.cursor/ai-memory/current-session.json # Local hot cache
AI Backend
apis/backend-ai-api/src/app/learning/learning.service.ts # Intelligence Pyramid
apis/backend-ai-api/src/app/learning/triggers/adaptive-trigger.service.ts # Triggers
apis/backend-ai-api/src/app/orchestration/orchestration.service.ts # Multi-agent
MCP System
MCP/mcp-development-ai/src/tools/log-decision.ts # Decision logging + sync
MCP/mcp-development-ai/src/storage/docs-data-integration.ts # Session handling
Frontend Dashboard
libs/libs-ai/gograb-ai/src/lib/components/ai-dashboard-v2/ # Main dashboard
libs/libs-ai/gograb-ai/src/lib/ai.routes.ts # All AI routes
Key Architectural Decisions (From Session 9)
1. Intelligence Pyramid
- Core Rules (~20 items, ~500 tokens) - Always loaded, in-memory cached
- Pattern Library (~100 items, ~2000 tokens) - Loaded by category
- Similar Decisions (3-5 items, ~500 tokens) - Semantic search
- Archive (10K+ items) - Never loaded directly, only for mining
2. Adaptive Triggers (Event-Driven)
| Trigger | Condition | Job Type |
|---|---|---|
| Volume | N decisions in category | Pattern Extraction |
| Repetition | Same question 3x | Pattern Extraction |
| Performance | Success rate < 60% | Anti-Pattern Detection |
| Confidence | Confidence drops 20% | Meta-Learning |
| Novelty | New category detected | Accelerated Learning |
3. Three-Tier Architecture
| Tier | Control | Description |
|---|---|---|
| Cursor (Development) | Read-Only | Observe IDE agent decisions |
| Platform | Full Control | Configure models, training, behavior |
| Tenant (Space) | Tenant-Config | Per-tenant model & operation settings |
4. sessionID Format
- Now numeric:
10.0,10.1,10.2, etc. - Each
log_decision()call increments the decimal - Enables easy calculations and sorting
API Endpoints
All frontend libraries should use these endpoints:
// Infrastructure
/ai-api/infrastructure/decisions
/ai-api/infrastructure/patterns
/ai-api/infrastructure/conventions
// Learning
/ai-api/learning/pyramid
/ai-api/learning/patterns/mine
/ai-api/learning/rules
// Platform
/ai-api/platform/stats
/ai-api/platform/agents
// Triggers
/ai-api/triggers/stats
/ai-api/triggers/queue
// Orchestration
/ai-api/orchestration/plans
/ai-api/orchestration/execute
Checklist for New Agents
- ✅ Call
preflight({ task: "description" })before any task - ✅ Use
/ai-api/*endpoints (NOT/api/ai-agents/*) - ✅ Log decisions with
log_decision()for learning - ✅ sessionID is numeric (e.g., 10.5)
- ✅ External template/style files for Angular components
- ✅ Use inject() function, NOT constructor injection
Warnings
⚠️ Do NOT restart servers unless explicitly requested
⚠️ Do NOT use inline templates for complex components
⚠️ Do NOT use old /api/ai-agents/ endpoints
⚠️ Do NOT use string sessionID - always numeric