# Pegas — автономный агент-исследователь на базе dsh

Упрощённый наследник **Alicorn**: один агент, одна-две локальные модели, DeepSeek Harness
как runtime, Pegas Memory как память и база знаний. Всё лишнее из Alicorn — вырезано.

## Ключевая идея

Alicorn проектировался под «модель предлагает — детерминированный Rust-runtime исполняет».
На железе a2000 (1× RTX A2000 12GB) это оказалось избыточно: Rust-выполнитель, Anvil
(смарт-контракты доверия) и World Model (V-JEPA 2) не дают выигрыша, но кратно умножают
сложность и число моделей.

**Pegas** — это то, что реально нужно: dsh уже умеет ReAct-цикл, инструменты, subagent,
goal-трекинг, todo, песочницу и approval. Осталось навесить **память** (Pegas Memory) и
**персону исследователя**. Никакого своего runtime.

## Архитектура (одна страница)

\`\`\`
┌─────────────────────────────────────────────────────────────┐
│  dsh (DeepSeek Harness) — runtime                           │
│  ReAct · инструменты · subagent · goal · todo · sandbox    │
│                                                             │
│  Модель:  Ollama lfm25-24b-a2b (reasoning, 128k)           │
│           + qwen3.5:4b (быстрые операции)                   │
│                                                             │
│  Инструменты (MCP + встроенные):                            │
│   ├─ Pegas Memory (mcp-pegas-memory) — память/база знаний  │
│   │    PG (истина) → Qdrant (вектора) + Memgraph (граф)    │
│   ├─ SearXNG — поиск в интернете                            │
│   ├─ Playwright — браузер (сложные страницы, проверка)     │
│   ├─ Gitea / Outline / Context7 — свои репозитории и доки  │
│   └─ bash / fs / read / write — файловая работа             │
└─────────────────────────────────────────────────────────────┘
\`\`\`

## Что вырезано из Alicorn (и почему)

| Компонент Alicorn | Решение для Pegas | Причина |
|---|---|---|
| Rust-выполнитель (DSL-план) | dsh как runtime | dsh уже детерминирован на уровне журнала, свой runtime не нужен |
| Anvil (смарт-контракты, репутация) | sandbox + approval dsh | локальному агенту не нужна переносимая on-chain репутация |
| World Model (V-JEPA 2) | ReAct + память | 12GB VRAM не тянут V-JEPA 2 параллельно с LLM |
| 4 роли (Planner/Executor/Researcher/Decision) | 1–2 модели | роли = 4 модели, конкурируют за GPU |
| Append-only журнал (свой) | журнал сессий dsh | dsh уже пишет журнал и replay |
| OTEL + ClickHouse + Grafana | отложено | наблюдемость можно добавить потом |

## Что осталось из Alicorn

- **Pegas Memory** — PostgreSQL (источник истины) + Qdrant (вектора, EmbeddingGemma 2, dim=768) + Memgraph (граф). Уже реализована в \`pegas-memory/\`.
- **Цикл исследования пробелов** — detect → plan → acquire → extract → verify → commit.
- **Типизированные атомы** (text/definition/logical_rule/code/table/fact) + tree-sitter код + логическая инференция.
- **Принцип «модель предлагает — runtime располагает»** — но runtime = dsh, не свой Rust.

## Связь с другими проектами

- \`pegas-memory/\` — подсистема памяти (MCP-сервер, 14 инструментов).
- \`alicorn-agent/\` — полная (архивная) спецификация, откуда выделен Pegas.
- \`spark-mind/\` — предок (чат-бот Animus).

## Статус

Архитектурно зафиксирован. Память реализована и подключена. Осталось оформить персону
и инструкции (AGENTS.md) + проверить рабочий цикл через dsh.

## Файлы

- [ARCHITECTURE.md](./ARCHITECTURE.md) — решения и сравнение с Alicorn.
- [ROADMAP.md](./ROADMAP.md) — план.
- [AGENTS.md](./AGENTS.md) — инструкции агента (грузится dsh-agent-instructions).
- [persona.md](./persona.md) — текст персоны исследователя.
- [dsh/](./dsh/) — слой конфигурации профиля dsh.