musubix 1.0.9 → 1.0.13

package/AGENTS.md

@@ -8,12 +8,13 @@
 
 | 項目 | 詳細 |
 |------|------|
-| **バージョン** | 1.0.0 |
+| **バージョン** | 1.0.12 |
 | **言語** | TypeScript |
 | **ランタイム** | Node.js >= 20.0.0 |
 | **パッケージマネージャ** | npm >= 10.0.0 |
 | **ビルドシステム** | モノレポ（npm workspaces） |
 | **テストフレームワーク** | Vitest |
+| **テスト数** | 285 (全合格) |
 
 ---
 
@@ -44,6 +45,7 @@ packages/core/src/
 ├── design/         # 設計パターン・C4モデル
 ├── error/          # エラーハンドリング
 ├── explanation/    # 説明生成・可視化
+├── learning/       # 自己学習システム（NEW!）
 ├── requirements/   # 要件分析・分解
 ├── traceability/   # トレーサビリティ
 ├── types/          # 型定義
@@ -90,6 +92,17 @@ npx musubix trace validate                 # リンク検証
 npx musubix explain why <id>               # 決定理由の説明
 npx musubix explain graph <id>             # 推論グラフ生成
 
+# 自己学習システム
+npx musubix learn status                   # 学習状態ダッシュボード
+npx musubix learn feedback <id>            # フィードバック記録
+npx musubix learn patterns                 # パターン一覧表示
+npx musubix learn add-pattern <name>       # パターン手動登録
+npx musubix learn remove-pattern <id>      # パターン削除
+npx musubix learn recommend                # コンテキストベースの推奨
+npx musubix learn decay                    # 未使用パターンの減衰
+npx musubix learn export                   # 学習データエクスポート
+npx musubix learn import <file>            # 学習データインポート
+
 # ヘルプ
 npx musubix --help
 npx musubix help <command>
@@ -236,11 +249,30 @@ npm run clean
 - **Component**: コンテナ内部構造
 - **Code**: 実装詳細
 
+**C4コード生成** (v1.0.12 NEW!):
+```bash
+# C4設計ドキュメントからTypeScriptスケルトンコードを自動生成
+npx musubix codegen generate <design.md> --output src/
+```
+- 設計パターン（Repository, Service, Factory等）を自動検出
+- コンポーネントごとにTypeScriptファイル生成
+- 設計との完全なトレーサビリティを維持
+
 ### 4. 完全なトレーサビリティ
 ```
 要件(REQ-*) → 設計(DES-*) → タスク(TSK-*) → コード → テスト
 ```
 
+### 5. 自己学習システム（REQ-LEARN-001〜006準拠）
+- **フィードバック収集**: accept/reject/modifyの記録と分析
+- **パターン抽出**: 繰り返しパターンの自動検出・登録
+- **適応的推論**: 学習済みパターンに基づく推論調整
+- **プライバシー保護**: 機密情報の自動フィルタリング（ローカルストレージのみ）
+
+```
+フィードバック → パターン候補 → 閾値超過 → パターン登録 → 推論に適用
+```
+
 ---
 
 ## 📚 ドキュメント
@@ -281,6 +313,6 @@ npm run clean
 ---
 
 **Agent**: GitHub Copilot / Claude
-**Last Updated**: 2026-01-02
-**Version**: 1.0.0
+**Last Updated**: 2026-01-05
+**Version**: 1.0.12
 **Repository**: https://github.com/nahisaho/MUSUBIX

package/README.ja.md

@@ -6,8 +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-285%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
 
 > MUSUBI × YATA 統合による次世代AIコーディングシステム
+>
+> **v1.0.12** - 自己学習システム、C4コード生成、日本語EARSサポート
 
 ## 概要
 
@@ -23,6 +26,8 @@ MUSUBIXは、**ニューラル（LLM）** と **シンボリック（知識グ
 - 💬 **一問一答形式ヒアリング** - 対話的な要件定義サポート
 - 🌐 **多言語対応（i18n）** - 日本語・英語対応
 - 🔒 **セキュリティスキャン** - 脆弱性検出・認証管理
+- 📚 **自己学習システム** - フィードバック収集とパターン抽出による適応的改善
+- 🏗️ **C4コード生成** - C4設計ドキュメントからTypeScriptスケルトン生成
 
 ## アーキテクチャ
 
@@ -59,6 +64,7 @@ flowchart TB
 | `packages/core/design/` | 設計パターン・C4モデル |
 | `packages/core/error/` | エラーハンドリング |
 | `packages/core/explanation/` | 説明生成・可視化 |
+| `packages/core/learning/` | 自己学習・パターン抽出 |
 | `packages/core/requirements/` | 要件分析・分解 |
 | `packages/core/traceability/` | トレーサビリティ |
 | `packages/core/types/` | 型定義 |
@@ -198,5 +204,5 @@ nahisaho
 ---
 
 **文書ID**: README  
-**バージョン**: 1.0.0  
-**最終更新**: 2026-01-02
+**バージョン**: 1.0.12  
+**最終更新**: 2026-01-03

package/README.md

@@ -7,8 +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-285%20passing-brightgreen)](https://github.com/nahisaho/MUSUBIX)
 
 > Next-generation AI Coding System powered by MUSUBI × YATA Integration
+>
+> **v1.0.12** - Self-learning system, C4 code generation, Japanese EARS support
 
 **[日本語版 README](README.ja.md)**
 
@@ -26,6 +29,8 @@ MUSUBIX is an innovative AI coding system that integrates **Neural (LLM)** and *
 - 💬 **Interactive Q&A Hearing** - Dialogue-based requirements gathering support
 - 🌐 **Internationalization (i18n)** - Japanese and English support
 - 🔒 **Security Scanning** - Vulnerability detection and authentication management
+- 📚 **Self-Learning System** - Adaptive improvement through feedback collection and pattern extraction
+- 🏗️ **C4 Code Generation** - Generate TypeScript skeleton from C4 design documents
 
 ## Architecture
 
@@ -62,6 +67,7 @@ flowchart TB
 | `packages/core/design/` | Design Patterns & C4 Models |
 | `packages/core/error/` | Error Handling |
 | `packages/core/explanation/` | Explanation Generation & Visualization |
+| `packages/core/learning/` | Self-Learning & Pattern Extraction |
 | `packages/core/requirements/` | Requirements Analysis & Decomposition |
 | `packages/core/traceability/` | Traceability |
 | `packages/core/types/` | Type Definitions |
@@ -201,5 +207,5 @@ See [CHANGELOG.md](CHANGELOG.md)
 ---
 
 **Document ID**: README  
-**Version**: 1.0.0  
-**Last Updated**: 2026-01-02
+**Version**: 1.0.12  
+**Last Updated**: 2026-01-03

package/docs/API-REFERENCE.md

@@ -628,6 +628,6 @@ MIT License - see [LICENSE](./LICENSE) for details.
 
 ---
 
-**Version:** 1.0.0  
-**Generated:** 2024  
+**Version:** 1.0.12  
+**Generated:** 2026-01-03  
 **MUSUBIX Core Package**

package/docs/USER-GUIDE.ja.md

@@ -13,10 +13,12 @@
 7. [設計フェーズ](#設計フェーズ)
 8. [タスクフェーズ](#タスクフェーズ)
 9. [検証フェーズ](#検証フェーズ)
-10. [MCPサーバー連携](#mcpサーバー連携)
-11. [YATA知識グラフ](#yata知識グラフ)
-12. [ベストプラクティス](#ベストプラクティス)
-13. [トラブルシューティング](#トラブルシューティング)
+10. [自己学習システム](#自己学習システム)
+11. [C4コード生成](#c4コード生成)
+12. [MCPサーバー連携](#mcpサーバー連携)
+13. [YATA知識グラフ](#yata知識グラフ)
+14. [ベストプラクティス](#ベストプラクティス)
+15. [トラブルシューティング](#トラブルシューティング)
 
 ---
 
@@ -507,6 +509,130 @@ console.log(`  テスト: ${result.coverage.tests}%`);
 
 ---
 
+## 自己学習システム
+
+MUSUBIXには、フィードバック収集とパターン抽出により改善を続ける自己学習システムが含まれています。
+
+### 学習CLIコマンド
+
+```bash
+# 学習状態ダッシュボードを表示
+musubix learn status
+
+# 成果物にフィードバックを記録
+musubix learn feedback <artifact-id> --type accept|reject|modify --artifact-type requirement|design|code|test --reason "説明"
+
+# 学習済みパターン一覧を表示
+musubix learn patterns
+
+# パターンを手動登録
+musubix learn add-pattern <name> --category code|design|requirement|test --action prefer|avoid --description "パターンの説明"
+
+# パターンを削除
+musubix learn remove-pattern <pattern-id>
+
+# コンテキストベースの推奨を取得
+musubix learn recommend --artifact-type code
+
+# 未使用パターンの減衰を適用
+musubix learn decay
+
+# 学習データをエクスポート
+musubix learn export --output learning-data.json
+
+# 学習データをインポート
+musubix learn import learning-data.json
+```
+
+### プログラムからの使用
+
+```typescript
+import { createLearningEngine } from '@nahisaho/musubix-core';
+
+const learningEngine = createLearningEngine();
+
+// フィードバックを記録
+await learningEngine.recordFeedback({
+  type: 'accept',
+  artifactType: 'code',
+  artifactId: 'AUTH-001',
+  reason: 'JWT認証の良い実装'
+});
+
+// 推奨を取得
+const recommendations = await learningEngine.getRecommendations({
+  artifactType: 'code',
+  context: 'authentication'
+});
+
+// 学習データをエクスポート
+const data = await learningEngine.exportData();
+```
+
+### パターン抽出
+
+類似のフィードバックが複数回（デフォルト閾値：3回）記録されると、パターンが自動的に抽出されます。
+
+```typescript
+// パターンは出現ごとに信頼度が上昇
+// 高信頼度パターン（≥70%）は推奨に表示される
+const stats = await learningEngine.getStats();
+console.log(`総パターン数: ${stats.totalPatterns}`);
+console.log(`高信頼度パターン: ${stats.highConfidencePatterns}`);
+```
+
+---
+
+## C4コード生成
+
+C4設計ドキュメントからTypeScriptスケルトンコードを生成します。
+
+### CLIの使用
+
+```bash
+# C4設計からコード生成
+musubix codegen generate design-c4.md --output src/
+
+# 言語を指定
+musubix codegen generate design-c4.md --output src/ --language typescript
+```
+
+### 生成されるコード構造
+
+以下のようなコンポーネントを持つC4設計から：
+
+| ID | Name | Type | Description |
+|----|------|------|-------------|
+| auth | AuthService | component | 認証 |
+
+MUSUBIXは以下を生成します：
+
+```typescript
+// auth-service.ts
+export interface IAuthService {
+  authenticate(credentials: { username: string; password: string }): Promise<{ token: string }>;
+  validate(token: string): Promise<boolean>;
+}
+
+export class AuthService implements IAuthService {
+  async authenticate(credentials: { username: string; password: string }): Promise<{ token: string }> {
+    // TODO: authenticateを実装
+    throw new Error('Not implemented');
+  }
+  
+  async validate(token: string): Promise<boolean> {
+    // TODO: validateを実装
+    throw new Error('Not implemented');
+  }
+}
+
+export function createAuthService(): IAuthService {
+  return new AuthService();
+}
+```
+
+---
+
 ## MCPサーバー連携
 
 ### MCPサーバーの起動
@@ -819,6 +945,6 @@ const client = createYATAClient({
 
 ---
 
-**バージョン**: 1.0.0  
-**最終更新**: 2026-01-02  
+**バージョン**: 1.0.12  
+**最終更新**: 2026-01-03  
 **MUSUBIX Project**

package/docs/USER-GUIDE.md

@@ -11,10 +11,12 @@
 3. [CLI Usage](#cli-usage)
 4. [Quick Start](#quick-start)
 5. [SDD Workflow](#sdd-workflow)
-6. [MCP Server Integration](#mcp-server-integration)
-7. [YATA Integration](#yata-integration)
-8. [Best Practices](#best-practices)
-9. [Troubleshooting](#troubleshooting)
+6. [Self-Learning System](#self-learning-system)
+7. [C4 Code Generation](#c4-code-generation)
+8. [MCP Server Integration](#mcp-server-integration)
+9. [YATA Integration](#yata-integration)
+10. [Best Practices](#best-practices)
+11. [Troubleshooting](#troubleshooting)
 
 ---
 
@@ -375,6 +377,130 @@ result.articleResults.forEach(article => {
 
 ---
 
+## Self-Learning System
+
+MUSUBIX includes a self-learning system that improves through feedback collection and pattern extraction.
+
+### Learning CLI Commands
+
+```bash
+# View learning status dashboard
+musubix learn status
+
+# Record feedback on an artifact
+musubix learn feedback <artifact-id> --type accept|reject|modify --artifact-type requirement|design|code|test --reason "explanation"
+
+# List learned patterns
+musubix learn patterns
+
+# Manually register a pattern
+musubix learn add-pattern <name> --category code|design|requirement|test --action prefer|avoid --description "pattern description"
+
+# Remove a pattern
+musubix learn remove-pattern <pattern-id>
+
+# Get context-based recommendations
+musubix learn recommend --artifact-type code
+
+# Apply decay to unused patterns
+musubix learn decay
+
+# Export learning data
+musubix learn export --output learning-data.json
+
+# Import learning data
+musubix learn import learning-data.json
+```
+
+### Programmatic Usage
+
+```typescript
+import { createLearningEngine } from '@nahisaho/musubix-core';
+
+const learningEngine = createLearningEngine();
+
+// Record feedback
+await learningEngine.recordFeedback({
+  type: 'accept',
+  artifactType: 'code',
+  artifactId: 'AUTH-001',
+  reason: 'Good implementation of JWT authentication'
+});
+
+// Get recommendations
+const recommendations = await learningEngine.getRecommendations({
+  artifactType: 'code',
+  context: 'authentication'
+});
+
+// Export learning data
+const data = await learningEngine.exportData();
+```
+
+### Pattern Extraction
+
+Patterns are automatically extracted when similar feedback is recorded multiple times (default threshold: 3).
+
+```typescript
+// Patterns gain confidence with each occurrence
+// High-confidence patterns (≥70%) appear in recommendations
+const stats = await learningEngine.getStats();
+console.log(`Total patterns: ${stats.totalPatterns}`);
+console.log(`High confidence patterns: ${stats.highConfidencePatterns}`);
+```
+
+---
+
+## C4 Code Generation
+
+Generate TypeScript skeleton code from C4 design documents.
+
+### CLI Usage
+
+```bash
+# Generate code from C4 design
+musubix codegen generate design-c4.md --output src/
+
+# With specific language
+musubix codegen generate design-c4.md --output src/ --language typescript
+```
+
+### Generated Code Structure
+
+From a C4 design with components like:
+
+| ID | Name | Type | Description |
+|----|------|------|-------------|
+| auth | AuthService | component | Authentication |
+
+MUSUBIX generates:
+
+```typescript
+// auth-service.ts
+export interface IAuthService {
+  authenticate(credentials: { username: string; password: string }): Promise<{ token: string }>;
+  validate(token: string): Promise<boolean>;
+}
+
+export class AuthService implements IAuthService {
+  async authenticate(credentials: { username: string; password: string }): Promise<{ token: string }> {
+    // TODO: Implement authenticate
+    throw new Error('Not implemented');
+  }
+  
+  async validate(token: string): Promise<boolean> {
+    // TODO: Implement validate
+    throw new Error('Not implemented');
+  }
+}
+
+export function createAuthService(): IAuthService {
+  return new AuthService();
+}
+```
+
+---
+
 ## MCP Server Integration
 
 ### CLI Startup
@@ -659,6 +785,6 @@ const client = createYATAClient({
 
 ---
 
-**Version**: 1.0.0  
-**Last Updated**: 2026-01-02  
+**Version**: 1.0.12  
+**Last Updated**: 2026-01-03  
 **MUSUBIX Project**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musubix",
-  "version": "1.0.9",
+  "version": "1.0.13",
   "description": "Neuro-Symbolic AI Coding System - MUSUBI × YATA Integration",
   "type": "module",
   "workspaces": [

package/steering/tech.ja.md

@@ -1,42 +1,133 @@
 # Technology Stack
 
 **Project**: MUSUBIX
-**Last Updated**: 2026-01-01
-**Status**: Technology stack to be determined
+**Last Updated**: 2026-01-03
+**Version**: 1.0.10
+**Status**: Production Ready
 
 ---
 
 ## Overview
 
-The technology stack for this project has not yet been decided. This document will be updated once the technical decisions are made.
+MUSUBIXはニューロシンボリックAIコーディングシステムであり、LLM（Large Language Model）とシンボリック推論（知識グラフ）を統合しています。
 
-## Decision Criteria
+## Core Technologies
 
-When selecting technologies, consider:
+| カテゴリ | 技術 | バージョン | 状態 |
+|---------|------|-----------|------|
+| 言語 | TypeScript | 5.3+ | ✅ 採用 |
+| ランタイム | Node.js | 20.0.0+ | ✅ 採用 |
+| パッケージマネージャ | npm | 10.0.0+ | ✅ 採用 |
+| ビルドシステム | tsc | 5.3+ | ✅ 採用 |
+| テストフレームワーク | Vitest | 4.0+ | ✅ 採用 |
+| リンター | ESLint | 9.0+ | ✅ 採用 |
 
-1. **Application Type**: What type of application is being built?
-2. **Performance Requirements**: What are the performance constraints?
-3. **Team Expertise**: What technologies is the team familiar with?
-4. **Ecosystem**: What libraries and tools are available?
-5. **Long-term Maintainability**: How well-supported is the technology?
+## Architecture
 
-## Candidates Under Consideration
+### パッケージ構成（モノレポ）
 
-| Aspect | Options | Decision |
-|--------|---------|----------|
-| Primary Language | TBD | ⏳ Pending |
-| Web Framework | TBD | ⏳ Pending |
-| Database | TBD | ⏳ Pending |
-| Hosting | TBD | ⏳ Pending |
+```
+packages/
+├── core/           # @nahisaho/musubix-core (v1.0.9)
+├── mcp-server/     # @nahisaho/musubix-mcp-server (v1.0.3)
+└── yata-client/    # @nahisaho/musubix-yata-client (v1.0.3)
+```
 
-## Next Steps
+### Core Package モジュール
 
-1. [ ] Define functional requirements
-2. [ ] Identify performance constraints
-3. [ ] Evaluate team skills
-4. [ ] Create proof-of-concept
-5. [ ] Make final decision and update this document
+| モジュール | 役割 | 主要機能 |
+|-----------|------|---------|
+| `auth/` | 認証・認可 | JWT/OAuth管理 |
+| `cli/` | CLIインターフェース | コマンドライン処理 |
+| `codegen/` | コード生成・解析 | テンプレート生成、静的解析、セキュリティスキャン |
+| `design/` | 設計 | パターン検出、C4モデル、ADR生成 |
+| `error/` | エラーハンドリング | 構造化エラー、リカバリー |
+| `explanation/` | 説明生成 | 推論グラフ、可視化 |
+| `requirements/` | 要件分析 | EARS検証、オントロジーマッピング |
+| `traceability/` | トレーサビリティ | アーティファクト追跡、カバレッジ分析 |
+| `validators/` | 検証 | EARS検証器 |
+
+## Key Features
+
+### 1. EARS検証器（Symbolic Reasoning）
+
+5つのEARSパターンをサポート：
+
+| パターン | 構文 | 信頼度ボーナス |
+|---------|------|---------------|
+| Event-driven | `WHEN <trigger>, THE <system> SHALL <action>` | +0.25 |
+| State-driven | `WHILE <state>, THE <system> SHALL <action>` | +0.25 |
+| Unwanted | `THE <system> SHALL NOT <behavior>` | +0.20 |
+| Optional | `WHERE <feature>, THE <system> SHALL <action>` | +0.20 |
+| Ubiquitous | `THE <system> SHALL <action>` | +0.00 |
+
+**最適化機能**:
+- 早期終了（高信頼度≥0.85で即座にマッチ）
+- 事前チェック（"shall"キーワードの存在確認）
+
+### 2. トレーサビリティ管理
+
+**カバレッジ計算（重み付け平均）**:
+- 要件: 30%
+- 設計: 20%
+- コード: 30%
+- テスト: 20%
+
+**最適化機能**:
+- リンクインデックス（O(1)検索）
+- アーティファクト型インデックス
+
+### 3. アーティファクトステータス
+
+```typescript
+type ArtifactStatus =
+  | 'draft'       // 初期作成状態
+  | 'active'      // アクティブ開発中
+  | 'approved'    // レビュー承認済み
+  | 'implemented' // コード実装完了
+  | 'verified'    // テスト・検証完了
+  | 'deprecated'  // 非推奨
+  | 'deleted';    // 削除予定
+```
+
+### 4. ニューロシンボリック統合ルール（REQ-INT-002）
+
+| シンボリック結果 | ニューラル信頼度 | 最終決定 |
+|-----------------|-----------------|---------|
+| invalid | - | ニューラル結果を棄却 |
+| valid | ≥0.8 | ニューラル結果を採用 |
+| valid | <0.8 | シンボリック結果を優先 |
+
+## Development Commands
+
+```bash
+# 依存関係インストール
+npm install
+
+# 全パッケージビルド
+npm run build
+
+# テスト実行
+npm run test
+
+# コード品質
+npm run lint
+npm run typecheck
+
+# クリーンアップ
+npm run clean
+```
+
+## Performance Benchmarks
+
+| 機能 | 処理速度 | 備考 |
+|------|---------|------|
+| EARS検証（単一要件） | <1ms | 早期終了最適化 |
+| パターンマッチング | <5ms | 信頼度計算含む |
+| トレーサビリティリンク検索 | O(1) | インデックス利用 |
+| C4モデル生成 | <10ms | 11要素、6関係 |
+| 全テスト（262件） | ~750ms | Vitest実行 |
 
 ---
 
-*Run `musubi steering` to update this document after decisions are made.*
+*Last Updated: 2026-01-03 by MUSUBIX v1.0.10*