Metadata-Version: 2.4
Name: coreason_manifest
Version: 0.26.1
Summary: This package is the definitive source of truth. If it isn't in the manifest, it doesn't exist. If it violates the manifest, it doesn't run.
Project-URL: Homepage, https://github.com/CoReason-AI/coreason_manifest
Project-URL: Repository, https://github.com/CoReason-AI/coreason_manifest
Project-URL: Documentation, https://github.com/CoReason-AI/coreason_manifest
Author-email: Gowtham A Rao <gowtham.rao@coreason.ai>
License: # The Prosperity Public License 3.0.0
        
        Contributor: CoReason, Inc.
        
        Source Code: https://github.com/CoReason-AI/coreason_manifest
        
        ## Purpose
        
        This license allows you to use and share this software for noncommercial purposes for free and to try this software for commercial purposes for thirty days.
        
        ## Agreement
        
        In order to receive this license, you have to agree to its rules.  Those rules are both obligations under that agreement and conditions to your license.  Don't do anything with this software that triggers a rule you can't or won't follow.
        
        ## Notices
        
        Make sure everyone who gets a copy of any part of this software from you, with or without changes, also gets the text of this license and the contributor and source code lines above.
        
        ## Commercial Trial
        
        Limit your use of this software for commercial purposes to a thirty-day trial period.  If you use this software for work, your company gets one trial period for all personnel, not one trial per person.
        
        ## Contributions Back
        
        Developing feedback, changes, or additions that you contribute back to the contributor on the terms of a standardized public software license such as [the Blue Oak Model License 1.0.0](https://blueoakcouncil.org/license/1.0.0), [the Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0.html), [the MIT license](https://spdx.org/licenses/MIT.html), or [the two-clause BSD license](https://spdx.org/licenses/BSD-2-Clause.html) doesn't count as use for a commercial purpose.
        
        ## Personal Uses
        
        Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, doesn't count as use for a commercial purpose.
        
        ## Noncommercial Organizations
        
        Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution doesn't count as use for a commercial purpose regardless of the source of funding or obligations resulting from the funding.
        
        ## Defense
        
        Don't make any legal claim against anyone accusing this software, with or without changes, alone or with other technology, of infringing any patent.
        
        ## Copyright
        
        The contributor licenses you to do everything with this software that would otherwise infringe their copyright in it.
        
        ## Patent
        
        The contributor licenses you to do everything with this software that would otherwise infringe any patents they can license or become able to license.
        
        ## Reliability
        
        The contributor can't revoke this license.
        
        ## Excuse
        
        You're excused for unknowingly breaking [Notices](#notices) if you take all practical steps to comply within thirty days of learning you broke the rule.
        
        ## No Liability
        
        ***As far as the law allows, this software comes as is, without any warranty or condition, and the contributor won't be liable to anyone for any damages related to this software or this license, under any kind of legal claim.***
License-File: LICENSE
License-File: NOTICE
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.14
Requires-Dist: pydantic>=2.12.5
Description-Content-Type: text/markdown

# CoReason Manifest

> **"This package is the definitive source of truth. If it isn't in the manifest, it doesn't exist. If it violates the manifest, it doesn't run."**

## Overview

**CoReason Manifest** (`coreason_manifest`) is a 2026+ State-of-the-Art Neurosymbolic architecture component acting as the Universal Unified Ontology for the CoReason AI swarm ecosystem.

This is **NOT** a standard human-centric software package. It is a strictly bounded, AI-native, pure structural data library. It maintains the foundational mathematical, causal, and spatial definitions required to orchestrate a decentralized, zero-trust swarm of Large Language Models and mechanistic solvers.

## Core Architectural Directives

Contributors (both human and AI) are strictly bound to the **Shared Kernel Protocol**. Violating these directives will result in immediate rejection by the CI/CD architectural gates.

### 1. Passive by Design (No Execution)

This repository is a completely **Hollow Data Plane**.

* It is distributed exclusively as an inert data library (Wheel).
* Importing any module **MUST NOT** trigger runtime side effects (no network sockets, no file writing, no global loggers, no runtime loops).
* Dependencies are strictly limited to pure data parsers (`pydantic` and `pyyaml`).

### 2. The "God Context" Monolith Directive

We intentionally ignore legacy "Separation of Concerns" (SoC) anti-patterns.

* **NEVER federate or split `src/coreason_manifest/spec/ontology.py`.** * The entire universe of the ecosystem's state, orchestration, memory, and compute lives within this single artifact. This is a mathematical requirement to guarantee deterministic, zero-shot latent alignment across the swarm.

### 3. The Anti-CRUD Mandate & Strict Lexical Architecture

Legacy CRUD terminology flattens softmax distributions and introduces semantic drift.

* **Banned Terms:** `Create`, `Read`, `Update`, `Delete`, `User`, `Data`, `List`.
* **Required Paradigm:** State transitions are mapped using Judea Pearl’s Structural Causal Models (e.g., `Transmutation`, `DefeasibleCascade`, `StateMutationIntent`).
* **Categorical Suffixing:** Every schema ends in a strict topological contract:
* `...Event` / `...Receipt`: Cryptographically frozen historical facts (Append-only).
* `...Intent` / `...Task`: Authorized kinetic execution triggers.
* `...Policy` / `...Contract`: Rigid mathematical boundaries.
* `...State` / `...Manifest`: Ephemeral or declarative N-dimensional coordinates.



### 4. Cryptographic Determinism

All models subclass `CoreasonBaseState`, enforcing `frozen=True` immutability. Arrays and sets are mathematically sorted during instantiation to guarantee deterministic canonical hashing (RFC 8785) across varying distributed environments.

## Repository Structure

```text
coreason_manifest/
├── src/coreason_manifest/
│   ├── spec/
│   │   └── ontology.py       # THE GOD CONTEXT: All Pydantic models, TypeAliases, and Enums.
│   └── utils/
│       └── algebra.py        # Pure algebraic functors, matrix projections, and validation.
├── scripts/
│   ├── evaluate_architecture.py  # CI gate blocking runtime side-effects.
│   ├── semantic_diff.py          # CI gate enforcing backward schema compatibility.
│   └── swarm_watchdog.py         # Semantic scanner for intellectual property bounds.
├── coreason_ontology.schema.json # The compiled JSON Schema used for MCP Discovery.
└── pyproject.toml            # Project definitions and uv dependencies.

```

## Installation

This project requires **Python 3.14+** and uses [`uv`](https://www.google.com/search?q=%5Bhttps://github.com/astral-sh/uv%5D(https://github.com/astral-sh/uv)) as the standard package manager.

```bash
# Clone the repository
git clone https://github.com/CoReason-AI/coreason_manifest.git
cd coreason_manifest

# Install dependencies using uv
uv sync --all-extras --dev

```

## Mandatory Local Verification Workflow

To ensure the Shared Kernel remains mathematically sound, all commits must pass a stringent local evaluation before a Pull Request is opened. The CI/CD pipeline enforces a strict 95% test coverage floor.

**1. Formatting and Linting (Strict Ruff ruleset)**

```bash
uv run ruff format .
uv run ruff check . --fix

```

**2. Strict Type Checking**

```bash
uv run mypy src/ tests/

```

**3. Behavioral and Contract Testing**

```bash
uv run pytest

```

**4. Dependency Auditing**

```bash
uv run deptry src/

```

## License and Copyright

This repository and its entire ontology are the intellectual property of **CoReason, Inc.**

Licensed under the **Prosperity Public License 3.0**.

* **Non-Commercial:** Free for research, experiments, and open-source non-commercial use.
* **Commercial:** Permitted for a strict 30-day trial period.

For full license details, see the `LICENSE` file. For commercial licensing exceptions or inquiries, please explicitly contact `license@coreason.ai` or `gowtham.rao@coreason.ai`.

*(Genesis Commit: Initialized per CoReason Clean Room Protocol PIP-001 on 2026-01-01).*