Metadata-Version: 2.4
Name: selfheal-api
Version: 1.0.0rc1
Summary: Watches a FastAPI app's telemetry, decides when an error is safe to fix, and drives a ticket-based, human-approved fix flow.
Author: Ruchir Adnaik
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/ruchiradnaik/self-maintaining-apis
Project-URL: Repository, https://github.com/ruchiradnaik/self-maintaining-apis
Project-URL: Issues, https://github.com/ruchiradnaik/self-maintaining-apis/issues
Project-URL: Changelog, https://github.com/ruchiradnaik/self-maintaining-apis/blob/main/CHANGELOG.md
Keywords: fastapi,observability,opentelemetry,self-healing,github-actions,llm
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: fastapi>=0.142
Requires-Dist: uvicorn>=0.54
Requires-Dist: httpx>=0.28
Requires-Dist: PyYAML>=6.0
Requires-Dist: jevbrief==0.10.0
Requires-Dist: opentelemetry-api>=1.45
Requires-Dist: opentelemetry-sdk>=1.45
Requires-Dist: opentelemetry-semantic-conventions>=0.66b0
Dynamic: license-file

# selfheal

Watches a FastAPI app's telemetry, decides when an error is safe to fix, and drives a ticket-based fix flow
(issue -> implement with a fix intent and server-side scope limits -> guardrails, retried on failure -> blind reviewer -> draft PR
-> human merge, with `/revise` to steer). Decisions and guardrails are plain code; the draft PR is the only human step (review, optionally `/revise`, merge).

The project overview, architecture diagram, the three outcomes (auto-fix, escalation, recommendation), the safety model and the
quickstart are in the repository's top-level [`README.md`](../README.md); this file is the package README.

```bash
pip install -e .   # from this directory (SETUP.md installs it this way)
selfheal init      # in your FastAPI repo: writes selfheal.yml and the three workflows, prints the secrets to add
selfheal doctor    # checks config, workflows, secrets, the evidence API and the required guard check
selfheal serve     # the pipeline service (watcher + API + UI)
selfheal guard     # the guardrail checks (also run by the workflow on selfheal/* branches)
```

See [`SETUP.md`](SETUP.md) to set it up, [`IMPLEMENTATION.md`](IMPLEMENTATION.md) for how it works,
[`FINDINGS_V1.md`](FINDINGS_V1.md) for what the first real run found, and [`../DEMO.md`](../DEMO.md) to run the demo.
