Metadata-Version: 2.5
Name: reactive-research
Version: 0.2.0
Summary: Tools for reactive research.
Project-URL: Changelog, https://github.com/structural-explainability/reactive-research/blob/main/CHANGELOG.md
Project-URL: Documentation, https://structural-explainability.github.io/reactive-research/
Project-URL: Homepage, https://github.com/structural-explainability/reactive-research
Project-URL: Issues, https://github.com/structural-explainability/reactive-research/issues
Project-URL: Repository, https://github.com/structural-explainability/reactive-research
License-File: LICENSE
Keywords: automation,command-line-tool,python,reactive-research,reproducible-research,research-graphs,research-provenance,software-architecture,structural-explainability,uvx
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# Reactive Research: Tools

<!-- [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.x.svg)](https://zenodo.org/records/x) -->

[![PyPI](https://img.shields.io/pypi/v/reactive-research.svg)](https://pypi.org/project/reactive-research/)
[![Python 3.14](https://img.shields.io/badge/python-3.14%2B-blue?logo=python)](pyproject.toml)
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![CI Status](https://github.com/structural-explainability/reactive-research/actions/workflows/ci-python-zensical.yml/badge.svg)](https://github.com/structural-explainability/reactive-research/actions/workflows/ci-python-zensical.yml)
[![Docs](https://img.shields.io/badge/docs-Zensical-blue)](https://structural-explainability.github.io/reactive-research/)

> Tools for building, validating, resolving, and querying Reactive Research graphs.

`reactive-research` is the reference command-line implementation for
Reactive Research.

Reactive Research represents addressable research objects and their typed
relationships so changes to upstream research can generate explicit downstream
revalidation obligations.

## Quick Start

From the repository:

```powershell
uvx reactive-research --version
uvx reactive-research --help
uvx reactive-research extract
uvx reactive-research extract --format json
```

## Research Annotations

The canonical compact namespace is `RR`.

```text
RR.DEFINES: SE-210.Definition.4.3
RR.IMPLEMENTS: SE-210.Theorem.5.2
```

The expanded namespace is also supported:

```text
REACTIVE-RESEARCH.DEFINES: SE-210.Definition.4.3
REACTIVE-RESEARCH.IMPLEMENTS: SE-210.Theorem.5.2
```

Namespaces and relationship names are case-insensitive.

## Documentation

See the
[Reactive Research documentation](https://structural-explainability.github.io/reactive-research/)
for the model, typed relationships, integration architecture, and command-line API.

## Project Family

Reactive Research currently consists of:

- [reactive-research-spec](https://github.com/structural-explainability/reactive-research-spec) manages the normative model;
- [reactive-research-registry](https://github.com/structural-explainability/reactive-research-registry) manages the resolvable graph and snapshots; and
- [reactive-research](https://github.com/structural-explainability/reactive-research) provides executable tooling.

## Status

The initial implementation is being exercised against an existing
multi-repository research program.

## Annotations

[.annotations/annotations.md](./.annotations/annotations.md)

## Changelog

[CHANGELOG.md](./CHANGELOG.md).

## Citation

Citation metadata is available in [CITATION.cff](./CITATION.cff).

## Documentation

[Documentation](https://structural-explainability.github.io/reactive-research/)

## License

[MIT](./LICENSE)

## Repository Manifest

The repository's role, scope, and dependencies are declared in
[SE_MANIFEST.toml](./SE_MANIFEST.toml).
