@fabrika/provider-contract 0.8.0 → 0.9.0-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fabrika/provider-contract",
-	"version": "0.8.0",
+	"version": "0.9.0-dev.1",
 	"type": "module",
 	"repository": {
 		"type": "git",
@@ -31,6 +31,6 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@fabrika/auth-core": "0.8.0"
+		"@fabrika/auth-core": "0.9.0-dev.1"
 	}
 }

package/src/control.ts

@@ -66,10 +66,18 @@ export interface ProviderApprovedAccess {
 	readonly checker: string
 }
 
+/**
+ * `dev`: the environment follows a workspace through a platform-owned launcher, which its provider starts instead of the
+ * serving entry (ADR-0043). The kind is Control's registry, never the application's.
+ */
+export type ProviderEnvironmentKind = 'standard' | 'dev'
+
 /** Persisted deploy data for one app environment. */
 export interface ProviderEnvironment {
 	readonly appId: string
 	readonly env: string
+	/** Absent means `standard`. */
+	readonly kind?: ProviderEnvironmentKind
 	readonly domain?: string
 	/** Canonical externally reachable HTTP(S) origin; independent of provider domain routing. */
 	readonly publicOrigin?: string
@@ -483,6 +491,21 @@ export interface ProviderNamespaceCapabilities {
 	readonly operator?: ProviderNamespaceOperator
 }
 
+/** One call on the service of a `dev` environment, between its bootstrap runs. */
+export interface ProviderDevEnvironmentInput {
+	readonly environment: ProviderEnvironment
+	readonly signal: AbortSignal
+}
+
+/**
+ * The service of a `dev` environment outside a run (ADR-0049): Control stops it after an idle period and starts it on
+ * the next commit. Files the launcher wrote survive both.
+ */
+export interface ProviderDevEnvironments {
+	stop(input: ProviderDevEnvironmentInput): Promise<void>
+	start(input: ProviderDevEnvironmentInput): Promise<void>
+}
+
 /**
  * The control-plane capability bundle selected statically by one composition root.
  *
@@ -504,6 +527,8 @@ export interface ControlProvider {
 	reconcile?(input: ProviderReconcileInput): Promise<ProviderReconcileOutcome>
 	readonly secrets?: ProviderManagedSecrets
 	readonly namespaces?: ProviderNamespaceCapabilities
+	/** Absent means the provider runs no `dev` environment, and Control refuses one. */
+	readonly devEnvironments?: ProviderDevEnvironments
 	/** Absent means the provider deploys public sources only. */
 	readonly source?: ProviderSourceCapabilities
 	/**

package/src/steps.ts

@@ -59,7 +59,9 @@ export const runSteps = async <TStep extends { readonly id: string; readonly des
 		log(`→ ${step.id}`)
 		try {
 			await untilCancelled(runOne(step), signal)
-			results.push({ id: step.id, status: 'succeeded', startedAt, finishedAt: Date.now() })
+			const finishedAt = Date.now()
+			log(`✓ ${step.id} (${((finishedAt - startedAt) / 1000).toFixed(1)}s)`)
+			results.push({ id: step.id, status: 'succeeded', startedAt, finishedAt })
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error)
 			stopped = true