@generativereality/content-studio 0.0.0-stage → 0.1.1

package/skills/content-studio/scripts/render-frames.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+# Render HTML frames to PNG with headless Chrome/Chromium (references/stills.md, recipe A).
+# Usage: render-frames.sh OUT_DIR WIDTH HEIGHT frame.html [frame.html...]
+# Output: OUT_DIR/<frame-basename>.png at WIDTH x HEIGHT CSS px (SCALE=2 for 2x pixels).
+set -euo pipefail
+[ $# -ge 4 ] || { echo "usage: $0 OUT_DIR WIDTH HEIGHT frame.html..." >&2; exit 2; }
+OUT=$1; W=$2; H=$3; shift 3
+mkdir -p "$OUT"
+CHROME=${CHROME:-}
+if [ -z "$CHROME" ]; then
+  for c in "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
+           "/Applications/Chromium.app/Contents/MacOS/Chromium" \
+           "/c/Program Files/Google/Chrome/Application/chrome.exe" \
+           "/c/Program Files (x86)/Google/Chrome/Application/chrome.exe" \
+           "$(command -v google-chrome 2>/dev/null || true)" \
+           "$(command -v chromium 2>/dev/null || true)" \
+           "$(command -v chromium-browser 2>/dev/null || true)"; do
+    if [ -n "$c" ] && [ -x "$c" ]; then CHROME=$c; break; fi
+  done
+fi
+[ -n "$CHROME" ] || { echo "no Chrome/Chromium found; set CHROME=/path/to/chrome" >&2; exit 1; }
+for f in "$@"; do
+  abs=$(cd "$(dirname "$f")" && pwd)/$(basename "$f")
+  png="$OUT/$(basename "${f%.*}").png"
+  "$CHROME" --headless=new --disable-gpu --hide-scrollbars --no-first-run --no-default-browser-check \
+    --force-device-scale-factor="${SCALE:-1}" --window-size="$W,$H" \
+    --virtual-time-budget=3000 --screenshot="$png" "file://$abs" >/dev/null 2>&1 || true
+  if [ -s "$png" ]; then echo "$png"; else echo "failed: $f" >&2; exit 1; fi
+done
+echo "Now open every PNG and look for collisions, crops and contrast before calling it done." >&2

package/skills/content-studio/scripts/spend.mjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+// Per-piece spend ledger (references/costs-and-licences.md). No dependencies.
+//   node spend.mjs add <dir> --model M --usd 0.05 [--seconds 23] [--out file] [--note "..."] [--local]
+//   node spend.mjs total <dir> [--budget 5]      exit 3 when over budget
+import { appendFileSync, existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const [cmd, dir, ...rest] = process.argv.slice(2);
+const opt = {};
+for (let i = 0; i < rest.length; i++) {
+  const k = rest[i].replace(/^--/, '');
+  if (rest[i + 1] !== undefined && !rest[i + 1].startsWith('--')) opt[k] = rest[++i];
+  else opt[k] = true;
+}
+if (!cmd || !dir) { console.error('usage: spend.mjs add|total <dir> [...]'); process.exit(2); }
+const file = join(dir, 'spend.jsonl');
+
+if (cmd === 'add') {
+  if (!opt.model || opt.usd === undefined) { console.error('add needs --model and --usd'); process.exit(2); }
+  const row = {
+    at: new Date().toISOString(), model: opt.model, usd: Number(opt.usd),
+    seconds: opt.seconds ? Number(opt.seconds) : null, out: opt.out || null,
+    note: opt.note || null, local: !!opt.local,
+  };
+  if (Number.isNaN(row.usd)) { console.error('--usd must be a number'); process.exit(2); }
+  appendFileSync(file, JSON.stringify(row) + '\n');
+  console.log(JSON.stringify(row));
+} else if (cmd === 'total') {
+  const rows = existsSync(file)
+    ? readFileSync(file, 'utf8').split('\n').filter(Boolean).map((l) => JSON.parse(l)) : [];
+  const by = {}; let usd = 0; let secs = 0;
+  for (const r of rows) {
+    usd += r.usd; secs += r.seconds || 0;
+    by[r.model] ??= { calls: 0, usd: 0 };
+    by[r.model].calls++; by[r.model].usd += r.usd;
+  }
+  for (const [m, v] of Object.entries(by)) console.log(`${m}\t${v.calls} calls\t$${v.usd.toFixed(3)}`);
+  console.log(`TOTAL\t${rows.length} calls\t$${usd.toFixed(3)}\t${Math.round(secs)} s`);
+  if (opt.budget !== undefined) {
+    const b = Number(opt.budget);
+    if (usd > b) { console.log(`OVER BUDGET by $${(usd - b).toFixed(3)}: stop and say so`); process.exit(3); }
+    console.log(`within budget ($${(b - usd).toFixed(3)} left)`);
+  }
+} else { console.error(`unknown command ${cmd}`); process.exit(2); }

package/skills/content-studio/scripts/voice-sweep.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# Mechanical sweep for machine-prose tells (references/voice.md §3-4).
+# A candidate list, not a verdict: read every hit, then read the text aloud.
+# Usage: voice-sweep.sh FILE [FILE...]
+set -u
+for F in "$@"; do
+  [ -f "$F" ] || { echo "no such file: $F" >&2; continue; }
+  # Strip YAML frontmatter, fenced code, HTML comments and markdown quote markers.
+  TXT=$(awk 'NR==1&&/^---$/{fm=1;next} fm&&/^---$/{fm=0;next} fm{next}
+       /^```/{code=!code;next} code{next}
+       /<!--/{c=1} !c{print} /-->/{c=0}' "$F" | sed 's/^[[:space:]]*>[[:space:]]*//')
+  # In code files, drop comment lines too, or a dash in a JSDoc counts as one in the copy.
+  case "$F" in *.svelte|*.ts|*.tsx|*.js|*.jsx|*.mjs) TXT=$(printf '%s\n' "$TXT" | grep -vE '^[[:space:]]*(\*|/\*|\*/|//)');; esac
+  t() { printf '%s\n' "$TXT"; }
+  paras=$(t | awk 'BEGIN{RS="";n=0}{n++}END{print n}')
+  dashes=$(t | grep -oE '—|&mdash;' | wc -l | tr -d ' ')
+  echo "== $F"
+  echo "paragraphs: $paras · em dashes: $dashes  (about one per paragraph is the tell)"
+  echo "-- banned words and phrases"
+  t | grep -noiE "\b(delve|tapestry|testament|pivotal|vibrant|boasts?|foster|landscape|intricate|meticulous|showcase|garner|seamless(ly)?|unlock|supercharge|game.changer|underscore|honest(ly)?|serves as|functions as|in today's|the reality is|fast-paced)\b" | head -40
+  echo "-- meta-narration and negative parallelism"
+  t | grep -noiE "(here'?s (the|what|why|how)|here (is|are) (the|what|why|how)|the part (that|nobody)|let me (explain|close)|that'?s not (what|how|why|the)|\. not [a-z]+[.,]|it'?s not (about )?[a-z]+[,.] it'?s|, not [a-z]+[.,]|, not (from|about|for|because|just|only|what|the|a|an) |not just [a-z]+ but|(isn'?t|wasn'?t) [a-z]+[^.]{0,40}\. (it'?s|it was))" | head -40
+  t | grep -noiE "(is|was|are|were) not [^.]{1,50}\. (It|That|They) (is|was|are|were) " | head -20
+  echo "-- short fragments (candidates: brand names with dots are false positives)"
+  t | grep -oE "(^|[.!?]\"?[[:space:]]+)[A-Z][A-Za-z'-]{0,11}[.!?]" | sed 's/^[.!?"]*[[:space:]]*//' | sort | uniq -c | sort -rn | head -20
+  echo "-- drumbeat lines (2+ adjacent hits = three parallel sentences)"
+  t | grep -nE "^(The|An|A|Your|It|We|You) [a-z]+ [a-z]+ .{0,70}\.$" | head -10
+  echo "-- one-line paragraphs"
+  t | awk 'BEGIN{RS=""}{n=split($0,l,"\n"); if(n==1 && length($0)<60 && $0 !~ /^#|^[-*|]/) print "  " $0}' | head -15
+done
+echo "Now read it aloud as the person would say it. The sweep is a net with holes."