Ranex Framework

🚀 Ranex Community Edition

Python用のAIネイティブなガバナンスフレームワーク

AIによって生成されたコードを本番環境で使用できるようにします。

✨ 主な機能

✅ 20の機能が含まれています

🚀 クイックスタート

インストール

# インストーラーを実行する（仮想環境を作成する）
./install.sh

# 仮想環境をアクティブにする
source .venv/bin/activate

または手動で:

python3 -m venv .venv
source .venv/bin/activate
pip install ranex_core-0.0.1-cp312-cp312-manylinux_2_28_x86_64.whl

プロジェクトの初期化

cd your-project
ranex init
ranex scan

コードでの使用

from ranex import Contract

@Contract(feature="orders")
async def process_order(order_data, *, _ctx=None):
    """
    ステートマシンによる強制: Pending → Confirmed → Processing → Shipped → Delivered
    """
    _ctx.transition("Confirmed")
    # ... あなたのビジネスロジック
    return {"status": "confirmed"}

📦 このパッケージに含まれるもの

community-edition/
├── ranex_core-*.whl          # Rustコア + Pythonパッケージ (PyO3)
├── ranex_mcp                 # MCPサーバーバイナリ (21MB)
├── ranex-cli                 # CLIバイナリ (4MB)
├── ranex/                    # Pythonソース (ホイールにバンドルされている)
│   ├── __init__.py          # @Contractデコレータ
│   ├── cli.py               # CLIコマンド
│   ├── errors.py            # エラータイプ
│   ├── logging.py           # ロギングユーティリティ
│   ├── simulation.py        # ホロデッキシミュレーション
│   └── templates.py         # プロジェクトテンプレート
├── docs/                    # ドキュメント (20のガイド)
├── mcp_config.json          # MCP設定テンプレート
├── MCP_SETUP.md             # MCPセットアップガイド
├── README.md                # このファイル
├── QUICK_START.md           # 5分で始めるガイド
├── install.sh               # 簡単なインストーラー (仮想環境を作成する)
└── LICENSE                  # MITライセンス

🔧 コミュニティエディションの機能

1. ステートマシン検証

AIがビジネスロジックのステップをスキップするのを防ぎます:

# app/features/orders/state.yaml
feature: orders
initial_state: Pending

states:
  Pending: { description: "New order" }
  Confirmed: { description: "Order confirmed" }
  Processing: { description: "Being prepared" }
  Shipped: { description: "In transit" }
  Delivered: { description: "Completed", terminal: true }
  Cancelled: { description: "Cancelled", terminal: true }

transitions:
  - { from: Pending, to: Confirmed }
  - { from: Pending, to: Cancelled }
  - { from: Confirmed, to: Processing }
  - { from: Processing, to: Shipped }
  - { from: Shipped, to: Delivered }

AIがルールに違反した場合の挙動:

StateTransitionError: [orders] 🛑 ILLEGAL STATE TRANSITION
  Current State: Pending
  Attempted: Pending → Delivered
  Allowed: Pending → [Confirmed, Cancelled]

2. セキュリティスキャン (7パターン)

ranex scan

検出対象:

• SQLインジェクション
• コマンドインジェクション (os.system)
• ハードコードされたシークレット
• 弱い暗号化 (MD5, SHA1)
• 不安全な逆シリアル化 (pickle)
• パストラバーサル
• 不安全な乱数生成

3. インポート検証 (タイポスクワッティング)

from ranex_core import ImportValidator

validator = ImportValidator()
result = validator.check_package("reqests")  # タイポスクワッティングを検出！

4. CLIコマンド

ranex init          # プロジェクトを初期化する
ranex scan          # セキュリティ + アーキテクチャスキャン
ranex arch          # アーキテクチャ検証
ranex fix           # 自動修正
ranex doctor        # ヘルスチェック
ranex task          # ワークフロー管理 (ステータス/設計/構築)
ranex context       # AIアライメントプロンプトを生成する
ranex verify        # ホロデッキシミュレーションテスト
ranex db            # データベースユーティリティ
ranex graph         # Mermaid図を生成する
ranex bench         # パフォーマンスベンチマーク
ranex stress        # ストレステスト
ranex update-rules  # AIガバナンスルールを更新する

5. MCPサーバー (AI統合)

ranex_mcpバイナリは、AIアシスタント用の10個のツールを提供します:

# MCPサーバーをインストールする
cp ranex_mcp /usr/local/bin/

# Cursorに追加する (.cursor/mcp.json)
{
  "mcpServers": {
    "ranex": {
      "command": "/usr/local/bin/ranex_mcp"
    }
  }
}

コミュニティエディションのMCPツール:

• validate_file_structure - アーキテクチャ検証
• validate_transition - ステートマシンチェック
• check_import - タイポスクワッティング検出
• security_scan - SAST (7パターン)
• detect_antipattern - コードスメル (5パターン)
• list_db_aliases - データベース設定
• validate_sql - SQL検証
• validate_intent - 曖昧さ検出
• check_function_exists - セマンティック検索 (TF-IDF)
• get_active_persona - ペルソナを表示する

完全なセットアップガイドはMCP_SETUP.mdを参照してください。

⬆️ チームエディションにアップグレード

もっと機能が必要ですか？チームエディションには以下の機能が含まれています:

お問い合わせ: sales@ranex.dev

📄 ライセンス

MITライセンス - 個人および商用プロジェクトで自由に使用できます。

🆘 サポート

• ドキュメント: ranex.dev/docs
• 問題報告: GitHub Issues

Ranex v0.0.1 Community Edition © 2025 Ranex Project