Skip to content

Dangling #meta-block anchor: 3 consumers reference a slug with no host heading #1088

Description

@michael-wojcik

What

The #meta-block anchor is referenced by 3 consumers across the plugin instruction files, but no host heading exists that yields that slug — the fragment is dangling (file-existence link tests pass; fragment resolution is untested).

Surfaced during the wake/idle ordering-hardening PREPARE sweep (anchor/cross-ref inventory over pact-plugin/**/*.md), where it was ruled out-of-scope drift (pre-existing, not co-located with the edited sections).

Fix sketch

Either:

  1. Add the missing host heading (e.g. ### META-BLOCK) at the canonical META-BLOCK definition site in protocols/pact-completion-authority.md — NOTE: that file is a byte-compared extract; the heading must land in the same commit in its pact-protocols.md SSOT region (scripts/verify-protocol-extracts.sh gates it), or
  2. Re-point the 3 referrers at an existing heading's slug.

Option 1 preferred: the referrers' intent is "the META-BLOCK rule", which deserves a stable anchor.

Acceptance criteria

  • #meta-block (or the replacement slug) resolves to a real heading in every referring file's target
  • Extract/SSOT byte-parity maintained (verify script green)
  • Consider a slug-derivation presence pin in tests/test_wake_ordering_pinned.py style so the anchor cannot silently dangle again

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions