@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 +133 -957
- package/bin/maria +26 -68
- package/dist/cli.d.ts +2 -4
- package/dist/cli.js +62 -33291
- package/dist/index.d.ts +2 -2
- package/dist/index.js +66 -33296
- package/package.json +19 -52
- package/dist/cli.js.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/metafile-cjs.json +0 -1
package/README.md
CHANGED
|
@@ -1,1034 +1,210 @@
|
|
|
1
|
-
#
|
|
1
|
+
# MARIA CODE - Advanced AGI Development Assistant
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@bonginkan/maria)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
3
5
|
[](https://www.typescriptlang.org/)
|
|
4
|
-
[](https://pnpm.io/)
|
|
5
6
|
[](https://nodejs.org/)
|
|
6
|
-
[](https://cloud.google.com/)
|
|
7
|
-
[](https://neo4j.com/)
|
|
8
7
|
|
|
9
|
-
|
|
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
|
-
|
|
13
|
+
# Install globally
|
|
14
|
+
npm install -g @bonginkan/maria@latest
|
|
137
15
|
|
|
138
|
-
#
|
|
139
|
-
|
|
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
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
548
|
-
- **
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
- **Auth**: Firebase Auth + カスタムRBAC
|
|
86
|
+
```toml
|
|
87
|
+
[project]
|
|
88
|
+
name = "my-project"
|
|
89
|
+
type = "typescript"
|
|
701
90
|
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
3. **DevOps Console**: インフラ管理
|
|
706
|
-
4. **Graph Viewer**: Neo4j Bloom統合
|
|
91
|
+
[ai]
|
|
92
|
+
default_provider = "openai"
|
|
93
|
+
fallback_provider = "local"
|
|
707
94
|
|
|
708
|
-
|
|
95
|
+
[ai.providers.openai]
|
|
96
|
+
api_key = "${OPENAI_API_KEY}"
|
|
97
|
+
model = "gpt-4o"
|
|
709
98
|
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
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
|
-
|
|
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
|
-
###
|
|
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
|
-
|
|
904
|
-
|
|
121
|
+
### Code Review
|
|
905
122
|
```bash
|
|
906
|
-
|
|
907
|
-
# NODE_NO_WARNINGS=1が設定されている
|
|
123
|
+
maria review --diff --suggestions --severity warning
|
|
908
124
|
```
|
|
909
125
|
|
|
910
|
-
|
|
126
|
+
## 📦 Installation Options
|
|
911
127
|
|
|
912
128
|
```bash
|
|
913
|
-
#
|
|
914
|
-
|
|
129
|
+
# Latest stable
|
|
130
|
+
npm install -g @bonginkan/maria@latest
|
|
915
131
|
|
|
916
|
-
#
|
|
917
|
-
|
|
918
|
-
```
|
|
132
|
+
# Development version
|
|
133
|
+
npm install -g @bonginkan/maria@alpha
|
|
919
134
|
|
|
920
|
-
|
|
135
|
+
# Beta version
|
|
136
|
+
npm install -g @bonginkan/maria@beta
|
|
921
137
|
|
|
922
|
-
|
|
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
|
-
|
|
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
|
-
|
|
980
|
-
|
|
981
|
-
-
|
|
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
|
-
|
|
989
|
-
-
|
|
990
|
-
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
1016
|
-
- [ ]
|
|
1017
|
-
- [
|
|
1018
|
-
- [ ]
|
|
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
|
-
|
|
1021
|
-
- [ ] エンタープライズ機能
|
|
1022
|
-
- [ ] オンプレミス対応
|
|
1023
|
-
- [ ] SAML/SSO統合
|
|
202
|
+
## 💬 Support
|
|
1024
203
|
|
|
1025
|
-
|
|
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
|
|
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.
|