hyodo 3.0.1__py3-none-any.whl

hyodo/__init__.py

@@ -0,0 +1,76 @@
+"""HyoDo (孝道) - AI Code Quality Automation
+
+The Way of Devotion: Philosophy-driven code review for AI-assisted development.
+
+Built with the Five Pillars:
+- 眞 (Truth): Technical accuracy
+- 善 (Goodness): Security and stability
+- 美 (Beauty): Code clarity
+- 孝 (Serenity): User experience
+- 永 (Eternity): Long-term maintainability
+"""
+
+__version__ = "3.0.1"
+__author__ = "AFO Kingdom"
+__license__ = "MIT"
+
+# Trinity Score weights
+TRINITY_WEIGHTS = {
+    "truth": 0.35,      # 眞
+    "goodness": 0.35,   # 善
+    "beauty": 0.20,     # 美
+    "serenity": 0.08,   # 孝
+    "eternity": 0.02,   # 永
+}
+
+
+def calculate_trinity_score(
+    truth: float,
+    goodness: float,
+    beauty: float,
+    serenity: float = 1.0,
+    eternity: float = 1.0,
+) -> float:
+    """Calculate Trinity Score from pillar values.
+
+    Args:
+        truth: Technical accuracy score (0-1)
+        goodness: Security/stability score (0-1)
+        beauty: Code clarity score (0-1)
+        serenity: UX score (0-1), default 1.0
+        eternity: Maintainability score (0-1), default 1.0
+
+    Returns:
+        Trinity Score as percentage (0-100)
+    """
+    score = (
+        TRINITY_WEIGHTS["truth"] * truth
+        + TRINITY_WEIGHTS["goodness"] * goodness
+        + TRINITY_WEIGHTS["beauty"] * beauty
+        + TRINITY_WEIGHTS["serenity"] * serenity
+        + TRINITY_WEIGHTS["eternity"] * eternity
+    )
+    return round(score * 100, 2)
+
+
+def should_auto_approve(trinity_score: float, risk_score: float = 0) -> bool:
+    """Determine if changes can be auto-approved.
+
+    Args:
+        trinity_score: Trinity Score (0-100)
+        risk_score: Risk score (0-100), lower is better
+
+    Returns:
+        True if auto-approve eligible (Trinity >= 90, Risk <= 10)
+    """
+    return trinity_score >= 90 and risk_score <= 10
+
+
+__all__ = [
+    "__version__",
+    "__author__",
+    "__license__",
+    "TRINITY_WEIGHTS",
+    "calculate_trinity_score",
+    "should_auto_approve",
+]

hyodo-3.0.1.dist-info/METADATA

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: hyodo
+Version: 3.0.1
+Summary: AI Code Quality Automation - Claude Code Extension
+Project-URL: Homepage, https://github.com/lofibrainwav/HyoDo
+Project-URL: Documentation, https://github.com/lofibrainwav/HyoDo#readme
+Project-URL: Repository, https://github.com/lofibrainwav/HyoDo
+Project-URL: Issues, https://github.com/lofibrainwav/HyoDo/issues
+Author-email: AFO Kingdom <afokingdom@example.com>
+License-Expression: MIT
+License-File: LICENSE
+License-File: LICENSE.md
+Keywords: ai,automation,claude,claude-code,code-quality,llm,trinity-score
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# HyoDo (孝道)
+
+> **Automated Code Review for AI-Assisted Development**
+> Built Where Philosophy Breathes Through Code
+
+<p align="center">
+  <a href="./i18n/ko/README.md">한국어</a> •
+  <a href="./i18n/zh/README.md">中文</a> •
+  <a href="./i18n/ja/README.md">日本語</a>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Works_with-Claude_Code-blueviolet" alt="Claude Code">
+  <img src="https://img.shields.io/badge/Saves-50--70%25_AI_Costs-green" alt="Cost Savings">
+  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
+  <img src="https://img.shields.io/badge/Python-3.10+-blue" alt="Python">
+</p>
+
+---
+
+## What is HyoDo?
+
+HyoDo is a **code quality automation system** designed for AI-assisted development workflows. It integrates with [Claude Code](https://claude.ai/code) to provide:
+
+- **Trinity Score** - 5-pillar philosophy-based code evaluation
+- **Automated Quality Gates** - CI/CD integration with smart routing
+- **Cost-Aware Routing** - Reduce AI API costs by 40-70%
+- **Multi-Agent Collaboration** - Parallel strategist analysis
+
+## The Five Pillars (眞善美孝永)
+
+HyoDo evaluates code through five philosophical pillars:
+
+| Pillar | Weight | Focus |
+|--------|--------|-------|
+| **眞 (Truth)** | 35% | Technical accuracy, type safety, test coverage |
+| **善 (Goodness)** | 35% | Security, stability, error handling |
+| **美 (Beauty)** | 20% | Code clarity, documentation, UX |
+| **孝 (Serenity)** | 8% | Maintainability, low cognitive load |
+| **永 (Eternity)** | 2% | Long-term sustainability |
+
+**Trinity Score Formula:**
+```
+Score = 0.35×眞 + 0.35×善 + 0.20×美 + 0.08×孝 + 0.02×永
+```
+
+## Quick Start
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/lofibrainwav/HyoDo.git
+cd HyoDo
+
+# Install (creates Claude Code skills)
+./install.sh
+```
+
+### Basic Usage
+
+In Claude Code, use these commands:
+
+```bash
+/check          # Run 4-Gate CI quality check
+/score          # Calculate Trinity Score
+/safe           # Security and risk scan
+/trinity        # Full Trinity analysis
+```
+
+### Score Interpretation
+
+| Score | Status | Action |
+|-------|--------|--------|
+| **90+** | Excellent | Auto-approve eligible |
+| **70-89** | Good | Review recommended |
+| **50-69** | Needs Work | Improvements required |
+| **<50** | Critical | Block until fixed |
+
+## Features
+
+### 4-Gate CI Protocol
+
+```
+Gate 1: Pyright (眞 Truth) → Type checking
+Gate 2: Ruff (美 Beauty) → Lint + format
+Gate 3: pytest (善 Goodness) → Test coverage
+Gate 4: SBOM (永 Eternity) → Security seal
+```
+
+### Three Strategists
+
+HyoDo uses three AI strategists for balanced analysis:
+
+- **Jang Yeong-sil (장영실)** - Technical architecture (眞)
+- **Yi Sun-sin (이순신)** - Security & stability (善)
+- **Shin Saimdang (신사임당)** - UX & clarity (美)
+
+### Cost-Aware Routing
+
+Automatically routes tasks to appropriate tiers:
+
+| Tier | Use Case | Cost |
+|------|----------|------|
+| FREE | Read-only, search | $0 |
+| CHEAP | Simple edits | Low |
+| EXPENSIVE | Complex refactors | Standard |
+
+## Project Structure
+
+```
+hyodo/
+├── commands/       # Claude Code slash commands
+├── skills/         # Skill definitions
+├── agents/         # AI agent configurations
+├── scripts/        # Automation scripts
+├── hooks/          # Git hooks
+└── afo_core/       # Core library
+```
+
+## Requirements
+
+- Python 3.10+
+- Claude Code CLI
+- Git
+
+## Configuration
+
+Create `.env` from the example:
+
+```bash
+cp .env.example .env
+```
+
+Key settings:
+- `TRINITY_THRESHOLD=90` - Auto-approve threshold
+- `RISK_THRESHOLD=10` - Max acceptable risk
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+All contributions are evaluated using the Five Pillars. A Trinity Score >= 70 is required for PRs.
+
+## License
+
+MIT License - see [LICENSE](./LICENSE)
+
+## Links
+
+- [Documentation](./docs/)
+- [Roadmap](./ROADMAP.md)
+- [Changelog](./CHANGELOG.md)
+- [Security Policy](./SECURITY.md)
+
+---
+
+<p align="center">
+  <em>"孝道 (HyoDo) - The Way of Devotion"</em><br>
+  Built with the Spirit of King Sejong
+</p>

hyodo-3.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+hyodo/__init__.py,sha256=ZfYJR5jXEATCJf4e3TvF6WyO3dXhyMdRLc1Dmydx_gM,1956
+hyodo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hyodo-3.0.1.dist-info/METADATA,sha256=gjyyuSbs8Fpw_KqHEoIYCE0R9HD4Lu_Ckqil_kXVbto,5461
+hyodo-3.0.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+hyodo-3.0.1.dist-info/licenses/LICENSE,sha256=zYOZ6hE-1WlK_MhGUKGi8VbprFw5QJXCKYVlx0HuIpo,1068
+hyodo-3.0.1.dist-info/licenses/LICENSE.md,sha256=a8DsfBs8Sy5EsYEt6QYPGtqw8TlTEgsa4LNKqPELXNY,1070
+hyodo-3.0.1.dist-info/RECORD,,

hyodo-3.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

hyodo-3.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AFO Kingdom
+
+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.

hyodo-3.0.1.dist-info/licenses/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hyodo Authors
+
+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.