cflx 0.6.322

Conflux – a spec-driven parallel coding orchestrator that runs AI agents on git worktrees
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

//! Opt-in cumulative-base upstream integration for `cflx run`.
//!
//! This subsystem is installed **only** when the operator passes `-u` /
//! `--integrate-upstream` to cumulative parallel `cflx run`. When the option is
//! absent no object from this module is constructed, so the existing execution
//! path performs no additional fetch, merge, verification, lifecycle event, or
//! push.
//!
//! The module is split so that every routing decision is a pure function or a
//! port-driven state machine:
//!
//! - [`options`]: invocation-scoped CLI contract and static startup validation.
//! - [`trailers`]: `Cflx-Upstream-*` identity trailer format and validation.
//! - [`classify`]: repository-state classification (merge outcome, ancestry,
//!   `git push --porcelain` per-ref status, `git status --porcelain=v2`).
//! - [`spine`]: first-parent cumulative-history classification.
//! - [`checkpoint`]: deterministic base-lane checkpoint triggering/batching.
//! - [`ports`]: the Git/verification/repair boundaries the coordinator drives.
//! - [`coordinator`]: the Conflux-owned integration and finalization workflow.
//! - [`repair`]: dedicated upstream textual/semantic repair goal and prompt.
//! - [`git_ops`]: real Git implementation of [`ports::UpstreamGit`].
//! - [`verify`]: real verification-command implementation.
//!
//! Unit coverage drives [`coordinator::UpstreamCoordinator`] through in-memory
//! fakes; real Git/worktree/bare-remote behavior is covered by heavy E2E tests.

pub mod checkpoint;
pub mod classify;
pub mod coordinator;
pub mod git_ops;
pub mod options;
pub mod ports;
pub mod publication;
/// Repository-local benchmark proving bounded recovery discovery stays constant
/// in Git subprocess count. Heavy: ignored unless `heavy-tests` is enabled.
#[cfg(test)]
mod recovery_benchmark;
pub mod repair;
pub mod spine;
pub mod startup;
pub mod trailers;
pub mod verify;

pub use checkpoint::{CheckpointDecision, CheckpointScheduler, CheckpointTrigger};
pub use classify::{
    classify_merge_outcome, classify_push_failure, classify_upstream_revision, MergeOutcomeClass,
    PushFailureClass, UpstreamRevisionClass,
};
pub use coordinator::{SchedulerOutcome, UpstreamCoordinator, UpstreamStepOutcome};
pub use options::{
    resolve_frontend_upstream_config, resolve_upstream_config, validate_static_preconditions,
    StaticPreconditions, UpstreamIntegrationConfig, UpstreamOptionError, DEFAULT_UPSTREAM_REMOTE,
};
pub use publication::{
    format_publication_marker_message, parse_publication_trailers, PublicationEvidence,
    PublicationTrailers, TRAILER_PUBLISH_BRANCH, TRAILER_PUBLISH_CHANGE, TRAILER_PUBLISH_REMOTE,
};
pub use spine::{classify_spine_commit, SpineCommitClass};
pub use startup::{
    ensure_no_unpushed_upstream_recovery, prepare_upstream_integration, UpstreamRuntime,
    UpstreamStartupError,
};
pub use trailers::{
    format_upstream_merge_message, parse_upstream_trailers, UpstreamTrailers, TRAILER_BRANCH,
    TRAILER_REMOTE, TRAILER_SHA,
};