desc: Runbookの基本構造例                    # シナリオの説明（必須）

# オプションフィールド
labels:                              # シナリオの分類ラベル
  - api
  - integration

runners:                             # 使用するランナーの定義
  api: https://api.example.com
  db: postgres://user:pass@localhost:5432/testdb

vars:                                # シナリオ全体で使用する変数
  timeout: 30
  user_id: 123

needs:                               # 依存関係の定義
  setup: ./setup.yml

concurrency: 5                       # 並行実行制御

if: env.RUN_TESTS == "true"          # 条件付き実行

loop:                                # ループ設定
  count: 3

# 必須フィールド
steps:                               # 実行するステップ
  - req:
      api:///health:
        get:
    test: current.res.status == 200

desc: ステップの基本構造例
runners:
  api: https://api.example.com
  db: postgres://user:pass@localhost:5432/testdb
  browser: chrome://new
  server: ssh://user@host:22

steps:
  # ステップの基本構造を示す例
  http_request_example:
    desc: HTTPリクエストの例                # ステップの説明（オプション）
    if: env.RUN_HTTP_TEST == "true"        # 条件付き実行（オプション）
    loop: 3                                 # ループ設定（オプション）
    req:                                    # HTTPリクエスト
      api:///users:
        get:
    test: current.res.status == 200         # テストアサーション（オプション）
    dump:                                   # デバッグ出力（オプション）
      status: current.res.status

  db_query_example:
    desc: データベースクエリの例
    db:                                     # データベースクエリ
      db:///:
        query: SELECT COUNT(*) as count FROM users
    test: current.rows[0].count >= 0

  browser_action_example:
    desc: ブラウザ操作の例
    cdp:                                    # ブラウザ操作
      browser:///:
        actions:
          - navigate: https://example.com

  ssh_command_example:
    desc: SSHコマンド実行の例
    ssh:                                    # SSH実行
      server:///:
        command: echo "Hello from SSH"

  local_command_example:
    desc: ローカルコマンド実行の例
    exec:                                   # ローカルコマンド実行
      command: echo "Hello from local"

  include_example:
    desc: 他のシナリオをインクルードする例
    include:                                # 他のシナリオをインクルード
      path: ./another_scenario.yml

runners:
  # HTTPランナー
  api_name: "https://api.example.com"

  # または詳細設定
  api_name:
    type: http
    base_url: "https://api.example.com"
    timeout: 30s
    headers:
      User-Agent: "MyApp/1.0"

  # データベースランナー
  db_name: "postgres://user:pass@host:5432/dbname"

  # gRPCランナー
  grpc_name: "grpc://grpc.example.com:443"

  # CDPランナー
  browser_name: "chrome://new"

  # SSHランナー
  ssh_name: "ssh://user@host:22"

desc: ループ設定の例
runners:
  api: https://api.example.com

steps:
  # 単純な回数指定
  simple_loop:
    loop: 5
    req:
      api:///health:
        get:
    test: current.res.status == 200

  # 詳細設定
  detailed_loop:
    loop:
      count: 10                    # 最大実行回数
      until: current.res.status == 200  # 終了条件（式）
      minInterval: 1              # 最小間隔（秒）
      maxInterval: 10             # 最大間隔（秒）
      jitter: true               # ランダムな間隔を追加
      multiplier: 1.5            # 間隔の倍率
    req:
      api:///unstable-endpoint:
        get:
    test: current.res.status == 200

desc: HTTPリクエスト構造の例
runners:
  api: https://api.example.com

steps:
  # 各種メソッドの例
  get_request:
    req:
      api:///path/to/endpoint:
        get:                         # GETメソッド
          headers:
            Accept: "application/json"
          query:
            param1: "value1"
            param2: "value2"
          timeout: 30s
          followRedirect: true
    test: current.res.status == 200

  post_json:
    req:
      api:///users:
        post:                        # POSTメソッド
          headers:
            Content-Type: "application/json"
          body:
            application/json:        # JSON形式
              name: "Test User"
              email: "test@example.com"
    test: current.res.status == 201

  post_form:
    req:
      api:///form-endpoint:
        post:
          body:
            application/x-www-form-urlencoded:  # フォーム形式
              field1: "value1"
              field2: "value2"
    test: current.res.status == 200

  post_multipart:
    req:
      api:///upload:
        post:
          body:
            multipart/form-data:     # マルチパート形式
              file: "@./test-file.txt"
              description: "Test file upload"
    test: current.res.status == 200

  put_text:
    req:
      api:///documents/1:
        put:                         # PUTメソッド
          body:
            text/plain: |            # プレーンテキスト
              これはテスト用の
              テキストデータです
    test: current.res.status == 200

  delete_request:
    req:
      api:///users/1:
        delete:                      # DELETEメソッド
    test: current.res.status == 204

desc: データベースクエリの構造例
runners:
  test_db: postgres://user:pass@localhost:5432/testdb?sslmode=disable

vars:
  user_id: 1

steps:
  query_example:
    db:
      test_db:///:
        query: |
          SELECT * FROM users
          WHERE id = $1
        params:
          - "{{ vars.user_id }}"
        timeout: 30s
    test: len(current.rows) >= 0

desc: CDP（ブラウザ操作）アクション構造の例
runners:
  browser: chrome://new

steps:
  browser_test:
    cdp:
      browser:///:
        actions:
          - navigate: "https://example.com"
          - waitVisible: "h1"
          - click: "button#submit"
          - type:
              selector: "input#search"
              text: "テスト入力"
          - screenshot: "./screenshot.png"
          - evaluate: "document.title"
    test: |
      current.res.actions[5].result == "Example Domain"