Conversation
…ill mode to sitemap (1.7.1) Library users calling runAeoAudit on a site's homepage missed per-page issues like duplicate singleton @types — those problems live on subpages, not the homepage. The schema-validity analyzer detected them correctly when pointed at an affected page, but the README's Programmatic Usage section only showed runAeoAudit, so callers had no obvious path to site-wide validation. - README Programmatic Usage now documents runSitemapAudit alongside runAeoAudit, leading with the scope distinction and a concrete crossCuttingIssues / affectedUrls example. - Schema mode in skills/aeo/SKILL.md defaults to sitemap mode (--sitemap --top-issues) for site-wide schema requests; single-URL form preserved for cases where the user names one specific page. - Bumps to 1.7.1 with matching CHANGELOG entry. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
runAeoAudit('https://site.com')on a homepage silently missed per-page issues — duplicate singleton@types, JSON parse errors, and missing schema on individual templates — because those live on subpages. Theschema-validityanalyzer was already correct when pointed at an affected page; the gap was that the README's Programmatic Usage section only showedrunAeoAudit, so site-wide auditing wasn't discoverable.runSitemapAuditalongsiderunAeoAudit, leads with the scope distinction, and shows a concretecrossCuttingIssues/affectedUrlsexample.skills/aeo/SKILL.mddefaults to--sitemap --top-issuesfor site-wide schema requests, mirroring the same scope guidance for skill users; single-URL form preserved.Test plan
pnpm run typecheck,pnpm run lint,pnpm test— all 146 tests passrunSitemapAuditexample end-to-end:node bin/aeo-audit.js https://ainyc.ai --sitemap --top-issues --factors schema-validitysurfaces "Duplicate FAQPage" with all 13 of 22 affected subpages listed🤖 Generated with Claude Code