musubix 3.0.7 → 3.0.14

package/docs/adr/0001-real-time-pattern-learning-architecture-for-v1-5-0.md

@@ -0,0 +1,75 @@
+# ADR-0001: Real-time Pattern Learning Architecture for v1.5.0
+
+- **Date**: 2026-01-05
+- **Status**: accepted
+- **Deciders**: Architecture Team
+- **Categories**: Learning, Performance
+
+## Context
+
+MUSUBIX v1.4.xではバッチ学習方式を採用しているが、ユーザーのコード変更をリアルタイムで学習する要求がある。
+
+### 要件
+- REQ-LEARN-011: ファイル変更時500ms以内に分析
+- REQ-LEARN-013: フィードバック収集レイテンシ100ms以内
+- REQ-LEARN-014: ストリーム処理1000 events/sec以上
+
+### 検討した選択肢
+1. **Polling方式**: 定期的にファイル変更をチェック
+2. **fs.watch + EventEmitter**: Node.js標準のファイル監視
+3. **chokidar + RxJS**: サードパーティライブラリによるリアクティブストリーム
+
+## Decision
+
+**選択肢 2: fs.watch + EventEmitter** を採用する。
+
+### 理由
+- 外部依存なしで実現可能
+- Node.js標準APIで十分な性能
+- メモリフットプリントが小さい
+
+### アーキテクチャ
+
+```
+FileWatcher (fs.watch)
+    │
+    ▼
+StreamProcessor (EventEmitter)
+    │
+    ├─▼ FeedbackQueue (Non-blocking)
+    │
+    └─▼ PatternExtractor (AST)
+           │
+           ▼
+    IncrementalUpdater (Delta)
+```
+
+### パフォーマンス目標
+| メトリクス | 目標 | 測定方法 |
+|------------|------|----------|
+| 分析レイテンシ | < 500ms | StreamProcessor.getLatency() |
+| フィードバック収集 | < 100ms | FeedbackQueue timing |
+| スループット | ≥ 1000/sec | EventStream.getThroughput() |
+
+## Consequences
+
+### Positive
+- リアルタイム学習によるユーザー体験向上
+- 外部依存なしで軽量
+- 段階的な実装が可能
+
+### Negative
+- fs.watchのクロスプラットフォーム差異への対応が必要
+- 大規模プロジェクトでのスケーラビリティ検証が必要
+
+### Risks
+- macOS/Linux/Windowsでのfs.watchの挙動差異
+- 軽減策: chokidarへのフォールバック機構を用意
+
+## Related Requirements
+
+- REQ-LEARN-010: Real-time pattern learning
+- REQ-LEARN-011: 500ms analysis latency
+- REQ-LEARN-012: Incremental update
+- REQ-LEARN-013: Non-blocking feedback
+- REQ-LEARN-014: Stream processing

package/docs/adr/0002-pattern-sharing-protocol-for-cross-team-collaborat.md

@@ -0,0 +1,79 @@
+# ADR-0002: Pattern Sharing Protocol for cross-team collaboration
+
+- **Date**: 2026-01-05
+- **Status**: accepted
+- **Deciders**: Architecture Team
+- **Categories**: Sharing, Security
+
+## Context
+
+チーム間で学習済みパターンを共有する要求がある。プライバシーとセキュリティを考慮したプロトコルが必要。
+
+### 要件
+- REQ-SHARE-001: JSON形式でエクスポート
+- REQ-SHARE-003: インポート時のオントロジー検証
+- REQ-SHARE-004: 機密データの除去
+- REQ-SHARE-005: 競合解決戦略
+
+### 検討した選択肢
+1. **Git-based sharing**: Gitリポジトリでパターンを共有
+2. **REST API**: 中央サーバー経由の共有
+3. **File-based export/import**: JSONファイルの直接交換
+
+## Decision
+
+**選択肢 3: File-based export/import** を採用する。
+
+### 理由
+- インフラ不要で即座に利用可能
+- オフライン環境でも利用可能
+- 将来的にGit連携への拡張が容易
+
+### ファイルフォーマット
+
+```json
+{
+  "version": "1.0",
+  "exportedAt": "2026-01-05T12:00:00Z",
+  "patterns": [
+    {
+      "id": "PAT-001",
+      "name": "Repository Pattern",
+      "category": "design",
+      "confidence": 0.95,
+      "template": "...",
+      "metadata": {
+        "author": "[REDACTED]",
+        "domain": "data-access"
+      }
+    }
+  ],
+  "checksum": "sha256:..."
+}
+```
+
+### セキュリティ対策
+| 対策 | 実装 |
+|------|------|
+| 機密データ除去 | DataSanitizerによる自動マスキング |
+| 改ざん検出 | SHA-256チェックサム |
+| スキーマ検証 | JSON Schemaによるバリデーション |
+
+## Consequences
+
+### Positive
+- シンプルで即座に利用可能
+- プライバシー保護が容易
+- バージョン管理が明確
+
+### Negative
+- 自動同期機能なし（将来拡張）
+- 大規模チームでの管理が煩雑になる可能性
+
+## Related Requirements
+
+- REQ-SHARE-001: JSON export format
+- REQ-SHARE-002: External import
+- REQ-SHARE-003: Ontology validation
+- REQ-SHARE-004: Privacy protection
+- REQ-SHARE-005: Conflict resolution

package/docs/adr/0003-owl-2-rl-implementation-strategy-for-advanced-infe.md

@@ -0,0 +1,90 @@
+# ADR-0003: OWL 2 RL Implementation Strategy for advanced inference
+
+- **Date**: 2026-01-05
+- **Status**: accepted
+- **Deciders**: Architecture Team
+- **Categories**: Ontology, Inference
+
+## Context
+
+MUSUBIX v1.4.xではN3.jsによる基本的なRDF処理を実装済み。OWL 2 RLプロファイルの推論機能を追加する必要がある。
+
+### 要件
+- REQ-ONTO-010: OWL 2 RLプロファイル対応
+- REQ-ONTO-011: 200ms以内の推論（10,000トリプルまで）
+- REQ-ONTO-014: Datalogルール統合（最大100ルール）
+
+### 検討した選択肢
+1. **完全なOWL 2推論器（HermiT等）**: Javaベース、高機能だが重い
+2. **N3.js + カスタムルール**: 既存実装を拡張
+3. **RDFox / Stardog**: 商用推論エンジン
+
+## Decision
+
+**選択肢 2: N3.js + カスタムOWL 2 RLルール** を採用する。
+
+### 理由
+- 既存のN3Store実装を活用可能
+- 軽量でNode.js環境に最適
+- 必要なルールセットのみ実装（段階的拡張）
+
+### 実装するOWL 2 RLルール（Phase 1）
+
+| ルールID | 説明 | 優先度 |
+|----------|------|--------|
+| prp-dom | rdfs:domain推論 | P0 |
+| prp-rng | rdfs:range推論 | P0 |
+| prp-spo1 | rdfs:subPropertyOf推論 | P0 |
+| cax-sco | rdfs:subClassOf推論 | P0 |
+| prp-trp | owl:TransitiveProperty | P1 |
+| prp-symp | owl:SymmetricProperty | P1 |
+| prp-inv1/2 | owl:inverseOf | P1 |
+
+### アーキテクチャ
+
+```
+QueryEngine
+    │
+    ▼
+RuleEngine (OWL 2 RL)
+    │
+    ├── BuiltInRules (prp-*, cax-*)
+    │
+    └── DatalogIntegrator (最大100ルール)
+           │
+           ▼
+    InferenceExecutor (200ms SLA)
+           │
+           ▼
+    ExplanationGenerator
+```
+
+### パフォーマンス目標
+| グラフサイズ | 目標レイテンシ |
+|-------------|---------------|
+| 1,000 triples | < 50ms |
+| 5,000 triples | < 100ms |
+| 10,000 triples | < 200ms |
+
+## Consequences
+
+### Positive
+- 既存実装との統合が容易
+- 軽量で高速
+- 段階的な機能追加が可能
+
+### Negative
+- OWL 2 RL全機能のサポートには時間がかかる
+- 複雑な推論には限界あり
+
+### Risks
+- 10,000トリプル超での性能劣化
+- 軽減策: インデックス最適化、マテリアライズドビュー
+
+## Related Requirements
+
+- REQ-ONTO-010: OWL 2 RL support
+- REQ-ONTO-011: 200ms inference latency
+- REQ-ONTO-012: Progress feedback
+- REQ-ONTO-013: Explanation generation
+- REQ-ONTO-014: Datalog integration