mateooo93-cortex 0.25.21 → 0.25.23

package/README.md

@@ -1,13 +1,41 @@
-# mateooo93-cortex (npm)
+# @mateooo93/cortex (npm)
 
-Cross-platform npm wrapper for the [Mateooo93 cortex-cli](https://github.com/Mateooo93/cortex-cli) AI coding agent. On install it downloads the matching native binary from GitHub Releases.
+npm wrapper that downloads the native `cortex` binary for your OS on `postinstall`.
 
-> **Note:** The npm package `cortex-cli` is a different product (CognitiveScale). Use `mateooo93-cortex`.
+> **Note:** The package `cortex-cli` on npmjs.org is a different product (CognitiveScale). Use `@mateooo93/cortex`.
+
+## Install
+
+```bash
+npm install -g @mateooo93/cortex --registry=https://npm.pkg.github.com
+```
+
+Or set the scope once in `~/.npmrc`:
+
+```
+@mateooo93:registry=https://npm.pkg.github.com
+```
+
+Then:
+
+```bash
+npm install -g @mateooo93/cortex
+```
+
+The global `cortex` command must point at `.../node_modules/@mateooo93/cortex/shims/cortex.js` (or your package manager's global bin shim).
+
+## Publish (maintainers)
+
+**GitHub Packages** (default — uses `GITHUB_TOKEN` in Actions):
+
+```bash
+./script/publish-npm.sh v0.25.19 --yes
+```
+
+**npmjs.org** (optional legacy `mateooo93-cortex` — requires npm Automation token):
 
 ```bash
-npm uninstall -g cortex-cli
-npm install -g mateooo93-cortex
-cortex
+./script/publish-npm.sh v0.25.19 --yes --registry npmjs
 ```
 
-Set `CORTEX_SKIP_POSTINSTALL=1` to skip the binary download (for CI or offline mirrors).
+After the first GitHub Packages publish, set the package visibility to **Public** under the repo's **Packages** tab so anyone can install without a token.

package/lib/install.js

@@ -4,6 +4,7 @@ const fs = require("fs");
 const path = require("path");
 
 const { downloadBinary } = require("./download");
+const { warnIfShadowed } = require("./path-check");
 const { resolveAsset } = require("./platform");
 const { cacheDir, readPackageVersion, releaseBase } = require("./paths");
 
@@ -51,6 +52,7 @@ async function main() {
     if (dest) {
       console.log(`cortex-cli: installed native binary to ${dest}`);
     }
+    warnIfShadowed();
   } catch (err) {
     console.error(`cortex-cli: postinstall failed: ${err.message}`);
     process.exit(1);

package/lib/path-check.js

@@ -0,0 +1,109 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+
+const CONFLICT_MARKERS = [
+  "cortex-cli/bin/cortex",
+  "node_modules/cortex-cli/",
+  "CognitiveScale",
+  "cortex actions",
+];
+
+function npmGlobalBin() {
+  try {
+    const prefix = execSync("npm prefix -g", {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    }).trim();
+    return path.join(prefix, "bin", "cortex");
+  } catch {
+    return null;
+  }
+}
+
+function pathEntries() {
+  return (process.env.PATH || "")
+    .split(path.delimiter)
+    .map((entry) => entry.trim())
+    .filter(Boolean);
+}
+
+function resolveCortexOnPath() {
+  for (const dir of pathEntries()) {
+    const candidate = path.join(dir, process.platform === "win32" ? "cortex.cmd" : "cortex");
+    if (!fs.existsSync(candidate)) {
+      continue;
+    }
+    try {
+      return fs.realpathSync(candidate);
+    } catch {
+      return candidate;
+    }
+  }
+  return null;
+}
+
+function looksLikeCognitiveScale(target) {
+  if (!target) {
+    return false;
+  }
+  const normalized = target.replace(/\\/g, "/");
+  if (CONFLICT_MARKERS.some((marker) => normalized.includes(marker))) {
+    return true;
+  }
+  if (normalized.endsWith("/shims/cortex.js")) {
+    return false;
+  }
+  if (normalized.includes("/mateooo93-cortex/") || normalized.includes("/@mateooo93/cortex/")) {
+    return false;
+  }
+  if (normalized.includes("/.cortex/npm/")) {
+    return false;
+  }
+  // Heuristic: CognitiveScale ships a cortex.js launcher, not our shim layout.
+  if (
+    normalized.endsWith("/cortex.js") &&
+    !normalized.includes("mateooo93-cortex") &&
+    !normalized.includes("@mateooo93/cortex")
+  ) {
+    return true;
+  }
+  return false;
+}
+
+function warnIfShadowed() {
+  const shimPath = npmGlobalBin();
+  const firstOnPath = resolveCortexOnPath();
+
+  if (!shimPath || !firstOnPath) {
+    return;
+  }
+
+  let same = false;
+  try {
+    same = fs.realpathSync(shimPath) === fs.realpathSync(firstOnPath);
+  } catch {
+    same = shimPath === firstOnPath;
+  }
+
+  if (same || !looksLikeCognitiveScale(firstOnPath)) {
+    return;
+  }
+
+  console.warn("");
+  console.warn("cortex-cli: another `cortex` command comes first on your PATH:");
+  console.warn(`  ${firstOnPath}`);
+  console.warn(`@mateooo93/cortex shim: ${shimPath}`);
+  console.warn("");
+  console.warn("Remove the conflicting CognitiveScale CLI, then open a new terminal:");
+  console.warn("  npm uninstall -g cortex-cli");
+  console.warn("  bun remove -g cortex-cli   # if installed via bun");
+  console.warn("");
+  console.warn("Or run this package directly until PATH is fixed:");
+  console.warn(`  ${shimPath}`);
+  console.warn("");
+}
+
+module.exports = { warnIfShadowed, resolveCortexOnPath, looksLikeCognitiveScale };

package/lib/run.js

@@ -4,6 +4,7 @@ const { spawn } = require("child_process");
 const fs = require("fs");
 
 const { ensureBinary } = require("./install");
+const { name: packageName } = require("../package.json");
 
 async function main() {
   let binaryPath;
@@ -16,14 +17,14 @@ async function main() {
 
   if (!binaryPath || !fs.existsSync(binaryPath)) {
     console.error(
-      "cortex-cli: native binary not installed. Re-run: npm install -g mateooo93-cortex"
+      `cortex-cli: native binary not installed. Re-run: npm install -g ${packageName} --registry=https://npm.pkg.github.com`
     );
     process.exit(1);
   }
 
   const env = {
     ...process.env,
-    CORTEX_NPM_PACKAGE: "mateooo93-cortex",
+    CORTEX_NPM_PACKAGE: packageName,
     CORTEX_NPM_SHIM: __filename,
   };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mateooo93-cortex",
-  "version": "0.25.21",
+  "version": "0.25.23",
   "description": "Fast AI coding agent with a polished terminal UI (npm wrapper — downloads the native binary for your OS)",
   "license": "AGPL-3.0-or-later",
   "repository": {