← System handbook

Tags, context & the 27-state model

Partialknowledge

Preserve source identity, then add frame-relative derived context without overwriting provenance.

TL;DR

Primitive currently has two different metadata layers that must not be confused: immutable-ish source classification in Foundry's primitive.tags/v1, and derived Workspace Primitive metadata including the canonical E/P/A 27-state cube. There is ONE canonical 27-state E/P/A cube today. The proposed Environment, Relation and Context cubes are experiments, not three production cubes.

ELI5

The source tag is the label stuck to the original box: where it came from and what kind of thing it is. The context score is a note we add later saying how useful or actionable that box is for a particular question. We can change the note without pretending the original box came from somewhere else.

Synthesis

This separation is what lets Primitive trace information reliably. Foundry source tags travel unchanged through intake; OS adds graph edges, summaries, embeddings and frame-relative metadata. The canonical cube q=(E,P,A) uses exactly three ternary axes and Q00–Q26. Zero is a real reference band, while UNKNOWN uses null coordinates. Probability, uncertainty, consequence, risk, confidence and importance remain continuous overlays rather than secretly creating extra cube dimensions.

Source tags

primitive.tags/v1 — what each group means

GroupPurposeExamples
identityStable source identity and integrityasset_id, content_sha256, source_scope
classificationWhat the source isrelationship_to_primitive, asset_type, functions, artifact_types, domains
evidenceWhat kind of evidence state we currently knowstate, classification confidence
lifecycleWhether the captured source is present/currentstate, present
governanceSensitivity and review requirementssensitivity, security_sensitive, requires_review
contextSource-local location/contextsource_id, source_kind, source_label, project, original_path, relative_path
labelsSearchable convenience labelsrelationship, type, functions, artifact types
Invariant: Downstream systems may derive more metadata, but they must not silently rewrite the original universal source tags.
Canonical cube

E / P / A produces exactly 27 states

The current Workspace contract is q=(E,P,A) in {-1,0,+1}^3. E is Epistemic/Evidence, P is Potency/Capacity, and A is Actionable/Agency. The address is index=(E+1)*9+(P+1)*3+(A+1), producing Q00 through Q26.

Canonical E/P/A cubeQ13 is (0,0,0), the reference/middle state. UNKNOWN is outside the cube.
E = -1
Q00P -1 · A -1
Q01P -1 · A 0
Q02P -1 · A +1
Q03P 0 · A -1
Q04P 0 · A 0
Q05P 0 · A +1
Q06P +1 · A -1
Q07P +1 · A 0
Q08P +1 · A +1
E = 0
Q09P -1 · A -1
Q10P -1 · A 0
Q11P -1 · A +1
Q12P 0 · A -1
Q13P 0 · A 0
Q14P 0 · A +1
Q15P +1 · A -1
Q16P +1 · A 0
Q17P +1 · A +1
E = +1
Q18P -1 · A -1
Q19P -1 · A 0
Q20P -1 · A +1
Q21P 0 · A -1
Q22P 0 · A 0
Q23P 0 · A +1
Q24P +1 · A -1
Q25P +1 · A 0
Q26P +1 · A +1
Zero vs unknown

0 means reference; null means unknown

StateMeaning
0 on an axisKnown reference / middle band
-1 / +1Declared orientation relative to that axis
UNKNOWNInsufficient/unresolved information; axes are null
Overlays

Continuous evaluation stays off the grid

Workspace explicitly keeps probability, uncertainty, consequence, risk, confidence and importance outside the ternary coordinate. That avoids turning the current 27-state contract into an accidental 243-state or larger space.

Proposed research

Environment / Relation / Context cubes are not canonical yet

The recursive-systems programme proposes three coordinated chart instances — Environment, Relation and Context — rather than overwriting E/P/A. Exact axes still require definitions and benchmarking. They should be versioned charts if adopted.

Proposed coordinated chartsExperimental layer around the existing canonical E/P/A chart.
EnvironmentConditions/resources
RelationAuthority/dependency/membership
ContextMeaning/interpretation in frame
Trace

How tags become relevant context without losing lineage

Traceable information path
Source + hashOriginal provenance
primitive.tags/v1Stable source classification
Chunk + filingSearchable derived representation
Hybrid retrievalLexical + embedding + tag signals
Context CompilerAuthorised task-specific context
Reflex / RouterSelect relevant subset
Run + ReceiptOutcome and causal evidence
Keep reading

Related pages

Reference / evidence

Canonical sources

These pages are explanatory read models. Where wording conflicts with implementation or a Control decision, the linked implementation/decision is authoritative and this page should be corrected.