musubix 3.6.1 → 3.7.3

package/.github/skills/build-fix/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: build-fix
+description: ビルドエラーを分析し、反復的に修正。TypeScript/ESLint/依存関係エラーに対応。
+license: MIT
+version: 1.1.0
+triggers:
+  - ビルドエラー発生
+  - /build-fix
+  - npm run build 失敗
+---
+
+# Build Fix
+
+> **要約**: ビルドエラーを自動分類し、反復的な修正戦略で段階的に解決。
+
+## 🔍 エラー分析 (REQ-BF-001)
+
+**WHEN** ビルドエラー発生  
+**DO** カテゴリ分類と優先度付け
+
+| カテゴリ | 例 | 優先度 |
+|---------|-----|--------|
+| **Type Error** | TS2322, TS2339 | 🔴 高 |
+| **Import Error** | Module not found | 🔴 高 |
+| **Syntax Error** | Unexpected token | 🔴 高 |
+| **Lint Error** | ESLint errors | 🟡 中 |
+| **Config Error** | tsconfig, webpack | 🟡 中 |
+| **Dependency** | Version mismatch | 🟢 低 |
+
+### 分析出力
+
+```
+🔍 Build Error Analysis
+━━━━━━━━━━━━━━━━━━━━━━
+Total: 8 errors
+
+By Category:
+  🔴 Type Error:   4 (High)
+  🔴 Import Error: 2 (High)
+  🟡 Lint Error:   2 (Medium)
+
+Root Cause:
+  1. src/user.ts:45 - Missing 'email' property
+     → Causes 2 downstream errors
+
+Fix Order:
+  1. src/user.ts:45 (root cause)
+  2. Remaining may resolve automatically
+```
+
+---
+
+## 🔄 修正ループ (REQ-BF-002)
+
+**WHILE** ビルドエラーが存在 (最大10回)  
+**DO** 以下のループを実行
+
+```
+1. エラーリスト取得
+   ↓
+2. Root Cause特定（影響範囲最大のエラー）
+   ↓
+3. 修正適用（1エラーに集中）
+   ↓
+4. ビルド再実行
+   ↓
+5. 結果確認
+   ↓
+エラーあり → 1へ戻る
+```
+
+### 優先順位
+
+1. **Root Cause First** - 連鎖エラーの根本原因
+2. **Import/Module First** - コンパイル阻害要因
+3. **Type Errors** - 下流エラーの原因
+4. **Syntax Errors** - 局所的だが致命的
+5. **Lint Errors** - 最後に対応
+
+---
+
+## 📋 TypeScriptエラーリファレンス
+
+| コード | 説明 | 解決策 |
+|--------|------|--------|
+| TS2322 | Type not assignable | 型の修正/アサーション |
+| TS2339 | Property not exist | プロパティ追加/型定義修正 |
+| TS2345 | Argument mismatch | 引数の型修正 |
+| TS2304 | Cannot find name | import追加/定義追加 |
+| TS2307 | Module not found | パス修正/インストール |
+| TS2531 | Possibly null | nullチェック追加 |
+
+---
+
+## 📊 Fix Report (REQ-BF-003)
+
+**WHEN** 修正完了  
+**DO** レポート生成
+
+```
+🔧 Build Fix Report
+━━━━━━━━━━━━━━━━━━━━━━━━
+Iterations: 2
+Errors Fixed: 8
+
+Changes:
+  • src/user.ts (+5 -2)
+  • tsconfig.json (+1 -0)
+
+Progress:
+  Iteration 1: 8 → 4 errors
+  Iteration 2: 4 → 0 errors
+
+Status: ✅ Build successful
+Remaining Warnings: 3
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-BF-001: Build Error Analysis
+- REQ-BF-002: Iterative Fix Strategy
+- REQ-BF-003: Fix Report

package/.github/skills/checkpoint/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: checkpoint
+description: セーフポイントの作成・復元・比較。Gitと統合して状態を追跡。
+license: MIT
+version: 1.1.0
+triggers:
+  - /checkpoint
+  - 危険な操作前
+  - マイルストーン達成時
+---
+
+# Checkpoint
+
+> **要約**: 開発作業のセーフポイントを提供。作成・復元・比較をサポート。
+
+## 📌 コマンド
+
+### /checkpoint create (REQ-CP-001)
+
+**WHEN** `/checkpoint create <name>` 実行  
+**DO** 以下を順次実行
+
+1. Quick検証（`/verify quick`）
+2. Git commit/stash作成
+3. ログ記録
+
+```bash
+# 未コミット変更がある場合
+git stash push -m "checkpoint: <name>"
+# または
+git add -A && git commit -m "checkpoint: <name>"
+```
+
+**出力**:
+```
+📍 Checkpoint: <name>
+━━━━━━━━━━━━━━━━━━━━
+✅ Verification: PASS
+✅ Git: abc1234
+✅ Logged
+━━━━━━━━━━━━━━━━━━━━
+Time: 2026-01-25 14:30
+```
+
+---
+
+### /checkpoint verify (REQ-CP-002)
+
+**WHEN** `/checkpoint verify <name>` 実行  
+**DO** チェックポイントとの差分を報告
+
+| 項目 | 計算 |
+|------|------|
+| 変更ファイル数 | `git diff --stat <sha>..HEAD` |
+| テスト合格率 | 現在 vs チェックポイント時 |
+| カバレッジ | 現在 vs チェックポイント時 |
+| ビルド状態 | 現在のビルド結果 |
+
+**出力**:
+```
+📊 Verify: <name> (abc1234)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+| Metric   | Checkpoint | Current | Change |
+|----------|------------|---------|--------|
+| Tests    | 42/42      | 45/45   | +3 ✅  |
+| Coverage | 85%        | 87%     | +2% ✅ |
+| Build    | PASS       | PASS    | -      |
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Status: ✅ Quality maintained
+```
+
+---
+
+### /checkpoint list (REQ-CP-003)
+
+**WHEN** `/checkpoint list` 実行  
+**DO** 全チェックポイントを表示
+
+```
+📋 Checkpoints
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+| Name                    | Time       | SHA     |
+|-------------------------|------------|---------|
+| feature-auth-complete   | 01-25 14:30| abc1234 |
+| before-migration        | 01-25 10:00| def5678 |
+| fix-123-done            | 01-24 16:45| ghi9012 |
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### /checkpoint restore (REQ-CP-004)
+
+**WHEN** `/checkpoint restore <name>` 実行  
+**DO** 安全に復元
+
+**復元前チェック**:
+- 未コミット変更 → stash/commit確認
+- 復元後 → `/verify quick` 提案
+
+---
+
+## 📁 Storage (REQ-CP-005)
+
+| パス | 内容 |
+|------|------|
+| `~/.musubix/checkpoints/checkpoints.log` | メタデータ |
+| 保持数 | 最新10件（超過時は古いものを整理） |
+
+**ログ形式**: `YYYY-MM-DD-HH:MM | <name> | <sha>`
+
+---
+
+## 🏷️ 命名規則
+
+| パターン | 例 |
+|---------|-----|
+| `feature-<name>-<state>` | `feature-auth-complete` |
+| `fix-<issue>-<state>` | `fix-123-done` |
+| `before-<action>` | `before-migration` |
+| `after-<action>` | `after-refactor` |
+
+---
+
+## トレーサビリティ
+
+- REQ-CP-001: Checkpoint Creation
+- REQ-CP-002: Checkpoint Verification
+- REQ-CP-003: Checkpoint Listing
+- REQ-CP-004: Checkpoint Restore
+- REQ-CP-005: Checkpoint Retention & Location

package/.github/skills/codemap/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: codemap
+description: リポジトリ構造を分析し、アーキテクチャドキュメントを自動生成。
+license: MIT
+version: 1.1.0
+triggers:
+  - /codemap
+  - /map
+  - アーキテクチャ可視化
+---
+
+# Codemap
+
+> **要約**: コードベースのアーキテクチャを分析し、構造化ドキュメントを自動生成。
+
+## 📌 コマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `/codemap generate` | 全体マップ生成 |
+| `/codemap analyze <path>` | 特定パス分析 |
+| `/codemap diff` | 既存との差分表示 |
+
+---
+
+## 🔍 分析内容
+
+### REQ-CM-001: リポジトリ構造
+
+1. **ワークスペース検出**
+   ```bash
+   cat package.json | jq '.workspaces'
+   ```
+
+2. **エントリーポイント識別**
+   - `src/index.ts`, `src/main.ts`
+   - `bin/` 配下
+   - `package.json` の `main`, `exports`
+
+3. **フレームワーク検出**
+   - Next.js: `next.config.js`, `app/`
+   - Express: `app.ts`, `routes/`
+
+### REQ-CM-002: モジュール分析
+
+| 分析項目 | 検索方法 |
+|---------|---------|
+| エクスポート | `grep "^export" src/index.ts` |
+| インポート | `grep "from '" src/*.ts` |
+| APIルート | `ls pages/api/` or `grep router.` |
+| DBモデル | `grep "^model" prisma/schema.prisma` |
+
+---
+
+## 📁 出力構造 (REQ-CM-003)
+
+```
+docs/CODEMAPS/
+├── INDEX.md        # 全体概要
+├── packages.md     # パッケージ一覧
+├── backend.md      # バックエンド構造
+├── frontend.md     # フロントエンド構造
+├── database.md     # DBスキーマ
+└── integrations.md # 外部サービス
+```
+
+### INDEX.md テンプレート
+
+```markdown
+# Codemap: [Project Name]
+
+**Generated:** [日時]
+**Version:** [バージョン]
+
+## Overview
+[プロジェクト概要]
+
+## Structure
+[ディレクトリ構造]
+
+## Packages
+| Package | Description |
+|---------|-------------|
+| core | コア機能 |
+| api | APIサーバー |
+
+## Entry Points
+- `bin/cli.js` - CLI
+- `src/index.ts` - Library
+```
+
+---
+
+## 📊 Diff Threshold (REQ-CM-004)
+
+**WHEN** 既存マップ更新時  
+**DO** 差分率を計算し、30%超過時はユーザー承認
+
+**出力**:
+```
+📊 Codemap Diff
+━━━━━━━━━━━━━━
+Diff: 35% ⚠️
+New: 5 modules
+Removed: 2 modules
+Changed: 8 modules
+━━━━━━━━━━━━━━
+Update? (y/n)
+```
+
+**レポート保存**: `.reports/codemap-diff.txt`
+
+---
+
+## トレーサビリティ
+
+- REQ-CM-001: Repository Structure Analysis
+- REQ-CM-002: Module Analysis
+- REQ-CM-003: Codemap Generation
+- REQ-CM-004: Codemap Diff Threshold

package/.github/skills/codemap/templates/codemap-index.md

@@ -0,0 +1,142 @@
+# Codemap Index Template
+
+MUSUBIX コードマップのインデックステンプレートです。
+
+---
+
+## 📍 Entry Points
+
+### CLI Commands
+| Command | Location | Description |
+|---------|----------|-------------|
+| `musubix init` | [packages/core/src/cli/commands/init.ts](packages/core/src/cli/commands/init.ts) | プロジェクト初期化 |
+| `musubix requirements` | [packages/core/src/cli/commands/requirements.ts](packages/core/src/cli/commands/requirements.ts) | 要件分析 |
+| `musubix design` | [packages/core/src/cli/commands/design.ts](packages/core/src/cli/commands/design.ts) | 設計生成 |
+| `musubix codegen` | [packages/core/src/cli/commands/codegen.ts](packages/core/src/cli/commands/codegen.ts) | コード生成 |
+
+### MCP Tools
+| Tool | Location | Description |
+|------|----------|-------------|
+| `sdd_create_requirements` | [packages/mcp-server/src/tools/](packages/mcp-server/src/tools/) | 要件作成 |
+| `pattern_extract` | [packages/pattern-mcp/src/](packages/pattern-mcp/src/) | パターン抽出 |
+| `knowledge_put_entity` | [packages/knowledge/src/](packages/knowledge/src/) | 知識グラフ操作 |
+
+---
+
+## 🔌 Integration Points
+
+### External Systems
+```
+┌──────────────────────────────────────────────────────────┐
+│                    MUSUBIX System                        │
+├──────────────────────────────────────────────────────────┤
+│  MCP Server ←→ Claude/Copilot                           │
+│  Knowledge Store ←→ .knowledge/graph.json               │
+│  Policy Engine ←→ steering/rules/                       │
+│  Codegraph ←→ TypeScript AST                            │
+└──────────────────────────────────────────────────────────┘
+```
+
+### Package Dependencies
+```
+core
+├── mcp-server (depends on)
+├── security (depends on)
+└── formal-verify (depends on)
+
+knowledge
+├── policy (depends on)
+└── decisions (depends on)
+
+agent-orchestrator
+├── workflow-engine (depends on)
+├── skill-manager (depends on)
+└── expert-delegation (depends on)
+```
+
+---
+
+## 📊 Key Data Flows
+
+### Requirements → Code Flow
+```
+1. Natural Language (User Input)
+   ↓
+2. EARS Requirements (REQ-*)
+   ↓ [packages/core/src/validators/ears-validator.ts]
+3. C4 Design (DES-*)
+   ↓ [packages/core/src/design/]
+4. Implementation Tasks (TSK-*)
+   ↓ [packages/core/src/codegen/]
+5. Generated Code
+```
+
+### Pattern Learning Flow
+```
+1. Code Observation
+   ↓
+2. Pattern Extraction [packages/pattern-mcp/]
+   ↓
+3. Pattern Storage [packages/library-learner/]
+   ↓
+4. Pattern Query & Reuse
+```
+
+---
+
+## 🧩 Core Abstractions
+
+### Entities
+- `Requirement`: EARS形式の要件
+- `Design`: C4モデルの設計
+- `Pattern`: 学習済みコードパターン
+- `Entity`: Knowledge Graph のエンティティ
+
+### Services
+- `EarsValidator`: EARS構文検証
+- `PatternLibrary`: パターン管理
+- `KnowledgeStore`: 知識グラフ操作
+- `PolicyEngine`: 憲法条項検証
+
+### Bridges (Integration)
+- `PatternBridge`: Core ↔ Pattern-MCP
+- `KnowledgeBridge`: Core ↔ Knowledge
+- `QualityGateBridge`: Core ↔ Policy
+- `CodemapBridge`: Core ↔ Codegraph
+- `RefactorCleanerBridge`: Core ↔ Security
+
+---
+
+## 🔍 Quick Navigation
+
+### "Where is X defined?"
+
+| Concept | Location |
+|---------|----------|
+| EARS Patterns | [packages/core/src/validators/ears-patterns.ts](packages/core/src/validators/ears-patterns.ts) |
+| 10 Constitution Articles | [steering/rules/constitution.md](steering/rules/constitution.md) |
+| MCP Tool Definitions | [packages/mcp-server/src/tools/](packages/mcp-server/src/tools/) |
+| Type Definitions | [packages/core/src/types/](packages/core/src/types/) |
+
+### "How does Y work?"
+
+| Feature | Key Files |
+|---------|-----------|
+| Pattern Learning | `packages/pattern-mcp/src/pattern-library.ts`, `packages/wake-sleep/src/` |
+| Traceability | `packages/core/src/traceability/` |
+| Formal Verification | `packages/formal-verify/src/`, `packages/lean/src/` |
+| Neural Search | `packages/neural-search/src/` |
+
+---
+
+## 📝 Update Instructions
+
+このファイルを更新する際の手順：
+
+1. 新しいパッケージ追加時 → Integration Points セクション更新
+2. 新しい CLI コマンド追加時 → Entry Points セクション更新
+3. 新しい Bridge 追加時 → Core Abstractions セクション更新
+4. 新しい型定義追加時 → Quick Navigation セクション更新
+
+**更新者**: 各パッケージのメンテナ
+**頻度**: リリースごと

package/.github/skills/codemap/templates/package-codemap.md

@@ -0,0 +1,160 @@
+# Package Codemap Template
+
+個別パッケージのコードマップテンプレートです。
+
+---
+
+## Package: `@nahisaho/musubix-{package-name}`
+
+### Overview
+
+| Property | Value |
+|----------|-------|
+| **Purpose** | {パッケージの目的} |
+| **Version** | {バージョン} |
+| **Dependencies** | {主要依存パッケージ} |
+| **Test Count** | {テスト数} |
+
+---
+
+### Directory Structure
+
+```
+packages/{package-name}/
+├── package.json
+├── tsconfig.json
+├── vitest.config.ts
+└── src/
+    ├── index.ts          # Public exports
+    ├── types.ts          # Type definitions
+    ├── {module}/         # Feature modules
+    │   ├── index.ts
+    │   ├── {service}.ts
+    │   └── __tests__/
+    │       └── {service}.test.ts
+    └── integration/      # Integration bridges
+        ├── index.ts
+        └── __tests__/
+```
+
+---
+
+### Public API
+
+#### Exports from `index.ts`
+
+```typescript
+// Main exports
+export { MainService } from './main-service';
+export { HelperFunction } from './helpers';
+
+// Types
+export type { MainConfig, MainResult } from './types';
+
+// Constants
+export { DEFAULT_CONFIG } from './constants';
+```
+
+#### Key Functions
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `createService` | `(config: Config) => Service` | サービスインスタンス生成 |
+| `processData` | `(data: Input) => Result<Output, Error>` | データ処理 |
+| `validateInput` | `(input: unknown) => boolean` | 入力検証 |
+
+---
+
+### Internal Modules
+
+#### `{module-name}/`
+
+**Purpose**: {モジュールの目的}
+
+**Key Files**:
+- `service.ts`: {説明}
+- `types.ts`: {説明}
+- `utils.ts`: {説明}
+
+**Dependencies**:
+- `../types`: 型定義
+- `external-package`: {用途}
+
+---
+
+### Data Flow
+
+```
+Input
+  ↓ [validate]
+Validated Input
+  ↓ [process]
+Intermediate State
+  ↓ [transform]
+Output
+```
+
+---
+
+### Integration Points
+
+#### Consumed By
+- `@nahisaho/musubix-{consumer-package}`: {用途}
+
+#### Consumes
+- `@nahisaho/musubix-{dependency-package}`: {用途}
+
+---
+
+### Configuration
+
+```typescript
+interface Config {
+  // Required
+  required: string;
+  
+  // Optional with defaults
+  optional?: number; // default: 10
+  
+  // Feature flags
+  enableFeature?: boolean; // default: false
+}
+```
+
+---
+
+### Error Handling
+
+| Error Class | When Thrown | Recovery |
+|-------------|-------------|----------|
+| `ValidationError` | Invalid input | Fix input |
+| `ProcessingError` | Processing failure | Retry |
+| `ConfigError` | Invalid config | Fix config |
+
+---
+
+### Testing Strategy
+
+| Type | Coverage Target | Location |
+|------|-----------------|----------|
+| Unit | 80%+ | `src/**/__tests__/*.test.ts` |
+| Integration | Key flows | `src/integration/__tests__/` |
+
+---
+
+### Change History
+
+| Version | Changes |
+|---------|---------|
+| v3.7.0 | Initial release |
+| v3.7.1 | Bug fixes |
+| v3.7.2 | Performance improvements |
+
+---
+
+## Update Instructions
+
+1. 新しい export 追加時 → Public API セクション更新
+2. 新しいモジュール追加時 → Internal Modules セクション更新
+3. 設定項目追加時 → Configuration セクション更新
+4. 新しいエラー追加時 → Error Handling セクション更新