Skip to main content

Semantic coordination system for human-LLM collaboration (GenesisAeon Package 39)

Project description

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 modeldD/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 CREPGamma_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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

genesis_scope-1.0.0.tar.gz (95.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

genesis_scope-1.0.0-py3-none-any.whl (26.1 kB view details)

Uploaded Python 3

File details

Details for the file genesis_scope-1.0.0.tar.gz.

File metadata

  • Download URL: genesis_scope-1.0.0.tar.gz
  • Upload date:
  • Size: 95.8 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for genesis_scope-1.0.0.tar.gz
Algorithm Hash digest
SHA256 c2ac58c32dac92460aa0141fb3c58eae0180c3a89da0aa65c8f124096dbbe20d
MD5 515a08393272fa6d05cff18d5d85a66f
BLAKE2b-256 ebd339031868d46a8cdc30da53ecf29d738dfb0dfac54b5dc84f97b667fca207

See more details on using hashes here.

File details

Details for the file genesis_scope-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: genesis_scope-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 26.1 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for genesis_scope-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2c5de9de4a78f6c1b3463c4ef96544bcfbaf3df0270b3991641261bf775f59dc
MD5 7b6f738e147a34155e999f613343b7cd
BLAKE2b-256 10278668e54b870be72fff725119b766fc717c3b3e232a6e8499925cf152c046

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page