fix(opencode): use singular directory names (agent/, skill/) to match OpenCode layout

OpenCode discovers agents in agent/ and skills in skill/ (singular), not
agents/ or skills/ (plural). command/ was already correct. This fix makes
the installed plugin visible to OpenCode immediately after install.

Bumps version to 1.2.1.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: RichardHightower

ai_codebase_mentor/__init__.py

@@ -1,3 +1,3 @@
 """ai-codebase-mentor — multi-runtime Codebase Wizard installer."""
 
-__version__ = "1.2.0"
+__version__ = "1.2.1"

ai_codebase_mentor/converters/opencode.py

@@ -5,8 +5,8 @@
   Project: ./.opencode/codebase-wizard/
 
 Agent frontmatter is converted from Claude Code format (allowed_tools: array)
-to OpenCode format (tools: object with lowercase keys). Command files are placed
-in command/ (singular). Skills are copied verbatim.
+to OpenCode format (tools: object with lowercase keys). OpenCode uses singular
+directory names: agent/, command/, skill/ (not agents/, commands/, skills/).
 """
 
 import json
@@ -231,8 +231,8 @@ def _resolve_dest(self, target: str) -> Path:
     def install(self, source: Path, target: str = "global") -> None:
         """Convert and install the plugin to the OpenCode configuration directory.
 
-        Converts agent frontmatter, renames commands/ -> command/, copies skills
-        verbatim, and writes opencode.json permission pre-authorization.
+        Converts agent frontmatter, renames commands/ -> command/, agents/ -> agent/,
+        skills/ -> skill/, and writes opencode.json permission pre-authorization.
 
         Args:
             source: Path to the bundled plugin directory (contains .claude-plugin/).
@@ -254,7 +254,7 @@ def install(self, source: Path, target: str = "global") -> None:
 
             # Convert and copy agent files
             agents_src = source / "agents"
-            agents_dst = destination / "agents"
+            agents_dst = destination / "agent"
             agents_dst.mkdir(parents=True, exist_ok=True)
             for agent_file in agents_src.glob("*.md"):
                 content = agent_file.read_text(encoding="utf-8")
@@ -274,7 +274,7 @@ def install(self, source: Path, target: str = "global") -> None:
             # Copy skills verbatim (runtime-agnostic)
             skills_src = source / "skills"
             if skills_src.exists():
-                shutil.copytree(skills_src, destination / "skills")
+                shutil.copytree(skills_src, destination / "skill")
 
             # Copy .claude-plugin directory (for version reading)
             claude_plugin_src = source / ".claude-plugin"

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-codebase-mentor"
-version = "1.2.0"
+version = "1.2.1"
 description = "Wizard-style codebase exploration and documentation. Install the Codebase Wizard plugin for Claude Code (and other runtimes in future releases)."
 requires-python = ">=3.9"
 license = {text = "MIT"}

tests/test_opencode_installer.py

@@ -32,26 +32,26 @@ def installer(tmp_path, monkeypatch):
 
 
 def test_global_install_creates_agent_files(installer, source_plugin_dir, tmp_path):
-    """install(source, 'global') creates agents dir at ~/.config/opencode/codebase-wizard/agents/."""
+    """install(source, 'global') creates agent dir at ~/.config/opencode/codebase-wizard/agent/."""
     installer.install(source_plugin_dir, "global")
     agents_dir = (
-        tmp_path / "home" / ".config" / "opencode" / "codebase-wizard" / "agents"
+        tmp_path / "home" / ".config" / "opencode" / "codebase-wizard" / "agent"
     )
-    assert agents_dir.exists(), f"agents dir not found at {agents_dir}"
+    assert agents_dir.exists(), f"agent dir not found at {agents_dir}"
     assert (agents_dir / "codebase-wizard-agent.md").exists(), (
-        "codebase-wizard-agent.md not found in agents dir"
+        "codebase-wizard-agent.md not found in agent dir"
     )
 
 
 def test_project_install_creates_agent_files(installer, source_plugin_dir, tmp_path):
-    """install(source, 'project') creates agents dir at ./.opencode/codebase-wizard/agents/."""
+    """install(source, 'project') creates agent dir at ./.opencode/codebase-wizard/agent/."""
     installer.install(source_plugin_dir, "project")
     agents_dir = (
-        tmp_path / "cwd" / ".opencode" / "codebase-wizard" / "agents"
+        tmp_path / "cwd" / ".opencode" / "codebase-wizard" / "agent"
     )
-    assert agents_dir.exists(), f"agents dir not found at {agents_dir}"
+    assert agents_dir.exists(), f"agent dir not found at {agents_dir}"
     assert (agents_dir / "codebase-wizard-agent.md").exists(), (
-        "codebase-wizard-agent.md not found in agents dir"
+        "codebase-wizard-agent.md not found in agent dir"
     )
 
 
@@ -103,7 +103,7 @@ def test_agent_tool_names_lowercased(installer, source_plugin_dir, tmp_path):
     installer.install(source_plugin_dir, "global")
     agent_file = (
         tmp_path / "home" / ".config" / "opencode" / "codebase-wizard"
-        / "agents" / "codebase-wizard-agent.md"
+        / "agent" / "codebase-wizard-agent.md"
     )
     content = agent_file.read_text()
     assert "read: true" in content, (
@@ -141,7 +141,7 @@ def test_special_tool_mapping_applied(installer, source_plugin_dir, tmp_path):
     installer.install(temp_source, "global")
     agent_out = (
         tmp_path / "home" / ".config" / "opencode" / "codebase-wizard"
-        / "agents" / "codebase-wizard-agent.md"
+        / "agent" / "codebase-wizard-agent.md"
     )
     content = agent_out.read_text()
     assert "question: true" in content, (
@@ -154,7 +154,7 @@ def test_name_field_stripped(installer, source_plugin_dir, tmp_path):
     installer.install(source_plugin_dir, "global")
     agent_file = (
         tmp_path / "home" / ".config" / "opencode" / "codebase-wizard"
-        / "agents" / "codebase-wizard-agent.md"
+        / "agent" / "codebase-wizard-agent.md"
     )
     content = agent_file.read_text()
     # Find the frontmatter section (between first and second '---')
@@ -198,7 +198,7 @@ def test_subagent_type_normalized(installer, source_plugin_dir, tmp_path):
     installer.install(temp_source, "global")
     agent_out = (
         tmp_path / "home" / ".config" / "opencode" / "codebase-wizard"
-        / "agents" / "codebase-wizard-agent.md"
+        / "agent" / "codebase-wizard-agent.md"
     )
     content = agent_out.read_text()
     assert 'subagent_type: "general"' in content, (