diffctx 1.18.3__tar.gz → 1.18.4__tar.gz

{diffctx-1.18.3 → diffctx-1.18.4}/CHANGELOG.md

@@ -7,6 +7,141 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.18.4] - 2026-10-07
+
+### Security
+
+- Impact no longer names a file the run withholds (`.diffctx/ignore`, a
+  secret name): a definition removed from it, its deletion or its rename
+  reached the answer while pack reported only a withheld count.
+
+### Changed
+
+- The MCP server runs on the MCP Python SDK 2.3 (`mcp>=2.3,<3`): it answers
+  the `server/discover` probe Claude Code opens with, instead of rejecting it
+  with 31 validation errors on every connect, and still accepts every
+  `initialize` revision back to 2024-11-05 (#366).
+- `ChangeClass` gains `layout`: a file whose diff changes only whitespace,
+  comments, quote style, trailing commas, semicolons or import order. Pack
+  ranks it with `mechanical` (#370).
+- `diffctx graph --level file|directory` now applies to `-f json`, `-f
+  graphml` and the `--summary` counts; without `--level` they stay per
+  fragment (#352).
+
+### Fixed
+
+- Plugin hook: the commit is previewed as the index it will start from — the
+  line's own `git add`/`git rm` replayed on a copy of the index, `-a`, a
+  pathspec with `--only` semantics, `-i`, `--amend`, a first commit, a linked
+  worktree — instead of the whole working tree; a here-document message is no
+  pathspec; a multi-commit cherry-pick is reviewed whole; `cd ~/repo` is
+  followed; a diff written to a file is no inspection; an empty answer stays
+  empty after the commit lands (#384, #373, #380, #377). The session hint
+  names `--symbol` again (#379).
+- Impact: the header counts every caller its lines call untested, says
+  "callers unresolved" instead of "0 caller(s)" when no binding model could
+  resolve them, says when the run stopped early, and counts changed
+  definitions no test reaches (#386, #387, #335). A caller registered by a
+  decorator (`@register_node`, `@app.route`) is no longer called untested
+  (#388). Adding fields or parameters with defaults collapses the call sites
+  into one signature-compatible line (#388); formatting- or comment-only edits
+  are no contract and list no callers (#370). An unchanged caller in a changed
+  file is listed (#362). `pub` inside a `pub(crate)` module is no public API
+  (#359); a script named for a schema is no schema contract (#374). A deleted
+  path is matched by its path, a relative path, its module name or a
+  basename no other file has, never by a bare word (#369, #383). A removed
+  member and the remaining `?.()` calls to it are reported (#367).
+- Impact on a large changed module took 74 s on one core; per-file indexes and
+  memoized test links bring it to 4 s with byte-identical output (#385). The
+  Python CLI's watchdog waits the binary's 30 s grace past `--timeout`, so a
+  run that stops at its deadline answers partially instead of exiting 124
+  with nothing (#382).
+- MCP: `diff_ref="HEAD"` is documented as the uncommitted work, and a clean
+  tree answers with the hint that `HEAD~1..HEAD` is the last commit (#368).
+- Selection: changed code is placed by evidence tier (production, tests,
+  config and docs, mechanical or layout edits, generated files) and by how
+  densely each piece carries the change, not cheapest-first; a core the
+  first pass could only place as its signature stub gets its body when the
+  difference fits (#296, #327). A Django migration ("Generated by Django")
+  is no longer a generated file ranked last (#311).
+- Graph: a range's own commits no longer vouch for its files in the
+  co-change channel, which now links two files once, representative to
+  representative (#340). The tags fallback no longer links files of a
+  language its own builder parsed (a stdlib module name, a keyword); a key
+  most config files carry (`workflow_dispatch` in every CI workflow) links
+  no source file to all of them (#286, #297); a setting spelled whole
+  (`database_url` in two of four environment files) still links its reader.
+  A bare `--diff X` or a time window reads history only up to its base.
+- Imports that spell paths resolve through one rule — next to the importing
+  file, then from the root, `..` folded: Nim `import vendor/palette`, Nix
+  `import ../vendor/palette.nix` (and a directory's `default.nix`), Ruby
+  `require_relative`; OCaml `open Palette` links `palette.ml` (#285). A
+  TypeScript import resolves with the nearest `tsconfig*.json`, its relative
+  `extends` folded in, not only the root one (#372).
+- Plugin hook: `merge --squash`, `merge -S` and `cherry-pick -S` keep their
+  target; a pathspec commit previews the paths the index knows, never an
+  untracked file under them; `git apply`, `update-index`, `read-tree` and
+  the like before a commit preview the working tree; a step in another
+  repository stages nothing; the preview reads a copy of the index, so a
+  held index lock neither blocks it nor is taken; a first commit is checked
+  once it lands; a manual run that found nothing leaves no reminder;
+  `git status && git diff --cached` reviews the index; the `impact_gate`
+  option no longer silences PostToolUse answers; merging the branch's own
+  upstream (`git merge --ff-only origin/main`) is silence.
+- Impact: a definition moved to another module names the importers of the
+  old one; removed methods are found in classes split into fragments, and
+  `def self.x`, `func (r T) x`, `const x = () =>` name `x`; a deletion below
+  a definition does not change it; a lexical test or caller link stops at
+  a sibling project's manifest; a function nested in another has callers
+  only inside it, and an untyped `x.name` attribute read is no possible
+  caller. Formatting-only detection keeps a docstring
+  that is not one, and no longer calls a change layout when it moves a line
+  out of its Python or YAML block, drops a one-element tuple's comma, edits
+  a mid-word `#` (`${#a}`), or removes a `;` before a line starting with `(`
+  or `[` in JS/TS. Compatible extension requires the new field to be
+  appended, and a relative path to a moved file is a stale reference.
+- `--symbol` accepts `Owner.name`, `Owner::name` and dotted names; a
+  malformed one exits 2 in both CLIs, and over MCP a malformed or unknown
+  symbol is a refusal the agent can read, not "Error executing tool"; a
+  name in more than 256 files keeps its definition past the cap.
+- The Python budget fitter drops a `layout` witness with `mechanical` ones
+  and ranks `unknown` with content, as the native CLI does.
+- Release: post-publish smokes wait until both pip and uv resolve the version
+  and fail with a named error after 10 minutes; dispatched runs are found by
+  dispatch time (#364).
+- Plugin hook: a path git cannot hash (an untracked nested repository, a
+  moved submodule) no longer turns the answer into silence logged as
+  "clean"; a multi-commit cherry-pick touching a non-UTF-8 file is reviewed;
+  a `cd` that a search printed is not taken for where it ran. `--diff staged`
+  writes a copy of the index, so a held `index.lock` is no "unmerged entries?".
+- Impact: a Rust type and its `impl` blocks are one definition with its
+  callers, a trait method is reached through its trait (`Display`, not
+  `std`), and an unresolved name counts definitions, not "files" (#403).
+  Python `//` hides no call; a root `"baseUrl": "."` resolves bare
+  specifiers and overlapping `paths` take the longest prefix (#414). A
+  non-ASCII path, a `diff.context` setting, a deleted call statement, a
+  deletion right under a caller, a column-0 line removed from a body and a
+  call still naming a moved Rust function's old module no longer hide or
+  invent callers; a body call gaining an argument and an added `__slots__`
+  are not signature-compatible; `pub mod r#type;` and an attributed
+  `pub mod` are public; a same-language sibling module importing the
+  qualified name keeps its test link. `--symbol Owner.name` answers only for
+  that owner, and `PATH:Owner::name` parses. A call spread into an object
+  (`...workboxPolicy({..})`) is a call, not a member access: four Vite
+  configs read as zero callers.
+- Impact counts the files the run withholds instead of reading them as
+  nothing: the header says `N more withheld by ignore rules` for a range and
+  `N file(s) naming it withheld` for `--symbol`, and that their calls and
+  tests were not read (`withheld_files` in the JSON) (#392).
+- Impact: a definition moved within its file with its text unchanged lists
+  no callers, as a formatting-only edit does; moved and edited, it still
+  does. `@value.setter`, `@attr.s`, `@define`, `@enum.unique` and Lombok
+  annotations shape a definition and register it nowhere, so an untested
+  setter reads untested instead of "registered by" (#414).
+- The CLI and the MCP server report only the engine's own "nothing defines
+  it" as a refusal; a `KeyError` or `IndexError` is an internal error with its
+  traceback. Git output is decoded as UTF-8 on every platform.
+
 ## [1.18.3] - 2026-10-04
 
 ### Added
@@ -1903,7 +2038,8 @@ Earlier releases shipped as `treemapper`; see
 <https://github.com/nikolay-e/diffctx/releases> for the corresponding GitHub
 release notes (`1.0.0` through `1.6.1`).
 
-[Unreleased]: https://github.com/nikolay-e/diffctx/compare/v1.18.3...HEAD
+[Unreleased]: https://github.com/nikolay-e/diffctx/compare/v1.18.4...HEAD
+[1.18.4]: https://github.com/nikolay-e/diffctx/compare/v1.18.3...v1.18.4
 [1.18.3]: https://github.com/nikolay-e/diffctx/compare/v1.18.2...v1.18.3
 [1.18.2]: https://github.com/nikolay-e/diffctx/compare/v1.18.1...v1.18.2
 [1.18.1]: https://github.com/nikolay-e/diffctx/compare/v1.18.0...v1.18.1

{diffctx-1.18.3 → diffctx-1.18.4}/Cargo.lock

@@ -194,7 +194,7 @@ checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28"
 
 [[package]]
 name = "diffctx"
-version = "1.18.3"
+version = "1.18.4"
 dependencies = [
  "aho-corasick",
  "anyhow",

diffctx-1.18.4/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: diffctx
+Version: 1.18.4
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Dist: pathspec>=0.11,<2.0
+Requires-Dist: black>=23.0.0,<27.0 ; extra == 'dev'
+Requires-Dist: charset-normalizer>=3.0,<4.0 ; extra == 'dev'
+Requires-Dist: coverage>=7.0,<8.0 ; extra == 'dev'
+Requires-Dist: hypothesis>=6.0,<7.0 ; extra == 'dev'
+Requires-Dist: import-linter>=2.0,<3.0 ; extra == 'dev'
+Requires-Dist: mypy>=1.0,<3.0 ; extra == 'dev'
+Requires-Dist: pre-commit>=3.0,<5.0 ; extra == 'dev'
+Requires-Dist: pygit2>=1.12,<2.0 ; extra == 'dev'
+Requires-Dist: pytest>=7.0,<10.0 ; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23,<2.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=3.0,<8.0 ; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.1,<3.0 ; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.0,<4.0 ; extra == 'dev'
+Requires-Dist: pyyaml>=6.0.2,<8.0 ; extra == 'dev'
+Requires-Dist: radon>=6.0,<7.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.4,<1.0 ; extra == 'dev'
+Requires-Dist: tiktoken>=0.9,<1.0 ; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0,<7.0 ; extra == 'dev'
+Requires-Dist: charset-normalizer>=3.0,<4.0 ; extra == 'full'
+Requires-Dist: anyio>=4.5,<5.0 ; extra == 'mcp'
+Requires-Dist: mcp>=2.3,<3 ; extra == 'mcp'
+Provides-Extra: dev
+Provides-Extra: full
+Provides-Extra: mcp
+License-File: LICENSE
+Summary: Selects the minimum code an LLM needs to review a git diff
+Keywords: ai,chatgpt,claude,code-analysis,code-context,code-review,code-to-prompt,codebase,context,context-selection,diff-context,directory-tree,export,git-diff,json,llm,llm-context,mcp,model-context-protocol,tree,yaml
+Home-Page: https://diffctx.com/
+Author-email: Nikolay Eremeev <nikolay.eremeev@outlook.com>
+License-Expression: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Author, https://nikolay-eremeev.com
+Project-URL: Changelog, https://github.com/nikolay-e/diffctx/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://diffctx.com/
+Project-URL: Homepage, https://diffctx.com/
+Project-URL: Issues, https://github.com/nikolay-e/diffctx/issues
+Project-URL: Paper, https://doi.org/10.5281/zenodo.18824579
+Project-URL: Repository, https://github.com/nikolay-e/diffctx
+
+# diffctx — what a git change reaches, and the code to review it
+
+[![CI](https://github.com/nikolay-e/diffctx/actions/workflows/ci.yml/badge.svg)](https://github.com/nikolay-e/diffctx/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/diffctx)](https://pypi.org/project/diffctx/)
+[![crates.io](https://img.shields.io/crates/v/diffctx)](https://crates.io/crates/diffctx)
+[![npm](https://img.shields.io/npm/v/diffctx)](https://www.npmjs.com/package/diffctx)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.nikolay--e%2Fdiffctx-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.nikolay-e/diffctx)
+
+**diffctx tells an agent or a reviewer what a change reaches outside its
+diff** — the callers, the tests that reach them, the contracts it crosses —
+**and selects the code needed to understand it** under a token budget. Local,
+deterministic, no index, no model calls. Caller resolution is static and per
+language; where it cannot resolve, the answer says so instead of printing a
+zero.
+
+> Formerly published as `treemapper` — every command, flag, and API call works unchanged.
+
+## Install
+
+```bash
+# Claude Code: the MCP server, /diffctx:impact, and hooks that run it before commit and push
+claude plugin marketplace add nikolay-e/diffctx
+claude plugin install diffctx@diffctx
+
+# any MCP client
+claude mcp add diffctx -- uvx --from 'diffctx[mcp]' diffctx-mcp
+
+# CLI, zero-install
+uvx diffctx . --diff HEAD~1
+```
+
+pipx, pip, cargo, npm, Docker, Scoop, other MCP clients and the Python API:
+[integrations](docs/product/integrations.md).
+
+## Usage
+
+```bash
+diffctx . --diff --mode impact          # uncommitted work: callers outside the diff, their tests, contracts
+diffctx . --symbol parse_config         # the same for a name, no change needed
+diffctx . --diff main...feature         # the code to review a branch, packed under the auto budget
+diffctx . --diff HEAD~1 --budget 12000  # the last commit, capped at 12k o200k tokens
+diffctx . --diff 24h --mode locate      # today's work as ranked JSON, no source bodies
+diffctx .                               # whole-tree export, Markdown
+```
+
+`--diff` takes a git range, `staged`, or a duration window ending now (`24h`,
+`90min`, `2w`). Every flag, default and exit code:
+[command-line reference](docs/product/cli.md).
+
+![diffctx demo](https://raw.githubusercontent.com/nikolay-e/diffctx/main/docs/demo/demo.gif)
+
+## How it compares
+
+Whole-repo packers export everything; code-graph servers answer queries
+against a maintained index. diffctx is **diff-seeded**: the input is a change,
+the output is what it touches and what explains it. Measured results, and when
+the other two fit better: [COMPARISON.md](COMPARISON.md).
+
+## More
+
+- [Documentation site](https://diffctx.com/) — the pipeline end to end
+- [Command-line reference](docs/product/cli.md) — rendered from `diffctx --help`
+- [Integrations](docs/product/integrations.md) — install, MCP clients, Python API
+- [FAQ](docs/product/faq.md) — heuristic or oracle, ignore rules, monorepos, secrets
+- [Token counting](docs/product/token-budget.md) — `--budget` for non-GPT models
+- [GitHub Action](docs/product/github-action.md) — diff context as a CI step
+- [Benchmarks](BENCHMARKS.md) and the [paper](https://doi.org/10.5281/zenodo.18824579)
+- [Changelog](CHANGELOG.md) · [Security](SECURITY.md)
+- [Parameter strategy](docs/engineering/parameter-strategy.md)
+
+Apache 2.0
+
+<!-- mcp-name: io.github.nikolay-e/diffctx -->
+<!-- Ownership marker read from the PyPI description by the MCP registry. -->
+<!-- Must survive edits verbatim: one space after the colon, case-sensitive. -->
+

diffctx-1.18.4/README.md

@@ -0,0 +1,75 @@
+# diffctx — what a git change reaches, and the code to review it
+
+[![CI](https://github.com/nikolay-e/diffctx/actions/workflows/ci.yml/badge.svg)](https://github.com/nikolay-e/diffctx/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/diffctx)](https://pypi.org/project/diffctx/)
+[![crates.io](https://img.shields.io/crates/v/diffctx)](https://crates.io/crates/diffctx)
+[![npm](https://img.shields.io/npm/v/diffctx)](https://www.npmjs.com/package/diffctx)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.nikolay--e%2Fdiffctx-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.nikolay-e/diffctx)
+
+**diffctx tells an agent or a reviewer what a change reaches outside its
+diff** — the callers, the tests that reach them, the contracts it crosses —
+**and selects the code needed to understand it** under a token budget. Local,
+deterministic, no index, no model calls. Caller resolution is static and per
+language; where it cannot resolve, the answer says so instead of printing a
+zero.
+
+> Formerly published as `treemapper` — every command, flag, and API call works unchanged.
+
+## Install
+
+```bash
+# Claude Code: the MCP server, /diffctx:impact, and hooks that run it before commit and push
+claude plugin marketplace add nikolay-e/diffctx
+claude plugin install diffctx@diffctx
+
+# any MCP client
+claude mcp add diffctx -- uvx --from 'diffctx[mcp]' diffctx-mcp
+
+# CLI, zero-install
+uvx diffctx . --diff HEAD~1
+```
+
+pipx, pip, cargo, npm, Docker, Scoop, other MCP clients and the Python API:
+[integrations](docs/product/integrations.md).
+
+## Usage
+
+```bash
+diffctx . --diff --mode impact          # uncommitted work: callers outside the diff, their tests, contracts
+diffctx . --symbol parse_config         # the same for a name, no change needed
+diffctx . --diff main...feature         # the code to review a branch, packed under the auto budget
+diffctx . --diff HEAD~1 --budget 12000  # the last commit, capped at 12k o200k tokens
+diffctx . --diff 24h --mode locate      # today's work as ranked JSON, no source bodies
+diffctx .                               # whole-tree export, Markdown
+```
+
+`--diff` takes a git range, `staged`, or a duration window ending now (`24h`,
+`90min`, `2w`). Every flag, default and exit code:
+[command-line reference](docs/product/cli.md).
+
+![diffctx demo](https://raw.githubusercontent.com/nikolay-e/diffctx/main/docs/demo/demo.gif)
+
+## How it compares
+
+Whole-repo packers export everything; code-graph servers answer queries
+against a maintained index. diffctx is **diff-seeded**: the input is a change,
+the output is what it touches and what explains it. Measured results, and when
+the other two fit better: [COMPARISON.md](COMPARISON.md).
+
+## More
+
+- [Documentation site](https://diffctx.com/) — the pipeline end to end
+- [Command-line reference](docs/product/cli.md) — rendered from `diffctx --help`
+- [Integrations](docs/product/integrations.md) — install, MCP clients, Python API
+- [FAQ](docs/product/faq.md) — heuristic or oracle, ignore rules, monorepos, secrets
+- [Token counting](docs/product/token-budget.md) — `--budget` for non-GPT models
+- [GitHub Action](docs/product/github-action.md) — diff context as a CI step
+- [Benchmarks](BENCHMARKS.md) and the [paper](https://doi.org/10.5281/zenodo.18824579)
+- [Changelog](CHANGELOG.md) · [Security](SECURITY.md)
+- [Parameter strategy](docs/engineering/parameter-strategy.md)
+
+Apache 2.0
+
+<!-- mcp-name: io.github.nikolay-e/diffctx -->
+<!-- Ownership marker read from the PyPI description by the MCP registry. -->
+<!-- Must survive edits verbatim: one space after the colon, case-sensitive. -->

{diffctx-1.18.3 → diffctx-1.18.4}/crates/diffctx-native/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "diffctx"
-version = "1.18.3"
+version = "1.18.4"
 edition = "2024"
 rust-version = "1.85"
 description = "Selects the minimum code an LLM needs to review a git diff: walks the dependency graph outward from changed lines and stops when extra context stops paying for itself"

diffctx-1.18.4/crates/diffctx-native/README.md

@@ -0,0 +1,75 @@
+# diffctx — what a git change reaches, and the code to review it
+
+[![CI](https://github.com/nikolay-e/diffctx/actions/workflows/ci.yml/badge.svg)](https://github.com/nikolay-e/diffctx/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/diffctx)](https://pypi.org/project/diffctx/)
+[![crates.io](https://img.shields.io/crates/v/diffctx)](https://crates.io/crates/diffctx)
+[![npm](https://img.shields.io/npm/v/diffctx)](https://www.npmjs.com/package/diffctx)
+[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.nikolay--e%2Fdiffctx-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.nikolay-e/diffctx)
+
+**diffctx tells an agent or a reviewer what a change reaches outside its
+diff** — the callers, the tests that reach them, the contracts it crosses —
+**and selects the code needed to understand it** under a token budget. Local,
+deterministic, no index, no model calls. Caller resolution is static and per
+language; where it cannot resolve, the answer says so instead of printing a
+zero.
+
+> Formerly published as `treemapper` — every command, flag, and API call works unchanged.
+
+## Install
+
+```bash
+# Claude Code: the MCP server, /diffctx:impact, and hooks that run it before commit and push
+claude plugin marketplace add nikolay-e/diffctx
+claude plugin install diffctx@diffctx
+
+# any MCP client
+claude mcp add diffctx -- uvx --from 'diffctx[mcp]' diffctx-mcp
+
+# CLI, zero-install
+uvx diffctx . --diff HEAD~1
+```
+
+pipx, pip, cargo, npm, Docker, Scoop, other MCP clients and the Python API:
+[integrations](docs/product/integrations.md).
+
+## Usage
+
+```bash
+diffctx . --diff --mode impact          # uncommitted work: callers outside the diff, their tests, contracts
+diffctx . --symbol parse_config         # the same for a name, no change needed
+diffctx . --diff main...feature         # the code to review a branch, packed under the auto budget
+diffctx . --diff HEAD~1 --budget 12000  # the last commit, capped at 12k o200k tokens
+diffctx . --diff 24h --mode locate      # today's work as ranked JSON, no source bodies
+diffctx .                               # whole-tree export, Markdown
+```
+
+`--diff` takes a git range, `staged`, or a duration window ending now (`24h`,
+`90min`, `2w`). Every flag, default and exit code:
+[command-line reference](docs/product/cli.md).
+
+![diffctx demo](https://raw.githubusercontent.com/nikolay-e/diffctx/main/docs/demo/demo.gif)
+
+## How it compares
+
+Whole-repo packers export everything; code-graph servers answer queries
+against a maintained index. diffctx is **diff-seeded**: the input is a change,
+the output is what it touches and what explains it. Measured results, and when
+the other two fit better: [COMPARISON.md](COMPARISON.md).
+
+## More
+
+- [Documentation site](https://diffctx.com/) — the pipeline end to end
+- [Command-line reference](docs/product/cli.md) — rendered from `diffctx --help`
+- [Integrations](docs/product/integrations.md) — install, MCP clients, Python API
+- [FAQ](docs/product/faq.md) — heuristic or oracle, ignore rules, monorepos, secrets
+- [Token counting](docs/product/token-budget.md) — `--budget` for non-GPT models
+- [GitHub Action](docs/product/github-action.md) — diff context as a CI step
+- [Benchmarks](BENCHMARKS.md) and the [paper](https://doi.org/10.5281/zenodo.18824579)
+- [Changelog](CHANGELOG.md) · [Security](SECURITY.md)
+- [Parameter strategy](docs/engineering/parameter-strategy.md)
+
+Apache 2.0
+
+<!-- mcp-name: io.github.nikolay-e/diffctx -->
+<!-- Ownership marker read from the PyPI description by the MCP registry. -->
+<!-- Must survive edits verbatim: one space after the colon, case-sensitive. -->