patina-cli 3.11.0 → 4.0.0

package/playground/styles.css

@@ -0,0 +1,267 @@
+:root {
+  color-scheme: dark;
+  --bg: #070809;
+  --panel: #111318;
+  --panel-2: #171a21;
+  --text: #f5efe4;
+  --muted: #b8ad9a;
+  --line: #2a2d35;
+  --gold: #d8a948;
+  --amber: #f2c86b;
+  --green: #78d99a;
+  --red: #ff7b72;
+  --blue: #8ecaff;
+  --shadow: 0 24px 80px rgba(0, 0, 0, 0.42);
+  font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+}
+
+* { box-sizing: border-box; }
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  background:
+    radial-gradient(circle at 20% 10%, rgba(216, 169, 72, 0.18), transparent 34rem),
+    radial-gradient(circle at 80% 0%, rgba(142, 202, 255, 0.11), transparent 30rem),
+    linear-gradient(180deg, #08090b 0%, #101116 100%);
+  color: var(--text);
+}
+
+a { color: var(--amber); text-decoration: none; }
+a:hover { text-decoration: underline; }
+
+.hero, .workspace, .footer {
+  width: min(1180px, calc(100% - 32px));
+  margin: 0 auto;
+}
+
+.hero { padding: 28px 0 22px; }
+
+.nav, .panel__head, .button-row, .hero__actions, .cli-box__head {
+  display: flex;
+  align-items: center;
+}
+
+.nav { justify-content: space-between; gap: 18px; }
+
+.brand {
+  display: inline-flex;
+  align-items: center;
+  gap: 12px;
+  color: var(--text);
+  font-weight: 800;
+  letter-spacing: -0.04em;
+  font-size: 1.25rem;
+}
+.brand img { display: block; filter: drop-shadow(0 8px 18px rgba(0, 0, 0, 0.35)); }
+
+.nav__links { display: flex; gap: 18px; font-size: 0.95rem; }
+
+.hero__copy {
+  padding: 78px 0 46px;
+  max-width: 850px;
+}
+
+.eyebrow {
+  color: var(--gold);
+  font-weight: 800;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  font-size: 0.75rem;
+  margin: 0 0 10px;
+}
+
+h1, h2, h3, p { margin-top: 0; }
+h1 {
+  font-size: clamp(2.6rem, 8vw, 6.2rem);
+  line-height: 0.92;
+  letter-spacing: -0.08em;
+  margin-bottom: 24px;
+}
+h2 { font-size: 1.2rem; margin-bottom: 0; }
+h3 { font-size: 0.95rem; margin-bottom: 0; }
+
+.hero__copy > p:not(.eyebrow) {
+  color: var(--muted);
+  font-size: clamp(1.05rem, 2vw, 1.3rem);
+  line-height: 1.7;
+  max-width: 720px;
+}
+
+.hero__actions { gap: 10px; flex-wrap: wrap; margin-top: 22px; }
+
+.workspace {
+  display: grid;
+  grid-template-columns: minmax(0, 1.15fr) minmax(340px, 0.85fr);
+  gap: 18px;
+  align-items: start;
+}
+
+.panel {
+  background: color-mix(in srgb, var(--panel) 92%, transparent);
+  border: 1px solid var(--line);
+  border-radius: 24px;
+  padding: 22px;
+  box-shadow: var(--shadow);
+  backdrop-filter: blur(18px);
+}
+
+.panel.full { grid-column: 1 / -1; }
+.panel__head { justify-content: space-between; gap: 16px; margin-bottom: 18px; }
+
+.field { display: grid; gap: 6px; color: var(--muted); font-size: 0.8rem; font-weight: 700; }
+select, textarea, button {
+  font: inherit;
+}
+select {
+  color: var(--text);
+  background: var(--panel-2);
+  border: 1px solid var(--line);
+  border-radius: 12px;
+  padding: 10px 34px 10px 12px;
+}
+
+textarea {
+  width: 100%;
+  min-height: 330px;
+  resize: vertical;
+  color: var(--text);
+  background: #0b0d11;
+  border: 1px solid var(--line);
+  border-radius: 18px;
+  padding: 18px;
+  line-height: 1.65;
+  outline: none;
+}
+textarea:focus, select:focus, button:focus-visible, a:focus-visible {
+  outline: 2px solid var(--amber);
+  outline-offset: 3px;
+}
+
+.button-row { gap: 10px; flex-wrap: wrap; margin-top: 14px; }
+.button {
+  border: 0;
+  border-radius: 999px;
+  padding: 11px 18px;
+  color: #111;
+  background: linear-gradient(135deg, var(--amber), #f9e7a6);
+  font-weight: 850;
+  cursor: pointer;
+}
+.button.secondary, .button.ghost {
+  color: var(--text);
+  background: #1d2028;
+  border: 1px solid var(--line);
+}
+.button:hover { transform: translateY(-1px); }
+
+.status, .quiet, .muted {
+  color: var(--muted);
+}
+.status { min-height: 1.4em; margin: 10px 0 0; }
+
+.score-band, .pill {
+  border-radius: 999px;
+  padding: 7px 10px;
+  font-size: 0.8rem;
+  font-weight: 800;
+}
+.score-band[data-tone="good"], .pill.clean { color: #10351e; background: var(--green); }
+.score-band[data-tone="warn"] { color: #3d2a00; background: var(--amber); }
+.score-band[data-tone="hot"], .pill.hot { color: #3f0c08; background: var(--red); }
+
+.score-meter { display: grid; gap: 18px; }
+.score-meter__number { font-size: 5rem; line-height: 1; letter-spacing: -0.08em; font-weight: 900; }
+.score-meter__number small { color: var(--muted); font-size: 1.3rem; letter-spacing: 0; }
+.score-meter__bar {
+  height: 14px;
+  border-radius: 999px;
+  background: #0b0d11;
+  border: 1px solid var(--line);
+  overflow: hidden;
+}
+.score-meter__bar span {
+  --score: 0%;
+  display: block;
+  height: 100%;
+  width: var(--score);
+  background: linear-gradient(90deg, var(--green), var(--amber), var(--red));
+  transition: width 180ms ease;
+}
+
+.summary { display: grid; gap: 8px; padding-left: 1.1rem; color: var(--muted); }
+.summary strong { color: var(--text); }
+
+.cli-box {
+  margin-top: 20px;
+  border: 1px solid var(--line);
+  border-radius: 18px;
+  background: #0b0d11;
+  overflow: hidden;
+}
+.cli-box__head {
+  justify-content: space-between;
+  gap: 12px;
+  padding: 12px 14px;
+  border-bottom: 1px solid var(--line);
+  color: var(--muted);
+}
+.cli-box pre {
+  margin: 0;
+  padding: 14px;
+  max-height: 220px;
+  overflow: auto;
+  color: #f5efe4;
+  white-space: pre-wrap;
+}
+
+.table-wrap { overflow-x: auto; }
+table { width: 100%; border-collapse: collapse; min-width: 850px; }
+th, td { padding: 12px; text-align: left; border-bottom: 1px solid var(--line); vertical-align: top; }
+th { color: var(--muted); font-size: 0.8rem; text-transform: uppercase; letter-spacing: 0.08em; }
+
+.diff-list { display: grid; gap: 14px; }
+.diff-card {
+  border: 1px solid var(--line);
+  border-radius: 18px;
+  background: #0b0d11;
+  padding: 16px;
+}
+.diff-card.hot { border-color: color-mix(in srgb, var(--red) 60%, var(--line)); }
+.diff-card.clean { border-color: color-mix(in srgb, var(--green) 45%, var(--line)); }
+.diff-card__head { display: flex; justify-content: space-between; gap: 12px; margin-bottom: 10px; color: var(--muted); }
+.diff-card p { line-height: 1.75; }
+.diff-card ul { color: var(--muted); padding-left: 1.2rem; }
+.diff-card code {
+  display: inline-block;
+  margin: 0 4px 6px 0;
+  padding: 3px 7px;
+  border: 1px solid var(--line);
+  border-radius: 999px;
+  color: var(--amber);
+  background: #151820;
+}
+mark {
+  color: #140f05;
+  background: var(--amber);
+  border-radius: 6px;
+  padding: 0 4px;
+}
+.empty-state {
+  color: var(--muted);
+  border: 1px dashed var(--line);
+  border-radius: 16px;
+  padding: 18px;
+}
+.footer {
+  padding: 34px 0 48px;
+  color: var(--muted);
+}
+
+@media (max-width: 880px) {
+  .workspace { grid-template-columns: 1fr; }
+  .nav { align-items: flex-start; }
+  .nav__links { flex-wrap: wrap; justify-content: flex-end; }
+  .panel__head { align-items: flex-start; flex-direction: column; }
+  .score-meter__number { font-size: 4rem; }
+}

package/profiles/namuwiki.md

@@ -0,0 +1,111 @@
+---
+profile: namuwiki
+name: 나무위키풍 프로필
+version: 1.0.0
+scope: 한국어 위키풍 설명, 인터넷 커뮤니티식 부연, 가벼운 리뷰/해설 글. ko 전용이며 실제 나무위키 문서 텍스트를 포함하지 않는다.
+language: ko
+license-note: Original style description only; do not copy CC BY-NC-SA NamuWiki article text into this repo.
+voice-overrides:
+  first-person: normal
+  opinions: amplify
+  rhythm-variation: amplify
+  humor: allow
+  messiness: amplify
+  concrete-emotions: amplify
+  structure-heavy: reduce
+pattern-overrides:
+  ko:
+    # current schema: suppress=allow this marker, reduce=only fix overuse, amplify=fix aggressively
+    13: reduce      # 연결 표현: 후술/상술 같은 위키체 접속은 일부 허용, 반복만 정리
+    14: reduce      # 볼드체: 표제어/주의 강조는 일부 허용, 기계적 전면 볼드만 교정
+    15: reduce      # 인라인 헤더: 목록+잡담 혼합 문체에서 일부 허용
+    17: reduce      # 이모지/기호: 원문에 있는 가벼운 장식은 일부 허용
+    22: reduce      # 채움 표현: 사족과 말맛은 보존, 빈 완충어 남발만 줄임
+    23: reduce      # 헤징: '~인 듯', '~카더라' 류는 장르 표식일 수 있음
+    24: suppress    # 막연한 긍정 결론: 위키풍 글은 닫힌 홍보 결론보다 열린 사족이 자연스러움
+    25: reduce      # 구조 반복: 목록은 허용하되 문장 틀 복붙은 교정
+    26: reduce      # 번역체: 일부 어색함/구어 리듬은 보존, 영어 직역만 교정
+    30: reduce      # 수사적 질문: 문단 도입 드립은 일부 허용
+    31: suppress    # 결론 신호어: '결론적으로'식 마무리보다 문단 자체로 끝내기
+    1: amplify      # 거창한 중요성 부여는 위키풍이 아니라 AI/홍보 톤이므로 더 엄격히 제거
+    4: amplify      # 홍보성 언어는 위키풍과 충돌
+    7: amplify      # AI 고빈도 어휘는 인터넷식 말맛을 죽임
+    8: amplify      # '~적' 남발은 위키풍보다 보고서투에 가까움
+    10: amplify     # 3의 법칙은 위키풍 사족보다 발표자료 톤
+    16: amplify     # '~고 있다' 진행형 남발은 교정
+    18: amplify     # 과도한 한자어/공식어는 위키풍 구어성을 해침
+    19: suppress    # 챗봇 응대 표현은 나무위키풍으로 바꾸기보다 제거
+---
+
+# 나무위키풍 프로필
+
+이 프로필은 한국어 글을 **위키풍 해설 + 인터넷식 사족** 쪽으로 기울인다. 목적은 실제 나무위키 문서를 모사하거나 복제하는 것이 아니라, 딱딱한 AI 문체를 한국어 인터넷 독자가 익숙하게 읽는 설명체로 낮추는 것이다.
+
+## 라이선스 가드레일
+
+- 실제 나무위키 문서 문장, 예시, 제목, 각주를 복사하지 않는다.
+- 예시는 모두 이 저장소에서 새로 쓴 문장이어야 한다.
+- 외부 덤프는 오프라인 통계 확인에만 쓸 수 있고, 텍스트는 repo에 반입하지 않는다.
+
+## 적용 범위
+
+- 한국어 글(`--lang ko`) 전용.
+- 짧은 제품 해설, 게임/도구 리뷰, 커뮤니티 공지, 가벼운 기술 소개에 적합하다.
+- 논문, 법률/의학 안내, 회사 공식 공지에는 쓰지 않는다. 이런 글은 `academic`, `legal`, `medical`, `formal`이 맞다.
+
+## 어조 지침
+
+- **표제어 설명처럼 시작한다.** 첫 문장은 대상을 짧게 정의하고, 바로 예외나 맥락을 붙인다.
+- **사족을 허용한다.** 괄호 부연, 짧은 딴지, `[* ...]` 형식의 주석을 쓸 수 있다. 단, 사실을 새로 만들지 않는다.
+- **완벽한 중립을 강요하지 않는다.** 원문에 평가가 있으면 살리고, 너무 홍보 문장처럼 보이면 한 발 물러서서 쓴다.
+- **목록과 산문을 섞는다.** 모든 단락을 같은 길이와 같은 구조로 맞추지 않는다.
+- **구어와 문어를 섞는다.** `~다`체를 기본으로 하되, `다만`, `문제는`, `그렇다고` 같은 구어적 연결을 허용한다.
+- **드립은 작게.** 농담은 문장 하나 안에서 끝내고, 핵심 설명을 가리지 않는다.
+
+## 적극 보존 / 허용
+
+- 괄호 부연: `(물론 이것만으로 해결되진 않는다)`
+- 각주풍 사족: `[* 실제로는 설정 파일 한 줄 때문에 터지는 경우가 많다.]`
+- 위키체 연결: `후술`, `상술한`, `전술한`, `~인 셈`, `~카더라` — 과하면 줄인다.
+- 짧은 평가: `애매하다`, `귀찮다`, `생각보다 세다`처럼 독자가 감을 잡는 말.
+
+## 계속 제거할 AI 티
+
+- `혁신적인`, `강력한`, `효율적인` 같은 빈 수식어.
+- `중요한 역할을 하고 있다`, `미래가 기대된다` 같은 닫힌 홍보 결론.
+- 모든 문단이 `정의 → 장점 → 결론`으로 반복되는 구조.
+- `~적` 형용사와 한자어가 한 문장에 몰리는 보고서투.
+
+## Before / After
+
+### 도구 소개
+
+**Before**
+```text
+이 솔루션은 혁신적인 접근을 통해 사용자의 생산성을 극대화하고, 체계적인 워크플로우를 기반으로 지속 가능한 가치를 제공합니다.
+```
+
+**After**
+```text
+작업 문장을 한 번 훑어서 AI 티 나는 부분을 표시해 주는 도구다. 생산성을 올린다고 크게 말할 수도 있겠지만, 실제로는 `혁신적인`, `체계적인` 같은 말부터 지우는 쪽에 가깝다.[* 그래서 결과물이 더 수수해진다. 이게 장점이다.]
+```
+
+### 기능 설명
+
+**Before**
+```text
+본 기능은 다양한 사용 환경에서 효과적으로 활용될 수 있으며, 향후 사용자 경험 향상에 중요한 역할을 할 것으로 기대됩니다.
+```
+
+**After**
+```text
+브라우저에서는 점수만 보고, 실제 재작성은 CLI나 에디터 스킬에서 한다. 역할이 나뉘어 있어서 처음엔 조금 헷갈릴 수 있다. 대신 웹에 글을 맡기는 구조가 아니라는 점은 꽤 명확하다.
+```
+
+## 사용
+
+```bash
+patina --lang ko --profile namuwiki input.txt
+```
+
+`--lang en|zh|ja`와 함께 쓰면 기본 프로필로 폴백한다. 이 프로필은 한국어 조사, 어미, 인터넷식 부연을 전제로 하기 때문이다.

package/scripts/adversarial-mps-report.mjs

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { analyzeText } from '../src/features/index.js';
+import { loadLexicon } from '../src/features/lexicon.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(__dirname, '..');
+
+export const DEFAULT_INPUT = 'tests/quality/adversarial-mps/fixtures.jsonl';
+export const DEFAULT_OUTPUT = 'docs/research/adversarial-mps.md';
+
+export function parseArgs(argv = process.argv.slice(2)) {
+  const args = { input: DEFAULT_INPUT, output: DEFAULT_OUTPUT, json: false, check: false };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--input') args.input = argv[++i];
+    else if (arg === '--output') args.output = argv[++i];
+    else if (arg === '--json') args.json = true;
+    else if (arg === '--check') args.check = true;
+    else if (arg === '--help' || arg === '-h') args.help = true;
+    else throw new Error(`unknown option ${arg}`);
+  }
+  return args;
+}
+
+export function loadFixtures(path = DEFAULT_INPUT) {
+  const fullPath = resolve(repoRoot, path);
+  if (!existsSync(fullPath)) throw new Error(`fixture file not found: ${path}`);
+  return readFileSync(fullPath, 'utf8')
+    .split('\n')
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line, index) => {
+      try {
+        return normalizeFixture(JSON.parse(line));
+      } catch (err) {
+        throw new Error(`${path}:${index + 1}: ${err.message}`);
+      }
+    });
+}
+
+function normalizeFixture(row) {
+  if (!row || typeof row !== 'object' || Array.isArray(row)) throw new Error('fixture must be an object');
+  for (const key of ['id', 'lang', 'original', 'rewritten']) {
+    if (typeof row[key] !== 'string' || row[key].trim() === '') throw new Error(`${key} is required`);
+  }
+  if (!Array.isArray(row.anchors) || row.anchors.length === 0) throw new Error('anchors must be a non-empty array');
+  const anchors = row.anchors.map((anchor) => {
+    if (typeof anchor !== 'string' || anchor.trim() === '') throw new Error('anchors must be non-empty strings');
+    return anchor.trim();
+  });
+  return {
+    expected_mps_min: 90,
+    expected_ai_min: 60,
+    ...row,
+    anchors,
+  };
+}
+
+export function evaluateFixtures(fixtures) {
+  return fixtures.map((fixture) => {
+    const mps = anchorMps(fixture);
+    const ai = deterministicAiScore(fixture.rewritten, fixture.lang);
+    const pass = mps.mps >= fixture.expected_mps_min && ai.score >= fixture.expected_ai_min;
+    return { ...fixture, mps, ai, pass };
+  });
+}
+
+export function anchorMps({ rewritten, anchors }) {
+  const haystack = normalizeText(rewritten);
+  const checked = anchors.map((anchor) => ({
+    anchor,
+    pass: haystack.includes(normalizeText(anchor)),
+  }));
+  const passCount = checked.filter((item) => item.pass).length;
+  const totalCount = checked.length;
+  return {
+    pass_count: passCount,
+    total_count: totalCount,
+    mps: totalCount ? round1((passCount / totalCount) * 100) : 0,
+    anchors: checked,
+  };
+}
+
+function deterministicAiScore(text, lang) {
+  const result = analyzeText(text, {
+    lang,
+    repoRoot,
+    lexicon: loadLexicon(lang, repoRoot),
+  });
+  const paragraphs = Array.isArray(result.paragraphs) ? result.paragraphs : [];
+  const paragraphCount = paragraphs.length;
+  const hotParagraphs = paragraphs.filter((p) => p.hot).length;
+  return {
+    score: paragraphCount ? round1((hotParagraphs / paragraphCount) * 100) : 0,
+    paragraph_count: paragraphCount,
+    hot_paragraphs: hotParagraphs,
+    lexicon_hits: Array.from(new Set(paragraphs.flatMap((p) => p.lexicon?.hits || []))).sort(),
+    ko_diagnostics_hot: paragraphs.filter((p) => p.koDiagnostics?.hot).length,
+  };
+}
+
+function normalizeText(text) {
+  return String(text || '').normalize('NFC').replace(/\s+/g, ' ').trim().toLowerCase();
+}
+
+function round1(n) {
+  return Math.round(n * 10) / 10;
+}
+
+export function summarize(rows) {
+  const total = rows.length;
+  const passing = rows.filter((r) => r.pass).length;
+  return {
+    total,
+    passing,
+    failing: total - passing,
+    min_mps: rows.length ? Math.min(...rows.map((r) => r.mps.mps)) : 0,
+    min_ai: rows.length ? Math.min(...rows.map((r) => r.ai.score)) : 0,
+  };
+}
+
+export function formatMarkdown(rows, { input = DEFAULT_INPUT } = {}) {
+  const summary = summarize(rows);
+  const lines = [];
+  lines.push('# Adversarial MPS audit');
+  lines.push('');
+  lines.push('This report checks whether a rewrite can preserve explicit meaning anchors while still looking AI-like. It is a repo-owned adversarial fixture set, not a public model-performance claim.');
+  lines.push('');
+  lines.push(`Fixture source: \`${input}\``);
+  lines.push('');
+  lines.push('## Summary');
+  lines.push('');
+  lines.push(`- Fixtures: ${summary.total}`);
+  lines.push(`- Passing adversarial cases: ${summary.passing}/${summary.total}`);
+  lines.push(`- Minimum anchor-MPS proxy: ${summary.min_mps.toFixed(1)}`);
+  lines.push(`- Minimum deterministic AI score: ${summary.min_ai.toFixed(1)}`);
+  lines.push('- Gate: MPS proxy ≥90 and deterministic AI score ≥60.');
+  lines.push('');
+  lines.push('## Results');
+  lines.push('');
+  lines.push('| id | lang | register | MPS proxy | AI score | hot paragraphs | status |');
+  lines.push('|---|---|---|---:|---:|---:|---|');
+  for (const row of rows) {
+    lines.push(`| ${cell(row.id)} | ${cell(row.lang)} | ${cell(row.register || '')} | ${row.mps.mps.toFixed(1)} | ${row.ai.score.toFixed(1)} | ${row.ai.hot_paragraphs}/${row.ai.paragraph_count} | ${row.pass ? 'pass' : 'fail'} |`);
+  }
+  lines.push('');
+  lines.push('## Interpretation');
+  lines.push('');
+  lines.push('The audit confirms the known gap: an anchor-preservation floor can pass text that still retains AI-marker density. MPS should remain a meaning-safety floor, not a humanness score. A complementary anti-gaming check should penalize repeated AI-marker recurrence after rewrite, especially when MPS is high.');
+  lines.push('');
+  lines.push('## Proposed MPS-v2 companion check');
+  lines.push('');
+  lines.push('Keep MPS unchanged for semantic safety, then add an independent recurrence gate:');
+  lines.push('');
+  lines.push('1. Score the original and rewritten text with deterministic `analyzeText`.');
+  lines.push('2. If `MPS ≥ 90` and rewritten AI score remains `≥ 60`, mark the candidate as `style_not_improved`.');
+  lines.push('3. In Ouroboros selection, prefer candidates that pass MPS and lower the AI score; do not let high MPS alone rescue a visibly AI-like rewrite.');
+  lines.push('4. Report preserved anchors and recurring AI markers separately so users can decide whether to edit more or keep the register.');
+  return `${lines.join('\n')}\n`;
+}
+
+function cell(value) {
+  return String(value ?? '').replace(/\|/g, '\\|').replace(/\n/g, '<br>');
+}
+
+export function writeReport(rows, { output = DEFAULT_OUTPUT, input = DEFAULT_INPUT } = {}) {
+  const outPath = resolve(repoRoot, output);
+  mkdirSync(dirname(outPath), { recursive: true });
+  const markdown = formatMarkdown(rows, { input });
+  writeFileSync(outPath, markdown);
+  return { path: relative(repoRoot, outPath), markdown };
+}
+
+function printHelp() {
+  console.log(`Usage: node scripts/adversarial-mps-report.mjs [--input <fixtures.jsonl>] [--output <report.md>] [--check] [--json]\n\nValidates hand-built adversarial MPS fixtures: MPS proxy >= 90 and deterministic AI score >= 60.`);
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  try {
+    const args = parseArgs();
+    if (args.help) {
+      printHelp();
+      process.exit(0);
+    }
+    const rows = evaluateFixtures(loadFixtures(args.input));
+    if (args.json) console.log(JSON.stringify({ summary: summarize(rows), rows }, null, 2));
+    else {
+      const result = writeReport(rows, { input: args.input, output: args.output });
+      console.log(`Wrote ${result.path}`);
+      console.log(JSON.stringify(summarize(rows)));
+    }
+    if (args.check && rows.some((row) => !row.pass)) process.exitCode = 1;
+  } catch (err) {
+    console.error(`adversarial-mps-report: ${err.message}`);
+    process.exitCode = 1;
+  }
+}

package/scripts/badge-json.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { scoreFiles, summarizeRows } from './prose-score.mjs';
+
+export function badgeBand(maxScore = 0) {
+  const score = Number(maxScore);
+  if (!Number.isFinite(score)) return { text: 'human-ish', color: 'brightgreen' };
+  if (score <= 30) return { text: 'human-ish', color: 'brightgreen' };
+  if (score <= 50) return { text: 'mixed', color: 'yellow' };
+  return { text: 'ai-like', color: 'red' };
+}
+
+export function formatBadgeScore(maxScore = 0) {
+  const score = Number(maxScore);
+  return `${Math.round(Number.isFinite(score) ? score : 0)}%`;
+}
+
+export function toShieldsEndpoint(summary, { label = 'patina' } = {}) {
+  const maxScore = summary?.maxScore ?? 0;
+  const band = badgeBand(maxScore);
+  return {
+    schemaVersion: 1,
+    label,
+    message: `${formatBadgeScore(maxScore)} · ${band.text}`,
+    color: band.color,
+  };
+}
+
+export function parseArgs(argv) {
+  const opts = {
+    files: [],
+    gate: 30,
+    lang: 'auto',
+    maxFiles: 50,
+    label: 'patina',
+  };
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--score-threshold') opts.gate = Number(argv[++i]);
+    else if (arg === '--lang') opts.lang = argv[++i] || 'auto';
+    else if (arg === '--max-files') opts.maxFiles = Number(argv[++i]);
+    else if (arg === '--label') opts.label = argv[++i] || 'patina';
+    else if (arg.startsWith('-')) throw new Error(`unknown option ${arg}`);
+    else opts.files.push(arg);
+  }
+
+  if (opts.files.length === 0) opts.files.push('README.md');
+  if (!Number.isFinite(opts.gate) || opts.gate < 0 || opts.gate > 100) {
+    throw new Error(`--score-threshold expects a number from 0 to 100, got ${opts.gate}`);
+  }
+  if (!Number.isInteger(opts.maxFiles) || opts.maxFiles < 1) {
+    throw new Error(`--max-files expects a positive integer, got ${opts.maxFiles}`);
+  }
+  return opts;
+}
+
+export function buildBadge(files, opts = {}) {
+  const rows = scoreFiles(files, opts);
+  return toShieldsEndpoint(summarizeRows(rows), opts);
+}
+
+export function run(argv = process.argv.slice(2)) {
+  const opts = parseArgs(argv);
+  const badge = buildBadge(opts.files, opts);
+  process.stdout.write(`${JSON.stringify(badge)}\n`);
+}
+
+const directPath = process.argv[1] ? resolve(process.argv[1]) : '';
+if (directPath === fileURLToPath(import.meta.url)) {
+  try {
+    run();
+  } catch (error) {
+    console.error(`patina-badge: ${error.message}`);
+    process.exitCode = 2;
+  }
+}