Repository navigation
[Framework] CONTRIBUTING.md test command fails as documented #95
Description
Problem
CONTRIBUTING.md step 5 instructs contributors to run:
node .opencode/plugins/tests/test-<name>.mjs
This fails immediately for every test file, e.g.:
SyntaxError: The requested module '../ccgs-hooks.ts' does not provide an export named 'handleLogAgent'
because the .mjs test files import .ts sources and require the tsx ESM loader, which plain node doesn't provide. The correct invocation (per package.json) is:
node --import tsx --test .opencode/plugins/tests/test-<name>.mjs
or simply npm run test:plugins / npm test.
Verified: npm test → 158/158 passing; direct node test-*.mjs → SyntaxError on every file.
Fix
Update CONTRIBUTING.md step 5 to reference npm run test:plugins (or the full node --import tsx --test ... form), matching package.json scripts.
Acceptance criteria
- CONTRIBUTING.md's documented test command actually runs successfully when copy-pasted
Activity
striderZA commentedon Aug 2, 2026
Fixed in commit edaac99 (local, not yet pushed). Verified via
node tests/agents/validate.mjs(206/206 PASS) andnpm test(158/158 PASS).striderZA commentedon Aug 2, 2026
Correction: the initial close (edaac99) missed two more instances of the broken
node .opencode/plugins/tests/test-<name>.mjscommand — README.md:351 and AGENTS.md:248. Fixed in follow-up commit 09c6eae; both now referencenpm run test:plugins. Re-verified: npm test 158/158.fix: repair broken plugin test invocation in docs and package.json (#95…
chore: prepare v0.12.1 (#103)