#!/bin/bash
set -euo pipefail

printf '%s\n' '=== Commit and current head ==='
git rev-parse --short HEAD
git show --no-patch --format='commit=%H%nparents=%P%nsubject=%s' 22ac8685

printf '%s\n' '=== Changed files ==='
git diff-tree --no-commit-id --name-only -r 22ac8685

printf '%s\n' '=== Focused structural outline ==='
ast-grep outline src/server/responses/core.ts --items all --type function --match 'invalidateSameTargetRequest|handleResponses' --view expanded || true
ast-grep outline src/config.ts --items all --type function,variable --match 'sanitize|retryOn429|loadConfig' --view expanded || true
ast-grep outline src/server/auth-cors.ts --items all --type function --match 'providerManagementConfigError' --view expanded || true

printf '%s\n' '=== Token invalidation and narrowed request bindings ==='
rg -n -C 8 'invalidateSameTargetRequest|transportToken\s*\+=|builtInitialRequest|builtContinuationRequest|initialRequest|continuationRequest' \
  src/server/responses/core.ts

printf '%s\n' '=== Sanitizer and management redaction ==='
rg -n -C 12 'retryOn429|redactSecretString|providerManagementConfigError' \
  src/config.ts src/server/auth-cors.ts

printf '%s\n' '=== Relevant regression tests ==='
rg -n -C 10 'invalid.*retryOn429|intentionally empty|intentional.*empty|sk-super-secret-9876|redact|transportToken|buildRequest' \
  tests/config-user-edits.test.ts tests/management-provider-validation.test.ts tests/abort-race.test.ts \
  2>/dev/null || true

printf '%s\n' '=== Exact patch ==='
git show --format= --unified=45 22ac8685 -- \
  src/server/responses/core.ts \
  src/config.ts \
  src/server/auth-cors.ts \
  tests/config-user-edits.test.ts \
  tests/management-provider-validation.test.ts

#!/bin/bash
set -euo pipefail

printf '%s\n' '=== Commit metadata ==='
git show --no-patch --format='commit=%H%nparents=%P%nsubject=%s' 7a07a2fe

printf '%s\n' '=== Changed files ==='
git diff-tree --no-commit-id --name-status -r 7a07a2fe

printf '%s\n' '=== Exact patch ==='
git show --format= --unified=25 7a07a2fe -- \
  src/server/responses/core.ts \
  gui/src/pages/Logs.tsx

printf '%s\n' '=== Affected declaration contexts ==='
rg -n -C 12 \
  'invalidateSameTargetRequest|RECOVERY_KIND_KEYS|recoveryKindKey' \
  src/server/responses/core.ts \
  gui/src/pages/Logs.tsx

#!/bin/bash
set -euo pipefail

printf '%s\n' '=== Current commit and docstring-related changed files ==='
git rev-parse --short HEAD
git diff --name-only "$(git merge-base HEAD upstream/dev 2>/dev/null || git merge-base HEAD origin/dev 2>/dev/null || true)" HEAD \
  | rg '\.(ts|tsx|js|jsx|mjs|cjs)$' || true

printf '%s\n' '=== Locate coverage configuration and references ==='
fd -HI -t f . \
  | rg -i 'docstring|coverage|workflow|action|biome|eslint|package\.json|readme' \
  | head -300

rg -n -i -C 4 'docstring.{0,30}coverage|coverage.{0,30}docstring|jsdoc|tsdoc' \
  .github package.json pnpm-workspace.yaml turbo.json . 2>/dev/null \
  -g '!node_modules/**' -g '!dist/**' -g '!build/**' \
  | head -800 || true

printf '%s\n' '=== Declarations in diff-touched TypeScript and TSX files ==='
base="$(git merge-base HEAD upstream/dev 2>/dev/null || git merge-base HEAD origin/dev 2>/dev/null)"
git diff --name-only "$base" HEAD | rg '\.(ts|tsx)$' | while IFS= read -r file; do
  printf '\n--- %s ---\n' "$file"
  ast-grep outline "$file" --items all --type function,class,interface,type,variable,method --view expanded 2>/dev/null || true
done

#!/bin/bash
set -euo pipefail

repo="lidge-jun/opencodex"
pr="865"

printf '%s\n' '=== PR revisions and changed files ==='
gh pr view "$pr" --repo "$repo" --json baseRefOid,headRefOid,baseRefName,headRefName,commits,files \
  --jq '{baseRefName, headRefName, baseRefOid, headRefOid, commits: [.commits[] | {oid: .oid, messageHeadline: .messageHeadline}], files: [.files[].path]}'

printf '%s\n' '=== PR checks ==='
gh pr checks "$pr" --repo "$repo" --json name,state,link,workflow,bucket 2>/dev/null || true

printf '%s\n' '=== Relevant package scripts ==='
node -e '
const p = require("./package.json");
for (const [name, cmd] of Object.entries(p.scripts ?? {})) {
  if (/doc|string|cover|check|lint/i.test(name + " " + cmd)) console.log(`${name}: ${cmd}`);
}
'

printf '%s\n' '=== Workflow command references ==='
rg -n -i -C 5 'docstring|jsdoc|tsdoc|coverage' .github/workflows package.json gui/package.json \
  -g '*.yml' -g '*.yaml' -g 'package.json' || true

printf '%s\n' '=== Candidate checker/configuration files ==='
fd -HI -t f . \
  -E node_modules -E dist -E build \
  | rg -i 'doc|string|cover|quality|check|audit' \
  | head -500

#!/bin/bash
set -euo pipefail

base="6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head="7a07a2fe8e1a53c9767968cae20470ffea574624"

printf '%s\n' '=== Base availability and TypeScript files changed by this PR ==='
git cat-file -e "${base}^{commit}"
git diff --name-only "$base" "$head" -- \
  'src/**/*.ts' 'gui/src/**/*.ts' 'gui/src/**/*.tsx' \
  | sort

printf '%s\n' '=== Added and modified declaration hunks ==='
git diff --unified=0 "$base" "$head" -- \
  'src/**/*.ts' 'gui/src/**/*.ts' 'gui/src/**/*.tsx' \
  | rg -n -C 2 '^\+.*\b(export\s+)?(async\s+)?function\b|^\+.*\b(class|interface|type)\b|^\+.*\b(const|let)\s+[A-Za-z_$][A-Za-z0-9_$]*\s*=|^\+.*\b[A-Za-z_$][A-Za-z0-9_$]*\s*\([^;{}]*\)\s*\{' \
  || true

printf '%s\n' '=== Current outlines for changed production and GUI files ==='
git diff --name-only "$base" "$head" -- \
  'src/**/*.ts' 'gui/src/**/*.ts' 'gui/src/**/*.tsx' \
  | while IFS= read -r file; do
      printf '\n--- %s ---\n' "$file"
      ast-grep outline "$file" --items all --view expanded 2>/dev/null || true
    done

printf '%s\n' '=== Diff sections with immediate source context ==='
git diff --unified=8 "$base" "$head" -- \
  src/config.ts src/images/loop.ts src/lib/upstream-retry.ts \
  src/providers/derive.ts src/providers/key-failover.ts src/providers/xai-transport.ts \
  src/server/auth-cors.ts src/server/responses/core.ts src/types.ts src/usage/log.ts \
  src/web-search/loop.ts gui/src/pages/Logs.tsx \
  | sed -n '1,2600p'

#!/bin/bash
set -euo pipefail

base="6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head="7a07a2fe8e1a53c9767968cae20470ffea574624"

python3 - <<'PY'
import re
import subprocess
from pathlib import Path

base = "6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head = "7a07a2fe8e1a53c9767968cae20470ffea574624"

files = subprocess.check_output(
    ["git", "diff", "--name-only", base, head],
    text=True,
).splitlines()
files = [f for f in files if re.search(r"\.(?:ts|tsx)$", f)]

# Obtain exact added-line ranges from zero-context hunks.
ranges = {}
for f in files:
    diff = subprocess.check_output(
        ["git", "diff", "--unified=0", base, head, "--", f],
        text=True,
    )
    for m in re.finditer(r"^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@", diff, re.M):
        start = int(m.group(1))
        count = int(m.group(2) or "1")
        if count:
            ranges.setdefault(f, []).append((start, start + count - 1))

# Match declaration lines that are added directly in this PR.
patterns = [
    re.compile(r"^\s*(?:export\s+)?(?:declare\s+)?(?:abstract\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)\b"),
    re.compile(r"^\s*(?:export\s+)?(?:default\s+)?(?:abstract\s+)?(class|interface|type|enum|namespace)\s+([A-Za-z_$][\w$]*)\b"),
    re.compile(r"^\s*(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*(?::[^=]+)?="),
    re.compile(r"^\s*(?:export\s+)?(?:async\s+)?function\*\s+([A-Za-z_$][\w$]*)\b"),
]

def is_added(f, line):
    return any(a <= line <= b for a, b in ranges.get(f, []))

def attached_doc(lines, n):
    # Skip blank lines directly before the declaration. A JSDoc block must then end on the
    # prior non-blank line and use /** rather than ordinary // comments.
    i = n - 2
    while i >= 0 and not lines[i].strip():
        i -= 1
    if i < 0 or not lines[i].rstrip().endswith("*/"):
        return False, ""
    end = i
    while i >= 0 and "/**" not in lines[i]:
        i -= 1
    if i < 0:
        return False, ""
    return True, " ".join(x.strip(" \t/*") for x in lines[i:end + 1]).strip()

print("=== Added declaration candidates and attached JSDoc status ===")
count = 0
for f in files:
    path = Path(f)
    if not path.exists():
        continue
    lines = path.read_text(encoding="utf-8").splitlines()
    for idx, line in enumerate(lines, 1):
        if not is_added(f, idx):
            continue
        name = None
        for pat in patterns:
            m = pat.match(line)
            if m:
                name = m.group(m.lastindex)
                break
        if not name:
            continue
        has_doc, doc = attached_doc(lines, idx)
        count += 1
        print(f"{f}:Line {idx}: {name}: {'JSDOC' if has_doc else 'MISSING'}")
        if doc:
            print(f"  {doc[:300]}")
print(f"=== Added declaration candidates: {count} ===")

print("\n=== Existing exported declarations whose bodies or members changed ===")
# For each changed file, show current exported symbols with line ranges. This captures
# declarations changed internally, not only headers added by the PR.
for f in files:
    print(f"\n--- {f} ---")
    subprocess.run(
        ["ast-grep", "outline", f, "--items", "all", "--view", "expanded"],
        check=False,
    )
PY

printf '%s\n' '=== Direct source context for likely undocumented diff declarations ==='
rg -n -C 5 \
  '^(export )?(const (en|de|ja|ko|ru|zh|DEFAULT_RATE_LIMIT_RETRY)|type AttemptRecoveryKind|interface (ImageBridgeDeps|WebSearchLoopDeps)|function providerManagementConfigError)' \
  gui/src/i18n/en.ts gui/src/i18n/de.ts gui/src/i18n/ja.ts gui/src/i18n/ko.ts gui/src/i18n/ru.ts gui/src/i18n/zh.ts \
  gui/src/pages/Logs.tsx src/images/loop.ts src/web-search/loop.ts src/providers/key-failover.ts src/server/auth-cors.ts src/usage/log.ts

#!/bin/bash
set -euo pipefail

printf '%s\n' '=== Commit and current head ==='
git rev-parse --short HEAD
git show --no-patch --format='commit=%H%nsubject=%s' 2bd814db
git diff-tree --no-commit-id --name-status -r 2bd814db

printf '%s\n' '=== Exact patch ==='
git show --format= --unified=12 2bd814db -- \
  gui/src/i18n/en.ts gui/src/i18n/de.ts gui/src/i18n/ja.ts \
  gui/src/i18n/ko.ts gui/src/i18n/ru.ts gui/src/i18n/zh.ts \
  gui/src/pages/Logs.tsx src/config.ts src/images/loop.ts \
  src/providers/key-failover.ts src/server/auth-cors.ts src/usage/log.ts \
  src/web-search/loop.ts

printf '%s\n' '=== Required declaration contexts ==='
rg -n -C 6 \
  'export const (en|de|ja|ko|ru|zh)\b|type AttemptRecoveryKind\b|const providerConfigSchema\b|interface ImageBridgeDeps\b|const DEFAULT_RATE_LIMIT_RETRY\b|function providerManagementConfigError\b|interface WebSearchLoopDeps\b' \
  gui/src/i18n/en.ts gui/src/i18n/de.ts gui/src/i18n/ja.ts \
  gui/src/i18n/ko.ts gui/src/i18n/ru.ts gui/src/i18n/zh.ts \
  gui/src/pages/Logs.tsx src/config.ts src/images/loop.ts \
  src/providers/key-failover.ts src/server/auth-cors.ts src/usage/log.ts \
  src/web-search/loop.ts

#!/bin/bash
set -euo pipefail

printf '%s\n' '=== Commit and changed files ==='
git rev-parse --short HEAD
git show --no-patch --format='commit=%H%nparents=%P%nsubject=%s' d2db4295
git diff-tree --no-commit-id --name-status -r d2db4295

printf '%s\n' '=== Focused changed-file outlines ==='
for file in \
  src/server/responses/core.ts \
  src/config.ts \
  gui/src/pages/Logs.tsx \
  gui/src/i18n/ko.ts \
  docs-site/src/content/docs/ja/reference/configuration/providers.md \
  docs-site/src/content/docs/ja/guides/providers.md \
  docs-site/src/content/docs/ko/guides/providers.md \
  docs-site/src/content/docs/ru/guides/providers.md \
  docs-site/src/content/docs/zh-cn/guides/providers.md \
  devlog/_plan/260802_429_same_target_retry/010_design.md
do
  if [ -f "$file" ]; then
    printf '\n--- %s ---\n' "$file"
    ast-grep outline "$file" --items all --view expanded 2>/dev/null || true
  fi
done

printf '%s\n' '=== Exact relevant patch ==='
git show --format= --unified=25 d2db4295 -- \
  src/server/responses/core.ts src/config.ts gui/src/pages/Logs.tsx gui/src/i18n/ko.ts \
  docs-site/src/content/docs/ja/reference/configuration/providers.md \
  docs-site/src/content/docs/ja/guides/providers.md \
  docs-site/src/content/docs/ko/guides/providers.md \
  docs-site/src/content/docs/ru/guides/providers.md \
  docs-site/src/content/docs/zh-cn/guides/providers.md \
  devlog/_plan/260802_429_same_target_retry/010_design.md \
  tests

printf '%s\n' '=== Implementation and test references ==='
rg -n -C 8 \
  'imageTierBias|fetchContinuation|replayKind|recoveryKindKey|recovery\.unknown|sanitizeRetryOn429ForLoad|configDiagnosticsFromRaw|runTurn|Cursor|^\|?[\s:-]+\|' \
  src/server/responses/core.ts src/config.ts gui/src/pages/Logs.tsx gui/src/i18n \
  tests devlog/_plan/260802_429_same_target_retry/010_design.md \
  docs-site/src/content/docs/ja docs-site/src/content/docs/ko \
  docs-site/src/content/docs/ru docs-site/src/content/docs/zh-cn \
  2>/dev/null || true

#!/bin/bash
set -euo pipefail

printf '%s\n' '=== Commit metadata and exact changed paths ==='
git show --no-patch --format='commit=%H%nsubject=%s' d2db4295
git diff-tree --no-commit-id --name-only -r d2db4295

printf '%s\n' '=== d2db4295 patch only ==='
git show --format= --unified=18 d2db4295

printf '%s\n' '=== Terminal continuation state and replay label ==='
rg -n -C 12 \
  '\bimageTierBias\b|\brateLimitPolicy\b|\brateLimitRetries\b|\breplayKind\b|function fetchContinuation|const fetchContinuation' \
  src/server/responses/core.ts

printf '%s\n' '=== Retry-policy diagnostic sanitization ==='
rg -n -C 12 \
  'function sanitizeRetryOn429ForLoad|const sanitizeRetryOn429ForLoad|function configDiagnosticsFromRaw|const configDiagnosticsFromRaw|safeParse|providerConfigSchema' \
  src/config.ts

printf '%s\n' '=== Recovery-kind fallback and locale keys ==='
rg -n -C 6 \
  'RECOVERY_KIND_KEYS|function recoveryKindKey|const recoveryKindKey|recovery\.unknown|rate-limit-429|요청 한도 초과' \
  gui/src/pages/Logs.tsx gui/src/i18n/en.ts gui/src/i18n/de.ts gui/src/i18n/ja.ts \
  gui/src/i18n/ko.ts gui/src/i18n/ru.ts gui/src/i18n/zh.ts

printf '%s\n' '=== Documentation changes ==='
rg -n -C 5 \
  'runTurn|HTTP adapters|Cursor|Copilot|mixed-wire|retry' \
  devlog/_plan/260802_429_same_target_retry/010_design.md \
  docs-site/src/content/docs/ja/guides/providers.md \
  docs-site/src/content/docs/ko/guides/providers.md \
  docs-site/src/content/docs/ru/guides/providers.md \
  docs-site/src/content/docs/zh-cn/guides/providers.md \
  2>/dev/null || true

printf '%s\n' '=== Markdown table delimiter rows ==='
rg -n '^\|?[-:| ]+\|[-:| ]+\|?$' \
  docs-site/src/content/docs/ja/reference/configuration/providers.md \
  docs-site/src/content/docs/ja/guides/providers.md \
  2>/dev/null || true

printf '%s\n' '=== Relevant regression tests in d2db4295 ==='
git show --format= --name-only d2db4295 -- tests | sed '/^$/d'
git show --format= --unified=20 d2db4295 -- tests

#!/bin/bash
set -euo pipefail

repo="lidge-jun/opencodex"
pr="865"

printf '%s\n' '=== PR revision ==='
gh pr view "$pr" --repo "$repo" \
  --json baseRefName,baseRefOid,headRefName,headRefOid \
  --jq '{baseRefName,baseRefOid,headRefName,headRefOid}'

printf '%s\n' '=== Current checkout and reported commit ==='
git rev-parse HEAD
git show --no-patch --format='commit=%H%nparents=%P%nsubject=%s' 6c7ea9f7

printf '%s\n' '=== PR check metadata ==='
gh pr checks "$pr" --repo "$repo" --json name,state,link,workflow,bucket \
  | jq '.[] | select((.name + " " + (.workflow // "")) | test("docstring"; "i"))' || true

printf '%s\n' '=== Candidate checker and workflow files ==='
fd -HI -t f . -E node_modules -E dist -E build \
  | rg -i '(^|/)(docstring|jsdoc|tsdoc|.*coverage.*|.*quality.*|.*check.*)(\.[^/]+)?$|\.github/workflows/' \
  | head -400

printf '%s\n' '=== Checker references ==='
rg -n -i -C 6 'docstring.{0,40}coverage|coverage.{0,40}docstring|jsdoc|tsdoc' \
  .github package.json pnpm-workspace.yaml turbo.json scripts src gui 2>/dev/null \
  -g '!node_modules/**' -g '!dist/**' -g '!build/**' \
  | head -1200 || true

printf '%s\n' '=== Files changed from PR base ==='
base="$(gh pr view "$pr" --repo "$repo" --json baseRefOid --jq '.baseRefOid')"
printf 'base=%s\n' "$base"
git diff --name-only "$base" HEAD -- \
  '*.ts' '*.tsx' '*.js' '*.jsx' '*.mjs' '*.cjs' | sort

printf '%s\n' '=== Current TypeScript/TSX declaration outline in changed source files ==='
git diff --name-only "$base" HEAD -- '*.ts' '*.tsx' \
  | while IFS= read -r file; do
      printf '\n--- %s ---\n' "$file"
      ast-grep outline "$file" --items all --view expanded 2>/dev/null || true
    done

#!/bin/bash
set -euo pipefail

printf '%s\n' '=== PR-quality script outline ==='
ast-grep outline .github/scripts/pr-quality.cjs --items all --view expanded
ast-grep outline .github/scripts/pr-quality.test.cjs --items all --view expanded

printf '%s\n' '=== Docstring logic and threshold references ==='
rg -n -i -C 12 'docstring|jsdoc|tsdoc|coverage|declaration|threshold|80' \
  .github/scripts/pr-quality.cjs \
  .github/scripts/pr-quality.test.cjs \
  .github/workflows/pr-hygiene.yml \
  docs-site/src/content/docs/contributing/pr-quality.md \
  docs/superpowers/specs/2026-07-28-pr-quality-gates-design.md \
  docs/superpowers/plans/2026-07-28-pr-quality-gates.md \
  2>/dev/null

printf '%s\n' '=== PR-quality script source ==='
cat -n .github/scripts/pr-quality.cjs | sed -n '1,900p'

printf '%s\n' '=== Focused docstring tests ==='
rg -n -i -C 20 'docstring|jsdoc|tsdoc|coverage' .github/scripts/pr-quality.test.cjs \
  | head -1000

printf '%s\n' '=== Workflow invocation ==='
rg -n -C 12 'pr-quality|quality' .github/workflows/pr-hygiene.yml package.json 2>/dev/null

#!/bin/bash
set -euo pipefail

repo="lidge-jun/opencodex"
pr="865"
head="6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"
base="6a7351b4d9f729fcc33241cbb385a01a70b21e0e"

printf '%s\n' '=== Check runs on head ==='
gh api --paginate "repos/$repo/commits/$head/check-runs?per_page=100" \
  --jq '.check_runs[] | {name,status,conclusion,details_url,app:.app.slug,output:{title:.output.title,summary:.output.summary,text:.output.text}}' \
  || true

printf '%s\n' '=== Legacy statuses on head ==='
gh api "repos/$repo/commits/$head/status" \
  --jq '.statuses[] | {context,state,target_url,description,creator:.creator.login}' \
  || true

printf '%s\n' '=== PR comments that mention coverage or docstrings ==='
gh api --paginate "repos/$repo/issues/$pr/comments?per_page=100" \
  --jq '.[] | select((.body // "") | test("docstring|coverage"; "i")) | {user:.user.login,created_at,html_url,body}' \
  || true

printf '%s\n' '=== Review comments that mention coverage or docstrings ==='
gh api --paginate "repos/$repo/pulls/$pr/comments?per_page=100" \
  --jq '.[] | select((.body // "") | test("docstring|coverage"; "i")) | {user:.user.login,path,line,original_line,commit_id,html_url,body}' \
  || true

printf '%s\n' '=== Added or modified declaration headers in production and GUI source ==='
git diff --unified=0 "$base" "$head" -- \
  'src/**/*.ts' 'gui/src/**/*.ts' 'gui/src/**/*.tsx' \
  | rg -n -C 3 \
    '^\+.*\b(export\s+)?(async\s+)?function(\s*\*)?\s+[A-Za-z_$][A-Za-z0-9_$]*|^\+.*\b(export\s+)?(class|interface|type|enum)\s+[A-Za-z_$][A-Za-z0-9_$]*|^\+.*\b(export\s+)?(const|let|var)\s+[A-Za-z_$][A-Za-z0-9_$]*\s*[:=]|^\+.*^\s*[A-Za-z_$][A-Za-z0-9_$]*\s*\([^;]*\)\s*\{' \
  || true

printf '%s\n' '=== Public declarations whose source range intersects a changed line ==='
python3 - <<'PY'
import json
import re
import subprocess
from pathlib import Path

base = "6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head = "6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"
files = subprocess.check_output(
    ["git", "diff", "--name-only", base, head, "--", "src/**/*.ts", "gui/src/**/*.ts", "gui/src/**/*.tsx"],
    text=True,
).splitlines()

def changed_ranges(file):
    diff = subprocess.check_output(["git", "diff", "--unified=0", base, head, "--", file], text=True)
    result = []
    for m in re.finditer(r"^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@", diff, re.M):
        start, count = int(m.group(1)), int(m.group(2) or "1")
        if count:
            result.append((start, start + count - 1))
    return result

def intersects(start, end, ranges):
    return any(start <= b and a <= end for a, b in ranges)

# ast-grep JSON outline supplies locations without executing repository code.
for file in files:
    try:
        data = subprocess.check_output(
            ["ast-grep", "outline", file, "--items", "all", "--json=stream"],
            text=True,
            stderr=subprocess.DEVNULL,
        )
    except subprocess.CalledProcessError:
        continue
    ranges = changed_ranges(file)
    print(f"\n--- {file} ---")
    for raw in data.splitlines():
        try:
            item = json.loads(raw)
        except json.JSONDecodeError:
            continue
        # Print raw shape once if the expected location format is absent.
        text = json.dumps(item, ensure_ascii=False)
        if "range" not in item:
            continue
        r = item["range"]
        start = r["start"]["line"] + 1
        end = r["end"]["line"] + 1
        if intersects(start, end, ranges):
            name = item.get("name") or item.get("text") or item.get("kind") or "<unnamed>"
            kind = item.get("kind") or item.get("type") or ""
            print(f"{start}-{end}\t{kind}\t{name}")
PY

#!/bin/bash
set -euo pipefail

base="6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head="6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"

printf '%s\n' '=== CodeRabbit configuration file ==='
if [ -f .coderabbit.yaml ]; then
  cat -n .coderabbit.yaml
else
  printf '%s\n' 'No .coderabbit.yaml in the checkout.'
fi

printf '%s\n' '=== Added TypeScript/TSX lines that declare named symbols ==='
python3 - <<'PY'
import re
import subprocess
from pathlib import Path

base = "6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head = "6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"
files = subprocess.check_output(
    ["git", "diff", "--name-only", base, head, "--", "src/**/*.ts", "gui/src/**/*.ts", "gui/src/**/*.tsx"],
    text=True,
).splitlines()

patterns = [
    ("function", re.compile(r"^\s*(?:export\s+)?(?:async\s+)?function\s*\*?\s+([A-Za-z_$][\w$]*)\b")),
    ("class/interface/type/enum", re.compile(r"^\s*(?:export\s+)?(?:declare\s+)?(?:abstract\s+)?(?:class|interface|type|enum)\s+([A-Za-z_$][\w$]*)\b")),
    ("variable", re.compile(r"^\s*(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)\b")),
    ("method", re.compile(r"^\s*(?:async\s+)?([A-Za-z_$][\w$]*)\s*\([^;{}]*\)\s*(?::\s*[^={]+)?\s*\{")),
]

def added_lines(file):
    diff = subprocess.check_output(["git", "diff", "--unified=0", base, head, "--", file], text=True)
    current = None
    result = set()
    for line in diff.splitlines():
        m = re.match(r"^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@", line)
        if m:
            current = int(m.group(1))
            continue
        if current is None:
            continue
        if line.startswith("+") and not line.startswith("+++"):
            result.add(current)
            current += 1
        elif line.startswith("-") and not line.startswith("---"):
            continue
        else:
            current += 1
    return result

def jsdoc_before(lines, lineno):
    i = lineno - 2
    while i >= 0 and not lines[i].strip():
        i -= 1
    if i < 0 or not lines[i].rstrip().endswith("*/"):
        return False
    while i >= 0:
        if "/**" in lines[i]:
            return True
        i -= 1
    return False

candidates = []
for file in files:
    lines = Path(file).read_text(encoding="utf-8").splitlines()
    added = added_lines(file)
    for n in sorted(added):
        line = lines[n - 1]
        for kind, pattern in patterns:
            match = pattern.match(line)
            if match:
                name = match.group(1)
                # Exclude control-flow constructs misread as methods.
                if kind == "method" and name in {"if", "for", "while", "switch", "catch"}:
                    continue
                candidates.append((file, n, kind, name, jsdoc_before(lines, n), line.strip()))
                break

for file, line, kind, name, documented, source in candidates:
    print(f"{file}:Line {line}: {kind}: {name}: {'JSDOC' if documented else 'MISSING'}")
    print(f"  {source}")
print(f"TOTAL={len(candidates)} DOCUMENTED={sum(x[4] for x in candidates)} MISSING={sum(not x[4] for x in candidates)}")
PY

printf '%s\n' '=== Current contexts for candidates without directly adjacent JSDoc ==='
python3 - <<'PY'
import re
import subprocess
from pathlib import Path

base = "6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head = "6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"
files = subprocess.check_output(["git", "diff", "--name-only", base, head, "--", "src/**/*.ts", "gui/src/**/*.ts", "gui/src/**/*.tsx"], text=True).splitlines()

for file in files:
    diff = subprocess.check_output(["git", "diff", "--unified=0", base, head, "--", file], text=True)
    added = set()
    cur = None
    for row in diff.splitlines():
        m = re.match(r"^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@", row)
        if m: cur = int(m.group(1)); continue
        if cur is None: continue
        if row.startswith("+") and not row.startswith("+++"): added.add(cur); cur += 1
        elif row.startswith("-") and not row.startswith("---"): pass
        else: cur += 1
    lines = Path(file).read_text(encoding="utf-8").splitlines()
    for n in sorted(added):
        line = lines[n - 1]
        if re.match(r"^\s*(?:export\s+)?(?:async\s+)?function\s*\*?\s+\w+|^\s*(?:export\s+)?(?:const|let|var)\s+\w+|^\s*(?:export\s+)?(?:class|interface|type|enum)\s+\w+", line):
            i = n - 2
            while i >= 0 and not lines[i].strip(): i -= 1
            if i < 0 or not lines[i].rstrip().endswith("*/"):
                lo, hi = max(1, n - 4), min(len(lines), n + 5)
                print(f"\n--- {file}:Line {n} ---")
                for j in range(lo, hi + 1):
                    print(f"{j}: {lines[j-1]}")
PY

#!/bin/bash
set -euo pipefail

base="6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head="6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"

python3 - <<'PY'
import re
import subprocess
from pathlib import Path

BASE = "6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
HEAD = "6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"
files = subprocess.check_output(
    ["git", "diff", "--name-only", BASE, HEAD, "--", "src/**/*.ts", "gui/src/**/*.ts", "gui/src/**/*.tsx"],
    text=True,
).splitlines()

def added_lines(file):
    diff = subprocess.check_output(["git", "diff", "--unified=0", BASE, HEAD, "--", file], text=True)
    result, current = set(), None
    for row in diff.splitlines():
        m = re.match(r"^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@", row)
        if m:
            current = int(m.group(1))
        elif current is not None and row.startswith("+") and not row.startswith("+++"):
            result.add(current); current += 1
        elif current is not None and row.startswith("-") and not row.startswith("---"):
            pass
        elif current is not None:
            current += 1
    return result

def jsdoc_before(lines, line):
    i = line - 2
    while i >= 0 and not lines[i].strip():
        i -= 1
    if i < 0 or not lines[i].rstrip().endswith("*/"):
        return False
    while i >= 0:
        if "/**" in lines[i]:
            return True
        i -= 1
    return False

# Candidate categories: type/interface/class/enum declarations, named function declarations,
# top-level/exported values, and named callable arrow functions. Ordinary function-local state
# variables are deliberately excluded.
decl_patterns = [
    ("type", re.compile(r"^\s*(?:export\s+)?type\s+([A-Za-z_$][\w$]*)\b")),
    ("interface", re.compile(r"^\s*(?:export\s+)?interface\s+([A-Za-z_$][\w$]*)\b")),
    ("class", re.compile(r"^\s*(?:export\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)\b")),
    ("enum", re.compile(r"^\s*(?:export\s+)?(?:const\s+)?enum\s+([A-Za-z_$][\w$]*)\b")),
    ("function", re.compile(r"^\s*(?:export\s+)?(?:async\s+)?function\s*\*?\s+([A-Za-z_$][\w$]*)\b")),
    ("arrow function", re.compile(r"^\s*(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)\b.*=\s*(?:async\s*)?(?:\([^)]*\)|[A-Za-z_$][\w$]*)\s*=>")),
]

# Brace-depth estimate is sufficient to identify module scope here. Remove strings/comments
# conservatively so punctuation within them does not affect the depth.
def brace_delta(line):
    clean = re.sub(r"//.*$", "", line)
    clean = re.sub(r"/\*.*?\*/", "", clean)
    clean = re.sub(r'"(?:\\.|[^"\\])*"', '""', clean)
    clean = re.sub(r"'(?:\\.|[^'\\])*'", "''", clean)
    return clean.count("{") - clean.count("}")

all_candidates = []
for file in files:
    lines = Path(file).read_text(encoding="utf-8").splitlines()
    added = added_lines(file)
    depth = 0
    for idx, source in enumerate(lines, 1):
        module_scope = depth == 0
        if idx in added:
            found = None
            for category, pattern in decl_patterns:
                m = pattern.match(source)
                if m:
                    found = (category, m.group(1))
                    break
            if found is None and module_scope:
                # Module-level values are part of the public/module declaration surface.
                m = re.match(r"^\s*(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)\b", source)
                if m:
                    found = ("module value", m.group(1))
            if found:
                all_candidates.append((file, idx, found[0], found[1], jsdoc_before(lines, idx), source.strip()))
        depth += brace_delta(source)

print("=== Documentation-oriented added declarations ===")
for item in all_candidates:
    file, line, category, name, documented, source = item
    print(f"{file}:Line {line}: {category}: {name}: {'JSDOC' if documented else 'MISSING'}")
    print(f"  {source}")

docs = sum(item[4] for item in all_candidates)
print(f"\nTOTAL={len(all_candidates)} DOCUMENTED={docs} MISSING={len(all_candidates)-docs}")

print("\n=== Missing candidates with source context ===")
for file, line, category, name, documented, source in all_candidates:
    if documented:
        continue
    lines = Path(file).read_text(encoding="utf-8").splitlines()
    print(f"\n--- {file}:Line {line}: {category} {name} ---")
    for n in range(max(1, line - 3), min(len(lines), line + 4) + 1):
        print(f"{n}: {lines[n - 1]}")
PY

printf '%s\n' '=== PR declaration changes, grouped by commit ==='
git log --format='%H %s' "$base..$head" | while read -r commit subject; do
  printf '\n--- %s %s ---\n' "${commit:0:8}" "$subject"
  git show --format= --unified=0 "$commit" -- 'src/**/*.ts' 'gui/src/**/*.ts' 'gui/src/**/*.tsx' \
    | rg '^\+.*\b(export\s+)?(async\s+)?function\s*\*?\s+[A-Za-z_$][A-Za-z0-9_$]*|^\+.*\b(export\s+)?(type|interface|class|enum)\s+[A-Za-z_$][A-Za-z0-9_$]*|^\+.*\b(export\s+)?(const|let|var)\s+[A-Za-z_$][A-Za-z0-9_$]*\s*=' \
    || true
done

#!/bin/bash
set -euo pipefail

base="6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head="6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"

python3 - <<'PY'
import re
import subprocess
from pathlib import Path

BASE = "6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
HEAD = "6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"
PATHS = ["src/*.ts", "src/**/*.ts", "gui/src/*.ts", "gui/src/*.tsx", "gui/src/**/*.ts", "gui/src/**/*.tsx"]
files = subprocess.check_output(
    ["git", "diff", "--name-only", BASE, HEAD, "--", *PATHS],
    text=True,
).splitlines()

def added_lines(file):
    diff = subprocess.check_output(["git", "diff", "--unified=0", BASE, HEAD, "--", file], text=True)
    result, current = set(), None
    for row in diff.splitlines():
        m = re.match(r"^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@", row)
        if m:
            current = int(m.group(1))
        elif current is not None and row.startswith("+") and not row.startswith("+++"):
            result.add(current)
            current += 1
        elif current is not None and row.startswith("-") and not row.startswith("---"):
            pass
        elif current is not None:
            current += 1
    return result

def jsdoc_before(lines, line):
    i = line - 2
    while i >= 0 and not lines[i].strip():
        i -= 1
    if i < 0 or not lines[i].rstrip().endswith("*/"):
        return False
    while i >= 0:
        if "/**" in lines[i]:
            return True
        i -= 1
    return False

patterns = [
    ("type", re.compile(r"^\s*(?:export\s+)?type\s+([A-Za-z_$][\w$]*)\b")),
    ("interface", re.compile(r"^\s*(?:export\s+)?interface\s+([A-Za-z_$][\w$]*)\b")),
    ("class", re.compile(r"^\s*(?:export\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)\b")),
    ("enum", re.compile(r"^\s*(?:export\s+)?(?:const\s+)?enum\s+([A-Za-z_$][\w$]*)\b")),
    ("function", re.compile(r"^\s*(?:export\s+)?(?:async\s+)?function\s*\*?\s+([A-Za-z_$][\w$]*)\b")),
    ("arrow function", re.compile(r"^\s*(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)\b.*=\s*(?:async\s*)?(?:\([^)]*\)|[A-Za-z_$][\w$]*)\s*=>")),
]

def brace_delta(line):
    clean = re.sub(r"//.*$", "", line)
    clean = re.sub(r"/\*.*?\*/", "", clean)
    clean = re.sub(r'"(?:\\.|[^"\\])*"', '""', clean)
    clean = re.sub(r"'(?:\\.|[^'\\])*'", "''", clean)
    return clean.count("{") - clean.count("}")

candidates = []
for file in files:
    lines = Path(file).read_text(encoding="utf-8").splitlines()
    added = added_lines(file)
    depth = 0
    for idx, source in enumerate(lines, 1):
        module_scope = depth == 0
        if idx in added:
            found = None
            for category, pattern in patterns:
                m = pattern.match(source)
                if m:
                    found = (category, m.group(1))
                    break
            if found is None and module_scope:
                m = re.match(r"^\s*(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)\b", source)
                if m:
                    found = ("module value", m.group(1))
            if found:
                candidates.append((file, idx, found[0], found[1], jsdoc_before(lines, idx), source.strip()))
        depth += brace_delta(source)

print("=== Assessed-declaration candidate inventory ===")
for file, line, category, name, documented, source in candidates:
    print(f"{file}:Line {line}: {category}: {name}: {'JSDOC' if documented else 'MISSING'}")

documented = sum(item[4] for item in candidates)
print(f"\nTOTAL={len(candidates)} DOCUMENTED={documented} MISSING={len(candidates)-documented}")

print("\n=== Missing declaration contexts ===")
for file, line, category, name, documented, source in candidates:
    if documented:
        continue
    lines = Path(file).read_text(encoding="utf-8").splitlines()
    print(f"\n--- {file}:Line {line}: {category} {name} ---")
    for n in range(max(1, line - 3), min(len(lines), line + 4) + 1):
        print(f"{n}: {lines[n - 1]}")
PY

printf '%s\n' '=== Complete changed source-file list ==='
git diff --name-only "$base" "$head" -- \
  'src/*.ts' 'src/**/*.ts' 'gui/src/*.ts' 'gui/src/*.tsx' 'gui/src/**/*.ts' 'gui/src/**/*.tsx' \
  | sort

#!/bin/bash
set -euo pipefail

base="6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
head="6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"

printf '%s\n' '=== Directly added exported declarations ==='
git diff --unified=0 "$base" "$head" -- \
  'src/*.ts' 'src/**/*.ts' 'gui/src/*.ts' 'gui/src/*.tsx' 'gui/src/**/*.ts' 'gui/src/**/*.tsx' \
  | rg -n -C 2 \
    '^\+\s*export\s+(?:declare\s+)?(?:async\s+)?function\s*\*?\s+[A-Za-z_$][A-Za-z0-9_$]*|^\+\s*export\s+(?:const|let|var)\s+[A-Za-z_$][A-Za-z0-9_$]*|^\+\s*export\s+(?:abstract\s+)?(?:class|interface|type|enum)\s+[A-Za-z_$][A-Za-z0-9_$]*' \
  || true

python3 - <<'PY'
import re
import subprocess
from pathlib import Path

BASE = "6a7351b4d9f729fcc33241cbb385a01a70b21e0e"
HEAD = "6c7ea9f77e5fd66c24af0f1ddfccb8096b7d67df"
PATHS = ["src/*.ts", "src/**/*.ts", "gui/src/*.ts", "gui/src/*.tsx", "gui/src/**/*.ts", "gui/src/**/*.tsx"]
files = subprocess.check_output(["git", "diff", "--name-only", BASE, HEAD, "--", *PATHS], text=True).splitlines()

direct_patterns = [
    ("function", re.compile(r"^\s*export\s+(?:async\s+)?function\s*\*?\s+([A-Za-z_$][\w$]*)\b")),
    ("value", re.compile(r"^\s*export\s+(?:const|let|var)\s+([A-Za-z_$][\w$]*)\b")),
    ("type", re.compile(r"^\s*export\s+type\s+([A-Za-z_$][\w$]*)\b")),
    ("interface", re.compile(r"^\s*export\s+interface\s+([A-Za-z_$][\w$]*)\b")),
    ("class", re.compile(r"^\s*export\s+(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)\b")),
    ("enum", re.compile(r"^\s*export\s+(?:const\s+)?enum\s+([A-Za-z_$][\w$]*)\b")),
]

def added_lines(file):
    text = subprocess.check_output(["git", "diff", "--unified=0", BASE, HEAD, "--", file], text=True)
    current, output = None, set()
    for row in text.splitlines():
        hunk = re.match(r"^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@", row)
        if hunk:
            current = int(hunk.group(1))
        elif current is not None and row.startswith("+") and not row.startswith("+++"):
            output.add(current); current += 1
        elif current is not None and row.startswith("-") and not row.startswith("---"):
            pass
        elif current is not None:
            current += 1
    return output

def jsdoc(lines, n):
    i = n - 2
    while i >= 0 and not lines[i].strip():
        i -= 1
    if i < 0 or not lines[i].strip().endswith("*/"):
        return False
    while i >= 0:
        if "/**" in lines[i]:
            return True
        i -= 1
    return False

items = []
for file in files:
    lines = Path(file).read_text(encoding="utf-8").splitlines()
    for n in sorted(added_lines(file)):
        for category, pattern in direct_patterns:
            m = pattern.match(lines[n - 1])
            if m:
                items.append((file, n, category, m.group(1), jsdoc(lines, n)))
                break

print("=== Direct added exported declarations and JSDoc ===")
for item in items:
    print(f"{item[0]}:Line {item[1]}: {item[2]} {item[3]}: {'JSDOC' if item[4] else 'MISSING'}")
print(f"TOTAL={len(items)} DOCUMENTED={sum(x[4] for x in items)} MISSING={sum(not x[4] for x in items)}")

# Get exported declarations from the current files by extracting outline text and identify
# declarations that are not direct additions but have a changed line in their textual span.
# The source context is printed for human verification.
print("\n=== Existing exported declaration headers near changed hunks ===")
for file in files:
    lines = Path(file).read_text(encoding="utf-8").splitlines()
    changed = added_lines(file)
    exported_headers = []
    for n, line in enumerate(lines, 1):
        for category, pattern in direct_patterns:
            m = pattern.match(line)
            if m:
                exported_headers.append((n, category, m.group(1)))
                break
    for i, (start, category, name) in enumerate(exported_headers):
        end = (exported_headers[i+1][0] - 1) if i + 1 < len(exported_headers) else len(lines)
        # Only report an existing header when a later changed line lies before next export.
        if start not in changed and any(start <= c <= end for c in changed):
            print(f"{file}:Line {start}: {category} {name}: {'JSDOC' if jsdoc(lines, start) else 'MISSING'}")
PY