# CODEOWNERS for matra: the paths where a change should reach the owner.
#
# What this file does today: GitHub asks the listed owner to review a pull
# request that touches a matching path. It enforces nothing. Branch
# protection on main does not require code-owner review, and Claude's pull
# requests are opened under the owner's own login, so on those GitHub does
# not even request the review: an author is never asked to review their own
# pull request. The owner's decisions are held by practice for now
# (CONTRIBUTING.md, How decisions are made).
#
# Enforcement waits on Claude's own GitHub identity, a GitHub App
# (CONTRIBUTING.md, Identity). Once Claude opens pull requests as the App,
# acceptance is held by a required check: a pull request that changes a
# proposal's status line to `accepted` cannot merge without the owner's
# approval (CONTRIBUTING.md, Identity). A path rule on blueprints/proposals/
# would hold too much, since a `proposed` proposal merges without the owner.
# This file then shrinks to what should still reach the owner; the list below
# would otherwise hold almost every pull request.
#
# Pattern syntax follows GitHub's CODEOWNERS spec.

# Public manifest and version pins — every change here ripples through
# crates.io, PyPI, and the supply chain.
/Cargo.toml          @yzavyas
/Cargo.lock          @yzavyas
/pyproject.toml      @yzavyas

# Docsite structure: SUMMARY.md is the navigation tree; vite.config.ts owns
# the build and the base path; the tag registry decides what raw HTML a page
# may carry; urls.txt and anchors.txt are the published URL contract. Drift
# here is silent and high-impact.
/site/content/SUMMARY.md                     @yzavyas
/site/vite.config.ts                         @yzavyas
/site/src/lib/server/markdown/registry.ts    @yzavyas
/site/urls.txt                               @yzavyas
/site/anchors.txt                            @yzavyas

# CI workflows — change to triggers, permissions, or pinned action SHAs
# affects every subsequent PR.
/.github/workflows/        @yzavyas

# Release machinery — irreversible operations live here. Publishing
# needs a human approval per release, enforced by the `crates-io` and
# `pypi` environments that .github/workflows/release.yml deploys to (each
# requires a reviewer; see the prerequisites at the top of that file), so
# every change to release.yml, changelog-release.sh, the release recipe
# in the justfile, or the supply-chain config gets explicit review.
/justfile                              @yzavyas
/scripts/changelog-release.sh          @yzavyas
/scripts/check-boundaries.sh           @yzavyas
/.semgrep/                             @yzavyas
/.semgrepignore                        @yzavyas
/.github/requirements/                 @yzavyas
/scripts/check-docsite-floor.sh        @yzavyas
/scripts/install-hooks.sh              @yzavyas
/scripts/pre-commit-hook.sh            @yzavyas
/deny.toml                             @yzavyas

# Design records — proposals and plans are the durable record. Anything in
# blueprints/ should be reviewed for template compliance, for the index
# in blueprints/README.md, and for supersede chain integrity. blueprints/legacy/ is never edited.
/blueprints/             @yzavyas

# Hex boundary critical files — any change to domain.rs, the port
# modules, or the composition root ripples through every adapter and
# every consumer. The boundary-check script catches violations
# mechanically; CODEOWNERS adds human review on top.
/src/domain.rs           @yzavyas
/src/lib.rs              @yzavyas
/src/source/mod.rs       @yzavyas
/src/decompose/mod.rs    @yzavyas
/src/nlp/mod.rs          @yzavyas
/src/embed/mod.rs        @yzavyas

# The constitution. CLAUDE.md is loaded as agent context; CONTRIBUTING.md
# is the human contributor's first stop; the maintenance page explains the
# arrangement to an outside reader. None should drift without review.
/CLAUDE.md                                               @yzavyas
/CONTRIBUTING.md                                         @yzavyas
/site/content/explanation/how-matra-is-maintained.md     @yzavyas
/README.md                       @yzavyas
/CHANGELOG.md                    @yzavyas
