memento-mori-jester 0.1.3

package/dist/hooks.js

@@ -0,0 +1,133 @@
+import { execFile } from "node:child_process";
+import { chmod, mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { promisify } from "node:util";
+export const hookNames = ["pre-commit", "pre-push"];
+const execFileAsync = promisify(execFile);
+const marker = "memento-mori-jester managed hook";
+export async function installHook(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const path = await gitHookPath(options.hook, cwd);
+    const existing = await readOptional(path);
+    if (existing && !existing.includes(marker) && !options.force) {
+        throw new Error(`Refusing to overwrite existing ${options.hook} hook at ${path}. Re-run with --force to replace it.`);
+    }
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, renderHook(options), "utf8");
+    await chmod(path, 0o755);
+    return {
+        hook: options.hook,
+        path,
+        changed: true,
+        message: `Installed ${options.hook} hook at ${path}.`
+    };
+}
+export async function uninstallHook(hook, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const path = await gitHookPath(hook, cwd);
+    const existing = await readOptional(path);
+    if (!existing) {
+        return {
+            hook,
+            path,
+            changed: false,
+            message: `No ${hook} hook found at ${path}.`
+        };
+    }
+    if (!existing.includes(marker) && !options.force) {
+        throw new Error(`Refusing to remove non-jester ${hook} hook at ${path}. Re-run with --force to remove it anyway.`);
+    }
+    await unlink(path);
+    return {
+        hook,
+        path,
+        changed: true,
+        message: `Removed ${hook} hook at ${path}.`
+    };
+}
+export async function hookStatus(cwd = process.cwd()) {
+    return Promise.all(hookNames.map(async (hook) => {
+        const path = await gitHookPath(hook, cwd);
+        const existing = await readOptional(path);
+        const managed = Boolean(existing?.includes(marker));
+        return {
+            hook,
+            path,
+            changed: false,
+            message: existing ? managed ? "installed" : "occupied by another hook" : "not installed"
+        };
+    }));
+}
+export async function assertGitRepository(cwd = process.cwd()) {
+    try {
+        await execFileAsync("git", ["rev-parse", "--show-toplevel"], { cwd });
+    }
+    catch {
+        throw new Error("This command must be run inside a git repository.");
+    }
+}
+export function isHookName(value) {
+    return Boolean(value && hookNames.includes(value));
+}
+export function shellCommandPrefixForLocalCli(cliPath) {
+    return `node ${shellQuote(toShellPath(cliPath))}`;
+}
+export function shellQuote(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+async function gitHookPath(hook, cwd) {
+    await assertGitRepository(cwd);
+    const { stdout } = await execFileAsync("git", ["rev-parse", "--git-path", `hooks/${hook}`], { cwd });
+    return resolve(cwd, stdout.trim());
+}
+async function readOptional(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+function renderHook(options) {
+    if (options.hook === "pre-commit") {
+        return renderPreCommitHook(options.commandPrefix, options.failOn);
+    }
+    return renderPrePushHook(options.commandPrefix, options.failOn);
+}
+function renderPreCommitHook(commandPrefix, failOn) {
+    return `#!/bin/sh
+# ${marker}
+set -eu
+
+diff_output="$(git diff --cached --binary --no-ext-diff)"
+if [ -z "$diff_output" ]; then
+  exit 0
+fi
+
+printf "%s\\n" "$diff_output" | ${commandPrefix} diff --fail-on ${failOn} --subject "staged changes"
+`;
+}
+function renderPrePushHook(commandPrefix, failOn) {
+    return `#!/bin/sh
+# ${marker}
+set -eu
+
+upstream="$(git rev-parse --abbrev-ref --symbolic-full-name @{upstream} 2>/dev/null || true)"
+if [ -n "$upstream" ]; then
+  diff_range="$upstream..HEAD"
+else
+  diff_range="HEAD~1..HEAD"
+fi
+
+diff_output="$(git diff --binary --no-ext-diff "$diff_range" 2>/dev/null || git diff --binary --no-ext-diff HEAD 2>/dev/null || true)"
+if [ -z "$diff_output" ]; then
+  exit 0
+fi
+
+printf "%s\\n" "$diff_output" | ${commandPrefix} diff --fail-on ${failOn} --subject "unpushed changes"
+`;
+}
+function toShellPath(path) {
+    return path.replace(/\\/g, "/");
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadConfig } from "./config.js";
+import { reviewCommand, reviewDiff, reviewFinalAnswer, reviewPlan } from "./core.js";
+import { formatReview } from "./format.js";
+import { tones } from "./types.js";
+const toneSchema = z.enum(tones).optional();
+const sharedShape = {
+    context: z.string().optional(),
+    tone: toneSchema,
+    intensity: z.number().int().min(1).max(5).optional(),
+    riskTolerance: z.enum(["low", "medium", "high"]).optional(),
+    configPath: z.string().optional(),
+    noConfig: z.boolean().optional()
+};
+const server = new McpServer({
+    name: "memento-mori-jester",
+    version: "0.1.0"
+});
+server.registerTool("jester_review_plan", {
+    title: "Review Agent Plan",
+    description: "Puncture overconfident plans with a brief jester critique and concrete verification checks.",
+    inputSchema: {
+        plan: z.string().min(1),
+        subject: z.string().optional(),
+        ...sharedShape
+    }
+}, async ({ plan, subject, context, tone, intensity, riskTolerance, configPath, noConfig }) => {
+    const { config } = await loadConfig({ configPath, search: !noConfig });
+    const result = reviewPlan(plan, { subject, context, tone, intensity, riskTolerance, config });
+    return toolResult(result);
+});
+server.registerTool("jester_check_command", {
+    title: "Check Shell Command",
+    description: "Review a shell command for destructive operations, broad file changes, and other footguns.",
+    inputSchema: {
+        command: z.string().min(1),
+        subject: z.string().optional(),
+        ...sharedShape
+    }
+}, async ({ command, subject, context, tone, intensity, riskTolerance, configPath, noConfig }) => {
+    const { config } = await loadConfig({ configPath, search: !noConfig });
+    const result = reviewCommand(command, { subject, context, tone, intensity, riskTolerance, config });
+    return toolResult(result);
+});
+server.registerTool("jester_review_diff", {
+    title: "Review Code Diff",
+    description: "Review a diff for risky deletions, suppressed types, debug logs, sensitive areas, and missing checks.",
+    inputSchema: {
+        diff: z.string().min(1),
+        subject: z.string().optional(),
+        ...sharedShape
+    }
+}, async ({ diff, subject, context, tone, intensity, riskTolerance, configPath, noConfig }) => {
+    const { config } = await loadConfig({ configPath, search: !noConfig });
+    const result = reviewDiff(diff, { subject, context, tone, intensity, riskTolerance, config });
+    return toolResult(result);
+});
+server.registerTool("jester_final_answer_roast", {
+    title: "Review Final Answer",
+    description: "Check whether a final agent answer overclaims, omits verification, or needs a humbling caveat.",
+    inputSchema: {
+        answer: z.string().min(1),
+        subject: z.string().optional(),
+        ...sharedShape
+    }
+}, async ({ answer, subject, context, tone, intensity, riskTolerance, configPath, noConfig }) => {
+    const { config } = await loadConfig({ configPath, search: !noConfig });
+    const result = reviewFinalAnswer(answer, { subject, context, tone, intensity, riskTolerance, config });
+    return toolResult(result);
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+function toolResult(result) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatReview(result)
+            }
+        ],
+        structuredContent: result
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+export declare const tones: readonly ["gentle_stoic", "court_jester", "absolute_menace", "professional"];
+export type Tone = (typeof tones)[number];
+export declare const reviewKinds: readonly ["plan", "command", "diff", "final"];
+export type ReviewKind = (typeof reviewKinds)[number];
+export type Verdict = "pass" | "caution" | "block";
+export type RiskTolerance = "low" | "medium" | "high";
+export type HookFailOn = "caution" | "block";
+export interface JesterConfig {
+    tone: Tone;
+    intensity: number;
+    riskTolerance: RiskTolerance;
+}
+export interface CustomRuleConfig {
+    id: string;
+    pattern: string;
+    severity?: Issue["severity"];
+    title?: string;
+    detail?: string;
+    suggestedCheck?: string;
+    kinds?: ReviewKind[];
+    flags?: string;
+}
+export interface UserJesterConfig {
+    tone?: Tone;
+    intensity?: number;
+    riskTolerance?: RiskTolerance;
+    blockedCommands?: string[];
+    sensitiveDomains?: string[];
+    customRules?: CustomRuleConfig[];
+    hookFailOn?: HookFailOn;
+}
+export interface ReviewInput {
+    kind: ReviewKind;
+    content: string;
+    subject?: string;
+    context?: string;
+    tone?: Tone;
+    intensity?: number;
+    riskTolerance?: RiskTolerance;
+    config?: UserJesterConfig;
+}
+export interface Issue {
+    id: string;
+    severity: 1 | 2 | 3 | 4 | 5;
+    title: string;
+    detail: string;
+    suggestedCheck: string;
+    evidence?: string;
+}
+export interface ReviewResult {
+    kind: ReviewKind;
+    subject: string;
+    verdict: Verdict;
+    riskScore: number;
+    tone: Tone;
+    intensity: number;
+    jab: string;
+    memento: string;
+    issues: Issue[];
+    suggestedChecks: string[];
+}

package/dist/types.js

@@ -0,0 +1,8 @@
+export const tones = [
+    "gentle_stoic",
+    "court_jester",
+    "absolute_menace",
+    "professional"
+];
+export const reviewKinds = ["plan", "command", "diff", "final"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,cAAc;CACN,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC"}

package/docs/AGENTS.md

@@ -0,0 +1,145 @@
+# Agent Setup
+
+Memento Mori Jester is an MCP stdio server plus a normal CLI. The safest pattern is:
+
+1. Add the MCP server to the agent.
+2. Add the suggested instruction to the agent's rules or custom instructions.
+3. Keep a `jester.config.json` in project repos that need local rules.
+
+## Quick MCP Config
+
+After npm publish, use the `npx` config:
+
+```json
+{
+  "mcpServers": {
+    "memento-mori-jester": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "memento-mori-jester@latest",
+        "mcp-server"
+      ]
+    }
+  }
+}
+```
+
+For a global install:
+
+```json
+{
+  "mcpServers": {
+    "memento-mori-jester": {
+      "command": "memento-mori-jester-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+For local development from this repo:
+
+```powershell
+npm.cmd install
+npm.cmd run build
+node .\dist\cli.js mcp-config --mode local
+```
+
+## Suggested Agent Instruction
+
+```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.
+```
+
+## Project Bootstrap
+
+Use `bootstrap` inside a repo when you want the project files created for you:
+
+```powershell
+jester bootstrap --preset node
+```
+
+Before npm publish, the GitHub `npx` path should keep using the GitHub package spec in generated MCP config:
+
+```powershell
+npx -y github:Martin123132/Memento-Mori bootstrap --preset node --package github:Martin123132/Memento-Mori
+```
+
+It writes `jester.config.json`, `memento-mori.mcp.json`, and `MEMENTO_MORI.md`. Existing files are kept unless `--force` is passed.
+
+To add managed git hooks during bootstrap:
+
+```powershell
+jester bootstrap --preset node --hook pre-commit
+jester bootstrap --preset security --hook pre-commit --hook pre-push
+```
+
+## Codex
+
+Use:
+
+```powershell
+jester init --agent codex
+```
+
+Then paste the generated `mcpServers` block wherever your Codex MCP configuration is kept. For local development before npm publish:
+
+```powershell
+node .\dist\cli.js init --mode local --agent codex
+```
+
+## Claude Code
+
+Use:
+
+```powershell
+jester init --agent claude
+```
+
+Then paste the generated `mcpServers` block into Claude Code's MCP configuration. If Claude Code asks for a command and args separately, keep the generated values exactly.
+
+## Generic MCP Clients
+
+Use:
+
+```powershell
+jester mcp-config --mode npx
+```
+
+If the client does not support `npx`, install globally:
+
+```powershell
+npm install -g memento-mori-jester
+jester mcp-config --mode global
+```
+
+## Project Rules
+
+Create a project config:
+
+```powershell
+jester config init
+```
+
+Use a preset for common stacks:
+
+```powershell
+jester config init --preset node
+jester config init --preset python
+jester config init --preset security
+```
+
+Validate config before asking agents or hooks to use it:
+
+```powershell
+jester config validate
+jester config validate --json
+```
+
+Agents do not need to pass the config manually. The MCP server searches upward from the current working directory for:
+
+- `jester.config.json`
+- `.jester.json`
+
+If an agent invokes tools outside the project directory, pass `configPath` to the MCP tool.

package/docs/GITHUB_ACTIONS.md

@@ -0,0 +1,116 @@
+# GitHub Actions
+
+Use Memento Mori Jester in CI to review diffs before they merge.
+
+## Composite Action
+
+This repo can be used directly as a GitHub Action:
+
+```yaml
+name: Jester Review
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  jester:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Review diff
+        uses: Martin123132/Memento-Mori@main
+        with:
+          fail-on: block
+          subject: pull request diff
+```
+
+For pinned releases, replace `@main` with a tag such as `@v0.1.0`.
+
+## Pull Request Diff Review
+
+Create `.github/workflows/jester.yml`:
+
+```yaml
+name: Jester Review
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  jester:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Review pull request diff
+        run: |
+          git fetch origin "${{ github.base_ref }}" --depth=1
+          git diff --binary --no-ext-diff "origin/${{ github.base_ref }}...HEAD" \
+            | npx -y memento-mori-jester@latest diff --fail-on block --subject "pull request diff"
+```
+
+## Push Diff Review
+
+```yaml
+name: Jester Push Review
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  jester:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - name: Review pushed diff
+        run: |
+          git diff --binary --no-ext-diff HEAD~1..HEAD \
+            | npx -y memento-mori-jester@latest diff --fail-on block --subject "pushed diff"
+```
+
+## With Project Config
+
+Commit `jester.config.json` at the repo root. The CLI discovers it automatically:
+
+```yaml
+- run: |
+    git diff --binary --no-ext-diff "origin/${{ github.base_ref }}...HEAD" \
+      | npx -y memento-mori-jester@latest diff --fail-on block
+```
+
+To use a non-root config:
+
+```yaml
+- run: |
+    git diff --binary --no-ext-diff "origin/${{ github.base_ref }}...HEAD" \
+      | npx -y memento-mori-jester@latest diff --config .github/jester.config.json --fail-on block
+```
+
+## Softer Mode
+
+Use `--fail-on caution` if you want warnings to fail CI too:
+
+```yaml
+- run: |
+    git diff --binary --no-ext-diff "origin/${{ github.base_ref }}...HEAD" \
+      | npx -y memento-mori-jester@latest diff --fail-on caution
+```
+
+Use `--json` if another CI step will parse the result.

package/docs/RELEASE.md

@@ -0,0 +1,119 @@
+# Release Guide
+
+This project is ready to become a one-command package.
+
+## 1. Create The Repo
+
+Suggested repo name:
+
+```text
+Memento-Mori
+```
+
+After creating it:
+
+```powershell
+git remote add origin https://github.com/Martin123132/Memento-Mori.git
+git branch -M main
+git push -u origin main
+```
+
+## 2. Confirm Package Name
+
+The name was available on 2026-05-17:
+
+```powershell
+npm view memento-mori-jester version
+```
+
+An npm 404 means the name is still unclaimed.
+
+## 3. Publish To npm
+
+```powershell
+npm login
+npm test
+npm run pack:dry
+npm publish
+```
+
+The package publishes these bins:
+
+- `jester`: human CLI
+- `memento-mori-jester`: human CLI, useful for `npx`
+- `memento-mori-jester-mcp`: MCP stdio server
+
+## 4. Smoke Test Published Package
+
+```powershell
+npx -y memento-mori-jester@latest doctor
+npx -y memento-mori-jester@latest command "git reset --hard"
+npx -y memento-mori-jester@latest init
+npx -y memento-mori-jester@latest bootstrap --preset node
+npx -y memento-mori-jester@latest config init
+npx -y memento-mori-jester@latest config init --preset security --path jester-security.config.json
+npx -y memento-mori-jester@latest config validate --config jester-security.config.json
+```
+
+If this machine is not logged in to npm yet:
+
+```powershell
+npm login
+npm whoami
+```
+
+Then run the publish commands again.
+
+## 5. MCP Copy-Paste
+
+The lowest-friction config uses `npx`:
+
+```json
+{
+  "mcpServers": {
+    "memento-mori-jester": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "memento-mori-jester@latest",
+        "mcp-server"
+      ]
+    }
+  }
+}
+```
+
+For users who install globally:
+
+```json
+{
+  "mcpServers": {
+    "memento-mori-jester": {
+      "command": "memento-mori-jester-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+## 6. Repository Metadata
+
+The package is configured for:
+
+```text
+https://github.com/Martin123132/Memento-Mori
+```
+
+If the repo moves, update `repository`, `homepage`, and `bugs` in `package.json`, plus the raw installer URLs in `README.md`.
+
+## 7. Post-Release Workflow Check
+
+In a throwaway git repo:
+
+```powershell
+npx -y memento-mori-jester@latest config init
+npx -y memento-mori-jester@latest install-hook pre-commit
+npx -y memento-mori-jester@latest hook-status
+```
+
+Then stage a risky diff and confirm the hook blocks or cautions according to `hookFailOn`.