Metadata-Version: 2.5
Name: bhanuj-governance-plugin-api
Version: 1.0.0
Summary: Public, provider-neutral plugin contracts for BHANUJ AI Governance.
Project-URL: Homepage, https://governance.bhanuj.ai
Project-URL: Documentation, https://governance.bhanuj.ai/docs
Project-URL: Repository, https://github.com/Bhanuj-AI/ai-governance-oss
Author: BHANUJ AI
License: Apache-2.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# BHANUJ Governance Plugin API

`bhanuj-governance-plugin-api` is the small, versioned extension contract for
external BHANUJ runtime plugins. It is not the BHANUJ application SDK: it does
not contain a control plane, persistence, workers, settings, RBAC, or provider
implementations.

## Install

```toml
[project]
dependencies = ["bhanuj-governance-plugin-api>=1.0,<2"]

[project.entry-points."bhanuj.governance.plugins"]
my-runtime = "my_runtime.plugin:MyRuntimePlugin"
```

## Boundary

The package supplies lifecycle metadata, the replay-adapter contribution,
bounded replay context, and the governed intervention envelope. The host owns
replay persistence, the canonical workflow execution record, and policy
evaluation. Plugins return `ReplayExecutionResult`; the host materialises its
own execution record.

The package has no dependency on `ai-governance` and must never import Core.
`SPI_VERSION` is currently `"1"`. Plugins declare the major version they
implement with `PluginMetadata(spi_version="1")`; an unsupported major fails
host startup explicitly.
