th-19cca5: th pearls sync — two-way sync with Smoo Projects work items

[brentrager]

Problem

Pearls moved to a machine-local SQLite file (#522, th-d3e842) and lost Dolt's push/pull. The Smoo Projects work-items API (smoo work, 09766e3) is the shared home now; smooth-diver's direct Jira client is the wrong seam once smoo work jira import exists.

Solution

th pearls sync [--project <KEY|uuid>] [--pull-only|--push-only] [--dry-run] [--json] [--org] — one explicit, offline-first reconcile verb (crates/smooth-cli/src/pearls_sync.rs).

• Identity: new sync_map table in pearls.db (pearl_id ↔ remote_id + per-side updated_at baselines). Pushed items carry externalRef = th-xxxxxx@<checkout-dir>; a fresh machine adopts by ref (and keeps the pearl id when free) instead of duplicating. Project binding lives in the store's per-project config (sync.project_id / sync.project_key); sync.last_pull_at is the updatedSince cursor.
• Field map: title/description/labels/parent; status closed↔done, deferred↔blocked (in_review/cancelled fold in on pull and are never demoted on push); priority inverted (pearl P0 ↔ work item 4); epic survives as a label; deps → blocks links on the blocker; comments both ways with a pearl-comment:<id> first line to stop echoes.
• Conflicts: "changed" = differs from the last-sync baseline (clock skew between laptop and server must not hide an edit), timestamps only break ties, newer wins, the loser is listed under conflict: — never silent. Create-on-first-sight both ways. Nothing is ever deleted on either side; orphans are reported under skipped:.
• th pearls push/pull notices now point at th pearls sync. smooth-diver is left in place; docs mark th jira sync legacy.

Depends on the smooai side (SmooAI/smooai PR for SMOODEV-3128: labels, external_ref, externalRef/label/updatedSince list filters). Against today's prod API a sync still works but can't adopt by ref (no externalRef yet) and pulls full pages instead of incrementally.

Verification

• cargo fmt --check, cargo clippy (no new hits in touched files), cargo test -p smooai-smooth-cli -p smooai-smooth-pearls → 796 + 203 pass, pnpm format:check.
• Tests: mapping round-trips (status/priority/type/labels/external ref/comment marker), and an in-process axum mock of the work-items API covering pull-create (+deps +comments, echo filtered), push-create (externalRef, blocks link, marked comment), updates both ways, conflict logged + newer wins, adoption by externalRef, free-id reuse, dry-run writes nothing, push-only reports remote-newer, delete-safety (DELETE routes assert 0 calls).
• Smoke against real api.smoo.ai (read-only): th pearls sync --project SMOODEV --dry-run --json from the smooth checkout → would create 3027 local pearls (the Jira-imported SMOODEV items) and push 1541 pearls; 0 conflicts; ~10s. A real first run should target a dedicated Smoo project per repo (e.g. key SMOOTH), not SMOODEV.

Landing

Rebased onto main after #522 landed; auto-merge armed. Checkpoints (th-9483e8, smooth-checkpoint: comments) ride along through comment sync. Pearl th-19cca5.

🤖 Generated with Claude Code

https://claude.ai/code/session_01M9HmiTg9pYARWUdaXYasqq

[changeset-bot]

🦋 Changeset detected

Latest commit: d149ec2

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@smooai/smooth	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR