claude-term-tabs 2.1.0 → 2.1.1

package/README.md

@@ -136,9 +136,10 @@ and modification time. Delete it any time.
 ## Development
 
 ```bash
-npm ci          # installs the commit hooks (husky + commitlint)
-npm run check   # type-check
+npm ci                 # installs the commit hooks (husky + commitlint)
+npm run check          # type-check
 npm test
+npm run test:package   # packs, installs and runs the npm package
 ```
 
 No runtime dependencies; Node runs the TypeScript directly. [CONTRIBUTING.md](CONTRIBUTING.md) has the commit and

package/dist/cli.js

@@ -1,5 +1,6 @@
 import { spawnSync } from 'node:child_process';
-import { closeSync, openSync, readSync } from 'node:fs';
+import { accessSync, closeSync, constants, openSync, readSync, statSync } from 'node:fs';
+import { join } from 'node:path';
 import { isatty } from 'node:tty';
 import { parseFlags, SEARCH_FLAGS } from "./args.js";
 import { DigestCache } from "./cache.js";
@@ -244,6 +245,7 @@ export function realDeps(exec = realExec, installed = false) {
         sleep: ms => new Promise(resolve => setTimeout(resolve, ms)),
         self: [process.execPath, process.argv[1]],
         completionProgram: completionProgram(process.argv[1], installed),
+        completionWarning: program => completionWarning(program, process.env.PATH ?? '', isProgram),
         shell: process.env.SHELL
     };
     return deps;
@@ -256,6 +258,29 @@ export function realDeps(exec = realExec, installed = false) {
 export function completionProgram(argv1, installed) {
     return installed ? 'claude-term-tabs' : argv1;
 }
+/**
+ * Why a completion script calling `program` won't work, if it won't. A clone's script calls its own path; an installed
+ * package's calls claude-term-tabs from PATH. npx (its cache) and a project's node_modules/.bin are on PATH only for
+ * this run, so they don't count: without a lasting copy, every Tab press would fail with "command not found".
+ */
+export function completionWarning(program, path, isProgram) {
+    if (program.includes('/'))
+        return undefined;
+    const lasting = path.split(':').filter(d => d !== '' && !d.includes('/_npx/') && !/\/node_modules\/\.bin\/?$/.test(d));
+    if (lasting.some(d => isProgram(join(d, program))))
+        return undefined;
+    return "claude-term-tabs: it isn't on your PATH outside this run, so Tab completion won't work until you run: npm install --global claude-term-tabs";
+}
+/** True for an executable file. */
+function isProgram(p) {
+    try {
+        accessSync(p, constants.X_OK);
+        return statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
 /** Entry point used by bin/claude-term-tabs, which says whether it runs the installed package. */
 export async function main(argv, { installed = false } = {}) {
     const deps = realDeps(realExec, installed);

package/dist/commands.js

@@ -102,6 +102,9 @@ function completion(argv, deps) {
         throw new Error(`unknown shell "${shell}"${where} (supported: ${SHELLS.join(', ')}); run ${SHELLS.map(s => `ctt completion ${s}`).join(' or ')}`);
     }
     deps.stdout(completionScript(shell, deps.completionProgram));
+    const warning = deps.completionWarning(deps.completionProgram);
+    if (warning !== undefined)
+        deps.stderr(warning);
     return EXIT_OK;
 }
 function focus(argv, deps) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-term-tabs",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Find a running Claude Code session by what you remember, and jump to its terminal tab",
   "type": "module",
   "license": "MIT",
@@ -38,7 +38,8 @@
     "check": "tsc",
     "prepare": "husky",
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
-    "prepack": "npm run build"
+    "prepack": "npm run build",
+    "test:package": "CTT_NO_REAL_EXEC=1 node --test 'tests/**/*.pack.ts'"
   },
   "devDependencies": {
     "@commitlint/cli": "21.2.4",