tomevault-io Validate Changes
Since this project relies on scraping a 3rd party website (CSFD.cz), validation is crucial to ensure their DOM hasn't changed or our logic isn't broken.
1. Static Analysis & Build
Ensure that TypeScript compiles and the dual-build system works.
# Checks types and builds both 'server' and 'mcp-server' related outputs
yarn build
2. Unit & Integration Tests
Run the test suite. Note that some tests might hit the real CSFD website.
yarn test
3. Real-world Demo
The demo.ts file is a scratchpad for testing the actual scraper against current CSFD pages.
# Run the demo script
npm run demo
If the demo fails:
- Check your internet connection (CSFD might block generic IPs).
- Check if CSFD changed their DOM layout.
- Verify
User-Agentheaders insrc/fetchers/fetcher.ts.
4. MCP Server Check
If you modified mcp-server/, verify it builds and starts.
# Build specific to MCP
yarn build:mcp
# Try to run it (it handles stdio, so it will just wait for input, but shouldn't crash immediately)
node dist/bin/mcp-server.js
Converted and distributed by TomeVault — claim your Tome and manage your conversions.