Skip to content

v0.37.0

Latest

Choose a tag to compare

@github-actions github-actions released this 21 Nov 06:55
· 29 commits to main since this release
c0c6e25

Highlights

  • 0.37 writes lockfile version 4 (security hardening). APM 0.36.1 and older refuse v4 lockfiles, so upgrade every machine and CI runner together. (#4026)
  • BREAKING: Copilot project MCP servers move to a root .mcp.json shared with Claude Code. (#3875)
  • apm approve pins each package's hooks, MCP servers and native plugins to their content. (#3918)
  • Marketplace installs replay from the lockfile and fail closed on rebound aliases and cross-repo *.ghe.com sources. (#3915, #3917, #3923)
  • apm install -g --target claude installs Claude plugins natively, with MCP, LSP and bin/ under one approval; non-interactive runs also need --trust-bin. (#3290)

Breaking changes and upgrade notes

  • BREAKING: copilot project MCP servers move to root .mcp.json, shared with Claude Code (which ignores tools allow-lists); run apm install, review static env:, commit. (#3875)
  • BREAKING: apm audit --ci fails MCP servers the lockfile admits but apm.yml does not approve; replace --trust-transitive-mcp with apm approve <pkg> and commit apm.yml. (#3918)
  • BREAKING: Hostless dependencies.require entries match only the default host; host-qualify others, or enforcement: block fails apm install and apm audit --ci. (closes #3993, #4008)
  • apm install writes lockfile_version: "4", which older APM refuses; move CI to APM 0.37 before committing it. (closes #4000, #4026)
  • Replace the deprecated vscode target with copilot; VS Code Local mode no longer gets MCP servers, and vscode lockfiles still install. (#3875)
  • Replace singular target: with the targets: value its warning prints, and delete the ignored compilation.target. (#3801, #3875)
  • Remove the deprecated auto-integrate config key; it never had an effect. (#3865)
  • With default_host: in apm.yml, shorthand dependencies resolve against it; write github.com/owner/repo for GitHub packages. (#3865)
  • Diamond dependencies deploy each skill only to its own declaration's harnesses; older lockfiles fail --frozen until you run apm install and commit. (#3769)
  • mcp.transport.allow checks the transport APM writes; registry servers on a disallowed or unresolvable transport are blocked, so set transport: or update the policy. (#3788)
  • Non-default-port dependencies are keyed host:8443/owner/repo and no longer merge with the default port; re-approve their executables with apm approve. (#3932)
  • Pinned approvals in apm.yml need APM 0.37 or later on every machine; older clients reject them and fail closed. (#3918)
  • hooks: true and mcp: true approvals still deploy but warn; run apm approve <pkg> to pin them to content. (#3918)
  • apm lifecycle test --execute fires only what an install would; run apm lifecycle trust for project scripts. APM_NO_SCRIPTS and org deny_all apply. (#3988)
  • After apm install -g --target claude moves to native Claude plugins, reinstall older loose Claude hooks after apm uninstall -g <package>. (closes #3181, #3191, #3290)
  • apm install --frozen fails before deploying on any edited deployed file; delete the files, rerun apm install, commit. (closes #3994, #4004)
  • PROXY_REGISTRY_ONLY=1 also refuses MCP registries and marketplace catalogs the proxy cannot serve; set MCP_REGISTRY_URL to a proxied registry. (closes #3994, #4004)
  • Cleanup deletes only files a receipt or the locked render proves APM wrote; others, such as old hook package.json sidecars, are named for you to delete. (closes #3701, #4049)
  • After upgrading, apm uninstall needs deployment evidence per file; without it, it changes nothing and names each file (see the uninstall reference if the source is unreachable). (#3701)
  • apm install keeps a managed file it cannot prove it deployed, names it and exits 1. (#4382)
  • In CI, apm install with a committed lockfile verifies it like --frozen; pass --no-frozen to opt out. (#4509)
  • Coming in 0.38: CLI contract changes to exit codes, stderr routing and locally-authored files at a dependency's path; details in the 0.38 notes. (#3983)

Added

  • Codex installs targets: [codex] packages at their real version with root skills/ and .mcp.json; apm pack writes .codex-plugin/plugin.json. (closes #3077, #3906)
  • OpenAPM v0.1 adds the native plugin activation profile (req-na-001-007). (closes #3919, #3929)
  • apm approve lists what each package runs and pins MCP servers, hook files and native plugins to their content; changed content waits for re-approval. (#3918)
  • targets: on dependencies.mcp entries limits which targets get each server. (closes #2606, #3989)

Changed

  • Azure DevOps installs report success or HTTP 401 to your Git credential helper; ADO_APM_PAT and az tokens are never reported. (#3765, #3818)
  • OpenAPM v0.1 adopts amendments 0.1.61-0.1.63 (vscode alias, hermes and grok-bot targets, stricter-wins fetch_failure, per-file .mcp.json ownership). (#3851, #3865, #3875, #3888, #3905)
  • Docs are rebuilt around the agent supply chain, old URLs redirect, and they state which hosts receive GITHUB_APM_PAT. (#3996, #4092, #4371)
  • apm install --refresh, apm update, apm marketplace update, apm deps update and apm lock --update revalidate marketplace catalogs and fail rather than use stale data. (#3910, #3988)
  • apm install upgrades pre-0.37 projects automatically: unedited files re-render once, edited files are kept and named, and a blocked upgrade exits 1. (#4398, #4504)
  • apm unpack applies org policy and integrity checks like apm install <bundle> and records deployed files in an APM project. (closes #4080, #4157)
  • User-scope (-g) policy comes from $APM_HOME/apm.yml, never from a git remote; apm policy status -g shows the source. (#4158)
  • Remedies never suggest --force, --no-policy, APM_POLICY_DISABLE or editing apm.lock.yaml; policy refusals say nothing changed and point to apm policy status. (#4424, #4500)
  • apm audit --format json adds a structured remediation to failing CI checks, and a failed install replay is reported once under drift. (#4143, #4424)
  • Each command writes apm.lock.yaml at most once, and apm compile refuses a lockfile from a newer APM before changing files. (closes #4086, #4255)
  • apm lock export identifies GitHub packages as pkg:github/<owner>/<repo>@<commit>, with subpaths and labelled lock hashes. (closes #3994, #4004)
  • apm init --apply implies --discover, and apm plugin init scaffolds a commented license: line. (closes #3994, #4004)
  • ASCII tables and panels, full names in apm marketplace browse, clearer --frozen help, no apm run in apm --help, and a semver-range hint for unpinned dependencies. (closes #3994, #4004)
  • Faster CLI startup: commands and GitPython load only when needed (apm --help imports 332 modules instead of 767). (closes #4118, #4150)

Removed

  • BREAKING: apm init --plugin and apm init --marketplace exit 2 and print the replacement: apm plugin init (now with --version, --author, --description) or apm marketplace init. (closes #4073, #4074)
  • The unused marketplace-authoring experimental flag; marketplace authoring has been GA since 0.11. (closes #3994, #4004)

Fixed

  • Install, lockfile and manifests: 24 fixes, including a failed multi-package install integrating nothing, a symlinked apm.lock.yaml refused before deploying, and 0.36-era edits staying proven. (#3989, #4255, #4424)
  • Audit and --frozen: 23 fixes, including one verdict on locked content hashes, blocked or interrupted installs restoring deployed files, and stale apm_modules copies no longer failing a lock. (#3989, #4255, #4271)
  • Local bundles and apm pack: 32 fixes, including pack refusing credential files and packing .agents/skills/, and apm approve --pending listing parked bundle executables with their key. (#4217, #4283, #4339)
  • Marketplace: 20 fixes, including locked dependencies replaying without the catalog, refusing a plugin whose ref changed since install, and apm update re-verifying recorded provenance. (#3915, #4338, #4416)
  • MCP and LSP: 36 fixes, including the .mcp.json move never stranding APM entries, config rewrites keeping their formatting, and repeated warnings printing once. (#3909, #4405, #4530)
  • Executables, apm approve and apm deny: 24 fixes, including replace: dependencies (by Mohammed Alkindi (@MohammedAlkindi)), org-denied hooks reported as denied, and --frozen agreeing with audit --ci on hook pins. (#3742, #4055, #4272)
  • Org policy and proxy: 26 fixes, including denied dependencies refused before any fetch, cached policy verified and applied offline, and exact release tags in require_pinned_constraint (by Mohammed Alkindi (@MohammedAlkindi)). (#3775, #4315, #4464, #4534)
  • Uninstall, prune and cleanup: 17 fixes, including uninstall keeping your own files in a removed skill directory and every command listing each path it deletes. (#4217, #4255)
  • Targets and compile: 20 fixes, including Kiro agents with current tool IDs, targets: [vscode] dependencies in copilot projects, and --target antigravity skill paths. (#3864, #3947, #3992)
  • Auth and credentials: 5 fixes, including inaccessible-repository errors naming the host and credential sources tried, never their values, and redacted registry tokens. (#4217, #4240)
  • Windows and terminal output: 13 fixes, including apm self-update under PowerShell 7, deep project paths, and non-ASCII paths printed as ASCII escapes. (#3931, #4425, #4487)

Security

  • For dependencies resolved through a registry proxy, prefer pinning to a full commit SHA over a movable tag. (#3777)
  • apm install -g, apm install -g <bundle> and global apm uninstall apply executables approvals only from ~/.apm/apm.yml. (#3986, #3989)
  • apm install, apm update and apm audit --ci retire or report executables once apm deny or a removed approval gates them, including those recorded while the gate was off. (closes #3944, #3958, #3990, #3991, #3988, #3989)
  • apm approve and apm deny match package names exactly and refuse ambiguous names. (#3988)
  • *.ghe.com marketplaces refuse bare cross-repo sources, rebound aliases fail closed, and cold installs keep the locked commit. (closes #3912, #3913, #3917, #3923, #3937, #3942, #3945, #3952, #3959, #3961, #3988, #3989)
  • apm pack builds plugin MCP servers from authored sources only, so packs carry no install-resolved credentials. (closes #3966, #3988)
  • Local bundles drop revoked, denied or repacked MCP servers on reinstall, and apm audit --ci applies org MCP policy to every locked server. (closes #3956, #3988, #3989)
  • Trust and integrity consistency hardening. (#4051, #4061)

Known issue: apm unpack into a checkout with a committed apm.lock.yaml rewrites that file; use microsoft/apm-action v1.12.0 or later with APM 0.37 (fixed in the CLI in 0.38, #4556).

The full list of 0.37.0 fixes is in the closed 0.37.0 milestone issues and the closing references of #4424.

New Contributors

Full Changelog: v0.36.1...v0.37.0