@waits/cadence 0.5.0 → 0.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waits/cadence",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "type": "module",
   "license": "MIT",
   "bin": {

package/prompts/art/compose.ts

@@ -7,21 +7,30 @@ import { FANTASY, type FantasyLevel } from "./fantasy";
  * Build the full image-gen prompt for a freeform subject × fantasy level × format.
  * `style`/`negatives` default to the built-in luminist look; a pack or `--style-file`
  * can override them. `COMPOSITION` (UI-safe framing) is always engine-supplied.
+ * `brand` (from `--brand`, a project's theme palette) appends a last, explicit
+ * palette nudge so it dominates any color the base style mentions.
  */
 export function composePrompt(opts: {
   subject: string;
   level: FantasyLevel;
-  format: Format;
   style?: string;
   negatives?: string;
+  format: Format;
+  brand?: { accent?: string; paper?: string };
 }): string {
+  const brand = opts.brand?.accent
+    ? `Tune the palette toward the brand: a ${opts.brand.accent} accent${opts.brand.paper ? ` over ${opts.brand.paper}-toned light` : ""} — cohesive and harmonious, never garish.`
+    : "";
   return [
     opts.style ?? STYLE,
     `Subject: ${opts.subject}.`,
     FANTASY[opts.level],
     COMPOSITION[opts.format],
+    brand,
     opts.negatives ?? NEGATIVES,
-  ].join(" ");
+  ]
+    .filter(Boolean)
+    .join(" ");
 }
 
 export { LANDMARKS, FANTASY };

package/scripts/generate-art.ts

@@ -18,7 +18,7 @@ import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "
 import { join } from "node:path";
 import { composePrompt, LANDMARKS, type FantasyLevel } from "../prompts/art/compose";
 import type { Format } from "../src/schema/beats";
-import { findCadenceDir } from "./_theme";
+import { discoverProjectTheme, findCadenceDir } from "./_theme";
 
 const SIZE: Record<Format, string> = { "16x9": "1536x1024", "1x1": "1024x1024", "9x16": "1024x1536" };
 
@@ -79,6 +79,19 @@ const styleFile = flag("--style-file");
 const style = styleFile ? readFileSync(styleFile, "utf8") : pack.style;
 const negatives = pack.negatives;
 
+// --brand: tint generated art toward the project's theme palette (accent + paper).
+let brand: { accent?: string; paper?: string } | undefined;
+if (has("--brand")) {
+  const tf = discoverProjectTheme(process.cwd());
+  if (tf) {
+    const colors = (JSON.parse(readFileSync(tf, "utf8")).colors ?? {}) as Record<string, string>;
+    brand = { accent: colors.signalBlue, paper: colors.paper };
+    console.error(`· --brand: ${tf} (accent ${brand.accent ?? "—"})`);
+  } else {
+    console.error("· --brand: no .cadence/theme.json found — generating unbranded");
+  }
+}
+
 // A job = one image to generate. Freeform `--prompt` (needs `--name`) wins;
 // otherwise pull subjects from the pack via --landmark/--all.
 type Job = { subject: string; slug: string; label: string };
@@ -117,7 +130,7 @@ if (!process.env.OPENAI_API_KEY) {
 }
 
 async function generate(job: Job) {
-  const prompt = composePrompt({ subject: job.subject, level, format, style, negatives });
+  const prompt = composePrompt({ subject: job.subject, level, format, style, negatives, brand });
   const fname = `${job.slug}-${level}-${format}.png`;
   process.stdout.write(`· ${fname} … `);
   const res = await fetch("https://api.openai.com/v1/images/generations", {

package/scripts/theme.ts

@@ -12,7 +12,7 @@
  * the palette and writes a themes/<name>.json. See the cadence skill.
  */
 import { mkdirSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { deriveTheme } from "../src/theme/derive";
 
 const args = process.argv.slice(2);
@@ -61,8 +61,8 @@ if (!accent) {
 const name = flag("--name") ?? "brand";
 const theme = deriveTheme({ name, accent, ink: flag("--ink"), paper: flag("--paper"), gold: flag("--gold") });
 
-mkdirSync("themes", { recursive: true });
 const out = flag("--out") ?? join("themes", `${name}.json`);
+mkdirSync(dirname(out), { recursive: true });
 writeFileSync(out, JSON.stringify(theme, null, 2));
 
 // Portable design summary — a human-readable companion to the JSON.