fix: changelog generation - #292

#!/bin/bash
set -euo pipefail

echo "== file list =="
git ls-files | rg 'packages/site/(app/changelog/feed.xml/route.ts|lib/changelog/(github-client|release-markdown))'

echo "== route outline =="
ast-grep outline packages/site/app/changelog/feed.xml/route.ts --view compact || true

echo "== route relevant lines =="
cat -n packages/site/app/changelog/feed.xml/route.ts | sed -n '1,90p'

echo "== release-markdown =="
cat -n packages/site/lib/changelog/release-markdown.ts | sed -n '1,220p'

echo "== github-client release shape =="
ast-grep outline packages/site/lib/changelog/github-client.ts --view compact || true
rg -n "loadChangelogReleases|release\.body|description|body" packages/site/lib/changelog/github-client.ts packages/site/app/changelog/feed.xml/route.ts

#!/bin/bash
set -euo pipefail

echo "== github-client relevant lines =="
cat -n packages/site/lib/changelog/github-client.ts | sed -n '80,145p'
cat -n packages/site/lib/changelog/github-client.ts | sed -n '160,200p'

echo "== release-markdown exports and rest =="
cat -n packages/site/lib/changelog/release-markdown.ts | sed -n '1,280p'

echo "== search for render/release-markdown exports in repository =="
rg -n "renderReleaseMarkdownToHtml|release-markdown|markdownToHtml|markdown-to-html|remark|github\\-actions\\-release\\-markdown|@.*markdown|escapeXml\\(" packages/site

#!/bin/bash
set -euo pipefail

echo "== changelog page imports and ReleaseMarkdown usage =="
cat -n "packages/site/app/changelog/[version]/page.tsx" | sed -n '1,140p'

echo "== components/blog/release-markdown.tsx =="
cat -n "packages/site/components/blog/release-markdown.tsx" | sed -n '1,180p'

echo "== package json dependencies =="
cat -n packages/site/package.json | sed -n '1,90p'

echo "== package-lock/npm lock files =="
git ls-files | rg '(^|/)package-lock\.json$|(^|/)pnpm-lock\.yaml$|(^|/)yarn\.lock$|(^|/)bun\.lockb?$'

echo "== lockfile remark versions if present =="
for f in package-lock.json packages/site/package-lock.json pnpm-lock.yaml bun.lock bun.lockb yarn.lock; do
  if [ -f "$f" ]; then
    echo "-- $f --"
    rg -n '"remark"|remark@|remark-gfm|remark-mdx' "$f" | head -80 || true
  fi
done

#!/bin/bash
set -euo pipefail

echo "Locate files:"
fd -a 'release-markdown|changelog-components|release.*\.(ts|tsx)$' . | sed 's#^\./##' | head -100

echo
echo "Inspect targeted file outline and relevant source:"
if [ -f packages/site/components/blog/release-markdown.tsx ]; then
  wc -l packages/site/components/blog/release-markdown.tsx
  ast-grep outline packages/site/components/blog/release-markdown.tsx || true
  sed -n '1,180p' packages/site/components/blog/release-markdown.tsx
fi

echo
echo "Search remarkReleaseStructure:"
rg -n "remarkReleaseStructure|ReleaseStructure|release.*structure|heading" packages/site lib packages 2>/dev/null | head -200

#!/bin/bash
set -euo pipefail

echo "Inspect changelog release-markdown implementation:"
sed -n '1,240p' packages/site/lib/changelog/release-markdown.ts

echo
echo "Inspect changelog components tests around release markdown:"
sed -n '1,140p' packages/site/components/blog/__tests__/changelog-components.test.tsx

echo
echo "Find release detail/list page usage and body normalization:"
rg -n "ReleaseMarkdown|body:|stripLeadingReleaseHeading|remarkReleaseStructure" packages/site -g '*.tsx' -g '*.ts'

#!/bin/bash
set -euo pipefail

echo "Inspect remainder of remarkReleaseStructure implementation:"
sed -n '240,340p' packages/site/lib/changelog/release-markdown.ts

echo
echo "Inspect changelog version page body source:"
sed -n '1,180p' packages/site/app/changelog/[version]/page.tsx

echo
echo "Run a read-only semantic probe of the markdown parser behavior from source:"
python3 - <<'PY'
from pathlib import Path
p = Path('packages/site/lib/changelog/release-markdown.ts')
s = p.read_text()
checks = {
    "remaps heading depth to HTML element": 'depth 2 -> "h2"' in s or '"h2"' in s[s.find("remarkReleaseStructure"):],
    "remaps heading depth to HTML element": 'depth 3 -> "h3"' in s or 'node.tagName = "h3"' in s[s.find("remarkReleaseStructure"):],
    "normalizes heading levels before react-markdown": '"depth" in node' in s[s.find("remarkReleaseStructure"):s.find("remarkReleaseStructure", s.find("remarkReleaseStructure") + 1)],
}
# Since the source output truncated before the transformer body, print search diagnostics only for requested identifiers.
for token in ["remarkReleaseStructure", "node.depth", "node.tagName", '"depth"', "depth --"]:
    print(f"{token}: {s.count(token)} occurrences")
PY

#!/bin/bash
set -euo pipefail

echo "== locate release markdown and package deps =="
fd -a 'release-markdown\.tsx$|package\.json$' . | sed 's#^\./##' | head -100

echo
echo "== relevant package files =="
for f in $(fd 'package\.json$' . | head -20); do
  if rg -q 'react-markdown|remark' "$f" 2>/dev/null; then
    echo "--- $f ---"
    rg -n '"react-markdown"|remark|rehype' "$f"
  fi
done

echo
echo "== target file context =="
target=$(fd 'release-markdown\.tsx$' packages/site | head -1 || true)
if [ -n "$target" ]; then
  wc -l "$target"
  sed -n '1,130p' "$target" | cat -n
fi

echo
echo "== usages of components/code/pre in package/site =="
rg -n "react-markdown|components=\{|code: props =>|pre: props =>|syntax-highlight|mdx|code-block|next-mdx|fumadocs|react-syntax|highlight" packages/site packages -g '*.{ts,tsx,jsx,js,json,md,mdx}' | head -200

#!/bin/bash
set -euo pipefail

echo "== mdx block / shiki files =="
cat -n packages/ui/src/components/custom/code-block.tsx | sed -n '1,220p'
echo
cat -n packages/ui/src/lib/shiki-highlighter.ts | sed -n '1,160p'

echo
echo "== mdx component wiring =="
cat -n packages/site/mdx-components.tsx | sed -n '1,160p'
echo
cat -n packages/site/source.config.ts | sed -n '1,120p'

echo
echo "== rehype-pretty-code usage =="
rg -n "rehype-pretty-code|CodeToRaw|codeToTokens|highlightCompozyCode|pre.*className|code-block|mdx-blocks" packages/ui packages/site -g '*.{ts,tsx}' | sed -n '1,200p'

#!/bin/bash
set -euo pipefail

echo "== changelog plugin tests =="
target=$(fd 'release-markdown\.test\.tsx$|release-markdown\.test\.ts$|changelog-components\.test\.tsx$|changelog-components\.test\.ts$' packages/site | head -20 || true)
echo "$target"
for f in $target; do
  echo "--- $f ---"
  wc -l "$f"
  rg -n "h2|h3|h4|h5|h6|release|markdown|heading|##|code|pre|fenced|block" "$f" | sed -n '1,240p'
done