claude-term-tabs 2.1.0 → 2.1.2

package/README.md

@@ -1,5 +1,9 @@
 # claude-term-tabs
 
+[![npm](https://img.shields.io/npm/v/claude-term-tabs)](https://www.npmjs.com/package/claude-term-tabs)
+[![Release](https://github.com/ecoutu/claude-term-tabs/actions/workflows/release.yml/badge.svg)](https://github.com/ecoutu/claude-term-tabs/actions/workflows/release.yml)
+[![License: MIT](https://img.shields.io/npm/l/claude-term-tabs)](LICENSE)
+
 Find a running Claude Code session by what you remember about it, and switch to its terminal tab.
 
 ```bash
@@ -136,21 +140,23 @@ 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
-pull request rules.
+No runtime dependencies. A clone runs the TypeScript directly; the npm package ships it built to JavaScript.
+[CONTRIBUTING.md](CONTRIBUTING.md) has the commit and pull request rules.
 
 ### Releases
 
 Every push to `main` runs CI, then semantic-release reads the conventional commit
-messages since the last tag and, when any warrant it, tags the next version (`fix:` patch,
-`feat:` minor, `BREAKING CHANGE:` major), adds the notes to [CHANGELOG.md](CHANGELOG.md) and
-publishes a GitHub release. Nothing is published to npm, and `package.json` keeps a placeholder
-version; the git tag is the version.
+messages since the last tag and, when any warrant it, tags the next version (`fix:`, `perf:` or
+`docs(readme):` patch, `feat:` minor, `!` or `BREAKING CHANGE:` major), adds the notes to
+[CHANGELOG.md](CHANGELOG.md), publishes the package to npm with provenance and creates a GitHub
+release. `package.json` keeps a placeholder version; the git tag is the version.
+[CONTRIBUTING.md](CONTRIBUTING.md) explains how the npm publish works.
 
 ### Manual checks
 

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.2",
   "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",