/**
 * Worktree-sync SSOT for tagged result codes and shared record types.
 *
 * Every worktree-sync operation reports its outcome through one of these string-literal codes in
 * a typed result -- callers branch on `code`, NEVER on message/stderr substrings. Git stderr is
 * carried alongside as evidence for humans, not as a branch condition.
 */
/** Cap on `WorktreeSyncEpoch.changedPaths`; beyond it the list is truncated and overlap checks
 * treat the land as conservatively overlapping EVERYTHING (deterministic, never optimistic). */
export declare const EPOCH_CHANGED_PATHS_CAP = 500;
/** Branch namespace for lane branches: `pi/wt/<laneKey>`. */
export declare const LANE_BRANCH_PREFIX = "pi/wt/";
export type WorktreeSyncCode = "ok" | "disabled" | "not_a_git_repo" | "default_branch_unresolved" | "hub_missing" | "invalid_lane_key" | "lane_exists" | "lane_not_found" | "max_lanes_reached" | "lane_dirty" | "hub_dirty" | "stale_lane" | "sync_required" | "sync_clean" | "sync_conflicts" | "rebase_in_progress" | "no_rebase_in_progress" | "conflict_markers_present" | "gate_command_unset" | "gate_failed" | "lane_changed_during_gate" | "ff_failed" | "lock_busy" | "lock_takeover" | "nothing_to_land" | "main_mutation_refused" | "lane_unlanded_work" | "worktree_missing" | "released" | "reconciled" | "git_error" | "role_forbidden" | "path_outside_lane" | "lane_owner_conflict";
/**
 * A refusal/failure outcome. `message` is deterministic text assembled from facts (safe to show a
 * model verbatim); `gitStderr` is bounded raw evidence; `paths` names offending files where the
 * refusal is about specific files (dirty files, conflict markers); `holder` identifies the
 * integration-lock holder on `lock_busy`.
 */
export interface WorktreeSyncRefusal<C extends WorktreeSyncCode = WorktreeSyncCode> {
    code: C;
    message: string;
    gitStderr?: string;
    paths?: string[];
    holder?: IntegrationLockOwner;
}
/** Staleness-propagation policy (D9). `on_land_mandatory` is the default: every land marks every
 * other active lane sync_required. `overlap_mandatory` requires it only on changed-file overlap.
 * `land_time_only` keeps staleness advisory until the land gate (G3 always enforces). */
export type WorktreeSyncPolicy = "on_land_mandatory" | "overlap_mandatory" | "land_time_only";
/** One lane registration record (`lanes/<laneKey>.json`). Identity/binding fields ONLY -- git
 * truths (freshness, dirtiness, ahead/behind) are always re-derived live, never stored here. */
export interface LaneRegistration {
    laneKey: string;
    branch: string;
    worktreePath: string;
    status: "active" | "released" | "orphaned";
    createdAt: string;
    updatedAt: string;
    goalId?: string;
    requirementId?: string;
    /** Host `LaneRecord.laneId` after dispatch correlation (tmux/in-process worker binding). */
    boundLaneId?: string;
    ownerPid?: number;
    ownerSessionId?: string;
}
/** `epoch.json` -- the integration epoch. `epoch` is monotonic messaging/audit sugar; correctness
 * always derives from git shas (`merge-base --is-ancestor`), never from this counter. */
export interface WorktreeSyncEpoch {
    epoch: number;
    mainSha: string;
    previousMainSha?: string;
    landedLaneKey?: string;
    landedAt?: string;
    changedPaths: string[];
    changedPathsTruncated: boolean;
}
/** Live, git-derived facts about one lane. Computed fresh per call -- there is no cached copy to
 * go stale, which is the point. */
export interface LaneFacts {
    laneKey: string;
    branch: string;
    worktreePath: string;
    registrationStatus: LaneRegistration["status"];
    /** Lane branch tip sha; undefined when the branch no longer exists. */
    branchSha?: string;
    /** True iff current main is an ancestor of the lane tip (`merge-base --is-ancestor`). */
    fresh: boolean;
    /** True when `status --porcelain` in the lane worktree is non-empty. */
    dirty: boolean;
    rebaseInProgress: boolean;
    aheadOfMain: number;
    behindMain: number;
    worktreePresent: boolean;
    /** Undefined when the lane has no recorded owner pid. */
    ownerAlive?: boolean;
}
export interface IntegrationLockOwner {
    pid: number;
    hostname: string;
    /** Random acquisition identity; PID/session are diagnostic only and never authorize release. */
    token: string;
    sessionId?: string;
    laneKey?: string;
    acquiredAt: string;
}
export type IntegrationLockAcquisition = {
    acquired: true;
    takeover: boolean;
    token: string;
} | {
    acquired: false;
    holder?: IntegrationLockOwner;
    holderAlive: boolean;
};
/** One conflicted file in a sync stopped on conflicts. */
export interface ConflictWorklistFile {
    path: string;
    /** Both-modified is the common case; add/add and modify/delete surface as their index states. */
    kind: "both_modified" | "both_added" | "deleted_by_us" | "deleted_by_them" | "unknown";
    /** True when git rerere already replayed a recorded resolution for this file -- review, not re-resolve. */
    resolvedByRerere: boolean;
}
/** Structured conflict worklist returned when a sync/continue stops on conflicts. */
export interface ConflictWorklist {
    /** e.g. "2/5" -- rebase progress (stopped step / total steps). */
    step: string;
    stoppedAtCommit?: {
        sha: string;
        subject: string;
    };
    files: ConflictWorklistFile[];
}
export type BindLaneWorkerResult = {
    code: "bound";
    laneKey: string;
    laneId: string;
} | {
    code: "already_bound";
    laneKey: string;
    laneId: string;
} | {
    code: "binding_conflict";
    laneKey: string;
    boundLaneId: string;
} | {
    code: "lane_not_found";
    message: string;
} | {
    code: "lane_not_active";
    message: string;
} | {
    code: "store_error";
    message: string;
};
export type CreateLaneResult = {
    code: "ok";
    lane: LaneRegistration;
} | WorktreeSyncRefusal<"not_a_git_repo" | "default_branch_unresolved" | "invalid_lane_key" | "lane_exists" | "max_lanes_reached" | "git_error">;
export type ReleaseLaneResult = {
    code: "released";
    laneKey: string;
} | WorktreeSyncRefusal<"not_a_git_repo" | "default_branch_unresolved" | "lane_not_found" | "lane_unlanded_work" | "lane_owner_conflict" | "git_error">;
export interface LandingTransaction {
    laneKey: string;
    priorMainSha: string;
    testedTipSha: string;
    changedPaths: string[];
    changedPathsTruncated: boolean;
    lockToken: string;
    gate: "passed" | "off";
    stage: "ready_to_merge" | "main_moved" | "epoch_written" | "audit_logged";
}
export interface ReconcileSummary {
    code: "reconciled";
    orphanedLaneKeys: string[];
    reRegisteredLaneKeys: string[];
    ownerClearedLaneKeys: string[];
    staleLockReleased: boolean;
}
export type ReconcileResult = ReconcileSummary | WorktreeSyncRefusal<"not_a_git_repo" | "default_branch_unresolved" | "git_error">;
export type SyncLaneResult = {
    code: "sync_clean";
    laneKey: string;
    alreadyFresh: boolean;
    autoContinued: number;
} | {
    code: "sync_conflicts";
    laneKey: string;
    worklist: ConflictWorklist;
} | WorktreeSyncRefusal<"not_a_git_repo" | "default_branch_unresolved" | "lane_not_found" | "worktree_missing" | "lane_dirty" | "rebase_in_progress" | "git_error">;
export type ContinueSyncResult = {
    code: "sync_clean";
    laneKey: string;
    autoContinued: number;
} | {
    code: "sync_conflicts";
    laneKey: string;
    worklist: ConflictWorklist;
} | WorktreeSyncRefusal<"not_a_git_repo" | "default_branch_unresolved" | "lane_not_found" | "worktree_missing" | "no_rebase_in_progress" | "conflict_markers_present" | "git_error">;
export type AbortSyncResult = {
    code: "ok";
    laneKey: string;
} | WorktreeSyncRefusal<"not_a_git_repo" | "default_branch_unresolved" | "lane_not_found" | "no_rebase_in_progress" | "git_error">;
export type LandResult = {
    code: "ok";
    laneKey: string;
    epoch: number;
    mainSha: string;
    gate: "passed" | "off";
} | WorktreeSyncRefusal<"not_a_git_repo" | "default_branch_unresolved" | "lane_not_found" | "worktree_missing" | "rebase_in_progress" | "lane_dirty" | "stale_lane" | "hub_missing" | "hub_dirty" | "gate_command_unset" | "gate_failed" | "lane_changed_during_gate" | "ff_failed" | "lock_busy" | "nothing_to_land" | "lane_owner_conflict" | "git_error">;
/** One lane's full status entry: live git facts plus registry identity plus policy derivation. */
export interface LaneStatusEntry extends LaneFacts {
    goalId?: string;
    requirementId?: string;
    boundLaneId?: string;
    /** Not fresh: main moved past this lane's base. Derived, never stored. */
    stale: boolean;
    /** Stale AND the active policy makes syncing mandatory NOW (G8 gates on this). */
    syncRequired: boolean;
    /** Lane-changed files intersecting the last land's changed files (conservatively the whole
     * lane-changed list when the epoch's changedPaths were truncated). */
    overlapWithLastLand: string[];
}
/** The deterministic full picture (`status` action): everything an agent would otherwise infer
 * probabilistically from porcelain output, computed mechanically. */
export interface SyncStatus {
    code: "ok";
    mainBranch: string;
    mainSha: string;
    epoch: number;
    hub?: {
        path: string;
        clean: boolean;
    };
    lock: {
        held: boolean;
        holder?: IntegrationLockOwner;
        holderAlive?: boolean;
    };
    lanes: LaneStatusEntry[];
    /** One deterministic advisory sentence assembled from the codes above; never model-generated. */
    advice?: string;
}
export type SyncStatusResult = SyncStatus | WorktreeSyncRefusal<"not_a_git_repo" | "default_branch_unresolved" | "git_error">;
//# sourceMappingURL=codes.d.ts.map