https://rekeeply.github.io/spec/en/appendices/Recent content in Appendices on Rekeeply SpecHugoenhttps://rekeeply.github.io/spec/en/appendices/glossary/Mon, 01 Jan 0001 00:00:00 +0000https://rekeeply.github.io/spec/en/appendices/glossary/<h1 id="glossary">Glossary<a class="anchor" href="#glossary">#</a></h1> <p>Fixed canonical terms used across the specification.</p> <ul> <li><code>Account</code> — top-level user domain context in core.</li> <li><code>Session</code> — authenticated runtime context bound to one <code>account_id</code>.</li> <li><code>Library</code> — structured storage domain for organized work.</li> <li><code>Raw</code> — account-scoped unstructured capture domain.</li> <li><code>active_library_id</code> — selected library for library-scoped operations.</li> <li><code>library-scoped</code> — operation/data requiring an active library context.</li> <li><code>account-scoped</code> — operation/data requiring only account session context.</li> <li><code>unlock</code> — session opening after credential validation.</li> <li><code>sync</code> — asynchronous data synchronization between local and remote runtimes.</li> <li><code>promote</code> — explicit transfer from <code>Raw</code> into <code>Library</code>.</li> </ul>https://rekeeply.github.io/spec/en/appendices/versioning-policy/Mon, 01 Jan 0001 00:00:00 +0000https://rekeeply.github.io/spec/en/appendices/versioning-policy/<h1 id="versioning-policy">Versioning Policy<a class="anchor" href="#versioning-policy">#</a></h1> <h2 id="scope">Scope<a class="anchor" href="#scope">#</a></h2> <ul> <li>This policy defines versioning rules for specification, core API, and project repositories.</li> </ul> <h2 id="version-domains">Version Domains<a class="anchor" href="#version-domains">#</a></h2> <ul> <li><code>Spec Version</code> - version of this specification.</li> <li><code>Core API Version</code> - version of runtime contract between clients and core.</li> <li><code>Project Version</code> - version of each concrete repository/package (<code>core</code>, <code>cli</code>, other clients).</li> </ul> <h2 id="scheme">Scheme<a class="anchor" href="#scheme">#</a></h2> <ul> <li>All version domains MUST use Semantic Versioning: <code>MAJOR.MINOR.PATCH</code>.</li> </ul> <h2 id="semver-rules">SemVer Rules<a class="anchor" href="#semver-rules">#</a></h2> <ul> <li><code>MAJOR</code>: breaking contract change.</li> <li><code>MINOR</code>: backward-compatible feature addition.</li> <li><code>PATCH</code>: backward-compatible fix/editorial correction.</li> </ul> <h2 id="compatibility-baseline">Compatibility Baseline<a class="anchor" href="#compatibility-baseline">#</a></h2> <ul> <li>Clients MUST declare supported <code>Core API Version</code> range.</li> <li>Core runtime MUST expose current <code>Core API Version</code>.</li> <li>On startup/handshake, client-core compatibility MUST be validated before normal operations.</li> <li>Incompatible versions MUST fail with explicit compatibility error.</li> </ul> <h2 id="release-mapping">Release Mapping<a class="anchor" href="#release-mapping">#</a></h2> <ul> <li><code>Spec Version</code> MAY evolve independently of project package versions.</li> <li>Breaking changes in spec core contract SHOULD increment both <code>Spec Version</code> and <code>Core API Version</code> major versions.</li> <li>Project package versions SHOULD map to internal release cadence but MUST not bypass API compatibility checks.</li> </ul> <h2 id="rkl-format-versioning">RKL Format Versioning<a class="anchor" href="#rkl-format-versioning">#</a></h2> <ul> <li><code>*.rkl</code> format version is independent and MUST be declared in <code>manifest</code>.</li> <li>Import MUST validate declared <code>rkl</code> version before processing datasets.</li> </ul>