memento-mori-jester 0.1.80 → 0.1.81

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to Memento Mori Jester are tracked here.
 
 ## Unreleased
 
+## 0.1.81
+
+- Added a lightweight repo-local landing page under `site/index.html` that reuses the social card, demo video, start command, and public project links.
+- Added `npm run site:check` and wired it into `npm test` and production-readiness checks.
+- Updated README, promo docs, release docs, roadmap, and release notes for the new share page.
+
 ## 0.1.80
 
 - Added a deterministic `promo/share-kit/social-card.svg` for GitHub, X, and project-update link previews.

package/README.md

@@ -13,6 +13,7 @@ It roasts the reasoning, not the human.
 [![Memento Mori Jester terminal demo](docs/demo-terminal.svg)](docs/DEMO.md)
 
 See the full [demo transcript](docs/DEMO.md), or use the [promo/share kit](promo) for X post copy, stills, and a 30-second demo script.
+There is also a lightweight repo-local [landing page](site/index.html) for sharing the project in one screen.
 
 ## Start Here
 
@@ -505,6 +506,7 @@ Run `npm run fixtures:check` before merging fixture changes; it catches duplicat
 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.
+Run `npm run site:check` after editing the repo-local landing page; it verifies the start command, demo links, social card, repo, release, and npm links.
 
 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
 
+- Repo-local landing page in v0.1.81, adding a static one-page share surface plus deterministic link checks.
 - 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.
@@ -71,7 +72,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 web landing page that reuses the existing demo, social card, and start command.
+- Add a hosted-page option or GitHub Pages instructions once the static page has settled.
 
 ## Quality And Safety
 

package/docs/PRODUCTION_READINESS.md

@@ -10,6 +10,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
 - 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.
+- The repo-local landing page stays outside the npm package, but `npm run site:check` keeps its start command and public links aligned.
 
 ## npm Package
 
@@ -43,6 +44,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
 
 - `README.md` leads with a no-write first run, project bootstrap, agent setup, and optional hooks/CI.
 - `docs/GETTING_STARTED.md`, `docs/CLI.md`, `docs/RELEASE.md`, and `docs/TRUSTED_PUBLISHING.md` cover the core adoption and release paths.
+- `site/index.html` gives maintainers a static one-page share surface that reuses the demo, social card, start command, and public links.
 - Every public release has matching `CHANGELOG.md` notes and `docs/RELEASE_NOTES_vX.Y.Z.md`.
 
 ## Support And Recovery
@@ -56,6 +58,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
 - `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 run site:check` verifies the static landing page before maintainers post or host it.
 - npm publish has a manual workflow fallback, but the normal release path is tag-driven trusted publishing.
 
 ## Static Guard
@@ -72,6 +75,7 @@ This checklist defines what "production grade" means for Memento Mori Jester rig
 - fixture authoring checks are wired into `npm test`.
 - fixture coverage reports are wired into `npm test`.
 - promo freshness checks are wired into `npm test`.
+- site checks are wired into `npm test`.
 
 `npm test` runs this check after the TypeScript build and unit tests.
 

package/docs/RELEASE.md

@@ -14,6 +14,7 @@ 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 site:check
 npm.cmd run pack:dry
 git diff --check
 ```

package/docs/RELEASE_NOTES_v0.1.81.md

@@ -0,0 +1,41 @@
+# Memento Mori Jester v0.1.81
+
+## Summary
+
+This release adds a lightweight repo-local landing page that reuses the existing demo video, social card, install command, and public project links. It gives maintainers a one-page share surface without adding a framework or hosting dependency.
+
+## What Changed
+
+- Added `site/index.html`.
+- Added `scripts/check-site.mjs`.
+- Added `npm run site:check`.
+- Wired `site:check` into `npm test` and production-readiness checks.
+- Updated README, 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.
+- `site/` and `promo/` remain 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 site:check
+npm.cmd run pack:dry
+git diff --check
+git diff | node .\dist\cli.js diff --fail-on block --subject "v0.1.81 landing page"
+```
+
+Expected:
+
+- `site/index.html` opens as a static page with the current start command, demo video, social card, repo, release, and npm links,
+- `site/` remains repo-local and is not included in the npm tarball,
+- GitHub Release and npm Publish complete from the `v0.1.81` tag.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mori-jester",
-  "version": "0.1.80",
+  "version": "0.1.81",
   "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,7 +40,7 @@
     "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 promo:check && 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 site: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",
@@ -49,6 +49,7 @@
     "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",
+    "site:check": "node scripts/check-site.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

@@ -66,6 +66,7 @@ for (const path of [
   "action.yml",
   "scripts/check-promo-freshness.mjs",
   "scripts/render-social-card.mjs",
+  "scripts/check-site.mjs",
   "scripts/check-fixtures.mjs",
   "scripts/report-fixtures.mjs",
   ".github/ISSUE_TEMPLATE/bug_report.yml",
@@ -79,7 +80,8 @@ for (const path of [
   "examples/github-code-scanning.yml",
   "examples/ci/README.md",
   "examples/presets/README.md",
-  "examples/fixtures/preset-review-cases.json"
+  "examples/fixtures/preset-review-cases.json",
+  "site/index.html"
 ]) {
   requireFile(path);
 }
@@ -137,11 +139,16 @@ requireText("package.json", /"fixtures:report": "node scripts\/report-fixtures\.
 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", /"site:check": "node scripts\/check-site\.mjs"/, "site 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("package.json", /npm run site:check/, "site 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("scripts/check-site.mjs", /site\/index\.html/, "site index check");
+requireText("site/index.html", /npx -y memento-mori-jester@latest start/, "site start command");
+requireText("site/index.html", /promo\/share-kit\/social-card\.svg/, "site social card");
 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-site.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+const root = process.cwd();
+const failures = [];
+
+function read(path) {
+  return readFileSync(join(root, path), "utf8");
+}
+
+function requireFile(path) {
+  if (!existsSync(join(root, path))) {
+    failures.push(`${path} is missing.`);
+  }
+}
+
+function requireText(path, pattern, description) {
+  const content = read(path);
+  if (!pattern.test(content)) {
+    failures.push(`${path} should include ${description}.`);
+  }
+}
+
+requireFile("site/index.html");
+
+const promoReadme = read("promo/README.md");
+const currentVideo = promoReadme.match(/Final vertical demo video:\s*\[([^\]]+)\]\(([^)]+)\)/);
+const videoPath = currentVideo?.[2] ?? "";
+
+if (!videoPath) {
+  failures.push("promo/README.md should expose the current final vertical demo video.");
+}
+
+requireText("site/index.html", /<h1 id="hero-title">Memento Mori Jester<\/h1>/, "the product name as the hero heading");
+requireText("site/index.html", /npx -y memento-mori-jester@latest start/, "the current start command");
+requireText("site/index.html", /\.\.\/promo\/share-kit\/social-card\.svg/, "the social preview card");
+requireText("site/index.html", /\.\.\/docs\/DEMO\.md/, "the demo transcript link");
+requireText("site/index.html", /https:\/\/github\.com\/Martin123132\/Memento-Mori/, "the GitHub repository link");
+requireText("site/index.html", /https:\/\/github\.com\/Martin123132\/Memento-Mori\/releases\/latest/, "the latest release link");
+requireText("site/index.html", /https:\/\/www\.npmjs\.com\/package\/memento-mori-jester/, "the npm package link");
+requireText("site/index.html", /Codex, Claude Code, generic MCP clients, hooks, and CI/, "agent compatibility copy");
+
+if (videoPath) {
+  requireText("site/index.html", new RegExp(`\\.\\./promo/${videoPath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`), "the current promo video");
+}
+
+if (failures.length > 0) {
+  process.stderr.write("Site check failed:\n");
+  for (const failure of failures) {
+    process.stderr.write(`- ${failure}\n`);
+  }
+  process.exit(1);
+}
+
+process.stdout.write("Site check passed for site/index.html.\n");