"""Meta-repo entry file shape per §2.1.

One markdown file per RFC under rfcs/<slug>.md, frontmatter on top, body
below. The frontmatter carries the canonical RFC state — id, repo,
owners, arbiters, graduation timestamps — and the body holds the pitch
(for super-drafts) or is empty (for graduated entries per §13.3 step 3).

This module contains the parser, the serializer, and a small validator
for the frontmatter shape. The parser is intentionally lenient about
unknown keys — future fields land in frontmatter without breaking older
readers.
"""
from __future__ import annotations

import re
from dataclasses import dataclass, field
from datetime import date
from typing import Any

import yaml

FRONTMATTER_RE = re.compile(r"^---\n(.*?)\n---\n?(.*)$", re.DOTALL)

SLUG_RE = re.compile(r"^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$")


@dataclass
class Entry:
    slug: str
    title: str
    state: str = "super-draft"  # super-draft | active | withdrawn
    id: str | None = None       # 'RFC-NNNN' or None
    repo: str | None = None
    proposed_by: str = ""
    proposed_at: str = ""        # ISO date
    graduated_at: str | None = None
    graduated_by: str | None = None
    owners: list[str] = field(default_factory=list)
    arbiters: list[str] = field(default_factory=list)
    tags: list[str] = field(default_factory=list)
    body: str = ""


def parse(text: str) -> Entry:
    match = FRONTMATTER_RE.match(text)
    if not match:
        raise ValueError("Entry file missing frontmatter")
    fm = yaml.safe_load(match.group(1)) or {}
    body = match.group(2).lstrip("\n")
    return Entry(
        slug=str(fm.get("slug") or ""),
        title=str(fm.get("title") or ""),
        state=str(fm.get("state") or "super-draft"),
        id=fm.get("id") or None,
        repo=fm.get("repo") or None,
        proposed_by=str(fm.get("proposed_by") or ""),
        proposed_at=str(fm.get("proposed_at") or ""),
        graduated_at=fm.get("graduated_at"),
        graduated_by=fm.get("graduated_by"),
        owners=list(fm.get("owners") or []),
        arbiters=list(fm.get("arbiters") or []),
        tags=list(fm.get("tags") or []),
        body=body,
    )


def serialize(entry: Entry) -> str:
    """Emit canonical entry file text — frontmatter then body."""
    fm: dict[str, Any] = {
        "slug": entry.slug,
        "title": entry.title,
        "state": entry.state,
        "id": entry.id,
        "repo": entry.repo,
        "proposed_by": entry.proposed_by,
        "proposed_at": entry.proposed_at,
        "graduated_at": entry.graduated_at,
        "graduated_by": entry.graduated_by,
        "owners": entry.owners,
        "arbiters": entry.arbiters,
        "tags": entry.tags,
    }
    yaml_text = yaml.safe_dump(fm, sort_keys=False, default_flow_style=False).rstrip()
    body = entry.body.lstrip("\n")
    if body:
        return f"---\n{yaml_text}\n---\n\n{body}\n"
    return f"---\n{yaml_text}\n---\n"


def slugify(title: str) -> str:
    """Deterministic kebab-case per §9.1."""
    s = title.lower().strip()
    s = re.sub(r"[^a-z0-9]+", "-", s)
    return s.strip("-")


def today() -> str:
    return date.today().isoformat()


def is_valid_slug(slug: str) -> bool:
    return bool(SLUG_RE.match(slug)) and len(slug) <= 80