Add recursive package manifest imports

[Copilot]

Package manifests can now compose subpackages instead of duplicating their file declarations. Imported manifests produce one validated install list.

Changes

• Manifest composition

  • Adds recursive imports support to the aw.yml schema.
  • Resolves paths relative to the importing manifest.
  • Uses top-level metadata and configuration.

• Unified installation

  • Combines imported workflows, resources, skills, and agents.
  • Supports local and remote packages consistently.
  • Suppresses implicit discovery for import-only manifests.

• Validation

  • Detects import cycles with the full cycle path.
  • Rejects paths escaping the top-level package root.
  • Prevents symlink-based local escapes.
  • Rejects case-insensitive destination clashes before installation.

name: Central Agentic Ops
imports:
  - activity/aw.yml
  - ambient-context/aw.yml
  - dashboard/aw.yml

---

Generated by 👨‍🍳 PR Sous Chef · pi · gpt54 · 22.6 AIC · ⌖ 8.6 AIC · ⊞ 9.2K · ◷
_{Comment /souschef to run again}

[pelikhan]

@copilot add tests with various tooologies

[pelikhan]

@copilot do not add a new keyword, reuse "includes"

[Copilot]

🟡 Changes recommended

Compile-time validation now incorrectly rejects package manifests marked private.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds recursive aw.yml imports so repository packages can compose validated installable assets.

Changes:

• Resolves local and remote manifest import graphs with cycle and path validation.
• Unifies workflows, resources, skills, and agents with destination-clash detection.
• Documents and tests manifest composition.

File summaries

File	Description
pkg/parser/schemas/aw_manifest_schema.json	Defines the imports field.
pkg/cli/compile_repository_manifest.go	Validates composed local manifests.
pkg/cli/add_workflow_resolution.go	Resolves local imported assets.
pkg/cli/add_package_manifest_resolve.go	Resolves remote imported assets.
pkg/cli/add_package_manifest_parse.go	Parses manifest imports.
pkg/cli/add_package_manifest_imports.go	Implements graph and collision validation.
pkg/cli/add_package_manifest_imports_test.go	Tests imports, cycles, symlinks, and clashes.
docs/src/content/docs/specs/repository-package-manifest-specification.md	Specifies import behavior.
docs/src/content/docs/reference/aw-yml-package-manifest.md	Documents user-facing usage.

Review details

• Files reviewed: 9/9 changed files
• Comments generated: 1
• Review effort level: Balanced

---

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

@copilot add tests with various tooologies

Added manifest topology coverage for chained, shared (diamond), cycle, path normalization, symlink escape, and destination clash cases in 85f0d64.

@copilot do not add a new keyword, reuse "includes"

Package composition now reuses includes entries naming aw.yml manifests; the separate imports keyword was removed from the schema and documentation in 85f0d64.

[github-actions]

🎉 This pull request is included in a new release.

Release: v0.88.3