merge: integrate messaging R2 polling producer

# Conflicts:
#	docs/superpowers/specs/2026-07-28-messaging-production-capability-design.md
#	src/app-bootstrap/gradle.lockfile
#	src/app-bootstrap/src/test/java/dev/caskeleton/bootstrap/architecture/ArchitectureViolationFixtureTest.java
#	src/build.gradle
This commit is contained in:
donghyeon-ka
2026-08-01 00:04:02 +09:00
92 changed files with 10591 additions and 54 deletions
@@ -0,0 +1,170 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:dev.caskeleton:messaging:build-evidence-manifest:v1",
"title": "Messaging build evidence manifest v1",
"type": "object",
"additionalProperties": false,
"required": [
"schemaVersion",
"sourceDigest",
"artifactDigest",
"producerTask",
"scenarioIds",
"counts",
"command",
"generatedAt",
"hashes",
"failures",
"skips",
"unsupportedClaims"
],
"properties": {
"schemaVersion": {
"type": "integer",
"const": 1
},
"sourceDigest": {
"$ref": "#/$defs/sha256"
},
"artifactDigest": {
"$ref": "#/$defs/sha256"
},
"producerTask": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^verifyMessaging[A-Za-z0-9]+$",
"enum": [
"verifyMessagingContracts",
"verifyMessagingJsonSchemaV1",
"verifyMessagingPollingOutboxR2",
"verifyMessagingKafkaProducerR2",
"verifyMessagingSecurityR2",
"verifyMessagingReleaseProfile",
"verifyMessagingTargetBindingPreflight",
"verifyMessagingTargetBinding",
"verifyMessagingDeploymentCutover",
"verifyMessagingCleanupTargetBinding",
"verifyMessagingFinalR2Profile"
]
},
"scenarioIds": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"$ref": "#/$defs/identifier"
}
},
"counts": {
"type": "object",
"additionalProperties": false,
"required": [
"executed",
"passed",
"failed",
"skipped"
],
"properties": {
"executed": {
"type": "integer",
"minimum": 1
},
"passed": {
"type": "integer",
"minimum": 0
},
"failed": {
"type": "integer",
"minimum": 0
},
"skipped": {
"type": "integer",
"minimum": 0
}
}
},
"command": {
"type": "string",
"minLength": 1,
"maxLength": 2048
},
"generatedAt": {
"type": "string",
"format": "date-time"
},
"hashes": {
"type": "object",
"additionalProperties": false,
"required": [
"profile",
"catalog",
"schema",
"settings"
],
"properties": {
"profile": {
"$ref": "#/$defs/sha256"
},
"catalog": {
"$ref": "#/$defs/sha256"
},
"schema": {
"$ref": "#/$defs/sha256"
},
"settings": {
"$ref": "#/$defs/sha256"
}
}
},
"failures": {
"type": "array",
"items": {
"$ref": "#/$defs/result"
}
},
"skips": {
"type": "array",
"items": {
"$ref": "#/$defs/result"
}
},
"unsupportedClaims": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#/$defs/identifier"
}
}
},
"$defs": {
"sha256": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"identifier": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$"
},
"result": {
"type": "object",
"additionalProperties": false,
"required": [
"scenarioId",
"reason"
],
"properties": {
"scenarioId": {
"$ref": "#/$defs/identifier"
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 512
}
}
}
}
}
@@ -0,0 +1,30 @@
schemaVersion: 1
profiles:
- profileId: messaging-first-r2-polling-producer.v1
semanticContractId: messaging-outbox-publish.v1
selectedCardIds:
- messaging-outbox-publish.v1
- kafka-spring-acknowledged-idempotent.v1
- postgresql-polling-outbox.v2
- postgresql-per-record-jit-claim.v1
- json-schema-envelope.v1
- external-topic-validated.v1
- kafka-sasl-ssl-scram-sha-512.v1
- kafka-compression-none.v1
- per-key-normal-path-sequence-detectable.v1
- same-postgresql-transaction-resource.v1
- authenticated-internal-web-disposition.v1
dispatchProfile: postgresql-polling-outbox.v2
claimProfile: postgresql-per-record-jit-claim.v1
serializationProfile: json-schema-envelope.v1
producerProfile: kafka-spring-acknowledged-idempotent.v1
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topicProfile: external-topic-validated.v1
compressionProfile: kafka-compression-none.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
transactionProfile: same-postgresql-transaction-resource.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
requiredScenarios:
- messaging.interaction.append-encode-claim-ack.v1
- messaging.interaction.indeterminate-hold-disposition.v1
- messaging.interaction.shutdown-drain.v1
+381
View File
@@ -0,0 +1,381 @@
schemaVersion: 1
cards:
- cardId: messaging-outbox-publish.v1
cardVersion: 1
phase: P1
semanticContractIds:
- messaging-outbox-publish.v1
providerId: provider-neutral
providerVersion: 1
maturity: not-implemented
guarantees:
- transactional-append-before-publication
- explicit-terminal-or-operator-disposition
explicitNonGuarantees:
- consumer-deduplication
- global-ordering
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: bounded-first-r2.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingContracts
requiredScenarios:
- messaging.contract.transactional-append.v1
- messaging.contract.explicit-disposition.v1
runbookIds:
- runbook.messaging-terminal-delivery-disposition.v1
owner: application-core
- cardId: kafka-spring-acknowledged-idempotent.v1
cardVersion: 1
phase: P3
semanticContractIds:
- messaging-outbox-publish.v1
providerId: spring-kafka
providerVersion: 4
maturity: not-implemented
guarantees:
- broker-acknowledgement-observed
- finite-producer-settings
explicitNonGuarantees:
- duplicate-free-delivery
- global-ordering
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: per-record-jit-bounded.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingKafkaProducerR2
requiredScenarios:
- messaging.kafka.ack-metadata.v1
- messaging.kafka.indeterminate-outcome.v1
runbookIds:
- runbook.messaging-producer-unavailable-or-unauthorized.v1
owner: adapter-outbound-messaging
- cardId: postgresql-polling-outbox.v2
cardVersion: 2
phase: P2
semanticContractIds:
- messaging-outbox-publish.v1
providerId: postgresql-polling
providerVersion: 2
maturity: not-implemented
guarantees:
- immutable-event-mutable-delivery-split
- fenced-publication-authority
explicitNonGuarantees:
- zero-duplicate-delivery
- global-ordering
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: per-record-jit-bounded.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingPollingOutboxR2
requiredScenarios:
- messaging.polling.delivery-lifecycle.v2
- messaging.polling.authority-fence.v1
runbookIds:
- runbook.messaging-outbox-backlog-and-stale-lease.v1
owner: adapter-outbound-persistence-jpa
- cardId: postgresql-per-record-jit-claim.v1
cardVersion: 1
phase: P2
semanticContractIds:
- messaging-outbox-publish.v1
providerId: postgresql-jit-claim
providerVersion: 1
maturity: not-implemented
guarantees:
- one-record-claim-after-local-admission
- token-and-unexpired-lease-cas
explicitNonGuarantees:
- distributed-strict-fifo
- duplicate-free-delivery
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: admitted-record-upper-bound-one.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingPollingOutboxR2
requiredScenarios:
- messaging.polling.jit-claim.v1
- messaging.polling.stale-token-rejected.v1
runbookIds:
- runbook.messaging-outbox-backlog-and-stale-lease.v1
owner: adapter-outbound-persistence-jpa
- cardId: json-schema-envelope.v1
cardVersion: 1
phase: P1
semanticContractIds:
- messaging-outbox-publish.v1
providerId: json-schema-envelope
providerVersion: 1
maturity: implemented-candidate
guarantees:
- deterministic-utf8-envelope
- closed-offline-schema-catalog
explicitNonGuarantees:
- alternate-wire-format
- dynamic-contract-discovery
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: bounded-envelope-and-payload.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: "sha256:42040504d5c204f9ee0e01bfa17fd9a03182db13f8f99e31b63ec79d5ecc40d0"
settingsDigest: "sha256:fcd849322d43a8d88c926a43160296339cbc6e945db81e46c513ab45d185b924"
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingContracts
- verifyMessagingJsonSchemaV1
requiredScenarios:
- messaging.schema.envelope-valid.v1
- messaging.schema.adversarial-bounds.v1
runbookIds:
- runbook.messaging-schema-poison-or-record-too-large.v1
owner: adapter-outbound-messaging
- cardId: external-topic-validated.v1
cardVersion: 1
phase: P4
semanticContractIds:
- messaging-outbox-publish.v1
providerId: external-kafka-topic
providerVersion: 1
maturity: not-implemented
guarantees:
- external-topic-policy-attested
- exact-destination-binding
explicitNonGuarantees:
- automatic-topic-creation
- multi-cluster-failover
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: finite-topic-catalog.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingSecurityR2
requiredScenarios:
- messaging.topic.policy-attestation.v1
- messaging.topic.below-min-isr-rejection.v1
runbookIds:
- runbook.messaging-topic-policy-or-partition-change.v1
owner: adapter-outbound-messaging
- cardId: kafka-sasl-ssl-scram-sha-512.v1
cardVersion: 1
phase: P4
semanticContractIds:
- messaging-outbox-publish.v1
providerId: kafka-sasl-ssl-scram-sha-512
providerVersion: 1
maturity: not-implemented
guarantees:
- authenticated-encrypted-broker-transport
- least-privilege-producer-principal
explicitNonGuarantees:
- encryption-at-rest
- credential-zero-downtime-without-drill
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: bounded-secret-refresh.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingSecurityR2
requiredScenarios:
- messaging.security.sasl-ssl-scram.v1
- messaging.security.least-privilege-negative-probe.v1
runbookIds:
- runbook.messaging-shutdown-deploy-and-secret-rotation.v1
owner: adapter-outbound-messaging
- cardId: kafka-compression-none.v1
cardVersion: 1
phase: P3
semanticContractIds:
- messaging-outbox-publish.v1
providerId: kafka-compression-none
providerVersion: 1
maturity: not-implemented
guarantees:
- exact-uncompressed-producer-profile
explicitNonGuarantees:
- compression-ratio
- compression-throughput
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: bounded-record-size.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingKafkaProducerR2
requiredScenarios:
- messaging.kafka.compression-none-effective.v1
runbookIds:
- runbook.messaging-producer-unavailable-or-unauthorized.v1
owner: adapter-outbound-messaging
- cardId: per-key-normal-path-sequence-detectable.v1
cardVersion: 1
phase: P2
semanticContractIds:
- messaging-outbox-publish.v1
providerId: aggregate-sequence-header
providerVersion: 1
maturity: not-implemented
guarantees:
- per-key-sequence-gap-detectable
explicitNonGuarantees:
- strict-fifo-through-failure
- cross-key-ordering
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: bounded-sequence-metadata.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingPollingOutboxR2
requiredScenarios:
- messaging.ordering.per-key-sequence.v1
runbookIds:
- runbook.messaging-delivery-indeterminate-and-duplicate-burst.v1
owner: application-core
- cardId: same-postgresql-transaction-resource.v1
cardVersion: 1
phase: P2
semanticContractIds:
- messaging-outbox-publish.v1
providerId: same-postgresql-transaction-resource
providerVersion: 1
maturity: not-implemented
guarantees:
- business-write-and-outbox-append-atomic
explicitNonGuarantees:
- cross-database-atomicity
- broker-transaction-atomicity
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: one-transaction-resource.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingPollingOutboxR2
requiredScenarios:
- messaging.persistence.same-resource-rollback.v1
runbookIds:
- runbook.messaging-outbox-backlog-and-stale-lease.v1
owner: app-bootstrap
- cardId: authenticated-internal-web-disposition.v1
cardVersion: 1
phase: P3
semanticContractIds:
- messaging-outbox-publish.v1
providerId: authenticated-internal-web-disposition
providerVersion: 1
maturity: not-implemented
guarantees:
- authenticated-operator-disposition
- audited-generation-cas
explicitNonGuarantees:
- raw-status-update
- unauthenticated-operator-access
outcomeTaxonomyVersion: outbox-publication-outcome.v1
orderingProfile: per-key-normal-path-sequence-detectable.v1
resourceBounds: bounded-operator-request.v1
automaticPublicationAge: finite-required
sameEventRequeueHorizon: finite-required
securityProfile: kafka-sasl-ssl-scram-sha-512.v1
topologyProfile: external-topic-validated.v1
lifecycleProfile: bounded-startup-shutdown.v1
operatorControlProfile: authenticated-internal-web-disposition.v1
schemaSetHash: ""
settingsDigest: ""
evidenceFingerprint: ""
evidenceTasks:
- verifyMessagingKafkaProducerR2
requiredScenarios:
- messaging.operator.authenticated-disposition.v1
- messaging.operator.stale-generation-rejected.v1
runbookIds:
- runbook.messaging-terminal-delivery-disposition.v1
owner: adapter-inbound-web
@@ -0,0 +1,55 @@
schemaVersion: 1
releaseProfiles:
- releaseProfileId: messaging-first-r2-polling-producer-release.v1
compatibilityProfileId: messaging-first-r2-polling-producer.v1
selectedCardIds:
- messaging-outbox-publish.v1
- kafka-spring-acknowledged-idempotent.v1
- postgresql-polling-outbox.v2
- postgresql-per-record-jit-claim.v1
- json-schema-envelope.v1
- external-topic-validated.v1
- kafka-sasl-ssl-scram-sha-512.v1
- kafka-compression-none.v1
- per-key-normal-path-sequence-detectable.v1
- same-postgresql-transaction-resource.v1
- authenticated-internal-web-disposition.v1
requiredCardMaturity: release-eligible
expectedProfileHash: ""
expectedCatalogHash: ""
expectedSchemaHash: ""
expectedSettingsHash: ""
requiredEvidenceTasks:
- verifyMessagingContracts
- verifyMessagingJsonSchemaV1
- verifyMessagingPollingOutboxR2
- verifyMessagingKafkaProducerR2
- verifyMessagingSecurityR2
- verifyMessagingReleaseProfile
- verifyMessagingTargetBindingPreflight
- verifyMessagingTargetBinding
- verifyMessagingDeploymentCutover
- verifyMessagingCleanupTargetBinding
- verifyMessagingFinalR2Profile
requiredScenarios:
- messaging.release.contracts-schema.v1
- messaging.release.polling-outbox.v2
- messaging.release.kafka-producer.v1
- messaging.release.security-topology.v1
- messaging.release.shutdown-rotation.v1
runbookIds:
- runbook.messaging-producer-unavailable-or-unauthorized.v1
- runbook.messaging-outbox-backlog-and-stale-lease.v1
- runbook.messaging-delivery-indeterminate-and-duplicate-burst.v1
- runbook.messaging-schema-poison-or-record-too-large.v1
- runbook.messaging-terminal-delivery-disposition.v1
- runbook.messaging-topic-policy-or-partition-change.v1
- runbook.messaging-shutdown-deploy-and-secret-rotation.v1
- runbook.messaging-legacy-to-v2-relay-authority-cutover.v1
evidencePolicy:
rejectMissing: true
rejectSkipped: true
rejectStale: true
rejectWrongSource: true
rejectMismatchedProfile: true
maximumAgeSeconds: 86400