docs: expand lint scope batch44 (2 files)
This commit is contained in:
Apple
@@ -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 і адаптований для:
|
||||
|
||||
* автоматичної генерації типів,
|
||||
* швидкої розробки фронтенду,
|
||||
* мінімізації зайвих деталей.
|
||||
- автоматичної генерації типів,
|
||||
- швидкої розробки фронтенду,
|
||||
- мінімізації зайвих деталей.
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user