Adresářové smlouvy vrstvy
Každý adresář vrstvy, který index zná, s kontraktem, který deklaruje, zda jeden dluží a který kontrakt rozhodl, a — pro pojmenovanou cestu, nebo na požádání pro všechny — efektivní řetěz složený od kořene dolů, nejméně specifický první.
- query
- behaviorally_verified
- vyžaduje se měření výkonu
- cache procesu (max_entries=8, ttl_seconds=5)
- Nástroj MCP majordomus_directories
- Zdroj MCP {"name": "directories", "uri": "majordomus://directories"}
Parametry dotazu
| název | typ | povinné | popis | příklady |
|---|---|---|---|---|
| path | string | ne | Jeden adresář, relativní k repozitáři a uvnitř vrstvy. Jeho účinný řetěz se vždy rozřeší. Vynechání znamená každý adresář vrstvy. | one-directory: ".ai/repo/rules" |
| účinné | boolean | ne | Vyřešit účinný řetěz pro každý adresář, ne jen pro pojmenovaný. | effective-everywhere: true |
| state | DirectoryState | null | ne | Jen adresáře v tomto stavu: `documented`, `exempt` nebo `owed`. | owed: "owed" |
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/directories?path=.ai%2Frepo%2Frules&effective=true&state=owed"
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
| status | tělo | význam |
|---|---|---|
| 200 | DirectoryReport | Kontrakty adresářů vrstvy: 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. |