@burakboduroglu/portkill 0.4.1 → 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +10 -11
  2. package/package.json +11 -3
package/README.md CHANGED
@@ -8,6 +8,8 @@
8
8
 
9
9
  > The name reads like **`.portkill`** — a small, local dev utility (think `.env`-style prefix). The CLI binary is still `portkill`.
10
10
 
11
+ **Published on npm:** [`@burakboduroglu/portkill`](https://www.npmjs.com/package/@burakboduroglu/portkill) — install with `npm i -g @burakboduroglu/portkill` or `npx @burakboduroglu/portkill` (see [Install](#install)).
12
+
11
13
  When Node or another stack prints `EADDRINUSE`, **`.portkill`** shows who owns the port, lets you **preview** (`--dry-run`), then stops only what you intend — or opens a **calm local web UI** on loopback.
12
14
 
13
15
  ---
@@ -25,6 +27,8 @@ When Node or another stack prints `EADDRINUSE`, **`.portkill`** shows who owns t
25
27
 
26
28
  ## Install
27
29
 
30
+ Registry page: [npmjs.com/package/@burakboduroglu/portkill](https://www.npmjs.com/package/@burakboduroglu/portkill).
31
+
28
32
  ```bash
29
33
  npm i -g @burakboduroglu/portkill
30
34
  portkill --version
@@ -36,15 +40,6 @@ No global install:
36
40
  npx @burakboduroglu/portkill --list
37
41
  ```
38
42
 
39
- **Homebrew (tap)** — needs [@burakboduroglu/portkill on npm](https://www.npmjs.com/package/@burakboduroglu/portkill). Then:
40
-
41
- ```bash
42
- brew tap burakboduroglu/portkill
43
- brew install portkill
44
- ```
45
-
46
- Tap: [github.com/burakboduroglu/homebrew-portkill](https://github.com/burakboduroglu/homebrew-portkill) · [docs/homebrew.md](https://github.com/burakboduroglu/portkill/blob/main/docs/homebrew.md)
47
-
48
43
  **From source**
49
44
 
50
45
  ```bash
@@ -76,6 +71,10 @@ portkill --gui
76
71
 
77
72
  Press **Ctrl+C** to stop the GUI server. The printed URL is loopback-only.
78
73
 
74
+ ### GUI walkthrough (video)
75
+
76
+ [![portkill --gui: local web UI walkthrough](https://img.youtube.com/vi/_-Z6zwiEHmg/hqdefault.jpg)](https://youtu.be/_-Z6zwiEHmg)
77
+
79
78
  ---
80
79
 
81
80
  ## CLI flags (short)
@@ -108,7 +107,7 @@ Full reference: [CLI reference](https://github.com/burakboduroglu/portkill/blob/
108
107
  | [Implementation](https://github.com/burakboduroglu/portkill/blob/main/docs/implementation.md) | Architecture & data flow |
109
108
  | [Data dictionary](https://github.com/burakboduroglu/portkill/blob/main/DATA_DICTIONARY.md) | Types, GUI API shapes |
110
109
  | [Security notes](https://github.com/burakboduroglu/portkill/blob/main/docs/security-notes.md) | GUI scope, `npm audit`, reporting |
111
- | [Release](https://github.com/burakboduroglu/portkill/blob/main/docs/RELEASE.md) | `npm publish` (2FA), tags, checksums, tap updates |
110
+ | [Release](https://github.com/burakboduroglu/portkill/blob/main/docs/RELEASE.md) | `npm publish` (2FA), tags, GitHub Release |
112
111
 
113
112
  ---
114
113
 
@@ -127,7 +126,7 @@ Terminal colors use [chalk](https://github.com/chalk/chalk); set `NO_COLOR=1` to
127
126
 
128
127
  ## npm vs GitHub README
129
128
 
130
- **The same `README.md` is what npm shows** on [npmjs.com/package/@burakboduroglu/portkill](https://www.npmjs.com/package/@burakboduroglu/portkill) — it is listed in `package.json` `"files"`. Links to deep docs use **GitHub URLs** so they still work from the npm page (the `docs/` folder is not inside the published tarball).
129
+ This file is the **npm package readme** for [`@burakboduroglu/portkill`](https://www.npmjs.com/package/@burakboduroglu/portkill) (included via `package.json` `"files"`). **Distribution is npm only** (`npm i -g` / `npx`). Full source, `docs/`, and the PRD are on [GitHub](https://github.com/burakboduroglu/portkill); in-repo links use GitHub URLs so they work from the npm package page too.
131
130
 
132
131
  ---
133
132
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@burakboduroglu/portkill",
3
- "version": "0.4.1",
3
+ "version": "0.4.3",
4
4
  "description": "Kill processes listening on TCP ports — CLI for macOS/Linux: dry-run, port ranges, --list, optional local web UI (--gui). Node.js 18+.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -34,9 +34,17 @@
34
34
  "test:watch": "vitest",
35
35
  "lint": "eslint .",
36
36
  "format": "prettier --write .",
37
- "prepublishOnly": "npm run build && npm test"
37
+ "release:bump-patch": "npm version patch --no-git-tag-version",
38
+ "release:bump-minor": "npm version minor --no-git-tag-version",
39
+ "prepublishOnly": "node scripts/assert-version-not-published.mjs && npm run build && npm test"
38
40
  },
39
- "keywords": ["cli", "port", "kill", "lsof", "dev"],
41
+ "keywords": [
42
+ "cli",
43
+ "port",
44
+ "kill",
45
+ "lsof",
46
+ "dev"
47
+ ],
40
48
  "license": "MIT",
41
49
  "dependencies": {
42
50
  "chalk": "^5.4.1",