musubix 3.6.0 → 3.7.3

package/.github/skills/refactor-cleaner/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: refactor-cleaner
+description: デッドコード検出・安全な削除。knip/depcheck/ts-pruneと連携。
+license: MIT
+version: 1.1.0
+triggers:
+  - /refactor
+  - /cleanup
+  - /deadcode
+---
+
+# Refactor Cleaner
+
+> **要約**: デッドコードを検出し、安全に削除。すべての削除操作をログに記録。
+
+## 📌 コマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `/refactor analyze` | デッドコード検出 |
+| `/refactor clean [--safe-only]` | 安全な削除 |
+| `/refactor report` | レポート表示 |
+
+---
+
+## 🔍 検出ツール (REQ-RC-001)
+
+| ツール | 検出内容 | コマンド |
+|--------|---------|---------|
+| **knip** | 未使用ファイル/エクスポート/依存 | `npx knip` |
+| **depcheck** | 未使用npm依存 | `npx depcheck` |
+| **ts-prune** | 未使用TSエクスポート | `npx ts-prune` |
+
+---
+
+## ⚠️ 安全な削除 (REQ-RC-002)
+
+**BEFORE** 削除実行  
+**DO** 以下を検証
+
+| チェック | コマンド |
+|---------|---------|
+| 動的インポート | `grep -rn "import(" src/` |
+| テスト参照 | `grep -rn "<name>" tests/` |
+| ドキュメント参照 | `grep -rn "<name>" docs/` |
+
+**検出された場合**: 削除対象から除外
+
+---
+
+## 📊 リスク分類 (REQ-RC-004)
+
+| レベル | 説明 | アクション |
+|--------|------|----------|
+| 🟢 **SAFE** | 静的解析で参照なし | 自動削除可 |
+| 🟡 **CAUTION** | 動的参照の可能性 | 確認必要 |
+| 🔴 **DANGER** | 公開API/エントリーポイント | 自動削除禁止 |
+
+**出力例**:
+```
+🔍 Dead Code Analysis
+━━━━━━━━━━━━━━━━━━━━━━━━
+🟢 SAFE (5):
+  • src/utils/deprecated.ts
+  • src/helpers/old.ts
+
+🟡 CAUTION (2):
+  • src/lib/maybe-used.ts
+
+🔴 DANGER (1):
+  • src/index.ts (entry point)
+━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## 📝 Deletion Log (REQ-RC-003)
+
+**WHEN** コード削除  
+**DO** `docs/DELETION_LOG.md`に記録
+
+```markdown
+## [日付]
+
+### Deleted
+- `src/utils/deprecated.ts`
+- `src/helpers/old.ts`
+
+### Reason
+knip検出: 未使用エクスポート
+
+### Restore
+`git checkout abc1234 -- <file>`
+```
+
+**レポート保存**: `.reports/dead-code-analysis.md`
+
+---
+
+## トレーサビリティ
+
+- REQ-RC-001: Dead Code Detection
+- REQ-RC-002: Safe Deletion
+- REQ-RC-003: Deletion Log
+- REQ-RC-004: Risk Classification

package/.github/skills/session-manager/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: session-manager
+description: セッション開始時にコンテキスト復元、終了時に状態保存。TodoWrite統合でタスク追跡。
+license: MIT
+version: 1.1.0
+triggers:
+  - セッション開始
+  - セッション終了
+  - /session
+  - マルチステップタスク
+---
+
+# Session Manager
+
+> **要約**: セッション間の継続性を提供。開始時に過去コンテキストを復元、終了時に状態を永続化。
+
+## 🔄 トリガーと即時アクション
+
+### セッション開始時
+
+**WHEN** 新しいセッションが開始される  
+**DO** 以下を順に実行:
+
+1. `~/.musubix/sessions/` から過去7日間のファイルを検索
+2. 直近セッションの「Notes for Next Session」を読む
+3. ユーザーに引き継ぎ内容を通知
+
+```bash
+find ~/.musubix/sessions/ -name "*.md" -mtime -7 2>/dev/null | head -5
+```
+
+**出力フォーマット**:
+```
+📋 前回セッションからの引き継ぎ
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📅 日時: [YYYY-MM-DD HH:MM]
+📝 未完了: [タスクリスト]
+💡 メモ: [重要コンテキスト]
+📂 推奨ファイル: [パスリスト]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+続きから再開しますか？
+```
+
+---
+
+### セッション終了時
+
+**WHEN** セッション終了/長時間中断  
+**DO** 状態を `~/.musubix/sessions/YYYY-MM-DD-HH-MM.md` に保存
+
+**保存フォーマット**:
+```markdown
+# Session: [日付]
+**Project:** [名前] | **Started:** [HH:MM] | **Updated:** [HH:MM]
+
+## Completed
+- [x] 完了タスク
+
+## In Progress
+- [ ] 進行中タスク
+
+## Notes for Next Session
+- 重要コンテキスト
+
+## Context to Load
+- `path/to/file`
+```
+
+---
+
+### コンテキスト圧縮前
+
+**WHEN** コンテキスト圧縮がトリガーされる  
+**DO** 圧縮前に重要な状態をセッションファイルに追記
+
+**保存項目**: 現在のタスク状態、重要な変数/設定、次のアクション
+
+---
+
+## ✅ TodoWrite統合
+
+**WHEN** マルチステップタスク（3ステップ以上）を開始  
+**DO** TodoWriteツールで進捗を追跡
+
+### ベストプラクティス
+
+| やること | 理由 |
+|---------|------|
+| タスク開始時にリスト作成 | 実行順序を明示 |
+| 完了ごとにチェック | 進捗を可視化 |
+| 欠落ステップを検出 | 抜け漏れ防止 |
+| 終了時に未完了を記録 | 次回引き継ぎ |
+
+**例**:
+```
+□ 1. 要件定義の確認
+□ 2. 設計ドキュメント作成
+☑ 3. 実装（完了）
+□ 4. テスト作成
+□ 5. レビュー依頼
+```
+
+---
+
+## 📁 ストレージ
+
+| パス | 内容 |
+|------|------|
+| `~/.musubix/sessions/` | セッションファイル（30日保持） |
+| `~/.musubix/sessions/YYYY-MM-DD-HH-MM.md` | 個別セッション |
+
+---
+
+## トレーサビリティ
+
+- REQ-SM-001: SessionStart Hook
+- REQ-SM-002: SessionEnd Hook  
+- REQ-SM-003: Pre-Compact State Saving
+- REQ-SM-004: TodoWrite統合

package/.github/skills/session-manager/scripts/session-end.sh

@@ -0,0 +1,175 @@
+#!/bin/bash
+# MUSUBIX Session End Hook
+# REQ-SM-002: SessionEnd Hook
+#
+# Usage: ./session-end.sh [--project PROJECT_NAME]
+
+set -e
+
+# Configuration
+SESSIONS_DIR="${HOME}/.musubix/sessions"
+MAX_FILE_SIZE=1048576  # 1MB
+RETENTION_DAYS=30
+MAX_FILES=100
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# Parse arguments
+PROJECT_NAME=""
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        --project) PROJECT_NAME="$2"; shift ;;
+        *) echo "Unknown parameter: $1"; exit 1 ;;
+    esac
+    shift
+done
+
+# Create sessions directory if it doesn't exist
+mkdir -p "$SESSIONS_DIR"
+
+# Generate filename
+TIMESTAMP=$(date +"%Y-%m-%d-%H-%M")
+SESSION_FILE="${SESSIONS_DIR}/${TIMESTAMP}.md"
+
+echo -e "${BLUE}📋 MUSUBIX Session Manager - Session End${NC}"
+echo "================================================"
+echo ""
+
+# Detect project name if not provided
+if [ -z "$PROJECT_NAME" ]; then
+    if [ -f "package.json" ]; then
+        PROJECT_NAME=$(grep -o '"name": *"[^"]*"' package.json | head -1 | cut -d'"' -f4)
+    elif [ -d ".git" ]; then
+        PROJECT_NAME=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null)
+    fi
+    PROJECT_NAME="${PROJECT_NAME:-Unknown Project}"
+fi
+
+# Get start time (approximate based on shell history or use current)
+START_TIME=$(date -d "2 hours ago" +"%H:%M" 2>/dev/null || date +"%H:%M")
+CURRENT_TIME=$(date +"%H:%M")
+CURRENT_DATE=$(date +"%Y-%m-%d")
+
+# Interactive prompts for session data
+echo -e "${YELLOW}セッション情報を入力してください:${NC}"
+echo ""
+
+# Completed tasks
+echo "✅ 完了したタスク (空行で終了):"
+COMPLETED_TASKS=""
+while IFS= read -r line; do
+    [ -z "$line" ] && break
+    COMPLETED_TASKS="${COMPLETED_TASKS}\n- [x] ${line}"
+done
+
+# In progress tasks
+echo ""
+echo "⏳ 進行中のタスク (空行で終了):"
+IN_PROGRESS_TASKS=""
+while IFS= read -r line; do
+    [ -z "$line" ] && break
+    IN_PROGRESS_TASKS="${IN_PROGRESS_TASKS}\n- [ ] ${line}"
+done
+
+# Notes for next session
+echo ""
+echo "📝 次回向けメモ (空行で終了):"
+NOTES=""
+while IFS= read -r line; do
+    [ -z "$line" ] && break
+    NOTES="${NOTES}\n- ${line}"
+done
+
+# Context files to load
+echo ""
+echo "📂 次回読み込むべきファイル (空行で終了):"
+CONTEXT_FILES=""
+while IFS= read -r line; do
+    [ -z "$line" ] && break
+    CONTEXT_FILES="${CONTEXT_FILES}\n${line}"
+done
+
+# Count completed tasks
+COMPLETED_COUNT=$(echo -e "$COMPLETED_TASKS" | grep -c "\[x\]" 2>/dev/null || echo 0)
+IN_PROGRESS_COUNT=$(echo -e "$IN_PROGRESS_TASKS" | grep -c "\[ \]" 2>/dev/null || echo 0)
+NOTES_COUNT=$(echo -e "$NOTES" | grep -c "^-" 2>/dev/null || echo 0)
+
+# Generate session file
+cat > "$SESSION_FILE" << EOF
+# Session: ${CURRENT_DATE}
+
+**Date:** ${CURRENT_DATE}
+**Started:** ${START_TIME}
+**Last Updated:** ${CURRENT_TIME}
+**Project:** ${PROJECT_NAME}
+
+---
+
+## Current State
+
+### Completed
+$(echo -e "$COMPLETED_TASKS" | sed '/^$/d')
+
+### In Progress
+$(echo -e "$IN_PROGRESS_TASKS" | sed '/^$/d')
+
+### Blocked
+- [ ] (なし)
+
+---
+
+## Notes for Next Session
+$(echo -e "$NOTES" | sed '/^$/d')
+
+---
+
+## Context to Load
+
+\`\`\`
+$(echo -e "$CONTEXT_FILES" | sed '/^$/d')
+\`\`\`
+
+---
+
+## Session Summary
+
+- **タスク完了数**: ${COMPLETED_COUNT}
+- **未完了タスク**: ${IN_PROGRESS_COUNT}
+- **次回向けメモ**: ${NOTES_COUNT}項目
+- **セッション時間**: ${START_TIME} - ${CURRENT_TIME}
+
+EOF
+
+# Check file size
+FILE_SIZE=$(stat -f%z "$SESSION_FILE" 2>/dev/null || stat -c%s "$SESSION_FILE" 2>/dev/null)
+if [ "$FILE_SIZE" -gt "$MAX_FILE_SIZE" ]; then
+    echo -e "${RED}⚠️  警告: セッションファイルが1MBを超えています${NC}"
+fi
+
+# Cleanup old sessions
+echo ""
+echo -e "${YELLOW}🧹 古いセッションのクリーンアップ...${NC}"
+find "$SESSIONS_DIR" -name "*.md" -mtime +"$RETENTION_DAYS" -delete 2>/dev/null || true
+
+# Check file count
+FILE_COUNT=$(find "$SESSIONS_DIR" -name "*.md" -type f | wc -l)
+if [ "$FILE_COUNT" -gt "$MAX_FILES" ]; then
+    echo -e "${YELLOW}ℹ️  ファイル数が${MAX_FILES}を超えています。古いファイルを削除します。${NC}"
+    find "$SESSIONS_DIR" -name "*.md" -type f -printf '%T+ %p\n' | sort | head -n "$((FILE_COUNT - MAX_FILES))" | cut -d' ' -f2- | xargs rm -f 2>/dev/null || true
+fi
+
+echo ""
+echo "================================================"
+echo -e "${GREEN}✅ セッションを保存しました: ${SESSION_FILE}${NC}"
+echo ""
+echo -e "${BLUE}サマリー:${NC}"
+echo "  - 完了タスク: ${COMPLETED_COUNT}件"
+echo "  - 未完了タスク: ${IN_PROGRESS_COUNT}件"
+echo "  - 次回向けメモ: ${NOTES_COUNT}項目"
+echo ""
+echo -e "${GREEN}セッションを正常に終了しました。お疲れ様でした！${NC}"

package/.github/skills/session-manager/scripts/session-start.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# MUSUBIX Session Start Hook
+# REQ-SM-001: SessionStart Hook
+#
+# Usage: source session-start.sh
+#        Or run directly: ./session-start.sh
+
+set -e
+
+# Configuration
+SESSIONS_DIR="${HOME}/.musubix/sessions"
+RETENTION_DAYS=7
+MAX_SESSIONS_TO_SHOW=5
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Create sessions directory if it doesn't exist
+mkdir -p "$SESSIONS_DIR"
+
+echo -e "${BLUE}📋 MUSUBIX Session Manager - Session Start${NC}"
+echo "================================================"
+echo ""
+
+# Find recent sessions (within RETENTION_DAYS days)
+recent_sessions=$(find "$SESSIONS_DIR" -name "*.md" -mtime -"$RETENTION_DAYS" -type f 2>/dev/null | sort -r | head -"$MAX_SESSIONS_TO_SHOW")
+
+if [ -z "$recent_sessions" ]; then
+    echo -e "${YELLOW}ℹ️  過去${RETENTION_DAYS}日間のセッションは見つかりませんでした。${NC}"
+    echo ""
+    echo "新しいセッションを開始します。"
+    exit 0
+fi
+
+echo -e "${GREEN}✅ 過去${RETENTION_DAYS}日間のセッションが見つかりました:${NC}"
+echo ""
+
+# Process each session
+for session_file in $recent_sessions; do
+    filename=$(basename "$session_file")
+    date_part="${filename%.md}"
+    
+    # Extract info from session file
+    echo -e "${BLUE}📄 $filename${NC}"
+    
+    # Extract Notes for Next Session
+    notes=$(sed -n '/^## Notes for Next Session/,/^##/p' "$session_file" 2>/dev/null | grep -v "^##" | head -5)
+    if [ -n "$notes" ]; then
+        echo "   📝 次回向けメモ:"
+        echo "$notes" | sed 's/^/      /'
+    fi
+    
+    # Extract In Progress tasks
+    in_progress=$(sed -n '/^### In Progress/,/^###/p' "$session_file" 2>/dev/null | grep "^\- \[ \]" | head -5)
+    if [ -n "$in_progress" ]; then
+        echo "   ⏳ 未完了タスク:"
+        echo "$in_progress" | sed 's/^/      /'
+    fi
+    
+    echo ""
+done
+
+# Get the most recent session
+most_recent=$(echo "$recent_sessions" | head -1)
+
+if [ -n "$most_recent" ]; then
+    echo "================================================"
+    echo -e "${YELLOW}💡 最新セッション: $(basename "$most_recent")${NC}"
+    echo ""
+    echo "前回のセッションから続けますか？"
+    echo "  - 'yes' または 'y' で前回のコンテキストを読み込み"
+    echo "  - 'no' または 'n' で新規セッション開始"
+    echo ""
+    
+    # Extract Context to Load
+    context_files=$(sed -n '/^## Context to Load/,/^##/p' "$most_recent" 2>/dev/null | grep -v "^##" | grep -v "^\`\`\`" | grep -v "^$")
+    if [ -n "$context_files" ]; then
+        echo "📂 読み込み推奨ファイル:"
+        echo "$context_files" | sed 's/^/   /'
+    fi
+fi
+
+echo ""
+echo -e "${GREEN}セッション開始の準備が完了しました。${NC}"

package/.github/skills/verification-loop/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: verification-loop
+description: 6フェーズ検証ループ（Build→Type→Lint→Test→Security→Diff）でPRレディネスを判定。
+license: MIT
+version: 1.1.0
+triggers:
+  - /verify
+  - /verify quick
+  - PRレビュー前
+  - セッション終了
+---
+
+# Verification Loop
+
+> **要約**: 6フェーズの総合検証でPRレディネスを判定。quick/fullモードとStop Hook監査をサポート。
+
+## 🔄 /verify コマンド
+
+### Full検証 (REQ-VL-001)
+
+**WHEN** `/verify` 実行  
+**DO** 6フェーズを順次実行
+
+| # | フェーズ | コマンド | 失敗時 |
+|---|---------|---------|--------|
+| 1 | **Build** | `npm run build` | 即停止・修正 |
+| 2 | **Type** | `npx tsc --noEmit` | 重大エラー修正 |
+| 3 | **Lint** | `npm run lint` | 報告（--fix可） |
+| 4 | **Test** | `npm test` | 報告 |
+| 5 | **Security** | `npm audit` | 報告 |
+| 6 | **Diff** | `git diff --stat` | レビュー |
+
+---
+
+### Quick検証 (REQ-VL-004)
+
+**WHEN** `/verify quick` 実行  
+**DO** 最小セットを実行
+
+- Type Check（可能なら）
+- Tests（差分関連 or `test:unit`）
+- Diff Review（サマリーのみ）
+
+---
+
+## 📋 Verification Report (REQ-VL-002)
+
+```
+╔════════════════════════════════════════════╗
+║         VERIFICATION REPORT                ║
+╠════════════════════════════════════════════╣
+║  Build:     [PASS] ✅                      ║
+║  Types:     [PASS] ✅ (0 errors)           ║
+║  Lint:      [PASS] ⚠️ (3 warnings)         ║
+║  Tests:     [PASS] ✅ (42/42, 85%)         ║
+║  Security:  [PASS] ✅ (0 critical)         ║
+║  Diff:      [INFO] 📝 (5 files, +120 -45)  ║
+╠════════════════════════════════════════════╣
+║  Overall:   [READY] ✅ for PR              ║
+╚════════════════════════════════════════════╝
+```
+
+**NOT READY時**:
+```
+Issues to Fix:
+1. src/user.ts:45 - Type error TS2322
+2. tests/api.test.ts - 2 failed tests
+```
+
+---
+
+## ⏱️ Continuous Verification (REQ-VL-003)
+
+**WHEN** 長時間セッション（15分以上）または大きな変更後  
+**DO** 自動検証を提案
+
+```
+💡 検証を実行しますか？
+最後の検証から15分経過しました。
+```
+
+---
+
+## 🔍 Stop Hook監査 (REQ-VL-005)
+
+**WHEN** セッション終了  
+**DO** 編集ファイルに対して監査
+
+| チェック | 対象 | アクション |
+|---------|------|----------|
+| `console.log` | `.ts`, `.tsx`, `.js` | 警告 |
+| `debugger` | `.ts`, `.tsx`, `.js` | 警告 |
+| TODO/FIXME | 全ファイル | リスト化 |
+| 未コミット | Git管理 | コミット提案 |
+
+**検出コマンド**:
+```bash
+grep -rn "console.log\|debugger" --include="*.ts" --include="*.tsx" src/
+grep -rn "TODO\|FIXME" --include="*.ts" src/
+git status --short
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-VL-001: Multi-Phase Verification
+- REQ-VL-002: Verification Report
+- REQ-VL-003: Continuous Verification
+- REQ-VL-004: Verification Modes
+- REQ-VL-005: Stop Hook監査