{% extends "docs/base.html" %}

{% block docs_content %}
  <div class="mb-4">
    <h1 class="h3 mb-1">{{ title }}</h1>
    <p class="text-muted mb-0">
      {% if title == "get_pull_protection" %}
        Evaluate pull branch protection and merge-readiness from MCP.
      {% elif title == "get_pull_diff" %}
        Fetch the effective pull diff without manually ordering source and target refs.
      {% elif title == "get_pull_files" %}
        List changed files for a pull without returning full diff content.
      {% elif title == "get_my_pull_review" %}
        Fetch the authenticated user's existing review for a pull.
      {% elif title == "create_pull" %}
        Create a pull request from MCP.
      {% elif title == "update_pull" %}
        Update pull metadata, refs, or visibility from MCP.
      {% elif title == "close_pull" %}
        Close a pull request from MCP.
      {% elif title == "reopen_pull" %}
        Reopen a closed pull request from MCP.
      {% elif title == "merge_pull" %}
        Merge an open pull request after protections pass.
      {% else %}
        Work with pull requests from MCP.
      {% endif %}
    </p>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Parameters</h2>
      <table class="table table-sm mb-0">
        <thead>
          <tr>
            <th>Name</th>
            <th>Type</th>
            <th>Required</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><code>repo</code></td>
            <td>string</td>
            <td>Yes</td>
            <td>Repository path. Format: <code>teams/team_slug/repo_slug</code> or <code>username/repo_slug</code>.</td>
          </tr>
          {% if title == "create_pull" %}
            <tr>
              <td><code>source_repo</code></td>
              <td>string</td>
              <td>No</td>
              <td>Source repository path. Defaults to <code>repo</code>.</td>
            </tr>
            <tr>
              <td><code>source_ref</code></td>
              <td>string</td>
              <td>Yes</td>
              <td>Source branch name.</td>
            </tr>
            <tr>
              <td><code>target_ref</code></td>
              <td>string</td>
              <td>No</td>
              <td>Target branch name. Defaults to the target repo's default branch.</td>
            </tr>
            <tr>
              <td><code>title</code></td>
              <td>string</td>
              <td>Yes</td>
              <td>Pull title.</td>
            </tr>
            <tr>
              <td><code>body</code></td>
              <td>string</td>
              <td>No</td>
              <td>Pull body markdown.</td>
            </tr>
            <tr>
              <td><code>status</code></td>
              <td>string</td>
              <td>No</td>
              <td><code>open</code> or <code>draft</code>. Defaults to <code>open</code>.</td>
            </tr>
            <tr>
              <td><code>visibility</code></td>
              <td>string</td>
              <td>No</td>
              <td><code>public</code> or <code>private</code>. Private repos always create private pulls.</td>
            </tr>
          {% else %}
            <tr>
              <td><code>pull_number</code></td>
              <td>integer</td>
              <td>Yes</td>
              <td>Pull request number within the repo.</td>
            </tr>
            {% if title == "get_pull_diff" or title == "get_pull_files" %}
              <tr>
                <td><code>path</code></td>
                <td>string</td>
                <td>No</td>
                <td>Optional file or directory path filter.</td>
              </tr>
              <tr>
                <td><code>offset</code></td>
                <td>integer</td>
                <td>No</td>
                <td>Number of changed files to skip. Defaults to <code>0</code>.</td>
              </tr>
              <tr>
                <td><code>limit</code></td>
                <td>integer</td>
                <td>No</td>
                <td>Maximum number of changed files to return.</td>
              </tr>
            {% elif title == "update_pull" %}
              <tr>
                <td><code>source_ref</code></td>
                <td>string</td>
                <td>No</td>
                <td>Updated source branch name.</td>
              </tr>
              <tr>
                <td><code>target_ref</code></td>
                <td>string</td>
                <td>No</td>
                <td>Updated target branch name.</td>
              </tr>
              <tr>
                <td><code>title</code></td>
                <td>string</td>
                <td>No</td>
                <td>Updated pull title.</td>
              </tr>
              <tr>
                <td><code>body</code></td>
                <td>string</td>
                <td>No</td>
                <td>Updated pull body markdown.</td>
              </tr>
              <tr>
                <td><code>visibility</code></td>
                <td>string</td>
                <td>No</td>
                <td><code>public</code> or <code>private</code>.</td>
              </tr>
            {% elif title == "merge_pull" %}
              <tr>
                <td><code>expected_target_oid</code></td>
                <td>string</td>
                <td>No</td>
                <td>Optional expected current target commit OID.</td>
              </tr>
              <tr>
                <td><code>expected_source_oid</code></td>
                <td>string</td>
                <td>No</td>
                <td>Optional expected current source commit OID.</td>
              </tr>
              <tr>
                <td><code>message</code></td>
                <td>string</td>
                <td>No</td>
                <td>Optional merge commit message when a merge commit is required.</td>
              </tr>
            {% endif %}
          {% endif %}
        </tbody>
      </table>
    </div>
  </div>

  <div class="card shadow-sm mb-4">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Example</h2>
      <div class="bg-light border rounded p-3">
        <pre class="mb-0"><code>curl -X POST https://pearing.example/api/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "{{ title }}",
      "arguments": {
{% if title == "create_pull" %}        "repo": "teams/acme/webapp",
        "source_ref": "feature/auth",
        "target_ref": "main",
        "title": "Add auth flow"
{% elif title == "update_pull" %}        "repo": "teams/acme/webapp",
        "pull_number": 42,
        "title": "Add auth flow"
{% elif title == "get_pull_diff" or title == "get_pull_files" %}        "repo": "teams/acme/webapp",
        "pull_number": 42,
        "limit": 25
{% elif title == "merge_pull" %}        "repo": "teams/acme/webapp",
        "pull_number": 42,
        "expected_target_oid": "abc123"
{% else %}        "repo": "teams/acme/webapp",
        "pull_number": 42
{% endif %}      }
    }
  }'</code></pre>
      </div>
    </div>
  </div>

  <div class="card shadow-sm">
    <div class="card-body">
      <h2 class="h6 text-uppercase text-muted">Response</h2>
      <p class="mb-0">
        {% if title == "get_pull_diff" %}
          Returns pull metadata, changed file metadata, pagination fields, a diff stat, and unified diff content.
        {% elif title == "get_pull_files" %}
          Returns pull metadata, changed file metadata, pagination fields, and a diff stat without full diff content.
        {% elif title == "get_pull_protection" %}
          Returns pull protection status, merge blocking state, and per-rule checks.
        {% elif title == "get_my_pull_review" %}
          Returns the authenticated user's review object or <code>null</code>.
        {% elif title == "merge_pull" %}
          Returns the merged pull object and merge mode.
        {% else %}
          Returns the created or updated pull object inside the standard MCP tool result.
        {% endif %}
      </p>
    </div>
  </div>
{% endblock %}