jonathan-vella/apex
APEX vNext Azure workflow agent, hidden workers, skills, managed hooks, the bundled MCP server and read-only Azure pricing tools.
APEX plugin changelog
Each apex plugin release published to the apex-plugins marketplace
needs a section here headed ## [<version>]. npm run publish:plugin -- --apply refuses to publish a version without
one, and clients only update when the version changes.
The plugin version is the @apexops/cli version in packages/cli/package.json; the build copies it into plugin.json.
Plugin and CLI therefore move in lockstep, and the plugin bundles the CLI release published to npm at that version.
When you prepare a release, rename ## [Unreleased] to the new version.
[Unreleased]
[0.11.0-next.16] - 2026-11-13
This release simplifies Planning, CodeGen, and IaC Validation so pre-sales and multi-resource workloads author and validate real AVM Bicep and Terraform instead of blocking on static literal generator and storage-only AST gates.
Changed
- Support
kind: "deferred"inenvironment-inputs(blocked only before livepreview),componentId1-to-many Architecture component splits inimplementation-intent, and AVM bindings without RGphysicalResourcesmaps onlocaland subscription-scoped runs. - Update
APEX CodeGenandapex/generateIacto stage, format, compile-check, and seal real AVM Bicep and Terraform withparams/variables and symbolic module wiring, withexpectedShafile replacement on compiler feedback. - Resolve
bicepfrom~/.azure/binwhen absent fromPATHand validate staged trees with nativebicep/terraformtoolchains, universal credential/baseline checks, and multi-resource/parameter-aware source policy validation.
[0.11.0-next.15] - 2026-11-13
This release fixes pilot workflow, pricing, review-artifact, and diagram issues uncovered during the EU partner webhook gateway pilot audit.
Fixed
- Support pre-sales
labcontinuation on the ALZ Corp reference baseline atgovernance-refreshthrough Planning, CodeGen, and IaC validation (blocking before livepreview/deployuntilapex governance reviseimports a reviewed subscription baseline). - Preserve
RTO/RPOintake answers inRequirementsV1templates, re-renderchallenger-findings.mdand stageREADME.mdstatus on review resolution, sync existingagent-outputpackages into linked git worktrees, and improve01-requirements,03-des-diagram.mmd, WAF, and cost diagrams. - Update
retail-pricing.mdandapex-architectureto use ODatafilterqueries for tier/meter-billed services in@azure/mcppricing_get, enforce oneask_usercall per response, and restrict silent Gate 2 auto-dismissal toinfo/lowstage-excluded noise.
[0.11.0-next.14] - 2026-11-11
This release replaces bundled multi-finding review prompts with a scannable Markdown overview table followed by
sequential one-by-one ask_user prompts per actionable finding (1/N) across Requirements, Architecture, and Planning
reviews.
Changed
- Update
APEX,apex-next,apex-requirements,apex-architecture,apex-planning, andApexService.decideReviewso Architecture review noise is auto-dismissed silently, actionable findings render in a Markdown overview table first, users answer one finding at a time via sequentialask_userprompts filtered by each finding's returnedfinding.actions, and mixedrevise+ disposition batches audit non-reviseanswers on the current review before invalidating for revision.
[0.11.0-next.13] - 2026-11-11
This release ensures governance and Architecture only stop or mark controls blocked on active deny policies, never
pausing on modify, deployIfNotExists, audit, or unconfirmed reference-baseline assignments.
Changed
- Restrict
disposition: "blocked"andpolicy-refreshArchitecture reopening toeffect: "deny"inApexService, and updaterubber-duckArchitecture review instructions somodify,deployIfNotExists,audit, and accepted reference-baseline assumptions are non-blocking. - Update
apex-architecture,apex-azure-governance,apex-operations,apex-azure-defaultsreferences, andAPEXboundaries soapex-azure/policy(policy_assignment_list) is not called whengovernance-constraintsusessource: "reference"and non-denyeffects never pause the workflow.
[0.11.0-next.12] - 2026-11-11
This release resolves end-to-end worktree, provider handoff, Bicep AVM/generator, and native Terraform validation gaps
across the bundled runtime and managed APEX guidance.
Changed
- Unify linked Git worktree
.apex/resolution across CLI and MCP, addapex release-writer/apex/releaseWriter, mirroragent-output/into linked worktrees, dynamically reload.apex/provider-config.jsonwith active-runiac-handoffdefaults, provide zero-config offline source validation forvalidateTaskandcompleteTask, block runtime downgrades inupdateanddoctor --fix, and include generated.apex/work/<runId>/...IaC files in state transfer bundles. - Support AVM Bicep module evaluation,
targetScope-bound Log Analytics resolution, Bicep output/interpolation/RBACscopeLogicalIdgeneration, and root-module Terraform HCL parity/baseline validation; route missing governance baselines throughask_user; and trim duplicatedAPEXcoordinator prose.
[0.11.0-next.11] - 2026-11-10
This release codifies the canonical 9-tag resource-group contract from jonathan-vella/azure-landing-zones
(enforce-resource-group-tags-exclude-resource-groups-based-on-name.json) with automatic runtime default values so
resource-group creation in Bicep and Terraform always includes all required tags without blocking on missing baseline
tag inputs.
Changed
- Add
resourceGroupTagContract(environment,owner,costcenter,application,workload,sla,backup-policy,maint-window,technical-contactplus allowedenvironmentandslavalues) toconfig/defaults.v1.jsonand updateapex-azure-defaultsreferences (baseline-fallbacks.md,tag-precedence.md) with automatic default resolution. - Enforce the 9-tag contract and value normalization in
resolveResourceGroupTags,generateBicepTree,generateTerraformTree, andAzdBicepProvidergreenfield resource-group provisioning.
[0.11.0-next.10] - 2026-11-10
This release improves Requirements intake UX across the GitHub Copilot App, VS Code Copilot harness, and Copilot CLI by
adding baseline and workload-derived recommendations (availability-recovery, operations, compliance, and
stateless container service-preferences), enabling one-click round summary confirmations, and ensuring multi-value
ask_user prompts always include selectable single-choice options instead of rendering a bare Skip button.
Changed
- Add baseline recommendations for
availability-recovery(["single-region-availability"]) andoperations(["azure-monitor", "application-insights", "log-analytics"]), derivecompliancerecommendations from the confirmed workload description, and recommendcontainer-appsfor container/scale-to-zero workloads inrecommendedServiceCandidates. - Update
APEXandapex-requirementsintake mechanics to support one-click round answer table confirmation and always pass selectable single-choice options on multi-valueask_userprompts.
[0.11.0-next.9] - 2026-11-10
This release fixes Windows CRLF asset hash drift in assets/manifest.json and allows scripts/onboard.ps1 to accept
-Yes alongside --yes.
Fixed
- Normalize text source files to LF in
packages/cli/scripts/prepare-assets.mjssoassets/manifest.jsondigests match the LF-normalized files written bytools/scripts/build-plugin.mjson Windows. - Map
-Yes(case-insensitive) to--yesinscripts/onboard.ps1.
[0.11.0-next.8] - 2026-11-10
This release ships azd layered provisioning support (infra.layers[] in azure.yaml, #480) and top-level
user-requested input amendment routing in the APEX agent (#517).
Added
- Support
azdlayered provisioning (infra.layers[]inazure.yaml) inAzdBicepProvider: validate and compile declared layer roots without requiringinfra/main.bicep, preview and apply layers in topological dependency order, re-verify bound inputs at every layer boundary, stop on partial failure while naming completed vs failed layers, and tear down layers in reverse dependency order (#480). - Add top-level user-requested decision-amendment routing (
apex/inputHistory->apex/previewInputAmendment-> confirmation ->apex/amendInput) inagents/apex.agent.mdbefore normal gate stops (#517).
[0.11.0-next.7] - 2026-11-09
This release ships the vNext-only plugin cleanup (#539), syncs upstream Azure Bicep, retail-pricing, and diagram pattern guidance, and completes the remaining UX polish items in #500.
Changed
- Remove 73 legacy v1 skill templates and
upstream-coverage.mdfiles from the shipped plugin (1,245→1,172files) and rewrite all shipped skill links to local relative paths (#539). - Add
app-service-entra-private-registry-pattern.mdand Storage point-in-time restore gotchas toapex-bicep-patterns, expandapex-azure-defaults/references/retail-pricing.mdwithFoundry Models,Azure Front Door Service(Zone 1), Standard SSD, Bastion, and Monitor alert meter selection rules, and add end-to-end overview pattern guidance toapex-python-diagrams. - Complete UX polish (#500): support optional
actors, componentsubnetboundaries, labelledflows/edgeLabels, and aLegendsubgraph inArchitectureV1andrenderArchitectureMermaid; generate human-readable<environment>-<YYYYMMDD>-<shortId>run folder names; and add explicit exclusivenoneoptions toservice-preferences,availability-recovery, andoperationsmulti-select intake questions.
[0.11.0-next.6] - 2026-11-09
This release resets the preview launch scope (DECISION-040, #535, #536), ships a single self-contained marketplace
plugin artifact bundling both mcp/apex.mjs and cli/apex.mjs with .apex/bin/apex.mjs workspace launchers and
scripts/onboard.{ps1,sh}, cuts the MCP tools/list wire payload under a static context budget (27,505 / 28,000
bytes), and qualifies general Bicep and MCR AVM module live execution through azd (#533, #386, #455).
Changed
- Bundle
cli/apex.mjsandscripts/onboard.{ps1,sh}directly in the plugin (CP-35, #531) and generate.apex/bin/apex.mjsduring workspace initialization without runningnpm install @apexops/cli. Treat duplicate marketplace entries disabled in.github/copilot/settings.local.jsonas healthy indoctor(#507). - Stop serializing
outputSchemaonto the MCPtools/listwire payload while keeping server-side output validation, unregister 10 CLI-only MCP tools (31role-scoped tools retained), and enforce static context budgets (CP-34,CP-36, #530, #532). - Unlock general Bicep and MCR AVM module validation (
CP-33, #529, #536): remove the 9-resource storage-only lock, supportMicrosoft.Resources/deploymentsmodules and nested array sub-deployments, omit unused top-levelparamdeclarations ingenerateBicepTree, and pass--api-version 2021-05-01-previewwhen readingMicrosoft.Insights/diagnosticSettingsduring destroy preview on Azure CLI 2.91+. - Add exact Azure MCP Server
3.0.0as the general read-onlyapex-azureprovider with verified foreground grants and guarded namespace commands. Retire the separate ARM CostManagement server; actual billing, forecasts, budgets, alerts and commitment records are unsupported. Pricing usespricing_getwith explicit cap/provenance guidance. External install/cache and client/live qualification remain separate from APEX's bundled offline startup and kernel approval guarantees. - Static Web Apps Bicep guidance no longer shows a Key Vault reference in the managed integrated API's application settings, which Managed Functions do not resolve; secrets belong on a linked bring-your-own Functions app.
[0.11.0-next.5] - 2026-10-19
This release bundles the azd Bicep executor (CP-26, PR B) and skill guidance corrections from the 0.11.0-next.4 marketplace review. Bicep live runs stay unavailable until CP-30 qualifies the azd executor.
- Skill guidance corrections from the 0.11.0-next.4 marketplace review (Refs #384): Terraform verification no longer
builds
https://https://URLs from the shippedapi_urloutput; supporting-resource tables show optional integrations (AKS, Logic Apps, Container Apps and others) as conditional instead of required; permission-denied recipes diagnose the denied action and scope and recommend the narrowest role instead of Contributor; the Learn CLI fallback requires Node.js 22 or later. There is no runtime change.
[0.11.0-next.4] - 2026-10-11
This fix release corrects agent and skill guidance findings from the 0.11.0-next.3 marketplace review: wrong CLI command
orderings, health-check exit codes, least-privilege role guidance and redirect URI guidance. It includes the Gate 1
apex/gateDecide correction: the call must carry decision. There is no runtime change.
- Skill guidance corrections from the 0.11.0-next.3 marketplace review (Refs #384):
apex/gateDecideguidance now names the requireddecision(approvedorrejected) withgate: 1andconfirm: true; deployment recipes useaz deployment operation sub list,terraform import <address> <id>, fail-fast boundedcurlhealth checks and secret-store guidance for CI/CD secrets; role-assignment delegation prefers Role Based Access Control Administrator over User Access Administrator; native and mobile Entra redirect URIs are no longer forced to HTTPS; Cosmos DB hierarchical keys carryversion: 2; AKS, Application Insights and Event Grid references no longer overstate minimums, mislabel the workspace SKU or require Key Vault.
[0.11.0-next.3] - 2026-10-11
Adds the purpose-bound lab approval flow guidance (Gate 1 intent confirmation and Gate 4 final preview approval; production is not available) and re-ported Azure design, IaC and operations skills. azd does not execute anything in this release.
-
Operations skills re-ported at the pinned upstream commit (CP-18/CP-21): full recipe/CLI/azd/SDK and service references, migration scenarios/runtime examples and inline Mermaid syntax. Script/workflow sources are non-executable references. Native-provider authority, task/evidence boundaries, the current runtime's Gate 4 and the unavailable status of the planned DECISION-036 flow (CP-26 to CP-30) are preserved; no deployment or Mermaid renderer capability is added.
-
Azure design skills re-ported from
jonathan-vella/apex(CP-18): trigger-rich descriptions, retail pricing, SKU availability and cost tool references, guidance aligned to the read-onlyapex-azure-pricingtools, and the upstream Azure CLI and azd commands. Read commands run directly; commands that change Azure route throughapex deployand Gate 4 or the approved GitHub Actions pipeline. APEX never runsazd up.
[0.11.0-next.2] - 2026-10-09
Fixes a Copilot review finding on the second marketplace release pull request (closed without merging): the apex-automation instruction now requires pinning third-party actions to a full commit SHA instead of a mutable major version tag.
[0.11.0-next.1] - 2026-10-09
Fixes 3 findings from the Copilot review on the first marketplace release pull request (closed without merging): the
preToolUse hook now fails closed on a missing script, the APEX CodeGen agent no longer carries an unused
apex/completeTask grant, and apex-azure-quotas no longer blocks an exact-fit quota request.
[0.11.0-next.0] - 2026-10-08
First marketplace release of APEX as one Agent Plugins 1.0 plugin.
- The APEX agent, hidden workers (CodeGen and Validator) and skills from the managed customizations. Agents are rendered
with the Copilot CLI client mechanics the workspace copies carried before
apex initstopped copying them (CP-11). The built-inrubber-duckagent runs the Requirements, Architecture and Plan reviews; the APEX Reviewer worker is retired. - The
apexMCP server: the bundled@apexops/cliruntime as one esbuild bundle on the MCP TypeScript SDK v2, started withnodefrom the plugin folder and needing no registry download. - The
apex-azure-pricingMCP server: Azure Resource Manager MCP over streamable HTTP with theCostManagementandPricingtoolsets. It replacesazure-resource-manager-mcpfrom the retired workspace.mcp.json; agent tool references useapex-azure-pricing/<tool>. - PNG diagrams on
linux-x64(glibc) andwin32-x64hosts: the plugin ships the prebuilt@resvg/resvg-js2.6.2 binaries undernative/resvg-js/with their MPL-2.0 license and loads one only when its SHA-256 matches the hash pinned in the bundle. Other platforms, musl Linux and altered binaries fall back to Python and SVG diagrams and report PNG as unavailable. The binaries add about 8.5 MB to the package. - Managed hooks that deny the APEX agent as a task target, and every
apex-azure-pricingtool except the read-only pricing and cost tools fromtools/registry/arm-mcp-cost-pricing.v1.json. They also capture kernel-requested rubber-duck reviews as signed records for the kernel, and deny state-changing APEX tools to rubber-duck while it runs. - The
apexMCP server refuses a workspace whose.apex/apex.lock.jsonnames another@apexops/cliversion withAPEX_RUNTIME_MISMATCH;statusreports the mismatch read-only. Runapex updatefor an older workspace, or install the plugin version that matches a newer one (CP-25). - The manual-only
apex-unslopskill (/apex-unslop): polishes prose you ask it to without changing facts, identifiers or APEX file contracts, and never edits kernel-managed artifacts.