Atlas 0.4.1: exact path explorer and complete infrastructure intelligence

README.md

@@ -174,8 +174,9 @@ The NestJS adapter currently detects:
 - SQL migrations, columns, indexes, keys, constraints, and foreign-key relationships;
 - ClickHouse tables, materialized views, engines, partition/order keys, and TTL rules;
 - NestJS cron/interval/timeout jobs, repeatable queue jobs, and Kubernetes CronJobs;
-- GitHub Actions and GitLab CI workflows, jobs, dependencies, images, and deploy commands;
-- Dockerfiles, Compose services, and Kubernetes workloads, containers, probes, services, ingress, ConfigMaps, and Secret names;
+- GitHub Actions and GitLab CI workflows, reusable workflows, actions, jobs, dependencies, images, and deploy commands;
+- Dockerfiles and Compose services, health checks, dependencies, networks, volumes, configs, and Secret names;
+- Kubernetes workloads, init containers, probes, services, ingress, autoscaling, volumes, ConfigMaps, Secret names, Kustomize overlays, Helm metadata, and Argo CD applications;
 - environment variable contracts and safe examples, while redacting secret-like values;
 - external HTTP API hosts;
 - unit test relationships;
@@ -254,6 +255,19 @@ request and asynchronous flows, complete data catalog and focused table ERD,
 migrations, scheduled jobs, source files, risks, deployment, runtime topology,
 environment comparison, and configuration contracts.
 
+The **System Map** combines business domains, asynchronous runtime, data and external
+systems with a visible Delivery & Runtime band. Its grouped domain anchors keep every
+detected aggregate arrow in the scene, and hovering a component isolates its direct
+system connections. Build/deploy, structure, events, data and external calls use
+different line grammar instead of one generic edge style.
+
+**Path A -> B** answers a direct architecture question without opening a giant
+neighbourhood graph. Select any starting element, select a target, and Atlas renders
+only the exact detected chain between them. Directed mode follows the real execution
+or dependency direction; Any connection can cross an incoming relationship while
+keeping every arrowhead truthful. The Overview also ranks architecture hubs by their
+actual graph degree so highly influential elements are visible immediately.
+
 Operations are deliberately separated. **Deployment** follows CI/CD jobs, Docker
 build stages, images, and releases. **Runtime** follows ingress, services, workloads,
 containers, ConfigMaps, and Secret names. Both switch independently between
@@ -307,6 +321,7 @@ The server exposes these tools:
 - `atlas_get_node`
 - `atlas_get_dependencies`
 - `atlas_get_dependents`
+- `atlas_find_path`
 - `atlas_find_routes`
 - `atlas_find_flow`
 - `atlas_find_async_flows`
@@ -348,11 +363,11 @@ npm run typecheck
 ```
 
 The tests scan a representative NestJS fixture, validate route-to-database,
-publisher-to-consumer, DI-token, CQRS, runtime, migration, schedule, and delivery flows, exercise all 18 MCP
+publisher-to-consumer, DI-token, CQRS, runtime, migration, schedule, path, and delivery flows, exercise all 19 MCP
 tools, verify architecture and deployment risks, and confirm that real secret values
 never enter generated artifacts. The performance suite generates 1,000 TypeScript
 files, 100 controllers, 300 services, and 1,000 routes; it also checks warm-scan
-reuse, indexed graph queries, viewport culling, and bounded animation.
+reuse, indexed graph and path queries, viewport culling, and bounded animation.
 
 The detailed MVP requirements and their automated evidence are listed in
 [`docs/PRD-COMPLIANCE.md`](docs/PRD-COMPLIANCE.md).

docs/CLAUDE-DESIGN-BRIEF.md

@@ -66,6 +66,14 @@ question, show direction clearly, and avoid an undifferentiated force-directed g
    - Secret-like variables show a hidden-value state, never a fake value.
    - Show where each variable is consumed and which runtime object provides it.
 
+9. **Path A -> B**
+   - A persistent header command starts from the currently selected element.
+   - The target is chosen through global search or by clicking a map card.
+   - Render only the exact chain in numbered left-to-right columns, without unrelated neighbours.
+   - Directed mode follows outgoing links. Any connection may traverse incoming links but preserves real arrow direction.
+   - Explain no-path results and let the user replace either endpoint immediately.
+   - Keep path search indexed and bounded for large project graphs.
+
 ## Shared interaction rules
 
 - Desktop reference viewport: 1440 x 900. Also provide usable 1280 x 720 and mobile layouts.

docs/PRD-COMPLIANCE.md

@@ -22,11 +22,13 @@ verification or `npm run test:performance` for the scale target alone.
 | Supported HTTP client calls and unknown env-configured APIs | Complete | fixture integration test |
 | Package dependencies, libraries, scripts, version, and package manager metadata | Complete | fixture integration test |
 | Static local viewer with modes, filters, search, details, flows, source, dependencies, and dependents | Complete | generated viewer syntax/assertions and browser verification |
-| Eighteen read-only MCP graph tools, including data, schedule, delivery, and async queries | Complete | live MCP subprocess integration test |
+| Nineteen read-only MCP graph tools, including exact A-to-B path, data, schedule, delivery, and async queries | Complete | live MCP subprocess integration test |
 | Markdown report and architecture/runtime risk rules | Complete | `tests/risks.test.mjs`, report integration test |
 | SQL migrations, full table profiles, and ClickHouse topology | Complete | SQL fixtures and MCP integration test |
 | Scheduled jobs and deterministic async overview | Complete | schedule fixtures and viewer assertions |
 | CI/CD, Docker, Compose, and Kubernetes topology | Complete | delivery fixtures and viewer assertions |
+| Reusable workflows, Compose runtime resources, Helm, Kustomize, autoscaling, and Argo CD topology | Complete | infrastructure fixtures and graph assertions |
+| Exact path between arbitrary architecture elements | Complete | graph, MCP, viewer interaction, and performance tests |
 | Separate development, staging, and production runtime scenes | Complete | generated viewer integration test |
 | Unsupported projects produce a basic graph and warning without crashing | Complete | unsupported-project integration test |
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dthreads/atlas",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Architecture intelligence for NestJS codebases.",
   "keywords": [
     "nestjs",