Metadata-Version: 2.5
Name: vf-hive-author
Version: 0.8.0
Summary: Write-only MCP server: file OKF memory/correction issues (keeps hive-serve keyless)
Project-URL: Homepage, https://github.com/voyagerforge-dev/hive-intelligence
Project-URL: Documentation, https://github.com/voyagerforge-dev/hive-intelligence/blob/main/docs/reference/hive-author.md
Project-URL: Source, https://github.com/voyagerforge-dev/hive-intelligence
Project-URL: Issues, https://github.com/voyagerforge-dev/hive-intelligence/issues
Project-URL: Release notes, https://github.com/voyagerforge-dev/hive-intelligence/releases
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Requires-Python: >=3.12
Requires-Dist: fastapi>=0.135
Requires-Dist: httpx>=0.27
Requires-Dist: mcp==1.28.1
Requires-Dist: prometheus-client>=0.20
Requires-Dist: pydantic-settings>=2.5
Requires-Dist: pydantic>=2.9
Requires-Dist: uvicorn>=0.30
Provides-Extra: dev
Requires-Dist: pytest>=8.3; extra == 'dev'
Requires-Dist: ruff>=0.7; extra == 'dev'
Requires-Dist: vf-hive-gen; extra == 'dev'
Description-Content-Type: text/markdown

# hive-author

The write door. Files corrections and memory promotions as reviewable issues, so `hive-serve` holds no credential that can change the corpus.

[![PyPI](https://img.shields.io/pypi/v/vf-hive-author.svg)](https://pypi.org/project/vf-hive-author/)
[![Licence: Apache 2.0](https://img.shields.io/badge/licence-Apache--2.0-blue.svg)](https://github.com/voyagerforge-dev/hive-intelligence/blob/main/LICENSE)

Part of [Hive Intelligence](https://github.com/voyagerforge-dev/hive-intelligence), which turns a body of documentation into
reviewed, git-versioned concept cards and serves them to any MCP or REST client - no vector
index, no embeddings, and no model call at serving time.

**Full documentation: [docs/reference/hive-author.md](https://github.com/voyagerforge-dev/hive-intelligence/blob/main/docs/reference/hive-author.md)**, which covers the command
surface, configuration, behaviour and the things that catch people out.

## Install

```bash
pip install vf-hive-author
```

It is a **service**, not a library: nothing imports it. A deployment installs it at the same
version as the rest of the engine and runs the `hiveauthor` console script it puts on the path.
The container image built by `tooling/hive-author/deploy/Dockerfile` still installs from a
checkout instead, and stays that way until the deployment switches to the pin. See
[distributing the engine](https://github.com/voyagerforge-dev/hive-intelligence/blob/main/docs/architecture/engine-distribution.md).

## From source

```bash
cd tooling/hive-author
uv sync --extra dev     # install
uv run pytest -q        # test
uv run hiveauthor
```

This file is deliberately short. Everything else lives in the reference doc, so there is one
place to keep current rather than two that drift apart.
