Předat práci s otevřenou otázkou a nechat ji dál blokovat

setup: finish-blocker-open
given:
  - 'an active task with one unresolved question open against it'
steps:
  - id: hand-over
    run: ['handover', '--close']
    stdin: handover-body.md
    note: 'the record the next session resumes from; --close marks the task handed over so a new one may start'
    expect:
      exit: 0
      stdout_contains: ['\.ai/local/state/handovers/']
  - id: follow-up
    run: ['start', 'the follow-up', '--scope', 'lib']
    note: 'the next task; the prior handover for this worktree and branch is named on the way in'
    expect:
      exit: 0
      stdout_contains: ['^INFO handover', 'same_worktree_same_branch', 'next: majordomus context']
  - id: still-blocked
    run: ['check']
    note: 'the question opened under the previous task still blocks this branch'
    expect:
      exit: 10
      stdout_contains: ['^FAIL blockers', 'unresolved question', 'tabs']
  - id: still-listed
    run: ['question', 'list']
    note: 'the entry, numbered, with the task it was opened under'
    expect:
      exit: 0
      stdout_contains: ['^1  \[unresolved\]', 'tabs']
  - id: refused
    run: ['finish', '--outcome', 'completed', '--verify-command', 'test -d .ai']
    note: 'completion of the follow-up is refused by the same entry'
    expect:
      exit: 10
      stdout_contains: ['^FAIL blockers']
then:
  - 'the handover carries the branch and head it was written at'
  - 'a question is a fact of the branch, not of the task that happened to open it'
  - 'nothing was resolved by handing over; the next worker sees the same blocker'

Scénář

Provedeno proti skutečnému nástroji v repozitáři připraveném pomocí finish-blocker-open, při každém generování tohoto webu. To, co následuje, není popis toho, co by se mělo stát; je to to, co se stalo.

Co nástroj udělal

Důkaz běhu, z něhož byla tato stránka vygenerována: pass, 5 kroků. Výstup je normalizován: cesta repozitáře, časová razítka, id a doby trvání jsou zástupné hodnoty; nic dalšího se neupravuje.

Testováno v test/cases/94_use_cases.sh, který spouští každý scénář a odmítne krok, jehož zaznamenaný výstup není tím, co vyprodukoval.

1. 1$ majordomus handover --close exit 0< handover-body.md

   záznam, ze kterého další relace pokračuje; --close označí úlohu jako předanou, aby mohla začít nová

   .ai/local/state/handovers/<time>--main--<head>--<hash>.md

   • exit 0
   • stdout_contains /\.ai/local/state/handovers//
2. 2$ majordomus start 'the follow-up' --scope lib exit 0

   další úloha; předchozí předávka pro tento worktree a větev je jmenována cestou dovnitř

   started t-<id>  profile=implementation  scope=lib
   INFO handover    .ai/local/state/handovers/<time>--main--<head>--<hash>.md — prior record, same_worktree_same_branch, exact, <age> ago  [reproduce: majordomus handover --resolve]
   next: majordomus context; checkpoint every 15m; majordomus check before claiming anything

   • exit 0
   • stdout_contains /^INFO handover/
   • stdout_contains /same_worktree_same_branch/
   • stdout_contains /next: majordomus context/
3. 3$ majordomus check exit 10

   otázka otevřená pod předchozí úlohou stále blokuje tuto větev

   OK   knowledge   records — 0 record(s) valid against knowledge/v1; every reference resolves  [reproduce: majordomus knowledge check]
   ·    checkpoint  t-<id> — <timed against the checkpoint interval>
   OK   records     ledger.jsonl — every line is a well-formed event
   FAIL blockers    t-<id> — 1 unresolved question(s) on this branch; first: t-<id> — does the parser need to accept tabs?  [reproduce: majordomus question list]
   OK   records     decisions.md — every entry is attributable
   OK   scope       t-<id> — 1 touched file(s), all within scope
   OK   state       t-<id> — exact (head <head>)
   INFO mesh        t-<id> — the repository declares no enabled mesh
   INFO use-case    30 advisory gap(s) — not covered by an active use case, and the policy does not require it: command:init command:update command:doctor command:watch command:start command:context command:checkpoint command:handover command:check command:finish command:history command:decision command:question command:prompt command:evidence command:skills command:capture command:search command:doctrine command:plan command:version command:session command:knowledge command:adr command:usecase command:rules command:migrate command:recover command:bench command:archive  [reproduce: majordomus usecase coverage]
   OK   use-case    0 of 30 target(s) covered — every public command the policy requires is named and run by an active use case (policy use_cases.coverage)
   INFO obligation  t-<id> — the task declares no obligations
   INFO gate        t-<id> — this repository declares no CI model at .ai/repo/ci/gates.yaml; nothing can be planned
   check: 12 finding(s), 1 failing

   • exit 10
   • stdout_contains /^FAIL blockers/
   • stdout_contains /unresolved question/
   • stdout_contains /tabs/
4. 4$ majordomus question list exit 0

   záznam, očíslovaný, s úlohou, pod kterou byl otevřen

   1  [unresolved] t-<id> — does the parser need to accept tabs? (<date>)

   • exit 0
   • stdout_contains /^1 \[unresolved\]/
   • stdout_contains /tabs/
5. 5$ majordomus finish --outcome completed --verify-command 'test -d .ai' exit 10

   dokončení navazující úlohy odmítne tentýž záznam

   FAIL blockers    t-<id> — 1 unresolved question(s) on this branch; first: t-<id> — does the parser need to accept tabs?  [reproduce: majordomus question list]
   FAIL note        t-<id> — no --note file and no handover for this task  [reproduce: majordomus handover < note.md]
   INFO regression  t-<id> — profile implementation adds no requirement beyond the shared contract
   OK   scope       t-<id> — 1 touched file(s), all within scope
   OK   state       t-<id> — exact (head <head>)
   INFO continuity  t-<id> — applies to partial and blocked
   INFO mesh        t-<id> — the repository declares no enabled mesh
   INFO use-case    30 advisory gap(s) — not covered by an active use case, and the policy does not require it: command:init command:update command:doctor command:watch command:start command:context command:checkpoint command:handover command:check command:finish command:history command:decision command:question command:prompt command:evidence command:skills command:capture command:search command:doctrine command:plan command:version command:session command:knowledge command:adr command:usecase command:rules command:migrate command:recover command:bench command:archive  [reproduce: majordomus usecase coverage]
   OK   use-case    0 of 30 target(s) covered — every public command the policy requires is named and run by an active use case (policy use_cases.coverage)
   OK   verification t-<id> — test -d .ai — exit 0, <s>s, tree <tree>
   INFO obligation  t-<id> — the task declares no obligations
   INFO gate        t-<id> — this repository declares no CI model at .ai/repo/ci/gates.yaml; nothing can be planned
   INFO gate        t-<id> — not in verification.finish_requires
   finish: refused, 2 unmet
   blocking doctrines:
   - majordomus.blocker-resolution
   - majordomus.note-integrity

   • exit 10
   • stdout_contains /^FAIL blockers/

Proč to nástroj ví

Řetězec od této stránky ke kódu: případ užití jmenuje příkazy, pravidla a tvrzení; každé pravidlo se dispatchuje z registru a každé tvrzení jmenuje test, který ho dokazuje; scénář výše provedl příkazy. Nic v tomto řetězci není text o záměru.

• majordomus handoverZapíše append-only záznam pokračování a vyhledá nejrelevantnější předchozí.
• majordomus startZahájit jednu úlohu s rozsahem pod profilem a odmítnout, dokud je aktivní jiná.
• majordomus checkJe aktuální úloha stále konzistentní se svou politikou, rozsahem a tímto checkoutem?
• majordomus questionOtevřít otázku, která blokuje přijetí, vyřešit ji a vypsat, co zůstává otevřené.
• majordomus finishVyhodnotí kontrakt dokončení a odmítne výsledek, pokud je jakýkoli jeho řádek nesplněn.

Pravidla, díky nimž platí

• ✕blokující Integrita předávekResolver běží a hlásí buď záznam pro tento worktree a branch, nebo jeho čistou nepřítomnost; chybně utvořený záznam se nikdy tiše nepřeskočí a záznam popisující historii, kterou tento checkout už nemá, se ohlásí.
• ✕blokující Řešení blokátorůŽádnou úlohu nelze dokončit, dokud je nevyřešena jakákoli otázka na této větvi; stále ji lze ukončit jako blocked, partial, no_match nebo failed.
• ✕blokující Integrita úložiště otázekKaždá položka v open-questions.md se zpracuje, protože kontrolu, která nedokáže přečíst položku, lze obejít jejím překlepem.

Uplatněné záruky

• ○zaručeno handover zapisuje záznam jen pro připojování s vypočtenou front matter a povinnými sekcemi
• ○zaručeno finish vyhodnotí kontrakt dokončení řádek po řádku a odmítne, pokud některý řádek není splněn
• ○zaručeno Správný předchozí záznam se určí podle worktree a branche a nesouvisející se nikdy nenabídne
• ○zaručeno Nevyřešená otázka blokuje přijetí a položka, kterou kontrola neumí zpracovat, je selhání, a ne tiché propuštění
• ○zaručeno Blokující otázka blokuje dál, i když se práce předá nové úloze

Související případy užití

Vypočteno z toho, co sdílejí: tvrzení, pravidla, příkazy, kategorie, aplikace. Tento seznam nikdo neudržuje.

• Zablokovat přijetí kvůli otázce, na kterou nikdo neodpovědělOtevřete k úloze otázku, sledujte, jak finish odmítá dokončení, dokud je nevyřešená, vyřešte ji odpovědí a teprve pak úlohu dokončete.
• Přichytit agenta, který tvrdí, že je hotov, a neníJedna úloha od začátku do konce: worker vybočí z rozsahu, prohlásí, že je hotov, předá práci a je přijat teprve tehdy, když projde vlastní ověření repozitáře.
• Předat nedokončenou práci další relaciZastavte se uprostřed úlohy a zanechte dalšímu pracovníkovi něco, na co lze navázat a co není přepis.
• Rozhodnout, zda je dokončená práce skutečně dokončenáVyhodnoťte kontrakt řádek po řádku, místo abyste přijali větu, která tvrdí, že je práce hotová.
• Navažte ve správném worktree, nikdy proti cizí úlozeNajděte předávku, která patří tomuto worktree a větvi, a podívejte se, jak se záznam úlohy z jiného checkoutu ohlásí jako cizí, místo aby se tady vynucoval.