Dohledat ke změně kontextové dokumenty, kterých se týká

setup: installed
given:
  - 'a repository with Majordomus installed and projections generated, and one commit of work'
steps:
  - id: list
    run: ['context', 'list']
    note: 'every scoped document: id, path, scope, composition, providers, status'
    expect:
      exit: 0
      stdout_contains: ['ai.layer']
  - id: resolve
    run: ['context', 'resolve', 'lib']
    note: 'the documents that apply to a path, root to target, in effective order with provenance'
    expect:
      exit: 0
      stdout_contains: ['^01  ai.layer']
  - id: explain
    run: ['context', 'explain', 'lib']
    note: 'the same, with why each applies and why each candidate was left out'
    expect:
      exit: 0
      stdout_contains: ['ai.layer']
  - id: affected
    run: ['context', 'affected']
    note: 'which documents the working tree’s changes touch; nothing is changed here, so nothing is affected'
    expect:
      exit: 0
      tree_unchanged: true
  - id: sync
    run: ['context', 'check-sync']
    note: 'the tree validates, every projection matches its stamp, and nothing is affected'
    expect:
      exit: 0
      stdout_contains: ['in sync']
then:
  - 'resolution is deterministic: the same path gives the same ordered list'
  - 'a change under a scope names the document that governs it'
  - 'the projections are checked against the documents they were rendered from'

Scénář

Provedeno proti skutečnému nástroji v repozitáři připraveném pomocí installed, 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 context list exit 0

   každý dokument s rozsahem: id, cesta, rozsah, složení, poskytovatelé, stav

   ai.layer                     .ai/README.md                                subtree   final   *              active
   ai.repo                      .ai/repo/README.md                           subtree   extend  *              active
   ai.repo.adrs                 .ai/repo/adrs/README.md                      subtree   extend  *              active
   ai.repo.applications         .ai/repo/applications/README.md              subtree   extend  *              active
   ai.repo.deployments          .ai/repo/deployments/README.md               subtree   extend  *              active
   ai.repo.features             .ai/repo/features/README.md                  subtree   extend  *              active
   ai.repo.knowledge            .ai/repo/knowledge/README.md                 subtree   extend  *              active
   ai.repo.profiles             .ai/repo/profiles/README.md                  subtree   extend  *              active
   ai.repo.project              .ai/repo/project/README.md                   subtree   extend  *              active
   ai.repo.prompts              .ai/repo/prompts/README.md                   subtree   extend  *              active
   ai.repo.rules                .ai/repo/rules/README.md                     subtree   extend  *              active
   ai.repo.sessions             .ai/repo/sessions/README.md                  subtree   extend  *              active
   ai.repo.skills               .ai/repo/skills/README.md                    subtree   extend  *              active
   ai.repo.use-cases            .ai/repo/use-cases/README.md                 subtree   extend  *              active
   ai.repo.why                  .ai/repo/why/README.md                       subtree   extend  *              active
   ai.repo.workflows            .ai/repo/workflows/README.md                 subtree   extend  *              active
   ai.repo.knowledge.candidates .ai/repo/knowledge/candidates/README.md      subtree   extend  *              active
   ai.repo.knowledge.curated    .ai/repo/knowledge/curated/README.md         subtree   extend  *              active
   ai.repo.rules.project        .ai/repo/rules/project/README.md             subtree   extend  *              active

   • exit 0
   • stdout_contains /ai.layer/
2. 2$ majordomus context resolve lib exit 0

   dokumenty, které platí pro cestu, od kořene k cíli, v efektivním pořadí s původem

   # effective context for lib
   01  ai.layer                   .ai/README.md                              subtree   final   *

   • exit 0
   • stdout_contains /^01 ai.layer/
3. 3$ majordomus context explain lib exit 0

   totéž, s důvodem, proč se každý uplatňuje a proč byl každý kandidát vynechán

   # effective context for lib
   01  ai.layer                   .ai/README.md                              subtree   final   *
       applies: the tree root; the target is outside .ai/
   
   # left out
   (nothing: every candidate applies)
   
   # order
   depth (tree root first), then order, then path; never the order the filesystem lists files in
   fingerprint <sha><hash16>ef77ca97

   • exit 0
   • stdout_contains /ai.layer/
4. 4$ majordomus context affected exit 0

   kterých dokumentů se změny pracovního stromu dotýkají; nic se tu nemění, takže nic není dotčeno

   • exit 0
5. 5$ majordomus context check-sync exit 0

   strom projde validací, každá projekce odpovídá svému razítku a nic není dotčeno

   OK   context     .ai/ — 19 document(s) validate
   OK   context     AGENTS.md — projection for agents matches its stamp and the policy as it is
   OK   context     CLAUDE.md — projection for claude-code matches its stamp and the policy as it is
   OK   context     GEMINI.md — projection for gemini matches its stamp and the policy as it is
   context check-sync: in sync (19 document(s), 3 projection(s), 0 affected)

   • exit 0
   • stdout_contains /in sync/

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 contextCo potřebuje vědět další worker právě teď, v pořadí podle autority a v rámci rozpočtu.
• majordomus doctorKontroluje jen governance: je samotný Majordomus zdravý a je každé vynucování, které deklaruje, tady skutečně zapojeno?

Pravidla, díky nimž platí

• ✕blokující Integrita kontextuKaždý adresář AI vrstvy nese kontextový dokument, každý nese smlouvu, skládají se do jednoho deterministického řetězce pro každou cestu a strom, který se neověří, nevyřeší nic.
• ✕blokující Integrita AI vrstvyAI vrstva repozitáře je skutečná: manifest deklaruje formát, který tento spustitelný soubor čte, a každá sekce, kterou jmenuje, existuje, lokální část checkoutu je ignorovaná gitem a nic pod ní není sledováno a pod cestou .majordomus/ z doby před .ai nezůstala žádná projektová data.

Uplatněné záruky

• ○zaručeno Kontext, který se vztahuje na cestu, se skládá z dokumentů vrstvy s rozsahem, od kořene k cíli, v jednom deterministickém pořadí s původem, a strom, který neprojde validací, nevyřeší nic
• ○zaručeno Dopad sady změn na kontext v rozsahu se hlásí z gitu — dokumenty, rozsahy pod nimi, přesuny s jejich původem, sledované zdroje k prověření a zastaralé projekce — a nesouvisející změna nehlásí nic
• ○zaručeno AI vrstva repozitáře je jeden adresář, jehož manifest pojmenovává každou sekci, čitelný bez nástroje

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

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

• Řekněte jednou, k čemu vaše práce slouží, a nechte to říkat každý povrchZaznamenejte provozní způsob selhání jako jeden soubor a nechte na něj odpovídat příkazovou řádku, API, MCP i web, aniž by se kdekoli registroval.
• Odmítnout adresář vrstvy, který nic nedokumentujeAdresář přidaný do vrstvy bez kontextového dokumentu selže při validaci jménem, nic se proti stromu nevyřeší, dokud neřekne, k čemu je, a stejná hierarchie je čitelná přes MCP a API, aniž by se spouštěla kontrola.
• Určit jako data, co patří do AI kontextuPřečtěte si deklarovanou politiku rozsahu repozitáře, zjistěte, které cesty jsou v indexu a které mimo něj, a nechte ji uplatňovat doctor a index znalostí místo pevně zadaného seznamu.
• Přesunout repozitář z rozvržení před .ai do vrstvyPodívat se, co by migrace přesunula, přesunout to se zálohou a dokázat, že výsledek je vrstva, kterou nástroj čte.
• Čtěte jen kontext, který se vejde do rozpočtu, a vězte, co se zahodiloSestavte kontext, který worker potřebuje právě teď, v pořadí autority, oříznuté na rozpočet řádků, a podívejte se na každou zahozenou sekci jmenovanou s důvodem.

Okamžiky, na které to odpovídá

• → našel pravidlo pro adresář v README, které žádná relace nikdy nenačetla Lokální pravidlo je buď v vždy načítaném souboru, kde za něj platí každá relace, nebo vedle kódu, kde ho nic nesvazuje s upravovanou cestou.
• → našel kód, který odporoval rozhodnutí, jež si repozitář zapsal Rozhodnutí bylo zaznamenáno a implementace šla opačným směrem, protože nic nepropojuje rozhodnutí s cestami, kterým vládne.
• → našel totéž vysvětlené třikrát, pokaždé trochu jinak Každá ručně udržovaná kopie faktu se rozchází podle vlastního rozvrhu a čtenář nepozná, která kopie je aktuální.