musubix 1.6.0 → 1.7.0

package/AGENTS.md

@@ -8,13 +8,13 @@
 
 | 項目 | 詳細 |
 |------|------|
-| **バージョン** | 1.6.0 (開発中) |
+| **バージョン** | 1.7.0 (YATA Platform Enhancements) |
 | **言語** | TypeScript |
 | **ランタイム** | Node.js >= 20.0.0 |
 | **パッケージマネージャ** | npm >= 10.0.0 |
 | **ビルドシステム** | モノレポ（npm workspaces） |
 | **テストフレームワーク** | Vitest |
-| **テスト数** | 1208 (全合格) |
+| **テスト数** | 1386 (全合格) |
 | **コンポーネント数** | 249 (62ドメイン対応) |
 | **Agent Skills** | 12 (Claude Code対応) |
 
@@ -29,10 +29,13 @@ packages/
 ├── core/           # @nahisaho/musubix-core
 ├── mcp-server/     # @nahisaho/musubix-mcp-server  
 ├── yata-client/    # @nahisaho/musubix-yata-client
-├── pattern-mcp/    # @nahisaho/musubix-pattern-mcp (NEW!)
-├── ontology-mcp/   # @nahisaho/musubix-ontology-mcp (NEW!)
-├── wake-sleep/     # @nahisaho/musubix-wake-sleep (NEW!)
-└── sdd-ontology/   # @nahisaho/musubix-sdd-ontology (NEW!)
+├── yata-local/     # @nahisaho/yata-local
+├── yata-global/    # @nahisaho/yata-global
+├── yata-ui/        # @nahisaho/yata-ui (NEW!)
+├── pattern-mcp/    # @nahisaho/musubix-pattern-mcp
+├── ontology-mcp/   # @nahisaho/musubix-ontology-mcp
+├── wake-sleep/     # @nahisaho/musubix-wake-sleep
+└── sdd-ontology/   # @nahisaho/musubix-sdd-ontology
 ```
 
 | パッケージ | npm | 役割 |
@@ -40,6 +43,9 @@ packages/
 | `packages/core/` | `@nahisaho/musubix-core` | コアライブラリ - CLI、EARS検証、コード生成、設計パターン |
 | `packages/mcp-server/` | `@nahisaho/musubix-mcp-server` | MCPサーバー - 19ツール、3プロンプト |
 | `packages/yata-client/` | `@nahisaho/musubix-yata-client` | YATAクライアント - 知識グラフ連携 |
+| `packages/yata-local/` | `@nahisaho/yata-local` | **YATA Local** - SQLiteベースローカル知識グラフ |
+| `packages/yata-global/` | `@nahisaho/yata-global` | **YATA Global** - 分散型知識グラフプラットフォーム |
+| `packages/yata-ui/` | `@nahisaho/yata-ui` | **YATA UI** - Web可視化・管理インターフェース (NEW!) |
 | `packages/pattern-mcp/` | `@nahisaho/musubix-pattern-mcp` | パターン学習 - 抽出・圧縮・ライブラリ |
 | `packages/ontology-mcp/` | `@nahisaho/musubix-ontology-mcp` | オントロジー - N3Store・推論エンジン |
 | `packages/wake-sleep/` | `@nahisaho/musubix-wake-sleep` | Wake-Sleep学習サイクル |
@@ -96,8 +102,11 @@ npx musubix test coverage <dir>            # カバレッジ測定
 
 # トレーサビリティ
 npx musubix trace matrix                   # トレーサビリティマトリクス
+npx musubix trace matrix -p <project>      # 指定プロジェクトのマトリクス
 npx musubix trace impact <id>              # 影響分析
 npx musubix trace validate                 # リンク検証
+npx musubix trace sync                     # トレースマトリクス自動更新 (v1.6.7 NEW!)
+npx musubix trace sync --dry-run           # プレビューのみ
 
 # 説明生成
 npx musubix explain why <id>               # 決定理由の説明
@@ -126,6 +135,21 @@ npx musubix repl                           # 対話的シェルを起動
 npx musubix repl --history <file>          # カスタム履歴ファイル
 npx musubix repl --no-color                # 色なしモード
 
+# KGPR - Knowledge Graph Pull Request (v1.6.4 NEW!)
+npx musubix kgpr create -t "title"         # KGPR作成
+npx musubix kgpr diff                      # 差分プレビュー
+npx musubix kgpr list                      # KGPR一覧
+npx musubix kgpr submit <id>               # KGPR送信
+npx musubix kgpr show <id>                 # KGPR詳細表示
+npx musubix kgpr close <id>                # KGPRクローズ
+  # オプション: --namespace <ns>, --entity-types <types>, --privacy <strict|moderate|none>
+
+# SDDプロジェクトスキャフォールド (v1.6.7 NEW!)
+npx musubix scaffold domain-model <name>   # DDDプロジェクト生成
+npx musubix scaffold domain-model <name> -e "Entity1,Entity2"  # エンティティ指定
+npx musubix scaffold domain-model <name> -d DOMAIN  # ドメイン接頭辞指定
+npx musubix scaffold minimal <name>        # 最小構成プロジェクト
+
 # ヘルプ
 npx musubix --help
 npx musubix help <command>
@@ -142,7 +166,7 @@ npx @nahisaho/musubix-mcp-server
 npx musubix-mcp --transport stdio
 ```
 
-### ツール一覧（19ツール）
+### ツール一覧（24ツール）
 
 #### SDD基本ツール（9ツール）
 
@@ -178,6 +202,16 @@ npx musubix-mcp --transport stdio
 | `validate_triple` | 単一トリプルの事前検証 |
 | `check_circular` | 循環依存の検出 |
 
+#### KGPRツール（5ツール）- v1.6.4 NEW!
+
+| ツール名 | 説明 |
+|---------|------|
+| `kgpr_create` | KGPR作成（ローカルKGからドラフト作成） |
+| `kgpr_diff` | 差分プレビュー |
+| `kgpr_list` | KGPR一覧表示 |
+| `kgpr_submit` | KGPR送信（レビュー用） |
+| `kgpr_review` | KGPRレビュー（approve/changes_requested/commented） |
+
 ### プロンプト一覧（3プロンプト）
 
 | プロンプト名 | 説明 |
@@ -488,5 +522,4 @@ npx musubix learn best-practices --format markdown
 
 **Agent**: GitHub Copilot / Claude
 **Last Updated**: 2026-01-06
-**Version**: 1.5.0
-**Repository**: https://github.com/nahisaho/MUSUBIX
+**Version**: 1.6.4

package/README.ja.md

@@ -6,11 +6,11 @@
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
-[![Tests](https://img.shields.io/badge/tests-1208%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
+[![Tests](https://img.shields.io/badge/tests-1429%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
 
 > MUSUBI × YATA 統合による次世代AIコーディングシステム
 >
-> **v1.6.0** - REPLテスト実装＆CLI統合
+> **v1.7.0** - YATAプラットフォーム拡張
 
 ## 概要
 
@@ -32,6 +32,10 @@ MUSUBIXは、**ニューラル（LLM）** と **シンボリック（知識グ
 - ⚙️ **品質ゲート** - フェーズ移行前の自動品質検証
 - 🔮 **高度推論** - OWL 2 RL推論とDatalog評価 *(v1.4.5)*
 - 🖥️ **対話的REPL** - コマンド補完、履歴管理、セッション変数 *(v1.6.0)*
+- 🗄️ **YATA Local** - SQLiteベースローカル知識グラフ (BFS/DFS、推論) *(v1.6.3)*
+- 🌐 **YATA Global** - オフライン同期対応分散型知識プラットフォーム *(v1.6.3)*
+- 📤 **KGPR** - 安全な知識共有のためのKnowledge Graph Pull Request *(v1.6.4)*
+- 🚀 **YATAプラットフォーム拡張** - インデックス最適化、拡張エクスポート、グローバル同期、コード生成、Web UI *(v1.7.0)*
 
 ## アーキテクチャ
 
@@ -75,7 +79,7 @@ flowchart TB
 | `packages/core/types/` | 型定義 |
 | `packages/core/utils/` | ユーティリティ |
 | `packages/core/validators/` | EARS検証 |
-| `packages/mcp-server/` | MCPサーバー（19 tools, 3 prompts） |
+| `packages/mcp-server/` | MCPサーバー（24 tools, 3 prompts） |
 | `packages/yata-client/` | YATA クライアント |
 | `packages/pattern-mcp/` | **パターン学習（NEW!）** |
 | `packages/ontology-mcp/` | **オントロジーエンジン（NEW!）** |

package/README.md

@@ -7,11 +7,11 @@
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
-[![Tests](https://img.shields.io/badge/tests-1208%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
+[![Tests](https://img.shields.io/badge/tests-1429%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
 
 > Next-generation AI Coding System powered by MUSUBI × YATA Integration
 >
-> **v1.6.0** - REPL Test Implementation & CLI Enhancement
+> **v1.7.0** - YATA Platform Enhancements
 
 **[日本語版 README](README.ja.md)**
 
@@ -35,6 +35,10 @@ MUSUBIX is an innovative AI coding system that integrates **Neural (LLM)** and *
 - ⚙️ **Quality Gates** - Automated quality validation before phase transitions
 - 🔮 **Advanced Inference** - OWL 2 RL reasoning and Datalog evaluation *(v1.4.5)*
 - 🖥️ **Interactive REPL** - Command completion, history, session variables *(v1.6.0)*
+- 🗄️ **YATA Local** - SQLite-based local knowledge graph (BFS/DFS, reasoning) *(v1.6.3)*
+- 🌐 **YATA Global** - Distributed knowledge platform with offline sync *(v1.6.3)*
+- 📤 **KGPR** - Knowledge Graph Pull Request for safe knowledge sharing *(v1.6.4)*
+- 🚀 **YATA Platform Enhancements** - Index optimization, enhanced export, global sync, code generation, web UI *(v1.7.0)*
 
 ## Architecture
 
@@ -78,12 +82,14 @@ flowchart TB
 | `packages/core/types/` | Type Definitions |
 | `packages/core/utils/` | Utilities |
 | `packages/core/validators/` | EARS Validation |
-| `packages/mcp-server/` | MCP Server (19 tools, 3 prompts) |
+| `packages/mcp-server/` | MCP Server (24 tools, 3 prompts) |
 | `packages/yata-client/` | YATA Client |
 | `packages/pattern-mcp/` | **Pattern Learning (NEW!)** |
 | `packages/ontology-mcp/` | **Ontology Engine (NEW!)** |
 | `packages/wake-sleep/` | **Wake-Sleep Learning (NEW!)** |
 | `packages/sdd-ontology/` | **SDD Ontology (NEW!)** |
+| `packages/yata-local/` | **YATA Local - SQLite Knowledge Graph (NEW!)** |
+| `packages/yata-global/` | **YATA Global - Distributed Knowledge Platform (NEW!)** |
 | `steering/` | Project Memory |
 | `storage/` | Specifications & Artifacts |
 | `templates/` | Templates |
@@ -171,7 +177,7 @@ npm run type-check
 
 ### MCP Server
 
-Provides 16 tools (9 SDD + 7 Pattern) and 3 prompts:
+Provides 24 tools (9 SDD + 7 Pattern + 3 Ontology + 5 KGPR) and 3 prompts:
 
 ```bash
 # Start MCP Server

package/docs/API-REFERENCE.md

@@ -14,6 +14,10 @@
   - [Symbolic](#symbolic)
   - [Inference](#inference) *(v1.4.5)*
   - [REPL](#repl) *(v1.5.0)*
+  - [YATA Local](#yata-local) *(v1.6.3)*
+  - [YATA Global](#yata-global) *(v1.6.3)*
+  - [KGPR](#kgpr) *(v1.6.4)*
+  - [YATA Platform](#yata-platform) *(v1.7.0)*
   - [Validation](#validation)
   - [Utils](#utils)
 - [MCP Server](#mcp-server)
@@ -681,6 +685,206 @@ await reasoner.reason(store, { progressReporter: reporter });
 
 ---
 
+### YATA Platform (v1.7.0)
+
+Version 1.7.0 introduces enhanced YATA platform APIs.
+
+#### IndexOptimizer
+
+Optimizes database indexes for improved query performance.
+
+```typescript
+import { IndexOptimizer } from '@nahisaho/yata-local';
+
+const optimizer = new IndexOptimizer(database);
+
+// Analyze query patterns
+const analysis = await optimizer.analyzeQueryPatterns();
+
+// Create optimal indexes
+const created = await optimizer.createOptimalIndexes();
+
+// Check index health
+const health = await optimizer.checkIndexHealth();
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `analyzeQueryPatterns()` | - | `QueryAnalysis` | Analyze query patterns |
+| `createOptimalIndexes()` | - | `IndexCreationResult` | Create composite indexes |
+| `checkIndexHealth()` | - | `IndexHealthReport` | Check fragmentation |
+| `rebuildIndex(name)` | `name: string` | `void` | Rebuild specific index |
+
+---
+
+#### ExportPipeline
+
+Exports knowledge graph data with transformation support.
+
+```typescript
+import { ExportPipeline } from '@nahisaho/yata-local';
+
+const pipeline = new ExportPipeline(database);
+
+// Full export
+const data = await pipeline.exportFull({ namespace: 'myproject' });
+
+// Incremental export
+const changes = await pipeline.exportIncremental({
+  since: lastExportTime,
+  format: 'json'
+});
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `exportFull(options)` | `ExportOptions` | `ExportData` | Full data export |
+| `exportIncremental(options)` | `IncrementalOptions` | `ExportData` | Export changes since timestamp |
+| `exportWithTransform(options)` | `TransformOptions` | `ExportData` | Export with format transformation |
+
+**Export Formats:**
+
+| Format | Description |
+|--------|-------------|
+| `json` | JSON format (default) |
+| `rdf` | RDF/Turtle format |
+| `ntriples` | N-Triples format |
+
+---
+
+#### GlobalSyncClient
+
+Synchronizes local knowledge graph with YATA Global.
+
+```typescript
+import { GlobalSyncClient } from '@nahisaho/yata-global';
+
+const client = new GlobalSyncClient({
+  endpoint: 'https://yata-global.example.com',
+  offlineMode: true
+});
+
+await client.initialize();
+
+const result = await client.sync({
+  namespace: 'myproject',
+  direction: 'push'
+});
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `initialize()` | - | `Promise<void>` | Initialize client |
+| `sync(options)` | `SyncOptions` | `SyncResult` | Synchronize data |
+| `getStatus()` | - | `SyncStatus` | Get sync status |
+| `resolveConflict(id, resolution)` | `id: string, resolution: Resolution` | `void` | Resolve conflict |
+
+---
+
+#### SyncEngine
+
+Core synchronization engine with conflict resolution.
+
+```typescript
+import { SyncEngine } from '@nahisaho/yata-global';
+
+const engine = new SyncEngine({
+  conflictStrategy: 'server-wins',
+  batchSize: 100
+});
+
+const result = await engine.sync(localData, remoteData);
+```
+
+**Conflict Strategies:**
+
+| Strategy | Description |
+|----------|-------------|
+| `server-wins` | Server data takes precedence |
+| `client-wins` | Client data takes precedence |
+| `merge` | Attempt automatic merge |
+| `manual` | Require manual resolution |
+
+---
+
+#### CacheManager
+
+Manages local caching for offline support.
+
+```typescript
+import { CacheManager } from '@nahisaho/yata-global';
+
+const cache = new CacheManager({
+  maxSize: 100 * 1024 * 1024, // 100MB
+  ttl: 24 * 60 * 60 * 1000    // 24 hours
+});
+
+await cache.set('key', data);
+const cached = await cache.get('key');
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `get(key)` | `key: string` | `T \| undefined` | Get cached item |
+| `set(key, value)` | `key: string, value: T` | `void` | Cache item |
+| `has(key)` | `key: string` | `boolean` | Check if exists |
+| `clearAll()` | - | `void` | Clear all cache |
+| `getStats()` | - | `CacheStats` | Get cache statistics |
+
+---
+
+#### YataUIServer
+
+Web-based visualization server for knowledge graphs.
+
+```typescript
+import { YataUIServer, createYataUIServer } from '@nahisaho/yata-ui';
+
+const server = createYataUIServer({
+  port: 3000,
+  host: 'localhost',
+  cors: true,
+  enableRealtime: true
+});
+
+server.setDataProvider(async () => ({
+  nodes: await getEntities(),
+  edges: await getRelationships()
+}));
+
+await server.start();
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `start()` | - | `Promise<void>` | Start server |
+| `stop()` | - | `Promise<void>` | Stop server |
+| `isRunning()` | - | `boolean` | Check if running |
+| `getUrl()` | - | `string` | Get server URL |
+| `setDataProvider(fn)` | `DataProvider` | `void` | Set data provider |
+| `broadcastUpdate(event, data)` | `event: string, data: any` | `void` | Broadcast to clients |
+
+**Configuration:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `port` | `number` | `3000` | Server port |
+| `host` | `string` | `localhost` | Server host |
+| `cors` | `boolean` | `true` | Enable CORS |
+| `enableRealtime` | `boolean` | `true` | Enable WebSocket |
+
+---
+
 ### Utils
 
 #### I18nManager
@@ -978,6 +1182,6 @@ MIT License - see [LICENSE](./LICENSE) for details.
 
 ---
 
-**Version:** 1.4.5  
-**Generated:** 2026-01-05  
+**Version:** 1.7.0  
+**Generated:** 2026-01-06  
 **MUSUBIX Core Package**

package/docs/INSTALL-GUIDE.ja.md

@@ -1,7 +1,7 @@
 # MUSUBIX インストールガイド
 
 **文書ID**: INSTALL-GUIDE  
-**バージョン**: 1.6.0  
+**バージョン**: 1.7.0  
 **最終更新**: 2026-01-06
 
 ---

package/docs/INSTALL-GUIDE.md

@@ -1,7 +1,7 @@
 # MUSUBIX Installation Guide
 
 **Document ID**: INSTALL-GUIDE  
-**Version**: 1.6.0  
+**Version**: 1.7.0  
 **Last Updated**: 2026-01-06
 
 ---