docs: expand lint scope batch53 (2 files)

docs/cursor/22_operator_modes_and_system_agents.md

@@ -8,7 +8,7 @@
 
 ---
 
-# 1. Основні типи системних агентів
+## 1. Основні типи системних агентів
 
 MicroDAO має три фундаментальні типи агентів:
 
@@ -21,7 +21,7 @@ MicroDAO має три фундаментальні типи агентів:
 
 ---
 
-# 2. Особистий агент (Personal Agent)
+## 2. Особистий агент (Personal Agent)
 
 ### 2.1. Призначення  
 Особистий агент — це "внутрішній супутник" людини в екосистемі microDAO:
@@ -58,25 +58,25 @@ operatorMode: {
   schedule: "*/20 * * * *", // кожні 20 хвилин (приклад)
   maxActionsPerHour: 10
 }
-```
+```text
 
 ---
 
-# 3. Спільний агент (Team/Shared Agent)
+## 3. Спільний агент (Team/Shared Agent)
 
 ### 3.1. Призначення
 
 Це агенти:
 
-* Team Assistant,
-* Messenger Agent,
-* Projects Agent,
-* Followups Agent,
-* Memory Agent,
-* Attention Agent,
-* Knowledge Guide,
-* Bridges Agent,
-* Governance Agent.
+- Team Assistant,
+- Messenger Agent,
+- Projects Agent,
+- Followups Agent,
+- Memory Agent,
+- Attention Agent,
+- Knowledge Guide,
+- Bridges Agent,
+- Governance Agent.
 
 Вони працюють на рівні microDAO (колективний простір).
 
@@ -84,11 +84,11 @@ operatorMode: {
 
 Спільні агенти можуть отримувати доступ до:
 
-* каналів,
-* проектів,
-* документів Knowledge Space,
-* ритуалів узгодження,
-* Co-Memory microDAO.
+- каналів,
+- проектів,
+- документів Knowledge Space,
+- ритуалів узгодження,
+- Co-Memory microDAO.
 
 Доступи обмежуються entitlements — кожен агент бачить лише те, що дозволено.
 
@@ -110,30 +110,29 @@ operatorMode: {
   schedule: "0 * * * *", // щогодини
   maxActionsPerHour: 30
 }
-```
+```text
 
 Операторські дії **завжди логуються** в Co-Memory.
 
 ---
 
-# 4. Protocol Agents: DAO Agent і Wallet Agent
+## 4. Protocol Agents: DAO Agent і Wallet Agent
 
 Ці агенти не є "учасниками" в комунікації, а швидше **протокольними модулями**.
 
 ---
 
-# 4.1. DAO Agent
+## 4.1. DAO Agent
 
 Роль: `"dao_protocol_agent"`
 
-### Призначення
-
+- **Призначення**
 DAO Agent відповідає за:
 
-* зв'язок із зовнішнім DAO-протоколом (якщо microDAO його має),
-* синхронізацію правил із контрактами,
-* оновлення локальних правил на основі зовнішніх церемоній,
-* відправку ритуалів узгодження в DAO-контракт (якщо дозволено).
+- зв'язок із зовнішнім DAO-протоколом (якщо microDAO його має),
+- синхронізацію правил із контрактами,
+- оновлення локальних правил на основі зовнішніх церемоній,
+- відправку ритуалів узгодження в DAO-контракт (якщо дозволено).
 
 ### Інтерфейс (tools)
 
@@ -144,7 +143,7 @@ tools: [
   "submit_ritual_to_dao",
   "resolve_dao_result"
 ]
-```
+```text
 
 ### Оператор-режим
 
@@ -152,31 +151,30 @@ DAO Agent завжди працює **строго у командному ма
 
 ---
 
-# 4.2. Wallet Agent
+## 4.2. Wallet Agent
 
 Роль: `"wallet_interface_agent"`
 
-### Призначення
-
+- **Призначення**
 Wallet Agent — це **інтерфейс** між microDAO/агентами та:
 
-* криптографічним підписом,
-* зовнішніми гаманцями користувачів,
-* фізичними ключами (Tangem-подібні),
-* системою capability-доступів.
+- криптографічним підписом,
+- зовнішніми гаманцями користувачів,
+- фізичними ключами (Tangem-подібні),
+- системою capability-доступів.
 
 Wallet Agent **не зберігає приватні ключі**.
 
 Він:
 
-* формує пояснення:
+- формує пояснення:
 
-  * "що саме підписується",
-  * "чому це потрібно",
-  * "які наслідки";
+  - "що саме підписується",
+  - "чому це потрібно",
+  - "які наслідки";
 
-* відправляє payload на зовнішній Signer;
-* отримує підписаний результат і повертає агенту, що ініціював дію.
+- відправляє payload на зовнішній Signer;
+- отримує підписаний результат і повертає агенту, що ініціював дію.
 
 ### Tools
 
@@ -187,11 +185,11 @@ tools: [
   "verify_signature",
   "get_wallet_state"
 ]
-```
+```text
 
 ---
 
-# 5. Модель operatorMode
+## 5. Модель operatorMode
 
 Операторський режим є **частиною конфігурації кожного агента**.
 
@@ -203,7 +201,7 @@ interface OperatorModeConfig {
   schedule?: string;         // CRON або natural language
   maxActionsPerHour?: number;
 }
-```
+```text
 
 У `AgentConfig`:
 
@@ -212,14 +210,14 @@ interface AgentConfig {
   ...
   operatorMode?: OperatorModeConfig;
 }
-```
+```text
 
 ### 5.1. Scopes
 
-* `"personal"` — особистий простір користувача;
-* `"team"` — командний рівень microDAO;
-* `"project"` — окремий проєкт;
-* `"channel"` — конкретний канал/чат.
+- `"personal"` — особистий простір користувача;
+- `"team"` — командний рівень microDAO;
+- `"project"` — окремий проєкт;
+- `"channel"` — конкретний канал/чат.
 
 ### 5.2. Режими
 
@@ -247,89 +245,89 @@ interface AgentConfig {
 
 ---
 
-# 6. Модель системних агентів у БД
+## 6. Модель системних агентів у БД
 
 ### Таблиця `system_agents`
 
-* id
-* team_id
-* type (`personal`, `team`, `protocol`)
-* role
-* operator_enabled
-* config_json (включає operatorMode)
-* created_at
+- id
+- team_id
+- type (`personal`, `team`, `protocol`)
+- role
+- operator_enabled
+- config_json (включає operatorMode)
+- created_at
 
 ### Таблиця `agent_permissions`
 
-* id
-* agent_id
-* resource_kind
-* resource_id
-* scopes (json array)
-* created_at
+- id
+- agent_id
+- resource_kind
+- resource_id
+- scopes (json array)
+- created_at
 
 ### Таблиця `operator_logs`
 
-* id
-* agent_id
-* action
-* payload_json
-* context
-* created_at
+- id
+- agent_id
+- action
+- payload_json
+- context
+- created_at
 
 ---
 
-# 7. Інтеграція з доступами та ключами (Governance Agent)
+## 7. Інтеграція з доступами та ключами (Governance Agent)
 
 OperatorMode завжди працює у звʼязці з:
 
-* entitlements,
-* symbolic keys,
-* governance_policies.
+- entitlements,
+- symbolic keys,
+- governance_policies.
 
 Наприклад:
 
-* Personal Agent має ключ рівня `personal-scope`.
-* Projects Agent має ключ `project-operator`.
-* DAO Agent має ключ `protocol-access`, який Governance Agent може видати або анулювати.
+- Personal Agent має ключ рівня `personal-scope`.
+- Projects Agent має ключ `project-operator`.
+- DAO Agent має ключ `protocol-access`, який Governance Agent може видати або анулювати.
 
 ---
 
-# 8. UI-інтеграція
+## 8. UI-інтеграція
 
 ### 8.1. Сторінка Агентів
 
 У профілі агента:
 
-* показати блок **"Режим оператора"**:
+- показати блок **"Режим оператора"**:
 
-  * увімкнено/вимкнено,
-  * дозволені дії,
-  * сфери дії,
-  * розклад.
+  - увімкнено/вимкнено,
+  - дозволені дії,
+  - сфери дії,
+  - розклад.
 
 ### 8.2. Налаштування microDAO
 
 Окремий розділ:
 
-* "Системні агенти"
+- "Системні агенти"
 
-  * Personal Agent (індивідуальний)
-  * Team Agents (список)
-  * Protocol Agents
+  - Personal Agent (індивідуальний)
+  - Team Agents (список)
+  - Protocol Agents
 
 ### 8.3. Журнал операторських дій
 
-* список автоматичних дій агентів,
-* фільтри: агент → проєкт → тип дії.
+- список автоматичних дій агентів,
+- фільтри: агент → проєкт → тип дії.
 
 ---
 
-# 9. Інструкції для Cursor
+## 9. Інструкції для Cursor
 
 Приклад:
 
-```
+```text
 Implement Operator Modes & System Agents using:
 
 - 22_operator_modes_and_system_agents.md
@@ -367,18 +365,17 @@ Output:
 - list of files
 - diff
 - summary
-```
+```text
 
 ---
 
-# 10. Результат
+## 10. Результат
 
 Після впровадження цього модуля:
 
-* приватні агенти можуть працювати як персональні оператори;
-* командні агенти можуть працювати як "ритуальні організатори" microDAO;
-* DAO Agent та Wallet Agent стають безпечними протокольними модулями;
-* усі дії мають чіткі межі, правила і логування;
-* система стає самокерованою, але контрольованою через дух спільноти.
-
+- приватні агенти можуть працювати як персональні оператори;
+- командні агенти можуть працювати як "ритуальні організатори" microDAO;
+- DAO Agent та Wallet Agent стають безпечними протокольними модулями;
+- усі дії мають чіткі межі, правила і логування;
+- система стає самокерованою, але контрольованою через дух спільноти.
 

docs/cursor/34_internal_services_architecture.md

@@ -1,6 +1,6 @@
 # 34 — Internal Services Architecture (MicroDAO)
 
-*Архітектура внутрішніх сервісів, їхні ролі, API, дані, залежності, взаємодія з PDP, Gateway, NATS, DB*
+Архітектура внутрішніх сервісів, їхні ролі, API, дані, залежності, взаємодія з PDP, Gateway, NATS, DB
 
 ---
 
@@ -24,7 +24,7 @@
 
 ## 2. High-Level Service Landscape
 
-```
+```text
                       ┌──────────────────────────┐
                       │    API Gateway (PEP)     │
                       └───────────────┬──────────┘
@@ -32,7 +32,7 @@
                    ┌──────────────────┴──────────────────┐
                    │                                     │
            Public API                            Internal Service Mesh
-```
+```text
 
 Внутрішні сервіси:
 
@@ -74,27 +74,25 @@
 
 ### 4.1 User & Team Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - Users, teams, memberships.
 - Roles: Owner, Guardian, Member, Visitor.
 - Viewer types: reader/commenter/contributor.
 - Team mode: public/confidential.
 
-#### Таблиці:
-
+- **Таблиці**
 - `users`
 - `teams`
 - `team_members`
 
-#### API (internal):
+#### API (internal)
 
 - `GET /internal/team/:id`
 - `POST /internal/team/create`
 - `POST /internal/team/member/add`
 - `POST /internal/team/member/remove`
 
-#### Події (NATS):
+#### Події (NATS)
 
 - `team.member.joined`
 - `team.member.left`
@@ -103,27 +101,23 @@
 
 ### 4.2 Messaging Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - Channels, messages, followups.
 - Co-memory embeddings.
 - Confidential mode enforcement (via Gateway).
 
-#### Таблиці:
-
+- **Таблиці**
 - `channels`
 - `messages`
 - `followups`
 - `comemory_items`
 
-#### API:
-
+- **API**
 - `POST /internal/message/send`
 - `GET /internal/channel/:id/messages`
 - `POST /internal/comemory/index`
 
-#### Події:
-
+- **Події**
 - `chat.message.created`
 - `comemory.item.created`
 
@@ -131,17 +125,14 @@
 
 ### 4.3 Projects & Tasks Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - Projects, tasks, workflow.
 
-#### Таблиці:
-
+- **Таблиці**
 - `projects`
 - `tasks`
 
-#### Події:
-
+- **Події**
 - `project.created`
 - `task.created`
 - `task.updated`
@@ -150,24 +141,20 @@
 
 ### 4.4 Agent Orchestrator
 
-#### Відповідальність:
-
+- **Відповідальність**
 - запуск приватних агентів;
 - трекінг `agent_runs`;
 - sandbox execution.
 
-#### Таблиці:
-
+- **Таблиці**
 - `agents`
 - `agent_runs`
 
-#### Події:
-
+- **Події**
 - `agent.run.started`
 - `agent.run.completed`
 
-#### API:
-
+- **API**
 - `POST /internal/agent/run`
 - `POST /internal/agent/finish`
 - `GET /internal/agent/run/:id/status`
@@ -176,18 +163,17 @@
 
 ### 4.5 LLM Proxy Service
 
-#### Завдання:
+#### Завдання
 
 - централізований доступ до LLM (OpenAI / local models).
 - облік токенів.
 - нормалізація моделей.
 
-#### API:
-
+- **API**
 - `POST /internal/llm/chat`
 - `POST /internal/llm/embeddings`
 
-#### Event:
+#### Event
 
 - `llm.tokens.used`
 
@@ -195,20 +181,17 @@
 
 ### 4.6 Router / Planner (DAARWIZZ)
 
-#### Відповідальність:
-
+- **Відповідальність**
 - run multi-agent routing pipeline;
 - orchestration of tools;
 - intent recognition;
 - complex "flows".
 
-#### API:
-
+- **API**
 - `POST /internal/router/route`
 - `POST /internal/router/plan`
 
-#### Events:
-
+- **Events**
 - `router.invoked`
 - `router.completed`
 
@@ -216,27 +199,23 @@
 
 ### 4.7 Wallet Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - стейк RINGK;
 - генерація payout'ів;
 - claim payout;
 - зв'язок з блокчейном.
 
-#### Таблиці:
-
+- **Таблиці**
 - `wallets`
 - `staking_ringk`
 - `payouts`
 
-#### API:
-
+- **API**
 - `POST /internal/wallet/stake`
 - `POST /internal/wallet/payout/claim`
 - `GET /internal/wallet/balance/:user`
 
-#### Events:
-
+- **Events**
 - `staking.locked`
 - `payout.generated`
 - `payout.claimed`
@@ -245,43 +224,36 @@
 
 ### 4.8 RWA Inventory Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - облік energy/food/water/etc.
 - інтеграція з Embassy.
 - оновлення RWA стоків.
 
-#### Таблиці:
-
+- **Таблиці**
 - `rwa_inventory`
 
-#### Events:
-
+- **Events**
 - `rwa.inventory.updated`
 
 ---
 
 ### 4.9 Embassy Gateway Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - прийом підписаних webhook'ів від платформ (EnergyUnion, GREENFOOD).
 - HMAC перевірка.
 - PDP авторизація (embassy keys).
 - генерація подій для NATS.
 
-#### Таблиці:
-
+- **Таблиці**
 - `embassy_identities`
 - `embassy_webhooks`
 
-#### API:
-
+- **API**
 - `POST /embassy/energy`
 - `POST /embassy/rwa`
 
-#### Events:
-
+- **Events**
 - `embassy.event.received`
 - `embassy.energy.update`
 - `embassy.rwa.claim`
@@ -290,53 +262,45 @@
 
 ### 4.10 Oracle Processor
 
-#### Відповідальність:
-
+- **Відповідальність**
 - обробка потоків енергетичних даних;
 - нормалізація;
 - створення `oracles`.
 
-#### Таблиці:
-
+- **Таблиці**
 - `oracles`
 
-#### Events:
-
+- **Events**
 - `oracle.reading.published`
 
 ---
 
 ### 4.11 Governance Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - пропозиції,
 - голосування,
 - застосування політик,
 - оновлення bundles/caps/quotas.
 
-#### Таблиці:
-
+- **Таблиці**
 - `governance_policies`
 
-#### Events:
-
+- **Events**
 - `governance.policy.updated`
 
 ---
 
 ### 4.12 Capability Registry Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - управління:
   - capabilities,
   - bundles,
   - bundle_caps,
   - plan entitlements.
 
-#### Таблиці:
-
+- **Таблиці**
 - `capabilities`
 - `bundles`
 - `bundle_caps`
@@ -347,8 +311,7 @@
 
 ### 4.13 Usage Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - підрахунок usage:
   - agent runs,
   - LLM tokens,
@@ -356,8 +319,7 @@
   - router invokes,
   - wallet transactions.
 
-#### Таблиці:
-
+- **Таблиці**
 (опціонально)
 
 - `usage_agent_runs`
@@ -371,13 +333,12 @@
 
 ### 4.14 Outbox Worker
 
-#### Відповідальність:
-
+- **Відповідальність**
 - читання `outbox_events` з БД;
 - публікація у NATS;
 - маркування `processed`.
 
-#### Таблиця:
+#### Таблиця
 
 - `outbox_events`
 
@@ -385,14 +346,12 @@
 
 ### 4.15 Telemetry / Logs Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - прийом логів з фронтенду,
 - прийом internal logs,
 - агрегація в аналітичні стріми.
 
-#### Events:
-
+- **Events**
 - `telemetry.client.event`
 - `telemetry.error`
 - `telemetry.screen_view`
@@ -401,22 +360,19 @@
 
 ### 4.16 Auth / Session Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - login,
 - OTP/Magic-link,
 - session cookies.
 
-#### Таблиці:
-
+- **Таблиці**
 - `sessions` (опціонально)
 
 ---
 
 ### 4.17 File Storage / Docs Service
 
-#### Відповідальність:
-
+- **Відповідальність**
 - завантаження файлів у каналах,
 - документи,
 - архіви,
@@ -432,24 +388,24 @@
 
 Умовний граф залежностей:
 
-```
+```text
 User/Team → Messaging → Projects/Tasks → Agents → Router
                     ↓            ↓        ↓
                  RWA       Wallet       Embassy
                     ↓           ↓         ↓
                   Oracle → Usage → Governance → PDP
-```
+```text
 
 Простіший вигляд:
 
-```
+```text
 API Gateway (PEP)
       ↓ PDP
       ↓
 Internal Services
       ↓
 DB + NATS
-```
+```text
 
 ---
 
@@ -471,7 +427,7 @@ DB + NATS
 
 ## 7. Horizontal Scaling Responsibilities
 
-### Stateless services:
+### Stateless services
 
 - Messaging
 - Projects/Tasks
@@ -480,7 +436,7 @@ DB + NATS
 - Router/Planner (частково)
 - LLM Proxy
 
-### Stateful services:
+### Stateful services
 
 - Wallet
 - RWA
@@ -653,7 +609,7 @@ Output:
 - list of modified files
 - diff
 - summary
-```
+```text
 
 ---
 
@@ -676,4 +632,3 @@ Output:
 **Версія:** 1.0  
 **Останнє оновлення:** 2024-11-14
 
-

docs/standards/lint_scope.txt

@@ -135,3 +135,5 @@ docs/cursor/15_projects_agent_module.md
 docs/cursor/12_agent_runtime_core.md
 docs/cursor/13_agent_memory_system.md
 docs/cursor/06_tasks_onboarding_mvp.md
+docs/cursor/22_operator_modes_and_system_agents.md
+docs/cursor/34_internal_services_architecture.md