@kentwynn/kgraph 0.2.1 → 0.2.2

package/README.md

@@ -74,6 +74,8 @@ That shows matched files/symbols, files importing the target, known callers/call
 
 ## Install
 
+The official npm package is `@kentwynn/kgraph`; the official repository is `github.com/kentwynn/KGraph`.
+
 Use the published CLI:
 
 ```bash
@@ -90,6 +92,8 @@ npx @kentwynn/kgraph@latest "auth token refresh"
 
 KGraph requires Node.js 20 or newer.
 
+KGraph's core functionality is free and local-first. It does not require accounts, telemetry, cloud services, API keys, or source-code upload.
+
 ## Quick Start
 
 From the root of a repository:
@@ -302,7 +306,7 @@ All runtime data lives under `.kgraph/`:
 └── context/
 ```
 
-The files are local, inspectable, and human-readable. There is no database, telemetry, cloud service, account, API key, embedding service, or model provider.
+The files are local, inspectable, and human-readable. Core KGraph functionality is free. There is no database, telemetry, cloud service, account, API key, embedding service, model provider, or source-code upload.
 
 ## Language Support
 
@@ -371,14 +375,25 @@ npm run release:pack
 
 ## Release
 
-Releases are tag-driven:
+Releases are PR-first because `main` is protected. Use the Makefile helper to bump the version on a release branch, push it, and open a pull request when the GitHub CLI is available:
+
+```bash
+make release
+```
+
+Use `RELEASE=minor` or `RELEASE=major` when needed:
+
+```bash
+make release RELEASE=minor
+```
+
+After the PR is merged, tag the merged commit from an up-to-date `main`:
 
 ```bash
-npm version patch
-git push origin main --follow-tags
+make release-tag VERSION=v0.2.2
 ```
 
-The release workflow builds, tests, packs, publishes the npm package on version tags, creates a GitHub Release, and uploads the tarball artifact.
+The release workflow builds, tests, packs, publishes the npm package on version tags, creates a GitHub Release, and uploads the tarball artifact. Do not push directly to `main` for releases.
 
 ## Design Principles
 
@@ -391,8 +406,9 @@ The release workflow builds, tests, packs, publishes the npm package on version
 
 ## Roadmap
 
+- Better Git-aware token saving and diff context.
 - Smarter cross-file symbol and call relationship inference.
 - Stronger TypeScript path alias and package export resolution.
 - Richer graph filtering for large repositories.
-- Optional MCP server for editor tool-call access.
-- Team workflows for shared committed cognition.
+- Optional MCP and editor integration.
+- Team-friendly shared cognition workflows that stay local-first.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kentwynn/kgraph",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Persistent repo intelligence for AI coding assistants.",
   "type": "module",
   "bin": {