Merge remote-tracking branch 'upstream/main' into fix/remove-invoke-config-timeout

# Conflicts:
#	docs/architecture.md
#	docs/core/invoke.md
#	packages/aws-durable-execution-sdk-python/tests/operation/invoke_test.py

Author: AdityaAudi

.github/DISCUSSION_TEMPLATE/major-releases.yml

@@ -0,0 +1,104 @@
+title: "[Major Release]: "
+labels: ["major-release", "breaking-change"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template to propose a major version release. Major releases include breaking changes
+        that require careful planning, communication, and migration support.
+
+  - type: input
+    id: proposed-version
+    attributes:
+      label: Proposed Version Number
+      description: The target major version number for this release
+      placeholder: "e.g., 2.0.0"
+    validations:
+      required: true
+
+  - type: textarea
+    id: breaking-changes
+    attributes:
+      label: Description of the Breaking Changes
+      description: List all breaking changes included in this release with clear before/after examples
+      placeholder: |
+        1. **Change**: Description of the breaking change
+           - Before: `old_api()`
+           - After: `new_api()`
+
+        2. **Change**: Description of the breaking change
+           - Before: ...
+           - After: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: justification
+    attributes:
+      label: Justification for the Changes
+      description: Explain why these breaking changes are necessary and what problems they solve
+      placeholder: |
+        - Why can't this be done in a backward-compatible way?
+        - What user pain points or technical debt does this address?
+        - What benefits do users gain from upgrading?
+    validations:
+      required: true
+
+  - type: textarea
+    id: consuming-code-changes
+    attributes:
+      label: Changes Needed in Consuming Code
+      description: Describe what consumers of this SDK need to change in their code to adopt the new version
+      placeholder: |
+        - Step-by-step migration instructions
+        - Code examples showing required changes
+        - Any tooling or codemods available to assist migration
+    validations:
+      required: true
+
+  - type: textarea
+    id: inflight-impact
+    attributes:
+      label: Impact to In-flight Executions
+      description: Describe how this release affects durable executions that are currently in progress
+      placeholder: |
+        - Can in-flight executions continue running after upgrade?
+        - Is there a required draining period?
+        - Are checkpointed states compatible across versions?
+        - What happens to executions that are suspended (waiting)?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Explored
+      description: Describe alternative approaches that were considered and why they were not chosen
+      placeholder: |
+        1. **Alternative**: Description
+           - Pros: ...
+           - Cons: ...
+           - Why rejected: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: deprecation-changes
+    attributes:
+      label: Deprecation Changes Required for Previous Versions
+      description: Describe deprecation notices, warnings, or shims that should be added to the current major version before this release
+      placeholder: |
+        - What deprecation warnings should be added to the current release?
+        - What is the proposed deprecation timeline?
+        - Are there compatibility shims or adapters to ease migration?
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other context, timeline considerations, or references
+      placeholder: Additional information...
+    validations:
+      required: false

.github/hooks/pre-commit

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+if hatch fmt --check; then
+    echo "Hatch fmt check passed!"
+else
+    hatch fmt
+    echo "Error: hatch fmt modified your files. Please re-stage and commit again."
+    exit 1
+fi

.github/scripts/__init__.py

@@ -0,0 +1 @@
+

.github/scripts/check_dist_legal_files.py

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+"""Verify built distributions include LICENSE and NOTICE files."""
+
+from __future__ import annotations
+
+import sys
+import tarfile
+import zipfile
+from pathlib import Path
+
+
+REQUIRED_BASENAMES = {"LICENSE", "NOTICE"}
+
+
+def list_archive_names(archive_path: Path) -> list[str]:
+    if archive_path.suffix == ".whl":
+        with zipfile.ZipFile(archive_path) as archive:
+            return archive.namelist()
+
+    if archive_path.suffixes[-2:] == [".tar", ".gz"]:
+        with tarfile.open(archive_path) as archive:
+            return archive.getnames()
+
+    raise ValueError(f"Unsupported distribution type: {archive_path}")
+
+
+def verify_package(package_dir: Path) -> list[str]:
+    dist_dir = package_dir / "dist"
+    errors: list[str] = []
+
+    if not dist_dir.is_dir():
+        return [f"{package_dir}: missing dist directory"]
+
+    archives = sorted(
+        path
+        for path in dist_dir.iterdir()
+        if path.is_file()
+        and (path.suffix == ".whl" or path.suffixes[-2:] == [".tar", ".gz"])
+    )
+    if not archives:
+        return [f"{package_dir}: no built distributions found"]
+
+    for archive_path in archives:
+        names = list_archive_names(archive_path)
+        basenames = {Path(name).name for name in names}
+        missing = sorted(REQUIRED_BASENAMES - basenames)
+        if missing:
+            errors.append(f"{archive_path}: missing {', '.join(missing)}")
+
+    return errors
+
+
+def main(argv: list[str]) -> int:
+    if len(argv) < 2:
+        print(
+            "usage: check_dist_legal_files.py <package-dir> [<package-dir> ...]",
+            file=sys.stderr,
+        )
+        return 2
+
+    errors: list[str] = []
+    for arg in argv[1:]:
+        errors.extend(verify_package(Path(arg)))
+
+    if errors:
+        for error in errors:
+            print(error, file=sys.stderr)
+        return 1
+
+    for arg in argv[1:]:
+        print(f"{arg}: LICENSE and NOTICE found in all distributions")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv))

.github/scripts/ci-checks.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+
+set -e
+
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+cd "$REPO_ROOT"
+
+# --- Core SDK checks ---
+echo "=========================================="
+echo "Running checks for aws-durable-execution-sdk-python"
+echo "=========================================="
+
+hatch run dev-core:cov
+echo "SUCCESS: tests + coverage (core)"
+
+hatch run dev-core:typecheck
+echo "SUCCESS: typings (core)"
+
+# --- OTel SDK checks ---
+echo "=========================================="
+echo "Running checks for aws-durable-execution-sdk-python-otel"
+echo "=========================================="
+
+hatch run dev-otel:cov
+echo "SUCCESS: tests + coverage (otel)"
+
+hatch run dev-otel:typecheck
+echo "SUCCESS: typings (otel)"
+
+# --- Examples checks ---
+echo "=========================================="
+echo "Running checks for examples"
+echo "=========================================="
+
+hatch run dev-examples:test
+echo "SUCCESS: tests (examples)"
+
+# --- Formatting / linting (per package) ---
+PACKAGES=(
+  "packages/aws-durable-execution-sdk-python"
+  "packages/aws-durable-execution-sdk-python-otel"
+  "packages/aws-durable-execution-sdk-python-examples"
+)
+
+for package_dir in "${PACKAGES[@]}"; do
+  full_path="$REPO_ROOT/$package_dir"
+  if [ -d "$full_path" ]; then
+    echo "=========================================="
+    echo "Running formatting/linting for $package_dir"
+    echo "=========================================="
+    cd "$full_path"
+    hatch fmt
+    echo "SUCCESS: linting/fmt ($package_dir)"
+  else
+    echo "WARNING: $package_dir does not exist, skipping fmt"
+  fi
+done
+
+cd "$REPO_ROOT"
+
+# --- Commit message validation ---
+hatch run python .github/scripts/lintcommit.py