#!/usr/bin/env python3
"""Build a hook-free portable plugin ZIP from the same eighteen canonical skills.

The ZIP, and only the ZIP, declares the optional remote MCP server: OpenAI's plugin
directory does not accept skills-only submissions. The repository root is also the
Git marketplace plugin root, so a root .mcp.json would connect every marketplace
install to the remote server; the file is therefore written into the archive here.
"""
import argparse
import json
from pathlib import Path
import zipfile

ROOT = Path(__file__).resolve().parents[1]
DIRECTORIES = ("skills", "scripts", "adapters", "docs", "assets")
ROOT_FILES = ("plugin.json", "README.md", "LICENSE", "SECURITY.md", "package.json")
EXCLUDED = {"__pycache__", ".DS_Store", "node_modules"}
ARCHIVES = {".zip", ".tgz", ".tar", ".gz"}
# Exact shape required by OpenAI for Codex packages: one remote server, url only.
MCP_CONFIG = {"mcpServers": {"nobrainer-tech-flow": {"url": "https://mcp.nobrainer.tech/mcp"}}}
# The root plugin.json makes the ZIP a portable (Agent Plugins) package, and OpenAI then
# ignores .codex-plugin/plugin.json; portable packages discover this root mcp.json.
PORTABLE_MCP_CONFIG = {
    "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
    "mcpServers": {"nobrainer-tech-flow": {"type": "streamable-http", "url": "https://mcp.nobrainer.tech/mcp"}},
}
# Fixed entry metadata keeps the ZIP byte-identical across builds of the same source.
FIXED_TIME = (1980, 1, 1, 0, 0, 0)


def entry(name: str, executable: bool = False) -> zipfile.ZipInfo:
    info = zipfile.ZipInfo(name, FIXED_TIME)
    info.compress_type = zipfile.ZIP_DEFLATED
    info.create_system = 3
    info.external_attr = (0o100755 if executable else 0o100644) << 16
    return info


def build(output: Path) -> None:
    version = json.loads((ROOT / "plugin.json").read_text())["version"]
    files = []
    for directory in DIRECTORIES:
        for path in sorted((ROOT / directory).rglob("*")):
            if path.is_symlink():
                raise ValueError("plugin source must not contain symlinks: " + str(path))
            if path.is_file() and not set(path.parts) & EXCLUDED and path.suffix not in ARCHIVES | {".pyc"}:
                if directory == "docs" and path.parent not in (ROOT / "docs", ROOT / "docs/releases"):
                    continue
                if directory == "assets" and path.suffix not in (".svg", ".png"):
                    continue
                files.append(path)
    files.extend(ROOT / name for name in ROOT_FILES)
    skills = list((ROOT / "skills").glob("*/SKILL.md"))
    if len(skills) != 18:
        raise ValueError("plugin requires the exact eighteen-module portfolio")
    output.parent.mkdir(parents=True, exist_ok=True)
    if output.exists() or output.is_symlink():
        raise ValueError("output already exists; choose a fresh path")
    with zipfile.ZipFile(output, "x", compression=zipfile.ZIP_DEFLATED) as archive:
        for path in files:
            archive.writestr(entry(path.relative_to(ROOT).as_posix(), bool(path.stat().st_mode & 0o111)), path.read_bytes())
        archive.writestr(entry(".mcp.json"), json.dumps(MCP_CONFIG, indent=2) + "\n")
        archive.writestr(entry("mcp.json"), json.dumps(PORTABLE_MCP_CONFIG, indent=2) + "\n")
        overlay = json.loads((ROOT / ".codex-plugin/plugin.json").read_text())
        overlay["mcpServers"] = "./.mcp.json"
        archive.writestr(entry(".codex-plugin/plugin.json"), json.dumps(overlay, indent=2) + "\n")
        claude = json.loads((ROOT / ".claude-plugin/plugin.json").read_text())
        claude.pop("hooks", None)
        archive.writestr(entry(".claude-plugin/plugin.json"), json.dumps(claude, indent=2) + "\n")
    print(f"PLUGIN_READY: {output.name}; version={version}; skills=18; hooks=none; mcpServers=1; bytes={output.stat().st_size}")


if __name__ == "__main__":
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("--output", type=Path, required=True)
    args = parser.parse_args()
    build(args.output)