@horizon_works/banto 0.5.0

package/README.md

@@ -0,0 +1,109 @@
+# AI番頭のOS
+
+株式会社ホライズンワークス
+
+AIを「便利な道具」ではなく「**任された範囲を預かる番頭**」として使うための土台です。
+MCPを1本入れるだけで、番頭の作法・ルール・記憶・検査がそろいます。
+
+---
+
+## いちばん大事なこと
+
+> **AIに中身を見せずに、AIに検査させる。**
+
+顧問先のお名前が入った下書きを、AIに貼らずに検査できます。
+ファイルを読むのは**あなたのパソコンの中のプログラム**で、AIが受け取るのは「何件あったか」という数字だけです。
+
+★このプログラムは、**あなたのパソコンの中で動きます**。
+検査するファイルも、書き留めた記録も、外へは出ません。
+
+---
+
+## 使えるようにする
+
+お使いのAIの設定（MCPの設定）に、次を足してください。
+
+```json
+{
+  "mcpServers": {
+    "banto": {
+      "command": "npx",
+      "args": ["-y", "@horizon_works/banto"]
+    }
+  }
+}
+```
+
+Node.js が入っていれば、ほかに何も要りません。
+足したあと、AIの窓を開き直してください。
+
+### 鍵を入れる
+
+お渡しした鍵を、環境変数に入れてください。
+
+```
+BANTOU_LICENSE_KEY   = （お渡しした鍵）
+BANTOU_LICENSE_URL   = （お渡しした URL）
+BANTOU_LICENSE_ANON  = （お渡しした 公開キー）
+```
+
+★鍵が無くても、**検査と記録は使えます**。サプリの取得だけが止まります。
+
+---
+
+## 最初にやること
+
+AIにこう言ってください。
+
+```
+番頭の道具を、このフォルダに入れて
+```
+
+スキル（画像・スライド・文字起こし）や、週に一度の手入れの手順が入ります。
+何が入るかは「**入る前に一覧を見せて**」と言えば、先に確かめられます。
+
+続けて、こう言えます。
+
+```
+番頭の棚を見せて
+```
+
+お仕事に合わせたサプリ（給与・就業規則・助成金・36協定など）の一覧がブラウザで開きます。
+要るものだけ選んで入れてください。★要らなくなったら外せます（**消えません**）。
+
+---
+
+## できること
+
+| 頼み方 | すること |
+|---|---|
+| 「このファイル、出して大丈夫か検査して」 | ★中身を見せずに検査。件数と判定だけ返ります |
+| 「これ、記録しておいて」 | 1行だけ書き留めます |
+| 「振り返って」 | ★**同じことを3回したら「決まりごとにする番です」**と出ます |
+| 「片づけて」 | 散らかりを診ます。★**消しません。寄せるだけで、戻せます** |
+| 「棚を見せて」 | サプリを選んで入れる／外す |
+| 「新しくして」 | ★**あなたが書き換えたものには触りません** |
+
+---
+
+## 大事にしていること
+
+- ★**消しません。** 外すときも、片づけるときも、移すだけです。あとで戻せます
+- ★**書き換えたものには触りません。** 育てたものは、あなたのものです
+- ★**記録はあなたの手元のテキストです。** この道具が使えなくなっても、メモ帳で読めます
+- ★**「0件」は「安全」という意味ではありません。** この検査で出なかった、という意味です
+
+---
+
+## 気をつけていただきたいこと
+
+この道具を通したことは、**安全の証明にはなりません**。
+機械が見ているのは決められた形だけで、形が違えば見つかりません。
+
+★**最後に判断するのは、いつでも人です。**
+
+---
+
+## お問い合わせ
+
+株式会社ホライズンワークス

package/env.js

@@ -0,0 +1,83 @@
+/**
+ * 下ごしらえ（Node / Python / Playwright / Google）
+ *
+ * ★2026-08-21 主「Playwright を Node と Python と同じタイミングで使えるようにしてほしい」
+ *
+ * ★なぜ Playwright が要るか
+ *   見た目を直すとき、**測るだけだと静かに嘘をつく**。画は嘘をつかない。
+ *   （→ tooling-check「見た目を直しているときは、まずスクリーンショットを1枚撮って目で見る」）
+ *
+ * ★案内は**次の一手だけ**返す。手順が5つを超えると、人はそこで止まる。
+ */
+const { execFileSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const run = (cmd, args) => {
+  try {
+    return execFileSync(cmd, args, { encoding: 'utf8', timeout: 20000, stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+  } catch (_) { return null; }
+};
+const win = process.platform === 'win32';
+
+function look() {
+  const node = process.version;
+  const py = run(win ? 'py' : 'python3', ['--version']) || run('python', ['--version']);
+  let pw = null;
+  try { require.resolve('playwright'); pw = 'あり（Node側）'; } catch (_) {}
+  if (!pw) { const v = run('npx', ['--no-install', 'playwright', '--version']); if (v) pw = v; }
+  let pwpy = null;
+  if (py) { const v = run(win ? 'py' : 'python3', ['-m', 'playwright', '--version']); if (v) pwpy = v; }
+  return { node, python: py, playwright: pw, playwright_python: pwpy };
+}
+
+/**
+ * ★足りないものを、順に1つだけ案内する。
+ *   ぜんぶ並べると、いちばん重いところで止まって全部が進まなくなる。
+ */
+function guide(want) {
+  const s = look();
+  const 欲しいもの = (want && want.length) ? want : ['node', 'python', 'playwright'];
+  const 手順 = [];
+
+  const major = Number(String(s.node).replace('v', '').split('.')[0]);
+  if (!(major >= 18)) {
+    手順.push({
+      何が: 'Node.js が古いか、入っていません（いまは ' + s.node + '）',
+      どうする: 'https://nodejs.org/ja から LTS 版を入れてください',
+      重さ: '5分ほど',
+    });
+  }
+
+  if (欲しいもの.includes('python') && !s.python) {
+    手順.push({
+      何が: 'Python が入っていません',
+      どうする: win
+        ? 'https://www.python.org/downloads/ から入れてください（★「Add python.exe to PATH」に必ずチェック）'
+        : 'python3 を入れてください',
+      重さ: '5分ほど',
+      なぜ: '文字起こしなど、一部のサプリが使います',
+    });
+  }
+
+  if (欲しいもの.includes('playwright') && !s.playwright) {
+    手順.push({
+      何が: 'Playwright が入っていません',
+      どうする: '仕事のフォルダで：npm i -D playwright  そのあと：npx playwright install chromium',
+      重さ: '★ブラウザを落とすので5〜10分・数百MB',
+      なぜ: '★作った画面を**目で見て**確かめるためです。数字だけ見ていると、直したつもりで直っていないことがあります',
+    });
+  }
+
+  return {
+    いまの状態: s,
+    足りないもの: 手順.length,
+    次にすること: 手順.length ? 手順[0] : null,
+    このあと: 手順.length > 1 ? 手順.slice(1).map((h) => h.何が) : undefined,
+    note: 手順.length
+      ? '★1つずつで構いません。**全部そろっていなくても、番頭の他の道具は使えます。**'
+      : '✅ そろっています。',
+  };
+}
+
+module.exports = { look, guide };