Skip to content

Fix stale package name references after rename to graphrag-lexical-graph (#175)#182

Open
mykola-pereyma wants to merge 2 commits intoawslabs:mainfrom
mykola-pereyma:fix/issue-175-notebook-version-url
Open

Fix stale package name references after rename to graphrag-lexical-graph (#175)#182
mykola-pereyma wants to merge 2 commits intoawslabs:mainfrom
mykola-pereyma:fix/issue-175-notebook-version-url

Conversation

@mykola-pereyma
Copy link
Copy Markdown
Contributor

Summary

Fixes #175

The package was renamed from graphrag-toolkit-lexical-graph to graphrag-lexical-graph in v3.18.0, but several references were not updated.

Changes

Bug fix: version() calls use old package name (runtime impact)

  • neptune_graph_stores.py: version('graphrag-toolkit-lexical-graph') always raises PackageNotFoundError, causing toolkit_version to silently default to 'unknown' and the user-agent string to report incorrect identity
  • traversal_based_base_retriever.py: same issue — retriever version reporting always empty

Both now use version('graphrag-lexical-graph').

Cleanup: dead version-rewriting steps in release workflow

  • The release workflow had regex steps to rewrite pip install URLs in notebooks before zipping. Since Update notebook to use pypi #180 switched notebooks to PyPI installs, these steps are dead code and will fail (nothing to match). Removed.

Fix: stale references in docs

  • examples/lexical-graph/README.md: download URL referenced lexical-graph-examples.zip but the release workflow only produces lexical-graph-examples-latest.zip
  • examples/lexical-graph-local-dev/docs/troubleshooting.md: pip uninstall command used old package name

Root cause of #175

The issue reporter observed that CloudFormation-deployed notebooks with v3.18.2 content fail while v3.17.1 works. The underlying cause: when the tag format changed from v3.17.1 to graphrag-lexical-graph/v3.18.2, the release workflow's regex produced archive URLs like /refs/tags/v3.18.2.zip (404) instead of /refs/tags/graphrag-lexical-graph/v3.18.2.zip (200). This was resolved by #180 switching to PyPI installs, making the URL rewriting unnecessary. This PR removes the now-dead workflow steps and fixes the remaining stale references.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

version('graphrag-toolkit-lexical-graph') always raises PackageNotFoundError
since the package was renamed to graphrag-lexical-graph in v3.18.0.
This causes toolkit_version to silently default to 'unknown'/empty,
breaking user-agent tracking and retriever version reporting.

Fixes awslabs#175
The release workflow had regex steps to rewrite pip install URLs in
notebooks before zipping. Since notebooks now install from PyPI (awslabs#180),
these steps are dead code. Also fixes:
- examples/lexical-graph/README.md: broken zip filename (missing -latest)
- troubleshooting.md: old package name in uninstall command
Copy link
Copy Markdown
Collaborator

@acarbonetto acarbonetto left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CloudFormation Content Version Issue

2 participants