musubix 1.4.4 → 1.7.0

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.
Files changed (13) hide show
  1. package/AGENTS.md +48 -10
  2. package/README.ja.md +34 -5
  3. package/README.md +37 -6
  4. package/docs/API-REFERENCE.md +430 -2
  5. package/docs/INSTALL-GUIDE.ja.md +2 -2
  6. package/docs/INSTALL-GUIDE.md +2 -2
  7. package/docs/MUSUBIv1.6.1-enhancement_roadmap_20260105.md +291 -0
  8. package/docs/ROADMAP-v1.5.md +60 -56
  9. package/docs/USER-GUIDE.ja.md +717 -6
  10. package/docs/USER-GUIDE.md +717 -6
  11. package/docs/evolution-from-musubi-to-musubix.md +522 -6
  12. package/docs/getting-started-with-sdd.md +1 -1
  13. package/package.json +3 -2
package/AGENTS.md CHANGED
@@ -8,13 +8,13 @@
8
8
 
9
9
  | 項目 | 詳細 |
10
10
  |------|------|
11
- | **バージョン** | 1.4.3 |
11
+ | **バージョン** | 1.7.0 (YATA Platform Enhancements) |
12
12
  | **言語** | TypeScript |
13
13
  | **ランタイム** | Node.js >= 20.0.0 |
14
14
  | **パッケージマネージャ** | npm >= 10.0.0 |
15
15
  | **ビルドシステム** | モノレポ（npm workspaces） |
16
16
  | **テストフレームワーク** | Vitest |
17
- | **テスト数** | 853 (全合格) |
17
+ | **テスト数** | 1386 (全合格) |
18
18
  | **コンポーネント数** | 249 (62ドメイン対応) |
19
19
  | **Agent Skills** | 12 (Claude Code対応) |
20
20
 
@@ -29,10 +29,13 @@ packages/
29
29
  ├── core/ # @nahisaho/musubix-core
30
30
  ├── mcp-server/ # @nahisaho/musubix-mcp-server
31
31
  ├── yata-client/ # @nahisaho/musubix-yata-client
32
- ├── pattern-mcp/ # @nahisaho/musubix-pattern-mcp (NEW!)
33
- ├── ontology-mcp/ # @nahisaho/musubix-ontology-mcp (NEW!)
34
- ├── wake-sleep/ # @nahisaho/musubix-wake-sleep (NEW!)
35
- └── sdd-ontology/ # @nahisaho/musubix-sdd-ontology (NEW!)
32
+ ├── yata-local/ # @nahisaho/yata-local
33
+ ├── yata-global/ # @nahisaho/yata-global
34
+ ├── yata-ui/ # @nahisaho/yata-ui (NEW!)
35
+ ├── pattern-mcp/ # @nahisaho/musubix-pattern-mcp
36
+ ├── ontology-mcp/ # @nahisaho/musubix-ontology-mcp
37
+ ├── wake-sleep/ # @nahisaho/musubix-wake-sleep
38
+ └── sdd-ontology/ # @nahisaho/musubix-sdd-ontology
36
39
  ```
37
40
 
38
41
  | パッケージ | npm | 役割 |
@@ -40,6 +43,9 @@ packages/
40
43
  | `packages/core/` | `@nahisaho/musubix-core` | コアライブラリ - CLI、EARS検証、コード生成、設計パターン |
41
44
  | `packages/mcp-server/` | `@nahisaho/musubix-mcp-server` | MCPサーバー - 19ツール、3プロンプト |
42
45
  | `packages/yata-client/` | `@nahisaho/musubix-yata-client` | YATAクライアント - 知識グラフ連携 |
46
+ | `packages/yata-local/` | `@nahisaho/yata-local` | **YATA Local** - SQLiteベースローカル知識グラフ |
47
+ | `packages/yata-global/` | `@nahisaho/yata-global` | **YATA Global** - 分散型知識グラフプラットフォーム |
48
+ | `packages/yata-ui/` | `@nahisaho/yata-ui` | **YATA UI** - Web可視化・管理インターフェース (NEW!) |
43
49
  | `packages/pattern-mcp/` | `@nahisaho/musubix-pattern-mcp` | パターン学習 - 抽出・圧縮・ライブラリ |
44
50
  | `packages/ontology-mcp/` | `@nahisaho/musubix-ontology-mcp` | オントロジー - N3Store・推論エンジン |
45
51
  | `packages/wake-sleep/` | `@nahisaho/musubix-wake-sleep` | Wake-Sleep学習サイクル |
@@ -96,8 +102,11 @@ npx musubix test coverage <dir> # カバレッジ測定
96
102
 
97
103
  # トレーサビリティ
98
104
  npx musubix trace matrix # トレーサビリティマトリクス
105
+ npx musubix trace matrix -p <project> # 指定プロジェクトのマトリクス
99
106
  npx musubix trace impact <id> # 影響分析
100
107
  npx musubix trace validate # リンク検証
108
+ npx musubix trace sync # トレースマトリクス自動更新 (v1.6.7 NEW!)
109
+ npx musubix trace sync --dry-run # プレビューのみ
101
110
 
102
111
  # 説明生成
103
112
  npx musubix explain why <id> # 決定理由の説明
@@ -121,6 +130,26 @@ npx musubix ontology validate -f <file> # 知識グラフ整合性検証
121
130
  npx musubix ontology check-circular -f <file> # 循環依存チェック
122
131
  npx musubix ontology stats -f <file> # 統計表示
123
132
 
133
+ # Interactive REPL (v1.5.0 NEW!)
134
+ npx musubix repl # 対話的シェルを起動
135
+ npx musubix repl --history <file> # カスタム履歴ファイル
136
+ npx musubix repl --no-color # 色なしモード
137
+
138
+ # KGPR - Knowledge Graph Pull Request (v1.6.4 NEW!)
139
+ npx musubix kgpr create -t "title" # KGPR作成
140
+ npx musubix kgpr diff # 差分プレビュー
141
+ npx musubix kgpr list # KGPR一覧
142
+ npx musubix kgpr submit <id> # KGPR送信
143
+ npx musubix kgpr show <id> # KGPR詳細表示
144
+ npx musubix kgpr close <id> # KGPRクローズ
145
+ # オプション: --namespace <ns>, --entity-types <types>, --privacy <strict|moderate|none>
146
+
147
+ # SDDプロジェクトスキャフォールド (v1.6.7 NEW!)
148
+ npx musubix scaffold domain-model <name> # DDDプロジェクト生成
149
+ npx musubix scaffold domain-model <name> -e "Entity1,Entity2" # エンティティ指定
150
+ npx musubix scaffold domain-model <name> -d DOMAIN # ドメイン接頭辞指定
151
+ npx musubix scaffold minimal <name> # 最小構成プロジェクト
152
+
124
153
  # ヘルプ
125
154
  npx musubix --help
126
155
  npx musubix help <command>
@@ -137,7 +166,7 @@ npx @nahisaho/musubix-mcp-server
137
166
  npx musubix-mcp --transport stdio
138
167
  ```
139
168
 
140
- ### ツール一覧（19ツール）
169
+ ### ツール一覧（24ツール）
141
170
 
142
171
  #### SDD基本ツール（9ツール）
143
172
 
@@ -173,6 +202,16 @@ npx musubix-mcp --transport stdio
173
202
  | `validate_triple` | 単一トリプルの事前検証 |
174
203
  | `check_circular` | 循環依存の検出 |
175
204
 
205
+ #### KGPRツール（5ツール）- v1.6.4 NEW!
206
+
207
+ | ツール名 | 説明 |
208
+ |---------|------|
209
+ | `kgpr_create` | KGPR作成（ローカルKGからドラフト作成） |
210
+ | `kgpr_diff` | 差分プレビュー |
211
+ | `kgpr_list` | KGPR一覧表示 |
212
+ | `kgpr_submit` | KGPR送信（レビュー用） |
213
+ | `kgpr_review` | KGPRレビュー（approve/changes_requested/commented） |
214
+
176
215
  ### プロンプト一覧（3プロンプト）
177
216
 
178
217
  | プロンプト名 | 説明 |
@@ -482,6 +521,5 @@ npx musubix learn best-practices --format markdown
482
521
  ---
483
522
 
484
523
  **Agent**: GitHub Copilot / Claude
485
- **Last Updated**: 2025-01-05
486
- **Version**: 1.4.1
487
- **Repository**: https://github.com/nahisaho/MUSUBIX
524
+ **Last Updated**: 2026-01-06
525
+ **Version**: 1.6.4
package/README.ja.md CHANGED
@@ -6,11 +6,11 @@
6
6
  [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
7
7
  [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
8
8
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
9
- [![Tests](https://img.shields.io/badge/tests-775%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
9
+ [![Tests](https://img.shields.io/badge/tests-1429%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
10
10
 
11
11
  > MUSUBI × YATA 統合による次世代AIコーディングシステム
12
12
  >
13
- > **v1.4.1** - 正誤性検証＆OWL制約チェック
13
+ > **v1.7.0** - YATAプラットフォーム拡張
14
14
 
15
15
  ## 概要
16
16
 
@@ -30,6 +30,12 @@ MUSUBIXは、**ニューラル（LLM）** と **シンボリック（知識グ
30
30
  - 📚 **自己学習システム** - フィードバック収集とパターン抽出による適応的改善
31
31
  - 🏗️ **C4コード生成** - C4設計ドキュメントからTypeScriptスケルトン生成
32
32
  - ⚙️ **品質ゲート** - フェーズ移行前の自動品質検証
33
+ - 🔮 **高度推論** - OWL 2 RL推論とDatalog評価 *(v1.4.5)*
34
+ - 🖥️ **対話的REPL** - コマンド補完、履歴管理、セッション変数 *(v1.6.0)*
35
+ - 🗄️ **YATA Local** - SQLiteベースローカル知識グラフ (BFS/DFS、推論) *(v1.6.3)*
36
+ - 🌐 **YATA Global** - オフライン同期対応分散型知識プラットフォーム *(v1.6.3)*
37
+ - 📤 **KGPR** - 安全な知識共有のためのKnowledge Graph Pull Request *(v1.6.4)*
38
+ - 🚀 **YATAプラットフォーム拡張** - インデックス最適化、拡張エクスポート、グローバル同期、コード生成、Web UI *(v1.7.0)*
33
39
 
34
40
  ## アーキテクチャ
35
41
 
@@ -59,7 +65,7 @@ flowchart TB
59
65
 
60
66
  | パス | 説明 |
61
67
  |------|------|
62
- | `packages/core/` | コアライブラリ（224モジュール） |
68
+ | `packages/core/` | コアライブラリ（249モジュール） |
63
69
  | `packages/core/auth/` | 認証・認可 |
64
70
  | `packages/core/cli/` | CLIインターフェース |
65
71
  | `packages/core/codegen/` | コード生成・解析 |
@@ -73,7 +79,7 @@ flowchart TB
73
79
  | `packages/core/types/` | 型定義 |
74
80
  | `packages/core/utils/` | ユーティリティ |
75
81
  | `packages/core/validators/` | EARS検証 |
76
- | `packages/mcp-server/` | MCPサーバー（16 tools, 3 prompts） |
82
+ | `packages/mcp-server/` | MCPサーバー（24 tools, 3 prompts） |
77
83
  | `packages/yata-client/` | YATA クライアント |
78
84
  | `packages/pattern-mcp/` | **パターン学習（NEW!）** |
79
85
  | `packages/ontology-mcp/` | **オントロジーエンジン（NEW!）** |
@@ -233,6 +239,29 @@ Wake-Sleepアルゴリズムに基づく継続的学習システム:
233
239
  - `ontology_query` - オントロジーグラフへのクエリ
234
240
  - `ontology_infer` - オントロジーによる推論実行
235
241
 
242
+ ## 高度推論（v1.4.5）
243
+
244
+ OWL 2 RLプロファイル推論とDatalog評価エンジン:
245
+
246
+ ### 推論コンポーネント
247
+ - **OWL2RLReasoner** - OWL 2 RLプロファイル準拠推論（20+ビルトインルール）
248
+ - **DatalogEngine** - ストラティファイドDatalog評価（否定サポート）
249
+ - **InferenceExplainer** - 人間可読な推論説明生成
250
+ - **ProgressReporter** - リアルタイム進捗フィードバック（500ms間隔）
251
+
252
+ ### OWL 2 RLビルトインルール
253
+ | カテゴリ | ルール | 説明 |
254
+ |----------|-------|------|
255
+ | Class Axioms | cax-sco, cax-eqc | サブクラス、同値クラス推論 |
256
+ | Property | prp-dom, prp-rng | ドメイン、レンジ推論 |
257
+ | Property Characteristics | prp-symp, prp-trp, prp-inv | 対称、推移、逆プロパティ |
258
+ | Equality | eq-ref, eq-sym, eq-trans | sameAs推論 |
259
+
260
+ ### 説明フォーマット
261
+ - `text` - プレーンテキスト説明
262
+ - `markdown` - Markdown形式
263
+ - `html` - HTML形式（エスケープ対応）
264
+
236
265
  ## 憲法（9条）
237
266
 
238
267
  MUSUBIXは以下の9条の憲法に準拠しています：
@@ -262,5 +291,5 @@ nahisaho
262
291
  ---
263
292
 
264
293
  **文書ID**: README
265
- **バージョン**: 1.3.0
294
+ **バージョン**: 1.4.5
266
295
  **最終更新**: 2026-01-05
package/README.md CHANGED
@@ -7,11 +7,11 @@
7
7
  [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
8
8
  [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
9
9
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
10
- [![Tests](https://img.shields.io/badge/tests-775%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
10
+ [![Tests](https://img.shields.io/badge/tests-1429%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
11
11
 
12
12
  > Next-generation AI Coding System powered by MUSUBI × YATA Integration
13
13
  >
14
- > **v1.4.1** - Consistency Validation & OWL Constraint Checking
14
+ > **v1.7.0** - YATA Platform Enhancements
15
15
 
16
16
  **[日本語版 README](README.ja.md)**
17
17
 
@@ -33,6 +33,12 @@ MUSUBIX is an innovative AI coding system that integrates **Neural (LLM)** and *
33
33
  - 📚 **Self-Learning System** - Adaptive improvement through feedback collection and pattern extraction
34
34
  - 🏗️ **C4 Code Generation** - Generate TypeScript skeleton from C4 design documents
35
35
  - ⚙️ **Quality Gates** - Automated quality validation before phase transitions
36
+ - 🔮 **Advanced Inference** - OWL 2 RL reasoning and Datalog evaluation *(v1.4.5)*
37
+ - 🖥️ **Interactive REPL** - Command completion, history, session variables *(v1.6.0)*
38
+ - 🗄️ **YATA Local** - SQLite-based local knowledge graph (BFS/DFS, reasoning) *(v1.6.3)*
39
+ - 🌐 **YATA Global** - Distributed knowledge platform with offline sync *(v1.6.3)*
40
+ - 📤 **KGPR** - Knowledge Graph Pull Request for safe knowledge sharing *(v1.6.4)*
41
+ - 🚀 **YATA Platform Enhancements** - Index optimization, enhanced export, global sync, code generation, web UI *(v1.7.0)*
36
42
 
37
43
  ## Architecture
38
44
 
@@ -62,7 +68,7 @@ flowchart TB
62
68
 
63
69
  | Path | Description |
64
70
  |------|-------------|
65
- | `packages/core/` | Core library (224 modules) |
71
+ | `packages/core/` | Core library (249 modules) |
66
72
  | `packages/core/auth/` | Authentication & Authorization |
67
73
  | `packages/core/cli/` | CLI Interface |
68
74
  | `packages/core/codegen/` | Code Generation & Analysis |
@@ -76,12 +82,14 @@ flowchart TB
76
82
  | `packages/core/types/` | Type Definitions |
77
83
  | `packages/core/utils/` | Utilities |
78
84
  | `packages/core/validators/` | EARS Validation |
79
- | `packages/mcp-server/` | MCP Server (16 tools, 3 prompts) |
85
+ | `packages/mcp-server/` | MCP Server (24 tools, 3 prompts) |
80
86
  | `packages/yata-client/` | YATA Client |
81
87
  | `packages/pattern-mcp/` | **Pattern Learning (NEW!)** |
82
88
  | `packages/ontology-mcp/` | **Ontology Engine (NEW!)** |
83
89
  | `packages/wake-sleep/` | **Wake-Sleep Learning (NEW!)** |
84
90
  | `packages/sdd-ontology/` | **SDD Ontology (NEW!)** |
91
+ | `packages/yata-local/` | **YATA Local - SQLite Knowledge Graph (NEW!)** |
92
+ | `packages/yata-global/` | **YATA Global - Distributed Knowledge Platform (NEW!)** |
85
93
  | `steering/` | Project Memory |
86
94
  | `storage/` | Specifications & Artifacts |
87
95
  | `templates/` | Templates |
@@ -169,7 +177,7 @@ npm run type-check
169
177
 
170
178
  ### MCP Server
171
179
 
172
- Provides 16 tools (9 SDD + 7 Pattern) and 3 prompts:
180
+ Provides 24 tools (9 SDD + 7 Pattern + 3 Ontology + 5 KGPR) and 3 prompts:
173
181
 
174
182
  ```bash
175
183
  # Start MCP Server
@@ -236,6 +244,29 @@ Continuous learning system based on the Wake-Sleep algorithm:
236
244
  - `ontology_query` - Query ontology graph
237
245
  - `ontology_infer` - Execute ontology-based inference
238
246
 
247
+ ## Advanced Inference (v1.4.5)
248
+
249
+ OWL 2 RL profile reasoning and Datalog evaluation engine:
250
+
251
+ ### Inference Components
252
+ - **OWL2RLReasoner** - OWL 2 RL profile compliant inference (20+ built-in rules)
253
+ - **DatalogEngine** - Stratified Datalog evaluation with negation support
254
+ - **InferenceExplainer** - Human-readable inference explanation generator
255
+ - **ProgressReporter** - Real-time progress feedback (500ms interval)
256
+
257
+ ### OWL 2 RL Built-in Rules
258
+ | Category | Rules | Description |
259
+ |----------|-------|-------------|
260
+ | Class Axioms | cax-sco, cax-eqc | Subclass, Equivalent class inference |
261
+ | Property | prp-dom, prp-rng | Domain, Range inference |
262
+ | Property Characteristics | prp-symp, prp-trp, prp-inv | Symmetric, Transitive, Inverse |
263
+ | Equality | eq-ref, eq-sym, eq-trans | sameAs inference |
264
+
265
+ ### Explanation Formats
266
+ - `text` - Plain text explanation
267
+ - `markdown` - Markdown format
268
+ - `html` - HTML format with escaping
269
+
239
270
  ## Constitutional Articles (9 Articles)
240
271
 
241
272
  MUSUBIX adheres to the following 9 constitutional articles:
@@ -265,5 +296,5 @@ See [CHANGELOG.md](CHANGELOG.md)
265
296
  ---
266
297
 
267
298
  **Document ID**: README
268
- **Version**: 1.3.0
299
+ **Version**: 1.4.5
269
300
  **Last Updated**: 2026-01-05