@maximem/synap-cli 0.1.0

package/README.md

@@ -0,0 +1,28 @@
+# @maximem/synap-cli
+
+One-line installer for the **maximem-synap** developer CLI (the Synap control
+plane). This npm package is a small bootstrap: it installs the actual CLI — a
+Python/Typer program, bundled here as a wheel — onto your PATH and then runs it.
+
+> This is **not** the runtime SDK. Agents/apps integrate Synap with
+> [`@maximem/synap-js-sdk`](https://www.npmjs.com/package/@maximem/synap-js-sdk)
+> or the Python SDK. This CLI is for **developers** to provision and operate
+> Synap from a terminal.
+
+## Use
+
+```bash
+npx @maximem/synap-cli              # install the CLI onto your PATH
+npx @maximem/synap-cli auth login   # bootstrap if needed, then log in
+```
+
+After the first run, the `maximem-synap` command is on your PATH:
+
+```bash
+maximem-synap auth login
+maximem-synap whoami
+```
+
+Requires **Node 16+** and **Python 3.10+** on the host. The CLI is installed via
+`pipx` if present, otherwise into an isolated virtualenv at `~/.maximem-synap`
+and symlinked into `~/.local/bin`.

package/bin/synap-cli.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+"use strict";
+
+/*
+ * npx bootstrap for the `maximem-synap` developer CLI.
+ *
+ * The CLI itself is a Python (Typer) program. This Node shim exists only to give
+ * JS-first developers a one-liner:  `npx maximem-synap`. It:
+ *   1. ensures the Python CLI is installed onto your PATH (pipx, or an isolated
+ *      venv at ~/.maximem-synap symlinked into ~/.local/bin), then
+ *   2. forwards your command to it  (`npx maximem-synap auth login`).
+ *
+ * It is NOT the runtime SDK. Agents/apps use @maximem/synap-js-sdk to call Synap.
+ *
+ * Env:
+ *   MAXIMEM_SYNAP_SOURCE  pip spec to install (default "maximem-synap").
+ *                         Set to a local path/checkout for development.
+ */
+
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const HOME = os.homedir();
+const LOCAL_BIN = path.join(HOME, ".local", "bin");
+const INSTALL_HOME = path.join(HOME, ".maximem-synap");
+const VENV = path.join(INSTALL_HOME, "venv");
+const VENV_BIN = process.platform === "win32" ? "Scripts" : "bin";
+const EXE = process.platform === "win32" ? ".exe" : "";
+
+// What pip should install. Priority:
+//   1. MAXIMEM_SYNAP_SOURCE env (dev: a path/checkout)
+//   2. the wheel bundled in this npm package (vendor/*.whl) — self-contained,
+//      so `npx maximem-synap` works without the CLI being on PyPI yet
+//   3. "maximem-synap" from PyPI (once published)
+function resolvePkgSpec() {
+  if (process.env.MAXIMEM_SYNAP_SOURCE) return process.env.MAXIMEM_SYNAP_SOURCE;
+  const vendor = path.join(__dirname, "..", "vendor");
+  try {
+    const wheels = fs.readdirSync(vendor).filter((f) => f.endsWith(".whl"));
+    if (wheels.length) return path.join(vendor, wheels.sort().reverse()[0]);
+  } catch (_) { /* no bundled wheel */ }
+  return "maximem-synap";
+}
+const PKG_SPEC = resolvePkgSpec();
+
+function log(msg) { process.stderr.write(msg + "\n"); }
+
+function shHasCommand(name) {
+  if (process.platform === "win32") {
+    return spawnSync("where", [name], { stdio: "ignore" }).status === 0;
+  }
+  return spawnSync("sh", ["-c", `command -v ${name}`], { stdio: "ignore" }).status === 0;
+}
+
+// Resolve the *installed Python CLI* by concrete location, NOT by spawning bare
+// `maximem-synap` (which under npx would recurse into this very shim).
+function findInstalledCli() {
+  const candidates = [
+    path.join(LOCAL_BIN, "maximem-synap" + EXE),
+    path.join(VENV, VENV_BIN, "maximem-synap" + EXE),
+  ];
+  for (const c of candidates) {
+    if (!fs.existsSync(c)) continue;
+    const r = spawnSync(c, ["--version"], { encoding: "utf8" });
+    if (r.status === 0 && /maximem-synap/i.test(r.stdout || "")) return c;
+  }
+  return null;
+}
+
+function findPython() {
+  const cands = ["python3.13", "python3.12", "python3.11", "python3.10", "python3", "python"];
+  for (const py of cands) {
+    const r = spawnSync(py, ["-c", "import sys;print('%d.%d' % sys.version_info[:2])"], { encoding: "utf8" });
+    if (r.status !== 0) continue;
+    const [maj, min] = (r.stdout || "").trim().split(".").map(Number);
+    if (maj === 3 && min >= 10) return py;
+  }
+  return null;
+}
+
+function ensureLocalBinOnPath() {
+  const parts = (process.env.PATH || "").split(path.delimiter);
+  if (!parts.includes(LOCAL_BIN)) {
+    log("");
+    log(`Note: ${LOCAL_BIN} is not on your PATH. Add this to your shell profile:`);
+    log(`  export PATH="$HOME/.local/bin:$PATH"`);
+    log("");
+  }
+}
+
+function symlink(target, linkPath) {
+  try { fs.mkdirSync(path.dirname(linkPath), { recursive: true }); } catch (_) {}
+  try { fs.unlinkSync(linkPath); } catch (_) {}
+  fs.symlinkSync(target, linkPath);
+}
+
+function install() {
+  // Preferred: pipx (isolated, manages ~/.local/bin + PATH itself).
+  if (shHasCommand("pipx")) {
+    log(`Installing maximem-synap via pipx (${PKG_SPEC})…`);
+    const r = spawnSync("pipx", ["install", "--force", PKG_SPEC], { stdio: "inherit" });
+    if (r.status === 0) { ensureLocalBinOnPath(); return findInstalledCli(); }
+    log("pipx install failed; falling back to a managed virtualenv.");
+  }
+
+  // Fallback: a dedicated venv at ~/.maximem-synap, symlinked into ~/.local/bin.
+  const py = findPython();
+  if (!py) {
+    log("");
+    log("✗ maximem-synap needs Python 3.10+ on your machine (the CLI is Python).");
+    log("  Install Python 3.10+ and re-run, or use Homebrew: brew install maximem-ai/tap/maximem-synap");
+    process.exit(1);
+  }
+  log(`Installing maximem-synap into ${VENV} using ${py}…`);
+  fs.mkdirSync(INSTALL_HOME, { recursive: true });
+  if (!fs.existsSync(VENV)) {
+    const v = spawnSync(py, ["-m", "venv", VENV], { stdio: "inherit" });
+    if (v.status !== 0) { log("✗ Failed to create virtualenv."); process.exit(1); }
+  }
+  const venvPy = path.join(VENV, VENV_BIN, "python" + EXE);
+  spawnSync(venvPy, ["-m", "pip", "install", "--quiet", "--upgrade", "pip"], { stdio: "inherit" });
+  const pip = spawnSync(venvPy, ["-m", "pip", "install", "--upgrade", PKG_SPEC], { stdio: "inherit" });
+  if (pip.status !== 0) { log("✗ pip install failed."); process.exit(1); }
+
+  fs.mkdirSync(LOCAL_BIN, { recursive: true });
+  for (const name of ["maximem-synap", "synap"]) {
+    const src = path.join(VENV, VENV_BIN, name + EXE);
+    if (fs.existsSync(src)) symlink(src, path.join(LOCAL_BIN, name + EXE));
+  }
+  ensureLocalBinOnPath();
+  return findInstalledCli();
+}
+
+function main() {
+  let args = process.argv.slice(2);
+
+  // `npx maximem-synap install` (or `setup`) = bootstrap only, don't forward.
+  const bootstrapOnly = args[0] === "install" || args[0] === "setup";
+  if (bootstrapOnly) args = args.slice(1);
+
+  let cli = findInstalledCli();
+  if (!cli) cli = install();
+  if (!cli) { log("✗ Could not locate maximem-synap after install."); process.exit(1); }
+
+  if (bootstrapOnly || args.length === 0) {
+    log("");
+    log("✓ maximem-synap is installed.");
+    log("  Next:  maximem-synap auth login");
+    log("");
+    if (args.length === 0) return;
+  }
+
+  const r = spawnSync(cli, args, { stdio: "inherit" });
+  process.exit(r.status === null ? 1 : r.status);
+}
+
+main();

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@maximem/synap-cli",
+  "version": "0.1.0",
+  "description": "Installer for the maximem-synap developer CLI. Bootstraps the (Python) Synap control-plane CLI onto your PATH, then runs it. Not the runtime SDK — see @maximem/synap-js-sdk for agent integration.",
+  "bin": {
+    "synap-cli": "bin/synap-cli.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin/",
+    "vendor/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "keywords": [
+    "synap",
+    "maximem",
+    "cli",
+    "memory",
+    "agents"
+  ],
+  "license": "UNLICENSED",
+  "homepage": "https://maximem.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maximem-ai/maximem_synap.git"
+  }
+}