Add Authority Advisory AI and API Lifecycle Configuration

- Introduced AuthorityAdvisoryAiOptions and related classes for managing advisory AI configurations, including remote inference options and tenant-specific settings.
- Added AuthorityApiLifecycleOptions to control API lifecycle settings, including legacy OAuth endpoint configurations.
- Implemented validation and normalization methods for both advisory AI and API lifecycle options to ensure proper configuration.
- Created AuthorityNotificationsOptions and its related classes for managing notification settings, including ack tokens, webhooks, and escalation options.
- Developed IssuerDirectoryClient and related models for interacting with the issuer directory service, including caching mechanisms and HTTP client configurations.
- Added support for dependency injection through ServiceCollectionExtensions for the Issuer Directory Client.
- Updated project file to include necessary package references for the new Issuer Directory Client library.

scripts/render_docs.py

@@ -15,11 +15,12 @@ Dependencies:
 
 from __future__ import annotations
 
-import argparse
-import json
-import logging
-import os
-import shutil
+import argparse
+import json
+import logging
+import os
+import shutil
+import subprocess
 from dataclasses import dataclass
 from datetime import datetime, timezone
 from pathlib import Path
@@ -211,25 +212,44 @@ def write_index(entries: List[DocEntry], output_root: Path) -> None:
     logging.info("Wrote HTML index with %d entries", len(entries))
 
 
-def parse_args() -> argparse.Namespace:
-    parser = argparse.ArgumentParser(description="Render documentation bundle")
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Render documentation bundle")
     parser.add_argument("--source", default="docs", type=Path, help="Directory containing Markdown sources")
     parser.add_argument("--output", default=Path("build/docs-site"), type=Path, help="Directory for rendered output")
     parser.add_argument("--clean", action="store_true", help="Remove the output directory before rendering")
-    return parser.parse_args()
-
-
-def main() -> int:
-    logging.basicConfig(level=logging.INFO, format="%(levelname)s %(message)s")
-    args = parse_args()
-
-    source_root: Path = args.source.resolve()
-    output_root: Path = args.output.resolve()
-
-    if not source_root.exists():
-        logging.error("Source directory %s does not exist", source_root)
-        return os.EX_NOINPUT
-
+    return parser.parse_args()
+
+
+def run_attestor_validation(repo_root: Path) -> None:
+    """Execute the attestor schema + SDK validation prior to rendering docs."""
+    logging.info("Running attestor payload validation (npm run docs:attestor:validate)")
+    result = subprocess.run(
+        ["npm", "run", "docs:attestor:validate"],
+        cwd=repo_root,
+        check=False,
+    )
+    if result.returncode != 0:
+        raise RuntimeError("Attestor payload validation failed; aborting docs render.")
+
+
+def main() -> int:
+    logging.basicConfig(level=logging.INFO, format="%(levelname)s %(message)s")
+    args = parse_args()
+
+    source_root: Path = args.source.resolve()
+    output_root: Path = args.output.resolve()
+    repo_root = Path(__file__).resolve().parents[1]
+
+    if not source_root.exists():
+        logging.error("Source directory %s does not exist", source_root)
+        return os.EX_NOINPUT
+
+    try:
+        run_attestor_validation(repo_root)
+    except RuntimeError as exc:
+        logging.error("%s", exc)
+        return os.EX_DATAERR
+
     if args.clean and output_root.exists():
         logging.info("Cleaning existing output directory %s", output_root)
         shutil.rmtree(output_root)