Metadata-Version: 2.4
Name: fixdoc
Version: 0.0.3
Summary: Capture and search infrastructure fixes for cloud/SRE engineers
Author-email: Fiyi <fiyignk@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/fiyiogunkoya/FixDoc
Keywords: devops,terraform,infrastructure,documentation,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: pyyaml>=6.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"

# FixDoc

A CLI tool for cloud engineers to capture and search infrastructure fixes. Stop losing tribal knowledge in Slack threads and personal notes.

When you hit a Terraform error or Kubernetes failure, pipe it directly into FixDoc. It auto-detects the error source, extracts structured metadata, and prompts you for the resolution. Next time you or a teammate hits the same issue, search your fix history instead of starting from scratch.

```bash
terraform apply 2>&1 | fixdoc capture
fixdoc search "S3"
```

## Features

- **Pipe errors directly** from `terraform apply` or `kubectl` — no copy-pasting
- **Auto-parse errors** from Terraform (AWS, Azure, GCP) and Kubernetes
- **Similar fix suggestions** — shows matching fixes from your history before creating duplicates
- **Search your fix history** by keyword, tag, or error message
- **Watch mode** — wrap any command and auto-capture errors on failure
- **Blast radius analysis** — estimate the impact of Terraform changes before applying
- **Analyze Terraform plans** against your fix history before `apply`
- **CI gating** — fail pipelines when blast radius severity exceeds a threshold
- **Sync with your team** via a shared Git repo
- **Markdown export** — every fix generates a shareable `.md` file

## Installation

```bash
pip install fixdoc
```

Requires Python 3.9+.

## Contributing

```bash
git clone https://github.com/fiyiogunkoya/fixdoc.git
cd fixdoc
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
```

Run tests with `pytest`. Format with `black src/ tests/` and lint with `ruff check src/ tests/`.

## License

MIT
