memento-mori-jester 0.1.78 → 0.1.80

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to Memento Mori Jester are tracked here.
 
 ## Unreleased
 
+## 0.1.80
+
+- Added a deterministic `promo/share-kit/social-card.svg` for GitHub, X, and project-update link previews.
+- Added `npm run promo:card` and `npm run promo:card:check` to regenerate or verify the social card.
+- Extended promo freshness checks and docs so the social card stays part of the maintainer release flow.
+
+## 0.1.79
+
+- Added `npm run promo:check` to verify the current repo-local promo video, stills, docs, and fixture evidence numbers stay aligned.
+- Wired promo freshness validation into `npm test` and the production-readiness guard.
+- Updated release, readiness, roadmap, and promo docs with the new maintainer check.
+
 ## 0.1.78
 
 - Added a refreshed HyperFrames X demo render under `promo/x-demo-v0.1.78` with current version and fixture-evidence numbers.

package/README.md

@@ -503,6 +503,8 @@ Use the false-positive template for noisy cautions or blocks. Include `jester su
 Maintainers can use [docs/MAINTAINER_TRIAGE.md](docs/MAINTAINER_TRIAGE.md) to turn useful false-positive reports into redacted fixtures.
 Run `npm run fixtures:check` before merging fixture changes; it catches duplicate IDs, missing rule metadata, weak descriptions, unsafe-looking content, and duplicate content.
 Run `npm run fixtures:report` to see fixture coverage by rule, rule family, preset slice, kind, verdict, quiet-pass boundaries, feasible pass-case gaps, and curation-next guidance before choosing the next fixture. Use `npm run fixtures:report -- --markdown` when you want a paste-ready summary for release notes or GitHub issues.
+Run `npm run promo:card` to regenerate the repo-local social preview card after changing its copy or design.
+Run `npm run promo:check` after editing promo assets; it checks the current demo video, stills, docs, and fixture evidence numbers stay in sync.
 
 For vulnerabilities, private code exposure, or credential-handling concerns, follow [SECURITY.md](SECURITY.md) instead of opening a public issue with sensitive details.
 
@@ -512,6 +514,7 @@ Release checklist:
 
 ```powershell
 npm.cmd test
+npm.cmd run promo:check
 npm.cmd run production:check
 npm.cmd run pack:dry
 git tag -a v0.1.x -m "Memento Mori Jester v0.1.x"

package/ROADMAP.md

@@ -6,6 +6,8 @@ Memento Mori Jester is usable today as a CLI, MCP server, GitHub Action, and git
 
 ## Recently Shipped
 
+- Social preview card in v0.1.80, adding a deterministic 1200x630 promo card plus generation and freshness checks.
+- Promo freshness check in v0.1.79, verifying the current demo video, share-kit stills, docs, and fixture evidence numbers before public posting.
 - Fresh demo render in v0.1.78, updating the repo-local X video and share-kit stills to current version and fixture totals.
 - Promo/share kit in v0.1.77, adding X post copy, a short demo script, a posting checklist, and still images from the existing demo video.
 - Real-world preset quiet-pass curation in v0.1.76, adding eight safe examples across python, security, web, and AI workflows while keeping fixture coverage gaps clean.
@@ -69,7 +71,7 @@ Memento Mori Jester is usable today as a CLI, MCP server, GitHub Action, and git
 
 - Collect real-world reports for the next lowest-count preset slices now highlighted by `fixtures:report`.
 - Add more framework-specific false-positive examples from real reports so tuning guidance keeps getting sharper.
-- Add a small promo freshness check so future demo copy does not drift from package version or fixture totals.
+- Add a small web landing page that reuses the existing demo, social card, and start command.
 
 ## Quality And Safety
 

package/docs/PRODUCTION_READINESS.md

@@ -9,6 +9,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
 - GitHub Releases and npm publishing are automated from annotated `v*` tags through GitHub Actions trusted publishing.
 - CI runs tests and a package dry run on every push to `main` and pull request.
 - The local playground, GitHub Action, MCP setup snippets, preset examples, fixtures, and release notes ship in the npm package.
+- Repo-local promo assets stay outside the npm package, but `npm run promo:check` keeps the current demo video, stills, social card, docs, and fixture evidence numbers aligned.
 
 ## npm Package
 
@@ -54,6 +55,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
 - `docs/MAINTAINER_TRIAGE.md` explains how to turn useful false-positive reports into fixture coverage before changing rule logic.
 - `npm run fixtures:check` validates fixture IDs, metadata, unsafe-looking content, duplicate content, and explicit expected/absent rule intent.
 - `npm run fixtures:report` shows fixture coverage by rule, rule family, preset slice, kind, verdict, quiet-pass rule boundaries, and feasible pass-case gaps so maintainers can pick the next fixture target; `npm run fixtures:report -- --markdown` produces a paste-ready maintainer snapshot.
+- `npm run promo:card` regenerates the deterministic social preview card, and `npm run promo:check` verifies current repo-local promo assets against the current fixture evidence before maintainers post or refresh the demo.
 - npm publish has a manual workflow fallback, but the normal release path is tag-driven trusted publishing.
 
 ## Static Guard
@@ -69,6 +71,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
 - maintainer triage docs exist and link noisy-rule reports back to fixture coverage.
 - fixture authoring checks are wired into `npm test`.
 - fixture coverage reports are wired into `npm test`.
+- promo freshness checks are wired into `npm test`.
 
 `npm test` runs this check after the TypeScript build and unit tests.
 

package/docs/RELEASE.md

@@ -12,6 +12,8 @@ npm.cmd run fixtures:check
 npm.cmd run fixtures:report
 npm.cmd run fixtures:report -- --json
 npm.cmd run fixtures:report -- --markdown
+npm.cmd run promo:card:check
+npm.cmd run promo:check
 npm.cmd run pack:dry
 git diff --check
 ```

package/docs/RELEASE_NOTES_v0.1.79.md

@@ -0,0 +1,47 @@
+# Memento Mori Jester v0.1.79
+
+## Summary
+
+This release adds a repo-local promo freshness check so maintainers can verify the current demo video, stills, docs, and fixture evidence numbers before posting or refreshing public assets.
+
+## What Changed
+
+- Added `scripts/check-promo-freshness.mjs`.
+- Added `npm run promo:check`.
+- Wired `promo:check` into `npm test`.
+- Updated production-readiness checks so the promo freshness guard cannot silently disappear.
+- Updated README, release docs, production-readiness docs, promo docs, roadmap, changelog, and release notes.
+
+## Public Interface
+
+- No CLI command changes.
+- No MCP tool changes.
+- No config schema changes.
+- No review rule, scoring, or verdict behavior changes.
+- No GitHub Action behavior changes.
+- `promo/` remains outside the npm package `files` list.
+
+## Release Validation
+
+```powershell
+npm.cmd test
+npm.cmd run demo:svg:check
+npm.cmd run promo:check
+npm.cmd run pack:dry
+git diff --check
+git diff | node .\dist\cli.js diff --fail-on block --subject "v0.1.79 promo freshness check"
+```
+
+For a future same-version promo refresh, maintainers can run:
+
+```powershell
+npm.cmd run promo:check -- --require-package-version
+```
+
+This release does not require that strict mode because the current public demo snapshot remains `x-demo-v0.1.78`.
+
+Expected:
+
+- default `promo:check` passes for the current published demo snapshot,
+- `--require-package-version` is available for intentional same-version promo refreshes,
+- GitHub Release and npm Publish complete from the `v0.1.79` tag.

package/docs/RELEASE_NOTES_v0.1.80.md

@@ -0,0 +1,40 @@
+# Memento Mori Jester v0.1.80
+
+## Summary
+
+This release adds a deterministic social preview card for GitHub, X, and project-update links. It keeps the promo work local and reviewable while making shared links look intentional.
+
+## What Changed
+
+- Added `promo/share-kit/social-card.svg`.
+- Added `scripts/render-social-card.mjs`.
+- Added `npm run promo:card` and `npm run promo:card:check`.
+- Extended `npm run promo:check` to verify the social card exists, has 1200x630 dimensions, includes the product name, and includes the `npx` start command.
+- Updated promo docs, release docs, production-readiness docs, roadmap, changelog, and release notes.
+
+## Public Interface
+
+- No CLI command changes.
+- No MCP tool changes.
+- No config schema changes.
+- No review rule, scoring, or verdict behavior changes.
+- No GitHub Action behavior changes.
+- `promo/` remains outside the npm package `files` list.
+
+## Release Validation
+
+```powershell
+npm.cmd test
+npm.cmd run demo:svg:check
+npm.cmd run promo:card:check
+npm.cmd run promo:check
+npm.cmd run pack:dry
+git diff --check
+git diff | node .\dist\cli.js diff --fail-on block --subject "v0.1.80 social preview card"
+```
+
+Expected:
+
+- `promo/share-kit/social-card.svg` is deterministic and current,
+- default `promo:check` includes social-card validation,
+- GitHub Release and npm Publish complete from the `v0.1.80` tag.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mori-jester",
-  "version": "0.1.78",
+  "version": "0.1.80",
   "description": "A local court-jester sidecar for AI coding agents: review plans, commands, diffs, and final claims before they get too pleased with themselves.",
   "type": "module",
   "repository": {
@@ -40,12 +40,15 @@
     "build": "tsc -p tsconfig.json",
     "start": "node dist/server.js",
     "start:mcp": "node dist/server.js",
-    "test": "npm run build && node scripts/run-tests.mjs && npm run fixtures:check && npm run fixtures:report && npm run production:check",
+    "test": "npm run build && node scripts/run-tests.mjs && npm run fixtures:check && npm run fixtures:report && npm run promo:check && npm run production:check",
     "doctor": "node dist/cli.js doctor",
     "demo:svg": "node scripts/render-demo-svg.mjs",
     "demo:svg:check": "node scripts/render-demo-svg.mjs --check",
     "fixtures:check": "node scripts/check-fixtures.mjs",
     "fixtures:report": "node scripts/report-fixtures.mjs",
+    "promo:card": "node scripts/render-social-card.mjs",
+    "promo:card:check": "node scripts/render-social-card.mjs --check",
+    "promo:check": "node scripts/check-promo-freshness.mjs",
     "production:check": "node scripts/check-production-readiness.mjs",
     "pack:dry": "npm pack --dry-run",
     "prepare": "npm run build",

package/scripts/check-production-readiness.mjs

@@ -64,6 +64,8 @@ for (const path of [
   "docs/MAINTAINER_TRIAGE.md",
   `docs/RELEASE_NOTES_${tag}.md`,
   "action.yml",
+  "scripts/check-promo-freshness.mjs",
+  "scripts/render-social-card.mjs",
   "scripts/check-fixtures.mjs",
   "scripts/report-fixtures.mjs",
   ".github/ISSUE_TEMPLATE/bug_report.yml",
@@ -132,8 +134,14 @@ requireText("scripts/report-fixtures.mjs", /--markdown/, "Markdown fixture repor
 forbidText("scripts/report-fixtures.mjs", /src\/config\.ts|src\/types\.ts/, "source-only fixture report dependencies");
 requireText("package.json", /"fixtures:check": "node scripts\/check-fixtures\.mjs"/, "fixture authoring check script");
 requireText("package.json", /"fixtures:report": "node scripts\/report-fixtures\.mjs"/, "fixture coverage report script");
+requireText("package.json", /"promo:card": "node scripts\/render-social-card\.mjs"/, "social card render script");
+requireText("package.json", /"promo:card:check": "node scripts\/render-social-card\.mjs --check"/, "social card stale check script");
+requireText("package.json", /"promo:check": "node scripts\/check-promo-freshness\.mjs"/, "promo freshness check script");
 requireText("package.json", /npm run fixtures:check/, "fixture authoring check in npm test");
 requireText("package.json", /npm run fixtures:report/, "fixture coverage report in npm test");
+requireText("package.json", /npm run promo:check/, "promo freshness check in npm test");
+requireText("scripts/check-promo-freshness.mjs", /--require-package-version/, "optional strict package-version promo check");
+requireText("scripts/check-promo-freshness.mjs", /social-card\.svg/, "social-card freshness check");
 requireText("SECURITY.md", /doctor --json/, "doctor JSON redaction guidance");
 requireText("SECURITY.md", /security\/advisories\/new/, "private vulnerability report link");
 requireText(".github/ISSUE_TEMPLATE/bug_report.yml", /doctor --json/, "doctor JSON support prompt");

package/scripts/check-promo-freshness.mjs

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+
+const root = process.cwd();
+const failures = [];
+const args = new Set(process.argv.slice(2));
+const requirePackageVersion = args.has("--require-package-version");
+
+for (const arg of args) {
+  if (arg !== "--require-package-version") {
+    failures.push(`Unknown option: ${arg}`);
+  }
+}
+
+function read(path) {
+  return readFileSync(join(root, path), "utf8");
+}
+
+function readJson(path) {
+  return JSON.parse(read(path));
+}
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function requireFile(path, description, minBytes = 1) {
+  const fullPath = join(root, path);
+  if (!existsSync(fullPath)) {
+    failures.push(`${description} is missing: ${path}`);
+    return;
+  }
+  const size = statSync(fullPath).size;
+  if (size < minBytes) {
+    failures.push(`${description} looks too small: ${path} (${size} bytes).`);
+  }
+}
+
+function requireText(path, pattern, description) {
+  const content = read(path);
+  if (!pattern.test(content)) {
+    failures.push(`${path} should include ${description}.`);
+  }
+}
+
+function failJson(path, error) {
+  failures.push(`${path} could not be parsed: ${error instanceof Error ? error.message : String(error)}.`);
+}
+
+function loadRiskyDomainEvidence() {
+  const cliPath = join(root, "dist", "cli.js");
+  if (!existsSync(cliPath)) {
+    failures.push("dist/cli.js is missing; run `npm run build` before `npm run promo:check`.");
+    return null;
+  }
+
+  const result = spawnSync(
+    process.execPath,
+    [cliPath, "tune", "risky-domain", "--json", "--no-config"],
+    { cwd: root, encoding: "utf8" }
+  );
+
+  if (result.status !== 0) {
+    failures.push(`Could not load risky-domain fixture evidence: ${result.stderr || result.stdout}`.trim());
+    return null;
+  }
+
+  try {
+    const parsed = JSON.parse(result.stdout);
+    return parsed.fixtureEvidence ?? null;
+  } catch (error) {
+    failures.push(`Could not parse risky-domain fixture evidence JSON: ${error instanceof Error ? error.message : String(error)}.`);
+    return null;
+  }
+}
+
+let packageJson;
+try {
+  packageJson = readJson("package.json");
+} catch (error) {
+  failJson("package.json", error);
+  packageJson = {};
+}
+
+let fixtures;
+try {
+  fixtures = readJson("examples/fixtures/preset-review-cases.json");
+} catch (error) {
+  failJson("examples/fixtures/preset-review-cases.json", error);
+  fixtures = [];
+}
+
+const promoReadmePath = "promo/README.md";
+const promoReadme = read(promoReadmePath);
+const currentVideo = promoReadme.match(/Final vertical demo video:\s*\[([^\]]+)\]\(([^)]+)\)/);
+
+if (!currentVideo) {
+  failures.push(`${promoReadmePath} should link the final vertical demo video.`);
+}
+
+const linkedLabel = currentVideo?.[1] ?? "";
+const linkedTarget = currentVideo?.[2] ?? "";
+if (linkedLabel && linkedTarget && linkedLabel !== linkedTarget) {
+  failures.push(`${promoReadmePath} video link label and target should match.`);
+}
+
+const videoMatch = linkedTarget.match(/^x-demo-v(\d+\.\d+\.\d+)\/renders\/memento-mori-jester-x-demo-v\1\.mp4$/);
+if (!videoMatch) {
+  failures.push(`${promoReadmePath} video should point at x-demo-vX.Y.Z/renders/memento-mori-jester-x-demo-vX.Y.Z.mp4.`);
+}
+
+const promoVersion = videoMatch?.[1] ?? "unknown";
+const demoId = `x-demo-v${promoVersion}`;
+const demoDir = `promo/${demoId}`;
+const demoVideoPath = linkedTarget ? `promo/${linkedTarget}` : "";
+const fixtureTotal = Array.isArray(fixtures) ? fixtures.length : 0;
+const riskyEvidence = loadRiskyDomainEvidence();
+const socialCardPath = "promo/share-kit/social-card.svg";
+
+if (requirePackageVersion && packageJson.version !== promoVersion) {
+  failures.push(`Current promo version v${promoVersion} should match package.json ${packageJson.version} when --require-package-version is used.`);
+}
+
+if (promoVersion !== "unknown") {
+  requireFile(`${demoDir}/index.html`, "current promo demo HTML");
+  requireFile(`${demoDir}/README.md`, "current promo demo README");
+  requireFile(`${demoDir}/package.json`, "current promo demo package.json");
+  requireFile(`${demoDir}/package-lock.json`, "current promo demo package-lock.json");
+  requireFile(`${demoDir}/meta.json`, "current promo demo metadata");
+  requireFile(demoVideoPath, "current promo demo video", 100_000);
+
+  for (const still of ["01-opener.jpg", "02-command-block.jpg", "03-tuning-evidence.jpg", "04-try-it.jpg"]) {
+    requireFile(`promo/share-kit/stills/${still}`, `share-kit still ${still}`, 50_000);
+  }
+  requireFile(socialCardPath, "social preview card", 2_000);
+  requireText(socialCardPath, /width="1200" height="630"/, "1200x630 social-card dimensions");
+  requireText(socialCardPath, /Memento Mori Jester/, "product name");
+  requireText(socialCardPath, /npx -y memento-mori-jester@latest start/, "start command");
+  requireText("promo/share-kit/README.md", /social-card\.svg/, "social-card asset row");
+
+  try {
+    const demoPackage = readJson(`${demoDir}/package.json`);
+    if (demoPackage.name !== demoId) {
+      failures.push(`${demoDir}/package.json name should be ${demoId}.`);
+    }
+  } catch (error) {
+    failJson(`${demoDir}/package.json`, error);
+  }
+
+  try {
+    const demoLock = readJson(`${demoDir}/package-lock.json`);
+    if (demoLock.name !== demoId || demoLock.packages?.[""]?.name !== demoId) {
+      failures.push(`${demoDir}/package-lock.json root name should be ${demoId}.`);
+    }
+  } catch (error) {
+    failJson(`${demoDir}/package-lock.json`, error);
+  }
+
+  try {
+    const demoMeta = readJson(`${demoDir}/meta.json`);
+    if (demoMeta.id !== demoId || demoMeta.name !== demoId) {
+      failures.push(`${demoDir}/meta.json id and name should be ${demoId}.`);
+    }
+  } catch (error) {
+    failJson(`${demoDir}/meta.json`, error);
+  }
+
+  const escapedVersion = escapeRegExp(promoVersion);
+  requireText(`${demoDir}/README.md`, new RegExp(`# Memento Mori Jester X Demo v${escapedVersion}`), `demo title v${promoVersion}`);
+  requireText(`${demoDir}/README.md`, new RegExp(`renders/memento-mori-jester-x-demo-v${escapedVersion}\\.mp4`), "current render path");
+  requireText(`${demoDir}/index.html`, new RegExp(`<span>v${escapedVersion}</span>`), `visible version v${promoVersion}`);
+  requireText(`${demoDir}/index.html`, new RegExp(`PASS package-version: ${escapedVersion}`), `doctor package version ${promoVersion}`);
+  requireText(`${demoDir}/index.html`, new RegExp(`<strong>${fixtureTotal}</strong>\\s*<span>fixtures checked</span>`), `${fixtureTotal} fixture count`);
+  requireText("promo/share-kit/README.md", new RegExp(escapeRegExp(`../${linkedTarget}`)), "current promo video path");
+
+  if (riskyEvidence) {
+    requireText(
+      `${demoDir}/index.html`,
+      new RegExp(`<strong>${riskyEvidence.matchCount}</strong>\\s*<span>risky-domain matches</span>`),
+      `${riskyEvidence.matchCount} risky-domain match count`
+    );
+    requireText(
+      `${demoDir}/index.html`,
+      new RegExp(`<strong>${riskyEvidence.quietPassCount}</strong>\\s*<span>quiet-pass examples</span>`),
+      `${riskyEvidence.quietPassCount} quiet-pass count`
+    );
+    requireText("docs/DEMO.md", new RegExp(`Total fixtures checked: ${riskyEvidence.totalFixtures}`), "current tune fixture total");
+    requireText("docs/DEMO.md", new RegExp(`Matching fixtures: ${riskyEvidence.matchCount}`), "current tune match count");
+    requireText("docs/DEMO.md", new RegExp(`Quiet-pass fixtures: ${riskyEvidence.quietPassCount}`), "current tune quiet-pass count");
+  }
+}
+
+if (failures.length > 0) {
+  process.stderr.write("Promo freshness check failed:\n");
+  for (const failure of failures) {
+    process.stderr.write(`- ${failure}\n`);
+  }
+  process.exit(1);
+}
+
+process.stdout.write(
+  `Promo freshness check passed for ${demoId}: ${fixtureTotal} fixtures, ` +
+    `${riskyEvidence?.matchCount ?? "unknown"} risky-domain matches, ` +
+    `${riskyEvidence?.quietPassCount ?? "unknown"} quiet-pass examples.\n`
+);

package/scripts/render-social-card.mjs

@@ -0,0 +1,105 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const targetPath = resolve(root, "promo/share-kit/social-card.svg");
+const mode = process.argv.includes("--check") ? "check" : "write";
+
+const width = 1200;
+const height = 630;
+
+const copy = {
+  title: "Memento Mori Jester",
+  eyebrow: "For AI agents with ambition",
+  headline: ["A local court jester", "for AI coding agents."],
+  detail: ["Reviews commands, plans, diffs, and final answers", "before the agent gets too pleased with itself."],
+  command: "npx -y memento-mori-jester@latest start",
+  footer: "Codex | Claude Code | MCP | hooks | CI"
+};
+
+function escapeXml(value) {
+  return value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll("\"", "&quot;");
+}
+
+function text(value) {
+  return escapeXml(value);
+}
+
+function renderSvg() {
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-labelledby="title desc">
+  <title id="title">${text(copy.title)} social preview card</title>
+  <desc id="desc">${text(copy.detail.join(" "))}</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="#11100e"/>
+      <stop offset="58%" stop-color="#171410"/>
+      <stop offset="100%" stop-color="#211b14"/>
+    </linearGradient>
+    <radialGradient id="heat" cx="78%" cy="16%" r="70%">
+      <stop offset="0%" stop-color="#d7a642" stop-opacity="0.36"/>
+      <stop offset="42%" stop-color="#d64b3f" stop-opacity="0.12"/>
+      <stop offset="100%" stop-color="#11100e" stop-opacity="0"/>
+    </radialGradient>
+    <filter id="soft-shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="24" stdDeviation="24" flood-color="#050403" flood-opacity="0.38"/>
+    </filter>
+  </defs>
+  <rect width="${width}" height="${height}" fill="url(#bg)"/>
+  <rect width="${width}" height="${height}" fill="url(#heat)"/>
+  <g opacity="0.09">
+    <path d="M0 90H1200M0 180H1200M0 270H1200M0 360H1200M0 450H1200M0 540H1200" stroke="#f2eadc" stroke-width="1"/>
+    <path d="M100 0V630M200 0V630M300 0V630M400 0V630M500 0V630M600 0V630M700 0V630M800 0V630M900 0V630M1000 0V630M1100 0V630" stroke="#f2eadc" stroke-width="1"/>
+  </g>
+  <g transform="translate(875 74)" opacity="0.55">
+    <circle cx="150" cy="150" r="145" fill="none" stroke="#d7a642" stroke-width="3" opacity="0.55"/>
+    <circle cx="150" cy="150" r="95" fill="none" stroke="#d64b3f" stroke-width="3" opacity="0.36"/>
+    <circle cx="150" cy="150" r="48" fill="none" stroke="#f2eadc" stroke-width="3" opacity="0.28"/>
+  </g>
+  <text x="-36" y="612" fill="#f2eadc" opacity="0.055" font-family="Georgia, serif" font-size="132" font-weight="900">remember you are shipping code</text>
+  <g transform="translate(74 66)">
+    <g transform="translate(0 0)">
+      <circle cx="27" cy="27" r="27" fill="#f2eadc"/>
+      <path d="M27 0A27 27 0 0 1 54 27H27Z" fill="#d64b3f"/>
+      <path d="M27 27H54A27 27 0 0 1 13 50Z" fill="#d7a642"/>
+      <path d="M27 0V27H0A27 27 0 0 1 27 0Z" fill="#f2eadc"/>
+    </g>
+    <text x="76" y="36" fill="#f2eadc" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="25" font-weight="800" letter-spacing="4">${text(copy.title.toUpperCase())}</text>
+  </g>
+  <g transform="translate(76 166)">
+    <text x="0" y="0" fill="#d7a642" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="22" font-weight="700" letter-spacing="3">${text(copy.eyebrow.toUpperCase())}</text>
+    <text x="0" y="76" fill="#f2eadc" font-family="Georgia, serif" font-size="72" font-weight="900">${text(copy.headline[0])}</text>
+    <text x="0" y="146" fill="#f2eadc" font-family="Georgia, serif" font-size="72" font-weight="900">${text(copy.headline[1])}</text>
+    <text x="0" y="202" fill="#d8cbb5" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="25">${text(copy.detail[0])}</text>
+    <text x="0" y="238" fill="#d8cbb5" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="25">${text(copy.detail[1])}</text>
+  </g>
+  <g transform="translate(76 432)" filter="url(#soft-shadow)">
+    <rect x="0" y="0" width="812" height="88" rx="18" fill="#1b1814" stroke="#d7a642" stroke-opacity="0.48" stroke-width="2"/>
+    <text x="32" y="55" fill="#d7a642" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="28">$</text>
+    <text x="64" y="55" fill="#f2eadc" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="28" font-weight="700">${text(copy.command)}</text>
+  </g>
+  <g transform="translate(76 546)">
+    <rect x="0" y="-28" width="650" height="48" rx="24" fill="#d64b3f"/>
+    <text x="28" y="3" fill="#fff3eb" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="18" font-weight="800" letter-spacing="1.5">${text(copy.footer.toUpperCase())}</text>
+  </g>
+</svg>
+`;
+}
+
+const svg = renderSvg();
+
+if (mode === "check") {
+  const existing = await readFile(targetPath, "utf8");
+  if (existing !== svg) {
+    process.stderr.write("promo/share-kit/social-card.svg is stale. Run `npm run promo:card`.\n");
+    process.exitCode = 1;
+  }
+} else {
+  await mkdir(dirname(targetPath), { recursive: true });
+  await writeFile(targetPath, svg, "utf8");
+  process.stdout.write(`Wrote ${targetPath}\n`);
+}