musubix 1.6.0 → 1.8.0

package/AGENTS.md

@@ -8,13 +8,13 @@
 
 | 項目 | 詳細 |
 |------|------|
-| **バージョン** | 1.6.0 (開発中) |
+| **バージョン** | 1.8.0 (Security Analysis Edition) |
 | **言語** | TypeScript |
 | **ランタイム** | Node.js >= 20.0.0 |
 | **パッケージマネージャ** | npm >= 10.0.0 |
 | **ビルドシステム** | モノレポ（npm workspaces） |
 | **テストフレームワーク** | Vitest |
-| **テスト数** | 1208 (全合格) |
+| **テスト数** | 1586 (全合格) |
 | **コンポーネント数** | 249 (62ドメイン対応) |
 | **Agent Skills** | 12 (Claude Code対応) |
 
@@ -28,18 +28,28 @@
 packages/
 ├── core/           # @nahisaho/musubix-core
 ├── mcp-server/     # @nahisaho/musubix-mcp-server  
+├── security/       # @nahisaho/musubix-security (NEW!)
+├── formal-verify/  # @nahisaho/musubix-formal-verify
 ├── 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
+├── 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 | 役割 |
 |-----------|-----|------|
 | `packages/core/` | `@nahisaho/musubix-core` | コアライブラリ - CLI、EARS検証、コード生成、設計パターン |
 | `packages/mcp-server/` | `@nahisaho/musubix-mcp-server` | MCPサーバー - 19ツール、3プロンプト |
+| `packages/security/` | `@nahisaho/musubix-security` | **セキュリティ分析** - 脆弱性検出、シークレット検出、テイント解析 (NEW!) |
+| `packages/formal-verify/` | `@nahisaho/musubix-formal-verify` | 形式検証 - Z3統合、Hoare検証、EARS→SMT変換 |
 | `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可視化・管理インターフェース |
 | `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 +106,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 +139,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 +170,7 @@ npx @nahisaho/musubix-mcp-server
 npx musubix-mcp --transport stdio
 ```
 
-### ツール一覧（19ツール）
+### ツール一覧（24ツール）
 
 #### SDD基本ツール（9ツール）
 
@@ -178,6 +206,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 +526,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-1569%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
 
 > MUSUBI × YATA 統合による次世代AIコーディングシステム
 >
-> **v1.6.0** - REPLテスト実装＆CLI統合
+> **v1.7.5** - 形式検証エディション
 
 ## 概要
 
@@ -32,6 +32,11 @@ 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)*
+- 🔬 **形式検証** - Z3 SMTソルバー統合、Hoareトリプル検証、EARS→SMT変換 *(v1.7.5)*
 
 ## アーキテクチャ
 
@@ -75,7 +80,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-1569%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.5** - Formal Verification Edition
 
 **[日本語版 README](README.ja.md)**
 
@@ -35,6 +35,11 @@ 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)*
+- 🔬 **Formal Verification** - Z3 SMT solver integration, Hoare triple verification, EARS-to-SMT conversion *(v1.7.5)*
 
 ## Architecture
 
@@ -78,12 +83,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 +178,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,11 @@
   - [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)*
+  - [Formal Verification](#formal-verification) *(v1.7.5)*
   - [Validation](#validation)
   - [Utils](#utils)
 - [MCP Server](#mcp-server)
@@ -681,6 +686,443 @@ 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 |
+
+---
+
+### Formal Verification (v1.7.5)
+
+The formal verification module provides Z3 SMT solver integration for verifying code correctness.
+
+#### Z3Adapter
+
+Unified interface for Z3 backends (WASM or Process).
+
+```typescript
+import { Z3Adapter } from '@nahisaho/musubix-formal-verify';
+
+// Create adapter (auto-selects best backend)
+const z3 = await Z3Adapter.create();
+
+// Check satisfiability
+const result = await z3.checkSat('(declare-const x Int) (assert (> x 0))');
+console.log(result); // 'sat' | 'unsat' | 'unknown'
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `create()` | - | `Promise<Z3Adapter>` | Create adapter instance |
+| `checkSat(smtLib2)` | `smtLib2: string` | `Promise<string>` | Check satisfiability |
+| `dispose()` | - | `Promise<void>` | Cleanup resources |
+
+---
+
+#### PreconditionVerifier
+
+Verifies preconditions for functions and methods.
+
+```typescript
+import { PreconditionVerifier } from '@nahisaho/musubix-formal-verify';
+
+const verifier = new PreconditionVerifier(z3Adapter);
+
+const result = await verifier.verify({
+  condition: { expression: 'amount > 0 && balance >= amount', format: 'javascript' },
+  variables: [
+    { name: 'amount', type: 'Int' },
+    { name: 'balance', type: 'Int' }
+  ]
+});
+
+console.log(result.status); // 'valid' | 'invalid' | 'unknown' | 'error'
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `verify(spec)` | `PreconditionSpec` | `Promise<VerificationResult>` | Verify precondition |
+
+**PreconditionSpec:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `condition` | `Condition` | The precondition to verify |
+| `variables` | `Variable[]` | Variables with types |
+
+**VerificationResult:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `status` | `'valid' \| 'invalid' \| 'unknown' \| 'error'` | Verification status |
+| `counterexample?` | `Record<string, any>` | Counterexample if invalid |
+| `message?` | `string` | Additional message |
+
+---
+
+#### PostconditionVerifier
+
+Verifies Hoare triples {P} C {Q}.
+
+```typescript
+import { PostconditionVerifier } from '@nahisaho/musubix-formal-verify';
+
+const verifier = new PostconditionVerifier(z3Adapter);
+
+const result = await verifier.verify({
+  precondition: { expression: 'balance >= amount', format: 'javascript' },
+  postcondition: { expression: 'balance_new == balance - amount', format: 'javascript' },
+  preVariables: [
+    { name: 'balance', type: 'Int' },
+    { name: 'amount', type: 'Int' }
+  ],
+  postVariables: [
+    { name: 'balance_new', type: 'Int' }
+  ],
+  transition: 'balance_new == balance - amount'
+});
+```
+
+**PostconditionSpec:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `precondition` | `Condition` | Pre-state condition |
+| `postcondition` | `Condition` | Post-state condition |
+| `preVariables` | `Variable[]` | Pre-state variables |
+| `postVariables` | `Variable[]` | Post-state variables |
+| `transition` | `string` | State transition expression |
+
+---
+
+#### EarsToSmtConverter
+
+Converts EARS requirements to SMT-LIB2 formulas.
+
+```typescript
+import { EarsToSmtConverter } from '@nahisaho/musubix-formal-verify';
+
+const converter = new EarsToSmtConverter();
+
+// Single conversion
+const result = converter.convert('THE system SHALL validate inputs');
+
+// Multiple conversions
+const results = converter.convertMultiple([
+  'THE system SHALL validate inputs',           // ubiquitous
+  'WHEN error, THE system SHALL notify user',   // event-driven
+  'WHILE busy, THE system SHALL queue requests', // state-driven
+  'THE system SHALL NOT expose secrets',        // unwanted
+  'IF admin, THEN THE system SHALL allow edit'  // optional
+]);
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `convert(ears)` | `ears: string` | `ConversionResult` | Convert single requirement |
+| `convertMultiple(ears[])` | `ears: string[]` | `ConversionResult[]` | Convert multiple requirements |
+
+**EARS Patterns:**
+
+| Pattern | Syntax | SMT Encoding |
+|---------|--------|--------------|
+| Ubiquitous | `THE system SHALL [action]` | `(assert action)` |
+| Event-driven | `WHEN [event], THE system SHALL [response]` | `(assert (=> event response))` |
+| State-driven | `WHILE [state], THE system SHALL [response]` | `(assert (=> state response))` |
+| Unwanted | `THE system SHALL NOT [behavior]` | `(assert (not behavior))` |
+| Optional | `IF [condition], THEN THE system SHALL [response]` | `(assert (=> condition response))` |
+
+---
+
+#### TraceabilityDB
+
+SQLite-based traceability database.
+
+```typescript
+import { TraceabilityDB } from '@nahisaho/musubix-formal-verify';
+
+const db = new TraceabilityDB('./trace.db');
+
+// Add nodes
+await db.addNode({ id: 'REQ-001', type: 'requirement', title: 'User Auth' });
+await db.addNode({ id: 'DES-001', type: 'design', title: 'AuthService' });
+await db.addNode({ id: 'CODE-001', type: 'code', title: 'auth.ts' });
+
+// Add links
+await db.addLink({ source: 'DES-001', target: 'REQ-001', type: 'satisfies' });
+await db.addLink({ source: 'CODE-001', target: 'DES-001', type: 'implements' });
+
+// Query
+const node = await db.getNode('REQ-001');
+const stats = await db.getStatistics();
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `addNode(node)` | `TraceNode` | `Promise<void>` | Add traceability node |
+| `getNode(id)` | `id: string` | `Promise<TraceNode \| undefined>` | Get node by ID |
+| `addLink(link)` | `TraceLink` | `Promise<void>` | Add traceability link |
+| `getStatistics()` | - | `Promise<TraceStats>` | Get database statistics |
+| `query(nodeId, options?)` | `nodeId: string, QueryOptions` | `Promise<QueryResult>` | Query related nodes |
+| `close()` | - | `void` | Close database |
+
+**Node Types:**
+
+| Type | Description |
+|------|-------------|
+| `requirement` | Requirements (REQ-*) |
+| `design` | Design artifacts (DES-*) |
+| `code` | Code files |
+| `test` | Test cases |
+
+**Link Types:**
+
+| Type | Description |
+|------|-------------|
+| `satisfies` | Design satisfies requirement |
+| `implements` | Code implements design |
+| `verifies` | Test verifies requirement |
+| `traces-to` | Generic traceability |
+
+---
+
+#### ImpactAnalyzer
+
+Analyzes change impact across traceability graph.
+
+```typescript
+import { ImpactAnalyzer } from '@nahisaho/musubix-formal-verify';
+
+const analyzer = new ImpactAnalyzer(traceabilityDB);
+
+// Analyze impact of changing REQ-001
+const impact = await analyzer.analyze('REQ-001');
+
+console.log(`Total impacted: ${impact.totalImpacted}`);
+console.log(`Direct: ${impact.directImpact.length}`);
+console.log(`Indirect: ${impact.indirectImpact.length}`);
+```
+
+**Methods:**
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `analyze(nodeId)` | `nodeId: string` | `Promise<ImpactResult>` | Analyze change impact |
+
+**ImpactResult:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `sourceId` | `string` | Source node ID |
+| `directImpact` | `ImpactedNode[]` | Directly impacted nodes |
+| `indirectImpact` | `ImpactedNode[]` | Transitively impacted nodes |
+| `totalImpacted` | `number` | Total number of impacted nodes |
+| `maxDepth` | `number` | Maximum impact depth |
+
+---
+
 ### Utils
 
 #### I18nManager
@@ -978,6 +1420,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,8 +1,8 @@
 # MUSUBIX インストールガイド
 
 **文書ID**: INSTALL-GUIDE  
-**バージョン**: 1.6.0  
-**最終更新**: 2026-01-06
+**バージョン**: 1.7.5  
+**最終更新**: 2026-01-07
 
 ---
 

package/docs/INSTALL-GUIDE.md

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