@ataraxy-labs/sem 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to sem are documented in this file.
+
+## [Unreleased]
+
+## [0.11.0] - 2026-06-14
+
+### Added
+
+- Progress spinner for slow graph builds. `sem graph` and `sem context` now show a uv-style spinner and a summary line (e.g. `135,298 entities, 7,743 files in 6.6s`) while building the entity graph. Strictly stderr and TTY-only, so pipes, JSON, and agent/MCP sessions are unaffected. Disable with SEM_NO_PROGRESS=1.
+
+- SQL support (`.sql`, `.psql`, `.pgsql`, `.ddl`) via the official DerekStride/tree-sitter-sql grammar. Extracts tables, views, materialized views, functions, indexes, types, schemas, triggers, sequences, and databases. Thanks @robahtou for the request (#339).
+- Start tracking project changes in `CHANGELOG.md`.
+- Add a pull request check that asks contributors to include a changelog entry.
+- `sem entities` accepts multiple file or directory path arguments.
+
+### Changed
+
+- Sparse checkouts now work. libgit2 cannot read a sparse index (`unsupported mandatory extension: 'sdir'`) and its workdir diff reported sparse-excluded files as deleted; sem now routes working and staged diffs through the git CLI when a sparse checkout is detected. Thanks for the report (#330).
+
+- README now documents adding the MCP server to coding agents (`claude mcp add sem -- sem mcp`) and explains why `sem mcp` exists. The old section pointed at a separate `sem-mcp` binary; `sem mcp` ships in the main binary.
+
+- `sem stats` now counts every diff, including runs that find no changes (previously those returned early and were never recorded, so `diffs performed` undercounted).
+
+- Telemetry no longer records development builds (debug builds, or binaries run from a Cargo `target/` directory), so contributor and CI-of-our-own usage stays out of the numbers.
+
+- Cloud sync only auto-registers repos that GitHub confirms are public. Private repos run locally unless you opt in with `SEM_SYNC_PRIVATE=1`.
+- `install.sh` verifies the release archive against `checksums.txt` before installing.
+- Switched the Perl grammar to the official `ts-parser-perl` crate (was the unattributed `tree-sitter-perl-next` copy). Properly attributed, correctly MIT-licensed, and includes upstream fixes: an infinite-loop hang on malformed input, better error recovery, and faster parsing. Thanks @rabbiveesh for the report (#355).
+
+### Removed
+
+- `sem verify` (function call-arity checker). It saw negligible use and overlapped with compilers/LSPs; removing it keeps the surface area focused.

package/README.md

@@ -19,7 +19,7 @@
   <a href="https://ataraxy-labs.com/blogs/code-is-not-text">Why sem?</a> ·
   <a href="#install">Install</a> ·
   <a href="#commands">Commands</a> ·
-  <a href="#mcp-server">MCP Server</a> ·
+  <a href="#use-with-ai-agents-mcp">Agents (MCP)</a> ·
   <a href="https://github.com/Ataraxy-Labs/sem/releases/latest">Releases</a>
 </p>
 
@@ -64,6 +64,12 @@ bun add -d @ataraxy-labs/sem
 bun pm trust @ataraxy-labs/sem
 ```
 
+Once installed, update to the latest release any time:
+
+```bash
+sem update
+```
+
 Or build from source (requires Rust):
 
 ```bash
@@ -289,6 +295,7 @@ sem unsetup
 | Clojure | `.clj` `.cljs` `.cljc` | vars, functions, macros, multimethods, protocols, records, types |
 | D | `.d` `.di` | modules, functions, classes, structs, interfaces, unions, enums, templates, aliases, unittests |
 | Zig | `.zig` | functions, tests, variables |
+| SQL | `.sql` `.psql` `.pgsql` `.ddl` | tables, views, functions, indexes, types, schemas, triggers, sequences |
 
 Plus structured data formats:
 
@@ -327,26 +334,34 @@ Three-phase entity matching:
 
 This means sem detects renames and moves, not just additions and deletions. Structural hashing also distinguishes cosmetic changes (whitespace, formatting) from real logic changes.
 
-## MCP Server
+## Use with AI agents (MCP)
+
+`sem mcp` starts a [Model Context Protocol](https://modelcontextprotocol.io) server over stdin/stdout. It's not a command you run and read yourself: it's a server your coding agent launches in the background so it can ask sem questions while it works. That's the reason `mcp` lives alongside the normal commands. The agent gets 6 tools, all entity-level: `sem_impact`, `sem_context`, `sem_diff`, `sem_entities`, `sem_blame`, `sem_log`.
+
+Why an agent wants these: instead of reading whole files and burning tokens, it can ask "what breaks if I change `submitOrder`" (`sem_impact`) or "give me just the context to refactor this function" (`sem_context`) and get a precise answer from the dependency graph.
+
+Add it once, then talk to your agent normally. It calls the tools on its own.
 
-sem includes an MCP server with 6 tools for AI agents: `sem_entities`, `sem_diff`, `sem_blame`, `sem_impact`, `sem_log`, `sem_context`. These mirror the CLI commands exactly.
+**Claude Code:**
+
+```bash
+claude mcp add sem -- sem mcp
+```
+
+**Cursor, Claude Desktop, or any client with an `mcpServers` config:**
 
 ```json
 {
   "mcpServers": {
     "sem": {
-      "command": "sem-mcp"
+      "command": "sem",
+      "args": ["mcp"]
     }
   }
 }
 ```
 
-Install the MCP binary:
-
-```bash
-cd sem/crates
-cargo install --path sem-mcp
-```
+If `sem` isn't on the agent's PATH, use the absolute path to the binary. No separate install is needed: `sem mcp` ships in the same binary as every other command.
 
 ## JSON output
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ataraxy-labs/sem",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "npm wrapper for the sem CLI. Downloads the matching release binary and exposes the sem command in node_modules/.bin.",
   "license": "MIT OR Apache-2.0",
   "type": "module",
@@ -14,6 +14,7 @@
     "scripts/verify-checksum.mjs",
     "scripts/sync-package-version.mjs",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE-APACHE",
     "LICENSE-MIT"
   ],