Skip to content

feat(sitemap): surface per-issue affected URLs; flag short meta descriptions#21

Merged
arberx merged 1 commit intomainfrom
arberx/meta-desc-feedback
Apr 18, 2026
Merged

feat(sitemap): surface per-issue affected URLs; flag short meta descriptions#21
arberx merged 1 commit intomainfrom
arberx/meta-desc-feedback

Conversation

@arberx
Copy link
Copy Markdown
Member

@arberx arberx commented Apr 18, 2026

Summary

  • Technical-SEO analyzer now flags meta descriptions shorter than 120 chars (not just missing ones), recommends a 150–160 char target, and trims over-long descriptions — matching real-world feedback patterns.
  • Sitemap audit report now lists the specific URLs affected by each recommendation via a new additive `topIssues: CrossCuttingIssueDetail[]` field on `CrossCuttingIssue`, and markdown/text formatters render a per-issue URL breakdown; `buildCrossCuttingIssues` is exported for direct use.
  • Bumps version to 1.4.0 (new exported helper + additive report field).

Test plan

  • `pnpm run typecheck`
  • `pnpm test` (91 unit tests, includes new `test/analyzers/technical-seo.test.ts` and `test/sitemap-cross-cutting.test.ts`)
  • `pnpm run test:e2e`
  • `pnpm run lint`
  • Spot-check a real sitemap audit to confirm the per-issue URL breakdown renders as expected in markdown and text output.

🤖 Generated with Claude Code

…scriptions

Makes the technical-seo analyzer flag meta descriptions under 120 chars
(not just missing ones) with a 150–160 char target, matching real-world
feedback patterns. Extends the sitemap audit report so each cross-cutting
issue lists the specific URLs affected by every recommendation, rather
than only reporting factor-level averages. Bumps version to 1.4.0 for the
new exported `buildCrossCuttingIssues` helper and the additive
`topIssues` field on `CrossCuttingIssue`.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@arberx arberx merged commit 825f0d8 into main Apr 18, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant