@vibe-forge/workspace-assets 2.0.0 → 2.0.2

package/__tests__/bundle.spec.ts

@@ -1,12 +1,18 @@
+/* eslint-disable max-lines -- bundle coverage keeps related fixture scenarios in one file */
 import { join } from 'node:path'
 import process from 'node:process'
 
-import { describe, expect, it } from 'vitest'
+import { readFile } from 'node:fs/promises'
+import { afterEach, describe, expect, it, vi } from 'vitest'
 
-import { resolveWorkspaceAssetBundle } from '#~/index.js'
+import { buildAdapterAssetPlan, resolveWorkspaceAssetBundle } from '#~/index.js'
 
 import { createWorkspace, installPluginPackage, writeDocument } from './test-helpers'
 
+afterEach(() => {
+  vi.unstubAllGlobals()
+})
+
 describe('resolveWorkspaceAssetBundle', () => {
   it('loads npm plugin assets via the package-id fallback and exposes OpenCode overlays', async () => {
     const workspace = await createWorkspace()
@@ -97,6 +103,562 @@ describe('resolveWorkspaceAssetBundle', () => {
     }
   })
 
+  it('loads local and dev rule files as workspace rules', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(
+      join(workspace, '.ai/rules/team.md'),
+      '---\ndescription: 团队规则\n---\n团队共享约束'
+    )
+    await writeDocument(
+      join(workspace, '.ai/rules/preference.local.md'),
+      '---\ndescription: 本地偏好\nalwaysApply: true\n---\n使用当前用户偏好的输出风格'
+    )
+    await writeDocument(
+      join(workspace, '.ai/rules/debug.dev.md'),
+      '---\ndescription: 本地调试\nalwaysApply: true\n---\n优先保留调试证据'
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [undefined, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.rules.map(asset => asset.displayName).sort()).toEqual(['debug.dev', 'preference.local', 'team'])
+    expect(bundle.rules.find(asset => asset.displayName === 'preference.local')?.payload.definition.body)
+      .toContain('当前用户偏好')
+    expect(bundle.rules.find(asset => asset.displayName === 'debug.dev')?.payload.definition.attributes.alwaysApply)
+      .toBe(true)
+  })
+
+  it('bridges supported home skill roots by default and keeps the first duplicate root', async () => {
+    const workspace = await createWorkspace()
+    const realHome = process.env.__VF_PROJECT_REAL_HOME__
+
+    await writeDocument(
+      join(realHome!, '.agents/skills/research/SKILL.md'),
+      '---\ndescription: 来自 agents root\n---\n阅读 README.md'
+    )
+    await writeDocument(
+      join(realHome!, '.claude/skills/research/SKILL.md'),
+      '---\ndescription: 来自 claude root\n---\n这份定义应被后面的 root 覆盖掉'
+    )
+    await writeDocument(
+      join(realHome!, '.config/opencode/skills/release/SKILL.md'),
+      '---\ndescription: 来自 opencode root\n---\n整理发布材料'
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [undefined, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.skills.map(asset => asset.displayName)).toEqual(['research', 'release'])
+    expect(bundle.skills.find(asset => asset.name === 'research')).toEqual(expect.objectContaining({
+      origin: 'workspace',
+      resolvedBy: 'home-bridge',
+      sourcePath: join(realHome!, '.agents/skills/research/SKILL.md')
+    }))
+    expect(bundle.skills.find(asset => asset.name === 'release')).toEqual(expect.objectContaining({
+      origin: 'workspace',
+      resolvedBy: 'home-bridge',
+      sourcePath: join(realHome!, '.config/opencode/skills/release/SKILL.md')
+    }))
+  })
+
+  it('can disable the home skill bridge entirely', 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: [{
+        skills: {
+          homeBridge: {
+            enabled: false
+          }
+        }
+      }, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.skills).toEqual([])
+  })
+
+  it('supports custom home skill roots with tilde expansion', async () => {
+    const workspace = await createWorkspace()
+    const realHome = process.env.__VF_PROJECT_REAL_HOME__
+
+    await writeDocument(
+      join(realHome!, '.agents/skills/ignored/SKILL.md'),
+      '---\ndescription: 默认目录\n---\n这份定义不应被加载'
+    )
+    await writeDocument(
+      join(realHome!, 'custom-skills/writer/SKILL.md'),
+      '---\ndescription: 自定义目录\n---\n产出说明文档'
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [{
+        skills: {
+          homeBridge: {
+            roots: '~/custom-skills'
+          }
+        }
+      }, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.skills.map(asset => asset.displayName)).toEqual(['writer'])
+    expect(bundle.skills[0]?.sourcePath).toBe(join(realHome!, 'custom-skills/writer/SKILL.md'))
+    expect(bundle.skills[0]?.resolvedBy).toBe('home-bridge')
+  })
+
+  it('keeps the first matching skill when multiple homeBridge roots contain the same name', async () => {
+    const workspace = await createWorkspace()
+    const realHome = process.env.__VF_PROJECT_REAL_HOME__
+
+    await writeDocument(
+      join(realHome!, '.claude/skills/research/SKILL.md'),
+      '---\ndescription: 来自 claude root\n---\n优先保留这份定义'
+    )
+    await writeDocument(
+      join(realHome!, '.agents/skills/research/SKILL.md'),
+      '---\ndescription: 来自 agents root\n---\n这份定义应被后面的 root 跳过'
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [{
+        skills: {
+          homeBridge: {
+            roots: ['~/.claude/skills', '~/.agents/skills']
+          }
+        }
+      }, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.skills.map(asset => asset.displayName)).toEqual(['research'])
+    expect(bundle.skills[0]).toEqual(expect.objectContaining({
+      origin: 'workspace',
+      resolvedBy: 'home-bridge',
+      sourcePath: join(realHome!, '.claude/skills/research/SKILL.md')
+    }))
+  })
+
+  it('warns once when a custom homeBridge root uses an unsupported relative path', async () => {
+    const workspace = await createWorkspace()
+    const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => undefined)
+
+    try {
+      const bundle = await resolveWorkspaceAssetBundle({
+        cwd: workspace,
+        configs: [{
+          skills: {
+            homeBridge: {
+              roots: ['./team-skills']
+            }
+          }
+        }, undefined],
+        useDefaultVibeForgeMcpServer: false
+      })
+
+      expect(bundle.skills).toEqual([])
+      expect(warnSpy).toHaveBeenCalledWith(
+        expect.stringContaining('Ignoring invalid skills.homeBridge root "./team-skills"')
+      )
+    } finally {
+      warnSpy.mockRestore()
+    }
+  })
+
+  it('lets project and plugin skills override matching home-bridged skills', async () => {
+    const workspace = await createWorkspace()
+    const realHome = process.env.__VF_PROJECT_REAL_HOME__
+
+    await writeDocument(
+      join(realHome!, '.agents/skills/research/SKILL.md'),
+      '---\ndescription: home research\n---\nhome research body'
+    )
+    await writeDocument(
+      join(realHome!, '.agents/skills/review/SKILL.md'),
+      '---\ndescription: home review\n---\nhome review body'
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/research/SKILL.md'),
+      '---\ndescription: project research\n---\nproject research body'
+    )
+    await installPluginPackage(workspace, '@vibe-forge/plugin-review', {
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-review',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
+      'skills/review/SKILL.md': '---\ndescription: plugin review\n---\nplugin review body'
+    })
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [{
+        plugins: [
+          { id: 'review' }
+        ]
+      }, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.skills.map(asset => asset.displayName).sort()).toEqual(['research', 'review'])
+    expect(bundle.skills.find(asset => asset.name === 'research')).toEqual(expect.objectContaining({
+      sourcePath: join(workspace, '.ai/skills/research/SKILL.md'),
+      resolvedBy: undefined
+    }))
+    expect(bundle.skills.find(asset => asset.name === 'review')).toEqual(expect.objectContaining({
+      origin: 'plugin',
+      sourcePath: expect.stringContaining('/node_modules/@vibe-forge/plugin-review/skills/review/SKILL.md')
+    }))
+  })
+
+  it('keeps scoped project skills alongside unscoped home skills with the same base name', async () => {
+    const workspace = await createWorkspace()
+    const realHome = process.env.__VF_PROJECT_REAL_HOME__
+
+    await writeDocument(
+      join(realHome!, '.agents/skills/research/SKILL.md'),
+      '---\ndescription: home research\n---\nhome research body'
+    )
+    await installPluginPackage(workspace, '@vibe-forge/plugin-team', {
+      'package.json': JSON.stringify(
+        {
+          name: '@vibe-forge/plugin-team',
+          version: '1.0.0'
+        },
+        null,
+        2
+      ),
+      'skills/research/SKILL.md': '---\ndescription: scoped research\n---\nscoped research body'
+    })
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [{
+        plugins: [
+          { id: 'team', scope: 'team' }
+        ]
+      }, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.skills.map(asset => asset.displayName).sort()).toEqual(['research', 'team/research'])
+    expect(bundle.skills.find(asset => asset.displayName === 'research')).toEqual(expect.objectContaining({
+      resolvedBy: 'home-bridge'
+    }))
+    expect(bundle.skills.find(asset => asset.displayName === 'team/research')).toEqual(expect.objectContaining({
+      origin: 'plugin'
+    }))
+  })
+
+  it('installs selected missing skill dependencies from an API-compatible registry cache', 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=frontend-design&limit=10') {
+        return new Response(JSON.stringify({
+          skills: [{
+            id: 'anthropics/skills/frontend-design',
+            skillId: 'frontend-design',
+            name: 'frontend-design',
+            source: 'anthropics/skills'
+          }]
+        }))
+      }
+      if (url === 'https://registry.example.test/api/download/anthropics/skills/frontend-design') {
+        return new Response(JSON.stringify({
+          files: [{
+            path: 'SKILL.md',
+            contents: '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse strong visual hierarchy.\n'
+          }]
+        }))
+      }
+      return new Response('not found', { status: 404 })
+    })
+    vi.stubGlobal('fetch', fetchMock)
+
+    await writeDocument(
+      join(realHome!, '.agents/skills/frontend-design/SKILL.md'),
+      '---\ndescription: home frontend design\n---\nUse the home definition.'
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/app-builder/SKILL.md'),
+      [
+        '---',
+        'name: app-builder',
+        'description: Build apps',
+        'dependencies:',
+        '  - anthropics/skills@frontend-design',
+        '---',
+        'Build the app.'
+      ].join('\n')
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [{
+        skills: {
+          registry: 'https://registry.example.test'
+        }
+      }, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.skills.map(asset => asset.name).sort()).toEqual(['app-builder', 'frontend-design'])
+    expect(bundle.skills.find(asset => asset.name === 'frontend-design')).toEqual(expect.objectContaining({
+      resolvedBy: 'home-bridge',
+      sourcePath: join(realHome!, '.agents/skills/frontend-design/SKILL.md')
+    }))
+    expect(fetchMock).not.toHaveBeenCalled()
+
+    await buildAdapterAssetPlan({
+      adapter: 'opencode',
+      bundle,
+      options: {
+        skills: {
+          include: ['app-builder']
+        }
+      }
+    })
+
+    const dependency = bundle.skills.find(asset => asset.name === 'frontend-design')
+    expect(bundle.skills.map(asset => asset.name).sort()).toEqual(['app-builder', 'frontend-design'])
+    expect(dependency?.sourcePath).toContain('/.ai/caches/skill-dependencies/registry.example.test/')
+    expect(bundle.skills.find(asset => (
+      asset.name === 'frontend-design' && asset.resolvedBy === 'home-bridge'
+    ))).toBeUndefined()
+    expect(fetchMock).toHaveBeenCalledWith(
+      'https://registry.example.test/api/download/anthropics/skills/frontend-design',
+      expect.any(Object)
+    )
+  })
+
+  it('installs skill dependencies into the primary workspace shared cache', async () => {
+    const primary = await createWorkspace()
+    const worktree = await createWorkspace()
+    const previousPrimaryWorkspace = process.env.__VF_PROJECT_PRIMARY_WORKSPACE_FOLDER__
+    const fetchMock = vi.fn(async (url: string) => {
+      if (url === 'https://registry.example.test/api/search?q=frontend-design&limit=10') {
+        return new Response(JSON.stringify({
+          skills: [{
+            id: 'anthropics/skills/frontend-design',
+            skillId: 'frontend-design',
+            name: 'frontend-design',
+            source: 'anthropics/skills'
+          }]
+        }))
+      }
+      if (url === 'https://registry.example.test/api/download/anthropics/skills/frontend-design') {
+        return new Response(JSON.stringify({
+          files: [{
+            path: 'SKILL.md',
+            contents: '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse primary cache.\n'
+          }]
+        }))
+      }
+      return new Response('not found', { status: 404 })
+    })
+    vi.stubGlobal('fetch', fetchMock)
+
+    try {
+      process.env.__VF_PROJECT_PRIMARY_WORKSPACE_FOLDER__ = primary
+      await writeDocument(
+        join(worktree, '.ai/skills/app-builder/SKILL.md'),
+        [
+          '---',
+          'name: app-builder',
+          'description: Build apps',
+          'dependencies:',
+          '  - frontend-design',
+          '---',
+          'Build the app.'
+        ].join('\n')
+      )
+
+      const bundle = await resolveWorkspaceAssetBundle({
+        cwd: worktree,
+        configs: [{
+          skills: {
+            registry: 'https://registry.example.test'
+          }
+        }, undefined],
+        useDefaultVibeForgeMcpServer: false
+      })
+
+      await buildAdapterAssetPlan({
+        adapter: 'opencode',
+        bundle,
+        options: {
+          skills: {
+            include: ['app-builder']
+          }
+        }
+      })
+
+      const dependency = bundle.skills.find(asset => asset.name === 'frontend-design')
+      expect(dependency?.sourcePath).toContain(join(
+        primary,
+        '.ai/caches/skill-dependencies/registry.example.test/'
+      ))
+      expect(dependency?.sourcePath).not.toContain(join(worktree, '.ai/caches'))
+    } finally {
+      if (previousPrimaryWorkspace == null) {
+        delete process.env.__VF_PROJECT_PRIMARY_WORKSPACE_FOLDER__
+      } else {
+        process.env.__VF_PROJECT_PRIMARY_WORKSPACE_FOLDER__ = previousPrimaryWorkspace
+      }
+    }
+  })
+
+  it('reuses complete skill dependency caches without deleting or downloading them again', async () => {
+    const workspace = await createWorkspace()
+    const fetchMock = vi.fn(async () => new Response('not found', { status: 404 }))
+    vi.stubGlobal('fetch', fetchMock)
+
+    const cachedSkillPath = join(
+      workspace,
+      '.ai/caches/skill-dependencies/registry.example.test/anthropics/skills/frontend-design/SKILL.md'
+    )
+    await writeDocument(
+      cachedSkillPath,
+      '---\nname: frontend-design\ndescription: Cached UI guidance\n---\nUse the cached copy.\n'
+    )
+    await writeDocument(
+      join(workspace, '.ai/skills/app-builder/SKILL.md'),
+      [
+        '---',
+        'name: app-builder',
+        'description: Build apps',
+        'dependencies:',
+        '  - anthropics/skills@frontend-design',
+        '---',
+        'Build the app.'
+      ].join('\n')
+    )
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [{
+        skills: {
+          registry: 'https://registry.example.test'
+        }
+      }, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    await buildAdapterAssetPlan({
+      adapter: 'opencode',
+      bundle,
+      options: {
+        skills: {
+          include: ['app-builder']
+        }
+      }
+    })
+
+    expect(fetchMock).not.toHaveBeenCalled()
+    expect(await readFile(cachedSkillPath, 'utf8')).toContain('Use the cached copy.')
+    expect(bundle.skills.map(asset => asset.name).sort()).toEqual(['app-builder', 'frontend-design'])
+  })
+
+  it('keeps configured registry url search and download endpoints together when env overrides exist', async () => {
+    const workspace = await createWorkspace()
+    const previousDownloadUrl = process.env.SKILLS_DOWNLOAD_URL
+    const fetchMock = vi.fn(async (url: string) => {
+      if (url === 'https://private-registry.example.test/api/search?q=frontend-design&limit=10') {
+        return new Response(JSON.stringify({
+          skills: [{
+            id: 'anthropics/skills/frontend-design',
+            skillId: 'frontend-design',
+            name: 'frontend-design',
+            source: 'anthropics/skills'
+          }]
+        }))
+      }
+      if (url === 'https://private-registry.example.test/api/download/anthropics/skills/frontend-design') {
+        return new Response(JSON.stringify({
+          files: [{
+            path: 'SKILL.md',
+            contents: '---\nname: frontend-design\ndescription: UI design guidance\n---\nUse strong visual hierarchy.\n'
+          }]
+        }))
+      }
+      return new Response('not found', { status: 404 })
+    })
+    vi.stubGlobal('fetch', fetchMock)
+
+    try {
+      process.env.SKILLS_DOWNLOAD_URL = 'https://env-download.example.test'
+      await writeDocument(
+        join(workspace, '.ai/skills/app-builder/SKILL.md'),
+        [
+          '---',
+          'name: app-builder',
+          'description: Build apps',
+          'dependencies:',
+          '  - frontend-design',
+          '---',
+          'Build the app.'
+        ].join('\n')
+      )
+
+      const bundle = await resolveWorkspaceAssetBundle({
+        cwd: workspace,
+        configs: [{
+          skills: {
+            registry: {
+              url: 'https://private-registry.example.test'
+            }
+          }
+        }, undefined],
+        useDefaultVibeForgeMcpServer: false
+      })
+
+      await buildAdapterAssetPlan({
+        adapter: 'opencode',
+        bundle,
+        options: {
+          skills: {
+            include: ['app-builder']
+          }
+        }
+      })
+
+      expect(fetchMock).toHaveBeenCalledWith(
+        'https://private-registry.example.test/api/download/anthropics/skills/frontend-design',
+        expect.any(Object)
+      )
+      expect(fetchMock).not.toHaveBeenCalledWith(
+        'https://env-download.example.test/api/download/anthropics/skills/frontend-design',
+        expect.any(Object)
+      )
+    } finally {
+      if (previousDownloadUrl == null) {
+        delete process.env.SKILLS_DOWNLOAD_URL
+      } else {
+        process.env.SKILLS_DOWNLOAD_URL = previousDownloadUrl
+      }
+    }
+  })
+
   it('loads workspace entities from the env-configured entities dir', async () => {
     const workspace = await createWorkspace()
     const previousEntitiesDir = process.env.__VF_PROJECT_AI_ENTITIES_DIR__
@@ -201,6 +763,44 @@ describe('resolveWorkspaceAssetBundle', () => {
     expect(disabledBundle.mcpServers).not.toHaveProperty('VibeForge')
   })
 
+  it('discovers configured workspaces from glob patterns and entries', async () => {
+    const workspace = await createWorkspace()
+
+    await writeDocument(join(workspace, 'services/billing/README.md'), '# billing\n')
+    await writeDocument(join(workspace, 'services/legacy/README.md'), '# legacy\n')
+    await writeDocument(join(workspace, 'docs/README.md'), '# docs\n')
+
+    const bundle = await resolveWorkspaceAssetBundle({
+      cwd: workspace,
+      configs: [{
+        workspaces: {
+          include: ['services/*'],
+          exclude: ['services/legacy'],
+          entries: {
+            docs: {
+              path: 'docs',
+              description: 'Documentation workspace'
+            }
+          }
+        }
+      }, undefined],
+      useDefaultVibeForgeMcpServer: false
+    })
+
+    expect(bundle.workspaces.map(asset => asset.displayName)).toEqual(['billing', 'docs'])
+    expect(bundle.workspaces.map(asset => asset.payload)).toEqual([
+      expect.objectContaining({
+        id: 'billing',
+        path: 'services/billing'
+      }),
+      expect.objectContaining({
+        id: 'docs',
+        path: 'docs',
+        description: 'Documentation workspace'
+      })
+    ])
+  })
+
   it('skips disabled plugin instances and lets disabled child overrides suppress default child activation', async () => {
     const workspace = await createWorkspace()
 

package/__tests__/prompt-builders.spec.ts

@@ -9,6 +9,7 @@ import {
   generateSkillsRoutePrompt,
   generateSpecRoutePrompt
 } from '#~/prompt-builders.js'
+import { generateWorkspaceRoutePrompt } from '#~/workspace-prompt.js'
 
 describe('workspace asset prompt builders', () => {
   it('builds skill prompts with stable names, descriptions, and relative paths', () => {
@@ -175,12 +176,50 @@ describe('workspace asset prompt builders', () => {
     expect(prompt).toContain('reviewer: 负责代码审查')
     expect(prompt).toContain('`VibeForge.StartTasks`')
     expect(prompt).toContain('`VibeForge.GetTaskInfo`')
+    expect(prompt).toContain('Task tool guide:')
+    expect(prompt).toContain('After starting a task')
+    expect(prompt).toContain('10 most recent log entries')
+    expect(prompt).toContain('`logLimit`')
+    expect(prompt).toContain('`logOrder`')
+    expect(prompt).toContain('`VibeForge.SendTaskMessage`')
+    expect(prompt).toContain('`{ taskId, message, mode }`')
+    expect(prompt).toContain('Choose `mode: "direct"`')
+    expect(prompt).toContain('Choose `mode: "steer"`')
+    expect(prompt).toContain('`VibeForge.SubmitTaskInput`')
+    expect(prompt).toContain('Do not use it for ordinary follow-up instructions or queued steer turns')
+    expect(prompt).toContain('If a task is `completed` or `failed`')
     expect(prompt).toContain('`wait`')
     expect(prompt).not.toContain('run-tasks')
     expect(prompt).not.toContain('需要关注变更风险')
     expect(prompt).not.toContain('hidden')
   })
 
+  it('builds workspace routes with managed task guidance', () => {
+    const cwd = '/tmp/project'
+
+    const prompt = generateWorkspaceRoutePrompt(cwd, [
+      {
+        id: 'billing',
+        cwd: join(cwd, 'packages/billing'),
+        path: join(cwd, '.ai/workspaces/billing.md'),
+        description: 'Billing workspace'
+      }
+    ])
+
+    expect(prompt).toContain('The project includes the following registered workspaces')
+    expect(prompt).toContain('Identifier: billing')
+    expect(prompt).toContain('`VibeForge.StartTasks`')
+    expect(prompt).toContain('type: "workspace"')
+    expect(prompt).toContain('Task tool guide:')
+    expect(prompt).toContain('`VibeForge.GetTaskInfo`')
+    expect(prompt).toContain('`VibeForge.ListTasks`')
+    expect(prompt).toContain('`VibeForge.SendTaskMessage`')
+    expect(prompt).toContain('`VibeForge.SubmitTaskInput`')
+    expect(prompt).toContain('Choose `mode: "direct"`')
+    expect(prompt).toContain('Choose `mode: "steer"`')
+    expect(prompt).toContain('Do not directly edit files inside a registered workspace')
+  })
+
   it('builds skill route prompts without preloading content', () => {
     const cwd = '/tmp/project'