Add hack/sync-mint-embed script to automate embed file sync

[fullsend-ai-retro]

What happened

Renovate opened PR #2854 to bump functions-framework-go from v1.9.0 to v1.9.2 in internal/mint/go.mod. CI ran make lint-all which executes pre-commit run --all-files. The lint-mint-embed-sync hook detected that internal/mint/go.mod and go.sum differ from their .embed counterparts in internal/dispatch/gcf/mintsrc/, printing two DESYNC errors. The PR has been open since 2026-07-01 with auto-merge enabled but blocked by this CI failure. No human or agent review occurred because CI never passed.

What could go better

The repo has hack/lint-mint-embed-sync to detect desync but no companion script to fix it. The AGENTS.md documents a manual copy process for syncing these files. This means any change to internal/mint/ — whether from Renovate, a code agent, or a human — requires manual knowledge of the embed sync requirement. A fixer script would enable automation (Renovate postUpgradeTasks, pre-commit auto-fix hooks) and reduce the cognitive burden on contributors.

Proposed change

Create hack/sync-mint-embed that performs the inverse of the lint script:

1. For each non-test file in internal/mint/, copy it to internal/dispatch/gcf/mintsrc/<name>.embed. For go.mod, apply the replace-directive rewrite (=> ../mintcore → => ./mintcore) before writing.
2. For each non-test file in internal/mintcore/, copy it to internal/dispatch/gcf/mintsrc/mintcore/<name>.embed.
3. Add a Makefile target sync-mint-embed: hack/sync-mint-embed.

The logic should mirror hack/lint-mint-embed-sync exactly (same file iteration, same go.mod special case, same test-file exclusion) to guarantee that running sync followed by lint always succeeds.

Validation criteria

Running hack/sync-mint-embed && hack/lint-mint-embed-sync exits 0 after any modification to files in internal/mint/ or internal/mintcore/. Verify by modifying internal/mint/go.mod and confirming the sync script updates internal/dispatch/gcf/mintsrc/go.mod.embed with the correct replace-directive rewrite.

---

Generated by retro agent from #2854

[fullsend-ai-triage]

🤖 Finished Triage · ✅ Success · Started 7:54 PM UTC · Completed 7:58 PM UTC
Commit: 0a95cac · View workflow run →

[fullsend-ai-triage]

Triage Summary

Category: Feature — new automation script
Severity: Medium

Problem

The repo has hack/lint-mint-embed-sync to detect desync between mint source files and their .embed copies, but no companion script to fix it. This blocks automated workflows (Renovate PR #2854 is currently stuck) and requires manual knowledge of the sync process.

Recommended Implementation

Create hack/sync-mint-embed mirroring the lint script's logic:

1. Iterate non-test files in internal/mint/, copy each to internal/dispatch/gcf/mintsrc/<name>.embed
2. For go.mod, rewrite the replace directive (=> ../mintcore → => ./mintcore) before writing
3. Iterate non-test files in internal/mintcore/, copy each to internal/dispatch/gcf/mintsrc/mintcore/<name>.embed
4. Add a Makefile target sync-mint-embed

The existing lint script at hack/lint-mint-embed-sync serves as the reference implementation — the sync script should use identical file iteration, test-file exclusion, and go.mod special-case handling.

Proposed Test

# Modify a source file, sync, then verify lint passes
echo '# test comment' >> internal/mint/go.mod
hack/sync-mint-embed
hack/lint-mint-embed-sync  # should exit 0

# Verify go.mod rewrite
grep '=> ./mintcore' internal/dispatch/gcf/mintsrc/go.mod.embed

# Verify test files are excluded
ls internal/dispatch/gcf/mintsrc/*_test.go.embed 2>/dev/null && echo FAIL || echo PASS

Related

• Issue Configure Renovate postUpgradeTasks to sync mint embed files after Go dependency updates #2966 (Renovate postUpgradeTasks) depends on this script being available
• PR fix(deps): update module github.com/googlecloudplatform/functions-framework-go to v1.9.2 #2854 (Renovate dependency bump) is currently blocked by the missing sync

---

Labels: Mint embed sync automation script touching component/mint and component/dispatch, filed as a type/chore maintenance task with medium priority.

[ralphbean]

/fs-code

[fullsend-ai-coder]

🤖 Finished Code · ❌ Failure · Started 8:00 PM UTC · Completed 8:07 PM UTC
Commit: 0a95cac · View workflow run →