@ziamana/bruine 0.1.0 → 0.1.1

package/README.md

@@ -12,7 +12,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-b4a7ff)](LICENSE)
 [![Node 22+](https://img.shields.io/badge/node-22%2B-7dcfff)](https://nodejs.org)
 ![Windows · macOS · Linux](https://img.shields.io/badge/Windows%20%C2%B7%20macOS%20%C2%B7%20Linux-supported-8fe3a3)
-[![Changelog](https://img.shields.io/badge/version-0.1.0-ff9ed2)](CHANGELOG.md)
+[![Changelog](https://img.shields.io/badge/version-0.1.1-ff9ed2)](CHANGELOG.md)
 
 <a href="docs/media/bruine-film.mp4"><img src="docs/media/hero.webp" alt="The bruine film: the word bruine becomes the logo in the rain, then the effort climbs from low to max and the rain turns into a storm" width="100%"></a>
 
@@ -35,6 +35,29 @@ bruine
 The first launch opens a setup wizard: it finds a local model server if you run one, asks for API
 keys if you want a cloud route, lets you pick skills, and writes `~/.bruine/`.
 
+## Install
+
+You need **Node 22 or newer** and npm (it comes with Node). Check with `node --version`.
+
+| | Get Node 22+ | Install bruine | Open it in |
+|---|---|---|---|
+| **Linux** | your package manager (`sudo pacman -S nodejs npm`, `sudo apt install nodejs npm` if it is 22+) or [nvm](https://github.com/nvm-sh/nvm) | `npm install -g @ziamana/bruine` | any terminal |
+| **macOS** | `brew install node`, or the installer from [nodejs.org](https://nodejs.org) | `npm install -g @ziamana/bruine` | Terminal or iTerm2 |
+| **Windows** | `winget install OpenJS.NodeJS.LTS`, or the installer from [nodejs.org](https://nodejs.org) | `npm install -g @ziamana/bruine` | Windows Terminal (PowerShell) |
+
+Then type `bruine` in your project's folder. The command is `bruine`; `@ziamana/bruine` is only the
+name npm knows it by.
+
+- **Permission denied (`EACCES`) on Linux or macOS**: do not use `sudo`. Point npm at a folder you own:
+  `npm config set prefix ~/.local`, and make sure `~/.local/bin` is on your `PATH`.
+- **Update**: `bruine update` (or `/update` in a session). **Remove**: `npm uninstall -g @ziamana/bruine`,
+  and delete `~/.bruine` if you want your settings gone too.
+- **Where it was tested**: Linux every day. On macOS the unit tests pass on the CI runner and the
+  terminal tests are being fixed; on Windows both are being fixed, and it has not yet been run by hand
+  on a real Windows machine. If something breaks there,
+  [open an issue](https://github.com/ziamana/bruine/issues) with your terminal and `bruine --version`.
+  [docs/PLATFORMS.md](docs/PLATFORMS.md) lists what was checked.
+
 ## See it
 
 <img src="docs/demo/bruine.svg" alt="bruine in a terminal: a prompt, the model's reasoning streaming then folding away, a file read, an edit shown as a diff, two permission prompts, the tests passing, and a second prompt that was queued while it worked going out after" width="100%">

package/dist/bin.js

@@ -4625,7 +4625,7 @@ var init_config = __esm({
 });
 
 // src/mcp/state.ts
-import { mkdirSync, readFileSync as readFileSync6, renameSync, writeFileSync } from "fs";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync6, renameSync, writeFileSync } from "fs";
 import path7 from "path";
 function projectKey(dir, platform = process.platform) {
   const abs = path7.resolve(dir);
@@ -4643,7 +4643,7 @@ function readMcpState(home) {
   }
 }
 function writeMcpState(home, state2) {
-  mkdirSync(home, { recursive: true });
+  mkdirSync2(home, { recursive: true });
   const target = path7.join(home, MCP_STATE_FILE);
   const temp = `${target}.${String(process.pid)}.tmp`;
   writeFileSync(temp, `${JSON.stringify(state2, null, 2)}
@@ -4802,7 +4802,7 @@ function flagMode(argv) {
 // src/profile.ts
 import { createRequire as createRequire2 } from "module";
 import { mkdir, readFile, rename, rm, stat, writeFile } from "fs/promises";
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync2, rmSync, symlinkSync } from "fs";
 import path3 from "path";
 import { parse as parseYaml } from "yaml";
 var require3 = createRequire2(import.meta.url);
@@ -4934,6 +4934,30 @@ async function ensureProfile(dshHome, pathMod = path3) {
   await writePersonaPatch(p.patchYml, dshHome, pathMod);
   return { created: true, dir };
 }
+function linkProfileBundles(profileDir, own, dshBaseDir) {
+  const type = process.platform === "win32" ? "junction" : "dir";
+  const link = (target, at) => {
+    mkdirSync(path3.dirname(at), { recursive: true });
+    rmSync(at, { recursive: true, force: true });
+    symlinkSync(target, at, type);
+  };
+  try {
+    const modules = path3.join(profileDir, "node_modules");
+    link(own.root, path3.join(modules, own.name));
+    link(dshBaseDir, path3.join(modules, "@deepseek-ai", "dsh-base"));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function resolveDshBaseDir() {
+  try {
+    const dshRequire = createRequire2(require3.resolve("@deepseek-ai/dsh/package.json"));
+    return path3.dirname(dshRequire.resolve("@deepseek-ai/dsh-base/package.json"));
+  } catch {
+    return void 0;
+  }
+}
 
 // src/bin.ts
 init_simple();
@@ -5060,8 +5084,14 @@ function selfPackageRoot() {
 function ensureBundleInstalled(profileDir, dshEntry, env, headless = false) {
   const marker = join7(profileDir, "node_modules", pkg2.name, "package.json");
   if (existsSync7(marker)) return;
-  const spec = selfPackageRoot() ?? `${pkg2.name}@${pkg2.version}`;
+  const root = selfPackageRoot();
   if (!headless) console.log("Setting up bruine (one time)\u2026");
+  const dshBase = resolveDshBaseDir();
+  if (root !== void 0 && dshBase !== void 0 && linkProfileBundles(profileDir, { name: pkg2.name, root }, dshBase)) {
+    if (!headless) console.log("Ready.");
+    return;
+  }
+  const spec = root ?? `${pkg2.name}@${pkg2.version}`;
   const { status, error, output } = runDsh(
     dshEntry,
     ["plugin", "--profile", "bruine", "add", spec],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziamana/bruine",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Interactive terminal coding agent that runs your own models, local or OpenAI-compatible",
   "type": "module",
   "license": "MIT",