opensidian 1.0.0

package/.eslintrc.json

@@ -0,0 +1 @@
+.eslintrc.json

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,49 @@
+name: Bug Report
+
+about: Create a report to help us improve
+
+title: '[BUG] '
+
+labels: ['bug']
+
+assignees: ''
+
+---
+
+## Description
+
+<!-- A clear description of the bug -->
+
+## Steps to Reproduce
+
+<!-- Steps to reproduce the behavior -->
+
+1. 
+2. 
+3. 
+
+## Expected Behavior
+
+<!-- What you expected to happen -->
+
+## Actual Behavior
+
+<!-- What actually happened -->
+
+## Screenshots
+
+<!-- If applicable, add screenshots to help explain your problem -->
+
+## Environment
+
+- OS: [e.g., Windows 11, macOS 14, Ubuntu 22.04]
+- Node.js version: 
+- OpenSidian version: 
+
+## Additional Context
+
+<!-- Add any other context about the problem here -->
+
+## Related Issues
+
+<!-- Link any related issues -->

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,35 @@
+name: Feature Request
+
+about: Suggest a new feature for OpenSidian
+
+title: '[FEATURE] '
+
+labels: ['enhancement']
+
+assignees: ''
+
+---
+
+## Problem Statement
+
+<!-- Describe the problem this feature solves -->
+
+## Proposed Solution
+
+<!-- Describe your proposed solution -->
+
+## Alternatives Considered
+
+<!-- Describe any alternative solutions you've considered -->
+
+## Use Cases
+
+<!-- List specific use cases for this feature -->
+
+## Additional Context
+
+<!-- Add any other context or screenshots about the feature request -->
+
+## Related Issues
+
+<!-- Link any related issues -->

package/.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,23 @@
+name: Question
+
+about: Ask a question about OpenSidian
+
+title: '[QUESTION] '
+
+labels: ['question']
+
+assignees: ''
+
+---
+
+## Question
+
+<!-- Your question -->
+
+## Context
+
+<!-- Additional context -->
+
+## Related Issues
+
+<!-- Link any related issues -->

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,45 @@
+name: Pull Request
+
+about: Submit changes to the OpenSidian project
+
+title: '[PR] '
+
+labels: ''
+
+assignees: ''
+
+---
+
+## Description
+
+<!-- Describe your changes -->
+
+## Type of Change
+
+<!-- Please delete options that are not relevant -->
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+
+## Checklist
+
+<!-- Please make sure all items are checked -->
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged
+
+## Related Issues
+
+<!-- Link any related issues, e.g., "Closes #123" -->
+
+## Additional Context
+
+<!-- Add any other context about the PR here -->

package/.github/README.md

@@ -0,0 +1,5 @@
+# OpenSidian
+
+Open-source knowledge management system with MCP server, graph indexing, and real-time sync.
+
+See [README.md](README.md) for full documentation.

package/.github/workflows/cd.yml

@@ -0,0 +1,44 @@
+name: CD
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    name: Publish Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish to Docker Hub
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: docker/Dockerfile
+          push: true
+          tags: |
+            opensidian:${{ github.event.release.tag_name }}
+            opensidian:latest
+        env:
+          DOCKER_BUILDKIT: 1

package/.github/workflows/ci.yml

@@ -0,0 +1,128 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    name: Test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        node: ['20', '22']
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run lint
+        run: npm run lint
+
+      - name: Run typecheck
+        run: npm run typecheck
+
+      - name: Run tests with coverage
+        run: npm run test:coverage
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        if: matrix.os == 'ubuntu-latest' && matrix.node == '20'
+        with:
+          token: ${{ secrets.CCODECOV_TOKEN }}
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  build-docker:
+    name: Build Docker
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: docker/Dockerfile
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: |
+            opensidian:latest
+            opensidian:${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    needs: build-docker
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/qa.yml

@@ -0,0 +1,45 @@
+name: QA Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  code-review:
+    name: Code Quality Review
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run analysis
+        run: |
+          npm run lint
+          npm run typecheck
+          npm run test
+
+      - name: Check file size
+        run: |
+          npm run build
+          du -sh dist/
+
+      - name: Comment PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '## QA Report\n\nBuild and tests completed successfully.'
+            })

package/.planning/PROJECT.md

@@ -0,0 +1,96 @@
+# OpenSidian
+
+## What This Is
+
+OpenSidian é um sistema de gerenciamento de conhecimento open-source inspirado no Obsidian. Ele permite criar, organizar e interconectar notas em Markdown com indexação de grafo de conhecimento, sincronização em tempo real e suporte a plugins. O projeto já possui código funcional (servidor MCP, API REST, WebSocket sync, plugin host) e está rodando em produção local.
+
+## Core Value
+
+Usuários podem escrever notas em Markdown, conectá-las com links `[[wikilink]]`, visualizar o grafo de conhecimento e sincronizar em tempo real — tudo open-source e auto-hospedável.
+
+## Requirements
+
+### Validated
+
+- ✓ **Vault Manager**: criar, abrir e gerenciar vaults de notas — `src/core/vault.ts`
+- ✓ **Markdown Parser**: parsing de Markdown com frontmatter, links e headings — `src/core/markdown.ts`
+- ✓ **Graph Engine**: indexação de grafo de conhecimento com vizinhança e backlinks — `src/core/graph.ts`
+- ✓ **Sync Service**: sincronização em tempo real via WebSocket — `src/core/sync.ts`
+- ✓ **Plugin Host**: sistema de plugins com comandos e hooks — `src/plugins/host.ts`
+- ✓ **MCP Server**: servidor Model Context Protocol com tools para vault/notas/grafo — `src/mcp/server.ts`
+- ✓ **REST API**: endpoints para vaults, notas e grafo — `src/api/routes.ts`
+- ✓ **CI/CD**: GitHub Actions para testes, build e release multiplataforma — `.github/workflows/`
+- ✓ **Docker**: containerização multi-stage com docker-compose — `docker/`
+- ✓ **Testes**: 67 testes passando com cobertura >80% — `tests/`
+- ✓ **Licença MIT**: `LICENSE`
+
+### Active
+
+- [ ] **Interface Web**: UI para visualizar e editar notas, grafo e configurações
+- [ ] **Autenticação**: login com email/senha e sessão persistente
+- [ ] **Busca Full-Text**: busca avançada com indexação de conteúdo
+- [ ] **Temas Customizáveis**: suporte a temas com CSS variables
+- [ ] **Plugin Registry**: marketplace ou repositório de plugins
+- [ ] **Backup Automático**: snapshots e restore de vaults
+- [ ] **API de Plugins documentada**: SDK público para desenvolvedores
+- [ ] **Modo Offline**: suporte a PWA/Electron para uso sem internet
+- [ ] **Colaboração**: edição simultânea com CRDT/OT
+
+### Out of Scope
+
+- Aplicativo mobile nativo — foco em web + PWA por enquanto
+- Suporte a formatos não-Markdown (PDF, DOCX) — conversão via plugins
+- Armazenamento cloud proprietário — cada um escolhe onde hospedar
+
+## Context
+
+Projeto iniciado do zero como clone open-source do Obsidian. Todo o backend core está funcional. O próximo passo é construir a interface web e melhorar a experiência do usuário.
+
+Stack atual: TypeScript, Node.js, Express, WebSocket, MCP SDK, Vitest, Docker.
+
+Repositório: [thiagovasconcelosti/opensidian](https://github.com/thiagovasconcelosti/opensidian)
+
+## Constraints
+
+- **Node.js**: runtime obrigatório (>=20), sem Python/Go no backend
+- **Compatibilidade**: must support Windows, macOS e Linux
+- **Formato**: notas em `.md` padrão, sem lock-in
+
+## Key Decisions
+
+| Decision | Rationale | Outcome |
+|----------|-----------|---------|
+| TypeScript + Node.js | Ecossistema maduro, tipagem segura, mesma linguagem front/back | ✓ Good |
+| MCP SDK oficial | Integração nativa com LLMs sem reinventar protocolo | ✓ Good |
+| Markdown puro sem custom syntax | Máxima compatibilidade com outras ferramentas | ✓ Good |
+| Vitest em vez de Jest | Mais rápido, nativo ESM, integração Vite | ✓ Good |
+
+## Evolution
+
+This document evolves at phase transitions and milestone boundaries.
+
+**After each phase transition:**
+1. Requirements invalidated? → Move to Out of Scope with reason
+2. Requirements validated? → Move to Validated with phase reference
+3. New requirements emerged? → Add to Active
+4. Decisions to log? → Add to Key Decisions
+5. "What This Is" still accurate? → Update if drifted
+
+**After each milestone:**
+1. Full review of all sections
+2. Core Value check — still the right priority?
+3. Audit Out of Scope — reasons still valid?
+4. Update Context with current state
+
+---
+## Current Milestone: v2.0 Busca Full-Text
+
+**Goal:** Implementar busca full-text com indexação, highlighting e filtros por tag/data.
+
+**Target features:**
+- Indexador full-text que analisa conteúdo de notas
+- API de busca com query string, highlighting e filtros
+- UI de busca integrada ao editor com resultados em tempo real
+- Filtros por tag, data de modificação e tipo de link
+
+*Last updated: 2026-05-06 after milestone v2.0 start*

package/.planning/REQUIREMENTS.md

@@ -0,0 +1,66 @@
+# Requirements: OpenSidian — Milestone v2.0
+
+**Defined:** 2026-05-06
+**Milestone:** v2.0 — Busca Full-Text
+**Core Value:** Usuários podem escrever notas em Markdown, conectá-las com links, visualizar o grafo de conhecimento e sincronizar em tempo real — open-source e auto-hospedável.
+
+## v2.0 Requirements
+
+### Indexação Full-Text
+
+- [ ] **SRCH-01**: Indexador processa conteúdo de todas as notas de um vault
+- [ ] **SRCH-02**: Indexação é incremental (só reindexa notas modificadas)
+- [ ] **SRCH-03**: Indexador extrai termos do body e do frontmatter
+- [ ] **SRCH-04**: Indexador ignora stopwords e normaliza acentos
+- [ ] **SRCH-05**: Índice persiste em disco entre reinicializações
+
+### API de Busca
+
+- [ ] **SRCH-06**: Endpoint GET `/api/notes/search?vault=&q=` retorna resultados
+- [ ] **SRCH-07**: Resultados incluem trecho do conteúdo com highlighting
+- [ ] **SRCH-08**: Filtro por tag (`tag:javascript`)
+- [ ] **SRCH-09**: Filtro por data (`after:2026-01-01 before:2026-06-01`)
+- [ ] **SRCH-10**: Filtro por tipo de link (`hasBacklinks:true`)
+- [ ] **SRCH-11**: Ordenação por relevância (TF-IDF ou similar)
+
+### Frontend de Busca
+
+- [ ] **SRCH-12**: Input de busca na toolbar com resultados em dropdown
+- [ ] **SRCH-13**: Resultados mostram título, trecho com highlight e metadata
+- [ ] **SRCH-14**: Painel de busca avançada com filtros (tag, data, tipo)
+- [ ] **SRCH-15**: Navegação para nota ao clicar no resultado
+
+### MCP Search Tool
+
+- [ ] **SRCH-16**: Tool MCP `note_search` retorna resultados com highlighting
+- [ ] **SRCH-17**: Tool MCP aceita filtros (tag, data) como parâmetros opcionais
+
+## Future Requirements
+
+- **SRCH-18**: Busca fuzzy (tolerância a erros de digitação)
+- **SRCH-19**: Sugestões de busca enquanto digita (autocomplete)
+- **SRCH-20**: Busca em anexos (PDF, DOCX) via plugin
+
+## Out of Scope
+
+| Feature | Reason |
+|---------|--------|
+| Busca em múltiplos idiomas | Stopwords só em português/inglês por enquanto |
+| Busca por similaridade semântica (embedding) | Exige modelo ML, custo alto |
+
+## Traceability
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| SRCH-01 a SRCH-05 | Phase 8 (Indexador) | Pending |
+| SRCH-06 a SRCH-11 | Phase 9 (API) | Pending |
+| SRCH-12 a SRCH-15 | Phase 10 (Frontend) | Pending |
+| SRCH-16 a SRCH-17 | Phase 9 (API) | Pending |
+
+**Coverage:**
+- v2.0 requirements: 17 total
+- Mapped to phases: 17
+- Unmapped: 0 ✓
+
+---
+*Requirements defined: 2026-05-06 for milestone v2.0*

package/.planning/ROADMAP.md

@@ -0,0 +1,129 @@
+# Roadmap: OpenSidian
+
+**Version:** 2.0.0
+**Milestone:** v2.0 ✅ Complete
+
+## v1.0 Phases (Complete)
+
+### Phase 1: Backend Core
+**Goal:** Base do sistema funcional (vault, markdown, graph)
+**Requirements:** VAULT-01 a VAULT-03, MD-01 a MD-03, GRAPH-01 a GRAPH-05, CI-01 a CI-03, DOCKER-01 a DOCKER-02
+**Status:** Complete
+**Success criteria:**
+1. Usuário pode criar, abrir e listar vaults
+2. Sistema faz parsing de Markdown com frontmatter e links
+3. Grafo de conhecimento é indexado automaticamente
+4. Testes e CI estão funcionando
+
+### Phase 2: Sync & API
+**Goal:** APIs REST, WebSocket sync e servidor MCP
+**Requirements:** SYNC-01 a SYNC-02, MCP-01 a MCP-06, API-01 a API-05
+**Status:** Complete
+**Success criteria:**
+1. Alterações em notas são sincronizadas via WebSocket
+2. Servidor MCP expõe tools para vault, notas e grafo
+3. REST API responde corretamente para todos os endpoints
+4. Sistema lida com erros de forma tipada
+
+### Phase 3: Plugin System
+**Goal:** Arquitetura extensível com plugins
+**Requirements:** PLUGIN-01 a PLUGIN-05
+**Status:** Complete
+**Success criteria:**
+1. Plugin pode ser carregado e descarregado em runtime
+2. Plugin pode registrar comandos e hooks
+3. Hooks executam em sequência sem quebrar com erros
+4. Plugin de exemplo funcional incluso
+
+### Phase 4: Web UI
+**Goal:** Interface web para uso diário
+**Requirements:** WEB-01 a WEB-07, SEARCH-01 a SEARCH-03
+**Status:** Complete
+**Success criteria:**
+1. ✅ Usuário vê lista de notas e pode criar novas
+2. ✅ Editor Markdown com preview ao vivo
+3. ✅ Grafo de conhecimento interativo (D3.js)
+4. ✅ Navegação entre notas por clique em links
+5. ✅ Busca funcional com resultados em tempo real
+6. ✅ Interface responsiva (desktop e mobile)
+7. ✅ Servidor Express serve frontend buildado em produção
+**UI hint**: yes
+
+### Phase 5: Authentication
+**Goal:** Segurança com login e sessão
+**Requirements:** AUTH-01 a AUTH-04
+**Status:** Complete
+**Success criteria:**
+1. ✅ Usuário cria conta com email/senha
+2. ✅ Login persiste após refresh (JWT + localStorage)
+3. ✅ Logout invalida sessão
+4. ✅ Rotas protegidas redirecionam para login
+5. ✅ Nome e email do usuário visíveis na sidebar
+**Dependencies:** Phase 4
+
+### Phase 6: Themes
+**Goal:** Suporte a temas customizáveis
+**Requirements:** THEME-01 a THEME-03
+**Status:** Complete
+**Success criteria:**
+1. ✅ Temas claro e escuro inclusos
+2. ✅ Usuário pode criar temas com CSS variables (editor visual)
+3. ✅ Troca de tema sem refresh
+4. ✅ Temas persistem no localStorage
+5. ✅ Temas salvos no servidor e listados na sidebar
+**Dependencies:** Phase 4
+
+### Phase 7: Polish & Release
+**Goal:** Documentação, SDK de plugins e release 1.0
+**Requirements:** REG-01 a REG-03
+**Status:** Complete
+**Success criteria:**
+1. ✅ Documentação completa no README (API, plugins, MCP, Docker)
+2. ✅ Guia de contribuição atualizado no CONTRIBUTING.md
+3. ✅ Documentação da API de plugins publicada
+4. ✅ Badge CI e license no README
+5. ✅ Release 1.0 via GitHub Actions configurado
+**Dependencies:** Phase 5, Phase 6
+
+## v2.0 Phases
+
+### Phase 8: Indexador Full-Text
+**Goal:** Indexador que processa conteúdo das notas e persiste em disco
+**Requirements:** SRCH-01 a SRCH-05
+**Status:** Complete
+**Success criteria:**
+1. ✅ Indexador processa vaults existentes e novas notas automaticamente
+2. ✅ Indexação incremental via VaultManager (indexOnCreate/Update/Delete)
+3. ✅ Termos extraídos do body, frontmatter e tags
+4. ✅ Stopwords removidas, acentos normalizados (NFD)
+5. ✅ Índice salvo em disco (JSON) sobrevive a restart
+6. ✅ Ranking TF-IDF implementado
+7. ✅ 12 novos testes, total 79 testes passando
+
+### Phase 9: API de Busca
+**Goal:** Endpoint REST e MCP tool com highlighting e filtros
+**Requirements:** SRCH-06 a SRCH-11, SRCH-16 a SRCH-17
+**Status:** Complete
+**Success criteria:**
+1. ✅ GET `/api/notes/search?q=` retorna resultados ordenados por relevância
+2. ✅ Resultados incluem snippet com highlighting
+3. ✅ Filtro `tag:` funcional
+4. ✅ Filtro `after:`/`before:` funcional
+5. ✅ Filtro `hasBacklinks:` funcional
+6. ✅ Tool MCP `note_search` aceita filtros opcionais
+7. ✅ Frontend SearchBar usa full-text search com highlighting
+
+### Phase 10: Frontend de Busca
+**Goal:** UI de busca com dropdown e painel avançado de filtros
+**Requirements:** SRCH-12 a SRCH-15
+**Status:** Complete
+**Success criteria:**
+1. ✅ Input de busca na toolbar com dropdown de resultados com highlight
+2. ✅ Resultado mostra título, trecho com highlight e metadata
+3. ✅ Painel de busca avançada com filtros visuais (tag, data, backlinks)
+4. ✅ Clique no resultado navega para a nota
+5. ✅ Rota /search com busca full-text e filtros
+
+---
+*Roadmap created: 2026-05-06*
+*Updated: 2026-05-06 — v2.0 phases added*