[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_129":130},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":-5,"_77":-5,"_78":48,"_79":-5,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93},"apiUrl","https://odel.app/api","creator","karzone","moduleId","testatlas","@karzone/testatlas","displayName","TestAtlas","tagline","Semantic map of a .NET test-automation solution for AI agents — search, impact, endpoints","iconKey","https://raw.githubusercontent.com/Karzone/TestAtlas/main/assets/logo-mark.png","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1785387469000,"updatedAt",1788775642000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Karzone%2FTestAtlas.Mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",3,"upstreamUpdatedAt",1788645619000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/Karzone/TestAtlas","githubRepoFullName","Karzone/TestAtlas","releaseId","ext-karzone-testatlas","version","0.1.10","descriptionMarkdown","\n

\n $\"\"$ \n TestAtlas\n

\n\n

\n A queryable, semantic map of your .NET test-automation solution — in one SQLite file, served to your AI agent over MCP.\n

\n\n

\n Zero config · No AI · No network · Deterministic\n

\n\n

\n $\"TestAtlas.Mcp$ \n $\"TestAtlas.Cli$ \n $\"Model$ \n $\"Glama$ \n $\".NET$ \n $\"MIT$ \n

\n\n

\n $\"TestAtlas$ \n

\n\n

\n _{11 MCP tools}
\n _{resolve_step · step_catalog · impact · search_steps · search_scenarios · get_scenario · get_step_definition · list_tags · list_endpoints · project_dependencies · stats}\n

\n\n

\n The problem ·\n See it in action ·\n Quick start ·\n MCP ·\n Commands ·\n Fresh maps ·\n Roadmap\n

\n\n---\n\n## The problem\n\nLarge test-automation solutions are hard to navigate — for humans *and* for AI agents. Asked to\nautomate a new story, an agent can't see which steps already exist, where similar code lives, or\nwhat conventions the solution follows — so it duplicates steps and misplaces code. TestAtlas\nindexes the solution once into a single SQLite map and answers those questions precisely:\ndeterministically, offline, without a model or a network call.\n\n---\n\n## See it in action\n\nIndex the bundled 8-project sample once — `testatlas index samples/SampleShop/SampleShop.sln` — then\nask it questions from the terminal. Every number below is real output from that run:\n\n```console\n$ testatlas stats sampleshop.db\nTestAtlas map: sampleshop.db (schema v5)\n\ntotals: 8 project(s), 15 class(es), 36 method(s), 14 step definition(s)\nclass kinds:\n api_client 7\n page_object 4\n step_class 4\n\ngherkin: 4 feature(s), 5 scenario(s), 16 step(s)\nbound steps: 16 · unbound: 0 · ambiguous: 0\nendpoints: 3 (3 call site(s))\n```\n\n…or let your agent ask them over MCP. Here an agent checks whether a step it is about to write\nalready exists — `resolve_step` answers with the definitions that would bind it, or the closest\nnear-misses to reuse instead:\n\n```jsonc\n// agent → testatlas: resolve_step { \"text\": \"I add the product to my cart\" }\n{\n \"status\": \"none\", // nothing binds this exact text — don't invent it from scratch:\n \"suggestions\": [ // these existing steps are the closest, ranked by shared terms\n { \"expression\": \"product (.*) is added to the cart with quantity (.*)\",\n \"keyword\": \"When\", \"location\": \"SampleShop.Tests.Api/Steps/CatalogApiSteps.cs:34\" },\n { \"expression\": \"the cart is not empty\",\n \"keyword\": \"Then\", \"location\": \"SampleShop.Tests.Api/Steps/CatalogApiSteps.cs:43\" }\n // …8 more\n ]\n}\n```\n\nLive sample outputs, committed from that same solution:\n**[HTML report](https://htmlpreview.github.io/?https://github.com/Karzone/TestAtlas/blob/main/docs/sample-report.html)** (features, scenarios, bindings, class kinds, endpoints) ·\n**[dependency map](https://htmlpreview.github.io/?https://github.com/Karzone/TestAtlas/blob/main/docs/sample-map.html)** (the eight projects and their edges).\n_{(GitHub serves `.html` as source, so the links route through htmlpreview.github.io — or download from [`docs/`](https://github.com/Karzone/TestAtlas/blob/main/docs/) and open locally.)}\n\n## What you get\n\nTestAtlas statically analyses the solution and emits `codemap.db` — projects and their dependency\nedges, Gherkin features/scenarios/steps, step definitions and their bindings (bound / unbound /\nambiguous), page objects, API clients, helpers, test classes, and the call/usage edges connecting\nthem — then turns that map into answers:\n\n| | Capability | What you get |\n|:--:|---|---|\n| 🧩 | **Reuse-first authoring** | `resolve_step` — would this phrase bind an existing definition? `step_catalog` — the reusable step vocabulary with placeholders + allowed values |\n| 💥 | **Impact** | Blast radius — the scenarios affected by changing a class, method, step, or endpoint |\n| 🔍 | **Search** | FTS5 over step definitions + scenarios — *\"does a step for this already exist?\"* |\n| 🔌 | **MCP** | All of it served to an AI agent over stdio — precise answers in a few hundred tokens, no context stuffing |\n| 📊 | **Report & map** | Self-contained HTML drill-down of the whole map + project-dependency graph |\n| 📈 | **Stats** | Entity counts, class-kind breakdown, binding coverage, diagnostics |\n\nAll of it **offline, deterministic, and reproducible** — same input, same map, every time.\n\n---\n\n## 🚀 Quick start\n\n> **Requires** the [.NET SDK 8.0+](https://dotnet.microsoft.com/download). On a corporate machine\n> where `dotnet tool install` fails with **401**, see\n> [docs/troubleshooting.md](https://github.com/Karzone/TestAtlas/blob/main/docs/troubleshooting.md).\n\n**1 — Install** the CLI (and the MCP server, if you'll connect an agent):\n\n```bash\ndotnet tool install --global TestAtlas.Cli\ndotnet tool install --global TestAtlas.Mcp\n```\n\n**2 — Index** your solution. This produces the map (`./codemap.db`) that every query, report, and\nMCP answer reads — nothing works without it:\n\n```bash\ntestatlas index path/to/YourSolution.sln\n```\n\nNo need to build or restore the solution first — indexing is a syntax-only pass, so an unrestored\ncheckout maps fine. Point `index` at a folder (or nothing) and it auto-discovers a single\n`.sln`/`.csproj` there.\n\n**3 — Query it:**\n\n```bash\ntestatlas stats\ntestatlas search \"login\"\ntestatlas report # writes codemap.html\ntestatlas map # writes codemap-map.html\n```\n\n…and to serve it to your AI agent, continue to [MCP setup](#-use-it-from-an-ai-agent-mcp).\n\n

Or run from source (no install)

\n\n```bash\ngit clone https://github.com/Karzone/TestAtlas.git\ncd TestAtlas\ndotnet build TestAtlas.sln\ndotnet run --project src/CodeMap.Cli -- index path/to/YourSolution.sln\n```\n\n

\n\n---\n\n## 🔌 Use it from an AI agent (MCP)\n\nTestAtlas ships an MCP server — `testatlas-mcp` — that serves the map to any MCP-aware client\n(Visual Studio / VS Code Copilot, Claude Code, and others) over stdio JSON-RPC. The agent asks a\nprecise question and gets an exact, structured answer straight from the `.db` — instead of\nstuffing source files into its context window.\n\nPrerequisites: **both tools installed and a map built** — steps 1–2 of the\n[Quick start](#-quick-start). Then register the server:\n\n**Visual Studio / VS Code** (GitHub Copilot agent mode) — add to your `.mcp.json`\n(`%USERPROFILE%\\.mcp.json` or `\\.mcp.json`):\n\n```json\n{\n \"servers\": {\n \"testatlas\": {\n \"type\": \"stdio\",\n \"command\": \"testatlas-mcp\",\n \"args\": [\"C:\\\\path\\\\to\\\\codemap.db\"]\n }\n }\n}\n```\n\n**Pass the map path explicitly** (as above, or via a `TESTATLAS_DB` env var) — most agents launch\nthe server from their own working directory, not your solution folder, so relying on auto-discovery\nmakes the server exit with `code 2`. In Visual Studio you can also use **Tools picker → `+` → Add\ncustom MCP server** to write this entry for you. On the .NET 10 SDK you can skip the install and\nuse `\"command\": \"dnx\", \"args\": [\"TestAtlas.Mcp\", \"--yes\", \"C:\\\\path\\\\to\\\\codemap.db\"]` — `dnx`\nfetches and runs the server on demand.\n\n**Claude Code:**\n\n```bash\nclaude mcp add testatlas -- testatlas-mcp path/to/codemap.db\nclaude mcp list # the testatlas row should read: ✔ Connected\n```\n\nBy default the server is registered for the **current project** (`--scope local`). Add\n`--scope user` to make it available in every project on your machine, or `--scope project` to\nshare the registration with your team via a committed `.mcp.json`.\n\n> [!IMPORTANT]\n> MCP clients load servers **at session start** — if you register mid-session, restart your agent\n> session before the `testatlas` tools appear. To confirm it's actually being used (and not\n> silently ignored), run the checks in\n> [docs/troubleshooting.md](https://github.com/Karzone/TestAtlas/blob/main/docs/troubleshooting.md#the-agent-doesnt-seem-to-use-testatlas).\n\n**Tools exposed:**\n\n- `resolve_step` — resolve a Gherkin phrase to the existing step definition(s) that would bind it (regex/cucumber, keyword-agnostic). `exact` / `ambiguous` / `none` (+ near-match suggestions ranked by shared terms). Reuse-first authoring: don't write a step that already exists.\n- `step_catalog` — the reusable step vocabulary with extracted placeholders and allowed values (cucumber `{type}`, regex `(a|b)` enums). Compose scenarios from what exists.\n- `impact` — blast radius of a change: the scenarios affected by a given class, method, step definition, or endpoint.\n- `search_steps` — full-text search over step definitions (expression text + method + class name).\n- `search_scenarios` — full-text search over scenarios (feature + scenario name + step text + tags).\n- `get_scenario` — full detail of scenario(s) by name: feature, tags, kind, example-row count, and the ordered steps.\n- `get_step_definition` — full detail of step definition(s) by expression: keyword, params, C# class/method/signature, and the scenarios that use it.\n- `list_tags` — the tag taxonomy with per-tag scenario counts, most-used first — tag new scenarios consistently.\n- `list_endpoints` — the HTTP endpoints the suite calls, each with verb, route, and scenario blast radius (highest-reach first).\n- `project_dependencies` — the implied project dependency graph (depends-on / depended-on-by), e.g. *\"what depends on the Party project?\"*.\n- `stats` — summary counts: projects, classes, methods, class-kind breakdown, endpoints, and edge tallies.\n\nRetrieval runs locally against the SQLite file — deterministic, offline, and a few hundred tokens\nper answer. Protocol details in [`specs/codemap-mcp.md`](https://github.com/Karzone/TestAtlas/blob/main/specs/codemap-mcp.md); registration from\nsource and every failure mode in [docs/troubleshooting.md](https://github.com/Karzone/TestAtlas/blob/main/docs/troubleshooting.md).\n\n---\n\n## 📖 Commands\n\n| Command | What it does |\n| --- | --- |\n| `index []` | Analyse a `.sln`/`.csproj` and write the map (default `./codemap.db`). |\n| `stats []` | Entity counts per project, unbound/ambiguous steps, diagnostics. |\n| `search [] ` | FTS5 full-text search over step definitions and scenarios. |\n| `impact [] --class\\|--method\\|--step\\|--endpoint ` | Blast radius: scenarios affected by changing an entity. |\n| `report []` | Write a self-contained HTML drill-down of the map. |\n| `map []` | Write a self-contained project dependency graph (HTML). |\n| `validate []` | Check a file is a supported TestAtlas map. |\n\n

Options & exit codes

\n\n
\n\n**`index`** `--output ` · `--config ` · `--include ` (repeatable) · `--exclude ` (repeatable) · `--verbose` · `--quiet`\n\n**`search`** `--steps` (step definitions only) · `--scenarios` (scenarios only)\n\n**Exit codes** `0` ok · `1` completed with warnings · `2` fatal · `3` bad arguments\n\nRun `testatlas --help` for the full usage text.\n\n

\n\n

A typical session

\n\n
\n\n```bash\n# Index the solution (no build needed — the pass is syntax-only)\ntestatlas index YourSolution.sln --output atlas.db\n\n# Before writing a new step — does one already exist?\ntestatlas search atlas.db \"add a product to the cart\" --steps\n\n# About to change a shared client — what will it hit?\ntestatlas impact atlas.db --class ProductsApiClient\n\n# Share human-readable snapshots\ntestatlas report atlas.db --html atlas.html\ntestatlas map atlas.db --html atlas-map.html\n```\n\n

\n\n

About the bundled sample (SampleShop)

\n\n
\n\n[`samples/SampleShop`](https://github.com/Karzone/TestAtlas/blob/main/samples/SampleShop) is a self-contained **8-project** solution mixing API\ntests and UI tests, so the map has plenty of connected nodes — real `HttpClient` API clients, real\nSelenium `IWebDriver` page objects, and Reqnroll suites driving both:\n\n```text\n ┌─▶ Api.Catalog ──┐\nTests.Api ────────────┼─▶ Api.Cart ──┤\nTests.E2E ──┬─────────┴─▶ Api.Identity ──┼─▶ Core (ApiClientBase : HttpClient)\n └─▶ Ui.Pages ─────────────────┘ (PageBase : IWebDriver)\nTests.Ui ────▶ Ui.Pages ──────────────────▶ Core\n```\n\nReproduce the committed sample outputs yourself:\n\n```bash\ntestatlas index samples/SampleShop/SampleShop.sln --output sampleshop.db\ntestatlas report sampleshop.db --html docs/sample-report.html\ntestatlas map sampleshop.db --html docs/sample-map.html\n```\n\n

\n\n---\n\n## 🔄 Keeping the map fresh\n\nAnswers are deterministic — but only as fresh as the map, so re-index on *change*, not on a timer.\nA full re-index is a single static pass (**seconds**), and its cost scales with solution size, not\nwith how much changed:\n\n- **Locally** — `python scripts/check-map-age.py` tells you when your map drifted; a\n version-controlled `post-merge` git hook can warn automatically after every pull.\n- **In CI (team model)** — re-index on every merge to main and publish the `.db` to a shared feed\n (never commit it — it's a build artifact). Then teammates and agents only need **`TestAtlas.Mcp`**\n locally: download the shared map and point `TESTATLAS_DB` at it — no local `TestAtlas.Cli` or\n indexing required. (Index locally only to include your own *uncommitted* branch work.)\n\nDetails — the staleness checker, the git hook, and copy-paste CI recipes (GitHub Actions +\nAzure DevOps with a Universal feed) — in **[docs/keeping-the-map-fresh.md](https://github.com/Karzone/TestAtlas/blob/main/docs/keeping-the-map-fresh.md)**.\n\n---\n\n## 🧹 Uninstall\n\nTwo separate things — remove them in this order, so the editor isn't launching a server whose binary just vanished:\n\n1. **Remove the MCP registration** — delete the `testatlas` block from your `.mcp.json`\n (`\\.mcp.json` or `%USERPROFILE%\\.mcp.json`), then restart Visual Studio / VS Code.\n (Or just toggle it off in the agent's tools/wrench picker to keep it for later.)\n2. **Uninstall the tools** — they're .NET global tools, not editor add-ins:\n ```bash\n dotnet tool uninstall --global TestAtlas.Mcp\n dotnet tool uninstall --global TestAtlas.Cli\n dotnet tool list --global # confirm they're gone\n ```\n3. **(Optional)** delete the `codemap.db` map file — it's just data, nothing else references it.\n\n---\n\n## 🎯 Design tenets\n\n- **Zero config** — a useful map on an unseen solution, no config file required.\n- **Solution agnostic** — heuristic, overridable detection; no company-specific assumptions.\n- **Deterministic & offline** — same input ⇒ byte-equivalent logical content; no network, no AI.\n- **Graceful degradation** — solutions without Gherkin still yield a useful map.\n- **Public schema as contract** — a versioned SQLite schema, so downstream consumers keep working\n even if a third party swaps in their own indexer.\n\n_{The project folders use the indexer's working name (**CodeMap**); the shipped tools and\npackages are **TestAtlas**. Full specs: [`specs/codemap-indexer.md`](https://github.com/Karzone/TestAtlas/blob/main/specs/codemap-indexer.md) ·\n[`specs/codemap-mcp.md`](https://github.com/Karzone/TestAtlas/blob/main/specs/codemap-mcp.md). Repo layout: [CONTRIBUTING.md](https://github.com/Karzone/TestAtlas/blob/main/CONTRIBUTING.md#project-layout).}\n\n---\n\n## 🗺 Roadmap\n\n- [x] **Indexer CLI** — C# indexer + documented, versioned SQLite schema\n- [x] **HTML visualization** — self-contained report + project map generated from the db\n- [x] **MCP server** — `testatlas-mcp` exposes the map to AI agents over stdio JSON-RPC (11 tools)\n- [ ] **Second-language indexer** — same schema, contract-tested\n\n**Deliberately not planned** (see [design tenets](#-design-tenets)): LLM-assisted analysis inside\nthe indexer, network calls at index/query time, running or generating tests, and semantic\n(compilation-based) analysis that would require a restored build. Releases and per-version notes\nlive on the [releases page](https://github.com/Karzone/TestAtlas/releases); current distribution\nchannels in [docs/DISTRIBUTION.md](https://github.com/Karzone/TestAtlas/blob/main/docs/DISTRIBUTION.md).\n\n---\n\n## 📄 License\n\n[MIT](https://github.com/Karzone/TestAtlas/blob/main/LICENSE) © 2026 Karthik Kalaiyarasu\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_111":112,"_113":114,"_115":116,"_117":118,"_119":-5,"_120":121},"requiredSecrets",[],"tags",[96,97,98,99,100,101,102,103,104,105,106,107,108,109,110],"assets",[],"stats",{"_94":81,"_95":81},"ratingAvg","reviewCount","ai-agents","bdd","code-analysis","csharp","dependency-graph","developer-tools","dotnet","gherkin","reqnroll","roslyn","software-testing","specflow","sqlite","static-analysis","test-automation","topics",[96,97,98,99,100,101,102,103,127,128,104,105,106,107,108,109,110],"license","MIT","language","C#","registryName","io.github.Karzone/TestAtlas.Mcp","homepage","packages",[122],{"_123":124,"_125":126,"_71":72},"registryType","nuget","identifier","TestAtlas.Mcp","mcp","model-context-protocol","ENV",{"_131":132,"_133":134,"_135":136},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

\n \n TestAtlas\n

\n $\"\"$ \n TestAtlas\n