From 39628e6e7a33e8044ddcfe63c2e58557b27b5f3b Mon Sep 17 00:00:00 2001 From: Ernesto Ongaro Date: Fri, 28 Aug 2026 15:25:22 +0100 Subject: [PATCH 1/2] ci(notify-docs): trigger the docs sync on command-surface changes, not only prose A push that adds a flag or rewrites help text (cmd/, internal/openapi/, api/openapi.json) changes what docs.omni.co/developers/cli/commands should say, but the workflow only fired on *.md edits, so most CLI changes never reached the docs repo. Tests are excluded since they never alter the surface. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01Ei8UYaG1bW5PJhk93EaqzA --- .github/workflows/notify-docs.yml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/.github/workflows/notify-docs.yml b/.github/workflows/notify-docs.yml index 0f61d07..4be5ab2 100644 --- a/.github/workflows/notify-docs.yml +++ b/.github/workflows/notify-docs.yml @@ -6,8 +6,15 @@ on: push: branches: [main] paths: + # Prose changes. - "**/*.md" + # Anything that changes the generated command surface: flags, args, + # help text, agent-help, and the spec every command is derived from. + - "cmd/**" + - "internal/openapi/**" + - "api/openapi.json" - "!.github/**" + - "!**/*_test.go" jobs: notify: From ccdebf51986bcb644579a489c6255c9f135ee779 Mon Sep 17 00:00:00 2001 From: Ernesto Ongaro Date: Fri, 28 Aug 2026 15:26:47 +0100 Subject: [PATCH 2/2] ci(notify-docs): dispatch the docs sync on release only Drop the push trigger: the receiver already diffs previous tag..release tag, so a single dispatch per release carries every change since the last one, and per-merge pushes only produced a docs PR per merge. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01Ei8UYaG1bW5PJhk93EaqzA --- .github/workflows/notify-docs.yml | 15 +++------------ 1 file changed, 3 insertions(+), 12 deletions(-) diff --git a/.github/workflows/notify-docs.yml b/.github/workflows/notify-docs.yml index 4be5ab2..316b3c9 100644 --- a/.github/workflows/notify-docs.yml +++ b/.github/workflows/notify-docs.yml @@ -1,20 +1,11 @@ name: Notify Docs on Changes on: + # Release-only: the receiver diffs previous tag..this tag, so one dispatch per + # release carries every change since the last one. Pushes to main are + # deliberately not a trigger — they produced a docs PR per merge. release: types: [published] - push: - branches: [main] - paths: - # Prose changes. - - "**/*.md" - # Anything that changes the generated command surface: flags, args, - # help text, agent-help, and the spec every command is derived from. - - "cmd/**" - - "internal/openapi/**" - - "api/openapi.json" - - "!.github/**" - - "!**/*_test.go" jobs: notify: