musubix 1.7.0 → 1.8.0

package/AGENTS.md

@@ -8,13 +8,13 @@
 
 | 項目 | 詳細 |
 |------|------|
-| **バージョン** | 1.7.0 (YATA Platform Enhancements) |
+| **バージョン** | 1.8.0 (Security Analysis Edition) |
 | **言語** | TypeScript |
 | **ランタイム** | Node.js >= 20.0.0 |
 | **パッケージマネージャ** | npm >= 10.0.0 |
 | **ビルドシステム** | モノレポ（npm workspaces） |
 | **テストフレームワーク** | Vitest |
-| **テスト数** | 1386 (全合格) |
+| **テスト数** | 1586 (全合格) |
 | **コンポーネント数** | 249 (62ドメイン対応) |
 | **Agent Skills** | 12 (Claude Code対応) |
 
@@ -28,10 +28,12 @@
 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
 ├── yata-local/     # @nahisaho/yata-local
 ├── yata-global/    # @nahisaho/yata-global
-├── yata-ui/        # @nahisaho/yata-ui (NEW!)
+├── yata-ui/        # @nahisaho/yata-ui
 ├── pattern-mcp/    # @nahisaho/musubix-pattern-mcp
 ├── ontology-mcp/   # @nahisaho/musubix-ontology-mcp
 ├── wake-sleep/     # @nahisaho/musubix-wake-sleep
@@ -42,10 +44,12 @@ packages/
 |-----------|-----|------|
 | `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可視化・管理インターフェース (NEW!) |
+| `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学習サイクル |

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-1429%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.7.0** - YATAプラットフォーム拡張
+> **v1.7.5** - 形式検証エディション
 
 ## 概要
 
@@ -36,6 +36,7 @@ MUSUBIXは、**ニューラル（LLM）** と **シンボリック（知識グ
 - 🌐 **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)*
 
 ## アーキテクチャ
 

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-1429%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.7.0** - YATA Platform Enhancements
+> **v1.7.5** - Formal Verification Edition
 
 **[日本語版 README](README.ja.md)**
 
@@ -39,6 +39,7 @@ MUSUBIX is an innovative AI coding system that integrates **Neural (LLM)** and *
 - 🌐 **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
 

package/docs/API-REFERENCE.md

@@ -18,6 +18,7 @@
   - [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)
@@ -885,6 +886,243 @@ await server.start();
 
 ---
 
+### 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

package/docs/INSTALL-GUIDE.ja.md

@@ -1,8 +1,8 @@
 # MUSUBIX インストールガイド
 
 **文書ID**: INSTALL-GUIDE  
-**バージョン**: 1.7.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.7.0  
-**Last Updated**: 2026-01-06
+**Version**: 1.7.5  
+**Last Updated**: 2026-01-07
 
 ---
 

package/docs/USER-GUIDE.ja.md

@@ -23,7 +23,8 @@
 17. [YATA Global](#yata-global) *(v1.6.3)*
 18. [KGPR - Knowledge Graph Pull Request](#kgpr---knowledge-graph-pull-request) *(v1.6.4)*
 19. [YATA プラットフォーム拡張](#yata-プラットフォーム拡張) *(v1.7.0)*
-20. [MCPサーバー連携](#mcpサーバー連携)
+20. [形式検証](#形式検証) *(v1.7.5)*
+21. [MCPサーバー連携](#mcpサーバー連携)
 21. [YATA知識グラフ](#yata知識グラフ)
 22. [ベストプラクティス](#ベストプラクティス)
 23. [トラブルシューティング](#トラブルシューティング)
@@ -1551,6 +1552,119 @@ console.log(`UI: ${server.getUrl()}`);
 
 ---
 
+## 形式検証
+
+*(v1.7.5)*
+
+`@nahisaho/musubix-formal-verify` パッケージは、Z3 SMTソルバーを使用した形式検証機能を提供します。
+
+### インストール
+
+```bash
+npm install @nahisaho/musubix-formal-verify
+# オプション: WebAssemblyサポート用にz3-solverをインストール
+npm install z3-solver
+```
+
+### Z3 SMTソルバー統合
+
+```typescript
+import { Z3Adapter, PreconditionVerifier, PostconditionVerifier } from '@nahisaho/musubix-formal-verify';
+
+// Z3アダプター作成（バックエンド自動選択）
+const z3 = await Z3Adapter.create();
+
+// 事前条件検証
+const preVerifier = new PreconditionVerifier(z3);
+const result = await preVerifier.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'
+```
+
+### Hoareトリプル検証
+
+```typescript
+// {P} C {Q} の検証
+const postVerifier = new PostconditionVerifier(z3);
+const hoareResult = await postVerifier.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',
+});
+```
+
+### EARS→SMT変換
+
+```typescript
+import { EarsToSmtConverter } from '@nahisaho/musubix-formal-verify';
+
+const converter = new EarsToSmtConverter();
+
+// EARS要件をSMT-LIB2に変換
+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
+]);
+
+results.forEach(r => {
+  console.log(`パターン: ${r.formula?.metadata.earsPattern.type}`);
+  console.log(`SMT: ${r.formula?.smtLib2}`);
+});
+```
+
+### トレーサビリティデータベース
+
+```typescript
+import { TraceabilityDB, ImpactAnalyzer } from '@nahisaho/musubix-formal-verify';
+
+// SQLiteベースのトレーサビリティDB作成
+const db = new TraceabilityDB('./trace.db');
+
+// ノード追加
+await db.addNode({ id: 'REQ-001', type: 'requirement', title: 'ユーザー認証' });
+await db.addNode({ id: 'DES-001', type: 'design', title: 'AuthService' });
+await db.addNode({ id: 'CODE-001', type: 'code', title: 'auth.ts' });
+
+// トレーサビリティリンク追加
+await db.addLink({ source: 'DES-001', target: 'REQ-001', type: 'satisfies' });
+await db.addLink({ source: 'CODE-001', target: 'DES-001', type: 'implements' });
+
+// 影響分析
+const analyzer = new ImpactAnalyzer(db);
+const impact = await analyzer.analyze('REQ-001');
+console.log(`影響ノード数: ${impact.totalImpacted}`);
+```
+
+### v1.7.5 パッケージ概要
+
+| パッケージ | 説明 |
+|-----------|------|
+| `@nahisaho/musubix-formal-verify` | Z3統合、Hoare検証、EARS→SMT、トレーサビリティDB |
+
+### サポートされる変数型
+
+| 型 | 説明 |
+|----|------|
+| `Int` | 整数値 |
+| `Real` | 実数 |
+| `Bool` | 真偽値 |
+| `String` | 文字列 |
+| `Array` | 配列型 |
+| `BitVec` | ビットベクトル |
+
+---
+
 ## MCPサーバー連携
 
 ### MCPサーバーの起動

package/docs/USER-GUIDE.md

@@ -21,7 +21,8 @@
 13. [YATA Global](#yata-global) *(v1.6.3)*
 14. [KGPR - Knowledge Graph Pull Request](#kgpr---knowledge-graph-pull-request) *(v1.6.4)*
 15. [YATA Platform Enhancements](#yata-platform-enhancements) *(v1.7.0)*
-16. [MCP Server Integration](#mcp-server-integration)
+16. [Formal Verification](#formal-verification) *(v1.7.5)*
+17. [MCP Server Integration](#mcp-server-integration)
 17. [YATA Integration](#yata-integration)
 18. [Best Practices](#best-practices)
 19. [Troubleshooting](#troubleshooting)
@@ -1093,6 +1094,119 @@ console.log(`UI available at ${server.getUrl()}`);
 
 ---
 
+## Formal Verification
+
+*(v1.7.5)*
+
+The `@nahisaho/musubix-formal-verify` package provides formal verification capabilities using the Z3 SMT solver.
+
+### Installation
+
+```bash
+npm install @nahisaho/musubix-formal-verify
+# Optional: Install z3-solver for WebAssembly support
+npm install z3-solver
+```
+
+### Z3 SMT Solver Integration
+
+```typescript
+import { Z3Adapter, PreconditionVerifier, PostconditionVerifier } from '@nahisaho/musubix-formal-verify';
+
+// Create Z3 adapter (auto-selects backend)
+const z3 = await Z3Adapter.create();
+
+// Precondition verification
+const preVerifier = new PreconditionVerifier(z3);
+const result = await preVerifier.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'
+```
+
+### Hoare Triple Verification
+
+```typescript
+// Verify {P} C {Q}
+const postVerifier = new PostconditionVerifier(z3);
+const hoareResult = await postVerifier.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',
+});
+```
+
+### EARS to SMT Conversion
+
+```typescript
+import { EarsToSmtConverter } from '@nahisaho/musubix-formal-verify';
+
+const converter = new EarsToSmtConverter();
+
+// Convert EARS requirements to SMT-LIB2
+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
+]);
+
+results.forEach(r => {
+  console.log(`Pattern: ${r.formula?.metadata.earsPattern.type}`);
+  console.log(`SMT: ${r.formula?.smtLib2}`);
+});
+```
+
+### Traceability Database
+
+```typescript
+import { TraceabilityDB, ImpactAnalyzer } from '@nahisaho/musubix-formal-verify';
+
+// Create SQLite-based traceability database
+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 traceability links
+await db.addLink({ source: 'DES-001', target: 'REQ-001', type: 'satisfies' });
+await db.addLink({ source: 'CODE-001', target: 'DES-001', type: 'implements' });
+
+// Impact analysis
+const analyzer = new ImpactAnalyzer(db);
+const impact = await analyzer.analyze('REQ-001');
+console.log(`Impacted nodes: ${impact.totalImpacted}`);
+```
+
+### v1.7.5 Package Summary
+
+| Package | Description |
+|---------|-------------|
+| `@nahisaho/musubix-formal-verify` | Z3 integration, Hoare verification, EARS→SMT, TraceabilityDB |
+
+### Supported Variable Types
+
+| Type | Description |
+|------|-------------|
+| `Int` | Integer values |
+| `Real` | Real numbers |
+| `Bool` | Boolean values |
+| `String` | String values |
+| `Array` | Array types |
+| `BitVec` | Bit vectors |
+
+---
+
 ## MCP Server Integration
 
 ### CLI Startup