test

Step 1: Determine what to test

If $ARGUMENTS specifies a tier or package, use that. Otherwise, detect which packages were affected by recent changes:

git diff --name-only main

Map changed files to packages:

| Changed path | Test target | |---|---| | packages/dart_node_core/ | packages/dart_node_core | | packages/dart_node_express/ | packages/dart_node_express | | packages/dart_node_ws/ | packages/dart_node_ws | | packages/dart_node_better_sqlite3/ | packages/dart_node_better_sqlite3 | | packages/dart_node_mcp/ | packages/dart_node_mcp | | packages/dart_node_react/ | packages/dart_node_react | | packages/dart_node_react_native/ | packages/dart_node_react_native | | packages/dart_logging/ | packages/dart_logging | | packages/reflux/ | packages/reflux | | packages/dart_jsx/ | packages/dart_jsx | | examples/frontend/ | examples/frontend | | examples/markdown_editor/ | examples/markdown_editor | | examples/reflux_demo/ | examples/reflux_demo/web_counter | | tools/ or root config | Run --all |

If a Tier 1 package changed, also run its downstream dependents in Tier 2/3.

Step 2: Run tests

Specific packages (preferred — faster):

./tools/test.sh packages/dart_node_core packages/dart_node_express

Full tier:

./tools/test.sh --tier 1

Everything (use --all arg or when root files changed):

./tools/test.sh

Step 3: Coverage for affected packages

For each Node package that was tested, run the coverage tool:

cd packages/<name> && dart run ../dart_node_coverage/bin/coverage.dart

Node packages (use coverage CLI): dart_node_core, dart_node_express, dart_node_ws, dart_node_better_sqlite3, dart_node_mcp, dart_node_react_native

Browser packages (use dart test -p chrome): dart_node_react

Standard packages (use dart test --coverage): dart_logging, reflux

Minimum coverage: 80%. If below threshold, read coverage/lcov.info and identify uncovered lines.

Tiers reference

• Tier 1: dart_logging, dart_node_core
• Tier 2: reflux, dart_node_express, dart_node_ws, dart_node_better_sqlite3, dart_node_mcp, dart_node_react_native, dart_node_react
• Tier 3: examples/frontend, examples/markdown_editor, examples/reflux_demo/web_counter

After running

1. Report PASS/FAIL per package with coverage percentages
2. If failures occur, read the log from logs/<package>.log and diagnose
3. If coverage is below 80%, suggest specific test cases to add
4. Never skip tests, remove assertions, or silently swallow failures