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_convert_symlinks_to_manifest.py

View on GitHub
#!/usr/bin/env python3
"""
Unit tests for convert_symlinks_to_manifest.py (convert-plugin-to-apm skill).

Purpose:
    Validates the symlink -> copy-manifest conversion (APM migration plan Section 10.3):
    1. Dry-run changes nothing
    2. Apply removes the links, updates existing manifest entries and adds missing ones
    3. tests/ links and links leaving the plugin are skipped and reported
    4. Stale "symlink" entries whose destination is now a real file are removed
    5. The build pipeline stages the same bytes after conversion as before it

Key Input Dependencies:
    - ../scripts/convert_symlinks_to_manifest.py (module under test)
    - ../scripts/apm_build_pipeline.py (staging comparison)
    - git on PATH
"""

import json
import os
import subprocess
import sys
import tempfile
import unittest
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "scripts"))
import apm_build_pipeline as pipeline  # noqa: E402
import convert_symlinks_to_manifest as conv  # noqa: E402


def _git(cwd: Path, *args: str) -> None:
    """Run git quietly with a fixed identity."""
    subprocess.run(["git", "-c", "user.name=t", "-c", "user.email=t@t", *args], cwd=cwd, check=True, capture_output=True)


class TestConvert(unittest.TestCase):
    """Conversion against a synthetic repository."""

    def setUp(self) -> None:
        """Plugin p: two skills sharing a script, a doc link, a tests/ link, a cross-plugin link."""
        self.tmp = tempfile.TemporaryDirectory()
        self.root = Path(self.tmp.name).resolve()
        p = self.root / "plugins" / "p"
        for d in ("scripts", "references", "tests", "skills/a/scripts", "skills/b/scripts", "skills/b/references", "agents"):
            (p / d).mkdir(parents=True)
        (p / "scripts" / "tool.py").write_text("print('tool')\n")
        (p / "references" / "doc.md").write_text("doc\n")
        for skill in ("a", "b"):
            (p / "skills" / skill / "SKILL.md").write_text(f"---\nname: {skill}\ndescription: Test skill.\n---\n")
            os.symlink("../../../scripts/tool.py", p / "skills" / skill / "scripts" / "tool.py")
        os.symlink("../../../references/doc.md", p / "skills" / "b" / "references" / "doc.md")
        os.symlink("../scripts/tool.py", p / "tests" / "tool.py")
        (self.root / "plugins" / "q").mkdir()
        (self.root / "plugins" / "q" / "x.md").write_text("q\n")
        os.symlink("../../../../q/x.md", p / "skills" / "b" / "references" / "x.md")
        (p / "agents" / "a.md").write_text("standalone agent\n")
        (self.root / "symlinks.json").write_text(json.dumps({"version": 1, "links": [
            {"src": "plugins/p/scripts/tool.py", "dst": "plugins/p/skills/a/scripts/tool.py", "strategy": "symlink", "description": "hub"},
            {"src": "plugins/p/skills/a/SKILL.md", "dst": "plugins/p/agents/a.md", "strategy": "symlink", "description": "old mirror"},
            {"src": "plugins/p/x", "dst": "docs/keep.md", "strategy": "symlink", "description": "outside"},
        ]}))
        _git(self.root, "init", "-q")
        _git(self.root, "add", "-A")
        _git(self.root, "commit", "-q", "-m", "fixture")

    def tearDown(self) -> None:
        self.tmp.cleanup()

    def _staged_bytes(self) -> dict:
        insp = pipeline.inspect_plugin(self.root, self.root / "plugins" / "p")
        staging = self.root / "build" / "staging" / "p"
        pipeline.normalize_plugin(insp, staging)
        return {str(f.relative_to(staging)): f.read_bytes() for f in staging.rglob("*") if f.is_file()}

    def test_dry_run_changes_nothing(self) -> None:
        before = (self.root / "symlinks.json").read_text()
        result = conv.convert(self.root, ["p"], apply=False)
        self.assertEqual(len(result["converted"]), 3)
        self.assertTrue((self.root / "plugins/p/skills/a/scripts/tool.py").is_symlink())
        self.assertEqual((self.root / "symlinks.json").read_text(), before)

    def test_apply_converts_and_reports(self) -> None:
        result = conv.convert(self.root, ["p"], apply=True)
        self.assertEqual(result["manifest"], {"updated": 1, "added": 2, "stale_removed": 1})
        self.assertFalse((self.root / "plugins/p/skills/a/scripts/tool.py").exists())
        self.assertTrue((self.root / "plugins/p/tests/tool.py").is_symlink())
        reasons = {s["path"]: s["reason"] for s in result["skipped"]}
        self.assertIn("tests/", reasons["plugins/p/tests/tool.py"])
        self.assertIn("outside the plugin", reasons["plugins/p/skills/b/references/x.md"])
        entries = {e["dst"]: e for e in json.loads((self.root / "symlinks.json").read_text())["links"]}
        self.assertEqual(entries["plugins/p/skills/a/scripts/tool.py"]["strategy"], "copy")
        self.assertEqual(entries["plugins/p/skills/b/references/doc.md"]["src"], "plugins/p/references/doc.md")
        self.assertNotIn("plugins/p/agents/a.md", entries)
        self.assertIn("docs/keep.md", entries)

    def test_staged_content_unchanged_by_conversion(self) -> None:
        (self.root / "plugins/p/skills/b/references/x.md").unlink()
        _git(self.root, "add", "-A")
        _git(self.root, "commit", "-q", "-m", "drop cross-plugin link")
        before = self._staged_bytes()
        conv.convert(self.root, ["p"], apply=True)
        after = self._staged_bytes()
        self.assertEqual(before, after)


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: 472kUpdated 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