Deps: record an upstreaming plan for the Anglesite/swift-markdown-engine fork

[davidwkeith]

Context

Package.swift:465-477 pins https://github.com/Anglesite/swift-markdown-engine at badbaa4b — Anglesite's fork of nodes-app/swift-markdown-engine v0.10.0 plus one patch making automatic quote substitution configurable (SpellCheckingPolicy.automaticQuoteSubstitution), because smart quotes corrupt Markdown sources (#797). The comment says upstream is pre-1.0 and its API moves, which is exactly the situation where a fork silently falls behind. Nothing records whether the patch was offered upstream or what would let the fork go.

Ask

Record on this issue and in the Package.swift comment:

1. Upstream PR link for the quote-substitution patch (or open one; it is a small, general-purpose option).
2. The drop condition (e.g. "upstream ≥ 0.11 includes the option").
3. A note on whether tracking upstream's moving API is worth a periodic rebase, or whether the fork is frozen at 0.10.0 by choice.

Related: #797, #796.

---

Filed from the 2026-09-03 tech-debt audit (Phase 1: quick wins, each under a day).

[davidwkeith]

Automated triage (Stage 0): classified as feature (a documentation/process task, not a bug/epic/question). No 🎯 topic label fits well (this is about SwiftPM dependency-fork governance, not a product area), so none applied. State: 🏭 Ready — the ask is well-scoped and self-contained (upstream PR link for the patch, drop condition, rebase-vs-freeze note) with no missing information or cross-repo/schema dependency, so it looks safe for an autonomous fix agent.

---

Generated by Claude Code

[davidwkeith]

Investigated and recorded in Package.swift. Findings:

The fork actually carries two patches on top of v0.10.0, not one — the Package.swift comment only documented the quote-substitution patch:

1. ff54708b — SpellCheckingPolicy.automaticQuoteSubstitution (the one this issue names).
2. badbaa4b — honors autoClosePairsEnabled for the [/[[ bracket auto-close paths in MarkdownLists. Undocumented in the comment until now; presumably added later without updating it.

Upstream PR status:

• Patch 1 (quote substitution): no PR existed. Opened Make automatic quote substitution configurable nodes-app/swift-markdown-engine#174, cherry-picked cleanly onto current upstream main, with an added unit test (SpellCheckingPolicyTests) and CHANGELOG.md entry per upstream's CONTRIBUTING guide. Awaiting review — upstream's CONTRIBUTING.md sets expectations at 1–2 weeks (single maintainer).
• Patch 2 (bracket auto-close): no PR filed. Out of scope for this pass since it wasn't part of the original ask — flagging here so it doesn't fall through the cracks. Confirmed neither patch is present in upstream's current 0.11.0/0.12.0.

Drop condition: once both patches land in a tagged upstream release, bump the pin to that release (or later, per the rebase policy below) and delete the fork.

Rebase policy: the fork is not tracked as a moving branch — bumps are deliberate, matching the SwiftGit2/STTextView-Plugin-Neon policy elsewhere in Package.swift. Upstream has moved to 0.11.0 → 0.12.0 since this fork's 0.10.0 base; that range hasn't been surveyed for anything relevant, so a future bump should be its own review rather than a fast-forward.

Full detail is in the updated Package.swift comment (#1805).