wand-kit 0.3.2 → 0.5.0

package/library/interim/open-agent-discovery-share-head-tags.html

@@ -0,0 +1,17 @@
+<!-- https://wand.ai/insights/open-agent-discovery-nandaindex.html -->
+<meta property="og:type" content="article">
+<meta property="og:site_name" content="Wand">
+<meta property="og:title" content="An Open Agentic Web Needs Open Discovery | Wand AI">
+<meta property="og:description" content="Why interoperable agent discovery matters for the emerging agentic economy, and how NandaIndex complements governed AI workforces.">
+<meta property="og:url" content="https://wand.ai/insights/open-agent-discovery-nandaindex.html">
+<meta property="og:image" content="https://wand.ai/assets/og/20261023/open-agent-discovery-share-1200x630.png">
+<meta property="og:image:secure_url" content="https://wand.ai/assets/og/20261023/open-agent-discovery-share-1200x630.png">
+<meta property="og:image:type" content="image/png">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:image:alt" content="Wand. An Open Agentic Web Needs Open Discovery.">
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="An Open Agentic Web Needs Open Discovery | Wand AI">
+<meta name="twitter:description" content="Why interoperable agent discovery matters for the emerging agentic economy, and how NandaIndex complements governed AI workforces.">
+<meta name="twitter:image" content="https://wand.ai/assets/og/20261023/open-agent-discovery-share-1200x630.png">
+<meta name="twitter:image:alt" content="Wand. An Open Agentic Web Needs Open Discovery.">

package/library/interim/wand-ai-share-head-tags.html

@@ -0,0 +1,17 @@
+<!-- https://wand.ai/ -->
+<meta property="og:type" content="website">
+<meta property="og:site_name" content="Wand">
+<meta property="og:title" content="Wand AI">
+<meta property="og:description" content="Autonomous AI workers. One operating system for people and agents. The foundation for a new era of enterprise and national capacity.">
+<meta property="og:url" content="https://wand.ai/">
+<meta property="og:image" content="https://wand.ai/assets/og/20261023/wand-ai-share-1200x630.png">
+<meta property="og:image:secure_url" content="https://wand.ai/assets/og/20261023/wand-ai-share-1200x630.png">
+<meta property="og:image:type" content="image/png">
+<meta property="og:image:width" content="1200">
+<meta property="og:image:height" content="630">
+<meta property="og:image:alt" content="Wand. A new workforce. A new operating era.">
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="Wand AI">
+<meta name="twitter:description" content="Autonomous AI workers. One operating system for people and agents. The foundation for a new era of enterprise and national capacity.">
+<meta name="twitter:image" content="https://wand.ai/assets/og/20261023/wand-ai-share-1200x630.png">
+<meta name="twitter:image:alt" content="Wand. A new workforce. A new operating era.">

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wand-kit",
-  "version": "0.3.2",
-  "description": "One HTML design surface for every sales and marketing material, on either Wand brand: decks that animate and present, documents, one-pagers, case studies, storyboards from a script, social cards. Every export (PDF, PNG, PowerPoint, one-file HTML) is read from the page that was reviewed.",
+  "version": "0.5.0",
+  "description": "One HTML design surface for every sales and marketing material, on any of the three Wand brands: decks that animate and present, documents, one-pagers, case studies, storyboards from a script, social images. Every export (PDF, PNG, PowerPoint, one-file HTML) is read from the page that was reviewed, and the files people approved (banners, link previews, icons, logos, art) are handed out as they are.",
   "license": "SEE LICENSE IN PROMPT.md",
   "bin": {
     "wand-kit": "./wand.js"

package/templates/card.mjs

@@ -2,17 +2,21 @@
  * __NAME__ — social cards on the Wand studio (square 1080 × 1080, or og 1200 × 630).
  *
  * One `c.page()` per card. Each page becomes a PNG in out/pages/; the PDF
- * carries them all. `css` may only use the brand's custom properties.
+ * carries them all. `css` may only use the brand's custom properties. On the
+ * interim brand, banners and link previews come from its approved composition
+ * instead: `node wand.js social` (PROMPT.md §14).
  */
 export default {
   name: "__NAME__",
-  brand: "__BRAND__",          // current | next
+  brand: "__BRAND__",          // current | next | interim
   surface: "__SURFACE__",      // square | og
   tag: "Wand",
   footer: "wand.ai",
   css: `
 .quote-card .content{justify-content:center;gap:1.2em}
 .quote-card .lede{font-size:var(--t-h2);line-height:1.3;max-width:100%}
+/* a share image (og) keeps its words in the centre square: Slack and WhatsApp cut their thumbnail there */
+.surface-og .quote-card .content{left:309px;right:309px}
 `,
   pages: (c) => [
     c.page({ dark: true, art: "cover", eyebrow: "Announcement", cls: "quote-card", body: `

package/templates/page.mjs

@@ -11,7 +11,7 @@
  */
 export default {
   name: "__NAME__",
-  brand: "__BRAND__",          // current | next
+  brand: "__BRAND__",          // current | next | interim
   surface: "__SURFACE__",      // letter | a4
   tag: "Wand",                 // the running tag, left of the eyebrow
   footer: "Wand AI · Confidential",

package/templates/slide.mjs

@@ -8,7 +8,7 @@
  */
 export default {
   name: "__NAME__",
-  brand: "__BRAND__",          // current | next
+  brand: "__BRAND__",          // current | next | interim
   surface: "slide",
   tag: "Wand × Client",
   footer: "Wand AI · Strictly confidential",

package/templates/storyboard.mjs

@@ -10,7 +10,7 @@
  */
 export default {
   name: "__NAME__",
-  brand: "__BRAND__",          // current | next
+  brand: "__BRAND__",          // current | next | interim
   surface: "slide",
   tag: "Wand · Storyboard",
   footer: "Wand AI · Draft for review",

package/wand.js

@@ -3,7 +3,7 @@
  * wand.js — the studio's front door.
  *
  *   node wand.js doctor                               what works here, and the brand rule
- *   node wand.js new <dir> [--surface letter] [--brand current|next] [--name "Title"]
+ *   node wand.js new <dir> [--surface letter] [--brand current|next|interim] [--name "Title"]
  *                                                     a job folder to compose in, on the default brand
  *                                                     unless --brand names the other
  *   node wand.js new <dir> --surface storyboard        a storyboard from a script (shots, frames, timing)
@@ -14,7 +14,17 @@
  *                                                     like a presenter would before it ships
  *   node wand.js poster <demo.html> [--play 4]        a demo's poster: the frame every static export shows
  *   node wand.js watch <job.mjs>                      rebuild on save, the browser kept warm
- *   node wand.js gallery [--brand current|next]       every component, light and dark, on one surface each
+ *   node wand.js social <social.json> [--brand interim]  the social set drawn from the brand's approved composition:
+ *                                                     banners, share images and their tags, a square, the avatar,
+ *                                                     a profile photo that continues the banner, the site's icons;
+ *                                                     INSTALL.md and a zip of the hand-over (interim only)
+ *   node wand.js social --audit <url | page.html> [more] [--image og.png]
+ *                                                     a page's link preview as it is today: its tags, its image,
+ *                                                     and that image the way the feeds cut and shrink it
+ *   node wand.js library [words] [--brand interim]    the approved files: banners, link previews, icons, logos, art
+ *   node wand.js library get <id> [<id>…] [--to dir]  hand one over as it is (no browser needed)
+ *   node wand.js library --check                      every file the one approved, and the kit still draws it
+ *   node wand.js gallery [--brand current|next|interim]       every component, light and dark, on one surface each
  *   node wand.js components                           the vocabulary
  *   node wand.js brands                               the brands this kit can draw with
  *
@@ -51,6 +61,7 @@ async function doctor() {
   const py = ["python3", "python"].find((c) => spawnSync(c, ["-c", "import sys;print(sys.version_info[0])"], { encoding: "utf8" }).stdout?.trim() === "3");
   rows.push(["python3", py ? execFileSync(py, ["-V"], { encoding: "utf8" }).trim() : "absent", py ? "ok" : "the .pptx ships without embedded fonts"]);
   rows.push(["pdftotext", has("pdftotext") ? "found" : "absent", has("pdftotext") ? "ok" : "coverage is read from the DOM only (poppler adds the PDF read-back)"]);
+  try { const { load } = await import("./lib/library.js"); rows.push(["library", `${load().assets.length} approved assets`, "ok"]); } catch { rows.push(["library", "absent", "no approved files to hand out"]); }
   const w = Math.max(...rows.map((r) => r[0].length));
   console.log("");
   for (const [k, v, s] of rows) console.log(`${s === "ok" ? "  " : "! "}${k.padEnd(w)}  ${String(v).padEnd(36)}${s === "ok" ? "" : s}`);
@@ -61,7 +72,7 @@ async function doctor() {
 }
 
 function newJob() {
-  const dir = args[1]; if (!dir) die("usage: node wand.js new <dir> [--surface letter|a4|slide|square|og] [--brand current|next] [--name \"Title\"]");
+  const dir = args[1]; if (!dir) die("usage: node wand.js new <dir> [--surface letter|a4|slide|square|og] [--brand current|next|interim] [--name \"Title\"]");
   const surface = flag("--surface", "letter"), brand = flag("--brand", DEFAULT_BRAND), name = flag("--name", path.basename(dir));
   if (!BRANDS.includes(brand)) die(`unknown brand "${brand}" - one of ${BRANDS.join(", ")}`);
   const tpl = path.join(KIT, "templates", `${surface === "storyboard" ? "storyboard" : ["slide", "square", "og"].includes(surface) ? (surface === "slide" ? "slide" : "card") : "page"}.mjs`);
@@ -82,7 +93,7 @@ function brandFlag() {
 }
 
 async function build(jobPath, opts) {
-  if (!jobPath) die("usage: node wand.js build <job.mjs> [--brand current|next]");
+  if (!jobPath) die("usage: node wand.js build <job.mjs> [--brand current|next|interim]");
   const { build } = await import("./lib/engine.js");
   return build(jobPath, { ...opts, brand: brandFlag() });
 }
@@ -143,7 +154,7 @@ async function watch(jobPath) {
 
 /** A demo's poster: the page at the size it is shown, after it settles, optionally after it plays. */
 async function poster(demoPath) {
-  if (!demoPath) die("usage: node wand.js poster <demo.html> [--brand current|next] [--size 1280x720] [--wait 1.5] [--play 0] [--out poster.png]");
+  if (!demoPath) die("usage: node wand.js poster <demo.html> [--brand current|next|interim] [--size 1280x720] [--wait 1.5] [--play 0] [--out poster.png]");
   const { browser, closeBrowser } = await import("./lib/engine.js");
   const [w, h] = flag("--size", "1280x720").split("x").map(Number);
   const out = flag("--out", demoPath.replace(/\.html?$/i, "") + ".poster.png");
@@ -174,6 +185,52 @@ async function gallery() {
   return r.ok ? 0 : 1;
 }
 
+async function social(specPath) {
+  const { closeBrowser } = await import("./lib/engine.js");
+  if (on("--audit")) {
+    const { audit } = await import("./lib/audit.js");
+    const skip = new Set(["--audit", flag("--image"), flag("--out")]);
+    const targets = args.slice(1).filter((a, i, all) => !skip.has(a) && !["--image", "--out"].includes(all[i - 1]) && !a.startsWith("--"));
+    const r = await audit(targets, { image: flag("--image"), out: flag("--out", "audit") });
+    await closeBrowser();
+    return r.ok ? 0 : 1;
+  }
+  if (!specPath) die("usage: node wand.js social <social.json> [--brand interim]   (see examples/social/social.json)\n       node wand.js social --audit <url | page.html> [more] [--image og.png] [--out audit]");
+  const { social } = await import("./lib/social.js");
+  const r = await social(specPath, { brand: brandFlag() });
+  await closeBrowser();
+  return r.ok ? 0 : 1;
+}
+
+/** The approved files: list them, hand them over as they are, or prove they are still the ones approved. */
+async function library() {
+  const lib = await import("./lib/library.js");
+  if (on("--check")) {
+    const r = await lib.check();
+    const { closeBrowser } = await import("./lib/engine.js"); await closeBrowser();
+    return r.ok ? 0 : 1;
+  }
+  const brand = brandFlag();
+  const words = args.slice(1).filter((a, i, all) => !a.startsWith("--") && !["--brand", "--to"].includes(all[i - 1]));
+  if (words[0] === "get") {
+    if (!words[1]) die("usage: node wand.js library get <id> [<id>…] [--to dir] [--brand interim]   (node wand.js library lists the ids)");
+    const { done, missing } = lib.get(words.slice(1), { to: flag("--to", "wand-assets"), brand });
+    for (const { asset, files } of done) {
+      console.log(`\n  ${asset.id}  ${asset.title} (${asset.brand} brand)\n  use       ${asset.use}\n  approved  ${asset.approved}`);
+      const show = (p) => (rel(p).startsWith("..") ? p : rel(p));
+      for (const f of files) console.log(`    ${show(f.dest).padEnd(52)} ${String(f.px || "").padEnd(24)} ${Math.max(1, Math.round(f.bytes / 1024))} KB`);
+    }
+    for (const m of missing) console.log(`\n  ${m.id}: ${m.cands.length ? `which one? ${m.cands.join(", ")}` : "no such asset; node wand.js library lists them"}`);
+    console.log("");
+    return missing.length ? 2 : 0;
+  }
+  const found = lib.list(words, { brand });
+  console.log("");
+  for (const a of found) console.log(`  ${a.id.padEnd(28)} ${a.brand.padEnd(8)} ${a.title}${a.size ? `, ${a.size}` : ""}`);
+  console.log(found.length ? `\n  ${found.length} of ${lib.load().assets.length} approved assets. Hand one over: node wand.js library get <id> --to <folder>\n` : `  nothing matches ${words.join(" ")}; node wand.js library lists everything\n`);
+  return 0;
+}
+
 async function components() {
   const { bind } = await import("./lib/components.js");
   const { loadBrand } = await import("./lib/brand.js");
@@ -185,7 +242,7 @@ async function components() {
     tag: "tag(text)  a caps label", cols: "cols(n, [items], { stretch })  a grid", card: "card({ tag, title, level, body, out, emph, sm })", callout: "callout({ tag, text, emph })",
     strip: "strip([labels], { on })  numbered chips with arrows", chip: "chip(i, label, state)", phase: "phase(i, label, line)  chip then heading", flow: "flow({ label, nodes: [[who, verb, 'a'|'p']], note })",
     table: "table({ head, rows, emph })  cells: string or { v, meter, cls }", quote: "quote({ text, by, emph })", who: "who(name, role)", stats: "stats([{ v, k, hero }])", delta: "delta(from, to)",
-    steps: "steps([{ title, when, body, emph }])", list: "list([items])", chapter: "chapter(num)  the deck's numeral panel", img: "img(src, cls, alt)", icon: "icon(name)  a brand glyph", tile: "tile(name)  a glyph on a tile",
+    steps: "steps([{ title, when, body, emph }])", list: "list([items])", chapter: "chapter(num)  the deck's numeral panel", img: "img(src, cls, alt)", photo: "photo(nameOrPath, { cls, alt, pos })  a photograph, filled and graded", icon: "icon(name)  a brand glyph", tile: "tile(name)  a glyph on a tile",
     accent: "accent(text, phrase)  the phrase in the accent colour", split: "split(line, sep)", L: "L(n)  line n of content.txt", esc: "esc(s)", art: "art(role)  a brand art url", asset: "asset(file)",
   };
   console.log("");
@@ -209,6 +266,8 @@ try {
     case "watch": await watch(args[1]); break;
     case "gallery": process.exit(await gallery());
     case "poster": process.exit(await poster(args[1]));
+    case "social": process.exit(await social(args[1]));
+    case "library": process.exit(await library());
     case "components": await components(); break;
     case "brands": await brands(); break;
     default: