docs: expand lint scope batch1 (13 files)

2026-02-16 02:40:49 -08:00
parent b722e28338
commit 08dcfea960
12 changed files with 35 additions and 27 deletions
--- a/docs/CONTRIBUTING_DOCS.md
+++ b/docs/CONTRIBUTING_DOCS.md
@@ -73,7 +73,7 @@ last_updated: 2024-11-14

 ## Структура документації

-```
+```text
 docs/
 ├── cursor/              # Детальні технічні специфікації
 ├── tokenomics/          # Токеноміка (канонічний: city-tokenomics.md)
@@ -92,7 +92,6 @@ docs/
 Завжди вказуй канонічні документи:

 > Використовуй `docs/tokenomics/city-tokenomics.md` як єдине актуальне джерело токеноміки.
-
 > Використовуй `docs/cursor/50_daarion_city_website_integration.md` для інтеграції з сайтом.

 ### При оновленні документації
@@ -137,5 +136,3 @@ docs/
 ---

 **Останнє оновлення:** 2024-11-14
-
-
--- a/docs/DB_HARDENING_QUICKSTART.md
+++ b/docs/DB_HARDENING_QUICKSTART.md
@@ -68,4 +68,3 @@ python3 scripts/sync-node2-dagi-agents.py
 - **SEED_RECOVERY.md** - аварійне відновлення
 - **INFRA_ASSETS_MINIO.md** - налаштування MinIO
 - **TASK_PHASE_DATABASE_HARDENING_AND_ASSETS_MIGRATION_v1.md** - повний таск
-
--- a/docs/DB_PERSISTENCE_SUMMARY.md
+++ b/docs/DB_PERSISTENCE_SUMMARY.md
@@ -67,4 +67,3 @@ crontab -l | grep db-health-check
 2. Додати алерти при виявленні проблем (наприклад, через email або Telegram)
 3. Налаштувати моніторинг розміру volume та попереджати при нестачі місця
 4. Розглянути використання managed PostgreSQL (наприклад, AWS RDS) для production
-
--- a/docs/DB_STABILITY_FIX.md
+++ b/docs/DB_STABILITY_FIX.md
@@ -112,4 +112,3 @@ bash scripts/monitor-db-stability.sh
 - ✅ PostgreSQL конфігурацію покращено
 - ✅ Автоматичне відновлення працює
 - ✅ Логи зберігаються в `/var/log/db-stability-monitor.log`
-
--- a/docs/DEPLOYMENT.md
+++ b/docs/DEPLOYMENT.md
@@ -383,6 +383,6 @@ server {

 ## 📞 Support

- Documentation: https://docs.daarion.city
- Issues: https://github.com/daarion/dagi-stack/issues
- Discord: https://discord.gg/daarion
+- Documentation: [docs.daarion.city](https://docs.daarion.city)
+- Issues: [github.com/daarion/dagi-stack/issues](https://github.com/daarion/dagi-stack/issues)
+- Discord: [discord.gg/daarion](https://discord.gg/daarion)
--- a/docs/DEPLOY_CHECKLIST_2024_11_30.md
+++ b/docs/DEPLOY_CHECKLIST_2024_11_30.md
@@ -157,16 +157,16 @@ pytest tests/test_infra_smoke.py -v --base-url http://localhost:7001

 ## 🌐 КРОК 5: Перевірка в браузері

-1. **Node Directory:** https://daarion.space/nodes
+1. **Node Directory:** [daarion.space/nodes](https://daarion.space/nodes)
   - Повинні відображатися NODE1 і NODE2
   - Без "Помилка завантаження нод"

-2. **Node Cabinet:** https://daarion.space/nodes/node-1-hetzner-gex44
+2. **Node Cabinet:** [daarion.space/nodes/node-1-hetzner-gex44](https://daarion.space/nodes/node-1-hetzner-gex44)
   - Метрики CPU/GPU/RAM/Disk
   - DAGI Router Card
   - Guardian/Steward агенти

-3. **Agents:** https://daarion.space/agents
+3. **Agents:** [daarion.space/agents](https://daarion.space/agents)
   - System Prompts для агентів

 ---
@@ -190,7 +190,6 @@ NODE_ENVIRONMENT=development \
 NODE_ROLES=development,gpu,ai_runtime,testing \
 ./scripts/node-bootstrap.sh
 ```
-
 ---

 ## ❌ Rollback (якщо щось пішло не так)
@@ -241,4 +240,3 @@ docker exec -it daarion-postgres psql -U daarion_user -d daarion -c "SELECT node
 # Якщо порожньо — запустити bootstrap
 ./scripts/node-bootstrap.sh
 ```
-
--- a/docs/DEPLOY_SMOKETEST_CHECKLIST.md
+++ b/docs/DEPLOY_SMOKETEST_CHECKLIST.md
@@ -416,9 +416,9 @@ docker stats --no-stream --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}"

 Записати всі знайдені проблеми:

-1. _____________________________
-2. _____________________________
-3. _____________________________
+1. [ ] _____________________________
+2. [ ] _____________________________
+3. [ ] _____________________________

 ---

@@ -440,4 +440,3 @@ docker stats --no-stream --format "table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}"
 **Виконано:** _______________ (дата/час)  
 **Виконавець:** _______________ (ім'я)  
 **Версія:** 1.0.0
-
--- a/docs/INDEX.md
+++ b/docs/INDEX.md
@@ -1,6 +1,6 @@
 # DAARION Documentation Index

-**Quick navigation for all documentation**
+## Quick navigation for all documentation

 ---

--- a/docs/NODE2_GUARDIAN_QUICKSTART.md
+++ b/docs/NODE2_GUARDIAN_QUICKSTART.md
@@ -104,7 +104,7 @@ launchctl list | grep node-guardian

 ## Крок 4: Перевірка роботи

-### Перевірити логи:
+### Перевірити логи

 ```bash
 # Якщо запущено через nohup
@@ -114,13 +114,13 @@ tail -f /tmp/node-guardian.log
 tail -f /tmp/node-guardian.log /tmp/node-guardian-error.log
 ```

-### Перевірити в БД (на сервері):
+### Перевірити в БД (на сервері)

 ```bash
 ssh root@144.76.224.179 "docker exec daarion-postgres psql -U postgres -d daarion -c \"SELECT node_id, swapper_healthy, swapper_models_total, router_healthy, last_heartbeat FROM node_cache WHERE node_id = 'node-2-macbook-m4max';\""
 ```

-### Перевірити в UI:
+### Перевірити в UI

 Відкрийте `https://daarion.space/nodes/node/node-2-macbook-m4max` та перевірте:
 - Swapper Service показує моделі ✅
@@ -175,4 +175,3 @@ ssh root@144.76.224.179 "docker exec daarion-postgres psql -U postgres -d daario
   ```bash
   ./scripts/setup-node2-agents.sh
   ```
-
--- a/docs/NODE_PROFILE_STANDARD_v1.md
+++ b/docs/NODE_PROFILE_STANDARD_v1.md
@@ -340,4 +340,3 @@ Returns aggregated dashboard data for the current node.
 ## Changelog

 - **v1.0.0** (2025-11-28): Initial standard based on NODE1/NODE2 audit
-
--- a/docs/README.md
+++ b/docs/README.md
@@ -36,8 +36,14 @@ DAGI Router, DevTools Agent, CrewAI Orchestrator.
 **Категорії:**
 - **00-07:** Фундамент (overview, product brief, architecture, API, UI/UX, coding standards, tasks, testing)
 - **08-13:** Агентська система (onboarding, evolutionary agent, UI, LLM, runtime core, memory)
- **14-24:** Модулі та інтерфейс (messenger, projects, follow-ups, co-memory, governance, notifications, integrations, agent-only interface, operator modes, domains/wallet/DAO, agent cards)
- **24-50:** Інфраструктура та сервіси (access keys, deployment, security, database, flows, scaling, cost optimization, governance policies, PDP, API Gateway, service mesh, agent isolation, tools, lifecycle, templates, RWA, AI governance, NATS, outbox, usage, LLM proxy, router, messaging, teams, wallet, website integration)
+- **14-24:** Модулі та інтерфейс
+  (messenger, projects, follow-ups, co-memory, governance, notifications, integrations,
+  agent-only interface, operator modes, domains/wallet/DAO, agent cards)
+- **24-50:** Інфраструктура та сервіси
+  (access keys, deployment, security, database, flows, scaling, cost optimization,
+  governance policies, PDP, API Gateway, service mesh, agent isolation, tools, lifecycle,
+  templates, RWA, AI governance, NATS, outbox, usage, LLM proxy, router, messaging, teams,
+  wallet, website integration)

 **Детальний опис:** `/cursor/README.md`

--- a/docs/standards/lint_scope.txt
+++ b/docs/standards/lint_scope.txt
@@ -1,4 +1,17 @@
 docs/SESSION_STARTER.md
+docs/README.md
+docs/INDEX.md
+docs/CONTRIBUTING_DOCS.md
+docs/NODE_PROFILE_STANDARD_v1.md
+docs/NODE2_GUARDIAN_QUICKSTART.md
+docs/DEPLOYMENT.md
+docs/DEPLOY_SMOKETEST_CHECKLIST.md
+docs/DEPLOY_CHECKLIST_2024_11_30.md
+docs/DB_HARDENING_QUICKSTART.md
+docs/DB_STABILITY_FIX.md
+docs/DB_PERSISTENCE_SUMMARY.md
+docs/NODA1-AGENT-VERIFICATION.md
+docs/RUNBOOK_NODE1_RECOVERY_SAFETY.md
 docs/consolidation/README.md
 docs/consolidation/SOURCES.md
 docs/runbooks/DOCS_SERVICES_AUTOMATION_RUNBOOK.md