TRUST 5 品質フレームワーク

def calculate_discount(price: float, discount_rate: float) -> float:
    """割引価格を計算します。

    Args:
        price: 元の価格 (0 以上)
        discount_rate: 割引率 (0.0 ~ 1.0)

    Returns:
        割引された価格

    Raises:
        ValueError: 有効でない入力値
    """
    if price < 0:
        raise ValueError("価格は 0 より小さくできません")
    if not 0 <= discount_rate <= 1:
        raise ValueError("割引率は 0.0 から 1.0 の間である必要があります")
    return price * (1 - discount_rate)

# テスト: 正常ケースと例外ケースの両方を検証
def test_calculate_discount_normal():
    assert calculate_discount(10000, 0.1) == 9000
    assert calculate_discount(5000, 0.5) == 2500
    assert calculate_discount(0, 0.5) == 0

def test_calculate_discount_invalid_price():
    with pytest.raises(ValueError, match="価格は 0 より"):
        calculate_discount(-1000, 0.1)

def test_calculate_discount_invalid_rate():
    with pytest.raises(ValueError, match="割引率は"):
        calculate_discount(10000, 1.5)

# 悪い例: 名前だけでは何をするか分かりません
def calc(d, r):
    return d * (1 - r)

# 良い例: 名前を読むだけで役割が分かります
def calculate_discounted_price(original_price: float, discount_rate: float) -> float:
    """元の価格から割引率の分だけ割引された価格を計算します。"""
    return original_price * (1 - discount_rate)

# 統一されたエラー処理パターン
class AppError(Exception):
    """アプリケーションの基本エラー"""
    def __init__(self, message: str, code: int = 500):
        self.message = message
        self.code = code

class NotFoundError(AppError):
    """リソースが見つからない"""
    def __init__(self, resource: str, id: str):
        super().__init__(f"{resource} '{id}' が見つかりません", code=404)

class ValidationError(AppError):
    """入力値の検証失敗"""
    def __init__(self, field: str, reason: str):
        super().__init__(f"'{field}' の検証失敗: {reason}", code=400)

# すべてのサービスで同じパターンを使用
def get_user(user_id: str) -> User:
    user = user_repository.find_by_id(user_id)
    if not user:
        raise NotFoundError("ユーザー", user_id)
    return user

# 悪い例: SQL Injection の脆弱性
def get_user(username: str) -> dict:
    query = f"SELECT * FROM users WHERE username = '{username}'"
    return db.execute(query)

# 良い例: パラメータ化されたクエリで安全に
def get_user(username: str) -> dict:
    query = "SELECT * FROM users WHERE username = %s"
    return db.execute(query, (username,))

# 構造: <タイプ>(<範囲>): <説明>
# 例:

# 新機能の追加
$ git commit -m "feat(auth): JWT ベースのログイン API を追加"

# バグ修正
$ git commit -m "fix(auth): トークン有効期限の計算エラーを修正"

# リファクタリング
$ git commit -m "refactor(auth): 認証ロジックを AuthService に分離"

# セキュリティ改善
$ git commit -m "security(db): パラメータ化されたクエリで SQL Injection を防止"

# 自動修正の実行
> /moai fix

# 完了するまで自動反復修正
> /moai loop

constitution:
  # TRUST 5 品質検証の有効化
  enforce_quality: true

  # 目標テストカバレッジ
  test_coverage_target: 85

  # LSP 品質ゲート設定
  lsp_quality_gates:
    enabled: true

    plan:
      require_baseline: true # Plan 開始時にベースライン取得

    run:
      max_errors: 0 # Run ステップのエラー許容: 0 個
      max_type_errors: 0 # 型エラー許容: 0 個
      max_lint_errors: 0 # リントエラー許容: 0 個
      allow_regression: false # ベースライン比の回帰不可

    sync:
      max_errors: 0 # Sync ステップのエラー許容: 0 個
      max_warnings: 10 # 警告許容: 最大 10 個
      require_clean_lsp: true # LSP クリーン状態が必要

    cache_ttl_seconds: 5 # LSP 診断キャッシュ時間
    timeout_seconds: 3 # LSP 診断タイムアウト

# 1. Plan: SPEC 生成 (LSP ベースライン取得)
> /moai plan "ユーザー検索 API の実装"

# 2. Run: DDD で実装 (TRUST 5 検証)
> /moai run SPEC-SEARCH-001

# 3. Sync: ドキュメント生成および PR (最終 LSP クリーン確認)
> /moai sync SPEC-SEARCH-001