chore(release): prepare v1.4.0

[galshubeli]

Cuts the [Unreleased] section into [1.4.0] and bumps the version. No functional changes — everything released here is already merged on main.

What's in 1.4.0

Chunk-level extraction cache for update() (#288) — update(..., cache_unchanged_chunks=True) rebuilds untouched chunks from the live graph instead of re-extracting them, so editing one paragraph of a 50-chunk document costs roughly one LLM extraction rather than fifty. Opt-in; the default stays False.

DatabaseError / DatabaseUnavailableError contract — driver-level failures now surface as DatabaseError, with DatabaseUnavailableError separating "the server never answered" from "the server answered and rejected the query". That split is what lets the cache decide when falling open is safe.

Minor bump: purely additive, no breaking changes to existing ingest paths. Callers catching redis.exceptions.* directly should catch DatabaseError instead — see the Changed section of the changelog.

Changes

File	Change
CHANGELOG.md	[Unreleased] → [1.4.0] - 2026-08-10 + summary paragraph
graphrag_sdk/pyproject.toml	1.3.0 → 1.4.0
graphrag_sdk/src/graphrag_sdk/__init__.py	__version__ 1.2.0 → 1.4.0

Note on __version__

__version__ was left at 1.2.0 when 1.3.0 was cut, so the 1.3.0 release reported a stale version through __version__ and the API's /version endpoint. Fixed here and logged under Fixed. The existing test_version only regex-checks for a 1.x shape, which is why it never caught the drift — worth pinning it to pyproject.toml in a follow-up.

Not included

• feat(resolution): IncrementalResolution — graph-aware entity linking #278 (IncrementalResolution) — conflicting with main and has requested changes outstanding; it lands in a later release.
• docs: update GraphRAG-Bench results and correct averaging method #291 — docs-only benchmark refresh, no changelog entry.

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features
  • Added chunk-level extraction caching to speed up updates and avoid redundant processing.
• Bug Fixes
  • Improved database error handling and clearer distinction between unavailable servers and other failures.
  • Expanded detection of permanent database errors.
• Documentation
  • Added release documentation for the new caching and database behavior.
• Chores
  • Updated the package version to 1.4.0.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8f17b63f-8f26-498d-ae2e-860bcb8faa84

📥 Commits

Reviewing files that changed from the base of the PR and between 586cb37 and 4da4c18.

📒 Files selected for processing (3)

• CHANGELOG.md
• graphrag_sdk/pyproject.toml
• graphrag_sdk/src/graphrag_sdk/__init__.py

---

📝 Walkthrough

Walkthrough

The release updates the project and package versions to 1.4.0. The changelog documents extraction caching, database error handling, and the corrected reported version.

Changes

1.4.0 release

Layer / File(s)	Summary
Version declarations and release notes graphrag_sdk/pyproject.toml, graphrag_sdk/src/graphrag_sdk/__init__.py, CHANGELOG.md	The project version and graphrag_sdk.__version__ now use 1.4.0. The changelog documents the release changes and corrected version reporting.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

• FalkorDB/GraphRAG-SDK#246: Both changes update package versions and changelog entries.
• FalkorDB/GraphRAG-SDK#272: Both changes prepare a release with version and changelog updates.

Suggested reviewers: naseem77

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the release preparation and matches the version, changelog, and package updates.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/release-v1.4.0

---

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.}