Skip to content

feat: support package namespaces for skills#1028

Open
shreejaykurhade wants to merge 7 commits intomicrosoft:mainfrom
shreejaykurhade:feature/support-package-namespaces
Open

feat: support package namespaces for skills#1028
shreejaykurhade wants to merge 7 commits intomicrosoft:mainfrom
shreejaykurhade:feature/support-package-namespaces

Conversation

@shreejaykurhade
Copy link
Copy Markdown
Contributor

@shreejaykurhade shreejaykurhade commented Apr 29, 2026

Add an optional namespace field to apm.yml, deploy package-owned skills and promoted sub-skills under skills/<namespace>/<skill-name>, and persist the namespace in apm.lock.yaml.

Also document the namespace schema and add coverage for validation, namespaced deployment, lockfile round-tripping, and lockfile assembly.

Description

This PR implements opt-in package namespaces for skill deployment.

Today, installed skills from project packages, direct dependencies, and transitive dependencies are flattened into the same skills/ directory. That makes it harder to identify where a skill came from and easier to accidentally edit dependency-owned skills while working in a project.

With this change, package authors can declare a safe single-segment namespace in apm.yml. When present, APM deploys native package skills and promoted .apm/skills/ sub-skills under:

skills/<namespace>/<skill-name>

Packages without namespace keep the existing flat layout, so current packages remain backward compatible.

Fixes #739

Type of change

  • Bug fix
  • New feature
  • Documentation
  • Maintenance / refactor

Testing

  • Tested locally
  • All existing tests pass
  • Added tests for new functionality (if applicable)

Local checks run:

python -m pytest tests\test_apm_package_models.py
python -m pytest tests\unit\integration\test_skill_integrator.py tests\test_lockfile.py
python -m pytest tests\unit\test_drift_detection.py tests\unit\test_install_update.py -k "build_download_ref or drift"
python -m pytest tests\unit\test_artifactory_support.py -k "download_ref or registry_prefix"

Add an optional namespace field to apm.yml, deploy package-owned
skills and promoted sub-skills under skills/<namespace>/<skill-name>,
and persist the namespace in apm.lock.yaml.

Also document the namespace schema and add coverage for validation,
namespaced deployment, lockfile round-tripping, and lockfile assembly.
…ge-namespaces

# Conflicts:
#	src/apm_cli/install/phases/lockfile.py
#	src/apm_cli/integration/skill_integrator.py
#	src/apm_cli/models/apm_package.py
Copilot AI review requested due to automatic review settings April 29, 2026 01:43
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@shreejaykurhade
Copy link
Copy Markdown
Contributor Author

@danielmeppiel @sergio-sisternes-epam please review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FEATURE] Support package namespaces

2 participants