#!/usr/bin/env python3
# SPDX-License-Identifier: Apache-2.0
# Copyright 2024-2026 Lukasz Krzemien (biuro@softspark.eu)
# Source: https://github.com/softspark/ai-toolkit

"""Generate a Devin/Windsurf skill pointer.

Current Devin docs list ``.windsurf/skills/`` as a supported cross-tool skill
path and do not list ``.devin/skills/``. Pass an explicit ``skill_root`` for a
single alternate location (used by the legacy HOME-scoped Windsurf install).
"""
from __future__ import annotations

import sys
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent))
from skill_pointer import POINTER_SKILL_NAME, write_pointer_skill

DEFAULT_SKILL_ROOTS: tuple[str, ...] = (".windsurf/skills",)


def generate(target_dir: Path, *, emit_skill_pointer: bool = True,
             skill_root: str | None = None) -> None:
    if not emit_skill_pointer:
        return
    roots = (skill_root,) if skill_root else DEFAULT_SKILL_ROOTS
    for root in roots:
        write_pointer_skill(target_dir, root, "Windsurf")
        print(f"  Generated: {root}/{POINTER_SKILL_NAME}/SKILL.md")


def main() -> None:
    target = Path(sys.argv[1]) if len(sys.argv) > 1 else Path.cwd()
    generate(target)


if __name__ == "__main__":
    main()
