microsoft / microsoft/apm

[BUG] hook virtual package can't be installed with apm v0.29.1 and v0.30.0

Open
#2,980 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area/cli area/distribution status/accepted triage/recommended type/bug
Dominant language
Python
Stars
3.8k
Forks
362
Avg merge
1d 17h
Merged PRs (30d)
132

Description

Describe the bug

Fresh installation with apm install fails to install hook virtual packages.

To Reproduce

I'll use podman to isolate the problem.

podman container run -it --rm docker.io/library/ubuntu:noble-20260905

Inside a container:

apt update && apt install curl git -y
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
cd $(mktemp -d)
cat <<EOF > apm.yml
name: crabswarm
version: 1.0.0
description: APM project for crabswarm
author: ngicks
targets:
  - claude
  - codex
dependencies:
  apm:
    - git: github.com/ngicks/agents-package
      path: hooks/markdown-mermaid-lint
  mcp: []
scripts: {}
EOF

It fails for 0.29.1 and 0.30.0

# uv tool install apm-cli@0.30.0
# apm --version
Agent Package Manager (APM) CLI version 0.30.0
# apm install
[>] Installing dependencies from apm.yml...
[>] Resolving agents-package-markdown-mermaid-lint...
[x] Failed to install APM dependencies: Downloaded dependency 'agents-package-markdown-mermaid-lint' is invalid: Downloaded
package has no apm.yml or SKILL.md:
/tmp/tmp.7r3AkSDPgP/apm_modules/.apm-resolution-staging/72dafc60a61340fa83b9bf4b3f0d8823/replacements/3042fe6e04725a55e65ca53e
15cd51a18e4181d83eaac8177f605b972636c8f1. The downloaded candidate was not activated; fix the cause and retry the install.
[i] Run with --verbose for detailed diagnostics
[x] Install failed after 1.4s.

Succeeds with 0.28.0 and 0.29.0

# uv tool install apm-cli@0.28.0
# apm install
[>] Installing dependencies from apm.yml...
[>] Resolving agents-package-markdown-mermaid-lint...
[i] Targets: claude, codex  (source: apm.yml)
  [+] github.com/ngicks/agents-package/hooks/markdown-mermaid-lint #default @48df58af
  |-- 2 hook(s) integrated -> .claude/settings.json, .codex/hooks.json
  |   PostToolUse: runs .Files}} (hook.json)
  |   PostToolUse: runs .Files}} (hook.json)
[i] Added apm_modules/ to .gitignore
  [!] 1 dependency unpinned: ngicks/agents-package -- add #tag or #sha to prevent drift
[*] Installed 1 APM dependency in 1.8s.

Expected behavior

Succeeds as the doc promises.

Environment (please complete the following information):

  • OS: linux
  • Python Version: 3.14.7
  • APM Version: 0.29.1, 0.30.0
  • VSCode Version (if relevant): irrelevant

Logs

Noted in the repro step.

Additional context

I believe I have nothing.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the failure with the provided apm.yml and apm install using APM 0.30.0, then compare it with 0.28.0 and 0.29.0. Trace the dependency installation path around validation of the downloaded package and its missing apm.yml or SKILL.md. Done means the hook virtual package installs successfully and integrates its hooks as shown in the older-version output.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
cli
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.