Extenote
← All Docs

Manual Testing Guide

Test all three interfaces (CLI, TUI, Web).

Prerequisites: Run bun install && bun run build and configure .env per the Quick Start guide.

Automated Tests

Run from the extenote/ repo root:

bun run --cwd packages/core test
bun run --cwd packages/cli test
bun run --cwd packages/refcheck test
bun run --cwd packages/tui test
bun run --cwd extensions/clipper test

Web UI integration tests (starts servers and captures screenshots):

bun run --cwd packages/web test:run

Testing Workflow

1. CLI Testing

# View vault status
bun run cli -- status

# Check for issues
bun run cli -- issues

# Create a BibTeX entry (non-interactive)
bun run cli -- create bibtex_entry smith2024 \
  --title "Machine Learning in Practice" \
  --visibility public \
  --project personal-website

# Create a memo (interactive wizard)
bun run cli -- creator

# Export personal-website project
bun run cli -- export-project personal-website \
  --format json \
  --output dist/export/personal-website/json

# Show available commands
bun run cli -- guide --project personal-website

Expected outputs:

2. TUI Testing

bun run tui

Test flow:

  1. Dashboard (default) - View stats
  2. Press i - Issues - Press 1/2/3/4 to filter by severity
  3. Press c - Create - Select schema, enter details
  4. Press e - Export - Select project and format
  5. Navigation - Press h or ESC to return, q to quit

3. Web Testing

bun run web

Opens http://localhost:3000

Test flow:

  1. Dashboard - View vault stats
  2. Project Detail - Click a project to view objects
  3. Object Detail - View frontmatter and markdown
  4. Issues Page - Filter by severity
  5. Create Page - Create new objects
  6. Export Page - Export projects

Build & Deploy Testing

# List buildable projects
bun run cli -- build --list

# Dry-run build
bun run cli -- build data-leverage-blogs --dry-run

# Build a project
bun run cli -- build data-leverage-blogs --verbose

# Deploy
bun run cli -- deploy data-leverage-blogs

Success Criteria