From 229fb8d275eb2a9f5efefbdbf8fd73e65b7c81ca Mon Sep 17 00:00:00 2001
From: ***** <721466+soodoku@users.noreply.github.com>
Date: Sun, 27 Sep 2026 19:17:40 -0700
Subject: [PATCH] docs: add monthly Adjacent v2 recommendations

---
 .github/workflows/adjacent.yml | 59 ++++++++++++++++++++++++++++++++++
 .github/workflows/docs.yml     |  1 +
 README.md                      | 12 +++++++
 3 files changed, 72 insertions(+)
 create mode 100644 .github/workflows/adjacent.yml

diff --git a/.github/workflows/adjacent.yml b/.github/workflows/adjacent.yml
new file mode 100644
index 0000000..df51fa3
--- /dev/null
+++ b/.github/workflows/adjacent.yml
@@ -0,0 +1,59 @@
+name: Adjacent repositories
+
+on:
+  schedule:
+    - cron: '17 5 1 * *'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: adjacent-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  refresh:
+    if: github.ref == format('refs/heads/{0}', github.event.repository.default_branch)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: write
+      pull-requests: write
+      actions: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Update related repositories
+        uses: gojiplus/adjacent@a2f97a586c48d941f493a1f75af07b0b95dceff8 # v2.0
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          similarity_method: topics
+          min_score: '0.1'
+          max_repos: '3'
+
+      - name: Propose README update
+        id: pull-request
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: automation/adjacent
+          delete-branch: true
+          add-paths: README.md
+          commit-message: 'docs: refresh adjacent repositories'
+          title: 'docs: refresh adjacent repositories'
+          body: |
+            Refresh the marked related-repository section using Adjacent v2.
+            Automatic refreshes run once a month. Review the recommendation diff
+            and the repository checks before merging.
+
+      - name: Run checks on the proposed update
+        if: steps.pull-request.outputs.pull-request-operation == 'created' || steps.pull-request.outputs.pull-request-operation == 'updated'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh workflow run ci.yml --ref automation/adjacent
+          gh workflow run docs.yml --ref automation/adjacent
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index ae7b02c..4223915 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -4,6 +4,7 @@ on:
   push:
     branches: [main]
   pull_request:
+  workflow_dispatch:
 
 permissions:
   contents: read
diff --git a/README.md b/README.md
index 3a871d3..c25f421 100644
--- a/README.md
+++ b/README.md
@@ -182,3 +182,15 @@ make evidence
 ## License
 
 MIT
+
+<!-- adjacent:start -->
+
+## 🔗 Adjacent Repositories
+
+- [finite-sample/optimal-classification-cutoffs](https://github.com/finite-sample/optimal-classification-cutoffs) — Cutoffs for max. multiclass F1-score, etc.
+- [finite-sample/calibre](https://github.com/finite-sample/calibre) — Advanced Calibration Models
+- [finite-sample/rank-preserving-calibration](https://github.com/finite-sample/rank-preserving-calibration) — Rank preserving calibration of multiclass prob.
+
+_Powered by [Adjacent](https://github.com/gojiplus/adjacent)_
+
+<!-- adjacent:end -->