Home /Modules/registry/README.md

README.md

lib/registry/README.md · 59 line(s) · markdown

lib/registry — Sleela OOD equivalents of the registry

Idea System(TM) / Idea(TM). From Author; distributive.

The SLeeLa 3.0 architecture contract is REGISTRY-3.0-ARCHITECTURE.md. The classes below remain the compatibility object model while the record-oriented 3.0 model is implemented in staged, testable increments.

The SLeeLa object-oriented mirror of the native registry core (/registry), so a program can model, seed, and review the registry from Sleela.

The native core these classes mirror is built and its baseline table materialized by the master build (repo-root make all → registry target → build-registry.sh); see /registry for the build and the on-disk .sleelareg / MySQL table it produces.

ClassMirrors (native)Role
SLRegistryValuea registry value (sl_reg_kind)one setting / feature flag: string, int, or bool
SLRegistryProvenancesl_reg_provenance + seala tracked artifact's file/date/author/version/hex-id/hash + originality seal
SLRegistryKeythe key nodea path-keyed node holding values + an optional provenance record
SLRegistrythe storethe HKEY-style tree; seedDefaults() + show() (terminal review)

Shape

Following the lib conventions: #sleela 1.3, the five-field doc-header, configure()-style init, and numbered fields instead of arrays (the surface has no arrays) for the bounded value/key sets.

SLRegistry reg = new SLRegistry();
reg.seedDefaults();     // System, System/VM, Settings, Features, Artifacts
reg.show();             // terminal review
boolean on = reg.featureEnabled("modium");

The originality seal

SLRegistryProvenance records the seal input hexId | version | hash | author. The SHA-256 of that (and of the file content for hash) is computed by the host across the native bridge; isSealed() / verify(expected) check it. The native /registry core is the authority for computing and persisting seals.

Naming notes

A few method names were chosen to avoid words the grammar treats as contextual in call position: the review method is show() (not review), and the seal-check is isSealed() (not sealed). Chained calls on a method's return value are also avoided (assign to a local first) — the SLeeLa surface rejects a.foo().bar().

Registry 3.0 source model and governance

The new native API and versioned persistence contract are described in Registry 3.0 architecture, native bindings, and the Modium catalog contract.

The SLeeLa source model now includes SLRegistryRecord, SLRegistryIdentity, SLRegistryRelationship, SLRegistryLifecycle, SLRegistryResolver, and SLRegistryReview. The key-path index and per-key value-name index are growable SLList string collections. The eight numbered object slots are retained solely as the legacy display window; SLList stores strings, not arbitrary class instances, and the native record engine owns the full record set.

The separate governance package defines source shapes for manual voting. Its @vote annotation is currently inert documentation; ballot handling and eligibility remain an explicitly human procedure. The syntax and safeguards are specified in DEMOCRATIC-VOTING-SYNTAX.md.