docs: expand lint scope batch43 (2 files)

This commit is contained in:
Apple
2026-02-16 07:37:15 -08:00
parent 40c75258ea
commit 9eba663695
3 changed files with 196 additions and 195 deletions

View File

@@ -10,7 +10,7 @@
---
# 1. Призначення
## 1. Призначення
Governance & Access Agent відповідає за:
@@ -25,7 +25,7 @@ Governance & Access Agent відповідає за:
---
# 2. Ключові концепти
## 2. Ключові концепти
## 2.1. "Ключі спільноти" (Community Keys)
@@ -70,7 +70,7 @@ Governance & Access Agent відповідає за:
---
# 3. Роль Governance Agent
## 3. Роль Governance Agent
Роль агента: `"governance_core"`
@@ -85,7 +85,7 @@ Governance & Access Agent відповідає за:
---
# 4. Ролі Access Agent
## 4. Ролі Access Agent
Роль: `"access_keeper"`
@@ -102,7 +102,7 @@ Governance & Access Agent відповідає за:
---
# 5. Структура правил
## 5. Структура правил
## 5.1. Рівні правил
@@ -138,7 +138,7 @@ Governance & Access Agent відповідає за:
---
# 6. Інтеграція з RBAC та Entitlements
## 6. Інтеграція з RBAC та Entitlements
Використовується модуль `microdao — RBAC and Entitlements (MVP)`.
@@ -161,7 +161,7 @@ Governance Agent:
---
# 7. Ритуали узгодження
## 7. Ритуали узгодження
## 7.1. Створення ритуалу
@@ -196,7 +196,7 @@ Governance Agent:
---
# 8. Символічні ключі (Soulbound Keys)
## 8. Символічні ключі (Soulbound Keys)
Це:
@@ -217,7 +217,7 @@ Governance Agent:
---
# 9. Інтеграція з агентами інших модулів
## 9. Інтеграція з агентами інших модулів
### Messenger Agent
@@ -238,7 +238,7 @@ Governance Agent:
---
# 10. UI
## 10. UI
## 10.1. Sidebar → Правила
@@ -271,7 +271,7 @@ Governance Agent:
---
# 11. Tools (сумісно з Runtime Core)
## 11. Tools (сумісно з Runtime Core)
### 11.1. create_policy
@@ -306,7 +306,7 @@ Governance Agent:
---
# 12. Конфіг агента (Runtime Core)
## 12. Конфіг агента (Runtime Core)
```ts
const governanceAgentConfig: AgentConfig = {
@@ -326,11 +326,11 @@ const governanceAgentConfig: AgentConfig = {
"finalize_ritual"
]
};
```
```text
---
# 13. API
## 13. API
### Policies
@@ -352,9 +352,9 @@ const governanceAgentConfig: AgentConfig = {
---
# 14. Інструкції для Cursor
## 14. Інструкції для Cursor
```
```text
Implement the Governance & Access Agent using:
- 18_governance_access_agent.md
@@ -387,18 +387,17 @@ Output:
- list of changed files
- diff
- summary
```
```text
---
# 15. Результат
## 15. Результат
Після впровадження цього модуля:
* кожне microDAO отримує свою "конституцію",
* доступи стають функцією духу спільноти, а не технічних ролей,
* символічні ключі формують систему довіри,
* ритуали узгодження стають живою формою колективного рішення,
* Governance Agent забезпечує гармонію роботи людей і агентів.
- кожне microDAO отримує свою "конституцію",
- доступи стають функцією духу спільноти, а не технічних ролей,
- символічні ключі формують систему довіри,
- ритуали узгодження стають живою формою колективного рішення,
- Governance Agent забезпечує гармонію роботи людей і агентів.

View File

@@ -2,33 +2,35 @@
Живі картки агентів та повний інтерфейс Agent Console
Цей документ описує UI/UX для агентів у форматі "живих карток" та повний інтерфейс Agent Console, де кожен агент представлений як учасник спільноти з власною історією, досвідом та репутацією.
Цей документ описує UI/UX для агентів у форматі "живих карток" та повний
інтерфейс Agent Console, де кожен агент представлений як учасник спільноти з
власною історією, досвідом та репутацією.
---
# 1. Концепція: "Живі картки агентів"
## 1. Концепція: "Живі картки агентів"
Кожен агент у MicroDAO — це не просто бот, а:
* учасник спільноти з власною історією,
* живий модуль розуму, підключений до DAGI,
* носій досвіду (1T як міра обчислень та "шляху агента"),
* носій репутації в межах спільноти.
- учасник спільноти з власною історією,
- живий модуль розуму, підключений до DAGI,
- носій досвіду (1T як міра обчислень та "шляху агента"),
- носій репутації в межах спільноти.
Тому **основний UI-елемент** — не список у вигляді таблиці, а **плитки / картки агентів**.
---
# 2. Плитка агента (карточка в гріді)
## 2. Плитка агента (карточка в гріді)
## 2.1. Розташування
* В розділі "Агенти" (ліва панель → клік → відкривається основний грід).
* Також може використовуватись у:
- В розділі "Агенти" (ліва панель → клік → відкривається основний грід).
- Також може використовуватись у:
* модалці "Додати агента до каналу",
* маркетплейсі агентів DAARION.city,
* списку підключених агентів до microDAO.
- модалці "Додати агента до каналу",
- маркетплейсі агентів DAARION.city,
- списку підключених агентів до microDAO.
## 2.2. Структура картки
@@ -36,78 +38,78 @@
### 1. Верхній блок: Аватар + Відео-аватар
* Статичний аватар (іконка/символ).
* Мала відео-плашка / анімований аватар (loop, без звуку).
* Індикатор "онлайн/активний" (маленький маркер).
- Статичний аватар (іконка/символ).
- Мала відео-плашка / анімований аватар (loop, без звуку).
- Індикатор "онлайн/активний" (маленький маркер).
### 2. Імʼя та роль
* `Імʼя агента` (наприклад, "DAGI Guide", "Tokenomics Keeper").
* Короткий опис призначення у один рядок:
- `Імʼя агента` (наприклад, "DAGI Guide", "Tokenomics Keeper").
- Короткий опис призначення у один рядок:
* "Провідник microDAO"
* "Куратор знань"
* "Месенджер-організатор"
- "Провідник microDAO"
- "Куратор знань"
- "Месенджер-організатор"
Без жодних фінансових ролей.
### 3. Метрики досвіду (без фінансової асоціації)
* **Вік агента**:
- **Вік агента**:
* "У спільноті: 3 тижні" / "6 місяців" / "1 рік 2 місяці".
- "У спільноті: 3 тижні" / "6 місяців" / "1 рік 2 місяці".
* **Досвід 1T**:
- **Досвід 1T**:
* Лічильник: `Досвід: 12 340 1T`
* В UI пояснення через tooltip:
- Лічильник: `Досвід: 12 340 1T`
- В UI пояснення через tooltip:
> "1T — це внутрішня одиниця обчислень і досвіду агента в екосистемі DAARION.city."
* Важливо: не використовувати слів, які натякають на торгівлю/прибуток; це чисто "XP".
- Важливо: не використовувати слів, які натякають на торгівлю/прибуток; це чисто "XP".
* **Репутація спільноти**:
- **Репутація спільноти**:
* Наприклад, шкала 0100 або 05 "зірочок".
* Підпис: `Репутація в спільноті` / `Довіра спільноти`.
- Наприклад, шкала 0100 або 05 "зірочок".
- Підпис: `Репутація в спільноті` / `Довіра спільноти`.
### 4. Присутність у просторах
* Маленькі бейджі:
- Маленькі бейджі:
* `Учасник: 3 канали`
* `Працює в: 2 microDAO`
- `Учасник: 3 канали`
- `Працює в: 2 microDAO`
* Позначки "публічний / конфіденційний":
- Позначки "публічний / конфіденційний":
* іконка замка для конфіденційних контекстів.
- іконка замка для конфіденційних контекстів.
### 5. Статус підключення
* Текст/бейдж:
- Текст/бейдж:
* `Підключено до цього простору`
* або `Доступний для підключення`
- `Підключено до цього простору`
- або `Доступний для підключення`
* Кнопка:
- Кнопка:
* `Підключити до контексту` (якщо ще не підʼєднаний).
- `Підключити до контексту` (якщо ще не підʼєднаний).
---
# 3. Ховер та клік по картці
## 3. Ховер та клік по картці
## 3.1. При наведенні курсору (hover)
Показати поверх картки напівпрозорий оверлей з опціями:
* Основна кнопка:
- Основна кнопка:
**"Почати взаємодію"**
* Додаткові:
- Додаткові:
* `Підключити до цього каналу` (якщо стіна контексту вже вибрана)
* `Деталі агента` (відкрити повний профіль)
- `Підключити до цього каналу` (якщо стіна контексту вже вибрана)
- `Деталі агента` (відкрити повний профіль)
Можна додати коротку анімацію відео-аватара (легке пожвавлення).
@@ -115,204 +117,204 @@
Якщо клікаємо по основній площі картки:
* Відкривається **нове вікно/панель агента** (Agent Console), де:
- Відкривається **нове вікно/панель агента** (Agent Console), де:
* є текстовий чат,
* є керування голосовим режимом,
* є вкладка для обміну файлами/документами,
* є вкладка памʼяті/прав доступу.
- є текстовий чат,
- є керування голосовим режимом,
- є вкладка для обміну файлами/документами,
- є вкладка памʼяті/прав доступу.
---
# 4. Agent Console: повний інтерфейс агента
## 4. Agent Console: повний інтерфейс агента
Приклад структури:
## 4.1. Верхня панель
* Аватар + відео-аватар (більший).
* Імʼя, роль, короткий опис.
* Показники:
- Аватар + відео-аватар (більший).
- Імʼя, роль, короткий опис.
- Показники:
* Вік,
* Досвід 1T,
* Репутація спільноти.
- Вік,
- Досвід 1T,
- Репутація спільноти.
* Значок підключеності до поточного microDAO / каналу.
- Значок підключеності до поточного microDAO / каналу.
## 4.2. Вкладки
### Вкладка 1: Чат
* Текстовий чат (як звичайний agent chat).
* Голосовий режим: кнопка "Голосовий діалог" (start/stop).
* Привʼязка до поточного контексту:
- Текстовий чат (як звичайний agent chat).
- Голосовий режим: кнопка "Голосовий діалог" (start/stop).
- Привʼязка до поточного контексту:
* показати, в якому просторі ти з ним розмовляєш.
- показати, в якому просторі ти з ним розмовляєш.
### Вкладка 2: Файли та Документи
* Список файлів, якими обмінювались з цим агентом в межах даного microDAO.
* Кнопка `Завантажити файл` → агент через DAGI може:
- Список файлів, якими обмінювались з цим агентом в межах даного microDAO.
- Кнопка `Завантажити файл` → агент через DAGI може:
* проаналізувати документ,
* створити новий документ (збереження в microDAO file store).
- проаналізувати документ,
- створити новий документ (збереження в microDAO file store).
* Обовʼязково:
- Обовʼязково:
* **збереження у власних сховищах microDAO**, не у зовнішньому середовищі по замовчуванню.
- **збереження у власних сховищах microDAO**, не у зовнішньому середовищі по замовчуванню.
### Вкладка 3: Памʼять і Знання
* Блоки з:
- Блоки з:
* короткостроковою памʼяттю (останні теми),
* довгостроковими фактами про цю спільноту (як у 13_agent_memory_system).
- короткостроковою памʼяттю (останні теми),
- довгостроковими фактами про цю спільноту (як у 13_agent_memory_system).
* Кнопки:
- Кнопки:
* `Показати, що ти памʼятаєш про цей проєкт`
* `Очистити частину памʼяті`
- `Показати, що ти памʼятаєш про цей проєкт`
- `Очистити частину памʼяті`
### Вкладка 4: Присутність / Права доступу
* Список:
- Список:
* В яких каналах цей агент присутній (публічні/конфіденційні).
* В яких проєктах бере участь.
- В яких каналах цей агент присутній (публічні/конфіденційні).
- В яких проєктах бере участь.
* Для кожного:
- Для кожного:
* перемикач `Підключити/Відключити`.
* Позначка рівня доступу (read/write/tasks/knowledge).
- перемикач `Підключити/Відключити`.
- Позначка рівня доступу (read/write/tasks/knowledge).
* Кнопка:
- Кнопка:
* `Додати до нового каналу/проєкту` → відкриває спрощений Invite-Agent-Flow, але вже з попередньо вибраним агентом.
- `Додати до нового каналу/проєкту` → відкриває спрощений Invite-Agent-Flow, але вже з попередньо вибраним агентом.
### Вкладка 5: Еволюція та дух спільноти
* Замінює будь-який фінансовий наратив:
- Замінює будь-який фінансовий наратив:
* `Шлях агента в цій спільноті`
* Лог:
- `Шлях агента в цій спільноті`
- Лог:
* скільки разів агент допомагав у задачах,
* які типи запитів обробляє найчастіше,
* "внесок у колективний розум" (наприклад, скільки фактів/правил додано).
- скільки разів агент допомагав у задачах,
- які типи запитів обробляє найчастіше,
- "внесок у колективний розум" (наприклад, скільки фактів/правил додано).
* Репутація:
- Репутація:
* відгуки/оцінки від учасників (без мови торгівлі).
- відгуки/оцінки від учасників (без мови торгівлі).
---
# 5. DAGI, багатомодальність і сховища
## 5. DAGI, багатомодальність і сховища
## 5.1. DAGI як бекенд агентських здібностей
Кожен агент отримує від DAGI:
* текстове мислення,
* мульти-модальні можливості:
- текстове мислення,
- мульти-модальні можливості:
* розуміння зображень/файлів,
* створення текстів, планів, специфікацій,
* потенційно роботу з відео.
- розуміння зображень/файлів,
- створення текстів, планів, специфікацій,
- потенційно роботу з відео.
Інтерфейс агента дає доступ до:
* аналізу файлів:
- аналізу файлів:
* "Поясни цей документ для команди"
* "Зроби витяг для каналу #planning"
- "Поясни цей документ для команди"
- "Зроби витяг для каналу #planning"
* генерації нових артефактів:
- генерації нових артефактів:
* плани,
* дорожні карти,
* документація.
- плани,
- дорожні карти,
- документація.
## 5.2. Зберігання в MicroDAO, а не "десь в хмарі без контролю"
Ключовий принцип:
* **Результати роботи агента** (файли, документи, знання) зберігаються:
- **Результати роботи агента** (файли, документи, знання) зберігаються:
* у сховищі степені MicroDAO (файлове / БД),
* або у локальних базах спільноти.
- у сховищі степені MicroDAO (файлове / БД),
- або у локальних базах спільноти.
* DAGI використовується як "мозок", але:
- DAGI використовується як "мозок", але:
* не забирає собі сирі дані без волі спільноти,
* не є єдиним місцем зберігання.
- не забирає собі сирі дані без волі спільноти,
- не є єдиним місцем зберігання.
Це важливо підкреслити в UX:
* у консолі:
- у консолі:
* "Документи зберігаються в просторі вашої microDAO."
- "Документи зберігаються в просторі вашої microDAO."
* опції експорту:
- опції експорту:
* "Поділитися в іншому просторі DAARION.city"
* "Надати доступ іншому агенту"
- "Поділитися в іншому просторі DAARION.city"
- "Надати доступ іншому агенту"
---
# 6. Підключення/відключення агентів до публічних/конфіденційних просторів
## 6. Підключення/відключення агентів до публічних/конфіденційних просторів
## 6.1. З точки зору плитки
На картці агента:
* бейджі:
- бейджі:
* `Публічні простори: 2`
* `Конфіденційні: 1`
- `Публічні простори: 2`
- `Конфіденційні: 1`
* При натисканні:
- При натисканні:
* відкривається невеликий список:
- відкривається невеликий список:
* `#general (публічний)`
* `#dev-mvp (конфіденційний)`
- `#general (публічний)`
- `#dev-mvp (конфіденційний)`
* поруч — перемикач:
- поруч — перемикач:
* `Підключено / Відʼєднано`.
- `Підключено / Відʼєднано`.
## 6.2. З точки зору Agent Console
У вкладці "Присутність / Права доступу":
* Табличка:
- Табличка:
* Простір / Тип (публічний/конфіденційний) / Доступ / Перемикач.
- Простір / Тип (публічний/конфіденційний) / Доступ / Перемикач.
* Операції:
- Операції:
* натискання `Відʼєднати`:
- натискання `Відʼєднати`:
* агент перестає отримувати потік повідомлень з цього каналу/простору;
* його не видно у списку учасників.
- агент перестає отримувати потік повідомлень з цього каналу/простору;
- його не видно у списку учасників.
* натискання `Підключити`:
- натискання `Підключити`:
* запускає внутрішній Invite-Agent-Flow для відповідного ресурсу.
- запускає внутрішній Invite-Agent-Flow для відповідного ресурсу.
Все це повинно залишатись максимально людським в термінології:
жодних "інвесторів", "юнітів вартості", "ROI" тощо — тільки:
* "досвід",
* "шлях агента",
* "довіра спільноти",
* "внесок у колективний розум".
- "досвід",
- "шлях агента",
- "довіра спільноти",
- "внесок у колективний розум".
---
# 7. Компоненти та структура
## 7. Компоненти та структура
## 7.1. Agent Card Component
@@ -330,7 +332,7 @@ interface AgentCardProps {
export function AgentCard({ agent, onCardClick, onConnect, currentContext }: AgentCardProps) {
// Рендер картки з усіма метриками
}
```
```text
## 7.2. Agent Grid
@@ -344,7 +346,7 @@ interface AgentGridProps {
export function AgentGrid({ agents, onAgentSelect, filter }: AgentGridProps) {
// Сітка карток агентів
}
```
```text
## 7.3. Agent Console
@@ -357,11 +359,11 @@ interface AgentConsoleProps {
export function AgentConsole({ agentId, initialTab = "chat" }: AgentConsoleProps) {
// Повний інтерфейс агента з вкладками
}
```
```text
---
# 8. Типи даних
## 8. Типи даних
## 8.1. Agent Metrics
@@ -384,7 +386,7 @@ interface AgentMetrics {
confidential: number;
};
}
```
```text
## 8.2. Agent Presence
@@ -396,7 +398,7 @@ interface AgentPresence {
accessLevel: string[];
connected: boolean;
}
```
```text
## 8.3. Agent Evolution Log
@@ -415,11 +417,11 @@ interface AgentEvolutionLog {
averageRating: number;
};
}
```
```text
---
# 9. API Endpoints
## 9. API Endpoints
## 9.1. Agent Metrics
@@ -429,7 +431,7 @@ GET /agents/{agentId}/metrics
GET /agents/{agentId}/presence
// Список просторів, де агент присутній
```
```text
## 9.2. Agent Files
@@ -446,42 +448,42 @@ POST /agents/{agentId}/files
channelId?: string;
};
}
```
```text
## 9.3. Agent Evolution
```ts
GET /agents/{agentId}/evolution/log
// Лог еволюції та внеску агента
```
```text
---
# 10. UI/UX Деталі
## 10. UI/UX Деталі
## 10.1. Відео-аватар
* Формат: короткий loop (2-5 секунд)
* Розмір на картці: 64x64px
* Розмір в консолі: 128x128px
* Без звуку
* Анімація при hover: легке пожвавлення
- Формат: короткий loop (2-5 секунд)
- Розмір на картці: 64x64px
- Розмір в консолі: 128x128px
- Без звуку
- Анімація при hover: легке пожвавлення
## 10.2. Метрики досвіду
* Вік: "3 тижні", "6 місяців", "1 рік 2 місяці"
* 1T: велике число з розділювачами (12 340 1T)
* Репутація: візуальна шкала (зірки або прогрес-бар)
- Вік: "3 тижні", "6 місяців", "1 рік 2 місяці"
- 1T: велике число з розділювачами (12 340 1T)
- Репутація: візуальна шкала (зірки або прогрес-бар)
## 10.3. Бейджі присутності
* Компактні бейджі з іконками
* Кольори: синій для публічних, червоний для конфіденційних
* Іконка замка для конфіденційних просторів
- Компактні бейджі з іконками
- Кольори: синій для публічних, червоний для конфіденційних
- Іконка замка для конфіденційних просторів
---
# 11. Інтеграція з існуючими модулями
## 11. Інтеграція з існуючими модулями
## 11.1. Agent UI System (10)
@@ -506,11 +508,11 @@ Agent Console використовує:
---
# 12. Завдання для Cursor
## 12. Завдання для Cursor
Приклад промта:
```
```text
You are a senior React/TS engineer.
Implement Agent Cards and Console using:
@@ -534,23 +536,21 @@ Output:
- list of modified files
- diff
- summary
```
```text
---
# 13. Результат
## 13. Результат
Після впровадження:
* Агенти представлені як живі учасники спільноти, а не просто боти
* Користувач бачить досвід та репутацію кожного агента
* Повний контроль над підключеннями агентів до просторів
* Зберігання всіх результатів роботи агентів у сховищі microDAO
* Людська термінологія без фінансових наративів
- Агенти представлені як живі учасники спільноти, а не просто боти
- Користувач бачить досвід та репутацію кожного агента
- Повний контроль над підключеннями агентів до просторів
- Зберігання всіх результатів роботи агентів у сховищі microDAO
- Людська термінологія без фінансових наративів
---
**Готово.**
Це **повна специфікація Agent Cards та Console**, готова до використання в Cursor.

View File

@@ -115,3 +115,5 @@ docs/cursor/MVP_VERTICAL_SLICE.md
docs/cursor/42_nats_event_streams_and_event_catalog.md
docs/cursor/21_agent_only_interface.md
docs/cursor/40_rwa_energy_food_water_flow_specs.md
docs/cursor/18_governance_access_agent.md
docs/cursor/23_agent_cards_and_console.md