@vibe-forge/workspace-assets 2.0.0 → 2.0.2

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

@@ -1,6 +1,7 @@
+/* eslint-disable 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'
 
 import { buildAdapterAssetPlan, resolvePromptAssetSelection, resolveWorkspaceAssetBundle } from '#~/index.js'
 
@@ -78,7 +79,7 @@ describe('buildAdapterAssetPlan', () => {
         }
       }
     })
-    const plan = buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'codex',
       bundle,
       options: {
@@ -150,7 +151,7 @@ describe('buildAdapterAssetPlan', () => {
       }, undefined],
       useDefaultVibeForgeMcpServer: false
     })
-    const plan = buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'opencode',
       bundle,
       options: {
@@ -180,6 +181,217 @@ 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 registry dependencies ahead of preselected home-bridged skills in overlays', async () => {
+    const workspace = await createWorkspace()
+    const realHome = process.env.__VF_PROJECT_REAL_HOME__
+    const fetchMock = vi.fn(async (url: string) => {
+      if (url === 'https://registry.example.test/api/search?q=foo&limit=10') {
+        return new Response(JSON.stringify({
+          skills: [{
+            id: 'anthropics/skills/foo',
+            skillId: 'foo',
+            name: 'foo',
+            source: 'anthropics/skills'
+          }]
+        }))
+      }
+      if (url === 'https://registry.example.test/api/download/anthropics/skills/foo') {
+        return new Response(JSON.stringify({
+          files: [{
+            path: 'SKILL.md',
+            contents: '---\nname: foo\ndescription: Registry foo\n---\nUse the registry definition.\n'
+          }]
+        }))
+      }
+      return new Response('not found', { status: 404 })
+    })
+    vi.stubGlobal('fetch', fetchMock)
+
+    try {
+      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: [{
+          skills: {
+            registry: 'https://registry.example.test'
+          }
+        }, 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/registry.example.test/')
+      expect(fooOverlays[0]?.sourcePath).not.toBe(join(realHome!, '.agents/skills/foo'))
+    } finally {
+      vi.unstubAllGlobals()
+    }
+  })
+
+  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 +458,7 @@ describe('buildAdapterAssetPlan', () => {
         }
       }
     })
-    const plan = buildAdapterAssetPlan({
+    const plan = await buildAdapterAssetPlan({
       adapter: 'copilot',
       bundle,
       options: {
@@ -346,7 +558,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 +612,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: {}