memento-mori-jester 0.1.3

package/examples/github-action.yml

@@ -0,0 +1,21 @@
+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
+        uses: Martin123132/Memento-Mori@main
+        with:
+          fail-on: block
+          subject: pull request diff

package/examples/jester.config.json

@@ -0,0 +1,28 @@
+{
+  "tone": "court_jester",
+  "intensity": 3,
+  "riskTolerance": "medium",
+  "hookFailOn": "block",
+  "blockedCommands": [
+    "git reset --hard",
+    "git clean -fd"
+  ],
+  "sensitiveDomains": [
+    "auth",
+    "billing",
+    "payments",
+    "production",
+    "customer data"
+  ],
+  "customRules": [
+    {
+      "id": "no-force-push-main",
+      "pattern": "git\\s+push\\s+--force(?:-with-lease)?\\s+origin\\s+main",
+      "severity": 5,
+      "title": "Force-push to main",
+      "detail": "This project treats force-pushing main as a stop-and-think event.",
+      "suggestedCheck": "Create a branch or use --force-with-lease only after confirming the protected branch policy.",
+      "kinds": ["command", "plan"]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "memento-mori-jester",
+  "version": "0.1.3",
+  "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": {
+    "type": "git",
+    "url": "git+https://github.com/Martin123132/Memento-Mori.git"
+  },
+  "homepage": "https://github.com/Martin123132/Memento-Mori#readme",
+  "bugs": {
+    "url": "https://github.com/Martin123132/Memento-Mori/issues"
+  },
+  "main": "./dist/core.js",
+  "types": "./dist/core.d.ts",
+  "bin": {
+    "jester": "dist/cli.js",
+    "memento-mori-jester": "dist/cli.js",
+    "memento-mori-jester-mcp": "dist/server.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "docs",
+    "examples",
+    "scripts",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "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",
+    "doctor": "node dist/cli.js doctor",
+    "pack:dry": "npm pack --dry-run",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm test && npm run pack:dry"
+  },
+  "keywords": [
+    "mcp",
+    "ai-agent",
+    "coding-agent",
+    "safety",
+    "cli",
+    "code-review",
+    "memento-mori",
+    "court-jester"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
+}

package/scripts/install.ps1

@@ -0,0 +1,30 @@
+param(
+  [string]$PackageSpec = "memento-mori-jester@latest",
+  [ValidateSet("npx", "global")]
+  [string]$Mode = "npx"
+)
+
+$ErrorActionPreference = "Stop"
+
+function Assert-Command($Name, $InstallHint) {
+  if (-not (Get-Command $Name -ErrorAction SilentlyContinue)) {
+    throw "$Name was not found. $InstallHint"
+  }
+}
+
+Assert-Command "node" "Install Node.js 20 or newer, then run this script again."
+Assert-Command "npm.cmd" "Install npm with Node.js, then run this script again."
+
+$nodeMajor = [int](& node -p "process.versions.node.split('.')[0]")
+if ($nodeMajor -lt 20) {
+  throw "Node.js 20 or newer is required. Found: $(& node --version)"
+}
+
+if ($Mode -eq "global") {
+  & npm.cmd install -g $PackageSpec
+  & jester doctor
+  & jester mcp-config --mode global
+} else {
+  & npx -y $PackageSpec doctor
+  & npx -y $PackageSpec mcp-config --mode npx --package $PackageSpec
+}

package/scripts/install.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PACKAGE_SPEC="${PACKAGE_SPEC:-memento-mori-jester@latest}"
+MODE="${MODE:-npx}"
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "node was not found. Install Node.js 20 or newer, then run this script again." >&2
+  exit 1
+fi
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "npm was not found. Install npm with Node.js, then run this script again." >&2
+  exit 1
+fi
+
+NODE_MAJOR="$(node -p "process.versions.node.split('.')[0]")"
+if [ "$NODE_MAJOR" -lt 20 ]; then
+  echo "Node.js 20 or newer is required. Found: $(node --version)" >&2
+  exit 1
+fi
+
+if [ "$MODE" = "global" ]; then
+  npm install -g "$PACKAGE_SPEC"
+  jester doctor
+  jester mcp-config --mode global
+else
+  npx -y "$PACKAGE_SPEC" doctor
+  npx -y "$PACKAGE_SPEC" mcp-config --mode npx --package "$PACKAGE_SPEC"
+fi

package/scripts/run-tests.mjs

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+
+const testFiles = await findTestFiles("dist");
+
+if (testFiles.length === 0) {
+  console.error("No compiled test files found in dist.");
+  process.exit(1);
+}
+
+const result = spawnSync(process.execPath, ["--test", ...testFiles], {
+  stdio: "inherit"
+});
+
+process.exit(result.status ?? 1);
+
+async function findTestFiles(dir) {
+  const entries = await readdir(dir, { withFileTypes: true });
+  const files = await Promise.all(entries.map(async (entry) => {
+    const path = join(dir, entry.name);
+
+    if (entry.isDirectory()) {
+      return findTestFiles(path);
+    }
+
+    return entry.isFile() && entry.name.endsWith(".test.js") ? [path] : [];
+  }));
+
+  return files.flat().sort();
+}