[BUG] hook virtual package can't be installed with apm v0.29.1 and v0.30.0
Nobody has claimed this yet.
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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