pi-widget-host 0.2.0 → 0.3.3

package/CHANGELOG.md

@@ -1,9 +1,37 @@
 # Changelog
 
+## Unreleased
+
+- Add Buy Me a Coffee sponsor button to README and native GitHub funding link via `.github/FUNDING.yml`.
+
 All notable changes to this project will be documented in this file.
 
 This project follows semantic versioning.
 
+## [0.3.2] - 2026-06-26
+
+### Fixed
+
+- npm Trusted Publishing publish retry after registry configuration fix (no functional changes from 0.3.1).
+
+## [0.3.1] - 2026-06-25
+
+### Changed
+
+- README install and development guidance now matches the current Pi OSS template baseline, including project-local install, `pi -e npm:pi-widget-host`, and `npm run pack:check` (`npm pack --dry-run`) validation in the public docs flow.
+- `Package contents` now lists the actual shipped paths instead of unused template resource directories.
+
+## [0.3.0] - 2026-06-24
+
+### Added
+
+- Package-readiness hardening for the first publishable Host-only MVP release boundary.
+- Explicit acceptance coverage for `matchday` event boost, known host tags, and silent empty slot behavior.
+
+### Changed
+
+- Minor semver bump marking the completed Host-only MVP: event boost, known tags, registry protocol, and demo-provider dogfooding path.
+
 ## [0.2.0] - 2026-06-15
 
 ### Added
@@ -18,3 +46,4 @@ This project follows semantic versioning.
 ### Changed
 
 - Replaced template placeholders and removed template-only skill, prompt, and theme resources.
+

package/README.md

@@ -7,6 +7,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Pi package](https://img.shields.io/badge/pi-package-purple.svg)](https://pi.dev/packages)
 [![Trusted Publishing](https://img.shields.io/badge/npm-Trusted%20Publishing-blue.svg)](docs/release.md)
+<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>
 
 > Shared-slot host for managing one prompt-top Pi widget across multiple providers.
 
@@ -32,19 +33,31 @@ v1 is a **Host-only MVP**:
 
 ## Install
 
-Published package:
+Install the published npm package with Pi:
 
 ```bash
 pi install npm:pi-widget-host
 ```
 
-GitHub install:
+Install into the current project instead of your user Pi settings:
+
+```bash
+pi install npm:pi-widget-host -l
+```
+
+Or install from GitHub:
 
 ```bash
 pi install git:github.com/eiei114/pi-widget-host
 ```
 
-Local dev:
+Try it without permanently installing:
+
+```bash
+pi -e npm:pi-widget-host
+```
+
+Local development from this repository:
 
 ```bash
 pi -e .
@@ -97,17 +110,21 @@ The built-in demo provider exists to prove the host loop first:
 
 | Path | Purpose |
 |---|---|
-| `extensions/` | Pi extension entrypoint and command registration |
-| `lib/` | config store, registry protocol, policy evaluation, demo provider |
-| `docs/` | supporting docs such as release and protocol notes |
+| `extensions/index.ts` | Pi extension entrypoint and `/widget-host:*` command registration |
+| `lib/` | config store, registry protocol, policy evaluation, and demo provider |
+| `docs/protocol.md` | registry protocol reference for future provider packages |
+| `docs/release.md` | Trusted Publishing release notes |
 
 ## Development
 
 ```bash
 npm install
 npm run ci
+npm run pack:check
 ```
 
+`npm run ci` runs typecheck, tests, and pack validation. `npm run pack:check` runs `npm pack --dry-run` to confirm the shipped tarball contents.
+
 ## Release
 
 This package uses npm Trusted Publishing.

package/extensions/index.ts

@@ -2,7 +2,7 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { readHostConfig, updateHostConfig, writeHostConfig } from "../lib/config.ts";
 import { stopDemoProviderHeartbeat, syncBuiltInDemoProvider } from "../lib/demo-provider.ts";
 import { DEFAULT_PRESET_ID, describePreset, evaluateProviderEntries, getPreset, getRemainingTtlMs, PRESET_OPTIONS } from "../lib/policy.ts";
-import { getWidgetHostRegistry, listProviderEntries, removeProviderEntry } from "../lib/registry.ts";
+import { clearHostPresent, getWidgetHostRegistry, listProviderEntries, markHostPresent, removeProviderEntry } from "../lib/registry.ts";
 import { DEMO_PROVIDER_ID, WIDGET_ID, type HostConfig, type PolicyEvaluationResult, type ProviderState } from "../lib/types.ts";
 
 type NotifyLevel = "info" | "warning" | "error";
@@ -103,6 +103,7 @@ export default function widgetHostExtension(pi: ExtensionAPI) {
   pi.on("session_start", async (_event, ctx) => {
     if (!ctx.hasUI) return;
     bindUi(ctx as { hasUI: boolean; ui: HostUiBridge });
+    markHostPresent();
     ensureRegistryWatcher();
     await refreshHostWidget(ctx as { hasUI: boolean; ui: HostUiBridge });
   });
@@ -113,6 +114,7 @@ export default function widgetHostExtension(pi: ExtensionAPI) {
     registryDispose = undefined;
     stopDemoProviderHeartbeat();
     removeProviderEntry(DEMO_PROVIDER_ID);
+    clearHostPresent();
     uiBridge = undefined;
   });
 

package/lib/demo-provider.ts

@@ -1,12 +1,18 @@
+import { createProviderRuntime, type ProviderRuntime } from "pi-widget-core/provider";
 import { readHostConfig } from "./config.ts";
 import { detectTimeBlock } from "./policy.ts";
-import { publishProviderEntry, removeProviderEntry } from "./registry.ts";
 import { DEMO_PROVIDER_ID, type HostConfig, type ProviderEntry } from "./types.ts";
 
 const HEARTBEAT_MS = 30_000;
 const ENTRY_TTL_MS = 90_000;
 
 let heartbeat: NodeJS.Timeout | undefined;
+let runtime: ProviderRuntime | undefined;
+
+function ensureRuntime(): ProviderRuntime {
+  runtime ??= createProviderRuntime({ providerId: DEMO_PROVIDER_ID });
+  return runtime;
+}
 
 function baseTagsForBlock(block: ReturnType<typeof detectTimeBlock>): string[] {
   switch (block) {
@@ -52,11 +58,10 @@ export function buildDemoProviderEntry(config: HostConfig, now = new Date()): Pr
 async function heartbeatTick(): Promise<void> {
   const config = await readHostConfig();
   if (!config.demoProviderEnabled) {
-    removeProviderEntry(DEMO_PROVIDER_ID);
     stopDemoProviderHeartbeat();
     return;
   }
-  publishProviderEntry(buildDemoProviderEntry(config));
+  ensureRuntime().update(buildDemoProviderEntry(config));
 }
 
 function ensureHeartbeat(): void {
@@ -68,17 +73,19 @@ function ensureHeartbeat(): void {
 
 export async function syncBuiltInDemoProvider(config: HostConfig): Promise<void> {
   if (!config.demoProviderEnabled) {
-    removeProviderEntry(DEMO_PROVIDER_ID);
     stopDemoProviderHeartbeat();
     return;
   }
 
-  publishProviderEntry(buildDemoProviderEntry(config));
+  ensureRuntime().update(buildDemoProviderEntry(config));
   ensureHeartbeat();
 }
 
 export function stopDemoProviderHeartbeat(): void {
-  if (!heartbeat) return;
-  clearInterval(heartbeat);
-  heartbeat = undefined;
+  if (heartbeat) {
+    clearInterval(heartbeat);
+    heartbeat = undefined;
+  }
+  runtime?.stop();
+  runtime = undefined;
 }

package/lib/registry.ts

@@ -1,89 +1,11 @@
-import { REGISTRY_SYMBOL, type ProviderEntry } from "./types.ts";
-
-type Listener = () => void;
-
-export interface WidgetHostRegistry {
-  version: 1;
-  set: (entry: ProviderEntry) => void;
-  remove: (providerId: string) => void;
-  list: () => ProviderEntry[];
-  subscribe: (listener: Listener) => () => void;
-  clear: () => void;
-}
-
-function normalizeEntry(entry: ProviderEntry): ProviderEntry {
-  return {
-    providerId: entry.providerId.trim(),
-    available: entry.available === true,
-    lines: Array.isArray(entry.lines) ? entry.lines.map((line) => String(line)) : [],
-    updatedAt: new Date(entry.updatedAt).toISOString(),
-    priority: typeof entry.priority === "number" ? entry.priority : 0,
-    tags: Array.isArray(entry.tags) ? [...new Set(entry.tags.map((tag) => String(tag).trim()).filter(Boolean))] : [],
-    mode: typeof entry.mode === "string" && entry.mode.trim().length > 0 ? entry.mode.trim() : undefined,
-    ttlMs: typeof entry.ttlMs === "number" && entry.ttlMs > 0 ? entry.ttlMs : undefined,
-  };
-}
-
-function sameEntry(left: ProviderEntry | undefined, right: ProviderEntry): boolean {
-  return JSON.stringify(left) === JSON.stringify(right);
-}
-
-function createRegistry(): WidgetHostRegistry {
-  const entries = new Map<string, ProviderEntry>();
-  const listeners = new Set<Listener>();
-  const notify = () => {
-    for (const listener of listeners) {
-      listener();
-    }
-  };
-
-  return {
-    version: 1,
-    set(entry) {
-      const normalized = normalizeEntry(entry);
-      const previous = entries.get(normalized.providerId);
-      if (sameEntry(previous, normalized)) return;
-      entries.set(normalized.providerId, normalized);
-      notify();
-    },
-    remove(providerId) {
-      if (!entries.delete(providerId)) return;
-      notify();
-    },
-    list() {
-      return [...entries.values()].map((entry) => ({ ...entry, lines: [...entry.lines], tags: [...(entry.tags ?? [])] }));
-    },
-    subscribe(listener) {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    clear() {
-      if (entries.size === 0) return;
-      entries.clear();
-      notify();
-    },
-  };
-}
-
-export function getWidgetHostRegistry(): WidgetHostRegistry {
-  const root = globalThis as typeof globalThis & Record<symbol, WidgetHostRegistry | undefined>;
-  const existing = root[REGISTRY_SYMBOL];
-  if (existing) return existing;
-  const registry = createRegistry();
-  root[REGISTRY_SYMBOL] = registry;
-  return registry;
-}
-
-export function publishProviderEntry(entry: ProviderEntry): void {
-  getWidgetHostRegistry().set(entry);
-}
-
-export function removeProviderEntry(providerId: string): void {
-  getWidgetHostRegistry().remove(providerId);
-}
-
-export function listProviderEntries(): ProviderEntry[] {
-  return getWidgetHostRegistry().list();
-}
+export {
+  clearHostPresent,
+  getWidgetHostRegistry,
+  listProviderEntries,
+  markHostPresent,
+  publishProviderEntry,
+  removeProviderEntry,
+  subscribeToProviderEntries,
+  type ProviderEntry,
+  type WidgetHostRegistry,
+} from "pi-widget-core/host";

package/lib/types.ts

@@ -1,25 +1,15 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
+import { REGISTRY_SYMBOL, type ProviderEntry } from "pi-widget-core/protocol";
 
 export const PACKAGE_NAME = "pi-widget-host";
 export const WIDGET_ID = PACKAGE_NAME;
 export const DEMO_PROVIDER_ID = `${PACKAGE_NAME}.demo`;
-export const REGISTRY_SYMBOL = Symbol.for("pi-widget-host.registry.v1");
+export { REGISTRY_SYMBOL, type ProviderEntry };
 
 export type HostTimeBlock = "morning" | "day" | "evening" | "night";
 export type KnownHostTag = "music" | "sports" | "playing-now" | "matchday" | "idle";
 
-export interface ProviderEntry {
-  providerId: string;
-  available: boolean;
-  lines: string[];
-  updatedAt: string;
-  priority?: number;
-  tags?: string[];
-  mode?: string;
-  ttlMs?: number;
-}
-
 export interface BlockPolicy {
   allowedProviderIds?: string[];
   preferredTags?: KnownHostTag[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-widget-host",
-  "version": "0.2.0",
+  "version": "0.3.3",
   "description": "Host package for managing one shared Pi widget slot across multiple providers with preset policies and a built-in demo provider.",
   "type": "module",
   "license": "MIT",
@@ -45,6 +45,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "pi-widget-core": "^0.1.0"
+  },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*"
   },
@@ -55,7 +58,7 @@
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "latest",
-    "@types/node": "^25.9.1",
+    "@types/node": "^26.0.0",
     "tsx": "^4.20.6",
     "typescript": "^6.0.3"
   }