nestornotes 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# nestornotes (npm)
+
+Thin Node.js wrapper around the Python [`nestornotes`](https://pypi.org/project/nestornotes/) CLI. The wrapper proxies every invocation to the matching pinned PyPI wheel via [`uv`](https://astral.sh/uv), so `npm install -g nestornotes@X.Y.Z` always runs the same Python release.
+
+## Install
+
+```bash
+# Prerequisite: uv (one-liner installer)
+curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS / Linux
+# or: winget install astral-sh.uv                  # Windows
+
+npm install -g nestornotes
+```
+
+## Usage
+
+```bash
+nestornotes --help
+nestornotes call-tool list_collections
+nestornotes call-tool semantic_search --query "rust async"
+```
+
+By default the CLI talks to `https://mcp.nestornotes.com/mcp`. Override:
+
+```bash
+NESTORNOTES_SERVER_URL=http://localhost:8000/mcp nestornotes call-tool list_collections
+```
+
+## Upgrade
+
+```bash
+npm update -g nestornotes
+```
+
+## Why a wrapper?
+
+The actual CLI is generated from the [NestorNotes MCP server](https://github.com/grumpy-miner-dev/nestornotes-mcp)'s tool registry by `fastmcp generate-cli`. The Python wheel on PyPI is the source of truth; this npm package exists so Node-first users can install with one command.

package/bin/nestornotes.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+// Thin Node.js wrapper that proxies to the Python `nestornotes` CLI on PyPI
+// via `uvx`. The pinned version matches this npm package's version, so
+// installing `nestornotes@<X.Y.Z>` from npm always runs the matching wheel.
+//
+// Requires: `uv` on PATH (https://astral.sh/uv).
+
+"use strict";
+
+const { spawn, spawnSync } = require("node:child_process");
+const path = require("node:path");
+const { version } = require(path.join(__dirname, "..", "package.json"));
+
+function fail(msg) {
+  process.stderr.write(`nestornotes: ${msg}\n`);
+  process.exit(1);
+}
+
+// Verify uv is installed before invoking — gives a useful error rather than
+// the cryptic "ENOENT" you'd get from spawn() on a missing binary.
+const uvCheck = spawnSync("uv", ["--version"], { stdio: "ignore" });
+if (uvCheck.error || uvCheck.status !== 0) {
+  fail(
+    "`uv` is not installed or not on PATH.\n" +
+    "Install it: https://astral.sh/uv (one-line curl on macOS / Linux / Windows).\n" +
+    "Then re-run this command."
+  );
+}
+
+const args = ["tool", "run", `nestornotes==${version}`, ...process.argv.slice(2)];
+const child = spawn("uv", args, { stdio: "inherit" });
+
+child.on("error", (err) => fail(`failed to spawn uv: ${err.message}`));
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 1);
+  }
+});

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "nestornotes",
+  "version": "0.1.0",
+  "description": "Command-line client for the NestorNotes knowledge base. Thin wrapper around the Python `nestornotes` CLI on PyPI; runs it via `uvx`.",
+  "keywords": [
+    "nestornotes",
+    "mcp",
+    "fastmcp",
+    "cli",
+    "knowledge-base"
+  ],
+  "homepage": "https://nestornotes.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nestornotes/nestornotes-cli.git",
+    "directory": "npm"
+  },
+  "bugs": {
+    "url": "https://github.com/nestornotes/nestornotes-cli/issues"
+  },
+  "license": "MIT",
+  "bin": {
+    "nestornotes": "bin/nestornotes.js"
+  },
+  "files": [
+    "bin/nestornotes.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}