Skip to content

Commit af86159

Browse files
MasuRiiMasuRii
committed
fix(docs): correct internal cross-section relative links
Adjust relative Markdown links on nested documentation pages so they correctly traverse up to parent directories before navigating to sibling sections. The previous links used insufficient parent hops, causing 404 errors when deployed to GitHub Pages with a base path. Changes: - documentation-index: use ../../ links to reach sibling sections - architecture/*: fix links from nested pages to other sections - integrations/*: correct links to architecture and sibling pages - operations/*: fix links to architecture and reference sections - reference/bridge-http-api: correct link to operations section Regenerate public Markdown mirrors and LLM docs artifact to reflect the corrected link paths.
1 parent 61512a2 commit af86159

31 files changed

Lines changed: 203 additions & 203 deletions

‎docs-site/public/llms-full.txt‎

Lines changed: 55 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -381,7 +381,7 @@ Agent wants to use a tool. Sent when Agent SDK initiates tool use.
381381
```
382382

383383
#### `claude_event` (server -> client)
384-
Event from Claude Code Hooks. See [Claude Code Hooks Integration](../integrations/claude-code-hooks/).
384+
Event from Claude Code Hooks. See [Claude Code Hooks Integration](../../integrations/claude-code-hooks/).
385385

386386
```json
387387
{
@@ -713,10 +713,10 @@ When the mobile app reconnects after disconnection:
713713

714714
## Related Documentation
715715

716-
- [Architecture Overview](./system-overview/) — System architecture
717-
- [Data Flow](./data-flow/) — Message sequence diagrams
718-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Hook event format
719-
- [Agent SDK Integration](../integrations/agent-sdk/) — Agent SDK message flow
716+
- [Architecture Overview](../system-overview/) — System architecture
717+
- [Data Flow](../data-flow/) — Message sequence diagrams
718+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Hook event format
719+
- [Agent SDK Integration](../../integrations/agent-sdk/) — Agent SDK message flow
720720

721721
---
722722

@@ -881,7 +881,7 @@ flowchart TB
881881
| `Stop` | Session status | Show completion status |
882882
| `SubagentStop` | Subagent status | Update subagent state |
883883

884-
> **Note**: Only confirmed hook events from Claude Code source truth are listed above. See [Claude Code Hooks Integration](../integrations/claude-code-hooks/) for the complete verified event list.
884+
> **Note**: Only confirmed hook events from Claude Code source truth are listed above. See [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) for the complete verified event list.
885885

886886
---
887887

@@ -961,17 +961,17 @@ flowchart TD
961961

962962
## Message Format: WebSocket Protocol
963963

964-
See [Bridge Protocol](./bridge-protocol/) for complete WebSocket message specification.
964+
See [Bridge Protocol](../bridge-protocol/) for complete WebSocket message specification.
965965

966966
---
967967

968968
## Related Documentation
969969

970-
- [Architecture Overview](./system-overview/) — High-level system architecture
971-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Hook configuration details
972-
- [Agent SDK Integration](../integrations/agent-sdk/) — Parallel session flow
973-
- [Bridge Protocol](./bridge-protocol/) — WebSocket message specification
974-
- [Offline Architecture](../operations/offline-architecture/) — Sync queue implementation
970+
- [Architecture Overview](../system-overview/) — High-level system architecture
971+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Hook configuration details
972+
- [Agent SDK Integration](../../integrations/agent-sdk/) — Parallel session flow
973+
- [Bridge Protocol](../bridge-protocol/) — WebSocket message specification
974+
- [Offline Architecture](../../operations/offline-architecture/) — Sync queue implementation
975975

976976
---
977977

@@ -1545,11 +1545,11 @@ class PreToolUseEvent with _$PreToolUseEvent {
15451545

15461546
## Related Documentation
15471547

1548-
- [Project Structure](./project-structure/) — Flutter directory layout
1549-
- [Bridge Protocol](./bridge-protocol/) — WebSocket message specification
1550-
- [Offline Architecture](../operations/offline-architecture/) — Sync and storage patterns
1551-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Event models
1552-
- [OpenCode UI Patterns](../integrations/opencode-ui-patterns/) — UI component data
1548+
- [Project Structure](../project-structure/) — Flutter directory layout
1549+
- [Bridge Protocol](../bridge-protocol/) — WebSocket message specification
1550+
- [Offline Architecture](../../operations/offline-architecture/) — Sync and storage patterns
1551+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Event models
1552+
- [OpenCode UI Patterns](../../integrations/opencode-ui-patterns/) — UI component data
15531553

15541554
---
15551555

@@ -1895,9 +1895,9 @@ bridge/
18951895

18961896
## Related Documentation
18971897

1898-
- [Data Models](./data-models/) — Drift schemas and domain entities
1899-
- [Architecture Overview](./system-overview/) — System architecture
1900-
- [OpenCode UI Patterns](../integrations/opencode-ui-patterns/) — UI component mapping
1898+
- [Data Models](../data-models/) — Drift schemas and domain entities
1899+
- [Architecture Overview](../system-overview/) — System architecture
1900+
- [OpenCode UI Patterns](../../integrations/opencode-ui-patterns/) — UI component mapping
19011901

19021902
---
19031903

@@ -2084,12 +2084,12 @@ After establishing the WebSocket connection, the bridge analyzes the connection
20842084

20852085
## Related Documentation
20862086

2087-
- [Data Flow Details](./data-flow/) — Message-level sequence diagrams
2088-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Hook configuration
2089-
- [Agent SDK Integration](../integrations/agent-sdk/) — Parallel session setup
2090-
- [OpenCode UI Patterns](../integrations/opencode-ui-patterns/) — UI component mapping
2091-
- [Bridge Protocol](./bridge-protocol/) — WebSocket message specification
2092-
- [Security Architecture](../operations/security-architecture/) — Security implementation details
2087+
- [Data Flow Details](../data-flow/) — Message-level sequence diagrams
2088+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Hook configuration
2089+
- [Agent SDK Integration](../../integrations/agent-sdk/) — Parallel session setup
2090+
- [OpenCode UI Patterns](../../integrations/opencode-ui-patterns/) — UI component mapping
2091+
- [Bridge Protocol](../bridge-protocol/) — WebSocket message specification
2092+
- [Security Architecture](../../operations/security-architecture/) — Security implementation details
20932093

20942094
---
20952095

@@ -2489,10 +2489,10 @@ function validateWorkingDirectory(dir: string): void {
24892489

24902490
## Related Documentation
24912491

2492-
- [Claude Code Hooks Integration](./claude-code-hooks/) — Event observation
2493-
- [Architecture Overview](../architecture/system-overview/) — System architecture
2494-
- [Data Flow](../architecture/data-flow/) — Message sequence diagrams
2495-
- [Bridge Protocol](../architecture/bridge-protocol/) — WebSocket message specification
2492+
- [Claude Code Hooks Integration](../claude-code-hooks/) — Event observation
2493+
- [Architecture Overview](../../architecture/system-overview/) — System architecture
2494+
- [Data Flow](../../architecture/data-flow/) — Message sequence diagrams
2495+
- [Bridge Protocol](../../architecture/bridge-protocol/) — WebSocket message specification
24962496

24972497
---
24982498

@@ -2512,7 +2512,7 @@ Description: Configure Claude Code Hooks to POST events to the ReCursor bridge s
25122512

25132513
Claude Code provides a **Hooks system** that allows plugins to observe and react to events. ReCursor uses this system to receive real-time events from Claude Code, enabling the mobile app to display agent activity with OpenCode-style UI components.
25142514

2515-
> **Important**: Hooks are **one-way observation only**. They cannot inject messages or control the Claude Code session. For bidirectional communication, use the [Agent SDK](./agent-sdk/) for parallel sessions.
2515+
> **Important**: Hooks are **one-way observation only**. They cannot inject messages or control the Claude Code session. For bidirectional communication, use the [Agent SDK](../agent-sdk/) for parallel sessions.
25162516

25172517
---
25182518

@@ -3332,8 +3332,8 @@ When validation fails, the bridge server responds with:
33323332

33333333
- [Claude Code Hook Development Guide](file:///C:/Repository/claude-code/plugins/plugin-dev/skills/hook-development/SKILL.md)
33343334
- [Hookify Plugin Example](file:///C:/Repository/claude-code/plugins/hookify/hooks/hooks.json)
3335-
- [Agent SDK Integration](./agent-sdk/) — For bidirectional communication
3336-
- [Bridge Protocol](../architecture/bridge-protocol/) — WebSocket message specification
3335+
- [Agent SDK Integration](../agent-sdk/) — For bidirectional communication
3336+
- [Bridge Protocol](../../architecture/bridge-protocol/) — WebSocket message specification
33373337

33383338
---
33393339

@@ -3886,10 +3886,10 @@ class _ToolCardState extends State<ToolCard>
38863886

38873887
## Related Documentation
38883888

3889-
- [Architecture Overview](../architecture/system-overview/) — System architecture
3890-
- [Data Flow](../architecture/data-flow/) — Message sequence diagrams
3891-
- [Claude Code Hooks Integration](./claude-code-hooks/) — Event source
3892-
- [Agent SDK Integration](./agent-sdk/) — Session control
3889+
- [Architecture Overview](../../architecture/system-overview/) — System architecture
3890+
- [Data Flow](../../architecture/data-flow/) — Message sequence diagrams
3891+
- [Claude Code Hooks Integration](../claude-code-hooks/) — Event source
3892+
- [Agent SDK Integration](../agent-sdk/) — Session control
38933893

38943894
---
38953895

@@ -4119,8 +4119,8 @@ end
41194119

41204120
## Related Documentation
41214121

4122-
- [Testing Strategy](./testing-strategy/) — Testing approach
4123-
- [Architecture Overview](../architecture/system-overview/) — System architecture
4122+
- [Testing Strategy](../testing-strategy/) — Testing approach
4123+
- [Architecture Overview](../../architecture/system-overview/) — System architecture
41244124

41254125
---
41264126

@@ -4431,9 +4431,9 @@ If sync complexity grows, consider:
44314431

44324432
## Related Documentation
44334433

4434-
- [Data Models](../architecture/data-models/) — Drift schemas
4435-
- [Architecture Overview](../architecture/system-overview/) — System architecture
4436-
- [Bridge Protocol](../architecture/bridge-protocol/) — WebSocket specification
4434+
- [Data Models](../../architecture/data-models/) — Drift schemas
4435+
- [Architecture Overview](../../architecture/system-overview/) — System architecture
4436+
- [Bridge Protocol](../../architecture/bridge-protocol/) — WebSocket specification
44374437

44384438
---
44394439

@@ -4612,9 +4612,9 @@ Future<void> showLocalNotification(AppNotification notification) async {
46124612

46134613
## Related Documentation
46144614

4615-
- [Bridge Protocol](../architecture/bridge-protocol/) — WebSocket message specification
4616-
- [Architecture Overview](../architecture/system-overview/) — System architecture
4617-
- [Data Flow](../architecture/data-flow/) — Message sequence diagrams
4615+
- [Bridge Protocol](../../architecture/bridge-protocol/) — WebSocket message specification
4616+
- [Architecture Overview](../../architecture/system-overview/) — System architecture
4617+
- [Data Flow](../../architecture/data-flow/) — Message sequence diagrams
46184618

46194619
---
46204620

@@ -5441,12 +5441,12 @@ class TOFUTrustManager {
54415441

54425442
## Related Documentation
54435443

5444-
- [Architecture Overview](../architecture/system-overview/) — System architecture
5445-
- [Bridge Protocol](../architecture/bridge-protocol/) — WebSocket specification
5446-
- [Bridge HTTP API](../reference/bridge-http-api/) — HTTP endpoints specification
5447-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Hook security
5448-
- [Agent SDK Integration](../integrations/agent-sdk/) — Agent SDK security
5449-
- [Error Handling](../reference/error-handling/) — Error codes and recovery
5444+
- [Architecture Overview](../../architecture/system-overview/) — System architecture
5445+
- [Bridge Protocol](../../architecture/bridge-protocol/) — WebSocket specification
5446+
- [Bridge HTTP API](../../reference/bridge-http-api/) — HTTP endpoints specification
5447+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Hook security
5448+
- [Agent SDK Integration](../../integrations/agent-sdk/) — Agent SDK security
5449+
- [Error Handling](../../reference/error-handling/) — Error codes and recovery
54505450

54515451
---
54525452

@@ -5802,9 +5802,9 @@ testWidgets('displays Claude Code event from bridge', (tester) async {
58025802

58035803
## Related Documentation
58045804

5805-
- [CI/CD Pipeline](./ci-cd/) — CI/CD configuration
5806-
- [Architecture Overview](../architecture/system-overview/) — System architecture
5807-
- [Bridge Protocol](../architecture/bridge-protocol/) — WebSocket message specification
5805+
- [CI/CD Pipeline](../ci-cd/) — CI/CD configuration
5806+
- [Architecture Overview](../../architecture/system-overview/) — System architecture
5807+
- [Bridge Protocol](../../architecture/bridge-protocol/) — WebSocket message specification
58085808

58095809
---
58105810

@@ -6331,7 +6331,7 @@ Access-Control-Max-Age: 86400
63316331

63326332
## TLS Requirements
63336333

6334-
All HTTP endpoints require TLS. See [security-architecture.md](../operations/security-architecture/) for:
6334+
All HTTP endpoints require TLS. See [security-architecture.md](../../operations/security-architecture/) for:
63356335
- Self-signed certificate generation
63366336
- Certificate pinning
63376337
- Mobile platform TLS caveats

‎docs-site/public/page-markdown/architecture/bridge-protocol.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -371,7 +371,7 @@ Agent wants to use a tool. Sent when Agent SDK initiates tool use.
371371
```
372372

373373
#### `claude_event` (server -> client)
374-
Event from Claude Code Hooks. See [Claude Code Hooks Integration](../integrations/claude-code-hooks/).
374+
Event from Claude Code Hooks. See [Claude Code Hooks Integration](../../integrations/claude-code-hooks/).
375375

376376
```json
377377
{
@@ -703,10 +703,10 @@ When the mobile app reconnects after disconnection:
703703

704704
## Related Documentation
705705

706-
- [Architecture Overview](./system-overview/) — System architecture
707-
- [Data Flow](./data-flow/) — Message sequence diagrams
708-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Hook event format
709-
- [Agent SDK Integration](../integrations/agent-sdk/) — Agent SDK message flow
706+
- [Architecture Overview](../system-overview/) — System architecture
707+
- [Data Flow](../data-flow/) — Message sequence diagrams
708+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Hook event format
709+
- [Agent SDK Integration](../../integrations/agent-sdk/) — Agent SDK message flow
710710

711711
---
712712

‎docs-site/public/page-markdown/architecture/data-flow.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -153,7 +153,7 @@ flowchart TB
153153
| `Stop` | Session status | Show completion status |
154154
| `SubagentStop` | Subagent status | Update subagent state |
155155

156-
> **Note**: Only confirmed hook events from Claude Code source truth are listed above. See [Claude Code Hooks Integration](../integrations/claude-code-hooks/) for the complete verified event list.
156+
> **Note**: Only confirmed hook events from Claude Code source truth are listed above. See [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) for the complete verified event list.
157157
158158
---
159159

@@ -233,17 +233,17 @@ flowchart TD
233233

234234
## Message Format: WebSocket Protocol
235235

236-
See [Bridge Protocol](./bridge-protocol/) for complete WebSocket message specification.
236+
See [Bridge Protocol](../bridge-protocol/) for complete WebSocket message specification.
237237

238238
---
239239

240240
## Related Documentation
241241

242-
- [Architecture Overview](./system-overview/) — High-level system architecture
243-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Hook configuration details
244-
- [Agent SDK Integration](../integrations/agent-sdk/) — Parallel session flow
245-
- [Bridge Protocol](./bridge-protocol/) — WebSocket message specification
246-
- [Offline Architecture](../operations/offline-architecture/) — Sync queue implementation
242+
- [Architecture Overview](../system-overview/) — High-level system architecture
243+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Hook configuration details
244+
- [Agent SDK Integration](../../integrations/agent-sdk/) — Parallel session flow
245+
- [Bridge Protocol](../bridge-protocol/) — WebSocket message specification
246+
- [Offline Architecture](../../operations/offline-architecture/) — Sync queue implementation
247247

248248
---
249249

‎docs-site/public/page-markdown/architecture/data-models.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -562,11 +562,11 @@ class PreToolUseEvent with _$PreToolUseEvent {
562562

563563
## Related Documentation
564564

565-
- [Project Structure](./project-structure/) — Flutter directory layout
566-
- [Bridge Protocol](./bridge-protocol/) — WebSocket message specification
567-
- [Offline Architecture](../operations/offline-architecture/) — Sync and storage patterns
568-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Event models
569-
- [OpenCode UI Patterns](../integrations/opencode-ui-patterns/) — UI component data
565+
- [Project Structure](../project-structure/) — Flutter directory layout
566+
- [Bridge Protocol](../bridge-protocol/) — WebSocket message specification
567+
- [Offline Architecture](../../operations/offline-architecture/) — Sync and storage patterns
568+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Event models
569+
- [OpenCode UI Patterns](../../integrations/opencode-ui-patterns/) — UI component data
570570

571571
---
572572

‎docs-site/public/page-markdown/architecture/project-structure.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -334,9 +334,9 @@ bridge/
334334

335335
## Related Documentation
336336

337-
- [Data Models](./data-models/) — Drift schemas and domain entities
338-
- [Architecture Overview](./system-overview/) — System architecture
339-
- [OpenCode UI Patterns](../integrations/opencode-ui-patterns/) — UI component mapping
337+
- [Data Models](../data-models/) — Drift schemas and domain entities
338+
- [Architecture Overview](../system-overview/) — System architecture
339+
- [OpenCode UI Patterns](../../integrations/opencode-ui-patterns/) — UI component mapping
340340

341341
---
342342

‎docs-site/public/page-markdown/architecture/system-overview.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -175,12 +175,12 @@ After establishing the WebSocket connection, the bridge analyzes the connection
175175

176176
## Related Documentation
177177

178-
- [Data Flow Details](./data-flow/) — Message-level sequence diagrams
179-
- [Claude Code Hooks Integration](../integrations/claude-code-hooks/) — Hook configuration
180-
- [Agent SDK Integration](../integrations/agent-sdk/) — Parallel session setup
181-
- [OpenCode UI Patterns](../integrations/opencode-ui-patterns/) — UI component mapping
182-
- [Bridge Protocol](./bridge-protocol/) — WebSocket message specification
183-
- [Security Architecture](../operations/security-architecture/) — Security implementation details
178+
- [Data Flow Details](../data-flow/) — Message-level sequence diagrams
179+
- [Claude Code Hooks Integration](../../integrations/claude-code-hooks/) — Hook configuration
180+
- [Agent SDK Integration](../../integrations/agent-sdk/) — Parallel session setup
181+
- [OpenCode UI Patterns](../../integrations/opencode-ui-patterns/) — UI component mapping
182+
- [Bridge Protocol](../bridge-protocol/) — WebSocket message specification
183+
- [Security Architecture](../../operations/security-architecture/) — Security implementation details
184184

185185
---
186186

0 commit comments

Comments
 (0)