[ctawiah]

Context

Link needs a step that validates everything and writes nothing, so that the command can show a preview first.

What changes

• Add the link package. Prepare validates the target, the source path, the format, the mapping, and the compiled projection.
• Write publishes the descriptor only after the review.

Design notes

• Prepare reads only the named file and its static dependencies.

Review focus

• Can Prepare write any file?

Verification

• make build
• go test ./...
• golangci-lint run ./...

Related changes

1. refactor(sync): remove Phase 1 source references #1005: Phase 1 reference removal
2. feat(sync): add projection and problem core #987: projection and problem core
3. feat(sync): add the adapter core and the Markdown adapter #988: adapter core and Markdown
4. feat(sync): add the structured document adapters #989: structured adapters
5. feat(sync): add the Python adapter #991: Python adapter
6. feat(sync): add the TypeScript and JavaScript adapters #992: TypeScript and JavaScript adapters
7. feat(sync): add source descriptor storage #993: descriptor storage
8. feat(sync): compile and publish repository sources #994: compile and publish
9. feat(sync): detach descriptor-backed sources #1003: descriptor detach
10. This PR: link preparation
11. feat(sync): integrate repository sources with planning and link #995: planning and link
12. feat(sync): add the link commands #998: link commands

🤖 Generated with Claude Code

---

Note

Overview
Adds internal/sync/link, a two-phase workflow for linking repository source files to LaunchDarkly descriptor refs: Prepare validates the target, builds the reference, compiles the source, and renders descriptor bytes without writing, and Write / Rollback handle publish and undo after review.

Prepare snapshots any existing descriptor and, on relink, carries forward tools and skills from the current file so relinking file/select/map does not drop attachments. Write publishes via WriteDescriptorFrom only if on-disk state still matches the snapshot (ErrorStateChanged when another writer wins). Rollback restores the prior descriptor or removes a new one only when this process actually wrote, so refused or skipped writes do not clobber a concurrent link.

Tests cover preview-without-write, concurrent-write refusal, rollback semantics, and tools/skills preservation.

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

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[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 64ba2d4. Configure here.}