Repository navigation
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.jsonshared with Claude Code. (#3875) apm approvepins 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.comsources. (#3915, #3917, #3923) apm install -g --target claudeinstalls Claude plugins natively, with MCP, LSP andbin/under one approval; non-interactive runs also need--trust-bin. (#3290)
Breaking changes and upgrade notes
- BREAKING:
copilotproject MCP servers move to root.mcp.json, shared with Claude Code (which ignorestoolsallow-lists); runapm install, review staticenv:, commit. (#3875) - BREAKING:
apm audit --cifails MCP servers the lockfile admits butapm.ymldoes not approve; replace--trust-transitive-mcpwithapm approve <pkg>and commitapm.yml. (#3918) - BREAKING: Hostless
dependencies.requireentries match only the default host; host-qualify others, orenforcement: blockfailsapm installandapm audit --ci. (closes #3993, #4008) apm installwriteslockfile_version: "4", which older APM refuses; move CI to APM 0.37 before committing it. (closes #4000, #4026)- Replace the deprecated
vscodetarget withcopilot; VS Code Local mode no longer gets MCP servers, andvscodelockfiles still install. (#3875) - Replace singular
target:with thetargets:value its warning prints, and delete the ignoredcompilation.target. (#3801, #3875) - Remove the deprecated
auto-integrateconfig key; it never had an effect. (#3865) - With
default_host:inapm.yml, shorthand dependencies resolve against it; writegithub.com/owner/repofor GitHub packages. (#3865) - Diamond dependencies deploy each skill only to its own declaration's harnesses; older lockfiles fail
--frozenuntil you runapm installand commit. (#3769) mcp.transport.allowchecks the transport APM writes; registry servers on a disallowed or unresolvable transport are blocked, so settransport:or update the policy. (#3788)- Non-default-port dependencies are keyed
host:8443/owner/repoand no longer merge with the default port; re-approve their executables withapm approve. (#3932) - Pinned approvals in
apm.ymlneed APM 0.37 or later on every machine; older clients reject them and fail closed. (#3918) hooks: trueandmcp: trueapprovals still deploy but warn; runapm approve <pkg>to pin them to content. (#3918)apm lifecycle test --executefires only what an install would; runapm lifecycle trustfor project scripts.APM_NO_SCRIPTSand orgdeny_allapply. (#3988)- After
apm install -g --target claudemoves to native Claude plugins, reinstall older loose Claude hooks afterapm uninstall -g <package>. (closes #3181, #3191, #3290) apm install --frozenfails before deploying on any edited deployed file; delete the files, rerunapm install, commit. (closes #3994, #4004)PROXY_REGISTRY_ONLY=1also refuses MCP registries and marketplace catalogs the proxy cannot serve; setMCP_REGISTRY_URLto 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.jsonsidecars, are named for you to delete. (closes #3701, #4049) - After upgrading,
apm uninstallneeds deployment evidence per file; without it, it changes nothing and names each file (see the uninstall reference if the source is unreachable). (#3701) apm installkeeps a managed file it cannot prove it deployed, names it and exits 1. (#4382)- In CI,
apm installwith a committed lockfile verifies it like--frozen; pass--no-frozento 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 rootskills/and.mcp.json;apm packwrites.codex-plugin/plugin.json. (closes #3077, #3906) - OpenAPM v0.1 adds the native plugin activation profile (
req-na-001-007). (closes #3919, #3929) apm approvelists what each package runs and pins MCP servers, hook files and native plugins to their content; changed content waits for re-approval. (#3918)targets:ondependencies.mcpentries 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_PATandaztokens are never reported. (#3765, #3818) - OpenAPM v0.1 adopts amendments 0.1.61-0.1.63 (
vscodealias,hermesandgrok-bottargets, stricter-winsfetch_failure, per-file.mcp.jsonownership). (#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 updateandapm lock --updaterevalidate marketplace catalogs and fail rather than use stale data. (#3910, #3988)apm installupgrades 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 unpackapplies org policy and integrity checks likeapm 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 -gshows the source. (#4158) - Remedies never suggest
--force,--no-policy,APM_POLICY_DISABLEor editingapm.lock.yaml; policy refusals say nothing changed and point toapm policy status. (#4424, #4500) apm audit --format jsonadds a structuredremediationto failing CI checks, and a failed install replay is reported once underdrift. (#4143, #4424)- Each command writes
apm.lock.yamlat most once, andapm compilerefuses a lockfile from a newer APM before changing files. (closes #4086, #4255) apm lock exportidentifies GitHub packages aspkg:github/<owner>/<repo>@<commit>, with subpaths and labelled lock hashes. (closes #3994, #4004)apm init --applyimplies--discover, andapm plugin initscaffolds a commentedlicense:line. (closes #3994, #4004)- ASCII tables and panels, full names in
apm marketplace browse, clearer--frozenhelp, noapm runinapm --help, and a semver-range hint for unpinned dependencies. (closes #3994, #4004) - Faster CLI startup: commands and GitPython load only when needed (
apm --helpimports 332 modules instead of 767). (closes #4118, #4150)
Removed
- BREAKING:
apm init --pluginandapm init --marketplaceexit 2 and print the replacement:apm plugin init(now with--version,--author,--description) orapm marketplace init. (closes #4073, #4074) - The unused
marketplace-authoringexperimental 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.yamlrefused 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 staleapm_modulescopies no longer failing a lock. (#3989, #4255, #4271) - Local bundles and
apm pack: 32 fixes, including pack refusing credential files and packing.agents/skills/, andapm approve --pendinglisting 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 updatere-verifying recorded provenance. (#3915, #4338, #4416) - MCP and LSP: 36 fixes, including the
.mcp.jsonmove never stranding APM entries, config rewrites keeping their formatting, and repeated warnings printing once. (#3909, #4405, #4530) - Executables,
apm approveandapm deny: 24 fixes, includingreplace:dependencies (by Mohammed Alkindi (@MohammedAlkindi)), org-denied hooks reported as denied, and--frozenagreeing withaudit --cion 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 incopilotprojects, and--target antigravityskill 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-updateunder 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 globalapm uninstallapplyexecutablesapprovals only from~/.apm/apm.yml. (#3986, #3989)apm install,apm updateandapm audit --ciretire or report executables onceapm denyor a removed approval gates them, including those recorded while the gate was off. (closes #3944, #3958, #3990, #3991, #3988, #3989)apm approveandapm denymatch package names exactly and refuse ambiguous names. (#3988)*.ghe.commarketplaces 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 packbuilds 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 --ciapplies 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
- Rodrigo Liberoff (@rliberoff) made their first contribution in #3729
- Florian Assmus (@fassmus) made their first contribution in #3892
- Eunkwang Shin (@gracefullight) made their first contribution in #3943
Full Changelog: v0.36.1...v0.37.0