Skip to content

[P2 docs] Fix generated AB4100 diagnostics reference to include Amp as a built-in target #756

Description

@ScriptedAlchemy

Drift found during #754 capability audit

Main 14c9822bc6c01d8ff2788454d0e1dc7861bc3816 has Amp in the production default registry, but docs/diagnostics.md still says AB4100's built-in registry publishes only claude, codex, cursor, and portable, and its recovery text lists only those four.

The Rspress reference/diagnostics.md page is generated from this repository contract, so the stale source propagates into the public docsite even though reference/configuration.mdx, targets-artifacts.mdx, and #754's capability guide correctly list all five targets.

Required correction

  • Add amp to AB4100's built-in-target statement and recovery list.
  • Search docs/diagnostics.md for other exhaustive built-in-target enumerations that predate Amp and correct only current contract prose; do not rewrite historical changesets.
  • Regenerate/verify both locale diagnostics pages through the normal docsite generation path rather than hand-editing generated website/docs/*/reference/diagnostics.md output.
  • Add or retain a guard that compares the documented exhaustive target set with createDefaultRegistry().names() (or another canonical source) so the next built-in adapter cannot silently drift the generated reference.
  • Preserve portable as the default and preserve the fact that plugin is not a target.

Acceptance

Built diagnostics reference lists amp, claude, codex, cursor, portable for AB4100 and no current recovery text tells an Amp author that amp is unknown. Run locale/link/docs generation gates. This is documentation-contract drift only; no target or diagnostic behavior change is requested.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions