Správa projektu Kshana

Tento dokument uvádí, jak je Kshana řízen: kdo rozhoduje, jak, a co projekt přijme a co nikoli. Je záměrně lehký — úměrný současné velikosti projektu — a otevřeně uvádí dnešní realitu jediného správce i cestu k širší správě, jak komunita poroste.

Poslání a rozsah#

Kshana je neutrální, reprodukovatelná a poctivě ověřená reference pro výkonnost a odolnost hybridního kvantově-klasického PNT. Poslání nastavuje měřítko pro každé rozhodnutí: správnost, citace a reprodukovatelnost před šíří záběru. Poctivý rozsah je zdokumentován v docs/CAPABILITY.md a stav validace v docs/VALIDATION.md; návrhy se posuzují vůči tomuto rozsahu, nikoli podle počtu funkcí.

Role#

Správce. Kshana v současnosti spravuje jeho zakladatel, společnost Ashforde OÜ (kontakt: contact@ashforde.org). Správce je konečným rozhodovatelem o rozsahu, návrhu, vydáních a o tom, co se začlení. Jde o model benevolentního správce, uvedený otevřeně, nikoli převlečený za výbor, který neexistuje.
Přispěvatelé. Kdokoli, kdo otevře issue nebo pull request. Příspěvky se posuzují podle měřítka v CONTRIBUTING.md — původ každého číselného parametru, validace vůči publikovanému vztahu a poctivost ohledně zralosti.
Budoucí committeři. Pokud to trvalý, kvalitní přínos opodstatní, budou práva k zápisu rozšířena na důvěryhodné přispěvatele a tento dokument bude aktualizován na model s více správci (rozhodnutí líným konsenzem, přičemž nesouhlasy řeší skupina správců). Do té doby platí postup: přispívat, vybudovat si zázemí a být pozván.

Jak se rozhoduje#

Diskuse na veřejnosti. Podstatné změny začínají jako issue na GitHubu, aby zdůvodnění, alternativy a kompromisy byly zaznamenány.
Líný konsenzus. Návrh, proti kterému po přiměřené době nezazní trvalá námitka a který splní níže uvedené technické měřítko, pokračuje.
Při nesouhlasu rozhoduje správce. Pokud se konsenzu nedosáhne, rozhodne správce a zaznamená důvod. Nesouhlas se řeší podle poslání a technického měřítka, nikoli podle senority nebo hlasitosti.

Technické měřítko (nesmlouvavé)#

Jde o pevné invarianty, vynucované CI a revizí, které žádné rozhodnutí neruší:

Reproducibility. (scenario, seed, engine_version) musí reprodukovat běh bit po bitu. Změna, která to učiní nedeterministickým, je chyba, nikoli funkce.
Původ. Žádné anonymní číselné konstanty — každý parametr cituje zdroj.
Poctivost validace. Každá schopnost je označena validated (vůči vnějšímu orákulu) nebo modelled / not modeled. Nic se netvrdí nad rámec důkazů. Viz strojově kontrolovanou matici v src/verification.rs.
Hygiena. Žádná atribuce automatizovaného nástroje nikde v commitech, obsahu ani historii (vynucuje scripts/check-no-attribution.sh).

Změna, která nesplní toto měřítko, se zamítne, ať by byla jakkoli užitečná.

Hranice mezi otevřeným a uzavřeným#

Kshana je open-core. Tento repozitář je a zůstane úplným otevřeným enginem pod AGPL-3.0 — neutrální referencí s komerční duální licencí od společnosti Ashforde OÜ (viz LICENSING.md). Projekt do otevřeného repozitáře nepřijme:

Hloubku podléhající exportní kontrole nebo dvojího užití — skutečné knihovny hrozeb, protivníkovy průběhy signálů nebo parametry výkonu protirušení a ochrany proti spoofingu. Veřejný repozitář zůstává u obecných, publikovaných modelů a metod (viz CONTRIBUTING.md → Exportní kontrola). Pokud si nejste jisti, zeptejte se před přispěním.
Důvěrná data nebo kalibrace zákazníků či partnerů.
Copyleftové (GPL/AGPL/LGPL/MPL) závislosti — ne proto, že by byly v rozporu s vlastní licencí AGPL enginu (nejsou), ale proto, že je nelze přelicencovat do komerční edice: komerční licenci můžeme prodávat jen nad kódem, který vlastníme nebo který je permisivní. Copyleftová závislost by komerční edici zasáhla a porušila by duální licenci. Závislosti proto zůstávají permisivní (Apache/MIT/BSD/ISC), což vynucuje deny.toml.

Naopak projekt nevyprázdní otevřené jádro kvůli prosazení proprietární hodnoty: ověřený engine, veřejné validační kotvy, registr poctivosti, výměnný/standardní formát a distribuční kanály zůstávají otevřené. Vyhladovění otevřeného jádra je jediná fatální chyba v modelu open-core a je vyloučeno.

Vydání#

Sémantické verzování. Před verzí 1.0 se schéma scénáře/výsledku může měnit; zásadní změny jsou výslovně uvedeny a verze výměnného schématu (src/interchange.rs::SCHEMA_VERSION) je jediným zdrojem pravdy o kompatibilitě artefaktů.
Pravomoc k vydání. Publikování (např. cargo publish) je ruční krok správce vyžadující token registru. CI a workflow Release spouštěný tagem nikdy automaticky nepublikují do externích registrů — pouze znovu spustí všechny kontroly a připojí sestavený artefakt. Viz CONTRIBUTING.md → Commity a verzování.

Etický kodex a bezpečnost#

Chování se řídí dokumentem CODE_OF_CONDUCT.md.
Bezpečnostní problémy se řídí postupem soukromého hlášení v SECURITY.md — pro zranitelnost neotevírejte veřejné issue.

Ochranná známka#

Název a logo Kshana jsou ochranné známky společnosti Ashforde OÜ. Licence (AGPL-3.0 nebo komerční licence) se vztahuje na kód, nikoli na značky: fork může používat kód podle licence, nikoli však název Kshana ani kanonickou identitu distribuce. Tím zůstává Ashforde citovaným zdrojem pravdy, což je součástí toho, jak otevřené jádro zůstává neutrální referencí.

Změny tohoto dokumentu#

Změny správy se samy navrhují jako pull request a rozhodují se výše popsaným postupem. Jak se bude měnit rozsah projektu, očekávejte, že tento dokument dostane model rozhodování s více správci; technické měřítko nesníží.

Lehká záměrně. Poctivá k dnešku, s uvedenou cestou na zítřek.