vitrinka.docs
Produkt

Watch for

Schvalte ohraničený plán sledování, kontrolujte zdroje bez otevřené session a proměňte potvrzené nálezy v připravenou práci.

Sledování změny, ne připomínka

Watch for je úkol, který opakovaně hledá důkaz: vydání nové verze závislosti, sloučený pull request, nasazení nebo nový problém. Má schválený plán sledování a mezi kontrolami přetrvává bez běžící programovací session. Jeho typ je watch.

Todo použijte, když chcete připomínku k datu nebo podmínce. Watch for použijte pro opakované pozorování, důkazy a předem určenou reakci na nález. Sledování běžného úkolu vás jen přihlásí k jeho aktivitě; žádné zdroje nekontroluje.

Od záměru ke spuštěnému plánu

  1. Založte úkol typu Watch for a otevřete jeho sekci Watch for. Čekající draft v Příjmu musí být nejdřív přijat, jinak nic nesleduje.
  2. Popište What to watch for a zvolte Draft plan with Eve. Nebo přes Write plan napište plán bez AI.
  3. Zkontrolujte cíl, zdroje, důkazy potřebné k potvrzení, dobu sledování, nejkratší/nejdelší interval, denní rozpočty, vlastníka a navazující práci. Poznámky Evy vysvětlují předpoklady nebo zdroje, které workspace nenabídl.
  4. Zvolte Arm revision … pro přesnou revizi, kterou jste zkontrolovali. Uložení ani návrh plánu sledování nespouští.

Každá uložená úprava plánu vytvoří novou, neschválenou revizi a zastaví kontroly pod starým schválením. Plán znovu zkontrolujte a spusťte. Přizpůsobení času uvnitř schválených mezí novou revizi nevytváří.

  • Jednorázově (once) — skončí po uložení nálezu a přípravy navazující práce. Úkol Watch může být hotový, i když navržená implementace stále čeká v Příjmu nebo je navazující úkol blokovaný.
  • Průběžně (ongoing) — dál hledá odlišné nálezy. Nezměněné důkazy nevytvoří další nález ani po schválení pozdější revize.

Volitelný konec plánu zastaví další kontroly po daném čase; nedokazuje splnění cíle. Pro pokračování plán upravte.

Vyberte zdroje dostupné ve workspace

Plán může mít nejvýše osm zdrojů. Dostupnost se ověřuje při uložení a spuštění a přístup znovu při každé kontrole.

ZdrojCo čte a co potřebuje
Fakt Vitrinky (vitrinka)Pravdu o projektu v gramatice podmínek todo: pr <n> [merged|closed], release cut|next, deployed <env> [<sha>] nebo after <id>. Plán složený jen z faktů vyhodnocuje server bez Evy; musí platit všechny uvedené fakty. Volný text ani podmínky cesty/úkolu závislé na session sem nepatří.
GitHub (github)Vydání, tagy, issues nebo pull requesty z určeného owner/repo, případně filtrované slovy v názvu. Admin připojí GitHub App workspace s přístupem do repozitáře; stejné oprávnění instalace je potřeba i pro soukromé repozitáře.
Problémy Hlídače (signals)Otevřené skupiny problémů už uložené pro projekt směrovaný nakonfigurovaným zdrojem Hlídače, včetně vstupů ze Sentry a alertů. Čte se místní záznam Vitrinky, nejde o nový přímý konektor do Sentry.
Veřejná stránka nebo feed (page, feed)Text veřejné stránky nebo RSS/Atom feedu na schválené URL. Bez přihlášení, shellu či prohlížeče. Stahování má limity a odmítá cíle v privátní síti.
Slack (slack)Vybraný kanál, případně vlákno a hledaná slova. Admin v integracích workspace nastaví připojení Slacku jen pro čtení a výslovný seznam povolených kanálů; aplikace musí mít přístup i do dané konverzace. Plán nemůže prohledávat jiné kanály ani posílat zprávy.

Odebrání instalace GitHubu, odpojení Slacku nebo odebrání kanálu se projeví při dalších čteních. Opravte připojení nebo vyberte dostupný zdroj; uložený plán není trvalé oprávnění k přístupu.

Výsledek a stav sledování

Každá kontrola má jeden ze tří výsledků:

  • Potvrzeno (match) — čitelné důkazy podporují nový nález s citacemi zdrojů a časy pozorování.
  • Bez shody (no_match) — dostupné důkazy neukazují novou shodu; už zpracované nálezy nejsou nové.
  • Nelze ověřit (unable) — důkazy jsou nepřístupné, chybí, nejsou průkazné nebo kontrolu nešlo vyhodnotit. Nikdy to neznamená „vše v pořádku“. Plánované datum vydání není skutečné vydání; nečitelný zdroj nedokazuje, že se nic nezměnilo.

Sekce ukazuje poslední a příští kontrolu, dnešní i celkové kontroly/tokeny, nálezy a historii. Stav vysvětluje situaci a nabízí nápravu:

StavCo udělat
idleNapište a schvalte plán nebo obnovte záměrně pozastavené sledování. Zrušené sledování zůstane zastavené.
okKontroly mohou pokračovat, nebo jednorázové sledování našlo důkaz a připravilo navazující práci. Čtěte i vysvětlení, ne pouze značku stavu.
degradedJedna nebo dvě kontroly nedokázaly cíl ověřit. Přečtěte si diagnózu; další pokusy se automaticky vzdalují v mezích plánu.
failingTři nebo více kontrol cíl neověřily. Opravte uvedený problém zdroje, oprávnění či backendu a požádejte o kontrolu.
blockedPostupujte podle konkrétní nápravy: zapněte Evu, počkejte na denní rozpočet, upravte prošlý plán, znovu otevřete uzavřený úkol nebo nechte editora znovu schválit revizi, pokud původní schvalující opustil workspace.

Intervaly a rozpočty

Meze intervalu plánu musí být mezi 15 minutami a jedním týdnem. Eve smí navrhnout další interval jen uvnitř těchto mezí; uvnitř nich se prodlužují i neúspěšné pokusy. Zmeškané termíny se sloučí do jedné aktuální kontroly, ne do dávky historických volání.

  • Kontroly za den: 1–96 na sledování, podle dnů UTC. Slot spotřebují i ruční a neúspěšné kontroly.
  • Tokeny za den: volitelně od 40 000 do 2 000 000; 0 ponechá jako jediný rozpočet plánu počet kontrol. Je to pevný strop: kontrola začne jen tehdy, když se nejvyšší možná spotřeba jedné kontroly (40 000 tokenů) ještě vejde do zbytku denního rozpočtu.
  • Limit workspace: watch.checks.perDay je ve výchozím stavu 500 pro všechna sledování dohromady. Platné nastavení je 0–10 000; 0 odstraní tento společný limit, nikoli limity jednotlivých sledování.

Když kontrolu zastaví denní limit, diagnóza ho pojmenuje a další pokus se přesune na 00:05 UTC následujícího dne. Požadavek na kontrolu rozpočet neobejde. Zvýšení rozpočtu plánu je úprava, kterou je třeba znovu zkontrolovat a schválit.

Co nález připraví

Schválené navázání určuje, co se stane pro každý odlišný nález:

  • Navrhnout (propose) — do Příjmu přijde jeden draft s důkazy. O přijetí, odmítnutí či sloučení rozhodne triáž; sledování novou práci samo nepřijímá.
  • Připravit (ready) — připojí existující přijatý úkol a zaznamená, zda jeho vlastní předpoklady dovolují práci v okamžiku přípravy. Otevřené lidské i akční brány, závislosti a další překážky dál platí; nález je neoznačí za splněné. Seznam nálezů čte předpoklady navazujícího úkolu při každém zobrazení znovu, takže „připraveno“ vždy znamená připraveno teď.
  • Bez navázání (none) — uloží nález bez přípravy úkolu.

Vlastník dostane nejvýše jedno upozornění na nález; prázdný vlastník znamená řešitele úkolu, případně jeho zakladatele. Opakované pokusy znovu použijí nález a připravený draft místo vytváření duplicit.

Nález není schválení realizace. Žádné sledování nespustí programovací session, neupraví repozitář, neotevře pull request ani nic nenasadí. Připravená práce si zachovává běžné implementační a release brány.

Pozastavit, obnovit, zkontrolovat nebo zrušit

  • Pause pozastaví spuštěné sledování a zneplatní výsledky rozpracovaných kontrol.
  • Resume zachová schválení a dodrží nejkratší interval plánu od poslední kontroly. Pokud původní schvalující ztratil členství ve workspace, musí místo toho editor plán znovu schválit.
  • Check now požádá o kontrolu spuštěného sledování s odstupem nejméně 15 minut od poslední kontroly a se stejnými denními rozpočty. Jde o zařazení požadavku, ne příslib okamžitého výsledku.
  • Edit plan zastaví staré schválení; novou revizi uložte, zkontrolujte a spusťte.
  • Cancel watch sledování trvale zastaví. Založte nové, zrušené nelze obnovit. Dokončené jednorázové sledování naopak můžete upravit a znovu schválit pro nový cíl.

Enterprise a přepínače AI

PřepínačDopad na Watch for
AIR_GAPBlokuje pozorování veřejných stránek/feedů, GitHubu a Slacku. Místní fakty Vitrinky a už uložené problémy Hlídače zůstávají čitelné. Eve potřebuje dostupný backend uvnitř perimetru.
watchOutboundOff ve workspaceVypne tyto vnější zdroje sledování, ne místní pozorování. Samo nevypíná AI; tu řídí samostatné přepínače.
Automatizace watch-checkZapíná/vypíná automatické vyhodnocení Evou; výchozí stav je zapnuto. Neblokuje vyžádaný návrh plánu ani vyhodnocení samotných faktů.
Vypnutí AI ve workspace (aiOff)Blokuje návrhy a vyhodnocení Evou. Ručně psané plány a kontroly samotných faktů fungují dál. Jiné plány hlásí nelze ověřit, ne bez shody; čtení zdrojů může proběhnout před kontrolou přístupu k AI.

I místní pozorování Hlídače potřebují vyhodnocení Evou; nejsou to deterministické fakty. Vypnutí Evy sledování samo nezruší a nezabrání započtení zahájených kontrol do rozpočtu.

Nástroje agentů a terminál

Založení používá create {kind: "task", type: "watch", …}. MCP update_watch přijímá op: "intent" | "draft" | "plan" | "arm" | "pause" | "resume" | "cancel" | "check". plan obsahuje celý plán; arm musí uvést zkontrolovanou revision.

get_task {id, view: "watch"} vrací plán, stav, spotřebu a dovolené akce; view: "watch-history" čte kontroly a nálezy.

Terminál používá vitrinka task watch <id> [verb]: bez slovesa znamená show; další jsou history, intent, draft, plan, arm, pause, resume, cancel a check. Přepínače a JSON výstup popisuje nápověda.

vitrinka task watch 42 show
vitrinka task watch 42 draft --intent "Upozorni mě, až vyjde oprava v upstreamu"
# Než schválíte revizi, přečtěte si vrácený plán.
vitrinka task watch 42 arm --revision 1
vitrinka task watch 42 history

Na této stránce