neat.is 0.2.5 → 0.2.7

package/README.md

@@ -2,15 +2,26 @@
 
 NEAT keeps a live semantic graph of a software system — code, infrastructure, runtime — and exposes it to AI agents over MCP.
 
+## Prerequisites
+
+- **Node.js 20 or newer.** Enforced via `engines`; older versions fail at install.
+- **A C toolchain**, because `@neat.is/core` builds native bindings for `tree-sitter` (JS, TS, Python parsers) at install time:
+  - macOS: Xcode Command Line Tools (`xcode-select --install`)
+  - Debian/Ubuntu: `build-essential` plus `python3` (for `node-gyp`)
+  - Alpine: `build-base python3`
+  - Windows: Visual Studio Build Tools with the "Desktop development with C++" workload
+
+If `npm install -g neat.is` fails partway through with a `gyp` error, the toolchain is the cause. Install it and re-run.
+
 ## Install
 
 ```bash
 npm install -g neat.is
 ```
 
-That gives you three binaries:
+That puts three binaries on your PATH:
 
-- `neat` — CLI (init, watch, list, skill, etc.)
+- `neat` — CLI (init, watch, list, skill, plus the nine query verbs that mirror the MCP tool surface)
 - `neatd` — daemon (start, stop, status, reload)
 - `neat-mcp` — MCP stdio server for Claude Code and other agents
 
@@ -21,7 +32,7 @@ neat init /path/to/your/repo --project myrepo
 neatd start
 ```
 
-Snapshot lands at `<repo>/neat-out/myrepo.json`. The daemon watches for file changes and OTel traces and keeps the graph live.
+Snapshot lands at `<repo>/neat-out/myrepo.json`. The daemon watches for file changes and OTel traces (`:4318` HTTP by default) and keeps the graph live.
 
 ## What's in the box
 

package/bin/neat

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// Bin shim — `npm install -g neat.is` puts this on PATH as `neat`.
+// argv[1] ends in `/neat`, which @neat.is/core/dist/cli.cjs's existing
+// entry detection already matches; requiring the file is enough to fire main().
+require('@neat.is/core/dist/cli.cjs')

package/bin/neat-mcp

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// Bin shim — `npm install -g neat.is` puts this on PATH as `neat-mcp`.
+// @neat.is/mcp/dist/index.cjs unconditionally calls main() at module load,
+// so requiring it fires the stdio MCP server.
+require('@neat.is/mcp/dist/index.cjs')

package/bin/neatd

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// Bin shim — `npm install -g neat.is` puts this on PATH as `neatd`.
+// argv[1] ends in `/neatd`, which @neat.is/core/dist/neatd.cjs's existing
+// entry detection already matches; requiring the file is enough to fire main().
+require('@neat.is/core/dist/neatd.cjs')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neat.is",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "NEAT — live semantic graph of a software system, queryable from AI agents over MCP. Install once, get the neat / neatd / neat-mcp CLIs.",
   "license": "BUSL-1.1",
   "homepage": "https://neat.is",
@@ -12,10 +12,18 @@
   "publishConfig": {
     "access": "public"
   },
-  "files": ["README.md"],
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "neat": "./bin/neat",
+    "neatd": "./bin/neatd",
+    "neat-mcp": "./bin/neat-mcp"
+  },
+  "files": ["bin", "README.md"],
   "dependencies": {
-    "@neat.is/core": "^0.2.5",
-    "@neat.is/mcp": "^0.2.5",
-    "@neat.is/claude-skill": "^0.2.5"
+    "@neat.is/core": "^0.2.7",
+    "@neat.is/mcp": "^0.2.7",
+    "@neat.is/claude-skill": "^0.2.7"
   }
 }