fux-engine 3.0.0-alpha.9 → 4.0.0

package/README.md

@@ -75,9 +75,12 @@ it, and the two are held byte-equal by a differential law.**
   generated file, so a fux upgrade is a one-file diff and a tampered reader is
   detectable by rebuilding it. Before 2026-09-12 it was 47 of fux's own `.mjs`
   files in your tree; `fux setup` deletes them when it upgrades you.
-- **It never writes and never fetches.** `ingest`, `build`, `add`, `enrich`
-  and every other write verb belongs to Python fux, and typing one here tells
-  you so rather than saying *unknown command*.
+- **It never fetches, and it writes one thing: the derived plane.** `fux
+  build` rebuilds the gitignored `.fux/runtime/` from the committed index,
+  byte-identical to Python's build, under the same write lock, and `--fast`
+  then answers from it. `ingest`, `add`, `enrich` and every other write verb
+  belongs to Python fux, and typing one here tells you so rather than saying
+  *unknown command*.
 - **Same answers as Python.** Same ids, same order, same locators, same band;
   scores equal after `round(9)`, which is the sort key's own resolution.
 - **Two things it deliberately does not do.** It cannot read a document that

package/mcp-tools.json

@@ -28,7 +28,7 @@
     },
     {
       "name": "fux_passage",
-      "description": "Read the verbatim text of a cited span, addressed as returned by fux_search. Use this instead of reading a whole file when you already have a citation: it returns only the cited lines and the hash they were read at.",
+      "description": "Read the verbatim text of a cited span, addressed as returned by fux_search. Use this instead of reading a whole file when you already have a citation: it returns only the cited lines and the hash they were read at, as `path`, `line_start`, `line_end`, `sha` and `text`.",
       "inputSchema": {
         "type": "object",
         "properties": {
@@ -49,7 +49,7 @@
     },
     {
       "name": "fux_related",
-      "description": "The neighbourhood around a document: what it links to, what links to it, what it supersedes or is superseded by, and whether it is archived. Use when a result raises 'what else was decided with this?'",
+      "description": "The neighbourhood around a document: what it links to, what links to it, what it supersedes or is superseded by, and whether it is archived. Use when a result raises 'what else was decided with this?' It returns `path`, `title`, `archived`, `superseded`, `outbound` and `inbound`.",
       "inputSchema": {
         "type": "object",
         "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fux-engine",
-  "version": "3.0.0-alpha.9",
+  "version": "4.0.0",
   "description": "Read a fux index from Node. Ranked, cited answers from a small index committed to git — no server, no model, no Python.",
   "type": "module",
   "engines": { "node": ">=22" },