Function load_plugin

tools/adapters/base.py:314–366

Load a plugin's source tree from `plugins/ /`. Plugin names with `__` are rejected: the adapter framework uses ` __ ` as a namespace separator across Codex/OpenCode/Gemini. A plugin name containing `__` would break stale-detection and produce ambiguous reverse-mappi

(plugin_name: str)

def load_plugin(plugin_name: str) -> PluginSource | None:
    """Load a plugin&#x27;s source tree from `plugins/<name>/`.

    Plugin names with `__` are rejected: the adapter framework uses
    `<plugin>__<leaf>` as a namespace separator across Codex/OpenCode/Gemini.
    A plugin name containing `__` would break stale-detection and produce
    ambiguous reverse-mappings in doc_gardener.
    """
    if "__" in plugin_name:
        # We use stderr-style print here only at the load site (no logger in this module).
        import sys

        print(
            f"warning: skipping plugin `{plugin_name}` — plugin names must not contain "
            "`__` (the adapter namespace separator).",
            file=sys.stderr,
        )
        return None
    plugin_dir = PLUGINS_DIR / plugin_name
    if not plugin_dir.is_dir():
        return None

    plugin_json = read_plugin_json(plugin_dir)
    plugin = PluginSource(name=plugin_name, dir=plugin_dir, plugin_json=plugin_json)

    agents_dir = plugin_dir / "agents"
    if agents_dir.is_dir():
        for md in sorted(agents_dir.glob("*.md")):
            fm, body = parse_frontmatter(read_file(md))
            plugin.agents.append(
                AgentSource(plugin=plugin_name, name=md.stem, path=md, frontmatter=fm, body=body)
            )

    skills_dir = plugin_dir / "skills"
    if skills_dir.is_dir():
        for sd in sorted(skills_dir.iterdir()):
            skill_file = sd / "SKILL.md"
            if not (sd.is_dir() and skill_file.is_file()):
                continue
            fm, body = parse_frontmatter(read_file(skill_file))
            plugin.skills.append(
                SkillSource(plugin=plugin_name, name=sd.name, dir=sd, frontmatter=fm, body=body)
            )

    commands_dir = plugin_dir / "commands"
    if commands_dir.is_dir():
        for md in sorted(commands_dir.glob("*.md")):
            fm, body = parse_frontmatter(read_file(md))
            plugin.commands.append(
                CommandSource(plugin=plugin_name, name=md.stem, path=md, frontmatter=fm, body=body)
            )

    return plugin


def list_plugins() -> list[str]: