session close: STATUS/PRD/TODO/WALKTHROUGH

STATUS.md

@@ -0,0 +1,42 @@
+# OpenSpec Lab — Статус
+
+Обновлено: 2026-09-06 (сессия @session:default/20260906_...)
+
+## Текущее состояние
+Лаборатория spec-driven подхода (OpenSpec CLI 1.12.0) для задач настройки инфраструктуры Hermes/homelab. Цикл propose→apply→archive работает; 2 change заархивированы, 1 открыт. Tavily-прокси (web_extract) работает end-to-end. Локальный экстрактор написан, ждёт сетевых тестов.
+
+## Сделано
+- [x] OpenSpec CLI установлен (npm, 1.12.0), лаба инициализирована с --tools hermes (6 скиллов)
+- [x] config.yaml с инфраструктурным контекстом (systemd, docker, /opt/<svc>/, gitverse)
+- [x] change tavily-proxy-setup — ЗААРХИВИРОВАН (delta → specs/web-extract-tavily/spec.md)
+- [x] web_extract работает: Hermes → 8971 → SOCKS5-туннель → Tavily (HTTP 200, контент Example Domain)
+- [x] change local-extractor — ОТКРЫТ (4/4 артефакта, валиден): trafilatura 2.2.0 в venv, local-режим в tavily_extract_proxy.py
+- [x] git-репо + README + remote origin → gitverse.ru (токен в obsidian)
+
+## В работе / Следующие шаги
+- [ ] Сетевые тесты local-режима (tasks 2.2 example.com через --local, 2.3 через --local-socks) — требуют присутствия пользователя (внешние запросы блокируются)
+- [ ] После тестов: openspec archive local-extractor
+- [ ] Создать репозиторий на gitverse.ru и git push -u origin main (внешнее действие, ждёт подтверждения)
+
+## Как запустить / проверить
+```bash
+cd /opt/hermes/openspec-lab
+openspec validate local-extractor
+openspec status --change local-extractor
+# локальный экстрактор (тест)
+./venv/bin/python .hermes/scripts/tavily_extract_proxy.py --port 8972 --local   # путь: /opt/hermes/.hermes/hermes-agent/venv/bin/python
+curl -s -X POST http://127.0.0.1:8972/extract -d '{"urls":["https://example.com"]}' -H 'Content-Type: application/json'
+# рабочий прокси (systemd)
+systemctl status tavily-proxy   # порт 8971, forward через туннель
+```
+
+## Ключевые артефакты
+- /opt/hermes/openspec-lab/openspec/changes/local-extractor/ — открытый change (4 артефакта)
+- /opt/hermes/openspec-lab/openspec/specs/web-extract-tavily/spec.md — main spec после archive
+- /opt/hermes/.hermes/scripts/tavily_extract_proxy.py — прокси + local-режим
+- /etc/systemd/system/tavily-proxy.service — юнит (forward)
+- /opt/hermes/openspec-lab/.hermes/skills/openspec-*/ — Hermes-скиллы OpenSpec
+
+## Открытые вопросы
+- Делать ли push на gitverse (нужен репозиторий + подтверждение)
+- Переключать ли systemd на --local после успешных тестов (отказ от облачного Tavily) или оставить forward как основной