ubiquitous-invention/plans/Plan-multitenant-cursor-sync/Epic-cursor-sync-layer/Task-push-pull-job-interface.md

50 lines
1.1 KiB
Markdown
Raw Permalink Normal View History

---
kind: task
slug: push-pull-job-interface
title: Define push/pull sync job interface and feature flags
plan_slug: multitenant-cursor-sync
epic_slug: cursor-sync-layer
status: draft
priority: P1
tenant_id: global
owner: unassigned
cursor_todo_id: null
updated_at: "2026-04-26"
---
# Task summary
Specify the job runner contract: inputs (tenant, mode), outputs (diff counts, errors), idempotency, and `CURSOR_SYNC_*` env toggles from `config/CursorSync.md`.
## Description
Start with **no-op** implementation that logs would-be operations; swap in HTTP client when Cursor API is available. Support **dry-run** flag for operators.
## Subtasks
- [ ] Interface types in `packages/shared` or app server package
- [ ] CLI or internal route `POST .../sync/cursor` with dry-run
- [ ] Structured logs with tenant id on every call
## Owner or assignee
Unassigned
## Status
draft
## Estimation
M
## Acceptance criteria
- [ ] Dry-run never writes to Cursor or DB mapping table.
- [ ] Same request twice is idempotent (no duplicate side effects).
## Links to related Epic / Plan
- Epic: `./Epic-cursor-sync-layer.md`
- Plan: `../Plan-multitenant-cursor-sync.md`