Merge pull request #837 from EnterpriseDB/hm_2026.3-put-genai-on-notice

Author: josh-heyer

gatsby-node.js

@@ -326,7 +326,7 @@ exports.createPages = async ({ actions, graphql, reporter }) => {
       !navRoot.mdxNode.frontmatter.navRootedTo
     )
       navRoot = navRoot.parent;
-    const navTree = treeToNavigation(navRoot, node);
+    const navTree = treeToNavigation(navRoot, curr);
 
     // determine next and previous nodes
     const prevNext = findPrevNextNavNodes(navRoot, curr);

product_docs/docs/edb-postgres-ai/1.3/ai-factory/gen-ai/index.mdx

@@ -2,6 +2,11 @@
 title: Gen AI Builder
 navTitle: Gen AI Builder
 description: "Comprehensive platform for building intelligent applications and retrieval-augmented generation systems using governed knowledge bases and private AI infrastructure within EDB Postgres AI."
+directoryDefaults:
+  displayBanner: |
+    The previous Griptape-based Gen AI Builder has been removed from EDB AI Factory releases 1.3.6 and beyond, and Innovation Release 2026.3 and beyond. 
+    New functionality built around LangFlow is now available as a replacement. <a href="https://www.enterprisedb.com/docs/edb-postgres-ai/latest/ai-factory/langflow/">More details&hellip;</a>
+
 prevNext: true
 redirects:
 - /purl/ai-factory/gen-ai/agent-studio

product_docs/docs/edb-postgres-ai/1.3/ai-factory/gen-ai/reference/index.mdx

@@ -3,8 +3,6 @@ title: Gen AI Builder
 originalFilePath: >-
   https://github.com/EnterpriseDB/pgai-ai-builder/blob/main/docs/griptape-cloud/index.md
 editTarget: originalFilePath
-directoryDefaults:
-  displayBanner: 'Adapted from the <a href="https://github.com/EnterpriseDB/pgai-ai-builder">Griptape AI Framework</a> documentation.'
 redirects:
 - /purl/hm/gen-ai-builder:splat
 ---

product_docs/docs/edb-postgres-ai/1.3/hybrid-manager/ai-factory/index.mdx

@@ -2,6 +2,10 @@
 title: AI Factory in Hybrid Manager
 navTitle: AI Factory in Hybrid Manager
 description: Learn how to use the AI Factory workload within Hybrid Manager (Hybrid Manager AI Factory), including Gen AI, model serving, vector search, and knowledge bases. Explore learning paths, use cases, and Hybrid Manager-specific capabilities.
+directoryDefaults:
+  displayBanner: |
+    The previous Griptape-based Gen AI Builder has been removed from EDB AI Factory releases 1.3.6 and beyond, and Innovation Release 2026.3 and beyond. 
+    New functionality built around LangFlow is now available as a replacement. <a href="https://www.enterprisedb.com/docs/edb-postgres-ai/latest/ai-factory/langflow/">More details&hellip;</a>
 redirects:
 - /purl/hm/ai-factory
 navigation:

product_docs/docs/edb-postgres-ai/preview/ai-factory/gen-ai/index.mdx

@@ -3,6 +3,10 @@ title: Gen AI Builder
 navTitle: Gen AI Builder
 description: "Comprehensive platform for building intelligent applications and retrieval-augmented generation systems using governed knowledge bases and private AI infrastructure within EDB Postgres AI."
 prevNext: true
+directoryDefaults:
+  displayBanner: |
+    The previous Griptape-based Gen AI Builder has been removed from EDB AI Factory releases 1.3.6 and beyond, and Innovation Release 2026.3 and beyond. 
+    New functionality built around LangFlow is now available as a replacement. <a href="https://www.enterprisedb.com/docs/edb-postgres-ai/latest/ai-factory/langflow/">More details&hellip;</a>
 redirects:
 - /purl/ai-factory/gen-ai/agent-studio
 navigation:

product_docs/docs/edb-postgres-ai/preview/ai-factory/gen-ai/reference/index.mdx

@@ -3,8 +3,6 @@ title: Gen AI Builder
 originalFilePath: >-
   https://github.com/EnterpriseDB/pgai-ai-builder/blob/main/docs/griptape-cloud/index.md
 editTarget: originalFilePath
-directoryDefaults:
-  displayBanner: 'Adapted from the <a href="https://github.com/EnterpriseDB/pgai-ai-builder">Griptape AI Framework</a> documentation.'
 redirects:
 - /purl/hm/gen-ai-builder:splat
 ---

product_docs/docs/edb-postgres-ai/preview/hybrid-manager/ai-factory/index.mdx

@@ -2,6 +2,10 @@
 title: AI Factory in Hybrid Manager
 navTitle: AI Factory in Hybrid Manager
 description: Learn how to use the AI Factory workload within Hybrid Manager (Hybrid Manager AI Factory), including Gen AI, model serving, vector search, and knowledge bases. Explore learning paths, use cases, and Hybrid Manager-specific capabilities.
+directoryDefaults:
+  displayBanner: |
+    The previous Griptape-based Gen AI Builder has been removed from EDB AI Factory releases 1.3.6 and beyond, and Innovation Release 2026.3 and beyond. 
+    New functionality built around LangFlow is now available as a replacement. <a href="https://www.enterprisedb.com/docs/edb-postgres-ai/latest/ai-factory/langflow/">More details&hellip;</a>
 redirects:
 - /purl/hm/ai-factory
 navigation:

src/constants/gatsby-utils.js

@@ -334,10 +334,24 @@ const treeNodeToNavNode = (treeNode) => {
 // create a tree structure suitable for embedding in page context
 // for use by sidebar nav, card decks during rendering
 // treeNode: produced by mdxNodesToTree(), represents the root of navigation (product index, etc)
-// pageNode: an mdxNode representing the page for which navigation is desired
+// pageNode: produced by mdxNodesToTree(), representing the page for which navigation is desired
 const treeToNavigation = (treeNode, pageNode) => {
-  const rootNode = treeNodeToNavNode(treeNode, true);
-  const { depth, path } = pageNode.fields;
+  const { depth, path } = pageNode;
+  // special-case: if this node is a version-specific root under an unversioned product root which actually has a landing page,
+  // then we want to rewrite children to be the children of the version-specific page. This allows unversioned siblings to exist and
+  // be navigated to.
+  let rootNode = null;
+  let remapChildren = false;
+  if (
+    depth === 2 &&
+    treeNode.depth === 1 &&
+    pageNode.mdxNode?.fields?.version &&
+    treeNode.path &&
+    path.includes(treeNode.path)
+  ) {
+    rootNode = treeNodeToNavNode(pageNode, true);
+    remapChildren = true;
+  } else rootNode = treeNodeToNavNode(treeNode, true);
 
   // if this page is "rooted" to another page, then we want to collect the chain
   // of ancestors (but not their other children) for use as the breadcrumb trail
@@ -368,7 +382,17 @@ const treeToNavigation = (treeNode, pageNode) => {
         // ignore nodes that are marked as such
         if (n.mdxNode?.frontmatter?.navExclude) return null;
 
-        const navNode = treeToNavigation(n, pageNode);
+        // special-case: if we're swapping in the version-specific page as the root, then we need to
+        // swap out children that belong to the latest-version page with their version-specific counterparts, if they exist
+        const navNode = treeToNavigation(
+          (remapChildren &&
+            pageNode.children.find(
+              (child) => replacePathVersion(child.path) === n.path,
+            )) ||
+            n,
+          pageNode,
+        );
+
         // mark "fake" children so that they can be made visually distinct, ignored, etc.
         if (n.parent !== treeNode || n.rootedTo === treeNode)
           navNode.rootedTo = true;

src/templates/doc.js

@@ -201,10 +201,10 @@ const DocTemplate = ({ data, pageContext }) => {
   let title = frontmatter.title;
   let preciseVersion = frontmatter.version;
 
-  if (depth === 2 && !navTree.hideVersion) {
+  if (depth === 2 && !navRoot.hideVersion) {
     // product version root
     title += ` ${FormatVersion(preciseVersion || version)}`;
-  } else if (depth > 2 && !navTree.hideVersion) {
+  } else if (depth > 2 && !navRoot.hideVersion) {
     const prettyProductName = (
       products[product] || { name: product.toUpperCase() }
     ).name;
@@ -263,7 +263,7 @@ const DocTemplate = ({ data, pageContext }) => {
           <div className="d-flex flex-column flex-md-row justify-content-between align-items-center">
             <h1 className="balance-text">
               {frontmatter.title}{" "}
-              {!navTree.hideVersion && (
+              {!navRoot.hideVersion && (
                 <span className="fw-light ms-2 text-muted bg-light px-2 rounded text-smaller position-relative lh-1 top-minus-3">
                   {FormatVersion(preciseVersion || version)}
                 </span>
@@ -286,12 +286,12 @@ const DocTemplate = ({ data, pageContext }) => {
             </div>
           </div>
 
-          {navTree.displayBanner ? (
+          {navRoot.displayBanner ? (
             <div
               className="alert alert-warning mt-3"
               role="alert"
               dangerouslySetInnerHTML={{
-                __html: navTree.displayBanner.replace(
+                __html: navRoot.displayBanner.replace(
                   /href="latest:splat"/,
                   `href="${withPrefix(pageContext.pathVersions[0] || getProductUrlBase(pagePath))}"`,
                 ),