tipalti 0.0.1__tar.gz

tipalti-0.0.1/.claude/skills/gh-issues/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: gh-issues
+description: >
+  Fetch GitHub issues with full body and comments. Use when checking issues,
+  reviewing bug reports, or the user says "check issues", "fetch issues",
+  "issue #N", or references GitHub issue numbers.
+triggers:
+  - check issues
+  - fetch issues
+  - issue #
+  - github issues
+  - verify issues
+---
+
+# GitHub Issues Skill
+
+Fetch one or more GitHub issues with full body text and all comments.
+
+## Usage
+
+### Single issue
+
+```bash
+bash .claude/skills/gh-issues/scripts/gh-issues.sh 191
+```
+
+### Range
+
+```bash
+bash .claude/skills/gh-issues/scripts/gh-issues.sh 191-197
+```
+
+### Specific list
+
+```bash
+bash .claude/skills/gh-issues/scripts/gh-issues.sh 191 195 197
+```
+
+### Explicit repo
+
+```bash
+bash .claude/skills/gh-issues/scripts/gh-issues.sh --repo owner/repo 42-50
+```
+
+Output is JSON per issue with: number, title, state, labels, body, and comments array.

tipalti-0.0.1/.claude/skills/gh-issues/scripts/gh-issues.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Fetch GitHub issues with full body and comments
+# Usage: gh-issues.sh [RANGE|NUMBER] [--repo OWNER/REPO]
+#   gh-issues.sh 191-197          # range
+#   gh-issues.sh 191              # single
+#   gh-issues.sh 191 192 195      # list
+#   gh-issues.sh --repo foo/bar 5 # explicit repo
+
+set -euo pipefail
+
+REPO_FLAG=""
+NUMBERS=()
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)
+      if [[ $# -lt 2 || -z "$2" ]]; then
+        echo "Error: --repo requires a value (OWNER/REPO)" >&2
+        echo "Usage: gh-issues.sh [RANGE|NUMBER...] [--repo OWNER/REPO]" >&2
+        exit 1
+      fi
+      REPO_FLAG="--repo $2"
+      shift 2 ;;
+    *-*)  # range like 191-197
+      IFS='-' read -r start end <<< "$1"
+      for ((i=start; i<=end; i++)); do NUMBERS+=("$i"); done
+      shift ;;
+    *)  NUMBERS+=("$1"); shift ;;
+  esac
+done
+
+if [[ ${#NUMBERS[@]} -eq 0 ]]; then
+  echo "Usage: gh-issues.sh [RANGE|NUMBER...] [--repo OWNER/REPO]" >&2
+  exit 1
+fi
+
+for num in "${NUMBERS[@]}"; do
+  echo "========================================"
+  echo "ISSUE #${num}"
+  echo "========================================"
+  # shellcheck disable=SC2086
+  gh issue view "$num" $REPO_FLAG --json number,title,state,labels,body,comments \
+    --jq '{
+      number: .number,
+      title: .title,
+      state: .state,
+      labels: [.labels[].name],
+      body: .body,
+      comments: [.comments[] | {author: .author.login, body: .body}]
+    }' 2>/dev/null || echo "ERROR: Could not fetch issue #${num}"
+  echo
+done

tipalti-0.0.1/.claude/skills/notebooklm/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: notebooklm
+description: >
+  Generate GitHub links to repo documentation for NotebookLM ingestion.
+  Use when: the user wants to create a NotebookLM notebook about a project,
+  needs doc links for a repo, or says "notebooklm", "notebook sources",
+  "get repo sources", or "doc links".
+---
+
+# NotebookLM — Repo Source Links
+
+Generate GitHub blob URLs for all documentation in the current repo, ready to paste into Google NotebookLM as sources.
+
+## When to Use
+
+- Creating a NotebookLM notebook about a project
+- Gathering all doc links for a repo
+- Exporting documentation URLs for any external tool
+
+## Usage
+
+```bash
+# Categorized output (default)
+bash .claude/skills/notebooklm/scripts/get-repo-sources.sh
+
+# Plain URLs only (for copy-paste)
+bash .claude/skills/notebooklm/scripts/get-repo-sources.sh --plain
+
+# Include plans and specs
+bash .claude/skills/notebooklm/scripts/get-repo-sources.sh --all
+
+# Override branch
+bash .claude/skills/notebooklm/scripts/get-repo-sources.sh --branch develop
+```
+
+## Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--all` | off | Include plans, specs, and changelogs |
+| `--plain` | off | Output only URLs, one per line (no headers) |
+| `--branch NAME` | auto-detect | Override the git branch used in URLs |
+
+## Requirements
+
+- Must be run inside a git repository with a GitHub remote
+- `git` CLI available

tipalti-0.0.1/.claude/skills/notebooklm/scripts/get-repo-sources.sh

@@ -0,0 +1,200 @@
+#!/usr/bin/env bash
+# get-repo-sources — Generate GitHub URLs for repo docs, ready for NotebookLM
+set -euo pipefail
+
+# --- Defaults ---
+INCLUDE_ALL=false
+PLAIN=false
+BRANCH=""
+
+# --- Parse args ---
+usage() {
+  echo "Usage: get-repo-sources.sh [--all] [--plain] [--branch NAME]"
+  echo "  --all      Include plans, specs, and changelogs"
+  echo "  --plain    Output plain URLs only (no headers)"
+  echo "  --branch   Override branch (default: auto-detect)"
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --all)       INCLUDE_ALL=true; shift ;;
+    --plain)     PLAIN=true; shift ;;
+    --branch)
+      if [[ $# -lt 2 || -z "$2" ]]; then
+        echo "Error: --branch requires a value" >&2
+        usage >&2
+        exit 1
+      fi
+      BRANCH="$2"
+      shift 2 ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *) echo "Unknown option: $1" >&2; exit 1 ;;
+  esac
+done
+
+# --- Detect repo root ---
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null)" || {
+  echo "Error: not inside a git repository" >&2; exit 1
+}
+cd "$REPO_ROOT"
+
+# --- Detect GitHub URL ---
+REMOTE_URL="$(git remote get-url origin 2>/dev/null)" || {
+  echo "Error: no 'origin' remote found" >&2; exit 1
+}
+
+# Normalise to https://github.com/OWNER/REPO
+GITHUB_URL="$REMOTE_URL"
+GITHUB_URL="${GITHUB_URL%.git}"
+if [[ "$GITHUB_URL" == git@github.com:* ]]; then
+  GITHUB_URL="https://github.com/${GITHUB_URL#git@github.com:}"
+fi
+
+# --- Detect branch (handle detached HEAD) ---
+if [[ -z "$BRANCH" ]]; then
+  BRANCH="$(git branch --show-current 2>/dev/null || true)"
+fi
+if [[ -z "$BRANCH" ]]; then
+  echo "Error: cannot determine the current branch (detached HEAD?)." >&2
+  echo "Hint: pass --branch <name> with a branch that exists on origin." >&2
+  exit 1
+fi
+
+# --- Verify the remote ref exists locally ---
+REMOTE_REF="origin/${BRANCH}"
+if ! git show-ref --verify --quiet "refs/remotes/${REMOTE_REF}"; then
+  echo "Error: remote ref '${REMOTE_REF}' is not available locally." >&2
+  echo "Hint: run 'git fetch origin ${BRANCH}', push the branch first, or pass --branch with an existing remote branch name." >&2
+  exit 1
+fi
+
+BASE_URL="${GITHUB_URL}/blob/${BRANCH}"
+
+# --- Collect all .md files from remote branch (only files that exist on GitHub) ---
+ALL_FILES=$(git ls-tree -r --name-only "${REMOTE_REF}" \
+  | grep '\.md$' \
+  | grep -v -E '^(\.github/|\.claude/|\.pytest_cache/|node_modules/|\.venv/|__pycache__/|\.mypy_cache/)' \
+  | sort)
+
+# --- Filter ---
+filter_file() {
+  local f="$1"
+  # Always exclude dot-dirs and lock files
+  [[ "$f" == .github/* ]] && return 1
+
+  if [[ "$INCLUDE_ALL" == "false" ]]; then
+    # Exclude plans, specs, changelogs by default
+    [[ "$f" == *superpowers/plans/* ]] && return 1
+    [[ "$f" == *superpowers/specs/* ]] && return 1
+    [[ "$f" == CHANGELOG.md ]] && return 1
+  fi
+  return 0
+}
+
+FILTERED=()
+while IFS= read -r f; do
+  [[ -z "$f" ]] && continue
+  if filter_file "$f"; then
+    FILTERED+=("$f")
+  fi
+done <<< "$ALL_FILES"
+
+if [[ ${#FILTERED[@]} -eq 0 ]]; then
+  echo "No documentation files found." >&2
+  exit 1
+fi
+
+# --- Categorise ---
+declare -a CAT_CORE=() CAT_ARCH=() CAT_START=() CAT_FEATURES=() CAT_PROTOCOL=()
+declare -a CAT_CLIENTS=() CAT_USECASES=() CAT_PACKAGES=() CAT_PLANS=() CAT_SPECS=() CAT_OTHER=()
+
+categorise() {
+  local f="$1"
+  local base
+  base="$(basename "$f")"
+
+  # Path-based categories first (more specific)
+  case "$f" in
+    *protocol/*)         CAT_PROTOCOL+=("$f"); return ;;
+    *clients/*)          CAT_CLIENTS+=("$f"); return ;;
+    *use-cases/*)        CAT_USECASES+=("$f"); return ;;
+    *packages/*)         CAT_PACKAGES+=("$f"); return ;;
+    *superpowers/plans*) CAT_PLANS+=("$f"); return ;;
+    *superpowers/specs*) CAT_SPECS+=("$f"); return ;;
+    *plugins/*)          CAT_OTHER+=("$f"); return ;;
+    *skills/*)           CAT_OTHER+=("$f"); return ;;
+  esac
+
+  # Root-level core files (only match files at repo root)
+  case "$f" in
+    README.md|CLAUDE.md|index.md) CAT_CORE+=("$f"); return ;;
+    CHANGELOG.md)                 CAT_OTHER+=("$f"); return ;;
+  esac
+
+  # By filename keywords
+  case "$base" in
+    layer*|overview*|design*|server-architecture*|*-spec*)
+      CAT_ARCH+=("$f"); return ;;
+    getting-started*|cli*|grow-your-agent*)
+      CAT_START+=("$f"); return ;;
+    *) ;;
+  esac
+
+  # Docs directory features
+  if [[ "$f" == docs/* ]]; then
+    CAT_FEATURES+=("$f")
+  else
+    CAT_OTHER+=("$f")
+  fi
+}
+
+for f in "${FILTERED[@]}"; do
+  categorise "$f"
+done
+
+# --- Output ---
+print_urls() {
+  local label="$1"; shift
+  local -n arr=$1
+
+  if [[ ${#arr[@]} -eq 0 ]]; then return; fi
+
+  if [[ "$PLAIN" == "false" ]]; then
+    echo ""
+    echo "--- ${label} ---"
+  fi
+  for f in "${arr[@]}"; do
+    echo "${BASE_URL}/${f}"
+  done
+}
+
+if [[ "$PLAIN" == "false" ]]; then
+  echo "=== Documentation Links for NotebookLM ==="
+  echo "Repository: ${GITHUB_URL}"
+  echo "Branch: ${BRANCH}"
+  echo "Files: ${#FILTERED[@]}"
+fi
+
+print_urls "Core"           CAT_CORE
+print_urls "Architecture"   CAT_ARCH
+print_urls "Getting Started" CAT_START
+print_urls "Features"       CAT_FEATURES
+print_urls "Protocol"       CAT_PROTOCOL
+print_urls "Clients"        CAT_CLIENTS
+print_urls "Use Cases"      CAT_USECASES
+print_urls "Packages"       CAT_PACKAGES
+print_urls "Plans"          CAT_PLANS
+print_urls "Specs"          CAT_SPECS
+print_urls "Other"          CAT_OTHER
+
+if [[ "$PLAIN" == "false" ]]; then
+  echo ""
+  echo "=== Plain URLs (copy-paste block) ==="
+  echo ""
+  for f in "${FILTERED[@]}"; do
+    echo "${BASE_URL}/${f}"
+  done
+fi

tipalti-0.0.1/.claude/skills/pr-review/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: pr-review
+description: >
+  Steward-specific PR workflow: branch, commit, push, PR, wait for Qodo/Copilot,
+  triage, fix, reply, resolve. Adds a portability lint (no absolute /home paths,
+  no per-user dotfile refs in committed docs), an alignment-delta check when
+  CLAUDE.md or culture.yaml change, and greenfield-aware test/version-bump
+  steps. Use when: creating PRs in steward, handling review feedback, or the
+  user says "create PR", "review comments", "address feedback", "resolve threads".
+---
+
+# PR Review — Steward edition
+
+Steward's PRs touch agent prompts, `culture.yaml` configs, and cross-project
+guidance. The generic `pr-review` skills don't know that, so they miss two
+classes of bugs Steward keeps producing:
+
+- **Path leaks** — committing absolute home-directory paths that work only on
+  the author's machine. (PR #1 had four of these.)
+- **Per-user config dependencies** — referencing a dotfile under the user's
+  home directory in repo guidance, breaking reproducibility for other
+  contributors and CI.
+
+This skill specializes Culture's `pr-review` to catch both up front, plus an
+alignment-delta step when Steward-affecting files change. The workflow is
+encapsulated in `scripts/workflow.sh` — follow that, not a manual checklist.
+
+## Prerequisites
+
+Hard requirements: `gh` (GitHub CLI), `jq`, `bash`, `python3` (stdlib only),
+`curl` (used by `pr-status.sh`).
+
+Soft requirement: `PyYAML` is needed **only for suffix mode** of the sibling
+`agent-config` skill, where it parses Culture's server manifest. Path mode
+and every `pr-review` script work without it. If suffix mode runs without
+PyYAML it exits with a clear install hint.
+
+Per-machine paths (sibling-project layout) live in
+`.claude/skills.local.yaml`; see the committed `.example` for the schema.
+
+## How to run
+
+`scripts/workflow.sh` is the entry point. Subcommands:
+
+| Command | Purpose |
+|---------|---------|
+| `workflow.sh lint` | Portability lint on the current diff (staged + unstaged). |
+| `workflow.sh poll <PR>` | Fetch and display all review comments. |
+| `workflow.sh delta` | Dump each sibling project's `CLAUDE.md` head + `culture.yaml`. |
+| `workflow.sh reply <PR>` | Batch reply (JSONL on stdin) and resolve threads. |
+| `workflow.sh help` | Print this list. |
+
+The vendored single-comment helpers — `pr-reply.sh`, `pr-status.sh` — live
+next to `workflow.sh` and are usable directly when batching isn't appropriate.
+
+## End-to-end flow
+
+```text
+git checkout -b <type>/<desc>
+# ... edit ...
+.claude/skills/pr-review/scripts/workflow.sh lint
+git commit -am "..." && git push -u origin <branch>
+gh pr create --title "..." --body "..."   # title <70 chars, body signed "- Claude"
+sleep 300                                  # wait for Qodo + Copilot
+.claude/skills/pr-review/scripts/workflow.sh poll <PR>
+# triage; if CLAUDE.md/culture.yaml/.claude/skills changed:
+.claude/skills/pr-review/scripts/workflow.sh delta
+# fix, re-lint, push
+.claude/skills/pr-review/scripts/workflow.sh reply <PR> < replies.jsonl
+gh pr checks <PR>
+# Wait for human merge — never merge yourself.
+```
+
+Branch naming: `fix/<desc>`, `feat/<desc>`, `docs/<desc>`, `skill/<name>`.
+Commit/PR signature: `- Claude` (workspace convention). The reply script
+auto-appends `- Claude` only if the body isn't already signed, so JSONL
+entries can include or omit it.
+
+## Triage rules
+
+For every comment, decide **FIX** or **PUSHBACK** with reasoning.
+
+Default to **FIX** for: portability complaints (always valid for Steward —
+recurring bug class), test or doc requests, style nits aligned with workspace
+conventions.
+
+Default to **PUSHBACK** for: architecture opinions that conflict with workspace
+`CLAUDE.md` or the all-backends rule; greenfield false-positives (e.g. "add
+tests" before there's any source — defer to a later PR, don't refuse).
+
+### Alignment-delta rule
+
+If the PR touches `CLAUDE.md`, `culture.yaml`, or anything under
+`.claude/skills/`, run `workflow.sh delta` **before** declaring FIX or
+PUSHBACK on each comment. The script dumps the head of every sibling
+project's `CLAUDE.md` plus the full `culture.yaml`, using `sibling_projects`
+from `skills.local.yaml`. Note any sibling that needs a follow-up PR and
+mention it in your reply.
+
+## Greenfield-aware steps
+
+The lint and the workflow script are always-on. Stack-specific steps are
+conditional and currently no-op (greenfield repo):
+
+```bash
+[ -d tests ] && [ -f pyproject.toml ] && uv run pytest tests/ -x -q
+[ -f pyproject.toml ] && bump_version_per_project_convention   # see project README
+[ -f .markdownlint-cli2.yaml ] && markdownlint-cli2 "$(git diff --name-only --cached '*.md')"
+```
+
+Revisit each line as the corresponding stack element actually lands.
+
+## Reply etiquette
+
+Every comment must get a reply — no silent fixes. Always pass `--resolve`
+when batch-replying so threads close automatically. Reference the
+review-comment IDs in the fix-up commit message. Steward currently has no
+SonarCloud integration and isn't a registered mesh agent, so skip the
+sonarclaude check and the post-merge IRC ping that Culture's `pr-review`
+includes — those will return when Steward joins those systems.

tipalti-0.0.1/.claude/skills/pr-review/scripts/portability-lint.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# Portability lint: catch path leaks and per-user config dependencies in
+# committed docs/configs before they ship in a PR. Steward's recurring bug
+# class.
+#
+# Usage: portability-lint.sh [--all]
+#   default: lint files modified vs HEAD (staged + unstaged)
+#   --all:   lint all tracked files
+#
+# Exits 0 if clean, 1 if any leak is found.
+
+set -euo pipefail
+
+mode="${1:-diff}"
+case "$mode" in
+    --all) files=$(git ls-files -- ':(exclude)*.lock') ;;
+    diff|--diff) files=$(git diff --diff-filter=AMR --name-only HEAD -- ':(exclude)*.lock') ;;
+    *) echo "Usage: $(basename "$0") [--all]" >&2; exit 2 ;;
+esac
+
+[ -z "$files" ] && { echo "(no files to check)"; exit 0; }
+
+# ----- Check 1: hard-coded /home/<user>/... paths -----
+hits1=$(echo "$files" | xargs -r grep -nE '/home/[a-z][a-z0-9_-]+/' 2>/dev/null || true)
+
+# ----- Check 2: per-user dotfile *config* refs in committed docs/configs -----
+# Carve-outs (allowed, NOT flagged):
+#   - ~/.claude/skills/<x>/scripts/   vendored tool calls
+#   - ~/.culture/                     Culture mesh data this skill is supposed to read
+md_yaml=$(echo "$files" | grep -E '\.(md|ya?ml|toml|json|jsonc)$' || true)
+if [ -n "$md_yaml" ]; then
+    hits2=$(echo "$md_yaml" | xargs -r grep -nE '~/\.[A-Za-z]' 2>/dev/null \
+        | grep -vE '~/\.claude/skills/[^[:space:]"]+/scripts/' \
+        | grep -vE '~/\.culture/' \
+        || true)
+else
+    hits2=""
+fi
+
+fail=0
+if [ -n "$hits1" ]; then
+    echo "❌ Hard-coded /home/<user>/ paths:"
+    echo "$hits1" | sed 's/^/    /'
+    echo "   Fix: use ../sibling, repo URL, or \$WORKSPACE/sibling instead."
+    fail=1
+fi
+if [ -n "$hits2" ]; then
+    [ "$fail" -eq 1 ] && echo
+    echo "❌ Per-user ~/.<dotfile> config refs in committed doc/config:"
+    echo "$hits2" | sed 's/^/    /'
+    echo "   Allowed carve-outs: ~/.claude/skills/.../scripts/ (tool calls), ~/.culture/ (mesh data)."
+    echo "   Otherwise: commit a repo-local config or document a portable lookup."
+    fail=1
+fi
+
+[ "$fail" -eq 0 ] && echo "✓ portability lint clean ($(echo "$files" | wc -l | tr -d ' ') files checked)"
+exit $fail

tipalti-0.0.1/.claude/skills/pr-review/scripts/pr-batch.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Batch reply to PR review comments from JSONL on stdin.
+# Each line: {"comment_id": 123, "body": "reply text"}
+# Usage: pr-batch.sh [--repo OWNER/REPO] [--resolve] PR_NUMBER < input.jsonl
+
+REPO=""
+RESOLVE=false
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --repo) REPO="$2"; shift 2 ;;
+        --resolve) RESOLVE=true; shift ;;
+        *) break ;;
+    esac
+done
+
+PR_NUMBER="${1:?Usage: pr-batch.sh [--repo OWNER/REPO] [--resolve] PR_NUMBER < input.jsonl}"
+
+if [[ -z "$REPO" ]]; then
+    REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner)
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+RESOLVE_FLAG=""
+if [[ "$RESOLVE" == true ]]; then
+    RESOLVE_FLAG="--resolve"
+fi
+
+SUCCESS=0
+FAIL=0
+
+while IFS= read -r line; do
+    # Skip empty lines
+    [[ -z "$line" ]] && continue
+
+    COMMENT_ID=$(echo "$line" | jq -r '.comment_id')
+    BODY=$(echo "$line" | jq -r '.body')
+
+    if [[ "$COMMENT_ID" == "null" || "$BODY" == "null" ]]; then
+        echo "SKIP: invalid line: $line"
+        ((FAIL++)) || true
+        continue
+    fi
+
+    echo "--- Comment $COMMENT_ID ---"
+    if bash "$SCRIPT_DIR/pr-reply.sh" --repo "$REPO" $RESOLVE_FLAG "$PR_NUMBER" "$COMMENT_ID" "$BODY"; then
+        ((SUCCESS++)) || true
+    else
+        echo "FAILED: comment $COMMENT_ID"
+        ((FAIL++)) || true
+    fi
+done
+
+echo ""
+echo "Done: $SUCCESS succeeded, $FAIL failed"

tipalti-0.0.1/.claude/skills/pr-review/scripts/pr-comments.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Fetch and display all PR feedback in one pass:
+#   1. Inline review comments (with thread resolve status)
+#   2. Issue comments (qodo summaries, sonarcloud, etc.)
+#   3. Top-level reviews with a non-empty body (copilot overview, etc.)
+#
+# Usage: pr-comments.sh [--repo OWNER/REPO] PR_NUMBER
+
+REPO=""
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --repo) REPO="$2"; shift 2 ;;
+        *) break ;;
+    esac
+done
+
+PR_NUMBER="${1:?Usage: pr-comments.sh [--repo OWNER/REPO] PR_NUMBER}"
+
+if [[ -z "$REPO" ]]; then
+    REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner)
+fi
+
+# ── Section 1: inline review comments ─────────────────────────────────────
+THREADS_JSON=$(gh api graphql -f query="
+{
+  repository(owner: \"${REPO%%/*}\", name: \"${REPO##*/}\") {
+    pullRequest(number: $PR_NUMBER) {
+      reviewThreads(first: 100) {
+        nodes {
+          id
+          isResolved
+          comments(first: 100) {
+            nodes { databaseId }
+          }
+        }
+      }
+    }
+  }
+}" --jq '.data.repository.pullRequest.reviewThreads.nodes')
+
+# Build a map from every comment ID in every thread → its thread metadata,
+# so replies in a thread also show resolved status (not just the first comment).
+THREAD_MAP=$(echo "$THREADS_JSON" | jq -r '
+  [.[] as $t | $t.comments.nodes[] | {
+    comment_id: .databaseId,
+    thread_id: $t.id,
+    resolved: $t.isResolved
+  }]
+')
+
+INLINE=$(gh api "repos/$REPO/pulls/$PR_NUMBER/comments" --paginate)
+INLINE_COUNT=$(echo "$INLINE" | jq 'length')
+
+echo "════════════════ INLINE REVIEW COMMENTS ($INLINE_COUNT) ════════════════"
+echo "$INLINE" | jq -r --argjson threads "$THREAD_MAP" '
+  .[] | . as $c |
+  ($threads | map(select(.comment_id == $c.id)) | first // {resolved: "unknown", thread_id: "?"}) as $t |
+  "──────────────────────────────────────────────────",
+  "ID: \($c.id)  |  Thread: \(if $t.resolved == true then "RESOLVED" elif $t.resolved == false then "UNRESOLVED" else "?" end)  |  Reply-to: \($c.in_reply_to_id // "none")",
+  "File: \($c.path):\($c.original_line // $c.line // "?")",
+  "Thread ID: \($t.thread_id)",
+  "Author: \($c.user.login)",
+  "",
+  ($c.body | split("\n") | if length > 10 then .[:10] + ["... (truncated)"] else . end | join("\n")),
+  ""
+'
+
+# ── Section 2: issue comments (general PR comments) ───────────────────────
+ISSUE=$(gh api "repos/$REPO/issues/$PR_NUMBER/comments" --paginate)
+ISSUE_COUNT=$(echo "$ISSUE" | jq 'length')
+
+echo ""
+echo "════════════════ ISSUE COMMENTS ($ISSUE_COUNT) ════════════════"
+echo "$ISSUE" | jq -r '
+  .[] |
+  "──────────────────────────────────────────────────",
+  "ID: \(.id)  |  Author: \(.user.login)  |  Created: \(.created_at)",
+  "",
+  (.body | split("\n") | if length > 10 then .[:10] + ["... (truncated)"] else . end | join("\n")),
+  ""
+'
+
+# ── Section 3: top-level reviews with a body ──────────────────────────────
+REVIEWS=$(gh api "repos/$REPO/pulls/$PR_NUMBER/reviews" --paginate)
+REVIEWS_WITH_BODY=$(echo "$REVIEWS" | jq '[.[] | select((.body // "") != "")]')
+REVIEW_COUNT=$(echo "$REVIEWS_WITH_BODY" | jq 'length')
+
+echo ""
+echo "════════════════ TOP-LEVEL REVIEWS ($REVIEW_COUNT) ════════════════"
+echo "$REVIEWS_WITH_BODY" | jq -r '
+  .[] |
+  "──────────────────────────────────────────────────",
+  "Review ID: \(.id)  |  Author: \(.user.login)  |  State: \(.state)  |  Submitted: \(.submitted_at)",
+  "",
+  (.body | split("\n") | if length > 10 then .[:10] + ["... (truncated)"] else . end | join("\n")),
+  ""
+'