brevi 0.0.0-stage → 0.25.0

package/README.md

@@ -1,3 +1,32 @@
-# Temporary Holding Version
+# Brevi: fast, safe native builds of AI-written Python
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Brevi is a compiler built for AI coding agents. The agent writes the plain Python it already writes best; Brevi builds it through Rust into a native binary that prints exactly what CPython prints and runs 1.7x to 40x faster with the default build. Anything it cannot build comes back as one short JSON line the agent can act on.
+
+```
+npm install -g brevi     # or run it without installing: npx brevi mcp
+```
+
+The first run downloads the prebuilt `brevi` for your platform from the matching [GitHub release](https://github.com/ets-public/brevi/releases) into `~/.cache/brevi/VERSION`.
+
+```
+$ printf 'print(sum(i * i for i in range(10)))\n' > main.py
+$ brevi run main.py                     # build natively (cached), then run
+285
+$ brevi check main.py                   # build without running: errors only
+$ brevi build main.py -o app --release  # an optimised binary to keep or ship
+$ brevi mcp                             # MCP server for agents: check, run, test, patch, edit, show, guide
+```
+
+A sure mistake is reported before anything runs, as one line with a fix:
+
+```
+{"line":8,"msg":"name 'totl' is not defined","fix":"did you mean total?"}
+```
+
+Brevi compiles through `rustc`, so a Rust toolchain must be on the PATH ([rustup.rs](https://rustup.rs)).
+
+- **For agents:** add the MCP server as the command `brevi` with the argument `mcp` (Claude Code: `claude mcp add brevi -- brevi mcp`). Its tools sandbox by default. [For AI agents](https://brevi-lang.org/docs/agents)
+- **Same answers as CPython:** every saved agent program and large test program matches CPython's output and exit status. Imports of installed packages (numpy, pandas, requests, ...) work; most numpy code builds natively.
+- **Public preview:** Brevi works today and is tested against CPython on every change, but expect the CLI to change between releases.
+
+[Docs](https://brevi-lang.org/docs/) · [Source](https://github.com/ets-public/brevi) · [Changelog](https://github.com/ets-public/brevi/blob/main/CHANGELOG.md) · [Issues](https://github.com/ets-public/brevi/issues) · Apache-2.0

package/bin/brevi.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+// Runs the prebuilt brevi binary for this platform, fetching it from the GitHub release on first use.
+// The binary is kept in ~/.cache/brevi/VERSION/, so later runs start at once.
+const { spawnSync, execFileSync } = require("child_process");
+const fs = require("fs"), os = require("os"), path = require("path");
+const version = require("../package.json").version;
+const targets = {
+  "linux-x64": "x86_64-unknown-linux-gnu", "linux-arm64": "aarch64-unknown-linux-gnu",
+  "darwin-arm64": "aarch64-apple-darwin", "darwin-x64": "x86_64-apple-darwin", "win32-x64": "x86_64-pc-windows-msvc",
+};
+const target = targets[`${process.platform}-${process.arch}`];
+if (!target) {
+  console.log(JSON.stringify({ e: "install", msg: `no prebuilt brevi for ${process.platform}-${process.arch}`, fix: "cargo install --git https://github.com/ets-public/brevi" }));
+  process.exit(1);
+}
+const exe = process.platform === "win32" ? "brevi.exe" : "brevi";
+const dir = path.join(os.homedir(), ".cache", "brevi", version);
+const bin = path.join(dir, `brevi-${target}`, exe);
+if (!fs.existsSync(bin)) {
+  fs.mkdirSync(dir, { recursive: true });
+  const ext = process.platform === "win32" ? "zip" : "tar.gz";
+  const url = `https://github.com/ets-public/brevi/releases/download/v${version}/brevi-${target}.${ext}`;
+  const archive = path.join(dir, `brevi.${ext}`);
+  try {
+    execFileSync("curl", ["-fsSL", "-o", archive, url], { stdio: "inherit" });
+    execFileSync("tar", ["-xf", archive, "-C", dir], { stdio: "inherit" });
+  } catch (e) {
+    console.log(JSON.stringify({ e: "install", msg: `could not fetch ${url}`, fix: "check the network, or cargo install --git https://github.com/ets-public/brevi" }));
+    process.exit(1);
+  }
+}
+const r = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+process.exit(r.status === null ? 1 : r.status);

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "brevi",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.25.0",
+  "description": "Compiles the plain Python AI agents write into fast native binaries via Rust, with one-line JSON errors and an MCP server.",
+  "keywords": [
+    "python",
+    "compiler",
+    "rust",
+    "mcp",
+    "ai-agents",
+    "llm",
+    "native",
+    "brevi"
+  ],
+  "homepage": "https://brevi-lang.org",
+  "bugs": {
+    "url": "https://github.com/ets-public/brevi/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ets-public/brevi.git"
+  },
+  "license": "Apache-2.0",
+  "bin": {
+    "brevi": "bin/brevi.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "mcpName": "io.github.ets-public/brevi"
+}