Fix dead links for namespace variables in generated docs

resolve_namespace_target was only using the last segment of the module
path, producing broken links like ./llm instead of ./client/llm when
rendering the top-level index. Now computes a proper relative path.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: 2 people

docs/opengradient/index.md

@@ -140,10 +140,10 @@ def __init__(private_key: str, email: Optional[str] = None, password: Optio
 
 #### Variables
 
-* [**`inference`**](./onchain_inference): On-chain ONNX model inference via blockchain smart contracts.
-* [**`llm`**](./llm): LLM chat and completion via TEE-verified execution.
-* [**`model_hub`**](./model_hub): Model Hub for creating, versioning, and uploading ML models.
-* [**`alpha`**](./alpha): Alpha Testnet features including workflow management and ML model execution.
+* [**`inference`**](./client/onchain_inference): On-chain ONNX model inference via blockchain smart contracts.
+* [**`llm`**](./client/llm): LLM chat and completion via TEE-verified execution.
+* [**`model_hub`**](./client/model_hub): Model Hub for creating, versioning, and uploading ML models.
+* [**`alpha`**](./client/alpha): Alpha Testnet features including workflow management and ML model execution.
 
 ### `InferenceMode`
 

templates/text.mako

@@ -68,12 +68,16 @@ def resolve_namespace_target(v):
   """If v's type resolves to an opengradient class in a different module, return link target."""
   result = [None]
   var_mod = v.module.name if hasattr(v, 'module') and v.module else ''
+  cur_parts = var_mod.split('.')
   def capture(dobj):
     if not isinstance(dobj, pdoc.Module) and hasattr(dobj, 'module') and dobj.module is not None:
       mod_parts = dobj.module.name.split('.')
       if (len(mod_parts) >= 2 and mod_parts[0] == 'opengradient'
           and dobj.module.name != var_mod):
-        result[0] = mod_parts[-1] if len(mod_parts) > 2 else mod_parts[1]
+        common = sum(1 for a, b in zip(cur_parts, mod_parts) if a == b)
+        remaining = mod_parts[common:]
+        if remaining:
+          result[0] = '/'.join(remaining)
     return '`{}`'.format(dobj.qualname.split('.')[-1])
   if show_type_annotations:
     v.type_annotation(link=capture)