PLATFORM_git-port-plumbing-cutover

[flyingrobots]

Migrated from a local Wesley Method backlog card after adopting METHOD v2.1.0 tracker doctrine.

• Source path: docs/method/backlog/up-next/PLATFORM_git-port-plumbing-cutover.md
• Original filesystem lane: up-next
• Canonical Method lane label: lane:asap
• Legend: PLATFORM
• Migration issue: Migrate Wesley Method backlog to GitHub Issues #548
• Migrated on: 2026-06-04

Original Local Backlog Card

PLATFORM_git-port-plumbing-cutover

Why

Wesley now carries the invariant that all Git operations must cross a GitPort
boundary and be backed by @git-stunts/plumbing.

The 2026-04-17 audit shows the repo currently violates that invariant in
runtime code, test helpers, and repo tooling.

Done when

• one sanctioned Wesley GitPort exists
• the only real adapter behind that port is backed by
  @git-stunts/plumbing
• Holmes no longer shells out to git directly
• repo tooling no longer shells out to git directly
• temp-repo tests use fake ports or plumbing-backed helpers rather than raw
  spawnSync('git', ...)
• hook and test-runner boundaries scrub inherited GIT_* env as defense in
  depth

Evidence

• git-port-plumbing-boundary
• 2026-04-17 git-port-plumbing-boundary audit

[coderabbitai]

🔗 Related PRs

#369 - fix(holmes): make CLI tests deterministic by disabling git activity [merged]
#375 - fix(holmes): git adapter security and reliability improvements [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[flyingrobots]

Triage decision: keep this in Wesley and move it out of the inbox into lane:v0.4.0 / Goalpost: Make It Boring.

Rationale: Git-port plumbing is platform infrastructure work and should be scheduled, not left in bad-code.

This is scheduled core Wesley work now, not an inbox item. The triage label is being removed as part of this state change.