craft-native 0.0.92 → 0.0.95

package/dist/android/templates/MainActivity.kt.template

@@ -1,10 +1,14 @@
 package {{PACKAGE_NAME}}
 
 import android.annotation.SuppressLint
+import android.content.Context
 import android.os.Bundle
 import android.content.Intent
 import android.graphics.Bitmap
+import android.net.ConnectivityManager
+import android.net.Network
 import android.net.Uri
+import android.util.Log
 import android.webkit.WebResourceRequest
 import android.webkit.WebResourceError
 import android.webkit.WebResourceResponse
@@ -19,6 +23,20 @@ import org.json.JSONObject
 import java.io.FileNotFoundException
 import java.net.URLConnection
 
+/** Main-frame failures for which the bundled app is an honest fallback (#254). */
+object CraftLoadFailure {
+    fun isUnreachable(errorCode: Int): Boolean = when (errorCode) {
+        WebViewClient.ERROR_HOST_LOOKUP,
+        WebViewClient.ERROR_CONNECT,
+        WebViewClient.ERROR_TIMEOUT,
+        // Android uses ERROR_IO for connection interruptions as well as local
+        // I/O failures. Keep it here deliberately: it is the closest Android
+        // equivalent to iOS's NSURLErrorNetworkConnectionLost.
+        WebViewClient.ERROR_IO -> true
+        else -> false
+    }
+}
+
 class MainActivity : AppCompatActivity() {
     private lateinit var webView: WebView
     private lateinit var craftBridge: CraftBridge
@@ -32,6 +50,28 @@ class MainActivity : AppCompatActivity() {
             .build()
     }
     private var loadedBundledFallback = false
+    private lateinit var connectivityManager: ConnectivityManager
+    @Volatile
+    private var isConnected = false
+    private var networkMonitoringRegistered = false
+    private val networkCallback = object : ConnectivityManager.NetworkCallback() {
+        override fun onAvailable(network: Network) {
+            val wasConnected = isConnected
+            isConnected = true
+            if (!wasConnected && isConnected) {
+                runOnUiThread {
+                    returnFromBundledFallback("the network came back")
+                }
+            }
+        }
+
+        override fun onLost(network: Network) {
+            // A second transport can already be the default by the time the
+            // old one reports its loss, so read current state instead of
+            // blindly turning the latch off.
+            isConnected = connectivityManager.activeNetwork != null
+        }
+    }
 
     @SuppressLint("SetJavaScriptEnabled")
     override fun onCreate(savedInstanceState: Bundle?) {
@@ -46,21 +86,29 @@ class MainActivity : AppCompatActivity() {
         craftBridge = CraftBridge(this, webView, CraftHealthConnect(this, webView))
         // The link that launched the app (#215). Queued until the page's bridge
         // is injected, then dispatched once with `initial: true`, so a page that
-        // subscribes rather than calling getInitialURL still hears it. A
-        // relaunch from Recents carries the old intent, and was not opened by it.
-        // A recreated activity restores what the bridge saved: its intent may
-        // be a later warm link that onNewIntent set.
+        // subscribes rather than calling getInitialURL still hears it.
+        //
+        // A relaunch from Recents carries the intent the app was first opened
+        // with. The person picked the task out of a list, not the link or the
+        // shortcut inside it, and neither is news the second time — so both
+        // are skipped, not just the link (#229).
+        //
+        // A recreated activity restores what the bridge saved rather than
+        // reading its intent, which onNewIntent may have replaced with a
+        // later warm link.
+        val launchedFromHistory = intent.flags and Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY != 0
         if (savedInstanceState == null) {
-            val launchLink = intent.data?.toString()
-            val launchedFromHistory = intent.flags and Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY != 0
-            if (launchLink != null && !launchedFromHistory) craftBridge.receiveDeepLink(launchLink)
+            if (!launchedFromHistory) {
+                intent.data?.toString()?.let(craftBridge::receiveDeepLink)
+                handleIncomingShortcut(intent)
+            }
         } else {
             craftBridge.restoreDeepLinks(savedInstanceState)
         }
-        if (savedInstanceState == null) handleIncomingShortcut(intent)
 
         setupWebView()
         loadContent()
+        setupNetworkMonitoring()
     }
 
     @SuppressLint("SetJavaScriptEnabled")
@@ -106,7 +154,13 @@ class MainActivity : AppCompatActivity() {
 
             override fun onReceivedError(view: WebView?, request: WebResourceRequest?, error: WebResourceError?) {
                 super.onReceivedError(view, request, error)
-                if (request?.isForMainFrame == true && hasBundledFallback && !loadedBundledFallback) {
+                if (
+                    request?.isForMainFrame == true &&
+                    error != null &&
+                    CraftLoadFailure.isUnreachable(error.errorCode) &&
+                    hasBundledFallback &&
+                    !loadedBundledFallback
+                ) {
                     loadedBundledFallback = true
                     webView.loadUrl(BUNDLED_APP_URL)
                 }
@@ -119,6 +173,23 @@ class MainActivity : AppCompatActivity() {
         webView.addJavascriptInterface(craftBridge, "CraftAndroid")
     }
 
+    private fun setupNetworkMonitoring() {
+        if (!hasBundledFallback || devServerUrl == null) return
+        connectivityManager = getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
+        isConnected = connectivityManager.activeNetwork != null
+        connectivityManager.registerDefaultNetworkCallback(networkCallback)
+        networkMonitoringRegistered = true
+    }
+
+    /** Leave the bundled copy for the configured remote origin again. */
+    private fun returnFromBundledFallback(reason: String) {
+        val remoteUrl = devServerUrl ?: return
+        if (!loadedBundledFallback) return
+        loadedBundledFallback = false
+        Log.i(TAG, "$reason; loading $remoteUrl again instead of the bundled copy")
+        webView.loadUrl(remoteUrl)
+    }
+
     private fun loadContent() {
         // Check for dev server URL in config
         val remoteUrl = devServerUrl
@@ -227,6 +298,7 @@ class MainActivity : AppCompatActivity() {
     override fun onResume() {
         super.onResume()
         webView.onResume()
+        returnFromBundledFallback("the app returned to the foreground")
     }
 
     override fun onPause() {
@@ -235,6 +307,10 @@ class MainActivity : AppCompatActivity() {
     }
 
     override fun onDestroy() {
+        if (networkMonitoringRegistered) {
+            connectivityManager.unregisterNetworkCallback(networkCallback)
+            networkMonitoringRegistered = false
+        }
         craftBridge.close()
         webView.destroy()
         super.onDestroy()
@@ -256,6 +332,7 @@ class MainActivity : AppCompatActivity() {
     }
 
     companion object {
+        private const val TAG = "CraftMainActivity"
         private const val BUNDLED_APP_HOST = "appassets.androidplatform.net"
         private const val BUNDLED_APP_ORIGIN = "https://appassets.androidplatform.net"
         private const val BUNDLED_APP_URL = "$BUNDLED_APP_ORIGIN/"

package/dist/api/mobile.d.ts

@@ -617,6 +617,22 @@ export interface NotificationOptions {
     /** Schedule for future (timestamp) */
     scheduleAt?: number;
 }
+/** A notification as the bridges read it: `delay` in place of `scheduleAt`. */
+export type BridgeNotification = Omit<NotificationOptions, 'scheduleAt'> & {
+    delay?: number;
+};
+/**
+ * The bridges' spelling of a notification: `scheduleAt` becomes `delay`.
+ *
+ * Both bridges schedule from `delay`, milliseconds from now, and iOS also from
+ * `timestamp`; neither reads `scheduleAt`, so a reminder meant for an hour
+ * from now fired at once (#261). `delay` rather than `timestamp` because
+ * Android reads only `delay`, and because an interval is what an instant
+ * means, where iOS's calendar trigger would move with the device's time zone.
+ * A moment already past sends no delay at all, which both bridges deliver
+ * now: a zero delay raises inside UserNotifications on the Swift side.
+ */
+export declare function bridgeNotification(options: NotificationOptions, now?: number): BridgeNotification;
 /**
  * Local notifications API.
  *
@@ -693,7 +709,23 @@ export declare const appReview: {
 export declare const pushNotifications: {
     register(): Promise<string>;
     onToken(callback: (token: string) => void): () => void;
+    /**
+     * A tap on a notification, with the payload it was sent with.
+     *
+     * Goes through the bridge's replay where there is one, so a tap that
+     * launched the app still reaches a page that subscribes once it has
+     * hydrated — rather than only one listening before the bridge was ready.
+     */
     onNotification(callback: (data: Record<string, unknown>) => void): () => void;
+    /**
+     * A notification that arrived while the app was open, with the payload it
+     * was sent with — the same shape `onNotification` hands a tap.
+     *
+     * The banner still shows. This is for a page that wants to react while it
+     * is on screen, such as refreshing what the push was about. Live only: an
+     * arrival before the page subscribed is not held for it. iOS only for now.
+     */
+    onReceive(callback: (data: Record<string, unknown>) => void): () => void;
 };
 export type HealthDataType = 'steps' | 'heartRate' | 'activeEnergy' | 'distance' | 'workouts';
 export interface HealthDataOptions {

package/dist/binary-resolver.d.ts

@@ -46,6 +46,10 @@ export declare function resolveCraftBinary(explicit?: string): string;
  * path-matrix behaviour the pantry contract exists to remove. So instead the
  * spawn is marked, and a CLI that starts up already marked knows it *is* the
  * thing that was spawned, and says so.
+ *
+ * Both spawners set it: `runCraftBinary()` in the CLI, and `CraftApp.show()`
+ * in the SDK. The SDK one was missing until #236, so every SDK caller on such
+ * a machine still met the raw parser error this marker exists to replace.
  */
 export declare const CRAFT_CLI_SPAWN_MARKER = "CRAFT_CLI_SPAWNED_FROM";
 /**

package/dist/cli.js

@@ -1736,7 +1736,8 @@ __export(exports_src2, {
   open: () => open2,
   installRuntime: () => installRuntime2,
   init: () => init2,
-  build: () => build2
+  build: () => build2,
+  ANDROID_MIN_SDK: () => ANDROID_MIN_SDK
 });
 import { cpSync as cpSync3, existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync4, rmSync as rmSync3, statSync as statSync2, writeFileSync as writeFileSync4 } from "fs";
 import { dirname as dirname2, extname, isAbsolute, join as join3, relative, resolve as resolve2, sep } from "path";
@@ -1840,6 +1841,9 @@ function validateAndroidConfig(config) {
       throw new Error(`Android ${name} must be a positive integer`);
     }
   }
+  if (Number(config.minSdk) < ANDROID_MIN_SDK) {
+    throw new Error(`Android minSdk must be at least ${ANDROID_MIN_SDK} (Android 8.0) for the Craft runtime`);
+  }
   if (Number(config.minSdk) > Number(config.targetSdk)) {
     throw new Error("Android minSdk must not exceed targetSdk");
   }
@@ -1977,7 +1981,6 @@ async function init2(options) {
   if (config.enableBackgroundLocation)
     config.enableGeolocation = true;
   if (config.enableHealthConnect) {
-    config.minSdk = Math.max(config.minSdk ?? 26, 26);
     config.compileSdk = Math.max(config.compileSdk ?? 36, 36);
   }
   normalizeAndroidNetworkConfig(config);
@@ -2061,7 +2064,7 @@ async function init2(options) {
   const projectGradleTemplate = readFileSync4(join3(TEMPLATES_DIR2, "build.gradle.kts.project.template"), "utf-8");
   writeFileSync4(join3(output, "build.gradle.kts"), projectGradleTemplate.replace(/\{\{GOOGLE_SERVICES_PLUGIN\}\}/g, hasGoogleServices ? '    id("com.google.gms.google-services") version "4.4.2" apply false' : ""));
   const appGradleTemplate = readFileSync4(join3(TEMPLATES_DIR2, "build.gradle.kts.app.template"), "utf-8");
-  const appGradle = appGradleTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{VERSION_NAME\}\}/g, escapeKotlinString(config.version || "1.0.0")).replace(/\{\{VERSION_CODE\}\}/g, String(config.versionCode || 1)).replace(/\{\{MIN_SDK\}\}/g, String(config.minSdk || 24)).replace(/\{\{COMPILE_SDK\}\}/g, String(config.compileSdk || 36)).replace(/\{\{TARGET_SDK\}\}/g, String(config.targetSdk || 35)).replace(/\{\{GOOGLE_SERVICES_PLUGIN\}\}/g, hasGoogleServices ? '    id("com.google.gms.google-services")' : "").replace(/\{\{FIREBASE_MESSAGING_DEPENDENCY\}\}/g, config.enablePushNotifications ? '    implementation("com.google.firebase:firebase-messaging:24.1.0")' : "").replace(/\{\{HEALTH_CONNECT_DEPENDENCIES\}\}/g, config.enableHealthConnect ? `    implementation("androidx.health.connect:connect-client:1.1.0")
+  const appGradle = appGradleTemplate.replace(/\{\{PACKAGE_NAME\}\}/g, finalPackageName).replace(/\{\{VERSION_NAME\}\}/g, escapeKotlinString(config.version || "1.0.0")).replace(/\{\{VERSION_CODE\}\}/g, String(config.versionCode || 1)).replace(/\{\{MIN_SDK\}\}/g, String(config.minSdk ?? ANDROID_MIN_SDK)).replace(/\{\{COMPILE_SDK\}\}/g, String(config.compileSdk || 36)).replace(/\{\{TARGET_SDK\}\}/g, String(config.targetSdk || 35)).replace(/\{\{GOOGLE_SERVICES_PLUGIN\}\}/g, hasGoogleServices ? '    id("com.google.gms.google-services")' : "").replace(/\{\{FIREBASE_MESSAGING_DEPENDENCY\}\}/g, config.enablePushNotifications ? '    implementation("com.google.firebase:firebase-messaging:24.1.0")' : "").replace(/\{\{HEALTH_CONNECT_DEPENDENCIES\}\}/g, config.enableHealthConnect ? `    implementation("androidx.health.connect:connect-client:1.1.0")
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.8.1")` : "");
   writeFileSync4(join3(output, "app/build.gradle.kts"), appGradle);
   const proguardTemplate = readFileSync4(join3(TEMPLATES_DIR2, "proguard-rules.pro.template"), "utf-8");
@@ -2359,7 +2362,7 @@ window.__craftRejectPendingPromises = function(message) {
         if (entry) entry.settle(false, new Error(message || 'Android bridge closed'));
     });
 };
-`, TEMPLATES_DIR2, LOCAL_DEVELOPMENT_HOSTS, KOTLIN_KEYWORDS, DEFAULT_CONFIG2, RUNTIME_ABIS;
+`, TEMPLATES_DIR2, LOCAL_DEVELOPMENT_HOSTS, KOTLIN_KEYWORDS, ANDROID_MIN_SDK = 26, DEFAULT_CONFIG2, RUNTIME_ABIS;
 var init_src2 = __esm(() => {
   ({ $: $2 } = globalThis.Bun);
   TEMPLATES_DIR2 = join3(dirname2(import.meta.dir), "templates");
@@ -2413,7 +2416,7 @@ var init_src2 = __esm(() => {
     enableDeepLinks: false,
     urlSchemes: [],
     trustedOrigins: [],
-    minSdk: 26,
+    minSdk: ANDROID_MIN_SDK,
     compileSdk: 36,
     targetSdk: 35
   };
@@ -4530,7 +4533,7 @@ function craftBinaryIsCliShimMessage(spawnedFrom) {
   return [
     `"${spawnedFrom}" on PATH is the Craft CLI, not the native binary.`,
     "",
-    "The CLI spawned it expecting the native build, and re-entered itself \u2014",
+    "Craft spawned it expecting the native build and reached this CLI instead \u2014",
     "which is why an option you never typed (--url) came back as unknown.",
     "",
     "Fix it in one of two ways:",
@@ -4584,7 +4587,7 @@ function pinCraftNativeDependency(packagePath, craftVersion) {
 `);
 }
 // package.json
-var version = "0.0.92";
+var version = "0.0.95";
 
 // bin/cli.ts
 var spawnedFrom = process6.env[CRAFT_CLI_SPAWN_MARKER];
@@ -5072,10 +5075,16 @@ cli.command("publish", "Publish app to App Store or Play Store").option("--ios",
   }
 });
 cli.command("init <name>", "Initialize a new Craft project").option("--template <type>", "Project template (blank, tabs, drawer, dashboard, desktop, ios, android, all)", { default: "blank" }).option("--bundle-id <id>", "Bundle identifier for mobile").example("craft init MyApp").example("craft init MyApp --template tabs").example("craft init MyApp --template dashboard").example("craft init MyApp --template all").action(async (name, options) => {
+  const template = options?.template || "blank";
+  const templates = ["blank", "tabs", "drawer", "dashboard", "desktop", "ios", "android", "all"];
+  if (!templates.includes(template)) {
+    console.error(`Error: Unknown template "${template}"`);
+    console.error(`Available templates: ${templates.join(", ")}`);
+    process6.exit(1);
+  }
   console.log(`
 \u26A1 Creating new Craft project: ${name}
 `);
-  const template = options?.template || "blank";
   const bundleId = options?.bundleId || `com.example.${name.toLowerCase().replace(/[^a-z0-9]/g, "")}`;
   const appNameSlug = name.toLowerCase().replace(/[^a-z0-9]/g, "-");
   const { mkdirSync: mkdirSync4, writeFileSync: writeFileSync5, existsSync: existsSync7, readdirSync: readdirSync3, readFileSync: readFileSync5, cpSync: cpSync4 } = await import("fs");

package/dist/index.cjs

@@ -218,6 +218,7 @@ __export(exports_src, {
   createArcSidebar: () => createArcSidebar,
   createApp: () => createApp,
   craftUnavailableMessage: () => craftUnavailableMessage,
+  craftProcessFailedMessage: () => craftProcessFailedMessage,
   craftBinaryNotFoundMessage: () => craftBinaryNotFoundMessage,
   copy: () => copy,
   components: () => exports_components,
@@ -291,6 +292,7 @@ function resolveCraftBinary(explicit) {
   }
   return "craft";
 }
+var CRAFT_CLI_SPAWN_MARKER = "CRAFT_CLI_SPAWNED_FROM";
 function craftBinaryNotFoundMessage(triedPath) {
   return [
     `Craft native binary not found (tried "${triedPath}").`,
@@ -307,6 +309,11 @@ function craftBinaryNotFoundMessage(triedPath) {
   ].join(`
 `);
 }
+// package.json
+var version = "0.0.95";
+
+// src/sdk-version.ts
+var SDK_VERSION = version;
 
 // src/package.ts
 var import_child_process = require("child_process");
@@ -422,13 +429,13 @@ async function packageApp(config) {
 }
 async function packageMacOS(config, outDir) {
   const results = [];
-  const { name, version, bundleId = `com.myapp.${name.toLowerCase()}` } = config;
+  const { name, version: version2, bundleId = `com.myapp.${name.toLowerCase()}` } = config;
   const opts = config.macos || {};
   const hardenedRuntime = !opts.appStore;
   const appBundlePath = import_path.join(outDir, `${name}.app`);
   const appBundle = createMacOSAppBundle({
     name,
-    version,
+    version: version2,
     bundleId,
     buildNumber: opts.buildNumber,
     category: opts.category,
@@ -472,7 +479,7 @@ async function packageMacOS(config, outDir) {
   }
   results.push({ success: true, platform: "macos", format: "app", outputPath: appBundlePath });
   if (opts.dmg !== false) {
-    const outputPath = import_path.join(outDir, `${name}-${version}.dmg`);
+    const outputPath = import_path.join(outDir, `${name}-${version2}.dmg`);
     const dmgResult = await createDMG({ appBundlePath, outputPath, volumeName: name });
     results.push({
       success: dmgResult.success,
@@ -485,12 +492,12 @@ async function packageMacOS(config, outDir) {
       results.push(...await notarizeIfRequested(opts, outputPath, "dmg"));
   }
   if (opts.pkg || opts.appStore) {
-    const outputPath = import_path.join(outDir, `${name}-${version}.pkg`);
+    const outputPath = import_path.join(outDir, `${name}-${version2}.pkg`);
     const pkgResult = await createPKG({
       appBundlePath,
       outputPath,
       identifier: bundleId,
-      version,
+      version: version2,
       appStore: opts.appStore === true,
       installerIdentity: opts.installerIdentity
     });
@@ -536,14 +543,14 @@ async function notarizeIfRequested(opts, artifactPath, format) {
 }
 async function packageWindows(config, outDir) {
   const results = [];
-  const { name, version } = config;
+  const { name, version: version2 } = config;
   const opts = config.windows || {};
   if (opts.msi !== false) {
     const msiResult = await createMSI({
       name,
-      version,
+      version: version2,
       binaryPath: config.binaryPath,
-      outputPath: import_path.join(outDir, `${name}-${version}.msi`),
+      outputPath: import_path.join(outDir, `${name}-${version2}.msi`),
       manufacturer: config.author || "Unknown",
       architecture: opts.architecture || windowsArchitecture(process.arch),
       certificatePath: opts.certificatePath,
@@ -560,9 +567,9 @@ async function packageWindows(config, outDir) {
   if (opts.zip || opts.msi === false) {
     const zipResult = await createZIP({
       name,
-      version,
+      version: version2,
       binaryPath: config.binaryPath,
-      outputPath: import_path.join(outDir, `${name}-${version}-windows.zip`)
+      outputPath: import_path.join(outDir, `${name}-${version2}-windows.zip`)
     });
     results.push({
       success: zipResult.success,
@@ -576,14 +583,14 @@ async function packageWindows(config, outDir) {
 }
 async function packageLinux(config, outDir) {
   const results = [];
-  const { name, version } = config;
+  const { name, version: version2 } = config;
   const opts = config.linux || {};
   if (opts.deb !== false) {
     const debResult = await createDEB({
       name,
-      version,
+      version: version2,
       binaryPath: config.binaryPath,
-      outputPath: import_path.join(outDir, `${name}_${version}_amd64.deb`),
+      outputPath: import_path.join(outDir, `${name}_${version2}_amd64.deb`),
       description: config.description || "",
       maintainer: config.author || "Unknown",
       dependencies: opts.debDependencies || ["libgtk-3-0", "libwebkit2gtk-4.1-37"]
@@ -599,9 +606,9 @@ async function packageLinux(config, outDir) {
   if (opts.rpm) {
     const rpmResult = await createRPM({
       name,
-      version,
+      version: version2,
       binaryPath: config.binaryPath,
-      outputPath: import_path.join(outDir, `${name}-${version}-1.x86_64.rpm`),
+      outputPath: import_path.join(outDir, `${name}-${version2}-1.x86_64.rpm`),
       description: config.description || "",
       requires: opts.rpmDependencies || ["gtk3", "webkit2gtk3"]
     });
@@ -616,9 +623,9 @@ async function packageLinux(config, outDir) {
   if (opts.appImage) {
     const appImageResult = await createAppImage({
       name,
-      version,
+      version: version2,
       binaryPath: config.binaryPath,
-      outputPath: import_path.join(outDir, `${name}-${version}-x86_64.AppImage`),
+      outputPath: import_path.join(outDir, `${name}-${version2}-x86_64.AppImage`),
       iconPath: config.iconPath
     });
     results.push({
@@ -2809,7 +2816,7 @@ class SystemTray {
   }
   async setIcon(icon) {
     this._options.icon = icon;
-    await this._call("setIcon", icon);
+    await this._call("setIcon", JSON.stringify({ icon }));
   }
   async setTooltip(tooltip) {
     this._options.tooltip = tooltip;
@@ -2823,6 +2830,9 @@ class SystemTray {
         if (!processedItem.id && processedItem.label) {
           processedItem.id = `menu_${index}_${Date.now()}`;
         }
+        if (!processedItem.action && processedItem.id && processedItem.type !== "separator") {
+          processedItem.action = processedItem.id;
+        }
         if (processedItem.submenu) {
           processedItem.submenu = processItems(processedItem.submenu);
         }
@@ -2885,9 +2895,9 @@ class SystemTray {
       return new Promise((resolve, reject) => {
         try {
           window.webkit.messageHandlers.craft.postMessage({
-            type: "tray",
-            action,
-            data: typeof data === "string" ? data : JSON.stringify(data)
+            t: "tray",
+            a: action,
+            d: typeof data === "string" ? data : JSON.stringify(data)
           });
           resolve(undefined);
         } catch (error) {
@@ -4167,8 +4177,8 @@ var crypto = {
     if (combined.length < 1 + SALT_LEN + IV_LEN + TAG_LEN) {
       throw new CraftCryptoError("Ciphertext too short to be valid");
     }
-    const version = combined[0];
-    if (version !== FORMAT_VERSION) {
+    const version2 = combined[0];
+    if (version2 !== FORMAT_VERSION) {
       throw new LegacyCiphertextError;
     }
     const salt = combined.slice(1, 1 + SALT_LEN);
@@ -5133,6 +5143,13 @@ var lifecycle = {
     return () => document.removeEventListener("visibilitychange", handler);
   }
 };
+function bridgeNotification(options, now = Date.now()) {
+  const { scheduleAt, ...rest } = options;
+  if (scheduleAt === undefined)
+    return rest;
+  const wait = Math.ceil(scheduleAt - now);
+  return wait > 0 ? { ...rest, delay: wait } : rest;
+}
 var notifications = {
   async show(options) {
     const craft = getCraftMobile();
@@ -5146,7 +5163,7 @@ var notifications = {
   async schedule(options) {
     const craft = getCraftMobile();
     if (typeof window !== "undefined" && craft?.notifications) {
-      return craft.notifications.schedule(options);
+      return craft.notifications.schedule(bridgeNotification(options));
     }
     throw new Error("Scheduled notifications not available in web");
   },
@@ -10822,14 +10839,14 @@ async function updaterCommand(args) {
   switch (subcommand) {
     case "check": {
       const url = rest[0];
-      const version = rest[1] || "0.0.0";
+      const version2 = rest[1] || "0.0.0";
       if (!url) {
         console.error("Usage: craft updater check <update-url> [current-version]");
         process.exit(1);
       }
       const updater = new AutoUpdater({
         updateUrl: url,
-        currentVersion: version,
+        currentVersion: version2,
         appPath: process.cwd(),
         autoDownload: false
       });
@@ -10863,14 +10880,14 @@ ${update.releaseNotes}`);
       break;
     }
     case "generate-manifest": {
-      const version = rest[0];
+      const version2 = rest[0];
       const outputPath = rest[1] || "update.json";
-      if (!version) {
+      if (!version2) {
         console.error("Usage: craft updater generate-manifest <version> [output]");
         process.exit(1);
       }
       const manifest = {
-        version,
+        version: version2,
         releaseDate: new Date().toISOString(),
         platforms: {}
       };
@@ -10902,21 +10919,13 @@ var updater_default = AutoUpdater;
 // src/index.ts
 var execFileAsync2 = import_node_util.promisify(import_node_child_process.execFile);
 var versionMismatchWarned = false;
-function getSdkVersion() {
-  try {
-    const pkgPath = import_node_path.join("/home/runner/work/craft/craft/packages/typescript/src", "..", "package.json");
-    return JSON.parse(import_node_fs2.readFileSync(pkgPath, "utf-8")).version ?? "unknown";
-  } catch {
-    return "unknown";
-  }
-}
 async function probeBinaryVersion(craftPath) {
   if (versionMismatchWarned)
     return;
   try {
     const { stdout } = await execFileAsync2(craftPath, ["--version"], { timeout: 2000 });
     const nativeVersion = parseCraftVersionOutput(stdout);
-    const sdkVersion = getSdkVersion();
+    const sdkVersion = SDK_VERSION;
     if (sdkVersion !== "unknown" && nativeVersion && nativeVersion !== sdkVersion) {
       versionMismatchWarned = true;
       console.warn(`⚠️  Craft binary/SDK version mismatch: SDK=${sdkVersion}, native=${nativeVersion}.
@@ -10926,7 +10935,27 @@ async function probeBinaryVersion(craftPath) {
 }
 function parseCraftVersionOutput(output) {
   const firstLine = output.trim().split(/\r?\n/, 1)[0] ?? "";
-  return firstLine.replace(/^craft version\s+/i, "").replace(/^v/, "").trim();
+  const withoutName = firstLine.replace(/^craft(?:\s+version)?[\s/]+/i, "").trim();
+  const firstToken = withoutName.split(/\s+/, 1)[0] ?? "";
+  return firstToken.replace(/^v/, "").trim();
+}
+var STDERR_TAIL_LIMIT = 4000;
+function craftProcessFailedMessage(code, stderr, quiet) {
+  const said = stderr.trim();
+  const header = `❌ Craft process exited with code ${code}`;
+  if (said)
+    return `${header}
+
+${said}`;
+  const where = quiet ? "It wrote nothing to stderr. Re-run without `quiet` to see its full output." : "Check the console output above for more details.";
+  return `${header}
+
+` + `This may indicate:
+` + `  • Invalid window configuration
+` + `  • Malformed HTML content
+` + `  • System resource constraints
+
+` + where;
 }
 function detectDevMode() {
   if (typeof process === "undefined")
@@ -10989,8 +11018,14 @@ class CraftApp {
     const args = this.buildArgs();
     const craftPath = await this.findCraftBinary();
     probeBinaryVersion(craftPath);
+    const quiet = this.config.quiet === true;
     this.process = import_node_child_process.spawn(craftPath, args, {
-      stdio: this.config.quiet ? "ignore" : "inherit"
+      stdio: quiet ? ["ignore", "ignore", "pipe"] : "inherit",
+      env: { ...process.env, [CRAFT_CLI_SPAWN_MARKER]: craftPath }
+    });
+    let stderrTail = "";
+    this.process.stderr?.on("data", (chunk) => {
+      stderrTail = (stderrTail + chunk.toString()).slice(-STDERR_TAIL_LIMIT);
     });
     return new Promise((resolve, reject) => {
       this.process?.on("error", (error) => {
@@ -11010,18 +11045,11 @@ class CraftApp {
 ` + `For troubleshooting, visit:
 ` + "  https://github.com/home-lang/craft/issues"));
       });
-      this.process?.on("exit", (code) => {
+      this.process?.on("close", (code) => {
         if (code === 0 || code === null) {
           resolve();
         } else {
-          reject(new Error(`❌ Craft process exited with code ${code}
-
-` + `This may indicate:
-` + `  • Invalid window configuration
-` + `  • Malformed HTML content
-` + `  • System resource constraints
-
-` + "Check the console output above for more details."));
+          reject(new Error(craftProcessFailedMessage(code, stderrTail, quiet)));
         }
       });
     });

package/dist/index.d.cts

@@ -3,7 +3,27 @@
  * TypeScript SDK powered by Bun
  */
 import type { AppConfig, WindowOptions } from './types.js';
+/**
+ * The version a `craft --version` first line reports, whichever form it takes:
+ * `craft version 0.0.92`, `craft/0.0.92 darwin-arm64 bun-v1.4.1`,
+ * `craft 0.0.92`, `v0.0.92`, or a bare `0.0.92`.
+ *
+ * The slash form is the CLI's own, and used to survive the strip intact, so
+ * the whole line was compared against a semver and never matched — two
+ * identical versions reported as drift, on the one path where the real fault
+ * was that PATH had resolved to the CLI at all (#236).
+ */
 export declare function parseCraftVersionOutput(output: string): string;
+/**
+ * The rejection for a child that exited non-zero.
+ *
+ * Whatever the child managed to say comes first, because it is the only part
+ * that can name the actual fault. `quiet` used to map to `stdio: 'ignore'`,
+ * which threw that away and then told the caller to read output that no
+ * longer existed — leaving `exited with code 1` as the whole of the error
+ * (#236).
+ */
+export declare function craftProcessFailedMessage(code: number | null, stderr: string, quiet: boolean): string;
 export { packageApp, pack, type PackageConfig, type PackageResult } from './package.js';
 export { craftBinaryNotFoundMessage, resolveCraftBinary } from './binary-resolver.js';
 export * from './utils/index.js';