I1511 — Dokumentační povrch odpovídá v checkoutu, který web nesestavil
Zařídit, aby /docs/ řeklo, co potřebuje, místo aby selhalo, takže vývojář vstupující do čerstvého worktree nenarazí na rozbitou dokumentaci jako první dojem z runtime.
HOTOVO vlna 0 · p2 · profil implementation · bezpečné souběžně
Součást development-runtime — The runtime has a development surface.
Cíl
Zařídit, aby /docs/ řeklo, co potřebuje, místo aby selhalo, takže vývojář vstupující do čerstvého worktree nenarazí na rozbitou dokumentaci jako první dojem z runtime.
Proč
F4 z tabulky selhání z auditu. /docs/ se servíruje z target/web/docs, což je výstup buildu, takže v každém checkoutu, kde se web nesestavil, povrch vrací 503. Každá další chyba, kterou tento server vyrobí, je vzorem toho, co má chyba říkat — tělo 404 jmenuje routu a odkazuje na /openapi.json — a tahle je výjimka. Záleží na ní víc, než naznačuje její velikost, protože čerstvý linkovaný worktree je přesně tam, kde nový worker začíná, a dokumentační povrch, který nefunguje, se nedá odlišit od dokumentačního povrchu, který neexistuje.
Aktuální stav
GET /docs/ vrací 503 s JSON tělem o 251 bajtech v checkoutu, jehož web nebyl sestaven. Nic na cestě dovnitř neříká, že rozhraní má krok sestavení.
Cílový stav
Povrch buď odpoví z něčeho, co má každý checkout, nebo vrátí chybu, která jmenuje jediný příkaz, který by ho přiměl odpovědět.
Rozsah
- apps/majordomus-cli/src/web
- docs/COCKPIT.md
- test/cases
Mimo rozsah
- Sestavení webu jako vedlejší efekt obsluhy. Čtecí plocha, která spouští build, je třída vedlejších efektů, jakou zakazuje vlastní pravidlo diagnostiky repozitáře.
Závislosti
Žádné. Tento úkol je kořenem grafu.
Kritéria přijetí
- Checkout, který web nesestavil, dostane odpověď nebo chybu pojmenovávající příkaz, který to napraví
- Nic nic nesestavuje jako vedlejší účinek GET
Validace
- bash test/run.sh
Požadované důkazy
- unbuilt_checkout_gets_a_useful_answer
Důkazy
| pokrývá | typ | command | výsledek | u commitu |
|---|---|---|---|---|
| unbuilt_checkout_gets_a_useful_answer | test | cargo test --locked --manifest-path apps/majordomus-cli/Cargo.toml --lib a_surface_whose_producer_has_not_run_says_what_to_run | test result: ok. 1 passed; 0 failed (run 2026-10-14 between 07:40Z and 07:58Z on master ce5959db59) | ce5959d |
Riziko
Low.
Časová osa
- zahájeno
- 2026-10-14T07:58:52Z
- ověřeno
- —
- dokončeno
- 2026-10-14T07:58:59Z
Tato tři pole, důkazy výše a stav závislostí jsou vše, z čeho se stav skládá. Neexistuje žádné pole stavu, které by s nimi mohlo být v rozporu.
Kanonický záznam: .ai/repo/project/issues/I1511.yaml. Načtěte jej zpět pomocí majordomus plan show I1511.