Alicorn (Pegas): спецификация, архитектура, roadmap

README.md

@@ -0,0 +1,60 @@
+# Alicorn Agent (Pegas)
+
+Автономный агент-исследователь для **локальных** LLM. Рабочее имя — **Pegas**.
+
+> Alicorn = агентский runtime, спроектированный для локальных моделей, а не адаптированный под них.
+
+## Ключевой принцип: «Модель предлагает — Runtime располагает»
+
+- **LLM (Ornith)** — только предлагает план в типизированном DSL. Не мутирует состояние, не вызывает инструменты напрямую.
+- **Runtime (Rust)** — детерминированно исполняет план. Дает **скорость** (без интерпретации) и **точность** (каждое исполнение байт-в-байт из журнала).
+
+## Почему это нужно
+
+Существующие фреймворки (LangChain, CrewAI, AutoGen, Hermes) предполагают LLM = облачный API (дешёвый контекст, 200+ t/s, редкие ошибки). Локальные модели — наоборот: слабый контекст, 20–150 t/s, частые ошибки. Агент «задыхается» через 5–10 шагов.
+
+Alicorn решает это через:
+1. **Детерминированный Rust-выполнитель** — без интерпретации, скорость и воспроизводимость.
+2. **Append-only журнал (SQLite WAL)** — источник правды и replay.
+3. **Anvil** — экономика доверия (права, репутация, бюджет, любопытство) через смарт-контракты.
+4. **World Model (V-JEPA 2)** — симуляция последствий до реального действия.
+5. **Pegas Memory** — единое хранилище (Postgres + pgvector + Apache AGE).
+
+## Архитектура (7 слоёв)
+
+| # | Слой | Технология | Роль |
+|---|------|-----------|------|
+| 1 | Pegas Memory | PostgreSQL + pgvector + Apache AGE | Текст, векторы, граф, метаданные |
+| 2 | KTL | MinerU, Segnatura, gresmcp, mammoth + VLM Qwen3-VL | PDF/EPUB/Web → структурированные знания |
+| 3 | MCP-серверы | Rust (mcport/V.E.L.O.C.I.T.Y.) | Knowledge, Anvil, Tool, World Model |
+| 4 | Anvil | Solidity + Foundry | Права, репутация, бюджет, любопытство |
+| 5 | Pegas Core | Rust (dsh Harness) | Planner, Executor, Researcher, Decision |
+| 6 | World Model | V-JEPA 2 / Agentic-JEPA (wm-mcp) | Симуляция последствий |
+| 7 | Observability | OTEL + ClickHouse + Grafana | Трассировка, стоимость, качество |
+
+**Допы:** append-only журнал (SQLite WAL) = source of truth + replay; Dragonfly/Redis = кэш сессий; NATS JetStream = event bus.
+
+## Детерминизм и replay
+
+- **Append-only журнал** (SQLite WAL + FULL sync) — source of truth.
+- Пишутся входы/выходы (llm.request/response, tool.call/result, anvil.check), не промежуточные рассуждения.
+- **Event Sourcing**: состояние = детерминированная свёртка журнала через reducer.
+- Replay — **байт-в-байт**, верификация в CI.
+- Exactly-once через Transactional Outbox + Idempotency Key + Saga.
+
+## Внутренние драйвы
+
+Не on-chain: любопытство, компетентность, автономность, связность.
+
+## Связь с другими проектами
+
+- **spark-mind / «Animus»** — локальный чат-бот (персона, память, дашборд). Предок Alicorn.
+- **Outline** (docs.qw4.ru) — вики, источник спецификации.
+
+## Стек
+
+Ornith 1.5 A3B, Spark-X2.5-4B, Nanbeige4.1-3B, Clef-Flash, bge-m3 (эмбеддинги), PostgreSQL, pgvector, Apache AGE, V-JEPA 2, Rust.
+
+## Статус
+
+Архитектурная спецификация зафиксирована. MVP-код — в разработке (см. ROADMAP.md).