ADFA-4128 (8/11): quickbuild:core — session orchestration

quickbuild/core/src/main/java/org/appdevforall/cotg/quickbuild/data/ProxyAppInfo.kt

@@ -98,6 +98,17 @@ data class ProxyAppInfo(
 	val supportsComponentInfo: Boolean
 		get() = schema >= COMPONENT_SCHEMA_VERSION
 
+	/**
+	 * Proxy class of the activity that carries MAIN/LAUNCHER, or null when none does; a null
+	 * makes the launcher fall back to the package's default launch intent, which also resolves
+	 * an `<activity-alias>` launcher.
+	 *
+	 * The restart deploy, the rebuild relaunch and the foreground switch all launch this, so
+	 * the three cannot drift apart.
+	 */
+	val launcherProxyClass: String?
+		get() = components.firstOrNull { it.kind == ComponentKind.ACTIVITY && it.launcher }?.proxyClass
+
 	companion object {
 		private val log = LoggerFactory.getLogger("QB-ProxyAppInfo")
 

quickbuild/core/src/main/java/org/appdevforall/cotg/quickbuild/data/QuickBuildScratch.kt

@@ -135,11 +135,7 @@ class QuickBuildScratch(
 	 * the space guard. Never throws - a failure comes back as [Preparation.Failed]
 	 * with the message provisioning surfaces to the user.
 	 *
-	 * A provision that fails after this returned [Preparation.Ready] leaves the tree behind:
-	 * [remove] is keyed off the live layout, which a failed provision never sets, so the tree
-	 * waits for the next session manager start's [sweep]. Tracked as a followup under
-	 * ADFA-5423 rather than fixed here, since the failure paths that leave it live in the
-	 * provisioner.
+	 * A provision that fails after [Preparation.Ready] [remove]s the tree itself.
 	 *
 	 * @param projectRoot the project's root directory.
 	 * @return [Preparation.Ready] with the tree, or [Preparation.Failed] on a space shortfall or

quickbuild/core/src/main/java/org/appdevforall/cotg/quickbuild/domain/reload/LiveReloadExecutor.kt

@@ -72,11 +72,15 @@ sealed interface BuildOutcome {
 	 *   total beside the timing line; falls back to the build's own start with no trigger stamp.
 	 * @property restarted true when the deploy took the process-restart path (a service,
 	 *   provider or Application class changed) instead of a hot swap.
+	 * @property diagnostics the warnings the compile still produced, in the compiler's order;
+	 *   empty when it reported none or the route compiled nothing. Never an ERROR - that is a
+	 *   [CompileError].
 	 */
 	data class Success(
 		val generation: Long,
 		val durationMillis: Long,
 		val restarted: Boolean = false,
+		val diagnostics: List<BuildDiagnostic> = emptyList(),
 	) : BuildOutcome
 
 	/**
@@ -147,6 +151,15 @@ sealed interface BuildOutcome {
 		val message: String,
 		val daemonDied: Boolean = false,
 	) : BuildOutcome
+
+	companion object {
+		/**
+		 * Fallback copy for a messageless throwable escaping the pipeline. The class name is
+		 * in the ERROR log line the catch already writes, where it helps; on the status
+		 * surface it reads as gibberish.
+		 */
+		const val UNEXPECTED_FAILURE = "Quick Build stopped unexpectedly"
+	}
 }
 
 /**

quickbuild/core/src/main/java/org/appdevforall/cotg/quickbuild/domain/reload/LiveReloadOrchestrator.kt

@@ -316,6 +316,7 @@ class LiveReloadOrchestrator(
 	 * Two limits: the daemon has no cancel op, so the compile runs to completion unheard and may
 	 * delay the next build; and a stop in the deploy's own scheduler turn can report a cancel for a
 	 * payload the proxy app already took, leaving the status line one generation behind.
+	 * Tracked as ADFA-5456.
 	 *
 	 * @return true when a build was abandoned; false when there was nothing to cancel or it was a
 	 *   warm compile the user never asked for, on which the caller must report no cancellation.
@@ -713,7 +714,7 @@ class LiveReloadOrchestrator(
 					throw e
 				} catch (e: Throwable) {
 					log.error("Quick build #{} threw instead of reporting an outcome", buildId, e)
-					BuildOutcome.InfrastructureFailure(e.message ?: e.javaClass.name)
+					BuildOutcome.InfrastructureFailure(e.message ?: BuildOutcome.UNEXPECTED_FAILURE)
 				}
 			onBuildFinished(buildId, outcome)
 		}

quickbuild/core/src/main/java/org/appdevforall/cotg/quickbuild/domain/session/QuickBuildMessage.kt

@@ -74,6 +74,15 @@ sealed interface QuickBuildMessage {
 	/** The proxy app rebuild failed with no more specific cause to report. */
 	data object RebuildFailed : QuickBuildMessage
 
+	/**
+	 * Provisioning died on an unexpected error that carried no message of its own.
+	 *
+	 * The fallback for a throw whose `message` is null (a bare NPE or `check`): the exception
+	 * class name is diagnostic, belongs in the error log, and would read as gibberish on a
+	 * banner - so the user gets this named case and the log keeps the class and stack.
+	 */
+	data object ProvisioningFailedUnexpectedly : QuickBuildMessage
+
 	/**
 	 * App storage is too tight to hold the build's intermediates. Checked up front so this
 	 * fails in seconds rather than minutes into a build.
@@ -99,6 +108,16 @@ sealed interface QuickBuildMessage {
 	/** The compile daemon refused the configuration it was started with. */
 	data object DaemonRejectedConfiguration : QuickBuildMessage
 
+	/**
+	 * The compile daemon could not be started, so provisioning failed before any build ran.
+	 *
+	 * @property detail the daemon client's own reason (a spawn error, a protocol version
+	 *   mismatch, a missing reply), diagnostic rather than translatable
+	 */
+	data class DaemonStartFailed(
+		val detail: String,
+	) : QuickBuildMessage
+
 	/**
 	 * The compile daemon died and could not be restarted, so the session stays degraded until
 	 * the next tap or a session restart retries.