v1.0.1

Changed

• Added semantic drilldown footers to directory reads and made overview --symbols emit budget-adaptive inline kind name@line-range anchors before falling back to compact symbol names.
• Extended show -C/--context-lines to line ranges, resolved sections, and comma-separated show/section targets; comma-separated multi reads clamp each target to 10 context lines.
• Updated discover next-step guidance to prefer confirmed context targets when structural candidates exist and raw show <path>:<line> -C 10 reads for text hits.
• Reframed the embedded agent guide as an evidence contract with explicit srcwalk-before-rg routing and comma-separated literal OR discovery guidance.

v1.0.0

Highlights

• Reworked srcwalk around intent-first commands for agent navigation: discover,
  show, trace, context, assess, overview, deps, compare, diff,
  and review.
• Added evidence packets with source, kind, confidence, caveat, and
  next-action guidance so agents can bound claims and continue from exact reads.
• Added change-review and diff evidence flows for Git worktrees.
• Added HTML/Markdown document navigation and CSS/SCSS/Less structural navigation.
• Improved bundled/minified artifact navigation with provenance labels and clearer
  caveats.

Breaking changes

• Removed legacy action-first commands and root analysis flags. Use the
  intent-first commands in the migration table below.
• Renamed the repo-orientation command from map to overview.
• Root positional input is now exact path evidence. Use srcwalk discover <query>
  for search.
• Slash-delimited text queries are literal text. Use rg for raw regex search.

Migration notes

Before	Use now
srcwalk find <query>	srcwalk discover <query>
srcwalk files <glob>	srcwalk discover <glob> --as file
srcwalk callers <target>	srcwalk trace callers <target>
srcwalk callees <target>	srcwalk trace callees <target>
srcwalk flow <target>	srcwalk context <target>
srcwalk impact <target>	srcwalk assess <target>
srcwalk map	srcwalk overview
srcwalk <query>	srcwalk discover <query>

Added

• Added review for change-set evidence packets with Flow Map context, changed
  symbol summaries, and next-step commands.
• Added diff for structured Git diff evidence across ranges, staged changes,
  working-tree changes, and untracked files.
• Added compare <target-a> <target-b> for structural shared/only evidence
  between two known function-like targets, without equivalence or runtime claims.
• Added discover --as access for field/member access grouping across writes,
  resets, reads, and unknown text evidence.
• Added HTML and Markdown-style document navigation for sections, elements, code
  blocks, links, and assets.
• Added CSS, SCSS, and Less structural navigation for selectors, at-rules,
  variables/properties, mixins/functions, imports, and url(...) references.
• Added show -C/--context-lines, strict comma-separated multi-location show,
  discover --match all, discover --exclude, and explicit literal OR through
  discover --match any --as text.
• Added smarter routing for exact bundled/minified artifact reads, exact
  artifact-file scopes, and path-like file glob discovery.

Changed

• Upgraded context into a one-target understanding packet with Flow Map
  evidence, caller/callee neighborhood summaries, trust labels, and exact next
  reads.
• Made deps <file> show explicit outbound and inbound sections by default,
  including empty sections when no edges are found.
• Grouped compact discover facets by file to reduce repeated path tokens while
  preserving exact :line-range evidence.
• Updated compare follow-up footers to route one-target follow-up reads through
  context.
• Refreshed README examples and srcwalk guide routing text around the
  intent-first command model and evidence-label interpretation.

Fixed

• Bounded default discover --as access output and added pagination guidance for
  large result sets.
• Counted untracked diff file lines without loading the whole file into memory.
• Hardened quoted Git diff path parsing for paths containing b/ inside names.
• Made review fallback routing resilient to wording changes in unsupported-target
  diagnostics.
• Fixed Windows CI builds for parser dependencies by using the Clang toolchain
  environment consistently.
• Improved path disambiguation when canonical and displayed temporary paths differ.

v0.5.0

Added

• Added Windows x64 CI, release asset, and npm install/run support, with path display, path filters, and path reads covered by Windows-specific tests.

Changed

• Improved JavaScript and TypeScript local dependency extraction for ESM specifiers, re-exports, and CommonJS require calls, so map and deps report more complete local relations.
• Documented Windows verification expectations for maintainers and tightened pull request workflow permissions.

Fixed

• Hardened source discovery against symlink scope escapes and invalid SRCWALK_THREADS values.
• Reduced noisy reverse dependency evidence by capping candidate searches and avoiding bare child-member matches without owner context.

v0.4.1

Added

• Improved artifact-mode JS/TS navigation with anchors, byte-range evidence, and section reads.
• Extended artifact routing across find, flow, impact, callers, and callees.

Changed

• Improved grouped artifact output, compact match snippets, and long-line hit evidence around matched terms.
• Clarified public artifact workflow guidance and added regression coverage for artifact navigation and path reads.

v0.4.0

Added

• Added action-first command routing for find, files, callers, callees, deps, flow, impact, and path reads, backed by split command services and focused integration coverage.
• Added dependency-aware map output with local relation groups, outbound dependency previews for narrowed scopes, and shallow directory token rollups for deep source trees.
• Added JS/TS artifact-mode navigation for bundle anchors, artifact reads, artifact search snippets, and artifact caller/callee support within the supported language surface.
• Added path range read shortcuts such as srcwalk <path>:start-end for direct evidence reads without shell sed/head chains.

Changed

• Split large CLI, read, search, display, ranking, symbol, and command modules into smaller focused modules while preserving existing command behavior.
• Streamlined srcwalk guide, README, and agent instructions around srcwalk-first navigation, srcwalk files for project filename discovery, narrow --scope, and generic unsupported-file fallbacks.
• Improved caller, callee, deps, find, and map output UX with more compact semantic rows, directory grouping, footer tips, and clearer scope/depth wording.

Fixed

• Fixed unsupported find query syntax diagnostics so misuse now reports supported forms instead of falling through to misleading path-not-found errors.
• Fixed map depth handling so explicit --depth remains strict while token totals still roll up deep files into visible shallow directories.
• Fixed several search/read edge cases around multi-scope queries, artifact snippets, path-line routing, semantic context display, and pagination coverage.

v0.3.2

Changed

• Removed the legacy benchmark/ harness from the repository and ignored local benchmark workspaces now that the maintained retrieval benchmark lives outside the published tree.

Fixed

• Improved callers ranking for common/overloaded method names by showing named contexts before top-level matches, demoting repeated callsites from the same caller context, and ranking explicit receivers ahead of self/no-receiver calls without filtering any candidates.

v0.3.1

Changed

• Grouped srcwalk files human output by directory by default, making larger file glob result sets easier to scan without adding a new flag.

Fixed

• Fixed JavaScript and TypeScript IIFE handling so named, async, generator, anonymous, arrow, and assigned IIFEs surface useful outline/search/caller/callee contexts.
• Fixed JavaScript and TypeScript assigned arrow functions so find, callees, and callers can use the assigned variable name as the callable context.

v0.3.0

Added

• Added srcwalk guide to print the full embedded, version-matched agent guide from the binary, making the installed binary the source of truth for agent routing policy.
• Added srcwalk version --check to check the latest release and print update commands for npm, cargo, and Git installs.
• Added multi-symbol + multi-scope find support, so commands like srcwalk find "A, B, C" --scope src --scope tests now search each query across all scopes and render one section per query.
• Added compact multi-section fallback output when --section A,B --budget N exceeds the section budget; output now keeps section labels, useful code snippets, omitted-line metrics, and concise follow-up hints instead of returning only a caveat.
• Added C/C++ declarator-based function-name extraction for structural search and sections, including K&R-style definitions such as rust_demangle_callback.

Changed

• Converted the installable skills/srcwalk/SKILL.md into a minimal bootstrap entry that points agents to srcwalk guide; compatible_srcwalk now requires a binary with the embedded guide contract.
• Updated root --help and README examples to surface srcwalk guide, action-first analysis, multi-scope/multi-symbol find, compact section reads, and current footer shapes.
• Clarified paginated multi-scope find output by labeling page-local scope counts as Scopes on this page: instead of implying totals.
• Shortened section-budget footers to keep enough metrics for agents without verbose prose.

Fixed

• Fixed repeated --scope combined with comma-separated find queries; each query now correctly searches all scopes instead of silently losing multi-scope behavior.
• Fixed paginated search count summaries so definition/usage/comment counts reflect the rendered page while continuation hints still use total matches.
• Fixed multi-section over-budget reads returning no body for large selections; they now degrade to compact snippets with anchor lines for requested ranges inside merged symbol sections.
• Fixed C structural outlines and symbol searches that previously surfaced some function definitions as <anonymous>, enabling name-glob find and --section <symbol> on affected C files.

v0.2.7

Added

• Added srcwalk files '<glob>' for ignore-aware, paginated file discovery.
• Added symbol-name glob search in find for patterns like displayAjax*, *Controller, and run_{full,expanded}*.
• Added comma-separated mixed --section reads and repeated --scope support for find.

Changed

• Moved file-glob queries out of find; use srcwalk files '<glob>' instead.
• Made --expand budget-aware so inline source is capped separately from search hits, with compact omitted-hit metrics.
• Made explicit --full --budget <N> act as the raw-read cap while preserving default safety caps.
• Shortened agent-facing caveats for capped output, callers, impact, and path-like misses.

v0.2.6

Added

• Action-first analysis subcommands: find, callers, callees, flow, impact, deps, and map. Legacy flag syntax remains supported.
• The srcwalk skill now includes example output shapes for flow and impact so agents understand their orientation/triage roles.

Changed

• CLI help, README, and the srcwalk skill now present the mental model as target-first file reading plus action-first analysis commands.
• Footer hints now use semantic prefixes: Next: for suggested commands, Note: for context/status, and Caveat: for limitations.

Fixed

• --section <symbol> no longer degrades to an outline solely because the section exceeds 200 lines; explicit sections now return source when within the effective token budget.
• Path-like queries with separators now fail fast with an fd candidate hint when the file does not exist, instead of falling back to search and implying nested paths are unsupported.