feat(sync): attach tools and skills to variations

[ctawiah]

Context

This layer gives users a direct way to attach an existing LaunchDarkly tool or skill to a variation that is already synchronized in their workspace. The same flow works interactively and through explicit command flags, so it can also be used in non-interactive environments.

What changes

• Adds --attach-tool and --attach-skill to ldcli sync prompt.
• Searches LaunchDarkly for matching tools and skills instead of loading the full catalog locally.
• Lets users search for a project and choose a variation that is already synchronized in the workspace.
• Supports --project and --variation when the caller already knows the target.
• Always fetches the latest tool or skill version before attaching it.
• Saves the attachment file and variation reference together so a failed variation update does not leave an unused file behind.
• Prevents skills from being attached to completion-mode configs because LaunchDarkly only supports them on agent-mode configs.
• Uses one shared attachment flow for tools and skills so another versioned attachment type can follow the same pattern later.

For example:

ldcli sync prompt --attach-tool search-docs
ldcli sync prompt --attach-skill support-guidance --project production --variation support/default

Review focus

• Is the interactive flow clear about selecting a synchronized variation?
• Do explicit flags provide everything needed for non-interactive use?
• Does the command always resolve the latest attachment version before updating the variation?
• Are failed or canceled attachments cleaned up without changing existing local files?
• Is the shared workflow simple enough to extend to another attachment type later?

Verification

• go test ./cmd/sync ./internal/sync/prompt ./internal/sync/local
• go test ./...
• git diff --check

Related changes

Review the stack in this order:

1. Confirm destructive watch actions
2. Guarantee prompt fingerprint convergence
3. Add searchable attachment API foundations
4. Reconcile variation attachments
5. Attach tools and skills to variations
6. Render attachment-aware review output
7. Safely clean unreferenced attachments
8. Persist sync manifests in LaunchDarkly

---

Note

Overview
Adds --attach-tool and --attach-skill to ldcli sync prompt, with optional --project and --variation for non-interactive runs. Bare flags open interactive search against LaunchDarkly (not a full local catalog) and pick among already-synced variations.

Attachment runs before the normal sync pipeline: it loads the latest tool or skill version, writes local attachment files, and updates the variation reference—reusing existing on-disk attachment content when another variation already uses the same key so shared edits are not overwritten. Failed variation updates roll back new attachment files; skills are rejected for completion-mode configs.

Attachment mode is isolated from --add, --detach, --dry-run, --link, and --watch (watch clears one-shot attachment on subsequent runs).

^{Reviewed by Cursor Bugbot for commit 78c89de. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Stale Bugbot comment from a previous run.

[ld-ahartmann]

gave this whole stack some ai review and discussion - no negative feedback from my end! seems like everything in here is pretty isolated from the rest of the cli

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 78c89de. Configure here.}

[cursor]

TTY check uses the wrong stream

Medium Severity

Interactive attach decides whether a terminal is available from stdin and stderr, then renders the project, variation, and attachment pickers on stdout. Redirecting stdout still looks interactive, so the picker runs on a non-TTY. The other sync selectors check the same stream they write to.

 

^{Reviewed by Cursor Bugbot for commit 78c89de. Configure here.}