Metadata-Version: 2.4
Name: maneuver-calculus
Version: 0.1.0a2
Summary: Maneuver Calculus research alpha: semantic compilation, maintained worlds, and research custody
Author: Jacob Schorr
License-Expression: Apache-2.0
Project-URL: Repository, https://github.com/maneuver-calculus/semantic-compiler
Project-URL: Issues, https://github.com/maneuver-calculus/semantic-compiler/issues
Keywords: maneuver-calculus,ontology,semantic-compiler,research
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: html5rdf==1.2.1
Requires-Dist: owlrl==7.6.2
Requires-Dist: packaging==26.3
Requires-Dist: prettytable==3.18.0
Requires-Dist: pyparsing==3.3.3
Requires-Dist: pyshacl==0.40.1
Requires-Dist: PyYAML==6.0.3
Requires-Dist: rdflib==7.6.0
Requires-Dist: wcwidth==0.9.2
Dynamic: license-file

# Maneuver Calculus

Maneuver Calculus (MC) is a research alpha for semantic compilation, maintained
worlds, and research custody. It includes the existing native compiler,
source-locked ontology compiler, persisted world API, and Research SWSS.

## Install

Use Python 3.12 or newer in a dedicated virtual environment:

```sh
python -m pip install "maneuver-calculus==0.1.0a2"
```

For development, install from a checkout of the
[public source repository](https://github.com/maneuver-calculus/semantic-compiler):

```sh
python -m pip install .
```

The distribution installs all nine pinned dependencies, the complete current
ontology runtime and its 140 source assets, and synthetic Research SWSS fixtures. No
repository clone or `PYTHONPATH` setting is needed. Use `python -X utf8` for the
existing ontology workflows, especially on Windows.

## Existing developer workflows

The import names remain `mc_mvp`, `mc_rules_visibility`, `mc_world`,
`mc_ontology`, `research_swss`, `mc_adapter`, and `mc_practitioner`.
The distribution name is `maneuver-calculus`; there is no new wrapper API.

Run the supplied native demo from any working directory:

```sh
python -I -B -X utf8 -m mc_mvp demo --output ./mc-demo
```

The existing authoring runner admits your Turtle through
`WorldSession.admit_ontology`, saves the snapshot, query, and incident projection,
and replays the persisted result in a fresh process:

```sh
python -I -B -X utf8 -m author_case --source ./my-case.ttl --context urn:my-project:context --at 10 --out ./my-case-run
python -I -B -X utf8 -m author_case --replay ./my-case-run
```

Use a fresh output directory for a new authored case. Optional `--inputs`,
`--requests`, and `--advance-to` retain their existing meanings. Application
integration uses `mc_world.pipeline.WorldSession` and its `admit_ontology`,
`query_ontology`, `project_ontology`, and `advance` methods. Native applications
use `mc_mvp.Compiler` and `mc_mvp.History`.

Research SWSS retains its existing CLI:

```sh
python -I -B -X utf8 -m research_swss --world ./mc-research init
python -I -B -X utf8 -m research_swss --help
```

Its fixture contains invented repositories and a public-literature curator
snapshot. Local initialization and the supplied native demo make no provider
calls. Live model integrations need your own explicit configuration.

Package documentation and examples are installed as resources beside the modules.
Use `importlib.resources.files("mc_ontology")` to locate its `README.md`,
`examples`, and byte-pinned `sources` directory. The same resource API locates
`mc_world/PIPELINE_API.md` and `research_swss/README.md`.

## Research status and identity

`0.1.0a2` versions this Python distribution. It preserves the existing native
`mc-mvp-core/1.0.1` and ontology `mc-ontology-core/0.3.1-public.2` identities.
Current semantic rules and source pins are unchanged. Ontology admission and replay
support `mc-ontology-core/0.3.1-public.2`; the three pre-publication runtimes are
excluded and older identities receive a clear unsupported-version error. Replay
under an older identity requires its corresponding archived package. Packaging
does not confer full MC-SPEC conformance.
The source-governance acceptance gate and the unqualified status of historical
model adapters remain as documented in the source release. Research records and
ontology instance graphs remain separate workflows.

Two known ontology defects remain open:

- Equivalent detector-face identities can cause a declared dependency to be
  ignored and permit unsupported absence-based elimination, including a falsely
  forced explanation.
- An unrelated health computation can introduce another evaluation context and
  suppress valid reconstruction paths; the resulting search is marked incomplete.

Native receipt, typing, key, cache, and observability limitations also remain.
Review the
[known limitations](https://github.com/maneuver-calculus/semantic-compiler/blob/main/KNOWN_LIMITATIONS.md)
before interpreting results. `full_ontology_verified` remains false.

The public repository is a derivative of the reviewed research-alpha candidate.
Repository metadata, documentation, and release automation have changed; current
runtime code and ontology source pins retain their reviewed identities. The
[source identity record](https://github.com/maneuver-calculus/semantic-compiler/blob/main/SOURCE_IDENTITY.md)
distinguishes the original candidate evidence from this repository.

Copyright 2026 Jacob Schorr. Licensed under Apache-2.0; the full `LICENSE` and
`NOTICE` are included. Source and issue tracking are available through the
[project repository](https://github.com/maneuver-calculus/semantic-compiler) and
[issue tracker](https://github.com/maneuver-calculus/semantic-compiler/issues).
