From 05cca2d051b07380969d8825b961735e4b16d32c Mon Sep 17 00:00:00 2001
From: hyperpolymath <6759885+hyperpolymath@users.noreply.github.com>
Date: Sun, 27 Sep 2026 01:36:54 +0000
Subject: [PATCH] docs: add repository discovery topics

Co-authored-by: arena-agent <297053741+arena-agent@users.noreply.github.com>
---
 .github/repository-topics.json | 56 ++++++++++++++++++++++++++++++++++
 .github/workflows/actions.lock | 14 +++++++--
 README.adoc                    |  7 +++++
 3 files changed, 75 insertions(+), 2 deletions(-)
 create mode 100644 .github/repository-topics.json

diff --git a/.github/repository-topics.json b/.github/repository-topics.json
new file mode 100644
index 00000000..299172fa
--- /dev/null
+++ b/.github/repository-topics.json
@@ -0,0 +1,56 @@
+{
+  "description": "Discovery metadata for GitHub repository topics and bot-readable repository classification.",
+  "recommended_topic_count": 20,
+  "minimum_topic_count": 7,
+  "topics": [
+    "automation",
+    "bots",
+    "repository-automation",
+    "workflow-automation",
+    "github-actions",
+    "ci-cd",
+    "devops",
+    "code-quality",
+    "quality-enforcement",
+    "security",
+    "supply-chain-security",
+    "compliance",
+    "governance",
+    "rust",
+    "developer-tools",
+    "ai-agents",
+    "self-healing",
+    "formal-verification",
+    "infrastructure-as-code",
+    "open-source"
+  ],
+  "short_description": "Rust-powered bot fleet for GitHub repository automation, code quality, CI/CD governance, security, and self-healing maintenance.",
+  "selection_rationale": {
+    "bot_discovery": [
+      "automation",
+      "bots",
+      "repository-automation",
+      "workflow-automation",
+      "github-actions",
+      "ai-agents",
+      "self-healing"
+    ],
+    "human_discovery": [
+      "developer-tools",
+      "code-quality",
+      "security",
+      "supply-chain-security",
+      "devops",
+      "rust",
+      "open-source"
+    ],
+    "domain_accuracy": [
+      "quality-enforcement",
+      "compliance",
+      "governance",
+      "formal-verification",
+      "infrastructure-as-code",
+      "ci-cd"
+    ]
+  }
+}
diff --git a/.github/workflows/actions.lock b/.github/workflows/actions.lock
index 6b2627ab..a48ddeda 100644
--- a/.github/workflows/actions.lock
+++ b/.github/workflows/actions.lock
@@ -12,10 +12,10 @@ workflows:
         - 'actions/deploy-pages@v5.0.1'
         - 'actions/download-artifact@v8.0.1'
         - 'actions/upload-pages-artifact@v5.0.0'
-        - 'haskell-actions/setup@v2.12.0'
+        - 'haskell-actions/setup@v2.12.1'
     '.github/workflows/codeql.yml':
         - 'actions/checkout@v7.0.1'
-        - 'github/codeql-action@b96794f015dfd88f77b49b1c93e0fa7110f94c63'
+        - 'github/codeql-action@1c5b675653bb5c22dbe9b12b556ec555138e09fd'
     '.github/workflows/dogfood-gate.yml':
         - 'actions/checkout@v7.0.1'
         - 'hyperpolymath/deed-ecosystem@main'
@@ -149,6 +149,11 @@ dependencies:
         commit: 'sha1-b96794f015dfd88f77b49b1c93e0fa7110f94c63'
         owner_id: 9919
         repo_id: 259445878
+    'github/codeql-action@1c5b675653bb5c22dbe9b12b556ec555138e09fd':
+        ref: '1c5b675653bb5c22dbe9b12b556ec555138e09fd'
+        commit: 'sha1-1c5b675653bb5c22dbe9b12b556ec555138e09fd'
+        owner_id: 9919
+        repo_id: 259445878
     'github/codeql-action@cdf488f595d80d6e07e03d4674febd5ab45fa938':
         ref: 'cdf488f595d80d6e07e03d4674febd5ab45fa938'
         commit: 'sha1-cdf488f595d80d6e07e03d4674febd5ab45fa938'
@@ -169,6 +174,11 @@ dependencies:
         commit: 'sha1-6037f33647c3f17758a2356c80fc4a53d7e0685d'
         owner_id: 75048950
         repo_id: 623796603
+    'haskell-actions/setup@v2.12.1':
+        ref: 'v2.12.1'
+        commit: 'sha1-0f7370ccbc65f22514ec3e094f6601b8d61fbbf7'
+        owner_id: 75048950
+        repo_id: 623796603
     'hyperpolymath/deed-ecosystem@main':
         ref: 'main'
         commit: 'sha1-ed83d6927e8fb21431e403dbf6d7a4af96772746'
diff --git a/README.adoc b/README.adoc
index 01f091af..636c9fc5 100644
--- a/README.adoc
+++ b/README.adoc
@@ -13,6 +13,13 @@ image:https://img.shields.io/badge/OpenSSF-Best_Practices-green?logo=openssource
 
 Bot orchestration hub for automated repository quality enforcement across the Hyperpolymath ecosystem (~500 repos).
 
+[NOTE]
+====
+Discovery tags for bots and humans: `automation`, `bots`, `repository-automation`, `workflow-automation`, `github-actions`, `ci-cd`, `devops`, `code-quality`, `quality-enforcement`, `security`, `supply-chain-security`, `compliance`, `governance`, `rust`, `developer-tools`, `ai-agents`, `self-healing`, `formal-verification`, `infrastructure-as-code`, `open-source`.
+
+The machine-readable source for these recommended GitHub topics is link:.github/repository-topics.json[`.github/repository-topics.json`].
+====
+
 toc::[]
 
 == Overview