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.

HTTP API: editors

Soubory, které z tohoto repozitáře čtou Zed a Google Antigravity, odvozené z dovedností a ze sledovaného justfile: co který produkt podporuje a na základě jakých důkazů, stav a obsahová adresa každého promítnutého souboru a co dělat s každým nálezem.

Vykresleno z docs/generated/openapi.json, který spustitelný soubor generuje ze svého registru schopností a CI jej odmítne, je-li zastaralý. Surový dokument je na /openapi.json; běžící server servíruje stejný dokument na vlastní /openapi.json a Swagger UI na /swagger.

editory

Soubory, které z tohoto repozitáře čtou Zed a Google Antigravity, odvozené z dovedností a ze sledovaného justfile: co který produkt podporuje a na základě jakých důkazů, stav a obsahová adresa každého promítnutého souboru a co dělat s každým nálezem.

GET /api/v1/editors editors.status

Projekce pro editory a agenty

Každý adaptér (Zed, Antigravity) s každou schopností, kterou podporuje, nepodporuje nebo nelze ověřit, a s důkazy; každý promítnutý soubor se vstupy, z nichž je odvozen, jeho adresou obsahu a jeho stavem zde (current, stale, absent, nebo konflikt se souborem, který tento generátor nezapsal); osiřelé projekce; a každý nález s jeho nápravou. Nic nezapisuje: `majordomus generate editors` ano.

  • query
  • behaviorally_verified
  • vyžaduje se měření výkonu
  • cache vypnuta
  • Nástroj MCP majordomus_editors
  • Zdroj MCP {"name": "editors", "uri": "majordomus://editors"}

Žádné parametry.

Vyzkoušejte

Port je ten, který server zalogoval; 8741 je ten, o který žádá jako první. Hodnoty jsou první příklad operace.

curl -s "http://127.0.0.1:8741/api/v1/editors"

Testováno v apps/majordomus-cli/tests/http_serve.rs, který přehrává routu s těmito hodnotami proti serveru na skutečném socketu.

Odpovědi

statustělovýznam
200 EditorProjection Projekce editorů a agentů: výsledek.
400 ErrorBody invalid_input: Vstup neodpovídá schématu: parametr špatného typu, neznámý parametr nebo hodnota, kterou schopnost odmítne.
404 ErrorBody not_found: Vstup pojmenovává něco, co repozitář nemá.
500 ErrorBody internal: Schopnost selhala z vlastního důvodu; zpráva ho pojmenovává.
výchozí ErrorBody Jakékoli jiné selhání, které transport hlásí: 405 method_not_allowed pro jinou metodu na této cestě, 400 invalid_input pro tělo, které není objektem JSON.

Schémata

Komponenty, které používají jen operace tohoto tagu. Každý řádek je pole daného typu, jeho doc komentář je popis; typ vlastněný jinou stránkou na ni odkazuje.

EditorAdapter

object
Jeden adaptér: produkt, verze, proti které byla jeho tvrzení ověřena, jeho schopnosti.
vlastnosttyppovinnépopis
id string ano zed nebo antigravity.
název string ano Název produktu.
verified_against string ano Release, ze kterého byly důkazy odebrány.
capabilities pole EditorCapability → EditorCapability ano Jeho schopnosti podle id.

Používá EditorProjection

EditorCapability

object
Jedna schopnost jednoho adaptéru.
vlastnosttyppovinnépopis
id string ano Stabilní identita v rámci adaptéru: skills, tasks, instructions, mcp, ...
podpora EditorSupport → EditorSupport ano Co s tím adaptér dělá.
artefakty array of string ne Soubory, které ji nesou, relativně k repozitáři. Prázdné, když se nic nepromítá.
evidence string ano Odkud pochází tvrzení o produktu.
poznámka string ano Co to znamená zde a co dělat, když se nic nepromítá.

Používá EditorAdapter

EditorDerivation

object
Jeden promítnutý soubor a jak vznikl.
vlastnosttyppovinnépopis
path string ano Cesta relativní k repozitáři.
dokument string ano Id dokumentu v manifestu generovaných artefaktů.
adaptéry array of string ano Adaptéry, které ji čtou.
zdroje array of string ano Vstupy, z nichž je odvozeno, podle cesty.
klíč string ano Adresa obsahu odvození: verze projekce a otisky jejích zdrojů. Stejný klíč vždy dává stejné bajty.
sha256 string ano SHA-256 promítnutého obsahu.
state EditorFileState → EditorFileState ano Stav souboru v tomto checkoutu.

Používá EditorProjection

EditorDiagnostic

object
Něco o projekci, s čím stojí za to něco udělat.
vlastnosttyppovinnépopis
závažnost Závažnost → Závažnost ano info, warning nebo error.
kód string ano Stabilní identita zjištění.
adaptér string | null ne Adaptér, kterého se týká, pokud se nějakého týká.
path string | null ne Soubor, jehož se týká, když se nějakého týká.
zpráva string ano Co se našlo.
náprava string ano Co s tím dělat.

Používá EditorProjection

EditorFileState

"current" | "stale" | "absent" | "conflict"
Promítnutý soubor tak, jak ho drží tento checkout.
  • currentBajt po bajtu to, co říká projekce.
  • staleVlastněno generátorem a odlišné: majordomus generate editors to přepíše.
  • absentNení tam: zapisuje to majordomus generate editors.
  • conflictNa cestě leží soubor bez generovaného banneru: patří někomu a nic ho nepřepíše.

Používá EditorDerivation

EditorInput

object
Jeden vstup projekce: soubor, jaký druh vstupu to je a jeho adresa podle obsahu.
vlastnosttyppovinnépopis
path string ano Cesta relativní k repozitáři.
měnitelnost EditorInputClass → EditorInputClass ano Sledovaný obsah nebo stav checkoutu.
sha256 string ano SHA-256 jeho obsahu.

Používá EditorProjection

EditorInputClass

"repository"
Jak daleko se vstup může změnit, aniž by se změnil repozitář.
  • repositorySledovaný obsah repozitáře: mění se jen commitem. Jediná třída, kterou má vstup dnes: to, co checkout pouze drží (instrukční soubor, starší adresář), mění nález, nikdy promítnutý bajt.

Používá EditorInput

EditorProjection

object
editors.status: každý adaptér, každý promítaný soubor a jeho stav, každý nález.
vlastnosttyppovinnépopis
schema string ano SCHEMA.
projection_version integer (uint32) ano PROJECTION_VERSION.
adaptéry pole EditorAdapter → EditorAdapter ano Adaptéry podle id.
vstupy pole EditorInput → EditorInput ano Vstupy podle cesty.
artefakty pole EditorDerivation → EditorDerivation ano Projektované soubory podle cesty.
osiřelé array of string ne Soubory vlastněné generátorem pod promítaným adresářem, které plán už neobsahuje.
diagnostika pole EditorDiagnostic → EditorDiagnostic ano Nálezy, podle závažnosti, pak kódu, pak cesty.

Používá editors.status

EditorSupport

"supported" | "unsupported" | "unknown" | "deprecated" | "requires_user_action"
Co adaptér s jednou schopností dokáže. Nikdy boolean: „nevíme“ je samostatná odpověď a není to „ne“.
  • supportedPromítnuto z ověřeného formátu.
  • unsupportedProdukt pro to nemá formu na úrovni projektu.
  • unknownFormulář na úrovni projektu je někde uplatňován a nepodařilo se jej ověřit; nic nebylo zapsáno.
  • deprecatedProdukt jej čte, z podoby, kterou tato projekce nezapíše.
  • requires_user_actionČlověk to může zapnout, mimo repozitář; náprava říká jak.

Používá EditorCapability

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