internal/

Package atomicfile writes a file via same-directory temp + rename so readers never see a half-written file and an interrupted write cannot truncate an existing one.

Package cli is tk's Cobra command tree, exit codes, signals, and output rules.

Package collision is the pure total order for same-id collision keeper pick.

Package flock provides exclusive, blocking POSIX advisory locks via syscall.Flock.

Package fmmerge is a pure 3-way frontmatter merge over three raw git stage blobs.

Package frontmatter models a ticket file's leading YAML frontmatter.

Package git wraps the external git binary for path-scoped staging, commits, porcelain status, and mid-rebase detection.

Package gitroot derives a directory's enclosing git repository root via the external git binary.

Package gitstate manages per-git-root operational state in machine-local XDG state — never under <git-root>/.git/.

Package id implements the ticket-id wire contract: predicates, crypto/rand short-id mint, and deterministic collision-repair extension.

Package index is tk's machine-wide SQLite read model: a derived, rebuildable store under XDG state (never inside a scope, never synced).

Package integrity is the doctor diagnose report and the shared repair orchestration above pure internal/repair: acquiring entry for doctor, locks-held batch apply + edge_verify for both doctor and sync integrity.

Package order implements fractional-index rank keys whose byte-wise string comparison equals rank order.

Package pathutil holds boundary-safe path predicates over filesystem paths.

Package rebasedriver resolves one conflicted ticket .md at a paused rebase.

Package reconcile is tk's read-through: it brings the derived SQLite index into agreement with ticket files before a command reads it, git-free.

Package registry is the machine-local XDG config tier: which scopes are registered, at which paths, plus the per-scope lens.

Package repair holds deterministic, bit-identical integrity-repair procedures: id-collision loser pick and short-id extension, equal-order and over-long-order re-space, and archive-layout move.

Package resolve implements ambient scope resolution.

Package rewrite is the shared multi-file in-scope rewrite durability engine.

Package scope implements --auto-name derivation from a code-root basename.

Package scopeadmin orchestrates the scope-administration verbs (init, import, rebind, forget, list) over the machine-local registry.

Package scopeconfig evaluates a scope's tk.cue into a validated Schema.

Package scopefile holds scope-directory file policy shared by write verbs, doctor, and sync: allowlist classification, dirty counting, and the per-scope flock path.

Package selfcommit is the single reusable self-commit step for auto-commit scopes.

Package skill holds the agent skill contract printed by `tk skill`.

Package slug implements create-time filename slugify: pure, deterministic, no uniqueness pass.

Package status defines built-in ticket statuses, the closed Category set, and terminal/list/next predicates.

Package syncengine is tk's sole push boundary: selection policy (auto-commit-only filter, unreachable/disabled/config-error reporting, participants grouped by git-root) and the per-root flow (preflight, lock order, snapshot, fetch/integrate, mid-rebase resume, sync-time integrity via integrity.RunBatches, push-if-ahead).

Package testgit runs git in tests under a hermetic config env.

Package title extracts the first ATX H1 from a markdown body.

Package token defines the closed set of machine-readable stderr tokens tk emits at line start.

Package xdg resolves tk's machine-local XDG config/state dirs and the machine-global flock over the config tier.