Skip to content

feat: page-specific factor classification + best-page context (3.1.0)#48

Merged
arberx merged 2 commits into
mainfrom
arberx/fix-page-factor-averaging
Jun 10, 2026
Merged

feat: page-specific factor classification + best-page context (3.1.0)#48
arberx merged 2 commits into
mainfrom
arberx/fix-page-factor-averaging

Conversation

@arberx

@arberx arberx commented Jun 10, 2026

Copy link
Copy Markdown
Member

The sitemap and static cross-cutting rollups now classify each factor as sitewide, limited, or opportunity, so page-specific factors (FAQ, Definition Blocks) are no longer ranked as site-wide failures on a structurally-inflated "affected" count — a present-but-isolated factor becomes a scoped limited tune-up and an absent one a discretionary opportunity. Every cross-cutting issue and fix also carries bestScore/bestPageUrl so a gap reads as "propagate the template from the strongest page" rather than a bare "add it", and the text/markdown reports gain status labels plus a best-page column. schemaVersion is bumped to 2.1 (additive — existing fields unchanged) and the package to 3.1.0, with docs/, the CHANGELOG, and the AEO skill updated to match. It also wires the audited pages into buildPrioritizedFixes from the static-audit path (the call site the new fourth argument missed, which otherwise left limited fixes with an empty affectedPages and a "present on 0 pages" summary), backed by an integration regression test.

🤖 Generated with Claude Code

arberx and others added 2 commits June 9, 2026 21:23
Sitemap and static cross-cutting rollups now classify each factor as sitewide, limited, or opportunity. Page-specific factors (FAQ, Definition Blocks) no longer float to the top of prioritizedFixes on a structurally-inflated "affected" count: a present-but-isolated factor becomes a scoped limited tune-up and an absent one a discretionary opportunity. Every cross-cutting issue and fix also carries bestScore/bestPageUrl so a gap reads as "propagate from the strongest page" rather than a bare "add it". Text/markdown reports gain status labels and a best-page column; schemaVersion bumped to 2.1 (additive), package to 3.1.0, with docs, CHANGELOG, and the skill updated to match.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…atters

An opportunity factor is absent from every audited page, so the Prioritized Fixes line printing "best 0/100 on /" is noise (the Cross-Cutting section already suppresses it). Guard both the text and markdown formatters to skip the best annotation when status is opportunity, and add a formatter regression test covering both.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@arberx arberx merged commit 7f50246 into main Jun 10, 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