_skill_management_support.py

"""Skill manager: read-only inspection, hash-confirmed mutation, and rollback."""

from __future__ import annotations

import json
import os
import shutil
import subprocess
import sys
import unittest
from contextlib import nullcontext
from pathlib import Path
from unittest import mock

REPO_ROOT = Path(__file__).resolve().parents[1]
SCRIPT = REPO_ROOT / "support_scripts" / "skill_manager.py"

sys.path.insert(0, str(REPO_ROOT))

import support_scripts.skill_management.links as link_module  # noqa: E402
import support_scripts.skill_management.policy as policy_module  # noqa: E402
from tests._fixture_isolation import temp_test_root  # noqa: E402
from support_scripts.skill_management import (  # noqa: E402
    SkillManagementError,
    apply_index_plan,
    apply_link_plan,
    apply_policy_plan,
    apply_store_index_plan,
    build_index_plan,
    build_link_plan,
    build_policy_plan,
    build_policy_restore_plan,
    build_store_index_plan,
    discover_skills,
    index_status,
    package_sha256,
    policy_status,
    restore_policy,
    validate_skill_package,
    validation_status,
)

def write_leaf(root: Path, name: str, keywords: list[str] | None = None) -> Path:
    skill = root / name
    (skill / "references").mkdir(parents=True)
    (skill / "evals").mkdir()
    (skill / "SKILL.md").write_text(
        "\n".join(
            [
                "---",
                f"name: {name}",
                f"description: Use when working with {name} fixtures and validation tests.",
                "---",
                "",
                f"# {name}",
                "",
                "## Workflow",
                "",
                "Read the relevant reference before acting.",
                "",
                "## References",
                "",
                "Start with [the index](references/INDEX.md).",
                "",
                "## Gotchas",
                "",
                "See [evals/GOTCHA.md](evals/GOTCHA.md).",
                "",
                "## Verification",
                "",
                "Run the package validator.",
                "",
            ]
        ),
        encoding="utf-8",
        newline="\n",
    )
    (skill / "references" / "topic.md").write_text("# Topic\n\nVerified guidance.\n", encoding="utf-8")
    (skill / "references" / "INDEX.md").write_text(
        "# References\n\n- [Topic](topic.md)\n", encoding="utf-8"
    )
    (skill / "references" / "topics.json").write_text(
        json.dumps(
            {
                "topics": [
                    {
                        "topic": "Topic",
                        "summary": "Verified topic guidance.",
                        "keywords": keywords or [name, "shared-entity"],
                        "file": "references/topic.md",
                    }
                ]
            },
            indent=2,
        )
        + "\n",
        encoding="utf-8",
    )
    (skill / "evals" / "GOTCHA.md").write_text("# Gotchas\n\n- Verify first.\n", encoding="utf-8")
    return skill

def write_router(root: Path, name: str, child_name: str = "child") -> tuple[Path, Path]:
    router = root / name
    (router / "evals").mkdir(parents=True)
    child = write_leaf(router, child_name)
    (router / "SKILL.md").write_text(
        "\n".join(
            [
                "---",
                f"name: {name}",
                f"description: Use when routing {name} work to a product subskill.",
                "---",
                "",
                f"# {name}",
                "",
                "## Workflow",
                "",
                f"Open [{child_name}]({child_name}/SKILL.md).",
                "",
                "## References",
                "",
                "Each child owns its references.",
                "",
                "## Gotchas",
                "",
                "See [evals/GOTCHA.md](evals/GOTCHA.md).",
                "",
                "## Verification",
                "",
                "Validate the complete router package.",
                "",
            ]
        ),
        encoding="utf-8",
    )
    (router / "evals" / "GOTCHA.md").write_text("# Gotchas\n\n- Route deliberately.\n", encoding="utf-8")
    return router, child

def create_directory_link(path: Path, target: Path) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    if os.name == "nt":
        proc = subprocess.run(
            ["cmd.exe", "/d", "/c", "mklink", "/J", str(path), str(target)],
            capture_output=True,
            text=True,
            encoding="utf-8",
        )
        if proc.returncode != 0:
            raise OSError(proc.stderr or proc.stdout)
    else:
        os.symlink(target, path, target_is_directory=True)

def create_file_link(path: Path, target: Path) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    os.symlink(target, path, target_is_directory=False)

class ScratchTest(unittest.TestCase):
    def setUp(self) -> None:
        self.root = self.enterContext(temp_test_root(prefix="skill_management-"))
        self.project = self.root / "project"
        self.store = self.root / "store"
        self.project.mkdir()
        self.store.mkdir()

__all__ = tuple(name for name in globals() if not name.startswith('__'))