@contractspec/bundle.library 3.4.3 → 3.5.2

package/dist/components/docs/architecture/ArchitectureKnowledgeBindingPage.js

@@ -3,85 +3,85 @@
 import { CodeBlock } from "@contractspec/lib.design-system";
 import Link from "@contractspec/lib.ui-link";
 import { ChevronRight } from "lucide-react";
-import { jsxDEV } from "react/jsx-dev-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 function ArchitectureKnowledgeBindingPage() {
-  return /* @__PURE__ */ jsxDEV("div", {
+  return /* @__PURE__ */ jsxs("div", {
     className: "space-y-8",
     children: [
-      /* @__PURE__ */ jsxDEV("div", {
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsxDEV("h1", {
+          /* @__PURE__ */ jsx("h1", {
             className: "text-4xl font-bold",
             children: "Knowledge Binding"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("p", {
+          }),
+          /* @__PURE__ */ jsx("p", {
             className: "text-muted-foreground",
             children: "Knowledge binding connects your app's workflows and agents to structured knowledge spaces. This enables semantic search, RAG (Retrieval-Augmented Generation), and context-aware decision-making."
-          }, undefined, false, undefined, this)
+          })
         ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV("div", {
+      }),
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsxDEV("h2", {
+          /* @__PURE__ */ jsx("h2", {
             className: "text-2xl font-bold",
             children: "How it works"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("p", {
+          }),
+          /* @__PURE__ */ jsx("p", {
             className: "text-muted-foreground",
             children: "Knowledge binding follows a three-layer model:"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("ol", {
+          }),
+          /* @__PURE__ */ jsxs("ol", {
             className: "text-muted-foreground list-inside list-decimal space-y-3",
             children: [
-              /* @__PURE__ */ jsxDEV("li", {
+              /* @__PURE__ */ jsxs("li", {
                 children: [
-                  /* @__PURE__ */ jsxDEV("strong", {
+                  /* @__PURE__ */ jsx("strong", {
                     children: "KnowledgeSpaceSpec"
-                  }, undefined, false, undefined, this),
+                  }),
                   " (global) - Defines a logical knowledge domain"
                 ]
-              }, undefined, true, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsxs("li", {
                 children: [
-                  /* @__PURE__ */ jsxDEV("strong", {
+                  /* @__PURE__ */ jsx("strong", {
                     children: "KnowledgeSourceConfig"
-                  }, undefined, false, undefined, this),
+                  }),
                   " (per-tenant) - Tenant's data sources feeding spaces"
                 ]
-              }, undefined, true, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsxs("li", {
                 children: [
-                  /* @__PURE__ */ jsxDEV("strong", {
+                  /* @__PURE__ */ jsx("strong", {
                     children: "AppKnowledgeBinding"
-                  }, undefined, false, undefined, this),
+                  }),
                   " (per-app) - Maps spaces to workflows/agents"
                 ]
-              }, undefined, true, undefined, this)
+              })
             ]
-          }, undefined, true, undefined, this)
+          })
         ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV("div", {
+      }),
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsxDEV("h2", {
+          /* @__PURE__ */ jsx("h2", {
             className: "text-2xl font-bold",
             children: "Example: Support agent with RAG"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("p", {
+          }),
+          /* @__PURE__ */ jsx("p", {
             className: "text-muted-foreground",
             children: "Let's build a support agent that uses canonical product documentation and operational support history."
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
+          }),
+          /* @__PURE__ */ jsxs("div", {
             className: "space-y-3",
             children: [
-              /* @__PURE__ */ jsxDEV("h3", {
+              /* @__PURE__ */ jsx("h3", {
                 className: "text-lg font-semibold",
                 children: "Step 1: Blueprint declares knowledge needs"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV(CodeBlock, {
+              }),
+              /* @__PURE__ */ jsx(CodeBlock, {
                 language: "typescript",
                 code: `// AppBlueprintSpec
 {
@@ -108,17 +108,17 @@ function ArchitectureKnowledgeBindingPage() {
     }
   ]
 }`
-              }, undefined, false, undefined, this)
+              })
             ]
-          }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
+          }),
+          /* @__PURE__ */ jsxs("div", {
             className: "space-y-3",
             children: [
-              /* @__PURE__ */ jsxDEV("h3", {
+              /* @__PURE__ */ jsx("h3", {
                 className: "text-lg font-semibold",
                 children: "Step 2: Tenant configures sources"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV(CodeBlock, {
+              }),
+              /* @__PURE__ */ jsx(CodeBlock, {
                 language: "typescript",
                 code: `// KnowledgeSourceConfig (per-tenant)
 [
@@ -150,17 +150,17 @@ function ArchitectureKnowledgeBindingPage() {
     lastSyncedAt: "2025-01-15T00:00:00Z"
   }
 ]`
-              }, undefined, false, undefined, this)
+              })
             ]
-          }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
+          }),
+          /* @__PURE__ */ jsxs("div", {
             className: "space-y-3",
             children: [
-              /* @__PURE__ */ jsxDEV("h3", {
+              /* @__PURE__ */ jsx("h3", {
                 className: "text-lg font-semibold",
                 children: "Step 3: TenantAppConfig binds spaces"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV(CodeBlock, {
+              }),
+              /* @__PURE__ */ jsx(CodeBlock, {
                 language: "typescript",
                 code: `// TenantAppConfig
 {
@@ -199,17 +199,17 @@ function ArchitectureKnowledgeBindingPage() {
     }
   ]
 }`
-              }, undefined, false, undefined, this)
+              })
             ]
-          }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
+          }),
+          /* @__PURE__ */ jsxs("div", {
             className: "space-y-3",
             children: [
-              /* @__PURE__ */ jsxDEV("h3", {
+              /* @__PURE__ */ jsx("h3", {
                 className: "text-lg font-semibold",
                 children: "Step 4: Workflow uses knowledge"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV(CodeBlock, {
+              }),
+              /* @__PURE__ */ jsx(CodeBlock, {
                 language: "yaml",
                 code: `// WorkflowSpec
 workflowId: answer-question
@@ -254,153 +254,153 @@ steps:
             
             Support history:
             \${steps.search-support-history.output.results}`
-              }, undefined, false, undefined, this)
+              })
             ]
-          }, undefined, true, undefined, this)
+          })
         ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV("div", {
+      }),
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsxDEV("h2", {
+          /* @__PURE__ */ jsx("h2", {
             className: "text-2xl font-bold",
             children: "Category-based access control"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("p", {
+          }),
+          /* @__PURE__ */ jsx("p", {
             className: "text-muted-foreground",
             children: "Different knowledge categories have different trust levels and access patterns:"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
+          }),
+          /* @__PURE__ */ jsx("div", {
             className: "border-border/50 overflow-x-auto rounded-lg border",
-            children: /* @__PURE__ */ jsxDEV("table", {
+            children: /* @__PURE__ */ jsxs("table", {
               className: "w-full text-left text-sm",
               children: [
-                /* @__PURE__ */ jsxDEV("thead", {
+                /* @__PURE__ */ jsx("thead", {
                   className: "bg-card/50",
-                  children: /* @__PURE__ */ jsxDEV("tr", {
+                  children: /* @__PURE__ */ jsxs("tr", {
                     className: "border-border/50 border-b",
                     children: [
-                      /* @__PURE__ */ jsxDEV("th", {
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "Category"
-                      }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV("th", {
+                      }),
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "Trust Level"
-                      }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV("th", {
+                      }),
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "Use Cases"
-                      }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV("th", {
+                      }),
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "Policy Impact"
-                      }, undefined, false, undefined, this)
+                      })
                     ]
-                  }, undefined, true, undefined, this)
-                }, undefined, false, undefined, this),
-                /* @__PURE__ */ jsxDEV("tbody", {
+                  })
+                }),
+                /* @__PURE__ */ jsxs("tbody", {
                   className: "divide-border/50 divide-y",
                   children: [
-                    /* @__PURE__ */ jsxDEV("tr", {
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsxDEV("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-mono text-xs",
                           children: "canonical"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Highest"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Product specs, schemas, official policies"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Can drive policy decisions"
-                        }, undefined, false, undefined, this)
+                        })
                       ]
-                    }, undefined, true, undefined, this),
-                    /* @__PURE__ */ jsxDEV("tr", {
+                    }),
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsxDEV("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-mono text-xs",
                           children: "operational"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "High"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Support tickets, sales docs, internal runbooks"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Can inform decisions"
-                        }, undefined, false, undefined, this)
+                        })
                       ]
-                    }, undefined, true, undefined, this),
-                    /* @__PURE__ */ jsxDEV("tr", {
+                    }),
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsxDEV("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-mono text-xs",
                           children: "external"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Medium"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Third-party docs, regulations, PSP guides"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Reference only, not authoritative"
-                        }, undefined, false, undefined, this)
+                        })
                       ]
-                    }, undefined, true, undefined, this),
-                    /* @__PURE__ */ jsxDEV("tr", {
+                    }),
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsxDEV("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-mono text-xs",
                           children: "ephemeral"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Low"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Agent scratchpads, session context, drafts"
-                        }, undefined, false, undefined, this),
-                        /* @__PURE__ */ jsxDEV("td", {
+                        }),
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Never used for decisions"
-                        }, undefined, false, undefined, this)
+                        })
                       ]
-                    }, undefined, true, undefined, this)
+                    })
                   ]
-                }, undefined, true, undefined, this)
+                })
               ]
-            }, undefined, true, undefined, this)
-          }, undefined, false, undefined, this)
+            })
+          })
         ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV("div", {
+      }),
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsxDEV("h2", {
+          /* @__PURE__ */ jsx("h2", {
             className: "text-2xl font-bold",
             children: "Multi-space workflows"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("p", {
+          }),
+          /* @__PURE__ */ jsx("p", {
             className: "text-muted-foreground",
             children: "Workflows can query multiple knowledge spaces and combine results:"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV(CodeBlock, {
+          }),
+          /* @__PURE__ */ jsx(CodeBlock, {
             language: "typescript",
             code: `knowledgeBindings: [
   {
@@ -431,98 +431,98 @@ steps:
     sources: ["src_crm_data", "src_past_invoices"]
   }
 ]`
-          }, undefined, false, undefined, this)
+          })
         ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV("div", {
+      }),
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsxDEV("h2", {
+          /* @__PURE__ */ jsx("h2", {
             className: "text-2xl font-bold",
             children: "Security & validation"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("ul", {
+          }),
+          /* @__PURE__ */ jsxs("ul", {
             className: "text-muted-foreground list-inside list-disc space-y-2",
             children: [
-              /* @__PURE__ */ jsxDEV("li", {
+              /* @__PURE__ */ jsx("li", {
                 children: "Knowledge sources are validated before sync - credentials and permissions checked"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsx("li", {
                 children: "PDP enforces which workflows/agents can access which spaces"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsx("li", {
                 children: "All knowledge queries are audited with search terms and results"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsx("li", {
                 children: "Canonical knowledge is immutable once indexed - changes require re-sync"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsx("li", {
                 children: "Ephemeral knowledge is automatically purged based on retention policies"
-              }, undefined, false, undefined, this)
+              })
             ]
-          }, undefined, true, undefined, this)
+          })
         ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV("div", {
+      }),
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsxDEV("h2", {
+          /* @__PURE__ */ jsx("h2", {
             className: "text-2xl font-bold",
             children: "Best practices"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("ul", {
+          }),
+          /* @__PURE__ */ jsxs("ul", {
             className: "text-muted-foreground list-inside list-disc space-y-2",
             children: [
-              /* @__PURE__ */ jsxDEV("li", {
+              /* @__PURE__ */ jsx("li", {
                 children: "Use canonical spaces for policy-critical decisions, operational for suggestions"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsx("li", {
                 children: "Never allow workflows to write to canonical spaces - maintain read-only access"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsx("li", {
                 children: "Set up monitoring for sync failures and stale knowledge sources"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsx("li", {
                 children: "Document the purpose and trust level of each knowledge space"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsx("li", {
                 children: "Test knowledge queries in sandbox before promoting to production"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("li", {
+              }),
+              /* @__PURE__ */ jsxs("li", {
                 children: [
                   "Use explicit ",
-                  /* @__PURE__ */ jsxDEV("code", {
+                  /* @__PURE__ */ jsx("code", {
                     children: "allowedConsumers"
-                  }, undefined, false, undefined, this),
+                  }),
                   " - avoid wildcard access"
                 ]
-              }, undefined, true, undefined, this)
+              })
             ]
-          }, undefined, true, undefined, this)
+          })
         ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV("div", {
+      }),
+      /* @__PURE__ */ jsxs("div", {
         className: "flex items-center gap-4 pt-4",
         children: [
-          /* @__PURE__ */ jsxDEV(Link, {
+          /* @__PURE__ */ jsx(Link, {
             href: "/docs/architecture/integration-binding",
             className: "btn-ghost",
             children: "Previous: Integration Binding"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV(Link, {
+          }),
+          /* @__PURE__ */ jsxs(Link, {
             href: "/docs/knowledge",
             className: "btn-primary",
             children: [
               "Knowledge & Context ",
-              /* @__PURE__ */ jsxDEV(ChevronRight, {
+              /* @__PURE__ */ jsx(ChevronRight, {
                 size: 16
-              }, undefined, false, undefined, this)
+              })
             ]
-          }, undefined, true, undefined, this)
+          })
         ]
-      }, undefined, true, undefined, this)
+      })
     ]
-  }, undefined, true, undefined, this);
+  });
 }
 export {
   ArchitectureKnowledgeBindingPage