Skip to content

Agent Mesh

fix docs links

Antonio Ojeac2e6d4823cbc
diff --git a/docs/README.md b/docs/README.md
index f837b3a9..77a72008 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -164,10 +164,10 @@ SAM enables this sovereignty by moving trust from **authorities** to **cryptogra
## Next Steps
-- **[Getting Started](/guides/dark-mesh.md)**: Set up an enterprise dark mesh
-- **[CLI Reference](/cli/reference.md)**: Full kubectl-style command hierarchy
-- **[Technical Deep Dive](/concepts/federation.md)**: How federation isolation works
-- **[Testing Guide](/testing.md)**: Run the test suite locally
+- **[Getting Started](#/guides/dark-mesh.md)**: Set up an enterprise dark mesh
+- **[CLI Reference](#/cli/reference.md)**: Full kubectl-style command hierarchy
+- **[Technical Deep Dive](#/concepts/federation.md)**: How federation isolation works
+- **[Testing Guide](#/testing.md)**: Run the test suite locally
## Philosophy
diff --git a/docs/_coverpage.md b/docs/_coverpage.md
index cc1bd217..4cc016cb 100644
--- a/docs/_coverpage.md
+++ b/docs/_coverpage.md
@@ -9,9 +9,9 @@
- **Federation-Ready**: Isolated namespaces for enterprise dark meshes
- **Audit-First**: Built-in transparency for security compliance
-[Documentation](/README.md)
-[GitHub](https://github.com/your-org/sam)
-[Getting Started](#features)
+[Documentation](#/README.md)
+[GitHub](https://github.com/aojea/sam)
+[Getting Started](#/quickstart.md)
---
diff --git a/docs/_sidebar.md b/docs/_sidebar.md
index 84838b31..57971e26 100644
--- a/docs/_sidebar.md
+++ b/docs/_sidebar.md
@@ -1,47 +1,27 @@
<!-- Sidebar Navigation -->
- **Getting Started**
- - [Overview](/README.md)
- - [Quick Start](/guides/dark-mesh.md)
-
-- **User Guides**
- - [Enterprise Dark Mesh](/guides/dark-mesh.md)
- - [Setting Up a Federation](/guides/federation-setup.md)
- - [Publishing an Agent](/guides/publish-agent.md)
+ - [Overview](#/README.md)
+ - [Quick Start](#/quickstart.md)
+ - [Enterprise Dark Mesh](#/guides/dark-mesh.md)
- **CLI Reference**
- - [Command Hierarchy](/cli/reference.md)
- - [sam identity](/cli/identity.md)
- - [sam publish](/cli/publish.md)
- - [sam call](/cli/call.md)
- - [sam inspect](/cli/inspect.md)
- - [sam mesh](/cli/mesh.md)
+ - [Command Hierarchy](#/cli/reference.md)
- **Technical Concepts**
- - [Federation & Storage](/concepts/federation.md)
- - [Identity & Vouch System](/concepts/identity.md)
- - [Biscuit Authorization](/concepts/biscuit.md)
- - [Agent Card Format](/concepts/agent-card.md)
- - [A2A Protocol](/concepts/a2a-protocol.md)
+ - [Federation & Storage](#/concepts/federation.md)
+ - [Identity & Vouch System](#/concepts/identity.md)
+ - [Biscuit Authorization](#/concepts/biscuit.md)
+ - [A2A Protocol](#/concepts/a2a-protocol.md)
- **Testing**
- - [Testing Guide](/testing.md)
- - [Running Tests Locally](/testing.md#running-tests)
- - [BATS E2E Tests](/testing.md#bats-e2e)
- - [Go Integration Tests](/testing.md#go-integration)
-
-- **Operations**
- - [Deployment Guide](/operations/deployment.md)
- - [Monitoring](/operations/monitoring.md)
- - [Troubleshooting](/operations/troubleshooting.md)
+ - [Testing Guide](#/testing.md)
- **Contributing**
- - [Contributing Guide](/contributing.md)
- - [Development Setup](/contributing.md#setup)
- - [Code Style](/contributing.md#style)
- - [Submitting Changes](/contributing.md#submit)
+ - [Contributing Guide](#/contributing.md)
- **Resources**
- - [FAQ](/faq.md)
- - [Glossary](/glossary.md)
- - [License](https://github.com/your-org/sam/blob/main/LICENSE)
+ - [FAQ](#/faq.md)
+ - [Glossary](#/glossary.md)
+ - [Documentation Inventory](#/DOCUMENTATION.md)
+ - [License](https://github.com/aojea/sam/blob/main/LICENSE)
diff --git a/docs/cli/reference.md b/docs/cli/reference.md
index 65a31baf..9c7bd19a 100644
--- a/docs/cli/reference.md
+++ b/docs/cli/reference.md
@@ -522,5 +522,5 @@ Use these to:
## Next Steps
-- **[User Journey Guide](/guides/dark-mesh.md)**: Full scenario walkthrough
-- **[Concepts](/concepts/federation.md)**: Technical deep dive
+- **[User Journey Guide](#/guides/dark-mesh.md)**: Full scenario walkthrough
+- **[Concepts](#/concepts/federation.md)**: Technical deep dive
diff --git a/docs/concepts/a2a-protocol.md b/docs/concepts/a2a-protocol.md
index f0cf76be..e30dddd0 100644
--- a/docs/concepts/a2a-protocol.md
+++ b/docs/concepts/a2a-protocol.md
@@ -404,15 +404,15 @@ If direct connection fails, libp2p automatically:
## Related Concepts
-- **[Vouch](/concepts/identity.md)**: Authentication mechanism
-- **[Biscuit](/concepts/biscuit.md)**: Authorization mechanism
-- **[Federation](/concepts/federation.md)**: Network isolation
-- **[CLI](/cli/reference.md)**: How to invoke A2A calls
+- **[Vouch](#/concepts/identity.md)**: Authentication mechanism
+- **[Biscuit](#/concepts/biscuit.md)**: Authorization mechanism
+- **[Federation](#/concepts/federation.md)**: Network isolation
+- **[CLI](#/cli/reference.md)**: How to invoke A2A calls
---
## Next Steps
-- **[Try it Out](/guides/dark-mesh.md)**: Make your first A2A call
-- **[Integration Tests](/tests/integration/)**: See A2A in action
-- **[Contributing](/contributing.md)**: Help improve the protocol
+- **[Try it Out](#/guides/dark-mesh.md)**: Make your first A2A call
+- **[Integration Tests](https://github.com/aojea/sam/tree/main/tests/integration)**: See A2A in action
+- **[Contributing](#/contributing.md)**: Help improve the protocol
diff --git a/docs/concepts/biscuit.md b/docs/concepts/biscuit.md
index 002a3269..c24dfaa6 100644
--- a/docs/concepts/biscuit.md
+++ b/docs/concepts/biscuit.md
@@ -486,6 +486,6 @@ return executeSkill(ctx, capability, payload)
## Next Steps
-- **[Identity & Vouch System](/concepts/identity.md)**: How authentication works
-- **[A2A Protocol](/concepts/a2a-protocol.md)**: How authorization is enforced
-- **[CLI Reference](/cli/reference.md)**: `sam inspect biscuit` usage
+- **[Identity & Vouch System](#/concepts/identity.md)**: How authentication works
+- **[A2A Protocol](#/concepts/a2a-protocol.md)**: How authorization is enforced
+- **[CLI Reference](#/cli/reference.md)**: `sam inspect biscuit` usage
diff --git a/docs/concepts/federation.md b/docs/concepts/federation.md
index e14f3037..fb021f74 100644
--- a/docs/concepts/federation.md
+++ b/docs/concepts/federation.md
@@ -388,6 +388,6 @@ Federated Database Architecture:
## Next Steps
-- **[Identity & Vouch System](/concepts/identity.md)**: Deep dive into how identity works
-- **[Biscuit Authorization](/concepts/biscuit.md)**: How skill-based access control works
-- **[A2A Protocol](/concepts/a2a-protocol.md)**: How agents authenticate and call each other
+- **[Identity & Vouch System](#/concepts/identity.md)**: Deep dive into how identity works
+- **[Biscuit Authorization](#/concepts/biscuit.md)**: How skill-based access control works
+- **[A2A Protocol](#/concepts/a2a-protocol.md)**: How agents authenticate and call each other
diff --git a/docs/concepts/identity.md b/docs/concepts/identity.md
index a21a3149..30d1ad31 100644
--- a/docs/concepts/identity.md
+++ b/docs/concepts/identity.md
@@ -428,6 +428,6 @@ sam inspect biscuit "bob;allow_skill=risk-audit"
## Next Steps
-- **[Biscuit Authorization](/concepts/biscuit.md)**: How skill-based access control works
-- **[Federation & Storage](/concepts/federation.md)**: How federation isolation works
-- **[A2A Protocol](/concepts/a2a-protocol.md)**: How agents authenticate to each other
+- **[Biscuit Authorization](#/concepts/biscuit.md)**: How skill-based access control works
+- **[Federation & Storage](#/concepts/federation.md)**: How federation isolation works
+- **[A2A Protocol](#/concepts/a2a-protocol.md)**: How agents authenticate to each other
diff --git a/docs/contributing.md b/docs/contributing.md
index 23caf5b0..b805cd54 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -22,7 +22,7 @@ We welcome contributions! This guide covers:
```bash
# Clone the repository
-git clone https://github.com/your-org/sam.git
+git clone https://github.com/aojea/sam.git
cd sam
# Build the binary
diff --git a/docs/faq.md b/docs/faq.md
index aa2ad511..6eda6a87 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -13,7 +13,7 @@ In short: **Pure P2P networks for agents, with cryptographic identity**.
### How do I install SAM?
```bash
-git clone https://github.com/your-org/sam.git
+git clone https://github.com/aojea/sam.git
cd sam
make build
./bin/sam --help
@@ -44,7 +44,7 @@ Requirements: Go 1.21+, Make, BATS (for E2E tests)
sam call mycapability --federation mynet --message "Do something"
```
-See [User Journey Guide](/guides/dark-mesh.md) for a full walkthrough.
+See [User Journey Guide](#/guides/dark-mesh.md) for a full walkthrough.
---
@@ -67,7 +67,7 @@ A **vouch** is a cryptographic credential proving your identity to a federation.
- Includes your subject (username), PeerID, and expiry
- Signed by the hub (so we trust the issuer, not a server)
-See [Identity & Vouch System](/concepts/identity.md).
+See [Identity & Vouch System](#/concepts/identity.md).
### What's a Biscuit?
@@ -79,7 +79,7 @@ Format: `alice;allow_skill=weather-bot,risk-audit`
- No central revocation (revoke by deleting locally)
- Plain-text for transparency
-See [Biscuit Authorization](/concepts/biscuit.md).
+See [Biscuit Authorization](#/concepts/biscuit.md).
### What's an Agent Card?
@@ -169,7 +169,7 @@ If direct connection fails:
2. Fall back to relay
3. Communication works either way
-See [CUJ-2 Test](/tests/integration/cuj_test.go) for example.
+See [CUJ-2 Test](https://github.com/aojea/sam/blob/main/tests/integration/cuj_test.go) for example.
### Can I run a SAM node in the cloud?
@@ -408,10 +408,10 @@ func main() {
Yes. Import SAM as a Go library:
```bash
-go get github.com/your-org/sam
+go get github.com/aojea/sam
```
-See [pkg/net](/pkg/net), [pkg/protocol](/pkg/protocol), [pkg/economy](/pkg/economy).
+See [pkg/net](https://github.com/aojea/sam/tree/main/pkg/net), [pkg/protocol](https://github.com/aojea/sam/tree/main/pkg/protocol), [pkg/economy](https://github.com/aojea/sam/tree/main/pkg/economy).
### Can I use SAM with Docker/Kubernetes?
@@ -433,7 +433,7 @@ For Kubernetes: Mount `~/.config/sam` as a persistent volume.
### How do I contribute?
-See [Contributing Guide](/contributing.md).
+See [Contributing Guide](#/contributing.md).
In short:
1. Fork the repo
@@ -500,7 +500,7 @@ Open an issue describing your use case. We prioritize based on:
### What license is SAM under?
-[Check LICENSE file](https://github.com/your-org/sam/blob/main/LICENSE)
+[Check LICENSE file](https://github.com/aojea/sam/blob/main/LICENSE)
Typically: MIT or Apache 2.0
@@ -510,7 +510,7 @@ Yes, as long as you comply with the license (usually MIT/Apache means you can).
### Do I need to contribute back to SAM?
-Not required, but appreciated. See [Contributing Guide](/contributing.md).
+Not required, but appreciated. See [Contributing Guide](#/contributing.md).
---
diff --git a/docs/glossary.md b/docs/glossary.md
index 427d792f..13e772d9 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -272,6 +272,6 @@
## See Also
-- **[Concepts](/concepts/federation.md)**: Technical deep dives
-- **[FAQ](/faq.md)**: Common questions answered
-- **[CLI Reference](/cli/reference.md)**: Command documentation
+- **[Concepts](#/concepts/federation.md)**: Technical deep dives
+- **[FAQ](#/faq.md)**: Common questions answered
+- **[CLI Reference](#/cli/reference.md)**: Command documentation
diff --git a/docs/guides/dark-mesh.md b/docs/guides/dark-mesh.md
index cc4a735c..7bfc8af1 100644
--- a/docs/guides/dark-mesh.md
+++ b/docs/guides/dark-mesh.md
@@ -444,7 +444,7 @@ Operations Federation (isolated namespace: /sam/fed/operations)
## Next Steps
-1. **Setup Your Federations**: [Federation Setup Guide](/guides/federation-setup.md)
-2. **Publish Your First Agent**: [Publishing Guide](/guides/publish-agent.md)
-3. **CLI Reference**: Full command documentation at [CLI Reference](/cli/reference.md)
-4. **Technical Deep Dive**: Understand federation storage at [Federation & Storage](/concepts/federation.md)
+1. **Setup Your Federations**: [CLI Reference](#/cli/reference.md)
+2. **Publish Your First Agent**: [Quick Start](#/quickstart.md)
+3. **CLI Reference**: Full command documentation at [CLI Reference](#/cli/reference.md)
+4. **Technical Deep Dive**: Understand federation storage at [Federation & Storage](#/concepts/federation.md)
diff --git a/docs/index.html b/docs/index.html
index 7c5d7674..b82b196a 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -51,10 +51,9 @@
<script>
window.$docsify = {
name: '<img src="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text x=%2210%22 y=%2275%22 font-size=%2280%22 fill=%22%236366f1%22>⚡</text></svg>" style="height: 2rem; margin-right: 8px;"/> SAM',
- repo: 'https://github.com/your-org/sam',
+ repo: 'https://github.com/aojea/sam',
// Documentation settings
- basePath: '/',
loadSidebar: true,
loadNavbar: false,
coverpage: true,
@@ -130,7 +129,7 @@
// Footer
footer: {
- copy: '<span>&copy; 2026 SAM Contributors. <a href="https://github.com/your-org/sam/blob/main/LICENSE">License</a></span>',
+ copy: '<span>&copy; 2026 SAM Contributors. <a href="https://github.com/aojea/sam/blob/main/LICENSE">License</a></span>',
auth: '',
pre: '<hr/>',
style: 'text-align: center;',
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 474a77d1..5d24c837 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -3,7 +3,7 @@
## Installation
```bash
-git clone https://github.com/your-org/sam.git
+git clone https://github.com/aojea/sam.git
cd sam
make build
./bin/sam --help
@@ -152,13 +152,13 @@ sam inspect card '{"peer_id":"...","agent_card":{...}}'
## Documentation
-- **[Overview](/README.md)**: What SAM is and why it matters
-- **[User Journey](/guides/dark-mesh.md)**: Step-by-step walkthrough
-- **[CLI Reference](/cli/reference.md)**: Full command documentation
-- **[Concepts](/concepts/federation.md)**: Technical deep dives
-- **[Testing](/testing.md)**: How to run and write tests
-- **[FAQ](/faq.md)**: Common questions
-- **[Glossary](/glossary.md)**: Terminology reference
+- **[Overview](#/README.md)**: What SAM is and why it matters
+- **[User Journey](#/guides/dark-mesh.md)**: Step-by-step walkthrough
+- **[CLI Reference](#/cli/reference.md)**: Full command documentation
+- **[Concepts](#/concepts/federation.md)**: Technical deep dives
+- **[Testing](#/testing.md)**: How to run and write tests
+- **[FAQ](#/faq.md)**: Common questions
+- **[Glossary](#/glossary.md)**: Terminology reference
---
@@ -172,7 +172,7 @@ sam <command> --help
SAM_DEBUG=1 sam <command>
# Report bugs
-https://github.com/your-org/sam/issues
+https://github.com/aojea/sam/issues
```
---
diff --git a/docs/testing.md b/docs/testing.md
index 34d6b68b..5516de35 100644
--- a/docs/testing.md
+++ b/docs/testing.md
@@ -421,6 +421,6 @@ func TestExample(t *testing.T) {
## Next Steps
-- **[Quick Start](/guides/dark-mesh.md)**: Set up SAM locally
-- **[CLI Reference](/cli/reference.md)**: Test with real commands
-- **[Contributing](/contributing.md)**: Submit a test PR
+- **[Quick Start](#/guides/dark-mesh.md)**: Set up SAM locally
+- **[CLI Reference](#/cli/reference.md)**: Test with real commands
+- **[Contributing](#/contributing.md)**: Submit a test PR