@glasshome/widget-cli 0.10.6 → 0.11.1

package/bin/cli.ts

@@ -33,7 +33,7 @@ Commands:
   publish [hub-url]      Build and publish a widget to Hub
   login [hub-url]        Authenticate with GlassHome Hub
   info [name]            Show widget metadata and bundle info
-  upgrade                Upgrade @glasshome/widget-sdk to latest version
+  upgrade                Upgrade @glasshome/widget-sdk (latest, or --to <version>) and sync manifests
   migrate config         Rewrite widgets' raw-zod config to defineConfig + field.*
                          --name <widget> targets one; --dry previews without writing
   help                   Show this help message
@@ -56,6 +56,7 @@ Examples:
   glasshome-widget login
   glasshome-widget login https://my-hub.example.com
   glasshome-widget upgrade
+  glasshome-widget upgrade --to 1.10.3
   glasshome-widget publish --dir packages/widgets
 `.trim();
 
@@ -68,6 +69,7 @@ const { values: flags, positionals } = parseArgs({
     name: { type: "string" },
     bump: { type: "string" },
     scope: { type: "string" },
+    to: { type: "string" },
     "re-auth": { type: "boolean" },
     isolate: { type: "boolean" },
     dry: { type: "boolean" },
@@ -193,7 +195,7 @@ switch (effectiveCommand) {
 
   case "upgrade": {
     const { runUpgrade } = await import("../src/commands/upgrade");
-    await runUpgrade(resolveWidgetDir());
+    await runUpgrade(resolveWidgetDir(), { to: str(flags.to) });
     outro("Done");
     break;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glasshome/widget-cli",
-  "version": "0.10.6",
+  "version": "0.11.1",
   "description": "CLI for creating and managing GlassHome widgets",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "@fontsource-variable/geist-mono": "^5.2.8",
     "@glasshome/sync-layer": "0.7.2",
     "@glasshome/widget-contract": "0.2.0",
-    "@glasshome/widget-sdk": "1.10.3",
+    "@glasshome/widget-sdk": "1.11.0",
     "@iconify-json/lucide": "^1.2.0",
     "@iconify-json/mdi": "^1.2.3",
     "@tailwindcss/vite": "^4.1.13",

package/src/commands/connect.ts

@@ -2,7 +2,7 @@ import { existsSync, readdirSync, readFileSync, statSync, watch } from "node:fs"
 import { resolve } from "node:path";
 import { log, note, spinner } from "@clack/prompts";
 import color from "picocolors";
-import { buildWidgets } from "@glasshome/widget-sdk/vite";
+import { buildWidgets, createIntrospectSession } from "@glasshome/widget-sdk/vite";
 import { trpcMutate, trpcQuery } from "../utils/api";
 import { clearHostToken, extractHost, getHostToken, storeHostToken } from "../utils/auth";
 import { lintAndReport } from "../utils/lint-source";
@@ -348,6 +348,9 @@ export async function runConnect(
   const pending = new Set<string>();
   let debounceTimer: ReturnType<typeof setTimeout> | null = null;
   let buildInFlight = false;
+  // One worker for the whole session: a fresh introspection process per save is
+  // the boot tax this avoids (docs/superpowers/specs/2026-08-18-widget-sdk-persistent-introspect-worker-design.md).
+  const introspectSession = createIntrospectSession();
 
   async function flush(): Promise<void> {
     debounceTimer = null;
@@ -362,7 +365,9 @@ export async function runConnect(
       const origCwd = process.cwd();
       process.chdir(cwd);
       try {
-        await withQuietStdout(() => buildWidgets({ ...buildOpts, only: widgets }));
+        await withQuietStdout(() =>
+          buildWidgets({ ...buildOpts, only: widgets, session: introspectSession }),
+        );
       } finally {
         process.chdir(origCwd);
       }
@@ -421,6 +426,9 @@ export async function runConnect(
     log.info("Disconnecting...");
     if (debounceTimer) clearTimeout(debounceTimer);
     watcher.close();
+    // connect never exits normally, so without this the worker only dies via
+    // its stdin-EOF watchdog.
+    await introspectSession.dispose();
 
     for (const slug of registeredTags) {
       try {

package/src/commands/preview.ts

@@ -21,14 +21,8 @@ export async function runPreview(cwd: string, names: string[], isolate: boolean)
     process.exit(1);
   }
 
-  // Capture the REAL stdout writer before withQuietStdout no-ops
-  // process.stdout.write. A clack spinner writes through that same override and
-  // would freeze inside the quiet block, so progress goes out this bound
-  // reference (which the override cannot intercept) as plain lines. Build/vite
-  // noise stays silenced; only these phase lines get through.
-  const realWrite = process.stdout.write.bind(process.stdout);
   const progress = (m: string) => {
-    realWrite(`${color.gray("│")}  ${color.dim(m)}\n`);
+    process.stdout.write(`${color.gray("│")}  ${color.dim(m)}\n`);
   };
 
   log.info(names.length ? `Previewing ${names.join(", ")}` : "Previewing all widgets");

package/src/commands/upgrade.test.ts

@@ -0,0 +1,20 @@
+import { describe, expect, test } from "bun:test";
+import { sdkDependencySection } from "./upgrade";
+
+describe("sdkDependencySection", () => {
+  test("finds the SDK in whichever section declares it", () => {
+    expect(sdkDependencySection({ peerDependencies: { "@glasshome/widget-sdk": "^1.10.2" } })).toBe(
+      "peerDependencies",
+    );
+    expect(sdkDependencySection({ devDependencies: { "@glasshome/widget-sdk": "^1.10.2" } })).toBe(
+      "devDependencies",
+    );
+    expect(sdkDependencySection({ dependencies: { "@glasshome/widget-sdk": "^1.10.2" } })).toBe(
+      "dependencies",
+    );
+  });
+
+  test("returns null when the SDK is not declared", () => {
+    expect(sdkDependencySection({ dependencies: { zod: "^4" } })).toBeNull();
+  });
+});

package/src/commands/upgrade.ts

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
-import { log, note, spinner } from "@clack/prompts";
+import { log, spinner } from "@clack/prompts";
 import { discoverWidgets, readManifest, writeManifest } from "../utils/manifest";
 import { getInstalledSdkVersion } from "../utils/sdk-version";
 import { runValidate } from "./validate";
@@ -58,20 +58,60 @@ function syncManifestSdkVersions(cwd: string, newVersion: string): void {
   log.info(`Updated sdkVersion to ${sdkRange} in ${widgets.length} manifest(s)`);
 }
 
-export async function runUpgrade(cwd: string): Promise<void> {
+const SDK_PKG = "@glasshome/widget-sdk";
+
+type DependencySection = "peerDependencies" | "devDependencies" | "dependencies";
+type PackageManifest = Partial<Record<DependencySection, Record<string, string>>>;
+
+const SECTION_FLAG: Record<DependencySection, string[]> = {
+  peerDependencies: ["--peer"],
+  devDependencies: ["--dev"],
+  dependencies: [],
+};
+
+/** Which section declares the SDK, so the bump lands where the author put it. */
+export function sdkDependencySection(pkg: PackageManifest): DependencySection | null {
+  const sections: DependencySection[] = ["peerDependencies", "devDependencies", "dependencies"];
+  return sections.find((section) => pkg[section]?.[SDK_PKG] !== undefined) ?? null;
+}
+
+/**
+ * Standalone project: `bun add` the SDK at the requested version (default
+ * latest) into the section that already declares it. Bun installs the SDK's
+ * required peers alongside, so @glasshome/ui follows without a second step.
+ */
+function bumpSdkDependency(cwd: string, section: DependencySection, target: string): boolean {
+  const s = spinner();
+  s.start(`Installing ${SDK_PKG}@${target}...`);
+  const proc = Bun.spawnSync(["bun", "add", ...SECTION_FLAG[section], `${SDK_PKG}@${target}`], {
+    cwd,
+  });
+  if (proc.exitCode !== 0) {
+    s.stop("Install failed");
+    log.error(proc.stderr.toString());
+    return false;
+  }
+  s.stop(`Installed ${SDK_PKG}@${target}`);
+  return true;
+}
+
+export interface UpgradeOptions {
+  /** Version or dist-tag to move to in a standalone project. Default "latest". */
+  to?: string;
+}
+
+export async function runUpgrade(cwd: string, options: UpgradeOptions = {}): Promise<void> {
   const pkgPath = resolve(cwd, "package.json");
   if (!existsSync(pkgPath)) {
     log.error("No package.json found in current directory.");
     process.exit(1);
   }
 
-  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-  const currentVersion =
-    pkg.peerDependencies?.["@glasshome/widget-sdk"] ??
-    pkg.devDependencies?.["@glasshome/widget-sdk"] ??
-    pkg.dependencies?.["@glasshome/widget-sdk"];
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8")) as PackageManifest;
+  const section = sdkDependencySection(pkg);
+  const currentVersion = section ? pkg[section]?.[SDK_PKG] : undefined;
 
-  if (!currentVersion) {
+  if (!section || !currentVersion) {
     log.error("@glasshome/widget-sdk is not listed in dependencies or peerDependencies.");
     process.exit(1);
   }
@@ -125,27 +165,21 @@ export async function runUpgrade(cwd: string): Promise<void> {
     return;
   }
 
-  // Standalone project. Bumping the dependency is still the author's call, but
-  // syncing the manifests to whatever is installed is not: a manifest range
-  // that excludes the installed SDK fails validation, and this is the command
-  // that error tells people to run.
+  // Standalone project: bump the dependency, then sync every manifest to what
+  // is now installed. A manifest range that excludes the installed SDK fails
+  // validation, and this is the command that error tells people to run.
+  if (!bumpSdkDependency(cwd, section, options.to ?? "latest")) process.exit(1);
+
   const installed = getInstalledSdkVersion(cwd);
-  if (installed) {
-    syncManifestSdkVersions(cwd, installed);
-    const valid = await runValidate(cwd);
-    if (!valid) log.warn(`Synced manifests to ${installed}, but validation found problems above.`);
-  } else {
+  if (!installed) {
     log.warn("No @glasshome/widget-sdk installed here, so manifests were left alone.");
+    return;
+  }
+  syncManifestSdkVersions(cwd, installed);
+  const valid = await runValidate(cwd);
+  if (valid) {
+    log.success(`Upgraded to @glasshome/widget-sdk@${installed}`);
+  } else {
+    log.warn(`Upgraded to ${installed}, but validation found problems above.`);
   }
-
-  log.info("To move to a different SDK version:");
-  note(
-    [
-      "1. Bump @glasshome/widget-sdk in package.json peerDependencies",
-      "2. bun install",
-      "3. bun widget upgrade   (sync manifest files)",
-      "4. bun widget validate  (check compatibility)",
-    ].join("\n"),
-    "To upgrade",
-  );
 }

package/src/utils/quiet.ts

@@ -1,20 +1,24 @@
 /**
- * Run `fn` with stdout writes swallowed. `buildWidgets()` (SDK) console.logs a
+ * Run `fn` with console logging swallowed. `buildWidgets()` (SDK) logs a
  * "[registry] Generated..." line mid-build; when the caller drives a clack
- * spinner that raw write lands on the spinner's line and garbles it. Stderr is
- * left alone so real warnings/errors still surface.
+ * spinner that line lands on the spinner's line and garbles it.
+ *
+ * Only the console methods are silenced, never `process.stdout.write`: a clack
+ * spinner renders its frames through that write, so overriding it left every
+ * caller's spinner frozen for the whole build. Bun's console writes to fd 1
+ * natively and bypasses a `process.stdout.write` override anyway, so the
+ * console patch is the one that ever did the work. Stderr is left alone so real
+ * warnings and errors still surface.
  */
 export async function withQuietStdout<T>(fn: () => Promise<T>): Promise<T> {
-  const originalWrite = process.stdout.write.bind(process.stdout);
   const originalLog = console.log;
-  // Bun's console.log writes to fd 1 natively and bypasses a process.stdout.write
-  // override, so both paths are silenced.
-  process.stdout.write = (() => true) as typeof process.stdout.write;
+  const originalInfo = console.info;
   console.log = () => {};
+  console.info = () => {};
   try {
     return await fn();
   } finally {
-    process.stdout.write = originalWrite;
     console.log = originalLog;
+    console.info = originalInfo;
   }
 }