microdao-daarion/TODO.md

DAARION DAGI Stack — Unified TODO

Version: 1.0.0
Updated: 15.11.2025
Status: 🚀 Active Development

---

📋 Overview

Цей TODO обʼєднує два шари розробки:

1. Project Governance - монорепо, версіонування, документація, Open Core
2. Runtime Stack - Router, DevTools, CrewAI, microDAO, боти

---

A. Governance & Repo (система керування проєктом)

A.1 Монорепозиторій

• Створити монорепо daarion/dagi або daarion/city-stack
• Завести базову структуру:
  • /router - DAGI Router core
  • /agents/devtools - DevTools Agent
  • /agents/crew-orchestrator - CrewAI integration
  • /microdao - microDAO SDK + API
  • /docs - Documentation site
  • /config - Shared configs
  • /integration-tests - E2E tests
  • /changelog - Release notes

A.2 Git Strategy

• Налаштувати гілки:
  • main - стабільна версія (production-ready)
  • develop - інтеграційна гілка
  • feature/* - нові features
  • release/* - підготовка релізів
  • hotfix/* - критичні фікси

A.3 Versioning & Changelog

• Увести SemVer (v1.0.0, v1.1.0, v1.1.1…)
• Запровадити Conventional Commits
  • feat: нова функціональність
  • fix: виправлення багів
  • docs: зміни в документації
  • chore: технічні зміни
  • breaking: breaking changes
• Додати автоматичний changelog (semantic-release або GitHub Release Notes)
• Створити template для CHANGELOG.md

A.4 Project Management

• Створити GitHub Project "DAARION Engineering"
  • Колонки: Backlog → In Progress → Review → Testing → Done
• Домовитись: кожне завдання = Issue, кожен PR лінкується до Issue
• Налаштувати labels:
  • governance - структура проєкту
  • router - DAGI Router
  • agent/devtools - DevTools Agent
  • agent/crew - CrewAI
  • microdao - microDAO
  • docs - Documentation
  • security - Security issues
  • bug - Bug reports
  • enhancement - New features

A.5 Audit & Compliance

• Додати audit mode в DAGI Router:
  • Лог змін конфігів у /router/audit/YYYY-MM/config-*.json
  • Лог викликів агентів у /router/audit/YYYY-MM/calls-*.json
  • Лог routing decisions у /router/audit/YYYY-MM/routing-*.json
• У microDAO додати audit trail:
  • Лог змін ролей /microdao/audit/YYYY-MM/roles-*.json
  • Лог ентайтлментів /microdao/audit/YYYY-MM/entitlements-*.json
  • Лог токен-операцій /microdao/audit/YYYY-MM/tokens-*.json

---

B. Документація та публічність

B.1 Структура документації

• У монорепо створити структуру docs:
  • /docs/architecture - Architecture Decision Records (ADR)
  • /docs/api - API Reference
  • /docs/agents - Agents documentation
  • /docs/security - Security guidelines
  • /docs/roadmap - Public roadmap
  • /docs/updates/YYYY-MM/ - Monthly updates

B.2 Documentation Site

• Підняти Docusaurus (або MkDocs) як docs.daarion.city
• Налаштувати GitHub Pages деплой при пуші в main
• Додати автоматичну генерацію API docs (Swagger/OpenAPI)
• Налаштувати versioned docs (v1.0, v1.1, etc.)

B.3 Roadmap

• Витягти Roadmap з GitHub Projects у /docs/roadmap/index.md
• Описати high-level roadmap:
  • Q4 2025 — DAGI Router v1 + локальна LLM (qwen3:8b)
  • Q1 2026 — DevTools Agent + CrewAI backend
  • Q2 2026 — microDAO v2 federation + tokenomics
  • Q3 2026 — DAGI Cloud beta
• Створити детальний roadmap для кожного компонента

---

C. Ліцензування / Open Core

C.1 Open Core Model

• Обрати модель: Open Core
• Визначити публічні компоненти:
  • DAGI Router (core)
  • DevTools Agent (базова функціональність)
  • microDAO SDK
  • API specifications
  • Documentation, Roadmap
• Визначити закриті компоненти:
  • Orchestrator (Crew/DAGI внутрішній)
  • Приватні моделі / адаптації
  • Бізнес-логіка DAARION.city
  • DAO governance скрипти
  • Advanced analytics & monitoring

C.2 Licensing

• Створити кастомну ліцензію DAARION License v1.0
• Додати Apache 2.0 для відкритих модулів
• Створити LICENSE.md для кожного компонента
• Додати CLA (Contributor License Agreement) для external contributors

---

D. DAGI Router + DevTools + LLM

D.1 LLM Setup ✅

• Підняти qwen3:8b в Ollama
• Налаштувати systemd-сервіс ollama.service
• Переконатися, що ollama list показує qwen3:8b
• Створити router-config.yml з профілем local_qwen3_8b

D.2 Router Configuration

• Додати у config секцію providers:

  providers:
    llm_local:
      type: ollama
      model: qwen3:8b
      base_url: http://localhost:11434
    devtools:
      type: http
      base_url: http://localhost:8001
    cloud_deepseek:
      type: openai_compatible
      base_url: https://api.deepseek.com
      api_key_env: DEEPSEEK_API_KEY
  

D.3 Router Implementation

• Реалізувати в коді DAGI Router:
  • Loader для router-config.yml (PyYAML)
  • Provider registry (pluggable providers)
  • Routing dispatcher (mode → provider)
  • Request/Response validation (Pydantic)
  • Error handling & fallbacks

D.4 DevTools Agent

• Створити окремий FastAPI сервіс /opt/devtools-agent
• Реалізувати DevTools HTTP API:
  • POST /tools/fs/read - читання файлів
  • POST /tools/fs/write - запис файлів
  • POST /tools/ci/run-tests - запуск тестів
  • POST /tools/git/diff - git diff
  • POST /tools/git/commit - git commit
  • POST /tools/notebook/execute - notebook execution
• Додати security:
  • Path validation (sandboxing)
  • File size limits
  • Allowed operations whitelist

D.5 Routing Rules

• Доробити routing rules:
  • mode=devtools → provider=devtools
  • mode=chat + simple → provider=llm_local
  • mode=chat + complex → provider=cloud_deepseek
  • default → provider=llm_local
• Додати context-aware routing (аналіз складності запиту)

D.6 Testing

• Створити та прогнати test-devtools.sh
• Золоті сценарії:
  • Bugfix scenario
  • Simple refactor scenario
  • Architecture review scenario
• Додати integration tests для routing

---

E. CrewAI Orchestrator

E.1 Configuration

• Додати provider crewai у router-config.yml:

  providers:
    crewai:
      type: http
      base_url: http://localhost:8002
      timeout_ms: 60000
  

E.2 API Design

• Визначити payload для CrewAI:

  {
    "mode": "crew",
    "workflow": "microdao_onboarding",
    "input": {
      "user_id": "...",
      "dao_id": "...",
      "channel": "telegram"
    }
  }
  

E.3 Implementation

• Реалізувати HTTP API до CrewAI backend:
  • POST /workflows/execute
  • GET /workflows/{id}/status
  • POST /workflows/{id}/cancel
• Додати routing rule: mode=crew → provider=crewai
• Написати простий workflow:
  • microDAO onboarding
  • Multi-step approval flow
  • Task delegation workflow

E.4 Testing

• Зробити інтеграційний тест: POST /router {mode:"crew"}
• End-to-end workflow test

---

F. Інтеграція microDAO + Telegram/Discord

F.1 Gateway Bot Service

• Підняти gateway-bot сервіс:
  • /telegram/webhook - Telegram Bot API
  • /discord/events - Discord Events API
  • Unified bot framework

F.2 Bot → Router Integration

• Прокинути: Bot → Gateway → POST /router/chat

  {
    "mode": "chat",
    "source": "telegram",
    "dao_id": "greenfood-dao",
    "user_id": "tg:123456",
    "message": "...",
    "session_id": "tg:123456:greenfood-dao",
    "context": {
      "agent_id": "microdao_assistant",
      "locale": "uk-UA"
    }
  }
  

F.3 RBAC Integration

• У Router додати rule microdao_chat:
  • mode=chat + has dao_id → use_provider: llm_local або crewai
• Додати витяг ролей/ентайтлментів із microDAO:
  • Fetch user roles by user_id + dao_id
  • Check entitlements for requested operations
• Обмежити доступні агенти залежно від ролі:
  • admin → full access
  • member → limited access
  • guest → read-only

F.4 E2E Testing

• Протестувати end-to-end:
  • Telegram → Gateway → Router → LLM → Response
  • Telegram → Gateway → Router → DevTools → Response
  • Telegram → Gateway → Router → CrewAI → Response
• Перевірити RBAC constraints
• Stress test (багато користувачів, багато DAO)

---

📊 Progress Tracking

Last Updated: 15.11.2025

Completed ✅

• D.1: LLM Setup (qwen3:8b + Ollama)
• Initial router-config.yml created
• Basic DAGI Router running on :9101

In Progress 🔄

• D.3: Router implementation (config loader)
• D.4: DevTools Agent design

Not Started ⏳

• A: Governance & Repo setup
• B: Documentation site
• C: Licensing
• E: CrewAI Orchestrator
• F: microDAO + Bot integration

---

🎯 Priority Order

Phase 1: Foundation (Current)

1. D.3 - Router config loader & provider registry
2. D.4 - DevTools Agent implementation
3. D.6 - Basic testing

Phase 2: Orchestration

4. E - CrewAI integration
5. F.1-F.2 - Gateway Bot service

Phase 3: Governance

6. A.1-A.3 - Monorepo setup
7. B - Documentation
8. C - Licensing

Phase 4: Production

9. F.3-F.4 - RBAC + E2E tests
10. A.4-A.5 - Project management + Audit

---

📚 References

• Current Setup: /opt/dagi-router/
• Config: /opt/dagi-router/router-config.yml
• Env: /opt/dagi-router/.env
• Docs: /opt/dagi-router/NEXT-STEPS.md
• Tests: /opt/dagi-router/test-devtools.sh