feat: add durable execution support by j-d-ha · Pull Request #383 · LayeredCraft/minimal-lambda

j-d-ha · 2026-08-01T23:14:03Z

🚀 Pull Request

📋 Summary

Adds optional AWS Lambda Durable Execution support to MinimalLambda through a dedicated MinimalLambda.DurableExecution package and the existing source generator. High-level durable handlers retain MinimalLambda hosting, DI, middleware, serializer, and generated binding behavior while AWS owns checkpoints, replay, suspension, and durable operations.

Support is documented as experimental until managed-service deployment evidence is completed.

🔧 Changes

Adds MapDurableHandler and IDurableContext.GetInvocationContext() public APIs.
Generates deterministic Task and Task<T> durable adapters using AWS DurableFunction.WrapAsync.
Adds durable signature and serializer diagnostics LH0007–LH0011.
Enforces atomic terminal lifecycle and serializer identity through MinimalLambda runtime infrastructure.
Keeps AWS Durable Execution dependency isolated from core package.
Adds package-only consumer matrix, NativeAOT publish smoke, host integration tests, replay workflow tests, source-generator snapshots, and public API/package isolation tests.
Adds buildable example, feature guide, deployment recipes, ADRs, and agent skill guidance.
Adds independent durable-v<semver> trusted-publishing lane with exact artifact, symbol, dependency, version, and collision guards.
Defers dedicated durable project templates until cloud deployment and NativeAOT evidence gates pass.

✅ Checklist

My changes build cleanly
I’ve added/updated relevant tests
I’ve added/updated documentation or README
I’ve followed the coding style for this project
I’ve tested the changes locally

🧪 Validation

Release solution build: 0 warnings, 0 errors
task test:all: 3,838 tests passed
task build:aot-check
task build:package-compat
uv run zensical build --clean --strict
task local:release-dry-run
Amazon.Lambda.Tools 7 ZIP package validation
CloudFormation validate-template for durable SAM template
actionlint for changed publishing workflows
git diff --check

📦 Release Notes

Install MinimalLambda.DurableExecution alongside compatible MinimalLambda and Amazon.Lambda.DurableExecution versions. Durable handlers require exactly one [FromEvent] input, one exact IDurableContext, and Task or Task<T> return.

💬 Notes for Reviewers

Suggested review order:

ADRs and decisions/durable-dependency-support-matrix.md
Public package APIs and package isolation
source-generator discovery, diagnostics, and adapter emission
runtime terminal lifecycle
tests and package compatibility matrix
docs, deployment recipes, and release workflows

AWS resource deployment was intentionally not run. Managed-service create/invoke, PENDING suspension, replay, denied-role behavior, callbacks, cloud NativeAOT, and live middleware evidence remain unverified and are explicitly excluded from production-ready claims. New durable publishing workflow also requires matching NuGet trusted-publisher policy before first release.

j-d-ha

First-pass review.

- Added a suppression for NU1608 in test projects due to NSubstitute version compatibility notes.

- Added missing spaces before closing slashes in all `<PackageVersion>` elements. - Ensured consistent XML formatting for improved readability in `Directory.Packages.props`.

- Updated `GetService` calls in unit tests to include null-forgiving operator (`null!`). - Ensured consistent suppression of nullable reference warnings in test setups.

…durable execution references - Updated tests to support multi-targeting for .NET 8.0, 9.0, 10.0, and 11.0 frameworks. - Added conditional compilation for `DurableExecution` references targeting .NET 10.0 and newer. - Adjusted project file to define `TargetFrameworks` and conditionally include durable references. - Expanded GitHub Actions workflow to test against all targeted frameworks.

- Fixed inconsistent spacing in lambda middleware setup in `MiddlewareOpenTelemetryExtensionsTest`. - Ensured consistent formatting for improved code readability.

Remove durable lifecycle and envelope feature plumbing. Generated handlers now serialize AWS envelopes directly around DurableFunction.WrapAsync.

Replace durable workflow smoke code with an empty executable and explicit trimmer roots.

j-d-ha

Overall feedback is that we need to go back to using our DevOps templates not writing custom workflows If something isn't supported we need to figure out why it's not supported with those Workflows without writing custom workflows for it.

ncipollina

Why did you downgrade all those version?

ncipollina · 2026-08-04T14:36:54Z

@codex review

chatgpt-codex-connector · 2026-08-04T14:44:20Z

Codex Review: Didn't find any major issues. Can't wait for the next one!

Reviewed commit: a228cb8435

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

- Introduced scripts for caveman compression: CLI, main entrypoint, and benchmark tools. - Added validation and token counting utilities to streamline compression. - Implemented prompts and retry logic to handle LLM-guided compression. - Set up detection for compressible files based on heuristics and file type. - Preserved YAML frontmatter and ensured atomic writes for backups. - Included safeguard mechanisms to prevent handling sensitive data or massive files.

ncipollina · 2026-08-05T02:25:02Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: add3b43373

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-08-05T02:34:48Z

+    if h1 != h2:
+        result.add_warning("Heading text/order changed")


Treat changed headings as validation errors

When Claude rewrites or reorders headings without changing the heading count, this path only records a warning, so result.is_valid remains true and compress_file() accepts the output and overwrites the source. This violates the skill's stated exact-heading preservation guarantee; make heading text/order changes an error or have the compressor fail on warnings that represent preservation rules.

Useful? React with 👍 / 👎.

j-d-ha added 30 commits July 30, 2026 12:10

docs: add durable execution architecture decisions

cc6fd19

docs: clarify architecture decision records

291ee96

docs: add examples to durable execution ADRs

f457075

docs: simplify durable execution ADRs

5e416f1

docs: add durable pipeline architecture decision

9f66adc

docs: add durable execution architecture decisions

297e52d

docs: clarify architecture decision records

e2e515e

docs: add examples to durable execution ADRs

cdc80ab

docs: simplify durable execution ADRs

02295b6

docs: pressure-test durable pipeline ADR

c9e9524

docs: clarify durable envelope ownership

8718d2c

docs: accept durable pipeline architecture decision

41e8a45

chore(deps): pin durable execution packages

23e4f84

feat(core): expose invocation serializer

e593dd5

feat(core): enforce durable terminal lifecycle

3358bb3

docs: finalize durable handler contract

e071986

feat: add durable execution package

c71342c

feat: add durable handler API

3ef1467

feat(source-generators): recognize durable handlers

c7c84b7

feat(source-generators): validate durable handlers

48a1000

feat(source-generators): emit durable adapters

f09a991

test(source-generators): expand durable coverage

8718423

test(core): verify durable terminal lifecycle

cdc0e00

test(testing): add durable host integration

2f81fab

test(aot): add durable publish smoke

a32943f

test(durable): verify public runtime APIs

0eab077

test(durable): cover workflow replay semantics

6afab16

docs(examples): add durable execution sample

975a876

docs(durable): document package usage

b3febc5

test(packaging): add durable consumer matrix

7071841

j-d-ha commented Aug 1, 2026

View reviewed changes

j-d-ha added 14 commits August 1, 2026 21:23

fix: address durable execution review feedback

6eca813

fix(tests): suppress NU1608 warning for AutoFixture.AutoNSubstitute

f72d8f4

- Added a suppression for NU1608 in test projects due to NSubstitute version compatibility notes.

chore(deps): fix formatting in shared props file

952ecda

- Added missing spaces before closing slashes in all `<PackageVersion>` elements. - Ensured consistent XML formatting for improved readability in `Directory.Packages.props`.

fix(tests): add null-forgiving operator to suppress nullable warnings

7134d2f

- Updated `GetService` calls in unit tests to include null-forgiving operator (`null!`). - Ensured consistent suppression of nullable reference warnings in test setups.

test(tests): guard compatibility package references

36e4b9e

fix(tests): adjust lambda middleware formatting in unit test

e6788a4

- Fixed inconsistent spacing in lambda middleware setup in `MiddlewareOpenTelemetryExtensionsTest`. - Ensured consistent formatting for improved code readability.

refactor(durable)!: simplify durable handler adapter

e179845

Remove durable lifecycle and envelope feature plumbing. Generated handlers now serialize AWS envelopes directly around DurableFunction.WrapAsync.

test(aot): root libraries for publish analysis

1119938

Replace durable workflow smoke code with an empty executable and explicit trimmer roots.

refactor(durable)!: relax handler signature validation

309386b

fix(durable): bind cancellation tokens and reject duplicate events

f8f9cfb

fix(source-generators): harden durable handler validation

00bf154

fix(source-generators): harden durable handler adapters

795c63c

fix(durable): address review findings

1dae505

j-d-ha commented Aug 4, 2026

View reviewed changes

j-d-ha added 7 commits August 4, 2026 07:23

ci: restore DevOps template workflows

bada7a9

ci(github): document DevOps template policy

fde51be

ci: unify package releases

c284488

test(tests): restore multi-target integration coverage

ebe2365

ci(github): stabilize required PR build check

88c7aa7

ci(github): remove duplicate PR build

11b2f55

docs: preserve contributing formatting

a228cb8

ncipollina requested changes Aug 4, 2026

View reviewed changes

Comment thread .github/workflows/publish-preview.yaml

Comment thread .github/workflows/publish-preview.yaml

j-d-ha added 2 commits August 4, 2026 16:31

ci(github): upgrade DevOps template workflows

add3b43

chatgpt-codex-connector Bot reviewed Aug 5, 2026

View reviewed changes

		if h1 != h2:
		result.add_warning("Heading text/order changed")

Uh oh!

Conversation

j-d-ha commented Aug 1, 2026

🚀 Pull Request

📋 Summary

🔧 Changes

✅ Checklist

🧪 Validation

📦 Release Notes

💬 Notes for Reviewers

Uh oh!

j-d-ha left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

j-d-ha left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ncipollina left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

ncipollina commented Aug 4, 2026

Uh oh!

chatgpt-codex-connector Bot commented Aug 4, 2026

Uh oh!

ncipollina commented Aug 5, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Aug 5, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants