feat: add Workflow Insight plugin

[wangyb-A]

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

Issue Link, if available

#679

Description

Adds the preview Workflow Insight plugin as a new insight-plugin Maven module.

The plugin emits schema-versioned execution records from the existing Java plugin hooks and matches the JavaScript Workflow Insight contract. It includes:

• deterministic per-execution sampling and on-complete, on-failure, and on-change emission modes
• execution input/output transforms, operation filtering, error controls, and result opt-in transforms
• top-level and full-tree operation detail
• operations-array and operationsByName record shapes
• per-exporter record-size truncation
• Lambda log, Amazon S3, and CloudWatch Logs exporters
• exporter failure isolation and flushing

The implementation uses the invocation operation snapshots, execution payloads, errors, attempts, and serialized operation results already exposed by the Java plugin API. No core hook changes are required.

Demo/Screenshots

No UI change. insight-plugin/README.md contains a usage example. The draft conformance PR linked above contains Java handlers for all 18 Workflow Insight requirements.

Checklist

• I have filled out every section of the PR template
• I have thoroughly tested this change

Testing

Unit Tests

Yes. The module adds 35 tests covering record construction, sampling, emission modes, replay/suspension state, operation filtering, result transforms, aggregation, truncation, exporter requests, failure isolation, and flush behavior.

mvn -q -pl insight-plugin -am test
mvn -q -pl insight-plugin -am clean verify

Both pass.

The full repository reactor also passes:

mvn -q clean verify

Integration Tests

Yes. WorkflowInsightPluginTest exercises the plugin through LocalDurableTestRunner.

The draft Workflow Insight conformance suite was also run against deployed Java 21 Lambda functions in us-west-2:

• S3 operations-array leg: 18 passed, 0 failed
• CloudWatch operationsByName leg: 18 passed, 0 failed

Sink-specific assertions were capability-gated and exercised by the complementary leg.

Examples

The module README includes configuration and exporter usage. Customer-facing conformance handlers are in aws/aws-durable-execution-conformance-tests#73 rather than this repository, following the repository's conformance-test ownership rule.

[zhongkechen]

Use /ai review command to trigger AI review workflows for draft PRs

[wangyb-A]

/ai review

[wangyb-A]

/ai review

[github-actions]

Codex AI review

Nine confirmed issues remain, mainly around checkpoint lifecycle blocking, record fidelity, truncation, and exporter safeguards. Current tests miss important custom-SerDes, null, suspension, and oversized-record paths.

Reviewed commit 7f3bdc4e67fc71884846370ed3fa3b98f5eb4842. Workflow run

[wangyb-A]

The new findings are being tracked in #679

Fix the first 3 blocking issues, the last one is tracked in the 679 and will be implemented in the next PR. @ParidelPooya