Release v4.0.0-preview-4

[chullybun]

Summary

Publishes v4.0.0-preview-4. All milestone work is already on main; this branch bumps Version.props to 4.0.0-preview-4 and adds a final documentation clarification pass discovered while reviewing the release.

Milestone

v4.0.0-preview-4 milestone — 4/4 closed.

#	Title	Type
#179	DB layer review: outbox, EF Core concurrency/tenancy, and error-mapping fixes	PR (merged)
#180	Code review pass: fix bugs and expand test coverage in CoreEx and CoreEx.RefData	PR (merged)
#181	Code review sweep: harden every CoreEx package, close doc/reality gaps	PR (merged)
#182	Add Aspire AppHost template, CleanArgs API, and coreex-domain naming fixes	PR (merged)

This branch's own change

Documentation clarification discovered while auditing the AI workflow assets shipped by dotnet new coreex-ai for this release:

• coreex-ai-workflows.md is dual-audience (authored in this repo, copied verbatim into every consumer repo by CoreEx.Template), but two of its table rows described contributor-repo-only artefacts as if they existed in the generated consumer output:

  • Global instructions row named copilot-instructions.md unconditionally, even though dotnet new coreex-ai deliberately never generates that file — it's replaced by instructions/coreex.instructions.md (applyTo: "**"), which is CI-enforced (validate-template-pack.ps1 asserts copilot-instructions.md is FilesAbsent).
  • Authoring guides row listed INSTRUCTION_AUTHORING.md/SKILL_AUTHORING.md, neither of which is copied into consumer repos.

  Both rows now correctly distinguish contributor-repo reality from consumer-repo reality.

• Bumped Version.props to 4.0.0-preview-4.

Test plan

• git diff reviewed — change is scoped to Version.props, .github/coreex-ai-workflows.md, and an incidental CoreEx.slnx re-sort (adds tools/validate-template-pack.ps1 as a solution item, alphabetizes a few entries)
• Confirmed via tools/validate-template-pack.ps1 scenario assertions that copilot-instructions.md is genuinely FilesAbsent from dotnet new coreex-ai output, and coreex.instructions.md is the actual replacement, before updating the doc

[Copilot]

Pull request overview

Publishes v4.0.0-preview-4 for the CoreEx framework repo by bumping the central version and aligning release documentation to accurately reflect what dotnet new coreex-ai generates for consumer repositories.

Changes:

• Bump package/versioning metadata from 4.0.0-preview-3 to 4.0.0-preview-4.
• Clarify .github/coreex-ai-workflows.md to distinguish contributor-repo-only artefacts from consumer-repo output (notably global instructions and authoring guides).
• Minor CoreEx.slnx housekeeping: reordering and adding tools/validate-template-pack.ps1 as a solution item.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
Version.props	Updates the repo-wide version to 4.0.0-preview-4.
CoreEx.slnx	Re-sorts entries and includes tools/validate-template-pack.ps1 as a solution item.
.github/coreex-ai-workflows.md	Corrects AI workflow asset documentation to reflect actual generated consumer repo contents.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.