feat(cli): effa sync family for effect-app/shared content

[patroza]

Summary

Add three subcommands to the effa CLI for syncing content (architecture docs, e2e helpers, ts-plugins) from effect-app/shared into consuming projects.

• effa sync — pull artifacts per project-side .shared.json lockfile. Caches the shared repo at ~/.cache/effa/shared/<slug>, checks out the pinned ref, copies files into project paths (honoring exclude list).
• effa sync-diff — sha256 compare each tracked file against the cache copy. Reports M (modified locally) / D (missing from project) / E (excluded).
• effa sync-push [--pr] [-m msg] [--branch name] — detect modified files, create a branch off the pinned ref in the cache, copy modified files in, commit, push. Optional --pr opens a PR via gh pr create.

Architecture

• New module: src/sync-shared.ts — syncShared, syncDiff, syncPush + shared helpers ensureCache, walkArtifacts.
• Wired into src/index.ts as three flat subcommands (matches existing sync-effect convention).
• Lockfile shape:

  {
    "repo": "github.com/effect-app/shared",
    "ref": "<sha>",
    "artifacts": { "<src-in-shared>": "<dest-in-project>" },
    "exclude": ["<src-path>"]
  }

Validation

• Tested against effect-app/boilerplate (companion PR Sync infrastructure: adopt effect-app/shared content boilerplate#51).
• effa sync is idempotent; second run produces no diff.
• effa sync-diff correctly reports drift for excluded/missing files.

Test plan

• pnpm build clean
• Smoke effa sync in a project with .shared.json
• Smoke effa sync-diff (should be clean post-sync)
• Smoke effa sync-push --pr w/ a test edit (creates branch + PR upstream)

Notes

MVP: effa sync overwrites destination files (no conflict detection beyond sync-diff reporting). Caller reviews via git status post-sync. Follow-ups: 3-way merge / safer overwrite mode, templates-diff support.

🤖 Generated with Claude Code

[pkg-pr-new]

Open in StackBlitz

@effect-app/cli

npm i https://pkg.pr.new/effect-app/libs/@effect-app/cli@764

effect-app

npm i https://pkg.pr.new/effect-app/libs/effect-app@764

@effect-app/eslint-codegen-model

npm i https://pkg.pr.new/effect-app/libs/@effect-app/eslint-codegen-model@764

@effect-app/eslint-shared-config

npm i https://pkg.pr.new/effect-app/libs/@effect-app/eslint-shared-config@764

@effect-app/infra

npm i https://pkg.pr.new/effect-app/libs/@effect-app/infra@764

@effect-app/vue

npm i https://pkg.pr.new/effect-app/libs/@effect-app/vue@764

@effect-app/vue-components

npm i https://pkg.pr.new/effect-app/libs/@effect-app/vue-components@764

commit: 088a51b