Releases: wchiway/contextweaver-mcp
v1.5.4
ContextWeaver v1.5.4
ContextWeaver v1.5.4 Stable Release
Highlights
- New
configcommand – manage environment variables directly from the CLI. - Dependency vulnerability fixes – updated package dependencies to reduce security risks.
- Documentation – added status badges to README (npm, stars, MCP Bridge, VS Code install).
Upgrade Notes
- If you encounter package specifier mismatches, regenerate your lockfile (
pnpm installor equivalent).
Installation Notes
- Install or update via npm/pnpm as usual. No breaking changes in this release.
Risk Notes
- This release includes minor security patches; upgrading is recommended but low risk.
- The MCP Registry publishing step has been removed from the prerelease workflow (CI change, no user impact).
Installation
npm install -g @chiway/contextweaver
# or
pnpm add -g @chiway/contextweaverWhat's Changed
New Contributors
Full Changelog: v1.5.3...v1.5.4
v1.6.0-alpha.1
ContextWeaver v1.6.0-alpha.1 prerelease
ContextWeaver v1.6.0-alpha.1 Prerelease Changelog
Highlights
- Native decodeBytes integration:
readFileWithEncodingnow routes through the RustdecodeBytesNAPI port, enabling faster and consistent file decoding. - Native import extraction: Import extraction in resolvers now uses the new Rust
extractImportsregex port, improving performance for large codebases. - Differential tests: Added TypeScript/Rust differential tests for both
decodeBytesand import extraction to validate correctness against the existing implementation. - Internal cleanup: Fixed a Clippy lint (
manual_contains) in the chunker; no user-facing change.
Risk Notes
- New native module: This alpha release introduces a Rust-native NAPI addon. Node-gyp scripts have been explicitly skipped, but platform compatibility should be verified (see testing instructions).
- Behavioral changes: Routing existing functions through the Rust layer may introduce subtle differences in encoding handling or import parsing. Differential tests help mitigate this, but edge cases may emerge.
- Prerelease stability: As an alpha, further breaking changes or reworks are expected. Not recommended for production use.
Testing (local tarball)
- Download the tarball from the GitHub release assets (e.g.,
contextweaver-v1.6.0-alpha.1.tar.gz). - Install in your project:
npm install /path/to/contextweaver-v1.6.0-alpha.1.tar.gz
- Run the test suite (requires Rust toolchain if building from source, but tarball includes prebuilt binary for supported platforms):
npm test - Focus on differential tests to confirm native vs. JavaScript parity:
npx mocha test/encoding/decodeBytes.differential.test.ts test/resolvers/importExtract.differential.test.ts
- Report any issues on the repository with the tag
v1.6.0-alpha.1.
Local npm package
Download the attached main tarball plus the chunker tarball matching your platform, then install:
npm install -g ./chiway-contextweaver-1.6.0-alpha.1.tgzNative chunker is optional — without the matching platform tarball it falls back to the TypeScript path.
This prerelease does not publish to npm.
Full Changelog: v1.6.0-alpha.0...v1.6.0-alpha.1
v1.6.0-alpha.0
ContextWeaver v1.6.0-alpha.0 prerelease
ContextWeaver v1.6.0-alpha.0 Prerelease Changelog
✨ Highlights
- Native Rust chunker: The tokenization and chunking layer has been migrated to a Rust core via
napi-rs, with a TypeScript fallback for platforms without a prebuilt binary. This improves performance and reduces memory usage. - Semantic indexing fixes: References are now correctly filtered out in
treeSitterTags, andend_linehas been added to thesemantic_symbolsprimary key to prevent duplicate symbol entries. - CI & build improvements: Cross‑compilation for macOS x64 is now done on arm64 runners, and the lockfile has been regenerated to match the package.json specifier. The MCP Registry publishing step has been removed from prerelease workflows.
🔧 What's Changed
feat(chunker): migrate chunking layer to Rust napi-rs core with TS fallbackfix(semantic): filter out references in treeSitterTagsfix(db): add end_line to semantic_symbols primary keyfix: regenerate lockfile to match package.json specifierfix: resolve 1.5.3 release blockersci(release): build native chunker across platforms with staged publishci: cross-compile darwin-x64 on arm64 macOS runnerci: remove MCP Registry publishing step from prerelease workflowtest(mcp): restore getSymbolDefinition tests via db injectiondocs: document native Rust chunker and prebuild install behaviordocs: add badges to READMEchore: bump version to 1.6.0-alpha.0
⚠️ Known Risks / Notes
- This is an alpha release – the Rust chunker is new and may have platform coverage gaps. The TS fallback will be used on unsupported platforms, but performance differences may be observed.
- The MCP Registry publishing step has been removed; the prerelease build will not publish to the MCP Registry automatically.
- Lockfile was regenerated due to specifier changes; if you use a monorepo or strict lockfile management, please re‑run
pnpm installlocally.
🧪 Local Testing (tarball)
To test this prerelease locally, run the following commands from your project root:
# 1. Build the tarball
pnpm pack
# 2. Install the tarball in a test project
cd /path/to/test/project
pnpm add /path/to/context-weaver-1.6.0-alpha.0.tgzThen verify:
- Semantic tag generation works as expected.
- Chunking runs correctly on your documents (both supported and fallback cases).
- No duplicate
semantic_symbolsentries appear on repeated indexing.
Please report any issues via GitHub Issues with the label v1.6.0-alpha.
Local npm package
Download the attached main tarball plus the chunker tarball matching your platform, then install:
npm install -g ./chiway-contextweaver-1.6.0-alpha.0.tgzNative chunker is optional — without the matching platform tarball it falls back to the TypeScript path.
This prerelease does not publish to npm.
Full Changelog: v1.5.3-rc.0...v1.6.0-alpha.0
v1.5.3
ContextWeaver v1.5.3
ContextWeaver v1.5.3 Stable Release
Highlights
- Fixed database schema: Added
end_lineto thesemantic_symbolsprimary key, improving data integrity for semantic symbol tracking. - Improved semantic analysis: Tree-sitter tags now correctly filter out references, reducing noise in symbol resolution.
- Resolved release blockers: All known issues from the release candidate (v1.5.3-rc.0) have been fixed, ensuring a stable release.
- CI and publishing enhancements: MCP Registry publishing now uses GitHub OIDC authentication for more secure and streamlined workflows.
Upgrade Notes
- Database migration required: The
semantic_symbolstable primary key has been updated. Run the appropriate migration script or recreate the table to avoid uniqueness conflicts. - Semantic results may change: The fix to filter out references in tree-sitter tags may alter the output of
getSymbolDefinitionand related functions. Verify expected behavior after upgrade.
Installation
- Source: Clone from the main branch at tag
v1.5.3. - Docker: Pull
contextweaver/contextweaver:1.5.3(if published). - MCP Registry: The MCP package is now published using OIDC authentication; ensure your client supports the updated registration flow.
Risk Notes
- Primary key change: If your deployment relies on direct database access or custom queries on
semantic_symbols, review and update queries to includeend_line. A full backup is recommended before applying the migration. - Reference filtering: Applications that depend on including references in tree-sitter tag results may see reduced data. Test thoroughly to confirm this change aligns with your use case.
- Minimal risk: All other changes are non-breaking (CI, documentation, tests). No API or config file changes are introduced.
Installation
npm install -g @chiway/contextweaver
# or
pnpm add -g @chiway/contextweaverFull Changelog: v1.5.2...v1.5.3
v1.5.3-rc.0
ContextWeaver v1.5.3-rc.0 prerelease
Prerelease Changelog: ContextWeaver v1.5.3-rc.0
Highlights
- Homepage URL updated to contextweaver.work.
- Added
mcpNamefield for improved MCP registry verification.
No user-facing feature changes are included in this release candidate.
Risk Notes
- Low risk: this release candidate only contains internal metadata updates (version bump, homepage change, and registry field addition).
- Verify that the new
mcpNamedoes not break existing MCP registration flows. - Confirm the homepage URL redirects correctly in all embedded contexts.
Local Tarball Testing Instructions
- Download the tarball from the release artifacts or build locally.
- Extract and install:
tar -xzf contextweaver-1.5.3-rc.0.tar.gz cd contextweaver-1.5.3-rc.0 # Follow installation instructions in README
- Test core functionality:
- Ensure MCP registration completes without errors.
- Click the homepage link in the UI or CLI help to verify the new URL.
- Run the existing test suite:
make test - Report any issues in the repository’s issue tracker.
Local npm package
Download the attached tarball or workflow artifact, then install it locally:
npm install -g ./chiway-contextweaver-1.5.3-rc.0.tgzThis prerelease does not publish to npm.
Full Changelog: v1.5.3-beta.1...v1.5.3-rc.0
v1.5.3-beta.1
ContextWeaver v1.5.3-beta.1 prerelease
ContextWeaver v1.5.3-beta.1 Prerelease Changelog
Highlights
- Semantic edges and list-symbols MCP tool – Added a new MCP tool
list-symbolsthat returns semantic edges, enabling richer symbol relationship queries. - Tree-sitter tags symbol extraction – Integrated tree-sitter tags for symbol extraction, improving the depth and accuracy of symbol identification in source code.
Risk Notes
- This is a beta release; new MCP tool and symbol extraction changes may have unforeseen interactions with existing features.
- The symbol extraction backend has been swapped to tree-sitter tags; verify that existing symbol queries continue to work as expected.
- The two tree-sitter commits appear to be identical; if this is a duplicate, only one change was applied.
Local Tarball Testing Instructions
- Download the tarball from the release artifacts (e.g.,
contextweaver-v1.5.3-beta.1.tar.gz). - Extract and install locally:
tar -xzf contextweaver-v1.5.3-beta.1.tar.gz cd contextweaver-v1.5.3-beta.1 npm install # or python setup.py install, etc.
- Start ContextWeaver and test the new
list-symbolsMCP tool with a sample codebase. - Run existing symbol extraction tests to verify no regressions.
- Report any issues via the project’s issue tracker.
Local npm package
Download the attached tarball or workflow artifact, then install it locally:
npm install -g ./chiway-contextweaver-1.5.3-beta.1.tgzThis prerelease does not publish to npm.
Full Changelog: v1.5.3-beta.0...v1.5.3-beta.1
v1.5.3-beta.0
ContextWeaver v1.5.3-beta.0 prerelease
ContextWeaver v1.5.3-beta.0 Prerelease Changelog
Highlights
- Feature: Parser enrichment layers – Added enrichment layers to the parser, allowing additional data transformation and augmentation during parsing. This is a new user-facing capability.
Internal Changes
- CI: Added prerelease workflow, build tarball and changelog generation, and integrated AI changelog into the release workflow.
- Version bump to 1.5.3-beta.0 (no user impact).
Risk Notes
- The new parser enrichment layers may alter existing parsing behavior. Test edge cases with custom enrichment configurations to ensure compatibility with your current data pipelines.
Local Tarball Testing Instructions
- Download the prerelease tarball from the release artifacts (e.g.,
contextweaver-1.5.3-beta.0.tar.gz). - Extract and install locally:
tar -xzf contextweaver-1.5.3-beta.0.tar.gz cd contextweaver-1.5.3-beta.0 pip install . - Run your existing tests or a sample enrichment pipeline:
contextweaver --help # or run test suite pytest tests/ - Report any regressions or unexpected behavior in the GitHub issues tracker.
Local npm package
Download the attached tarball or workflow artifact, then install it locally:
npm install -g ./chiway-contextweaver-1.5.3-beta.0.tgzThis prerelease does not publish to npm.
Full Changelog: v1.5.3-alpha.0...v1.5.3-beta.0
v1.5.3-alpha.0
ContextWeaver v1.5.3-alpha.0 prerelease
ContextWeaver v1.5.3-alpha.0 Prerelease Changelog
Highlights
- Vector manifest consistency guard – Added a safety check that ensures vector manifest data remains consistent during operations, reducing the risk of silent data corruption.
- New
updatecommand – Introduced a command to update existing resources, providing a more complete CLI interface.
Risk Notes
- The new consistency guard may reject previously accepted manifests that are now considered inconsistent. Review any existing vector manifest workflows before deploying this alpha.
- The
updatecommand is newly introduced and has not been widely tested; behaviour may change in subsequent releases.
Local Tarball Testing
- Download the tarball from the GitHub releases page.
- Extract:
tar -xzf contextweaver-v1.5.3-alpha.0.tar.gz - Install:
cd contextweaver-v1.5.3-alpha.0 && pip install . - Verify version:
contextweaver --versionshould printv1.5.3-alpha.0. - Test new features:
- Run
contextweaver update --helpto see the new command options. - Run
contextweaver vector manifest --checkto trigger the consistency guard.
- Run
Local npm package
Download the attached tarball or workflow artifact, then install it locally:
npm install -g ./chiway-contextweaver-1.5.3-alpha.0.tgzThis prerelease does not publish to npm.
Full Changelog: v1.5.2...v1.5.3-alpha.0
v1.5.2
🚀 ContextWeaver v1.5.2
Installation
npm install -g @chiway/contextweaver
# or
pnpm add -g @chiway/contextweaverFull Changelog: v1.5.1...v1.5.2
v1.5.1
🚀 ContextWeaver v1.5.1
Installation
npm install -g @chiway/contextweaver
# or
pnpm add -g @chiway/contextweaverFull Changelog: v1.5.0...v1.5.1