# BlackRoad OS Code Owners — Phase Q Edition
# This file defines module-based ownership with automation awareness.
# Each line is a file pattern followed by one or more owners.
#
# Related docs: MERGE_QUEUE_PLAN.md, AUTO_MERGE_POLICY.md, GITHUB_AUTOMATION_RULES.md

# ==============================================================================
# GLOBAL OWNERSHIP
# ==============================================================================

# Default owner for all files (fallback)
* @alexa-amundson

# ==============================================================================
# BACKEND (High Scrutiny)
# ==============================================================================

# Core backend application
/backend/ @alexa-amundson @backend-team
/backend/app/ @alexa-amundson @backend-team

# Backend modules (fine-grained ownership)
/backend/app/routers/ @backend-team @alexa-amundson
/backend/app/models/ @backend-team @data-team @alexa-amundson
/backend/app/services/ @backend-team @alexa-amundson
/backend/app/utils/ @backend-team

# Backend configuration (high scrutiny)
/backend/requirements.txt @alexa-amundson @backend-team
/backend/Dockerfile @alexa-amundson @infra-team
/backend/docker-compose.yml @alexa-amundson @infra-team
/backend/.env.example @alexa-amundson

# Backend tests (low scrutiny, can auto-approve)
/backend/tests/ @backend-team @test-bot

# ==============================================================================
# FRONTEND / OS (Medium Scrutiny)
# ==============================================================================

# Main OS interface (canonical frontend)
/backend/static/ @alexa-amundson @frontend-team
/backend/static/js/ @frontend-team
/backend/static/index.html @alexa-amundson @frontend-team

# Legacy OS interface (being deprecated)
/blackroad-os/ @alexa-amundson @frontend-team

# ==============================================================================
# AGENTS & AUTOMATION (AI-Aware)
# ==============================================================================

# Agent framework
/agents/ @alexa-amundson @agent-team
/agents/base/ @alexa-amundson @agent-team
/agents/categories/ @agent-team

# Agent tests (can auto-approve)
/agents/tests/ @agent-team @test-bot

# ==============================================================================
# INFRASTRUCTURE (Highest Scrutiny — Never Auto-Merge)
# ==============================================================================

# GitHub workflows (manual review required)
/.github/ @alexa-amundson
/.github/workflows/ @alexa-amundson @infra-team
/.github/CODEOWNERS @alexa-amundson

# Infrastructure as code
/infra/ @alexa-amundson @infra-team
/ops/ @alexa-amundson @ops-team @infra-team

# Deployment configuration
railway.toml @alexa-amundson @infra-team
railway.json @alexa-amundson @infra-team
docker-compose.yml @alexa-amundson @infra-team

# CI/CD scripts
/scripts/ @alexa-amundson @ops-team
/scripts/railway/ @alexa-amundson @infra-team

# ==============================================================================
# DOCUMENTATION (Lowest Scrutiny — Can Auto-Merge)
# ==============================================================================

# General documentation (auto-merge eligible)
/docs/ @docs-team
/docs/architecture/ @alexa-amundson @docs-team

# Root-level docs (auto-merge eligible)
/*.md @docs-team
/README.md @alexa-amundson @docs-team

# Security documentation (manual review required)
/SECURITY.md @alexa-amundson

# Phase Q documentation (automation policies)
/MERGE_QUEUE_PLAN.md @alexa-amundson
/AUTO_MERGE_POLICY.md @alexa-amundson
/GITHUB_AUTOMATION_RULES.md @alexa-amundson
/WORKFLOW_BUCKETING_EXPLAINED.md @alexa-amundson
/OPERATOR_PR_EVENT_HANDLERS.md @alexa-amundson

# ==============================================================================
# SDKs (Medium Scrutiny)
# ==============================================================================

# Python SDK
/sdk/python/ @alexa-amundson @sdk-team
/sdk/python/tests/ @sdk-team @test-bot

# TypeScript SDK
/sdk/typescript/ @alexa-amundson @sdk-team
/sdk/typescript/tests/ @sdk-team @test-bot

# ==============================================================================
# OPERATOR & PRISM (Automation Engine)
# ==============================================================================

# GitHub event handlers (critical automation logic)
/backend/app/services/github_events.py @alexa-amundson @operator-team
/backend/app/routers/webhooks.py @alexa-amundson @operator-team

# Prism Console (merge dashboard)
/blackroad-os/js/apps/prism.js @alexa-amundson @prism-team
/blackroad-os/js/apps/prism-merge-dashboard.js @alexa-amundson @prism-team

# ==============================================================================
# RESEARCH & COGNITIVE (Low Scrutiny)
# ==============================================================================

/cognitive/ @alexa-amundson @research-team
/blackroad-universe/ @alexa-amundson @brand-team
/blackroad-universe/prompts/ @alexa-amundson @prompt-team

# ==============================================================================
# STANDARD OPERATING PROCEDURES
# ==============================================================================

/sop/ @alexa-amundson @ops-team

# ==============================================================================
# IMPLEMENTATION PLANS
# ==============================================================================

/implementation-plans/ @alexa-amundson

# ==============================================================================
# TEAM ALIASES (for reference — not enforced by GitHub unless org teams exist)
# ==============================================================================
#
# @alexa-amundson     — Primary operator, final authority on all changes
# @backend-team       — Backend engineers (alias for automation)
# @frontend-team      — Frontend engineers (alias for automation)
# @agent-team         — AI agent developers (alias for automation)
# @infra-team         — Infrastructure engineers (alias for automation)
# @ops-team           — Operations team (alias for automation)
# @sdk-team           — SDK developers (alias for automation)
# @docs-team          — Documentation writers (alias for automation)
# @prism-team         — Prism Console developers (alias for automation)
# @operator-team      — Operator Engine developers (alias for automation)
# @research-team      — Research team (alias for automation)
# @brand-team         — Brand and marketing (alias for automation)
# @prompt-team        — Prompt engineers (alias for automation)
# @test-bot           — Auto-approval bot for test-only PRs
# @docs-bot           — Auto-approval bot for docs-only PRs
#
# NOTE: Some team aliases may not be real GitHub teams. They serve as semantic
# indicators for ownership and automation rules. Auto-approval bots are
# implemented via GitHub Actions, not actual bot accounts.
#
# ==============================================================================
# BlackRoad OS Code Owners
#
# This file defines who is responsible for code in this repository.
# Each line is a file pattern followed by one or more owners.
#
# Ownership hierarchy:
# 1. Human maintainers (primary approval authority)
# 2. AI automation teams (can auto-approve safe changes)
# 3. Specialized reviewers (domain experts)
#
# AI teams are GitHub teams that can auto-merge specific types of PRs:
# - @blackboxprogramming/claude-auto - Claude AI automated changes
# - @blackboxprogramming/atlas-auto - Atlas AI automated changes
# - @blackboxprogramming/docs-auto - Documentation-only changes
# - @blackboxprogramming/test-auto - Test-only changes

# ============================================================================
# GLOBAL OWNERSHIP
# ============================================================================

# All files require approval from primary maintainer
* @alexa-amundson

# ============================================================================
# BACKEND & API
# ============================================================================

# FastAPI Backend
/backend/ @alexa-amundson
/backend/app/ @alexa-amundson
/backend/requirements.txt @alexa-amundson
/backend/Dockerfile @alexa-amundson

# Backend tests can be auto-merged by AI
/backend/tests/ @alexa-amundson @blackboxprogramming/test-auto
/backend/pytest.ini @alexa-amundson @blackboxprogramming/test-auto

# ============================================================================
# FRONTEND & OS
# ============================================================================

# OS Interface (canonical)
/backend/static/ @alexa-amundson

# Legacy standalone UI (deprecated, needs migration)
/blackroad-os/ @alexa-amundson

# ============================================================================
# OPERATOR ENGINE & AUTOMATION
# ============================================================================

# Operator Engine (PR automation, merge queue)
/operator_engine/ @alexa-amundson
/operator_engine/**/*.py @alexa-amundson

# Prism Console (merge dashboard)
/prism-console/ @alexa-amundson

# ============================================================================
# INFRASTRUCTURE & DEVOPS
# ============================================================================

# GitHub Actions & Workflows (critical - no auto-merge)
/.github/workflows/ @alexa-amundson

# GitHub Configuration
/.github/ @alexa-amundson
/.github/CODEOWNERS @alexa-amundson
/.github/dependabot.yml @alexa-amundson @blackboxprogramming/claude-auto
/.github/labeler.yml @alexa-amundson @blackboxprogramming/claude-auto
/.github/merge_queue.yml @alexa-amundson

# Infrastructure scripts
/scripts/ @alexa-amundson
/ops/ @alexa-amundson
/infra/ @alexa-amundson

# Railway deployment (critical - no auto-merge)
railway.toml @alexa-amundson
railway.json @alexa-amundson

# Docker
docker-compose.yml @alexa-amundson
/backend/docker-compose.yml @alexa-amundson

# ============================================================================
# DOCUMENTATION
# ============================================================================

# Core documentation (safe for auto-merge)
/docs/ @alexa-amundson @blackboxprogramming/docs-auto
/README.md @alexa-amundson @blackboxprogramming/docs-auto
/*.md @alexa-amundson @blackboxprogramming/docs-auto

# Implementation plans (AI-generated, can auto-merge)
/implementation-plans/ @alexa-amundson @blackboxprogramming/claude-auto

# ============================================================================
# SDKs
# ============================================================================

# Python SDK
/sdk/python/ @alexa-amundson
/sdk/python/tests/ @alexa-amundson @blackboxprogramming/test-auto

# TypeScript SDK
/sdk/typescript/ @alexa-amundson
/sdk/typescript/tests/ @alexa-amundson @blackboxprogramming/test-auto

# ============================================================================
# AGENTS & AI
# ============================================================================

# AI Agents (can be auto-merged by Claude)
/agents/ @alexa-amundson @blackboxprogramming/claude-auto
/agents/tests/ @alexa-amundson @blackboxprogramming/test-auto

# Prompts & Templates
/blackroad-universe/prompts/ @alexa-amundson @blackboxprogramming/claude-auto

# Cognitive Research
/cognitive/ @alexa-amundson

# ============================================================================
# BRANDING & BUSINESS
# ============================================================================

# BlackRoad Universe (brand, GTM, domains)
/blackroad-universe/ @alexa-amundson

# SOP (Standard Operating Procedures)
/sop/ @alexa-amundson @blackboxprogramming/docs-auto

# ============================================================================
# SPECIAL FILES
# ============================================================================

# Security-sensitive files (no auto-merge ever)
.env.example @alexa-amundson
backend/.env.example @alexa-amundson
SECURITY.md @alexa-amundson

# License
LICENSE @alexa-amundson

# Git configuration
.gitignore @alexa-amundson @blackboxprogramming/claude-auto