docs: mark cross-host presence experimental - #107
Open
myobie wants to merge 1 commit into
Open
Conversation
myobie
marked this pull request as ready for review
July 30, 2026 21:54
25 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Cross-host presence is not reliable enough to serve as health or lifecycle authority. Under ordinary content replication, a same-value status refresh may update host-local freshness metadata without changing file bytes; a remote observer can then age the unchanged value to
unknown. The current replication mechanism gap is tracked in compoundingtech/fabric#27.What
st2 agents --helpunknownas no fresh observation, not proof that an agent or host is unhealthyImpact
This changes help text only. It does not change presence calculation, status refresh, doctor behavior, reconciliation, restart, teardown, service behavior, catalog data, or runtime state. It introduces no peer type or health classification.
Checks
cargo run --quiet -- agents --help— rendered wording inspectedcargo test --test status_agents -- --nocapture— 4 passedcargo test --lib status::tests -- --nocapture— 9 passedcargo clippy --test status_agents -- -D warnings -A clippy::too_many_arguments— passed; the allowance is for an unrelated current-main lint ineval_run::wait_donegit diff --check— passedcargo fmt --check— current-main baseline remains broadly red across unrelated files; this patch does not reformat themBase:
c6846f6239329f0803142afc06c15a07b93937c1.