See FixMap choose where to start.

User

sendMail times out when password reset email transport is unavailable. Can you fix it?

Agent

I should get a focused map before searching blindly.

Calls fixmap_plan:

{
  "issue": "sendMail times out when password reset email transport is unavailable",
  "limit": 3
}

FixMap

# FixMap Report

FixMap found 3 context files, 4 impact files, and generated 1 test route.

## Context Files

- `src/email/transport.ts` (high confidence, score 57): path matches task terms: email, transport; multiple task terms converge in the file path; file module name exactly matches a task term; content matches task terms: transport, password, send, mail; defines task identifiers: sendMail; task identifier is defined in maintained implementation source; defines symbols matching task terms: transport
- `src/auth/reset-password.ts` (medium confidence, score 38): path matches task terms: reset, password; multiple task terms converge in the file path; content matches task terms: reset, email, send, mail, transport, password; defines symbols matching task terms: createResetToken, consumeResetToken; auth-related task signal; imports ranked file src/email/transport.ts
- `src/email/templates/reset.ts` (medium confidence, score 29): path matches task terms: email, reset; multiple task terms converge in the file path; file module name exactly matches a task term; content matches task terms: reset, email, password; defines symbols matching task terms: resetEmailTemplate; within two import hops of ranked file src/email/transport.ts

## Impact Graph

- `test/auth/reset-password.test.ts` (high confidence, impact 20): changed alongside src/auth/reset-password.ts in 3 of its 4 eligible changes; this file imports src/auth/reset-password.ts; routed test for src/auth/reset-password.ts via npm run test
- `src/config.ts` (high confidence, impact 16): changed alongside src/email/transport.ts in 2 of its 2 eligible changes; src/auth/reset-password.ts imports this file; src/email/transport.ts imports this file
- `src/http/routes.ts` (high confidence, impact 11): changed alongside src/auth/reset-password.ts in 2 of its 4 eligible changes; this file imports src/auth/reset-password.ts
- `src/auth/token-store.ts` (high confidence, impact 9): changed alongside src/auth/reset-password.ts in 2 of its 4 eligible changes; src/auth/reset-password.ts imports this file

Inspection order: `src/email/transport.ts` → `src/auth/reset-password.ts` → `src/email/templates/reset.ts` → `test/auth/reset-password.test.ts` → `src/config.ts` → `src/http/routes.ts` → `src/auth/token-store.ts`.
History evidence: 8 eligible commits.

## Test Routes

- `npm run test`: repository root script named test. Related: `test/auth/reset-password.test.ts`.

## Risk Map

- **low** authentication: ranked files touch authentication; review this area before editing, but no diff evidence is available yet

## Changed Files

- None found

## Analysis

- Task grounding: **anchored**
- Repository scan: **complete**
- Ranking shape: **separated**
- Next action: Inspect src/email/transport.ts and its routed tests before editing.

## Diagnostics

- None found

Agent edits carefully

The agent opens the leading files, confirms the evidence, and adds a bounded SMTP connection timeout:

// Before
const transport = createTransport({ host: config.smtpHost, port: config.smtpPort });

// After
const transport = createTransport({
  host: config.smtpHost,
  port: config.smtpPort,
  connectionTimeout: config.smtpTimeoutMs
});

The configuration and related reset-email test are updated too.

Calls fixmap_verify:

{
  "report": { "...": "the previous FixMap JSON plan" },
  "diff": "main...HEAD"
}

FixMap

# FixMap Verification

FixMap verified 3 changed files against the plan and raised 2 warnings.

## Findings

- **warning** One file changed that the plan did not rank. Either the task grew beyond the original description, or the ranking missed them — worth checking which.
  - `src/config.ts`
- **warning** The change touches automation, which the original plan did not flag: configuration or CI automation files may affect developer workflows.
  - `src/config.ts`

## Changed Files

- `src/config.ts`
- `src/email/transport.ts`
- `test/auth/reset-password.test.ts`

## Recalculated Impact

- `src/auth/reset-password.ts` (high confidence): changed alongside test/auth/reset-password.test.ts in 3 of its 4 eligible changes; this file imports src/config.ts; this file imports src/email/transport.ts; test/auth/reset-password.test.ts imports this file
- `src/billing/invoice.ts` (medium confidence): this file imports src/config.ts

Agent proves the fix

npm run test

After the test passes, the agent reports the cause, the code change, and the validation result.