@naxodev/opencode-music-player 0.2.5 → 0.3.0

package/README.md

@@ -16,6 +16,10 @@ Read the [music session architecture field guide](../../docs/music-session-archi
 
 The daemon performs the bounded native `media-control get --now` read and validates the complete recording identity before and after the read. OpenCode uses those bytes when available, then keeps iTunes Search fallback, image downloads, conversion, cache/job ownership, and terminal rendering locally. Artwork failure never blocks playback state.
 
+Catalog matching, bounded downloads, cancellation, and transient retries use the [shared host-side acquisition policy](../music-core/README.md#host-side-catalog-artwork). OpenCode keeps image conversion and its shared presentation cache/jobs. Track changes remove only the changing view's interest; another view can keep the same job alive.
+
+Run `/music-artwork`, or select **Music → Refresh artwork** in the command palette, to recover artwork for the current track after connectivity returns. Automatic recovery stops after three transient attempts. A settled mismatch does not retry on playback snapshots. Refresh starts a new bounded attempt set; repeated refreshes while a job is active share that job. This action does not change playback.
+
 Ghostty and other terminals with Kitty graphics support display the cover as a native image. Other terminals receive a true-color half-block rendering of the same cover.
 
 Terminal multiplexers must pass Kitty graphics through to use native images. The player uses the half-block rendering when the host does not expose that support.
@@ -34,13 +38,13 @@ set -g allow-passthrough on
 ```
 
 > [!IMPORTANT]
-> This package targets the beta OpenCode 2 TUI plugin API in `opencode2 v0.0.0-next-17444`. OpenCode may change this API before its stable release.
+> This source targets stable `opencode v2.0.3`. The previous beta host is unsupported. See the [compatibility contract](../../docs/opencode-compatibility.md) for the exact dependency set and release requirements.
 
 ## Requirements
 
 - macOS
-- OpenCode 2 `v0.0.0-next-17444`
-- Bun, which OpenCode uses to load TypeScript plugin packages
+- OpenCode `v2.0.3`
+- The Bun-based OpenCode runtime; Bun 1.3.7 for workspace development
 - [`media-control`](https://github.com/ungive/media-control), recommended:
 
   ```sh
@@ -52,17 +56,19 @@ set -g allow-passthrough on
 
 ## Install
 
-Add the package to the `plugin` array in your global `~/.config/opencode/tui.jsonc` or project `.opencode/tui.jsonc`:
+Add the package to `plugins` in your global `~/.config/opencode/cli.json` (or `$XDG_CONFIG_HOME/opencode/cli.json`):
 
 ```jsonc
 {
-  "$schema": "https://opencode.ai/tui.json",
-  "plugin": ["@naxodev/opencode-music-player"],
+  "$schema": "https://opencode.ai/v2/cli.json",
+  "plugins": ["@naxodev/opencode-music-player"],
 }
 ```
 
 OpenCode installs npm plugin packages and their production dependencies in its isolated cache. Restart OpenCode after changing the package entry.
 
+This package requires the supported OpenCode Bun host. The host supplies the exact plugin API, OpenTUI, and Solid versions through its runtime resolver. The plugin API and OpenTUI are optional peers. Solid is required from the host but omitted from npm peer metadata because of an upstream peer-version conflict. Music-core and pngjs remain production dependencies. Standalone loading outside OpenCode is unsupported. Workspace development uses all four exact pins from the lockfile.
+
 ### Local checkout
 
 OpenCode imports local packages directly and does not install their dependencies. Install them first:
@@ -71,26 +77,23 @@ OpenCode imports local packages directly and does not install their dependencies
 git clone https://github.com/naxodev/ai.git
 cd ai
 bun install --frozen-lockfile
+bun run --cwd packages/opencode-music-player build
 ```
 
 Then reference the absolute package path:
 
 ```jsonc
 {
-  "$schema": "https://opencode.ai/tui.json",
-  "plugin": ["/absolute/path/to/ai/packages/opencode-music-player"],
+  "$schema": "https://opencode.ai/v2/cli.json",
+  "plugins": ["/absolute/path/to/ai/packages/opencode-music-player/dist"],
 }
 ```
 
 ## Verify
 
-Start OpenCode and list active plugin IDs:
-
-```sh
-opencode2 api get /api/plugin
-```
+The package precompiles JSX to JavaScript and keeps every package import external. `npm pack` builds the artifact automatically. Rebuild after source edits for local testing; the host watches the generated entrypoints.
 
-The response should include `music-player`. If it does not, inspect `~/.local/share/opencode/log/opencode.log` for package resolution or setup errors.
+Start `opencode` and run `/plugins` in the TUI. The list should include `music-player`. CLI-only plugins do not appear in the server plugin API. Inspect `~/.local/share/opencode/log/opencode.log` for package resolution or setup errors.
 
 ## Controls
 

package/SUPPORT.md

@@ -2,6 +2,6 @@
 
 Use [GitHub Discussions](https://github.com/naxodev/ai/discussions) for installation and usage questions.
 
-Use [GitHub Issues](https://github.com/naxodev/ai/issues) for reproducible defects and focused feature requests. Include your macOS version, `opencode2 --version`, package version, media backend, and relevant redacted logs.
+Use [GitHub Issues](https://github.com/naxodev/ai/issues) for reproducible defects and focused feature requests. Include your macOS version, `opencode --version`, package version, media backend, and relevant redacted logs.
 
 Security reports must follow the workspace [security policy](../../SECURITY.md).