@vibe-forge/workspace-assets 0.9.0 → 0.9.1-alpha.0

package/__tests__/snapshot.ts

@@ -16,16 +16,25 @@ import type {
 } from '@vibe-forge/types'
 import { resolveDocumentName, resolveSpecIdentifier } from '@vibe-forge/utils'
 
+import { isOpenCodeOverlayAsset } from '#~/internal-types.js'
+
 const sortStrings = (values: string[]) => [...values].sort((left, right) => left.localeCompare(right))
 
+const isConfigNativePluginAsset = (
+  asset: Extract<WorkspaceAsset, { kind: 'nativePlugin' }>
+): asset is Extract<WorkspaceAsset, { kind: 'nativePlugin' }> & {
+  payload: {
+    name: string
+    enabled: boolean
+  }
+} => !isOpenCodeOverlayAsset(asset)
+
 const sanitizeValue = (
   value: string,
   cwd: string
 ) => (
   value
-    .replaceAll(`/private${cwd}`, '<workspace>')
     .replaceAll(cwd, '<workspace>')
-    .replaceAll(`/private${process.execPath}`, '<node-path>')
     .replaceAll(process.execPath, '<node-path>')
 )
 
@@ -90,73 +99,104 @@ const summarizeDefinition = (
   body: definition.body.trim()
 })
 
-const buildSnapshotAssetId = (
-  asset: WorkspaceAsset,
+const summarizeDocumentAsset = (
+  asset: Extract<WorkspaceAsset, { kind: 'rule' | 'spec' | 'entity' | 'skill' }>,
   cwd: string
-) => (
-  `${asset.kind}:${asset.origin}:${asset.instancePath ?? 'workspace'}:${asset.displayName}:${sanitizeValue(asset.sourcePath, cwd)}`
-)
-
-const summarizeBaseAsset = (
-  asset: WorkspaceAsset,
-  cwd: string,
-  assetIdMap?: Map<string, string>
 ) => ({
-  id: assetIdMap?.get(asset.id) ?? buildSnapshotAssetId(asset, cwd),
+  id: asset.id,
   kind: asset.kind,
-  name: asset.name,
-  displayName: asset.displayName,
   origin: asset.origin,
   scope: asset.scope,
-  sourcePath: sanitizeValue(asset.sourcePath, cwd),
-  instancePath: asset.instancePath,
-  packageId: asset.packageId,
-  resolvedBy: asset.resolvedBy,
-  taskOverlaySource: asset.taskOverlaySource
-})
-
-const summarizeDocumentAsset = (
-  asset: Extract<WorkspaceAsset, { kind: 'rule' | 'spec' | 'entity' | 'skill' }>,
-  cwd: string,
-  assetIdMap?: Map<string, string>
-) => ({
-  ...summarizeBaseAsset(asset, cwd, assetIdMap),
+  pluginId: asset.pluginId,
+  enabled: asset.enabled,
+  targets: sortStrings(asset.targets),
   definition: summarizeDefinition(asset.kind, asset.payload.definition, cwd)
 })
 
 const summarizeMcpServer = (
   asset: Extract<WorkspaceAsset, { kind: 'mcpServer' }>,
-  cwd: string,
-  assetIdMap?: Map<string, string>
+  cwd: string
 ) => ({
-  ...summarizeBaseAsset(asset, cwd, assetIdMap),
+  id: asset.id,
+  origin: asset.origin,
+  scope: asset.scope,
+  pluginId: asset.pluginId,
+  enabled: asset.enabled,
+  targets: sortStrings(asset.targets),
+  name: asset.payload.name,
   config: normalizeValue(asset.payload.config, cwd)
 })
 
 const summarizeHookPlugin = (
   asset: Extract<WorkspaceAsset, { kind: 'hookPlugin' }>,
-  cwd: string,
-  assetIdMap?: Map<string, string>
+  cwd: string
 ) => ({
-  ...summarizeBaseAsset(asset, cwd, assetIdMap),
+  id: asset.id,
+  origin: asset.origin,
+  scope: asset.scope,
+  pluginId: asset.pluginId,
+  enabled: asset.enabled,
+  targets: sortStrings(asset.targets),
   packageName: asset.payload.packageName,
   config: normalizeValue(asset.payload.config, cwd)
 })
 
-const summarizeOpenCodeOverlayAsset = (
-  asset: Extract<WorkspaceAsset, { kind: 'agent' | 'command' | 'mode' | 'nativePlugin' }>,
-  cwd: string,
-  assetIdMap?: Map<string, string>
-) => ({
-  ...summarizeBaseAsset(asset, cwd, assetIdMap),
-  entryName: asset.payload.entryName,
-  targetSubpath: asset.payload.targetSubpath
-})
+const summarizeNativePlugin = (
+  asset: Extract<WorkspaceAsset, { kind: 'nativePlugin' }>,
+  cwd: string
+) => {
+  if (isOpenCodeOverlayAsset(asset)) {
+    return {
+      id: asset.id,
+      kind: asset.kind,
+      origin: asset.origin,
+      scope: asset.scope,
+      pluginId: asset.pluginId,
+      enabled: asset.enabled,
+      targets: sortStrings(asset.targets),
+      entryName: asset.payload.entryName,
+      sourcePath: sanitizeValue(asset.payload.sourcePath, cwd),
+      targetSubpath: asset.payload.targetSubpath
+    }
+  }
 
-const summarizeDiagnostics = (
-  diagnostics: AssetDiagnostic[],
-  assetIdMap: Map<string, string>
-) => (
+  return {
+    id: asset.id,
+    kind: asset.kind,
+    origin: asset.origin,
+    scope: asset.scope,
+    pluginId: asset.pluginId,
+    enabled: asset.enabled,
+    targets: sortStrings(asset.targets),
+    name: isConfigNativePluginAsset(asset) ? asset.payload.name : undefined
+  }
+}
+
+const summarizeOverlayAsset = (
+  asset:
+    | Extract<WorkspaceAsset, { kind: 'agent' | 'command' | 'mode' }>
+    | Extract<WorkspaceAsset, { kind: 'nativePlugin' }>,
+  cwd: string
+) => {
+  if (!isOpenCodeOverlayAsset(asset)) {
+    return summarizeNativePlugin(asset, cwd)
+  }
+
+  return {
+    id: asset.id,
+    kind: asset.kind,
+    origin: asset.origin,
+    scope: asset.scope,
+    pluginId: asset.pluginId,
+    enabled: asset.enabled,
+    targets: sortStrings(asset.targets),
+    entryName: asset.payload.entryName,
+    sourcePath: sanitizeValue(asset.payload.sourcePath, cwd),
+    targetSubpath: asset.payload.targetSubpath
+  }
+}
+
+const summarizeDiagnostics = (diagnostics: AssetDiagnostic[]) => (
   [...diagnostics]
     .sort((left, right) => {
       const assetIdDiff = left.assetId.localeCompare(right.assetId)
@@ -164,31 +204,29 @@ const summarizeDiagnostics = (
       return left.status.localeCompare(right.status)
     })
     .map(diagnostic => ({
-      assetId: assetIdMap.get(diagnostic.assetId) ?? diagnostic.assetId,
+      assetId: diagnostic.assetId,
       adapter: diagnostic.adapter,
       status: diagnostic.status,
-      reason: diagnostic.reason,
-      scope: diagnostic.scope,
-      packageId: diagnostic.packageId
+      reason: diagnostic.reason
     }))
 )
 
 const summarizePlan = (
   plan: AdapterAssetPlan,
-  cwd: string,
-  assetIdMap: Map<string, string>
+  cwd: string
 ) => ({
   adapter: plan.adapter,
   mcpServers: normalizeValue(plan.mcpServers, cwd),
   overlays: [...plan.overlays]
     .sort((left, right) => left.assetId.localeCompare(right.assetId))
     .map(entry => ({
-      assetId: assetIdMap.get(entry.assetId) ?? entry.assetId,
+      assetId: entry.assetId,
       kind: entry.kind,
       sourcePath: sanitizeValue(entry.sourcePath, cwd),
       targetPath: entry.targetPath
     })),
-  diagnostics: summarizeDiagnostics(plan.diagnostics, assetIdMap)
+  native: normalizeValue(plan.native, cwd),
+  diagnostics: summarizeDiagnostics(plan.diagnostics)
 })
 
 const summarizeSelection = (
@@ -199,8 +237,7 @@ const summarizeSelection = (
     mcpServers?: Filter
     promptAssetIds?: string[]
   },
-  cwd: string,
-  assetIdMap: Map<string, string>
+  cwd: string
 ) => ({
   resolution: {
     rules: resolution.rules.map(rule => summarizeDefinition('rule', rule, cwd)),
@@ -209,15 +246,13 @@ const summarizeSelection = (
     skills: resolution.skills.map(skill => summarizeDefinition('skill', skill, cwd)),
     specs: resolution.specs.map(spec => summarizeDefinition('spec', spec, cwd)),
     targetBody: resolution.targetBody.trim(),
-    promptAssetIds: sortStrings(resolution.promptAssetIds.map(assetId => assetIdMap.get(assetId) ?? assetId))
+    promptAssetIds: sortStrings(resolution.promptAssetIds)
   },
   options: {
     systemPrompt: options.systemPrompt?.trim(),
     tools: sortFilter(options.tools),
     mcpServers: sortFilter(options.mcpServers),
-    promptAssetIds: options.promptAssetIds == null
-      ? undefined
-      : sortStrings(options.promptAssetIds.map(assetId => assetIdMap.get(assetId) ?? assetId))
+    promptAssetIds: options.promptAssetIds == null ? undefined : sortStrings(options.promptAssetIds)
   }
 })
 
@@ -236,39 +271,56 @@ export const serializeWorkspaceAssetsSnapshot = (params: {
   plans: AdapterAssetPlan[]
 }) => {
   const { bundle, cwd } = params
-  const assetIdMap = new Map(bundle.assets.map(asset => [asset.id, buildSnapshotAssetId(asset, cwd)]))
+  const overlayAssets = bundle.assets.filter((
+    asset
+  ): asset is
+    | Extract<WorkspaceAsset, { kind: 'agent' | 'command' | 'mode' }>
+    | Extract<WorkspaceAsset, { kind: 'nativePlugin' }> => (
+      asset.kind === 'agent' ||
+      asset.kind === 'command' ||
+      asset.kind === 'mode' ||
+      (asset.kind === 'nativePlugin' && isOpenCodeOverlayAsset(asset))
+    )
+  )
+  const claudeNativePlugins = bundle.assets.filter((
+    asset
+  ): asset is Extract<WorkspaceAsset, { kind: 'nativePlugin' }> => (
+    asset.kind === 'nativePlugin' && !isOpenCodeOverlayAsset(asset)
+  ))
 
   const snapshot = {
     bundle: {
       cwd: '<workspace>',
-      pluginConfigs: normalizeValue(bundle.pluginConfigs, cwd),
-      pluginInstances: normalizeValue(bundle.pluginInstances, cwd),
+      enabledPlugins: normalizeValue(bundle.enabledPlugins, cwd),
+      extraKnownMarketplaces: normalizeValue(bundle.extraKnownMarketplaces, cwd),
       defaultIncludeMcpServers: sortStrings(bundle.defaultIncludeMcpServers),
       defaultExcludeMcpServers: sortStrings(bundle.defaultExcludeMcpServers),
-      rules: bundle.rules.map(rule => summarizeDocumentAsset(rule, cwd, assetIdMap)),
-      specs: bundle.specs.map(spec => summarizeDocumentAsset(spec, cwd, assetIdMap)),
-      entities: bundle.entities.map(entity => summarizeDocumentAsset(entity, cwd, assetIdMap)),
-      skills: bundle.skills.map(skill => summarizeDocumentAsset(skill, cwd, assetIdMap)),
+      rules: bundle.rules.map(rule => summarizeDocumentAsset(rule, cwd)),
+      specs: bundle.specs.map(spec => summarizeDocumentAsset(spec, cwd)),
+      entities: bundle.entities.map(entity => summarizeDocumentAsset(entity, cwd)),
+      skills: bundle.skills.map(skill => summarizeDocumentAsset(skill, cwd)),
       mcpServers: Object.values(bundle.mcpServers)
         .sort((left, right) => left.payload.name.localeCompare(right.payload.name))
-        .map(server => summarizeMcpServer(server, cwd, assetIdMap)),
+        .map(server => summarizeMcpServer(server, cwd)),
       hookPlugins: bundle.hookPlugins
         .sort((left, right) => left.id.localeCompare(right.id))
-        .map(plugin => summarizeHookPlugin(plugin, cwd, assetIdMap)),
-      opencodeOverlayAssets: bundle.opencodeOverlayAssets
+        .map(plugin => summarizeHookPlugin(plugin, cwd)),
+      claudeNativePlugins: claudeNativePlugins
+        .sort((left, right) => left.id.localeCompare(right.id))
+        .map(asset => summarizeNativePlugin(asset, cwd)),
+      opencodeOverlayAssets: overlayAssets
         .sort((left, right) => left.id.localeCompare(right.id))
-        .map(asset => summarizeOpenCodeOverlayAsset(asset, cwd, assetIdMap))
+        .map(asset => summarizeOverlayAsset(asset, cwd))
     },
     selection: summarizeSelection(
       params.selection.resolution,
       params.selection.options,
-      cwd,
-      assetIdMap
+      cwd
     ),
     plans: Object.fromEntries(
       [...params.plans]
         .sort((left, right) => left.adapter.localeCompare(right.adapter))
-        .map(plan => [plan.adapter, summarizePlan(plan, cwd, assetIdMap)])
+        .map(plan => [plan.adapter, summarizePlan(plan, cwd)])
     )
   }
 

package/__tests__/test-helpers.ts

@@ -17,17 +17,6 @@ export const writeDocument = async (filePath: string, content: string) => {
   await writeFile(filePath, content)
 }
 
-export const installPluginPackage = async (
-  workspace: string,
-  packageName: string,
-  files: Record<string, string>
-) => {
-  const packageDir = join(workspace, 'node_modules', ...packageName.split('/'))
-  await Promise.all(Object.entries(files).map(async ([relativePath, content]) => {
-    await writeDocument(join(packageDir, relativePath), content)
-  }))
-}
-
 afterEach(async () => {
   await Promise.all(tempDirs.splice(0).map(dir => rm(dir, { recursive: true, force: true })))
 })

package/__tests__/workspace-assets.snapshot.spec.ts

@@ -8,7 +8,7 @@ import type { Config } from '@vibe-forge/types'
 import { buildAdapterAssetPlan, resolvePromptAssetSelection, resolveWorkspaceAssetBundle } from '#~/index.js'
 
 import { serializeWorkspaceAssetsSnapshot } from './snapshot'
-import { createWorkspace, installPluginPackage, writeDocument } from './test-helpers'
+import { createWorkspace, writeDocument } from './test-helpers'
 
 const resolveSnapshotPath = (name: string) => (
   fileURLToPath(new URL(`./__snapshots__/${name}.snapshot.json`, import.meta.url))
@@ -19,33 +19,43 @@ describe('workspace assets snapshots', () => {
     const workspace = await createWorkspace()
 
     const projectConfig: Config = {
-      plugins: [
-        {
-          id: 'logger'
-        },
-        {
-          id: 'demo',
-          scope: 'demo'
+      plugins: {
+        logger: {
+          level: 'info'
         }
-      ],
+      },
+      enabledPlugins: {
+        logger: true,
+        demo: true,
+        legacy: false,
+        telemetry: true
+      },
       mcpServers: {
         docs: {
           command: 'npx',
           args: ['docs-server']
         }
       },
-      defaultIncludeMcpServers: ['docs', 'demo/browser']
+      defaultIncludeMcpServers: ['docs', 'browser'],
+      extraKnownMarketplaces: {
+        internal: {
+          source: {
+            source: 'git',
+            url: 'https://plugins.internal.example.com'
+          }
+        }
+      }
     }
 
     const userConfig: Config = {
-      plugins: [
-        {
-          id: 'telemetry',
-          options: {
-            mode: 'summary'
-          }
+      plugins: {
+        telemetry: {
+          mode: 'summary'
         }
-      ],
+      },
+      enabledPlugins: {
+        telemetry: true
+      },
       mcpServers: {
         notes: {
           command: 'node',
@@ -55,59 +65,6 @@ describe('workspace assets snapshots', () => {
       defaultExcludeMcpServers: ['notes']
     }
 
-    await installPluginPackage(workspace, '@vibe-forge/plugin-demo', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-demo',
-        version: '1.0.0'
-      }, null, 2),
-      'hooks.js': 'module.exports = {}\n',
-      'rules/security.md': [
-        '---',
-        'description: 插件安全规则',
-        '---',
-        '上线前要检查权限与密钥暴露。'
-      ].join('\n'),
-      'specs/release/index.md': [
-        '---',
-        'description: 插件发布流程',
-        '---',
-        '插件 release 不应直接替代项目 release。'
-      ].join('\n'),
-      'skills/audit/SKILL.md': [
-        '---',
-        'description: 审计输出',
-        '---',
-        '检查最终输出是否覆盖风险项。'
-      ].join('\n'),
-      'mcp/browser.json': JSON.stringify(
-        {
-          name: 'browser',
-          command: 'npx',
-          args: ['browser-mcp']
-        },
-        null,
-        2
-      ),
-      'opencode/agents/release-helper.md': '# release-helper\n',
-      'opencode/commands/review.md': '# review\n',
-      'opencode/modes/strict.md': '# strict\n',
-      'opencode/plugins/demo-plugin.js': 'export default {}\n'
-    })
-    await installPluginPackage(workspace, '@vibe-forge/plugin-logger', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-logger',
-        version: '1.0.0'
-      }, null, 2),
-      'hooks.js': 'module.exports = {}\n'
-    })
-    await installPluginPackage(workspace, '@vibe-forge/plugin-telemetry', {
-      'package.json': JSON.stringify({
-        name: '@vibe-forge/plugin-telemetry',
-        version: '1.0.0'
-      }, null, 2),
-      'hooks.js': 'module.exports = {}\n'
-    })
-
     await writeDocument(
       join(workspace, '.ai/rules/review.md'),
       [
@@ -118,6 +75,25 @@ describe('workspace assets snapshots', () => {
         '必须检查发布改动的回归风险。'
       ].join('\n')
     )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/rules/review.md'),
+      [
+        '---',
+        'description: 插件评审规则',
+        'always: true',
+        '---',
+        '这是插件内的 review 规则，不应覆盖项目规则。'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/rules/security.md'),
+      [
+        '---',
+        'description: 插件安全规则',
+        '---',
+        '上线前要检查权限与密钥暴露。'
+      ].join('\n')
+    )
     await writeDocument(
       join(workspace, '.ai/specs/release/index.md'),
       [
@@ -130,9 +106,9 @@ describe('workspace assets snapshots', () => {
         'mcpServers:',
         '  include:',
         '    - docs',
-        '    - demo/browser',
+        '    - browser',
         '  exclude:',
-        '    - demo/browser',
+        '    - browser',
         'tools:',
         '  include:',
         '    - Read',
@@ -141,6 +117,15 @@ describe('workspace assets snapshots', () => {
         '执行正式发布，并整理变更摘要。'
       ].join('\n')
     )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/specs/release/index.md'),
+      [
+        '---',
+        'description: 插件发布流程',
+        '---',
+        '插件 release 不应覆盖项目 release。'
+      ].join('\n')
+    )
     await writeDocument(
       join(workspace, '.ai/entities/architect/README.md'),
       [
@@ -159,6 +144,52 @@ describe('workspace assets snapshots', () => {
         '先阅读 README.md，再补充结论。'
       ].join('\n')
     )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/skills/research/SKILL.md'),
+      [
+        '---',
+        'description: 插件 research',
+        '---',
+        '插件 research 不应覆盖项目 skill。'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/skills/audit/SKILL.md'),
+      [
+        '---',
+        'description: 审计输出',
+        '---',
+        '检查最终输出是否覆盖风险项。'
+      ].join('\n')
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/mcp/browser.json'),
+      JSON.stringify(
+        {
+          name: 'browser',
+          command: 'npx',
+          args: ['browser-mcp']
+        },
+        null,
+        2
+      )
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/opencode/plugins/demo-plugin.js'),
+      'export default {};\n'
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/opencode/agents/release-helper.md'),
+      '# release-helper\n'
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/opencode/commands/review.md'),
+      '# review\n'
+    )
+    await writeDocument(
+      join(workspace, '.ai/plugins/demo/opencode/modes/strict.md'),
+      '# strict\n'
+    )
 
     const bundle = await resolveWorkspaceAssetBundle({
       cwd: workspace,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-forge/workspace-assets",
-  "version": "0.9.0",
+  "version": "0.9.1-alpha.0",
   "description": "Workspace asset resolution and adapter asset planning for Vibe Forge",
   "imports": {
     "#~/*.js": {
@@ -25,18 +25,18 @@
     },
     "./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-loader": "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/types": "^0.9.0",
-    "@vibe-forge/utils": "^0.9.0",
-    "@vibe-forge/config": "^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__"
   }
-}
+}