import uuid from datetime import datetime, timezone from typing import Optional, TYPE_CHECKING from sqlalchemy import String, Text, DateTime, ForeignKey, Boolean, Integer, Enum as SAEnum, text from sqlalchemy.orm import Mapped, mapped_column, relationship from sqlalchemy.dialects.postgresql import UUID, JSONB from app.core.database import Base if TYPE_CHECKING: from app.models.user import User from app.models.team import Team from app.models.session import Session class ScriptCategory(Base): __tablename__ = "script_categories" id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) name: Mapped[str] = mapped_column(String(100), nullable=False) slug: Mapped[str] = mapped_column(String(100), nullable=False, unique=True, index=True) description: Mapped[Optional[str]] = mapped_column(Text, nullable=True) icon: Mapped[Optional[str]] = mapped_column(String(50), nullable=True) sort_order: Mapped[int] = mapped_column(Integer, nullable=False, default=0) is_active: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True) created_at: Mapped[datetime] = mapped_column( DateTime(timezone=True), default=lambda: datetime.now(timezone.utc) ) updated_at: Mapped[datetime] = mapped_column( DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc), ) templates: Mapped[list["ScriptTemplate"]] = relationship("ScriptTemplate", back_populates="category") class ScriptTemplate(Base): __tablename__ = "script_templates" id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) category_id: Mapped[uuid.UUID] = mapped_column( UUID(as_uuid=True), ForeignKey("script_categories.id", ondelete="RESTRICT"), nullable=False, index=True ) team_id: Mapped[Optional[uuid.UUID]] = mapped_column( UUID(as_uuid=True), ForeignKey("teams.id", ondelete="CASCADE"), nullable=True, index=True ) account_id: Mapped[uuid.UUID] = mapped_column( UUID(as_uuid=True), ForeignKey("accounts.id", ondelete="CASCADE"), nullable=False, index=True, ) created_by: Mapped[Optional[uuid.UUID]] = mapped_column( UUID(as_uuid=True), ForeignKey("users.id", ondelete="SET NULL"), nullable=True ) name: Mapped[str] = mapped_column(String(200), nullable=False) slug: Mapped[str] = mapped_column(String(200), nullable=False, unique=True, index=True) description: Mapped[Optional[str]] = mapped_column(Text, nullable=True) use_case: Mapped[Optional[str]] = mapped_column(Text, nullable=True) script_body: Mapped[str] = mapped_column(Text, nullable=False) language: Mapped[Optional[str]] = mapped_column( String(30), nullable=True, default="powershell", comment="Script language: powershell, bash, python", ) parameters_schema: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict, server_default=text("'{}'::jsonb")) default_values: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict, server_default=text("'{}'::jsonb")) validation_rules: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict, server_default=text("'{}'::jsonb")) tags: Mapped[list] = mapped_column(JSONB, nullable=False, default=list, server_default=text("'[]'::jsonb")) complexity: Mapped[str] = mapped_column( SAEnum("beginner", "intermediate", "advanced", name="script_complexity"), nullable=False, default="beginner" ) estimated_runtime: Mapped[Optional[str]] = mapped_column(String(50), nullable=True) requires_elevation: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False, server_default=text("false")) requires_modules: Mapped[list] = mapped_column(JSONB, nullable=False, default=list, server_default=text("'[]'::jsonb")) version: Mapped[int] = mapped_column(Integer, nullable=False, default=1, server_default=text("1")) is_verified: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False, server_default=text("false")) is_active: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True, server_default=text("true")) is_gallery_featured: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False, server_default=text("false"), index=True) gallery_sort_order: Mapped[int] = mapped_column(Integer, nullable=False, default=0, server_default=text("0")) usage_count: Mapped[int] = mapped_column(Integer, nullable=False, default=0, server_default=text("0")) # ── Provenance (Phase 1 — FlowPilot migration) ── # Populated when a template is promoted from a post-resolve draft_templates row. # Powers the Script Library provenance chip: # "generated from CW #X · resolved by Y · used N times" source_session_id: Mapped[Optional[uuid.UUID]] = mapped_column( UUID(as_uuid=True), ForeignKey("ai_sessions.id"), nullable=True, ) source_user_id: Mapped[Optional[uuid.UUID]] = mapped_column( UUID(as_uuid=True), ForeignKey("users.id"), nullable=True, ) source_ticket_ref: Mapped[Optional[str]] = mapped_column( String(64), nullable=True, comment="Human-readable PSA ticket ref for display, e.g. 'CW #48307'", ) created_at: Mapped[datetime] = mapped_column( DateTime(timezone=True), default=lambda: datetime.now(timezone.utc) ) updated_at: Mapped[datetime] = mapped_column( DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc), ) category: Mapped["ScriptCategory"] = relationship("ScriptCategory", back_populates="templates") team: Mapped[Optional["Team"]] = relationship("Team") creator: Mapped[Optional["User"]] = relationship("User", foreign_keys=[created_by]) generations: Mapped[list["ScriptGeneration"]] = relationship("ScriptGeneration", back_populates="template") class ScriptGeneration(Base): __tablename__ = "script_generations" id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) template_id: Mapped[uuid.UUID] = mapped_column( UUID(as_uuid=True), ForeignKey("script_templates.id", ondelete="RESTRICT"), nullable=False, index=True ) user_id: Mapped[uuid.UUID] = mapped_column( UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), nullable=False, index=True ) account_id: Mapped[uuid.UUID] = mapped_column( UUID(as_uuid=True), ForeignKey("accounts.id", ondelete="CASCADE"), nullable=False, index=True, ) team_id: Mapped[Optional[uuid.UUID]] = mapped_column( UUID(as_uuid=True), ForeignKey("teams.id", ondelete="SET NULL"), nullable=True, index=True ) session_id: Mapped[Optional[uuid.UUID]] = mapped_column( UUID(as_uuid=True), ForeignKey("sessions.id", ondelete="SET NULL"), nullable=True, index=True ) ai_session_id: Mapped[Optional[uuid.UUID]] = mapped_column( UUID(as_uuid=True), ForeignKey("ai_sessions.id", ondelete="SET NULL"), nullable=True, index=True, comment="FlowPilot AI session that triggered this generation", ) parameters_used: Mapped[dict] = mapped_column(JSONB, nullable=False, default=dict) generated_script: Mapped[str] = mapped_column(Text, nullable=False) created_at: Mapped[datetime] = mapped_column( DateTime(timezone=True), default=lambda: datetime.now(timezone.utc) ) template: Mapped["ScriptTemplate"] = relationship("ScriptTemplate", back_populates="generations") user: Mapped["User"] = relationship("User")