pi-superwhisper-paste 0.1.15 → 0.1.17

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 (3) hide show
  1. package/CHANGELOG.md +132 -121
  2. package/README.md +89 -22
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,121 +1,132 @@
1
- # Changelog
2
-
3
- All notable changes to this project will be documented in this file.
4
-
5
- This project follows semantic versioning.
6
-
7
- ## [0.1.15] - 2026-06-05
8
-
9
- ### Changed
10
-
11
- - Remove stale template-maintenance docs (`github-template.md`, `repository-settings.md`, `typescript.md`) from the published package.
12
-
13
- ## [0.1.14] - 2026-06-05
14
-
15
- ### Changed
16
-
17
- - Re-add `Code` / `Cursor` host processes to the clipboard-owner denylist so editor-hosted clipboard updates are blocked again during debugging.
18
-
19
- ## [0.1.13] - 2026-06-05
20
-
21
- ### Fixed
22
-
23
- - Remove `Code.exe` / `Cursor.exe` from the terminal-owner denylist so editor-hosted Superwhisper clipboard updates are not blocked just because Pi is running inside Code/Cursor.
24
-
25
- ## [0.1.12] - 2026-06-05
26
-
27
- ### Changed
28
-
29
- - Add an explicit `v0.1.12` marker to the status text so stale package loads are visible during live debugging.
30
-
31
- ## [0.1.11] - 2026-06-05
32
-
33
- ### Fixed
34
-
35
- - Broaden the terminal clipboard-owner denylist with `OpenConsole` / explicit `.exe` variants.
36
- - Surface the last clipboard decision in the Pi status text (`blocked ...`, `... via ...`) so real-machine owner mismatches can be diagnosed quickly.
37
-
38
- ## [0.1.10] - 2026-06-05
39
-
40
- ### Fixed
41
-
42
- - Fix the Windows PowerShell clipboard-owner probe script so the owner-aware bridge works in real Pi sessions instead of failing on multiline `Add-Type` syntax.
43
-
44
- ## [0.1.9] - 2026-06-05
45
-
46
- ### Fixed
47
-
48
- - Replace the strict Superwhisper owner allowlist with a terminal-owner denylist so unknown Superwhisper owner names still auto-paste while terminal/CLI clipboard owners stay blocked.
49
-
50
- ## [0.1.8] - 2026-06-05
51
-
52
- ### Fixed
53
-
54
- - Filter clipboard updates by clipboard-owner process so Pi auto-pastes only when the clipboard owner looks like Superwhisper.
55
- - Keep local terminal copy suppression as a fallback for forwarded copy shortcuts while blocking mouse/right-click terminal copies via owner filtering.
56
-
57
- ## [0.1.7] - 2026-06-05
58
-
59
- ### Fixed
60
-
61
- - Suppress auto-paste for a short window after local terminal copy shortcuts so copying inside the active CLI no longer pastes into Pi.
62
- - Refresh the clipboard baseline after local copy intent so the bridge keeps waiting for the next Superwhisper clipboard update.
63
-
64
- ## [0.1.6] - 2026-06-04
65
-
66
- ### Changed
67
-
68
- - Added `version:check` PR guard support: package script + `scripts/check-version-bump.mjs`.
69
- - Added CI verification that publishable changes must bump `package.json` and update `CHANGELOG.md` in the same PR.
70
-
71
- ### Fixed
72
-
73
- - Truncate clipboard text in PowerShell before writing stdout so huge clipboards no longer exceed Node `maxBuffer` on extension load.
74
- - Treat clipboard read failures (including `maxBuffer`) as empty reads so `session_start` never surfaces as an extension error.
75
-
76
- ## [0.1.5] - 2026-06-03
77
-
78
- ## [0.1.4] - 2026-06-03
79
-
80
- ### Changed
81
-
82
- - Clarify that `pi-superwhisper-paste` is the Windows clipboard-based package.
83
- - Point users to `@superwhisper/pi` only for the official deeplink/macOS flow.
84
- - Update npm package metadata to match the revived Windows-focused positioning.
85
-
86
- ## [0.1.3] - 2026-06-03
87
-
88
- ### Changed
89
-
90
- - Mark the package as archived in README and `package.json` description.
91
- - Point new installs to the official Superwhisper Pi extension: `pi install npm:@superwhisper/pi`.
92
-
93
- ## [0.1.2] - 2026-06-01
94
-
95
- ### Fixed
96
-
97
- - Register `/sw-paste:on` and `/sw-paste:off` as Pi slash commands so they appear in command autocomplete.
98
-
99
- ### Changed
100
-
101
- - Clarify that the Superwhisper paste controls are slash-autocomplete commands.
102
-
103
- ## [0.1.1] - 2026-05-31
104
-
105
- ### Added
106
-
107
- - Add automatic GitHub release creation for version bumps on `main`.
108
- - Add manual and release-published npm publish entrypoints for Trusted Publishing.
109
-
110
- ### Changed
111
-
112
- - Align CI and publish workflows with the maintained Pi OSS release pattern.
113
- - Skip npm publish when the exact package version is already published.
114
-
115
- ## [0.1.0] - YYYY-MM-DD
116
-
117
- ### Added
118
-
119
- - Initial Superwhisper paste bridge extension for Pi on Windows.
120
- - Default-on clipboard watcher with `/sw-paste:on` and `/sw-paste:off` controls.
121
- - CI and npm Trusted Publishing workflow from the Pi extension template.
1
+ # Changelog
2
+
3
+ ## Unreleased
4
+
5
+ - Add Buy Me a Coffee sponsor button to README and native GitHub funding link via `.github/FUNDING.yml`.
6
+
7
+ All notable changes to this project will be documented in this file.
8
+
9
+ This project follows semantic versioning.
10
+
11
+ ## [0.1.16] - 2026-06-27
12
+
13
+ ### Changed
14
+
15
+ - Align README with the current Pi extension template structure while preserving Windows install guidance and behavior notes.
16
+
17
+ ## [0.1.15] - 2026-06-05
18
+
19
+ ### Changed
20
+
21
+ - Remove stale template-maintenance docs (`github-template.md`, `repository-settings.md`, `typescript.md`) from the published package.
22
+
23
+ ## [0.1.14] - 2026-06-05
24
+
25
+ ### Changed
26
+
27
+ - Re-add `Code` / `Cursor` host processes to the clipboard-owner denylist so editor-hosted clipboard updates are blocked again during debugging.
28
+
29
+ ## [0.1.13] - 2026-06-05
30
+
31
+ ### Fixed
32
+
33
+ - Remove `Code.exe` / `Cursor.exe` from the terminal-owner denylist so editor-hosted Superwhisper clipboard updates are not blocked just because Pi is running inside Code/Cursor.
34
+
35
+ ## [0.1.12] - 2026-06-05
36
+
37
+ ### Changed
38
+
39
+ - Add an explicit `v0.1.12` marker to the status text so stale package loads are visible during live debugging.
40
+
41
+ ## [0.1.11] - 2026-06-05
42
+
43
+ ### Fixed
44
+
45
+ - Broaden the terminal clipboard-owner denylist with `OpenConsole` / explicit `.exe` variants.
46
+ - Surface the last clipboard decision in the Pi status text (`blocked ...`, `... via ...`) so real-machine owner mismatches can be diagnosed quickly.
47
+
48
+ ## [0.1.10] - 2026-06-05
49
+
50
+ ### Fixed
51
+
52
+ - Fix the Windows PowerShell clipboard-owner probe script so the owner-aware bridge works in real Pi sessions instead of failing on multiline `Add-Type` syntax.
53
+
54
+ ## [0.1.9] - 2026-06-05
55
+
56
+ ### Fixed
57
+
58
+ - Replace the strict Superwhisper owner allowlist with a terminal-owner denylist so unknown Superwhisper owner names still auto-paste while terminal/CLI clipboard owners stay blocked.
59
+
60
+ ## [0.1.8] - 2026-06-05
61
+
62
+ ### Fixed
63
+
64
+ - Filter clipboard updates by clipboard-owner process so Pi auto-pastes only when the clipboard owner looks like Superwhisper.
65
+ - Keep local terminal copy suppression as a fallback for forwarded copy shortcuts while blocking mouse/right-click terminal copies via owner filtering.
66
+
67
+ ## [0.1.7] - 2026-06-05
68
+
69
+ ### Fixed
70
+
71
+ - Suppress auto-paste for a short window after local terminal copy shortcuts so copying inside the active CLI no longer pastes into Pi.
72
+ - Refresh the clipboard baseline after local copy intent so the bridge keeps waiting for the next Superwhisper clipboard update.
73
+
74
+ ## [0.1.6] - 2026-06-04
75
+
76
+ ### Changed
77
+
78
+ - Added `version:check` PR guard support: package script + `scripts/check-version-bump.mjs`.
79
+ - Added CI verification that publishable changes must bump `package.json` and update `CHANGELOG.md` in the same PR.
80
+
81
+ ### Fixed
82
+
83
+ - Truncate clipboard text in PowerShell before writing stdout so huge clipboards no longer exceed Node `maxBuffer` on extension load.
84
+ - Treat clipboard read failures (including `maxBuffer`) as empty reads so `session_start` never surfaces as an extension error.
85
+
86
+ ## [0.1.5] - 2026-06-03
87
+
88
+ ## [0.1.4] - 2026-06-03
89
+
90
+ ### Changed
91
+
92
+ - Clarify that `pi-superwhisper-paste` is the Windows clipboard-based package.
93
+ - Point users to `@superwhisper/pi` only for the official deeplink/macOS flow.
94
+ - Update npm package metadata to match the revived Windows-focused positioning.
95
+
96
+ ## [0.1.3] - 2026-06-03
97
+
98
+ ### Changed
99
+
100
+ - Mark the package as archived in README and `package.json` description.
101
+ - Point new installs to the official Superwhisper Pi extension: `pi install npm:@superwhisper/pi`.
102
+
103
+ ## [0.1.2] - 2026-06-01
104
+
105
+ ### Fixed
106
+
107
+ - Register `/sw-paste:on` and `/sw-paste:off` as Pi slash commands so they appear in command autocomplete.
108
+
109
+ ### Changed
110
+
111
+ - Clarify that the Superwhisper paste controls are slash-autocomplete commands.
112
+
113
+ ## [0.1.1] - 2026-05-31
114
+
115
+ ### Added
116
+
117
+ - Add automatic GitHub release creation for version bumps on `main`.
118
+ - Add manual and release-published npm publish entrypoints for Trusted Publishing.
119
+
120
+ ### Changed
121
+
122
+ - Align CI and publish workflows with the maintained Pi OSS release pattern.
123
+ - Skip npm publish when the exact package version is already published.
124
+
125
+ ## [0.1.0] - YYYY-MM-DD
126
+
127
+ ### Added
128
+
129
+ - Initial Superwhisper paste bridge extension for Pi on Windows.
130
+ - Default-on clipboard watcher with `/sw-paste:on` and `/sw-paste:off` controls.
131
+ - CI and npm Trusted Publishing workflow from the Pi extension template.
132
+
package/README.md CHANGED
@@ -1,21 +1,65 @@
1
1
  # Pi Superwhisper Paste
2
2
 
3
- > Windows-focused Pi bridge for Superwhisper clipboard input.
4
- >
5
- > The official Superwhisper Pi package (`@superwhisper/pi`) targets the deeplink/macOS flow. If you need the clipboard-based Windows workaround, use this package.
6
-
7
3
  [![CI](https://github.com/eiei114/pi-superwhisper-paste/actions/workflows/ci.yml/badge.svg)](https://github.com/eiei114/pi-superwhisper-paste/actions/workflows/ci.yml)
8
4
  [![Publish](https://github.com/eiei114/pi-superwhisper-paste/actions/workflows/publish.yml/badge.svg)](https://github.com/eiei114/pi-superwhisper-paste/actions/workflows/publish.yml)
9
5
  [![npm version](https://img.shields.io/npm/v/pi-superwhisper-paste.svg)](https://www.npmjs.com/package/pi-superwhisper-paste)
6
+ [![npm downloads](https://img.shields.io/npm/dm/pi-superwhisper-paste.svg)](https://www.npmjs.com/package/pi-superwhisper-paste)
10
7
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
8
+ [![Pi package](https://img.shields.io/badge/pi-package-purple.svg)](https://pi.dev/packages)
9
+ [![Trusted Publishing](https://img.shields.io/badge/npm-Trusted%20Publishing-blue.svg)](docs/release.md)
10
+ <a href="https://buymeacoffee.com/ekawano114m"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" width="217" height="60"></a>
11
+
12
+ > Windows-focused Pi bridge that pastes Superwhisper clipboard output into Pi's TUI editor.
13
+
14
+ ## What this is
15
+
16
+ Superwhisper can paste dictated text into normal Windows apps, but terminal TUIs can be a rough edge. In the original case, dictation worked in Notepad and PowerShell, and Typeless worked in Pi, but Superwhisper's automatic paste did not reliably reach Pi's TUI editor without a manual `Ctrl+V`.
17
+
18
+ This package bridges that gap from the Pi side: it watches the Windows clipboard, detects new Superwhisper output, and inserts it into the active Pi editor with Pi's extension API.
19
+
20
+ The official Superwhisper Pi package (`@superwhisper/pi`) targets the deeplink/macOS flow. If you need the clipboard-based Windows workaround, use this package.
21
+
22
+ ## Features
23
+
24
+ - Default-on after the extension loads on Windows.
25
+ - Slash commands: `/sw-paste:on` and `/sw-paste:off`.
26
+ - Windows clipboard polling with active-tab gating.
27
+ - Brief copy-suppression window so local terminal copy actions do not get auto-pasted back into Pi.
28
+ - Clipboard-owner filtering so terminal/CLI-owned clipboard updates stay blocked by default.
29
+
30
+ ## Install
11
31
 
12
- ## Recommended install on Windows
32
+ Install the published npm package with Pi:
13
33
 
14
34
  ```bash
15
35
  pi install npm:pi-superwhisper-paste
16
36
  ```
17
37
 
18
- ## Official package
38
+ Pin a specific version when you want reproducible installs:
39
+
40
+ ```bash
41
+ pi install npm:pi-superwhisper-paste@0.1.16
42
+ ```
43
+
44
+ Install into the current project instead of your user Pi settings:
45
+
46
+ ```bash
47
+ pi install npm:pi-superwhisper-paste -l
48
+ ```
49
+
50
+ Or install from GitHub:
51
+
52
+ ```bash
53
+ pi install git:github.com/eiei114/pi-superwhisper-paste
54
+ ```
55
+
56
+ Try it without permanently installing:
57
+
58
+ ```bash
59
+ pi -e npm:pi-superwhisper-paste
60
+ ```
61
+
62
+ ### Official Superwhisper package
19
63
 
20
64
  If you are using the official Superwhisper Pi integration instead:
21
65
 
@@ -25,40 +69,63 @@ pi install npm:@superwhisper/pi
25
69
 
26
70
  Docs: https://superwhisper.com/pi
27
71
 
28
- ## Why this package exists
72
+ ## Quick start
29
73
 
30
- Superwhisper can paste dictated text into normal Windows apps, but terminal TUIs can be a rough edge. In the original case, dictation worked in Notepad and PowerShell, and Typeless worked in Pi, but Superwhisper's automatic paste did not reliably reach Pi's TUI editor without a manual `Ctrl+V`.
74
+ After install, start Pi and dictate with Superwhisper. New Superwhisper clipboard output should auto-paste into the active Pi editor when the bridge is on.
31
75
 
32
- This package bridges that gap from the Pi side: it watches the Windows clipboard, detects new Superwhisper output, and inserts it into the active Pi editor with Pi's extension API.
76
+ Toggle the bridge at runtime:
33
77
 
34
- ## Install
78
+ ```txt
79
+ /sw-paste:off
80
+ /sw-paste:on
81
+ ```
35
82
 
36
- From npm:
83
+ Try this package locally from a clone:
37
84
 
38
85
  ```bash
39
- pi install npm:pi-superwhisper-paste
86
+ pi -e .
40
87
  ```
41
88
 
42
- From GitHub:
89
+ ## Package contents
90
+
91
+ | Path | Purpose |
92
+ |---|---|
93
+ | `extensions/index.ts` | Pi TypeScript extension entrypoint |
94
+ | `docs/examples.md` | Usage examples |
95
+ | `docs/release.md` | Trusted Publishing release flow |
96
+ | `docs/template-checklist.md` | Maintainer template checklist |
97
+ | `CHANGELOG.md` | Version history |
98
+ | `LICENSE` | MIT license |
99
+
100
+ ## Development
43
101
 
44
102
  ```bash
45
- pi install git:github.com/eiei114/pi-superwhisper-paste
103
+ npm install
104
+ npm run ci
46
105
  ```
47
106
 
48
- ## Current behavior
107
+ ## Release
49
108
 
50
- - Default-on after the extension loads.
51
- - Slash commands: `/sw-paste:on` and `/sw-paste:off`.
52
- - Windows clipboard polling with active-tab gating.
53
- - Brief copy-suppression window so local terminal copy actions do not get auto-pasted back into Pi.
54
- - Clipboard-owner filtering so terminal/CLI-owned clipboard updates stay blocked by default.
109
+ This package is set up for npm Trusted Publishing, so no `NPM_TOKEN` is required.
110
+
111
+ ```bash
112
+ npm version patch
113
+ git push
114
+ ```
115
+
116
+ See [`docs/release.md`](docs/release.md) for setup details.
117
+
118
+ ## Security
119
+
120
+ Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.
55
121
 
56
- See [CHANGELOG.md](CHANGELOG.md) for version history.
122
+ For vulnerability reporting, see [`SECURITY.md`](SECURITY.md).
57
123
 
58
124
  ## Links
59
125
 
60
- - Windows package: https://www.npmjs.com/package/pi-superwhisper-paste
126
+ - npm: https://www.npmjs.com/package/pi-superwhisper-paste
61
127
  - GitHub: https://github.com/eiei114/pi-superwhisper-paste
128
+ - Issues: https://github.com/eiei114/pi-superwhisper-paste/issues
62
129
  - Official Superwhisper Pi package: https://superwhisper.com/pi — `@superwhisper/pi` on npm (`pi install npm:@superwhisper/pi`)
63
130
 
64
131
  ## License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-superwhisper-paste",
3
- "version": "0.1.15",
3
+ "version": "0.1.17",
4
4
  "description": "Superwhisper clipboard bridge for Pi on Windows.",
5
5
  "type": "module",
6
6
  "license": "MIT",