fix: eliminate Grok workspace plugin collision

Author: rockyshi1993

README.md

@@ -206,7 +206,7 @@ AGENTS.md                 ← 由 instructions.md 确定性生成的共享精简
 
 `init/update` 还会在当前 active runtime root 写入 `managed/deployment-manifest.json`。命令先预览 `add/update/unchanged/stale/unowned`：`stale` 只报警，不会自动删除；`unowned` 表示目标受管子树中从未进入 manifest 的文件（例如用户自有 `.codex/config.toml`），不会被接管。workspace-namespace 下 manifest 写入 `.devcodex/<project-or-workspace>/managed/`，不会另建平行运行态根。
 
-workspace-namespace 的共享真相与宿主 adapter 都由工作区拥有。Grok 使用工作区 `.grok/plugins/devcodex-workspace` 薄插件：工作区根由 Grok 原生发现，CLI 再以 Grok 官方本地插件命令登记该 workspace source owner，确保子 Git 项目 cwd 同样可发现 resolver Skill、Hook 与 MCP；用户级 `~/.grok/config.toml` 只精确维护受管 `plugins.enabled` 项，旧的受管 `plugins.paths` 项会被移除以避免同名插件碰撞。从子项目执行 `update --host grok` 时实际 owner/manifest 仍是工作区根，子项目不会生成 `AGENTS.md`、`.grok/`、`.codex/`、`.claude/` 或 `.gemini/`。由于 Grok passive Hook stdout 不进入提示上下文，子 Git 项目的完整 kernel 保证通过 `devcodex grok` 调用官方 `--rules` 提供；plain `grok` 只承诺插件发现与 best-effort resolver Skill。项目本地 adapter 仅用于显式 `--project-portable` 模式。
+workspace-namespace 的共享真相与宿主 adapter 都由工作区拥有。Grok 使用工作区非自动发现 source `.grok/devcodex/plugins/devcodex-workspace`：CLI 只通过 Grok 官方本地插件命令登记这个 source，root 与子 Git 项目因此都只看到一个 user-installed plugin identity；root kernel 仍由工作区 `AGENTS.md` 原生加载。旧 `.grok/plugins/devcodex-workspace` 会在新安装验证成功后可逆移动到 active-root backup，用户级 `~/.grok/config.toml` 只精确维护受管 `plugins.enabled`，并移除新旧 owner 的受管 `plugins.paths` 值。从子项目执行 `update --host grok` 时 owner/manifest 仍是工作区根，子项目不会生成 `AGENTS.md`、`.grok/`、`.codex/`、`.claude/` 或 `.gemini/`。由于 Grok passive Hook stdout 不进入提示上下文，子 Git 项目的完整 kernel 保证通过 `devcodex grok` 调用官方 `--rules` 提供；plain child 只承诺插件发现与 best-effort resolver Skill。项目本地 adapter 仅用于显式 `--project-portable` 模式。
 
 > ⚠️ 请确保 IDE 的 "Use Instruction Files" 设置已开启（默认开启）。
 >
@@ -512,14 +512,14 @@ README / 用户使用文档当前补充四类专项 Skill：`user-manual-authori
 | **GitHub Copilot (JetBrains)** | `.github/instructions/*.md` + `copilot-instructions.md`（instruction-fallback） | ⚠️ 官方自定义指令路径，无本地 Hook 硬拦承诺 | ⚠️ 仅文本 | ❌ 未内置 MCP | 🟡 Beta |
 | **Claude Code (CLI/桌面端)** | `CLAUDE.md` + `.claude/{instructions,skills,prompts,hooks/_runtime,mcp}/` + `settings.json` hooks + `.mcp.json` | ✅ Hook 事件支持硬拦；默认 `safety-only` 下流程项提醒放行 | ✅ Hook + 文本确认 | ✅ MCP | 🟢 Full |
 | **Gemini CLI** | `GEMINI.md` 薄入口 + `AGENTS.md` kernel + `.agents/skills/` + `.gemini/settings.json` | ⚠️ Before/After adapter 已实现；本机无 CLI direct replay | ⚠️ Hook + portable fallback | ⚠️ 按宿主配置 | 🟡 Beta / UNVERIFIED |
-| **Grok Build** | 独立显式 portable：项目 `AGENTS.md + .agents + .grok/hooks`；workspace-namespace：工作区 `.grok/plugins/devcodex-workspace` + 官方用户级本地插件登记，子项目零 generated host artifacts；`devcodex grok` 提供 full kernel launcher | ⚠️ plugin validate、两 cwd inspect、passive/PreToolUse 分级已验证；plain child 为 partial，launcher 为 direct | ⚠️ plain child partial；launcher 完整文本门控 | ✅ plugin MCP doctor direct | 🟡 Plain Partial / Launcher Full |
+| **Grok Build** | 独立显式 portable：项目 `AGENTS.md + .agents + .grok/hooks`；workspace-namespace：工作区非自动发现 source `.grok/devcodex/plugins/devcodex-workspace` + 单一官方用户级本地插件登记，子项目零 generated host artifacts | ✅ root native kernel + single user plugin；child plain plugin partial；`devcodex grok` launcher full | ⚠️ 仅 PreToolUse 可阻断；passive stdout ignored | ✅ root/child 双 MCP doctor direct | 🟢 Root Native / 🟡 Child Plain Partial / 🟢 Launcher Full |
 | **Cursor IDE** | 需手工配置 `.cursor/rules` 或 root `AGENTS.md`（instruction-fallback；DevCodex **不**自动分发 Cursor 规则；HOST best-effort only） | ⚠️ 无 DevCodex 本地 Hook 硬拦承诺 | ⚠️ 仅文本 | ❌ | 🟡 Best-effort |
 | **OpenAI Codex app/CLI** | `AGENTS.md` + `.agents/skills/` + `.codex/hooks.json`（含 `PreCompact` compaction guardrail） | ⚠️ Codex hook guardrail；阻断输出按事件契约分为顶层 `decision`、`continue:false` 与工具级 `permissionDecision` | ⚠️ Hook + 文本确认 | ⚠️ 可手工配置 MCP；DevCodex 未自动写入 | 🟡 Beta |
 | **ChatGPT 普通对话** | 不读取本地工作区 `AGENTS.md` / `.agents/` / `.codex/`；可手工粘贴规则 | ❌ | ⚠️ 文本 | ❌ | 🔴 Unsupported |
 
 > **安装命令**：已发布 v1.15.1 默认三宿主部署 → `npx @vextjs/devcodex init`；仅 Claude Code adapter → `npx @vextjs/devcodex init --claude`；仅 Codex adapter → `npx @vextjs/devcodex init --codex`。当前未发布源码可用 `node index.js init --host <gemini|grok|all>` 显式增加 Gemini / Grok，默认面仍保持三宿主兼容行为。
 >
-> **Grok workspace 插件**：在 `workspace-namespace` 的工作区或任一子项目执行 `update --host grok`，CLI 都把 kernel、Skills、薄插件和 managed manifest 写到同一工作区 owner，再通过 Grok 官方本地插件命令同步用户安装登记；用户 Grok 配置只增量维护 DevCodex plugin enabled 项，并移除同一 owner 的旧 path 注册，官方命令执行后恢复配置原始字节，因此其他设置、注释和插件保持不变，重复执行幂等。`uninstall --host grok` 复用相同 scope identity，只解除官方用户安装与受管配置，保留 workspace source，重复卸载幂等。插件用安装登记中的 source owner 校验 cwd，工作区外 no-op。工作区根可直接运行 `grok`；子 Git 项目要获得完整 kernel 保证时运行 `devcodex grok [原 Grok 参数]`。launcher 先消费官方 `--cwd` 决定真实 owner，校验 root kernel，且只在子 Git 边界追加官方 `--rules`；用户额外 rules 会合并，system prompt override 与重复 cwd 会因破坏保证而拒绝。plain child 与 launcher 证据严格分开，不能恢复 ignored 项目 bridge 冒充成功。
+> **Grok workspace 插件**：在 `workspace-namespace` 的工作区或任一子项目执行 `update --host grok`，CLI 都把 kernel、Skills、薄插件和 managed manifest 写到同一工作区 owner。薄插件 source 位于 `.grok/devcodex/plugins/devcodex-workspace`，不会被 project auto-discovery 再发现，只由 Grok 官方本地插件登记形成一个 user identity。旧 `.grok/plugins/devcodex-workspace` 登记会先通过官方 CLI 迁移，新安装 digest 验证后旧 source 才可逆移动到 `.tmp/backups`；失败走旧 source/registration/config 回滚。用户 Grok 配置只维护 DevCodex enabled 项和新旧受管 path 清理，其他设置、注释和插件保持不变，重复执行幂等。`uninstall --host grok` 只解除当前官方登记与受管配置，保留 canonical workspace source。工作区根可直接运行 `grok`；子 Git 项目要获得完整 kernel 保证时运行 `devcodex grok [原 Grok 参数]`。launcher 先消费官方 `--cwd` 决定真实 owner，校验 root kernel，且只在子 Git 边界追加官方 `--rules`；用户额外 rules 会合并，system prompt override 与重复 cwd 会因破坏保证而拒绝。root native、plain child 与 launcher 证据严格分开。
 >
 > **能力差异**：🟢 Full = 已验证 Hook 事件 + MCP + 自动同步；🟡 Beta/Best-effort = 尚未达到 Full，具体能力以矩阵各列为准；🔴 Unsupported = 不在当前本地 adapter 发布范围。默认 `safety-only` 下，bootstrap / CP / auto 白名单等流程问题为提醒并继续，仅危险命令硬拦；设置 `DEVCODEX_HOOK_ENFORCEMENT=strict` 后，支持硬拦的事件才会停止流程。
 >

changelogs/unreleased.md

@@ -15,7 +15,7 @@ WorkspaceDataAbsorptionScopeGate · DocsSiteVisualAcceptanceGate · OmissionOnly
 - bridge 在读取 Profile / memory / full fallback 前先形成语义意图种子，再绑定父级 kernel、项目 active-root 与意图相关 Skills；缺失或歧义时 fail-closed。
 - 独立项目仍保留本地 kernel + Skills + 完整 fallback；部署 manifest、碰撞检测、host inspection、source-root 精确例外与正负向 fixture 已同步。
 - 修正 Grok lifecycle 事件误带 tool matcher 导致 `UserPromptSubmit` / `Stop` 被拒载的问题；workspace 模式改由工作区薄插件承载 Hook 与 MCP bridge，通过官方本地插件安装登记确保 Git 项目 cwd 可达，只维护 `plugins.enabled` 并迁出旧的同 owner path 注册，避免插件碰撞；安装过程恢复用户配置原始字节。
-- 新增 `HostAdapterScopeV1`：workspace-namespace 的子项目默认零 generated host artifacts；Grok adapter owner 固定在工作区 `.grok/plugins/devcodex-workspace`，工作区外 no-op，用户配置保真/幂等，project legacy manifest claims 自动退休。旧项目 bridge 方案已 superseded。
+- 修复 Grok workspace plugin 双身份碰撞：`HostAdapterScopeV1` 将 canonical source 迁移到非自动发现的 `.grok/devcodex/plugins/devcodex-workspace`，只保留官方 user installation identity；旧 source/registration 采用 install-before-move 的可逆备份迁移，配置保真、工作区外 no-op、子项目零 generated host artifacts 与 legacy manifest 退休保持不变。
 - 新增 `devcodex grok` full-evidence launcher：只在 workspace 子 Git 项目用官方 `--rules` 绑定共享 kernel，并明确把 plain child 的 Skill-discovery/partial 与 launcher direct evidence 分开；修正把 passive Hook stdout 误当上下文注入的错误口径。
 - 拆分包开发与 Claude 安装态 MCP 契约：源码根 `.mcp.json` 改为指向实际存在的包内 `mcp/*`，CLI 仍为业务项目生成 `.claude/mcp/*`，避免 Grok 在源码仓发现通用 manifest 时启动不存在路径。
 - 补齐 `uninstall --host grok` 生命周期：复用 `HostAdapterScopeV1`，官方卸载用户插件并只移除 DevCodex 受管配置，保留 workspace source、未知键/注释与重复卸载幂等性。

grok/plugins/devcodex-workspace/hooks/devcodex-workspace.cjs

@@ -31,11 +31,13 @@ function findWorkspaceRoot(start) {
 
 function workspaceFromPluginRoot(pluginRoot) {
   const absolute = path.resolve(pluginRoot)
-  if (
-    path.basename(path.dirname(absolute)).toLowerCase() === 'plugins' &&
-    path.basename(path.dirname(path.dirname(absolute))).toLowerCase() === '.grok'
-  ) {
-    return path.dirname(path.dirname(path.dirname(absolute)))
+  const sourceWorkspace = findWorkspaceRoot(absolute)
+  if (sourceWorkspace) {
+    const allowedSources = [
+      path.join(sourceWorkspace, '.grok', 'devcodex', 'plugins', 'devcodex-workspace'),
+      path.join(sourceWorkspace, '.grok', 'plugins', 'devcodex-workspace')
+    ]
+    if (allowedSources.some(candidate => samePath(candidate, absolute))) return sourceWorkspace
   }
   const installedRoot = path.dirname(absolute)
   if (path.basename(installedRoot).toLowerCase() !== 'installed-plugins') return null

grok/plugins/devcodex-workspace/mcp/workspace-bridge.cjs

@@ -17,12 +17,29 @@ function samePath(left, right) {
   const b = path.resolve(right)
   return process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b
 }
+function findWorkspaceRoot(start) {
+  let current = path.resolve(start)
+  while (true) {
+    const marker = path.join(current, '.devcodex', 'layout.json')
+    try {
+      const layout = JSON.parse(fs.readFileSync(marker, 'utf8'))
+      if (String(layout.mode || '').trim() === 'workspace-namespace') return current
+    } catch { }
+    const parent = path.dirname(current)
+    if (parent === current) return null
+    current = parent
+  }
+}
 function workspaceFromPluginRoot(root) {
   const absolute = path.resolve(root)
-  if (
-    path.basename(path.dirname(absolute)).toLowerCase() === 'plugins' &&
-    path.basename(path.dirname(path.dirname(absolute))).toLowerCase() === '.grok'
-  ) return path.dirname(path.dirname(path.dirname(absolute)))
+  const sourceWorkspace = findWorkspaceRoot(absolute)
+  if (sourceWorkspace) {
+    const allowedSources = [
+      path.join(sourceWorkspace, '.grok', 'devcodex', 'plugins', 'devcodex-workspace'),
+      path.join(sourceWorkspace, '.grok', 'plugins', 'devcodex-workspace')
+    ]
+    if (allowedSources.some(candidate => samePath(candidate, absolute))) return sourceWorkspace
+  }
   const installedRoot = path.dirname(absolute)
   if (path.basename(installedRoot).toLowerCase() !== 'installed-plugins') return null
   try {

index.js

@@ -24,7 +24,7 @@ const {
   grokUserConfigPath,
   retireWorkspaceProjectHostManifest,
   resolveHostAdapterScope,
-  syncGrokPluginInstallation, uninstallGrokPluginInstallation,
+  syncGrokPluginInstallation, syncGrokWorkspacePluginInstallation, uninstallGrokPluginInstallation,
   writeGrokPluginRegistration
 } = require('./scripts/lib/host-adapter-scope.js')
 const { runCli: runMigrateLayout } = require('./scripts/migrate-layout.js')
@@ -356,7 +356,7 @@ const { cmdInit, cmdInitHost, cmdInitClaude, cmdInitCodex, cmdInitGemini, cmdIni
   ensureRuntimeDirs, ensureDevCodexGitignore, walkDir,
   resolveActiveRuntimeRoot, resolveGitignoreRoot, getLegacyCounts, isPlainObject,
   resolveHostAdapterScope, writeGrokPluginRegistration,
-  syncGrokPluginInstallation,
+  syncGrokPluginInstallation, syncGrokWorkspacePluginInstallation,
   uninstallGrokPluginInstallation,
   retireWorkspaceProjectHostManifest,
   resolveTenantSelection, shouldIncludeInstructionFile

scripts/lib/cli-host-utils.js

@@ -173,7 +173,9 @@ function buildCliHostUtils({ fs, path, isPlainObject, claudeMcpJson }) {
       let registrationError = null
       try {
         const config = fs.existsSync(configPath) ? fs.readFileSync(configPath, 'utf8') : ''
-        registrationCurrent = !mergeGrokPluginRegistration(config, hostScope.pluginRoot).changed
+        registrationCurrent = !mergeGrokPluginRegistration(config, hostScope.pluginRoot, {
+          legacyPluginPaths: hostScope.legacyPluginRoots
+        }).changed
       } catch (error) { registrationError = error.message }
       grokPlugin = {
         root: hostScope.pluginRoot,
@@ -183,6 +185,7 @@ function buildCliHostUtils({ fs, path, isPlainObject, claudeMcpJson }) {
         sourcePresent: fs.existsSync(manifest) && fs.existsSync(hook),
         installed: fs.existsSync(manifest) && fs.existsSync(hook) && installation.current,
         installation,
+        legacySourcesPresent: (hostScope.legacyPluginRoots || []).filter(item => fs.existsSync(item)),
         registrationCurrent,
         registrationError
       }
@@ -196,6 +199,9 @@ function buildCliHostUtils({ fs, path, isPlainObject, claudeMcpJson }) {
           ...(registrationError ? { detail: registrationError } : {})
         })
       }
+      if (grokPlugin.legacySourcesPresent.length) {
+        issues.push({ code: 'HOST_GROK_LEGACY_PLUGIN_SOURCE_PRESENT', paths: grokPlugin.legacySourcesPresent })
+      }
     }
     if (fallback.installed && sourceDigests.size === 1 && fallback.digest !== [...sourceDigests][0]) {
       issues.push({

scripts/lib/cli-install-commands.js

@@ -13,6 +13,7 @@ function buildCliInstallCommands(ctx) {
     mergeClaudeHooks, mergeClaudeMcpConfig,
     ensureRuntimeDirs, ensureDevCodexGitignore, getLegacyCounts, isPlainObject,
     resolveHostAdapterScope, writeGrokPluginRegistration, syncGrokPluginInstallation,
+    syncGrokWorkspacePluginInstallation,
     uninstallGrokPluginInstallation, retireWorkspaceProjectHostManifest,
     resolveTenantSelection, shouldIncludeInstructionFile
   } = ctx
@@ -794,6 +795,7 @@ function buildCliInstallCommands(ctx) {
     if (grokWorkspaceScope) {
       writeGrokPluginRegistration({
         pluginPath: hostScope.pluginRoot,
+        legacyPluginPaths: hostScope.legacyPluginRoots,
         activeRoot,
         dryRun: true,
         env: process.env
@@ -818,30 +820,27 @@ function buildCliInstallCommands(ctx) {
       addCounts(counts, copyProjectedTree({
         cwd: targetRoot,
         source: 'grok/plugins/devcodex-workspace',
-        destination: path.join('.grok', 'plugins', 'devcodex-workspace'),
+        destination: path.join('.grok', 'devcodex', 'plugins', 'devcodex-workspace'),
         force, dryRun, backupDir, log, inlineLog, tenantId
       }))
-      const registration = writeGrokPluginRegistration({
+      const installation = syncGrokWorkspacePluginInstallation({
         pluginPath: hostScope.pluginRoot,
+        legacyPluginPaths: hostScope.legacyPluginRoots,
         activeRoot,
+        backupDir,
         dryRun,
         env: process.env
       })
-      if (registration.changed) {
+      if (installation.status === 'migrated') {
         counts.updated++
-        log(c.green('  ✓ Grok user config (managed workspace plugin registration)'))
+        log(c.green('  ✓ Grok workspace plugin migrated to the canonical source'))
       } else {
         counts.skipped++
-        log(c.dim('  ~ Grok user config (workspace plugin already registered)'))
+        log(c.dim(`  ~ Grok workspace plugin source (${installation.status})`))
       }
-      const installation = syncGrokPluginInstallation({
-        pluginPath: hostScope.pluginRoot,
-        dryRun,
-        env: process.env
-      })
       if (installation.status === 'unavailable') {
-        inlineLog(c.yellow('  ⚠ Grok CLI not found; plugin path is registered but runtime activation remains unverified'))
-      } else if (installation.status === 'verified') {
+        inlineLog(c.yellow('  ⚠ Grok CLI not found; legacy source was retained and canonical activation remains unverified'))
+      } else if (['verified', 'migrated'].includes(installation.status)) {
         log(c.green('  ✓ Grok user plugin installation synchronized'))
       } else {
         log(c.dim(`  ~ Grok user plugin installation (${installation.status})`))