unoverse 0.1.178 → 0.1.180

package/operator/infra/aws/main.tf

@@ -307,6 +307,33 @@ resource "aws_instance" "app" {
   }
 
   tags = { Name = "${var.name}-app" }
+
+  # THE IMAGE IS CHOSEN ONCE, AT BUILD, AND NEVER AGAIN BY ACCIDENT.
+  #
+  # `ami` is a force-replacement attribute: an instance's image cannot be swapped in place,
+  # so any change to it means DESTROY AND REBUILD, losing the 100 GB root volume and
+  # everything on it. The lookup above asks for `most_recent`, so the value feeding it
+  # changes whenever Canonical publishes, roughly monthly. Together those two facts arm a
+  # trap that fires on the first `unoverse deploy aws` after a publish, on a universe
+  # nobody has touched, with nothing in the repo to explain it.
+  #
+  # Observed 2026-08-26. BPP's box was built from ...-20260731; every deploy for four weeks
+  # got that same id back and planned nothing. Canonical published ...-20260826 at 07:52
+  # UTC, and the next deploy that morning planned to replace the server. Terraform was
+  # right and the config was wrong, and the only warning was one line in a plan that also
+  # said "Changing".
+  #
+  # An EXISTING universe now keeps the image it was built on; a NEW one still takes
+  # whatever is current when it is created, because the lookup is untouched and only drift
+  # is ignored. The trade is deliberate: nothing upgrades the OS for you. Patch in place
+  # with apt, and move to a newer image by rebuilding on purpose — a decision, rather than
+  # a side effect of deploying on the wrong day.
+  #
+  # DigitalOcean needs none of this: its droplet names a fixed slug (`ubuntu-22-04-x64`),
+  # a literal in the file that cannot drift.
+  lifecycle {
+    ignore_changes = [ami]
+  }
 }
 
 resource "aws_eip" "app" {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unoverse",
-  "version": "0.1.178",
+  "version": "0.1.180",
   "description": "The Unoverse front door — create a Studio project, a universe, or a client app, and launch Studio.",
   "license": "SEE LICENSE IN README.md",
   "type": "module",

package/vendor/base/lint/design/file.mjs

@@ -101,7 +101,12 @@ function lintFile(file) {
       // manifest-only form must resolve a layout; an envelope-form template supplies its own.
       const hasEnvelope = !!defPath(root, basename(root));
       if (!hasEnvelope) {
-        const layoutName = json.layout ?? "main";
+        // The base defaults to the FIRST DECLARED STATE (states own layouts and
+        // declaration order ranks them); "main" only when no states block exists.
+        const firstState = json.states && typeof json.states === "object" && !Array.isArray(json.states)
+          ? Object.keys(json.states)[0]
+          : undefined;
+        const layoutName = json.layout ?? firstState ?? "main";
         if (!defPath(join(root, "layouts"), layoutName))
           report("error", file, `manifest.layout "${layoutName}" → layouts/${layoutName} does not exist (and no <name> envelope) (docs.unoverse.ai/design/apps)`);
       }
@@ -123,7 +128,7 @@ function lintFile(file) {
           report("error", file, `manifest "states" must be an object — the template tree: { <base>: { states: {…} }, <reaction>: {}, … } (STATE_MODEL §5)`);
         } else {
           const names = Object.keys(json.states);
-          const base = json.layout ?? "main";
+          const base = json.layout ?? Object.keys(json.states)[0] ?? "main";
           if (!names.includes(base))
             report("error", file, `the template tree must include the BASE state "${base}" (named for the default layout) — the ladder derives as the top level minus it (STATE_MODEL §5)`);
           const subs = [];
@@ -279,16 +284,21 @@ function lintFile(file) {
 
   if (isEnvelope) {
     // COMPONENT envelope (templates have no envelope — their manifest is it).
-    for (const req of ["kind", "name", "root"])
+    // The declaration word is `type:`; `kind:` is the legacy spelling, still read.
+    const declared = json.type ?? json.kind;
+    for (const req of ["name", "root"])
       if (json[req] === undefined) report("error", file, `envelope missing "${req}" (docs.unoverse.ai/design/sdui-and-mcp-apps)`);
-    if (json.kind && !["component", "template", "atom"].includes(json.kind))
-      report("error", file, `unknown kind "${json.kind}"`);
-    if (json.kind === "component" && !json.category)
+    if (declared === undefined) report("error", file, `envelope missing "type" (docs.unoverse.ai/design/sdui-and-mcp-apps)`);
+    if (json.kind !== undefined && json.type === undefined)
+      report("warn", file, `"kind" is the legacy spelling of the declaration — write "type: ${json.kind}"`);
+    if (declared && !["component", "template", "atom"].includes(declared))
+      report("error", file, `unknown type "${declared}"`);
+    if (declared === "component" && !json.category)
       report("warn", file, `component has no "category". Used to group it in the palette (docs.unoverse.ai/design/sdui-and-mcp-apps)`);
     if (json.root) walkNode(json.root, file, root);
 
     // ── the contained-microapp discipline (mirrors microapp-structure.test.ts) ──
-    if (json.kind === "component") {
+    if (declared === "component") {
       const hasLayouts = existsSync(join(root, "layouts"));
       const statesDir = join(root, "states");
       const stateFiles = existsSync(statesDir)

package/vendor/base/lint/design/vocabulary.mjs

@@ -13,7 +13,7 @@
 // ── ground truth (mirrors design/_schema/unoverse.schema.json + server guards) ──
 export const PRIMITIVES = new Set([
   "Box", "Stack", "Row", "Column", "Each", "Switch", "ComponentSlot", "Timeline",
-  "Text", "Image", "Button", "Input", "Select", "Markdown", "Skeleton", "Icon", "Ref", "Orb",
+  "Text", "Image", "Button", "Input", "Select", "Markdown", "Skeleton", "Icon", "Ref", "Orb", "Template",
 ]);
 export const CONDITION_KEYS = new Set(["field", "eq", "ne", "in"]);
 
@@ -56,6 +56,10 @@ export const PRIMITIVE_PROPS = {
   Switch: ["on", "cases", "fallback"],
   Ref: ["ref", "props", "with", "children", "name"],
   ComponentSlot: ["select", "frame", "fallback", "pinned", "appWidth"],
+  // THE MOUNT (UNOVERSE_TEMPLATE_MODEL §12): a layout place that runs a mounted
+  // template's machinery. `name` addresses the manifest's `templates:` entry;
+  // `frame` is the dressing drawn around it when occupied.
+  Template: ["name", "frame", "template", "director", "appWidth"],
   Timeline: ["user", "assistant", "userData", "assistantData", "autoScroll"],
 };