From f11bfa6ea1aa7a20f16383dd7cf97e70af58352f Mon Sep 17 00:00:00 2001 From: Uniskela <104075208+uniskela@users.noreply.github.com> Date: Fri, 9 Oct 2026 04:05:38 +0000 Subject: [PATCH 1/3] fix(ci): target uniskela/com for documentation dispatch --- .github/workflows/notify-uniskela-docs.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/notify-uniskela-docs.yml b/.github/workflows/notify-uniskela-docs.yml index 29038c0..8e0ab77 100644 --- a/.github/workflows/notify-uniskela-docs.yml +++ b/.github/workflows/notify-uniskela-docs.yml @@ -49,7 +49,7 @@ jobs: client-id: ${{ vars.DOCS_SYNC_APP_CLIENT_ID }} private-key: ${{ secrets.DOCS_SYNC_APP_PRIVATE_KEY }} owner: uniskela - repositories: .com + repositories: com permission-contents: write - name: Notify the documentation receiver env: @@ -60,4 +60,4 @@ jobs: run: | jq -n --arg repository "$SOURCE_REPO" --arg sha "$SOURCE_SHA" --arg ref "$SOURCE_REF" \ '{event_type:"docs-source-updated",client_payload:{repository:$repository,sha:$sha,ref:$ref}}' > "$RUNNER_TEMP/docs-dispatch.json" - gh api --method POST repos/uniskela/.com/dispatches --input "$RUNNER_TEMP/docs-dispatch.json" + gh api --method POST repos/uniskela/com/dispatches --input "$RUNNER_TEMP/docs-dispatch.json" From 435049504658bcf54c373d9ea61d9a7981e1170c Mon Sep 17 00:00:00 2001 From: Uniskela <104075208+uniskela@users.noreply.github.com> Date: Fri, 9 Oct 2026 04:05:41 +0000 Subject: [PATCH 2/3] docs: correct documentation receiver repository --- .github/docs-sync.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/.github/docs-sync.md b/.github/docs-sync.md index d54ef6b..024d52f 100644 --- a/.github/docs-sync.md +++ b/.github/docs-sync.md @@ -1,26 +1,26 @@ # Notify the Uniskela documentation site stack-manager's user documentation is published at [uniskela.com/docs/stack-manager](https://uniskela.com/docs/stack-manager/) -by `uniskela/.com`, the same way as adhd-hub and ts6-manager. +by `uniskela/com`, the same way as adhd-hub and ts6-manager. - [`docs/manifest.json`](../docs/manifest.json) lists the pages to publish: `source` file, URL `slug`, sidebar `title` and `group`. Published pages live under `docs/public/`. `docs/internal/` (plans, architecture decisions) and `docs/agents/` are not imported; links to them fall back to GitHub URLs on the site. - The `Notify Uniskela documentation` workflow sends an update notification after README/docs changes merge to - `main` (and on each published release). It does not publish the website directly: `uniskela/.com` imports the + `main` (and on each published release). It does not publish the website directly: `uniskela/com` imports the content, runs its checks and proposes a draft PR for review. ## One-time setup -1. In `uniskela/.com`, add `uniskela/stack-manager` to the receiver's list of documentation sources and select its +1. In `uniskela/com`, add `uniskela/stack-manager` to the receiver's list of documentation sources and select its pages (see `docs/docs-dispatch-setup.md` in that repository). 2. In this repository, configure the Actions variable `DOCS_SYNC_APP_CLIENT_ID` and the Actions secret - `DOCS_SYNC_APP_PRIVATE_KEY` for the dedicated documentation GitHub App (installed only on `uniskela/.com` with + `DOCS_SYNC_APP_PRIVATE_KEY` for the dedicated documentation GitHub App (installed only on `uniskela/com` with Contents read/write). The workflow creates a short-lived, destination-only installation token, which is revoked after the job. It never runs on pull requests or forks and does not check out source code. -3. Run the workflow manually on `main` and verify the receiver in `uniskela/.com` succeeds. +3. Run the workflow manually on `main` and verify the receiver in `uniskela/com` succeeds. -Missing credentials make the workflow fail visibly. The weekly sync in `uniskela/.com` remains a fallback. GitHub does +Missing credentials make the workflow fail visibly. The weekly sync in `uniskela/com` remains a fallback. GitHub does not start push-triggered workflows for pushes made with `GITHUB_TOKEN`; use a manual run in that case. Never put the App private key in repository files, PRs or chats. From d5014682fe91c27e25a2a22895c8a4da42f11b6c Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 9 Oct 2026 15:59:18 +1100 Subject: [PATCH 3/3] ci: name uniskela/com in the notifier header comment Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01WJyn1D52aa77MxSKQGKQYp --- .github/workflows/notify-uniskela-docs.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/notify-uniskela-docs.yml b/.github/workflows/notify-uniskela-docs.yml index 8e0ab77..bf9cfdb 100644 --- a/.github/workflows/notify-uniskela-docs.yml +++ b/.github/workflows/notify-uniskela-docs.yml @@ -1,5 +1,5 @@ name: Notify Uniskela documentation -# Tells uniskela/.com that README/docs changed so it can import them (see .github/docs-sync.md). +# Tells uniskela/com that README/docs changed so it can import them (see .github/docs-sync.md). # Sends only the repository, commit and ref: no checkout, never runs on pull requests or forks. on: push: