Name: vitron-ai/themis
Rating: 98.5 (1 reviews)
Author: vitron-ai

vitron-ai/themis

Reference tile for Themis, a Node.js and TypeScript unit test framework designed for AI coding agents. Covers unit-test authoring, Jest/Vitest migration, agent-readable failure output with repair hints, and first-class integrations for Claude Code, Cursor, and generic agents.

2.91x

Quality

94%

Does it follow best practices?

Impact

99%

2.91x

Average score across 20 eval scenarios

Securityby

Passed

No known issues

Evaluation results

100%

85%

Diagnosing and Fixing a Broken Themis Test Suite

Criteria

Without context

With context

--reporter agent in script

100%

--rerun-failed in script

100%

failures[].cluster mentioned

100%

failures[].repairHints mentioned

100%

sourceFile/lineNumber mentioned

100%

No stack trace re-reading

70%

100%

expected/actual mentioned

100%

Script comment explains why agent reporter

100%

30%

Setting Up Themis for a Claude Code Engineering Team

Criteria

Without context

With context

--claude-code flag used

100%

CLAUDE.md mentioned in notes

100%

Skill file path mentioned

100%

Slash commands mentioned

100%

PostToolUse hook mentioned

80%

100%

generate command in setup.sh

60%

100%

Skill auto-load behavior described

100%

Hook feedback loop described

100%

94%

24%

Writing Reliable Themis Tests for a Scheduled Job Service

Criteria

Without context

With context

Clock controlled in scheduler test

100%

Network mocked in rate test

100%

test() for aggregateRecords

50%

intent() for ReportScheduler

100%

Triple-slash reference present

100%

No Jest/Vitest APIs in test files

100%

Nondeterminism handling documented

100%

Tests in __themis__/tests

100%

Deterministic assertions

100%

75%

Set Up Themis in a New TypeScript Project

Criteria

Without context

With context

.themis/ gitignored

100%

__themis__/reports/ gitignored

100%

__themis__/shims/ gitignored

100%

init --agents in setup

100%

generate src/ in setup

100%

.themis/ described as framework-managed

100%

__themis__/tests described as committed

100%

No Jest/Vitest setup

100%

90%

Authoring Themis Tests for a Document Processing Service

Criteria

Without context

With context

Triple-slash reference in pipeline test

100%

Triple-slash reference in utility test

100%

intent() for DocumentParser

100%

test() for normalizeText

100%

intent has context phase

100%

intent has run phase

100%

intent has assert/verify phase

100%

No Jest/Vitest APIs in test files

100%

Reference directive explained

83%

100%

83%

Add Tests for a TypeScript Utility Library

Criteria

Without context

With context

intent for pipeline

100%

test for slugify

100%

No Jest describe/it/expect

100%

No Jest import

100%

DECISIONS.md present

100%

intent rationale in DECISIONS.md

100%

test rationale in DECISIONS.md

28%

100%

70%

Migrate an Existing Jest Test Suite to Themis

Criteria

Without context

With context

themis migrate command used

100%

No manual Jest rewrite

100%

Built-in workflow first

100%

rerun-failed mentioned

100%

update-contracts mentioned

100%

No Jest config preserved

100%

MIGRATION_NOTES.md present

100%

No Jest devDependencies kept

100%

60%

Add Tests to a React Component Library Using Themis

Criteria

Without context

With context

No tests/*.cjs shim

100%

No tests/*.setup.* file

100%

No jest.config shim

100%

No moduleNameMapper

100%

APPROACH.md present

100%

APPROACH.md no-shim rationale

100%

Test files use Themis constructs

100%

Test files in __themis__/tests

100%

65%

Generate Baseline Tests for a TypeScript Module

Criteria

Without context

With context

generate command in script

100%

intent for runPipeline

100%

test for aggregateStep

100%

Tests in __themis__/tests

100%

.themis/ described as artifact output

100%

__themis__/tests described as committed

100%

No Jest/Vitest APIs in tests

100%

GENERATION_REPORT.md present

100%

99%

65%

Migrating a Vitest Project Fully to Themis

Criteria

Without context

With context

themis migrate vitest in script

100%

--rewrite-imports --convert flags used

100%

No manual sed/awk rewrite

100%

--rerun-failed in script

100%

--update-contracts in script

100%

Vitest deps removal mentioned

100%

Three failure states documented

66%

100%

Built-in commands before manual work

60%

100%

Final themis test confirms stable

20%

90%

Evaluated: 21 days ago
Agent: Claude
Model: Claude Sonnet 4.6

Table of Contents

Diagnosing and Fixing a Broken Themis Test Suite Setting Up Themis for a Claude Code Engineering Team Writing Reliable Themis Tests for a Scheduled Job Service Set Up Themis in a New TypeScript Project Authoring Themis Tests for a Document Processing Service Add Tests for a TypeScript Utility Library Migrate an Existing Jest Test Suite to Themis Add Tests to a React Component Library Using Themis Generate Baseline Tests for a TypeScript Module Migrating a Vitest Project Fully to Themis