0xray 4.0.13 → 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,6 +25,15 @@ 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"];
 
+/** 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"] },
+};
+
+function isFactoryPlantKind(kind) {
+  return Boolean(millPlantProtocol.parsePlantToken(kind));
+}
+
 function deepMerge(src, dest) {
   if (typeof src !== "object" || src === null) return dest !== undefined ? dest : src;
   if (Array.isArray(src)) return Array.isArray(dest) ? dest : src;
@@ -111,11 +121,91 @@ 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, 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: mill | @scope/name | @scope/name/id | blip|sound aliases | array. millPlant:false strips mill. */
+function loadFactoryPlantKinds(targetDir, millPackageRoot) {
+  const extra = loadFoundryExtra(targetDir);
+  const seats = millPlantProtocol.resolvePlantSeats(targetDir, millPackageRoot, extra);
+  return millPlantProtocol.plantKindsFromSeats(seats);
+}
+
+function unionPlantFiles(kinds, millPackageRoot) {
+  const skills = [];
+  const agents = [];
+  for (const kind of kinds) {
+    const spec = catalogPlant(kind, millPackageRoot);
+    for (const name of spec.skills) {
+      if (!skills.includes(name)) skills.push(name);
+    }
+    for (const file of spec.agents) {
+      if (!agents.includes(file)) agents.push(file);
+    }
+  }
+  return { skills, agents };
+}
+
+function existingPlantFiles(plantDir, spec) {
+  if (!plantDir || !spec) return emptyPlantFiles();
+  const skillsSrc = path.join(plantDir, "skills");
+  const agentsSrc = path.join(plantDir, "agents");
+  const haveSkills = new Set(listSkillNamesAt(skillsSrc));
+  const haveAgents = new Set(listAgentFilesAt(agentsSrc));
+  return {
+    skills: spec.skills.filter((name) => haveSkills.has(name)),
+    agents: spec.agents.filter((file) => haveAgents.has(file)),
+  };
+}
+
+function factoryPlantAllowlist(millPackageRoot, targetDir) {
+  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) {
+  return millPlantProtocol.plantKindsFromInventory(inventory);
 }
 
 function listSkillNamesAt(skillsSrc) {
@@ -141,41 +231,100 @@ function listAgentFilesAt(agentsSrc) {
     .map((entry) => entry.name);
 }
 
-/** Fasten mill plant first. Mill names they did not plant stay; same-name overlay wins. */
-function fastenMillPlant(millPackageRoot, targetDir, log) {
-  const plant = millPlantDir(millPackageRoot);
-  if (!plant) return { skills: [], agents: [] };
-  const skillsSrc = path.join(plant, "skills");
-  const agentsSrc = path.join(plant, "agents");
-  const skills = listSkillNamesAt(skillsSrc);
-  const agents = listAgentFilesAt(agentsSrc);
+function copyPlantFiles(plant, spec, targetDir) {
+  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 (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 (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);
+    }
   }
-  if (log && (skills.length > 0 || agents.length > 0)) {
-    log("foundry-mint", "Fastened mill plant", "info", {
-      skills: skills.length,
-      agents: agents.length,
+  return { skills, agents };
+}
+
+/** Fasten requested plants. Mill files come from this foundry plant/. Mill-package organs come from that package. */
+function fastenMillPlant(millPackageRoot, targetDir, log) {
+  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 = soundSeat
+    ? { skills: [...soundSeat.skills], agents: [...soundSeat.agents] }
+    : emptyPlantFiles();
+  const blip = blipSeat
+    ? { skills: [...blipSeat.skills], agents: [...blipSeat.agents] }
+    : emptyPlantFiles();
+  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: fastenedSkills.length,
+      agents: fastenedAgents.length,
     });
   }
-  return { skills, agents };
+  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) {
@@ -371,30 +520,114 @@ function previousTreeAllowlist(targetDir) {
     const shopSkills = Array.isArray(shopFromInv)
       ? normalizeNameList(shopFromInv)
       : normalizeNameList(shopFromInv?.skills);
+    const soundFromInv = inventory?.soundPlant;
+    const soundSkills = Array.isArray(soundFromInv)
+      ? normalizeNameList(soundFromInv)
+      : normalizeNameList(soundFromInv?.skills);
+    const soundAgents = normalizeNameList(soundFromInv?.agents);
+    const blipFromInv = inventory?.blipPlant;
+    const blipSkills = Array.isArray(blipFromInv)
+      ? 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 : []),
+        ...(Array.isArray(inventory?.millPlant?.skills) ? inventory.millPlant.skills : []),
         ...shopSkills,
+        ...soundSkills,
+        ...blipSkills,
+        ...extraPlantSkills,
+      ],
+      agents: [
+        ...(Array.isArray(inventory?.tree?.agents) ? inventory.tree.agents : []),
+        ...(Array.isArray(inventory?.millPlant?.agents) ? inventory.millPlant.agents : []),
+        ...soundAgents,
+        ...blipAgents,
+        ...extraPlantAgents,
       ],
-      agents: Array.isArray(inventory?.tree?.agents) ? inventory.tree.agents : [],
     };
   } catch {
     return { skills: [], agents: [] };
   }
 }
 
-/** Extra worn names that are neither mill plant, their plant, shop plant, nor a prior overlay. */
+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, millPackageRoot);
+  if (!kinds.includes("sound")) return emptyPlantFiles();
+  return millPackagePlantFromTree(targetDir, tree, "sound", millPackageRoot);
+}
+
+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, 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. */
 function costumeDumpExtras(targetDir, millPlant, tree) {
   const prior = previousTreeAllowlist(targetDir);
   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 : []),
     ...prior.skills,
     ...shopPlant,
   ]);
   const allowedAgents = new Set([
     ...(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 : []),
     ...prior.agents,
   ]);
@@ -482,10 +715,19 @@ function mintConsumerFromSsot(packageRoot, targetDir, log, tree) {
   const millPlanted =
     (Array.isArray(tree?.millPlantSkills) && tree.millPlantSkills.length > 0) ||
     (Array.isArray(tree?.millPlantAgents) && tree.millPlantAgents.length > 0);
+  const soundPlanted =
+    (Array.isArray(tree?.soundPlantSkills) && tree.soundPlantSkills.length > 0) ||
+    (Array.isArray(tree?.soundPlantAgents) && tree.soundPlantAgents.length > 0);
+  const blipPlanted =
+    (Array.isArray(tree?.blipPlantSkills) && tree.blipPlantSkills.length > 0) ||
+    (Array.isArray(tree?.blipPlantAgents) && tree.blipPlantAgents.length > 0);
+  const plantKinds = Array.isArray(tree?.plantKinds) && tree.plantKinds.length > 0
+    ? tree.plantKinds
+    : loadFactoryPlantKinds(targetDir);
   const costume = wantsCostume(targetDir);
   const suit = overlayed
     ? "overlay"
-    : millPlanted
+    : millPlanted || soundPlanted || blipPlanted
       ? "fastened"
       : costume
         ? "costume"
@@ -494,12 +736,21 @@ function mintConsumerFromSsot(packageRoot, targetDir, log, tree) {
     mill: { name: mill.name || "@0xray/foundry", version: mill.version },
     consumer: { name: consumer.name, version: consumer.version },
     suit,
+    plant: plantKinds,
     params: tree?.params || loadFoundryParams(targetDir),
     tree: { skills, agents },
     millPlant: {
       skills: Array.isArray(tree?.millPlantSkills) ? tree.millPlantSkills : [],
       agents: Array.isArray(tree?.millPlantAgents) ? tree.millPlantAgents : [],
     },
+    soundPlant: {
+      skills: Array.isArray(tree?.soundPlantSkills) ? tree.soundPlantSkills : [],
+      agents: Array.isArray(tree?.soundPlantAgents) ? tree.soundPlantAgents : [],
+    },
+    blipPlant: {
+      skills: Array.isArray(tree?.blipPlantSkills) ? tree.blipPlantSkills : [],
+      agents: Array.isArray(tree?.blipPlantAgents) ? tree.blipPlantAgents : [],
+    },
     shopPlant: {
       skills: Array.isArray(tree?.shopPlantSkills) ? tree.shopPlantSkills : loadShopPlant(targetDir),
     },
@@ -514,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 });
@@ -539,8 +797,20 @@ function mintConsumerSuit(millPackageRoot, targetDir, log) {
   const params = loadFoundryParams(targetDir);
   const millPlant = fastenMillPlant(millPackageRoot, targetDir, log);
   const tree = overlayConsumerTree(targetDir, log, params);
+  tree.plantKinds = millPlant.kinds || loadFactoryPlantKinds(targetDir);
   tree.millPlantSkills = millPlant.skills;
   tree.millPlantAgents = millPlant.agents;
+  tree.soundPlantSkills = millPlant.sound?.skills || [];
+  tree.soundPlantAgents = millPlant.sound?.agents || [];
+  tree.sound = millPlant.sound || emptyPlantFiles();
+  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),
@@ -569,6 +839,22 @@ function mintConsumerSuit(millPackageRoot, targetDir, log) {
 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,
   loadFoundryExtra,
@@ -576,6 +862,11 @@ module.exports = {
   declaredShopPlant,
   wantsCostume,
   millPlantDir,
+  loadFactoryPlantKinds,
+  factoryPlantAllowlist,
+  inventoryPlantKinds,
+  catalogPlant,
+  unionPlantFiles,
   listSkillNamesAt,
   listAgentFilesAt,
   fastenMillPlant,

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,11 +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"
   },
@@ -49,6 +64,8 @@
     "0xray",
     "foundry",
     "mill",
+    "sound",
+    "blip",
     "release",
     "changelog"
   ]

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

@@ -0,0 +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.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

@@ -0,0 +1,5 @@
+name: blip
+skill: blip
+description: "Factory-blip plant. Brief → seed → still|motion:<id> → 4.44s mp4 → inspect gate."
+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

@@ -0,0 +1,5 @@
+name: sound-inspect
+skill: sound-inspect
+description: "Inspect the last factory-sound bed: chop, levels, peak, hum. Fail-closed."
+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

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

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

@@ -0,0 +1,41 @@
+# 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 design opt — two-tier stamp on hook → turn → tag.
+
+On-disk SSOT: `registry.json` next to this file.
+
+## v0 seed
+
+`still` · `orb` · `swirl` · `snap` · `waves` · `spark`
+
+## Rippel v2 — converter + living motions (TICKET-BLIP-RENDERER-UPGRADE)
+
+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 | 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 · 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.