chub-guard-init 1.2.0

One-command setup for chub_guard - the AI SDK deprecation linter

🛡️ chub-guard-init (v1.2)

The Universal Deprecation Guard for modern engineering teams.

📖 The Problem

Modern development moves fast. AI coding assistants often suggest deprecated APIs, and browser automation tools (Selenium, Playwright) change their signatures frequently. Standard linters miss these semantic deprecations, leading to production bugs and technical debt.

🚀 The Solution

chub-guard-init is the official one-command setup for chub-guard. It installs a specialized git-hook that blocks deprecated patterns—from AI SDKs and Automation to Legacy Python—before they ever reach your codebase by syncing with live documentation.

---

🛠 Prerequisites

Ensure your environment is ready:

• Python: 3.8+
• Node.js: >= 18.x (Required for the chub engine)
• Git: Project must be a git repository

---

🏎️ Usage

Option 1: pipx (Recommended)

Run this command once at the root of any project:

pipx run chub-guard-init

Option 2: Standard pip

pip install chub-guard-init
chub-guard-init

Run on demand (Universal Scan)

Run a full project scan at any time to generate a detailed report:

chub-guard-init run-all

This generates a chub_guard_report.md with recommended fixes, trend lines, and Agent-ready prompts.

---

🧠 What does it guard?

• 🤖 AI SDKs: Catches breaking changes in OpenAI, Gemini, Anthropic, Langchain.
• 🌐 Browser Automation: Detects deprecated Selenium (find_element_by_id) and Playwright patterns.
• 🐍 Legacy Code: Identifies Python 2 syntax and legacy urllib2/xrange.
• 🏗️ Framework Smells: Detects architectural misconfigurations (e.g. React/Angular mixing).
• ✨ Dynamic Docs: Automatically flags any pattern marked as "deprecated" in official documentation fetched via Context-Hub.

---

🏁 After Setup

Every time you git commit, the guard will scan your changed files. If it finds a deprecated pattern, it will block the commit and provide a rich terminal guide extracted directly from official docs.

---

⚙️ Configuration

Suppressing False Positives

Append # noqa: CHUB to any line:

import google.generativeai as genai  # noqa: CHUB

Syncing with the Ecosystem

Keep your project in sync with the latest ecosystem rules:

python scripts/chub_guard.py update-registry

---

🤝 Credits

Part of the chub-guard ecosystem, powered by Andrew Ng’s context-hub.

Full Documentation: github.com/rhealaloo45/chub-guard

---

📄 License

MIT © Rhea Laloo