Metadata-Version: 2.4
Name: stigmem-plugin-tombstones
Version: 0.1.0
Summary: Experimental RTBF tombstone plugin for Stigmem.
Project-URL: Homepage, https://github.com/eidetic-labs/stigmem
Project-URL: Documentation, https://github.com/eidetic-labs/stigmem/tree/main/features/tombstones
Project-URL: Repository, https://github.com/eidetic-labs/stigmem
Project-URL: Issues, https://github.com/eidetic-labs/stigmem/issues
Author-email: Eidetic Labs <oss@eidetic-labs.ai>
License: Apache-2.0
Keywords: memory,plugins,rtbf,stigmem,tombstones
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: pydantic<3,>=2
Requires-Dist: stigmem-node<1.0.0,>=0.9.0a8
Description-Content-Type: text/markdown

# Stigmem Tombstones Plugin

Experimental right-to-be-forgotten tombstones plugin for Stigmem.

This package provides the `stigmem-plugin-tombstones` source package for alpha
validation. It registers through the `stigmem.plugins` entry point group and is
loaded by `stigmem-node` only when explicitly installed and configured by an
operator.

## Status

Tombstones remain experimental. Installing this package does not add tombstone
filtering or propagation to the supported default surface. Default Stigmem
installs keep tombstone behavior disabled unless the plugin is registered and
the operator enables the relevant gates.

The package metadata is publication-shaped for the plugin readiness track, but
registry publication remains on hold until dry-run evidence and maintainer
clearance are recorded. See the feature record under `features/tombstones/` for
the current status, evidence, and security notes.

## Installation

```bash
pip install --pre stigmem-node==0.9.0a8 stigmem-plugin-tombstones==0.1.0
```

## Enable

Set the plugin gate environment variable to opt in:

```bash
export STIGMEM_TOMBSTONES_ENABLED=1
```

The default install is inert; tombstone hook behavior only activates when the
package is installed, discovered through the `stigmem.plugins` entry point, and
the operator enables the gate. Admin routes, federation routes, recall
filtering, and peer propagation remain separately gated.

## Disable

Unset the plugin gate environment variable, or set it to any value other than
`1`, `true`, `yes`, or `on`:

```bash
unset STIGMEM_TOMBSTONES_ENABLED
```

The plugin returns to inert state at the next process start. No data migration
is required; core scope, tenant, audit, and federation enforcement continues to
hold.

## Test

From a Stigmem repository checkout with development dependencies installed:

```bash
uv run pytest node/tests/plugins/test_tombstone_plugin_scaffold.py \
  node/tests/plugins/test_tombstone_plugin_gating.py
```

The package itself ships no separate test tree; upstream plugin validation
lives in `node/tests/plugins/`.

## Uninstall

```bash
pip uninstall stigmem-plugin-tombstones
```

Removing the package is sufficient. The gate environment variable becomes moot
once the entry point is no longer discoverable.

## Project Links

- Repository: <https://github.com/eidetic-labs/stigmem>
- Feature record: <https://github.com/eidetic-labs/stigmem/tree/main/features/tombstones>
- Plugin source: <https://github.com/eidetic-labs/stigmem/tree/main/experimental/tombstones>
- Issue tracker: <https://github.com/eidetic-labs/stigmem/issues>
