0xray 4.0.14 → 4.0.15

package/scripts/foundry/mint-suit.cjs

@@ -11,6 +11,7 @@ const os = require("os");
 const path = require("path");
 
 const { attachInventoryDna, inventoryDna } = require("./mill-dna.cjs");
+const millPlantProtocol = require("./mill-plant.cjs");
 
 const DEFAULT_PARAMS = {
   codex: "xray/codex.json",
@@ -24,15 +25,13 @@ const DEFAULT_PARAMS = {
 /** Factory shop plant. First-class with mill plant. Not 45/42 costume. */
 const FACTORY_SHOP_SKILLS = ["shop-extract", "shop-witness", "shop-pin"];
 
-/** Factory plant kinds. Mill is default. Sound is a bed factory. Blip is a tiny-video factory. */
+/** Builtin mill only. Package plants (blip, sound, @scope/pkg/prefix) use mill-plant.cjs. */
 const FACTORY_PLANT_CATALOG = {
   mill: { skills: ["mill", "inspect"], agents: ["mill.yml", "inspect.yml"] },
-  sound: { skills: ["sound", "sound-inspect"], agents: ["sound.yml", "sound-inspect.yml"] },
-  blip: { skills: ["blip", "blip-inspect"], agents: ["blip.yml", "blip-inspect.yml"] },
 };
 
 function isFactoryPlantKind(kind) {
-  return Boolean(kind && FACTORY_PLANT_CATALOG[kind]);
+  return Boolean(millPlantProtocol.parsePlantToken(kind));
 }
 
 function deepMerge(src, dest) {
@@ -122,51 +121,51 @@ function wantsCostume(targetDir) {
 }
 
 function millPlantDir(millPackageRoot) {
-  const nested = path.join(millPackageRoot, "scripts", "foundry", "plant");
-  if (isDirectory(nested)) return nested;
-  const packed = path.join(millPackageRoot, "plant");
-  if (isDirectory(packed)) return packed;
-  return null;
+  return millPlantProtocol.foundryPlantDir(millPackageRoot);
 }
 
 function emptyPlantFiles() {
   return { skills: [], agents: [] };
 }
 
-function catalogPlant(kind) {
-  const spec = FACTORY_PLANT_CATALOG[kind];
-  return spec ? { skills: [...spec.skills], agents: [...spec.agents] } : emptyPlantFiles();
+function catalogPlant(kind, millPackageRoot) {
+  if (!kind || kind === "mill") {
+    const spec = FACTORY_PLANT_CATALOG.mill;
+    return spec ? { skills: [...spec.skills], agents: [...spec.agents] } : emptyPlantFiles();
+  }
+  const parsed = millPlantProtocol.parsePlantToken(kind);
+  if (!parsed || parsed.builtin) {
+    const spec = FACTORY_PLANT_CATALOG.mill;
+    return spec ? { skills: [...spec.skills], agents: [...spec.agents] } : emptyPlantFiles();
+  }
+  const pkgRoot = millPlantProtocol.resolvePackageRoot(parsed.packageName, {
+    targetDir: millPackageRoot,
+    millPackageRoot,
+    cwd: process.cwd(),
+  });
+  if (!pkgRoot) throw millPlantProtocol.unresolvedPackageError(parsed.packageName);
+  const plantId = parsed.plantId || millPlantProtocol.readProtocol(pkgRoot).default;
+  if (!plantId) {
+    throw millPlantProtocol.plantError(
+      `foundry-plant: mill package "${parsed.packageName}" has no default plant id`,
+    );
+  }
+  const files = millPlantProtocol.selectPlantFiles(pkgRoot, plantId);
+  return { skills: [...files.skills], agents: [...files.agents] };
 }
 
-/** foundry.json plant: "sound" | "blip" | "mill" | ["mill","sound","blip"]. millPlant:false turns mill off. */
-function loadFactoryPlantKinds(targetDir) {
+/** foundry.json plant: mill | @scope/name | @scope/name/id | blip|sound aliases | array. millPlant:false strips mill. */
+function loadFactoryPlantKinds(targetDir, millPackageRoot) {
   const extra = loadFoundryExtra(targetDir);
-  const kinds = [];
-  const raw = extra.plant;
-  if (Array.isArray(raw)) {
-    for (const item of raw) {
-      if (isFactoryPlantKind(item)) kinds.push(item);
-    }
-  } else if (isFactoryPlantKind(raw)) {
-    kinds.push(raw);
-  } else if (extra.soundPlant === true || extra.blipPlant === true) {
-    if (extra.millPlant !== false) kinds.push("mill");
-    if (extra.soundPlant === true) kinds.push("sound");
-    if (extra.blipPlant === true) kinds.push("blip");
-  } else {
-    kinds.push("mill");
-  }
-  if (extra.millPlant === false) {
-    return [...new Set(kinds.filter((kind) => kind !== "mill"))];
-  }
-  return [...new Set(kinds)];
+  const seats = millPlantProtocol.resolvePlantSeats(targetDir, millPackageRoot, extra);
+  return millPlantProtocol.plantKindsFromSeats(seats);
 }
 
-function unionPlantFiles(kinds) {
+function unionPlantFiles(kinds, millPackageRoot) {
   const skills = [];
   const agents = [];
   for (const kind of kinds) {
-    const spec = catalogPlant(kind);
+    const spec = catalogPlant(kind, millPackageRoot);
     for (const name of spec.skills) {
       if (!skills.includes(name)) skills.push(name);
     }
@@ -190,27 +189,23 @@ function existingPlantFiles(plantDir, spec) {
 }
 
 function factoryPlantAllowlist(millPackageRoot, targetDir) {
-  const kinds = loadFactoryPlantKinds(targetDir);
-  return {
-    kinds,
-    ...existingPlantFiles(millPlantDir(millPackageRoot), unionPlantFiles(kinds)),
-  };
+  const extra = loadFoundryExtra(targetDir);
+  const seats = millPlantProtocol.resolvePlantSeats(targetDir, millPackageRoot, extra);
+  const skills = [];
+  const agents = [];
+  for (const seat of seats) {
+    for (const name of seat.skills || []) {
+      if (!skills.includes(name)) skills.push(name);
+    }
+    for (const file of seat.agents || []) {
+      if (!agents.includes(file)) agents.push(file);
+    }
+  }
+  return { kinds: millPlantProtocol.plantKindsFromSeats(seats), skills, agents, seats };
 }
 
 function inventoryPlantKinds(inventory) {
-  if (!inventory || typeof inventory !== "object") return ["mill"];
-  if (Array.isArray(inventory.plant) && inventory.plant.length > 0) {
-    return inventory.plant.filter((kind) => isFactoryPlantKind(kind));
-  }
-  if (isFactoryPlantKind(inventory.plant)) return [inventory.plant];
-  const hasSound = Array.isArray(inventory.soundPlant?.skills) && inventory.soundPlant.skills.length > 0;
-  const hasBlip = Array.isArray(inventory.blipPlant?.skills) && inventory.blipPlant.skills.length > 0;
-  const hasMill = Array.isArray(inventory.millPlant?.skills) && inventory.millPlant.skills.length > 0;
-  const kinds = [];
-  if (hasMill) kinds.push("mill");
-  if (hasSound) kinds.push("sound");
-  if (hasBlip) kinds.push("blip");
-  return kinds.length > 0 ? kinds : ["mill"];
+  return millPlantProtocol.plantKindsFromInventory(inventory);
 }
 
 function listSkillNamesAt(skillsSrc) {
@@ -237,64 +232,99 @@ function listAgentFilesAt(agentsSrc) {
 }
 
 function copyPlantFiles(plant, spec, targetDir) {
-  const skillsSrc = path.join(plant, "skills");
-  const agentsSrc = path.join(plant, "agents");
+  const skillsSrc = spec.skillsDir || (plant ? path.join(plant, "skills") : null);
+  const agentsSrc = spec.agentsDir || (plant ? path.join(plant, "agents") : null);
   const skills = spec.skills || [];
   const agents = spec.agents || [];
   const skillDirs = listProjectSkillDirs(targetDir);
   const agentsDest = path.join(targetDir, ".opencode", "agents");
-  for (const dir of skillDirs) {
-    for (const name of skills) {
-      const src = path.join(skillsSrc, name, "SKILL.md");
-      const destMd = path.join(dir, name, "SKILL.md");
-      if (!fs.existsSync(src)) continue;
-      if (path.resolve(src) === path.resolve(destMd)) continue;
-      if (fs.existsSync(destMd)) continue;
-      fs.mkdirSync(path.dirname(destMd), { recursive: true });
-      fs.copyFileSync(src, destMd);
+  if (skillsSrc) {
+    for (const dir of skillDirs) {
+      for (const name of skills) {
+        const src = path.join(skillsSrc, name, "SKILL.md");
+        const destMd = path.join(dir, name, "SKILL.md");
+        if (!fs.existsSync(src)) continue;
+        if (path.resolve(src) === path.resolve(destMd)) continue;
+        if (fs.existsSync(destMd)) continue;
+        fs.mkdirSync(path.dirname(destMd), { recursive: true });
+        fs.copyFileSync(src, destMd);
+      }
     }
   }
-  for (const file of agents) {
-    const src = path.join(agentsSrc, file);
-    const dest = path.join(agentsDest, file);
-    if (!fs.existsSync(src)) continue;
-    if (path.resolve(src) === path.resolve(dest)) continue;
-    if (fs.existsSync(dest)) continue;
-    fs.mkdirSync(agentsDest, { recursive: true });
-    fs.copyFileSync(src, dest);
+  if (agentsSrc) {
+    for (const file of agents) {
+      const src = path.join(agentsSrc, file);
+      const dest = path.join(agentsDest, file);
+      if (!fs.existsSync(src)) continue;
+      if (path.resolve(src) === path.resolve(dest)) continue;
+      if (fs.existsSync(dest)) continue;
+      fs.mkdirSync(agentsDest, { recursive: true });
+      fs.copyFileSync(src, dest);
+    }
   }
   return { skills, agents };
 }
 
-/** Fasten requested factory plants. Default mill only. Sound/blip seats skip mill unless asked. */
+/** Fasten requested plants. Mill files come from this foundry plant/. Mill-package organs come from that package. */
 function fastenMillPlant(millPackageRoot, targetDir, log) {
-  const plant = millPlantDir(millPackageRoot);
-  const kinds = loadFactoryPlantKinds(targetDir);
-  if (!plant) {
-    return { skills: [], agents: [], kinds, sound: emptyPlantFiles(), blip: emptyPlantFiles() };
-  }
-  const mill = kinds.includes("mill")
-    ? existingPlantFiles(plant, catalogPlant("mill"))
+  const extra = loadFoundryExtra(targetDir);
+  const seats = millPlantProtocol.resolvePlantSeats(targetDir, millPackageRoot, extra);
+  const kinds = millPlantProtocol.plantKindsFromSeats(seats);
+  const millSeat = seats.find((seat) => seat.builtin && seat.kind === "mill");
+  const soundSeat = seats.find((seat) => seat.kind === "sound");
+  const blipSeat = seats.find((seat) => seat.kind === "blip");
+  const mill = millSeat
+    ? { skills: [...millSeat.skills], agents: [...millSeat.agents] }
     : emptyPlantFiles();
-  const sound = kinds.includes("sound")
-    ? existingPlantFiles(plant, catalogPlant("sound"))
+  const sound = soundSeat
+    ? { skills: [...soundSeat.skills], agents: [...soundSeat.agents] }
     : emptyPlantFiles();
-  const blip = kinds.includes("blip")
-    ? existingPlantFiles(plant, catalogPlant("blip"))
+  const blip = blipSeat
+    ? { skills: [...blipSeat.skills], agents: [...blipSeat.agents] }
     : emptyPlantFiles();
-  const fastened = copyPlantFiles(
-    plant,
-    unionPlantFiles(kinds.filter((kind) => isFactoryPlantKind(kind))),
-    targetDir,
-  );
-  if (log && (fastened.skills.length > 0 || fastened.agents.length > 0)) {
+  const plants = {};
+  const fastenedSkills = [];
+  const fastenedAgents = [];
+  for (const seat of seats) {
+    if (!seat.builtin) {
+      plants[seat.kind] = { skills: [...seat.skills], agents: [...seat.agents] };
+    }
+    const copied = copyPlantFiles(
+      seat.packageRoot,
+      {
+        skills: seat.skills,
+        agents: seat.agents,
+        skillsDir: seat.skillsDir,
+        agentsDir: seat.agentsDir,
+      },
+      targetDir,
+    );
+    for (const name of copied.skills) {
+      if (!fastenedSkills.includes(name)) fastenedSkills.push(name);
+    }
+    for (const file of copied.agents) {
+      if (!fastenedAgents.includes(file)) fastenedAgents.push(file);
+    }
+  }
+  const millPkgSeat = seats.find((seat) => seat.packageName);
+  if (log && (fastenedSkills.length > 0 || fastenedAgents.length > 0)) {
     log("foundry-mint", "Fastened factory plant", "info", {
       plant: kinds,
-      skills: fastened.skills.length,
-      agents: fastened.agents.length,
+      skills: fastenedSkills.length,
+      agents: fastenedAgents.length,
     });
   }
-  return { skills: mill.skills, agents: mill.agents, kinds, sound, blip };
+  return {
+    skills: mill.skills,
+    agents: mill.agents,
+    kinds,
+    sound,
+    blip,
+    plants,
+    seats,
+    millPackage: millPkgSeat ? millPkgSeat.packageName : null,
+    millProtocol: millPkgSeat ? millPkgSeat.protocol || millPlantProtocol.PROTOCOL : null,
+  };
 }
 
 function isDirectory(p) {
@@ -500,6 +530,14 @@ function previousTreeAllowlist(targetDir) {
       ? normalizeNameList(blipFromInv)
       : normalizeNameList(blipFromInv?.skills);
     const blipAgents = normalizeNameList(blipFromInv?.agents);
+    const extraPlantSkills = [];
+    const extraPlantAgents = [];
+    if (inventory?.plants && typeof inventory.plants === "object") {
+      for (const spec of Object.values(inventory.plants)) {
+        extraPlantSkills.push(...normalizeNameList(spec?.skills));
+        extraPlantAgents.push(...normalizeNameList(spec?.agents));
+      }
+    }
     return {
       skills: [
         ...(Array.isArray(inventory?.tree?.skills) ? inventory.tree.skills : []),
@@ -507,12 +545,14 @@ function previousTreeAllowlist(targetDir) {
         ...shopSkills,
         ...soundSkills,
         ...blipSkills,
+        ...extraPlantSkills,
       ],
       agents: [
         ...(Array.isArray(inventory?.tree?.agents) ? inventory.tree.agents : []),
         ...(Array.isArray(inventory?.millPlant?.agents) ? inventory.millPlant.agents : []),
         ...soundAgents,
         ...blipAgents,
+        ...extraPlantAgents,
       ],
     };
   } catch {
@@ -520,26 +560,40 @@ function previousTreeAllowlist(targetDir) {
   }
 }
 
-function soundPlantFromTree(targetDir, tree) {
+function millPackagePlantFromTree(targetDir, tree, plantId, millPackageRoot) {
+  const seats = Array.isArray(tree?.seats)
+    ? tree.seats
+    : millPlantProtocol.resolvePlantSeats(targetDir, millPackageRoot || tree?.millPackageRoot);
+  const seat = seats.find((item) => item.kind === plantId);
+  return seat ? { skills: [...seat.skills], agents: [...seat.agents] } : emptyPlantFiles();
+}
+
+function soundPlantFromTree(targetDir, tree, millPackageRoot) {
   if (Array.isArray(tree?.soundPlantSkills) || Array.isArray(tree?.sound?.skills)) {
     return {
       skills: normalizeNameList(tree.soundPlantSkills || tree.sound?.skills),
       agents: normalizeNameList(tree.soundPlantAgents || tree.sound?.agents),
     };
   }
-  const kinds = Array.isArray(tree?.plantKinds) ? tree.plantKinds : loadFactoryPlantKinds(targetDir);
-  return kinds.includes("sound") ? catalogPlant("sound") : emptyPlantFiles();
+  const kinds = Array.isArray(tree?.plantKinds)
+    ? tree.plantKinds
+    : loadFactoryPlantKinds(targetDir, millPackageRoot);
+  if (!kinds.includes("sound")) return emptyPlantFiles();
+  return millPackagePlantFromTree(targetDir, tree, "sound", millPackageRoot);
 }
 
-function blipPlantFromTree(targetDir, tree) {
+function blipPlantFromTree(targetDir, tree, millPackageRoot) {
   if (Array.isArray(tree?.blipPlantSkills) || Array.isArray(tree?.blip?.skills)) {
     return {
       skills: normalizeNameList(tree.blipPlantSkills || tree.blip?.skills),
       agents: normalizeNameList(tree.blipPlantAgents || tree.blip?.agents),
     };
   }
-  const kinds = Array.isArray(tree?.plantKinds) ? tree.plantKinds : loadFactoryPlantKinds(targetDir);
-  return kinds.includes("blip") ? catalogPlant("blip") : emptyPlantFiles();
+  const kinds = Array.isArray(tree?.plantKinds)
+    ? tree.plantKinds
+    : loadFactoryPlantKinds(targetDir, millPackageRoot);
+  if (!kinds.includes("blip")) return emptyPlantFiles();
+  return millPackagePlantFromTree(targetDir, tree, "blip", millPackageRoot);
 }
 
 /** Extra worn names that are neither mill/sound/blip plant, their plant, shop plant, nor a prior overlay. */
@@ -548,10 +602,19 @@ function costumeDumpExtras(targetDir, millPlant, tree) {
   const shopPlant = loadShopPlant(targetDir);
   const soundPlant = soundPlantFromTree(targetDir, tree);
   const blipPlant = blipPlantFromTree(targetDir, tree);
+  const plantMapSkills = [];
+  const plantMapAgents = [];
+  if (millPlant?.plants && typeof millPlant.plants === "object") {
+    for (const spec of Object.values(millPlant.plants)) {
+      if (Array.isArray(spec?.skills)) plantMapSkills.push(...spec.skills);
+      if (Array.isArray(spec?.agents)) plantMapAgents.push(...spec.agents);
+    }
+  }
   const allowedSkills = new Set([
     ...(Array.isArray(millPlant?.skills) ? millPlant.skills : []),
     ...(Array.isArray(millPlant?.sound?.skills) ? millPlant.sound.skills : []),
     ...(Array.isArray(millPlant?.blip?.skills) ? millPlant.blip.skills : []),
+    ...plantMapSkills,
     ...soundPlant.skills,
     ...blipPlant.skills,
     ...(Array.isArray(tree?.skills) ? tree.skills : []),
@@ -562,6 +625,7 @@ function costumeDumpExtras(targetDir, millPlant, tree) {
     ...(Array.isArray(millPlant?.agents) ? millPlant.agents : []),
     ...(Array.isArray(millPlant?.sound?.agents) ? millPlant.sound.agents : []),
     ...(Array.isArray(millPlant?.blip?.agents) ? millPlant.blip.agents : []),
+    ...plantMapAgents,
     ...soundPlant.agents,
     ...blipPlant.agents,
     ...(Array.isArray(tree?.agents) ? tree.agents : []),
@@ -701,6 +765,13 @@ function mintConsumerFromSsot(packageRoot, targetDir, log, tree) {
     },
     mintedAt: new Date().toISOString(),
   };
+  if (tree?.millPackage) {
+    inventory.millPackage = tree.millPackage;
+    inventory.millProtocol = tree.millProtocol || millPlantProtocol.PROTOCOL;
+  }
+  if (tree?.plants && typeof tree.plants === "object" && Object.keys(tree.plants).length > 0) {
+    inventory.plants = tree.plants;
+  }
   const withDna = attachInventoryDna(inventory);
   const xrayDir = path.join(targetDir, ".xray");
   if (!fs.existsSync(xrayDir)) fs.mkdirSync(xrayDir, { recursive: true });
@@ -735,6 +806,11 @@ function mintConsumerSuit(millPackageRoot, targetDir, log) {
   tree.blipPlantSkills = millPlant.blip?.skills || [];
   tree.blipPlantAgents = millPlant.blip?.agents || [];
   tree.blip = millPlant.blip || emptyPlantFiles();
+  tree.plants = millPlant.plants || {};
+  tree.seats = millPlant.seats || [];
+  tree.millPackage = millPlant.millPackage || null;
+  tree.millProtocol = millPlant.millProtocol || null;
+  tree.millPackageRoot = millPackageRoot;
   tree.shopPlantSkills = loadShopPlant(targetDir);
   tree.codex = overlayJsonFacet(
     resolveInside(targetDir, params.codex),
@@ -764,6 +840,20 @@ module.exports = {
   DEFAULT_PARAMS,
   FACTORY_SHOP_SKILLS,
   FACTORY_PLANT_CATALOG,
+  FOUNDRY_PLANT_PROTOCOL: millPlantProtocol.PROTOCOL,
+  PROTOCOL: millPlantProtocol.PROTOCOL,
+  PACKAGE_ALIASES: millPlantProtocol.PACKAGE_ALIASES,
+  parsePlantToken: millPlantProtocol.parsePlantToken,
+  parsePlantRef: millPlantProtocol.parsePlantRef,
+  resolvePackageRoot: millPlantProtocol.resolvePackageRoot,
+  readProtocol: millPlantProtocol.readProtocol,
+  prefixSelect: millPlantProtocol.prefixSelect,
+  selectPlantFiles: millPlantProtocol.selectPlantFiles,
+  declaredPlantFiles: millPlantProtocol.declaredPlantFiles,
+  resolvePlantSeats: millPlantProtocol.resolvePlantSeats,
+  loadPlantRequests: millPlantProtocol.loadPlantRequests,
+  declaredReceiptSeats: millPlantProtocol.declaredReceiptSeats,
+  inventoryFilesForKind: millPlantProtocol.inventoryFilesForKind,
   isFactoryPlantKind,
   deepMerge,
   loadFoundryParams,

package/scripts/foundry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xray/foundry",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "private": false,
   "type": "module",
   "description": "0xRay mill: mint their suit params, stamp, gate, publish, CI report, git hooks. Not the worn exo.",
@@ -37,15 +37,26 @@
     "./release-gate": "./release-gate.mjs",
     "./mill-root": "./mill-root.mjs",
     "./mint-suit": "./mint-suit.cjs",
+    "./mill-plant": "./mill-plant.cjs",
     "./inspect": "./inspect.mjs",
     "./sound": "./sound.mjs",
     "./sound-bed": "./sound-bed.cjs",
+    "./sound-mixer": "./sound-mixer.cjs",
     "./blip": "./blip.mjs",
     "./blip-render": "./blip-render.cjs",
+    "./blip-vibe": "./blip-vibe.cjs",
+    "./blip-looker": "./blip-looker.cjs",
+    "./blip-scene": "./blip-scene.cjs",
+    "./sound-taste": "./sound-taste.cjs",
+    "./sound-voice": "./sound-voice.cjs",
+    "./blip-stroke": "./blip-stroke.cjs",
     "./ci-monitor": "./ci-monitor.mjs",
     "./hooks": "./hooks.mjs",
     "./docs-build": "./docs-build.mjs"
   },
+  "dependencies": {
+    "@0xray/blip": "^0.1.3"
+  },
   "engines": {
     "node": ">=18"
   },

package/scripts/foundry/plant/agents/blip-inspect.yml

@@ -1,5 +1,5 @@
 name: blip-inspect
 skill: blip-inspect
 description: "Inspect the last factory-blip: 4.44s duration, mode, file present. Fail-closed."
-version: "0.1.10"
+version: "0.1.12"
 mode: subagent

package/scripts/foundry/plant/agents/blip-looker.yml

@@ -0,0 +1,5 @@
+name: blip-looker
+skill: blip-looker
+description: "Friend hitting replay. Scores hook → turn → tag as a Short. Appeal 0–10. Ship bar is 8. Not stamp density. Not last-blip inspect."
+version: "0.1.12"
+mode: subagent

package/scripts/foundry/plant/agents/blip-vibe.yml

@@ -0,0 +1,5 @@
+name: blip-vibe
+skill: blip-vibe
+description: "Aesthetic / cool-factor organ. Scores still + Rippel five + kapow. Appeal 0–10. Ship bar is 8. Not last-blip inspect."
+version: "0.1.12"
+mode: subagent

package/scripts/foundry/plant/agents/blip.yml

@@ -1,5 +1,5 @@
 name: blip
 skill: blip
 description: "Factory-blip plant. Brief → seed → still|motion:<id> → 4.44s mp4 → inspect gate."
-version: "0.1.10"
+version: "0.1.12"
 mode: subagent

package/scripts/foundry/plant/agents/inspect.yml

@@ -1,5 +1,5 @@
 name: inspect
 skill: inspect
 description: "Inspect AI work: diffs, traces, mill receipts, CI. Fastened mill plant."
-version: "0.1.10"
+version: "0.1.12"
 mode: subagent

package/scripts/foundry/plant/agents/mill.yml

@@ -1,5 +1,5 @@
 name: mill
 skill: mill
 description: "Fasten their plant as the suit. Factory Repertoire. Inspect is the mill discipline."
-version: "0.1.10"
+version: "0.1.12"
 mode: subagent

package/scripts/foundry/plant/agents/sound-inspect.yml

@@ -1,5 +1,5 @@
 name: sound-inspect
 skill: sound-inspect
 description: "Inspect the last factory-sound bed: chop, levels, peak, hum. Fail-closed."
-version: "0.1.10"
+version: "0.1.12"
 mode: subagent

package/scripts/foundry/plant/agents/sound-mixer.yml

@@ -0,0 +1,5 @@
+name: sound-mixer
+skill: sound-mixer
+description: "Tuner for hats, plate, glue, and phrase levels. Levels every genre × tempo × motif. Not last-bed inspect."
+version: "0.1.12"
+mode: subagent

package/scripts/foundry/plant/agents/sound.yml

@@ -1,5 +1,5 @@
 name: sound
 skill: sound
 description: "Factory-sound plant. Brief → seed → genre → headless wav → metrics gate."
-version: "0.1.10"
+version: "0.1.12"
 mode: subagent

package/scripts/foundry/plant/motions/MOTION-REGISTRY.md

@@ -1,6 +1,6 @@
 # Motion registry (factory-blip)
 
-Law: motions are a dynamic registry (`id → renderer`). Rippel names are **imports**, not a frozen enum. Unknown id FAIL. `kapow` is a growth stub (`renderer: null`) until a renderer ships.
+Law: motions are a dynamic registry (`id → renderer`). Rippel names are **imports**, not a frozen enum. Unknown id FAIL. `kapow` is a design opt — two-tier stamp on hook → turn → tag.
 
 On-disk SSOT: `registry.json` next to this file.
 
@@ -12,24 +12,30 @@ On-disk SSOT: `registry.json` next to this file.
 
 Default motion path is the Rippel converter spine, not ffmpeg geometry. Look is **sharp** (opaque body + crisp rim + short glow) on all five. Motion is a **4.44s blip**: fast abstract travel, soft gold tints — no hard strobe. LFOs share the crystal-mill genre tempo + `CircleConfig.frequency` with the audio bed.
 
+One mill suit on every body: Wu hairline, Power Plant satellites, short glow, hook → turn → tag on the shared motion grid. Picture and bed seed-pick the same genre. Rippel geo stays (petals / N-gons / synapse / cosmos / aurora) and wears that suit — not a second CAD look.
+
 - **SSOT** `htafolla/rippel-synapse-flow@e5014cd`
 - `animationIcons.ts` → `ANIMATION_TO_VISUALIZATION`
 - `types/index.ts` → `ChecksumResponse.visualConfig` (`CircleConfig[]`, `CanvasConfig`, `tlmCommand`)
 - `SimplifiedVisualConverter.tsx` → Animation → viz id, canvas **1280×720** @ ~30fps
 - `MiniAnimationViewer` / `FiveDimensionalVisualizer` → viz backends
 
-| id | viz id | backend |
-|----|--------|---------|
-| `orb` | `canvas` | Orb Glow — dual rings, beat tick, frequency flash |
-| `swirl` | `3d-sacred` | merkaba + hex plate, counter-spin, beat vertices |
-| `snap` | `neural` | dual-ring lattice, hub, skip-links, traveling pulses |
-| `waves` | `waveform` | Wave Flow — harmonic ribbons + beat envelope + gold needle |
-| `spark` | `particles` | Spark Drift — beat bursts, orbital + radial motes |
+| id | viz id | mill body | rippel body |
+|----|--------|-----------|-------------|
+| `orb` | `canvas` | `focus` disc **or** `cage` Wu + nucleus | `mandala` |
+| `swirl` | `3d-sacred` | platonic `mesh` | `sacred-flow` |
+| `snap` | `neural` | `strike` (quantized) | `synapse` |
+| `waves` | `waveform` | sharp `ribbons` | `liquid-waves` |
+| `spark` | `particles` | `embers` | `cosmic-dance` |
 
-Every mint wears a **sparse seed mesh** (12 families · 5 gaits) plus a **field** (stars · grids `floor`/`meridian`/`ticks` · gradients · blinkers). Uniqueness is the field, not more wire in the middle. Receipt `visualConfig.mesh` + `visualConfig.field` are the NFT fingerprints.
+Every mint wears a **sparse seed mesh** (12 families · 5 gaits · 6 cameras) plus a **field** (stars · grids `floor`/`none` · gradients · blinkers) **under** the drawing. No outer-edge tick ruler or meridian box. Phrase eases spin: hook crawl → turn whip → tag hold. Camera is a seed shot (`front` `three-quarter` `top` `low` `dutch` `side`) with a turn push-in — same organ, different silhouette. Turn ruptures cage (gold lantern) and snap (held gold slash). Focus wears one large eclipse moon the noun eats. Mill swirl is a cyan/gold jewel, snap is a ghost hull + 2–3 strikes, spark is coals on verts and midpoints. Receipt `visualConfig.mesh` + `visualConfig.field` + `organ` are the NFT fingerprints.
 
 Motions encode **≥720p**. The old 320×180 ffmpeg wireframe is **`--engine wireframe` only**.
 
 Every Blip muxes a **4.44s audio bed** (`--bed PATH` or auto sound mill). No audio stream = inspect FAIL.
 
 `still` is the **Power Plant ident** — titlecard / corridor / rain / endcard dissolve over 4.44s at ≥720p. Not a frozen poster. Palette `#08090B` `#F5F7FA` `#3DE0E8` `#F5C518` `#4A7FD4`.
+
+## Design opt — `kapow`
+
+Not a Rippel import and not a `--look`. `--mode motion:kapow` paints a comic two-tier burst: 8–10 outer points, 6–8 inner, some spikes longer than others. Ink outline, sparse speed lines, readable `KAPOW!`. Hook winds the outer ring. The jewel cut slams the inner burst and the word. Tag holds. One noun sits under the word. `blip-vibe` scores still + Rippel five + kapow on the same organ — every type must hit **8** to ship. Same seed camera / genre grid / 4.44s bed as the five.

package/scripts/foundry/plant/motions/registry.json

@@ -1,7 +1,8 @@
 {
   "version": 1,
-  "law": "Motions are a dynamic registry (id → renderer). Rippel names are imports. Kapow is a growth stub until a renderer ships.",
+  "law": "Motions are a dynamic registry (id → renderer). Rippel names are imports. Kapow is a design opt — two-tier stamp on the stanza.",
   "v0": ["still", "orb", "swirl", "snap", "waves", "spark"],
+  "opt": ["kapow"],
   "palette": {
     "void": "#08090B",
     "ink": "#F5F7FA",
@@ -73,9 +74,9 @@
       "id": "kapow",
       "kind": "motion",
       "source": "blips",
-      "renderer": null,
-      "status": "growth",
-      "notes": "named growth slot — FAIL until a renderer ships"
+      "renderer": "kapow",
+      "status": "opt",
+      "notes": "Two-tier KAPOW on hook → turn → tag. Outer burst winds, inner burst + word stamp the jewel cut. Not a look. ≥720p + 4.44s bed."
     }
   ]
 }

package/scripts/foundry/plant/skills/blip/SKILL.md

@@ -13,7 +13,7 @@ This **factory plant** fastens a tiny-video factory. 4.44 seconds of picture **w
 
 `still` · `orb` · `swirl` · `snap` · `waves` · `spark`
 
-Rippel five are **imports**. Each mint is a **4.44s Short** — hook → turn → tag on one grid for picture and bed (continuous `hookEase`/`turnEase`/`tagEase`, not gear-shift flags). Seed-selected look (`focus` solid disc + satellites + field/mesh mass, or `cage` Wu hairline + field). Receipt `visualConfig.lookKind` + mesh + field are the fingerprints. `kapow` is a growth stub (FAIL until a renderer ships). Unknown id FAIL.
+Rippel five are **imports**. Four seed + flag axes: `--look focus|cage`, `--body mill|rippel`, `--genre ambient|techno|phonk|jazz|rock|timeless`, `--camera front|three-quarter|top|low|dutch|side` (unknown camera FAIL). Suit is void + five hexes + Wu + hook → turn → tag — not a circle pack on every organ. Focus keeps the disc + one large eclipse moon the noun eats. Cage and snap rupture on the turn (gold lantern / held slash). Mill swirl is Wu mesh, snap is strike, spark is embers. Same organ, different shot — top flattens, low lifts, dutch slashes the floor. Turn dollies in. Cage recoils then whips. Receipt `lookKind` + `bodyKind` + `genre` + `organ` + `camera` + `stereoImage`. `kapow` is a design opt (`--mode motion:kapow`) — two-tier stamp, not a third look. Unknown id FAIL.
 
 `still` is the **Power Plant ident** — titlecard / corridor / rain / endcard dissolve over 4.44s at ≥720p, not a frozen poster: void `#08090B` · ink `#F5F7FA` · cyan `#3DE0E8` · gold `#F5C518` · agent blue `#4A7FD4`. Motions use that palette as the Rippel `VisualConfig.circles` theme. The mill is the renderer — no LLM in the pixel/audio loop.
 
@@ -21,8 +21,8 @@ Rippel five are **imports**. Each mint is a **4.44s Short** — hook → turn
 
 1. **Brief** → checksum seed → Rippel `VisualConfig` (`CircleConfig[]`).
 2. **Mode** → `still` or `motion:<id>` from the registry.
-3. **Render** → 4.44s mp4. Motions are Rippel v2 viz at ≥720p (`--look focus|cage`, seed picks if omitted). `--engine wireframe` is emergency only.
-4. **Bed** → `--bed PATH` or auto sound mill. Auto bed **syncopates** to the motion grid (same seed + tempo + phase; downbeat kick / AND hat). Every mp4 muxes **stereo AAC**. Missing stream or inaudible bed = inspect FAIL.
+3. **Render** → 4.44s mp4. Motions are Rippel v2 viz at ≥720p (`--look focus|cage --body mill|rippel`, seed picks if omitted). `--engine wireframe` is emergency only.
+4. **Bed** → `--bed PATH` or auto sound mill. Auto bed **syncopates** to the motion grid (same seed + tempo + phase; downbeat kick / AND hat). The crash + motif answer land on the jewel cut. Every mp4 muxes **stereo AAC**. Missing stream or inaudible bed = inspect FAIL.
 5. **Inspect gate** → file, duration 4.44s±tol, mode id, **audio stream**, motion ≥720p. Fail-closed.
 6. **Receipt** → `.xray/blip/receipt.json` (`PASS` / `FAIL` + pictureMode + motionId + visualConfig).
 
@@ -34,6 +34,6 @@ npx @0xray/foundry blip inspect
 npx @0xray/foundry inspect --skip-live
 ```
 
-Mint fastens `blip` + `blip-inspect`. Chat is not a receipt.
+Mint fastens `blip` + `blip-inspect` + `blip-vibe`. Chat is not a receipt.
 
 A friend would hear: Blips should look like Rippel living motions with sound, not a silent wireframe box.