memento-mori-jester 0.1.45 → 0.1.47

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to Memento Mori Jester are tracked here.
 
 ## Unreleased
 
+## 0.1.47
+
+- Reworked the README Start Here section into a clearer four-step path: try without writing files, add a recommended preset, connect an agent, then add hooks or CI.
+- Updated Getting Started to mirror the same onboarding order and mention playground sample buttons.
+- Kept this as a docs-only onboarding release; no CLI, MCP, config, review, playground runtime, or release workflow behavior changed.
+
+## 0.1.46
+
+- Added one-click sample buttons to the local playground for command, plan, diff, and final-answer reviews.
+- The sample buttons populate both subject and content, switch the active review kind, and preserve the existing local-only review API.
+- Added playground tests for deterministic sample rendering and review-kind coverage.
+
 ## 0.1.45
 
 - Added eight focused preset review fixtures for `risky-domain`, `missing-verification-step`, `confidence-theater`, and `done-without-evidence`.

package/README.md

@@ -16,7 +16,7 @@ See the full [demo transcript](docs/DEMO.md).
 
 ## Start Here
 
-No install needed:
+### 1. Try It Without Writing Files
 
 ```powershell
 npx -y memento-mori-jester@latest start
@@ -25,11 +25,13 @@ npx -y memento-mori-jester@latest command "git reset --hard"
 npx -y memento-mori-jester@latest playground
 ```
 
-Add it to a project:
+`start` prints the guided checklist. `playground` opens the local browser UI with sample buttons for commands, plans, diffs, and final answers.
+
+### 2. Add It To A Project
 
 ```powershell
 npx -y memento-mori-jester@latest config recommend
-npx -y memento-mori-jester@latest bootstrap --preset node
+npx -y memento-mori-jester@latest bootstrap --preset <recommended-preset>
 ```
 
 That writes:
@@ -38,6 +40,25 @@ That writes:
 - `memento-mori.mcp.json`
 - `MEMENTO_MORI.md`
 
+Common presets are `node`, `python`, `web`, `api`, `infra`, `ai`, and `security`.
+
+### 3. Connect Your Agent
+
+```powershell
+npx -y memento-mori-jester@latest setup
+npx -y memento-mori-jester@latest setup --agent codex
+npx -y memento-mori-jester@latest setup --agent claude
+```
+
+Use the generated MCP snippet and agent instruction in Codex, Claude Code, or another MCP-capable client.
+
+### 4. Add Hooks Or CI When Ready
+
+```powershell
+npx -y memento-mori-jester@latest bootstrap --preset <recommended-preset> --hook pre-commit
+npx -y memento-mori-jester@latest bootstrap --preset <recommended-preset> --hook pre-commit --hook pre-push
+```
+
 Add it to GitHub code scanning:
 
 ```powershell
@@ -166,6 +187,8 @@ jester mcp-config --mode npx
 jester mcp-config --agent claude --mode npx
 ```
 
+`jester playground` includes one-click samples for command, plan, diff, and final-answer reviews, so you can see a block, caution, or evidence check without inventing input first.
+
 The package-name binary works too:
 
 ```powershell

package/ROADMAP.md

@@ -6,6 +6,8 @@ Memento Mori Jester is usable today as a CLI, MCP server, GitHub Action, and git
 
 ## Recently Shipped
 
+- README onboarding polish in v0.1.47 around the shortest path from `npx` to playground, agent setup, hooks, and CI.
+- Playground sample buttons in v0.1.46 for trying command, plan, diff, and final-answer reviews from the first screen.
 - Fixture curation pass in v0.1.45 that moved all built-in and structural rule evidence to medium-or-better confidence.
 - Additional precision pass for fixture-driven tuning signals (scoped to high-signal rule families first).
 - Fixture-informed `jester tune` evidence from preset review cases, including matched fixture IDs and verdict buckets.
@@ -34,7 +36,7 @@ Memento Mori Jester is usable today as a CLI, MCP server, GitHub Action, and git
 
 ## Product Ideas
 
-- Improve playground onboarding samples so users can try realistic command, plan, diff, and final-answer reviews without inventing input.
+- Add first-run screenshots or a short hosted demo clip once the README path has had real-user feedback.
 
 ## Quality And Safety
 

package/dist/playground.d.ts

@@ -1,5 +1,5 @@
 import { type Server } from "node:http";
-import { type UserJesterConfig } from "./types.js";
+import { type ReviewKind, type UserJesterConfig } from "./types.js";
 export declare const playgroundHost = "127.0.0.1";
 export declare const playgroundPortDefault = 4818;
 export type PlaygroundServerOptions = {
@@ -13,6 +13,14 @@ export type StartedPlayground = {
     url: string;
     port: number;
 };
+export type PlaygroundSample = {
+    id: string;
+    label: string;
+    kind: ReviewKind;
+    subject: string;
+    content: string;
+};
+export declare const playgroundSamples: PlaygroundSample[];
 export declare function createPlaygroundServer(options?: PlaygroundServerOptions): Server;
 export declare function startPlaygroundServer(options?: StartPlaygroundOptions): Promise<StartedPlayground>;
 export declare function renderPlaygroundHtml(): string;

package/dist/playground.js

@@ -10,16 +10,46 @@ class HttpError extends Error {
         this.status = status;
     }
 }
-const sampleInputs = {
-    command: "git reset --hard",
-    plan: "I will just refactor auth and ship it.",
-    final: "Implemented the fix, but tests not run.",
-    diff: `diff --git a/.env b/.env
+export const playgroundSamples = [
+    {
+        id: "command-hard-reset",
+        label: "Hard reset",
+        kind: "command",
+        subject: "destructive git command",
+        content: "git reset --hard"
+    },
+    {
+        id: "plan-auth-ship",
+        label: "Overconfident plan",
+        kind: "plan",
+        subject: "auth refactor plan",
+        content: "I will just refactor auth and ship it."
+    },
+    {
+        id: "diff-public-token",
+        label: "Public token diff",
+        kind: "diff",
+        subject: "environment diff",
+        content: `diff --git a/.env b/.env
 index 1111111..2222222 100644
 --- a/.env
 +++ b/.env
 @@ -1 +1,2 @@
 +PUBLIC_TOKEN=redacted-demo-value`
+    },
+    {
+        id: "final-tests-not-run",
+        label: "Untested final",
+        kind: "final",
+        subject: "final answer",
+        content: "Implemented the fix, but tests not run."
+    }
+];
+const defaultSampleByKind = {
+    command: playgroundSamples[0],
+    plan: playgroundSamples[1],
+    diff: playgroundSamples[2],
+    final: playgroundSamples[3]
 };
 export function createPlaygroundServer(options = {}) {
     return createServer(async (request, response) => {
@@ -332,6 +362,31 @@ export function renderPlaygroundHtml() {
       gap: 12px;
     }
 
+    .sample-grid {
+      display: grid;
+      grid-template-columns: repeat(4, minmax(0, 1fr));
+      gap: 8px;
+    }
+
+    .sample-button {
+      min-height: 38px;
+      padding: 0 10px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: #fff;
+      color: var(--ink);
+      cursor: pointer;
+      font-size: 12px;
+      font-weight: 760;
+      white-space: normal;
+    }
+
+    .sample-button[aria-pressed="true"] {
+      border-color: var(--accent);
+      background: var(--accent-soft);
+      color: var(--accent);
+    }
+
     .actions {
       display: flex;
       align-items: center;
@@ -491,6 +546,10 @@ export function renderPlaygroundHtml() {
         grid-template-columns: 1fr;
       }
 
+      .sample-grid {
+        grid-template-columns: repeat(2, minmax(0, 1fr));
+      }
+
       .segmented {
         grid-template-columns: repeat(2, minmax(0, 1fr));
       }
@@ -541,6 +600,10 @@ export function renderPlaygroundHtml() {
             <textarea id="content" name="content" spellcheck="false"></textarea>
           </label>
 
+          <div class="sample-grid" aria-label="Sample inputs">
+            ${playgroundSamples.map((sample) => `<button class="sample-button" type="button" data-sample-id="${sample.id}" aria-pressed="false">${sample.label}</button>`).join("\n            ")}
+          </div>
+
           <div class="row">
             <label>
               Tone
@@ -580,8 +643,10 @@ export function renderPlaygroundHtml() {
   </main>
 
   <script>
-    const samples = ${JSON.stringify(sampleInputs, null, 6)};
+    const samples = ${JSON.stringify(playgroundSamples, null, 6)};
+    const defaultSamples = ${JSON.stringify(defaultSampleByKind, null, 6)};
     let activeKind = "command";
+    let activeSampleId = "";
 
     const content = document.querySelector("#content");
     const subject = document.querySelector("#subject");
@@ -589,6 +654,7 @@ export function renderPlaygroundHtml() {
     const risk = document.querySelector("#risk");
     const result = document.querySelector("#result");
     const kindButtons = Array.from(document.querySelectorAll("[data-kind]"));
+    const sampleButtons = Array.from(document.querySelectorAll("[data-sample-id]"));
 
     function escapeHtml(value) {
       return String(value)
@@ -598,14 +664,28 @@ export function renderPlaygroundHtml() {
         .replaceAll('"', "&quot;");
     }
 
-    function setKind(kind) {
-      activeKind = kind;
-      content.value = samples[kind];
+    function syncButtons() {
       for (const button of kindButtons) {
-        button.setAttribute("aria-pressed", String(button.dataset.kind === kind));
+        button.setAttribute("aria-pressed", String(button.dataset.kind === activeKind));
+      }
+      for (const button of sampleButtons) {
+        button.setAttribute("aria-pressed", String(button.dataset.sampleId === activeSampleId));
       }
     }
 
+    function loadSample(sample) {
+      activeKind = sample.kind;
+      activeSampleId = sample.id;
+      subject.value = sample.subject;
+      content.value = sample.content;
+      syncButtons();
+    }
+
+    function setKind(kind) {
+      activeKind = kind;
+      loadSample(defaultSamples[kind]);
+    }
+
     function issueList(issues) {
       if (!issues.length) {
         return "";
@@ -667,6 +747,15 @@ export function renderPlaygroundHtml() {
       button.addEventListener("click", () => setKind(button.dataset.kind));
     }
 
+    for (const button of sampleButtons) {
+      button.addEventListener("click", () => {
+        const sample = samples.find((entry) => entry.id === button.dataset.sampleId);
+        if (sample) {
+          loadSample(sample);
+        }
+      });
+    }
+
     document.querySelector("#sample").addEventListener("click", () => setKind(activeKind));
     document.querySelector("#review-form").addEventListener("submit", (event) => {
       event.preventDefault();

package/dist/playground.js.map

@@ -1 +1 @@
-{"version":3,"file":"playground.js","sourceRoot":"","sources":["../src/playground.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playground.js","sourceRoot":"","sources":["../src/playground.ts"],"names":[],"mappings":"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"}

package/docs/CLI.md

@@ -49,6 +49,7 @@ jester playground --port 4919
 ```
 
 The playground listens on `127.0.0.1`, loads the same project config as the CLI, and reviews commands, plans, diffs, and final answers through the same rule engine.
+It includes one-click samples for the four review kinds so you can try realistic inputs before wiring Jester into an agent or hook.
 
 ## Start
 

package/docs/DEMO.md

@@ -83,6 +83,13 @@ Config: built-in defaults
 Press Ctrl+C to stop.
 ```
 
+The browser playground includes sample buttons for:
+
+- `Hard reset`
+- `Overconfident plan`
+- `Public token diff`
+- `Untested final`
+
 ## 5. Preset Recommendation And Preview
 
 Command:

package/docs/GETTING_STARTED.md

@@ -2,7 +2,7 @@
 
 This is the shortest path for a normal project.
 
-## 1. Check It Runs
+## 1. Try It Without Writing Files
 
 For a guided checklist:
 
@@ -18,8 +18,6 @@ npx -y memento-mori-jester@latest doctor
 
 You should see four `PASS` lines.
 
-## 2. See The Point
-
 ```powershell
 npx -y memento-mori-jester@latest command "git reset --hard"
 ```
@@ -38,19 +36,21 @@ For the local browser version:
 npx -y memento-mori-jester@latest playground
 ```
 
+The playground starts on `127.0.0.1` and includes sample buttons for command, plan, diff, and final-answer reviews.
+
 If a rule feels noisy, ask for tuning advice before disabling it:
 
 ```powershell
 npx -y memento-mori-jester@latest tune risky-domain
 ```
 
-## 3. Add It To A Project
+## 2. Add It To A Project
 
 Run this from the folder of the project you want protected:
 
 ```powershell
 npx -y memento-mori-jester@latest config recommend
-npx -y memento-mori-jester@latest bootstrap --preset node
+npx -y memento-mori-jester@latest bootstrap --preset <recommended-preset>
 ```
 
 Use `--preset ai` for LLM, MCP, and agent apps, `--preset api` for backend APIs, `--preset web` for frontend/browser apps, `--preset infra` for deployment or cloud infrastructure repos, or `--preset security` for a stricter general policy.
@@ -65,32 +65,34 @@ That creates:
 
 Existing files are kept. Add `--force` only when you want to overwrite the starter files.
 
-## 4. Optional Git Hooks
+## 3. Agent Instruction
 
-To make git call the Jester before commits:
+For exact Codex, Claude Code, or generic MCP snippets:
 
 ```powershell
-npx -y memento-mori-jester@latest bootstrap --preset node --hook pre-commit
+npx -y memento-mori-jester@latest setup
+npx -y memento-mori-jester@latest setup --agent codex
+npx -y memento-mori-jester@latest setup --agent claude
 ```
 
-To also check before pushing:
+Put this in your agent rules or custom instructions:
 
-```powershell
-npx -y memento-mori-jester@latest bootstrap --preset node --hook pre-commit --hook pre-push
+```text
+Before risky commands, final answers, commits, or large edits, call the Memento Mori Jester. Treat BLOCK as requiring a changed plan, and CAUTION as requiring at least one concrete verification step.
 ```
 
-## 5. Agent Instruction
+## 4. Optional Git Hooks
 
-For exact Codex, Claude Code, or generic MCP snippets:
+To make git call the Jester before commits:
 
 ```powershell
-npx -y memento-mori-jester@latest setup
+npx -y memento-mori-jester@latest bootstrap --preset <recommended-preset> --hook pre-commit
 ```
 
-Put this in your agent rules or custom instructions:
+To also check before pushing:
 
-```text
-Before risky commands, final answers, commits, or large edits, call the Memento Mori Jester. Treat BLOCK as requiring a changed plan, and CAUTION as requiring at least one concrete verification step.
+```powershell
+npx -y memento-mori-jester@latest bootstrap --preset <recommended-preset> --hook pre-commit --hook pre-push
 ```
 
 ## What To Share With Someone Else

package/docs/RELEASE_NOTES_v0.1.46.md

@@ -0,0 +1,24 @@
+# v0.1.46 Release Notes
+
+This release makes the local playground easier to try by adding one-click sample inputs for each review kind. It does not change review matching, scoring, verdicts, config, MCP tools, GitHub Action behavior, or release automation.
+
+## Changed
+
+- Added playground sample buttons:
+  - `Hard reset`
+  - `Overconfident plan`
+  - `Public token diff`
+  - `Untested final`
+- Sample buttons switch the active review kind and populate the subject/content fields.
+- Added tests that the rendered playground exposes all sample buttons and keeps sample review-kind coverage deterministic.
+
+## Release Validation
+
+```powershell
+npm.cmd test
+npm.cmd run demo:svg:check
+npm.cmd run pack:dry
+git diff --check
+node .\dist\cli.js playground
+git diff | node .\dist\cli.js diff --fail-on block --subject "v0.1.46 playground sample buttons"
+```

package/docs/RELEASE_NOTES_v0.1.47.md

@@ -0,0 +1,25 @@
+# v0.1.47 Release Notes
+
+This is a docs-only onboarding release. It makes the first README path clearer without changing CLI behavior, review behavior, MCP tools, config, playground runtime, GitHub Actions, or release automation.
+
+## Changed
+
+- Reworked README Start Here into four steps:
+  - try Jester without writing files,
+  - add it to a project with the recommended preset,
+  - connect Codex, Claude Code, or a generic MCP client,
+  - add hooks or GitHub code scanning when ready.
+- Updated Getting Started to follow the same order and mention the playground sample buttons.
+- Updated the roadmap with the shipped README polish and the next demo/onboarding idea.
+
+## Release Validation
+
+```powershell
+npm.cmd test
+npm.cmd run demo:svg:check
+npm.cmd run pack:dry
+git diff --check
+node .\dist\cli.js start
+node .\dist\cli.js config recommend
+git diff | node .\dist\cli.js diff --fail-on block --subject "v0.1.47 README onboarding polish"
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mori-jester",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "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": {