memento-mori-jester 0.1.46 → 0.1.47

package/CHANGELOG.md

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

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

package/ROADMAP.md

@@ -6,6 +6,7 @@ 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).
@@ -35,7 +36,7 @@ Memento Mori Jester is usable today as a CLI, MCP server, GitHub Action, and git
 
 ## Product Ideas
 
-- Polish README onboarding around the shortest path from `npx` to playground, agent setup, and hooks.
+- Add first-run screenshots or a short hosted demo clip once the README path has had real-user feedback.
 
 ## Quality And Safety
 

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.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.46",
+  "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": {