pi-spotify-widget 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## [0.1.9] - 2026-08-04
+
+### Changed
+
+- Bump package version for the Discord release webhook verification.
+
+## [0.1.8] - 2026-07-20
+
+### Fixed
+
+- Align README release command with `npm version patch --no-git-tag-version` so tagging stays with `auto-release.yml`.
+
+### Changed
+
+- Add `version:check` PR guard and align CI bootstrap with the Pi extension template.
+
 ## [0.1.7] - 2026-07-04
 
 ### Fixed

package/README.md

@@ -1,4 +1,6 @@
 # pi-spotify-widget
+
+[![Join dotfield.xyz on Discord](https://img.shields.io/badge/Join%20dotfield.xyz%20on%20Discord-5865F2?logo=discord&logoColor=white)](https://discord.gg/4945dXZVW5)
 
 [![CI](https://github.com/eiei114/pi-spotify-widget/actions/workflows/ci.yml/badge.svg)](https://github.com/eiei114/pi-spotify-widget/actions/workflows/ci.yml)
 [![Publish](https://github.com/eiei114/pi-spotify-widget/actions/workflows/publish.yml/badge.svg)](https://github.com/eiei114/pi-spotify-widget/actions/workflows/publish.yml)
@@ -130,7 +132,7 @@ Then run:
 | `extensions/` | Pi TypeScript extension entrypoints (`index.ts`) |
 | `lib/` | Spotify auth, API client, widget render |
 | `skills/` | `spotify-playback` Agent Skill |
-| `docs/` | Release, examples, and maintainer checklist |
+| `docs/` | Release and examples |
 
 ## Development
 
@@ -149,7 +151,7 @@ Before tagging, confirm `npm run ci` and `npm pack --dry-run` pass locally.
 This package is set up for npm Trusted Publishing, so no `NPM_TOKEN` is required.
 
 ```bash
-npm version patch
+npm version patch --no-git-tag-version
 git push
 ```
 
@@ -161,7 +163,6 @@ See [`docs/release.md`](docs/release.md) for setup details.
 
 - [`docs/examples.md`](docs/examples.md)
 - [`docs/release.md`](docs/release.md)
-- [`docs/template-checklist.md`](docs/template-checklist.md) — maintainer setup checklist
 
 ## Security
 
@@ -181,4 +182,4 @@ Review extensions before installing third-party packages. For vulnerability repo
 
 ## License
 
-MIT
+MIT

package/docs/examples.md

@@ -1,15 +1,17 @@
 # Examples
 
-This template ships one minimal example for each Pi package resource type.
+Pi Spotify Widget shows Now Playing in the prompt editor widget and exposes playback commands.
 
 ## Extension
 
-`extensions/hello.ts` registers:
+`extensions/index.ts` registers:
 
-- `/template-hello`
-- a small session status indicator
+- `/spotify:login`, `/spotify:status`, `/spotify:logout`
+- `/spotify:refresh`, `/spotify:prev`, `/spotify:next`, `/spotify:pause`, `/spotify:play`
+- `/spotify:help`, `/spotify:share`, `/spotify:play-uri`
+- a prompt-editor widget with track, artist, and playback state
 
-Try it with:
+Try it locally:
 
 ```bash
 pi -e .
@@ -18,32 +20,29 @@ pi -e .
 Then run:
 
 ```txt
-/template-hello YourName
+/spotify:login
+/spotify:status
+/spotify:refresh
+/spotify:next
+/spotify:share
 ```
 
 ## Agent Skill
 
-`skills/example-skill/SKILL.md` demonstrates a minimal Agent Skill.
-
-Replace it with your real workflow instructions.
+`skills/spotify-playback/SKILL.md` maps natural-language playback and share intents to the commands above.
 
-## Prompt template
+Replace or extend it when you add new playback workflows.
 
-`prompts/example.md` demonstrates a tiny prompt template with one variable.
+## OAuth setup
 
-## Theme
+Each user supplies a Spotify Developer app Client ID (PKCE; no Client Secret required).
 
-`themes/example-theme.json` is a placeholder theme. Replace it or remove `themes/` if your package does not ship themes.
+Redirect URI: `http://127.0.0.1:8888/callback`
 
-## Typed custom tool
-
-`extensions/index.ts` registers:
+Optional environment variable before starting Pi:
 
-- `/template-info`
-- `template_greet` custom tool
-
-The tool demonstrates:
+```bash
+export PI_SPOTIFY_CLIENT_ID="your_client_id_here"
+```
 
-- TypeBox object parameters
-- a string enum schema via `StringEnum`
-- shared logic imported from `lib/greeting.ts`
+Tokens are stored locally under `~/.pi/agent/` and are not exposed in `/spotify:status` output.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-spotify-widget",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Lightweight Spotify Now Playing widget for Pi Coding Agent.",
   "type": "module",
   "license": "MIT",
@@ -32,7 +32,8 @@
     "typecheck": "tsc --noEmit",
     "test": "node --test tests/*.test.mjs",
     "ci": "npm run typecheck && npm test && npm run pack:check",
-    "pack:check": "npm pack --dry-run"
+    "pack:check": "npm pack --dry-run",
+    "version:check": "node scripts/check-version-bump.mjs"
   },
   "pi": {
     "extensions": [
@@ -52,11 +53,11 @@
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "latest",
-    "@earendil-works/pi-coding-agent": "latest",
+    "@earendil-works/pi-ai": "^0.82.1",
+    "@earendil-works/pi-coding-agent": "^0.82.1",
     "@earendil-works/pi-tui": "latest",
     "typebox": "latest",
-    "@types/node": "^25.9.1",
+    "@types/node": "^26.0.0",
     "typescript": "^6.0.3"
   }
 }

package/docs/template-checklist.md

@@ -1,85 +0,0 @@
-# Template Setup Checklist
-
-このテンプレートから新しい Pi 拡張OSSを作った後に埋めること。
-
-## Repository
-
-- [ ] GitHub repository name を決める
-- [ ] GitHub About 欄を書く
-- [ ] GitHub topics を設定する
-  - [ ] `pi`
-  - [ ] `pi-package`
-  - [ ] `agent-skill`
-  - [ ] `typescript`
-- [ ] GitHub Settingsで `Template repository` をONにする
-- [ ] Repository URL を `package.json` に反映する
-- [ ] README の `OWNER/REPO` を実リポジトリに置き換える
-
-## Package metadata
-
-- [ ] `package.json` の `name` を変更する
-- [ ] `description` を書く
-- [ ] `author` を入れる
-- [ ] `repository.url` を埋める
-- [ ] `bugs.url` を埋める
-- [ ] `homepage` を埋める
-- [ ] `keywords` を見直す
-- [ ] `LICENSE` の年・名前を更新する
-
-## README placeholders
-
-- [ ] `PACKAGE_DISPLAY_NAME` を置き換える
-- [ ] `PACKAGE_NAME` を置き換える
-- [ ] `OWNER/REPO` を置き換える
-- [ ] one-line pitch を書く
-- [ ] feature list を書く
-- [ ] quick start command を実コマンドにする
-- [ ] npm URL を確認する
-- [ ] GitHub URL を確認する
-
-## Pi package manifest
-
-- [ ] `pi.extensions` に公開する拡張だけを残す
-- [ ] `pi.skills` に公開する skill だけを残す
-- [ ] 不要なら `prompts/` を消す
-- [ ] 不要なら `themes/` を消す
-- [ ] サンプル名を実名に変える
-
-## TypeScript
-
-- [ ] `extensions/index.ts` を実装に合わせて更新する
-- [ ] `extensions/hello.ts` が不要なら削除する
-- [ ] 共通ロジックを `lib/` に切り出す
-- [ ] `strict: true` を維持する
-- [ ] custom tool parameters は TypeBox schema で定義する
-- [ ] string choices は `StringEnum` helper を使う
-- [ ] runtime dependency は `dependencies`、Pi提供packageは `peerDependencies` に置く
-- [ ] `package.json.files` に公開対象だけを入れる
-
-## GitHub Template repo
-
-- [ ] `gh repo create --template OWNER/pi-extension-template` で作成できることを確認する
-- [ ] public/privateどちらの作成例もdocsに載せる
-
-## CI / Release
-
-- [ ] `npm run ci` が通る
-- [ ] `npm pack --dry-run` が通る
-- [ ] npm Trusted Publishing を設定する
-- [ ] `NPM_TOKEN` を使っていないことを確認する
-- [ ] tag publish が動くことを初回リリースで確認する
-
-## npm page
-
-- [ ] npm package URL を README に追加する
-- [ ] npm description が適切に表示されるか確認する
-- [ ] provenance が付いているか確認する
-- [ ] 不要なファイルが package に含まれていないか確認する
-
-## Before first release
-
-- [ ] サンプルコードを実機 Pi でロードする
-- [ ] `pi install git:github.com/OWNER/REPO` を試す
-- [ ] `pi -e .` を試す
-- [ ] README のコマンドがコピペで動くか確認する
-- [ ] CHANGELOG に `0.1.0` を書く