bumfuzzle 1.2.1__tar.gz

bumfuzzle-1.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 arc-com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bumfuzzle-1.2.1/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: bumfuzzle
+Version: 1.2.1
+Summary: Project scaffolding and validation
+Requires-Python: >=3.8
+License-File: LICENSE
+Dynamic: license-file

bumfuzzle-1.2.1/README.md

@@ -0,0 +1,160 @@
+<div align="center">
+
+# 🦝 Bumfuzzle: Starting Point for Every Project
+
+<p align="center">
+    <picture>
+        <img src="./public/bumfuzzle.png" alt="Bumfuzzle" width="500">
+    </picture>
+</p>
+
+<p align="center">
+  <strong>EXFOLIATE! EXFOLIATE!</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/arc-com/bumfuzzle/actions/workflows/ci.yml?branch=main"><img src="https://img.shields.io/github/actions/workflow/status/arc-com/bumfuzzle/ci.yml?branch=main&style=for-the-badge" alt="CI status"></a>
+  <a href="https://github.com/arc-com/bumfuzzle/releases"><img src="https://img.shields.io/github/v/release/arc-com/bumfuzzle?include_prereleases&style=for-the-badge" alt="GitHub release"></a>
+  <a href="https://discord.gg/REPLACE_ME"><img src="https://img.shields.io/badge/-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/arc-com/bumfuzzle?style=for-the-badge" alt="License"></a>
+</p>
+
+<!-- DEMO: replace with asciinema cast or GIF -->
+
+</div>
+
+---
+
+> [!CAUTION]
+> Now you can bash the soul out of your coding agent.
+> And it will never break a rule again.
+
+---
+
+## Summary
+
+- `bumfuzzle` is a single self-contained HTML file served by a lightweight local Python server. It shuts down when you close the tab. Nothing leaves your machine.
+- `bumfuzzle.yml` is the only config file created in your project. One file, all rules.
+- `preflight` only reads, never writes. `kickstart` only creates, never overwrites. They are symmetric: if you declare a file as expected, `kickstart` creates it and `preflight` checks it.
+
+---
+
+## Working with AI coding agents
+
+It works perfectly with **Cursor**, **Claude Code**, **Codex**, and many more.
+
+Models: Opus 4.8, Sonnet 5, Fable 5, GPT 5.5, GLM 5.2, and many more.
+
+When a check fails, preflight prints exactly what broke and how to fix it. The agent reads the hint, resolves the issue, and reruns, in a loop, until the board is clean.
+
+---
+
+## Table of contents
+
+- [Features](#features)
+- [Install](#install)
+- [How to use](#how-to-use)
+- [Roadmap](#roadmap)
+- [Comparison](#comparison)
+- [Contributing](#contributing)
+
+---
+
+## Features
+
+- **Closes the agentic verification loop:** custom instructions tell the model exactly what to do next.
+- **Extremely fast, ridiculously simple, and lightweight:** zero external dependencies.
+- **Works with any language, any OS, any project:** from a personal website to the Linux kernel.
+- **You pick the rules yourself:** linters, hooks, and virtually anything else.
+- **One config to rule them all:** a single `bumfuzzle.yml` stores every configuration.
+- **One entry point for every check:** the `bumfuzzle` command runs it all.
+- **Visual Wizard:** set up every check you want in seconds.
+- **Zero prod footprint:** Bumfuzzle is never included in your build.
+- **Batteries included:** ships with most of the common presets, so you just pick what you need.
+
+---
+
+## Install
+
+```bash
+# Homebrew
+brew tap arc-com/bumfuzzle
+brew install bumfuzzle
+
+# Package managers
+pnpm add -D bumfuzzle
+npm install -D bumfuzzle
+yarn add -D bumfuzzle
+
+pip install bumfuzzle
+uv add --dev bumfuzzle
+poetry add --group dev bumfuzzle
+
+# From source
+git clone https://github.com/arc-com/bumfuzzle ~/.local/share/bumfuzzle
+bash ~/.local/share/bumfuzzle/install-global.sh
+```
+
+Installing from source adds `kickstart`, `bumfuzzle`, and `preflight` to `~/.local/bin`.
+
+---
+
+## How to use
+
+```bash
+cd my-project
+
+# Path A, visual
+bumfuzzle
+# opens web wizard in browser; configure checks, environments, stacks, rules
+# save, writes bumfuzzle.yml to project root
+
+# Path B, fast
+kickstart
+# detects project type from manifests; scaffolds files and dirs; writes bumfuzzle.yml
+# edit bumfuzzle.yml directly, or run bumfuzzle to open the wizard later
+
+# Every subsequent run
+preflight              # run all checks
+preflight --verbose    # show passing checks too
+preflight --env prod   # scope to one environment
+```
+
+`preflight` also runs automatically on every `git commit` via the pre-commit hook installed by `kickstart`.
+
+Manage your rules two ways: run `bumfuzzle` for the visual wizard, or edit `bumfuzzle.yml` directly. `kickstart` is safe to rerun, it never deletes or overwrites. `preflight` is read-only. Both are idempotent.
+
+---
+
+## Roadmap
+
+### Bug fixes
+- [ ] Fix drag-and-drop crash when dropping a rule into an empty group
+
+### Planned improvements
+- [ ] Implement the `kickstart` scaffolding script (auto-detect project type, create config and hooks)
+- [ ] Standardize argument-passing and argument-expectation conventions across shared scripts
+- [ ] Support user-defined arguments in custom `command_checks` scripts
+- [ ] Reduce `bumfuzzle.yml` size by extracting reusable rule sets into importable modules
+
+---
+
+## Comparison
+
+How Bumfuzzle compares to other tools in the AI-agent-guardrail space:
+
+| | Bumfuzzle | [agentlint](https://github.com/mauhpr/agentlint) | [agent-governance-toolkit](https://github.com/microsoft/agent-governance-toolkit) | [drift-guard](https://dev.to/hwaninet/how-i-built-drift-guard-a-cli-to-stop-ai-agents-from-destroying-your-design-3egc) | Plain `pre-commit` |
+|---|---|---|---|---|---|
+| Enforcement point | Git commit (pre-commit hook) | Real-time, tool-call time | Git commit (hook templates) | Git commit / CLI | Git commit |
+| Config format | Single `bumfuzzle.yml` | Rule packs (JS/JSON config) | Docs + hook templates, no single schema | Zero-config | `.pre-commit-config.yaml` + per-hook config |
+| Structural checks (files, dirs, env drift) | ✅ built-in | Partial (code-quality/security focus) | Governance/process focus, not file structure | Design/UI drift only | Only if you write custom hooks |
+| Visual setup wizard | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Zero prod footprint | ✅ (dev dependency only) | ✅ | ✅ (docs/process, not shipped) | ✅ | ✅ |
+
+_Comparisons above reflect public information about these projects as of July 2026 and may not capture every capability. Verify directly with each project before relying on this table._
+
+---
+
+## Contributing
+
+Open an issue: [github.com/arc-com/bumfuzzle/issues](https://github.com/arc-com/bumfuzzle/issues)

bumfuzzle-1.2.1/VERSION

@@ -0,0 +1 @@
+1.2.1

bumfuzzle-1.2.1/__init__.py

@@ -0,0 +1,8 @@
+import os
+import sys
+
+
+def main() -> None:
+    root = os.path.dirname(os.path.abspath(__file__))
+    script = os.path.join(root, "bumfuzzle.sh")
+    os.execvp("bash", ["bash", script, *sys.argv[1:]])