docs: синхронизировать AGENTS.md и README с уже зашитыми фичами (дрейф документации) #89

New Issue

Ghost · 2026-06-21T02:33:13+03:00

Ghost commented

2026-06-21 02:33:13 +03:00

Найдено в multi-aspect code review всех изменений с коммита 053a9c0d (ветка develop).

Грань: documentation · Severity: warning

Несколько зашитых фич описаны в канонических доках по-старому или ведут на удалённые планы. AGENTS.md — справочник для агентов по security-чувствительным путям, поэтому устаревшие записи особенно вредны.

Чек-лист

AGENTS.md:243 — /mcp описан как «service account + опционально MCP_TOKEN»; на деле per-user HTTP Basic (валидация AuthService) или Bearer access JWT, MCP_DOCMOST_EMAIL/PASSWORD — опциональный fallback, общий guard MCP_TOKEN теперь в заголовке X-MCP-Token (не Authorization). Согласовать с .env.example.
AGENTS.md:266 — сказано «on push to main builds ghcr.io/...:develop», хотя .github/workflows/develop.yml триггерится на push в develop. Исправить на develop.
AGENTS.md:219 — новая fork-таблица page_template_references не отражена в списках fork-таблиц; is_template не nullable — отразить схему.
AGENTS.md:283 — «arbitrary HTML embed» всё ещё указан как in-progress дизайн-план, хотя фича зарелижена.
README.md:111 — ссылка «See docs/page-templates-plan.md» ведёт на удалённый этим набором файл (404). Убрать/перенаправить.
README.md:109 — Page templates всё ещё в разделе Planned, хотя MVP зашит. Перенести в реализованные.

Найдено в multi-aspect code review всех изменений с коммита `053a9c0d` (ветка develop). **Грань:** documentation · **Severity:** warning Несколько зашитых фич описаны в канонических доках по-старому или ведут на удалённые планы. AGENTS.md — справочник для агентов по security-чувствительным путям, поэтому устаревшие записи особенно вредны. **Чек-лист** - [ ] `AGENTS.md:243` — /mcp описан как «service account + опционально MCP_TOKEN»; на деле per-user HTTP Basic (валидация AuthService) или Bearer access JWT, MCP_DOCMOST_EMAIL/PASSWORD — опциональный fallback, общий guard MCP_TOKEN теперь в заголовке X-MCP-Token (не Authorization). Согласовать с .env.example. - [ ] `AGENTS.md:266` — сказано «on push to main builds ghcr.io/...:develop», хотя .github/workflows/develop.yml триггерится на push в `develop`. Исправить на develop. - [ ] `AGENTS.md:219` — новая fork-таблица page_template_references не отражена в списках fork-таблиц; is_template не nullable — отразить схему. - [ ] `AGENTS.md:283` — «arbitrary HTML embed» всё ещё указан как in-progress дизайн-план, хотя фича зарелижена. - [ ] `README.md:111` — ссылка «See docs/page-templates-plan.md» ведёт на удалённый этим набором файл (404). Убрать/перенаправить. - [ ] `README.md:109` — Page templates всё ещё в разделе Planned, хотя MVP зашит. Перенести в реализованные.

Ghost referenced this issue from a commit

2026-06-21 04:04:47 +03:00

docs: sync AGENTS.md + README with shipped features (#89)

Ghost referenced this issue

2026-06-21 04:19:31 +03:00

fix: review/red-team batch 2 — 30 issues (security, ws, page-templates, html-embed, mcp, tests, docs) #101

Ghost closed this issue

2026-06-21 14:10:33 +03:00

Sign in to join this conversation.