@h-rig/product-ad-website 0.0.6-alpha.283

package/site/assets/site.js

@@ -0,0 +1,510 @@
+/* Shared site behaviors: Pi terminal player + docs search.
+   Loaded on every page (path-relative); see scripts/site-build.ts. */
+
+/* ---------- Pi terminal player ----------
+   Markup contract:
+   <div class="pi-term" data-title="pi — attach" data-rows="14">
+     <script type="application/json">[
+       {"t":"u","s":"so now tell me: what's so special about pi?"},
+       {"t":"think","ms":1400},
+       {"t":"out","s":"Pi is minimal by design, and it can change itself in place."},
+       {"t":"del","s":"  --recording-font-family: var(--serif);"},
+       {"t":"add","s":"  --recording-font-family: \"Comic Sans MS\", cursive;"},
+       {"t":"pause","ms":2000}
+     ]</script>
+     <div class="pi-term-status-data" hidden
+       data-path="~/work/rig (main)"
+       data-stats="&uarr;6.4k &darr;122 R9.3k $0.000 (sub) 5.5%/128k (auto)"
+       data-model="worker brain &bull; thinking off"></div>
+   </div>
+   Step types: u (typed user line), out, dim, code, add, del (instant lines),
+   think (transient "Thinking..."), pause. The player builds the chrome,
+   plays on viewport entry, loops forever. */
+(function () {
+  var terms = document.querySelectorAll(".pi-term");
+  if (!terms.length) return;
+
+  function build(term) {
+    var scriptEl = term.querySelector('script[type="application/json"]');
+    if (!scriptEl) return null;
+    var steps;
+    try { steps = JSON.parse(scriptEl.textContent); } catch (e) { return null; }
+    var statusData = term.querySelector(".pi-term-status-data");
+    var rows = parseInt(term.getAttribute("data-rows") || "12", 10);
+
+    var bar = document.createElement("div");
+    bar.className = "pi-term-bar";
+    var t = document.createElement("span");
+    t.className = "t";
+    t.textContent = term.getAttribute("data-title") || "pi";
+    var dot = document.createElement("span");
+    dot.className = "dot";
+    bar.appendChild(t); bar.appendChild(dot);
+
+    var body = document.createElement("div");
+    body.className = "pi-term-body";
+    body.style.height = (rows * 1.85) + "em";
+
+    var input = document.createElement("div");
+    input.className = "pi-term-input";
+    var typed = document.createElement("span");
+    var cur = document.createElement("span");
+    cur.className = "cur";
+    cur.innerHTML = "&nbsp;";
+    input.appendChild(typed); input.appendChild(cur);
+
+    var status = document.createElement("div");
+    status.className = "pi-term-status";
+    var r1 = document.createElement("div");
+    r1.className = "row";
+    r1.textContent = statusData ? (statusData.getAttribute("data-path") || "") : "";
+    var r2 = document.createElement("div");
+    r2.className = "row";
+    var left = document.createElement("span");
+    left.innerHTML = statusData ? (statusData.getAttribute("data-stats") || "") : "";
+    var right = document.createElement("span");
+    right.className = "right";
+    right.innerHTML = statusData ? (statusData.getAttribute("data-model") || "") : "";
+    r2.appendChild(left); r2.appendChild(right);
+    status.appendChild(r1); status.appendChild(r2);
+
+    term.appendChild(bar); term.appendChild(body); term.appendChild(input); term.appendChild(status);
+    return { steps: steps, body: body, typed: typed, rows: rows };
+  }
+
+  function play(st) {
+    var i = 0, lines = [], timer = null, thinkEl = null;
+
+    function render() {
+      while (lines.length > st.rows) lines.shift();
+      st.body.innerHTML = "";
+      for (var k = 0; k < lines.length; k++) st.body.appendChild(lines[k]);
+    }
+    function addLine(cls, text) {
+      var el = document.createElement("div");
+      el.className = "ln " + cls;
+      el.textContent = text;
+      lines.push(el);
+      render();
+      return el;
+    }
+    function schedule(ms) { timer = setTimeout(step, ms); }
+
+    function step() {
+      if (thinkEl) {
+        var ix = lines.indexOf(thinkEl);
+        if (ix >= 0) lines.splice(ix, 1);
+        thinkEl = null;
+        render();
+      }
+      if (i >= st.steps.length) { i = 0; lines = []; st.typed.textContent = ""; render(); schedule(1200); return; }
+      var s = st.steps[i++];
+      if (s.t === "pause") { schedule(s.ms || 1500); return; }
+      if (s.t === "think") {
+        thinkEl = addLine("think", "Thinking...");
+        schedule(s.ms || 1400);
+        return;
+      }
+      if (s.t === "u") {
+        // typewriter into the input slot, then commit to the body
+        var text = s.s || "", p = 0;
+        st.typed.textContent = "";
+        (function type() {
+          if (p < text.length) {
+            st.typed.textContent += text.charAt(p++);
+            timer = setTimeout(type, 24 + Math.random() * 40);
+          } else {
+            timer = setTimeout(function () {
+              st.typed.textContent = "";
+              addLine("u", text);
+              addLine("dim", "");
+              schedule(420);
+            }, 380);
+          }
+        })();
+        return;
+      }
+      addLine(s.t, s.s || "");
+      schedule(s.ms || 320);
+    }
+
+    return {
+      start: function () { if (!timer) step(); },
+      stop: function () { if (timer) { clearTimeout(timer); timer = null; } }
+    };
+  }
+
+  var players = [];
+  terms.forEach(function (term) {
+    var st = build(term);
+    if (st) players.push({ el: term, p: play(st), running: false });
+  });
+  if (!("IntersectionObserver" in window)) {
+    players.forEach(function (e) { e.p.start(); });
+    return;
+  }
+  var io = new IntersectionObserver(function (entries) {
+    entries.forEach(function (en) {
+      var rec = players.find(function (e) { return e.el === en.target; });
+      if (!rec) return;
+      if (en.isIntersecting && !rec.running) { rec.running = true; rec.p.start(); }
+    });
+  }, { threshold: 0.25 });
+  players.forEach(function (e) { io.observe(e.el); });
+})();
+
+/* ---------- docs search (Cmd/Ctrl-K) ---------- */
+(function () {
+  // Resolve the site root from this script's own src so every page depth works.
+  var me = document.currentScript || document.querySelector('script[src*="site.js"]');
+  var base = me ? me.getAttribute("src").replace(/assets\/site\.js.*$/, "") : "./";
+
+  var overlay = null, input = null, resultsEl = null, index = null, sel = 0, items = [];
+
+  function ensureUi() {
+    if (overlay) return;
+    overlay = document.createElement("div");
+    overlay.className = "search-overlay";
+    overlay.innerHTML =
+      '<div class="search-box">' +
+      '<input type="text" placeholder="Search the docs..." autocomplete="off" spellcheck="false">' +
+      '<div class="search-results"></div>' +
+      '<div class="search-hint"><span>&uarr;&darr; navigate</span><span>&crarr; open</span><span>esc close</span></div>' +
+      "</div>";
+    document.body.appendChild(overlay);
+    input = overlay.querySelector("input");
+    resultsEl = overlay.querySelector(".search-results");
+    overlay.addEventListener("mousedown", function (e) { if (e.target === overlay) close(); });
+    input.addEventListener("input", function () { query(input.value); });
+    input.addEventListener("keydown", function (e) {
+      if (e.key === "ArrowDown") { e.preventDefault(); move(1); }
+      else if (e.key === "ArrowUp") { e.preventDefault(); move(-1); }
+      else if (e.key === "Enter") { e.preventDefault(); openSel(); }
+      else if (e.key === "Escape") { close(); }
+    });
+  }
+
+  function load(cb) {
+    if (index) { cb(); return; }
+    fetch(base + "assets/search-index.json")
+      .then(function (r) { return r.json(); })
+      .then(function (j) { index = j; cb(); })
+      .catch(function () {
+        resultsEl.innerHTML = '<div class="search-empty">search index unavailable</div>';
+      });
+  }
+
+  function open() {
+    ensureUi();
+    overlay.classList.add("open");
+    input.value = "";
+    resultsEl.innerHTML = '<div class="search-empty">type to search every docs page</div>';
+    setTimeout(function () { input.focus(); }, 10);
+    load(function () {});
+  }
+  function close() { if (overlay) overlay.classList.remove("open"); }
+  window.rigSearchOpen = open;
+
+  function tokenize(q) {
+    return q.toLowerCase().split(/\s+/).filter(function (w) { return w.length > 1; });
+  }
+
+  function query(q) {
+    sel = 0;
+    var words = tokenize(q);
+    if (!index || !words.length) {
+      resultsEl.innerHTML = '<div class="search-empty">type to search every docs page</div>';
+      items = [];
+      return;
+    }
+    var scored = [];
+    index.pages.forEach(function (page) {
+      page.sections.forEach(function (sec) {
+        var hayTitle = (page.title + " " + sec.heading).toLowerCase();
+        var hayBody = sec.text.toLowerCase();
+        var score = 0, allFound = true;
+        words.forEach(function (w) {
+          var inTitle = hayTitle.indexOf(w) >= 0;
+          var inBody = hayBody.indexOf(w) >= 0;
+          if (inTitle) score += 14;
+          if (inBody) score += 3;
+          if (!inTitle && !inBody) allFound = false;
+        });
+        if (allFound && score > 0) scored.push({ page: page, sec: sec, score: score });
+      });
+    });
+    scored.sort(function (a, b) { return b.score - a.score; });
+    scored = scored.slice(0, 12);
+    items = scored;
+    if (!scored.length) {
+      resultsEl.innerHTML = '<div class="search-empty">no matches for &ldquo;' + q.replace(/[<>&]/g, "") + '&rdquo;</div>';
+      return;
+    }
+    resultsEl.innerHTML = "";
+    scored.forEach(function (it, n) {
+      var a = document.createElement("a");
+      a.className = "sr" + (n === sel ? " sel" : "");
+      a.href = base + it.page.url + (it.sec.id ? "#" + it.sec.id : "");
+      var snippet = makeSnippet(it.sec.text, words);
+      a.innerHTML =
+        '<span class="pg">' + esc(it.page.title) + "</span>" +
+        '<span class="hd">' + esc(it.sec.heading || it.page.title) + "</span>" +
+        '<span class="sn">' + snippet + "</span>";
+      resultsEl.appendChild(a);
+    });
+  }
+
+  function esc(s) { return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"); }
+
+  function makeSnippet(text, words) {
+    var lower = text.toLowerCase(), at = -1;
+    for (var i = 0; i < words.length; i++) {
+      at = lower.indexOf(words[i]);
+      if (at >= 0) break;
+    }
+    var start = Math.max(0, at - 60);
+    var chunk = (start > 0 ? "…" : "") + text.slice(start, start + 180) + (start + 180 < text.length ? "…" : "");
+    var out = esc(chunk);
+    words.forEach(function (w) {
+      out = out.replace(new RegExp("(" + w.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + ")", "ig"), "<mark>$1</mark>");
+    });
+    return out;
+  }
+
+  function move(d) {
+    var els = resultsEl.querySelectorAll(".sr");
+    if (!els.length) return;
+    sel = (sel + d + els.length) % els.length;
+    els.forEach(function (el, n) { el.classList.toggle("sel", n === sel); });
+    els[sel].scrollIntoView({ block: "nearest" });
+  }
+  function openSel() {
+    var els = resultsEl.querySelectorAll(".sr");
+    if (els[sel]) window.location.href = els[sel].href;
+  }
+
+  addEventListener("keydown", function (e) {
+    if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "k") { e.preventDefault(); open(); }
+    else if (e.key === "/" && !/input|textarea/i.test((document.activeElement || {}).tagName || "")) { e.preventDefault(); open(); }
+  });
+})();
+
+/* ===== COMPANION DRONE =====================================================
+   A wingman that escorts the cursor on EVERY page (home + docs). Spring-follow
+   flight with banking, rotors that rev with speed, thruster exhaust — plus a
+   scenario engine: what it does depends on what you're pointing at.
+
+   Scenarios:
+    1  scan       interactive element        cyan lock-on beam + cyan eye
+    2  read       code / pre / terminal      closes in, eye saccades, data bits
+                                             stream from the element into it
+    3  salute     first visit to an h1/h2    barrel roll
+    4  judge      "the gate" content         magenta eye, disapproving head-shake
+    5  ok-ping    element containing a ✓     lime radar ping (once per element)
+    6  install    the install one-liner      orbits it once, then beams the
+                                             copy button
+    7  burst      any click                  spark explosion + 360 spin
+    8  tumble     fast scroll                rotation kick, stabilizes with
+                                             extra thrust
+    9  patrol     idle ~4s                   lazy lissajous drift
+   10  land       idle ~25s                  perches lower-right, rotors wind
+                                             down, eye dims; dust on takeoff
+   11  duck       cursor near the nav        flies BELOW the cursor so it never
+                                             hides under the chrome
+   12  greet      the hero ASCII sibling /   double nod + alternating
+                  any pi-term                lime/cyan blinks
+   13  tail-chase dogfood ("Rig ships Rig")  chases its own tail, ouroboros-style
+   14  table-scan any table                  parks at the edge, sweeps a beam
+                                             down the rows
+   15  assist     search modal open (⌘K)     parks beside the box, rotors rev,
+                                             eye pulses cyan
+   16  highlight  text selection             beams the selection, eye flares
+   17  farewell   footer                     slow wide goodbye circle, dips low
+
+   pointer-events: none — it can never block a click. Skipped on touch devices
+   and for prefers-reduced-motion. */
+(function () {
+  if (matchMedia("(pointer:coarse)").matches || matchMedia("(prefers-reduced-motion: reduce)").matches) return;
+  var cv = document.createElement("canvas"); cv.id = "dronecv"; cv.width = 200; cv.height = 200;
+  document.body.appendChild(cv);
+  var ctx = cv.getContext("2d");
+  var LIME = "204,255,77", PALE = "234,255,176", CYAN = "86,216,255", MAG = "255,121,176";
+  var x = innerWidth * 0.72, y = innerHeight * 0.28, vx = 0, vy = 0, tx = x, ty = y;
+  var rot = 0, rotV = 0, spin = 0, spinT = 0, t = 0, lastMove = -999, lastSY = scrollY;
+  var sparks = [], bits = [], rings = [];
+  var mode = { name: "cruise", until: 0, data: null, born: 0 };
+  var saluted = new WeakSet(), pinged = new WeakSet(), greetAt = -9999;
+  var gatePage = /\/gate\//.test(location.pathname);
+
+  function setMode(n, dur, data) { if (mode.name === n && mode.data === data) { mode.until = t + dur; return; } mode = { name: n, until: t + dur, data: data || null, born: t }; }
+  function on(n) { return mode.name === n && t < mode.until; }
+  function age() { return t - mode.born; }
+  function rect(el) { try { return el.getBoundingClientRect(); } catch (e) { return null; } }
+
+  addEventListener("mousemove", function (e) {
+    // (11) duck under the cursor when it's near the fixed nav
+    tx = e.clientX + 36; ty = e.clientY + (e.clientY < 130 ? 58 : -46);
+    lastMove = t;
+    if (mode.name === "land") { setMode("takeoff", 40); for (var i = 0; i < 8; i++) sparks.push({ x: (Math.random() - .5) * 14, y: 10, vx: (Math.random() - .5) * 1.6, vy: -Math.random() * 1.2, life: .8 }); }
+    var el = e.target, hit;
+    if (!el || !el.closest) return;
+    if ((hit = el.closest(".inst"))) setMode("install", 280, hit);
+    else if ((hit = el.closest("#cine,.mascot,.pi-term"))) {
+      if (t - greetAt > 1800) { greetAt = t; setMode("greet", 150, hit); }
+      else setMode("read", 50, hit);
+    }
+    else if ((hit = el.closest("code,pre,.pp,.scr,.pi-term-body"))) setMode("read", 50, hit);
+    else if ((hit = el.closest("table"))) setMode("tablescan", 60, hit);
+    else if ((hit = el.closest("h1,h2"))) { if (!saluted.has(hit)) { saluted.add(hit); spinT += 6.283; setMode("salute", 80, hit); } }
+    else if ((hit = el.closest("a,button,.btn,.pk,.mv,.stage,.vcard,.panel,.nsearch"))) {
+      if (hit.querySelector && hit.querySelector(".ok") && !pinged.has(hit)) { pinged.add(hit); rings.push({ r: 6, a: .55, hue: LIME }); setMode("okping", 50, hit); }
+      else setMode("scan", 50, hit);
+    }
+    else {
+      var sec = el.closest("section,footer,main");
+      if (sec) {
+        if (sec.tagName === "FOOTER") setMode("farewell", 200);
+        else {
+          var eb = sec.querySelector && sec.querySelector(".eyebrow");
+          var ebt = (eb && eb.textContent) || "";
+          if (/the gate/i.test(ebt) || gatePage) setMode("judge", 120);
+          else if (/dogfood/i.test(ebt)) setMode("tail", 180);
+        }
+      }
+    }
+  }, { passive: true });
+
+  addEventListener("mousedown", function () {
+    spinT += 6.283;
+    for (var i = 0; i < 14; i++) sparks.push({ x: 0, y: 0, vx: (Math.random() - .5) * 3.4, vy: (Math.random() - .5) * 3.4, life: 1 });
+    setMode("burst", 40);
+  }, { passive: true });
+
+  addEventListener("scroll", function () {
+    var d = Math.abs(scrollY - lastSY); lastSY = scrollY;
+    if (on("scan") || on("read") || on("tablescan")) mode.until = 0;
+    if (d > 140) { rotV += (Math.random() < .5 ? -1 : 1) * .3; setMode("tumble", 55); }
+  }, { passive: true });
+
+  document.addEventListener("selectionchange", function () {
+    var s = getSelection();
+    if (s && !s.isCollapsed && String(s).trim().length > 2) setMode("highlight", 200);
+  });
+
+  function selRect() {
+    var s = getSelection();
+    if (!s || s.isCollapsed || !s.rangeCount) return null;
+    var r = s.getRangeAt(0).getBoundingClientRect();
+    return r.width || r.height ? r : null;
+  }
+
+  function frame() {
+    t++;
+    // (15) assist: notice the search modal regardless of pointer
+    if (t % 20 === 0) { var so = document.querySelector(".search-overlay.open"); if (so) setMode("assist", 40, so.querySelector(".search-box") || so); }
+    // (10) land after long idle
+    if (t - lastMove > 1500 && mode.name !== "land" && mode.name !== "assist") setMode("land", 1e9);
+
+    // ---- flight target per scenario ----
+    var ix = tx, iy = ty, r0;
+    if (on("install") && mode.data && (r0 = rect(mode.data))) {
+      var icx = r0.left + r0.width / 2, icy = r0.top + r0.height / 2;
+      if (age() < 170) { var oa = age() * .037; ix = icx + Math.cos(oa) * (r0.width * .55 + 30); iy = icy + Math.sin(oa) * 42; } // one orbit
+      else { ix = r0.right - 18; iy = r0.top - 40; } // then hold over the copy button
+    } else if (on("read") && mode.data && (r0 = rect(mode.data))) {
+      ix = tx * .4 + (r0.left + r0.width / 2) * .6; iy = Math.max(60, r0.top - 26) * .6 + ty * .4; // lean in over the code
+    } else if (on("tablescan") && mode.data && (r0 = rect(mode.data))) {
+      ix = r0.right + 34; iy = r0.top + ((t * 1.6) % Math.max(40, r0.height));
+    } else if (on("assist") && mode.data && (r0 = rect(mode.data))) {
+      ix = r0.right + 44; iy = r0.top + 30;
+    } else if (on("tail")) { ix = tx + Math.cos(t * .14) * 30; iy = ty + Math.sin(t * .14) * 30; }
+    else if (on("farewell")) { ix = tx + Math.cos(t * .02) * 80; iy = ty + 50 + Math.sin(t * .04) * 12; }
+    else if (on("greet")) { iy = ty + (age() % 50 < 25 ? 10 : -10); }
+    else if (on("judge")) { ix = tx + Math.sin(t * .45) * 9; }
+    else if (mode.name === "land") { ix = innerWidth - 90; iy = innerHeight - 74; }
+    else if (t - lastMove > 240) { ix = tx + Math.sin(t * .012) * 64; iy = ty + Math.cos(t * .016) * 42; } // (9) patrol
+
+    // ---- physics ----
+    vx += (ix - x) * .012; vy += (iy - y) * .012; vx *= .88; vy *= .88; x += vx; y += vy;
+    var spd = Math.hypot(vx, vy);
+    var grounded = mode.name === "land" && Math.abs(y - (innerHeight - 74)) < 8;
+    var bob = grounded ? 0 : Math.sin(t * .06) * 3;
+    rotV *= .9; rot += rotV; rot += (Math.max(-.45, Math.min(.45, vx * .022)) - rot) * .1;
+    spin += (spinT - spin) * .09; if (Math.abs(spinT - spin) < .01) spin = spinT;
+    cv.style.transform = "translate3d(" + (x - 100) + "px," + (y - 100 + bob) + "px,0)";
+
+    // ---- draw ----
+    ctx.clearRect(0, 0, 200, 200);
+    ctx.save(); ctx.translate(100, 100); ctx.rotate(rot + spin);
+    var rotorSpd = grounded ? .04 : (.3 + spd * .07 + (on("assist") ? .35 : 0));
+
+    // thruster exhaust
+    if (spd > 1.2 && t % 2 === 0) sparks.push({ x: -vx * 1.6, y: 8, vx: -vx * .3 + (Math.random() - .5), vy: 1 + Math.random(), life: .7 });
+    if (on("tumble") && t % 2 === 0) sparks.push({ x: (Math.random() - .5) * 10, y: 8, vx: (Math.random() - .5) * 2, vy: 1.6 + Math.random(), life: .8 });
+    for (var i = sparks.length - 1; i >= 0; i--) {
+      var sp = sparks[i]; sp.x += sp.vx; sp.y += sp.vy; sp.life -= .04;
+      if (sp.life <= 0) { sparks.splice(i, 1); continue; }
+      ctx.fillStyle = "rgba(" + LIME + "," + (.5 * sp.life) + ")"; ctx.fillRect(sp.x, sp.y, 1.6, 1.6);
+    }
+    // radar ping rings
+    for (var g = rings.length - 1; g >= 0; g--) {
+      var rg = rings[g]; rg.r += 1.7; rg.a *= .93;
+      if (rg.a < .02) { rings.splice(g, 1); continue; }
+      ctx.strokeStyle = "rgba(" + rg.hue + "," + rg.a + ")"; ctx.lineWidth = 1; ctx.beginPath(); ctx.arc(0, 0, rg.r, 0, 7); ctx.stroke();
+    }
+
+    // beams + data bits toward whatever the scenario is locked on
+    var beamTo = null, beamHue = CYAN;
+    if (on("scan") && mode.data) beamTo = rect(mode.data);
+    else if (on("install") && age() >= 170 && mode.data) { var ir = rect(mode.data); if (ir) beamTo = { left: ir.right - 50, top: ir.top, width: 40, height: ir.height }; }
+    else if (on("tablescan") && mode.data) { var tr = rect(mode.data); if (tr) beamTo = { left: tr.left, top: tr.top + ((t * 1.6) % Math.max(40, tr.height)), width: tr.width, height: 2 }; }
+    else if (on("highlight")) { beamTo = selRect(); beamHue = LIME; }
+    if (beamTo) {
+      var bx = beamTo.left + beamTo.width / 2 - x, by = beamTo.top + beamTo.height / 2 - y;
+      var bd = Math.hypot(bx, by) || 1, ux = bx / bd, uy = by / bd, len = Math.min(bd, 78);
+      var bg = ctx.createLinearGradient(0, 0, ux * len, uy * len);
+      bg.addColorStop(0, "rgba(" + beamHue + ",.45)"); bg.addColorStop(1, "rgba(" + beamHue + ",0)");
+      ctx.strokeStyle = bg; ctx.lineWidth = 1; ctx.setLineDash([3, 5]); ctx.beginPath(); ctx.moveTo(ux * 11, uy * 11); ctx.lineTo(ux * len, uy * len); ctx.stroke(); ctx.setLineDash([]);
+    }
+    if (on("read") && mode.data && t % 5 === 0) {
+      var rr = rect(mode.data);
+      if (rr) { var sxx = rr.left + Math.random() * rr.width - x, syy = rr.top + Math.random() * rr.height - y; var sd = Math.hypot(sxx, syy); if (sd < 320) bits.push({ x: sxx, y: syy, life: 1 }); }
+    }
+    for (var b2 = bits.length - 1; b2 >= 0; b2--) {
+      var bt = bits[b2]; bt.x *= .9; bt.y *= .9; bt.life -= .03;
+      if (bt.life <= 0 || (Math.abs(bt.x) < 4 && Math.abs(bt.y) < 4)) { bits.splice(b2, 1); continue; }
+      ctx.fillStyle = "rgba(" + CYAN + "," + (.6 * bt.life) + ")"; ctx.fillRect(bt.x, bt.y, 1.5, 1.5);
+    }
+
+    // arms + rotors
+    var rs = t * rotorSpd;
+    for (var q = 0; q < 4; q++) {
+      var aa = q * 1.5708 + .7854, ax = Math.cos(aa) * 16, ay = Math.sin(aa) * 11;
+      ctx.strokeStyle = "rgba(169,214,63,.7)"; ctx.lineWidth = 1.2; ctx.beginPath(); ctx.moveTo(0, 0); ctx.lineTo(ax, ay); ctx.stroke();
+      ctx.save(); ctx.translate(ax, ay); ctx.rotate(rs * (q % 2 ? 1 : -1));
+      ctx.strokeStyle = "rgba(125,158,52,.85)"; ctx.lineWidth = 1; ctx.beginPath(); ctx.ellipse(0, 0, 7, 2.4, 0, 0, 7); ctx.stroke(); ctx.restore();
+      ctx.fillStyle = "rgba(" + LIME + ",.8)"; ctx.beginPath(); ctx.arc(ax, ay, 1.6, 0, 7); ctx.fill();
+    }
+    // body
+    ctx.fillStyle = "rgba(18,22,10,.92)"; ctx.strokeStyle = "rgba(" + LIME + ",.75)"; ctx.lineWidth = 1.3;
+    ctx.beginPath(); ctx.ellipse(0, 0, 9, 6.4, 0, 0, 7); ctx.fill(); ctx.stroke();
+
+    // eye — saccades over code, blinks, changes color with intent
+    var lx = Math.max(-3, Math.min(3, (tx - x) * .04)), ly = Math.max(-2, Math.min(2, (ty - y) * .04));
+    if (on("read")) lx = Math.sin(t * .5) * 3;                       // reading saccades
+    if (on("tail")) { lx = Math.cos(t * .14 + 1.2) * 3; ly = Math.sin(t * .14 + 1.2) * 2; } // watching its own tail
+    var ec = PALE, ea = .95;
+    if (on("scan") || on("read") || on("tablescan") || on("install")) ec = CYAN;
+    else if (on("assist")) { ec = CYAN; ea = .6 + .35 * Math.sin(t * .25); }
+    else if (on("judge")) ec = MAG;
+    else if (on("highlight") || on("okping")) ec = LIME;
+    else if (mode.name === "land" && grounded) { ec = LIME; ea = .25 + .12 * Math.sin(t * .04); } // ember
+    var blink = (t % 200) < 5 ? .15 : 1;
+    if (on("greet")) { ec = (age() % 50 < 25) ? LIME : CYAN; blink = (age() % 25) < 4 ? .15 : 1; }
+    ctx.fillStyle = "rgba(" + ec + "," + (ea * blink) + ")"; ctx.beginPath(); ctx.arc(lx, ly - .5, 2.1, 0, 7); ctx.fill();
+    ctx.fillStyle = "rgba(" + ec + ",.25)"; ctx.beginPath(); ctx.arc(lx, ly - .5, 5.5, 0, 7); ctx.fill();
+    ctx.restore();
+    requestAnimationFrame(frame);
+  }
+  frame();
+})();

package/site/cli/index.html

@@ -0,0 +1,88 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>CLI reference // RIG</title><meta property="og:image" content="https://how.rig-does.work/assets/og-card.png"><meta name="twitter:card" content="summary_large_image"><meta name="description" content="The Rig launcher: foreground OMP, inline /fleet, /tasks, /drone cards, exact-run attach, rig doctor, and the exact headless CLI over the same operations."><meta property="og:title" content="CLI reference // RIG"><meta property="og:description" content="The Rig launcher: foreground OMP, inline /fleet, /tasks, /drone cards, exact-run attach, rig doctor, and the exact headless CLI over the same operations."><link rel="stylesheet" href="../assets/rig.css?v=v9"><link rel="stylesheet" href="../assets/site.css?v=v9"><link rel="icon" type="image/svg+xml" href="../assets/favicon.svg"></head><body><canvas id="docfield"></canvas><nav class="nav"><div class="nav-in"><a class="brand" href="../index.html"><span class="mk"></span><span class="blk">Rig</span></a><button class="burger" onclick="document.getElementById('nl').classList.toggle('open')">menu</button><div class="nav-links" id="nl"><button class="nsearch" type="button" onclick="rigSearchOpen()">search<kbd>&#8984;K</kbd></button><a href="../index.html" class="">overview</a><a href="../docs/index.html" class="">docs</a><a href="../plugins/index.html" class="">plugins</a><a href="../skills/index.html" class="">skills</a><a href="../cli/index.html" class="active">cli</a><a href="../config/index.html" class="">config</a><a href="https://github.com/humanity-org/rig" class="ext">github</a></div></div></nav><div class="docwrap"><aside class="sidebar"><div class="grp">START</div><a href="../docs/index.html" class="">docs home</a><a href="../docs/capabilities/index.html" class="">capabilities</a><a href="../docs/getting-started/index.html" class="">getting started</a><div class="grp">RUN</div><a href="../docs/runs/index.html" class="">the run lifecycle</a><a href="../docs/operator/index.html" class="">operator guide</a><a href="../docs/swarm-commander/index.html" class="">swarm commander</a><a href="../docs/fleet-irc/index.html" class="">drone messages</a><a href="../docs/agent-tools/index.html" class="">agent tools</a><a href="../docs/gate/index.html" class="">the merge gate</a><a href="../docs/troubleshooting/index.html" class="">troubleshooting</a><div class="grp">ARCHITECTURE</div><a href="../docs/architecture/index.html" class="">how rig works</a><a href="../docs/entities/index.html" class="">entities & data model</a><a href="../docs/server/index.html" class="">OMP relay/web</a><a href="../docs/security/index.html" class="">security & trust</a><a href="../docs/environment/index.html" class="">environment variables</a><div class="grp">EXTEND</div><a href="../plugins/index.html" class="">plugin authoring</a><a href="../plugins/examples/index.html" class="">plugin examples</a><a href="../docs/pi-extensions/index.html" class="">OMP/Pi extensions</a><a href="../skills/index.html" class="">skills</a><a href="../docs/task-sources/index.html" class="">task sources</a><a href="../docs/validators/index.html" class="">validators & hooks</a><div class="grp">OPERATE</div><a href="../cli/index.html" class="active">cli reference</a><a href="../config/index.html" class="">rig.config.ts</a><a href="../docs/recipes/index.html" class="">recipes</a><a href="../docs/glossary/index.html" class="">glossary</a><a href="../docs/faq/index.html" class="">faq</a><div class="grp">ENGINE</div><a href="../docs/packages/index.html" class="">packages</a></aside><main class="doc"><h1>CLI reference</h1>
+<p class="lede">Rig has two first-class faces over one set of CNet and domain operations. Interactively, bare <code>rig</code> opens foreground OMP with the bundled Rig extension; work streams into the cnet and <code>/fleet</code>, <code>/tasks</code>, and <code>/drone</code> materialize focused cards inline. Headlessly, the exact <code>rig</code> command tree runs those same operations non-interactively for scripts, CI, and agents.</p>
+
+<div class="note"><b>The interactive session:</b> <code>rig</code> opens foreground OMP with Rig. The Swarm Commander is a model role in that chat; <code>/fleet</code>, <code>/tasks</code>, and <code>/drone [ref]</code> write CNet cards into the transcript, while inline attention items carry pending operator actions. <code>rig doctor</code> stays a terminal diagnostic command.</div>
+
+<h2 id="global-options">Global options <span class="ns">// launcher and headless CLI flags</span></h2>
+<p>These flags apply to the launcher and to the exact CLI command groups that run the same domain operations headlessly.</p>
+<table class="t"><thead><tr><th>flag</th><th>what it does</th></tr></thead>
+<tbody>
+<tr><td><code>--workspace &lt;path&gt;</code></td><td>Open the Rig session for an explicit workspace root instead of auto-discovering from the cwd. Useful when operating a project without cd-ing into it.</td></tr>
+<tr><td><code>--json</code></td><td>Structured machine output: subcommands that support it emit a structured record instead of a rendered human view, for scripts, CI, and agents.</td></tr>
+<tr><td><code>--dry-run</code></td><td>Deterministic plan where supported: prints the plan a subcommand would execute without mutating state.</td></tr>
+<tr><td><code>--version</code></td><td>Print the installed Rig CLI version.</td></tr>
+</tbody></table>
+
+<h2 id="start-here">Start here <span class="ns">// session first</span></h2>
+<table class="t"><thead><tr><th>command / action</th><th>what it does</th></tr></thead>
+<tbody>
+<tr><td><code>rig</code></td><td>Open the Rig session for the discovered workspace. The day-to-day entry point.</td></tr>
+<tr><td><code>rig --workspace &lt;path&gt;</code></td><td>Open the same session against an explicit workspace root instead of the current dir.</td></tr>
+<tr><td><code>rig attach &lt;run-id&gt; [--web]</code></td><td>Attach a terminal or browser to one exact live detached drone. Rig resolves its private credential internally.</td></tr>
+<tr><td><code>/fleet</code></td><td>Inside the session, materialize the current fleet as inline CNet cards.</td></tr>
+<tr><td><code>/tasks</code></td><td>Inside the session, materialize configured tasks with their create, rename, and close actions inline.</td></tr>
+<tr><td><code>/drone [ref]</code></td><td>Inside the session, materialize one exact run and its controls inline. With no ref, it targets the newest projected run.</td></tr>
+<tr><td><code>rig doctor</code></td><td>Diagnose sandbox backend and collaboration seams from the terminal.</td></tr>
+<tr><td><code>rig --version</code></td><td>Print the installed Rig CLI version.</td></tr>
+</tbody></table>
+<div class="note"><b>Attach boundary:</b> the relay carries the detached run session, but raw room credentials are transport data, not public UX. Operators select a run id; foreground Rig and the Swarm Commander role are not attach targets.</div>
+
+<h2 id="session-surfaces">Session surfaces <span class="ns">// one transcript, inline CNet cards</span></h2>
+<p>The Rig session is one chat-first surface. CNet maintains a bounded current projection, human-needed work appears as inline attention items, and the Swarm Commander model role can query or act through generated discoverable tools. Query aliases and exact receipts append to this same transcript.</p>
+<table class="t"><thead><tr><th>surface</th><th>command</th><th>what it shows</th></tr></thead>
+<tbody>
+<tr><td>CNet</td><td>automatic</td><td>One current fleet aggregate plus active or attention-requiring run items, with explicit query snapshots and receipts in OMP history.</td></tr>
+<tr><td>attention</td><td>inline items</td><td>Runs, approvals, or questions that currently need operator input, each with actions from its owning plugin.</td></tr>
+<tr><td>Swarm Commander</td><td>chat</td><td>Ask for state or an operation; the role receives bounded current context and discovers generated query/action tools.</td></tr>
+<tr><td>fleet</td><td><code>/fleet</code></td><td>One aggregate fleet card with counts, bounded rows, and a fleet-owned dispatch action.</td></tr>
+<tr><td>tasks</td><td><code>/tasks</code></td><td>One bounded task summary with task-owned create, rename, and close actions; exact dispatch is the <code>/fleet</code> action or <code>rig run dispatch &lt;taskId&gt;</code>.</td></tr>
+<tr><td>drone</td><td><code>/drone [ref]</code></td><td>One run&rsquo;s status, placement, progress, recent timeline, controls, and exact-run attach actions inline.</td></tr>
+<tr><td>doctor</td><td><code>rig doctor</code></td><td>Terminal diagnostics for sandbox backend and collaboration setup.</td></tr>
+</tbody></table>
+
+<h2 id="headless-cli">Headless CLI <span class="ns">// scripts, CI, and agents</span></h2>
+<p>The exact CLI command families are a first-class headless adapter over the same CNet and domain operations the session surfaces interactively &mdash; reach for them from scripts, CI, release checks, and agents, and add <code>--json</code> for structured output.</p>
+<table class="t"><thead><tr><th>command</th><th>surface</th><th>what it does</th></tr></thead>
+<tbody>
+<tr><td><code>rig task</code></td><td>headless</td><td>Read the configured task source non-interactively &mdash; the same task facts <code>/tasks</code> renders in the session.</td></tr>
+<tr><td><code>rig run start</code> / <code>start-serial</code> / <code>start-parallel</code></td><td>headless</td><td>Batch run starters for scripted dispatch; the interactive path is the <code>/fleet</code> action or <code>rig run dispatch &lt;taskId&gt;</code>.</td></tr>
+<tr><td><code>rig inbox</code> / <code>rig stats</code> / <code>rig inspect</code></td><td>headless</td><td>Inspect run and fleet state non-interactively; the same state lands as inline CNet items and <code>/drone</code> in the session.</td></tr>
+<tr><td><code>rig doctor</code></td><td>diagnostic</td><td>Terminal setup diagnostics for sandbox backend and collaboration seams.</td></tr>
+<tr><td><code>rig server task-run</code> / <code>rig server notify-test</code></td><td>headless</td><td>Server-owned task execution and event-notification checks for automation and CI.</td></tr>
+<tr><td><code>rig plugin</code></td><td>headless</td><td>Plugin introspection over the composed plugin graph.</td></tr>
+</tbody></table>
+
+<h2 id="configuration">Configuration <span class="ns">// what the session reads</span></h2>
+<p>The declarative <a href="../config/index.html"><code>.rig/rigfig.toml</code></a> (or the power-path <code>.rig/rig.config.ts</code>) declares project identity, loaded plugins/packages, the task source, workspace checkout + sandbox, runtime defaults, review policy, merge policy, and GitHub sync. It does <b>not</b> store OMP collab keys, relay credentials, or live session state.</p>
+<pre class="code"><span class="p">$</span> rig --workspace .
+<span class="p">$</span> rig attach 8a31e7
+<span class="p">$</span> rig attach 8a31e7 --web
+<span class="p">$</span> rig doctor
+<span class="p">$</span> rig --version</pre>
+
+<h2 id="advanced-groups">More CLI groups <span class="ns">// the full headless surface</span></h2>
+<p><b>Interactive UX:</b> <code>rig</code>, <code>rig --workspace &lt;path&gt;</code>, <code>rig attach &lt;run-id&gt; [--web]</code>, <code>/fleet</code>, <code>/tasks</code>, <code>/drone</code>, <code>rig doctor</code>, and <code>rig --version</code>. Every group below is a first-class headless entry point to the same operations. Run <code>rig help --advanced</code> for the live listing and <code>rig &lt;group&gt; --help</code> for per-group help.</p>
+<table class="t"><thead><tr><th>group</th><th>summary</th></tr></thead>
+<tbody>
+<tr><td><code>rig pi &lt;list|add|remove|search&gt;</code></td><td>Manage Pi extension packages for this project (community extensions from npm/git).</td></tr>
+<tr><td><code>rig profile</code></td><td>Runtime profile/model defaults.</td></tr>
+<tr><td><code>rig agent</code></td><td>Runtime agent workspace helpers.</td></tr>
+<tr><td><code>rig setup</code></td><td>Setup bootstrap/check helpers for automation and CI.</td></tr>
+<tr><td><code>rig test &lt;unit|e2e|all&gt;</code></td><td>Project test wrappers.</td></tr>
+<tr><td><code>rig review &lt;show|set&gt;</code></td><td>Inspect or change the completion review gate policy.</td></tr>
+</tbody></table>
+<p>More top-level groups round out the headless surface: <code>pipeline</code>, <code>graph</code>, <code>status</code>, <code>summary</code>, <code>blockers</code>, <code>doctor</code>, <code>plan</code>, <code>repo</code>, <code>github</code>, <code>triage</code>, <code>init</code>, <code>config</code>, <code>plugin</code>, <code>server</code>, <code>run</code>, <code>inbox</code>, <code>stats</code>, <code>inspect</code>, <code>task</code>, and <code>drift</code>. Each runs the same domain operations non-interactively; add <code>--json</code> for structured output and <code>--dry-run</code> for a plan where supported. Interactively, the same work flows through the Rig session, <code>/fleet</code>, <code>/tasks</code>, <code>/drone</code>, and <code>rig doctor</code>.</p>
+
+<h2 id="boot-banner">The launcher</h2>
+<p>On an interactive TTY, <code>rig</code> resolves the workspace, starts foreground OMP, loads the bundled Rig extension, and drops you into the CNet chat with the first fleet projection warming. Detached drone sessions start only when work is dispatched.</p>
+
+<h2 id="see-also">See also</h2>
+<ul>
+<li><b><a href="../docs/getting-started/index.html">Getting started</a></b> &mdash; install Rig, open the Rig session, and dispatch your first run.</li>
+<li><b><a href="../docs/operator/index.html">Operator guide</a></b> &mdash; driving CNet, attention items, the Swarm Commander role, inline queries, and exact-run attach.</li>
+<li><b><a href="../config/index.html">config</a></b> &mdash; project identity, task source, package list, runtime, gate, and merge policy.</li>
+<li><b><a href="../docs/environment/index.html">Environment variables</a></b> &mdash; runtime-only knobs outside config.</li>
+</ul>
+
+<div class="nextnav"><a href="../docs/validators/index.html"><span class="dir">&larr; Back</span><span class="ttl">Validators & hooks</span></a><a href="../config/index.html"><span class="dir">Next &rarr;</span><span class="ttl">rig.config.ts</span></a></div>
+</main></div><footer><div class="wrap"><div class="foot"><div class="col"><h5>orchestrate</h5><a href="../docs/getting-started/index.html">getting started</a><a href="../docs/runs/index.html">the run lifecycle</a><a href="../docs/operator/index.html">operator guide</a><a href="../docs/gate/index.html">the merge gate</a></div><div class="col"><h5>extend</h5><a href="../plugins/index.html">plugin authoring</a><a href="../skills/index.html">skills guide</a><a href="../docs/pi-extensions/index.html">OMP/Pi extensions</a><a href="../docs/packages/index.html">packages</a></div><div class="col"><h5>live</h5><a href="../index.html">the home rig</a><a href="../cli/index.html">cli reference</a><a href="https://where.rig-does.work/install">install script</a></div><div class="sig">Rig is the OMP session extension.<br><span class="blk">You are the operator.</span><br>release: rig --version</div></div></div></footer><script>document.querySelectorAll('[data-tab]').forEach(function(t){t.onclick=function(){document.querySelectorAll('[data-tab]').forEach(function(x){x.classList.remove('on')});document.querySelectorAll('[data-cmd]').forEach(function(x){x.style.display='none'});t.classList.add('on');var c=document.querySelector('[data-cmd="'+t.dataset.tab+'"]');if(c)c.style.display='flex';};});document.querySelectorAll('.cp').forEach(function(b){b.onclick=function(){var code=b.parentElement.querySelector('code');if(navigator.clipboard)navigator.clipboard.writeText(code.innerText);var o=b.innerText;b.innerText='copied';setTimeout(function(){b.innerText=o;},1200);};});</script><script src="../assets/rig.js"></script><script src="../assets/site.js?v=v9"></script></body></html>