Skip to main content

genesis-scope

Semantic coordination system for human-LLM collaboration — GenesisAeon Package 39.

CI Python 3.11+ License: MIT DOI


Mission

A human integrates temporally — meaning emerges from a continuous, ordered stream of experience. An LLM navigates atemporally — it collapses a probability space in a single step, with no continuous experience stream of its own.

genesis-scope is the explicit, executable geometry of the shared space between these two asynchronous processes. It models:

  • Semantic anchors (Sigillin) — compressed state markers that reduce meaning drift between sessions (semantic_anchor.py).
  • Drift model — dD/dt = -kappa * (D - D*), the relaxation of shared semantic state toward a fixed point D* = (lambda/kappa) * A_avg set by the registered anchors (drift_model.py).
  • Coordination space — the (tau_A, tau_H, Sigma) coordinate system: action time, human time, and semantic density (coordination_space.py).
  • Collaboration CREP — Gamma_collab = (C * R * E * P) ** 0.25, the coherence metric for a collaboration session (crep_collaboration.py).
  • Q4 collaboration states — 4-bit encoding of collaboration phases, following the GenesisAeon Q4 Runtime Contract (q4_collaboration.py).
  • Session tracking — records sessions, computes Fisher-Rao velocity through coordination space, and warns if it exceeds v_RIG (Package 31, session_tracker.py).
  • Semantic cartography — the navigable map of the GenesisAeon concept space: typed nodes and edges, explicit paths between concepts, attractor ranking, drift detection between map snapshots, and multi-agent perspective comparison (cartography.py).

All of these are tied together by GenesisScope, the Diamond-interface implementation in system.py.

Installation

pip install genesis-scope

Quickstart

uv sync --dev
uv run pytest
from genesis_scope import GenesisScope

scope = GenesisScope()
result = scope.run_cycle(n_sessions=38)

print(result["coherence_score"])   # Gamma_collab
print(result["drift_status"])      # "stable" | "drifting" | "anchored"
print(result["utac_state"])        # Sigma(t) + Q4 state

CLI

scope status                  # run a cycle and print the scope status
scope drift                   # simulate drift with/without anchors
scope benchmark                # evaluate against SCOPE_TARGETS
scope anchor                  # list registered semantic anchors (Sigillin)
scope map                     # print the semantic cartography (nodes + edges)
scope trace <start> <end>     # trace an explicit path through the map
scope attractors               # rank concepts by attractor strength
scope drift-map <old> <new>   # diff two semantic map snapshots

Semantic cartography

genesis-scope is the translation layer that projects domain knowledge (physics, governance, runtime, agents, entropy, mathematics) onto a navigable topography: explicit nodes (concepts, states, agents, metrics, models), typed edges (influences, generates, stabilizes, contradicts, extends, abstracts), and traceable paths between them.

from genesis_scope import DEFAULT_MAP, compare_maps, compare_perspectives

# An explicit path through the concept space
DEFAULT_MAP.trace("crep", "agent_coordination")
# ["crep", "governance", "diamond", "claim_system", "agent_coordination"]

# Which concepts attract the most meaning?
DEFAULT_MAP.attractors(top_n=3)
# [("genesis_os", 1.65), ("scope", 1.5), ("unified_mandala", 1.4)]

# Drift between two snapshots of the map over time
report = compare_maps(previous_map, current_map)
report.added_nodes, report.reweighted_edges

# Where do different agents' maps of the same space agree or diverge?
compare_perspectives({"claude": claude_map, "gemini": gemini_map})

Development

uv sync --dev
pre-commit install
uv run ruff check .
uv run mypy src
uv run pytest

Falsifiable prediction

Gamma_collab for GenesisAeon sessions is hypothesised to lie in the critical regime [0.2, 0.5] (see benchmark.py / SCOPE_TARGETS). If real session data instead lands outside [0.1, 0.8], the model needs revision.

Role in the GenesisAeon Ecosystem

genesis-scope is Package P39 of the GenesisAeon ecosystem, in the meta-collaboration / semantic cartography domain. It is the human-AI navigation layer: the explicit, executable geometry that tracks collaboration coherence (Gamma_collab), semantic drift, and the navigable concept map shared across the other GenesisAeon packages.

Citation

DOI

DOI will be assigned automatically on first GitHub Release once Zenodo–GitHub integration is enabled for this repo. Until then, cite the existing concept DOI: 10.5281/zenodo.17472834.


GenesisAeon Package 39 · Johann Römer · MOR Research Collective · Mai 2026 Reference: 10.5281/zenodo.17472834

Metadata

Release files for genesis-scope 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for genesis-scope 1.0.0
File Size Uploaded
genesis_scope-1.0.0.tar.gz 95.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for genesis-scope 1.0.0
File Interpreter ABI Platform
genesis_scope-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 121.9 kB

Release files / genesis_scope-1.0.0.tar.gz

Download URL genesis_scope-1.0.0.tar.gz
Size 95.8 kB
Tags Source
SHA-256 checksum
How to use checksums
c2ac58c32dac92460aa0141fb3c58eae0180c3a89da0aa65c8f124096dbbe20d
BLAKE2b-256 checksum
How to use checksums
ebd339031868d46a8cdc30da53ecf29d738dfb0dfac54b5dc84f97b667fca207
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / genesis_scope-1.0.0-py3-none-any.whl

Download URL genesis_scope-1.0.0-py3-none-any.whl
Size 26.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2c5de9de4a78f6c1b3463c4ef96544bcfbaf3df0270b3991641261bf775f59dc
BLAKE2b-256 checksum
How to use checksums
10278668e54b870be72fff725119b766fc717c3b3e232a6e8499925cf152c046
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.17 {"installer":{"name":"uv","version":"0.9.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page