Skip to content

Commit 8430cc2

Browse files
author
OpenSIN-AI
committed
fix: repair 7 dead internal links, expand sidebar with 25+ orphan docs, add fleet/governance/migrations docs
- Fixed 7 dead links: /docs/ prefix removed (VitePress uses root-relative paths) - Expanded sidebar: Best Practices (18 items), SDK (11), Tutorials (7), Plugins (9), Architecture (6), Bridges (4) - Added nav links: Fleet, Governance, Migrations, Best Practices, Bridges - Added migrations/overview.md (new section) - Build verified: 0 errors, 0 dead links
1 parent c13e068 commit 8430cc2

8 files changed

Lines changed: 130 additions & 7 deletions

File tree

‎.vitepress/config.js‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,13 @@ export default defineConfig({
2020
{ text: 'Architecture', link: '/architecture/overview' },
2121
{ text: 'SDK', link: '/sdk/overview' },
2222
{ text: 'Plugins', link: '/plugins/registry' },
23+
{ text: 'Fleet', link: '/fleet/overview' },
24+
{ text: 'Governance', link: '/governance/overview' },
2325
{ text: 'Tutorials', link: '/tutorials/first-agent' },
2426
{ text: 'Examples', link: '/examples/hello-world' },
27+
{ text: 'Best Practices', link: '/best-practices/' },
28+
{ text: 'Bridges', link: '/bridges/' },
29+
{ text: 'Migrations', link: '/migrations/overview' },
2530
],
2631
sidebar: [
2732
{
@@ -65,6 +70,7 @@ export default defineConfig({
6570
{ text: 'A2A', link: '/architecture/a2a' },
6671
{ text: 'Security', link: '/architecture/security' },
6772
{ text: 'Global Brain & Neural-Bus', link: '/architecture/global-brain-neural-bus' },
73+
{ text: 'Hacker Bypass (5-Layer)', link: '/architecture/hacker-bypass' },
6874
],
6975
},
7076
{
@@ -77,6 +83,8 @@ export default defineConfig({
7783
{ text: 'Safety Net', link: '/plugins/safety-net' },
7884
{ text: 'Context Analysis', link: '/plugins/context-analysis' },
7985
{ text: 'Agent Memory', link: '/plugins/agent-memory' },
86+
{ text: 'MCP Servers', link: '/plugins/mcp-servers' },
87+
{ text: 'OpenSIN Code Plugins', link: '/plugins/opensin-code-plugins' },
8088
],
8189
},
8290
{
@@ -90,6 +98,9 @@ export default defineConfig({
9098
{ text: 'Model Routing', link: '/sdk/model-routing' },
9199
{ text: 'Parallel Execution', link: '/sdk/parallel-execution' },
92100
{ text: 'Safety', link: '/sdk/safety' },
101+
{ text: 'Sessions', link: '/sdk/sessions' },
102+
{ text: 'Tool System', link: '/sdk/tool-system' },
103+
{ text: 'Usage & Pricing', link: '/sdk/usage-pricing' },
93104
],
94105
},
95106
{
@@ -118,6 +129,10 @@ export default defineConfig({
118129
{ text: 'First Agent', link: '/tutorials/first-agent' },
119130
{ text: 'Plugin Development', link: '/tutorials/plugin-development' },
120131
{ text: 'A2A Communication', link: '/tutorials/a2a-communication' },
132+
{ text: 'Advanced Orchestration', link: '/tutorials/advanced-orchestration' },
133+
{ text: 'Agent Basics', link: '/tutorials/agent-basics' },
134+
{ text: 'Custom Agents', link: '/tutorials/custom-agents' },
135+
{ text: 'Multi-Agent', link: '/tutorials/multi-agent' },
121136
],
122137
},
123138
{
@@ -132,16 +147,33 @@ export default defineConfig({
132147
{
133148
text: 'Best Practices',
134149
items: [
150+
{ text: 'Overview', link: '/best-practices/' },
135151
{ text: 'Agent Design', link: '/best-practices/agent-design' },
152+
{ text: 'A2A Communication', link: '/best-practices/a2a-communication' },
153+
{ text: 'Browser Automation', link: '/best-practices/browser-automation' },
154+
{ text: 'CI/CD & n8n', link: '/best-practices/ci-cd-n8n' },
155+
{ text: 'Code Quality', link: '/best-practices/code-quality' },
156+
{ text: 'Error Handling', link: '/best-practices/error-handling' },
157+
{ text: 'HF Fleet Keepalive', link: '/best-practices/hf-fleet-keepalive' },
158+
{ text: 'MCP Integration', link: '/best-practices/mcp-integration' },
159+
{ text: 'Monitoring & Observability', link: '/best-practices/monitoring-observability' },
136160
{ text: 'Performance', link: '/best-practices/performance' },
161+
{ text: 'Plugin Development', link: '/best-practices/plugin-development' },
137162
{ text: 'Security', link: '/best-practices/security' },
163+
{ text: 'SEO Pipeline', link: '/best-practices/seo-pipeline' },
164+
{ text: 'Simone MCP + PCPM', link: '/best-practices/simone-mcp-pcpm' },
165+
{ text: 'Software 3.0 — Neural-Bus', link: '/best-practices/software-3.0-neural-bus' },
166+
{ text: 'Team Orchestration', link: '/best-practices/team-orchestration' },
167+
{ text: 'Testing', link: '/best-practices/testing' },
138168
],
139169
},
140170
{
141171
text: 'Bridges',
142172
items: [
173+
{ text: 'Overview', link: '/bridges/' },
143174
{ text: 'Chrome Extension', link: '/bridges/chrome-extension' },
144175
{ text: 'OpenSIN Bridge', link: '/bridges/opensin-bridge-overview' },
176+
{ text: 'Bridge Monetization', link: '/bridges/opensin-bridge-monetization' },
145177
],
146178
},
147179
],

‎docs/best-practices/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ It is not a loose suggestion shelf. It is the operational memory of the system.
3535
| [Plugin Development](/best-practices/plugin-development) | Plugin architecture and extension rules |
3636
| [Performance](/best-practices/performance) | Cost, model routing, latency, efficiency |
3737
| [Security](/best-practices/security) | Secrets, auth boundaries, operator trust |
38-
| [Software 3.0: Neural-Bus](/docs/best-practices/software-3.0-neural-bus) | Higher-level architecture doctrine |
38+
| [Software 3.0: Neural-Bus](/best-practices/software-3.0-neural-bus) | Higher-level architecture doctrine |
3939
| [SEO Pipeline](/best-practices/seo-pipeline) | Proof-of-work blog publishing pipeline |
4040
| [**Simone MCP + PCPM** ⭐ PFLICHT](/best-practices/simone-mcp-pcpm) | Semantic code intelligence + cross-session memory — mandatory for every agent |
4141

‎docs/bridges/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
- [OpenSIN-Bridge Monetization](/docs/bridges/opensin-bridge-monetization)
1+
- [OpenSIN-Bridge Monetization](/bridges/opensin-bridge-monetization)

‎docs/guide/opensin-code.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ Die Rust Engine bietet ein performantes Backend:
9898

9999
## Plugin-System
100100

101-
OpenSIN-Code kommt mit 14 vorinstallierten Plugins. Siehe [Plugin-Dokumentation](/docs/plugins/opensin-code-plugins) für Details.
101+
OpenSIN-Code kommt mit 14 vorinstallierten Plugins. Siehe [Plugin-Dokumentation](/plugins/opensin-code-plugins) für Details.
102102

103103
### Eigene Plugins entwickeln
104104

@@ -114,7 +114,7 @@ mkdir -p plugins/sin-mein-plugin/skills
114114
mkdir -p plugins/sin-mein-plugin/hooks
115115
```
116116

117-
Siehe [Plugin Development Tutorial](/docs/tutorials/plugin-development) für eine Schritt-für-Schritt-Anleitung.
117+
Siehe [Plugin Development Tutorial](/tutorials/plugin-development) für eine Schritt-für-Schritt-Anleitung.
118118

119119
---
120120

‎docs/guide/troubleshooting.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Common issues and their solutions.
1111
## High Error Rate
1212

1313
1. Review error patterns
14-
2. Check rate limits (For Google accounts and OpenAI pools, see [Dual Auth Rotators](/docs/examples/dual-auth-rotators))
14+
2. Check rate limits (For Google accounts and OpenAI pools, see [Dual Auth Rotators](/examples/dual-auth-rotators))
1515
3. Verify input format
1616

1717
## High Latency

‎docs/migrations/overview.md‎

Lines changed: 91 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,91 @@
1+
# Migrations Overview — OpenSIN-AI Migration Guides
2+
3+
**Status:** Active
4+
**Owner:** Team Coding
5+
6+
---
7+
8+
## What Are Migrations?
9+
10+
Migration guides document the process of transitioning between versions, architectures, or configurations in the OpenSIN-AI ecosystem. They ensure fleet-wide consistency and prevent breakage during upgrades.
11+
12+
---
13+
14+
## Migration Categories
15+
16+
### 1. OpenCode Config Migrations
17+
Changes to `~/.config/opencode/opencode.json` that require fleet-wide sync:
18+
- Model updates or additions
19+
- Provider configuration changes
20+
- Plugin additions/removals
21+
- MCP server registration changes
22+
23+
**Sync command:** `sin-sync` (pushes Mac → OCI VM → HF VMs)
24+
25+
### 2. Agent Migrations
26+
Updating agent configurations across teams:
27+
- Team member additions/removals
28+
- Model reassignments
29+
- Capability registry updates
30+
- Telegram bot re-registration
31+
32+
### 3. Database Migrations
33+
Supabase schema changes:
34+
- New tables for agent pools
35+
- Column additions/modifications
36+
- Index optimizations
37+
- Data migrations
38+
39+
### 4. Infrastructure Migrations
40+
OCI VM, Cloudflare Workers, HF Space changes:
41+
- Container image updates
42+
- Proxy configuration changes
43+
- SSL/TLS certificate rotations
44+
- Domain migrations
45+
46+
---
47+
48+
## Migration Protocol
49+
50+
1. **Announce**: Create GitHub Issue with migration details
51+
2. **Test**: Apply migration on staging/dev environment
52+
3. **Document**: Update migration guide with steps and rollback plan
53+
4. **Execute**: Run migration during low-traffic window
54+
5. **Verify**: Run health checks across all fleet nodes
55+
6. **Sync**: Run `sin-sync` to propagate config changes
56+
57+
---
58+
59+
## Rollback Procedure
60+
61+
Every migration MUST have a rollback plan:
62+
1. Revert config changes from backup
63+
2. Restore database from snapshot
64+
3. Run `sin-sync` with previous config
65+
4. Verify fleet health returns to baseline
66+
67+
---
68+
69+
## Active Migrations
70+
71+
| Migration | Status | Date | Impact |
72+
|-----------|--------|------|--------|
73+
| *(none currently active)* | — | — | — |
74+
75+
---
76+
77+
## Past Migrations
78+
79+
| Migration | Completed | Notes |
80+
|-----------|-----------|-------|
81+
| Antigravity Plugin Migration | 2026-04 | All fleet nodes updated to use Antigravity OAuth |
82+
| Bun Package Manager Mandate | 2026-03 | npm permanently banned, bun enforced |
83+
| Technology Sovereignty Mandate | 2026-03 | Camoufox/Playwright/Puppeteer/Selenium banned |
84+
85+
---
86+
87+
## Related
88+
89+
- [sin-sync Documentation](/guide/deployment)
90+
- [OpenCode Config Guide](/guide/agent-configuration)
91+
- [Governance Overview](/governance/overview)

‎docs/plugins/opensin-code-plugins.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -237,7 +237,7 @@ Ralph-Loop-Technik für iterative Entwicklung. Ähnlich wie sin-loop, aber mit e
237237

238238
## Plugin-Entwicklung
239239

240-
Siehe [Plugin Development Tutorial](/docs/tutorials/plugin-development) für eine Schritt-für-Schritt-Anleitung.
240+
Siehe [Plugin Development Tutorial](/tutorials/plugin-development) für eine Schritt-für-Schritt-Anleitung.
241241

242242
### Flow-Builder Skill
243243

‎docs/plugins/registry.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ describe('My Plugin', () => {
111111

112112
## Examples
113113

114-
See the [examples](./examples) directory for complete plugin implementations.
114+
See the [Examples section](/examples/hello-world) for complete plugin implementations.
115115

116116
## Contributing
117117

0 commit comments

Comments
 (0)