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_knowledge_migrations.py

View on GitHub
import sys
import tempfile
import unittest
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parents[1]))

import knowledge  # noqa: E402

SOURCE = "github:acme/tools/skills"
MIGRATION = """
[migration]
module = "demo"
from = "1"
to = "2"
title = "Move demo artifacts to the v2 layout"
summary = "v1 to v2"
detect = "a v1 folder"
guide = "move it"
checklist = ["it moved"]
"""


def write_module(root: Path, skills: tuple[str, ...] = (), *, code: str = "demo") -> Path:
    record = root / f"bmod-{code}"
    record.mkdir(parents=True)
    names = ", ".join(f'"{name}"' for name in skills)
    lines = ["[bmod]", f'code = "{code}"', 'version = "1.0.0"', f'update_source = "{SOURCE}"', f"skills = [{names}]"]
    (record / "bmod.toml").write_text("\n".join(lines) + "\n", encoding="utf-8")
    for name in skills:
        folder = root / name
        folder.mkdir(parents=True)
        (folder / "bmod.toml").write_text(f'[skill]\nbmod = "{record.name}"\nsource = "{SOURCE}"\n', encoding="utf-8")
    return record


class MigrationTests(unittest.TestCase):
    def setUp(self):
        self.temp = tempfile.TemporaryDirectory()
        self.addCleanup(self.temp.cleanup)
        self.skills = Path(self.temp.name) / ".claude" / "skills"

    def test_a_migration_file_is_listed_by_its_table_without_its_text(self):
        record = write_module(self.skills, ("demo-one",))
        (record / "migration-1.toml").write_text(MIGRATION, encoding="utf-8")
        report = knowledge.collect([self.skills])
        self.assertEqual(
            report["migrations"],
            [
                {
                    "module": "demo",
                    "path": "migration-1.toml",
                    "file": str(record / "migration-1.toml"),
                    "from": "1",
                    "to": "2",
                    "title": "Move demo artifacts to the v2 layout",
                }
            ],
        )
        self.assertEqual(report["problems"], [])

    def test_other_toml_files_beside_the_record_are_not_migrations_and_a_bad_key_is_named(self):
        record = write_module(self.skills)
        (record / "roster.toml").write_text("[[members]\nnot even toml\n", encoding="utf-8")
        (record / "notes.toml").write_text('migration = "not a table"\n', encoding="utf-8")
        report = knowledge.collect([self.skills])
        self.assertEqual(report["migrations"], [])
        self.assertEqual([problem["kind"] for problem in report["problems"]], ["migration"])
        self.assertIn("'migration' is not a table", report["problems"][0]["problem"])

    def test_a_migration_without_its_fields_is_a_problem_not_a_listing(self):
        record = write_module(self.skills)
        (record / "migration-2.toml").write_text('[migration]\nmodule = "demo"\nfrom = 1\nto = "2"\n', encoding="utf-8")
        report = knowledge.collect([self.skills])
        self.assertEqual(report["migrations"], [])
        self.assertEqual(len(report["problems"]), 1)
        self.assertEqual(report["problems"][0]["kind"], "migration")
        self.assertIn(
            "needs non-empty from, title, summary, detect, guide, checklist", report["problems"][0]["problem"]
        )

    def test_whitespace_only_fields_and_blank_checklist_items_are_missing(self):
        record = write_module(self.skills)
        text = MIGRATION.replace('guide = "move it"', 'guide = "  "').replace(
            'checklist = ["it moved"]', 'checklist = [" "]'
        )
        (record / "migration-3.toml").write_text(text, encoding="utf-8")
        report = knowledge.collect([self.skills])
        self.assertEqual(report["migrations"], [])
        self.assertIn("needs non-empty guide, checklist", report["problems"][0]["problem"])

    def test_a_migration_for_another_module_is_a_problem(self):
        record = write_module(self.skills)
        text = MIGRATION.replace('module = "demo"', 'module = "other"')
        (record / "migration-4.toml").write_text(text, encoding="utf-8")
        report = knowledge.collect([self.skills])
        self.assertEqual(report["migrations"], [])
        self.assertIn("is not this record's 'demo'", report["problems"][0]["problem"])

    def test_migrations_are_listed_by_number_not_by_text(self):
        record = write_module(self.skills)
        for number in (10, 2, 1):
            text = MIGRATION.replace('from = "1"', f'from = "{number}"').replace('to = "2"', f'to = "{number + 1}"')
            (record / f"migration-{number}.toml").write_text(text, encoding="utf-8")
        report = knowledge.collect([self.skills])
        self.assertEqual(
            [m["path"] for m in report["migrations"]], ["migration-1.toml", "migration-2.toml", "migration-10.toml"]
        )
        self.assertEqual(report["problems"], [])

    def test_a_migration_outside_the_naming_rule_is_a_problem(self):
        record = write_module(self.skills)
        for name in ("v1-v2-migration.toml", "migration-one.toml", "migration-1-2.toml"):
            (record / name).write_text(MIGRATION, encoding="utf-8")
        report = knowledge.collect([self.skills])
        self.assertEqual(report["migrations"], [])
        self.assertEqual(len(report["problems"]), 3)
        for problem in report["problems"]:
            self.assertIn("must be named migration-<n>.toml", problem["problem"])

    def test_two_migrations_of_one_module_with_the_same_number_are_problems(self):
        record = write_module(self.skills)
        other = write_module(self.skills, code="other")
        (record / "migration-1.toml").write_text(MIGRATION, encoding="utf-8")
        (record / "migration-01.toml").write_text(MIGRATION, encoding="utf-8")
        (record / "migration-2.toml").write_text(MIGRATION, encoding="utf-8")
        (other / "migration-1.toml").write_text(
            MIGRATION.replace('module = "demo"', 'module = "other"'), encoding="utf-8"
        )
        report = knowledge.collect([self.skills])
        self.assertEqual(
            [(m["module"], m["path"]) for m in report["migrations"]],
            [("demo", "migration-2.toml"), ("other", "migration-1.toml")],
        )
        self.assertEqual(
            sorted(Path(problem["document"]).name for problem in report["problems"]),
            ["migration-01.toml", "migration-1.toml"],
        )
        for problem in report["problems"]:
            self.assertIn("same number", problem["problem"])

    def test_a_migration_that_is_not_toml_is_a_problem(self):
        record = write_module(self.skills)
        (record / "migration-5.toml").write_text('[migration\nfrom = "1"\n', encoding="utf-8")
        report = knowledge.collect([self.skills])
        self.assertEqual(report["migrations"], [])
        self.assertEqual([problem["kind"] for problem in report["problems"]], ["migration"])


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