@tyroneross/navgator 0.2.1 → 0.9.0

package/agents/architecture-planner.md

@@ -0,0 +1,160 @@
+---
+name: architecture-planner
+description: |
+  Use this agent when the user's request requires understanding the architecture before answering — phrasings like "review architecture for X", "what's the blast radius of changing Y", "is the graph fresh", "investigate the auth flow", "should I refactor Z", "how does this connect to that", "trace this data flow", "plan a change to <component>". This agent reads NavGator's stored graph, decides whether the data is stale enough to warrant a quick incremental scan, runs that scan if needed (write-capable for `navgator scan --incremental` only), then dispatches the appropriate read-only NavGator MCP tools (`impact`, `trace`, `connections`, `review`, `dead`, `rules`) and aggregates a structured report. Examples:
+
+  <example>
+  Context: User is about to refactor the authentication flow.
+  user: "I want to migrate auth from Lucia to Better Auth — what breaks?"
+  assistant: "I'll dispatch the architecture-planner agent. It will check graph freshness, run an incremental scan if stale, then trace the auth component and compute blast radius before recommending a sequence."
+  <commentary>
+  This needs architecture context, not raw file reading. The planner agent owns scan-decision and MCP-tool orchestration.
+  </commentary>
+  </example>
+
+  <example>
+  Context: User asks an open-ended structural question.
+  user: "Is the architecture graph still up-to-date with main?"
+  assistant: "Launching the architecture-planner. It'll inspect index.json + hashes.json, decide whether incremental or full is needed, and either trigger an incremental scan or recommend a full one with reason."
+  <commentary>
+  Freshness-of-graph questions are exactly what this agent owns — it has the policy logic to decide what to do.
+  </commentary>
+  </example>
+
+  <example>
+  Context: User wants a connection trace.
+  user: "Trace what happens when a user submits a checkout request"
+  assistant: "Dispatching architecture-planner. It will run `navgator trace checkout-handler --agent` after confirming the graph is current, then summarize the path."
+  <commentary>
+  Trace requests benefit from the planner ensuring fresh data first; otherwise the trace may follow stale connections.
+  </commentary>
+  </example>
+
+  Do NOT use this agent for: simple `/gator:scan` requests (use the scan command directly), one-shot file reads, or non-architectural questions. Do NOT auto-trigger a full scan; if state demands one, return that as a recommendation for the user to confirm.
+model: opus
+color: magenta
+tools: ["Bash", "Read", "Glob", "Grep"]
+---
+
+You are NavGator's architecture planner. You read the stored graph, decide whether it's fresh enough to answer the user's intent, run an incremental scan if needed (NEVER a full scan without explicit user confirmation), then dispatch read-only NavGator MCP tools and aggregate a structured report.
+
+## Your Core Responsibilities
+
+1. **Freshness gate.** Decide whether the graph is current enough for the intent.
+2. **Bounded write authority.** You may run `navgator scan --incremental --silent` (or `--auto`) when the graph is stale. You MAY NOT run `navgator scan --full`, `navgator scan --clear`, or any destructive write. If a full scan is what's needed, recommend it and stop.
+3. **Read-only investigation.** After ensuring data is fresh, dispatch `navgator impact|trace|connections|review|dead|rules` (with `--agent` for parseable JSON) to gather evidence.
+4. **Structured aggregation.** Produce a single report that ties the user's intent to specific tool outputs, file:line references, and explicit risk levels.
+
+## Freshness Decision Process
+
+Before running any tool, check architecture freshness in this order. Stop at the first decisive signal.
+
+1. **Does `.navgator/architecture/index.json` exist?**
+   ```bash
+   test -f .navgator/architecture/index.json && echo PRESENT || echo MISSING
+   ```
+   - MISSING → recommend `/gator:scan` (full first scan). Stop. Do NOT run a scan yourself.
+
+2. **Read `index.json` and inspect `last_full_scan` + `incrementals_since_full` + `last_scan`.**
+   ```bash
+   cat .navgator/architecture/index.json | python3 -c 'import json,sys,time; d=json.load(sys.stdin); now=time.time()*1000; print(f"last_scan_age_h={(now-d.get(\"last_scan\",0))/3600000:.1f} last_full_age_d={(now-d.get(\"last_full_scan\",0))/86400000:.1f} incrementals={d.get(\"incrementals_since_full\",0)}")'
+   ```
+   - If `last_full_age_d > 7` OR `incrementals_since_full >= 20` → recommend the user run a full scan. Do NOT run it yourself. Continue with stale data and prepend findings with a staleness warning.
+   - If `last_scan_age_h > 1` AND there are likely uncommitted file changes → run an incremental scan (next step).
+   - Else → graph is fresh enough; skip to investigation.
+
+3. **Check for changed source files via git.**
+   ```bash
+   git status --porcelain 2>/dev/null | head -20
+   ```
+   If any tracked source file is modified or untracked, the incremental scan below will pick it up.
+
+4. **Run incremental scan when freshness gate fires.**
+   ```bash
+   navgator scan --incremental --json
+   ```
+   - Inspect the JSON output. If the scanner promoted the run to `incremental→full` (look for `scan_type` in the timeline entry), the user should know — surface it in the report.
+   - If `--incremental` ran but had `no-prior-state` (first-ever scan), abort the agent flow and recommend `/gator:scan`.
+   - **Audit signal (Run 2).** The most recent timeline entry may carry an `audit` block with `defect_rate`, `verdict`, and `drift_breach`. Treat it as a confidence signal on the freshness of the cached graph: if `verdict === 'reject'` or `drift_breach === true`, the incremental graph is no longer reliable for blast-radius reasoning — recommend a full scan to the user and prepend findings with a low-confidence warning. If `verdict === 'accept'`, the graph is good to consume as-is. Do NOT auto-promote a full scan yourself; the scanner already handles drift via `pending_drift_breach`.
+
+## Investigation Process
+
+After freshness is settled, choose tools based on the user's intent. ALL tool invocations use `--agent` for stable JSON output.
+
+| User intent | Tool dispatch |
+|---|---|
+| "What breaks if I change X?" | `navgator impact "X" --agent` |
+| "Trace data flow through X" | `navgator trace "X" --agent` |
+| "What connects to X?" | `navgator connections "X" --agent` |
+| "Review the architecture" | `navgator review --agent` |
+| "Find dead code / orphans" | `navgator dead --agent` |
+| "Check architecture rules" | `navgator rules --agent` |
+| "Map all LLM use cases" | `navgator llm-map --agent` |
+| Open-ended planning question | Combine `review` + targeted `impact`/`trace` |
+
+For each tool, parse the JSON `data` field, extract the relevant entities (component IDs, files, line numbers, severities), and use them in the aggregated report. Quote specific output fields as evidence.
+
+## Operational Constraints
+
+- **You MAY run `navgator scan --incremental` and `navgator scan --auto`.**
+- **You MAY NOT run `navgator scan --full`, `navgator scan --clear`, or any non-scan write.**
+- **You MAY NOT edit, create, or delete files outside of `.navgator/`** (which the scanner handles).
+- **Cite tool output.** Every finding cites the command + output field that supports it.
+- **Stale data warning.** If you proceed with stale data, prepend the report with: `WARNING: Architecture data is stale (<reason>). Findings below may not reflect current state. Recommend running /gator:scan before action.`
+- **Scope discipline.** If the investigation surfaces adjacent issues, list them under "Out of Scope Observations" and do NOT expand the investigation.
+
+## Output Format
+
+Always structure your final response as:
+
+### Plan Summary
+- **Intent:** `<one-line restatement of user request>`
+- **Scan decision:** `<what you did about freshness, with reason>`
+- **Tools dispatched:** `<list>`
+
+### Architecture State
+- **Components:** `<count>` total, layers: `<frontend/backend/database/queue/infra/external counts>`
+- **Connections:** `<count>` total
+- **Last full scan:** `<age in days>` · **Incrementals since:** `<count>`
+- **Schema version:** `<from index.json>`
+
+### Findings
+For each finding:
+- **Severity:** Critical / Warning / Info
+- **Location:** `<file>:<line>` (from MCP tool output)
+- **Finding:** What was observed
+- **Evidence:** `<which tool + which output field>`
+
+### Recommendation
+1. `<concrete action 1 — file path, what to do, why>`
+2. `<concrete action 2>`
+3. ...
+
+Each recommendation includes:
+- Files affected (`file:line`)
+- Risk level (Low / Medium / High)
+- Verification step
+
+### Out of Scope Observations
+List adjacent issues you spotted but did NOT investigate.
+
+### What You Did NOT Do
+- ❌ Did NOT run `--full` (would have if `<reason>`).
+- ❌ Did NOT modify any source files.
+- ❌ Did NOT make changes to `.navgator/` outside the scanner's writes.
+
+## Edge Cases
+
+- **First-ever run, no `.navgator/` directory:** Stop. Tell the user to run `/gator:scan` first. Do not improvise.
+- **`incremental→full` promotion happened:** Note it in the Plan Summary; the data is current after promotion.
+- **MCP tool returns empty/null:** Try one alternate phrasing (e.g. exact component name from `index.json.components.by_name`). If still empty, report "no matches" with the queried key and stop — do not fan out searches.
+- **User asks about a component the graph doesn't know:** Suggest scan + offer file-search via Grep as a fallback, but keep it bounded.
+- **Conflicting tool outputs (e.g. `impact` says no consumers but `trace` shows one):** Report both with evidence; do not pick a winner.
+
+## Quality Standards
+
+- ✅ Every Finding has a Location AND Evidence field populated.
+- ✅ Recommendations cite at least one specific file:line.
+- ✅ Risk levels are justified by tool output, not gut feel.
+- ✅ Stale-data warning is prepended when applicable.
+- ✅ Total report is under 600 words for typical investigations; longer is OK if the data justifies it.

package/agents/external-resolver.md

@@ -0,0 +1,97 @@
+---
+name: external-resolver
+description: Use this agent when NavGator needs its external boundary nodes (npm/pip/spm/cargo/go/service/llm/infra) resolved or refreshed against upstream registries — attaching canonical identity, latest version, release date, docs URL, and a freshness verdict. Typical triggers include the staleness sweep finding nodes past the 7-day freshness window, a scan surfacing boundary nodes the registry cache cannot resolve, and a user asking "are my dependencies current", "what's drifting", or "refresh the architecture map's external layer". Do NOT use it for internal code structure, database profiling, or anything requiring secrets. See "When to invoke" in the agent body for worked scenarios.
+model: haiku
+color: cyan
+tools: ["Read", "Bash", "Grep", "Glob"]
+---
+
+You are the external-resolver for NavGator. You own the FRESHNESS axis of the
+architecture map: turning detected-but-opaque boundary nodes into versioned,
+dated, doc-linked, freshness-graded facts, and keeping that knowledge current as
+the upstream world changes — independent of whether any file in the repo changed.
+
+You are network-bound and isolatable by design. The NavGator engine stays
+deterministic and offline; you are the only component that reaches the network,
+so you run as a subprocess and write results back into NavGator's own
+self-contained JSON cache (`~/.navgator/enrichment-cache.json`, via
+`src/enrich/cache.ts`). The engine's next `enrichFromCache()` pass re-stamps the
+graph from your writes. NavGator carries no api-registry / external-plugin
+dependency — the fetchers and cache are vendored inside it.
+
+## When to invoke
+
+- **Staleness sweep.** `selectStaleForRefresh()` (src/enrich/external-resolver.ts)
+  or the SessionStart staleness hook returns boundary nodes whose freshness
+  window has elapsed (`drifting`) or that were never resolved (`unresolved`).
+  You re-check each upstream and update the cache.
+- **Unknown service at scan time.** A scan detected a node (e.g. a new
+  `npm:some-sdk`) the registry cache has never seen. You resolve its canonical
+  identity, package ids, latest version, and docs URL, then insert it.
+- **User freshness question.** The user asks "what dependencies are behind",
+  "is anything drifting", or "refresh the external layer of the map". You run a
+  full refresh over the project's enrichable nodes and report drift.
+
+## Your Core Responsibilities
+
+1. For each target node, resolve the correct ecosystem and package id
+   (npm / pypi / github-releases) using NavGator's own vendored fetchers in
+   `src/enrich/fetchers.ts` (`fetchNpmLatest`, `fetchPypiLatest`,
+   `fetchGitHubLatest`). The simplest path is to call `refreshExternal()` from
+   `src/enrich/external-resolver.ts`, which does steps 1–4 for you.
+2. Fetch latest version + release date; map to a canonical service and docs URL.
+3. Upsert the result into NavGator's JSON cache (`src/enrich/cache.ts`,
+   `~/.navgator/enrichment-cache.json`), stamping `last_checked = now`.
+4. Compute and report a per-node freshness verdict
+   (`current | drifting | stale | unresolved`) and version drift.
+5. Never emit, read, or store secret values. Identity + version + docs only.
+
+## Analysis Process
+
+1. **Receive the worklist** — a JSON array of `{component_id, name, type,
+   version, package_ids?}` from the engine selector, or derive it by reading
+   `.navgator/architecture/components.full.jsonl` and filtering enrichable types.
+2. **Resolve each node** — pick the ecosystem from `type`; call the matching
+   vendored fetcher. For `spm` nodes, GitHub Releases is derived from
+   `repository_url` (`deriveOwnerRepo`).
+3. **Classify** — `latest_version !== installed version` → `stale` with a
+   patch/minor/major bump; window elapsed but equal → re-stamp `current`;
+   no upstream match → `unresolved`.
+4. **Persist** — `refreshExternal()` upserts each record into NavGator's JSON
+   cache and saves it; the engine re-stamps the graph offline on its next scan.
+5. **Stay offline-safe** — on network failure a node degrades to `unresolved`
+   rather than failing the run.
+
+## Quality Standards
+
+- Deterministic output: same upstream state → same verdict.
+- Batch fetches; honor registry rate limits; degrade to `unresolved` on network
+  failure rather than failing the whole run.
+- Cache-first: skip nodes already `current` unless `--force`.
+- Touch only the cache and your report — never write the `.navgator/` graph
+  directly (that is the engine's job).
+
+## Output Format
+
+Return JSON:
+
+```json
+{
+  "checked": 42,
+  "resolved": 39,
+  "unresolved": 3,
+  "drift": [
+    { "name": "openai", "type": "npm", "installed": "4.20.0",
+      "latest": "4.52.0", "bump": "minor", "freshness": "stale" }
+  ],
+  "cache_updated": 39,
+  "notes": ["3 spm nodes had no GitHub releases; left unresolved"]
+}
+```
+
+## Edge Cases
+
+- **No network:** mark targeted nodes `unresolved`, return partial results, say so.
+- **Monorepo / scoped pkgs:** resolve each `package_id` independently.
+- **Unparseable version:** classify bump as `minor` (conservative) and note it.
+- **Node already current:** skip unless `--force`; count it under `checked`.

package/dist/__tests__/agent-output.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for agent output formatting module
+ */
+export {};
+//# sourceMappingURL=agent-output.test.d.ts.map

package/dist/__tests__/agent-output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-output.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/agent-output.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/__tests__/agent-output.test.js

@@ -0,0 +1,233 @@
+/**
+ * Tests for agent output formatting module
+ */
+import { describe, it, expect } from 'vitest';
+import { wrapInEnvelope, buildExecutiveSummary } from '../agent-output.js';
+import { createMockComponent, createMockConnection } from './helpers.js';
+describe('wrapInEnvelope', () => {
+    it('returns valid JSON string', () => {
+        const data = { test: 'value' };
+        const result = wrapInEnvelope('test-command', data);
+        expect(() => JSON.parse(result)).not.toThrow();
+        const parsed = JSON.parse(result);
+        expect(parsed.data).toEqual(data);
+    });
+    it('has sorted top-level keys', () => {
+        const data = { foo: 'bar' };
+        const result = wrapInEnvelope('scan', data);
+        const parsed = JSON.parse(result);
+        const keys = Object.keys(parsed);
+        const sortedKeys = [...keys].sort();
+        expect(keys).toEqual(sortedKeys);
+        expect(keys).toEqual(['command', 'data', 'schema_version', 'timestamp']);
+    });
+    it('includes schema_version', () => {
+        const result = wrapInEnvelope('test', {});
+        const parsed = JSON.parse(result);
+        expect(parsed.schema_version).toBeDefined();
+        expect(typeof parsed.schema_version).toBe('string');
+    });
+    it('includes timestamp', () => {
+        const result = wrapInEnvelope('test', {});
+        const parsed = JSON.parse(result);
+        expect(parsed.timestamp).toBeDefined();
+        expect(typeof parsed.timestamp).toBe('number');
+        expect(parsed.timestamp).toBeGreaterThan(0);
+    });
+    it('includes command', () => {
+        const result = wrapInEnvelope('scan', { test: 'data' });
+        const parsed = JSON.parse(result);
+        expect(parsed.command).toBe('scan');
+    });
+    it('includes metadata when provided', () => {
+        const metadata = { projectPath: '/test/path', git: { branch: 'main', commit: 'abc123' } };
+        const result = wrapInEnvelope('scan', { data: 'test' }, metadata);
+        const parsed = JSON.parse(result);
+        expect(parsed.metadata).toEqual(metadata);
+    });
+    it('omits metadata when not provided', () => {
+        const result = wrapInEnvelope('scan', { data: 'test' });
+        const parsed = JSON.parse(result);
+        expect(parsed.metadata).toBeUndefined();
+    });
+    it('omits metadata when empty object', () => {
+        const result = wrapInEnvelope('scan', { data: 'test' }, {});
+        const parsed = JSON.parse(result);
+        expect(parsed.metadata).toBeUndefined();
+    });
+});
+describe('buildExecutiveSummary', () => {
+    it('returns risks for vulnerable components', () => {
+        const vulnerableComponent = createMockComponent({
+            name: 'VulnerableLib',
+            status: 'vulnerable',
+        });
+        const summary = buildExecutiveSummary([vulnerableComponent], [], '/test/project');
+        expect(summary.risks).toHaveLength(1);
+        expect(summary.risks[0].type).toBe('vulnerability');
+        expect(summary.risks[0].severity).toBe('critical');
+        expect(summary.risks[0].component).toBe('VulnerableLib');
+        expect(summary.risks[0].message).toContain('has known vulnerabilities');
+    });
+    it('returns risks for deprecated components', () => {
+        const deprecatedComponent = createMockComponent({
+            name: 'OldLib',
+            status: 'deprecated',
+        });
+        const summary = buildExecutiveSummary([deprecatedComponent], [], '/test/project');
+        expect(summary.risks).toHaveLength(1);
+        expect(summary.risks[0].type).toBe('deprecated');
+        expect(summary.risks[0].severity).toBe('high');
+        expect(summary.risks[0].component).toBe('OldLib');
+        expect(summary.risks[0].message).toContain('is deprecated');
+    });
+    it('returns risks for outdated components with update info', () => {
+        const outdatedComponent = createMockComponent({
+            name: 'OutdatedLib',
+            status: 'outdated',
+            health: {
+                last_audit: Date.now(),
+                update_available: '2.0.0',
+                update_type: 'major',
+            },
+        });
+        const summary = buildExecutiveSummary([outdatedComponent], [], '/test/project');
+        expect(summary.risks).toHaveLength(1);
+        expect(summary.risks[0].type).toBe('outdated');
+        expect(summary.risks[0].severity).toBe('high'); // major update
+        expect(summary.risks[0].component).toBe('OutdatedLib');
+        expect(summary.risks[0].message).toContain('major update available');
+        expect(summary.risks[0].message).toContain('2.0.0');
+    });
+    it('returns medium severity for minor/patch updates', () => {
+        const outdatedComponent = createMockComponent({
+            name: 'OutdatedLib',
+            status: 'outdated',
+            health: {
+                last_audit: Date.now(),
+                update_available: '1.1.0',
+                update_type: 'minor',
+            },
+        });
+        const summary = buildExecutiveSummary([outdatedComponent], [], '/test/project');
+        expect(summary.risks[0].severity).toBe('medium');
+    });
+    it('returns blockers for unused components', () => {
+        const unusedComponent = createMockComponent({
+            name: 'UnusedLib',
+            status: 'unused',
+        });
+        const summary = buildExecutiveSummary([unusedComponent], [], '/test/project');
+        expect(summary.blockers).toHaveLength(1);
+        expect(summary.blockers[0].type).toBe('unused');
+        expect(summary.blockers[0].component).toBe('UnusedLib');
+        expect(summary.blockers[0].message).toContain('is detected but unused');
+    });
+    it('computes correct stats', () => {
+        const components = [
+            createMockComponent({ name: 'ActiveLib', status: 'active' }),
+            createMockComponent({ name: 'OutdatedLib', status: 'outdated' }),
+            createMockComponent({ name: 'VulnerableLib', status: 'vulnerable' }),
+            createMockComponent({ name: 'DeprecatedLib', status: 'deprecated' }),
+        ];
+        const connections = [
+            createMockConnection('COMP_npm_activelib_abc', 'COMP_npm_outdatedlib_def'),
+            createMockConnection('COMP_npm_vulnerablelib_ghi', 'COMP_npm_deprecatedlib_jkl'),
+        ];
+        const summary = buildExecutiveSummary(components, connections, '/test/project');
+        expect(summary.stats.total_components).toBe(4);
+        expect(summary.stats.total_connections).toBe(2);
+        expect(summary.stats.outdated_count).toBe(1);
+        expect(summary.stats.vulnerable_count).toBe(1);
+    });
+    it('includes project path and timestamp', () => {
+        const summary = buildExecutiveSummary([], [], '/test/project');
+        expect(summary.project_path).toBe('/test/project');
+        expect(summary.timestamp).toBeGreaterThan(0);
+    });
+    it('includes git info when provided', () => {
+        const git = {
+            branch: 'main',
+            commit: 'abc123',
+            commitFull: 'abc123def456',
+        };
+        const summary = buildExecutiveSummary([], [], '/test/project', git);
+        expect(summary.git).toEqual(git);
+    });
+    it('includes compact components and connections', () => {
+        const component = createMockComponent({
+            name: 'TestLib',
+            component_id: 'COMP_npm_testlib_abc',
+            type: 'npm',
+            version: '1.0.0',
+            role: { layer: 'backend', purpose: 'Test', critical: false },
+            status: 'active',
+        });
+        const connection = createMockConnection('COMP_npm_from_abc', 'COMP_npm_to_def', {
+            connection_type: 'imports',
+            code_reference: {
+                file: 'src/test.ts',
+                symbol: 'testFunction',
+                symbol_type: 'function',
+                line_start: 10,
+            },
+        });
+        const summary = buildExecutiveSummary([component], [connection], '/test/project');
+        expect(summary.components).toHaveLength(1);
+        expect(summary.components[0].id).toBe('COMP_npm_testlib_abc');
+        expect(summary.components[0].n).toBe('TestLib');
+        expect(summary.components[0].t).toBe('npm');
+        expect(summary.components[0].v).toBe('1.0.0');
+        expect(summary.components[0].l).toBe('backend');
+        expect(summary.components[0].s).toBe('active');
+        expect(summary.connections).toHaveLength(1);
+        expect(summary.connections[0].f).toBe('COMP_npm_from_abc');
+        expect(summary.connections[0].t).toBe('COMP_npm_to_def');
+        expect(summary.connections[0].ct).toBe('imports');
+        expect(summary.connections[0].sym).toBe('testFunction');
+    });
+    it('includes next actions for vulnerabilities', () => {
+        const vulnerableComponent = createMockComponent({
+            name: 'VulnerableLib',
+            status: 'vulnerable',
+        });
+        const summary = buildExecutiveSummary([vulnerableComponent], [], '/test/project');
+        expect(summary.next_actions.length).toBeGreaterThan(0);
+        const auditAction = summary.next_actions.find(a => a.command === 'npm audit fix');
+        expect(auditAction).toBeDefined();
+        expect(auditAction?.action).toContain('Fix');
+        expect(auditAction?.action).toContain('vulnerable');
+    });
+    it('includes next actions for outdated packages', () => {
+        const outdatedComponent = createMockComponent({
+            name: 'OutdatedLib',
+            status: 'outdated',
+        });
+        const summary = buildExecutiveSummary([outdatedComponent], [], '/test/project');
+        const updateAction = summary.next_actions.find(a => a.command === 'npm outdated');
+        expect(updateAction).toBeDefined();
+        expect(updateAction?.action).toContain('Update');
+        expect(updateAction?.action).toContain('outdated');
+    });
+    it('includes next actions for deprecated packages', () => {
+        const deprecatedComponent = createMockComponent({
+            name: 'DeprecatedLib',
+            status: 'deprecated',
+        });
+        const summary = buildExecutiveSummary([deprecatedComponent], [], '/test/project');
+        const replaceAction = summary.next_actions.find(a => a.action.includes('Replace'));
+        expect(replaceAction).toBeDefined();
+        expect(replaceAction?.action).toContain('deprecated');
+    });
+    it('includes next actions for unused components', () => {
+        const unusedComponent = createMockComponent({
+            name: 'UnusedLib',
+            status: 'unused',
+        });
+        const summary = buildExecutiveSummary([unusedComponent], [], '/test/project');
+        const reviewAction = summary.next_actions.find(a => a.action.includes('Review'));
+        expect(reviewAction).toBeDefined();
+        expect(reviewAction?.action).toContain('unused');
+    });
+});
+//# sourceMappingURL=agent-output.test.js.map

package/dist/__tests__/agent-output.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-output.test.js","sourceRoot":"","sources":["../../src/__tests__/agent-output.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/architecture-insights-stack.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Regression test for R6 stack-overflow on large/cyclic import graphs.
+ *
+ * Symptom (verified on atomize-ai 2026-05): scanning a project with ~2475
+ * components and deep import chains caused `detectImportCycles` to throw
+ * "Maximum call stack size exceeded" because its `visit()` helper recursed
+ * once per import edge along the longest path. Node's default V8 stack tops
+ * out around ~10–15k frames for this function's frame size; a single chain
+ * of ~10k internal imports is enough to blow it (verified empirically with
+ * `node -e` reproduction).
+ *
+ * The fix converts `visit()` to an explicit work-stack iteration. These tests
+ * lock in the post-fix invariants:
+ *   1. A 15,000-node deep linear import chain (well past the recursive limit)
+ *      completes without throwing.
+ *   2. A 15,000-node chain that closes into a cycle still detects exactly one
+ *      cycle and reports it correctly.
+ *   3. A graph mixing multiple cycles still respects the `limit` argument.
+ */
+export {};
+//# sourceMappingURL=architecture-insights-stack.test.d.ts.map

package/dist/__tests__/architecture-insights-stack.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-insights-stack.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/architecture-insights-stack.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/__tests__/architecture-insights-stack.test.js

@@ -0,0 +1,86 @@
+/**
+ * Regression test for R6 stack-overflow on large/cyclic import graphs.
+ *
+ * Symptom (verified on atomize-ai 2026-05): scanning a project with ~2475
+ * components and deep import chains caused `detectImportCycles` to throw
+ * "Maximum call stack size exceeded" because its `visit()` helper recursed
+ * once per import edge along the longest path. Node's default V8 stack tops
+ * out around ~10–15k frames for this function's frame size; a single chain
+ * of ~10k internal imports is enough to blow it (verified empirically with
+ * `node -e` reproduction).
+ *
+ * The fix converts `visit()` to an explicit work-stack iteration. These tests
+ * lock in the post-fix invariants:
+ *   1. A 15,000-node deep linear import chain (well past the recursive limit)
+ *      completes without throwing.
+ *   2. A 15,000-node chain that closes into a cycle still detects exactly one
+ *      cycle and reports it correctly.
+ *   3. A graph mixing multiple cycles still respects the `limit` argument.
+ */
+import { describe, expect, it } from 'vitest';
+import { detectImportCycles } from '../architecture-insights.js';
+import { createComponent, createConnection } from './helpers.js';
+function buildLinearChain(depth) {
+    const components = [];
+    const connections = [];
+    for (let i = 0; i < depth; i++) {
+        components.push(createComponent({
+            name: `chain/node-${i}`,
+            type: 'component',
+            file: `src/chain/node-${i}.ts`,
+        }));
+    }
+    for (let i = 0; i < depth - 1; i++) {
+        connections.push(createConnection(components[i], components[i + 1], { connection_type: 'imports' }));
+    }
+    return { components, connections };
+}
+describe('detectImportCycles — stack-overflow regression', () => {
+    it('handles a 15,000-node deep linear chain without overflowing the stack', () => {
+        // 15,000 is deliberately well past V8's default ~10–15k frame budget for
+        // this function's frame size (verified throws at this depth with a
+        // standalone reproduction of the recursive visit() pattern).
+        // A linear chain has NO cycle, so the correct answer is [].
+        const { components, connections } = buildLinearChain(15000);
+        // Pre-fix behavior: throws "Maximum call stack size exceeded".
+        // Post-fix: returns [] in well under a second.
+        expect(() => detectImportCycles(components, connections, 5)).not.toThrow();
+        const cycles = detectImportCycles(components, connections, 5);
+        expect(cycles).toEqual([]);
+    });
+    it('detects a single cycle inside a 15,000-node graph', () => {
+        const { components, connections } = buildLinearChain(15000);
+        // Close the chain back to node-0 → forms one 3,500-node cycle.
+        connections.push(createConnection(components[components.length - 1], components[0], {
+            connection_type: 'imports',
+        }));
+        expect(() => detectImportCycles(components, connections, 5)).not.toThrow();
+        const cycles = detectImportCycles(components, connections, 5);
+        expect(cycles).toHaveLength(1);
+        // Cycle is recorded as the full ring (start..end..start). Just spot-check
+        // structure — we don't want to materialize 3,500 names in the assertion.
+        expect(cycles[0][0]).toBe('chain/node-0');
+        expect(cycles[0][cycles[0].length - 1]).toBe('chain/node-0');
+        expect(cycles[0]).toHaveLength(15001);
+    });
+    it('respects the limit when many cycles are present', () => {
+        // Build 10 independent 4-node cycles.
+        const components = [];
+        const connections = [];
+        for (let r = 0; r < 10; r++) {
+            const ring = Array.from({ length: 4 }, (_, i) => createComponent({
+                name: `ring-${r}/node-${i}`,
+                type: 'component',
+                file: `src/ring-${r}/node-${i}.ts`,
+            }));
+            components.push(...ring);
+            for (let i = 0; i < ring.length; i++) {
+                connections.push(createConnection(ring[i], ring[(i + 1) % ring.length], { connection_type: 'imports' }));
+            }
+        }
+        expect(() => detectImportCycles(components, connections, 3)).not.toThrow();
+        const cycles = detectImportCycles(components, connections, 3);
+        expect(cycles).toHaveLength(3);
+    });
+});
+//# sourceMappingURL=architecture-insights-stack.test.js.map

package/dist/__tests__/architecture-insights-stack.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-insights-stack.test.js","sourceRoot":"","sources":["../../src/__tests__/architecture-insights-stack.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/architecture-insights.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=architecture-insights.test.d.ts.map