Skip to content

docs(#4777): add API surface review guidance - #4778

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/4777-api-surface-review-guidance
Open

fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/4777-api-surface-review-guidance

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Add a Review guidance for public API changes section to the scorecard AGENTS.md after the existing threshold review guidance. The new section instructs the review agent to: (1) verify new public type exports from scorecard-common or scorecard-node have production consumers, (2) flag test-only exports as [medium] and suggest local type aliases, and (3) verify changeset bump level when an author broadens usage to justify the export.

This addresses a gap where the review agent missed an API surface concern that a human reviewer caught on PR #4602.


Closes #4777

Post-script verification

  • Branch is not main/master (agent/4777-api-surface-review-guidance)
  • Secret scan passed (gitleaks — 47ac76dcd418a4003112ccb0032f2274cd46d420..HEAD)
  • Pre-commit hooks passed (authoritative run on runner)
  • Tests ran inside sandbox

Add a Review guidance for public API changes section to the
scorecard AGENTS.md after the existing threshold review guidance.
The new section instructs the review agent to: (1) verify new
public type exports from scorecard-common or scorecard-node have
production consumers, (2) flag test-only exports as [medium] and
suggest local type aliases, and (3) verify changeset bump level
when an author broadens usage to justify the export.

This addresses a gap where the review agent missed an API surface
concern that a human reviewer caught on PR #4602.

Closes #4777
@sonarqubecloud

Copy link
Copy Markdown

@codecov

codecov Bot commented Sep 15, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 63.02%. Comparing base (47ac76d) to head (b0772a3).
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #4778   +/-   ##
=======================================
  Coverage   63.02%   63.02%           
=======================================
  Files        2642     2642           
  Lines      105660   105660           
  Branches    29581    29581           
=======================================
  Hits        66587    66587           
  Misses      38529    38529           
  Partials      544      544           
Flag Coverage Δ *Carryforward flag
adoption-insights 84.77% <ø> (ø) Carriedforward from 47ac76d
ai-integrations 78.80% <ø> (ø) Carriedforward from 47ac76d
app-defaults 54.82% <ø> (ø) Carriedforward from 47ac76d
augment 46.67% <ø> (ø) Carriedforward from 47ac76d
boost 83.46% <ø> (ø) Carriedforward from 47ac76d
bulk-import 73.12% <ø> (ø) Carriedforward from 47ac76d
cost-management 13.53% <ø> (ø) Carriedforward from 47ac76d
dcm 73.47% <ø> (ø) Carriedforward from 47ac76d
e2e-adoption-insights 60.00% <ø> (ø) Carriedforward from 47ac76d
e2e-extensions 62.31% <ø> (ø) Carriedforward from 47ac76d
e2e-global-header 49.71% <ø> (ø) Carriedforward from 47ac76d
e2e-homepage 61.11% <ø> (ø) Carriedforward from 47ac76d
e2e-intelligent-assistant 46.08% <ø> (ø) Carriedforward from 47ac76d
e2e-orchestrator 49.49% <ø> (ø) Carriedforward from 47ac76d
e2e-orchestrator-plugin 49.48% <ø> (ø) Carriedforward from 47ac76d
e2e-quickstart 55.21% <ø> (ø) Carriedforward from 47ac76d
e2e-scorecard 50.05% <ø> (ø) Carriedforward from 47ac76d
e2e-theme 16.36% <ø> (ø) Carriedforward from 47ac76d
extensions 58.30% <ø> (ø) Carriedforward from 47ac76d
global-floating-action-button 71.18% <ø> (ø) Carriedforward from 47ac76d
global-header 67.88% <ø> (ø) Carriedforward from 47ac76d
homepage 48.39% <ø> (ø) Carriedforward from 47ac76d
install-dynamic-plugins 71.77% <ø> (ø) Carriedforward from 47ac76d
intelligent-assistant 77.16% <ø> (ø) Carriedforward from 47ac76d
konflux 91.98% <ø> (ø) Carriedforward from 47ac76d
lightspeed 69.02% <ø> (ø) Carriedforward from 47ac76d
mcp-integrations 84.46% <ø> (ø) Carriedforward from 47ac76d
orchestrator 77.32% <ø> (ø) Carriedforward from 47ac76d
quickstart 63.74% <ø> (ø) Carriedforward from 47ac76d
sandbox 79.56% <ø> (ø) Carriedforward from 47ac76d
scorecard 88.48% <ø> (ø)
theme 87.91% <ø> (ø) Carriedforward from 47ac76d
translations 5.12% <ø> (ø) Carriedforward from 47ac76d
x2a 78.44% <ø> (ø) Carriedforward from 47ac76d

*This pull request uses carry forward flags. Click here to find out more.


Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 47ac76d...b0772a3. Read the comment docs.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@fullsend-ai-review

fullsend-ai-review Bot commented Sep 15, 2026

Copy link
Copy Markdown

🤖 Review · ⚠️ Cancelled · Started 4:19 PM UTC · Ended 4:19 PM UTC

Commit: b0772a3 · View workflow run →

@fullsend-ai-review

fullsend-ai-review Bot commented Sep 15, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 4:20 PM UTC · Completed 4:25 PM UTC

Commit: b0772a3 · View workflow run →

Runtime: claude · Model: opus → claude-opus-4-6 · Cost: $0.58

@fullsend-ai-review

Copy link
Copy Markdown

Review — Approve

Scope: Documentation-only change — 1 file, +22 lines

Summary

This PR adds a "Review guidance for public API changes" section to the scorecard workspace AGENTS.md, directly addressing the gap identified in issue #4777. The retro found that the review agent missed an API surface concern on PR #4602 (a public type export consumed only by test files), and this guidance codifies the check so future reviews catch it on the first pass.

What was reviewed

Dimension Assessment
Correctness ✅ The guidance is logically sound. Both referenced packages (scorecard-common, scorecard-node) exist. The minor bump requirement for new public exports aligns with the repo's changeset policy in .fullsend/AGENTS.md.
Security ✅ No concerns — documentation-only change with no executable content.
Intent & coherence ✅ Tightly scoped to the issue's proposed change. Placement after the existing "Review guidance for threshold changes" section is logical and consistent.
Style & conventions ✅ Heading level (###) matches sibling sections. Bullet formatting, escaped bracket syntax (\[medium\]), and writing style are consistent with existing guidance.
Documentation currency ✅ This is the documentation update itself — content accurately reflects the workspace's package structure and review patterns.
Cross-repo contracts ✅ No impact — internal review guidance only.

Verdict

Clean documentation change that addresses a concrete retro finding. No findings to report.


Labels: Documentation-only change adding review guidance to scorecard AGENTS.md

@fullsend-ai-review fullsend-ai-review Bot added ready-for-merge All reviewers approved — ready to merge documentation Improvements or additions to documentation Review effort 1/5 labels Sep 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation ready-for-merge All reviewers approved — ready to merge ready-for-review Agent PR ready for human review Review effort 1/5 workspace/scorecard

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add public export surface review guidance to scorecard AGENTS.md

0 participants