Skip to content

Support matrix ​

What the current release supports: features, the formal subset, environments and external tools. For the meaning of each result, see Semantics.

Available ​

AreaNotes
init, doctor, configuration.veritas/config.json; veritas.config.{ts,mjs,js} only with --allow-code-config
Evidence discoveryREADME, docs/**/*.md, JSDoc, OpenAPI/JSON Schema bounds, git log, exported issues/PRs (.veritas-sources/), CHANGELOG; GitHub API and web only when enabled in config and not --offline
Statement extractionRule-based English and Japanese threshold phrases; optional LLM-assisted extraction through the Claude Code or Codex CLI with your own login, or the Anthropic or OpenAI API
Code intelligenceTypeScript Compiler API; static only
Property registryproposed / reviewed / accepted / rejected / conflicted / superseded, append-only approvals
Test inventoryVitest it/test/describe incl. modifiers, assertions, mocks, snapshots
Mutation testing@mizchi/mutator 0.4.x
Property-based testingfast-check, in a restricted process (permission model; project code is trusted, ADR 0011), fixed seeds
Z3 checksBounded integer/boolean subset (see below), z3-solver (WASM), run in its own process
Lean checksLean 4 with Lake when installed; proofs using sorry, admit, native_decide or extra axioms are rejected
Assessment and findingsEvidence vectors; no single score
Improvementimprove plans new test files only; applying needs the plan id and approval token, runs in an isolated copy and rolls back unless mutation results improve; refused in CI
Reportstext, JSON, Markdown, self-contained HTML and SARIF 2.1.0
CLIThe commands in the CLI reference
MCP serverRead-only tools; applying an approved improvement plan only with --allow-write
GitHub ActionOffline engine for pull_request, incremental with since; see GitHub Action
Agent Skillskills/veritas/SKILL.md; see Agents and MCP

Formal subset ​

ConstructSupported
Parameters/results of type number (as bounded safe integers) or booleanYes
Record parameters: object types (literal, interface or type in the same file) whose properties are all number or boolean; read as p.fieldYes (not as results)
Array parameters (number[], boolean[], readonly, Array<T>) up to formal.maxArrayLength elements; xs.length and xs[k] with a literal kYes (not as results)
Nested records, optional properties, passing or returning a record/array, computed indexes, array methods, spreadUnsupported
if/else, ternary, return, constYes
+ - *, comparisons, === !==, &&, ||, !, unary -Yes
Calls to other supported functions in the same fileYes (no recursion; not with record/array parameters)
/, %, **, floats, NaN, Infinity, ==, ??, castsUnsupported
Loops, let/var, side effects, async, generators, this, external stateUnsupported

Lean proofs cover integer and boolean parameters only; a property over records or arrays is unsupported with the Lean backend. Property-based tests draw inputs from the same subset (bounded integers, booleans, and records and arrays of them); strings, floats, NaN, Infinity and Unicode text are never generated.

Environments ​

ItemSupported
Node.js24 or later; project code runs only under Node.js 25+ (network blocked), unless sandbox.allowNetworkWithoutIsolation is set: the running Node.js, VERITAS_SANDBOX_NODE or node on PATH
OSLinux, macOS, Windows
Test runnerVitest. Mutation testing needs Vitest 4 or later: @mizchi/mutator declares Vitest 5 and also runs Vitest 4 projects, with a warning. On Vitest 3 and earlier, mutate is reported as unsupported and the other stages still run
DependenciesInstalled in node_modules (npm, pnpm, Yarn with nodeLinker: node-modules, Bun). Yarn Plug'n'Play is not supported
LanguagesTypeScript, JavaScript (ESM)

External tools and licenses ​

Veritas is licensed under Apache-2.0. It uses these external tools:

ToolLicenseHow it is used
@mizchi/mutatorMITnpm dependency, run as a separate process
z3-solver (Z3)MITnpm dependency, WASM build
fast-checkMITnpm dependency, run in a restricted process
Lean 4 and LakeApache-2.0Installed separately by the user (elan); not bundled
openaiApache-2.0npm dependency of the optional OpenAI adapter
@anthropic-ai/sdkApache-2.0npm dependency of the optional Claude adapter
lightningcss (through Vitest)MPL-2.0Unmodified transitive dependency; never bundled

Released under the Apache-2.0 License.