From ed9b0f0c8a9007517bbf6700a2362fec583a39c8 Mon Sep 17 00:00:00 2001
From: Travis James <travis@tribehealthsolutions.com>
Date: Thu, 8 Oct 2026 05:31:08 -0500
Subject: [PATCH] fix(build): order the docs-site build after every package
 build

site/package.json declares no workspace package as a dependency, so turbo's
`^build` gave the docs site no ordering against the packages whose built
`dist` its prebuild (scripts/generate-api-reference.mjs) resolves through
node_modules. On a fresh clone the prebuild raced the package builds and
failed with "new undocumented stable export: createGraphStore / graphStore
(prometheus-entity-management)"; a warm turbo cache hid it locally.

Reproduced deterministically with `rm -rf packages/*/dist && turbo run build
--force` (prebuild started before entity-graph-core's tsup), then fixed by
giving `@prometheus-ags/entity-graph-docs-site#build` an explicit dependsOn
on all 13 package builds. The same forced build now runs the prebuild after
the packages and passes (22/22 tasks).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
---
 turbo.json | 48 +++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 41 insertions(+), 7 deletions(-)

diff --git a/turbo.json b/turbo.json
index 76ce0ff2..fa614b66 100644
--- a/turbo.json
+++ b/turbo.json
@@ -3,17 +3,51 @@
   "ui": "stream",
   "tasks": {
     "build": {
-      "dependsOn": ["^build"],
-      "outputs": ["dist/**"]
+      "dependsOn": [
+        "^build"
+      ],
+      "outputs": [
+        "dist/**"
+      ]
     },
     "typecheck": {
-      "dependsOn": ["^build"],
-      "outputs": [".cache/typescript/**"]
+      "dependsOn": [
+        "^build"
+      ],
+      "outputs": [
+        ".cache/typescript/**"
+      ]
     },
     "test": {
-      "dependsOn": ["^build"],
-      "outputs": ["coverage/**"]
+      "dependsOn": [
+        "^build"
+      ],
+      "outputs": [
+        "coverage/**"
+      ]
     },
-    "lint": {}
+    "lint": {},
+    "@prometheus-ags/entity-graph-docs-site#build": {
+      "dependsOn": [
+        "^build",
+        "@prometheus-ags/entity-graph-core#build",
+        "@prometheus-ags/entity-graph-react#build",
+        "@prometheus-ags/prometheus-entity-management#build",
+        "@prometheus-ags/entity-graph-sync#build",
+        "@prometheus-ags/entity-graph-svelte#build",
+        "@prometheus-ags/entity-graph-solid#build",
+        "@prometheus-ags/entity-graph-alpine#build",
+        "@prometheus-ags/entity-graph-htmx#build",
+        "@prometheus-ags/entity-graph-web-components#build",
+        "@prometheus-ags/a2ui-react#build",
+        "@prometheus-ags/entity-graph-a2a#build",
+        "@prometheus-ags/entity-graph-tauri#build",
+        "@prometheus-ags/entity-graph-sdl#build"
+      ],
+      "outputs": [
+        "build/**",
+        ".docusaurus/**"
+      ]
+    }
   }
 }