wand-decks-kit 0.8.0

package/build.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+/**
+ * build.js — build a deck from a spec file.
+ *
+ *   node build.js deck.json out.pptx        build the deck
+ *   node build.js deck.json out.pdf         the same deck, as a PDF
+ *   node build.js deck.json --preview       write preview/trace.js and stop
+ *   node build.js deck.json --check         fit report only, no output
+ *
+ * The spec is plain data (see schema.md). Same spec feeds the .pptx build and
+ * the browser preview, so the two can't drift.
+ */
+
+const fs = require("fs");
+const path = require("path");
+const pptxgen = require("pptxgenjs");
+const W = require("./wand_kit");
+const { trace } = require("./lib/trace");
+const M = require("./lib/shared").measure;
+
+const FULL_BLEED = new Set(["cover", "divider", "closing"]);
+
+function loadSpec(p) {
+  const raw = fs.readFileSync(p, "utf8");
+  const spec = p.endsWith(".js") ? require(path.resolve(p)) : JSON.parse(raw);
+  if (!Array.isArray(spec.slides)) throw new Error("spec has no `slides` array");
+  return spec;
+}
+
+/** Build the .pptx. */
+function build(spec, out) {
+  const pres = W.newDeck(pptxgen);
+  const total = spec.slides.length;
+  spec.slides.forEach((sl, i) => {
+    const fn = W[sl.layout];
+    if (typeof fn !== "function") throw new Error(`slide ${i + 1}: unknown layout "${sl.layout}"`);
+    const args = { ...sl, n: i + 1, total };
+    if (!FULL_BLEED.has(sl.layout)) {
+      args.deck = sl.deck || spec.deck;
+      args.confidential = sl.confidential || spec.confidential;
+    }
+    fn(pres, args);
+  });
+  return pres.writeFile({ fileName: out }).then(() => {
+    console.log(`wrote ${out} (${total} slides)`);
+  });
+}
+
+/**
+ * Fit report. Walks the trace, re-measures every text shape in real Geist, and
+ * lists anything that overflows its box. This is the check LibreOffice cannot
+ * do (§9) — it substitutes DejaVu and lies about widths in both directions.
+ */
+function check(spec) {
+  const t = trace(W, spec);
+  t.errors.forEach((e) => console.error("ERROR " + e));
+  let bad = 0, checked = 0;
+  for (const sl of t.slides) {
+    for (const sh of sl.shapes) {
+      if (sh.kind !== "text" || !sh.w || !sh.h) continue;
+      const text = sh.runs.map((r) => r.text).join("");
+      if (!text.trim()) continue;
+      const o = sh.runs[0].options || {};
+      const opts = {
+        family: o.fontFace || sh.fontFace || "Geist",
+        fontSize: o.fontSize || sh.fontSize || 12,
+        bold: o.bold ?? sh.bold ?? false,
+        italic: o.italic ?? sh.italic ?? false,
+        lineSpacingMultiple: sh.lineSpacingMultiple || 1.2,
+      };
+      checked++;
+      // Measure the runs as they are actually set, not the whole string in the
+      // first run's face. The accent-italic device puts an italic in the middle
+      // of a bold title, and italic is wider — so a title could pass here and
+      // still drop its closing period onto a second line. The PDF renderer
+      // lays runs out individually, so this has to as well or the gate and the
+      // page disagree.
+      const v = sh.runs.length > 1 ? fitsRuns(sh) : M.fits(text, sh.w, sh.h, opts);
+      if (!v.ok) {
+        bad++;
+        const snip = text.length > 52 ? text.slice(0, 52) + "…" : text;
+        console.log(
+          `  S${String(sl.index).padStart(2, "0")} ${String(sl.layout).padEnd(14)} ` +
+          `+${v.overflowIn}"  ${v.lines}ln @${opts.fontSize}pt  "${snip}"`
+        );
+      }
+    }
+  }
+  // Bounds check. A shape can fit its own box and still be off the slide or
+  // buried under the footer — coverage QA won't catch that, because the text is
+  // present in the XML either way.
+  const FULL_BLEED = new Set(["cover", "divider", "closing"]);
+  let oob = 0;
+  for (const sl of t.slides) {
+    // 5.10 not 5.05: the reference deck's own six-up rows end at 5.08
+    const limit = FULL_BLEED.has(sl.layout) ? 5.625 : 5.10;
+    for (const sh of sl.shapes) {
+      if (sh.w == null || sh.h == null) continue;
+      const bottom = (sh.y || 0) + sh.h, right = (sh.x || 0) + sh.w;
+      const past = bottom > limit + 0.01, off = right > 10.01 || (sh.x || 0) < -0.01;
+      if (!past && !off) continue;
+      // full-bleed art legitimately covers the slide; the footer band legitimately
+      // sits below the content limit
+      if (sh.kind === "image" && (sh.w >= 9.9 || FULL_BLEED.has(sl.layout))) continue;
+      if ((sh.y || 0) >= 5.15) continue;
+      oob++;
+      const label = sh.kind === "text" ? `"${sh.runs.map((r) => r.text).join("").slice(0, 40)}"` : sh.type || sh.kind;
+      console.log(`  S${String(sl.index).padStart(2, "0")} ${String(sl.layout).padEnd(14)} ` +
+                  `${past ? `bottom ${bottom.toFixed(2)}\" past ${limit}\"` : "off canvas"}  ${label}`);
+    }
+  }
+  // Asset check. A missing glyph used to surface as a pptxgenjs stack trace
+  // during writeFile, after every other gate had passed - so the failure looked
+  // like a bug in the writer rather than a typo in the spec.
+  let missing = 0;
+  const seen = new Set();
+  for (const sl of t.slides) {
+    for (const sh of sl.shapes) {
+      if (sh.kind !== "image" || !sh.path || seen.has(sh.path)) continue;
+      seen.add(sh.path);
+      if (fs.existsSync(sh.path)) continue;
+      missing++;
+      console.log(`  S${String(sl.index).padStart(2, "0")} ${String(sl.layout).padEnd(14)} ` +
+                  `no such asset  ${path.relative(path.dirname(require("./lib/brand").resolve("assets")), sh.path)}`);
+    }
+  }
+
+  console.log(`\nfit check   : ${checked - bad}/${checked} text shapes fit in Geist` +
+              (bad ? `  — ${bad} overflow${bad > 1 ? "s" : ""} above` : "  — clean"));
+  console.log(`bounds check: ${oob ? oob + " shape(s) outside the content band — listed above" : "clean"}`);
+  console.log(`asset check : ${missing ? missing + " missing — listed above" : `${seen.size} resolved`}`);
+  return bad + oob + missing;
+}
+
+/** The same trace, as a PDF. Fonts embedded, no LibreOffice, no conversion. */
+function pdf(spec, out) {
+  const t = trace(W, spec);
+  t.errors.forEach((e) => console.error("ERROR " + e));
+  const { renderTrace } = require("./lib/render_pdf");
+  const r = renderTrace(t, out, { fontkit: require("fontkit") });
+  r.missing.forEach((m) => console.log(`  missing asset ${m}`));
+  console.log(`wrote ${out} (${r.pages} pages)`);
+  return r.missing.length;
+}
+
+/** Fit, measured run by run — the same layout the PDF renderer performs. */
+function fitsRuns(sh) {
+  const { layoutRuns } = require("./lib/render_pdf");
+  const lines = layoutRuns(sh);
+  const mult = sh.lineSpacingMultiple || 1.2;
+  const h = lines.reduce((a, l) => a + (Math.max(...l.parts.map((p) => p.st.size)) * mult) / 72, 0);
+  const widest = Math.max(0, ...lines.map((l) => l.parts.reduce((a, p) => a + p.w, 0)));
+  const boxW = (sh.w || 0) - (sh.margin === 0 ? 0 : 0.1);
+  return {
+    ok: h <= (sh.h || 0) + 1e-6 && widest <= boxW + 1e-6,
+    lines: lines.length,
+    overflowIn: +Math.max(0, h - (sh.h || 0)).toFixed(3),
+  };
+}
+
+/** Emit the trace as a JS file the preview page can load without a web server. */
+function preview(spec, specPath) {
+  const t = trace(W, spec);
+  t.errors.forEach((e) => console.error("ERROR " + e));
+  t.title = spec.deck || path.basename(specPath);
+  // The preview lives next to the kit but the brand payload may not: in the
+  // repo it is three levels up, in a packaged zip it is one. Resolve it once
+  // here and hand the preview a relative URL, so preview.js needs no rule.
+  const brand = require("./lib/brand");
+  const previewDir = path.join(__dirname, "preview");
+  const url = (d) => path.relative(previewDir, brand.resolve(d)).split(path.sep).join("/") + "/";
+  t.assetsBase = url("assets");
+  t.fontsBase = url("fonts");
+  const out = path.join(previewDir, "trace.js");
+  fs.writeFileSync(out, "window.__WAND_TRACE__ = " + JSON.stringify(t, null, 1) + ";\n");
+  console.log(`wrote ${out} (${t.slides.length} slides) — open preview/preview.html`);
+}
+
+const [, , specPath, arg] = process.argv;
+if (!specPath) {
+  console.error("usage: node build.js <spec.json> [out.pptx | out.pdf | --preview | --check]");
+  process.exit(2);
+}
+const spec = loadSpec(specPath);
+if (arg === "--preview") preview(spec, specPath);
+else if (arg === "--check") process.exit(check(spec) ? 1 : 0);
+else if (arg && arg.endsWith(".pdf")) process.exit(pdf(spec, arg) ? 1 : 0);
+else {
+  const bad = check(spec);
+  if (bad) console.log("(building anyway — fix the overflows above before shipping)\n");
+  build(spec, arg || "out.pptx").catch((e) => { console.error(e); process.exit(1); });
+}

package/build_example.js

@@ -0,0 +1,91 @@
+/* build_example.js — smoke test + usage reference for wand_kit.
+   node build_example.js  ->  example.pptx  */
+const pptxgen = require("pptxgenjs");
+const W = require("./wand_kit");
+
+const DECK = "KIT SMOKE TEST", TOTAL = 8;
+const pres = W.newDeck(pptxgen);
+
+W.cover(pres, {
+  tag: "THE SHIFT", eyebrow: "The agentic workforce advantage",
+  titleLines: ["A New Class", "Of Labor Is Here"],
+  body: "The next decade of enterprise performance won't be won with better tools. It will be won by the companies that build a workforce of humans and AI agents — governed as one.",
+  kickerPlain: "Others build AI tools.", kickerBold: "We build workforces.",
+});
+
+W.divider(pres, {
+  tag: "THE SHIFT", eyebrow: "Wand · The agentic workforce",
+  titleText: ["Infinite ", "labor", "."],
+  body: "The first workforce in history with human drives — curiosity, initiative, learning, growth — working beside people.",
+});
+
+W.threeUp(pres, {
+  tag: "THE SHIFT", deck: DECK, n: 3, total: TOTAL, dark: true, arrows: true,
+  titleText: "A new class of labor.",
+  subtitleText: "AI agents are no longer tools. They are a new form of labor — faster, more affordable, improving every quarter.",
+  items: [
+    { eyebrow: "Today · every company", title: "Human-Centric", pill: "100% human", body: "Humans think, decide, and execute. AI shows up in pockets, as tools. Sophisticated — but slow, costly, capped." },
+    { eyebrow: "The target model", title: "Hybrid / Dual", pill: "humans + AI agents", body: "One workforce, two kinds of colleagues — shared roles, shared objectives, shared accountability.", emph: true },
+    { eyebrow: "The horizon", title: "Autonomous", pill: "10:1 – 500:1 agents", body: "Agents are the primary workforce. Humans set direction. The emerging frontier." },
+  ],
+});
+
+W.fourUpIcon(pres, {
+  tag: "THE BREAKTHROUGH", deck: DECK, n: 4, total: TOTAL, dark: true,
+  titleText: ["We didn't build tools for humans. ", "We built workers that want", "."],
+  subtitleText: "Every Wand agent runs on intrinsic drives, not prompts.",
+  items: [
+    { icon: "icon-11.png", title: "Curiosity", body: "Explores what it doesn't understand — probing, questioning, mapping its world without being asked." },
+    { icon: "icon-12.png", title: "Initiative", body: "Generates and prioritizes its own work from a continuous loop of internal goals." },
+    { icon: "icon-13.png", title: "Learning", body: "Ends every task in structured reflection. Every lesson propagates into new patterns." },
+    { icon: "icon-14.png", title: "Growth", body: "Evolves measurably, quarter after quarter — compounding like your best hire." },
+  ],
+  kickerText: "The difference between software you operate and a colleague you trust.",
+});
+
+W.sixUpIcon(pres, {
+  tag: "THE WAND AGENT TECHNOLOGY", deck: DECK, n: 5, total: TOTAL, dark: false,
+  titleText: ["What makes a ", "Wand agent", " different."],
+  subtitleText: "The deepest agentic core in the category, built around drives.",
+  items: [
+    { icon: "icon-15.png", title: "Intrinsic motivation", body: "A continuous loop of internal drives generating and prioritizing its own work." },
+    { icon: "icon-16.png", title: "Self-improving by design", body: "Every task ends in structured reflection; lessons propagate into new patterns." },
+    { icon: "icon-17.png", title: "Safety on commit", body: "A validation gate sandboxes every risky action before anything happens." },
+    { icon: "icon-18.png", title: "Persistent strategy", body: "Operating theses are first-class objects — versioned, lineage-tracked." },
+    { icon: "icon-20.png", title: "Real organizations", body: "Manager/worker hierarchy, shared goals, deliberation channels." },
+    { icon: "icon-23.png", title: "One system, any domain", body: "The same primitives run alpha-trading or customer support." },
+  ],
+});
+
+W.rows(pres, {
+  tag: "THE FULL STACK", deck: DECK, n: 6, total: TOTAL, dark: true,
+  titleText: ["A workforce needs more than workers — it needs ", "institutions", "."],
+  subtitleText: "Wand builds the civic layer of AI labor.",
+  items: [
+    { icon: "icon-24.png", label: "Hybrid Human–AI OS", description: "The operating system of the intelligent organization — humans and agents governed as one.", badge: "WAND" },
+    { icon: "icon-25.png", label: "AI Labor", description: "The governed agentic workforce — a Network, a University, Governance and an Economy.", badge: "WAND" },
+    { icon: "icon-27.png", label: "Autonomous Agents", description: "Self-initiating agents with persistent memory — each owning KPIs and a seat in the org chart.", badge: "WAND" },
+    { icon: "icon-28.png", label: "LLMs", description: "The reasoning layer. Anthropic · OpenAI · Google · Meta · Mistral · open source.", badge: "BRING YOUR OWN", ours: false },
+    { icon: "icon-30.png", label: "Compute · Cloud · GPU", description: "The physical capacity layer. AWS · Azure · GCP · Oracle · CoreWeave · Nebius.", badge: "BRING YOUR OWN", ours: false },
+  ],
+});
+
+W.parity(pres, {
+  tag: "HUMAN PARITY", deck: DECK, n: 7, total: TOTAL, dark: false,
+  titleText: ["Two kinds of colleagues. ", "One set of drives", "."],
+  subtitleText: "For the first time, people and machines share more than tasks — they share temperament.",
+  left:  { label: "A great human hire", icon: "icon-31.png", items: ["Curious about the problem", "Committed to the goal", "Learns from every outcome", "Owns a role, answers for results", "Grows year over year"] },
+  right: { label: "A Wand agent", icon: "icon-32.png", items: ["Curious by architecture", "Committed to the KPIs it owns", "Reflects and learns after every task", "Holds a seat in the org chart", "Evolves quarter over quarter"] },
+  badge: "=",
+  kickerText: "Not automation replacing people — humanity gaining a second workforce built in its own image.",
+});
+
+W.closing(pres, {
+  eyebrow: "The mission",
+  line1: "The biggest transition in human history.",
+  line2: "Humanity's next level of evolution.",
+  body: "Infinite labor, human direction. People and agents — curious, committed, evolving.",
+  url: "wand.ai",
+});
+
+pres.writeFile({ fileName: "example.pptx" }).then(() => console.log("wrote example.pptx"));

package/build_infinite.js

@@ -0,0 +1,283 @@
+/* build_infinite.js — Infinite Labor rebuilt through wand-kit.
+   Mapping plan (source slide -> layout):
+     S01 cover                    -> L1  cover-D
+     S02 divider                  -> L2  divider-D
+     S03 content, 3-step          -> L5  threeUpArrows-D
+     S04 hero + 3 stats           -> L17 featureStats-L
+     S05 content, 4 icon          -> L6  fourUpIcon-D
+     S06 comparison, list-shaped  -> L10 parity-L
+     S07 3 layers + bullets       -> L11 colCards-D
+     S08 stack/ownership          -> L9  rows-D      (S10 is a duplicate; dropped per §10)
+     S09 content, 6 icon          -> L7  sixUpIcon-L
+     S11 product architecture     -> productMap-L    (bespoke, measured from source)
+     S12 ranked magnitudes        -> L18 barRank-L
+     S13 equation + 4 stats       -> L20 band-L
+     S14 hero + 4 tiles           -> heroQuad-D      (bespoke, measured from source)
+     S15 margin bridge            -> L19 bridge-L
+     S16 content, 6 icon          -> L7  sixUpIcon-D
+     S17 closing                  -> L3  closing-D
+*/
+const pptxgen = require("pptxgenjs");
+const W = require("./wand_kit");
+
+const DECK = "THE AGENTIC WORKFORCE";
+const TOTAL = 16;
+const pres = W.newDeck(pptxgen);
+let n = 0;
+const p = () => ++n;
+
+/* S01 ---------------------------------------------------------------- L1 */
+W.cover(pres, {
+  tag: "THE SHIFT",
+  eyebrow: "THE AGENTIC WORKFORCE ADVANTAGE",
+  titleLines: ["A New Class", "Of Labor Is Here"],
+  body: "The next decade of enterprise performance won't be won with better tools. It will be won by the companies that build a workforce of humans and AI agents — governed as one.",
+  kickerPlain: "Others build AI tools.",
+  kickerBold: "We build workforces.",
+});
+p();
+
+/* S02 ---------------------------------------------------------------- L2 */
+W.divider(pres, {
+  tag: "THE SHIFT",
+  eyebrow: "WAND  ·  THE AGENTIC WORKFORCE",
+  titleText: ["Infinite ", "labor", "."],
+  body: "The first workforce in history with human drives — curiosity, initiative, learning, growth — working beside people, at the scale of civilization's ambitions.",
+});
+p();
+
+/* S03 ---------------------------------------------------------------- L5 */
+W.threeUp(pres, {
+  tag: "THE SHIFT", deck: DECK, n: p(), total: TOTAL, dark: true, arrows: true,
+  titleText: "A new class of labor.",
+  subtitleText: "AI agents are no longer tools. They are a new form of labor — faster, more affordable, improving every quarter at a pace no organization can hire against.",
+  items: [
+    { eyebrow: "TODAY · EVERY COMPANY", title: "Human-Centric", pill: "100% human",
+      body: "Humans think, decide, and execute. AI shows up in pockets, as tools. Sophisticated — but slow, costly, capped." },
+    { eyebrow: "THE TARGET MODEL", title: "Hybrid / Dual", pill: "humans + AI agents", emph: true,
+      body: "One workforce, two kinds of colleagues — shared roles, shared objectives, shared accountability. Fast, affordable, alive." },
+    { eyebrow: "THE HORIZON", title: "Autonomous", pill: "10:1 – 500:1 agents",
+      body: "Agents are the primary workforce. Humans set direction. The emerging frontier." },
+  ],
+});
+
+/* S04 --------------------------------------------------------------- L17 */
+W.featureStats(pres, {
+  tag: "THE VISION", deck: DECK, n: p(), total: TOTAL, dark: false,
+  titleText: ["Everything humanity ever built\nwas ", "rationed by labor", "."],
+  subtitleText: "Every cure not researched. Every student not tutored. Every idea that died in a backlog — lost not to a lack of imagination, but to a lack of hands. For all of history, labor has been the scarcest resource on Earth.",
+  lead: { icon: "icon-9.png", runs: [
+    { text: "Wand makes labor " },
+    { text: "infinite", accent: true },
+    { text: "  — a workforce of agents and humans that grows itself." },
+  ] },
+  stats: [
+    { value: "∞",       caption: "execution capacity,\nalways on" },
+    { value: "10–100×", caption: "speed improvement\nvs. human baseline" },
+    { value: "3–5 yrs", caption: "to category lock-in\n— this transition" },
+  ],
+});
+
+/* S05 ---------------------------------------------------------------- L6 */
+W.fourUpIcon(pres, {
+  tag: "THE BREAKTHROUGH", deck: DECK, n: p(), total: TOTAL, dark: true,
+  titleText: ["We didn't build tools for humans.\nWe built ", "workers that want", "."],
+  subtitleText: "Every Wand agent runs on intrinsic drives, not prompts — the same inner engine that makes your best people your best people.",
+  items: [
+    { icon: "icon-11.png", title: "Curiosity",  body: "Explores what it doesn't understand — probing, questioning, mapping its world without being asked." },
+    { icon: "icon-12.png", title: "Initiative", body: "Generates and prioritizes its own work from a continuous loop of internal goals. No prompt required." },
+    { icon: "icon-13.png", title: "Learning",   body: "Ends every task in structured reflection. Every lesson propagates into new patterns and strategies." },
+    { icon: "icon-14.png", title: "Growth",     body: "Evolves measurably, quarter after quarter — compounding like your best hire, without the ceiling." },
+  ],
+  kickerText: "The difference between software you operate and a colleague you trust.",
+});
+
+/* S06 --------------------------------------------------------------- L10 */
+W.parity(pres, {
+  tag: "HUMAN PARITY", deck: DECK, n: p(), total: TOTAL, dark: false,
+  titleText: ["Two kinds of colleagues. ", "One set of drives", "."],
+  subtitleText: "For the first time, people and machines share more than tasks — they share temperament.",
+  left: { label: "A GREAT HUMAN HIRE", icon: "icon-31.png", items: [
+    "Curious about the problem", "Committed to the goal", "Learns from every outcome",
+    "Owns a role, answers for results", "Grows year over year" ] },
+  right: { label: "A WAND AGENT", icon: "icon-9.png", items: [
+    "Curious by architecture", "Committed to the KPIs it owns", "Reflects and learns after every task",
+    "Holds a seat in the org chart", "Evolves quarter over quarter" ] },
+  badge: "=",
+  kickerText: "Not automation replacing people — humanity gaining a second workforce built in its own image.",
+});
+
+/* S07 --------------------------------------------------------------- L11 */
+W.colCards(pres, {
+  tag: "HOW WAND WAS BUILT", deck: DECK, n: p(), total: TOTAL, dark: true,
+  titleText: "Three layers that turn AI tools into a workforce.",
+  items: [
+    { art: "orb-cover.png", eyebrow: "Agents", title: "Real Agents",
+      body: "Identity, multi-layered memory, objectives, escalation logic, action history, and self-initiation. They don't wait for prompts, they pursue goals, take action, and improve on their own, within defined policy boundaries.",
+      bullets: ["Persistent identity & role", "Contextual + episodic + strategic memory", "Self-initiating drive engine", "Full traceability"] },
+    { art: "orb-cover.png", eyebrow: "The Workforce", title: "Agentic Workforce",
+      body: "Agents are hired, managed, and scaled like people, embedded in the org chart with managers, peers, KPIs, and lifecycle. Includes a unified Workforce Registry covering humans and agents.",
+      bullets: ["Agent Network (humans + agents)", "Agent University (training & evolution)", "Agent Management  (policy & oversight)", "Agent Economy (tools & marketplace)"] },
+    { art: "orb-cover.png", eyebrow: "The OS", title: "Wand OS",
+      body: "The unifying control plane that manages, governs, and orchestrates agents from any vendor, Gemini, Copilot, custom, or Wand-native, as a single capacity layer alongside humans.",
+      bullets: ["Control Panel (orchestration & oversight)", "Collab (human-agent workspace)", "Process Automation", "Division Automation"] },
+  ],
+});
+
+/* S08 (S10 is its duplicate — dropped per §10) ------------------------ L9 */
+W.rows(pres, {
+  tag: "THE FULL STACK", deck: DECK, n: p(), total: TOTAL, dark: true,
+  titleText: ["A workforce needs more than workers —\nit needs ", "institutions", "."],
+  subtitleText: "Wand builds the civic layer of AI labor — and sits on whatever models and compute you already run.",
+  items: [
+    { icon: "icon-24.png", label: "Hybrid Human–AI OS", badge: "WAND",
+      description: "The operating system of the intelligent organization — humans and agents governed as one, continuously optimized." },
+    { icon: "icon-25.png", label: "AI Labor", badge: "WAND",
+      description: "The governed agentic workforce — a Network to collaborate, a University to learn, Governance and an Economy." },
+    { icon: "icon-27.png", label: "Autonomous Agents", badge: "WAND",
+      description: "Self-initiating, self-evolving agents with persistent memory — each owning KPIs and a seat inside the org chart." },
+    { icon: "icon-28.png", label: "LLMs", badge: "BRING YOUR OWN", ours: false,
+      description: "The reasoning layer. Anthropic · OpenAI · Google · Meta · Mistral · open source." },
+    { icon: "icon-30.png", label: "Compute · Cloud · GPU", badge: "BRING YOUR OWN", ours: false,
+      description: "The physical capacity layer. AWS · Azure · GCP · Oracle · CoreWeave · Nebius." },
+  ],
+});
+
+/* S09 ---------------------------------------------------------------- L7 */
+W.sixUpIcon(pres, {
+  tag: "THE WAND AGENT TECHNOLOGY", deck: DECK, n: p(), total: TOTAL, dark: false,
+  titleText: ["What makes a ", "Wand agent", " different."],
+  subtitleText: "Wand's foundational technology — the deepest agentic core in the category, built around drives.",
+  items: [
+    { icon: "icon-15.png", title: "Intrinsic motivation, not prompts", body: "A continuous loop of internal drives — goal-pursuit, curiosity, frugality, reflection — generating and prioritizing its own work." },
+    { icon: "icon-16.png", title: "Self-improving by design", body: "Every task ends in structured reflection; lessons propagate into new patterns, strategies, probes, and schedules." },
+    { icon: "icon-17.png", title: "Safety on commit", body: "A validation gate sandboxes every risky action: verdict plus falsifiable prediction before anything happens." },
+    { icon: "icon-18.png", title: "Persistent strategy", body: "Operating theses are first-class objects — versioned, lineage-tracked, capital-allocated, composable." },
+    { icon: "icon-20.png", title: "Real organizations", body: "Manager/worker hierarchy, shared goals, measurement integrity, deliberation channels, an internal economy." },
+    { icon: "icon-23.png", title: "One system, any domain", body: "The same primitives run alpha-trading or customer support — only missions and validators differ." },
+  ],
+});
+
+/* S11 -------------------------------------------------------- productMap */
+W.productMap(pres, {
+  tag: "WAND OPERATING SYSTEM", deck: DECK, n: p(), total: TOTAL, dark: false,
+  titleText: ["Multiple products. ", "One unified workforce", "."],
+  subtitleText: "One operating system — from a single message to an entire delegated function.",
+  bandRow: { rail: "MANAGE", icon: "icon-24.png", title: "Control Panel",
+             body: "Hub for intelligent actions, governance, visibility, and control across the entire workforce." },
+  cards: [
+    { icon: "icon-33.png", title: "Collab", body: "Unified workspace for real-time coordination between agent and human teams.",
+      bullets: ["Shared task layer", "In-line agent escalation", "Mixed-team conversations"] },
+    { icon: "icon-34.png", title: "Process Designer", body: "Self-improving workflows with escalations triggered by confidence or compliance.",
+      bullets: ["Natural-language workflows", "Self-improving processes", "Compliance gates"] },
+    { icon: "icon-35.png", title: "Division Designer", body: "Delegate entire functions — agent teams plan, coordinate, and deliver from goals.",
+      bullets: ["Goal-driven autonomy", "Multi-agent teams", "Outcome accountability"] },
+  ],
+  split: { rail: "WORKFORCE", left: "Agentic Workforce", right: "Human Workforce" },
+  base: "THE ORGANIZATION'S TOOLS, DATA, COMPUTE & INFRASTRUCTURE CONNECTIVITY",
+});
+
+/* S12 --------------------------------------------------------------- L18 */
+W.barRank(pres, {
+  tag: "THE MARKET", deck: DECK, n: p(), total: TOTAL, dark: false,
+  titleText: ["A $60T market — and the work\nitself is the ", "substrate", "."],
+  subtitleText: "Software sold tools that help workers. Wand sells the worker — and this worker learns.",
+  bars: [
+    { label: "Total global labor",      value: "$60T+",     frac: 1.00 },
+    { label: "Knowledge work TAM",      value: "$20T+",     frac: 0.64 },
+    { label: "Agent-addressable today", value: "$4–6T",     frac: 0.44 },
+    { label: "Wand SOM · 2029",         value: "$50–100B",  frac: 0.24 },
+  ],
+  cards: [
+    { icon: "icon-36.png", value: "70–95%", caption: "cost reduction vs. human-only operations" },
+    { icon: "icon-12.png", value: "100×",   caption: "speed increase vs. traditional workflows" },
+    { icon: "icon-37.png", value: "60×",    caption: "customer ROI on a typical Wand commitment" },
+  ],
+  footnote: "TAM expands as agentic transformation creates entirely new categories of addressable work.",
+});
+
+/* S13 --------------------------------------------------------------- L20 */
+W.band(pres, {
+  tag: "THE SOVEREIGN LOGIC", deck: DECK, n: p(), total: TOTAL, dark: false,
+  titleText: ["Nations are running out of ", "workers", "."],
+  subtitleText: "Every conventional remedy — retirement ages, birth rates, immigration — is politically impossible or mathematically insufficient. Governed AI labor is the only lever that scales.",
+  icon: "icon-39.png",
+  runs: [
+    { text: "National wealth  =  (humans × productivity)  +  " },
+    { text: "(AI agents × agent productivity)", accent: true },
+  ],
+  stats: [
+    { value: "33 → 52", caption: "people 65+ per 100 workers\nOECD · today → 2060" },
+    { value: "−13%",    caption: "working-age population,\nOECD, next 40 years" },
+    { value: "11M",     caption: "Japan's projected worker\nshortfall by 2040" },
+    { value: "$0",      caption: "pensions, healthcare, or\nvisas — per agent, ever" },
+  ],
+  quote: "\u201cYou're not describing a technology. You're describing a new factor of production.\u201d — a sitting finance minister",
+});
+
+/* S14 ---------------------------------------------------------- heroQuad */
+W.heroQuad(pres, {
+  tag: "THE CATALYST", deck: DECK, n: p(), total: TOTAL, dark: true,
+  titleText: ["Sovereign deals in ", "advanced stages", "."],
+  subtitleText: "Nations are hiring the new workforce — a combined commitment that anchors the priced round and validates Wand as sovereign-grade infrastructure.",
+  hero: {
+    pill: "ADVANCED · UAE · SINGAPORE",
+    bigValue: "$1B+", bigCaption: "Sovereign investment at $8B pre-money valuation",
+    subValue: "+$1B", subCaption: "Compute & revenue add-ons committed alongside the round",
+  },
+  tiles: [
+    { icon: "icon-40.png", title: "Each engagement", body: "$500M–$1B initial commitment per country" },
+    { icon: "icon-41.png", title: "Term",            body: "3–5 year contracts with annual escalators" },
+    { icon: "icon-43.png", title: "Deployment",      body: "On-premises sovereign cloud · full data residency" },
+    { icon: "icon-44.png", title: "Pipeline",        body: "8+ countries in active sovereign engagement" },
+  ],
+  kickerText: "Total government revenue commitment by 2029: $5.5B–$9.0B across 6+ countries.",
+});
+
+/* S15 --------------------------------------------------------------- L19 */
+W.bridge(pres, {
+  tag: "UNIT ECONOMICS", deck: DECK, n: p(), total: TOTAL, dark: false,
+  titleText: ["Software economics, ", "not AI economics", "."],
+  subtitleText: "Most AI companies burn 40–60% of revenue on compute. Wand doesn't carry that cost — clients run their own compute, structurally.",
+  eyebrow: "MARGIN BRIDGE",
+  rows: [
+    { label: "Revenue",                 value: "100%",    frac: 1.00 },
+    { label: "Compute (client-hosted)", value: "0%",      frac: 0.03 },
+    { label: "Platform ops & support",  value: "−5%",     frac: 0.05 },
+    { label: "Infrastructure & hosting",value: "−7%",     frac: 0.07 },
+    { label: "Gross margin",            value: "85–88%",  frac: 0.87 },
+  ],
+  stats: [
+    { value: "150%+",         label: "Net revenue retention", caption: "Land-and-expand drives account growth" },
+    { value: "<3%",           label: "Annual gross churn",    caption: "Mission-critical deployments lock in" },
+    { value: "<12 mo",        label: "CAC payback",           caption: "Capital-efficient acquisition" },
+    { value: "$5M → $50M+",   label: "ACV expansion · 3yr",   caption: "Average contract 10× in 3 years" },
+  ],
+});
+
+/* S16 ---------------------------------------------------------------- L7 */
+W.sixUpIcon(pres, {
+  tag: "THE MOAT", deck: DECK, n: p(), total: TOTAL, dark: true,
+  titleText: ["Six ", "compounding", " layers of advantage."],
+  subtitleText: "Technical, data, and organizational — each one widens the gap with every quarter of deployment.",
+  items: [
+    { icon: "icon-45.png", title: "40+ patents pending",  body: "Core agentic mechanics, orchestration protocols, and self-evolving agent architecture." },
+    { icon: "icon-16.png", title: "Self-evolving agents", body: "Agents improve autonomously every quarter — competitors can't replicate without years of deployment data." },
+    { icon: "icon-46.png", title: "Data network effects", body: "Every deployment generates proprietary workflow data that makes agents smarter — a compounding flywheel." },
+    { icon: "icon-31.png", title: "World-class team",     body: "80+ AI experts — researchers from leading AI labs, the intelligence community, and top tech operators." },
+    { icon: "icon-48.png", title: "Enterprise lock-in",   body: "Mission-critical deployments make switching costs enormous once Wand OS runs the workforce." },
+    { icon: "icon-39.png", title: "Sovereign-grade moat", body: "Multi-year contracts and on-premises deployments create regulatory and contractual barriers." },
+  ],
+});
+
+/* S17 ---------------------------------------------------------------- L3 */
+W.closing(pres, {
+  eyebrow: "THE MISSION",
+  line1: "The biggest transition in human history.",
+  line2: "Humanity's next level of evolution.",
+  body: "Infinite labor, human direction. People and agents — curious, committed, evolving — building together what neither could build alone.",
+  url: "wand.ai",
+});
+
+pres.writeFile({ fileName: "infinite-rebuilt.pptx" })
+  .then(() => console.log(`wrote infinite-rebuilt.pptx (${TOTAL} slides)`));

package/docs/LAYOUTS.md

@@ -0,0 +1,86 @@
+# Layout catalog
+
+Twenty-six callable layouts. `lib/schema.js` holds the same catalog as data —
+`node wand.js layouts <name>` prints any layout's fields, marks the required
+ones, and gives the item cap. Where this file and the schema disagree, the
+schema is what `validate` enforces, so fix the schema and this file together.
+
+Geometry is measured from the reference decks, not
+transcribed from the spec — where §5 and a reference deck disagreed, the deck won
+and the difference is noted.
+
+Every layout takes `tag`, `dark`, `titleText`, `subtitleText`, and (except the
+full-bleed three) `deck` / `n` / `total` for the footer.
+
+## Structural
+
+| Layout | Params | Use for |
+|---|---|---|
+| `cover` | `eyebrow, titleLines[], body, kickerPlain, kickerBold` | Slide 1. Dark, full bleed, no footer |
+| `divider` | `eyebrow, titleText, body` | Section breaks and the agenda. Keeps the tag, drops the footer |
+| `closing` | `eyebrow, line1, line2, body, url` | Last slide. Centred, full bleed |
+
+## Content
+
+| Layout | Params | Use for |
+|---|---|---|
+| `threeUp` | `items[{eyebrow,title,pill,body,emph}], arrows` | 3 comparable things. `arrows: true` for a progression |
+| `fourUpIcon` | `items[{icon,title,body}], kickerText` | 4 attributes or capabilities |
+| `sixUpIcon` | `items[{icon,title,body}]` | 6 features. Don't use it three slides running |
+| `rows` | `items[{icon,label,description,badge,ours}]` | Stack / ownership tables. `ours: false` gets the dashed "bring your own" treatment |
+| `parity` | `left, right, badge, kickerText` | Two-sided comparison, list-shaped. The contrast between the two cards is the point |
+| `colCards` | `items[{art,eyebrow,title,body,bullets[]}]` | 2–3 layers, each with prose *and* a bullet list |
+| `numberedCards` | `items[{eyebrow,number,title,badge,body,emph}]` | "Three strategic priorities" — where the ordinal is the organising device |
+| `phaseCards` | `phases[{period,title,bullets[]}]` | 4-step roadmaps. Card 1 is the emphasis card |
+| `archStack` | `top, middle{modules[]}, sources{cards[]}, outcome` | Layered architecture: actors on top, your governed layer in the middle, vendors below, outcome band at the base |
+
+## Data
+
+| Layout | Params | Use for |
+|---|---|---|
+| `statQuad` | `items[{value,caption}], kickerText` | 4 standalone figures |
+| `statGrid` | `items[{value,label,caption,emph}], footnote` | 6 figures. Card 1 can be the emphasis card |
+| `featureStats` | `lead{icon,runs[]}, stats[{value,caption}]` | One assertion card plus 3 supporting figures |
+| `barRank` | `bars[{label,value,frac}], cards[], footnote` | Ranked magnitudes — TAM ladders, market sizing. **Not `addChart()`** |
+| `bridge` | `eyebrow, rows[{label,value,frac}], stats[]` | Margin bridges and waterfalls |
+| `band` | `icon, runs[{text,accent}], stats[], quote` | An equation or single assertion, usually over a stat row |
+| `matrixGrid` | `groups[{category,items[{title,body}]}], kickerText` | Categorised inventories — use-case maps, capability grids. 3–4 columns × 3 rows |
+| `logoBands` | `stats[], bands[{label,names,note}]` | Proof points: figures over customer/investor name rows |
+| `heroQuad` | `hero{pill,bigValue,bigCaption,subValue,subCaption}, tiles[], kickerText` | One headline figure plus a 2×2 detail grid |
+| `productMap` | `bandRow, cards[], split, base` | Rail-labelled product architecture (MANAGE / EXECUTE / WORKFORCE) |
+
+## Choosing
+
+Follow §6 Phase 3 — stop at the first match. Structural first, then quotes,
+timelines, data, comparisons, stacks, assertions, numbered asks, and only then
+fall back on item count.
+
+Vary them. Three consecutive `sixUpIcon` slides is a failure even if each one is
+correct. Across 15 slides aim for at least 8 distinct layouts and alternate dark
+and light.
+
+## Not yet built
+
+`fiveUpStack` (L8), `timeline` (L13), `quotes` (L21).
+Add on demand — building the whole catalog before shipping a deck is what
+stalled two earlier revisions.
+
+## Layouts that flow from measurement
+
+`archStack`, `matrixGrid`, `phaseCards` and `numberedCards` compute their
+content top with `contentTop()` and fill down to the y5.05 limit. A two-line
+title on those layouts pushes the content down instead of colliding with it.
+The older layouts still use fixed content-band coordinates; migrating them is
+worth doing when one of them next misbehaves.
+
+## Added for client decks (v0.4.0)
+
+| Layout | Params | Use for |
+|---|---|---|
+| `problemGrid` | `strip{label,chips[]}, problems{label,items[]}` | The challenge slide: a strip of today's reality, then the problems it creates |
+| `splitPanel` | `left{eyebrow,heading,body,note}, right{eyebrow,heading,items[]}` | One half argument, one half evidence |
+| `compareTable` | `reasons[], table{leftHead,rightHead,rows[]}` | Reason cards over a status-quo vs ours comparison |
+| `numberedList` | `items[{title,body}], closing{line1,line2}, signoff, columns` | Agendas, asks, "what we'll cover" |
+
+`archStack` also accepts an empty `middle.modules` — the middle band then renders
+as a single centred connector line instead of a module row.