Skip to content

docs: ADR-0032 — propose durable/Azure Functions repo extraction - #7247

Merged
cgillum merged 7 commits into
mainfrom
adr-0032-durable-extraction
Jul 31, 2026
Merged

docs: ADR-0032 — propose durable/Azure Functions repo extraction#7247
cgillum merged 7 commits into
mainfrom
adr-0032-durable-extraction

Conversation

@cgillum

@cgillum cgillum commented Jul 21, 2026

Copy link
Copy Markdown
Member

Summary

Adds ADR-0032 (status: proposed) proposing that the Durable Task and Azure Functions hosting integrations (agent-framework-durabletask, agent-framework-azurefunctions) be extracted from this monorepo into a dedicated repository, microsoft/agent-framework-durable-extension.

This PR contains only the ADR — no code is moved or removed. Its purpose is to get independent stakeholder signoff on the direction before a follow-up PR performs the actual extraction/removal.

What the ADR proposes

  • Extract the integrations for independent release cadence, dependency & CI isolation, and clear ownership.
  • Preserve backward compatibility (Option 3): keep core's lazy agent_framework.azure re-export shim and both packages in the [all] extra, so existing imports and pip install agent-framework[all] keep working — the move is invisible to consumers.
  • Documents the resulting cross-repo coupling (shim publish-cadence + the .NET InternalsVisibleTo grant) as a known trade-off.

Proposes extracting the Durable Task and Azure Functions hosting integrations into a dedicated repository (microsoft/agent-framework-durable-extension), keeping a backward-compatible shim and the [all] extra so the move is invisible to consumers. Status: proposed, for stakeholder signoff ahead of the code-removal PR.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 6181dcf9-857b-43ea-9fd2-fcd6b175ffdd
Copilot AI review requested due to automatic review settings July 21, 2026 21:39
@giles17 giles17 added the documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs label Jul 21, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated Code Review

Reviewers: 5 | Confidence: 76% | Result: All clear

Reviewed: Correctness, Security Reliability, Test Coverage, Failure Modes, Design Approach


Automated review by cgillum's agents

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a proposed architectural decision record (ADR-0032) describing a plan to extract the Durable Task and Azure Functions hosting integrations into a dedicated repository while preserving backward compatibility via the existing agent_framework.azure shim.

Changes:

  • Introduces ADR-0032 (status: proposed) outlining motivations, options, and the recommended extraction approach (Option 3).
  • Documents expected compatibility strategy (lazy re-export shim + [all] extra) and known trade-offs (cross-repo coupling).
  • Specifies validation expectations and highlights publish-cadence risk for shim symbols.

Comment thread docs/decisions/0032-durable-azure-functions-extraction.md Outdated
Comment thread docs/decisions/0032-durable-azure-functions-extraction.md Outdated
cgillum added 2 commits July 21, 2026 14:46
Replace the WorkflowHitlContext-specific illustration with a generic description of the publish-lag mechanism. The named symbol is currently exported by the extension and present in core's shim, so using it as an 'unpublished' example read as internally inconsistent.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 6181dcf9-857b-43ea-9fd2-fcd6b175ffdd
@cgillum
cgillum marked this pull request as ready for review July 21, 2026 21:58

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated Code Review

Reviewers: 5 | Confidence: 85% | Result: All clear

Reviewed: Correctness, Security Reliability, Test Coverage, Failure Modes, Design Approach


Automated review by cgillum's agents

@cgillum
cgillum temporarily deployed to github-app-auth July 31, 2026 17:16 — with GitHub Actions Inactive
@cgillum
cgillum temporarily deployed to github-app-auth July 31, 2026 17:19 — with GitHub Actions Inactive
@cgillum
cgillum enabled auto-merge July 31, 2026 19:14
@cgillum
cgillum added this pull request to the merge queue Jul 31, 2026
Merged via the queue into main with commit c073ed9 Jul 31, 2026
23 checks passed
@cgillum
cgillum deleted the adr-0032-durable-extraction branch July 31, 2026 19:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Usage: [Issues, PRs], Target: documentation in the code base and learn docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants