Přeskočit na obsah

Tato stránka byla automaticky přeložena z angličtiny, jediného jazyka, ve kterém se tento web píše. Číst originál.

majordomus ui: doručení pro člověka

Hlavní plocha sdíleného serveru odpovídá, jak si dodávka stojí — zdraví, releasy, plán rozvoje, práce a její pull requesty, mesh, důkazy a pravidla — a každá hodnota na ní uvádí schopnost, ze které byla načtena, a každou další plochu, která ji servíruje.

status
stav funkce: stabilní
doména
Povrchy
na domovské stránce
zvýrazněné

Co dělá

majordomus ui je povrch, na který je člověk poslán jako první. Cockpit vykresluje registr (každou schopnost, objekt, graf a trasu). UI vykresluje doručení: zda je proces zdravý, která verze byla vydána a kterou příští naznačují commity, kolik úkolů je připraveno nebo blokováno, které milníky jsou stále otevřené, které stroje jsou na meshi a jak živý je každý runtime a co by integrační dráha mergnula, opravila nebo na co by čekala.

Každá dlaždice a panel cituje svou schopnost, ukazatel, který přečetla, trasu, která servíruje stejnou odpověď, a jak dlouho to trvalo, a odkazuje na stránku té schopnosti v Cockpitu. Zdroj, který nedokáže odpovědět, hlásí „neodpovězeno“ a hodnotu, kterou nenese, hlásí „žádné“ nebo „neznámé“, nikdy nulu či „zdravé“. Zdroje obrazovky se dotazují najednou. Zdroj příliš pomalý pro první vykreslení, například fronta pull requestů, je panel s vlastní trasou, který jediný skript natáhne po vykreslení obrazovky a který je odkazem dostupný čtenáři bez něj.

Co nedělá

Není to druhá aplikace. Nemá datové úložiště, slovník stavů ani seznam routes nad rámec obrazovek, na které odpovídá její dispatcher. Neběží ani na vlastním serveru: servíruje ji tentýž sdílený server, který servíruje API, MCP a Cockpit, pod stejnou content-security policy. Nenahrazuje Cockpit, který zůstává technickou vrstvou (ADR 0135), a nic nezapisuje: akce na ní je schopnost s vlastní route.

Proč existuje

Provozní okamžiky z katalogu Why, které pojmenovávají některý z mechanismů této funkce. Nic zde nebylo přiděleno: okamžik se objeví, protože pojmenovává pravidlo, příkaz, schopnost nebo tvrzení, které pojmenovává i tato funkce.

Každý moment, na který odpovídá (35)

Princip

Moduly schopností spustitelného souboru, které tato funkce pojmenovává, každý se schopnostmi, které skládá. Rozhraní, jichž každý dosahuje, jsou uvedena níže v části Rozhraní: jde o projekce jedné deklarace, ne o samostatné registrace.

Repozitář repository ověřeno chováním

Repozitář, který tento proces obsluhuje: jeho vrstva, stav gitu, stav indexu z něj postaveného a jeho rozsah: co z něj pracovník čte a co nikdy nečte.

Zdraví health ověřeno chováním

Zda je to, co tento proces servíruje, v pořádku, rozhodnuté stroji, které o tom už rozhodují: diagnostika indexu, builder registru, pokrytí projekce měření výkonu, porovnání, které provádí `generate --check`, a čtení lease, z něhož odpovídá `server.status`. Žádná zdejší kontrola nemá vlastní názor.

Release release implementováno

Co tento projekt dodal a co dodá příště, odvozené, ne udržované: changelog skládá záznamy release vrstvy, rozhodnutí datovaná v okně každého release a konvenční commity v jeho rozsahu; zpráva o verzi čte jediné místo, kde se verze píše, a projekci, kterou vypisuje shellový nástroj, a říká, čím se podle veřejného kontraktu musí stát — nebo že to nelze změřit, a tedy nic nerozhoduje — a vedle toho jako důkaz uvádí, co naznačují commity od posledního release.

Distribuce distribution ověřeno chováním

Jak je tento projekt balen, publikován a instalován: platformy, pro něž release staví, názvy artefaktů, které odvozuje jediná pojmenovávací funkce, kanonický příkaz instalátoru, publikované release a čím je samotný tento build. Každá odpověď pochází ze share/distribution.yaml a ze záznamů release; žádný zdejší povrch netvrdí vlastní fakt.

Plán a jeho odvozeniny plan ověřeno chováním

Model milníků a úkolů tohoto repozitáře a vše, co se z něj odvozuje a co nikdo nenapsal: stav každého záznamu, grafy závislostí nad hranicí milníku i pod ní, topologické vlny provádění, pořadí podle plánu rozvoje, právě prováděný milník a jeden úkol, který vzít jako další. Stav se nikdy neukládá — záznam říká, co se s ním stalo, a stav z toho a ze stavu jeho závislostí vyplývá — takže žádný soubor nemůže odporovat grafu. Tato schopnost čte; zápis značky životního cyklu do záznamu je `plan.transition`, která deklaruje, že zapisuje do repozitáře.

Záměr intents ověřeno chováním

Co se musí stát pravdou nad milníky, které to realizují: výrok každého záměru, invarianty a kritéria splnění, jeho fáze odvozená ze stavu milníků plánu, stav každého kritéria odvozený z ledgeru důkazů a jeho verdikt odvozený z těchto kritérií samotných. Nic se neukládá a nic nepřechází; záměr přidaný pod model projektu je zodpovězen vším tímto bez registrace kdekoli.

Mesh mesh experimentální

Mesh tohoto procesu: objevování (discovery) — ověřená pozorování dalších běžících instancí Majordomus v jednom registru — a spolupráce (cooperation) — ověřená spojení s důvěryhodnými runtime téhož repozitáře, která replikují relace, tvrzení, předávky a revize jedním žurnálem, jejž každý runtime skládá do stejného stavu. Objevení nic neuděluje; spojení se připouští po jednotlivých peerech a nic, co peer pošle, tu nic nespustí.

Integrace pull requestů integration experimentální

Každý otevřený pull request klasifikovaný proti aktuálnímu master — připravený, vyžaduje obnovu, čeká na kontroly, revizi nebo závislost, koncept, vyžaduje opravu, v konfliktu, blokovaný, nebezpečný (zapnuté auto-merge), redundantní (jeho práce už je na master), nahrazený (deklarovaným nástupcem, který přistál, jmenovaným v superseded_by), možná redundantní, jiná báze nebo neznámý — každý s master a hlavou, proti nimž byl rozhodnut, jeho důvody, důkazy, rizikem a překryvy, deterministicky seřazený; a auditní stopa exekutoru, který slučuje další prokazatelně bezpečný, po jednom. Vztah k master rozhoduje git s vlastními merge drivery tohoto repozitáře, protože forge nedokáže spustit driver odvozených souborů. Čte se z posledního zaznamenaného pozorování forge; jedinou výjimkou je důkaz nanečisto, který forge pozoruje sám, protože pozorování je součástí toho, co dokazuje, že nic nepřesouvá.

Nasazení deploy ověřeno chováním

Nasazení (deployments), která tento repozitář deklaruje, čtená z kanonických objektů držených indexem, a zda by fungovala — posuzováno proti registru schopností, který tento proces postavil, a pracovnímu prostoru, v němž sedí. Každá operace je čtení: nasazení se mění důvěryhodným příkazovým řádkem a CI, nikdy přes HTTP a nikdy klientem MCP.

Dodávka delivery experimentální

Zda každá funkce produktu existuje, počítáno a nikdy nezaznamenáváno: na trunku, nasazená, veřejně ověřená, s aktuálními požadovanými testy, s publikovanými důkazy a odkazem z rozhraní — každé je verdikt pass, fail nebo unknown s důvodem a nápravou a unknown nikdy není pass. Funkce, které cokoli z toho chybí, není dodána a její vývojová fáze (implementovaná na větvi, na masteru, otestovaná, nasazená) je jiný typ než dodání.

Kontroly dokončení gates ověřeno chováním

Dokončení jako stav, o kterém rozhoduje repozitář, a ne tvrzení, které vyslovuje pracovník: validační kontroly, které tento repozitář deklaruje ve svém modelu CI, které z nich vybere vlastní sada změn úlohy, co každá naposledy ohlásila, zda tento verdikt stále popisuje strom, nad nímž vznikl, a tedy zda lze úlohu označit za dokončenou. Kontrola, která nikdy nic neohlásila, je `queued`, ne `pass`, běh, jehož soubory se od té doby změnily, je `stale` a odmítá přesně jako selhání, a kontrola, kterou změna nemůže ovlivnit, je `exempt`, ne neznámá.

Důkazy evidence ověřeno chováním

Co skutečně běželo, proti kterému commitu a zda to ještě něco dokazuje. Matice tvrzení váže tvrzení k testu cestou; ledger pod .ai/repo/evidence zaznamenává poslední provedení každého testu s commitem, stavem stromu, otiskem vlastního zdroje testu, časem, původem a příkazem, který jej spustí znovu. Spojení obou odpovídá, za každé tvrzení, zda je repozitář může poctivě nazvat prokázaným — a rozlišuje běh zaznamenaný proti tomuto samému commitu od takového, jehož vstupy se od té doby prostě nezměnily, protože splynutí těchto dvou je způsob, jak zelený odznak přestane něco znamenat.

Pravidla rules ověřeno chováním

Co tento repozitář odmítá a co dokáže pro každé odmítnutí skutečně ukázat. Pravidlo deklaruje třídu — blocking, kde kontrola práci odmítne, nebo advisory, kde se očekává, že si ho čtenář přečetl — a blok vynucování, který pojmenovává buď validátor, jejž volá dispatcher, nebo případy chování, které ho dokazují. Tento modul tuto deklaraci spojuje se stromem a s knihou zaznamenaných běhů a hlásí pro každé pravidlo, zda to, co pojmenovává, existuje, zda ho vlastní nějaký runner, zda byl někdy spuštěn, zda běh prošel a zda je běh starší než to, čeho se týká. Blokující pravidlo, jehož důkaz chybí, visí v prázdnu nebo selhává, je nález, protože pravidlo, které nikdo nedokáže prokázat, je pravidlo, které nikdo nevynucuje.

Schopnosti capabilities ověřeno chováním

Registr viděný sám přes sebe: každá schopnost s jejím druhem, stabilitou, původem, expozicemi, měřením výkonu a politikou cache a jedna schopnost celá.

Graf příkazů commands implementováno

Každý příkaz, který tento repozitář nabízí, z jakéhokoli programu, který jej nabízí: spustitelný soubor v Rustu, shellový nástroj nesoucí životní cyklus úlohy a workflow, která repozitář deklaruje, aby je člověk spouštěl. Složeno ze tří deklarací, které už existují — stromu clap, dodaného registru příkazů a vlastního výpisu runneru workflow — nikdy ze seznamu. Každý příkaz nese, co jeho spuštění mění, co potřebuje, odkud pocházejí hodnoty jeho argumentů a každý povrch, který jej nese, s důvodem, když nějaký nenese.

Provedení executions ověřeno chováním

Spuštění schopnosti tohoto registru jako práce, kterou lze sledovat: spuštěné, sledované událost po události přes živý kanál, zpětně přečtené a zastavitelné na požádání. Jedna rovina na checkout: `majordomus run` běží ve vlastním procesu a spuštění oznámí serveru, který checkout už obsluhuje, aby ho vedl vedle svých; bez serveru řekne, že běh nemůže nikdo jiný vidět. V paměti; spuštění nepřežije server, který ho drží.

Objekty objects ověřeno chováním

Deklarativní objekty vrstvy AI repozitáře: pravidla, prompty, profily, politika, dokumenty, milníky, úkoly, tvrzení a jakékoli druhy, které repozitář přidá; vypisují se, čtou podle URI a prohledávají.

Webové plochy web ověřeno chováním

Co tento repozitář vystavuje přes HTTP, určeno z producentů, kteří to vytvářejí, a ne z registru, který by někdo udržoval: trasy, na které odpovídá samotný spustitelný soubor, build dokumentace a každá vygenerovaná zpráva, která deklarovala vlastní mount. Stejné určení obsluhuje router, vykresluje domovskou stránku a skládá publikaci.

Kde se nachází

doména
Povrchy — Jedna deklarace v repozitáři se stane příkazovou řádkou, HTTP API, MCP, UI, Cockpitem, dokumentací i tímto webem a projekce, která se s ní rozchází, shodí build.
oblasti práce
observabilita
pojmenováno v
Observatory

Rozhraní

Každá schopnost za ní, na každém rozhraní, na které je promítnuta. Odkaz vede na referenci tohoto webu pro dané rozhraní; HTTP route a nástroj MCP odpovídá běžící majordomus serve, ne tento web.

Schopnosti za touto funkcí podle rozhraní
schopnostpříkazová řádkaHTTPnástroj MCP
repository.info —žádné GET /api/v1/repository majordomus_repository
repository.scope majordomus scope GET /api/v1/scope majordomus_scope
repository.scope_classify —žádné GET /api/v1/scope/classify majordomus_scope_classify
health.live —žádné GET /api/v1/live —žádné
health.ready —žádné GET /api/v1/ready —žádné
health.report —žádné GET /api/v1/health majordomus_health
release.analysis —žádné GET /api/v1/release/analysis majordomus_release_analysis
release.changelog —žádné GET /api/v1/changelog majordomus_changelog
release.next —žádné GET /api/v1/release/next majordomus_release_next
release.version —žádné GET /api/v1/release/version majordomus_release_version
distribution.artifact majordomus distribution artifact GET /api/v1/distribution/artifact majordomus_artifact
distribution.build majordomus distribution build GET /api/v1/distribution/build majordomus_build
distribution.model majordomus distribution show GET /api/v1/distribution majordomus_distribution
distribution.releases majordomus distribution releases GET /api/v1/distribution/releases majordomus_releases
distribution.status majordomus distribution status GET /api/v1/distribution/status majordomus_install_status
plan.delivery majordomus plan delivery GET /api/v1/plan/delivery majordomus_plan_delivery
plan.drift majordomus plan drift GET /api/v1/plan/drift majordomus_plan_drift
plan.flight —žádné GET /api/v1/plan/flight majordomus_plan_flight
plan.issues —žádné GET /api/v1/plan/issues majordomus_plan_issues
plan.model —žádné GET /api/v1/plan majordomus_plan
plan.next —žádné GET /api/v1/plan/next majordomus_plan_next
plan.record —žádné GET /api/v1/plan/record majordomus_plan_record
plan.roadmap —žádné GET /api/v1/plan/roadmap majordomus_plan_roadmap
plan.status —žádné GET /api/v1/plan/status majordomus_plan_status
plan.transition —žádné POST /api/v1/plan/transition majordomus_plan_transition
plan.validate —žádné GET /api/v1/plan/validate majordomus_plan_validate
plan.waves —žádné GET /api/v1/plan/waves majordomus_plan_waves
intents.binding majordomus intent binding GET /api/v1/intents/binding majordomus_intent_binding
intents.coverage majordomus intent coverage GET /api/v1/intents/coverage majordomus_intent_coverage
intents.list majordomus intent list GET /api/v1/intents majordomus_intents
intents.preflight majordomus intent preflight GET /api/v1/intents/preflight majordomus_intent_preflight
intents.propose majordomus intent propose POST /api/v1/intents/propose majordomus_intent_propose
intents.record majordomus intent show GET /api/v1/intents/record majordomus_intent_record
intents.validate majordomus intent validate GET /api/v1/intents/validate majordomus_intent_validate
mesh.claim —žádné POST /api/v1/mesh/claims majordomus_mesh_claim
mesh.cooperation —žádné GET /api/v1/mesh/cooperation majordomus_mesh_cooperation
mesh.doctor majordomus mesh doctor GET /api/v1/mesh/doctor majordomus_mesh_doctor
mesh.events —žádné GET /api/v1/mesh/events majordomus_mesh_events
mesh.firewall majordomus mesh firewall GET /api/v1/mesh/firewall majordomus_mesh_firewall
mesh.firewall.apply majordomus mesh firewall apply —žádné —žádné
mesh.handover.consume —žádné POST /api/v1/mesh/handovers/consume majordomus_mesh_handover_consume
mesh.handover.publish —žádné POST /api/v1/mesh/handovers majordomus_mesh_handover_publish
mesh.identity majordomus mesh identity GET /api/v1/mesh/identity majordomus_mesh_identity
mesh.link.hello —žádné POST /api/v1/mesh/link/hello —žádné
mesh.link.sync —žádné POST /api/v1/mesh/link/sync —žádné
mesh.nodes —žádné GET /api/v1/mesh/nodes majordomus_mesh_nodes
mesh.peer —žádné GET /api/v1/mesh/peer majordomus_mesh_peer
mesh.peers —žádné GET /api/v1/mesh/peers majordomus_mesh_peers
mesh.register —žádné POST /api/v1/mesh/register majordomus_mesh_register
mesh.release —žádné POST /api/v1/mesh/claims/release majordomus_mesh_release
mesh.review.answer —žádné POST /api/v1/mesh/reviews/answer majordomus_mesh_review_answer
mesh.review.request —žádné POST /api/v1/mesh/reviews majordomus_mesh_review_request
mesh.review.withdraw —žádné POST /api/v1/mesh/reviews/withdraw majordomus_mesh_review_withdraw
mesh.session.close —žádné POST /api/v1/mesh/sessions/close majordomus_mesh_session_close
mesh.session.open —žádné POST /api/v1/mesh/sessions majordomus_mesh_session_open
mesh.state —žádné GET /api/v1/mesh/state majordomus_mesh_state
mesh.status —žádné GET /api/v1/mesh majordomus_mesh
mesh.verify —žádné POST /api/v1/mesh/verify majordomus_mesh_verify
integration.cleanup —žádné GET /api/v1/pull-requests/cleanup majordomus_pull_requests_cleanup
integration.events majordomus prs events GET /api/v1/pull-requests/events majordomus_integration_events
integration.explain majordomus prs explain GET /api/v1/pull-requests/explain majordomus_pull_request_explain
integration.prove_dry_run majordomus prs prove-dry-run GET /api/v1/pull-requests/prove-dry-run majordomus_pull_requests_prove_dry_run
integration.queue majordomus prs status GET /api/v1/pull-requests majordomus_pull_requests
integration.timings —žádné GET /api/v1/pull-requests/timings majordomus_ci_timings
integration.trains majordomus prs trains GET /api/v1/pull-requests/trains majordomus_pull_request_trains
deploy.check —žádné GET /api/v1/deployments/check majordomus_deploy_check
deploy.get —žádné GET /api/v1/deployment majordomus_deployment
deploy.list —žádné GET /api/v1/deployments majordomus_deployments
deploy.observed —žádné GET /api/v1/deployments/observed majordomus_deployments_observed
delivery.feature majordomus delivery show GET /api/v1/delivery/feature majordomus_delivery_feature
delivery.report majordomus delivery report GET /api/v1/delivery majordomus_delivery
gates.completion —žádné GET /api/v1/gates/completion majordomus_completion
gates.model —žádné GET /api/v1/gates majordomus_gates
evidence.claim majordomus evidence claim GET /api/v1/evidence/claim majordomus_evidence_claim
evidence.record majordomus evidence record —žádné —žádné
evidence.report majordomus evidence show GET /api/v1/evidence majordomus_evidence
evidence.stamp majordomus evidence stamp —žádné —žádné
evidence.test majordomus evidence proves GET /api/v1/evidence/test majordomus_evidence_test
rules.proves majordomus rules proves GET /api/v1/rules/proves majordomus_rule_proves
rules.report majordomus rules report GET /api/v1/rules majordomus_rules
rules.show majordomus rules show GET /api/v1/rules/rule majordomus_rule
capabilities.describe majordomus capabilities describe GET /api/v1/capability majordomus_capability
capabilities.list majordomus capabilities list GET /api/v1/capabilities majordomus_capabilities
capabilities.projections majordomus capabilities projections GET /api/v1/capabilities/projections majordomus_projections
commands.get —žádné GET /api/v1/command majordomus_command
commands.graph —žádné GET /api/v1/commands/graph majordomus_command_graph
commands.list —žádné GET /api/v1/commands majordomus_commands
executions.cancel majordomus executions cancel POST /api/v1/executions/cancel majordomus_execution_cancel
executions.demonstrate —žádné GET /api/v1/executions/demonstrate majordomus_demonstrate_execution
executions.events majordomus executions events GET /api/v1/executions/events majordomus_execution_events
executions.get majordomus executions show GET /api/v1/executions/get majordomus_execution
executions.list majordomus executions list GET /api/v1/executions majordomus_executions
executions.protocol majordomus executions protocol GET /api/v1/executions/protocol majordomus_execution_protocol
executions.report —žádné POST /api/v1/executions/report —žádné
executions.start majordomus run POST /api/v1/executions/start majordomus_execution_start
objects.get —žádné GET /api/v1/object majordomus_get
objects.list —žádné GET /api/v1/objects majordomus_list
objects.search —žádné GET /api/v1/search majordomus_search
objects.verify —žádné GET /api/v1/objects/verify majordomus_verify_objects
web.surfaces —žádné GET /api/v1/web/surfaces majordomus_web_surfaces
poskytováno spustitelným souborem
/ui Doručení, pro člověka: majordomus ui

Důkazy

Co je zaručeno

Každé tvrzení, které tato funkce pojmenovává, se stavem, který deklaruje jeho řádek, verdiktem, který podporují zaznamenané běhy, a testem, který o něm rozhoduje.

Pravidla, která jej drží

  • blokující Rozhraní ukazuje jen to, co je odvozeno, a neznámé se nikdy nevykresluje jako zdravéproject.ui-derived-state
  • blokující Externí rozhraní jsou projekce jedné definice schopnostiproject.interfaces-are-projections
  • blokující Webový povrch se deklaruje jednou a z něj se odvozují všechny webové projekceproject.web-surface-declared-once

Rozhodnutí za ním

Použití

Z příkazové řádky spustitelného souboru

Synopse každého, jak ji vypisuje nápověda samotného spustitelného souboru.

Odkud tato stránka pochází

soubor
.ai/repo/features/ui.md
stejná odpověď
majordomus product show ui

Prohledává názvy a popisy všech stránek, které tento web publikuje.