@jr2/orchestrator 0.2.1 → 0.4.1

package/src/server.ts

@@ -1,149 +1,288 @@
-// The deployed orchestrator's entrypoint (ADR-0019): the process the instance image runs — and, by
-// the same token, the e2e tier's per-scenario fixture (ADR-0010 boots exactly this process on the
-// host). Configuration is env, kube-style; the instance folder is the process cwd (the image bakes
-// engine + `workflows/` there, ADR-0008). No dev.json, no hot-reload, no stub Harness: those were
-// host-dev affordances, and there is no host dev mode.
+// The deployed orchestrator's entrypoint (ADR-0019): the process the Orchestrator Kit image runs
+// — and, by the same token, the e2e tier's per-scenario fixture (ADR-0010 boots exactly this
+// process on the host). Configuration is env, kube-style; the instance folder is the process cwd.
+// The Kit image holds the engine there and nothing of any Instance (ADR-0069): the Workflows and
+// `jr2.config.ts` are the CURRENT ASSEMBLY's, which `jr2 up` publishes onto the state volume
+// (assembly.ts). The folder the process starts in is never loaded: a host-booted fixture publishes
+// through the same door. No dev.json, no stub Harness: those were host-dev affordances, and there
+// is no host dev mode.
 //
 //   PORT               listen port (default 4000 — what the Service targets)
 //   HOST               listen hostname (default 0.0.0.0: pods must be reachable off-loopback)
 //   JR2_INSTANCE_TOKEN  the Instance credential (ADR-0013), from the instance's Secret; minted
 //                      per boot when absent (then only the announce line knows it — fixtures set it)
+//   JR2_PUBLISH_TOKEN   the publish credential (ADR-0069): `PUT /assembly` alone accepts it. From
+//                      the same Secret; minted per boot when absent, so no host-booted process has
+//                      a publish door anyone outside it can open.
 //   JR2_SIGNING_KEY     base64 key Sandbox tokens are signed with; from the Secret so live Sandboxes
 //                      survive a pod restart. Absent → minted into `<dir>/.jr2/secret` (dev-grade).
 //   JR2_NAMESPACE       the pod's own namespace (Deployment fieldRef) — presence = "deployed":
-//                      Sandboxes are driven in it, and the Adapters' route home is Service DNS.
-//   <git.credentials[].token>
-//                      each token env var the config names rides the instance Secret (ADR-0051):
-//                      the Orchestrator materializes it into the Repo's credential Secret.
+//                      Sandboxes are driven in it, and the Custodians' route home is Service DNS.
 //
-// The first stdout line is one JSON object `{ url, workflows }` — the discovery seam a fixture (or
-// a human tailing pod logs) parses instead of racing the socket. Deployed with a data plane, the
-// boot then creates one `Repo` resource per identity its Machines bind (ADR-0051) and announces
-// each as `{ repo, url, bound: true }` — or `{ repo, error }` — one line apiece, after serving:
-// a Repo the cluster refuses is a degraded Repo (ADR-0048), never a boot that did not happen.
-// Deployed WITHOUT one, the same pass still runs and binds nothing, which unlabels every Repo a
-// previous deploy bound — an Instance that drops its last `workspace()` leaves `jr2 gc` able to
-// collect what it stopped using.
+// No git token reaches this process (ADR-0068): `jr2 up` writes each entry's clone Secret, and
+// the Repo port names it from `git-clone.json` in the `jr2-held` mount.
+//
+// The first stdout line is one JSON object `{ url, workflows, assembly, kitVersion }` — the
+// discovery seam a fixture (or a human tailing pod logs) parses instead of racing the socket.
+// `assembly` is the current Assembly's hash, or `null` with `assemblyError` saying why when the
+// volume named one this process cannot load. The line also names the runs the boot did not resume
+// (`lost`, `drifted`, `failed`; ADR-0030), each restored inside the Assembly its snapshot names,
+// and the Assemblies the boot `collected` because no live run holds them (ADR-0069), and, when any
+// exists, the named Charts as `charts: { files, runtime, unrunnable }` (ADR-0070). A boot with
+// no current Assembly restores nothing: it names the live runs it left untouched as `waiting`, and
+// the first publish that lands restores them and announces one more line,
+// `{ assembly, lost?, drifted?, failed? }`, when any run was not resumed. The hourly sweep
+// announces what it collects as one more line, `{ collected }`; a publish names it in its answer.
+// Deployed, the boot then creates one `Repo` resource per identity the Machines of its held
+// Assemblies bind (ADR-0051, ADR-0069)
+// and announces each as `{ repo, url, bound: true }` — or `{ repo, error }` — one line apiece,
+// after serving: a Repo the cluster refuses is a degraded Repo (ADR-0048), never a boot that did
+// not happen. An Assembly that binds none still runs the same pass and binds nothing, which
+// unlabels every Repo a previous deploy bound — an Instance that drops its last `workspace()`
+// leaves `jr2 gc` able to collect what it stopped using. Each publish runs the pass again. With no
+// current Assembly there is no pass: nothing says what is bound, and the next publish decides.
 
 import { join } from "node:path";
-import { loadConfig } from "./config.ts";
+import { resolveAssembly, type ResolvedAssembly } from "./assembly.ts";
+import { KIT_VERSION, loadConfig, type JR2Config } from "./config.ts";
+import { readImageRefs } from "./images.ts";
+import { readMountDigests } from "./mount-digest.ts";
+import { GIT_CLONE_MANIFEST_KEY, readGitCloneManifest } from "./git-clone.ts";
 import { loadWorkflows, startInstance, type RunningInstance } from "./instance.ts";
 import {
   HARNESS_CONFIGMAP,
   HARNESS_CONFIG_KEY,
   HARNESS_ENV_SECRET,
+  HELD_MOUNT,
   IMAGES_KEY,
   IMAGES_MOUNT,
   INSTANCE_HARNESS_PORT,
   INSTANCE_HARNESS_SERVICE,
-  ORCHESTRATOR_SERVICE,
+  INSTANCE_EFFECTOR,
+  EFFECTOR_PORT,
 } from "./names.ts";
+import type { AnyStateMachine } from "xstate";
 import { partsOf, type CarriedRepo } from "./parts.ts";
-import { kubectlRepoFetches, type RepoFetches } from "./repo-fetch.ts";
-import { kubectlRepos, type RepoResources } from "./repos.ts";
-import { kubectlSandbox, type KubectlExec } from "./sandbox-kubectl.ts";
+import { kubeClient, type KubeClient } from "./kube-client.ts";
+import { kubeRepoFetches, type RepoFetches } from "./repo-fetch.ts";
+import { kubeRepos, type RepoResources } from "./repos.ts";
+import { SANDBOX_EFFECTOR_PORT, kubeSandbox } from "./sandbox-kube.ts";
+import { sandboxEffectorService } from "./sandbox-effector.ts";
+import { watchSandboxes, type SandboxWatch } from "./sandbox-watch.ts";
 import { loadSigningKey, mintInstanceToken } from "./tokens.ts";
 import type { SandboxPort } from "./workspace.ts";
 
 export type ServerMainOptions = {
-  /** The instance folder (deployed: the image's WORKDIR; fixtures: a temp instance). */
+  /** The instance folder (deployed: the image's WORKDIR, with the state volume at `.jr2`;
+   * fixtures: a temp instance, whose `.jr2` receives what the fixture publishes). */
   dir: string;
   /** The environment to read the contract above from (deployed: `process.env`). */
   env: Record<string, string | undefined>;
   /** Where the one-line JSON announcement goes (deployed: stdout). */
   announce: (line: string) => void;
-  /** The kubectl process seam behind the data plane's two ports, injectable for tests.
-   * Deployed: the `kubectl` on PATH. */
-  exec?: KubectlExec;
+  /** The Kubernetes client behind the data plane's ports (ADR-0063), injectable for tests.
+   * Deployed: the in-cluster client over the Pod's ServiceAccount. */
+  kube?: KubeClient;
 };
 
 /** Boot the instance the env describes; resolves once serving (the caller owns signals/exit). */
 export async function serverMain(opts: ServerMainOptions): Promise<RunningInstance> {
   const { env } = opts;
-  const config = await loadConfig(opts.dir);
   const port = env.PORT !== undefined ? Number(env.PORT) : 4000;
   const signingKey =
     env.JR2_SIGNING_KEY !== undefined ? Buffer.from(env.JR2_SIGNING_KEY, "base64") : await loadSigningKey(opts.dir);
 
-  // Deployed (JR2_NAMESPACE set): Adapters dial the orchestrator at its own Service DNS — stable
-  // by nature, which is what lets live Sandboxes outlive orchestrator restarts (ADR-0013).
+  // Deployed (JR2_NAMESPACE set): Custodians dial the orchestrator at its own Service DNS — stable
+  // by nature, which is what lets live Sandboxes outlive orchestrator restarts (ADR-0013). `jr2 up`
+  // writes that address into the Custodian's bootstrap; nothing here passes it on.
   const namespace = env.JR2_NAMESPACE;
 
   // From the instance Secret when deployed; per-boot for a host-booted fixture.
   const instanceToken = env.JR2_INSTANCE_TOKEN ?? mintInstanceToken();
+  const publishToken = env.JR2_PUBLISH_TOKEN ?? mintInstanceToken();
+
+  // The current Assembly (ADR-0069), and its config and Workflows read from its ROOT, never from
+  // the folder directly. A published Assembly that does not load (a Kit bump that broke an import,
+  // say) is no current Assembly: the process serves and says why (ADR-0048).
+  let resolved: ResolvedAssembly = await resolveAssembly(opts.dir);
+  // The config that applies is ALWAYS the current Assembly's (ADR-0069): the ports read it through
+  // this binding, and a publish replaces it. `bound` is whether a current Assembly binds one at all:
+  // an Assembly with no `jr2.config.ts` binds `undefined`, which is the defaults; no current
+  // Assembly binds nothing. In that window no run runs: the boot defers its restore to the first
+  // publish, which binds a config before it restores (instance.ts), and no Workflow is registered
+  // to start. The read routes (`GET /repos`, `GET /assembly`, `/healthz`, the feeds) read no
+  // config, so they answer in the window.
+  let config: JR2Config | undefined;
+  let bound = false;
+  // The current Assembly's hash, beside its config: a held run's provision names it (ADR-0069).
+  let currentHash: string | undefined;
+  let carried = partsOf([]);
+  if (resolved.current) {
+    const current = resolved.current;
+    try {
+      config = await loadConfig(current.root);
+      carried = partsOf((await loadWorkflows(current.root)).map((w) => w.machine));
+      bound = true;
+      currentHash = current.hash;
+    } catch (err) {
+      config = undefined;
+      resolved = {
+        current: null,
+        error: `the current Assembly ${current.hash} does not load: ${err instanceof Error ? err.message : err}`,
+      };
+    }
+  }
 
-  // The data-plane switch (ADR-0012/0031/0051): a registered Machine COMPOSES a Sandbox — read off
-  // the same walk `jr2 up` makes — and this process is deployed in a cluster → wire the kubectl
-  // Sandbox backend. Otherwise an instance without a data plane (workspace() invocations fault
-  // pointedly). The walk loads the same modules `startInstance` registers below; Node's module
-  // cache makes them one import.
-  const carried = partsOf((await loadWorkflows(opts.dir)).map((w) => w.machine));
-  const dataPlane = carried.composesSandbox && namespace !== undefined;
+  // The data plane is ALWAYS wired when deployed (ADR-0069): a publish can bring the first
+  // `workspace()`, and wiring a client is free. `jr2 up` still decides from its host-side walk
+  // whether to DEPLOY the operator; a provision on a cluster with none fails naming `jr2 up`
+  // (sandbox-kube.ts). A host-booted process has no cluster: its `workspace()` runs fault pointedly.
+  const dataPlane = namespace !== undefined;
   let sandbox: SandboxPort | undefined;
   let repos: RepoResources | undefined;
   let fetches: RepoFetches | undefined;
-  // The Repo port hangs off DEPLOYED, not off the data plane: this boot's reconcile is the only
-  // writer that ever REMOVES `jr2.dev/bound` (repos.ts), and an Instance that drops its last
-  // `workspace()` still owns the Repos its earlier deploys bound. So the port is built whenever
-  // there is a cluster to drive, and the walk — now naming nothing — unlabels every one of them,
-  // which is what puts them on `jr2 gc`'s clock. Gate it on the data plane instead and they stay
-  // bound forever: uncollectable resources, with their node caches behind them.
+  let watch: LazyWatch | undefined;
   if (namespace !== undefined) {
-    const credentials = config?.git?.credentials ?? [];
+    /** The config that applies now, or a pointed refusal while no current Assembly binds one.
+     * Only a provision (`settings`) and a Repo pass (`credentials`, through `bind`/`ensure`) read
+     * it; `repos.list()`, which `GET /repos` reads, does not. No run reaches it in the window: the
+     * restore is deferred and nothing is registered to start. The guard exists so that a future
+     * caller cannot provision with an empty fence and no placement, a config nobody wrote. */
+    const applied = (): JR2Config | undefined => {
+      if (!bound) throw new Error(NO_CONFIG);
+      return config;
+    };
+    const credentials = () => applied()?.git?.credentials ?? [];
+    // ONE client for the process (ADR-0063): one write cap over every port that writes, and the
+    // token read fresh on every request. Nothing is dialed until a port first asks.
+    const client = opts.kube ?? kubeClient({ env });
     // The Repo resources (ADR-0051): created by this process, cloned by the operator's cache agent
     // on every node that needs them. The port resolves `git.credentials` into each resource's
-    // `secretRef`, reading a token entry's env var off this process — the Instance Secret is
-    // `envFrom` on the Deployment, so `jr2 up` is what put it there.
-    repos = kubectlRepos({ namespace, credentials, env, ...(opts.exec ? { exec: opts.exec } : {}) });
-    if (dataPlane) {
-      // The ask a pod makes when something inside it fetches (ADR-0053): it marks the Sandbox CR
-      // and waits on the same status the provision waits on. Gated on the DATA PLANE, unlike the
-      // Repo port above — there is nothing to ask for where no Sandbox is ever composed, and the
-      // only caller is a pod that would have to exist to call it.
-      fetches = kubectlRepoFetches({ namespace, ...(opts.exec ? { exec: opts.exec } : {}) });
-      sandbox = kubectlSandbox({
-        // The fence (ADR-0051): a per-run url must match one of these, or the provision refuses it.
-        credentials,
-        // Where a provision records the Repos it names, before the CR names them.
-        repos,
-        // Named here the same way HARNESS_CONFIGMAP is: a jr2-owned mount path, deliberately NOT an
-        // env knob — there is no image escape hatch left to configure (ADR-0038). Note what this
-        // buys: the map is read per provision, so an instance whose `jr2-images` ConfigMap is not yet
-        // mounted still BOOTS and serves — only a provision fails, pointing at `jr2 up`. That is the
-        // correct blast pattern, and the stale-read window is one kubelet propagation.
-        imagesPath: join(IMAGES_MOUNT, IMAGES_KEY),
-        // The Harness containers' env (ADR-0018): what this instance can REACH (the custom provider
-        // — no Agents, they ride each Turn since ADR-0049), then the instance's own valueFrom
-        // entries (literal values already live in the jr2-harness-env Secret below).
-        env: [
-          {
-            name: "JR2_HARNESS_JSON",
-            valueFrom: { configMapKeyRef: { name: HARNESS_CONFIGMAP, key: HARNESS_CONFIG_KEY } },
-          },
-          ...(config?.harness?.env ?? []).filter((v) => v.valueFrom !== undefined),
-        ],
-        envFrom: [{ secretRef: { name: HARNESS_ENV_SECRET } }, ...(config?.harness?.envFrom ?? [])],
-        // Presence only — the PEM itself was materialized into the jr2-ca ConfigMap by `jr2 up`
-        // (ADR-0020); the in-cluster config eval never reads the file.
-        caBundle: config?.harness?.caBundle !== undefined,
-        // Which nodes are Sandbox nodes (ADR-0052) — the CR carries it, the operator reads no config.
-        ...(config?.sandbox ? { placement: config.sandbox } : {}),
-        orchestratorUrl: `http://${ORCHESTRATOR_SERVICE}.${namespace}.svc:${port}`,
-        signingKey,
-        namespace,
-        ...(opts.exec ? { exec: opts.exec } : {}),
-      });
-    }
+    // `secretRef` and only names the Secret: `jr2 up` wrote each token's clone Secret and listed
+    // them in `git-clone.json`, read here per call so a converge reaches the next attach (ADR-0068).
+    // This port is also what unlabels the Repos an earlier deploy bound, so it hangs off DEPLOYED.
+    repos = kubeRepos({
+      namespace,
+      credentials,
+      cloneSecrets: async () => new Set((await readGitCloneManifest(join(HELD_MOUNT, GIT_CLONE_MANIFEST_KEY))).secrets),
+      client,
+    });
+    // The one watch (ADR-0063): every Sandbox of this Instance, shared by the provision, the lease
+    // and the fetch ask. Lazy, because a cluster where `jr2 up` deployed no operator serves no
+    // Sandbox kind, and a watch on it would only log. It starts at boot when the current Assembly
+    // composes a Sandbox: its first list IS the restore reconcile (ADR-0012).
+    watch = lazyWatch(() => watchSandboxes(client, { namespace }));
+    if (carried.composesSandbox) watch.start();
+    // The ask a pod makes when something inside it fetches (ADR-0053): it marks the Sandbox CR and
+    // waits on the same watch the provision waits on.
+    fetches = kubeRepoFetches({ namespace, client, watch });
+    sandbox = kubeSandbox({
+      // Named here the same way HARNESS_CONFIGMAP is: a jr2-owned mount path, deliberately NOT an
+      // env knob — there is no image escape hatch left to configure (ADR-0038). Note what this
+      // buys: the map is read per provision, so an instance whose `jr2-images` ConfigMap is not yet
+      // mounted still BOOTS and serves — only a provision fails, pointing at `jr2 up`. That is the
+      // correct blast pattern, and the stale-read window is one kubelet propagation.
+      imagesPath: join(IMAGES_MOUNT, IMAGES_KEY),
+      // What comes from the config, read per provision off the current Assembly's (ADR-0069).
+      settings: () => {
+        const config = applied();
+        return {
+          // The fence (ADR-0051): a per-run url must match one of these, or the provision refuses it.
+          credentials: credentials(),
+          // The Harness containers' env (ADR-0018): what this instance can REACH (the custom provider
+          // — no Agents, they ride each Turn since ADR-0049), then the instance's own valueFrom
+          // entries (literal values already live in the jr2-harness-env Secret below).
+          env: [
+            {
+              name: "JR2_HARNESS_JSON",
+              valueFrom: { configMapKeyRef: { name: HARNESS_CONFIGMAP, key: HARNESS_CONFIG_KEY } },
+            },
+            ...(config?.harness?.env ?? []).filter((v) => v.valueFrom !== undefined),
+          ],
+          envFrom: [{ secretRef: { name: HARNESS_ENV_SECRET } }, ...(config?.harness?.envFrom ?? [])],
+          // Presence only — the PEM itself was materialized into the jr2-ca ConfigMap by `jr2 up`
+          // (ADR-0020); the in-cluster config eval never reads the file.
+          caBundle: config?.harness?.caBundle !== undefined,
+          // Which nodes are Sandbox nodes (ADR-0052) — the CR carries it, the operator reads no config.
+          ...(config?.sandbox ? { placement: config.sandbox } : {}),
+          // The Size of a Workspace that states none (ADR-0060), and the class its pod runs under.
+          ...(config?.sandbox?.resources ? { defaultSize: config.sandbox.resources } : {}),
+          ...(config?.priorityClasses?.sandbox ? { priorityClassName: config.priorityClasses.sandbox } : {}),
+        };
+      },
+      // A held run's provision names the current Assembly when its image is not in the map.
+      currentAssembly: () => currentHash,
+      // Where a provision records the Repos it names, before the CR names them.
+      repos,
+      signingKey,
+      namespace,
+      client,
+      watch,
+    });
   }
 
+  // The Repo passes run one after another on one chain, so the newest pass always finishes last:
+  // a slow boot pass can never reconcile after a publish has bound other Repos.
+  // A pass binds the Repos of every HELD Assembly's Machines, not the current one's alone
+  // (ADR-0051, ADR-0069): a run under a held Assembly mounts the Repos its own Machine binds, so
+  // they stay bound, and the boot restates their spec, while a live run holds that Assembly.
+  // Read when the pass runs, so it sees the holds of that moment.
+  let held: (() => Promise<AnyStateMachine[]>) | undefined;
+  let passes: Promise<void> = Promise.resolve();
+  const repoPass = (port: RepoResources): void => {
+    passes = passes.then(async () => {
+      let repos = carried.repos;
+      try {
+        if (held) repos = partsOf(await held()).repos;
+      } catch (err) {
+        opts.announce(JSON.stringify({ repos: [], error: (err as Error).message }));
+        return;
+      }
+      await ensureBound(port, repos, opts.announce);
+    });
+  };
+
   const inst = await startInstance({
     dir: opts.dir,
+    assembly: resolved,
     port,
     hostname: env.HOST ?? "0.0.0.0",
     instanceToken,
+    publishToken,
     signingKey,
     sandbox,
     dataPlane,
+    // The door reads the same image map a provision reads (ADR-0069): a `file:` context whose
+    // digest it lacks is refused at the publish rather than at the first provision.
+    ...(dataPlane
+      ? { imageMap: () => readImageRefs(join(IMAGES_MOUNT, IMAGES_KEY)), mounts: () => readMountDigests() }
+      : {}),
+    // A publish landed (ADR-0069): its config is the one that applies from now on, and its
+    // Machines may bind other Repos, so the Repo pass runs again. Synchronous: the walk is over
+    // the Machines the door already imported.
+    onPublish: ({ current: published, config: next, workflows }) => {
+      config = next;
+      bound = true;
+      currentHash = published.hash;
+      carried = partsOf(workflows.map((w) => w.machine));
+      if (carried.composesSandbox) watch?.start();
+      if (repos) repoPass(repos);
+    },
+    // The Assemblies the hourly sweep let go (ADR-0069): a run that finished released its hold.
+    onCollect: (collected) => opts.announce(JSON.stringify({ collected })),
+    // The restore a boot with no current Assembly deferred, run by the first publish that lands
+    // (ADR-0069): the runs it did not resume ride one line, as the boot's do (ADR-0030).
+    onRestore: ({ assembly, lost, drifted, failed }) => {
+      if (!lost.length && !drifted.length && !failed.length) return;
+      opts.announce(
+        JSON.stringify({
+          assembly,
+          ...(lost.length ? { lost } : {}),
+          ...(drifted.length ? { drifted } : {}),
+          ...(failed.length ? { failed } : {}),
+        }),
+      );
+    },
     // Read per request, never snapshotted: the Repos as the cluster reports them right now. An
     // instance without a data plane reports none — `GET /repos` answers `{ dataPlane: false,
     // repos: [] }` (http.ts), and what its dropped Machines left behind is `jr2 gc`'s to name.
@@ -151,37 +290,94 @@ export async function serverMain(opts: ServerMainOptions): Promise<RunningInstan
     // The pod's route out (ADR-0053), same shape: read per request, off the port.
     ...(fetches ? { fetchRepo: (name: string, identity: string) => fetches.fetch(name, identity) } : {}),
     // Where a Menu-only Turn runs (ADR-0031): the Instance Harness's deterministic Service DNS.
-    // `jr2 up` converges the Deployment behind it whenever any definition declares
+    // `jr2 up` converges the StatefulSet behind it whenever any definition declares
     // `workspace: "none"`, so deployed, the address exists exactly when it is needed.
     instanceHarness: namespace
       ? `http://${INSTANCE_HARNESS_SERVICE}.${namespace}.svc:${INSTANCE_HARNESS_PORT}`
       : undefined,
+    // Where an http Effect runs (ADR-0068): the Instance Effector's headless Service. `jr2 up`
+    // converges it whenever a registered Machine carries an http Effect.
+    ...(namespace ? { instanceEffector: `${INSTANCE_EFFECTOR}.${namespace}.svc:${EFFECTOR_PORT}` } : {}),
+    // Where a push, a file-body http or a credentialed command runs (ADR-0068): a Sandbox's Effector, by
+    // the headless Service the provision writes beside it when `jr2 up` placed an Effect there.
+    ...(namespace
+      ? {
+          sandboxEffector: (sandbox: string) =>
+            `${sandboxEffectorService(sandbox)}.${namespace}.svc:${SANDBOX_EFFECTOR_PORT}`,
+        }
+      : {}),
   });
+  held = inst.heldMachines;
+  // The watch ends with the instance: its stream is the one thing here that never settles alone.
+  if (watch) {
+    const close = inst.close;
+    inst.close = async () => {
+      watch!.stop();
+      await close();
+    };
+  }
   // Resumed runs are routine and stay quiet; runs this boot did NOT resume are not, so they ride
   // the announce line (ADR-0030) — the one thing every boot prints, whatever is reading it. Without
   // this, `drifted` is only reachable by asking after a run id nobody knows to ask about.
   const { lost, drifted, failed } = inst.restored;
+  const chartCounts = inst.charts;
   opts.announce(
     JSON.stringify({
       url: inst.url,
       workflows: inst.workflows,
+      // Which Assembly this process serves (ADR-0069), and the Kit version it accepts at the door.
+      assembly: inst.assembly?.hash ?? null,
+      kitVersion: KIT_VERSION,
+      ...(inst.assemblyError !== undefined ? { assemblyError: inst.assemblyError } : {}),
       ...(lost.length ? { lost } : {}),
       ...(drifted.length ? { drifted } : {}),
       ...(failed.length ? { failed } : {}),
+      // The live runs a boot with no current Assembly left untouched; the first publish restores them.
+      ...(inst.waiting.length ? { waiting: inst.waiting } : {}),
+      ...(inst.collected.length ? { collected: inst.collected } : {}),
+      // The named Charts (ADR-0070), when any exists: how many Chart files and runtime Charts, and
+      // the ones that cannot run now, with why.
+      ...(chartCounts.files || chartCounts.runtime ? { charts: chartCounts } : {}),
     }),
   );
   // After serving, never awaited: the bound Repos' resources (ADR-0051). Serving does not wait on
   // the cluster — a run whose Repo the boot could not record still finds its provision ensuring
   // it again — and a refusal is one announced line per Repo, in ADR-0048's shape. A deployed
   // instance that binds nothing still runs this: the walk names no Repo, so the reconcile is the
-  // whole of it, and every resource an earlier deploy bound becomes evictable.
-  if (repos) void ensureBound(repos, carried.repos, opts.announce);
+  // whole of it, and every resource an earlier deploy bound becomes evictable. A boot with no
+  // current Assembly does not: an empty walk there means "unknown", not "binds nothing", and
+  // unlabeling every Repo would let `jr2 gc` evict them until the publish.
+  if (repos && inst.assembly) repoPass(repos);
   return inst;
 }
 
+/** What a port that reads the config says while no current Assembly binds one (ADR-0069). */
+export const NO_CONFIG =
+  "no current Assembly: no config applies, so this Orchestrator provisions nothing — `jr2 up` publishes one";
+
+/** The one Sandbox watch, started on first use or by {@link LazyWatch.start}. */
+type LazyWatch = SandboxWatch & { start(): void };
+
+/**
+ * A watch that starts on its first use (ADR-0063, ADR-0069). The data plane is wired on every
+ * deployed boot, but a cluster with no operator serves no Sandbox kind: a watch started there
+ * would only log its retries. Every method but `stop` starts it.
+ */
+function lazyWatch(begin: () => SandboxWatch): LazyWatch {
+  let inner: SandboxWatch | undefined;
+  const live = () => (inner ??= begin());
+  return {
+    start: () => void live(),
+    synced: () => live().synced(),
+    get: (name) => live().get(name),
+    subscribe: (name, listener) => live().subscribe(name, listener),
+    stop: () => inner?.stop(),
+  };
+}
+
 /**
  * The boot's half of ADR-0051's "the Orchestrator creates Repo resources": one per identity the
- * registered Machines bind, so statically known repositories are KNOWN before a run asks (the
+ * Machines of the held Assemblies bind (ADR-0069), so statically known repositories are KNOWN before a run asks (the
  * cache agent probes each; a node clones on first demand) — then
  * the bound label reconciled, so a slot unbound since the last deploy is a Repo `jr2 gc` may
  * evict. The boot is the ONE writer of a bound resource's spec: a redeploy that moved a url or a