@spunto/build 0.6.1 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spunto/build",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Spunto's shared Build engine — the devcontainer image protocol and VS Code extension registry clients, with no database, no HTTP framework and no UI.",
   "type": "module",
   "license": "MIT",

package/src/agent-stream/model-window.ts

@@ -48,6 +48,7 @@ const WINDOWS: Record<string, number> = {
   "claude-mythos-5-1": 1_000_000,
   "claude-mythos-5": 1_000_000,
   "claude-mythos-preview": 1_000_000,
+  "claude-opus-5-5": 1_000_000,
   "claude-opus-5": 1_000_000,
   "claude-opus-4-8": 1_000_000,
   "claude-opus-4-7": 1_000_000,

package/src/script/setup-script.ts

@@ -427,7 +427,7 @@ function buildFeatureInstallScript(ociRef: string, options?: Record<string, stri
     `if [ -f "$_FEAT_DIR/devcontainer-feature.json" ]; then`,
     `  _EP=$(grep -o '"entrypoint"[[:space:]]*:[[:space:]]*"[^"]*"' "$_FEAT_DIR/devcontainer-feature.json" | head -1 | cut -d'"' -f4)`,
     `  if [ -n "$_EP" ]; then`,
-    `    echo "$_EP" >> " + FEATURE_ENTRYPOINTS_STAGING_FILE + "`,
+    `    echo "$_EP" >> ${FEATURE_ENTRYPOINTS_STAGING_FILE}`,
     `    echo "[feature] ${featureId}: registered entrypoint $_EP"`,
     `  fi`,
     `fi`,

package/src/types/index.ts

@@ -66,3 +66,15 @@ export type SetupStatus = {
 }
 
 export type { BuildStep, BuildStepKind, BuildStepState } from "../steps/build-steps"
+
+// Le vocabulaire de statuts d'un worker — la liste, le `statusMeta` qui dit pourquoi, et le graphe
+// des transitions. Même raison d'être que `SetupStatus` au-dessus : c'est un contrat versionné
+// entre deux plans de contrôle, pas le détail d'une application.
+export {
+  WORKER_STATUSES,
+  WORKER_STATUS_TRANSITIONS,
+  canTransition,
+  isSettingUp,
+  isTerminal,
+} from "./worker-status"
+export type { WorkerStatus, WorkerStatusReason, WorkerStatusMeta } from "./worker-status"

package/src/types/worker-status.ts

@@ -0,0 +1,141 @@
+// Le vocabulaire de statuts d'un worker : la liste, ce qu'un statut porte avec lui, et les
+// transitions permises.
+//
+// Ça vit ici et pas dans le design system pour la raison écrite dans la RFC 0021 § 2 : le design
+// system est le lieu des formes **structurelles et laxistes** (une carte doit survivre à une valeur
+// qu'elle n'a jamais vue), celui-ci est le lieu des formes **canoniques et strictes**. Un plan de
+// contrôle qui écrit un statut a besoin de la seconde ; une pastille qui l'affiche se contente de
+// la première. Les deux paquets restent indépendants : le typage structurel de TypeScript fait la
+// jointure sans import.
+//
+// Contexte complet, et la mesure qui a motivé tout ça (un conteneur mort laisse la ligne `ready`
+// indéfiniment) : `rfc/0026-les-etats-d-un-worker.md` dans le dépôt Spunto Cloud.
+
+/**
+ * Tous les statuts qu'un worker peut porter.
+ *
+ * **Aucun produit n'est tenu de tous les émettre.** Spunto Lite n'a ni `pulling`, ni `stopping`,
+ * ni `deleting` — son socket Docker est local, donc ces trois-là n'existent pas chez lui : ce sont
+ * des allers-retours réseau qui ont reçu un nom. La liste est l'union, pas un contrat d'exhaustivité.
+ */
+export const WORKER_STATUSES = [
+  "provisioning",
+  "building",
+  "pulling",
+  "starting",
+  "ready",
+  "stopping",
+  "stopped",
+  "deleting",
+  "exited",
+  "unknown",
+  "error",
+] as const
+
+export type WorkerStatus = (typeof WORKER_STATUSES)[number]
+
+/**
+ * Pourquoi un worker est dans le statut où il est. Porté par `WorkerStatusMeta`, et c'est ce qui
+ * distingue les trois « ça va mal » les uns des autres :
+ *
+ * - `stopped` — on l'a demandé ;
+ * - `exited` — le conteneur est mort tout seul (`exited` / `oom-killed` / `completed`) ;
+ * - `error` — une **opération de la plateforme** a échoué.
+ */
+export type WorkerStatusReason =
+  /** Le conteneur s'est terminé seul, code ≠ 0. */
+  | "exited"
+  /** Idem, tué par le kernel faute de mémoire (`OOMKilled`, ou code 137). */
+  | "oom-killed"
+  /** Idem, code 0 : le process principal a rendu la main. Ni un arrêt demandé, ni un échec. */
+  | "completed"
+  /** Le conteneur n'est plus dans l'inventaire du node alors qu'on l'y attendait. */
+  | "removed-externally"
+  /** Le setup dans le conteneur a échoué (clone, `postCreate`…). */
+  | "setup-failed"
+  /** L'image du projet n'a pas pu être construite. */
+  | "build-failed"
+  /** L'attente du spawn est morte avec le process du plan de contrôle. */
+  | "spawn-orphaned"
+  /** Le node a disparu **pendant une opération en vol**, avant qu'un conteneur existe. */
+  | "node-lost"
+  /** Le node a disparu alors que le conteneur existait : on ne sait plus, on ne prétend rien. */
+  | "node-disconnected"
+
+/**
+ * Ce qu'un statut emporte avec lui. Un seul objet, donc un nouveau cas n'est pas une migration.
+ *
+ * `previousStatus` n'est pas décoratif : basculer en `unknown` **détruirait** sinon le dernier
+ * statut connu, dont dépend ce qu'on propose à l'utilisateur — « unknown, c'était `ready` » et
+ * « unknown, c'était `stopped` » n'ouvrent pas les mêmes boutons.
+ */
+export type WorkerStatusMeta = {
+  reason?: WorkerStatusReason
+  /** Lisible par un humain, tel qu'affiché : « Container ran out of memory (exit 137) ». */
+  message?: string
+  /** Code de sortie du conteneur, quand il y en a un. `0` est une valeur, pas une absence. */
+  exitCode?: number | null
+  oomKilled?: boolean
+  /** Le statut qu'on quitte, quand il faudra pouvoir y revenir (`unknown`). */
+  previousStatus?: WorkerStatus
+  /** ISO 8601 du moment où ce statut a été écrit. */
+  at?: string
+}
+
+/**
+ * Les transitions permises, **en graphe et pas en liste ordonnée**, parce que le cycle de vie n'est
+ * pas linéaire : `building` est une attente *imbriquée* dans la préparation, donc
+ * `building → provisioning` est légitime (l'image est là, on reprend où on en était).
+ *
+ * Deux décisions sont encodées ici plutôt qu'écrites quelque part :
+ *
+ * 1. **Un worker pré-conteneur ne passe jamais en `unknown`.** `provisioning`, `building` et
+ *    `pulling` mènent à `error` quand le node tombe, et c'est juste : l'attente vivait dans le
+ *    plan de contrôle et personne ne la reprendra. `unknown` veut dire « le conteneur existe
+ *    probablement, on ne le voit plus » — il n'y a rien à ne pas voir avant qu'il existe.
+ * 2. **`deleting` ne mène nulle part** sauf à l'échec : après, la ligne n'existe plus, et
+ *    « supprimé » n'est pas un statut.
+ */
+export const WORKER_STATUS_TRANSITIONS: Record<WorkerStatus, readonly WorkerStatus[]> = {
+  provisioning: ["building", "pulling", "starting", "error", "deleting"],
+  building: ["provisioning", "pulling", "starting", "error", "deleting"],
+  pulling: ["starting", "error", "deleting"],
+  starting: ["ready", "stopping", "stopped", "exited", "unknown", "error", "deleting"],
+  ready: ["starting", "stopping", "stopped", "exited", "unknown", "error", "deleting"],
+  stopping: ["stopped", "error", "deleting"],
+  stopped: ["starting", "unknown", "error", "deleting"],
+  // Relancer un worker mort repart de `starting` : l'image et le volume sont toujours là.
+  exited: ["starting", "stopped", "unknown", "error", "deleting"],
+  // La réconciliation tranche au retour du node : l'inventaire dit ce qui existe vraiment.
+  unknown: ["ready", "starting", "stopped", "exited", "error", "deleting"],
+  deleting: ["error"],
+  // Un worker en erreur est relevé quand le node revient avec son conteneur, ou reconstruit.
+  error: ["provisioning", "starting", "ready", "stopped", "exited", "unknown", "deleting"],
+}
+
+/** `true` si passer de `from` à `to` est une transition prévue. */
+export function canTransition(from: WorkerStatus, to: WorkerStatus): boolean {
+  return WORKER_STATUS_TRANSITIONS[from]?.includes(to) ?? false
+}
+
+/**
+ * Le worker n'est pas encore utilisable et **la plateforme travaille dessus** : c'est le prédicat
+ * qui décide d'afficher une barre de progression plutôt qu'un bouton.
+ *
+ * `unknown` n'en fait pas partie : on ne sait pas si quelque chose est en cours, et annoncer un
+ * setup en vol pour une machine qu'on ne voit plus serait exactement le mensonge que ce statut
+ * existe pour éviter.
+ */
+export function isSettingUp(status: WorkerStatus): boolean {
+  return status === "provisioning" || status === "building" || status === "pulling" || status === "starting"
+}
+
+/**
+ * Plus rien ne bouge tout seul : il faudra une action pour en sortir.
+ *
+ * `unknown` n'est pas terminal (la reconnexion du node le tranchera) et `deleting` non plus (il
+ * finit par la disparition de la ligne, pas par un statut).
+ */
+export function isTerminal(status: WorkerStatus): boolean {
+  return status === "stopped" || status === "exited" || status === "error"
+}