Metadata-Version: 2.4
Name: vibecheck-hoohacks-post-deadline
Version: 0.1.0
Summary: Competence-aware guardrail scaffold for AI-assisted coding
Author-email: Om Arya <om.arya0577@gmail.com>, Advik Bhatt <advikbwork@gmail.com>, Blaise Dalton <blaisedalton1@gmail.com>, Vishv Joshi <vishvjoshi2001@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/vibecheck-hoohacks/vibecheck
Project-URL: Documentation, https://github.com/vibecheck-hoohacks/vibecheck#readme
Project-URL: Repository, https://github.com/vibecheck-hoohacks/vibecheck
Project-URL: Issues, https://github.com/vibecheck-hoohacks/vibecheck/issues
Keywords: claude,ai,coding,competence,guardrail,llm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: langchain-core>=0.3.79
Requires-Dist: langchain-openrouter>=0.1.0
Requires-Dist: pyyaml>=6.0.3
Provides-Extra: ui
Requires-Dist: gradio>=5.0; extra == "ui"
Provides-Extra: graph
Requires-Dist: networkx>=3.0; extra == "graph"
Dynamic: license-file

# VibeCheck

VibeCheck is a Python-first competence-aware guardrail in the Claude Code mutation path.

## Architecture

The initial project shape follows the MVP spec directly:

- `hooks/` holds Claude-facing hook entrypoints and decision output helpers.
- `core/` holds mutation normalization, context aggregation, gate orchestration, and competence state logic.
- `qa/` holds the blocking QA loop plus terminal and optional Gradio renderer boundaries.
- `state/` holds inspectable persisted artifacts like YAML, Markdown, and JSONL files.
- `tests/` covers the gate, hook, QA loop, and CLI flows.

## Tooling

This repo uses `uv` for Python environment and dependency management.

```bash
uv sync
uv run pytest
uv run ruff check .
uv run ruff format .
uv run pyright
```

## CI

GitHub Actions runs the same core checks on pushes and pull requests to `main`:

- `uv run ruff check .`
- `uv run pyright`
- `uv run pytest`

The workflow lives at `.github/workflows/ci.yml`.

## Notes

- The gate and QA loop are model-backed through OpenRouter.
- Runtime auth resolves `OPENROUTER_API_KEY` first, then falls back to `~/.vibecheck/config.toml`.
- Terminal QA is the day-one path.
- `qa/gradio_renderer.py` is the optional Python web UI seam if richer browser-based QA becomes necessary.
