Repository navigation
Releases
quelltest v0.3.1
Fixes from the 0.3.0 effectiveness report, and a research-backed answer to code that depends on API calls and services (see docs/dependencies.md).
Added
generate: property guards (typeof body.lat !== "number",!branch.geofences?.length) become tests with a composed argument.generate: path-condition stub synthesis for injected dependencies (parameters, their methods, globalfetch): the guards on a call's result define the conditions, a small solver picks the values, and the first guard to fire decides the expected outcome. Stubs are labelled as derived from guards, not from the real service. A stubbedglobalThis.fetchis always restored.- Rules
unguarded-network-callanddeep-response-chain; inline literal secrets injwt.sign/createHmac; the plain missing-awaitform. verify: survivors on mocked code carrymockBoundaryand an explanation in the handoff;--commandruns your own integration command (Testcontainers, in-memory server) against every mutant;--timeout; mutants capped per kind (maxPerKind, default 8).quell mocks --examples FILE: checks stubs annotated// quell-mock GET /pathagainst recorded examples (HAR, JSON map, OpenAPI JSON).quell evaland theeval/fixtures ship in the package; findings carryconfidenceand--min-confidencefilters them.
Fixed
module.exports.name = fn,exports.name, bracket form andObject.assign(module.exports, ...)are recognised as exports.- Route request cases see through
asyncHandler(...),catchAsync(...),wrap(...), middleware chains and curried wrappers. gatereports a newly added.onlyand shows a deleted-and-rewritten test as a replacement.- A sanitiser applied through a variable (
const p = escapeRegex(q)) no longer triggersregex-injection; a redirect checked withstartsWith('/')is not an open redirect. - From the independent review of this release: generation for
if (!body) ...; if (body.lat > 90) ...composes an object root instead oftrue; the security gate allowsglobalThis.fetchonly as an assignment target or asconst originalFetch = globalThis.fetch(never called or aliased); prototype-walking member names (__proto__,constructor,prototype) are rejected so the process cannot be polluted; guards nested in else-branches, loops or other conditions, tests of reassigned parameters and functions that call the network without a stubbable result are refused with a reason; a stubbed parameter that is also guarded keeps its guard cases; duplicate local result names are ambiguous; an imported or localfetchis not the global one;--commandpasses the test path in an environment variable (no shell interpolation) and--infra-exitmarks environment-failure exit codes;missing-awaitneeds a Model-like receiver or an ORM in the module and ignoresArray.find; a redirect needs bothstartsWith('/')andstartsWith('//')checks; only atryblock (notcatch/finallyor detached callbacks) guards a call; gate pairing does renames first and ignores generic names; computed export keys are skipped;quell mocksescapes routes, avoids backtracking and survives malformed example files. - A verification mirror that cannot be deleted (a child process still holds it after a timeout) no longer fails the run.
Install: npm install quelltest@0.3.1 (https://www.npmjs.com/package/quelltest/v/0.3.1)
quelltest v0.3.0
Repositioned as the free, offline gate for AI-written tests (see docs/agents.md).
Added
quell gate --diff REF: detects deleted/skipped tests,.only, removed and loosened assertions and changed expected values in a change;--json,--sarif,--strict; exit code 5.// quell-allow-weakenexempts a test.quell mcp: MCP server on stdio withfind,verifyandgatetools.verify: survivor handoff report (--handoff FILE),--min-score,--findings,--in-place,// quell-ignore-mutant, relative path support, the failing command in error messages.- Risk-aimed mutants: sanitiser unwrap,
awaitremoval,??/||swaps, ordered ahead of generic operator flips. - Rules:
nosql-injection,path-traversal,open-redirect,missing-await,hard-coded-secret,eval-input,unparsed-json; one hop of data flow fromreq.body/query/params(aliasing, spread,$set, destructuring,JSON.parse,new URL). // quell-ignore [rule]and// quell-ignore-file.generate: request cases for Express route handlers in TODO notes, actionable reasons (export / extract / unsupported expression), skips candidates already covered (--include-coveredoverrides).- Verifier benchmark (
eval/gate), runner fixture matrix for Jest, Mocha, Vitest andnode:test.
Changed
verifyandgenerate --verifyrun in a temporary copy of the project by default; the real source is never written (falls back to in-place with a backup for very large projects).- Findings are ranked by per-rule risk;
falsy-fallbackfires only for numeric defaults;nullishignores code that already has a fallback or guard;unguarded-callrespectsasyncHandler-style wrappers. - README rewritten around the verifier; honest comparison with Stryker, Flawd and LLM generators.
Fixed (from the independent review of this release)
- Verification can no longer write through a symlinked source file; sources under
build//dist/are mirrored; mutants that do not parse are dropped instead of counted as kills;return awaitand plain coercions are no longer prioritised equivalent mutants; refuses to overwrite an existing test in place; warns when it falls back to in-place. - Scanner: per-sink sanitisers, whole-body vs single-field taint, reassignment and parameter shadowing, same-site redirects, route/i18n constants,
process.envdefaults;quell-ignore-mutantno longer suppresses scanner findings. - Gate: git renames,
describe.only, template-literal and repeated test names,expect.assertions/t.mock/t.planno longer counted, unparsable files are errors; the PR workflow's gate step now fails the job. - MCP: malformed messages, batches and stray responses are handled without crashing.
- Nothing in 0.2.0's behaviour was removed. New exit codes: 4 (
verifynot verified, 0.2.0) and 5 (gate).
Install: npm install quelltest@0.3.0 (npm). Later fixes are in the changelog.
quelltest v0.2.0
AST scanner, coverage-based score, mutation-based verification, real test generation for the detected runner, --diff, SARIF, --llm hook, Apache-2.0 licence.
Install: npm install quelltest@0.2.0 (npm). See CHANGELOG.md for later releases.
quelltest v0.1.0
First release: regex scanner, placeholder scaffolds.
Install: npm install quelltest@0.1.0 (npm). Superseded: this version generated placeholder tests and a score that could not move; use 0.2.0 or later.