🚀 Build ScortonJS — Easy Wins, Tests & First PRs

[yojedesign]

Join the first contributor wave and help shape ScortonJS — the open-source framework that makes human trust measurable and programmable.

Repo structure
scorton-js/
├── scorton.py
├── packages/
│ ├── cli/
│ └── rust-core/
├── FRAMEWORK_GUIDE.md
└── tests/

How to pick a task

1. Comment below with the task you pick (e.g., "I’ll take: Add pytest for scorton.py").
2. Create a branch: git checkout -b feat/
3. Send a PR linking this issue and use the PR checklist.

--- Starter tasks (first-timer friendly)

1. ✅ Add a minimal test for scorton.py

• Path: tests/test_scorton_py/test_basic.py
• What: Add a simple pytest that imports scorton.py and asserts a trivial function (e.g., compute_score({}) == 0 or equivalent).
• Commands: pytest -q
• Time: 15–45 min • Difficulty: easy
• Acceptance: tests pass locally

2. ✅ Add vitest for CLI (smoke test)

• Path: packages/cli/
• What: Add vitest dev dependency and a tiny test that runs node ./bin/scorton --help or validates exported CLI function.
• Commands: npm ci && npm run test
• Time: 30–90 min • Difficulty: easy
• Acceptance: npm run test passes

3. ✅ Rust core: add a test skeleton

• Path: packages/rust-core/
• What: Add tests/integration_test.rs with a small cargo test example asserting an exported Rust function.
• Commands: cargo test
• Time: 30–60 min • Difficulty: easy
• Acceptance: cargo test passes

4. ✅ Add CI workflow

• Path: .github/workflows/test.yml
• What: Run pytest, npm test, and cargo test on PRs.
• Time: 1–2 hours • Difficulty: medium
• Acceptance: CI green on PR

--- PR Checklist (copy into PR body)

• I followed CONTRIBUTING.md
• Tests added or updated
• All local tests pass: pytest, npm test, cargo test
• CI checks pass

Labels: good first issue, first-timer, testing, python, nodejs, rust, help wanted

If you want to be a mentor/reviewer for new contributors, add @<github-handle> below.