|
|
e2cf883603
|
feat(scripts): interactive Lite-installer setup_lite.py (ORCH-104)
CI / test (push) Successful in 57s
CI / test (pull_request) Successful in 57s
Единый операторский CLI scripts/setup_lite.py — исполняемый инструмент
Lite-тиража поверх документа-канона docs/deployment/LITE_SETUP.md
(ORCH-102). Автоматизирует маршрут §2–§12: скан предусловий хоста с
офером доустановки → discovery docker-инсталляций Plane/Gitea →
интерактивный сбор обязательных ключей с немедленной верификацией →
автодетект хост-параметров и когерентность портов → сборка
.env/.env.watchdog от канонов → webhook Plane → guard-ы Gitea →
подъём ровно orchestrator+orchestrator-watchdog → регистрация проекта
строго кирпичом onboard_project.py → итоговый отчёт PASS/FAIL/MANUAL.
Scripts+docs+tests (паттерн ORCH-009/103): рантайм src/**, корневой
docker-compose.yml, Dockerfile, .env.example/.env.watchdog.example,
STAGE_TRANSITIONS/QG_CHECKS/check_*/machine-verdict/схема БД —
байт-в-байт. kill-switch не нужен (активация — только явный запуск
CLI человеком на целевом хосте; в нашем контуре артефакт инертен).
- D1/D2: stdlib-only, один файл; режимы plan/apply/verify (closed
choices), дефолт apply (бизнес-цель «одна команда»); безопасность
структурно — фаза 0 ≡ plan, ранний guard чужого .env, per-action
consent, non-TTY без --yes → exit 2 ДО мутаций. Exit 0/2/1; resume
= повторный запуск (check→ensure по реальности, без state-файла).
- D3: 10 нормативных шагов, инвариант APPLY_STEPS == build_plan().
- D4–D11: решающая логика — чистые функции (вердикты предусловий,
classifier discovery строго по image-префиксам, port_overrides
когерентной тройкой, staging==prod fail-closed, рендер env с
маркером managed-файла, C-1 ORCH-100 машинно, §6.4 branch
protection без удаления, webhook Plane Path A/Б, build_onboard_args).
- NFR-1/3: src.* не импортируется; секреты скрыты и не печатаются;
delete-операций нет; никаких операций с main; рестарт — только
собственного контура.
- D12: LITE_SETUP.md §1.1 + footer-норматив; tests/test_setup_lite_script.py
(47 unit/structural); аддитивный TC-27 в test_lite_setup_doc.py;
витрина docs/overview + docs/architecture/README дополнены;
CHANGELOG + CLAUDE.md (паспорт) обновлены.
Refs: ORCH-104
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
2026-06-12 03:04:35 +03:00 |
|
|
|
6d798c01ef
|
docs(overview): витрина системы docs/overview/ — бизнес+тех, 3 аудитории, презентация (ORCH-011)
Единая точка входа в документацию платформы (ADR-001 D1–D9):
- docs/overview/ — 10 файлов: индекс (маршруты «Я заказчик / Я менеджер /
Я разработчик» + норматив «изменил функциональность → обнови витрину в том же
PR»), business.md (без жаргона, 6 сценариев), 7 тех-блоков (link-first),
presentation.md (16 слайдов + процедура сборки «команда + Проверка:»).
- scripts/build_presentation.py — генератор .pptx в тёмном дизайне (python-pptx;
чистый stdlib-парсер parse_slides + ленивый import pptx; бинарь не коммитится,
build/ в .gitignore; зависимость НЕ в прод-образе — машинный гард TC-09).
- tests/test_system_docs.py — структурный анти-дрейф: derive-сверки стадий/
гейтов/агентов импортом STAGE_TRANSITIONS/QG_CHECKS/glob промптов/config,
валидность ссылок, FORBIDDEN-скан + секрет-эвристика, слайды каноническим
парсером, NFR-2, указатели.
- reviewer.md — ось обзорных доков ORCH-079 расширена на витрину (D7; канон 52d
байт-в-байт, только текст внутри секций) + анти-регресс ассерт в
test_agent_prompts_canon.py.
- Указатели: README.md, CLAUDE.md (правила №2/№6, «Структура»),
PRODUCT_VISION.md (врезка-ссылка), CHANGELOG.md.
Рантайм байт-в-байт: src/**, docker-compose.yml, Dockerfile, requirements* —
ноль изменений (docs+tests+dev-скрипт, паттерн ORCH-102/103). pytest: 1873 passed.
Refs: ORCH-011
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
2026-06-11 09:36:40 +03:00 |
|
