@gurupanguji

Mastodon Embed Phase 1 Implementation Plan

  1. Scan _posts/ for standalone bare Mastodon post URLs.
    • Build the exact candidate set for Phase 1.
  2. Add or extend a normalization script.
    • Detect standalone bare Mastodon post URLs.
    • Convert them into canonical Mastodon embed markup.
    • Skip already-converted embeds and non-Phase-1 shapes.
  3. Update validation.
    • Flag new standalone bare Mastodon post URLs under the policy window.
    • Leave markdown-link-only cases for Phase 2.
  4. Add tests.
    • Detection tests.
    • Conversion tests.
    • Idempotence tests.
    • Validator tests.
  5. Run the Phase 1 normalizer across _posts/.
    • Confirm the issue example is included.
    • Review the changed file list.
  6. Verify locally.
    • Run focused unit tests.
    • Run python3 scripts/validate_posts.py --today 2026-03-27.
  7. Commit, push, and open a PR tied to issue #117.