apm-cli 0.7.6__tar.gz → 0.7.8__tar.gz

apm_cli-0.7.8/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: apm-cli
+Version: 0.7.8
+Summary: MCP configuration tool
+Author-email: Daniel Meppiel <user@example.com>
+License: MIT License
+        
+        Copyright (c) Microsoft Corporation.
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: click>=8.0.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: llm>=0.17.0
+Requires-Dist: llm-github-models>=0.1.0
+Requires-Dist: tomli>=1.2.0; python_version < "3.11"
+Requires-Dist: toml>=0.10.2
+Requires-Dist: rich>=13.0.0
+Requires-Dist: rich-click>=1.7.0
+Requires-Dist: watchdog>=3.0.0
+Requires-Dist: GitPython>=3.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: build
+Requires-Dist: pyinstaller>=6.0.0; extra == "build"
+Dynamic: license-file
+
+# APM – Agent Package Manager
+
+**An open-source, community-driven dependency manager for AI agents.**
+
+Think `package.json`, `requirements.txt`, or `Cargo.toml` — but for AI agent configuration.
+
+GitHub Copilot · Claude Code
+
+**[Documentation](https://microsoft.github.io/apm/)** · **[Quick Start](https://microsoft.github.io/apm/getting-started/quick-start/)** · **[CLI Reference](https://microsoft.github.io/apm/reference/cli-commands/)**
+
+## Why APM
+
+AI coding agents need context to be useful — standards, prompts, skills, plugins — but today every developer sets this up manually. Nothing is portable nor reproducible. There's no manifest for it.
+
+**APM fixes this.** Declare your project's agentic dependencies once in `apm.yml`, and every developer who clones your repo gets a fully configured agent setup in seconds — with transitive dependency resolution, just like npm or pip.
+
+```yaml
+# apm.yml — ships with your project
+name: your-project
+version: 1.0.0
+dependencies:
+  apm:
+    # Skills from any repository
+    - anthropics/skills/skills/frontend-design
+    # Plugins
+    - github/awesome-copilot/plugins/context-engineering
+    # Specific agent primitives from any repository
+    - github/awesome-copilot/agents/api-architect.agent.md
+    # A full APM package with instructions, skills, prompts, hooks...
+    - microsoft/apm-sample-package
+```
+
+```bash
+git clone <org/repo> && cd <repo>
+apm install    # every agent is configured
+```
+
+## Highlights
+
+- **One manifest for everything** — instructions, skills, prompts, agents, hooks, plugins, MCP servers
+- **Install from anywhere** — GitHub, GitLab, Bitbucket, Azure DevOps, GitHub Enterprise, any git host
+- **Transitive dependencies** — packages can depend on packages; APM resolves the full tree
+- **Compile to standards** — `apm compile` produces `AGENTS.md` (GitHub Copilot) and `CLAUDE.md` (Claude Code)
+- **Create & share** — `apm pack` bundles your current configuration as a zipped package
+- **CI/CD ready** — [GitHub Action](https://github.com/microsoft/apm-action) for automated workflows
+
+## Get Started
+
+```bash
+curl -sSL https://raw.githubusercontent.com/microsoft/apm/main/install.sh | sh
+```
+
+<details>
+<summary>Other install methods</summary>
+
+```bash
+# Homebrew
+brew install microsoft/apm/apm
+# pip
+pip install apm-cli
+```
+
+</details>
+
+Then start adding packages:
+
+```bash
+apm install microsoft/apm-sample-package
+```
+
+See the **[Getting Started guide](https://microsoft.github.io/apm/getting-started/quick-start/)** for the full walkthrough.
+
+## Community
+
+Created and maintained by [@danielmeppiel](https://github.com/danielmeppiel).
+
+- [Roadmap & Discussions](https://github.com/microsoft/apm/discussions/116)
+- [Contributing](CONTRIBUTING.md)
+- [AI Native Development guide](https://danielmeppiel.github.io/awesome-ai-native) — a practical learning path for AI-native development
+
+---
+
+**Built on open standards:** [AGENTS.md](https://agents.md) · [Agent Skills](https://agentskills.io) · [MCP](https://modelcontextprotocol.io)
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

apm_cli-0.7.8/README.md

@@ -0,0 +1,87 @@
+# APM – Agent Package Manager
+
+**An open-source, community-driven dependency manager for AI agents.**
+
+Think `package.json`, `requirements.txt`, or `Cargo.toml` — but for AI agent configuration.
+
+GitHub Copilot · Claude Code
+
+**[Documentation](https://microsoft.github.io/apm/)** · **[Quick Start](https://microsoft.github.io/apm/getting-started/quick-start/)** · **[CLI Reference](https://microsoft.github.io/apm/reference/cli-commands/)**
+
+## Why APM
+
+AI coding agents need context to be useful — standards, prompts, skills, plugins — but today every developer sets this up manually. Nothing is portable nor reproducible. There's no manifest for it.
+
+**APM fixes this.** Declare your project's agentic dependencies once in `apm.yml`, and every developer who clones your repo gets a fully configured agent setup in seconds — with transitive dependency resolution, just like npm or pip.
+
+```yaml
+# apm.yml — ships with your project
+name: your-project
+version: 1.0.0
+dependencies:
+  apm:
+    # Skills from any repository
+    - anthropics/skills/skills/frontend-design
+    # Plugins
+    - github/awesome-copilot/plugins/context-engineering
+    # Specific agent primitives from any repository
+    - github/awesome-copilot/agents/api-architect.agent.md
+    # A full APM package with instructions, skills, prompts, hooks...
+    - microsoft/apm-sample-package
+```
+
+```bash
+git clone <org/repo> && cd <repo>
+apm install    # every agent is configured
+```
+
+## Highlights
+
+- **One manifest for everything** — instructions, skills, prompts, agents, hooks, plugins, MCP servers
+- **Install from anywhere** — GitHub, GitLab, Bitbucket, Azure DevOps, GitHub Enterprise, any git host
+- **Transitive dependencies** — packages can depend on packages; APM resolves the full tree
+- **Compile to standards** — `apm compile` produces `AGENTS.md` (GitHub Copilot) and `CLAUDE.md` (Claude Code)
+- **Create & share** — `apm pack` bundles your current configuration as a zipped package
+- **CI/CD ready** — [GitHub Action](https://github.com/microsoft/apm-action) for automated workflows
+
+## Get Started
+
+```bash
+curl -sSL https://raw.githubusercontent.com/microsoft/apm/main/install.sh | sh
+```
+
+<details>
+<summary>Other install methods</summary>
+
+```bash
+# Homebrew
+brew install microsoft/apm/apm
+# pip
+pip install apm-cli
+```
+
+</details>
+
+Then start adding packages:
+
+```bash
+apm install microsoft/apm-sample-package
+```
+
+See the **[Getting Started guide](https://microsoft.github.io/apm/getting-started/quick-start/)** for the full walkthrough.
+
+## Community
+
+Created and maintained by [@danielmeppiel](https://github.com/danielmeppiel).
+
+- [Roadmap & Discussions](https://github.com/microsoft/apm/discussions/116)
+- [Contributing](CONTRIBUTING.md)
+- [AI Native Development guide](https://danielmeppiel.github.io/awesome-ai-native) — a practical learning path for AI-native development
+
+---
+
+**Built on open standards:** [AGENTS.md](https://agents.md) · [Agent Skills](https://agentskills.io) · [MCP](https://modelcontextprotocol.io)
+
+## Trademarks
+
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

{apm_cli-0.7.6 → apm_cli-0.7.8}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "apm-cli"
-version = "0.7.6"
+version = "0.7.8"
 description = "MCP configuration tool"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = {file = "LICENSE"}
 authors = [
     {name = "Daniel Meppiel", email = "user@example.com"}

{apm_cli-0.7.6 → apm_cli-0.7.8}/src/apm_cli/bundle/packer.py

@@ -12,8 +12,9 @@ from ..core.target_detection import detect_target
 from .lockfile_enrichment import enrich_lockfile_for_pack
 
 
-# Target prefix mapping
+# Target prefix mapping ("copilot" and "vscode" both map to .github/)
 _TARGET_PREFIXES = {
+    "copilot": [".github/"],
     "vscode": [".github/"],
     "claude": [".claude/"],
     "all": [".github/", ".claude/"],

{apm_cli-0.7.6 → apm_cli-0.7.8}/src/apm_cli/bundle/unpacker.py

@@ -6,7 +6,7 @@ import tarfile
 import tempfile
 from dataclasses import dataclass, field
 from pathlib import Path
-from typing import List
+from typing import Dict, List
 
 from ..deps.lockfile import LockFile
 
@@ -18,6 +18,8 @@ class UnpackResult:
     extracted_dir: Path
     files: List[str] = field(default_factory=list)
     verified: bool = False
+    dependency_files: Dict[str, List[str]] = field(default_factory=dict)
+    skipped_count: int = 0
 
 
 def unpack_bundle(
@@ -93,18 +95,20 @@ def unpack_bundle(
                 "apm.lock in the bundle could not be parsed — the bundle may be corrupt."
             )
 
-        # Collect all deployed_files from lockfile
-        all_deployed: list[str] = []
-        for dep in lockfile.get_all_dependencies():
-            all_deployed.extend(dep.deployed_files)
-
-        # Deduplicate
+        # Collect deployed_files per dependency and deduplicated global list
+        dep_file_map: Dict[str, List[str]] = {}
         seen: set[str] = set()
         unique_files: list[str] = []
-        for f in all_deployed:
-            if f not in seen:
-                seen.add(f)
-                unique_files.append(f)
+        for dep in lockfile.get_all_dependencies():
+            dep_key = dep.get_unique_key()
+            dep_files: list[str] = []
+            for f in dep.deployed_files:
+                dep_files.append(f)
+                if f not in seen:
+                    seen.add(f)
+                    unique_files.append(f)
+            if dep_files:
+                dep_file_map[dep_key] = dep_files
 
         # 3. Verify completeness
         verified = True
@@ -128,11 +132,13 @@ def unpack_bundle(
                 extracted_dir=bundle_path,
                 files=unique_files,
                 verified=verified,
+                dependency_files=dep_file_map,
             )
 
         # 4. Copy target files to output_dir (additive, no deletes)
         output_dir = Path(output_dir)
         output_dir_resolved = output_dir.resolve()
+        skipped = 0
         for rel_path in unique_files:
             # Guard against absolute paths or path-traversal entries in deployed_files
             p = Path(rel_path)
@@ -147,6 +153,7 @@ def unpack_bundle(
                 )
             src = source_dir / rel_path
             if not src.exists():
+                skipped += 1
                 continue  # skip_verify may allow missing files
             if src.is_dir():
                 shutil.copytree(src, dest, dirs_exist_ok=True)
@@ -158,6 +165,8 @@ def unpack_bundle(
             extracted_dir=bundle_path,
             files=unique_files,
             verified=verified,
+            dependency_files=dep_file_map,
+            skipped_count=skipped,
         )
     finally:
         # Clean up temp dir if we created one

apm_cli-0.7.8/src/apm_cli/cli.py

@@ -0,0 +1,80 @@
+"""Command-line interface for Agent Package Manager (APM).
+
+Thin wiring layer — all command logic lives in ``apm_cli.commands.*`` modules.
+"""
+
+import sys
+
+import click
+
+from apm_cli.commands._helpers import (
+    ERROR,
+    RESET,
+    _check_and_notify_updates,
+    print_version,
+)
+from apm_cli.commands.compile import compile as compile_cmd
+from apm_cli.commands.config import config
+from apm_cli.commands.deps import deps
+from apm_cli.commands.init import init
+from apm_cli.commands.install import install
+from apm_cli.commands.list_cmd import list as list_cmd
+from apm_cli.commands.mcp import mcp
+from apm_cli.commands.pack import pack_cmd, unpack_cmd
+from apm_cli.commands.prune import prune
+from apm_cli.commands.run import preview, run
+from apm_cli.commands.runtime import runtime
+from apm_cli.commands.uninstall import uninstall
+from apm_cli.commands.update import update
+
+
+@click.group(
+    help="Agent Package Manager (APM): The package manager for AI-Native Development"
+)
+@click.option(
+    "--version",
+    is_flag=True,
+    callback=print_version,
+    expose_value=False,
+    is_eager=True,
+    help="Show version and exit.",
+)
+@click.pass_context
+def cli(ctx):
+    """Main entry point for the APM CLI."""
+    ctx.ensure_object(dict)
+
+    # Check for updates non-blockingly (only if not already showing version)
+    if not ctx.resilient_parsing:
+        _check_and_notify_updates()
+
+
+# Register command groups
+cli.add_command(deps)
+cli.add_command(pack_cmd, name="pack")
+cli.add_command(unpack_cmd, name="unpack")
+cli.add_command(init)
+cli.add_command(install)
+cli.add_command(uninstall)
+cli.add_command(prune)
+cli.add_command(update)
+cli.add_command(compile_cmd, name="compile")
+cli.add_command(run)
+cli.add_command(preview)
+cli.add_command(list_cmd, name="list")
+cli.add_command(config)
+cli.add_command(runtime)
+cli.add_command(mcp)
+
+
+def main():
+    """Main entry point for the CLI."""
+    try:
+        cli(obj={})
+    except Exception as e:
+        click.echo(f"{ERROR}Error: {e}{RESET}", err=True)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()