Skip to content

richfrem/agent-plugins-skills / plugins/agent-extension-authoring/.apm/skills/packaging-with-apm

packaging-with-apm

Flagged

Packages, installs and distributes agent extensions with APM (Agent Package Manager). Use when the user wants to create a new APM package, convert or migrate an existing plugin to APM and check it installs cleanly, compile a package into AGENTS.md, CLAUDE.md or GEMINI.md, install, update, pin or roll back packages globally or per project, or create a plugin marketplace catalog (marketplace.json). Not for authoring a single skill, plugin, sub-agent or rule (use the authoring-* skills).

FileKindSize
SKILL.mdskill md5.3 KB
evals/evals.jsonconfig2.7 KB
examples/marketplace.jsonconfig45 B
references/acceptance-criteria.mdmarkdown4.6 KB
references/agent-package-manager-overview.mdmarkdown28.7 KB
references/apm-alignment-fixes.mdmarkdown5.3 KB
references/diagrams/packaging-with-apm-flow.mmdother590 B
references/fallback-tree.mdmarkdown1.8 KB
references/legacy-plugin-conversion-guide.mdmarkdown15.4 KB
references/marketplace-architecture.mdmarkdown1.5 KB
references/marketplace-schema.mdmarkdown2.5 KB
references/marketplace.mdmarkdown11.5 KB
references/modes/compile-apm-package.mdmarkdown1.7 KB
references/modes/convert-plugin-to-apm.mdmarkdown7.3 KB
references/modes/create-apm-package.mdmarkdown1.7 KB
references/modes/install-apm-package.mdmarkdown4.3 KB
references/modes/manage-marketplace.mdmarkdown2.1 KB
requirements-dev.inother657 B
requirements-dev.txtmarkdown3.3 KB
requirements.inother148 B
requirements.txtmanifest171 B
scripts/apm_build_pipeline.pyscript35.1 KB
scripts/apm_consumer.pyscript11.3 KB
scripts/apply_symlink_repairs.pyscript1.7 KB
scripts/apply_symlink_repairs.shscript40 B
scripts/audit_marketplace_sources.pyscript2.5 KB
scripts/check_for_broken_symlinks.pyexecutablescript6.6 KB
scripts/convert_symlinks_to_manifest.pyscript6.7 KB
scripts/decouple_agent_paths.pyscript9.1 KB
scripts/fix_inside_plugin_symlinks.pyscript11.3 KB
scripts/materialize_copies.pyscript5.3 KB
scripts/migrate_to_apm.pyscript16.4 KB
scripts/scaffold_apm.pyscript8.6 KB
scripts/validate_apm_package.pyscript5.7 KB
tests/test_apm_build_pipeline.pyscript10.2 KB
tests/test_apm_consumer.pyscript4.8 KB
tests/test_audit_decoupled_state.pyscript8.6 KB
tests/test_convert_symlinks_to_manifest.pyscript5.3 KB
tests/test_decouple_agent_paths.pyscript4.8 KB
tests/test_scaffold_apm.pyscript1.7 KB

tests/test_apm_consumer.py

View on GitHub
#!/usr/bin/env python3
"""
Unit tests for apm_consumer.py (install-apm-package skill).

Purpose:
    Validates consumer tooling logic without network or a real APM install (run_apm is
    replaced by a recorder):
    1. Unpinned installs are refused; pinned specs are built as owner/repo/plugins/<p>#<ref>
    2. dependency_key handles APM's string and dict (--skill) entry forms
    3. set-ref rewrites refs on both entry forms for --source only, after a backup
    4. rollback uninstalls packages added since the backup before restoring state
    5. --checkout installs from a local clone only when its copies are materialized

Key Input Dependencies:
    - ../scripts/apm_consumer.py (module under test)
"""

import argparse
import os
import sys
import tempfile
import unittest
from pathlib import Path

import yaml

sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "scripts"))
import apm_consumer as consumer  # noqa: E402

SRC = "richfrem/agent-plugins-skills"


class TestApmConsumer(unittest.TestCase):
    """Consumer commands against a temporary HOME."""

    def setUp(self) -> None:
        """Redirect HOME and record APM calls instead of running them."""
        self.tmp = tempfile.TemporaryDirectory()
        self.old_home = os.environ.get("HOME")
        os.environ["HOME"] = self.tmp.name
        self.calls: list[list[str]] = []
        self.real_run = consumer.run_apm
        consumer.run_apm = lambda apm, args, cwd=None: self.calls.append(args) or 0
        (Path(self.tmp.name) / ".apm").mkdir()

    def tearDown(self) -> None:
        """Restore HOME and run_apm."""
        consumer.run_apm = self.real_run
        os.environ["HOME"] = self.old_home or ""
        self.tmp.cleanup()

    def _write_manifest(self, deps: list) -> None:
        manifest = {"name": "global", "dependencies": {"apm": deps}}
        (consumer.apm_home() / "apm.yml").write_text(yaml.safe_dump(manifest))
        (consumer.apm_home() / "apm.lock.yaml").write_text("lockfile_version: 1\n")

    def _args(self, **kw) -> argparse.Namespace:
        base = {"apm": "apm", "source": SRC, "targets": "claude,copilot,agy,codex", "is_global": True,
                "skill": None, "allow_unpinned": False, "ref": None, "backup": None, "plugins": "dev-utils",
                "checkout": None}
        base.update(kw)
        return argparse.Namespace(**base)

    def test_unpinned_install_refused_and_spec_pinned(self) -> None:
        self.assertEqual(consumer.cmd_install(self._args()), 2)
        self.assertEqual(self.calls, [])
        self.assertEqual(consumer.cmd_install(self._args(ref="abc123")), 0)
        self.assertEqual(self.calls[0][:2], ["install", f"{SRC}/plugins/dev-utils#abc123"])
        self.assertIn("--global", self.calls[0])

    def test_checkout_install_requires_materialized_clone(self) -> None:
        clone = Path(self.tmp.name) / "clone"
        (clone / "plugins" / "dev-utils").mkdir(parents=True)
        self.assertEqual(consumer.cmd_install(self._args(checkout=str(clone))), 2)  # no materialize tool
        consumer.checkout_ready = lambda checkout: True
        self.assertEqual(consumer.cmd_install(self._args(checkout=str(clone), skill=["managing-adrs"])), 0)
        self.assertEqual(self.calls[-1][:2], ["install", str(clone.resolve() / "plugins" / "dev-utils")])

    def test_dependency_key_forms(self) -> None:
        self.assertEqual(consumer.dependency_key(f"{SRC}/plugins/a#r1"), f"{SRC}/plugins/a")
        self.assertEqual(consumer.dependency_key({"git": f"{SRC}/plugins/b", "ref": "r1"}), f"{SRC}/plugins/b")

    def test_set_ref_rewrites_both_forms_for_source_only(self) -> None:
        self._write_manifest([f"{SRC}/plugins/a#old", {"git": f"{SRC}/plugins/b", "ref": "old", "skills": ["x"]},
                              "other/repo/pkg#keep"])
        self.assertEqual(consumer.cmd_set_ref(self._args(ref="new")), 0)
        deps = yaml.safe_load((consumer.apm_home() / "apm.yml").read_text())["dependencies"]["apm"]
        self.assertEqual(deps[0], f"{SRC}/plugins/a#new")
        self.assertEqual(deps[1]["ref"], "new")
        self.assertEqual(deps[2], "other/repo/pkg#keep")
        self.assertEqual(len(consumer.list_backups()), 1)
        self.assertEqual(self.calls[-1], ["install", "--global"])

    def test_rollback_uninstalls_added_then_restores(self) -> None:
        self._write_manifest([f"{SRC}/plugins/a#r1"])
        consumer.backup_global()
        self._write_manifest([f"{SRC}/plugins/a#r1", {"git": f"{SRC}/plugins/b", "ref": "r1", "skills": ["x"]}])
        self.assertEqual(consumer.cmd_rollback(self._args()), 0)
        self.assertEqual(self.calls, [["uninstall", f"{SRC}/plugins/b", "--global"], ["install", "--global"]])
        restored = yaml.safe_load((consumer.apm_home() / "apm.yml").read_text())["dependencies"]["apm"]
        self.assertEqual(restored, [f"{SRC}/plugins/a#r1"])


if __name__ == "__main__":
    unittest.main()
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall