Skip to content

m3taz-ahmed/aizee / skills/bmad

Answers BMad questions and recommends the next skill from what is installed. Use when the user asks bmad for help, what to do next or where to start; to set up, update, repair, doctor, migrate or check the status of the installation, or add modules; or to see or change the active initiative.

scripts/tests/test_resolve_customization.py

View on GitHub
import json
import os
import shutil
import subprocess
import sys
import tempfile
import unittest
from pathlib import Path

SCRIPT = Path(__file__).resolve().parents[1] / "resolve_customization.py"


class ResolveCustomizationStdoutTests(unittest.TestCase):
    def test_missing_tomllib_exits_with_actionable_version_error(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            scripts = Path(temp_dir)
            shutil.copy2(SCRIPT, scripts / SCRIPT.name)
            shutil.copy2(SCRIPT.parent / "config_utils.py", scripts / "config_utils.py")
            (scripts / "tomllib.py").write_text(
                'raise ModuleNotFoundError("No module named tomllib", name="tomllib")\n',
                encoding="utf-8",
            )

            result = subprocess.run(
                [sys.executable, str(scripts / SCRIPT.name), "--help"],
                text=True,
                capture_output=True,
                check=False,
            )

            self.assertEqual(result.returncode, 3)
            self.assertEqual(
                result.stderr,
                "error: Python 3.11+ is required (stdlib `tomllib` not found).\n",
            )
            self.assertNotIn("Traceback", result.stderr)

    def test_writes_emoji_json_when_stdout_encoding_is_cp1252(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            skill_dir = Path(temp_dir) / "emoji-agent"
            skill_dir.mkdir()
            (skill_dir / "customize.toml").write_text(
                '[agent]\nname = "Emoji Agent"\nicon = "🧭"\n',
                encoding="utf-8",
            )

            env = os.environ.copy()
            env["PYTHONIOENCODING"] = "cp1252"
            result = subprocess.run(
                [
                    sys.executable,
                    str(SCRIPT),
                    "--skill",
                    str(skill_dir),
                    "--key",
                    "agent",
                ],
                capture_output=True,
                cwd=temp_dir,
                env=env,
                check=False,
            )

            stderr = result.stderr.decode("utf-8", errors="replace")
            self.assertEqual(result.returncode, 0, msg=stderr)

            output = result.stdout.decode("utf-8")
            self.assertIn("🧭", output)
            resolved = json.loads(output)
            self.assertEqual(resolved["agent"]["icon"], "🧭")


def write(path: Path, body: str) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(body, encoding="utf-8")


def facts(*entries: str) -> str:
    listed = ", ".join(f'"{entry}"' for entry in entries)
    return f"[workflow]\npersistent_facts = [{listed}]\n"


def resolve(skill_dir: Path, cwd: Path, *extra: str):
    return subprocess.run(
        [sys.executable, str(SCRIPT), "--skill", str(skill_dir), "--key", "workflow", *extra],
        text=True,
        capture_output=True,
        cwd=str(cwd),
        check=False,
    )


class PreflightRootsTests(unittest.TestCase):
    """The setup preflight claims a dependency is missing only for roots the caller names."""

    SOURCE = "github:acme/tools/skills"

    def layout(self, temp_dir: str) -> tuple[Path, Path, Path]:
        project = Path(temp_dir) / "project"
        local = project / ".claude" / "skills"
        elsewhere = Path(temp_dir) / "global" / "skills"
        write(
            local / "bmod-demo" / "bmod.toml",
            f'[bmod]\ncode = "demo"\nversion = "1.0.0"\nupdate_source = "{self.SOURCE}"\n'
            'skills = ["demo-skill"]\nrequired_skills = ["other-skill"]\n',
        )
        write(local / "demo-skill" / "bmod.toml", f'[skill]\nbmod = "bmod-demo"\nsource = "{self.SOURCE}"\n')
        write(local / "demo-skill" / "customize.toml", facts("shipped default"))
        write(elsewhere / "other-skill" / "SKILL.md", "other\n")
        (project / "_bmad").mkdir(parents=True)
        return project, local / "demo-skill", elsewhere

    def test_no_roots_means_no_dependency_claim(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            project, skill, _ = self.layout(temp_dir)
            result = resolve(skill, project)
            self.assertEqual(result.returncode, 0, msg=result.stderr)
            self.assertEqual(result.stderr, "")

    def test_a_dependency_in_a_named_root_is_met(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            project, skill, elsewhere = self.layout(temp_dir)
            result = resolve(skill, project, "--root", str(skill.parent), "--root", str(elsewhere))
            self.assertEqual(result.returncode, 0, msg=result.stderr)
            self.assertEqual(result.stderr, "")

    def test_a_dependency_absent_from_every_named_root_is_reported(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            project, skill, _ = self.layout(temp_dir)
            result = resolve(skill, project, "--root", str(skill.parent))
            self.assertEqual(result.returncode, 0, msg=result.stderr)
            self.assertIn("needs the `other-skill` skill", result.stderr)


class ProjectRootResolutionTests(unittest.TestCase):
    """Regression cover for #2796 — the project is where the user works, not
    where the skill is installed."""

    def test_home_installed_skill_reads_project_override_not_home_bmad(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            home = Path(temp_dir) / "home"
            project = Path(temp_dir) / "project"
            skill = home / ".claude" / "skills" / "demo-skill"
            write(skill / "customize.toml", facts("shipped default"))
            (home / "_bmad" / "custom").mkdir(parents=True)
            write(project / "_bmad" / "custom" / "demo-skill.toml", facts("team override"))

            result = resolve(skill, project)

            self.assertEqual(result.returncode, 0, msg=result.stderr)
            resolved = json.loads(result.stdout)["workflow"]["persistent_facts"]
            self.assertEqual(resolved, ["shipped default", "team override"])

    def test_project_installed_skill_still_resolves(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            project = Path(temp_dir) / "project"
            skill = project / ".claude" / "skills" / "demo-skill"
            write(skill / "customize.toml", facts("shipped default"))
            write(project / "_bmad" / "custom" / "demo-skill.toml", facts("team override"))

            result = resolve(skill, project)

            self.assertEqual(result.returncode, 0, msg=result.stderr)
            resolved = json.loads(result.stdout)["workflow"]["persistent_facts"]
            self.assertEqual(resolved, ["shipped default", "team override"])

    def test_walk_prefers_bmad_over_a_nearer_git_directory(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            project = Path(temp_dir) / "project"
            submodule = project / "vendor" / "sub"
            skill = Path(temp_dir) / "skills" / "demo-skill"
            write(skill / "customize.toml", facts("shipped default"))
            write(project / "_bmad" / "custom" / "demo-skill.toml", facts("team override"))
            (submodule / ".git").mkdir(parents=True)

            result = resolve(skill, submodule)

            self.assertEqual(result.returncode, 0, msg=result.stderr)
            resolved = json.loads(result.stdout)["workflow"]["persistent_facts"]
            self.assertEqual(resolved, ["shipped default", "team override"])

    def test_notes_when_a_rejected_root_holds_the_only_override(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            home = Path(temp_dir) / "home"
            project = Path(temp_dir) / "project"
            skill = home / ".claude" / "skills" / "demo-skill"
            write(skill / "customize.toml", facts("shipped default"))
            write(home / "_bmad" / "custom" / "demo-skill.toml", facts("home override"))
            (project / "_bmad" / "custom").mkdir(parents=True)

            result = resolve(skill, project)

            self.assertEqual(result.returncode, 0, msg=result.stderr)
            resolved = json.loads(result.stdout)["workflow"]["persistent_facts"]
            self.assertEqual(resolved, ["shipped default"])
            self.assertIn("demo-skill", result.stderr)
            self.assertIn("--project-root", result.stderr)

    def test_explicit_project_root_wins_and_stays_quiet(self):
        with tempfile.TemporaryDirectory() as temp_dir:
            home = Path(temp_dir) / "home"
            project = Path(temp_dir) / "project"
            skill = home / ".claude" / "skills" / "demo-skill"
            write(skill / "customize.toml", facts("shipped default"))
            write(home / "_bmad" / "custom" / "demo-skill.toml", facts("home override"))
            (project / "_bmad" / "custom").mkdir(parents=True)

            result = resolve(skill, project, "--project-root", str(home))

            self.assertEqual(result.returncode, 0, msg=result.stderr)
            resolved = json.loads(result.stdout)["workflow"]["persistent_facts"]
            self.assertEqual(resolved, ["shipped default", "home override"])
            self.assertEqual(result.stderr, "")


if __name__ == "__main__":
    unittest.main()
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall