Docs Overhaul: Goal-Centric Navigation & Dark Mode (#3)

* docs: overhaul navigation structure and enable dark mode

* fix: comment out watch paths to prevent CI build errors

* fix: completely comment out watch section to prevent CI errors

* fix(ci): checkout all required repositories for monorepo build

* chore: trigger ci after fixing upstream docs

* fix: correct link to node cli scoring guide

Author: beonde

.github/workflows/deploy.yml

@@ -41,19 +41,43 @@ jobs:
           path: capiscio-docs
           fetch-depth: 0  # Full history for git-revision-date plugin
 
-      - name: Checkout a2a-security
+      - name: Checkout capiscio-core
         uses: actions/checkout@v4
         with:
-          repository: capiscio/a2a-security
-          path: a2a-security
+          repository: capiscio/capiscio-core
+          path: capiscio-core
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
-      
-      - name: Checkout capiscio-cli
+
+      - name: Checkout capiscio-sdk-python
+        uses: actions/checkout@v4
+        with:
+          repository: capiscio/capiscio-sdk-python
+          path: capiscio-sdk-python
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Checkout capiscio-python
+        uses: actions/checkout@v4
+        with:
+          repository: capiscio/capiscio-python
+          path: capiscio-python
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Checkout capiscio-node
+        uses: actions/checkout@v4
+        with:
+          repository: capiscio/capiscio-node
+          path: capiscio-node
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Checkout validate-a2a
         uses: actions/checkout@v4
         with:
-          repository: capiscio/capiscio-cli
-          path: capiscio-cli
+          repository: capiscio/validate-a2a
+          path: validate-a2a
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 

Makefile

@@ -0,0 +1,23 @@
+.PHONY: install serve build clean
+
+VENV = .venv
+PYTHON = $(VENV)/bin/python
+PIP = $(VENV)/bin/pip
+MKDOCS = $(VENV)/bin/mkdocs
+
+$(VENV)/bin/activate: requirements-docs.txt
+	python3 -m venv $(VENV)
+	$(PIP) install -r requirements-docs.txt
+	touch $(VENV)/bin/activate
+
+install: $(VENV)/bin/activate
+
+serve: install
+	$(MKDOCS) serve
+
+build: install
+	$(MKDOCS) build
+
+clean:
+	rm -rf $(VENV)
+	rm -rf site

README.md

@@ -6,7 +6,7 @@ This repository contains the landing page for CapiscIO documentation at [docs.ca
 
 The landing page serves as a navigation hub for all CapiscIO product documentation:
 
-- **A2A Security** (`/a2a-security`) - Runtime security middleware
+- **Python SDK** (`/capiscio-sdk-python`) - Runtime security middleware
 - **CLI Tool** (`/cli`) - Command-line utilities (coming soon)
 
 ## Local Development

docs/community/contributing.md

@@ -16,8 +16,9 @@ Thank you for your interest in contributing to CapiscIO! We welcome contribution
 
 CapiscIO is organized as a monorepo documentation site with multiple products:
 
-- **[A2A Security](https://github.com/capiscio/a2a-security)** - Python middleware for Agent-to-Agent Protocol security
-- **[CapiscIO CLI](https://github.com/capiscio/capiscio-cli)** - Command-line tools for A2A validation and testing
+- **[Python SDK](https://github.com/capiscio/capiscio-sdk-python)** - Python middleware for Agent-to-Agent Protocol security
+- **[Node.js CLI](https://github.com/capiscio/capiscio-node)** - Command-line tools for A2A validation and testing
+- **[Python CLI](https://github.com/capiscio/capiscio-python)** - Python wrapper for the CLI
 - **[Documentation](https://github.com/capiscio/capiscio-docs)** - This unified documentation site
 
 ## 🚀 How to Contribute
@@ -26,8 +27,9 @@ CapiscIO is organized as a monorepo documentation site with multiple products:
 
 Found a bug or have a feature request? Please open an issue in the relevant repository:
 
-- **[A2A Security Issues](https://github.com/capiscio/a2a-security/issues){:target="_blank"}
-- [CapiscIO CLI Issues](https://github.com/capiscio/capiscio-cli/issues){:target="_blank"}
+- **[Python SDK Issues](https://github.com/capiscio/capiscio-sdk-python/issues){:target="_blank"}
+- **[Node.js CLI Issues](https://github.com/capiscio/capiscio-node/issues){:target="_blank"}
+- **[Python CLI Issues](https://github.com/capiscio/capiscio-python/issues){:target="_blank"}
 - [Documentation Issues](https://github.com/capiscio/capiscio-docs/issues){:target="_blank"}
 
 !!! tip "Good Bug Reports Include"
@@ -41,8 +43,9 @@ Found a bug or have a feature request? Please open an issue in the relevant repo
 
 Each product has its own contributing guidelines:
 
-- [A2A Security Contributing Guide](https://github.com/capiscio/a2a-security/blob/main/CONTRIBUTING.md)
-- [CLI Contributing Guide](https://github.com/capiscio/capiscio-cli/blob/main/CONTRIBUTING.md)
+- [Python SDK Contributing Guide](https://github.com/capiscio/capiscio-sdk-python/blob/main/CONTRIBUTING.md)
+- [Node.js CLI Contributing Guide](https://github.com/capiscio/capiscio-node/blob/main/CONTRIBUTING.md)
+- [Python CLI Contributing Guide](https://github.com/capiscio/capiscio-python/blob/main/CONTRIBUTING.md)
 
 ### 📝 Contributing to Documentation
 
@@ -52,8 +55,8 @@ Documentation contributions are always welcome! Here's how:
     Each product maintains its own docs that are aggregated into the unified site. You can edit docs in the product repo and they'll automatically appear in docs.capisc.io.
 
 **1. Fork the relevant repository**
-   - For product docs: Fork the product repo (e.g., `a2a-security`)
-   - For landing pages: Fork `capiscio-docs`
+   - For product docs: Fork the product repo (e.g., `capiscio-sdk-python`)
+   - For the main site: Fork `capiscio-docs`
 
 2. **Make your changes locally**
    ```bash
@@ -113,7 +116,7 @@ The unified documentation site aggregates all product docs:
 
 **Test a single product**:
 ```bash
-cd a2a-security  # or capiscio-cli
+cd capiscio-sdk-python  # or capiscio-node
 mkdocs serve
 ```
 
@@ -122,8 +125,8 @@ mkdocs serve
 # Directory structure needed:
 # parent/
 #   ├── capiscio-docs/
-#   ├── a2a-security/
-#   └── capiscio-cli/
+#   ├── capiscio-sdk-python/
+#   └── capiscio-node/
 
 cd capiscio-docs
 mkdocs build -f mkdocs-unified.yml
@@ -154,7 +157,7 @@ Our documentation uses a confident, helpful voice:
 **Example:**
 
 ```python
-from capiscio_a2a_security import secure
+from capiscio_sdk import secure
 
 # Wrap your agent with security
 secured_agent = secure(MyAgentExecutor())
@@ -180,8 +183,8 @@ We use Material for MkDocs with these extensions:
 
 By participating in this project, you agree to abide by our Code of Conduct:
 
-- [A2A Security Code of Conduct](https://github.com/capiscio/a2a-security/blob/main/CODE_OF_CONDUCT.md)
-- [CLI Code of Conduct](https://github.com/capiscio/capiscio-cli/blob/main/CODE_OF_CONDUCT.md)
+- [Python SDK Code of Conduct](https://github.com/capiscio/capiscio-sdk-python/blob/main/CODE_OF_CONDUCT.md)
+- [Node.js CLI Code of Conduct](https://github.com/capiscio/capiscio-node/blob/main/CODE_OF_CONDUCT.md)
 
 ## Questions?
 
@@ -194,7 +197,7 @@ By participating in this project, you agree to abide by our Code of Conduct:
 ## See Also
 
 - **[Getting Help](support.md)** - Support resources and FAQs
-- **[A2A Security Contributing](https://github.com/capiscio/a2a-security/blob/main/CONTRIBUTING.md){:target="_blank"}** - Product-specific guidelines
-- **[CapiscIO CLI Contributing](https://github.com/capiscio/capiscio-cli/blob/main/CONTRIBUTING.md){:target="_blank"}** - CLI contribution guide
+- **[Python SDK Contributing](https://github.com/capiscio/capiscio-sdk-python/blob/main/CONTRIBUTING.md){:target="_blank"}** - Product-specific guidelines
+- **[Node.js CLI Contributing](https://github.com/capiscio/capiscio-node/blob/main/CONTRIBUTING.md){:target="_blank"}** - CLI contribution guide
 
 Thank you for helping make CapiscIO better! 🚀

docs/community/support.md

@@ -6,38 +6,39 @@ Need help with CapiscIO? Here are the best ways to get support.
 
 Start with the documentation for your specific product:
 
-- **[A2A Security Documentation](../a2a-security/index.md)** - Security middleware guides and API reference
-- **[CapiscIO CLI Documentation](../capiscio-cli/README.md)** - Command-line tools and validation
+- **[Python SDK Documentation](../capiscio-python-sdk/index.md)** - Security middleware guides and API reference
+- **[Node.js CLI Documentation](../capiscio-node-js-cli/index.md)** - Command-line tools and validation
+- **[Python CLI Documentation](../capiscio-python-cli/index.md)** - Python wrapper for the CLI
 
 ## Quick Links
 
 ### Getting Started
 
-- [A2A Security Quick Start](../a2a-security/getting-started/quickstart.md)
-- [CapiscIO CLI Getting Started](../capiscio-cli/README.md)
+- [Python SDK Quick Start](../capiscio-python-sdk/getting-started/quickstart.md)
+- [Node.js CLI Getting Started](../capiscio-node-js-cli/index.md)
 - [A2A Protocol Specification](https://github.com/a2aproject/A2A){:target="_blank"}
 
 ### Common Tasks
 
-**For A2A Security:**
+**For Python SDK:**
 
-- [Installation & Setup](../a2a-security/getting-started/installation.md)
-- [Configuration Guide](../a2a-security/guides/configuration.md)
-- [Core Concepts](../a2a-security/getting-started/concepts/)
+- [Installation & Setup](../capiscio-python-sdk/getting-started/installation.md)
+- [Configuration Guide](../capiscio-python-sdk/guides/configuration.md)
+- [Core Concepts](../capiscio-python-sdk/getting-started/concepts.md)
 
-**For CapiscIO CLI:**
+**For Node.js CLI:**
 
-- [Validation Process](../capiscio-cli/validation-process.md)
-- [Scoring System](../capiscio-cli/scoring-system/)
-- [Architecture](../capiscio-cli/architecture.md)
+- [Validation Process](../concepts/validation.md)
+- [Scoring System](../concepts/scoring.md)
+- [Architecture](../capiscio-node-js-cli/reference/architecture.md)
 
 ## GitHub Resources
 
 ### Issues & Bug Reports
 
 Report bugs or request features in the relevant repository:
 
-- [A2A Security Issues](https://github.com/capiscio/a2a-security/issues){:target="_blank"}
+- [Python SDK Issues](https://github.com/capiscio/capiscio-sdk-python/issues){:target="_blank"}
 - [CapiscIO CLI Issues](https://github.com/capiscio/capiscio-cli/issues){:target="_blank"}
 - [Documentation Issues](https://github.com/capiscio/capiscio-docs/issues){:target="_blank"}
 
@@ -60,10 +61,10 @@ Want to contribute? See our [Contributing Guide](contributing.md) for details on
 
 ## Package Resources
 
-### Python (A2A Security)
+### Python (SDK)
 
-- **PyPI**: [a2a-security package](https://pypi.org/project/a2a-security.md)
-- **Installation**: `pip install a2a-security`
+- **PyPI**: [capiscio-sdk-python package](https://pypi.org/project/capiscio-sdk-python/)
+- **Installation**: `pip install capiscio-sdk-python`
 - **Requirements**: Python 3.10+
 
 ### Node.js (CapiscIO CLI)
@@ -87,22 +88,22 @@ CapiscIO implements the Agent-to-Agent (A2A) Protocol. Learn more:
 We welcome contributions! Check out:
 
 - [Contributing Guidelines](contributing.md)
-- [Code of Conduct](https://github.com/capiscio/a2a-security/blob/main/CODE_OF_CONDUCT.md)
-- [Security Policy](https://github.com/capiscio/a2a-security/blob/main/SECURITY.md)
+- [Code of Conduct](https://github.com/capiscio/capiscio-sdk-python/blob/main/CODE_OF_CONDUCT.md)
+- [Security Policy](https://github.com/capiscio/capiscio-sdk-python/blob/main/SECURITY.md)
 
 ### Stay Updated
 
 - **GitHub**: Watch the repositories for updates
-  - [capiscio/a2a-security](https://github.com/capiscio/a2a-security)
-  - [capiscio/capiscio-cli](https://github.com/capiscio/capiscio-cli)
-- **Releases**: Check [Releases](https://github.com/capiscio/a2a-security/releases) for changelogs
+  - [capiscio/capiscio-sdk-python](https://github.com/capiscio/capiscio-sdk-python)
+  - [capiscio/capiscio-node](https://github.com/capiscio/capiscio-node)
+- **Releases**: Check [Releases](https://github.com/capiscio/capiscio-sdk-python/releases) for changelogs
 
 ## Security Issues
 
 Found a security vulnerability? Please report it responsibly:
 
 - **Do not** open a public issue
-- See [Security Policy](https://github.com/capiscio/a2a-security/blob/main/SECURITY.md) for reporting process
+- See [Security Policy](https://github.com/capiscio/capiscio-sdk-python/blob/main/SECURITY.md) for reporting process
 - Security issues are handled with priority
 
 ## Frequently Asked Questions
@@ -112,13 +113,13 @@ Found a security vulnerability? Please report it responsibly:
 
 ### Installation Issues
 
-**Q: `pip install capiscio-a2a-security` fails**
+**Q: `pip install capiscio-sdk-python` fails**
 
 A: Ensure you have Python 3.10 or higher:
 ```bash
 python --version
 pip install --upgrade pip
-pip install a2a-security
+pip install capiscio-sdk-python
 ```
 
 **Q: CLI command not found after installation**
@@ -140,7 +141,7 @@ capiscio validate path/to/agent-card.json
 
 Or programmatically with Python:
 ```python
-from a2a_security import validate_message
+from capiscio_sdk import validate_message
 
 result = validate_message(message_data)
 ```
@@ -155,9 +156,9 @@ A: Check the [CLI repository examples](https://github.com/capiscio/capiscio-cli/
 
 A: Each repository has its own test suite:
 
-**A2A Security**:
+**Python SDK**:
 ```bash
-cd a2a-security
+cd capiscio-sdk-python
 pip install -e ".[dev]"
 pytest
 ```
@@ -182,7 +183,7 @@ mkdocs serve
 
 If you can't find what you're looking for:
 
-1. Search existing [GitHub Issues](https://github.com/capiscio/a2a-security/issues)
+1. Search existing [GitHub Issues](https://github.com/capiscio/capiscio-sdk-python/issues)
 2. Check the [A2A Specification](https://github.com/a2aproject/A2A)
 3. Open a new issue with details about your problem