memento-mori-jester 0.1.79 → 0.1.80

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.

package/README.md

@@ -503,6 +503,7 @@ 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.

package/ROADMAP.md

@@ -6,6 +6,7 @@ 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.
@@ -70,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 lightweight social preview card or landing-page still for GitHub and X link previews.
+- 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,7 +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, docs, and fixture evidence numbers aligned.
+- 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
 
@@ -55,7 +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:check` verifies current repo-local promo assets against the current fixture evidence before maintainers post or refresh the demo.
+- `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

package/docs/RELEASE.md

@@ -12,6 +12,7 @@ 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.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.79",
+  "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": {
@@ -46,6 +46,8 @@
     "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",

package/scripts/check-production-readiness.mjs

@@ -65,6 +65,7 @@ for (const path of [
   `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",
@@ -133,11 +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

@@ -117,6 +117,7 @@ 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.`);
@@ -133,6 +134,11 @@ if (promoVersion !== "unknown") {
   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`);

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`);
+}