feat: add migrate-customizations command (ADR-0064)

[guyoron1]

Mirrored from fullsend-ai/fullsend#2971 — costwise baseline tracking

Summary

Implement the fullsend agent migrate-customizations command to automate migration from deprecated customized/ directory overlays to config-driven agent registration (ADR-0064).

Context

• ADR-0064: Deprecates customized/ overlays
• ADR-0058: Config-driven agent registration
• ADR-0045: Harness base composition model

Scope

• fullsend agent migrate-customizations command with --dry-run and --repo flags
• Harness diff engine (DiffHarness) that computes minimal composition harness from upstream/customized pair
• Three migration paths: dead overrides (delete), custom agents (move + register), modified standard agents (base: composition)
• PR creation via GitHub API with branch, commit, and PR body
• Deprecation notices on affected documentation

Implementation

• PR feat(cli): add migrate-customizations command fullsend-ai/fullsend#2954

[guyoron1]

/fs-triage

[fullsend-ai-triage]

🤖 Finished Triage · ✅ Success · Started 2:06 PM UTC · Completed 2:08 PM UTC
Commit: a9ab22d · View workflow run →

[fullsend-ai-triage]

Triage: Blocked on upstream PR

This issue mirrors upstream fullsend-ai#2971, which tracks the fullsend agent migrate-customizations command (ADR-0064).

The upstream implementation is already in progress:

• PR feat(cli): add migrate-customizations command fullsend-ai/fullsend#2954 was the original implementation but was closed — it was superseded by PR feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932, which includes additional safety checks (duplicate destination detection, nil pointer guards in diff.go, per-agent directory filtering).
• PR feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932 (feat(cli): add migrate-customizations command for ADR-0064) is currently open and under review upstream. It covers the full scope described here: harness diff engine, all three migration paths, --dry-run support, forge interface additions (ListBranches), and documentation updates.

No additional implementation work should be dispatched until PR fullsend-ai#2932 is merged upstream. Once it lands, this mirror issue can be resolved by syncing the upstream changes.

Blocked by:

• feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932

Blocked by:

• feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932

[guyoron1]

/fs-triage

[fullsend-ai-triage]

🤖 Finished Triage · ✅ Success · Started 4:24 PM UTC · Completed 4:25 PM UTC
Commit: 6a1b34d · View workflow run →

[fullsend-ai-triage]

Triage: Still blocked on upstream PR

Re-triage confirms the prior assessment. This issue mirrors upstream fullsend-ai#2971, and the implementation is already in progress:

• PR feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932 (feat(cli): add migrate-customizations command for ADR-0064) remains open and under active review (23 comments, labeled requires-manual-review). It covers the full scope: harness diff engine, all three migration paths, --dry-run support, forge interface additions (ListBranches), and documentation updates.

No implementation work should be dispatched on this mirror issue until the upstream PR is merged. Once it lands, this issue can be resolved by syncing the upstream changes.

Blocked by:

• feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932

Blocked by:

• feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932

[guyoron1]

/fs-triage

[guyoron1]

/fs-triage

[github-actions]

Triage: Still blocked on upstream PR

Re-triage confirms the prior assessment — no new information has changed the dependency.

Upstream PR fullsend-ai#2932 (feat(cli): add migrate-customizations command for ADR-0064) is still open and labeled requires-manual-review. It covers the entire scope of this issue:

• Harness diff engine (internal/harness/diff.go)
• All three migration paths: dead overrides (delete), custom agents (move + register), modified standard agents (base composition)
• --dry-run and --repo flags
• Forge interface additions (ListBranches)
• Documentation updates across ADRs, guides, and architecture docs

No implementation work should be dispatched here until the upstream PR is merged. Once it lands, this mirror issue can be resolved by syncing the upstream changes.

Blocked by:

• feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932

Blocked by:

• feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932

[guyoron1]

/fs-triage

[guyoron1]

/fs-triage

[github-actions]

Triage: Still blocked on upstream PR

Re-triage confirms all prior assessments — no new information has changed the dependency.

Upstream PR fullsend-ai#2932 (feat(cli): add migrate-customizations command for ADR-0064) is still open and labeled requires-manual-review. It covers the entire scope of this issue:

• Harness diff engine (internal/harness/diff.go)
• All three migration paths: dead overrides (delete), custom agents (move + register), modified standard agents (base composition)
• --dry-run and --repo flags
• Forge interface additions (ListBranches)
• Documentation updates across ADRs, guides, and architecture docs

No implementation work should be dispatched here until the upstream PR is merged. Once it lands, this mirror issue can be resolved by syncing the upstream changes.

Blocked by:

• feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932

Blocked by:

• feat(cli): add migrate-customizations command for ADR-0064 fullsend-ai/fullsend#2932