Skip to content

feat(plugins): Support hybrid plugin bundles - #169

Merged
gricha merged 6 commits into
mainfrom
feat/hybrid-plugin-bundles
Aug 24, 2026
Merged

gricha merged 6 commits into
mainfrom
feat/hybrid-plugin-bundles

Conversation

@gricha

@gricha gricha commented Aug 22, 2026 •

Copy link
Copy Markdown
Member

Allow valid Agent Plugins v1 roots to coexist with authored Claude, Cursor, or Codex manifests and legacy-root resources instead of rejecting migration bundles. The portable root remains the source of truth for identity, metadata, skills, and MCP. Generated native manifests are disposable adapters and are never read back as source input; native manifests are retained byte-for-byte only when they contain matching-client behavior the portable model cannot reproduce.

Discovery records those target-specific fallbacks and validates them at the matching selected-client boundary. A malformed or mismatched fallback blocks its selected target, while other clients preserve it and continue with a warning. Unverifiable orphan provenance also fails closed: reconciliation preserves every native output, emits one warning, and continues. Reconciliation handles managed-to-fallback and fallback-to-managed transitions, removes stale generated sidecars, and prevents legacy or native-only resources from leaking into other projections. Grok retains only portable MCP-referenced files and directory trees when those resources live under otherwise excluded legacy roots.

Native-only imports keep their existing conservative behavior. Install, sync, list, and doctor expose the durable compatibility state without changing agents.toml or agents.lock, and invalid portable roots still fail rather than downgrade to native or generalized legacy parsing.

Fixes #161

@vercel

vercel Bot commented Aug 22, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
dotagents Ready Ready Preview Aug 23, 2026 11:13pm

Request Review

@gricha
gricha marked this pull request as ready for review August 22, 2026 20:14
@github-actions github-actions Bot added the risk: high PR risk score: high label Aug 22, 2026
Comment thread packages/dotagents/src/plugins/runtime/writer.ts Outdated
Comment thread packages/dotagents/src/plugins/runtime/writer.ts Outdated
Comment thread packages/dotagents/src/cli/commands/sync.ts
Comment thread packages/dotagents/src/plugins/store.ts
…ndles

# Conflicts:
#	packages/dotagents/src/cli/index.test.ts
#	packages/dotagents/src/plugins/store.ts
Comment thread packages/dotagents/src/plugins/runtime/writer.ts Outdated
Comment thread packages/dotagents/src/plugins/runtime/writer.ts

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 9cd35b7. Configure here.

Comment thread packages/dotagents/src/plugins/runtime/writer.ts
@gricha
gricha merged commit 4a8b61e into main Aug 24, 2026
19 checks passed
@gricha
gricha deleted the feat/hybrid-plugin-bundles branch August 24, 2026 15:50

This branch was successfully deployed

1 active deployment
Preview — 0e92d0cb Deployed Aug 23, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

risk: high PR risk score: high

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Plugin with a standard $schema root manifest + native/legacy components fails to install

1 participant