From d0f35df658b388225da9bbab89f599dff3555651 Mon Sep 17 00:00:00 2001
From: Tom Softreck <tom@sapletta.com>
Date: Sun, 6 Sep 2026 00:37:22 +0200
Subject: [PATCH] fix: use centrally scheduled organization metadata sync

---
 .github/workflows/trigger-org-sync.yml | 27 -----------
 docs/README.md                         |  5 ++
 docs/information/org-metadata-sync.md  | 66 ++++++++++++++++++++++++++
 3 files changed, 71 insertions(+), 27 deletions(-)
 delete mode 100644 .github/workflows/trigger-org-sync.yml
 create mode 100644 docs/README.md
 create mode 100644 docs/information/org-metadata-sync.md

diff --git a/.github/workflows/trigger-org-sync.yml b/.github/workflows/trigger-org-sync.yml
deleted file mode 100644
index e5bf54a..0000000
--- a/.github/workflows/trigger-org-sync.yml
+++ /dev/null
@@ -1,27 +0,0 @@
-# Copy this file to member repos as .github/workflows/trigger-org-sync.yml
-# Repository dispatch target is filled by bootstrap_triggers.py
-
-name: Trigger org metadata sync
-
-on:
-  push:
-    branches: [main, master]
-    paths-ignore:
-      - "index.html"
-      - ".nojekyll"
-      - "profile/**"
-      - ".github/workflows/trigger-org-sync.yml"
-  workflow_dispatch:
-
-jobs:
-  dispatch:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Notify org metadata sync
-        uses: peter-evans/repository-dispatch@v3
-        with:
-          token: ${{ secrets.ORG_SYNC_PAT }}
-          repository: semcod/.github
-          event-type: org-repo-changed
-          client-payload: >-
-            {"repository":"${{ github.repository }}","ref":"${{ github.ref }}","sha":"${{ github.sha }}"}
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..ba7c4ca
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,5 @@
+# Dokumentacja
+
+## Automatyzacja repozytorium
+
+- [Synchronizacja metadanych](information/org-metadata-sync.md) — koordynator, harmonogram i diagnostyka.
diff --git a/docs/information/org-metadata-sync.md b/docs/information/org-metadata-sync.md
new file mode 100644
index 0000000..b61d60d
--- /dev/null
+++ b/docs/information/org-metadata-sync.md
@@ -0,0 +1,66 @@
+---
+{
+  "schema": "wellmanifest.docs/document/v1",
+  "id": "org-metadata-sync",
+  "kind": "information",
+  "version": 1,
+  "title": "Centralna synchronizacja metadanych repozytorium",
+  "status": "implemented",
+  "owner": "autogrammar/toonic",
+  "created": "2026-09-06",
+  "updated": "2026-09-06",
+  "review_after": "2026-10-06",
+  "source_revision": "433e3e61fccb3523ee17b7008b6210841acaa3c0",
+  "affected_repositories": [
+    "autogrammar/toonic"
+  ],
+  "evidence": [
+    "https://github.com/semcod/.github/blob/406fb4b692680b3d69d25ee9570e81869afbd0c5/org-sync/managed-repositories.json",
+    "https://github.com/semcod/.github/pull/1"
+  ]
+}
+---
+
+# Centralna synchronizacja metadanych repozytorium
+
+<!-- docs:section purpose -->
+## Cel
+
+Opis i tematy GitHub repozytorium `autogrammar/toonic` synchronizuje koordynator `semcod/.github`.
+
+<!-- docs:section scope -->
+## Zakres
+
+Ten dokument opisuje obsługę metadanych tego repozytorium. Aktualizacja zależności i testy projektu mają osobne workflow.
+
+<!-- docs:section evidence -->
+## Dowody
+
+Repozytorium jest jawnie wpisane do [katalogu koordynatora](https://github.com/semcod/.github/blob/406fb4b692680b3d69d25ee9570e81869afbd0c5/org-sync/managed-repositories.json). Zmianę mechanizmu opublikowano w [PR 1 koordynatora](https://github.com/semcod/.github/pull/1). [Wykonanie synchronizacji](https://github.com/semcod/.github/actions/runs/33996279028) zakończyło się sukcesem; ponowny odczyt API potwierdził temat `autogrammar` i zachowanie adresu WWW. Pełną konfigurację opisuje [instrukcja koordynatora](https://github.com/semcod/.github/blob/406fb4b692680b3d69d25ee9570e81869afbd0c5/docs/information/org-metadata-sync.md).
+
+<!-- docs:section content -->
+## Działanie
+
+Centralny harmonogram `17 */6 * * *` uruchamia aktualizację co sześć godzin. Koordynator używa pełnej tożsamości `autogrammar/toonic` i własnego uwierzytelniania. Lokalny wyzwalacz `trigger-org-sync.yml`, który wymagał niedostępnego sekretu `ORG_SYNC_PAT`, został wycofany.
+
+Tryb `--metadata-only --skip-profile` aktualizuje opis i tematy, zachowując adres WWW, konfigurację GitHub Pages i profil organizacji. Lokalny sekret `ORG_SYNC_PAT` nie jest potrzebny.
+
+Operator z dostępem do koordynatora może uruchomić podgląd:
+
+```bash
+gh workflow run org-metadata-sync.yml --repo semcod/.github --ref main -f repository=autogrammar/toonic -f dry_run=true
+```
+
+Aby zapisać zmiany, użyj `dry_run=false`. Wynik jest widoczny w [uruchomieniach koordynatora](https://github.com/semcod/.github/actions/workflows/org-metadata-sync.yml).
+
+<!-- docs:section limitations -->
+## Ograniczenia
+
+Aktualizacja odbywa się według harmonogramu, z możliwym opóźnieniem kolejki GitHub. Push do tego repozytorium nie uruchamia jej natychmiast. Dry-run sprawdza odczyt i proponowane wartości; skuteczny zapis wymaga udanego wykonania oraz kontroli API.
+
+Dokument używa formatu wellmanifest/docs 0.1.1; nie deklaruje wdrożenia chronionego checkera dokumentacji.
+
+<!-- docs:section next_actions -->
+## Utrzymanie
+
+Po zmianie właściciela repozytorium zaktualizuj katalog i konfigurację koordynatora, następnie sprawdź podgląd, wykonanie oraz wartości w API. Błędy synchronizacji diagnozuj w centralnym workflow. Przy zmianie mechanizmu zwiększ wersję tego dokumentu.