Butkhuzi Shared Shell Contract
This document describes the smallest truthful shared shell that Butkhuzi still depends on today.
It is not an aspirational design. It is the current extraction seam.
Resolving locale, route permissions, and workspace projection.
Current scope: Guest
Category: 10_normative | Version: v1.0.0
Owner: DOCUMENT_CUSTODIAN | Review cycle: 90 days
Approval authority: GOVERNANCE_ADMIN
Documentation portal is read-only. Editing and mutation endpoints are disabled.
Kvary platform is originally created in Georgian. Where a Georgian version exists, Georgian is authoritative for platform UI, documentation, and legal interpretation.
Translations into other languages are provided for convenience. Some records may originate in other languages and carry their own source or legal locale for a specific flow, but where a Georgian version is available, the Georgian version prevails for platform-level wording and interpretation.
Metadata incomplete: Document ID, Version, Status, Owner Role, Last Review Date, Next Review Date, Change Log
This document describes the smallest truthful shared shell that Butkhuzi still depends on today.
It is not an aspirational design. It is the current extraction seam.
Current gateway owner:
Current seam:
BUTKHUZI_SERVICE_URL ?? TENDERS_SERVICE_URLCurrent gateway route family:
GET /butkhuzi/normsGET /butkhuzi/suggestGET /butkhuzi/searchPOST /butkhuzi/upsertPOST /butkhuzi/chunks/rebuildVerdict:
Why:
Gateway auth behavior:
Service runtime auth behavior:
svc-tenders shell requireServiceAuth verifies bearer tokenssvc-auth /auth/meEvidence:
Verdict:
Why:
Current expectations:
/auth/meVerdict:
Notes:
Current helper surface adapted into Butkhuzi routes:
parsePositiveIntparseOptionalIntparseOptionalStringparseOptionalUpperrequireServiceAuthAdaptation layer:
Verdict by helper:
requireServiceAuth: must remain sharedWhy:
Real current integration:
Verdict:
Why:
svc-tenders to a future Butkhuzi runtimeThe truthful shared shell for Butkhuzi is small:
That is a good position for later runtime/bootstrap prep.