0xray 4.0.12 → 4.0.14

package/scripts/foundry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xray/foundry",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "private": false,
   "type": "module",
   "description": "0xRay mill: mint their suit params, stamp, gate, publish, CI report, git hooks. Not the worn exo.",
@@ -38,6 +38,10 @@
     "./mill-root": "./mill-root.mjs",
     "./mint-suit": "./mint-suit.cjs",
     "./inspect": "./inspect.mjs",
+    "./sound": "./sound.mjs",
+    "./sound-bed": "./sound-bed.cjs",
+    "./blip": "./blip.mjs",
+    "./blip-render": "./blip-render.cjs",
     "./ci-monitor": "./ci-monitor.mjs",
     "./hooks": "./hooks.mjs",
     "./docs-build": "./docs-build.mjs"
@@ -49,6 +53,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.10"
+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.10"
+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.9"
+version: "0.1.10"
 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.9"
+version: "0.1.10"
 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.10"
+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.10"
+mode: subagent

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

@@ -0,0 +1,35 @@
+# 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.
+
+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.
+
+- **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 |
+
+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.
+
+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`.

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

@@ -0,0 +1,81 @@
+{
+  "version": 1,
+  "law": "Motions are a dynamic registry (id → renderer). Rippel names are imports. Kapow is a growth stub until a renderer ships.",
+  "v0": ["still", "orb", "swirl", "snap", "waves", "spark"],
+  "palette": {
+    "void": "#08090B",
+    "ink": "#F5F7FA",
+    "cyan": "#3DE0E8",
+    "gold": "#F5C518",
+    "blue": "#4A7FD4",
+    "plate": "power-plant-intro"
+  },
+  "motions": [
+    {
+      "id": "still",
+      "kind": "motion",
+      "source": "blips",
+      "renderer": "still",
+      "status": "v0",
+      "notes": "Power Plant ident — hard-cut titlecard/corridor/rain/endcard over 4.44s. Not a frozen still. ≥720p + bed."
+    },
+    {
+      "id": "orb",
+      "kind": "motion",
+      "source": "rippel",
+      "import": true,
+      "visualization": "canvas",
+      "renderer": "orb",
+      "status": "v0",
+      "notes": "Rippel v2 canvas — Orb Glow, sharp discs, dual rings + beat tick. ≥720p + 4.44s bed."
+    },
+    {
+      "id": "swirl",
+      "kind": "motion",
+      "source": "rippel",
+      "import": true,
+      "visualization": "3d-sacred",
+      "renderer": "swirl",
+      "status": "v0",
+      "notes": "Rippel v2 3d-sacred — merkaba + hex plate, counter-spin, beat vertices. ≥720p + 4.44s bed."
+    },
+    {
+      "id": "snap",
+      "kind": "motion",
+      "source": "rippel",
+      "import": true,
+      "visualization": "neural",
+      "renderer": "snap",
+      "status": "v0",
+      "notes": "Rippel v2 neural — dual-ring lattice, hub, skip-links, frequency + beat pulses. ≥720p + 4.44s bed."
+    },
+    {
+      "id": "waves",
+      "kind": "motion",
+      "source": "rippel",
+      "import": true,
+      "visualization": "waveform",
+      "renderer": "waves",
+      "status": "v0",
+      "notes": "Rippel v2 Wave Flow — harmonic ribbons + beat envelope + gold needle. ≥720p + 4.44s bed."
+    },
+    {
+      "id": "spark",
+      "kind": "motion",
+      "source": "rippel",
+      "import": true,
+      "visualization": "particles",
+      "renderer": "spark",
+      "status": "v0",
+      "notes": "Rippel v2 Spark Drift — beat bursts, orbital + radial motes, short trails. ≥720p + 4.44s bed."
+    },
+    {
+      "id": "kapow",
+      "kind": "motion",
+      "source": "blips",
+      "renderer": null,
+      "status": "growth",
+      "notes": "named growth slot — FAIL until a renderer ships"
+    }
+  ]
+}

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

@@ -0,0 +1,39 @@
+---
+name: blip
+description: Factory-blip plant. Brief → checksum seed → still|motion:<id> → 4.44s mp4 → inspect gate. Sibling to mill + sound. Not costume.
+---
+
+# Blip
+
+This **factory plant** fastens a tiny-video factory. 4.44 seconds of picture **with a mandatory audio bed**. Sibling to mill + sound — not a mill copy.
+
+**Seat:** `foundry.json` `"plant": "blip"` turns mill off. `"plant": ["mill", "blip"]` wears both. Default stays mill+inspect.
+
+**Motions** live in an on-disk registry (`plant/motions/registry.json`). v0 seed:
+
+`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.
+
+`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.
+
+**Spine (headless, no browser):**
+
+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.
+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).
+
+```bash
+npx @0xray/foundry mint --skip-live
+npx @0xray/foundry blip render --brief "night alley still" --mode still
+npx @0xray/foundry blip render --brief "warehouse floor · Power Plant" --mode motion:orb --look focus
+npx @0xray/foundry blip inspect
+npx @0xray/foundry inspect --skip-live
+```
+
+Mint fastens `blip` + `blip-inspect`. Chat is not a receipt.
+
+A friend would hear: Blips should look like Rippel living motions with sound, not a silent wireframe box.

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

@@ -0,0 +1,32 @@
+---
+name: blip-inspect
+description: Inspect the last factory-blip — duration 4.44s, registry mode id, file present. Fail-closed. Not costume.
+---
+
+# Blip inspect
+
+This is the **factory-blip** inspect, not mill inspect. Open the receipt. Quote the numbers. Do not invent a pass.
+
+`npx @0xray/foundry inspect` reports blip plant present, live registry ids, plus last blip `PASS`/`FAIL`. `npx @0xray/foundry blip inspect` is the same check.
+
+## Gates (fail-closed)
+
+Missing mp4, unreadable mp4, or a thrown probe is **FAIL**. Never pass on a missing file.
+
+1. **File.** `.xray/blip/blip.mp4` (or receipt `mp4`) exists.
+2. **Duration.** 4.44s ± 0.12s.
+3. **Mode.** Receipt records a registry id (`still` or `motion:<id>`). Unknown id is FAIL.
+4. **Video.** Stream present.
+5. **Audio.** Stream present. Silent mp4 = FAIL. `--bed` or auto sound mill.
+6. **Resolution.** Every live blip ≥720p (`1280×720`), including the Power Plant ident (`still`).
+
+v0 ids: `still` · `orb` · `swirl` · `snap` · `waves` · `spark`. `kapow` is a growth stub (FAIL until a renderer ships). Unknown id FAIL. Receipt records the Power Plant palette.
+
+Receipt: `.xray/blip/receipt.json`. Mp4 default: `.xray/blip/blip.mp4`.
+
+```bash
+npx @0xray/foundry blip render --brief "warm basement swirl" --mode motion:swirl --bed bed.wav
+npx @0xray/foundry blip inspect
+```
+
+Plant-vs-worn allowlists `blip` + `blip-inspect` when `"plant": "blip"`. They are not a costume dump. Mill may be off on this seat.

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

@@ -12,8 +12,8 @@ Mill **does** these checks (`npx @0xray/foundry inspect`). Mint fails on a costu
 ## What mill inspects
 
 1. **Diff.** `git status` / `git diff --stat` of the milled cwd. Ignore the agent's summary if the diff disagrees.
-2. **Plant vs worn.** `src/skills`, `src/opencode/agents` vs `.opencode/skills`, `.opencode/agents`. Same name: plant wins. Shop plant (`shop-extract`, `shop-witness`, `shop-pin`, plus `foundry.json` `shopPlant`) is first-class with mill plant. Costume dump (worn names they did not plant, mill did not fasten, and shop plant did not name) fails mint unless `foundry.json` has `"costume": true`.
-3. **Mill receipt.** `.xray/foundry-inventory.json` — mill name/version, `suit` (`fastened` / `overlay` / `costume`), `millPlant.skills` must include `mill` and `inspect`.
+2. **Plant vs worn.** `src/skills`, `src/opencode/agents` vs `.opencode/skills`, `.opencode/agents`. Same name: plant wins. Shop plant (`shop-extract`, `shop-witness`, `shop-pin`, plus `foundry.json` `shopPlant`) is first-class with mill plant. Sound plant (`sound`, `sound-inspect`) is first-class when `foundry.json` `"plant": "sound"` (mill may be off). Blip plant (`blip`, `blip-inspect`) is first-class when `foundry.json` `"plant": "blip"` (mill may be off). Costume dump (worn names they did not plant, mill did not fasten, sound did not fasten, blip did not fasten, and shop plant did not name) fails mint unless `foundry.json` has `"costume": true`.
+3. **Mill receipt.** `.xray/foundry-inventory.json` — mill name/version, `suit` (`fastened` / `overlay` / `costume`), `plant`. Mill seats: `millPlant.skills` must include `mill` and `inspect`. Sound seats: `soundPlant.skills` must include `sound` and `sound-inspect`; last bed receipt is a separate check. Blip seats: `blipPlant.skills` must include `blip` and `blip-inspect`; last blip receipt is a separate check.
 4. **CI.** GitHub mill CI report (`.opencode/logs/ci-cd-monitor-report.json`), not a green check in chat. No token is a skip, not a pass invented.
 5. **Live PUT.** HTTP 200 on the npm `.tgz`. Metadata without a tarball is not shipped.
 6. **Isolated HOME.** Last-mile dest is project `.grok/plugins/0xray`. Isolated HOME may wear `$HOME/.grok/plugins/0xray` and must not write machine `~/.grok/plugins/0xray`. Shared HOME (passwd `$HOME`) does not last-wins clobber the machine plugin. Mill compares `$HOME` to the passwd home (`os.userInfo().homedir`), not `os.homedir()` (which follows `$HOME`).

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

@@ -0,0 +1,29 @@
+---
+name: sound
+description: Factory-sound plant. Brief → checksum seed → genre → headless wav → metrics gate. Not mill. Not costume.
+---
+
+# Sound
+
+This plant **fastens** a music/bed factory. Dist audio beds get a real plant like mill — not code-mill skills on a sound seat.
+
+**Seat:** `foundry.json` `"plant": "sound"` turns mill off. `"plant": ["mill", "sound"]` wears both. Default stays mill+inspect.
+
+**Spine (headless, no browser):**
+
+1. **Brief** → checksum seed (stable hash lineage).
+2. **Genre** → tempo + voice prefs: `ambient` | `techno` | `jazz` (`phonk` / `destination` are aliases).
+3. **Render** → wav via a crystal-clear mill of Rippel’s prototype chains (Membrane kick / Metal hat / Duo bass / mixer). Tone.Offline is blocked in Node (`OfflineAudioContext` missing); this is the lean headless port, not a 3-sine bed and not the Lovable volume-hack soup.
+4. **Metrics gate** → chop / levels / peak / hum. Fail-closed.
+5. **Receipt** → `.xray/sound-bed-receipt.json` (`PASS` / `FAIL` + numbers).
+
+```bash
+npx @0xray/foundry mint --skip-live
+npx @0xray/foundry sound render --brief "night alley rain" --genre ambient
+npx @0xray/foundry sound inspect
+npx @0xray/foundry inspect --skip-live
+```
+
+Mint fastens `sound` + `sound-inspect`. It does not dump mill inspect onto a sound-only seat. Chat is not a bed receipt.
+
+A friend would hear: the sound mill mills Dist beds like Rippel’s prototype grew up — kick membranes, metal hats, and a crystal-clear mixer, not a muddy toy and not a 3-sine pad.

package/scripts/foundry/plant/skills/sound-inspect/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: sound-inspect
+description: Inspect the last factory-sound bed — loudness/smoothness gates, not code-mill diffs. Not costume.
+---
+
+# Sound inspect
+
+This is the **bed** inspect, not mill inspect. Open the receipt. Quote the numbers. Do not invent a pass.
+
+`npx @0xray/foundry inspect` reports sound plant present plus last bed `PASS`/`FAIL`. `npx @0xray/foundry sound inspect` is the same bed check.
+
+## Gates (fail-closed)
+
+Missing wav, unreadable wav, or a thrown metric is **FAIL**. Never pass on silence.
+
+1. **Chop.** Mean |ΔRMS| over 0.25s windows ≪ 0.1 (strong ≤ 0.05).
+2. **Levels.** Body / intro mean RMS ratio ~1.5–3.0. Body min RMS ≥ 0.05 (exclude the final 1s fade).
+3. **Peak.** Max |sample| < 0.95.
+4. **Hum.** No continuous near-constant drone (dominant-bin share over the piece).
+
+Receipt: `.xray/sound-bed-receipt.json`. Wav default: `.xray/sound/bed.wav`.
+
+```bash
+npx @0xray/foundry sound render --brief "warm basement pad" --genre jazz
+npx @0xray/foundry sound inspect
+```
+
+Plant-vs-worn allowlists `sound` + `sound-inspect` when `"plant": "sound"`. They are not a costume dump. Mill may be off on this seat.

package/scripts/foundry/release-gate.mjs

@@ -53,33 +53,41 @@ function main() {
     if (!isXrayExoRepo(rootDir)) {
       runLightGate();
     } else if (verifyOnly) {
-      step("1/5 Git + reconcile", "node scripts/node/pre-publish-guard.js --verify-only");
+      step("1/6 Git + reconcile", "node scripts/node/pre-publish-guard.js --verify-only");
       if (!skipDocs) {
-        step("2/5 Release docs", docsCheckCmd());
+        step("2/6 Release docs", docsCheckCmd());
       }
       step(
-        "3/5 Plugin infrastructure",
+        "3/6 Plugin infrastructure",
         "node scripts/test/validate-plugins-e2e.cjs --structural-only",
       );
+      step(
+        "4/6 Packed dist/cli",
+        `${JSON.stringify(process.execPath)} ${JSON.stringify(millScript("assert-packed-dist-cli.mjs"))}`,
+      );
       if (!skipSmoke) {
-        step("4/5 Consumer install smoke", "node scripts/node/consumer-install-smoke.mjs");
+        step("5/6 Consumer install smoke", "node scripts/node/consumer-install-smoke.mjs");
       }
     } else {
-      step("1/7 Build", "npm run build");
-      step("2/7 Tests", "npm run test:comprehensive");
+      step("1/8 Build", "npm run build");
+      step(
+        "2/8 Packed dist/cli",
+        `${JSON.stringify(process.execPath)} ${JSON.stringify(millScript("assert-packed-dist-cli.mjs"))}`,
+      );
+      step("3/8 Tests", "npm run test:comprehensive");
       if (!skipDocs) {
-        step("3/7 Release docs", docsCheckCmd());
+        step("4/8 Release docs", docsCheckCmd());
       }
       step(
-        "4/7 Consumer hook verifiers",
+        "5/8 Consumer hook verifiers",
         "npm run verify:pre-commit-diff && npm run verify:pre-push-diff && node scripts/mjs/verify-delegation-gate-core.mjs --host=grok && node scripts/mjs/verify-delegation-gate-core.mjs --host=hermes && node scripts/mjs/verify-delegation-gate-core.mjs --host=opencode && node scripts/mjs/verify-hermes-session-start.mjs && node scripts/mjs/verify-confer-core.mjs && npm run verify:user-aside && npm run build && node scripts/mjs/verify-pipeline-facets.mjs --package-only",
       );
       step(
-        "5/7 Plugin infrastructure",
+        "6/8 Plugin infrastructure",
         "node scripts/test/validate-plugins-e2e.cjs --structural-only",
       );
       if (!skipSmoke) {
-        step("6/7 Consumer install smoke (fresh + upgrade)", "node scripts/node/consumer-install-smoke.mjs");
+        step("7/8 Consumer install smoke (fresh + upgrade)", "node scripts/node/consumer-install-smoke.mjs");
       }
     }
 

package/scripts/foundry/release.mjs

@@ -112,6 +112,9 @@ function publishIdempotent(version) {
     console.log(`ℹ️  ${packageName()}@${version} already on npm — skipping publish`);
     return;
   }
+  if (isXrayExoRepo(rootDir)) {
+    runMill("assert-packed-dist-cli.mjs", [], "packed dist/cli");
+  }
   execSync(npmPublishCmd(), { cwd: rootDir, stdio: "inherit", encoding: "utf-8" });
   console.log(`✅ Published ${packageName()}@${version}`);
 }