Skip to content

Six Primitives ​

Reference table for the six fixed protocol primitives. Authoritative contract: .nimi/spec/platform/core-protocol.authority.yaml and rule family P-PROTO-*.

The Six ​

PrimitiveRuleCarries
TimeflowP-PROTO-100Progression, timing, temporal meaning
SocialP-PROTO-101Relationships, social graph semantics
EconomyP-PROTO-102Value, exchange, economic state
TransitP-PROTO-103Movement between worlds or contexts
ContextP-PROTO-104Shared situational meaning
PresenceP-PROTO-105Who or what is present, and under what conditions

Each primitive is a contract surface. Worlds may define their own internal rules; meaning that crosses worlds must fit one of these six contracts.

Authority ​

LayerRole
Platform protocolDefines the primitives' shape and version policy
RealmOwns the source of truth and semantic execution for the six primitives
AppsConsume and observe; do not execute

The P-PROTO-003 rule pins primitive semantic execution and truth source to Realm.

Cross-Consistency ​

A world transition that involves multiple primitives must satisfy all relevant primitive contracts simultaneously:

ConstraintWhy
A transit must satisfy Social + Economy + Context simultaneouslyTransit moves a participant across worlds; social standing, economic standing, and contextual meaning must all align
Presence cannot bypass social admissionBeing "present" in a world requires social admission first
Timeflow cannot break economy settlement windowsTime progression must respect economic settlement boundaries

The six primitives are not independent enums. They are mutually constraining.

Versioning Posture ​

PropertyValue
Strategystrict-only
Cross-minor handshakesForbidden
Backward compatibility shimsForbidden
Failure modeFail-close on contract violation

Clients must match. There is no graceful degradation pretending compatibility while violating contracts.

Authorization Presets ​

Apps interact with primitives under scoped authorization. The platform admits three preset templates that all share the same token shape and validation chain:

PresetReadWriteDelegate
readOnlyyesnono
fullyesyesno
delegateyesyesone level

delegate allows up to one level of further delegation by default.

App Modes ​

ModePrimitive readPrimitive writeActive count per world
render-appyesnomany
extension-appyesyesat most one active per world

Audit Events ​

Cross-primitive actions emit audit events recorded under the platform audit dictionary (config/platform-audit-events.yaml).

Source Basis ​

Documentation for Nimi — the installable, open-source, local-first personal AI product.