From d2b5f2adc16fe192dd40e89521aa4ac6b55041c8 Mon Sep 17 00:00:00 2001 From: sting8k Date: Sun, 24 May 2026 23:51:17 +0700 Subject: [PATCH] chore: prepare v1.0.0 release --- CHANGELOG.md | 89 ++++++++++++++++++++++++++++++++++++++---------- Cargo.lock | 2 +- Cargo.toml | 2 +- npm/package.json | 2 +- 4 files changed, 74 insertions(+), 21 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f73be02..ebf6d73 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,28 +4,81 @@ All notable changes to srcwalk are documented here. ## Unreleased +## [1.0.0] - 2026-05-24 + +### 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 ` + for search. +- Slash-delimited text queries are literal text. Use `rg` for raw regex search. + +### Migration notes +| Before | Use now | +| --- | --- | +| `srcwalk find ` | `srcwalk discover ` | +| `srcwalk files ` | `srcwalk discover --as file` | +| `srcwalk callers ` | `srcwalk trace callers ` | +| `srcwalk callees ` | `srcwalk trace callees ` | +| `srcwalk flow ` | `srcwalk context ` | +| `srcwalk impact ` | `srcwalk assess ` | +| `srcwalk map` | `srcwalk overview` | +| `srcwalk ` | `srcwalk discover ` | + ### Added -- Added HTML and Markdown-style document navigation support: sections, elements, - code blocks, and explicit links/assets without runtime or renderer claims. -- Added smart routing for exact minified JS/TS artifact file reads and exact - artifact-file scopes, inferred path-like file glob discovery, and explicit - comma-separated literal text OR through `discover --match any --as text`. +- 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 ` for structural shared/only evidence - between two known function-like source targets, with exact anchors and no - equivalence/runtime/verdict claims. -- Added intent-first CLI routing: `discover`, `show`, `trace callers`, `trace callees`, `context`, and `assess`, while preserving `overview`, `deps`, `guide`, and `version`. -- Added `show -C/--context-lines`, strict comma-separated multi-location `show`, `discover --as`, `discover --match all` same-file co-occurrence, and conservative `discover --exclude` file-pattern filtering. + 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 -- Renamed the repo-orientation command from `map` to `overview` to make the intent explicit. -- Upgraded `context` into the one-target understanding packet with Flow Map evidence, caller/callee neighborhood summaries, and exact next reads. -- Made `deps ` show explicit empty outbound/inbound sections so imports and dependents are visible by default. -- Updated `compare` follow-up footers to route one-target follow-up reads through `context`. -- Compact discover facets now group multiple definitions from the same file under one file header, preserving exact `:line-range` evidence while reducing repeated path tokens. -- Removed the old action-first command surface (`find`, `files`, `callers`, `callees`, `flow`, `impact`, and root analysis flags); use the intent-first commands instead. -- Root non-path query fallback was removed. Root positional input is now exact path evidence; use `srcwalk discover ` for search. -- Slash-delimited text queries are now literal text; raw regex grep belongs to - `rg`, while srcwalk text discovery stays focused on literal navigation evidence. +- Upgraded `context` into a one-target understanding packet with Flow Map + evidence, caller/callee neighborhood summaries, trust labels, and exact next + reads. +- Made `deps ` 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. ## [0.5.0] - 2026-05-11 diff --git a/Cargo.lock b/Cargo.lock index 8e01e3c..d871df6 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -672,7 +672,7 @@ checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03" [[package]] name = "srcwalk" -version = "0.5.0" +version = "1.0.0" dependencies = [ "aho-corasick", "clap", diff --git a/Cargo.toml b/Cargo.toml index eb465fb..ac0fed0 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "srcwalk" -version = "0.5.0" +version = "1.0.0" edition = "2021" description = "Tree-sitter indexed lookups — smart code reading for AI agents" license = "MIT" diff --git a/npm/package.json b/npm/package.json index d973143..dd4d65d 100644 --- a/npm/package.json +++ b/npm/package.json @@ -1,6 +1,6 @@ { "name": "srcwalk", - "version": "0.5.0", + "version": "1.0.0", "description": "Code-intelligence CLI for AI agents — tree-sitter outlines, symbol search, caller/callee graphs, deps, overview", "bin": { "srcwalk": "run.js"