@palettelab/cli 0.3.4 → 0.3.5

package/lib/commands/dev.js

@@ -28,17 +28,40 @@ function imageExistsLocally(image) {
 }
 
 function tryPullImage(image) {
-  const res = spawnSync("docker", ["pull", image], { stdio: "inherit" })
-  return res.status === 0
+  const res = spawnSync("docker", ["pull", image], { encoding: "utf8" })
+  if (res.stdout) process.stdout.write(res.stdout)
+  if (res.stderr) process.stderr.write(res.stderr)
+  return {
+    ok: res.status === 0,
+    output: `${res.stdout || ""}${res.stderr || ""}`,
+  }
 }
 
 function ensureImageAvailable(image) {
   // Accept a locally-built image (e.g. `platform-dev:test` from `docker build`)
   // without attempting a registry pull — local is authoritative if present.
-  if (imageExistsLocally(image)) return true
+  if (imageExistsLocally(image)) return { ok: true, output: "" }
   return tryPullImage(image)
 }
 
+function imagePullHelp(image, output) {
+  const arch = `${process.platform}/${process.arch}`
+  const archHint =
+    /no matching manifest|manifest.*unknown|not found/i.test(output || "")
+      ? `            • The image tag may not include your CPU architecture (${arch}).\n` +
+        "              Platform maintainers: publish a multi-arch image for linux/amd64 and linux/arm64.\n"
+      : ""
+  return (
+    `\n[pltt] could not pull ${image}.\n` +
+    `          Most common causes:\n` +
+    archHint +
+    `            • The image hasn't been published to the registry yet.\n` +
+    `              Platform maintainers: run the platform-dev publish workflow and push the latest tag.\n` +
+    `            • You are not logged in:  docker login ghcr.io -u <github-user> -p <pat>\n` +
+    `            • You are pointing at a different tag: set PALETTE_DEV_IMAGE=<your-image> to override.\n`
+  )
+}
+
 async function run(args, { cwd }) {
   const { flags, rest } = parseFlags(args)
   const cloud = rest.includes("--cloud")
@@ -97,16 +120,10 @@ async function run(args, { cwd }) {
   // Pre-pull so we can give a useful error if the image isn't reachable
   // (common cause: maintainer hasn't pushed it yet, or `docker login ghcr.io`
   // missing). Without this, the `docker compose up` failure is cryptic.
-  if (!ensureImageAvailable(DEFAULT_IMAGE)) {
+  const image = ensureImageAvailable(DEFAULT_IMAGE)
+  if (!image.ok) {
     if (frontendWatcher) await frontendWatcher.dispose()
-    console.error(
-      `\n[pltt] could not pull ${DEFAULT_IMAGE}.\n` +
-      `          Most common causes:\n` +
-      `            • The image hasn't been published to the registry yet.\n` +
-      `              Platform maintainers: see docker/platform-dev/README.md for the build + push flow.\n` +
-      `            • You are not logged in:  docker login ghcr.io -u <github-user> -p <pat>\n` +
-      `            • You are pointing at a different tag: set PALETTE_DEV_IMAGE=<your-image> to override.\n`,
-    )
+    console.error(imagePullHelp(DEFAULT_IMAGE, image.output))
     process.exit(1)
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palettelab/cli",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Developer CLI for building Palette platform plugins — no platform source access required.",
   "bin": {
     "pltt": "bin/pltt.js"