wand-decks-kit 0.8.2 → 0.8.4

package/SKILL.md

@@ -99,6 +99,20 @@ Decks built here carry their own spec inside the file. Change only what was
 asked, then `ship`. If the deck carries no spec it was not built here — treat it
 as a rebrand.
 
+## Spend tool calls like they are metered — they are
+
+Chat turns cap the number of tool invocations, and a rebuild is command-heavy.
+Batch aggressively:
+
+- Setup is ONE call: `npm install ... && node wand.js doctor`
+- Gates are ONE call: `node wand.js validate spec && node wand.js check spec`
+- Write the whole spec in one write, never slide by slide
+- `ship` is already the whole pipeline — one call, at the end
+- The visual pass is ONE image: `slides/sheet.png`
+
+A smooth job fits in about ten calls. If a turn is cut off mid-way, continuing
+is safe: the sandbox and its installed kit survive within the same chat.
+
 ## Work in fast loops, ship once
 
 `node wand.js validate` and `node wand.js check` run in seconds; `ship` runs the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wand-decks-kit",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Rebuilds or authors a client-ready .pptx on the Wand design system: measured fit, embedded Geist, verbatim content.",
   "license": "SEE LICENSE IN PROMPT.md",
   "bin": {

package/tools/sheet.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""
+sheet.py — stitch rendered slides into one contact sheet.
+
+    python3 tools/sheet.py <dir-of-pngs> <out.png> [cols]
+
+Why: the visual gate on a 24-slide deck used to mean viewing 24 images — the
+single largest token cost of a rebuild, bigger than the instructions and the
+spec combined. One sheet gives the whole-deck pass for the price of one image;
+the full-size renders stay on disk for zooming into anything that looks off.
+
+Pure standard library, like everything else in this kit.
+"""
+
+import glob, os, struct, sys, zlib
+
+
+def read_png(path):
+    d = open(path, "rb").read()
+    pos, idat = 8, b""
+    w = h = ct = None
+    while pos < len(d):
+        ln = struct.unpack(">I", d[pos:pos + 4])[0]
+        typ = d[pos + 4:pos + 8]
+        if typ == b"IHDR":
+            w, h, bd, ct = struct.unpack(">IIBB", d[pos + 8:pos + 18])
+        elif typ == b"IDAT":
+            idat += d[pos + 8:pos + 8 + ln]
+        pos += 12 + ln
+    ch = {0: 1, 2: 3, 6: 4}[ct]
+    raw = zlib.decompress(idat)
+    stride = w * ch
+    out = bytearray(h * stride)
+    prev = bytearray(stride)
+    i = 0
+    for y in range(h):
+        f = raw[i]; i += 1
+        line = bytearray(raw[i:i + stride]); i += stride
+        for x in range(stride):
+            a = line[x - ch] if x >= ch else 0
+            b = prev[x]
+            c = prev[x - ch] if x >= ch else 0
+            v = line[x]
+            if f == 1: v += a
+            elif f == 2: v += b
+            elif f == 3: v += (a + b) // 2
+            elif f == 4:
+                p = a + b - c
+                pa, pb, pc = abs(p - a), abs(p - b), abs(p - c)
+                v += a if (pa <= pb and pa <= pc) else (b if pb <= pc else c)
+            line[x] = v & 255
+        out[y * stride:(y + 1) * stride] = line
+        prev = line
+    # normalise to RGB
+    if ch == 3:
+        return w, h, bytes(out)
+    rgb = bytearray(w * h * 3)
+    for px in range(w * h):
+        if ch == 1:
+            rgb[px * 3:px * 3 + 3] = bytes([out[px]] * 3)
+        else:
+            rgb[px * 3:px * 3 + 3] = out[px * 4:px * 4 + 3]
+    return w, h, bytes(rgb)
+
+
+def write_png(path, w, h, rgb):
+    raw = bytearray()
+    for y in range(h):
+        raw.append(0)
+        raw += rgb[y * w * 3:(y + 1) * w * 3]
+    def chunk(t, d):
+        return struct.pack(">I", len(d)) + t + d + struct.pack(">I", zlib.crc32(t + d) & 0xFFFFFFFF)
+    open(path, "wb").write(
+        b"\x89PNG\r\n\x1a\n"
+        + chunk(b"IHDR", struct.pack(">IIBBBBB", w, h, 8, 2, 0, 0, 0))
+        + chunk(b"IDAT", zlib.compress(bytes(raw), 9))
+        + chunk(b"IEND", b""))
+
+
+def main():
+    src, out = sys.argv[1], sys.argv[2]
+    cols = int(sys.argv[3]) if len(sys.argv) > 3 else 4
+    files = sorted(glob.glob(os.path.join(src, "*.png")))
+    files = [f for f in files if os.path.abspath(f) != os.path.abspath(out)]
+    if not files:
+        raise SystemExit(f"no PNGs in {src}")
+    tiles = [read_png(f) for f in files]
+    tw = max(t[0] for t in tiles)
+    th = max(t[1] for t in tiles)
+    gap = 6
+    rows = (len(tiles) + cols - 1) // cols
+    W = cols * tw + (cols + 1) * gap
+    H = rows * th + (rows + 1) * gap
+    sheet = bytearray(b"\x1a\x16\x38" * (W * H))          # dark ground between tiles
+    for i, (w, h, rgb) in enumerate(tiles):
+        ox = gap + (i % cols) * (tw + gap)
+        oy = gap + (i // cols) * (th + gap)
+        for y in range(h):
+            dst = ((oy + y) * W + ox) * 3
+            sheet[dst:dst + w * 3] = rgb[y * w * 3:(y + 1) * w * 3]
+    write_png(out, W, H, bytes(sheet))
+    print(f"{out}  ({len(tiles)} slides, {W}x{H})")
+
+
+if __name__ == "__main__":
+    main()

package/wand.js

@@ -210,8 +210,18 @@ function ship(specPath, outArg) {
     const dir = path.join(work, "slides");
     fs.mkdirSync(dir, { recursive: true });
     spawnSync("pdftoppm", ["-r", "96", "-png", pdfOut, path.join(dir, "slide")], { stdio: "inherit" });
-    shots = fs.readdirSync(dir).filter((f) => f.endsWith(".png")).length;
-    console.log(`rendered    : ${shots} slide(s) to ${rel(dir)}/ - look at every one`);
+    shots = fs.readdirSync(dir).filter((f) => f.startsWith("slide")).length;
+    // One contact sheet is the whole-deck pass for the price of one image.
+    // Viewing 24 renders one by one was the biggest token line of a rebuild —
+    // more than the instructions and the spec combined.
+    const small = fs.mkdtempSync(path.join(require("os").tmpdir(), "wand-sheet-"));
+    spawnSync("pdftoppm", ["-r", "26", "-png", pdfOut, path.join(small, "s")], { stdio: "ignore" });
+    const sheet = path.join(dir, "sheet.png");
+    runPython([path.join(KIT, "tools", "sheet.py"), small, sheet]);
+    fs.rmSync(small, { recursive: true, force: true });
+    console.log(`rendered    : ${shots} slide(s) to ${rel(dir)}/`);
+    console.log(`visual pass : open ${rel(sheet)} — one image, every slide. Open an`);
+    console.log(`              individual slide-NN.png only where something looks off.`);
   } else {
     console.log(`open ${rel(path.join(KIT, "preview", "preview.html"))} and look at every slide.`);
   }

package/wand_kit.js

@@ -999,7 +999,7 @@ function productMap(pres, { tag, titleText, subtitleText, bandRow, cards, split,
 
 
 module.exports = {
-  VERSION: "0.8.2",
+  VERSION: "0.8.4",
   T, F, COLS, ASSETS, radius, theme, autoSize, measure: M,
   background, chrome, footer, title, subtitle, kicker, contentTop,
   card, iconTile, pill,