From 72b1c41a85775fa120a5644c0a41423f109fc8f9 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Wed, 15 Jul 2026 12:45:57 +0200
Subject: [PATCH] Wire threat model for agent discoverability + rename to
 THREAT_MODEL.md

Adds AGENTS.md (## Security pointer) + SECURITY.md wiring the
conventional AGENTS.md -> SECURITY.md -> THREAT_MODEL.md chain, and
renames the PMC-merged draft-THREAT-MODEL.md to the canonical
THREAT_MODEL.md (no longer a draft; matches the discoverable
convention). No model content changes.

Generated-by: Claude Code (Claude Opus 4.8)
---
 AGENTS.md                                | 13 +++++++++
 SECURITY.md                              | 34 ++++++++++++++++++++++++
 draft-THREAT-MODEL.md => THREAT_MODEL.md |  0
 3 files changed, 47 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 SECURITY.md
 rename draft-THREAT-MODEL.md => THREAT_MODEL.md (100%)

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000000..ea0f93f6d9b
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+# Agent guidance
+
+This file is read by automated agents (security scanners, code
+analyzers, AI assistants) operating on this repository. It points
+them at the human-authored references they should consult before
+producing output.
+
+## Security
+
+Security model: [SECURITY.md](./SECURITY.md)
+
+Agents that scan this repository should consult `SECURITY.md` and the
+threat model it links before reporting issues.
diff --git a/SECURITY.md b/SECURITY.md
new file mode 100644
index 00000000000..f249256a0e7
--- /dev/null
+++ b/SECURITY.md
@@ -0,0 +1,34 @@
+<!--
+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.
+-->
+
+# Security Policy
+
+## Reporting a Vulnerability
+
+Apache Jackrabbit follows the [Apache Software Foundation security
+process](https://www.apache.org/security/). Please report suspected
+vulnerabilities privately to `security@apache.org` (the Jackrabbit PMC
+is reachable via `private@jackrabbit.apache.org`). Do not open public
+GitHub issues or pull requests for security reports.
+
+## Threat Model
+
+What the project treats as in scope and out of scope, the security
+properties it provides and disclaims, the adversary model, and how
+findings are triaged are documented in [THREAT_MODEL.md](./THREAT_MODEL.md).
diff --git a/draft-THREAT-MODEL.md b/THREAT_MODEL.md
similarity index 100%
rename from draft-THREAT-MODEL.md
rename to THREAT_MODEL.md