ja-llm-guard 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GX Cafe LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# ja-llm-guard
+
+日本語LLM出力の「**読めるのに壊れている**」を機械で拾う出口検査。依存ゼロ・MIT。
+
+```bash
+npx ja-llm-guard "検査したいテキスト"
+cat output.txt | npx ja-llm-guard   # 終了コード 0=合格 / 1=検知（CIの関所にそのまま置ける）
+```
+
+```js
+const { check } = require('ja-llm-guard');
+check('本日会議議事録送付確認依頼。');
+// => [ 'kana_ratio_low:0.00<0.15' ]  ← かなゼロの「日本語」は壊れの信号
+```
+
+## なぜ要るか（実測から）
+
+ローカルLLM上で自律エージェント群を24時間動かし、**63日間で8853件の失敗**を
+記録した。その中で「言語の壊れ」系は：
+
+| 実測件数 | 型 |
+|---|---|
+| 993 | 日英が無意味に混線した出力 |
+| 414 | 日本語文への中国語（簡体字）混入 |
+| 184 | 日本語で返ってこない |
+
+これらは文字列としては正常に「読める」ので、**例外にもならずログにも何も出ない**。
+多言語モデル（Qwen系など）を日本語業務に載せると、英語圏では起きない壊れ方をする。
+
+## 2つの検査（本番で実際に故障を捕まえた形だけ）
+
+1. **かな比率** — ひらがな・カタカナがゼロの「日本語文」は最も安く最も強い壊れの信号。
+   正常な日本語ビジネス文の実測はおおむね0.3〜0.6（既定の閾値は0.15）
+2. **簡体字混入** — 「CJKかどうか」の検査は日中両方を通してしまう。日本語の新字体に
+   存在しない簡体字だけのコードポイント（们・这・时 など）を名指しで見る
+
+## フル版
+
+敬体・常体の混在検査、見張り・関所テンプレ8本（cron欠落検知・出力契約・承認キュー・
+心拍ほか）、わざと壊すBREAK試験込みの試験28本を同梱した
+**Harness Templates Pro 日本語版（見張り・関所テンプレ8本＋日本語出力検査）**（¥49,800（税抜）・単一組織の商用ライセンス）を提供しています。
+お問い合わせ: **sales@gxcafe.co.jp**（件名に「日本語版テンプレ」とお書きください）
+
+運営: GX Cafe合同会社（[特定商取引法に基づく表記](https://gxcafe.co.jp/tokushoho/)）

package/README.template.md

@@ -0,0 +1,44 @@
+# ja-llm-guard
+
+日本語LLM出力の「**読めるのに壊れている**」を機械で拾う出口検査。依存ゼロ・MIT。
+
+```bash
+npx ja-llm-guard "検査したいテキスト"
+cat output.txt | npx ja-llm-guard   # 終了コード 0=合格 / 1=検知（CIの関所にそのまま置ける）
+```
+
+```js
+const { check } = require('ja-llm-guard');
+check('本日会議議事録送付確認依頼。');
+// => [ 'kana_ratio_low:0.00<0.15' ]  ← かなゼロの「日本語」は壊れの信号
+```
+
+## なぜ要るか（実測から）
+
+ローカルLLM上で自律エージェント群を24時間動かし、**{{days}}日間で{{records}}件の失敗**を
+記録した。その中で「言語の壊れ」系は：
+
+| 実測件数 | 型 |
+|---|---|
+| {{nBrokenLanguageMix}} | 日英が無意味に混線した出力 |
+| {{nChineseInJapanese}} | 日本語文への中国語（簡体字）混入 |
+| {{nNotJapanese}} | 日本語で返ってこない |
+
+これらは文字列としては正常に「読める」ので、**例外にもならずログにも何も出ない**。
+多言語モデル（Qwen系など）を日本語業務に載せると、英語圏では起きない壊れ方をする。
+
+## 2つの検査（本番で実際に故障を捕まえた形だけ）
+
+1. **かな比率** — ひらがな・カタカナがゼロの「日本語文」は最も安く最も強い壊れの信号。
+   正常な日本語ビジネス文の実測はおおむね0.3〜0.6（既定の閾値は0.15）
+2. **簡体字混入** — 「CJKかどうか」の検査は日中両方を通してしまう。日本語の新字体に
+   存在しない簡体字だけのコードポイント（们・这・时 など）を名指しで見る
+
+## フル版
+
+敬体・常体の混在検査、見張り・関所テンプレ8本（cron欠落検知・出力契約・承認キュー・
+心拍ほか）、わざと壊すBREAK試験込みの試験28本を同梱した
+**{{productProJaName}}**（{{priceProJa}}・単一組織の商用ライセンス）を提供しています。
+お問い合わせ: **sales@gxcafe.co.jp**（件名に「日本語版テンプレ」とお書きください）
+
+運営: GX Cafe合同会社（[特定商取引法に基づく表記](https://gxcafe.co.jp/tokushoho/)）

package/cli.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+'use strict';
+// 使い方:
+//   npx ja-llm-guard "検査したいテキスト"
+//   cat output.txt | npx ja-llm-guard
+// 終了コード: 0=合格 / 1=壊れを検知（CIやパイプラインの関所にそのまま置ける）
+const { check } = require('./index.js');
+
+function run(text) {
+  const fails = check(text);
+  if (!fails.length) {
+    console.log('✓ 合格（かな比率OK・簡体字混入なし）');
+    process.exit(0);
+  }
+  console.log('✗ 壊れを検知:');
+  for (const f of fails) console.log('  - ' + f);
+  process.exit(1);
+}
+
+const arg = process.argv.slice(2).join(' ');
+if (arg) { run(arg); } else if (!process.stdin.isTTY) {
+  let buf = '';
+  process.stdin.on('data', (d) => { buf += d; });
+  process.stdin.on('end', () => run(buf));
+} else {
+  console.log('使い方: npx ja-llm-guard "テキスト" もしくは cat file | npx ja-llm-guard');
+  process.exit(2);
+}

package/index.js

@@ -0,0 +1,58 @@
+'use strict';
+/**
+ * ja-llm-guard — 日本語LLM出力の「読めるのに壊れている」を機械で拾う無料ミニ検査（MIT）
+ *
+ * 出所: GX Cafe の本番ハーネス（ローカルLLM上の自律エージェント群・24時間稼働）の実測。
+ * 63日で記録した失敗 8,853件のうち、言語の壊れ系は
+ * broken_language_mix 993 / chinese_in_japanese 414 / not_japanese 184。
+ * どれも文字列としては正常に「読める」ので、例外にならず検知もされない。
+ *
+ * 2つの検査（本番で実際に故障を捕まえた形だけを載せる）:
+ *   1. かな比率 — ひらがな・カタカナがゼロの「日本語文」は最も安く最も強い壊れの信号。
+ *   2. 簡体字混入 — 「CJKかどうか」の検査は日中両方を通す。日本語の字体に無い
+ *      簡体字だけのコードポイントを名指しで見る（们・这・时 など）。
+ *
+ * フル版（敬体・常体の混在検査＋見張り・関所テンプレ8本＋試験28本）は
+ * Harness Templates Pro 日本語版として提供している（README参照）。
+ */
+
+// 日本語の新字体には存在しない、簡体字だけの代表的コードポイント（誤検知しない字だけを載せる）
+const SIMPLIFIED_ONLY = '们这应该现经说对发让见时间为样长东习头处务议论语读门问题击认识记级别战术运还进过买卖马';
+
+/** かな比率。null = 日本語の文字が無い（言語そのものが違う疑い） */
+function kanaRatio(text) {
+  const t = String(text || '');
+  const kana = (t.match(/[ぁ-ゖァ-ヺー]/g) || []).length;
+  const cjk = (t.match(/[ぁ-ゖァ-ヺー一-鿿]/g) || []).length;
+  return cjk === 0 ? null : kana / cjk;
+}
+
+/** 混入している簡体字（ユニーク）を返す。空配列＝混入なし */
+function simplifiedHits(text) {
+  const t = String(text || '');
+  const hits = new Set();
+  for (const ch of t) if (SIMPLIFIED_ONLY.includes(ch)) hits.add(ch);
+  return [...hits];
+}
+
+/**
+ * 検査の本体。fails配列を返す（空＝合格）。
+ * opts.minKanaRatio 既定0.15（実測: 正常な日本語ビジネス文はおおむね0.3〜0.6）
+ */
+function check(text, opts = {}) {
+  const fails = [];
+  const t = String(text || '');
+  if (!t.trim()) return ['empty'];
+
+  const ratio = kanaRatio(t);
+  const minKana = opts.minKanaRatio ?? 0.15;
+  if (ratio === null) fails.push('no_japanese_chars');
+  else if (ratio < minKana) fails.push(`kana_ratio_low:${ratio.toFixed(2)}<${minKana}`);
+
+  const simp = simplifiedHits(t);
+  if (simp.length) fails.push(`simplified_chinese:${simp.slice(0, 8).join('')}`);
+
+  return fails;
+}
+
+module.exports = { check, kanaRatio, simplifiedHits, SIMPLIFIED_ONLY };

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "ja-llm-guard",
+  "version": "0.1.0",
+  "description": "日本語LLM出力の『読めるのに壊れている』を機械で拾う出口検査（かな比率・簡体字混入）。実測8,853件の失敗ログから抽出。依存ゼロ。",
+  "license": "MIT",
+  "bin": { "ja-llm-guard": "cli.js" },
+  "main": "index.js",
+  "files": ["index.js", "cli.js", "README.md", "LICENSE"],
+  "keywords": ["japanese", "llm", "guardrails", "validation", "日本語", "ローカルLLM"],
+  "author": "GX Cafe LLC",
+  "repository": { "type": "git", "url": "https://gxcafe.co.jp/" }
+}