Improve v1.0.2 performance and reliability

CHANGELOG.md

@@ -3,6 +3,29 @@
 All notable public changes to Code System Graph are documented in this file. Code System Graph follows Semantic
 Versioning.
 
+## [1.0.2] - 2026-08-05
+
+### Performance and reliability
+
+- Made `csgraph sync` inspect structured CodeGraph status before invoking the provider, report
+  changed and unchanged indexes separately, and reuse the current graph snapshot when neither
+  native inputs nor CodeGraph indexes changed.
+- Grouped CodeGraph corroboration inputs in one pass, bounded and deduplicated queries
+  deterministically, and limited focused scans to the selected repository.
+- Released the previous graph before snapshot staging and verified incremental behavior with a
+  100-repository synthetic release workload and a representative large-repository workload.
+- Turned ambiguous HTTP providers into deterministic scan degradations so unrelated links still
+  resolve and exact manual relationships can disambiguate the intended provider.
+- Replaced raw worker parser failures with bounded, secret-safe diagnostics that retain actionable
+  workspace, repository, configuration, and contract context.
+
+### Documentation
+
+- Documented workspace-scoped Cursor MCP configuration, including restart and enablement checks,
+  without requiring a separate CodeGraph installation.
+- Added troubleshooting guidance for Cursor setup and per-value extraction budget failures,
+  including a concrete `maxStringBytesPerValue` example.
+
 ## [1.0.1] - 2026-08-04
 
 ### Fixed

Cargo.toml

@@ -4,16 +4,16 @@ default-members = ["crates/*"]
 resolver = "3"
 
 [workspace.package]
-version = "1.0.1"
+version = "1.0.2"
 edition = "2024"
 rust-version = "1.97.1"
-description = "Local system-level code intelligence across repositories."
+description = "Local cross-repository code intelligence and dependency graph for impact analysis and AI coding agents."
 license = "Apache-2.0"
 repository = "https://github.com/dertin/code-system-graph"
 homepage = "https://github.com/dertin/code-system-graph"
 readme = "README.md"
-keywords = ["code-intelligence", "static-analysis", "impact-analysis", "mcp", "monorepo"]
-categories = ["development-tools"]
+keywords = ["code-intelligence", "static-analysis", "impact-analysis", "mcp", "dependency-graph"]
+categories = ["development-tools", "command-line-utilities"]
 
 [workspace.lints.rust]
 future_incompatible = { level = "warn", priority = -1 }

README.md

@@ -2,12 +2,14 @@
 
 # Code System Graph
 
-**System-level code intelligence across repositories**
+**Open-source cross-repository code intelligence, dependency mapping, and impact analysis for AI
+coding agents**
 
-Understand what connects your repositories and what a change could break before you ship it.
+Map APIs, events, schemas, packages, databases, and ownership across repositories before a change
+breaks another service.
 
 [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
-![Source version](https://img.shields.io/badge/source-v1.0.1-orange.svg)
+![Source version](https://img.shields.io/badge/source-v1.0.2-orange.svg)
 [![crates.io](https://img.shields.io/crates/v/code-system-graph.svg)](https://crates.io/crates/code-system-graph)
 ![Platforms](https://img.shields.io/badge/validated-Linux%20%7C%20macOS%20%7C%20Windows-1793d1.svg)
 ![Privacy](https://img.shields.io/badge/privacy-local%20%7C%20no%20telemetry-2ea44f.svg)
@@ -22,10 +24,11 @@ Claude Code | Codex | Gemini CLI | Antigravity | Cursor
 
 </div>
 
-Code System Graph builds a local, evidence-backed map of the boundaries between repositories:
-APIs, events, schemas, packages, databases, deployments, tests, owners, and documentation. Your
-coding agent can then answer system-level questions that are difficult to solve by searching one
-repository at a time.
+Code System Graph is a local-first static analysis and system architecture tool that builds an
+evidence-backed dependency graph across repositories. It connects APIs, events, schemas, packages,
+databases, deployments, tests, owners, and documentation, then exposes that context to AI coding
+agents through the Model Context Protocol (MCP). Agents can answer system-level questions that are
+difficult to solve by searching one repository at a time.
 
 ## What problem does it solve?
 
@@ -279,6 +282,11 @@ configuration format; optional routing hooks are a separate step. Follow
 [Connect an agent](docs/AGENT_SETUP.md) for exact commands, configuration files, verification, and
 limitations.
 
+For Cursor, keep the entry in `<workspace>/.cursor/mcp.json`; an absolute database path does not
+make a global MCP entry workspace-scoped. Reload Cursor and enable the server after changing the
+file. `csgraph mcp --codegraph` starts CodeGraph itself, so a separate `codegraph install` entry is
+unnecessary.
+
 You can now ask the agent:
 
 ```text
@@ -383,7 +391,7 @@ non-loopback HTTP access.
 - [Use CodeGraph with every repository in a workspace](docs/CODEGRAPH_INTEGRATION.md)
 - [Connect Claude Code, Codex, Gemini, Antigravity, or Cursor](docs/AGENT_SETUP.md)
 - [CLI reference](docs/CLI.md)
-- [Troubleshooting with `doctor`](docs/GETTING_STARTED.md#troubleshooting)
+- [Troubleshooting](docs/TROUBLESHOOTING.md)
 
 ### Analysis guides
 

crates/code-system-graph-cli/Cargo.toml

@@ -30,10 +30,10 @@ atomic-write-file = "0.3.0"
 axum = "0.8.9"
 clap = { version = "4.6.4", features = ["derive"] }
 clap_complete = "4.6.8"
-code-system-graph-core = { version = "1.0.1", path = "../code-system-graph-core" }
-code-system-graph-hooks = { version = "1.0.1", path = "../code-system-graph-hooks" }
-code-system-graph-model = { version = "1.0.1", path = "../code-system-graph-model" }
-code-system-graph-store-sqlite = { version = "1.0.1", path = "../code-system-graph-store-sqlite" }
+code-system-graph-core = { version = "1.0.2", path = "../code-system-graph-core" }
+code-system-graph-hooks = { version = "1.0.2", path = "../code-system-graph-hooks" }
+code-system-graph-model = { version = "1.0.2", path = "../code-system-graph-model" }
+code-system-graph-store-sqlite = { version = "1.0.2", path = "../code-system-graph-store-sqlite" }
 rmcp = { version = "3.1.0", features = ["transport-io"] }
 notify = "8.2.0"
 rusqlite = { version = "0.40.1", features = ["bundled"] }