{"authentication":"none","beacon_version":"0.2.0rc2","capabilities":{"chunks":true,"concepts":true,"decisions":true,"guardrails":true,"mcp_http":true,"query":true,"question_submission":false,"snapshot":true,"status":true},"descriptor_version":"1.10","dynamic":{"explain":{"method":"GET","parameters":["concept","depth"],"url":"/v1/explain","use_when":"explain one concept in depth"},"read":{"method":"GET","parameters":["chunk_id","path","heading","line","max_chars","offset"],"url":"/v1/read","use_when":"read one section by chunk id, path or heading; continue with offset"},"search":{"method":"GET","parameters":["q","types","limit"],"url":"/v1/search","use_when":"find documents, concepts, decisions or guardrails by keywords"}},"freshness":{"generator":{"distribution":"archolith-beacon","version":"0.2.0rc2"},"observed_at":"2026-09-27T16:50:57Z","repository":{"commit":"9fe56e2d1add5a9f04e5b65c4f7b829ba0c8aed5","dirty":false,"state":"observed"},"snapshot_sha256":"3d64590b592dd0e8801979389b79774715775cd9403de7c800ce915240d52b06","status_url":"/v1/status"},"mcp":{"tools":7,"transport":"streamable-http","url":"/mcp","use_when":"an MCP client: the same answers as the JSON routes, as Beacon's tools"},"recommended_flow":[{"step":"identify","url":"/v1/snapshot/identity","use_when":"start here: learn which project and snapshot this is"},{"step":"why_search","url":"/v1/search","use_when":"for a why question: search with types=decisions"},{"step":"why_decision","url":"/v1/decisions/{id}","use_when":"read the decision the why search found"},{"step":"search","url":"/v1/search","use_when":"for any other question: search by keywords"},{"step":"read","url":"/v1/read","use_when":"read the section a search hit points to; pass offset to continue"},{"step":"explain","url":"/v1/explain","use_when":"alternative to read or the decision record: explain one concept"},{"step":"guardrails","url":"/v1/guardrails","use_when":"before making changes: read the guardrails"}],"representations":{"full":{"bytes":157027,"mode":"embedded","schema_version":"1.0","sha256":"3d64590b592dd0e8801979389b79774715775cd9403de7c800ce915240d52b06","url":"/v1/snapshot"},"identity":{"bytes":2438,"mode":"metadata_only","schema_version":"1.0","sha256":"f8d9618fd093876cc37d9bfcee78f9eede3bf61f332bbca5765fb14ada9e610c","url":"/v1/snapshot/identity"},"orientation":{"bytes":35889,"mode":"metadata_only","schema_version":"1.0","sha256":"135301266e446735de2ee13b2807ade3bde3e2014cd0bbae712c0d24d7321793","url":"/v1/snapshot/orientation"}},"resources":{"chunks":{"bytes":31273,"count":130,"index_url":"/v1/chunks","item_url_template":"/v1/chunks/{id}","sha256":"90bac56df0e5caa7ae47ef11b66229072cb2b373a06d425fc1052130d334804d","use_when":"read document text in heading-sized chunks by stable id","version":"1.0"},"concepts":{"bytes":1263,"count":5,"index_url":"/v1/concepts","item_url_template":"/v1/concepts/{id}","sha256":"4d37326fd9db4b180e177f45f82247addff73551ced61bfd0ef4f7459d042095","use_when":"list core concepts and find their ids","version":"1.0"},"decisions":{"bytes":239,"count":0,"index_url":"/v1/decisions","item_url_template":"/v1/decisions/{id}","sha256":"d5fd52e0d081b2baa0514fc3b4b3c0401a8d52418654bbffb1f6e93098e1d964","use_when":"why the project is built this way","version":"1.0"},"guardrails":{"bytes":1743,"count":7,"index_url":"/v1/guardrails","item_url_template":"/v1/guardrails/{id}","sha256":"f2e7b519f5e4f8cc4d13593001da26646d5af337c1d37d482cb302cadbb09246","use_when":"read the rules to respect before making changes","version":"1.0"},"status":{"bytes":8703,"sha256":"d5089c134d62da490e841df2af9da583c61898e19e5c41dee9cbd8f47638cc2f","url":"/v1/status","use_when":"check how fresh the snapshot and repository evidence are","version":"1.1"}},"scope":"container","snapshot":{"mode":"embedded","schema_version":"1.0","sha256":"3d64590b592dd0e8801979389b79774715775cd9403de7c800ce915240d52b06","url":"/v1/snapshot"},"trust":"direct_unverified","trust_note":"direct, unverified access: no signing and no trust broker yet"}