@bonginkan/maria 1.0.2-alpha.2 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,1034 +1,210 @@
1
- # 🏗️ MARIA Platform - Internal Development Repository
1
+ # MARIA CODE - Advanced AGI Development Assistant
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/@bonginkan/maria.svg)](https://www.npmjs.com/package/@bonginkan/maria)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
3
5
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue)](https://www.typescriptlang.org/)
4
- [![pnpm](https://img.shields.io/badge/pnpm-10.14%2B-orange)](https://pnpm.io/)
5
6
  [![Node.js](https://img.shields.io/badge/Node.js-18%2B-green)](https://nodejs.org/)
6
- [![GCP](https://img.shields.io/badge/GCP-Integrated-4285F4)](https://cloud.google.com/)
7
- [![Neo4j](https://img.shields.io/badge/Neo4j-AuraDS-008CC1)](https://neo4j.com/)
8
7
 
9
- > ⚠️ **社内開発用プライベートリポジトリ** - Bonginkan Inc. Internal Use Only
8
+ 🤖 **MARIA CODE** is an advanced AGI (Artificial General Intelligence) development assistant that brings senior engineer-level capabilities to your terminal. With support for 14+ AI models, intelligent routing, and comprehensive development tools, MARIA transforms how you write, review, and deploy code.
10
9
 
11
- ## 📋 目次
12
-
13
- 1. [概要](#概要)
14
- 2. [アーキテクチャ](#アーキテクチャ)
15
- 3. [開発環境セットアップ](#開発環境セットアップ)
16
- 4. [プロジェクト構造](#プロジェクト構造)
17
- 5. [開発コマンド一覧](#開発コマンド一覧)
18
- 6. [機能詳細](#機能詳細)
19
- 7. [AI統合](#ai統合)
20
- 8. [インフラストラクチャ](#インフラストラクチャ)
21
- 9. [デプロイメント](#デプロイメント)
22
- 10. [トラブルシューティング](#トラブルシューティング)
23
-
24
- ## 概要
25
-
26
- **MARIA Platform**は、Bonginkan Inc.が開発する次世代AI開発プラットフォームです。
27
-
28
- ### 🎯 3つの主要プロダクト
29
-
30
- 1. **MARIA CODE** (`/src`, `/dist`, `/bin`)
31
- - 40+のインタラクティブコマンドを持つCLIツール
32
- - 22+ AIモデル対応(OpenAI, Anthropic, Google, xAI, Groq, Local LLMs)
33
- - 自然言語によるコード生成・レビュー・テスト
34
- - 🧠 **インテリジェントルーティング**: 自然言語を内部で適切なスラッシュコマンドに自動変換
35
- - ⚡ **インタラプト機能**: AI処理中でも新しい指示を即座に受付・優先処理
36
-
37
- 2. **MARIA STUDIO** (`packages/studio-app`)
38
- - Next.js 15 + React 19 RCベースのWebアプリケーション
39
- - リアルタイムコラボレーション機能
40
- - Paper/Slides/DevOpsエディタ
41
-
42
- 3. **MARIA API** (`packages/core-api`)
43
- - tRPC APIサーバー(7 routers実装済み)
44
- - Neo4j Graph Database統合
45
- - Firebase Auth + RBAC
46
-
47
- ### 🔗 関連リポジトリ
48
-
49
- - **OSS配布用**: https://github.com/bonginkan/maria (公開リポジトリ)
50
- - **開発用**: https://github.com/bonginkan/maria_code (このリポジトリ)
51
- - **ランディングページ**: https://maria-code.vercel.app
52
-
53
- ## アーキテクチャ
54
-
55
- ```mermaid
56
- graph TB
57
- subgraph "Frontend"
58
- A[MARIA STUDIO<br/>Next.js 15 App]
59
- B[MARIA CODE CLI<br/>TypeScript/Ink]
60
- C[Landing Page<br/>Next.js]
61
- end
62
-
63
- subgraph "Backend"
64
- D[tRPC API<br/>Cloud Run]
65
- E[AI Agents<br/>LangGraph]
66
- F[Dataflow Jobs<br/>Apache Beam]
67
- end
68
-
69
- subgraph "Data Layer"
70
- G[Firestore<br/>Real-time State]
71
- H[Spanner<br/>Version Control]
72
- I[Neo4j AuraDS<br/>Graph RAG]
73
- J[BigQuery<br/>Analytics]
74
- end
75
-
76
- subgraph "AI Services"
77
- K[Vertex AI<br/>Gemini 2.5 Pro/Flash]
78
- L[OpenAI API<br/>GPT-5/o3]
79
- M[Anthropic<br/>Claude Opus 4.1]
80
- N[xAI<br/>Grok 4]
81
- O[Groq<br/>Llama 3.1 70B + Mixtral 8x22B]
82
- P[Local LLMs<br/>LM Studio]
83
- end
84
-
85
- A --> D
86
- B --> D
87
- D --> E
88
- D --> G
89
- D --> H
90
- D --> I
91
- E --> K
92
- E --> L
93
- E --> M
94
- E --> N
95
- E --> O
96
- B --> P
97
- F --> J
98
- ```
99
-
100
- ## 開発環境セットアップ
101
-
102
- ### 必要要件
103
-
104
- - **Node.js**: 18.0.0以上
105
- - **pnpm**: 10.14.0以上
106
- - **Git**: 2.30以上
107
- - **Docker**: 20.10以上(オプション)
108
- - **GCP Account**: Cloud機能用
109
- - **Firebase Project**: 認証用
110
-
111
- ### 初期セットアップ
112
-
113
- ```bash
114
- # リポジトリのクローン
115
- git clone https://github.com/bonginkan/maria_code.git
116
- cd maria_code
117
-
118
- # 依存関係のインストール
119
- pnpm install
120
-
121
- # 環境変数の設定
122
- cp .env.example .env.local
123
- # .env.localを編集して必要な値を設定
124
-
125
- # ビルド
126
- pnpm build
127
-
128
- # 開発サーバー起動
129
- pnpm dev
130
- ```
131
-
132
- ### MARIAコマンドのグローバルインストール
10
+ ## 🚀 Quick Start
133
11
 
134
12
  ```bash
135
- # ローカルでビルド
136
- pnpm build
13
+ # Install globally
14
+ npm install -g @bonginkan/maria@latest
137
15
 
138
- # グローバルにリンク
139
- npm link
16
+ # Initialize in your project
17
+ maria init
140
18
 
141
- # 動作確認
142
- maria --version
19
+ # Start interactive mode
143
20
  maria chat
144
21
  ```
145
22
 
146
- ## 🌐 ランディングページ
147
-
148
- OSS配布用の美しいランディングページが用意されています。
149
-
150
- ### ローカル起動方法
151
- ```bash
152
- # ランディングページディレクトリへ移動
153
- cd maria-code-lp
154
-
155
- # 依存関係インストール
156
- pnpm install
157
-
158
- # 開発サーバー起動
159
- pnpm run dev
160
-
161
- # ブラウザでアクセス
162
- # http://localhost:3000
163
- ```
164
-
165
- ### デプロイ済みURL
166
- - **Production**: https://maria-code.vercel.app
167
- - **自動デプロイ**: Vercel (mainブランチ)
168
-
169
- ### 特徴
170
- - ダークモードのシンプルなデザイン
171
- - Google Material Icons使用
172
- - Next.js 14 + TypeScript
173
- - レスポンシブ対応
174
- - 40+コマンドの詳細な説明
175
- - インストール手順のワンクリックコピー
176
-
177
- ## プロジェクト構造
178
-
179
- ```
180
- maria_code/
181
- ├── 📁 src/ # MARIA CODE CLIソースコード
182
- │ ├── bin/ # CLIエントリポイント
183
- │ ├── cli.ts # メインCLIロジック
184
- │ ├── commands/ # CLIコマンド実装
185
- │ │ ├── chat.ts # インタラクティブチャット
186
- │ │ ├── code.tsx # AIコード生成
187
- │ │ ├── vision.tsx # 画像解析
188
- │ │ ├── review.tsx # コードレビュー
189
- │ │ ├── test.ts # テスト生成
190
- │ │ ├── video.tsx # ビデオ生成
191
- │ │ └── image.tsx # 画像生成
192
- │ ├── components/ # React/Inkコンポーネント
193
- │ ├── providers/ # AIプロバイダー実装
194
- │ │ ├── openai-provider.ts
195
- │ │ ├── anthropic-provider.ts
196
- │ │ ├── google-provider.ts
197
- │ │ ├── groq-provider.ts
198
- │ │ └── lmstudio-provider.ts
199
- │ ├── services/ # ビジネスロジック
200
- │ │ ├── ai-router.ts # AIモデル選択
201
- │ │ ├── slash-command-handler.ts
202
- │ │ ├── chat-context.service.ts
203
- │ │ ├── interactive-session.ts
204
- │ │ └── intelligent-router/ # 🧠 インテリジェントルーティング (全Phase実装済み✅)
205
- │ │ ├── intent-classifier.ts # 自然言語→コマンド変換エンジン
206
- │ │ ├── command-dispatcher.ts # 内部コマンド実行制御
207
- │ │ ├── context-manager.ts # 会話履歴とプロジェクト状態管理
208
- │ │ ├── interrupt-handler.ts # 処理中断と優先度制御
209
- │ │ ├── priority-queue.ts # タスクキューと並列実行管理
210
- │ │ ├── stream-processor.ts # ストリーミングレスポンス処理
211
- │ │ ├── learning-engine.ts # 学習エンジン(Phase 3)
212
- │ │ ├── multimodal-handler.ts # マルチモーダル対応(Phase 4)
213
- │ │ └── index.ts # 統合モジュール
214
- │ └── utils/ # ユーティリティ
215
-
216
- ├── 📁 dist/ # ビルド済みCLI
217
- │ ├── cli.js # メインCLIバンドル
218
- │ └── index.js # エクスポート
219
-
220
- ├── 📁 bin/ # 実行可能ファイル
221
- │ └── maria # CLIエントリポイント
222
-
223
- ├── 📁 packages/ # pnpmワークスペース
224
- │ ├── studio-app/ # Next.js Webアプリ
225
- │ │ ├── app/ # App Router
226
- │ │ ├── components/ # UIコンポーネント
227
- │ │ └── lib/ # ライブラリ
228
- │ ├── code-cli/ # CLI追加機能
229
- │ ├── core-api/ # tRPC APIサーバー
230
- │ │ ├── routers/ # APIエンドポイント
231
- │ │ └── services/ # ビジネスロジック
232
- │ ├── ai-agents/ # AIエージェント
233
- │ ├── dataflow-jobs/ # バッチ処理
234
- │ └── shared/ # 共有ライブラリ
235
-
236
- ├── 📁 maria-code-lp/ # ランディングページ
237
- │ ├── app/ # Next.js App Router
238
- │ └── components/ # UIコンポーネント
239
-
240
- ├── 📁 maria-oss/ # OSS配布用パッケージ
241
- │ ├── README.md # エンドユーザー向け
242
- │ ├── package.json # npm公開用
243
- │ └── dist/ # 配布用ビルド
244
-
245
- ├── 📁 infra/ # インフラストラクチャ
246
- │ ├── terraform/ # IaC定義
247
- │ │ ├── gcp/ # GCPリソース
248
- │ │ └── neo4j/ # Neo4j設定
249
- │ └── pipelines/ # CI/CDパイプライン
250
-
251
- ├── 📁 scripts/ # 開発スクリプト
252
- │ ├── setup-wizard.sh # セットアップウィザード
253
- │ ├── health-monitor.sh # ヘルスチェック
254
- │ └── auto-start-llm.sh # LLM自動起動
255
-
256
- ├── 📁 .github/ # GitHub設定
257
- │ ├── workflows/ # GitHub Actions
258
- │ │ ├── ci-cd.yml # CI/CDパイプライン
259
- │ │ ├── sync-to-oss.yml # OSS同期
260
- │ │ └── release.yml # リリース自動化
261
- │ └── CODEOWNERS # コードオーナー
262
-
263
- ├── 📄 package.json # ルートパッケージ
264
- ├── 📄 pnpm-workspace.yaml # モノレポ設定
265
- ├── 📄 turbo.json # Turborepo設定
266
- ├── 📄 tsconfig.json # TypeScript設定
267
- ├── 📄 .env.example # 環境変数テンプレート
268
- ├── 📄 CLAUDE.md # AI開発ガイド
269
- └── 📄 README.md # このファイル
270
- ```
271
-
272
- ## 開発コマンド一覧
273
-
274
- ### 🚀 基本コマンド
275
-
276
- ```bash
277
- # 開発サーバー
278
- pnpm dev # 全サービス起動
279
- pnpm dev:studio # Studio + API起動
280
- pnpm dev:api # APIのみ起動
281
- pnpm dev:cli # CLIウォッチモード
282
-
283
- # ビルド
284
- pnpm build # 全パッケージビルド
285
- pnpm build:studio # Studioビルド
286
- pnpm build:cli # CLIビルド
287
- pnpm build:oss # OSS配布用ビルド
288
-
289
- # テスト
290
- pnpm test # 全テスト実行
291
- pnpm test:coverage # カバレッジ付きテスト
292
- pnpm test:cli # CLIテストのみ
293
- pnpm test:e2e # E2Eテスト
294
-
295
- # コード品質
296
- pnpm lint # ESLintチェック
297
- pnpm lint:fix # ESLint自動修正
298
- pnpm typecheck # TypeScriptチェック
299
- pnpm format # Prettier整形
300
- pnpm contract:all # 契約検証
301
- ```
302
-
303
- ### 🎯 MARIA CLIコマンド(40+)
304
-
305
- #### 基本コマンド
306
- ```bash
307
- maria init # プロジェクト初期化
308
- maria chat # インタラクティブモード起動
309
- maria code "prompt" # AIコード生成
310
- maria vision img.png # 画像解析
311
- maria review # コードレビュー
312
- maria test # テスト生成
313
- maria commit # AIコミットメッセージ
314
- maria deploy # デプロイ実行
315
- ```
316
-
317
- #### 🧠 インテリジェントルーティング (自動変換)
318
- ```bash
319
- # 自然言語入力 → 内部で適切なコマンドを自動実行
320
- "動画を作って" → /video
321
- "画像を生成" → /image
322
- "このバグを修正" → /code fix
323
- "テスト書いて" → /test
324
- "レビューして" → /review
325
- "コミットして" → /commit
326
- ```
327
-
328
- #### メディア生成
329
- ```bash
330
- maria video "プロンプト" # AI動画生成
331
- maria image "プロンプト" # AI画像生成
332
- ```
333
-
334
- #### インタラクティブモードのスラッシュコマンド
335
- ```bash
336
- # ユーザー管理
337
- /login # ログイン
338
- /logout # ログアウト
339
- /status # ステータス表示
340
- /mode # モード切替
341
-
342
- # 設定・環境
343
- /config # 設定パネル
344
- /model # ✅ AIモデル選択(完璧に実装済み)
345
- /permissions # 権限管理
346
- /hooks # フック設定
347
- /doctor # システム診断
348
-
349
- # プロジェクト管理
350
- /init # MARIA.md初期化
351
- /add-dir # ディレクトリ追加
352
- /memory # メモリ編集
353
- /export # エクスポート
354
-
355
- # 会話・コスト
356
- /clear # 履歴クリア
357
- /compact # 要約
358
- /resume # 再開
359
- /cost # コスト表示
360
-
361
- # 開発支援
362
- /review # PRレビュー
363
- /pr-comments # PRコメント取得
364
- /bug # バグ報告
365
- /release-notes # リリースノート
366
-
367
- # メディア生成
368
- /video # 動画生成
369
- /image # 画像生成
370
-
371
- # UI
372
- /vim # Vimモード
373
- /help # ヘルプ
374
- /exit # 終了
375
- ```
376
-
377
- ### 🔧 開発用スクリプト
378
-
379
- ```bash
380
- # セットアップ
381
- ./scripts/setup-wizard.sh # 初期設定ウィザード
382
- ./scripts/health-monitor.sh check # ヘルスチェック
383
-
384
- # LLM管理
385
- ./scripts/auto-start-llm.sh start # LM Studio起動
386
- ./scripts/auto-start-llm.sh status # ステータス確認
387
-
388
- # ComfyUI (動画生成用)
389
- ./scripts/setup-comfyui.sh # ComfyUIセットアップ
390
- ./scripts/start-comfyui.sh # ComfyUI起動
391
-
392
- # テスト
393
- ./scripts/test-media-generation.sh # メディア生成テスト
394
- pnpm test:cli:all # 全CLIテスト
395
- ```
396
-
397
- ## 機能詳細
398
-
399
- ### 🤖 MARIA CODE CLI
400
-
401
- #### 🎯 最大の特徴: 40個のスラッシュコマンド
402
-
403
- `maria`コマンドで即座にインタラクティブチャット開始。すべての機能がスラッシュコマンドで操作可能。
404
-
405
- #### ✅ 全Phase実装完了!インテリジェントルーティングシステム
406
-
407
- ##### 📂 実装済みモジュール
408
-
409
- **Phase 1: 内部スラッシュコマンド自動起動** ✅
410
- 1. `intent-classifier.ts` - 自然言語→コマンド変換エンジン
411
- 2. `command-dispatcher.ts` - 内部コマンド実行制御
412
- 3. `context-manager.ts` - 会話履歴とプロジェクト状態管理
413
-
414
- **Phase 2: インタラプト&リアルタイム処理** ✅
415
- 4. `interrupt-handler.ts` - 処理中断と優先度制御
416
- 5. `priority-queue.ts` - タスクキューと並列実行管理
417
- 6. `stream-processor.ts` - ストリーミングレスポンス処理
418
-
419
- **Phase 3: アダプティブラーニング** ✅
420
- 7. `learning-engine.ts` - ユーザーの使用パターンを学習し最適化
421
-
422
- **Phase 4: マルチモーダル対応** ✅
423
- 8. `multimodal-handler.ts` - 音声・画像・ジェスチャー入力対応
424
-
425
- ##### 🚀 実装済み機能
426
-
427
- **自然言語→コマンド自動変換:**
428
- - "動画を作って" → `/video`
429
- - "画像を生成" → `/image`
430
- - "バグ修正" → `/code fix`
431
- - "テスト書いて" → `/test`
432
-
433
- **リアルタイム処理:**
434
- - Ctrl+C対応の処理中断
435
- - 優先度ベースのタスクキュー
436
- - ストリーミングレスポンス
437
- - バックプレッシャー制御
438
-
439
- **コンテキスト認識:**
440
- - プロジェクトタイプ自動検出
441
- - 会話履歴の継続性維持
442
- - ユーザープロファイル学習
443
- - エラーパターン記録
444
-
445
- **Phase 3: 学習エンジン機能:**
446
- - 使用パターン記録とコマンド成功率追跡
447
- - 頻発エラーの検出と修正提案
448
- - 生産性の高い時間帯を特定
449
- - コンテキストから次のコマンドを予測
450
- - 使用頻度に基づく自動補完強化
451
- - 実行時間の長いコマンドを検出し最適化
452
-
453
- **Phase 4: マルチモーダル機能:**
454
- - 🎤 音声入力: ウェイクワード検出、音声→テキスト変換
455
- - 📸 画像解析: スクリーンショット、スケッチ、フローチャート→コード生成
456
- - 📁 ドラッグ&ドロップ: ファイルタイプ自動検出とバッチ処理
457
- - 👆 ジェスチャー認識: スワイプ、ピンチ、タップをコマンドに変換
458
- - 🎨 UIモックアップ→React: 画像からコンポーネント自動生成
459
-
460
- ```bash
461
- maria # 美しいASCIIロゴと共にインタラクティブチャット開始
462
- # 入力欄から40個のスラッシュコマンドを即座に実行可能
463
- ```
464
-
465
- **主要なスラッシュコマンド:**
466
- - `/code` - AIコード生成
467
- - `/test` - テスト生成・実行
468
- - `/review` - コードレビュー
469
- - `/video` - AI動画生成
470
- - `/image` - AI画像生成
471
- - `/init` - プロジェクト初期化
472
- - `/help` - 全40コマンド表示
473
-
474
- #### インタラクティブルーターシステム
475
- - **自然言語理解**: 開発者の意図を解析し最適なコマンドにルーティング
476
- - **コンテキスト認識**: 会話履歴とプロジェクト状態を利用
477
- - **マルチステップ実行**: 複雑なタスクを実行可能なステップに分解
478
- - **オートモード**: 自然言語→自動コマンド実行
479
- - **インタラプト機能**: AI処理中でも新しい指示を即座に優先処理 ✨ NEW
480
-
481
- #### インタラプト機能 ✨ NEW
482
- AI回答中でも新しい指示を入力可能。処理を中断し、新しい指示を優先的に実行します。
483
-
484
- **✅ 実装内容:**
485
-
486
- 1. **処理中断メカニズム**
487
- - `isProcessing`フラグで処理状態を管理
488
- - `processingTimeout`で非同期処理を制御
489
- - 新しい入力で`interruptProcessing()`を呼び出し
490
-
491
- 2. **優先順位判定ロジック**
492
- - 追加情報キーワード検出(「また」「さらに」「and」「also」など)
493
- - 矛盾する場合は新しい指示を優先
494
- - 追加情報は既存処理に統合
495
-
496
- 3. **AIへのプロンプト調整**
497
- ```
498
- // 優先指示の場合
499
- "User interrupted with new priority request. Focus on this new request instead."
500
-
501
- // 追加情報の場合
502
- "User provided additional information. Incorporate this with the previous request."
503
- ```
504
-
505
- 4. **ユーザーフィードバック**
506
- - `[Interrupted - Processing new request]`
507
- - `[Overriding previous request]` または `[Treating as additional information]`
508
-
509
- **📝 使用方法:**
510
-
511
- ```bash
512
- # 基本的な使い方
513
- > Create a REST API for users
514
- Thinking...
515
- > Actually, make it GraphQL instead # 処理中に新しい指示
516
- [Interrupted - Processing new request]
517
- [Overriding previous request]
518
- Based on your new request: Creating GraphQL API...
519
-
520
- # 追加情報の場合
521
- > Create a user authentication system
522
- Thinking...
523
- > Also add OAuth support # "also"で追加と判定
524
- [Interrupted - Processing new request]
525
- [Treating as additional information]
526
- Considering the additional info: Creating auth system with OAuth...
527
- ```
528
-
529
- **🔧 技術詳細:**
530
- - Ctrl+C対応: 処理中のみ中断、それ以外は終了確認
531
- - タイムアウト管理: clearTimeoutで確実にクリーンアップ
532
- - コンテキスト管理: systemロールでAIに優先順位を伝達
533
- - 言語対応: 日本語・英語両方のキーワードに対応
23
+ ## Key Features
534
24
 
535
- #### ベースナレッジシステム
536
- - **プロジェクト理解**: コードベース構造、依存関係、パターンを学習
537
- - **セマンティック検索**: コードとドキュメントの自然言語クエリ
538
- - **パターンメモリー**: 一般的なコードパターンの認識と提案
539
- - **永続学習**: セッション間で知識を.maria-memory.mdに保持
25
+ ### 🧠 Interactive Router System
26
+ - **Natural Language Understanding**: Interprets developer intentions and automatically routes to optimal commands
27
+ - **Context Awareness**: Uses conversation history and project state for intelligent decision making
28
+ - **Multi-Step Execution**: Decomposes complex tasks into executable steps
29
+ - **Auto Mode**: Natural language → Automatic command execution
540
30
 
541
- #### 📋 MARIA.md - AI開発設計書
31
+ ### 🤖 Multi-Model AI Support
32
+ - **Cloud Providers**: OpenAI GPT-4o, Anthropic Claude, Google Gemini, Groq
33
+ - **Local Models**: LM Studio, vLLM, Ollama (GPT-OSS, Qwen, Mistral)
34
+ - **Automatic Fallback**: Seamlessly switches between providers
35
+ - **Task-Based Selection**: Chooses optimal model for each task type
542
36
 
543
- `/init`コマンドで自動生成される、プロジェクトの包括的な開発設計書。
37
+ ### 🎬 Media Generation
38
+ - **Video Generation**: Text-to-Video and Image-to-Video with Wan 2.2
39
+ - **Image Generation**: High-quality images with Qwen-Image
40
+ - **Batch Processing**: Generate multiple variations
41
+ - **Resolution Control**: 720p/1080p video, up to 1024x1024 images
544
42
 
545
- **特徴:**
546
- - **自動解析**: コードベース全体を解析し、プロジェクトの意図を理解
547
- - **配置**: プロジェクトルートに`MARIA.md`として生成
548
- - **Claude Code互換**: CLAUDE.mdと同様の形式でAIアシスタントにコンテキスト提供
43
+ ### ⚡ Development Tools
44
+ - **Code Generation**: Create entire features with context awareness
45
+ - **Code Review**: Comprehensive analysis with actionable suggestions
46
+ - **Test Generation**: Unit, integration, and E2E tests
47
+ - **Smart Commits**: AI-generated conventional commit messages
549
48
 
550
- **生成される内容:**
551
- - プロジェクトの目的と概要
552
- - アーキテクチャ設計
553
- - 開発指針とベストプラクティス
554
- - SOW (Statement of Work)
555
- - 技術スタック詳細
556
- - API仕様
557
- - データベース設計
558
- - テスト戦略
559
- - デプロイメント手順
49
+ ## 📚 Commands
560
50
 
561
- **使用方法:**
51
+ ### Core Commands
562
52
  ```bash
563
- maria # インタラクティブモード起動
564
- /init # MARIA.md自動生成
53
+ maria init # Initialize MARIA in your project
54
+ maria chat # Interactive mode (40+ slash commands)
55
+ maria code "prompt" # Generate code with AI
56
+ maria vision image.png # Analyze images with vision models
57
+ maria review # Review code changes
58
+ maria test # Generate tests
59
+ maria commit # Create AI commit messages
565
60
  ```
566
61
 
567
- #### 🚀 /model 機能 - 完璧実装済み ✅
568
-
569
- **MARIA CODEの最重要機能の一つ:AIモデル選択機能**
570
-
571
- ##### 🔧 実装内容詳細
572
-
573
- **ローカルモデル選択時のフロー**
574
-
575
- 1. ✅ LM Studio接続確認 (localhost:1234)
576
- 2. ✅ 接続失敗時の詳細なエラー指示
577
- 3. ✅ モデル自動ローディング(プログレス表示付き)
578
- 4. ✅ ローディング成功/失敗の明確な通知
579
- 5. ✅ AIプロバイダーのlmstudioへの切り替え
580
-
581
- **クラウドモデル選択時のフロー**
582
-
583
- 1. ✅ モデルIDからプロバイダー自動判定
584
- - gpt-*, o3 → openai
585
- - claude-* → anthropic
586
- - gemini-* → google
587
- - grok-* → xai
588
- - llama-*, mixtral-* → groq
589
- 2. ✅ 即座にプロバイダー切り替え
590
- 3. ✅ ステータス表示でプロバイダー確認
591
-
592
- **AI即時利用統合**
593
-
594
- - ✅ /codeコマンド: 選択したプロバイダーで即座にコード生成
595
- - ✅ /testコマンド: 選択したプロバイダーで即座にテスト生成
596
- - ✅ /statusコマンド: プロバイダー状況を詳細表示
597
-
598
- ##### 🧪 動作確認
599
-
600
- **成功テスト**
601
-
602
- - ✅ 構文チェック: パス
603
- - ✅ CLI起動: 正常
604
- - ✅ インタラクティブUI: 実装済み
605
- - ✅ モデル表示: 完璧
606
- - ✅ 選択機能: 上下キー + Enter
607
- - ✅ 現在モデル表示: *マーク
608
-
609
- **実装済みユーザーエクスペリエンス**
610
-
62
+ ### Media Generation
611
63
  ```bash
612
- # ローカルモデル選択時
613
- 🔄 Switching to GPT-OSS 120B (LM Studio)...
614
- 🔍 Checking LM Studio connection...
615
- ✅ LM Studio connected
616
- 🚀 Loading GPT-OSS 120B...
617
- This may take a few moments for large models...
618
- ✅ GPT-OSS 120B loaded successfully
619
-
620
- 🤖 AI Provider Status:
621
- Provider: lmstudio
622
- Model: gpt-oss-120b
623
-
624
- 🚀 Ready for /code, /test, and other AI commands
64
+ maria video "A futuristic city" # Generate AI video
65
+ maria image "Abstract art" # Generate AI image
625
66
  ```
626
67
 
627
- ##### 📊 実装達成率
628
-
629
- | 機能 | 実装状況 | 達成率 |
630
- |-----------------|----------|------|
631
- | 1. 表示 | ✅ 完璧 | 100% |
632
- | 2. 現在モデル表示 | ✅ 完璧 | 100% |
633
- | 3. 選択(上下+Enter) | ✅ 完璧 | 100% |
634
- | 4. 即時切り替え | ✅ 完璧 | 100% |
635
- | 5. ローカル即時起動 | ✅ 新規実装完了 | 100% |
636
- | 6. AI即時利用 | ✅ 新規実装完了 | 100% |
637
-
638
- ##### 🎯 結果
639
-
640
- MARIA CODEの/model機能は現在完璧に動作します!
641
-
642
- - ✅ 全6項目完全実装
643
- - ✅ エラーハンドリング完備
644
- - ✅ ユーザーフィードバック充実
645
- - ✅ プロダクション品質
68
+ ### Interactive Slash Commands
69
+ In `maria chat` mode, use these commands:
646
70
 
647
- ユーザーはクラウドとローカルモデルを自由に選択し、即座にAI機能(/code, /test等)を利用できます。LM Studioが起動していない場合も明確な指示が表示され、ユーザーエクスペリエンスが大幅に向上しました。
71
+ - `/help` - Show all commands
72
+ - `/status` - System status
73
+ - `/model` - Select AI model
74
+ - `/clear` - Clear conversation
75
+ - `/config` - Configuration panel
76
+ - `/video` - Generate video
77
+ - `/image` - Generate image
78
+ - `/pr-comments` - Analyze PR comments
79
+ - `/review` - Execute PR review
80
+ - `/exit` - Exit interactive mode
648
81
 
649
- #### AIモデル設定 - August 2025 Latest ✨
650
- ```typescript
651
- // クラウドモデル (10モデル)
652
- const cloudModels = {
653
- openai: {
654
- 'gpt-5': { context: 256000, use: '🔥 Latest flagship - 最高性能' },
655
- 'gpt-5-mini': { context: 128000, use: '軽量・高速版' },
656
- 'o3': { context: 128000, use: '🧠 推論特化モデル' }
657
- },
658
- anthropic: {
659
- 'claude-opus-4.1': { context: 200000, use: '🎯 最新Claude - 長文処理' },
660
- 'claude-4-sonnet': { context: 200000, use: '⚡ コーディング特化' }
661
- },
662
- google: {
663
- 'gemini-2.5-pro': { context: 1000000, use: '🚀 推論強化・マルチモーダル' },
664
- 'gemini-2.5-flash': { context: 1000000, use: '⚡ 適応思考・費用対効果' },
665
- 'gemini-2.5-flash-lite': { context: 1000000, use: '💨 高スループット' }
666
- },
667
- xai: {
668
- 'grok-4': { context: 128000, use: '🤖 リアルタイムWeb情報' }
669
- },
670
- meta: {
671
- 'llama-4-405b': { context: 128000, use: '🦙 GPT-5競合・オープンソース' }
672
- },
673
- mistral: {
674
- 'mistral-large-3': { context: 128000, use: '🇫🇷 ヨーロッパAI' }
675
- }
676
- }
82
+ ## 🔧 Configuration
677
83
 
678
- // ローカルモデル (12モデル) - 全て32Kコンテキスト設定済み
679
- const localModels = {
680
- lmstudio: {
681
- 'qwen-3-72b': { context: 32768, vram: '~36GB', use: '🏆 最高のローカルモデル' },
682
- 'deepseek-v3-67b': { context: 32768, vram: '~34GB', use: '🔍 コード特化' },
683
- 'code-llama-70b': { context: 32768, vram: '~35GB', use: '💻 Meta製コーディング' },
684
- 'phi-4-14b': { context: 32768, vram: '~8GB', use: '🎯 Microsoft効率モデル' },
685
- 'llama-4-8b': { context: 32768, vram: '~5GB', use: '🦙 小型だが高性能' },
686
- 'mistral-7b-v0.3': { context: 32768, vram: '~4GB', use: '⚡ 超高速推論' }
687
- },
688
- ollama: {
689
- 'qwen2.5-vl': { context: 8192, vram: '~8GB', use: '📸 ビジョンタスク特化' }
690
- }
691
- }
692
- ```
693
-
694
- ### 🌐 MARIA STUDIO
84
+ MARIA uses `.maria-code.toml` for configuration:
695
85
 
696
- #### 技術スタック
697
- - **Frontend**: Next.js 15 (App Router) + React 19 RC
698
- - **Styling**: Tailwind CSS + shadcn/ui
699
- - **State**: Zustand + React Query
700
- - **Auth**: Firebase Auth + カスタムRBAC
86
+ ```toml
87
+ [project]
88
+ name = "my-project"
89
+ type = "typescript"
701
90
 
702
- #### 主要機能
703
- 1. **Paper Editor**: アカデミック論文作成
704
- 2. **Slides Editor**: プレゼンテーション作成
705
- 3. **DevOps Console**: インフラ管理
706
- 4. **Graph Viewer**: Neo4j Bloom統合
91
+ [ai]
92
+ default_provider = "openai"
93
+ fallback_provider = "local"
707
94
 
708
- ### 🔌 MARIA API
95
+ [ai.providers.openai]
96
+ api_key = "${OPENAI_API_KEY}"
97
+ model = "gpt-4o"
709
98
 
710
- #### tRPCルーター (7実装済み)
711
- ```typescript
712
- // packages/core-api/routers/
713
- auth // 認証、プロファイル、設定、チーム管理
714
- papers // Paper CRUD、バージョン管理、共同編集
715
- slides // プレゼンテーションCRUD、AI生成、Google Slides統合
716
- projects // プロジェクト管理、メンバー管理、統計
717
- chat // AIチャットセッション、履歴管理
718
- conversation // RTF分析、タスクプラン作成、SOW生成
719
- graph // Neo4j統合、Bloom統合
99
+ [ai.providers.local]
100
+ endpoint = "http://localhost:1234"
101
+ model = "gpt-oss-20b"
720
102
  ```
721
103
 
722
- #### セキュリティ
723
- - Firebase Auth認証
724
- - RBAC (admin/editor/viewer)
725
- - Rate Limiting
726
- - IP制限
727
- - CORS設定
728
-
729
- ## AI統合
730
-
731
- ### 🎬 動画生成 (Wan 2.2)
104
+ ## 🌟 Example Usage
732
105
 
106
+ ### Create a REST API
733
107
  ```bash
734
- # Text-to-Video
735
- maria video "夕焼けの中を走る赤いスポーツカー" --model wan22-14b
736
-
737
- # Image-to-Video
738
- maria video "カメラがゆっくりズームアウト" --input-image photo.jpg
739
-
740
- # 高品質設定
741
- maria video "二匹の猫がダンス" --resolution 1080p --fps 30 --frames 81
108
+ maria code "Create a REST API with user authentication" --language typescript
742
109
  ```
743
110
 
744
- ### 🖼️ 画像生成 (Qwen-Image)
745
-
111
+ ### Generate Tests
746
112
  ```bash
747
- # 基本生成
748
- maria image "未来都市の夜景、ネオン、サイバーパンク"
749
-
750
- # スタイル指定
751
- maria image "賢い老魔法使いの肖像" --style photorealistic --size 1024x1024
752
-
753
- # バッチ生成
754
- maria image "ロゴデザインコンセプト" --batch 4 --variations 3
113
+ maria test src/ --framework jest --coverage
755
114
  ```
756
115
 
757
- ### 🧠 コンテキスト管理
758
-
759
- ```typescript
760
- // ChatContextService設定
761
- const contextService = ChatContextService.getInstance({
762
- maxTokens: 128000, // コンテキストサイズ
763
- compressionThreshold: 0.8, // 圧縮開始閾値
764
- summaryTokenLimit: 2000, // 最大要約サイズ
765
- persistPath: '~/.maria/context'
766
- });
767
-
768
- // /clearコマンドオプション
769
- /clear # 通常クリア(統計表示付き)
770
- /clear --soft # 表示のみクリア(コンテキスト保持)
771
- /clear --hard # 完全リセット
772
- /clear --summary # 要約生成してクリア
773
- ```
774
-
775
- ## インフラストラクチャ
776
-
777
- ### GCPリソース
778
-
779
- ```hcl
780
- // infra/terraform/gcp/main.tf
781
- resource "google_project" "maria_code" {
782
- name = "maria-code"
783
- project_id = "maria-code"
784
- }
785
-
786
- // Cloud Run
787
- resource "google_cloud_run_service" "api" {
788
- name = "maria-api"
789
- location = "asia-northeast1"
790
- }
791
-
792
- // Vertex AI
793
- resource "google_vertex_ai_endpoint" "gemini" {
794
- display_name = "maria-gemini-endpoint"
795
- model = "gemini-2.5-pro"
796
- }
797
-
798
- // Firestore
799
- resource "google_firestore_database" "main" {
800
- name = "maria-firestore"
801
- location_id = "asia-northeast1"
802
- }
803
- ```
804
-
805
- ### Neo4j AuraDS
806
-
807
- ```typescript
808
- // Neo4j設定
809
- const neo4jConfig = {
810
- instanceId: "4234c1a0",
811
- uri: "neo4j+s://4234c1a0.databases.neo4j.io",
812
- constraints: 5,
813
- indexes: 14
814
- }
815
-
816
- // JWT認証 (15分有効)
817
- const jwtConfig = {
818
- secret: process.env.NEO4J_BLOOM_JWT_SECRET,
819
- expiresIn: '15m',
820
- algorithm: 'HS256'
821
- }
822
- ```
823
-
824
- ## デプロイメント
825
-
826
- ### 🚀 環境別デプロイ
827
-
828
- ```bash
829
- # 開発環境
830
- pnpm deploy:dev
831
-
832
- # ステージング環境
833
- pnpm deploy:staging
834
-
835
- # 本番環境
836
- pnpm deploy:prod
837
-
838
- # Cloud Buildトリガー
839
- gcloud builds submit --config=cloudbuild.yaml
840
- ```
841
-
842
- ### 📦 OSS配布
843
-
844
- ```bash
845
- # OSS用ビルド
846
- pnpm build:oss
847
-
848
- # mariaリポジトリへ同期 (自動)
849
- # mainブランチへのpush時に.github/workflows/sync-to-oss.ymlが実行
850
-
851
- # 手動同期
852
- gh workflow run sync-to-oss.yml
853
-
854
- # npm公開
855
- pnpm publish:oss
856
- ```
857
-
858
- ### 🔄 CI/CDパイプライン
859
-
860
- ```yaml
861
- # .github/workflows/ci-cd.yml
862
- name: CI/CD Pipeline
863
-
864
- on:
865
- push:
866
- branches: [main]
867
- pull_request:
868
- branches: [main]
869
-
870
- jobs:
871
- test:
872
- runs-on: ubuntu-latest
873
- steps:
874
- - uses: actions/checkout@v4
875
- - uses: pnpm/action-setup@v2
876
- - run: pnpm install
877
- - run: pnpm lint
878
- - run: pnpm typecheck
879
- - run: pnpm test
880
- - run: pnpm build
881
- ```
882
-
883
- ## トラブルシューティング
884
-
885
- ### よくある問題と解決方法
886
-
887
- #### 1. mariaコマンドが動作しない
888
-
116
+ ### AI Video Generation
889
117
  ```bash
890
- # 権限を確認
891
- chmod +x bin/maria
892
-
893
- # パスを確認
894
- which maria
895
-
896
- # エイリアスを設定
897
- alias maria='/Users/bongin_max/maria_code/bin/maria'
898
-
899
- # ビルドを再実行
900
- pnpm build
118
+ maria video "A red sports car racing through mountains" --model wan22-14b
901
119
  ```
902
120
 
903
- #### 2. punycode deprecation警告
904
-
121
+ ### Code Review
905
122
  ```bash
906
- # bin/mariaで既に対応済み
907
- # NODE_NO_WARNINGS=1が設定されている
123
+ maria review --diff --suggestions --severity warning
908
124
  ```
909
125
 
910
- #### 3. LM Studioが接続できない
126
+ ## 📦 Installation Options
911
127
 
912
128
  ```bash
913
- # LM Studioが起動しているか確認
914
- curl http://localhost:1234/v1/models
129
+ # Latest stable
130
+ npm install -g @bonginkan/maria@latest
915
131
 
916
- # 自動起動スクリプトを使用
917
- ./scripts/auto-start-llm.sh start
918
- ```
132
+ # Development version
133
+ npm install -g @bonginkan/maria@alpha
919
134
 
920
- #### 4. TypeScriptエラー
135
+ # Beta version
136
+ npm install -g @bonginkan/maria@beta
921
137
 
922
- ```bash
923
- # 型チェック
924
- pnpm typecheck
925
-
926
- # node_modulesを再インストール
927
- rm -rf node_modules pnpm-lock.yaml
928
- pnpm install
138
+ # Run without installing
139
+ npx @bonginkan/maria@latest
929
140
  ```
930
141
 
931
- #### 5. ビルドエラー
142
+ ## 🔌 AI Provider Setup
932
143
 
144
+ ### OpenAI
933
145
  ```bash
934
- # クリーンビルド
935
- pnpm clean
936
- pnpm build
937
-
938
- # Turboキャッシュをクリア
939
- rm -rf .turbo
940
- pnpm build
146
+ export OPENAI_API_KEY=your_key
941
147
  ```
942
148
 
943
- ## 📚 追加ドキュメント
944
-
945
- - [CLAUDE.md](./CLAUDE.md) - AI開発ガイド
946
- - [CONTRIBUTING.md](./CONTRIBUTING.md) - コントリビューションガイド
947
- - [SECURITY.md](./SECURITY.md) - セキュリティポリシー
948
- - [CHANGELOG.md](./CHANGELOG.md) - 変更履歴
949
-
950
- ## 🔐 セキュリティ
951
-
952
- ### 環境変数管理
953
-
149
+ ### Anthropic
954
150
  ```bash
955
- # 必須環境変数
956
- OPENAI_API_KEY= # OpenAI APIキー
957
- ANTHROPIC_API_KEY= # Anthropic APIキー
958
- GOOGLE_AI_API_KEY= # Google AI APIキー
959
- GROQ_API_KEY= # Groq APIキー
960
-
961
- # Firebase
962
- NEXT_PUBLIC_FIREBASE_API_KEY=
963
- NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
964
- NEXT_PUBLIC_FIREBASE_PROJECT_ID=
965
-
966
- # Neo4j
967
- NEO4J_URI=
968
- NEO4J_USER=
969
- NEO4J_PASSWORD=
970
- NEO4J_BLOOM_JWT_SECRET=
971
-
972
- # GCP
973
- MARIA_PROJECT_ID=maria-code
974
- VERTEX_TOKEN=
151
+ export ANTHROPIC_API_KEY=your_key
975
152
  ```
976
153
 
977
- ### アクセス制御
978
-
979
- - GitHub Branch Protection設定済み
980
- - CODEOWNERS設定済み
981
- - 2段階認証必須
982
- - 署名付きコミット推奨
154
+ ### Local Models (LM Studio)
155
+ 1. Download [LM Studio](https://lmstudio.ai)
156
+ 2. Load a model (e.g., GPT-OSS, Mistral)
157
+ 3. Start the server
158
+ 4. MARIA auto-detects at `http://localhost:1234`
983
159
 
984
- ## 📞 サポート
160
+ ## 🎯 Use Cases
985
161
 
986
- ### 社内連絡先
162
+ ### For Developers
163
+ - Generate boilerplate code instantly
164
+ - Review code for best practices
165
+ - Create comprehensive test suites
166
+ - Debug complex issues with AI assistance
987
167
 
988
- - **開発チーム**: dev@bonginkan.ai
989
- - **インフラチーム**: infra@bonginkan.ai
990
- - **セキュリティチーム**: security@bonginkan.ai
168
+ ### For Teams
169
+ - Standardize commit messages
170
+ - Automate code reviews
171
+ - Generate documentation
172
+ - Create consistent APIs
991
173
 
992
- ### 緊急時対応
174
+ ### For Learning
175
+ - Understand new codebases quickly
176
+ - Learn best practices
177
+ - Get explanations for complex code
178
+ - Practice with AI pair programming
993
179
 
994
- 1. **システム障害**: PagerDutyアラート
995
- 2. **セキュリティインシデント**: security@bonginkan.ai
996
- 3. **データ損失**: バックアップからの復旧手順書参照
180
+ ## 🛠️ System Requirements
997
181
 
998
- ## 📈 メトリクス・モニタリング
182
+ - **Node.js**: 18.0.0 or higher
183
+ - **OS**: macOS, Linux, Windows (WSL recommended)
184
+ - **Memory**: 4GB RAM minimum (8GB+ for local models)
185
+ - **Storage**: 500MB for CLI, varies for local models
999
186
 
1000
- ### ダッシュボード
187
+ ## 🤝 Contributing
1001
188
 
1002
- - **Grafana**: https://grafana.bonginkan.ai/maria
1003
- - **Sentry**: https://sentry.bonginkan.ai/maria
1004
- - **CloudWatch**: AWS Console
189
+ We welcome contributions! See [Contributing Guide](https://github.com/bonginkan/maria/blob/main/CONTRIBUTING.md) for details.
1005
190
 
1006
- ### 主要メトリクス
191
+ ## 📄 License
1007
192
 
1008
- - API応答時間: < 200ms (p95)
1009
- - CLI起動時間: < 2秒
1010
- - AI生成時間: < 10秒 (コード生成)
1011
- - エラー率: < 0.1%
193
+ MIT License - see [LICENSE](https://github.com/bonginkan/maria/blob/main/LICENSE) for details.
1012
194
 
1013
- ## 🎯 今後のロードマップ
195
+ ## 🔗 Links
1014
196
 
1015
- ### Phase 6 (2025 Q1)
1016
- - [ ] VSCode Extension開発
1017
- - [ ] JetBrains IDE統合
1018
- - [ ] GitHub Copilot競合機能
197
+ - [GitHub Repository](https://github.com/bonginkan/maria)
198
+ - [NPM Package](https://www.npmjs.com/package/@bonginkan/maria)
199
+ - [Documentation](https://maria-code.vercel.app)
200
+ - [Report Issues](https://github.com/bonginkan/maria/issues)
1019
201
 
1020
- ### Phase 7 (2025 Q2)
1021
- - [ ] エンタープライズ機能
1022
- - [ ] オンプレミス対応
1023
- - [ ] SAML/SSO統合
202
+ ## 💬 Support
1024
203
 
1025
- ### Phase 8 (2025 Q3)
1026
- - [ ] マルチテナント対応
1027
- - [ ] API Rate Limiting強化
1028
- - [ ] 監査ログ機能
204
+ - Email: maria@bonginkan.ai
205
+ - GitHub Issues: [Create an issue](https://github.com/bonginkan/maria/issues/new)
1029
206
 
1030
207
  ---
1031
208
 
1032
- **MARIA Platform** - AI-Powered Development Platform
1033
- © 2025 Bonginkan Inc. All rights reserved.
1034
- Internal Use Only - Proprietary and Confidential
209
+ **MARIA CODE** - Your AI-Powered Senior Engineer in the Terminal
210
+ © 2025 Bonginkan Inc. All rights reserved.