Skip to content

docs-sync sentinel: replace dead strike/cooldown model with score-based routing enforcement - #10

Merged
gtupak merged 1 commit into
masterfrom
docs-sync/sentinel-bootstrap
Aug 28, 2026
Merged

docs-sync sentinel: replace dead strike/cooldown model with score-based routing enforcement#10
gtupak merged 1 commit into
masterfrom
docs-sync/sentinel-bootstrap

Conversation

@maia-cloud-agent

@maia-cloud-agent maia-cloud-agent Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR syncs the documentation with the current Sentinel implementation by removing references to a dead "strike → 3 strikes → disqualified → cooldown" model and replacing it with the actual score-based routing enforcement mechanism.

Key Changes

intro/data-quality.mdx

Replay Checks Section:

  • Changed node sampling description from "three randomly selected nodes" to "a sample of nodes" to reflect the actual implementation
  • Removed the outdated strike-based model (strikes → disqualified → cooldown) and replaced it with the score-based approach: nodes receive lower scores for deviations, and nodes falling below the routing threshold are removed from production routing until recovery
  • Clarified that removal is enforced by the routing layer, while Sentinel's role is measurement and scoring

Lag Checks Section:

  • Clarified that lag checks are a separate check issuing eth_blockNumber calls (previously described as happening "during replay checks")
  • Updated normalization reference from "30-day rolling average" to "average block production time"
  • Changed "immediately blacklisted" to "removed from production routing" for severe lag cases
  • Updated scoring language: nodes receive "lower scores" instead of "strikes"

Implementation Details:

  • Replaced the fixed "forces rounds at least once per hour" with adaptive validation frequency based on traffic levels
  • Changed transport failure handling from "do not count as strikes" to "do not penalize a node"

provider/lag-checks.mdx

  • Updated the severe lag consequence from "immediate temporary removal" to "removed from production routing" for consistency with the new model

Purpose

The documentation previously described an outdated model that no longer exists in the codebase. This PR aligns the documentation with the actual Sentinel implementation: a scoring system where nodes are continuously evaluated, and routing decisions are made downstream based on trust scores, rather than a rigid strike count system.

… score-based routing enforcement

- replay samples 'a sample of nodes' (was: three randomly selected)
- deviations lower scores; below routing threshold removed from routing, enforced by router (was: strikes -> disqualified -> cooldown in sentinel)
- lag is a separate check issuing eth_blockNumber, normalized by avg block production time (was: 'during replay checks', '30-day rolling average')
- severe lag -> removed from production routing (was: immediately blacklisted)
- validation frequency adapts to traffic (was: forces rounds at least once per hour)
- provider lag-checks: severe lag removed from production routing; leaves active threshold numbers out
@maia-cloud-agent
maia-cloud-agent Bot requested a review from gtupak August 28, 2026 20:44
@kodus-routemesh-hosted

kodus-routemesh-hosted Bot commented Aug 28, 2026

Copy link
Copy Markdown

Kody Review Complete

Great news! 🎉
No issues were found that match your current review configurations.

Keep up the excellent work! 🚀

Kody Guide: Usage and Configuration
Interacting with Kody
  • Request a Review: Ask Kody to review your PR manually by adding a comment with the @kody start-review command at the root of your PR.

  • Validate Business Logic: Ask Kody to validate your code against business rules by adding a comment with the @kody -v business-logic command.

  • Provide Feedback: Help Kody learn and improve by reacting to its comments with a 👍 for helpful suggestions or a 👎 if improvements are needed.

Current Kody Configuration
Review Options

The following review options are enabled or disabled:

Options Enabled
Bug
Performance
Security
Business Logic

Access your configuration settings here.

@gtupak
gtupak merged commit 7f546c3 into master Aug 28, 2026
3 checks passed
@gtupak
gtupak deleted the docs-sync/sentinel-bootstrap branch August 28, 2026 20:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant