taken-gh 0.7.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RogueAlg0
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+[![npm](https://img.shields.io/npm/v/taken-gh?cacheSeconds=3600)](https://www.npmjs.com/package/taken-gh)
+
+# taken-gh
+
+The npm installer for [taken](https://github.com/RogueAlg0/taken), the small CLI that answers "taken?" for any GitHub issue before you volunteer for it.
+
+## What this installs
+
+Installing this package runs a postinstall step that makes sure the real `taken` Python CLI is on your PATH:
+
+- If `taken --version` already reports this package's version, nothing happens.
+- Otherwise it runs `python3 -m pip install --user "taken-gh==<this version>"`, retrying once with `--break-system-packages` on systems where pip refuses user installs (Debian 12+, Ubuntu 23.04+).
+
+The postinstall never fails your npm install: if Python or pip is missing, or the pip install fails, it prints the manual install command and moves on.
+
+## Binaries
+
+- `taken` — check whether a GitHub issue is already taken: `taken check owner/repo#123`
+- `taken-mcp` — the MCP server exposing the same checks to AI assistants
+
+Both are thin shims: they find the real Python-installed binary on your PATH and forward arguments, stdin/stdout/stderr, signals, and the exit code.
+
+## Versioning
+
+This package's version always matches the `taken-gh` PyPI release of the same number. The postinstall installs exactly that version, so the two can never drift.

package/bin/taken-mcp.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+"use strict";
+// npm shim for the real `taken` CLI (installed by the postinstall step via pip).
+// Finds the binary of the same name on PATH and forwards everything to it:
+// arguments, stdin/stdout/stderr, signals, and the exit code.
+const { spawn } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const NAME = path.basename(__filename, ".js");
+// Real path of this shim, so findOnPath can skip it: when npm links the shim
+// itself onto PATH as `taken`, a naive lookup would find the shim first and
+// recurse forever.
+const SELF_REALPATH = fs.realpathSync(__filename);
+
+function findOnPath(name) {
+  const pathEnv = process.env.PATH || "";
+  for (const dir of pathEnv.split(path.delimiter)) {
+    if (!dir) continue;
+    const candidate = path.join(dir, name);
+    try {
+      fs.accessSync(candidate, fs.constants.X_OK);
+      if (!fs.statSync(candidate).isFile()) continue;
+      // Skip this very shim if npm put it on PATH ahead of the real binary.
+      if (fs.realpathSync(candidate) === SELF_REALPATH) continue;
+      return candidate;
+    } catch {
+      // not in this directory, keep looking
+    }
+  }
+  return null;
+}
+
+const target = findOnPath(NAME);
+if (!target) {
+  console.error(
+    `${NAME} is not installed.\n` +
+      "The npm postinstall step normally installs it with pip. " +
+      "To install it by hand, run:\n" +
+      "  python3 -m pip install --user taken-gh"
+  );
+  process.exit(1);
+}
+
+const child = spawn(target, process.argv.slice(2), { stdio: "inherit" });
+
+for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(sig, () => child.kill(sig));
+}
+
+child.on("error", (err) => {
+  console.error(`Could not start ${NAME}: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    // Re-raise so the caller's exit status reflects the signal.
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code === null ? 1 : code);
+  }
+});

package/bin/taken.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+"use strict";
+// npm shim for the real `taken` CLI (installed by the postinstall step via pip).
+// Finds the binary of the same name on PATH and forwards everything to it:
+// arguments, stdin/stdout/stderr, signals, and the exit code.
+const { spawn } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const NAME = path.basename(__filename, ".js");
+// Real path of this shim, so findOnPath can skip it: when npm links the shim
+// itself onto PATH as `taken`, a naive lookup would find the shim first and
+// recurse forever.
+const SELF_REALPATH = fs.realpathSync(__filename);
+
+function findOnPath(name) {
+  const pathEnv = process.env.PATH || "";
+  for (const dir of pathEnv.split(path.delimiter)) {
+    if (!dir) continue;
+    const candidate = path.join(dir, name);
+    try {
+      fs.accessSync(candidate, fs.constants.X_OK);
+      if (!fs.statSync(candidate).isFile()) continue;
+      // Skip this very shim if npm put it on PATH ahead of the real binary.
+      if (fs.realpathSync(candidate) === SELF_REALPATH) continue;
+      return candidate;
+    } catch {
+      // not in this directory, keep looking
+    }
+  }
+  return null;
+}
+
+const target = findOnPath(NAME);
+if (!target) {
+  console.error(
+    `${NAME} is not installed.\n` +
+      "The npm postinstall step normally installs it with pip. " +
+      "To install it by hand, run:\n" +
+      "  python3 -m pip install --user taken-gh"
+  );
+  process.exit(1);
+}
+
+const child = spawn(target, process.argv.slice(2), { stdio: "inherit" });
+
+for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(sig, () => child.kill(sig));
+}
+
+child.on("error", (err) => {
+  console.error(`Could not start ${NAME}: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    // Re-raise so the caller's exit status reflects the signal.
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code === null ? 1 : code);
+  }
+});

package/install.js

@@ -0,0 +1,95 @@
+"use strict";
+// Postinstall for taken-gh: make sure the real `taken` Python CLI is
+// available, since the bin shims forward to it. Never fails the npm install:
+// every error path prints guidance and exits 0.
+const { spawnSync } = require("node:child_process");
+const pkg = require("./package.json");
+const VERSION = pkg.version;
+
+function manualInstallHint() {
+  return (
+    "You can install it by hand with:\n" +
+    `  python3 -m pip install --user "taken-gh==${VERSION}"`
+  );
+}
+
+// `taken --version` prints e.g. "taken 0.7.4". Returns the version string, or
+// null when taken is missing or its output cannot be parsed.
+function installedVersion() {
+  const existing = spawnSync("taken", ["--version"], { encoding: "utf8" });
+  if (existing.status !== 0 || existing.error) return null;
+  const m = /taken (\d+\.\d+\.\d+[^\s]*)/.exec(existing.stdout || "");
+  return m ? m[1] : null;
+}
+
+function pipInstall(extraArgs) {
+  const args = [
+    "-m",
+    "pip",
+    "install",
+    "--user",
+    ...extraArgs,
+    `taken-gh==${VERSION}`,
+  ];
+  // stdout stays inherited so pip's progress still shows; stderr is captured
+  // so we can spot PEP 668's externally-managed-environment and retry.
+  return spawnSync("python3", args, {
+    encoding: "utf8",
+    stdio: ["inherit", "inherit", "pipe"],
+  });
+}
+
+function main() {
+  try {
+    const have = installedVersion();
+    if (have === VERSION) {
+      console.log(
+        `taken ${VERSION} is already installed, skipping the pip install.`
+      );
+      return;
+    }
+    if (have === null) {
+      console.log(`Installing taken-gh ${VERSION} with pip...`);
+    } else {
+      console.log(
+        `Found taken ${have}, but this package needs ${VERSION}; reinstalling with pip...`
+      );
+    }
+
+    let result = pipInstall([]);
+    if (result.error && result.error.code === "ENOENT") {
+      console.error(
+        "python3 was not found on PATH, so the pip install was skipped.\n" +
+          manualInstallHint()
+      );
+      return;
+    }
+
+    if (
+      result.status !== 0 &&
+      /externally-managed-environment/.test(result.stderr || "")
+    ) {
+      console.log(
+        "pip refused the user install (externally-managed-environment); " +
+          "retrying once with --break-system-packages..."
+      );
+      result = pipInstall(["--break-system-packages"]);
+    }
+
+    if (result.status !== 0) {
+      console.error(
+        "The pip install did not finish cleanly, so the taken command may not work yet.\n" +
+          manualInstallHint()
+      );
+      return;
+    }
+
+    console.log("taken installed. Run `taken --help` to get started.");
+  } catch (err) {
+    console.error(`Postinstall hit a snag and skipped the pip install: ${err.message}`);
+    console.error(manualInstallHint());
+  }
+  process.exit(0);
+}
+
+main();

package/package.json

@@ -0,0 +1 @@
+{"//":"version must stay in sync with pyproject.toml for every release","bin":{"taken":"./bin/taken.js","taken-mcp":"./bin/taken-mcp.js"},"bugs":{"url":"https://github.com/RogueAlg0/taken/issues"},"description":"Check whether a GitHub issue is already taken before you volunteer for it.","engines":{"node":">=18"},"files":["bin/","install.js","README.md","LICENSE"],"homepage":"https://github.com/RogueAlg0/taken","keywords":["github","open-source","cli","good-first-issue","hacktoberfest","mcp"],"license":"MIT","name":"taken-gh","repository":{"type":"git","url":"https://github.com/RogueAlg0/taken.git"},"scripts":{"postinstall":"node install.js","test":"node --test \"test/*.test.js\""},"version":"0.7.5"}