From 45b0c639b9f30b3b43fc5512b062c6f1da3c91cf Mon Sep 17 00:00:00 2001
From: "flamingo[bot]" <277372822+flamingo[bot]@users.noreply.github.com>
Date: Fri, 18 Sep 2026 03:22:52 +0000
Subject: [PATCH] =?UTF-8?q?chore:=20add=20=F0=9F=A6=A9=20Flamingo=20Code?=
 =?UTF-8?q?=20Documentation=20workflow?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This workflow enables automated documentation generation using the
🦩 Flamingo Code Documentation pipeline. It runs on repository_dispatch events
triggered by the multi-platform-hub.

No secrets required - all credentials are passed securely at runtime.
---
 .github/workflows/doc-orchestrator.yml | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/doc-orchestrator.yml b/.github/workflows/doc-orchestrator.yml
index 217eed8c..df41e462 100644
--- a/.github/workflows/doc-orchestrator.yml
+++ b/.github/workflows/doc-orchestrator.yml
@@ -2528,7 +2528,12 @@ jobs:
       #                        dev/getting-started-dev, dev/architecture-overview-dev
       # =========================================================================
       - name: Install Tutorial Generator Dependencies
-        if: contains(env.STAGES, 'tutorials')
+        # Stage 3 AND Stage 4 run on VoltAgent (generate-repo-docs.cjs requires
+        # @voltagent/core too). Gated on tutorials alone, a repository configured
+        # with inline-docs + repo-docs and no tutorials (openframe-saas-mobile,
+        # openframe-saas-desktop) reached Stage 4 with no dependencies at all:
+        # "Cannot find module '@voltagent/core'", run 35302244804.
+        if: contains(env.STAGES, 'tutorials') || contains(env.STAGES, 'repo-docs')
         # Isolated deps tree (see Stage 1) - no reconciliation with the target repo, so no
         # peer-conflict band-aids. @ai-sdk/anthropic pinned to 2.x (v2 spec): 3.x uses the
         # v3 spec, incompatible with VoltAgent's ai@5.x (AI SDK 5).
@@ -3048,9 +3053,15 @@ jobs:
           echo "📋 Staged files:"
           git diff --cached --name-only | head -50
 
-          if [ "$STAGED_COUNT" -eq "0" ]; then
+          # "Changes" means the BRANCH differs from the documented source head, not
+          # that this final sweep found something left to stage: every stage commits
+          # its own output as it goes, so a run whose stages all committed (inline
+          # docs, README) left nothing here and was reported as no_changes while its
+          # pull request held twenty files (openframe-saas-mobile run 35302244804).
+          # The status file is the run's own bookkeeping, never a documentation change.
+          if [ "$STAGED_COUNT" -eq "0" ] && git diff --quiet "$SOURCE_HEAD_SHA" HEAD -- . ':!.flamingo-ai-technical-writer-status.md'; then
             echo ""
-            echo "⚠️ No documentation files to stage"
+            echo "⚠️ No documentation files to stage, and the branch holds no documentation change"
             set_output "has_changes" "false"
           else
             set_output "has_changes" "true"