Klíčové funkce
Více rozhraní.Jedna konzistentní realita.
Stejný stav repozitáře na každém povrchu: příkazová řádka, HTTP API, OpenAPI a Swagger UI, Cockpit, MCP a tato dokumentace. Povrch může fakt vykreslit jinak; nesmí o něm mít druhý názor.
“Vývojová sémantika žije v kanonickém runtime; povrch ji jen spotřebovává”
CLI
Životní cyklus úlohy, zaznamenaný
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
.ai/local/state/checkpoints/<time>--main--<head>--<hash>.md
REST API
Programový přístup
/api/v1/repository
Odpověď
{
"repository": RepositoryInfo,
"state": State,
"objects": integer (uint),
"kinds": map of integer (uint),
"diagnostics": array of Diagnostic,
"capabilities": Summary
}cURL
curl -s "http://127.0.0.1:8741/api/v1/repository"
OpenAPI / Swagger
Interaktivní dokumentace API
Majordomus API
OpenAPI 3.1.0201 operací; Swagger UI na /swagger.
GET/api/v1/repository
Stav repozitáře a indexu. Kořen repozitáře, sekce vrstvy, stav gitu, režim objevování, přítomné druhy, každá diagnostika a spočítaný registr schopností.
GET/api/v1/rules
Každé pravidlo proti důkazu, který pro něj existuje. Celý korpus pravidel spojený se stromem a účetní knihou: u každého pravidla jeho třída, režim vynucování, validátor a případy, které jmenuje, zda…
GET/api/v1/environment
Prostředí repozitáře. Jeden snapshot tohoto checkoutu: identita projektu, identita repozitáře, správa verzí, deklarované toolchainy, co vrstva drží, sečteno podle…
GET/api/v1/search
Hledání objektů. Vyhledávání podřetězce bez ohledu na velikost písmen v identitách, názvech, popisech a obsahu.
POST/api/v1/plan/transition
Posunout jeden úkol životním cyklem. Zaznamenat, že provádění úkolu začalo (`start`), že implementace je hotová a důkazy chybí (`verify`), nebo že je dokonče…
Server MCP
Nástroje pro agenty AI
Nástroje
- majordomus_repositoryStav repozitáře a indexu
- majordomus_rulesKaždé pravidlo proti důkazu, který pro něj existuje
- majordomus_environmentProstředí repozitáře
- majordomus_searchHledat objekty
- majordomus_plan_transitionPosunout jeden úkol životním cyklem
Zdroje
- majordomus://environmentProstředí repozitáře
- majordomus://planCelý odvozený plán
- majordomus://changelogChangelog
- majordomus://repositoryStav repozitáře a indexu
- majordomus://rulesKaždé pravidlo proti důkazu, který pro něj existuje
- majordomus://<kind>/<identity>každý objekt indexu
RepositoryReport
Kořen repozitáře, sekce vrstvy, stav gitu, režim zjišťování, přítomné druhy, každá diagnostika a spočítaný registr schopností.
- adr
- aplikace
- oblast
- publikum
- claim
- command
- kontext
- kritika
- nasazení
- derive-offload
- distribution-model
- dokument
- doména
- funkce
- mezera
- implementace
- intent
- issue
- knowledge
- mesh-declaration
- milestone
- okamžik
- policy
- profil
- prompt
- release-record
- pravidlo
- scope
- session
- dovednost
- taxonomie
- test
- use-case
- workspace
Dokumentace
Sestaveno z repozitáře
-
majordomus init -
majordomus update -
majordomus doctor
Cockpit
Vizuální přehled, servírovaný na /cockpit; zde zobrazený z generovaných dat
Přehled repozitáře
- Rules189
- Decisions158
- Skills8
- Tests581
Rozhodnutí na release
nejstarší první, z changelogu
Changes in 1.0.0-alpha.2
- Jedna deklaracekaždá schopnost jednou, ve spustitelném souboru
- Promítnutokaždý povrch čte stejný registr
- Objevenovrstva, ze sledovaných souborů
- Zkontrolováno189 pravidel, každé s odvozeným stavem důkazu
- Rozšiřitelnénová schopnost se z deklarace dostane do MCP, HTTP i OpenAPI