sync

Sync

Pull the objective backbone — issues and merged PRs — from the user's tracker and git host, and reconcile it with the ledger. The reconciliation itself is deterministic: a CLI or MCP tool fetches raw JSON, the engine normalizes and diffs it, you present the plan, one confirmation applies it. Prefer CLIs (acli, gh) over MCP tools for the fetch: the same facts arrive with scoped fields in a fraction of the payload, saved to files instead of flowing through context.

Invoke the engine as "${CLAUDE_PLUGIN_ROOT}/bin/waybill" <command>.

Scope rule (non-negotiable)

Query only the current user's own items: issues assigned to them, PRs authored by them, in the projects/repos listed in config.json. Never fetch, store, or summarize individual colleagues' issues, PRs, or statistics, even on request — explain briefly per skills/ledger/references/methodology.md §6 and continue with the user's own data.

Procedure

1. Read config.json for project_keys, repos, default_branch, and last_sync, and identity.json for the identity map. If last_sync is null, default the window to the last 90 days and say so. If identity.json lacks jira_account_id and the Atlassian MCP is connected, fetch the current user's accountId once and write it back — future queries stay scoped to it. (The acli path needs no accountId: currentUser() in the JQL scopes the fetch at the source.)

2. Tracker — Jira. Two fetch paths; prefer the CLI when it is authenticated (acli jira auth status exits 0 — waybill status also reports this):

   acli (Atlassian CLI) — preferred. Two steps keep the payload minimal: search returns only keys, then each item is fetched with exactly the fields sync needs (search's flattened JSON cannot carry custom fields; view is REST-shaped and can):

   acli jira workitem search --json --limit 200 --fields key \
     --jql 'assignee = currentUser() AND project IN (<keys>) AND updated >= "<date>"' \
     > /tmp/waybill-keys.json
   # .issues? (with ?) also handles a bare-array payload without erroring:
   jq -r '(.issues? // .) | .[].key' /tmp/waybill-keys.json | while read -r KEY; do
     acli jira workitem view "$KEY" --json --fields \
       "summary,status,resolutiondate,created,updated,issuetype,parent,assignee,customfield_10016,customfield_10026,customfield_10002,customfield_10020,customfield_10010,customfield_10014,customfield_10011"
   done | jq -s '.' > /tmp/waybill-items.json