@vibe-forge/workspace-assets 2.0.0 → 2.0.1

package/__tests__/__snapshots__/workspace-assets-rich.snapshot.json

@@ -510,12 +510,14 @@
           "assetId": "entity:workspace:workspace:architect:<workspace>/.ai/entities/architect/README.md",
           "adapter": "claude-code",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "hookPlugin:plugin:0:logger:<workspace>/node_modules/@vibe-forge/plugin-logger",
           "adapter": "claude-code",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Claude Code native hooks bridge.",
           "packageId": "@vibe-forge/plugin-logger"
         },
@@ -523,6 +525,7 @@
           "assetId": "hookPlugin:plugin:1:demo/demo:<workspace>/node_modules/@vibe-forge/plugin-demo",
           "adapter": "claude-code",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Claude Code native hooks bridge.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -531,6 +534,7 @@
           "assetId": "hookPlugin:plugin:2:telemetry:<workspace>/node_modules/@vibe-forge/plugin-telemetry",
           "adapter": "claude-code",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Claude Code native hooks bridge.",
           "packageId": "@vibe-forge/plugin-telemetry"
         },
@@ -538,12 +542,14 @@
           "assetId": "mcpServer:workspace:workspace:docs:<workspace>/.ai.config.json",
           "adapter": "claude-code",
           "status": "native",
+          "source": "project",
           "reason": "Mapped into adapter MCP settings."
         },
         {
           "assetId": "rule:plugin:1:demo/security:<workspace>/node_modules/@vibe-forge/plugin-demo/rules/security.md",
           "adapter": "claude-code",
           "status": "prompt",
+          "source": "plugin",
           "reason": "Mapped into the generated system prompt.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -552,24 +558,28 @@
           "assetId": "rule:workspace:workspace:review:<workspace>/.ai/rules/review.md",
           "adapter": "claude-code",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "skill:workspace:workspace:research:<workspace>/.ai/skills/research/SKILL.md",
           "adapter": "claude-code",
           "status": "native",
+          "source": "project",
           "reason": "Synced into the Claude mock home as a native skill."
         },
         {
           "assetId": "skill:workspace:workspace:research:<workspace>/.ai/skills/research/SKILL.md",
           "adapter": "claude-code",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "spec:plugin:1:demo/release:<workspace>/node_modules/@vibe-forge/plugin-demo/specs/release/index.md",
           "adapter": "claude-code",
           "status": "prompt",
+          "source": "plugin",
           "reason": "Mapped into the generated system prompt.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -578,6 +588,7 @@
           "assetId": "spec:workspace:workspace:release:<workspace>/.ai/specs/release/index.md",
           "adapter": "claude-code",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         }
       ]
@@ -598,6 +609,7 @@
           "assetId": "agent:plugin:1:demo/release-helper:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/agents/release-helper.md",
           "adapter": "codex",
           "status": "skipped",
+          "source": "plugin",
           "reason": "No stable native Codex mapping exists for this asset kind in V1.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -606,6 +618,7 @@
           "assetId": "command:plugin:1:demo/review:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/commands/review.md",
           "adapter": "codex",
           "status": "skipped",
+          "source": "plugin",
           "reason": "No stable native Codex mapping exists for this asset kind in V1.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -614,12 +627,14 @@
           "assetId": "entity:workspace:workspace:architect:<workspace>/.ai/entities/architect/README.md",
           "adapter": "codex",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "hookPlugin:plugin:0:logger:<workspace>/node_modules/@vibe-forge/plugin-logger",
           "adapter": "codex",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Codex native hooks bridge.",
           "packageId": "@vibe-forge/plugin-logger"
         },
@@ -627,6 +642,7 @@
           "assetId": "hookPlugin:plugin:1:demo/demo:<workspace>/node_modules/@vibe-forge/plugin-demo",
           "adapter": "codex",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Codex native hooks bridge.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -635,6 +651,7 @@
           "assetId": "hookPlugin:plugin:2:telemetry:<workspace>/node_modules/@vibe-forge/plugin-telemetry",
           "adapter": "codex",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Codex native hooks bridge.",
           "packageId": "@vibe-forge/plugin-telemetry"
         },
@@ -642,12 +659,14 @@
           "assetId": "mcpServer:workspace:workspace:docs:<workspace>/.ai.config.json",
           "adapter": "codex",
           "status": "translated",
+          "source": "project",
           "reason": "Translated into adapter-specific MCP configuration."
         },
         {
           "assetId": "mode:plugin:1:demo/strict:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/modes/strict.md",
           "adapter": "codex",
           "status": "skipped",
+          "source": "plugin",
           "reason": "No stable native Codex mapping exists for this asset kind in V1.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -656,6 +675,7 @@
           "assetId": "nativePlugin:plugin:1:demo/demo-plugin:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/plugins/demo-plugin.js",
           "adapter": "codex",
           "status": "skipped",
+          "source": "plugin",
           "reason": "No stable native Codex mapping exists for this asset kind in V1.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -664,6 +684,7 @@
           "assetId": "rule:plugin:1:demo/security:<workspace>/node_modules/@vibe-forge/plugin-demo/rules/security.md",
           "adapter": "codex",
           "status": "prompt",
+          "source": "plugin",
           "reason": "Mapped into the generated system prompt.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -672,18 +693,21 @@
           "assetId": "rule:workspace:workspace:review:<workspace>/.ai/rules/review.md",
           "adapter": "codex",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "skill:workspace:workspace:research:<workspace>/.ai/skills/research/SKILL.md",
           "adapter": "codex",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "spec:plugin:1:demo/release:<workspace>/node_modules/@vibe-forge/plugin-demo/specs/release/index.md",
           "adapter": "codex",
           "status": "prompt",
+          "source": "plugin",
           "reason": "Mapped into the generated system prompt.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -692,6 +716,7 @@
           "assetId": "spec:workspace:workspace:release:<workspace>/.ai/specs/release/index.md",
           "adapter": "codex",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         }
       ]
@@ -712,6 +737,7 @@
           "assetId": "agent:plugin:1:demo/release-helper:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/agents/release-helper.md",
           "adapter": "gemini",
           "status": "skipped",
+          "source": "plugin",
           "reason": "No stable native Gemini mapping exists for this asset kind in V1.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -720,6 +746,7 @@
           "assetId": "command:plugin:1:demo/review:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/commands/review.md",
           "adapter": "gemini",
           "status": "skipped",
+          "source": "plugin",
           "reason": "No stable native Gemini mapping exists for this asset kind in V1.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -728,12 +755,14 @@
           "assetId": "entity:workspace:workspace:architect:<workspace>/.ai/entities/architect/README.md",
           "adapter": "gemini",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "hookPlugin:plugin:0:logger:<workspace>/node_modules/@vibe-forge/plugin-logger",
           "adapter": "gemini",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Gemini native hooks bridge.",
           "packageId": "@vibe-forge/plugin-logger"
         },
@@ -741,6 +770,7 @@
           "assetId": "hookPlugin:plugin:1:demo/demo:<workspace>/node_modules/@vibe-forge/plugin-demo",
           "adapter": "gemini",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Gemini native hooks bridge.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -749,6 +779,7 @@
           "assetId": "hookPlugin:plugin:2:telemetry:<workspace>/node_modules/@vibe-forge/plugin-telemetry",
           "adapter": "gemini",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the Gemini native hooks bridge.",
           "packageId": "@vibe-forge/plugin-telemetry"
         },
@@ -756,12 +787,14 @@
           "assetId": "mcpServer:workspace:workspace:docs:<workspace>/.ai.config.json",
           "adapter": "gemini",
           "status": "translated",
+          "source": "project",
           "reason": "Translated into adapter-specific MCP configuration."
         },
         {
           "assetId": "mode:plugin:1:demo/strict:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/modes/strict.md",
           "adapter": "gemini",
           "status": "skipped",
+          "source": "plugin",
           "reason": "No stable native Gemini mapping exists for this asset kind in V1.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -770,6 +803,7 @@
           "assetId": "nativePlugin:plugin:1:demo/demo-plugin:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/plugins/demo-plugin.js",
           "adapter": "gemini",
           "status": "skipped",
+          "source": "plugin",
           "reason": "No stable native Gemini mapping exists for this asset kind in V1.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -778,6 +812,7 @@
           "assetId": "rule:plugin:1:demo/security:<workspace>/node_modules/@vibe-forge/plugin-demo/rules/security.md",
           "adapter": "gemini",
           "status": "prompt",
+          "source": "plugin",
           "reason": "Mapped into the generated system prompt.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -786,24 +821,28 @@
           "assetId": "rule:workspace:workspace:review:<workspace>/.ai/rules/review.md",
           "adapter": "gemini",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "skill:workspace:workspace:research:<workspace>/.ai/skills/research/SKILL.md",
           "adapter": "gemini",
           "status": "native",
+          "source": "project",
           "reason": "Symlinked into GEMINI_CLI_HOME as a native Gemini skill."
         },
         {
           "assetId": "skill:workspace:workspace:research:<workspace>/.ai/skills/research/SKILL.md",
           "adapter": "gemini",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "spec:plugin:1:demo/release:<workspace>/node_modules/@vibe-forge/plugin-demo/specs/release/index.md",
           "adapter": "gemini",
           "status": "prompt",
+          "source": "plugin",
           "reason": "Mapped into the generated system prompt.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -812,6 +851,7 @@
           "assetId": "spec:workspace:workspace:release:<workspace>/.ai/specs/release/index.md",
           "adapter": "gemini",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         }
       ]
@@ -863,6 +903,7 @@
           "assetId": "agent:plugin:1:demo/release-helper:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/agents/release-helper.md",
           "adapter": "opencode",
           "status": "native",
+          "source": "plugin",
           "reason": "Mirrored into OPENCODE_CONFIG_DIR as a native OpenCode asset.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -871,6 +912,7 @@
           "assetId": "command:plugin:1:demo/review:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/commands/review.md",
           "adapter": "opencode",
           "status": "native",
+          "source": "plugin",
           "reason": "Mirrored into OPENCODE_CONFIG_DIR as a native OpenCode asset.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -879,12 +921,14 @@
           "assetId": "entity:workspace:workspace:architect:<workspace>/.ai/entities/architect/README.md",
           "adapter": "opencode",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "hookPlugin:plugin:0:logger:<workspace>/node_modules/@vibe-forge/plugin-logger",
           "adapter": "opencode",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the OpenCode native hooks bridge.",
           "packageId": "@vibe-forge/plugin-logger"
         },
@@ -892,6 +936,7 @@
           "assetId": "hookPlugin:plugin:1:demo/demo:<workspace>/node_modules/@vibe-forge/plugin-demo",
           "adapter": "opencode",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the OpenCode native hooks bridge.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -900,6 +945,7 @@
           "assetId": "hookPlugin:plugin:2:telemetry:<workspace>/node_modules/@vibe-forge/plugin-telemetry",
           "adapter": "opencode",
           "status": "native",
+          "source": "plugin",
           "reason": "Mapped into the OpenCode native hooks bridge.",
           "packageId": "@vibe-forge/plugin-telemetry"
         },
@@ -907,12 +953,14 @@
           "assetId": "mcpServer:workspace:workspace:docs:<workspace>/.ai.config.json",
           "adapter": "opencode",
           "status": "translated",
+          "source": "project",
           "reason": "Translated into adapter-specific MCP configuration."
         },
         {
           "assetId": "mode:plugin:1:demo/strict:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/modes/strict.md",
           "adapter": "opencode",
           "status": "native",
+          "source": "plugin",
           "reason": "Mirrored into OPENCODE_CONFIG_DIR as a native OpenCode asset.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -921,6 +969,7 @@
           "assetId": "nativePlugin:plugin:1:demo/demo-plugin:<workspace>/node_modules/@vibe-forge/plugin-demo/opencode/plugins/demo-plugin.js",
           "adapter": "opencode",
           "status": "native",
+          "source": "plugin",
           "reason": "Mirrored into OPENCODE_CONFIG_DIR as a native OpenCode asset.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -929,6 +978,7 @@
           "assetId": "rule:plugin:1:demo/security:<workspace>/node_modules/@vibe-forge/plugin-demo/rules/security.md",
           "adapter": "opencode",
           "status": "prompt",
+          "source": "plugin",
           "reason": "Mapped into the generated system prompt.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -937,24 +987,28 @@
           "assetId": "rule:workspace:workspace:review:<workspace>/.ai/rules/review.md",
           "adapter": "opencode",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "skill:workspace:workspace:research:<workspace>/.ai/skills/research/SKILL.md",
           "adapter": "opencode",
           "status": "native",
+          "source": "project",
           "reason": "Mirrored into OPENCODE_CONFIG_DIR as a native skill."
         },
         {
           "assetId": "skill:workspace:workspace:research:<workspace>/.ai/skills/research/SKILL.md",
           "adapter": "opencode",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         },
         {
           "assetId": "spec:plugin:1:demo/release:<workspace>/node_modules/@vibe-forge/plugin-demo/specs/release/index.md",
           "adapter": "opencode",
           "status": "prompt",
+          "source": "plugin",
           "reason": "Mapped into the generated system prompt.",
           "scope": "demo",
           "packageId": "@vibe-forge/plugin-demo"
@@ -963,6 +1017,7 @@
           "assetId": "spec:workspace:workspace:release:<workspace>/.ai/specs/release/index.md",
           "adapter": "opencode",
           "status": "prompt",
+          "source": "project",
           "reason": "Mapped into the generated system prompt."
         }
       ]

package/__tests__/adapter-asset-plan.spec.ts

@@ -1,6 +1,23 @@
+/* eslint-disable import/first, max-lines -- adapter asset plan scenarios share setup helpers and assertions */
 import { join } from 'node:path'
 
-import { describe, expect, it } from 'vitest'
+import { describe, expect, it, vi } from 'vitest'
+
+const skillsCliMocks = vi.hoisted(() => ({
+  findSkillsCli: vi.fn(),
+  installSkillsCliRefToTemp: vi.fn(),
+  installSkillsCliSkillToTemp: vi.fn()
+}))
+
+vi.mock('@vibe-forge/utils/skills-cli', async () => {
+  const actual = await vi.importActual<typeof import('@vibe-forge/utils/skills-cli')>('@vibe-forge/utils/skills-cli')
+  return {
+    ...actual,
+    findSkillsCli: skillsCliMocks.findSkillsCli,
+    installSkillsCliRefToTemp: skillsCliMocks.installSkillsCliRefToTemp,
+    installSkillsCliSkillToTemp: skillsCliMocks.installSkillsCliSkillToTemp
+  }
+})
 
 import { buildAdapterAssetPlan, resolvePromptAssetSelection, resolveWorkspaceAssetBundle } from '#~/index.js'
 
@@ -78,7 +95,7 @@ describe('buildAdapterAssetPlan', () => {
         }
       }
     })
-    const plan = buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'codex',
       bundle,
       options: {
@@ -150,7 +167,7 @@ describe('buildAdapterAssetPlan', () => {
       }, undefined],
       useDefaultVibeForgeMcpServer: false
     })
-    const plan = buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'opencode',
       bundle,
       options: {
@@ -180,6 +197,203 @@ describe('buildAdapterAssetPlan', () => {
     ]))
   })
 
+  it('labels home-bridged skill diagnostics with source=home', async () => {
+    const workspace = await createWorkspace()
+    const realHome = process.env.__VF_PROJECT_REAL_HOME__
+
+    await writeDocument(
+      join(realHome!, '.agents/skills/research/SKILL.md'),
+      '---\ndescription: 检索资料\n---\n阅读 README.md'
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [undefined, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+    const researchSkillId = bundle.skills.find(asset => asset.name === 'research')?.id
+
+    const plan = await buildAdapterAssetPlan({
+      adapter: 'opencode',
+      bundle,
+      options: {
+        skills: {
+          include: ['research']
+        }
+      }
+    })
+
+    expect(plan.diagnostics).toEqual(expect.arrayContaining([
+      expect.objectContaining({
+        assetId: researchSkillId,
+        adapter: 'opencode',
+        status: 'native',
+        source: 'home'
+      })
+    ]))
+  })
+
+  it('includes transitive skill dependencies in selected native overlays', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/skills/app-builder/SKILL.md'),
+      [
+        '---',
+        'name: app-builder',
+        'description: Build apps',
+        'dependencies:',
+        '  - frontend-design',
+        '---',
+        'Build the app.'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/frontend-design/SKILL.md'),
+      '---\nname: frontend-design\ndescription: UI design guidance\n---\nDesign the UI.'
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [undefined, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+    const plan = await buildAdapterAssetPlan({
+      adapter: 'opencode',
+      bundle,
+      options: {
+        skills: {
+          include: ['app-builder']
+        }
+      }
+    })
+
+    expect(plan.overlays).toEqual(expect.arrayContaining([
+      expect.objectContaining({
+        kind: 'skill',
+        targetPath: 'skills/app-builder'
+      }),
+      expect.objectContaining({
+        kind: 'skill',
+        targetPath: 'skills/frontend-design'
+      })
+    ]))
+  })
+
+  it('keeps explicit skills CLI dependencies ahead of preselected home-bridged skills in overlays', async () => {
+    const workspace = await createWorkspace()
+    const realHome = process.env.__VF_PROJECT_REAL_HOME__
+    const tempInstallDir = join(workspace, '.tmp-install-skills-cli-foo')
+    const installedSkillDir = join(tempInstallDir, '.agents', 'skills', 'foo')
+    await writeDocument(
+      join(installedSkillDir, 'SKILL.md'),
+      '---\nname: foo\ndescription: Registry foo\n---\nUse the registry definition.\n'
+    )
+    skillsCliMocks.installSkillsCliSkillToTemp.mockResolvedValue({
+      tempDir: tempInstallDir,
+      installedSkill: {
+        dirName: 'foo',
+        name: 'foo',
+        sourcePath: installedSkillDir
+      }
+    })
+
+    await writeDocument(
+      join(realHome!, '.agents/skills/foo/SKILL.md'),
+      '---\ndescription: Home foo\n---\nUse the home definition.\n'
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/app-builder/SKILL.md'),
+      [
+        '---',
+        'name: app-builder',
+        'description: Build apps',
+        'dependencies:',
+        '  - anthropics/skills@foo',
+        '---',
+        'Build the app.'
+      ].join('\n')
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [undefined, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+    const plan = await buildAdapterAssetPlan({
+      adapter: 'opencode',
+      bundle,
+      options: {
+        skills: {
+          include: ['foo', 'app-builder']
+        }
+      }
+    })
+
+    const fooOverlays = plan.overlays.filter(entry => entry.kind === 'skill' && entry.targetPath === 'skills/foo')
+    expect(fooOverlays).toHaveLength(1)
+    expect(fooOverlays[0]?.sourcePath).toContain(
+      '/.ai/caches/skill-dependencies/skills-cli/skills/latest/default/anthropics/skills/foo'
+    )
+    expect(fooOverlays[0]?.sourcePath).not.toBe(join(realHome!, '.agents/skills/foo'))
+  })
+
+  it('prunes excluded skill dependency subtrees from selected native overlays', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/skills/app-builder/SKILL.md'),
+      [
+        '---',
+        'name: app-builder',
+        'description: Build apps',
+        'dependencies:',
+        '  - frontend-design',
+        '---',
+        'Build the app.'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/frontend-design/SKILL.md'),
+      [
+        '---',
+        'name: frontend-design',
+        'description: UI design guidance',
+        'dependencies:',
+        '  - color-system',
+        '---',
+        'Design the UI.'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/color-system/SKILL.md'),
+      '---\nname: color-system\ndescription: Color guidance\n---\nPick accessible colors.'
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [undefined, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+    const plan = await buildAdapterAssetPlan({
+      adapter: 'opencode',
+      bundle,
+      options: {
+        skills: {
+          include: ['app-builder'],
+          exclude: ['frontend-design']
+        }
+      }
+    })
+
+    expect(plan.overlays).toEqual([
+      expect.objectContaining({
+        kind: 'skill',
+        targetPath: 'skills/app-builder'
+      })
+    ])
+  })
+
   it('builds copilot native skill overlays and translated runtime diagnostics', async () => {
     const workspace = await createWorkspace()
 
@@ -246,7 +460,7 @@ describe('buildAdapterAssetPlan', () => {
         }
       }
     })
-    const plan = buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'copilot',
       bundle,
       options: {
@@ -346,7 +560,7 @@ describe('buildAdapterAssetPlan', () => {
     const loggerHookPluginId = bundle.hookPlugins.find(asset => asset.packageId === '@vibe-forge/plugin-logger')?.id
     const demoCommandId = bundle.opencodeOverlayAssets.find(asset => asset.kind === 'command')?.id
 
-    const plan = buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'kimi',
       bundle,
       options: {
@@ -400,7 +614,7 @@ describe('buildAdapterAssetPlan', () => {
     })
     const loggerHookPluginId = bundle.hookPlugins.find(asset => asset.packageId === '@vibe-forge/plugin-logger')?.id
 
-    const plan = buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'gemini',
       bundle,
       options: {}