wand-decks-kit 0.8.0 → 0.8.1

package/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: wand-decks
+description: Rebrand, merge, edit or author a PowerPoint deck on the Wand design system. Use when a .pptx is attached for restyling, or a deck is wanted from a brief. Outputs a client-ready .pptx and QA gates.
+compatibility: Requires Node.js 18+ and code execution enabled in claude.ai (Settings > Features). No network access needed - dependencies are bundled. Python 3 is used to read a source .pptx and to embed fonts; without it the kit can still author and check a deck, but the output will render in Arial on machines without Geist.
+license: Proprietary - Wand AI
+metadata:
+  version: "0.7.0"
+---
+
+
+# Wand decks
+
+## First: find the kit and stand in it
+
+This file ships inside the kit, so if you are reading it you are close. The kit
+arrives one of three ways — work out which, then `cd` into the kit's folder and
+run everything from there:
+
+1. **Installed from npm** (the usual way): it is at `node_modules/wand-decks-kit/`.
+   If it is not there yet: `npm install wand-decks-kit@latest --no-audit --no-fund`.
+2. **Attached to the chat as a zip**: unzip it and enter the folder it makes.
+3. **You are already inside it**: `wand.js` is next to this file.
+
+Then confirm the ground you are standing on:
+
+```bash
+node wand.js doctor
+```
+
+If none of the three work — npm unreachable, nothing attached — **stop and say
+so, and ask the user to attach the kit zip.** Never improvise a deck, and never
+report checks you did not run; the gates are the only reason to trust the
+output.
+
+Every path below is relative to the kit folder.
+
+A deck engine: 28 layouts, real font metrics, embedded Geist, and six gates that
+each catch something the others cannot.
+
+**Read `PROMPT.md` before making any design decision.** It is the source of
+truth on canvas, colour, type, layout choice and content rules. This file is
+only the operating procedure.
+
+## Available scripts
+
+- **`wand.js`** — the front door - doctor, rebuild, layouts, glyphs, validate, check, preview, ship, spec, inspect
+- **`build.js`** — spec -> .pptx, or --check, or --preview
+- **`tools/extract.py`** — read a source deck: verbatim dump, geometry, analysis
+- **`embed_fonts.py`** — embed Geist unsubsetted, and carry the spec inside the deck
+- **`qa_coverage.py`** — diff the verbatim dump against the built deck
+
+## Setup
+
+None beyond the doctor check above. Dependencies come with the package —
+npm resolves them on install, and the zip carries them vendored.
+
+
+```bash
+node wand.js doctor
+```
+
+If `node_modules` is somehow missing, `npm install` in this directory.
+
+## The four jobs
+
+### Rebrand a deck they attached
+
+```bash
+node wand.js rebuild <their-deck>.pptx     # phases 0-3
+#   ...you write work/deck.json...
+node wand.js ship work/deck.json           # phases 4-6, prints the gate table
+```
+
+`rebuild` normalises the source onto the 10in grid, dumps every verbatim string
+and writes `work/PLAN.md` — per slide: the source's shape, a layout shortlist
+with reasons, the verbatim text grouped by frame, and a stub with the required
+fields. Choose the layout yourself; the shortlist is ranked by shape and cannot
+see meaning.
+
+### Author from a brief
+
+Skip `rebuild`. Write the spec against `node wand.js layouts` and
+`examples/template.json`, then `ship`. Coverage is skipped — there is no source
+to cover — and it says so.
+
+### Merge several decks
+
+`node wand.js rebuild` each one into its own work directory, then write a single
+spec. Ask which deck leads if they have not said. Flag duplicates rather than
+silently dropping them, and list every merge in the review note.
+
+### Edit a deck this kit built
+
+```bash
+node wand.js spec <their-deck>.pptx work/deck.json
+```
+
+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.
+
+## Rules that decide whether the output is usable
+
+1. **Faithful means verbatim.** No consolidating slides, no paraphrasing to
+   tighten, no restructuring. Reflowing to fit is fine; rewording is not.
+   Paraphrase passes the schema check and passes the eye — only coverage catches
+   it.
+2. **A spec has no coordinates, colours or font sizes.** If a slide needs
+   geometry the layouts do not have, add a layout. Never leak positioning into
+   content.
+3. **Vary the layouts.** Three of the same in a row is a failure even if each is
+   correct. Across 15 slides aim for at least eight distinct ones, alternating
+   dark and light. `validate` warns when you do not.
+4. **Icons are named.** `node wand.js glyphs` lists all 75. Pick by meaning.
+   They recolour to the theme, so there is no polarity to get wrong.
+5. **Never invent content.** If the source is ambiguous, ask.
+
+## Useful commands
+
+| | |
+|---|---|
+| `node wand.js layouts [name]` | the catalog, and any layout's fields |
+| `node wand.js glyphs [search]` | the named icon set |
+| `node wand.js validate <spec>` | fields, types, item caps — run before building |
+| `node wand.js check <spec>` | fit in real Geist, bounds, assets |
+| `node wand.js preview <spec>` | writes `preview/trace.js` for the browser preview |
+| `node wand.js inspect <deck>` | parts, relationships, embedded fonts |
+
+## Deliver
+
+The `.pptx` first, then a review note: every split or merge, every fallback
+mapping, anything tight after fitting, and **everything dropped from the
+verbatim dump**. A rebuild that drops a string without saying so is not done.
+
+Tell them the gate table honestly. The visual gate is the one no script passes —
+say plainly that nobody has looked at the slides yet if nobody has.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wand-decks-kit",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "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/wand_kit.js

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