Module sync 

External tracker sync: orchestration for tix export / tix import, the Tool selector, the CommandRunner spawn seam, and the pure mapping / conflict-resolution rules.

WP05 wires the CLI to glab (GitLab) and linear-cli (Linear) under contracts/external-tools.md. Tokens are resolved through token::resolve with env precedence, injected only as an env pair (never argv), and every error/report surface scrubs the secret as <token>.

The orchestration lives here so it is testable at module granularity by pointing PATH at fake tool scripts; export / import are pure in the sense that they take the store, tool, config and an output sink, and the only externally visible side effects are local issue files, tix.toml, the tool subprocesses, and what is written to out.

Modules

glab

GitLab adapter: shells out to the glab CLI under contracts/external-tools.md (GitLab row). Every contract fabricate template’s command shape is reproduced; the only additions are --output json (needed to parse the create/list responses) and the token env injection.

linear

Linear adapter: shells out to the linear-cli CLI under contracts/external-tools.md (Linear row).

token

Token resolution with the contract’s precedence: env var, then tix.toml [export], then the CLI’s native auth.

Structs

CommandOutcome

The captured result of a spawned external tool.

ProcessRunner

Production runner: std::process::Command with a synchronous output wait.

RemoteIssue

A remote issue parsed from the tracker’s JSON list output.

Enums

Tool

The supported external tracker, selected via --target gitlab|linear.

Traits

CommandRunner

Spawn seam: production uses ProcessRunner; tests inject a FakeRunner that records argv/env without spawning anything.

TrackerAdapter

Common surface both tracker adapters implement so the orchestration is tool-agnostic.

Functions

date_to_epoch_days

Parse YYYY-MM-DD into days since the Unix epoch.

days_from_civil

The inverse of model::civil_from_days (Howard Hinnant’s days_from_civil): calendar date → days since the Unix epoch.

export

tix export: mirror local issues to the remote tracker, recording the remote id back into the local gitlab_id/linear_id so a re-run updates instead of creating duplicates (idempotency, FR-Remote-sync).

import

tix import: pull open remote issues into local files.

is_remote_newer

The conflict rule: the remote wins when its updated_at is strictly later than the local issue’s updated (a YYYY-MM-DD interpreted as end of day). A remote timestamp that cannot be parsed counts as not newer, so the local issue is kept.

iso_to_epoch_secs

Parse an ISO-8601 remote timestamp into epoch seconds. Accepts YYYY-MM-DDTHH:MM:SS (the T may be a space) with optional fractional seconds and a Z or ±HH:MM zone.

local_to_remote_status

Map a local column to the remote state/label sent to the tracker (contracts/external-tools.md mapping table).

remote_status_is_done

Whether the computed remote status conveys “done”.

remote_to_local_status

Map a remote state/label back onto a local column. Closed/Done maps to the effective done column; anything else lands in the column whose name matches (case-insensitive), else the first column — per the contract’s “whose name matches, else into the first column”.

scrub_secret

Redact a resolved secret from text flowing through error/report surfaces.