Repo Test Architect

[Repo Test Architect logo]

Repo Test Architect

[Repo Test Architect MCP server]

Audit-first test strategy tooling for codebases.

Repo Test Architect builds a deterministic audit graph before asking any model or agent to reason about tests. The goal is to identify repo-native, high-value test work from facts the tool can inspect locally: project roots, framework signals, existing tests, source classifications, blockers, and remaining risk.

The current implementation can:

• audit JavaScript/TypeScript, PHP, Python, Ruby, and Swift projects through supported adapters
• audit supported, bounded Kotlin/JVM fixtures through the same shared artifact model
• audit conventional Go modules and literal repository-contained go.work members through a supported bounded adapter
• audit conventional Cargo packages and literal repository-contained workspace members through a supported bounded Rust adapter
• audit one conventional SDK-style C# test project or one unique literal production/test project edge, including bounded native xUnit MTP-v2 and MSTest.Sdk v4 ownership, literal and one-hop root-aliased target frameworks, one repository-contained direct *.cs compile include, finite target-conditioned package shapes, bounded nearest-file build and central-package props, exact immutable test-field receivers, stable direct-call results, inline out results, framework exception and collection/string assertions, one-hop test helpers, and guarded well-known System type collisions, through a supported bounded .NET adapter
• audit one conventional Composer/PSR-4 project with PHPUnit through a supported bounded PHP adapter
• audit one conventional Mix application with exact MixProject/Mixfile, bounded source and Mix-task ownership, literal local ExUnit wrapper discovery, and test-body evidence through a supported bounded Elixir adapter
• detect polyglot project roots and report unsupported ecosystems without hiding them
• produce a complete repository analysis, findings, ranking, plan, execution hints, and verification commands in one audit pass
• classify source files by likely test value and defer low-value direct tests
• rank candidates and generate test plans from the audit graph
• derive provider-neutral execution, context, parallel-safety, and repository-reasoning hints without selecting models or spawning subagents
• analyze conservative test placement findings across project boundaries
• collect project-level stats for coverage, candidate counts, frameworks, commands, and adapter usage
• provide disabled-by-default local MCP diagnostics, safe internal-error report IDs, runtime checks, and inspectable sanitized bundles without external reporting
• expose the same deterministic behavior through CLI commands, a local invoke harness, and a stdio MCP SDK server
• lock behavior with golden snapshots, model-consistency scenarios, package checks, and cross-OS CI

Native test generation is intentionally deferred. generate_selected_test returns a structured deferred artifact until adapter-specific generation policy and repair-loop fixtures exist.

Repo Test Architect 1.1.0 is available on npm as latest and in the Official MCP Registry, with stable support for the documented CLI, MCP tools, configuration and versioned artifact contracts. Treat its findings as evidence-backed review input rather than an automatic instruction to change a repository. See the 1.1.0 release notes for per-project failure containment, skipped-test handling, artifact validation, compatibility notes and publication status, and the 1.0.0 release notes for the stable contract.

Ten adapters are supported within their documented boundaries. Dart/Flutter remains experimental, and native test generation remains deferred.

Maintenance is provided as time permits, with no guaranteed response time or feature schedule. Focused community PRs are welcome; see Contributing and Support.

Install

Node.js 20 or newer is required.

Run the CLI without a global install:

npx --yes repo-test-architect doctornpx --yes repo-test-architect analyze .

Pin the stable version:

npx --yes [email protected] doctornpx --yes [email protected] analyze .

Or install the CLI and MCP server binaries:

npm install --global repo-test-architectrepo-test-architect doctorrepo-test-architect analyze .

Add the local stdio MCP server to an MCP-capable client:

{  "mcpServers": {    "repo-test-architect": {      "command": "npx",      "args": [        "--yes",        "repo-test-architect",        "mcp"      ]    }  }}

To keep an MCP client on this exact release, pin its version:

{  "mcpServers": {    "repo-test-architect": {      "command": "npx",      "args": [        "--yes",        "[email protected]",        "mcp"      ]    }  }}

The client launches the server locally. Repository source stays on the machine unless the client or another configured tool sends it elsewhere. Connected models receive instructions to start with analyze_repository for a general repository review. See MCP client config and agent install paths for global-install, local-checkout, and host-specific guidance.

Quick Start

For a human-readable review of the current repository:

npx --yes repo-test-architect analyze .

analyze detects every project root, runs each supported adapter once, and derives the audit summary, top findings, candidate ranking, test plan, execution hints, project stats, and verification commands. Markdown stays compact; JSON preserves the complete evidence bundle:

npx --yes repo-test-architect analyze . --format jsonnpx --yes repo-test-architect analyze . --changed

Useful focused views:

Run repo-test-architect --help for the short command map or repo-test-architect <command> --help for options. The CLI reference documents the full surface.

For an MCP-connected model, the equivalent default is analyze_repository. Use narrower tools only when the request asks for one artifact or already supplies an audit artifact.

Current Scope

Available adapters:

• dart (experimental): Dart and Flutter pubspec packages, conventional package:test and flutter_test entrypoints, exact library-import evidence, widget test recommendations, and bounded dart test / flutter test commands; see Dart and Flutter support
• csharp: one static SDK-style test project or one unique literal production/test project edge, including bounded native xUnit MTP-v2 and MSTest.Sdk v4 ownership, exact literal or one-hop root-aliased target membership, one repository-contained direct *.cs compile include, finite project-local target-conditioned package predicates, and a pair selected amid unrelated projects, with bounded nearest-file Directory.Build.props metadata and static Directory.Packages.props versions, xUnit, NUnit, or MSTest attributed tests, exact project-file commands, runnable-body-owned direct type calls, bounded concrete-local or immutable test-field receivers, one-hop stable direct-call, receiver-call, or inline out var result assertions, bounded exception assertions, and one same-class private-static test-helper hop; see the C# alpha support matrix
• elixir: one conventional Mix application with literal app and exact MixProject/Mixfile ownership, conventional/app-prefixed modules and protocols, exact Mix tasks, bounded acronym, terminal-plural, repeated-declaration, and compiled local ExUnit-wrapper ownership, static startup options, test-body-scoped direct fully qualified or exact-alias calls, conservative filename evidence, and a blocker-free mix test command; see Elixir alpha support
• javascript: JavaScript/TypeScript repositories with Node's test runner (including TypeScript execution scripts), Bun test, AVA, Mocha/CommonJS, Vitest, Jest, Playwright, Cypress, Express/Supertest, React Testing Library detection, and bounded literal browser request-to-route evidence; see the alpha support matrix for evidence boundaries and known gaps
• go: conventional go.mod projects and literal repository-contained go.work members using runnable standard-library TestXxx, FuzzXxx, or ExampleXxx tests, package-local filename, unique top-level and parser-owned concrete receiver-method symbols through explicit types, exact simple constructor results, or exact statically typed test-helper results, bounded standard-library and Testify assertion usage, parser-scoped local shadow checks, same-package or exact external-package imports (including dot imports), generic top-level functions, and bounded callable-body-owned same-package or module-local source hops, module-local commands, and optional explicit GOOS/GOARCH/custom-tag selection; see the alpha support matrix for the supported boundary and blockers
• kotlin: conventional Gradle/Maven JVM module roots, settings-owned Gradle aggregates, and root-declared Maven reactors with Kotlin and/or Java standard source sets, dependency-qualified direct/exported-transitive module evidence, JUnit 4/5, kotlin.test, bounded Gradle/JUnit Platform Kotest common specs, conventional Gradle/Spock features, and method-level TestNG through direct Maven dependencies or Gradle useTestNG(); see the Kotlin/JVM alpha support matrix
• php: one root Composer project with literal string-valued PSR-4 source/test ownership, bounded literal autoloaded function files, statically declared PHPUnit, exact bounded commands or explicit safe command withholding, conventional runnable test classes including one unique source- or test-owned PHPUnit base edge, direct imported or exact same-namespace class calls, and conservative basename fallback; see PHP alpha support
• python: bounded Python package, FastAPI, Django, and Flask layouts with declarative multi-package/namespace ownership, configured pytest discovery, exact absolute/relative imports, one-hop source dependency evidence, static framework test-client route evidence, pytest/unittest, async and property-based extensions, fixture reachability, pip/setuptools, uv, Poetry, Hatch, tox, nox, and coverage configuration; see the Python alpha support matrix
• rust: conventional Cargo packages and literal repository-contained workspace members using the built-in #[test] harness, inline #[cfg(test)] modules, exact exclusion of external test-only module graphs, exact crate-module imports from tests/, and exact unconditional crate-root symbol re-exports; see the Rust alpha support matrix
• ruby: one conventional Bundler project with lib/ sources, one root gemspec or a complete exact named root-gemspec set, runnable Minitest::Test test_* methods or RSpec examples, exact bounded commands, root .rspec and exact per-file spec_helper loading, three-edge literal require/unique-constant evidence, exact singleton calls, exact constant-owned RSpec described_class, direct immutable constructor-local, one-line RSpec let/subject, exact source-factory and same-group RSpec helper receivers, and exact same-file literal shared-example inclusion, bounded assertion usage, conservative basename fallback, and explicit Minitest-spec/Rails/mixed-runner blockers; see the Ruby alpha support matrix
• swift: Swift Package Manager, Xcode-style and Bazel/rules_swift layouts, Swift Testing, XCTest, Quick/Nimble, SnapshotTesting, VaporTesting/XCTVapor, reactive frameworks, and generic Fluent database boundaries with driver-specific qualifiers; see the Swift alpha support matrix

Project detection reports Elixir Mix roots through the supported bounded adapter. Unsupported ecosystems remain visible so clients can distinguish "not audited yet" from "not present."

Don't see your stack? Open an adapter request with the language or ecosystem, build system, test frameworks, and—when possible—a representative public repository. Requests help prioritize adapters against real repository shapes and user demand.

The public package exposes the audit CLI, the stdio MCP server, and a deterministic MCP invoke harness under the stable binary names documented below.

Advanced CLI and Contributor Reference

The commands below expose focused artifacts, fixtures, evals, diagnostics, and release checks for advanced use and repository development.

npm run analyzenpm run analyze:jsonnpm run analyze:examplenpm run analyze:example:json

npm run doctornpm run doctor:json

npm run diagnostic-bundle -- --diagnostics-file ./.repo-test-architect/diagnostics.jsonl --format jsonnode ./src/cli/index.js diagnostic-bundle --diagnostics-file ./.repo-test-architect/diagnostics.jsonl --format json

npm run adaptersnpm run adapters:json

npm run detect-rulesnpm run detect-rules:json

npm run detect:examplenpm run detect:example:jsonnpm run detect:kotlin-fixturenpm run detect:kotlin-fixture:jsonnpm run detect:apple-fixturenpm run detect:apple-fixture:jsonnpm run audit-projects:examplenpm run audit-projects:example:jsonnpm run audit-projects:changed-sincenpm run summarize-projects:examplenpm run summarize-projects:example:jsonnpm run rank-projects:examplenpm run rank-projects:example:jsonnpm run plan-projects:examplenpm run plan-projects:example:jsonnpm run hints-projects:examplenpm run hints-projects:example:jsonnpm run findings-projects:examplenpm run findings-projects:example:jsonnpm run placement-projects:examplenpm run placement-projects:example:jsonnpm run placement-projects:split-example:jsonnpm run stats-projects:examplenpm run stats-projects:example:json

node ./src/cli/index.js findings-projects . --exclude-project "examples/**"

node ./src/cli/index.js audit-projects ./examples/polyglot-workspace --format jsonnode ./src/cli/index.js summarize-projects --from-project-audits ./project-audits.json --format jsonnode ./src/cli/index.js rank-projects --from-project-audits ./project-audits.json --format jsonnode ./src/cli/index.js plan-projects --from-project-audits ./project-audits.json --format jsonnode ./src/cli/index.js findings-projects --from-project-audits ./project-audits.json --format jsonnode ./src/cli/index.js placement-projects --from-project-audits ./project-audits.json --format jsonnode ./src/cli/index.js stats-projects --from-project-audits ./project-audits.json --format json

npm run audit:examplenpm run audit:kotlin-fixture

npm run audit:example:jsonnpm run audit:kotlin-fixture:json

npm run plan:examplenpm run plan:example:jsonnpm run hints:examplenpm run hints:example:jsonnpm run plan:kotlin-fixturenpm run plan:kotlin-fixture:jsonnpm run plan:item:examplenpm run plan:changednpm run plan:changed-since

node ./src/cli/index.js hints ./examples/node-vitest-basic --item add-test:src/authService.tsnode ./src/cli/index.js hints-projects ./examples/polyglot-workspace --format json

npm run explain:example

npm run rank:example

npm run placement:examplenpm run placement:example:jsonnpm run placement:from-audit:example

npm run mcp:toolsnpm run mcp:analyze:examplenpm run mcp:adaptersnpm run mcp:detect-rulesnpm run mcp:detect:examplenpm run mcp:audit-projects:examplenpm run mcp:summarize-projects:examplenpm run mcp:rank-projects:examplenpm run mcp:plan-projects:examplenpm run mcp:findings-projects:examplenpm run mcp:placement-projects:examplenpm run mcp:placement-split:examplenpm run mcp:stats-projects:examplenpm run mcp:audit:examplenpm run mcp:audit:kotlin-fixturenpm run mcp:placement:examplenpm run mcp:audit:envelopenpm run mcp:stdionpm run mcp:smoke

npm run plan:from-audit:example

npm testnpm run alpha:checknpm run release:check

npm run validation:repos -- --profile reactnpm run validation:repos -- --profile workspace --limit 10npm run validation:repos -- --profile swift,gradle,maven --format json

npm run corpus:checknpm run corpus:scorecardnpm run corpus:measure -- --case python-asyncer --checkout /path/to/pinned/asyncernpm run corpus:measure -- --case python-django --checkout /path/to/pinned/django --profile-phasesnpm run csharp:performance:checknpm run javascript:performance:checknpm run python:performance:checknpm run kotlin:performance:checknpm run rust:performance:checknpm run swift:performance:checknpm run go:performance:checknpm run ruby:performance:checknpm run php:performance:check

npm run eval:checknpm run eval:summarynpm run eval:testnpm run eval:update

npm run model-consistency:checknpm run model-consistency:jsonnpm run model-consistency:json -- --profile local-smallnpm run model-consistency:compare -- baseline-summary.json candidate-summary.jsonnpm run model-consistency:stats

npm run smoke

powershell -ExecutionPolicy Bypass -File ./scripts/smoke.ps1

npm run pack:checknpm run bin:checknpm run installed-package:checknpm run distribution:checknpm run release:check

Shape

src/  core/    audit-model.ts    audit-phase-timing.js    plan-execution-hints.js    plan-execution-hints.ts    repository-text-files.js    report.js    report.ts  diagnostics/    diagnostics.js  adapters/    csharp/      audit.js    javascript/      audit.js      audit.ts    kotlin/      audit.js    python/      audit.js    rust/      audit.js    swift/      audit.js  cli/    index.jsexamples/  csharp-sdk-project-pair/  csharp-sdk-unique-pair/  csharp-sdk-xunit-basic/  node-vitest-basic/  express-supertest/  react-testing-library/  kotlin-junit-basic/  kotlin-gradle-groovy-junit/  kotlin-gradle-module-graph-junit/  kotlin-maven-junit/  kotlin-maven-reactor-junit/  kotlin-maven-wrapper-junit4/  kotlin-gradle-aggregate-kotest/  kotlin-gradle-spock/  kotlin-maven-testng/  python-pytest-service/  python-uv-pytest/  python-poetry-pytest/  rust-cargo-basic/  rust-cargo-workspace-basic/  swift-spm-xctest/  swift-spm-swift-testing/  swift-spm-quick-nimble/  swift-spm-custom-paths/  swift-spm-alternate-roots/  swift-bazel-xctest/  swift-xcode-test-plans/  vapor-service-tests/  vapor-mongodb-boundaries/evals/  expected/  model-consistency/schemas/

JavaScript/TypeScript, PHP, Python, Ruby, Swift, bounded Kotlin/JVM modules, bounded Go modules, bounded C# SDK project shapes, and bounded Rust Cargo packages are supported adapter proof points. PHP support covers the bounded Composer/PSR-4/PHPUnit ownership, command-withholding, and evidence rules in PHP Alpha Support. Ruby support covers the bounded Bundler/Minitest/RSpec ownership and evidence rules in Ruby Alpha Support. Rust support includes literal repository-contained workspace members, exact package commands, built-in test ownership, literal module graphs, exact test-only module exclusion, direct logical-module imports, inherent associated calls, and exact unconditional crate-root symbol re-exports as defined in Rust Alpha Support. C# support covers one conventional SDK-style test project or one unique literal production/test project edge, including bounded native xUnit MTP-v2 and MSTest.Sdk v4 ownership, exact literal or one-hop root-aliased target membership, one repository-contained direct *.cs compile include, finite target-conditioned package predicates, and a pair amid unrelated projects, with bounded nearest-file build metadata and static central package versions, exact test-project commands, runnable-body-owned direct type calls, bounded concrete-local or immutable test-field receivers, one-hop stable direct-call, receiver-call, or inline out var result assertions, bounded exception assertions, and one same-class private-static test-helper hop while solution ownership remains excluded. Go support includes literal repository-contained go.work members, explicit static build-target selection, bounded standard-library/Testify assertion usage, parser-scoped receiver identity through concrete local and test-helper bindings, and callable-body-owned source evidence as defined in Go Alpha Support. Kotlin/JVM support is limited to conventional Gradle/Maven modules and directly declared aggregate graphs, JUnit, the documented Kotest common-spec and Spock feature variants, or method-level TestNG, and standard source sets as defined in Kotlin/JVM Alpha Support.

Important runtime surfaces:

• CLI: src/cli/index.js
• MCP tool definitions: src/mcp/tool-definitions.js
• stdio MCP SDK server: src/mcp/stdio.js
• local invoke harness: src/mcp/invoke.js
• release gate: scripts/check-release-readiness.js

Docs

• Contributing
• Support
• Security policy
• Project plan
• Project status
• Public readiness
• Alpha readiness
• Real repository audit reports
• Product positioning
• Near-term roadmap
• Adapter hardening plan
• August 2026 adapter portfolio analysis
• Shared audit kernel inventory
• Demo script
• Decision log
• Second adapter spike
• Kotlin/JVM alpha support
• Go alpha support
• Go validation hunt report
• Go HTTP validation report
• Go workspace ownership validation report
• Go dot-import validation report
• Go constructor-result validation report
• Go cross-package source validation report
• Go assertion-usage validation report
• Go parser-scoped binding validation report
• Go receiver and callable ownership validation report
• Go test-helper receiver validation report
• Rust alpha support
• Ruby alpha support
• PHP alpha support
• PHP brick/math live validation report
• PHP Guzzle live validation report
• PHP Ramsey UUID live validation report
• PHP Monolog post-promotion validation report
• Elixir Jason live validation report
• Elixir Plug live validation report
• Elixir Absinthe live validation report
• Ruby rubyzip live validation report
• Ruby Faraday live validation report
• Ruby Factory Bot live validation report
• Ruby Diplomat live validation report
• Ruby helper/factory return live validation report
• Ruby shared-example live validation report
• Ruby Licensed post-promotion validation report
• C# alpha support
• C# TDD live validation report
• C# Sharp Cast live validation report
• C# Glob live validation report
• C# central packages live validation report
• C# multi-target live validation report
• C# target-conditioned packages live validation report
• C# Microsoft.Testing.Platform v2 live validation report
• C# MSTest.Sdk v4 live validation report
• Kotlin/JVM validation hunt report
• Adapter contract
• Artifact contract
• CLI reference
• Project detection
• Polyglot workflow
• MCP tool surface
• MCP client config
• MCP deployment
• Local diagnostics
• Agent install paths
• Release lifecycle
• Release checklist