Method emit_plugin

tools/adapters/codex.py:346–386

(self, plugin: PluginSource)

        self.repo_root = repo_root if repo_root is not None else WORKTREE

    def emit_plugin(self, plugin: PluginSource) -> EmitResult:
        result = EmitResult()

        # Detect skill/command name collisions before emitting — Codex maps both into
        # `.codex/skills/<plugin>__<name>/`, so duplicates would silently overwrite.
        skill_names = {s.name for s in plugin.skills}
        command_collisions = {c.name for c in plugin.commands} & skill_names

        # Second-order collision: if a skill is literally named `<x>__command`, the
        # `__command` suffix the adapter uses for collision-resolution would clash
        # with it. Detect and route the command-skill to `__cmd` instead.
        skill_suffix_conflicts: set[str] = set()
        for cmd_name in command_collisions:
            if f"{cmd_name}__command" in skill_names:
                skill_suffix_conflicts.add(cmd_name)
                result.warnings.append(
                    f"plugin `{plugin.name}` has skill `{cmd_name}`, command `{cmd_name}`, "
                    f"AND skill `{cmd_name}__command` — command-skill routed to "
                    f"`{cmd_name}__cmd` to avoid second-order collision"
                )

        for skill in plugin.skills:
            self._emit_skill(plugin, skill, result)
        for agent in plugin.agents:
            self._emit_agent(plugin, agent, result)
        # Codex deprecated prompts in favor of skills. Synthesize a skill from each command.
        for cmd in plugin.commands:
            collides = cmd.name in command_collisions
            suffix_conflict = cmd.name in skill_suffix_conflicts
            self._emit_command_as_skill(
                plugin,
                cmd,
                result,
                collides=collides,
                fallback_suffix=suffix_conflict,
            )

        # Per-plugin Codex manifest for native marketplace install (reads source skills).
        self._emit_codex_plugin_manifest(plugin, result)

        return result

    def emit_global(self, plugins: list[PluginSource]) -> EmitResult:
        """Validate the committed root AGENTS.md and emit the Codex marketplace registry.