@vibe-forge/workspace-assets 0.9.2 → 0.10.1-alpha.0

package/__tests__/bundle.spec.ts

@@ -1,10 +1,11 @@
 import process from 'node:process'
+import { join } from 'node:path'
 
 import { describe, expect, it } from 'vitest'
 
 import { resolveWorkspaceAssetBundle } from '#~/index.js'
 
-import { createWorkspace, installPluginPackage } from './test-helpers'
+import { createWorkspace, installPluginPackage, writeDocument } from './test-helpers'
 
 describe('resolveWorkspaceAssetBundle', () => {
   it('loads npm plugin assets via the package-id fallback and exposes OpenCode overlays', async () => {
@@ -67,6 +68,58 @@ describe('resolveWorkspaceAssetBundle', () => {
     ]))
   })
 
+  it('auto-loads managed Claude plugins from .ai/plugins as directory plugins', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/.vf-plugin.json'),
+      JSON.stringify(
+        {
+          version: 1,
+          adapter: 'claude',
+          name: 'demo',
+          scope: 'demo',
+          installedAt: new Date().toISOString(),
+          source: {
+            type: 'path',
+            path: './demo'
+          },
+          nativePluginPath: 'native',
+          vibeForgePluginPath: 'vibe-forge'
+        },
+        null,
+        2
+      )
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/vibe-forge/skills/research/SKILL.md'),
+      '---\ndescription: 检索资料\n---\n阅读 README.md'
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/vibe-forge/mcp/browser.json'),
+      JSON.stringify({ command: 'npx', args: ['browser-server'] }, null, 2)
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/vibe-forge/hooks.js'),
+      'module.exports = { name: "demo-managed" }\n'
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [undefined, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.skills.map(asset => asset.displayName)).toContain('demo/research')
+    expect(Object.keys(bundle.mcpServers)).toContain('demo/browser')
+    expect(bundle.hookPlugins).toEqual(expect.arrayContaining([
+      expect.objectContaining({
+        scope: 'demo',
+        origin: 'plugin'
+      })
+    ]))
+  })
+
   it('adds the built-in Vibe Forge MCP server when enabled and omits it when disabled', async () => {
     const workspace = await createWorkspace()
 

package/__tests__/prompt-selection.spec.ts

@@ -241,6 +241,90 @@ describe('resolvePromptAssetSelection', () => {
     expect(options.systemPrompt).not.toContain('先读 README.md')
   })
 
+  it('omits route-only project skills when the adapter provides native skill loading', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/skills/research/SKILL.md'),
+      [
+        '---',
+        'description: 检索项目信息',
+        '---',
+        '先读 README.md'
+      ].join('\n')
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      useDefaultVibeForgeMcpServer: false
+    })
+    const [data, options] = await resolvePromptAssetSelection({
+      bundle,
+      adapter: 'claude-code',
+      type: undefined
+    })
+
+    expect(data.targetSkills).toEqual([])
+    expect(options.systemPrompt).not.toContain('<skills>')
+    expect(options.systemPrompt).not.toContain('# research')
+    expect(options.systemPrompt).not.toContain('Skill file path: .ai/skills/research/SKILL.md')
+    expect(options.promptAssetIds).not.toContain(bundle.skills[0]?.id)
+  })
+
+  it('keeps explicitly referenced skills embedded for adapters with native project skills', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/skills/research/SKILL.md'),
+      [
+        '---',
+        'description: 检索项目信息',
+        '---',
+        '先读 README.md'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/review/SKILL.md'),
+      [
+        '---',
+        'description: 评审代码改动',
+        '---',
+        '检查回归风险'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/specs/release/index.md'),
+      [
+        '---',
+        'description: 发布流程',
+        'skills:',
+        '  - research',
+        '---',
+        '执行发布'
+      ].join('\n')
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      useDefaultVibeForgeMcpServer: false
+    })
+    const [data, options] = await resolvePromptAssetSelection({
+      bundle,
+      adapter: 'claude-code',
+      type: 'spec',
+      name: 'release'
+    })
+
+    expect(data.targetSkills.map(skill => skill.resolvedName ?? skill.attributes.name)).toEqual(['research'])
+    expect(options.systemPrompt).toContain('The following skill modules are loaded for the project')
+    expect(options.systemPrompt).toContain('# research')
+    expect(options.systemPrompt).toContain('<skill-content>')
+    expect(options.systemPrompt).toContain('先读 README.md')
+    expect(options.systemPrompt).not.toContain('<skills>')
+    expect(options.systemPrompt).not.toContain('# review')
+    expect(options.systemPrompt).not.toContain('Skill file path: .ai/skills/review/SKILL.md')
+  })
+
   it('keeps spec route guidance without default identity in normal mode', async () => {
     const workspace = await createWorkspace()
 
@@ -389,4 +473,60 @@ describe('resolvePromptAssetSelection', () => {
     expect(options.systemPrompt).toContain('> Skill file path: .ai/skills/research/SKILL.md')
     expect(options.systemPrompt).not.toContain('先读 README.md')
   })
+
+  it('lets spec plugin overrides exclude managed plugins when mode is override', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/.vf-plugin.json'),
+      JSON.stringify({
+        version: 1,
+        adapter: 'claude',
+        name: 'demo',
+        scope: 'demo',
+        installedAt: new Date().toISOString(),
+        source: {
+          type: 'path',
+          path: './demo'
+        },
+        nativePluginPath: 'native',
+        vibeForgePluginPath: 'vibe-forge'
+      }, null, 2)
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/vibe-forge/skills/research/SKILL.md'),
+      [
+        '---',
+        'description: 托管插件技能',
+        '---',
+        '先读插件文档'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/specs/isolated/index.md'),
+      [
+        '---',
+        'description: 隔离 spec',
+        'plugins:',
+        '  mode: override',
+        '  list: []',
+        '---',
+        '执行隔离流程'
+      ].join('\n')
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      useDefaultVibeForgeMcpServer: false
+    })
+    const [, options] = await resolvePromptAssetSelection({
+      bundle,
+      type: 'spec',
+      name: 'isolated'
+    })
+
+    expect(bundle.skills.map(asset => asset.displayName)).toContain('demo/research')
+    expect(options.assetBundle?.skills).toEqual([])
+    expect(options.systemPrompt).not.toContain('demo/research')
+  })
 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-forge/workspace-assets",
-  "version": "0.9.2",
+  "version": "0.10.1-alpha.0",
   "description": "Workspace asset resolution and adapter asset planning for Vibe Forge",
   "imports": {
     "#~/*.js": {
@@ -25,19 +25,19 @@
     },
     "./package.json": "./package.json"
   },
+  "scripts": {
+    "test": "pnpm -C ../.. exec vitest run --workspace vitest.workspace.ts --project bundler packages/workspace-assets/__tests__"
+  },
   "dependencies": {
+    "@vibe-forge/config": "workspace:^",
+    "@vibe-forge/definition-core": "workspace:^",
+    "@vibe-forge/types": "workspace:^",
+    "@vibe-forge/utils": "workspace:^",
     "fast-glob": "^3.3.3",
     "front-matter": "^4.0.2",
-    "js-yaml": "^4.1.1",
-    "@vibe-forge/config": "^0.9.0",
-    "@vibe-forge/definition-core": "^0.9.0",
-    "@vibe-forge/utils": "^0.9.0",
-    "@vibe-forge/types": "^0.9.0"
+    "js-yaml": "^4.1.1"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9"
-  },
-  "scripts": {
-    "test": "pnpm -C ../.. exec vitest run --workspace vitest.workspace.ts --project bundler packages/workspace-assets/__tests__"
   }
-}
+}

package/src/adapter-asset-plan.ts

@@ -10,6 +10,7 @@ import type {
   WorkspaceSkillSelection
 } from '@vibe-forge/types'
 
+import { resolveNativeSkillDiagnosticReason, supportsNativeProjectSkills } from './adapter-capabilities'
 import { resolveSelectedMcpNames, resolveSelectedSkillAssets } from './selection-internal'
 
 export function buildAdapterAssetPlan(params: {
@@ -83,13 +84,13 @@ export function buildAdapterAssetPlan(params: {
   })
 
   const selectedSkillAssets = resolveSelectedSkillAssets(params.bundle.skills, params.options.skills)
-  if (params.adapter === 'opencode') {
+  if (supportsNativeProjectSkills(params.adapter)) {
     selectedSkillAssets.forEach((asset) => {
       diagnostics.push({
         assetId: asset.id,
         adapter: params.adapter,
         status: 'native',
-        reason: 'Mirrored into OPENCODE_CONFIG_DIR as a native skill.',
+        reason: resolveNativeSkillDiagnosticReason(params.adapter),
         packageId: asset.packageId,
         scope: asset.scope,
         instancePath: asset.instancePath,
@@ -98,6 +99,8 @@ export function buildAdapterAssetPlan(params: {
         taskOverlaySource: asset.taskOverlaySource
       })
     })
+  }
+  if (params.adapter === 'opencode') {
     params.bundle.opencodeOverlayAssets.forEach((asset) => {
       diagnostics.push({
         assetId: asset.id,

package/src/adapter-capabilities.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceAssetAdapter } from '@vibe-forge/types'
+
+const NATIVE_SKILL_ADAPTERS = new Set<WorkspaceAssetAdapter>(['claude-code', 'opencode'])
+
+export const supportsNativeProjectSkills = (adapter?: string): adapter is WorkspaceAssetAdapter =>
+  adapter != null && NATIVE_SKILL_ADAPTERS.has(adapter as WorkspaceAssetAdapter)
+
+export const resolveNativeSkillDiagnosticReason = (adapter: WorkspaceAssetAdapter) => (
+  adapter === 'claude-code'
+    ? 'Synced into the Claude mock home as a native skill.'
+    : 'Mirrored into OPENCODE_CONFIG_DIR as a native skill.'
+)

package/src/bundle-internal.ts

@@ -10,11 +10,12 @@ import {
 } from '@vibe-forge/config'
 import type { Config, Definition, Entity, PluginConfig, WorkspaceAsset, WorkspaceAssetKind } from '@vibe-forge/types'
 import { resolveRelativePath } from '@vibe-forge/utils'
+import { listManagedPluginInstalls, toManagedPluginConfig } from '@vibe-forge/utils/managed-plugin'
 import {
   flattenPluginInstances,
   mergePluginConfigs,
   resolveConfiguredPluginInstances,
-  resolvePluginHooksEntryPath
+  resolvePluginHooksEntryPathForInstance
 } from '@vibe-forge/utils/plugin-resolver'
 import type { ResolvedPluginInstance } from '@vibe-forge/utils/plugin-resolver'
 import { glob } from 'fast-glob'
@@ -341,6 +342,7 @@ export async function collectWorkspaceAssets(params: {
   configs?: [Config?, Config?]
   plugins?: PluginConfig
   overlaySource?: string
+  includeManagedPlugins?: boolean
   useDefaultVibeForgeMcpServer?: boolean
 }): Promise<{
   assets: WorkspaceAsset[]
@@ -357,7 +359,13 @@ export async function collectWorkspaceAssets(params: {
   specs: Array<Extract<WorkspaceAsset, { kind: 'spec' }>>
 }> {
   const [config, userConfig] = params.configs ?? await loadWorkspaceConfig(params.cwd)
-  const pluginConfigs = params.plugins ?? mergePluginConfigs(config?.plugins, userConfig?.plugins)
+  const managedPluginConfigs = params.includeManagedPlugins === false
+    ? undefined
+    : toManagedPluginConfig(await listManagedPluginInstalls(params.cwd))
+  const pluginConfigs = mergePluginConfigs(
+    params.plugins ?? mergePluginConfigs(config?.plugins, userConfig?.plugins),
+    managedPluginConfigs
+  )
   const pluginInstances = await resolveConfiguredPluginInstances({
     cwd: params.cwd,
     plugins: pluginConfigs,
@@ -493,9 +501,7 @@ export async function collectWorkspaceAssets(params: {
   }
 
   const hookPlugins = flattenedPluginInstances
-    .filter(instance =>
-      instance.packageId != null && resolvePluginHooksEntryPath(params.cwd, instance.packageId) != null
-    )
+    .filter(instance => resolvePluginHooksEntryPathForInstance(params.cwd, instance) != null)
     .map(instance => createHookPluginAsset(instance))
   assets.push(...hookPlugins)
 

package/src/bundle.ts

@@ -7,6 +7,7 @@ export async function resolveWorkspaceAssetBundle(params: {
   configs?: [Config?, Config?]
   plugins?: PluginConfig
   overlaySource?: string
+  includeManagedPlugins?: boolean
   useDefaultVibeForgeMcpServer?: boolean
 }): Promise<WorkspaceAssetBundle> {
   const collected = await collectWorkspaceAssets(params)

package/src/prompt-selection.ts

@@ -11,6 +11,7 @@ import type {
   WorkspaceSkillSelection
 } from '@vibe-forge/types'
 
+import { supportsNativeProjectSkills } from './adapter-capabilities'
 import { resolveWorkspaceAssetBundle } from './bundle'
 import {
   generateEntitiesRoutePrompt,
@@ -35,6 +36,7 @@ export async function resolvePromptAssetSelection(params: {
   bundle: WorkspaceAssetBundle
   type: 'spec' | 'entity' | undefined
   name?: string
+  adapter?: string
   input?: {
     skills?: WorkspaceSkillSelection
   }
@@ -69,7 +71,8 @@ export async function resolvePromptAssetSelection(params: {
       effectiveBundle = await resolveWorkspaceAssetBundle({
         cwd: params.bundle.cwd,
         plugins: resolvePluginOverlay(params.bundle.pluginConfigs, pluginOverlay),
-        overlaySource: `${params.type}:${baseTarget.displayName}`
+        overlaySource: `${params.type}:${baseTarget.displayName}`,
+        includeManagedPlugins: pluginOverlay.mode !== 'override'
       })
     }
 
@@ -82,10 +85,11 @@ export async function resolvePromptAssetSelection(params: {
   }
 
   const selectedSkillAssets = resolveSelectedSkillAssets(effectiveBundle.skills, params.input?.skills)
+  const useNativeProjectSkills = supportsNativeProjectSkills(params.adapter)
   const promptAssetIds = new Set<string>([
     ...effectiveBundle.rules.map(asset => asset.id),
     ...effectiveBundle.specs.map(asset => asset.id),
-    ...selectedSkillAssets.map(asset => asset.id),
+    ...(useNativeProjectSkills ? [] : selectedSkillAssets.map(asset => asset.id)),
     ...(params.type !== 'entity' ? effectiveBundle.entities.map(asset => asset.id) : [])
   ])
   const ruleDefinitions = new Map<string, Definition<Rule>>(
@@ -163,10 +167,12 @@ export async function resolvePromptAssetSelection(params: {
     generateRulesPrompt(effectiveBundle.cwd, rules),
     generateSkillsPrompt(effectiveBundle.cwd, targetSkills),
     generateEntitiesRoutePrompt(entities),
-    generateSkillsRoutePrompt(effectiveBundle.cwd, routedSkills),
+    useNativeProjectSkills ? '' : generateSkillsRoutePrompt(effectiveBundle.cwd, routedSkills),
     generateSpecRoutePrompt(specs, { active: params.type === 'spec' }),
     targetBody
-  ].join('\n\n')
+  ]
+    .filter(section => section !== '')
+    .join('\n\n')
 
   if (targetToolsFilter != null) {
     options.tools = targetToolsFilter

package/src/selection-internal.ts

@@ -219,11 +219,7 @@ export const resolveSelectedMcpNames = (
   const includeRefs = selection?.include ??
     (bundle.defaultIncludeMcpServers.length > 0 ? bundle.defaultIncludeMcpServers : undefined)
   const excludeRefs = selection?.exclude ??
-    (
-      selection?.include == null && bundle.defaultExcludeMcpServers.length > 0
-        ? bundle.defaultExcludeMcpServers
-        : undefined
-    )
+    (bundle.defaultExcludeMcpServers.length > 0 ? bundle.defaultExcludeMcpServers : undefined)
 
   const resolveRefs = (refs: string[] | undefined) => {
     if (refs == null || refs.length === 0) return undefined

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025-present Vibe-Forge.ai
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/__tests__/selection-internal.spec.ts

@@ -1,42 +0,0 @@
-import { describe, expect, it } from 'vitest'
-
-import type { WorkspaceAssetBundle } from '@vibe-forge/types'
-
-import { resolveSelectedMcpNames } from '#~/selection-internal.js'
-
-const createBundle = (): WorkspaceAssetBundle => ({
-  cwd: '/tmp/workspace',
-  pluginConfigs: [],
-  pluginInstances: [],
-  assets: [],
-  rules: [],
-  specs: [],
-  entities: [],
-  skills: [],
-  hookPlugins: [],
-  opencodeOverlayAssets: [],
-  defaultIncludeMcpServers: [],
-  defaultExcludeMcpServers: ['TypeScriptLanguageService'],
-  mcpServers: {
-    TypeScriptLanguageService: {
-      kind: 'mcpServer',
-      id: 'mcp:TypeScriptLanguageService',
-      scope: 'workspace',
-      name: 'TypeScriptLanguageService',
-      displayName: 'TypeScriptLanguageService',
-      source: '/tmp/workspace/.ai.config.json',
-      command: 'node',
-      args: ['tslspmcp']
-    }
-  }
-})
-
-describe('resolveSelectedMcpNames', () => {
-  it('lets an explicit include override default excludes', () => {
-    const selected = resolveSelectedMcpNames(createBundle(), {
-      include: ['TypeScriptLanguageService']
-    })
-
-    expect(selected).toEqual(['TypeScriptLanguageService'])
-  })
-})