diff --git a/docs/cursor/03_api_core_snapshot.md b/docs/cursor/03_api_core_snapshot.md index d4698788..6a31809b 100644 --- a/docs/cursor/03_api_core_snapshot.md +++ b/docs/cursor/03_api_core_snapshot.md @@ -11,12 +11,12 @@ Надсилає магічний лінк користувачу на email. -**Body** +- **Body** ```json { "email": "user@example.com" } ``` -**Response** +- **Response** `204 No Content` --- @@ -25,12 +25,12 @@ Обмін коду з email-лінка на JWT. -**Body** +- **Body** ```json { "code": "XXXXXX" } ``` -**Response 200** +- **Response 200** ```json { "token": "jwt-string", @@ -50,12 +50,12 @@ Створює нову спільноту (micro-DAO). -**Body** +- **Body** ```json { "name": "My Team" } ``` -**Response 201** +- **Response 201** ```json { "id": "t_123", @@ -71,12 +71,12 @@ Оновлює налаштування спільноти. -**Body** +- **Body** ```json { "mode": "public" | "confidential" } ``` -**Response 200** +- **Response 200** ```json { "id": "t_123", @@ -91,7 +91,7 @@ Список моїх спільнот. -**Response** +- **Response** ```json { "items": [ @@ -109,7 +109,7 @@ Створює канал. -**Body** +- **Body** ```json { "team_id": "t_123", @@ -119,7 +119,7 @@ } ``` -**Response 201** +- **Response 201** ```json { "id": "c_123", @@ -136,11 +136,11 @@ Отримує повідомлення каналу (cursor pagination). -**Query params** -* `cursor` (optional) -* `limit` (1–200) +- **Query params** +- `cursor` (optional) +- `limit` (1–200) -**Response** +- **Response** ```json { "items": [ @@ -164,7 +164,7 @@ Надсилає повідомлення. -**Body** +- **Body** ```json { "kind": "text", @@ -172,7 +172,7 @@ } ``` -**Response 201** +- **Response 201** ```json { "id": "m_123", @@ -190,7 +190,7 @@ Створює follow-up із повідомлення. -**Body** +- **Body** ```json { "team_id": "t_123", @@ -200,7 +200,7 @@ } ``` -**Response 201** +- **Response 201** ```json { "id": "fu_1", @@ -214,12 +214,12 @@ Список follow-up. -**Query** -* `assignee` (optional) -* `status` (optional) -* `cursor` (optional) +- **Query** +- `assignee` (optional) +- `status` (optional) +- `cursor` (optional) -**Response** +- **Response** ```json { "items": [ @@ -241,7 +241,7 @@ Створює проєкт. -**Body** +- **Body** ```json { "team_id": "t_123", @@ -250,7 +250,7 @@ } ``` -**Response** +- **Response** ```json { "id": "p_1", @@ -265,7 +265,7 @@ Список проєктів. -**Response** +- **Response** ```json { "items": [ { "id": "p_1", "name": "Website Launch" } ] } ``` @@ -276,7 +276,7 @@ Створює задачу. -**Body** +- **Body** ```json { "title": "Design homepage", @@ -284,7 +284,7 @@ } ``` -**Response 201** +- **Response 201** ```json { "id": "task_1", @@ -299,10 +299,10 @@ Отримує задачі. -**Query** -* `status` (optional) +- **Query** +- `status` (optional) -**Response** +- **Response** ```json { "items": [ @@ -323,7 +323,7 @@ Список приватних агентів. -**Response** +- **Response** ```json { "items": [ @@ -343,7 +343,7 @@ Створює агента. -**Body** +- **Body** ```json { "owner_kind": "team", @@ -354,7 +354,7 @@ } ``` -**Response** +- **Response** ```json { "id": "ag_1", @@ -370,11 +370,11 @@ Глобальний пошук по команді. -**Query** -* `q` — текст -* `scope`: `messages | files | docs | tasks | people` +- **Query** +- `q` — текст +- `scope`: `messages | files | docs | tasks | people` -**Response** +- **Response** ```json { "results": [ @@ -391,13 +391,13 @@ ## 8. Errors (узагальнення) -* **400** — неправильні дані -* **401** — без авторизації -* **403** — заборонено (немає прав) -* **404** — не знайдено -* **409** — конфлікт -* **429** — rate limit -* **500** — помилка сервера +- **400** — неправильні дані +- **401** — без авторизації +- **403** — заборонено (немає прав) +- **404** — не знайдено +- **409** — конфлікт +- **429** — rate limit +- **500** — помилка сервера Cursor повинен обробляти помилки через toast + лог у консоль. @@ -409,6 +409,6 @@ Cursor повинен обробляти помилки через toast + ло Він узятий з офіційної специфікації MicroDAO і адаптований для: -* автоматичної генерації типів, -* швидкої розробки фронтенду, -* мінімізації зайвих деталей. +- автоматичної генерації типів, +- швидкої розробки фронтенду, +- мінімізації зайвих деталей. diff --git a/docs/cursor/09_evolutionary_agent.md b/docs/cursor/09_evolutionary_agent.md index 8acca8fb..4e779e9c 100644 --- a/docs/cursor/09_evolutionary_agent.md +++ b/docs/cursor/09_evolutionary_agent.md @@ -13,7 +13,7 @@ --- -# 1. Мета +## 1. Мета Створити **особистого eволюційного агента** для кожної microDAO: @@ -28,7 +28,7 @@ --- -# 2. Архітектура (3 рівні мозку) +## 2. Архітектура (3 рівні мозку) Еволюційний агент складається з трьох шарів. @@ -62,7 +62,7 @@ --- -# 3. Компоненти Meta-Agent +## 3. Компоненти Meta-Agent ## 3.1. Feedback Collector @@ -132,13 +132,13 @@ Формує список пропозицій у вигляді: -``` +```text • Пропозиція №17 Тип: Нове правило Текст: "Якщо user → українська, відповідай українською." Джерело: 13 подібних ситуацій. [Прийняти] [Відхилити] [Редагувати] -``` +```text Це ключова відмінність MicroDAO від централізованих систем: @@ -166,7 +166,7 @@ UI показує «дерево еволюції». --- -# 4. UI/UX модуля "Еволюція агента" +## 4. UI/UX модуля "Еволюція агента" ## 4.1. Вкладка 1 — Огляд @@ -212,13 +212,13 @@ UI показує «дерево еволюції». Список: -``` +```text • Пропозиція №23 Тип: FAQ Тема: «Як додати нового учасника?» Згенеровано: Meta-Agent → [Прийняти] [Відхилити] [Редагувати] -``` +```text --- @@ -228,7 +228,7 @@ UI показує «дерево еволюції». --- -# 5. Логіка самонавчання (алгоритм) +## 5. Логіка самонавчання (алгоритм) ## 5.1. Тригер self-review @@ -249,7 +249,7 @@ Self-review запускається коли: --- -# 6. API для еволюційного агента +## 6. API для еволюційного агента Додаємо нові ендпоїнти: @@ -279,7 +279,7 @@ Self-review запускається коли: --- -# 7. Як працює Train-to-Earn +## 7. Як працює Train-to-Earn Коли користувач вмикає цю опцію: @@ -292,16 +292,16 @@ Self-review запускається коли: Користувач бачить: -``` +```text Ми використали 3 нові патерни вашої спільноти. Винагорода: +17 1T -``` +```text --- -# 8. MVP того, що реально зробити зараз +## 8. MVP того, що реально зробити зараз -### MVP-версія: +### MVP-версія - збір фідбеків (👍/👎), - ручний запуск self-review, @@ -309,7 +309,7 @@ Self-review запускається коли: - вручну додане рев'ю у UI, - зберігання версій у JSON. -### Наступні етапи: +### Наступні етапи - кластеризація помилок, - автоматичні тест-кейси, @@ -318,9 +318,9 @@ Self-review запускається коли: --- -# 9. Завдання для Cursor (шаблон) +## 9. Завдання для Cursor (шаблон) -``` +```text You are a senior React/TS and backend engineer. Implement the Self-Improving Agent module using: @@ -342,11 +342,11 @@ Output: * list of files * diff * summary -``` +```text --- -# 10. Інтеграція з існуючим кодом +## 10. Інтеграція з існуючим кодом ## 10.1. Використання API клієнтів @@ -365,13 +365,13 @@ export async function getAgentSuggestions(agentId: string) { export async function acceptSuggestion(agentId: string, suggestionId: string) { return apiClient.post(`/agents/${agentId}/suggestions/${suggestionId}/accept`); } -``` +```text ## 10.2. Компоненти UI Створити нову структуру: -``` +```text src/features/agent-evolution/ AgentEvolutionTab.tsx SuggestionsList.tsx @@ -381,7 +381,7 @@ src/features/agent-evolution/ hooks/ useAgentEvolution.ts useSuggestions.ts -``` +```text ## 10.3. State Management @@ -392,11 +392,11 @@ const { data: suggestions } = useQuery({ queryKey: ['agent-suggestions', agentId], queryFn: () => getAgentSuggestions(agentId), }); -``` +```text --- -# 11. Типи даних +## 11. Типи даних ## 11.1. Suggestion @@ -414,7 +414,7 @@ interface Suggestion { status: 'pending' | 'accepted' | 'rejected' | 'edited'; createdAt: string; } -``` +```text ## 11.2. AgentVersion @@ -427,7 +427,7 @@ interface AgentVersion { memoryDiff: MemoryDiff; changes: Change[]; } -``` +```text ## 11.3. Feedback @@ -439,11 +439,11 @@ interface Feedback { content?: string; // для explicit correction createdAt: string; } -``` +```text --- -# 12. Тестування +## 12. Тестування ## 12.1. Unit Tests @@ -466,7 +466,7 @@ interface Feedback { --- -# 13. Безпека та приватність +## 13. Безпека та приватність ## 13.1. Контроль доступу @@ -491,7 +491,7 @@ interface Feedback { --- -# 14. Продуктивність +## 14. Продуктивність ## 14.1. Оптимізація self-review @@ -507,7 +507,7 @@ interface Feedback { --- -# 15. Майбутні покращення +## 15. Майбутні покращення ## 15.1. Розширений аналіз @@ -529,7 +529,7 @@ interface Feedback { --- -# 16. Результат +## 16. Результат Еволюційний агент стає серцем MicroDAO: він вчиться, адаптується, росте — і належить спільноті. @@ -547,4 +547,3 @@ interface Feedback { **Готово.** Це **повна специфікація еволюційного агента**, готова до використання в Cursor. - diff --git a/docs/standards/lint_scope.txt b/docs/standards/lint_scope.txt index 9b086e71..a54038f3 100644 --- a/docs/standards/lint_scope.txt +++ b/docs/standards/lint_scope.txt @@ -117,3 +117,5 @@ 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 +docs/cursor/09_evolutionary_agent.md +docs/cursor/03_api_core_snapshot.md