magi-ai 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 多田龍正
+
+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.ja.md

@@ -0,0 +1,377 @@
+# MAGI System
+
+> **[English](./README.md)** | 日本語
+
+[![CI](https://github.com/ryu-tada/MAGI-system/actions/workflows/ci.yml/badge.svg)](https://github.com/ryu-tada/MAGI-system/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-v24+-green.svg)](https://nodejs.org/)
+[![Tests](https://img.shields.io/badge/tests-2135_passing-brightgreen.svg)](./test/)
+[![Soul Systems](https://img.shields.io/badge/soul_systems-20-blueviolet.svg)](#soul-system--magiに魂を宿す20のサブシステム)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
+
+**1つのAIでは足りないとき** — 3つのAIモデルが議論し、相互批評し、投票する。単体では見落とすものを検出する。
+
+> *Unofficial fan project inspired by Neon Genesis Evangelion. Not affiliated with Khara, Inc.*
+
+<p align="center">
+  <img src="docs/demo.gif" alt="MAGI System デモ — エヴァンゲリオン風TUI審議" width="700">
+</p>
+
+## 60秒で試す
+
+APIキー不要。エヴァンゲリオンTUIで録画済みの3体合議を体験:
+
+```bash
+npx magi-ai demo
+```
+
+本物の審議をする準備ができたら → [Quick Start](#quick-start)
+
+---
+
+## なぜマルチAI合議なのか
+
+どのAIモデルにも死角がある。Claudeは丁寧だが冗長、GPTは実用的だが過信しがち、Geminiは慎重だが曖昧になりやすい。**単一モデルに頼ると、そのバイアスは検出されないまま残る。**
+
+MAGIは意見の不一致を強制的に表面化させる。3つのモデルが独立に同じコードを分析し、2体がセキュリティ問題を指摘して1体が見逃した場合、その問題は本物だとわかる。全員一致なら、単体レビューより高い確信を持って行動できる。
+
+| 単一モデルレビュー | MAGI 3体レビュー |
+|-------------------|-----------------|
+| 1つの視点、1つのバイアス | 3つの視点、バイアスが相殺 |
+| 「問題なさそう」 | 2/3 APPROVE, 1 REJECT（反対意見記録） |
+| モデルを信用する | モデル同士が検証する |
+| サイレントな見落とし | 相互批評で看過を検出 |
+
+---
+
+## What is MAGI?
+
+新世紀エヴァンゲリオンのMAGIスーパーコンピュータは、赤木ナオコ博士の3つの人格がそれぞれ独立に判断し、合議で意思決定を行うシステム。
+
+本プロジェクトはその構造を再現し、3社の異なるAIモデルが同じ問題を異なる視点から分析する。モデル固有のバイアスを相互検証で排除し、単体では到達できない判断精度を目指す。
+
+| MAGI Unit | CLI Tool | Persona | Focus |
+|-----------|----------|---------|-------|
+| **MELCHIOR-1** | Claude Code (Anthropic) | 科学者 | 論理・整合性・構造化推論 |
+| **BALTHASAR-2** | Codex CLI (OpenAI) | 実装者 | 実装現実性・コード品質 |
+| **CASPER-3** | Gemini CLI (Google) | 審査者 | 安全性・リスク・俯瞰視点 |
+
+> **N体対応**: デフォルト3体だが、2〜7体の任意のAIユニットで審議可能。
+
+---
+
+## How It Works
+
+```
+Phase 1: INITIAL OPINION (並列実行)
+  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐
+  │  MELCHIOR   │  │  BALTHASAR  │  │   CASPER    │
+  │  (Claude)   │  │  (Codex)    │  │  (Gemini)   │
+  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘
+         └────── Promise.allSettled() ─────┘
+                          │
+              Early exit if unanimous
+                          │
+Phase 2: CROSS-EXAMINATION (並列実行)
+  各ユニットが他2体の意見を批評 → 立場の変更も可能
+                          │
+Phase 3: FINAL VOTE (並列実行)
+  全審議履歴を踏まえた最終投票 → Consensus Engine が判定
+                          │
+                  ┌───────▼───────┐
+                  │ MAGI DECISION │
+                  └───────────────┘
+```
+
+| 判定 | 条件 | 結果 |
+|------|------|------|
+| **全会一致** | 3/3 が同意 | 即採択 |
+| **多数決** | 2/3 が同意 | 採択（反対意見を記録） |
+| **デッドロック** | 全員不一致 | Tiebreak / Human-in-the-loop |
+| **定足数不足** | 2体以上がABSTAIN | 判定不能 |
+
+---
+
+## Use Cases
+
+| シナリオ | コマンド | MAGIの価値 |
+|----------|---------|------------|
+| PRコードレビュー | `magi review src/auth.ts` | 3モデルが異なるバグクラスを検出 |
+| アーキテクチャ決定 | `magi decide "PostgreSQL vs MongoDB?"` | 3つの視点から構造化されたpros/cons |
+| セキュリティ監査 | `magi deliberate "Audit this endpoint"` | 相互検証で偽陰性を削減 |
+| 技術的負債評価 | `/ops prophecy src/legacy/` | git履歴からランダムフォレスト予測 |
+| CI/CDゲート | `magi review --output json` | マージゲート用の機械可読コンセンサス |
+| チームの意見対立 | `magi decide "モノレポ移行?"` | 客観的な多角的仲裁 |
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- **Node.js v24+** (v20以上で動作)
+- 以下の3つのAI CLIがインストール・認証済みであること:
+
+<details>
+<summary><strong>Claude Code</strong> — MELCHIOR (Anthropic)</summary>
+
+```bash
+# インストール (どちらか一方)
+curl -fsSL https://claude.ai/install.sh | bash   # 推奨
+npm install -g @anthropic-ai/claude-code           # Node.js経由
+
+# 認証 — 初回起動でブラウザ認証が開く
+claude
+```
+
+Pro / Max / Teams / Enterprise いずれかの有料プランが必要。→ [公式ドキュメント](https://docs.anthropic.com/en/docs/claude-code)
+
+</details>
+
+<details>
+<summary><strong>Codex CLI</strong> — BALTHASAR (OpenAI)</summary>
+
+```bash
+# インストール
+npm install -g @openai/codex
+
+# 認証 — 初回起動でセットアップが始まる
+codex
+```
+
+ChatGPT Plus / Pro / Team / Enterprise いずれかのサブスクリプションが必要。→ [公式リポジトリ](https://github.com/openai/codex)
+
+</details>
+
+<details>
+<summary><strong>Gemini CLI</strong> — CASPER (Google)</summary>
+
+```bash
+# インストール
+npm install -g @google/gemini-cli
+
+# 認証 — 初回起動で「Sign in with Google」を選択
+gemini
+```
+
+Googleアカウントで無料利用可能 (60 req/min, 1,000 req/day)。→ [公式リポジトリ](https://github.com/google-gemini/gemini-cli)
+
+</details>
+
+### Install
+
+```bash
+npm install -g magi-ai
+```
+
+### Verify
+
+```bash
+magi doctor
+```
+
+```
+  ✓ MELCHIOR: 2.x.x (Claude Code)
+  ✓ BALTHASAR: codex-cli 0.x.x
+  ✓ CASPER: 0.x.x
+```
+
+### Start
+
+```bash
+magi
+```
+
+---
+
+## Usage
+
+起動するとNERVブートシーケンスが走り、対話的REPLが開始。自然言語で質問を入力するだけで3体合議が始まり、フルスクリーンTUIで審議過程がリアルタイム表示される。
+
+```
+  ╔════════════════════════════════════════════╗
+  ║          M A G I  S Y S T E M              ║
+  ║          REPL INTERFACE READY              ║
+  ╚════════════════════════════════════════════╝
+  Type a question to deliberate. /help for commands.
+
+MAGI[01|NORM|3/3|CTX:0]> 零号機の緊急出撃を承認すべきか
+  [フルスクリーンTUI起動 → NERVブート → 3体審議 → 結果表示]
+
+  ╔═══════════════════════════════════════════════╗
+  ║  MAGI DECISION: MAJORITY_APPROVE   CONF 82%   ║
+  ╠═══════════════════════════════════════════════╣
+  ║  MELCHIOR   ✓ APPROVE  ████████░░  84%        ║
+  ║  BALTHASAR  ✓ APPROVE  ██████████  95%        ║
+  ║  CASPER     ✗ REJECT   ██████░░░░  67%        ║
+  ╚═══════════════════════════════════════════════╝
+
+MAGI[02|NORM|3/3|CTX:1]> もうちょっと詳しく教えて
+  [前回のコンテキストが自動注入された状態で再審議]
+```
+
+自然言語でそのまま質問すれば審議が始まる。スラッシュコマンドで特殊な操作もできる:
+
+| コマンド | 動作 |
+|---------|------|
+| `/review <file>` | コードレビュー審議（Tab補完対応） |
+| `/decide <question>` | アーキテクチャ決定 |
+| `/berserk <prompt>` | 暴走モード（5戦略×N体デスマッチ） |
+| `/status` | システムダッシュボード |
+| `/export [file]` | 審議結果エクスポート |
+| `/ops watch start` | 使徒検知バックグラウンド開始 |
+| `/diag evolve` | S²エンジン自己進化 |
+| `/admin self-destruct <reason>` | 自爆シーケンス（全会一致必須） |
+| `/help` | 全コマンド一覧 |
+
+**コンテキスト持続:** 直近5件の審議サマリーが自動保持され、フォローアップの質問に前回の文脈が注入される。プロジェクトコンテキスト（git status、package.json、関連ファイル）も自動収集。
+
+### MCP Server (Claude Code Integration)
+
+`.mcp.json` がリポジトリ直下に配置済み。Claude Code を再起動すると `magi_deliberate`、`magi_review`、`magi_decide`、`magi_doctor` の4ツールが自動で使えるようになる。MCP Inspector で動作確認: `npx @modelcontextprotocol/inspector magi-mcp`
+
+### Programmatic API
+
+```typescript
+import { Magi } from 'magi-ai';
+
+const magi = new Magi();
+const result = await magi.deliberate({
+  type: 'code-review',
+  title: 'Review auth middleware',
+  artifacts: [{ type: 'file', path: 'src/auth.ts', content: '...', language: 'typescript' }],
+});
+
+console.log(result.consensus.decision); // => 'MAJORITY_APPROVE'
+```
+
+> CI/スクリプト向けの非対話コマンド (`magi deliberate`, `magi review`, `magi decide`) も利用可能。詳細は `magi --help`。
+
+---
+
+## Features
+
+### Evangelion TUI
+
+エヴァンゲリオン風フルスクリーンインターフェースがデフォルトで起動。NERVブートシーケンスから逆Y字型3パネルの投票可視化まで、原作の雰囲気を再現する。新規依存ゼロ（Raw ANSI + chalk）。
+
+- NERVブートシーケンス (~1.5秒)
+- 逆Y字型パネル — BALTHASAR(上中央), CASPER(左下), MELCHIOR(右下)
+- 呼吸アニメーション — thinking中のパネル枠がsin()曲線で明滅
+- カスケード投票リビール + 判定スタンプ（「可　決」「否　決」「膠　着」）
+- BERSERKフラッシュ — 暴走警告時に赤フラッシュ
+- 詳細オーバーレイ — `1`/`2`/`3`キーでユニット別reasoning閲覧
+
+### Soul System — MAGIに魂を宿す20のサブシステム
+
+エヴァンゲリオンの設定を技術的に意味のある形でマッピングした20のサブシステム:
+
+- **記憶・人格 (EngRam)** — TF-IDF類似検索、3層記憶、12次元ドリフト検知
+- **シンクロ率** — Beta分布ベイズ推定によるタスク適合度追跡
+- **A.T.フィールド** — 同調バイアスの定量検知と中和
+- **暴走モード (BERSERK)** — 5戦略×N体並列、fitness選択デスマッチ
+- **補完計画 (Instrumentality)** — MoA重み付き推論融合でデッドロック解決
+- **LCL** — フェーズ別情報密度制御 + 4種ハルシネーション検出・浄化
+- **使徒検知** — git差分ベース6種コード脅威パターン検出
+- **死海文書** — ランダムフォレスト(50木)による技術的負債予測
+- **666型防壁** — 4層多層防御ファイアウォール
+- **自爆シーケンス** — BFT f=0 全会一致による不可逆操作儀式
+- **S²エンジン** — 自己診断→改善提案→メタ合議の自己進化
+- **ゼーレ会議** — PBFT+Raft分散合議プロトコル
+- **Neon Genesis** — Fisher-Yates記憶生存による完全リセット
+
+### Security
+
+9層のセキュリティ硬化: Zodスキーマ入力バリデーション → プロンプトインジェクション防止(9パターン) → stdin配信+危険フラグ検出 → プロセスサンドボックス(ENV/CMD allowlist) → SafeOpinionSchema出力検証 → SHA-256ハッシュチェーン監査ログ → Semaphore+タイムアウト → リプレイ防止nonce → ランダムソルト暗号化
+
+### Auto-Context Collection
+
+審議時にプロジェクトコンテキスト（git status、package.json、ディレクトリツリー）と関連ファイル（import先、テストファイル）を自動収集して注入。`--no-auto-context` でオプトアウト可能。機密ファイル(.env, .key, credentials等)は自動除外。
+
+---
+
+## Architecture
+
+```
+MAGI-system/
+├── bin/                   # CLI entry points (magi, magi-mcp, magi-benchmark)
+├── src/
+│   ├── index.ts           # Public API (Magi class)
+│   ├── types/             # TypeScript types & Zod schemas
+│   ├── adapters/          # CLI wrappers (claude, codex, gemini)
+│   ├── engine/            # Core deliberation (kernel, consensus, middleware)
+│   │   ├── kernel/        #   Deliberation loop, phase runner, unit executor
+│   │   └── middleware/    #   Koa-style chain (cache, firewall)
+│   ├── parsers/           # Opinion extraction (JSON extractor, Zod schema, unstructured)
+│   ├── pipelines/         # Task-specific flows (code-review, architecture, bug-analysis)
+│   ├── tui/               # Evangelion full-screen TUI (raw ANSI, double-buffered)
+│   ├── repl/              # Interactive REPL (19 slash commands, state machine)
+│   ├── mcp/               # MCP server (4 tools, stdio transport)
+│   ├── context/           # Auto-context collection (git, imports, tests)
+│   ├── cache/             # SHA-256 keyed result cache with TTL
+│   ├── metrics/           # Token usage tracking
+│   ├── audit/             # SHA-256 hash chain audit logging
+│   └── utils/             # Shared utilities (process sandbox, file validation)
+├── test/                  # 2135 tests (vitest)
+│   ├── e2e/               #   E2E with real CLIs (MAGI_E2E=1 gated)
+│   ├── integration/       #   Orchestrator + TUI integration
+│   └── unit/              #   Per-module unit tests
+└── docs/                  # User-facing documentation
+```
+
+---
+
+## Development
+
+ソースから開発する場合:
+
+```bash
+git clone https://github.com/ryu-tada/MAGI-system.git
+cd MAGI-system
+npm install
+npm test              # 2135 tests
+npm run typecheck     # Type check
+npm run build         # Build
+```
+
+---
+
+## Documentation
+
+- [Practical Examples](docs/EXAMPLES.md) — 8 scenarios with commands and expected output
+- [Tuning Guide](docs/TUNING_GUIDE.md) — Configuration reference and optimization strategies
+- [Troubleshooting](docs/TROUBLESHOOTING.md) — Common issues and solutions
+- [Benchmark Results](docs/BENCHMARK_RESULTS.md) — スコアリングフレームワーク検証（実CLIで本番データ生成可能）
+- [Contributing](CONTRIBUTING.md) — Development setup, adding adapters/pipelines
+- [Changelog](CHANGELOG.md) — Release history
+
+---
+
+## Tech Stack
+
+- **Language**: TypeScript (ESM)
+- **Runtime**: Node.js v24+ (v20+ minimum)
+- **Dependencies**: commander, chalk, zod, @modelcontextprotocol/sdk
+- **Test**: Vitest (2135 tests)
+- **Dev**: tsx
+
+---
+
+## Credits & Legal
+
+> 「MAGIの回答は — 全会一致」
+> — 赤木リツコ, 新世紀エヴァンゲリオン
+
+MAGI System is inspired by the MAGI supercomputer system from *Neon Genesis Evangelion*, created by Hideaki Anno and produced by Gainax / Khara, Inc.
+
+### Disclaimer
+
+This is an **unofficial, non-commercial, fan-made** open-source project. It is not affiliated with, endorsed by, or connected to Khara, Inc. (株式会社カラー) or any official Evangelion production.
+
+*Neon Genesis Evangelion* and related names are copyrighted works of Khara, Inc. All rights reserved by their respective owners.
+
+---
+
+## License
+
+MIT — See [LICENSE](./LICENSE) for details.