Skip to content

[A3S Cloud/H0] Certify JetStream delivery and credential rotation #1

Description

@ZhiXiao-Lin

Cloud gate

H0 — production delivery evidence for a highly available control plane.

Planning reference: https://github.com/A3S-Lab/Cloud/blob/e2a05b7f1f63486b2fda866b22aa84eea89aadb4/docs/development-plan.md

Problem

Cloud relies on Event for durable relay and cross-process delivery. H0 requires proof that the JetStream provider preserves the documented contract through reconnects, redelivery, credential rotation, consumer drift, and poison messages.

Scope

  • Add real JetStream integration tests for reconnect, redelivery, deduplication, acknowledgement loss, and dead-letter handling.
  • Support credential rotation and reconnect without losing or duplicating logical delivery state.
  • Detect and report durable-consumer configuration drift before silently changing delivery semantics.
  • Preserve correlation, causation, tenant, and schema-version metadata end to end.
  • Define schema-evolution behavior for compatible, unknown, and rejected event versions.
  • Export delivery lag, redelivery, dead-letter, reconnect, and consumer-health metrics.

Acceptance criteria

  • Tests run against a real NATS JetStream server and cover server and client restart.
  • Duplicate transport delivery remains visible to consumers while the logical deduplication contract is deterministic.
  • Rotating credentials recovers within a bounded interval without message loss.
  • Poison messages reach a diagnosable dead-letter path without blocking unrelated subjects.
  • Metrics and errors contain no credential or event-payload secrets.

Non-goals

  • Cloud business-event schemas.
  • Exactly-once side effects across arbitrary consumers.
  • A Cloud-specific workflow engine.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions