wand-kit 0.1.0 → 0.2.0

package/PROMPT.md

@@ -37,8 +37,11 @@ strokes) and `art` (which file plays which role). A component asks for a role
 `tokens.json` and `BRAND.md` differ, `BRAND.md` is right and `tokens.json` has
 drifted.
 
-The new brand is for internal testing until the FK Roman Standard licence for
-documents is settled (`brand-next/fonts/LICENSE-FONTS.md`).
+`current` is the default while the two overlap; a job is on `next` when the
+user asks for the new brand. The default is one constant, `DEFAULT_BRAND` in
+`kit/lib/brand.js`, and `doctor` prints the rule from it. The FK Roman
+Standard licence for documents is still to be confirmed
+(`brand-next/fonts/LICENSE-FONTS.md`).
 
 ## 1. Surfaces — locked
 

package/SKILL.md

@@ -1,19 +1,19 @@
 ---
-name: wand-studio
-description: Design any Wand sales or marketing material on either brand - a deck, a document, a one-pager, a case study, social cards - as PDF, PowerPoint and one-file HTML, with gates. Use when a .pptx, .docx or .pdf is attached, or branded output is wanted from a brief.
+name: wand-design
+description: Rebrand or create Wand material on the current or the new brand - decks, documents, one-pagers, case studies, social cards. Use when a .pptx, .docx or .pdf is attached, or branded work is wanted.
 compatibility: Requires Node.js 18+, code execution enabled in claude.ai (Settings > Features), and a Chromium the kit can find (Playwright's cache or the system). No network needed once installed. Python 3 embeds fonts in the .pptx; without it the deck ships with the faces named, not embedded.
 license: Proprietary - Wand AI
 metadata:
-  version: "0.1.0"
+  version: "0.2.0"
 ---
 
 
-# Wand studio
+# Wand design
 
 ## First: find the kit and stand in it
 
 1. **Installed from npm** (the usual way): it is at `node_modules/wand-kit/`.
-   If it is not there yet: `npm install wand-kit@next --no-audit --no-fund`.
+   If it is not there yet: `npm install wand-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.
 
@@ -35,9 +35,15 @@ PDF, the PNGs, the PowerPoint and the one-file HTML are all read from it.
 `PROMPT.md` is the design system: read it once for design decisions, not per
 page. `node wand.js components` lists the vocabulary.
 
-Two brands: `current` (Geist, the default) and `next` (the website's; for
-internal testing until its font licence is settled). Use `next` only when the
-user says *new brand*, *new guidelines* or *website look*.
+## Which brand
+
+Two brands, one kit: `current` (Geist) and `next` (the website's). `doctor`
+ends with the brand rule: which one is the default, and the words that ask
+for the other. Follow it as printed. When the user names no brand, build on
+the default without asking; when their words ask for the other, pass
+`--brand` to `new`. One brand per piece, never a mix, and the review note
+says which. The rule lives in the kit, not here, so it can change without
+anyone reinstalling the skill.
 
 ## Read only what the job needs
 
@@ -57,8 +63,8 @@ user says *new brand*, *new guidelines* or *website look*.
    text runs in order, or use the decks kit's `tools/extract.py` if present.
 2. **Write the page list in the chat before any markup**: one line per page
    with the claim it carries and which source lines it takes. Then compose.
-3. `node wand.js new work/<name> --surface letter|slide --brand current`,
-   write `pages(c)` with `c.L(n)` for every string, declare every departure
+3. `node wand.js new work/<name> --surface letter|slide` (plus `--brand` only
+   when the brand rule says so), write `pages(c)` with `c.L(n)` for every string, declare every departure
    in `edits` (no em dashes: swap them for commas or semicolons there) and
    every line left out in `cut`.
 4. `node wand.js build work/<name>/job.mjs` until every hard gate is ok. Look
@@ -84,10 +90,21 @@ they are gone. Say in the note what was cut and what was generalised.
 `--surface square` or `og`; one `c.page()` per card; `out/pages/pNN.png` are
 the deliverables.
 
+### Older Wand work
+
+A deck or document made before this kit has no `job.mjs`. Treat it as a
+source and rebuild it (the first job above), on the brand the rule gives.
+One exception: a small edit (a date, a word, a figure) to a deck the old
+decks kit built, where they want the file otherwise untouched. For that edit
+only, `npm install wand-decks-kit@0.11.0 --no-audit --no-fund` and follow
+that kit's SKILL.md on editing (`node wand.js show`, then `edit --set`).
+An older copy of this skill may describe that kit, a routing table between
+two kits, or `edit --set`; none of it applies to anything else.
+
 ## The review note, always
 
-What was changed from the source and why (every edit, every cut); the gate
-table as printed; what a human still has to decide (a figure to confirm, a
+Which brand it is on; what was changed from the source and why (every edit,
+every cut); the gate table as printed; what a human still has to decide (a figure to confirm, a
 quote to clear, a claim legal should see). A file delivered without the gate
 table has been checked by nobody.
 

package/START-HERE.md

@@ -2,7 +2,7 @@
 
 ```bash
 node wand.js doctor                                   # what works here; chromium must name a binary
-node wand.js new work/acme --surface letter --brand current
+node wand.js new work/acme --surface letter            # the default brand; doctor prints the rule
 #   write work/acme/job.mjs (pages(c)) and, for a rebuild, work/acme/content.txt
 node wand.js build work/acme/job.mjs                  # gates, PDF, a PNG per page, out/sheet.png
 node wand.js ship  work/acme/job.mjs --pptx           # + one-file HTML, PowerPoint

package/examples/gallery/job.mjs

@@ -4,7 +4,9 @@
  * It is the regression for the component library: a change to components.js
  * or to a brand's tokens is reviewed here once, on one sheet, before any job.
  */
-const brand = process.env.WAND_GALLERY_BRAND || "current";
+import { DEFAULT_BRAND } from "../../lib/brand.js";
+
+const brand = process.env.WAND_GALLERY_BRAND || DEFAULT_BRAND;
 
 export default {
   name: `Gallery ${brand}`,

package/lib/brand.js

@@ -26,6 +26,26 @@ const KIT = path.join(path.dirname(fileURLToPath(import.meta.url)), "..");
 const REPO_DIRS = { current: "brand", next: "brand-next" };
 export const BRANDS = Object.keys(REPO_DIRS);
 
+// The brand a job gets when the user names none. While the two brands overlap
+// this is the only switch: set it to "next" and publish, and every chat builds
+// on the website's brand unless the user asks for the current one. The skill
+// never states the default; `doctor` prints it from here.
+export const DEFAULT_BRAND = "current";
+
+// What a user says when they want each brand, so the rule reads the same
+// whichever way the default points.
+export const ASKED_AS = {
+  current: ["current brand", "old brand", "existing guidelines", "Geist"],
+  next: ["new brand", "new branding", "new brand guidelines", "the website's look"],
+};
+
+/** The default and the words that switch away from it, as one line. */
+export function brandRule() {
+  const other = BRANDS.find((b) => b !== DEFAULT_BRAND);
+  const words = ASKED_AS[other].map((w) => `"${w}"`);
+  return `${DEFAULT_BRAND} by default; ${other} only when the user asks for ${words.slice(0, -1).join(", ")} or ${words.at(-1)}`;
+}
+
 /** Absolute path of a brand directory, or an error naming every place looked. */
 export function brandDir(name) {
   if (!REPO_DIRS[name]) throw new Error(`unknown brand "${name}" — one of ${BRANDS.join(", ")}`);

package/lib/engine.js

@@ -17,7 +17,7 @@ import path from "node:path";
 import { pathToFileURL, fileURLToPath } from "node:url";
 import { createRequire } from "node:module";
 import { execFileSync, spawnSync } from "node:child_process";
-import { loadBrand } from "./brand.js";
+import { loadBrand, DEFAULT_BRAND } from "./brand.js";
 import { surface as surfaceOf, surfaceCss } from "./surfaces.js";
 import { bind, COMPONENTS_CSS } from "./components.js";
 import { loadContent, coverage } from "./content.js";
@@ -179,7 +179,7 @@ function GATES({ min, chars, tokens, families, base }) {
 export async function build(jobPath, { outputs: wantOutputs = true, outDir = null, quiet = false } = {}) {
   const t0 = Date.now();
   const { job, file, dir } = await loadJob(jobPath);
-  const brand = loadBrand(job.brand || "current", job.theme || null);
+  const brand = loadBrand(job.brand || DEFAULT_BRAND, job.theme || null);
   const surface = surfaceOf(job.surface || "letter");
   const content = loadContent(dir, job);
   const c = bind({ brand, surface, job, content });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wand-kit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "One HTML design surface for every sales and marketing material, on either Wand brand: decks, documents, one-pagers, case studies, social cards. Every export (PDF, PNG, PowerPoint, one-file HTML) is read from the page that was reviewed.",
   "license": "SEE LICENSE IN PROMPT.md",
   "bin": {

package/wand.js

@@ -2,9 +2,10 @@
 /**
  * wand.js — the studio's front door.
  *
- *   node wand.js doctor                               what works here
- *   node wand.js new <dir> [--surface letter] [--brand current] [--name "Title"]
- *                                                     a job folder to compose in
+ *   node wand.js doctor                               what works here, and the brand rule
+ *   node wand.js new <dir> [--surface letter] [--brand current|next] [--name "Title"]
+ *                                                     a job folder to compose in, on the default brand
+ *                                                     unless --brand names the other
  *   node wand.js build <job.mjs>                      gates, then the PDF, a PNG per page, the sheet
  *   node wand.js check <job.mjs>                      gates only
  *   node wand.js ship  <job.mjs> [--pptx] [--no-html] everything: build, one-file HTML, PowerPoint
@@ -21,6 +22,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { createRequire } from "node:module";
 import { execFileSync, spawnSync } from "node:child_process";
+import { BRANDS, DEFAULT_BRAND, ASKED_AS, brandRule } from "./lib/brand.js";
 
 const require = createRequire(import.meta.url);
 const KIT = path.dirname(fileURLToPath(import.meta.url));
@@ -33,7 +35,7 @@ const rel = (p) => path.relative(process.cwd(), p) || ".";
 
 async function doctor() {
   const { findChrome, has } = await import("./lib/engine.js");
-  const { BRANDS, loadBrand } = await import("./lib/brand.js");
+  const { loadBrand } = await import("./lib/brand.js");
   const rows = [];
   rows.push(["node", process.version, +process.version.slice(1).split(".")[0] >= 18 ? "ok" : "MISSING - Node 18 or newer"]);
   for (const d of ["playwright-core", "pptxgenjs", "jszip", "fontkit"]) { let s = "ok"; try { require.resolve(d); } catch { s = `MISSING - npm install in ${rel(KIT)}`; } rows.push([d, s === "ok" ? "bundled" : "-", s]); }
@@ -47,13 +49,15 @@ async function doctor() {
   console.log("");
   for (const [k, v, s] of rows) console.log(`${s === "ok" ? "  " : "! "}${k.padEnd(w)}  ${String(v).padEnd(36)}${s === "ok" ? "" : s}`);
   const blocked = rows.some((r) => r[2].startsWith("MISSING") || r[2].startsWith("no renderer"));
+  console.log(`\n  brand rule  ${brandRule()}`);
   console.log(blocked ? "\nBLOCKED - fix the rows marked !\n" : "\nready - node wand.js new <dir>, then build <dir>/job.mjs\n");
   return blocked ? 1 : 0;
 }
 
 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 surface = flag("--surface", "letter"), brand = flag("--brand", "current"), name = flag("--name", path.basename(dir));
+  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", `${["slide", "square", "og"].includes(surface) ? (surface === "slide" ? "slide" : "card") : "page"}.mjs`);
   if (!fs.existsSync(tpl)) die(`no template for surface "${surface}"`);
   if (fs.existsSync(path.join(dir, "job.mjs"))) die(`${dir}/job.mjs already exists`);
@@ -120,7 +124,7 @@ async function watch(jobPath) {
 }
 
 async function gallery() {
-  const brand = flag("--brand", "current");
+  const brand = flag("--brand", DEFAULT_BRAND);
   const { build, closeBrowser } = await import("./lib/engine.js");
   process.env.WAND_GALLERY_BRAND = brand;
   const r = await build(path.join(KIT, "examples", "gallery", "job.mjs"), {});
@@ -148,9 +152,9 @@ async function components() {
 }
 
 async function brands() {
-  const { BRANDS, loadBrand } = await import("./lib/brand.js");
-  for (const b of BRANDS) { const br = loadBrand(b); console.log(`\n  ${b.padEnd(8)} ${br.title}\n  ${"".padEnd(8)} ${rel(br.dir)} · faces: ${br.families.join(", ")} · ${br.faceFiles.length} files · ${Object.keys(br.tokens.art).length} art roles`); }
-  console.log("");
+  const { loadBrand } = await import("./lib/brand.js");
+  for (const b of BRANDS) { const br = loadBrand(b); console.log(`\n  ${b.padEnd(8)} ${br.title}${b === DEFAULT_BRAND ? "  (default)" : ""}\n  ${"".padEnd(8)} ${rel(br.dir)} · faces: ${br.families.join(", ")} · ${br.faceFiles.length} files · ${Object.keys(br.tokens.art).length} art roles\n  ${"".padEnd(8)} asked for as: ${ASKED_AS[b].join(", ")}`); }
+  console.log(`\n  rule: ${brandRule()}\n`);
 }
 
 try {