feat(recipes): call-path and symbol-neighborhood trace recipes

[SutuSebastian]

Summary

• Add call-path recipe — shortest cycle-safe call path between two symbols (via: calls | dependencies | all).
• Add symbol-neighborhood recipe — depth-bounded bidirectional call-graph walk plus one-hop file dependencies.
• Golden scenarios on fixtures/minimal; fixture .codemap/.gitignore ignores index.lock / errors.log.

Recipe half of mcp-trace-explore-tools (PR 4 in agent-surface-delivery). MCP trace / explore tools follow in PR 6.

Test plan

• CODEMAP_ROOT=fixtures/minimal bun src/index.ts query --recipe call-path --params from=createClient,to=handshake --json
• CODEMAP_ROOT=fixtures/minimal bun src/index.ts query --recipe symbol-neighborhood --params name=createClient,depth=1 --json
• bun run test:golden

[changeset-bot]

🦋 Changeset detected

Latest commit: 0337f98

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@stainless-code/codemap	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Warning

Review limit reached

@SutuSebastian, we couldn't start this review because you've used your available PR reviews for now.

Your plan includes 1 review of capacity. Refill in 53 minutes and 16 seconds.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more review capacity refills, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than trial, open-source, and free plans. In all cases, review capacity refills continuously over time.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: bd9eef2c-085f-430f-8b99-37016bc84ccf

📥 Commits

Reviewing files that changed from the base of the PR and between f5374b8 and 0337f98.

📒 Files selected for processing (20)

• .changeset/trace-recipes.md
• docs/plans/agent-surface-delivery.md
• docs/plans/mcp-trace-explore-tools.md
• fixtures/golden/minimal/call-path-max-depth.json
• fixtures/golden/minimal/call-path-no-path.json
• fixtures/golden/minimal/call-path-via-all.json
• fixtures/golden/minimal/call-path-via-dependencies-same-file.json
• fixtures/golden/minimal/call-path-via-dependencies.json
• fixtures/golden/minimal/call-path.json
• fixtures/golden/minimal/symbol-neighborhood-depth-0.json
• fixtures/golden/minimal/symbol-neighborhood-depth-2.json
• fixtures/golden/minimal/symbol-neighborhood-kind-filter.json
• fixtures/golden/minimal/symbol-neighborhood-unknown.json
• fixtures/golden/minimal/symbol-neighborhood.json
• fixtures/golden/scenarios.json
• fixtures/minimal/.codemap/.gitignore
• templates/recipes/call-path.md
• templates/recipes/call-path.sql
• templates/recipes/symbol-neighborhood.md
• templates/recipes/symbol-neighborhood.sql

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/trace-recipes

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}