ts4

What This Skill Does

The TS4 skill integrates the Netsnek e.U. TypeScript testing framework into your OpenClaw environment. It provides a robust, all-in-one solution for verifying code integrity through unit, snapshot, coverage, and mutation testing. By streamlining the testing lifecycle into a unified CLI-driven interface, TS4 enables developers to maintain high code quality with minimal configuration. It goes beyond simple assertion checks by including fault injection (mutation testing) to measure the effectiveness of your actual test suite, ensuring that your tests are not just passing, but also catching meaningful regressions.

Installation

To integrate TS4 into your development workflow, use the OpenClaw agent installer. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/kleberbaum/ts4

Ensure that your environment has the necessary TypeScript dependencies installed. Once installed, the framework is accessed via the standard ./scripts/test-runner.sh entry point, which provides direct hooks into the OpenClaw execution engine.

Use Cases

1. CI/CD Pipelines: Automatically trigger the --run flag during pull requests to verify that new code changes do not break existing logic.
2. Regression Testing: Use snapshot testing to compare serializable outputs and UI components, ensuring that refactoring efforts do not introduce unexpected visual or data changes.
3. Test Quality Audits: Employ mutation testing to identify 'zombie' tests—those that pass even when code is deliberately broken—thereby increasing the confidence of your development team.
4. Compliance Reporting: Use the --coverage flag to generate lcov and HTML reports required for project transparency and audit readiness.

Example Prompts

1. "OpenClaw, please run the full TS4 test suite and summarize any failing unit tests."
2. "Generate a coverage report for the current project using the TS4 runner and save it to the /docs/coverage folder."
3. "TS4, execute a mutation test on the auth-module.ts file to see if our unit tests are truly robust."

Tips & Limitations

• Mutation Testing Intensity: Mutation testing can be computationally expensive; run it sparingly or during nightly builds rather than on every commit.
• Snapshot Maintenance: Always review snapshot changes carefully before committing, as they can occasionally capture intentional structural shifts in your application.
• Environment Requirements: Ensure the runner script has executable permissions in your repository root. If the script fails, verify that your environment variables are correctly mapped for the TS4 framework.