Skip to content

Scarabaeus1031/NEXAH-ORION

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

NEXAH-ORION — Certified Deterministic Core

ORION owns the certified deterministic Core within the NEXAH Orientation Ecosystem. Its Version 1 baseline covers immutable Structural Representation, UNDERSTAND inventory, Structural Summary and Statistics, Relations, Navigation, Orientation Map and the certified Expression boundary.

Public path: NEXAH Visitor Guide · Human-facing Workspace · Research & Framework

ORION does not own the public website, the Human Workspace, Human meaning, Human decisions, Runtime, Gateway, LYRA execution, SIRIUS, applications or presentation.

The canonical baseline is docs/releases/ORION_V1_CERTIFIED_BASELINE.md. Earlier Runtime, Gateway, report and LYRA documents remain historical or separate architectural records; they do not redefine the certified Version 1 baseline.

The governing rule is:

The model proposes. The Orchestrator validates. The Kernel decides.

Start here

I want to… Read
understand Version 1 without reading phase history docs/releases/ORION_V1_READING_ORDER.md
see what Version 1 includes and excludes docs/releases/ORION_V1_RELEASE_NOTES.md
inspect the canonical Version 1 baseline docs/releases/ORION_V1_CERTIFIED_BASELINE.md
inspect the public contract language docs/architecture/contracts/ORIENTATION_REQUEST.md
inspect historical Runtime/Gateway work outside the certified Core src/README.md
understand the ecosystem's highest governance baseline NEXAH Ecosystem Constitution v1.0
understand the architecture docs/architecture/ORION_ARCHITECTURE.md
inspect the official ORION v1 freeze docs/architecture/ORION_V1_ARCHITECTURE_FREEZE.md
read the F1 architecture review docs/architecture/ORION_V1_ARCHITECTURE_REVIEW.md
understand representation and rendering docs/architecture/REPRESENTATION_ARCHITECTURE.md
navigate the Orientation Transform Stack docs/architecture/transformations/ORIENTATION_TRANSFORM_STACK.md
inspect the versioned transformation contracts docs/architecture/transformations/contracts/TRANSITION_CONTRACT_SPECIFICATION.md
understand the operator capability inventory docs/architecture/operators/OPERATOR_ARCHITECTURE.md
inspect the historical LYRA boundary record outside the certified baseline docs/architecture/lyra/LYRA_ARCHITECTURE.md
explore why LUCY may exist docs/architecture/lucy/LUCY_CONCEPT.md
inspect the LUCY Concept Freeze docs/architecture/lucy/LUCY_CONCEPT_REVIEW.md
walk through the first NEXAH Alpha experience docs/experience/FIRST_USER_JOURNEY.md
browse the canonical Architecture Plates docs/architecture/plates/README.md
inspect the recovered Core baseline docs/architecture/baselines/PHASE_0_BASELINE_RECOVERY.md
prepare my local workspace docs/development/WORKSPACE.md
browse completed development phases docs/development/README.md
understand where work belongs docs/governance/OWNERSHIP.md
contribute a change CONTRIBUTING.md
inspect the publication candidate docs/releases/RELEASE_CANDIDATE.md
inspect the exact Core mismatch docs/releases/CORE_COMPATIBILITY_REPORT.md
propose an architecture decision docs/adr/README.md
prepare a release docs/releases/RELEASE_STRATEGY.md
inspect publication readiness docs/releases/PUBLICATION_BASELINE.md
inspect the first execution slice docs/development/PHASE_1A_EXECUTION.md
run the local Ollama backend docs/development/PHASE_1B_OLLAMA.md
verify the executable baseline docs/development/PHASE_1B_CLOSEOUT.md
build deterministic repository context docs/development/PHASE_2A_CONTEXT.md
derive repository documents from request scope docs/development/PHASE_2B_SELECTION.md
derive a deterministic content-free context brief docs/development/PHASE_2C_CONTEXT_BRIEF.md
plan deterministic representation transitions docs/development/PHASE_4A_TRANSFORMATION_ENGINE.md
inspect the Phase 5A operator placeholders docs/development/PHASE_5A_OPERATOR_REGISTRY.md
understand the Phase 6A language model docs/development/PHASE_6A_LYRA_LANGUAGE.md
run the Phase 6B Human → ORION → Human boundary docs/development/PHASE_6B_LYRA_INTEGRATION.md
execute canonical Phase 6C Orientation Sessions docs/orientation_sessions/README.md

Repository boundary

NEXAH Framework / OLS / Kernel   definitions, semantics and deterministic contracts
NEXAH-ORION                      certified structural orientation and Expression boundaries
Library House                    Works, Editions and editorial identity
Builder Hub                      independent operator-facing application

The NEXAH Framework and Builder Hub are not vendored into this repository. The canonical Library Registry currently lives under NEXAH/LIBRARY; the constitutional Library House does not by itself require an independent repository. Local working copies and reserved workspace entries are described by workspace.yaml.

First setup

./scripts/bootstrap-workspace
./scripts/check-workspace
./scripts/test

To connect the already available frozen Core clone:

./scripts/bootstrap-workspace \
  --core-path /absolute/path/to/NEXAH

Alternatively, clone the pinned Core revision:

./scripts/bootstrap-workspace --clone-core

Reserved Library and Builder Hub workspace entries remain unavailable until an authoritative repository identity and baseline are separately approved. Those entries do not establish new constitutional authority.

Where work belongs

Work Destination
accepted ORION architecture docs/architecture/ and an ADR when ownership or contracts change
proposed architecture decision docs/adr/
cross-repository rules docs/governance/
release and compatibility policy docs/releases/
frozen public contract specifications docs/architecture/contracts/
executable public contract binding src/orion/public_contracts/
historical Runtime, Gateway and presentation work outside the certified Core src/orion/orientation_runtime/, src/orion/gateway/
optional future transport encodings schemas/ only after separate approval
ORION-owned verification tests/ beside the owned behavior
local research .workspace/research/
local experiments .workspace/experiments/
local run artifacts .workspace/runs/
release candidates and review bundles .workspace/releases/
NEXAH semantic or deterministic Core changes the NEXAH Core repository, never here
Library identity, records or editorial execution the Library House; currently NEXAH/LIBRARY, never ORION
Builder UI and operator interaction Builder Hub, never here

Repository status

Under the adopted Ecosystem Constitution, ORION is the House that navigates. The certified Version 1 baseline owns only the structural Representation, UNDERSTAND inventory, Summary, Statistics, Relations, Navigation, Orientation Map and Expression boundaries named in the certified baseline. It does not own Experience presentation, Library identity, Runtime, Gateway, LYRA execution or Human interpretation, Reflection and decision.

The Phase 7A LUCY Concept Freeze remains a non-normative boundary record. LUCY is not an ORION component or constitutional House. The Human remains the one who reflects and decides.

The Phase VIII audit recommends the ORION Version 1 baseline for stable freeze. Core architecture stays in maintenance mode: a change to frozen terminology, responsibilities, authority, contracts, dependency direction or structure requires explicit Architecture Review and an accepted ADR.

Earlier public-contract, Runtime, Gateway, provider and LYRA modules remain explicit-path historical or experimental artifacts. Their presence in the working repository does not make them part of the certified Version 1 Core or its public release claim. LUCY remains research outside execution.

Architecture Plates follow a source/artifact rule: SVG files under docs/architecture/plates/src/ are canonical and editable; PNG files are generated documentation artifacts and are never edited directly.

The earlier Operator Registry and T01–T15 transition prototypes remain non-executable historical architecture slices. Ollama remains an opt-in experiment and is not part of the Version 1 public Runtime. Run all isolated tests with make test; the Ollama integration remains opt-in through make integration.

No registered transition is currently executable. ORION can navigate documented representation routes, attach declarative operator metadata and produce Transformation Plans and blocker reports, but it never generates a Representation Target; produced_representation remains None.

The repository version is 1.0.0. Its supported scope is exactly the certified baseline through WP30. Earlier Public Contract, Runtime, Gateway, provider and LYRA work remains available as historical or separately governed material and does not broaden the Version 1 release.

The public repository identity is Scarabaeus1031/NEXAH-ORION. It publishes the independent ORION Version 1 certified baseline. Publication and downstream compatibility remain bound to the exact immutable release revision and canonical fingerprint. The verified NEXAH Core pin is unchanged.

Original software is licensed under the Apache License 2.0. Original documentation, specifications, research, books and visual material are licensed under CC BY 4.0 where applicable. Third-party and source-derived material retains its stated terms. See the complete Licensing Scope.

Community participation follows the canonical CODE_OF_CONDUCT.md; security reports follow SECURITY.md.

About

The certified deterministic Core within NEXAH — The Orientation Ecosystem: structural representation, relations, navigation, orientation maps, Expression, and provenance.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages