"""On-disk layout under ``Settings.repo_workspace`` (REPO_WORKSPACE).

* **Checkout** — ``<root>/<workspace_id>/<project_id>``: git clone; may sync to a customer-owned remote.
* **Project meta** — ``<root>/<workspace_id>/project_meta/<project_id>``: P2HS-only (instructions mirror,
  AI rule sources, Cursor agent state). Not part of the pushed repo tree.
"""
from __future__ import annotations
import os
from uuid import UUID

PROJECT_META_SEGMENT = "project_meta"


def get_project_repo_path(repo_workspace_root: str, workspace_id: UUID, project_id: UUID) -> str:
    """Tenant-scoped checkout: ``<ROOT>/<workspace_id>/<project_id>``."""
    base = repo_workspace_root.rstrip("/\\")
    return os.path.join(base, str(workspace_id), str(project_id))


def get_project_meta_path(repo_workspace_root: str, workspace_id: UUID, project_id: UUID) -> str:
    """P2HS meta root: ``<ROOT>/<workspace_id>/project_meta/<project_id>``."""
    base = repo_workspace_root.rstrip("/\\")
    return os.path.join(base, str(workspace_id), PROJECT_META_SEGMENT, str(project_id))