.gitattributes

# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
#
#   http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.

# Files excluded from the source release artefact.
# `git archive` (used by release-rc-cut / release-build.md to build
# apache-magpie-<version>-source.zip) honours `export-ignore`, so the
# paths below are kept out of the signed source .zip that the [VOTE]
# votes on. Keep this list to VCS/CI/editor metadata — never source.
#
# IMPORTANT — symlinks in the archive. The committed agent-view dirs are
# regenerable adoption wiring, not source. `.agents/skills/*` are the
# canonical view (single-hop symlinks straight to the real `skills/*`),
# and the relay dirs `.claude/skills/`, `.github/skills/`, `.kiro/skills/`
# just chain through `.agents/skills/*`. A safe extractor (ATR's upload
# validator) rejects a symlink whose target is itself a symlink (the
# relay chain reads as a target "outside" the entry) — so the relay dirs
# are export-ignored here, leaving only the single-hop `.agents/skills/*`
# links (which resolve to real `skills/*` dirs). Shipped files that used
# to link the relay view (`projects/_template/*.md`) point at
# `.agents/skills/*` instead. Keep `.agents/` in the release: dropping it
# too would strip the one resolvable view and orphan those links.
#
# `.github/ISSUE_TEMPLATE/` and `.github/PULL_REQUEST_TEMPLATE.md` are
# linked by skills, so only the true CI/dev entries under `.github/` are
# stripped. The `.gitignore` files ship as development-environment config
# — the repo-root one (useful for a from-source dev checkout) and the
# nested examples (e.g. `projects/_template/.gitignore`) alike.
# `release-verify-rc` re-checks the unpacked tarball (symlink-lint +
# validators + no-.pyc) so a regression here fails the RC before the [VOTE].

# Root-only VCS / dev-tool metadata. Anchored with a leading `/` so an
# identically-named file deeper in the tree is unaffected. The repo-root
# `.gitignore` is intentionally NOT listed here — it ships as
# development-environment config (see the note above).
/.gitattributes                    export-ignore
/.pre-commit-config.yaml           export-ignore
/.lychee.toml                      export-ignore
/.lycheecache                      export-ignore
/.markdownlint.json                export-ignore
/.typos.toml                       export-ignore
/.zizmor.yml                       export-ignore
/.apache-magpie.session-state.json export-ignore

# Editor metadata.
.idea/              export-ignore

# Regenerable agent-view relay symlink dirs — chains through `.agents/`
# that a safe extractor rejects. `.agents/skills/*` (single-hop → real
# `skills/*`) is kept; these relays are not.
.claude/skills/     export-ignore
.github/skills/     export-ignore
.kiro/skills/       export-ignore

# CI / bot config only. The rest of `.github/` (ISSUE_TEMPLATE,
# PULL_REQUEST_TEMPLATE.md) is referenced by shipped skills, so it stays.
.github/workflows/  export-ignore
.github/dependabot.yml export-ignore