lystn-cli 0.1.5 → 0.2.0

package/README.md

@@ -1,35 +1,35 @@
-# lystn (npm package)
-
-Listen to AI coding assistants instead of reading them. This is the npm
-distribution of the [Lystn](https://github.com/burakayener/Lystn) CLI.
-
-```bash
-npm install -g lystn-cli     # or: pnpm add -g lystn-cli
-lystn config set server https://api.lystn.space
-lystn config set api_key <your key>
-lystn install            # wires the Claude Code hook automatically
-lystn test               # you should hear a voice
-```
-
-## How this package works
-
-The Lystn CLI is Python. This npm package is a thin launcher: on install
-(or on first run) it creates a private Python virtualenv inside the
-package directory and installs the matching `lystn` release from PyPI
-into it. Nothing touches your global Python or site-packages.
-
-- Requires **Python 3.10+** on the machine (macOS ships it; on Windows
-  install from python.org with "Add to PATH").
-- **pnpm users:** pnpm v10+ skips install scripts by default — that's
-  fine; the launcher sets itself up on the first `lystn` command instead.
-- Uninstall with `npm uninstall -g lystn-cli` (the venv lives inside the
-  package dir and is removed with it). Run `lystn uninstall` first to
-  remove the Claude Code hooks.
-
-## Releasing (maintainers)
-
-1. Publish the new version to PyPI first (see `docs/ops/INSTALL-BREW.md`
-   section 1 — same artifact serves brew and npm).
-2. Bump `version` in `packaging/npm/package.json` to the **same** version
-   (the bootstrap pins `lystn==<version>` from PyPI).
-3. `cd packaging/npm && npm publish`.
+# lystn (npm package)
+
+Listen to AI coding assistants instead of reading them. This is the npm
+distribution of the [Lystn](https://github.com/burakayener/Lystn) CLI.
+
+```bash
+npm install -g lystn-cli     # or: pnpm add -g lystn-cli
+lystn config set server https://api.lystn.space
+lystn config set api_key <your key>
+lystn install            # wires the Claude Code hook automatically
+lystn test               # you should hear a voice
+```
+
+## How this package works
+
+The Lystn CLI is Python. This npm package is a thin launcher: on install
+(or on first run) it creates a private Python virtualenv inside the
+package directory and installs the matching `lystn` release from PyPI
+into it. Nothing touches your global Python or site-packages.
+
+- Requires **Python 3.10+** on the machine (macOS ships it; on Windows
+  install from python.org with "Add to PATH").
+- **pnpm users:** pnpm v10+ skips install scripts by default — that's
+  fine; the launcher sets itself up on the first `lystn` command instead.
+- Uninstall with `npm uninstall -g lystn-cli` (the venv lives inside the
+  package dir and is removed with it). Run `lystn uninstall` first to
+  remove the Claude Code hooks.
+
+## Releasing (maintainers)
+
+1. Publish the new version to PyPI first (see `docs/ops/INSTALL-BREW.md`
+   section 1 — same artifact serves brew and npm).
+2. Bump `version` in `packaging/npm/package.json` to the **same** version
+   (the bootstrap pins `lystn==<version>` from PyPI).
+3. `cd packaging/npm && npm publish`.

package/bin/lystn.js

@@ -1,28 +1,28 @@
-#!/usr/bin/env node
-/*
- * `lystn` launcher for the npm package.
- *
- * Delegates every invocation to the real Python CLI living in the
- * package-private venv (.venv/). If the venv is missing (e.g. pnpm
- * skipped postinstall), it bootstraps on the spot, then runs the command.
- */
-"use strict";
-
-const { spawnSync } = require("child_process");
-const fs = require("fs");
-const path = require("path");
-
-const { bootstrap, venvLystn } = require(path.join(
-  __dirname,
-  "..",
-  "scripts",
-  "bootstrap.js"
-));
-
-const exe = venvLystn();
-if (!fs.existsSync(exe) && !bootstrap()) {
-  process.exit(1);
-}
-
-const res = spawnSync(exe, process.argv.slice(2), { stdio: "inherit" });
-process.exit(res.status === null ? 1 : res.status);
+#!/usr/bin/env node
+/*
+ * `lystn` launcher for the npm package.
+ *
+ * Delegates every invocation to the real Python CLI living in the
+ * package-private venv (.venv/). If the venv is missing (e.g. pnpm
+ * skipped postinstall), it bootstraps on the spot, then runs the command.
+ */
+"use strict";
+
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const { bootstrap, venvLystn } = require(path.join(
+  __dirname,
+  "..",
+  "scripts",
+  "bootstrap.js"
+));
+
+const exe = venvLystn();
+if (!fs.existsSync(exe) && !bootstrap()) {
+  process.exit(1);
+}
+
+const res = spawnSync(exe, process.argv.slice(2), { stdio: "inherit" });
+process.exit(res.status === null ? 1 : res.status);

package/package.json

@@ -1,30 +1,30 @@
-{
-  "name": "lystn-cli",
-  "version": "0.1.5",
-  "description": "Listen to AI coding assistant responses through your speakers.",
-  "homepage": "https://github.com/burakayener/Lystn",
-  "license": "SEE LICENSE IN LICENSE",
-  "bin": {
-    "lystn": "bin/lystn.js"
-  },
-  "scripts": {
-    "postinstall": "node scripts/bootstrap.js || exit 0"
-  },
-  "files": [
-    "bin/",
-    "scripts/",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "tts",
-    "claude-code",
-    "codex",
-    "ai-agents",
-    "voice",
-    "accessibility",
-    "adhd"
-  ]
-}
+{
+  "name": "lystn-cli",
+  "version": "0.2.0",
+  "description": "Listen to AI coding assistant responses through your speakers.",
+  "homepage": "https://github.com/burakayener/Lystn",
+  "license": "SEE LICENSE IN LICENSE",
+  "bin": {
+    "lystn": "bin/lystn.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/bootstrap.js || exit 0"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "tts",
+    "claude-code",
+    "codex",
+    "ai-agents",
+    "voice",
+    "accessibility",
+    "adhd"
+  ]
+}

package/scripts/bootstrap.js

@@ -1,129 +1,129 @@
-#!/usr/bin/env node
-/*
- * Bootstrap the private Python environment for the lystn npm package.
- *
- * Runs at `npm install -g lystn-cli` (postinstall) AND lazily from bin/lystn.js
- * if the venv is missing — pnpm v10+ skips postinstall scripts by default,
- * so the launcher must be able to self-bootstrap on first run.
- *
- * What it does:
- *   1. Find a Python >= 3.10 (python3.13..3.10, python3, python, py -3).
- *   2. Create a venv inside the package directory (.venv/).
- *   3. pip install lystn==<version from package.json> into it.
- */
-"use strict";
-
-const { spawnSync } = require("child_process");
-const fs = require("fs");
-const path = require("path");
-
-const PKG_ROOT = path.join(__dirname, "..");
-const VENV_DIR = path.join(PKG_ROOT, ".venv");
-const IS_WIN = process.platform === "win32";
-const PYPI_VERSION = require(path.join(PKG_ROOT, "package.json")).version;
-
-function run(cmd, args, opts) {
-  return spawnSync(cmd, args, { encoding: "utf-8", ...opts });
-}
-
-function pythonVersionOk(exe, viaLauncherArgs) {
-  const args = (viaLauncherArgs || []).concat([
-    "-c",
-    "import sys; print('%d.%d' % sys.version_info[:2])",
-  ]);
-  const res = run(exe, args);
-  if (res.status !== 0 || !res.stdout) return false;
-  const [maj, min] = res.stdout.trim().split(".").map(Number);
-  return maj === 3 && min >= 10;
-}
-
-function findPython() {
-  const candidates = IS_WIN
-    ? [
-        ["py", ["-3"]],
-        ["python", []],
-        ["python3", []],
-      ]
-    : [
-        ["python3.13", []],
-        ["python3.12", []],
-        ["python3.11", []],
-        ["python3.10", []],
-        ["python3", []],
-        ["python", []],
-      ];
-  for (const [exe, extraArgs] of candidates) {
-    if (pythonVersionOk(exe, extraArgs)) return { exe, extraArgs };
-  }
-  return null;
-}
-
-function venvPython() {
-  return IS_WIN
-    ? path.join(VENV_DIR, "Scripts", "python.exe")
-    : path.join(VENV_DIR, "bin", "python");
-}
-
-function venvLystn() {
-  return IS_WIN
-    ? path.join(VENV_DIR, "Scripts", "lystn.exe")
-    : path.join(VENV_DIR, "bin", "lystn");
-}
-
-function bootstrap() {
-  if (fs.existsSync(venvLystn())) return true; // already done
-
-  const py = findPython();
-  if (!py) {
-    console.error(
-      "[lystn] Python 3.10+ was not found on this system.\n" +
-        "[lystn] The lystn CLI runs on Python. Install it from:\n" +
-        "[lystn]   macOS:   brew install python  (or use: brew install burakayener/lystn/lystn)\n" +
-        "[lystn]   Windows: https://www.python.org/downloads/ (check 'Add to PATH')\n" +
-        "[lystn]   Linux:   your package manager, e.g. apt install python3\n" +
-        "[lystn] Then run any `lystn` command again — setup resumes automatically."
-    );
-    return false;
-  }
-
-  console.error("[lystn] First-run setup: preparing the speech engine ...");
-  let res = run(py.exe, py.extraArgs.concat(["-m", "venv", VENV_DIR]), {
-    stdio: ["ignore", "inherit", "inherit"],
-  });
-  if (res.status !== 0) {
-    console.error("[lystn] Failed to create a Python environment.");
-    return false;
-  }
-
-  res = run(
-    venvPython(),
-    ["-m", "pip", "install", "--quiet", `lystn==${PYPI_VERSION}`],
-    { stdio: ["ignore", "inherit", "inherit"] }
-  );
-  if (res.status !== 0 || !fs.existsSync(venvLystn())) {
-    console.error(
-      "[lystn] Failed to install the lystn engine from PyPI.\n" +
-        "[lystn] Check your network and try again with any `lystn` command."
-    );
-    // Leave no half-built venv behind so the next run retries cleanly.
-    try {
-      fs.rmSync(VENV_DIR, { recursive: true, force: true });
-    } catch (_) {}
-    return false;
-  }
-
-  console.error("[lystn] Ready. Try: lystn config set api_key <key> && lystn test");
-  return true;
-}
-
-module.exports = { bootstrap, venvLystn };
-
-if (require.main === module) {
-  // Postinstall context: never fail the npm install — the launcher
-  // self-bootstraps later if this didn't complete.
-  try {
-    bootstrap();
-  } catch (err) {
-    console.error(`[lystn] Setup deferred to first run (${err.message}).`);
-  }
-}
+#!/usr/bin/env node
+/*
+ * Bootstrap the private Python environment for the lystn npm package.
+ *
+ * Runs at `npm install -g lystn-cli` (postinstall) AND lazily from bin/lystn.js
+ * if the venv is missing — pnpm v10+ skips postinstall scripts by default,
+ * so the launcher must be able to self-bootstrap on first run.
+ *
+ * What it does:
+ *   1. Find a Python >= 3.10 (python3.13..3.10, python3, python, py -3).
+ *   2. Create a venv inside the package directory (.venv/).
+ *   3. pip install lystn==<version from package.json> into it.
+ */
+"use strict";
+
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const PKG_ROOT = path.join(__dirname, "..");
+const VENV_DIR = path.join(PKG_ROOT, ".venv");
+const IS_WIN = process.platform === "win32";
+const PYPI_VERSION = require(path.join(PKG_ROOT, "package.json")).version;
+
+function run(cmd, args, opts) {
+  return spawnSync(cmd, args, { encoding: "utf-8", ...opts });
+}
+
+function pythonVersionOk(exe, viaLauncherArgs) {
+  const args = (viaLauncherArgs || []).concat([
+    "-c",
+    "import sys; print('%d.%d' % sys.version_info[:2])",
+  ]);
+  const res = run(exe, args);
+  if (res.status !== 0 || !res.stdout) return false;
+  const [maj, min] = res.stdout.trim().split(".").map(Number);
+  return maj === 3 && min >= 10;
+}
+
+function findPython() {
+  const candidates = IS_WIN
+    ? [
+        ["py", ["-3"]],
+        ["python", []],
+        ["python3", []],
+      ]
+    : [
+        ["python3.13", []],
+        ["python3.12", []],
+        ["python3.11", []],
+        ["python3.10", []],
+        ["python3", []],
+        ["python", []],
+      ];
+  for (const [exe, extraArgs] of candidates) {
+    if (pythonVersionOk(exe, extraArgs)) return { exe, extraArgs };
+  }
+  return null;
+}
+
+function venvPython() {
+  return IS_WIN
+    ? path.join(VENV_DIR, "Scripts", "python.exe")
+    : path.join(VENV_DIR, "bin", "python");
+}
+
+function venvLystn() {
+  return IS_WIN
+    ? path.join(VENV_DIR, "Scripts", "lystn.exe")
+    : path.join(VENV_DIR, "bin", "lystn");
+}
+
+function bootstrap() {
+  if (fs.existsSync(venvLystn())) return true; // already done
+
+  const py = findPython();
+  if (!py) {
+    console.error(
+      "[lystn] Python 3.10+ was not found on this system.\n" +
+        "[lystn] The lystn CLI runs on Python. Install it from:\n" +
+        "[lystn]   macOS:   brew install python  (or use: brew install burakayener/lystn/lystn)\n" +
+        "[lystn]   Windows: https://www.python.org/downloads/ (check 'Add to PATH')\n" +
+        "[lystn]   Linux:   your package manager, e.g. apt install python3\n" +
+        "[lystn] Then run any `lystn` command again — setup resumes automatically."
+    );
+    return false;
+  }
+
+  console.error("[lystn] First-run setup: preparing the speech engine ...");
+  let res = run(py.exe, py.extraArgs.concat(["-m", "venv", VENV_DIR]), {
+    stdio: ["ignore", "inherit", "inherit"],
+  });
+  if (res.status !== 0) {
+    console.error("[lystn] Failed to create a Python environment.");
+    return false;
+  }
+
+  res = run(
+    venvPython(),
+    ["-m", "pip", "install", "--quiet", `lystn==${PYPI_VERSION}`],
+    { stdio: ["ignore", "inherit", "inherit"] }
+  );
+  if (res.status !== 0 || !fs.existsSync(venvLystn())) {
+    console.error(
+      "[lystn] Failed to install the lystn engine from PyPI.\n" +
+        "[lystn] Check your network and try again with any `lystn` command."
+    );
+    // Leave no half-built venv behind so the next run retries cleanly.
+    try {
+      fs.rmSync(VENV_DIR, { recursive: true, force: true });
+    } catch (_) {}
+    return false;
+  }
+
+  console.error("[lystn] Ready. Try: lystn config set api_key <key> && lystn test");
+  return true;
+}
+
+module.exports = { bootstrap, venvLystn };
+
+if (require.main === module) {
+  // Postinstall context: never fail the npm install — the launcher
+  // self-bootstraps later if this didn't complete.
+  try {
+    bootstrap();
+  } catch (err) {
+    console.error(`[lystn] Setup deferred to first run (${err.message}).`);
+  }
+}