Day 12: Cross-Host Packaging & Distribution

#!/usr/bin/env python3
"""
package-cross-host.py
Standard: agentskills Standard v1.0 (Phase 4 Final Distribution)
Compiles canonical .github/skills//SKILL.md into:
1. Native Cursor Rules (.cursor/rules/.mdc)
2. Native Claude Code Architecture Guide (CLAUDE.md)
Ensures zero configuration drift across all developer IDEs.
"""
import sys
import os
import re
from pathlib import Path

# // [TODAY'S LESSON PLUGS IN HERE: MULTI-HOST TRANSPILATION & PACKAGING]
def parse_canonical_skill(skill_file: Path) -> dict:
    """Parses Frontmatter and Markdown instruction body from canonical SKILL.md."""
    raw = skill_file.read_text(encoding="utf-8")
    fm_match = re.search(r"^---\s*([\s\S]*?)\s*---([\s\S]*)$", raw)
    if not fm_match:
        raise ValueError(f"Malformed SKILL.md in {skill_file}: No valid YAML frontmatter delimiters.")
    
    fm_raw = fm_match.group(1)
    body = fm_match.group(2).strip()

    name_m = re.search(r"^name:\s*(.+)$", fm_raw, re.MULTILINE)
    desc_m = re.search(r"description:\s*>?-?\s*([\s\S]*?)(?=\n[a-zA-Z0-9_-]+:|$)", fm_raw)

    return {
        "name": name_m.group(1).strip() if name_m else skill_file.parent.name,
        "description": " ".join(desc_m.group(1).split()) if desc_m else "",
        "body": body,
        "skill_dir": skill_file.parent
    }

def generate_cursor_rule(skill_data: dict, out_dir: Path) -> Path:
    """
    Generates native Cursor MDC Rule with optimized globs and alwaysApply: false
    to prevent context flooding while preserving exact architectural invariants.
    """
    out_dir.mkdir(parents=True, exist_ok=True)
    target_file = out_dir / f"{skill_data['name']}.mdc"

    cursor_content = f"""---
description: {skill_data['description']}
globs: ["src/test/kotlin/**/*Test.kt", "src/test/java/**/*Test.java"]
alwaysApply: false
---




{skill_data['body']}
"""
    target_file.write_text(cursor_content, encoding="utf-8")
    return target_file

def update_claude_code_manifest(skill_data: dict, repo_root: Path) -> Path:
    """
    Injects or updates modular skill block inside project-level CLAUDE.md.
    Maintains clean boundaries using sentinel comment tags.
    """
    claude_file = repo_root / "CLAUDE.md"
    start_tag = f""
    end_tag = f""

    block = f"""{start_tag}
## 🤖 Skill Integration: {skill_data['name']}
> {skill_data['description']}

### Verification Command:
`bash .github/skills/{skill_data['name']}/scripts/run-unit-tests.sh `

### Invariants:
- Pure isolated JVM memory execution (MockK + AssertJ).
- NEVER boot @SpringBootTest or Testcontainers for pure unit tests.
{end_tag}"""

    if claude_file.exists():
        content = claude_file.read_text(encoding="utf-8")
        pattern = re.compile(rf"{re.escape(start_tag)}[\s\S]*?{re.escape(end_tag)}")
        if pattern.search(content):
            new_content = pattern.sub(block, content)
        else:
            new_content = content.rstrip() + f"\n\n{block}\n"
    else:
        new_content = f"# Project Architecture & Claude Code Instructions\n\n{block}\n"

    claude_file.write_text(new_content, encoding="utf-8")
    return claude_file

def main():
    root = Path(__file__).resolve().parent.parent
    canonical_skill = root / ".github" / "skills" / "spring-boot-unit-tester" / "SKILL.md"

    if not canonical_skill.exists():
        sys.stderr.write(f"Error: Canonical skill file not found at: {canonical_skill}\n")
        sys.exit(1)

    print("================================================================================")
    print("📦 UNIVERSAL AGENT SKILL CROSS-HOST PACKAGING (Day 12)")
    print("================================================================================")
    print(f"Reading Canonical Spec: {canonical_skill}")
    skill_data = parse_canonical_skill(canonical_skill)

    # 1. Transpile to Cursor Rules
    cursor_file = generate_cursor_rule(skill_data, root / ".cursor" / "rules")
    print(f"✅ Generated Cursor Native Rule: {cursor_file.relative_to(root)}")

    # 2. Update Claude Code Manifest
    claude_file = update_claude_code_manifest(skill_data, root)
    print(f"✅ Synchronized Claude Code Guide: {claude_file.relative_to(root)}")

    print("--------------------------------------------------------------------------------")
    print("🏆 SUCCESS: Single-Source-of-Truth published to Copilot, Cursor & Claude Code!")
    sys.exit(0)

if __name__ == "__main__":
    main()
          

---
description: Generates and refactors isolated JVM unit tests for Kotlin and Spring Boot 3.x using JUnit 5, MockK, AssertJ, and Coroutines Test.
globs: ["src/test/kotlin/**/*Test.kt", "src/test/java/**/*Test.java"]
alwaysApply: false
---




# Spring Boot Unit Test Architect Specification

## 1. Architectural Invariants (RFC 2119 Mandates)
- **MUST NOT** import `org.mockito.*` or `org.springframework.boot.test.mock.mockito.*`.
- **MUST NOT** annotate test classes with `@SpringBootTest`, `@DataJpaTest`, or `@WebMvcTest`.
- **MUST** execute strictly in-memory (< 50ms per method) without Spring ApplicationContext.
- **MUST** wrap all `suspend` methods inside `kotlinx.coroutines.test.runTest` using `coEvery`.