---
id: TASK-32
title: Port folk-obsidian-browser shape (Obsidian vault explorer)
status: To Do
assignee: []
created_date: '2026-02-18 19:50'
labels:
  - shape-port
  - phase-3
  - data-integration
milestone: m-0
dependencies:
  - TASK-25
references:
  - canvas-website/src/shapes/ObsidianBrowserShapeUtil.tsx
  - canvas-website/src/components/ObsidianVaultBrowser.tsx
priority: medium
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Port ObsidianBrowserShapeUtil + ObsidianVaultBrowser component from canvas-website to rspace-online.

Source: canvas-website/src/shapes/ObsidianBrowserShapeUtil.tsx (413 lines) + canvas-website/src/components/ObsidianVaultBrowser.tsx (1,694 lines)
Target: rspace-online/lib/folk-obsidian-browser.ts

Total: 2,107 lines — one of the largest ports.

Features to implement:
- Obsidian vault file tree navigation
- Full-text search across vault
- Backlink preview and navigation
- Note opening (creates folk-obs-note shapes)
- Vault metadata display

Needs /api/obsidian/* server endpoints for local vault file operations (TASK-25).
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [ ] #1 File tree renders vault directory structure
- [ ] #2 Full-text search returns matching notes
- [ ] #3 Backlink preview displays on hover/click
- [ ] #4 Selecting a note creates folk-obs-note shape
- [ ] #5 Toolbar button added to canvas.html
<!-- AC:END -->