Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[TS PBT] Build a reproducible property benchmark and mutant corpus

Open
#356 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
30/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
kotlin, typescript
Domain
devtools, testing

Research direction

Start with the shared property contract in #384 and the related work in #354, then locate the existing loading and execution commands. Define the corpus manifest and simple runner around the stated selection, mutant, revision, license, seed, budget and capability fields. Done means validation checks shared-property loading, concrete expected outcomes, traceable non-equivalent mutants and the required artifact fields.

Written by the indexing model from the issue text.

Description

Part of #345. Uses #348 and the shared property contract from #384.

Goal

Freeze a meaningful property and mutant corpus before testing optional search hints or drawing comparative conclusions.

Scope

  • Write selection criteria before evaluating engine outcomes. Use curated explanation fixtures and real open-source TypeScript programs.
  • Include round-trip, idempotence, reference-equivalence and collection/relational properties where the selected programs provide meaningful examples. State the mandatory supported categories in the corpus manifest; justify absent categories rather than adding a framework to satisfy a checklist.
  • Author each property once using the existing Kotlin domains and original TypeScript predicate/precondition exports.
  • Keep supported preconditions pure and invocations isolated according to #384.
  • Record project revision, license, selected files/methods, property rationale and relevant domain limits.
  • Add controlled mutants with stable IDs, a source change, expected violated property and at least one concrete validating witness. Identify equivalent/invalid mutants and exclude them under a documented rule before evaluation.
  • Record capability and reasons for every selected case; preserve unsupported cases in the corpus inventory.
  • Freeze revisions, dependency versions, seeds, budgets, properties and mutants. Separate development/pilot cases from final evaluation cases when tuning hints or phase allocations.
  • Reuse existing loading/execution commands for validation; a simple manifest and runner are sufficient.

Definition of Done

  • Correct fixtures and seeded faulty fixtures are concretely validated.
  • Every mutant counted in the fault denominator is traceable and non-equivalence is supported by a witness.
  • Corpus membership and exclusions do not depend on whether USVM wins.
  • A validation command checks shared-property loading, expected concrete outcomes and essential artifact fields.
  • All configurations consume the same property definitions.
  • The manifest records supported categories, limits, revisions, licenses and default run settings.
  • Selection/authoring may proceed while #384/#354 are implemented; final validation uses their shared semantics.

Stateful command-sequence/model-based testing, arbitrary object generators and full coverage of every property category are outside the initial corpus scope.

Dominant language
Kotlin
Stars
33
Forks
27
Avg merge
4d 3h
Merged PRs (30d)
15

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from UnitTestBot/usvm

All issues in UnitTestBot/usvm

Similar issues

More Kotlin issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.