musubix 3.6.1 → 3.7.3

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監査

package/.github/skills/verification-loop/scripts/verify.sh

@@ -0,0 +1,305 @@
+#!/usr/bin/env bash
+# verify.sh - 6フェーズ検証スクリプト
+# Usage: ./verify.sh [quick|full]
+#
+# トレーサビリティ: REQ-VL-001, DES-VL-001
+
+set -e
+
+MODE="${1:-full}"
+REPORT_FILE=".reports/verification-$(date +%Y%m%d-%H%M%S).md"
+
+# カラー定義
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# 結果を格納する配列
+declare -A RESULTS
+declare -A DETAILS
+
+# ヘルパー関数
+log_phase() {
+    echo -e "\n${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}Phase: $1${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+}
+
+log_pass() {
+    echo -e "${GREEN}✅ PASS${NC}: $1"
+}
+
+log_fail() {
+    echo -e "${RED}❌ FAIL${NC}: $1"
+}
+
+log_warn() {
+    echo -e "${YELLOW}⚠️  WARN${NC}: $1"
+}
+
+log_skip() {
+    echo -e "${YELLOW}⏭️  SKIP${NC}: $1"
+}
+
+# Phase 1: Build
+phase_build() {
+    log_phase "1. Build"
+    
+    if [ "$MODE" = "quick" ]; then
+        log_skip "Quick mode - skipping build"
+        RESULTS[build]="SKIP"
+        return 0
+    fi
+    
+    if npm run build 2>&1; then
+        log_pass "Build succeeded"
+        RESULTS[build]="PASS"
+        return 0
+    else
+        log_fail "Build failed"
+        RESULTS[build]="FAIL"
+        return 1
+    fi
+}
+
+# Phase 2: Type Check
+phase_types() {
+    log_phase "2. Type Check"
+    
+    local output
+    output=$(npx tsc --noEmit 2>&1) || true
+    local error_count
+    error_count=$(echo "$output" | grep -c "error TS" || echo "0")
+    
+    if [ "$error_count" -eq 0 ]; then
+        log_pass "No type errors"
+        RESULTS[types]="PASS"
+        DETAILS[types]="0 errors"
+        return 0
+    else
+        log_fail "$error_count type error(s)"
+        RESULTS[types]="FAIL"
+        DETAILS[types]="$error_count errors"
+        echo "$output" | head -20
+        return 1
+    fi
+}
+
+# Phase 3: Lint
+phase_lint() {
+    log_phase "3. Lint"
+    
+    if [ "$MODE" = "quick" ]; then
+        log_skip "Quick mode - skipping lint"
+        RESULTS[lint]="SKIP"
+        return 0
+    fi
+    
+    local output
+    output=$(npm run lint 2>&1) || true
+    local error_count
+    error_count=$(echo "$output" | grep -c "error" || echo "0")
+    local warn_count
+    warn_count=$(echo "$output" | grep -c "warning" || echo "0")
+    
+    if [ "$error_count" -eq 0 ]; then
+        if [ "$warn_count" -gt 0 ]; then
+            log_warn "$warn_count warning(s)"
+            RESULTS[lint]="PASS"
+            DETAILS[lint]="$warn_count warnings"
+        else
+            log_pass "No lint errors or warnings"
+            RESULTS[lint]="PASS"
+            DETAILS[lint]="clean"
+        fi
+        return 0
+    else
+        log_fail "$error_count error(s), $warn_count warning(s)"
+        RESULTS[lint]="FAIL"
+        DETAILS[lint]="$error_count errors, $warn_count warnings"
+        echo "$output" | head -20
+        return 1
+    fi
+}
+
+# Phase 4: Tests
+phase_tests() {
+    log_phase "4. Tests"
+    
+    local test_cmd="npm run test"
+    
+    if [ "$MODE" = "quick" ]; then
+        # Quick mode: 変更に関連するテストのみ
+        test_cmd="npm run test:unit -- --changed"
+    fi
+    
+    local output
+    if output=$($test_cmd 2>&1); then
+        local passed
+        passed=$(echo "$output" | grep -oP '\d+ passed' | head -1 || echo "? passed")
+        log_pass "Tests $passed"
+        RESULTS[tests]="PASS"
+        DETAILS[tests]="$passed"
+        return 0
+    else
+        log_fail "Some tests failed"
+        RESULTS[tests]="FAIL"
+        DETAILS[tests]="failed"
+        echo "$output" | tail -30
+        return 1
+    fi
+}
+
+# Phase 5: Security
+phase_security() {
+    log_phase "5. Security"
+    
+    if [ "$MODE" = "quick" ]; then
+        log_skip "Quick mode - skipping security scan"
+        RESULTS[security]="SKIP"
+        return 0
+    fi
+    
+    local output
+    output=$(npm audit --json 2>&1) || true
+    
+    local critical
+    critical=$(echo "$output" | jq '.metadata.vulnerabilities.critical // 0' 2>/dev/null || echo "0")
+    local high
+    high=$(echo "$output" | jq '.metadata.vulnerabilities.high // 0' 2>/dev/null || echo "0")
+    
+    if [ "$critical" -eq 0 ] && [ "$high" -eq 0 ]; then
+        log_pass "No critical or high vulnerabilities"
+        RESULTS[security]="PASS"
+        DETAILS[security]="0 critical, 0 high"
+        return 0
+    else
+        log_fail "$critical critical, $high high vulnerabilities"
+        RESULTS[security]="FAIL"
+        DETAILS[security]="$critical critical, $high high"
+        return 1
+    fi
+}
+
+# Phase 6: Diff
+phase_diff() {
+    log_phase "6. Diff Review"
+    
+    local stats
+    stats=$(git diff --stat HEAD~1..HEAD 2>/dev/null || git diff --stat)
+    
+    local files_changed
+    files_changed=$(echo "$stats" | tail -1 | grep -oP '\d+ file' | grep -oP '\d+' || echo "0")
+    local insertions
+    insertions=$(echo "$stats" | tail -1 | grep -oP '\d+ insertion' | grep -oP '\d+' || echo "0")
+    local deletions
+    deletions=$(echo "$stats" | tail -1 | grep -oP '\d+ deletion' | grep -oP '\d+' || echo "0")
+    
+    echo "$stats"
+    
+    RESULTS[diff]="INFO"
+    DETAILS[diff]="$files_changed files, +$insertions -$deletions"
+    
+    return 0
+}
+
+# レポート生成
+generate_report() {
+    mkdir -p .reports
+    
+    local overall="READY"
+    for phase in build types lint tests security; do
+        if [ "${RESULTS[$phase]}" = "FAIL" ]; then
+            overall="NOT READY"
+            break
+        fi
+    done
+    
+    cat << EOF > "$REPORT_FILE"
+# Verification Report
+
+**Date**: $(date +%Y-%m-%d\ %H:%M:%S)
+**Mode**: $MODE
+
+## Results
+
+| Phase | Status | Details |
+|-------|--------|---------|
+| Build | ${RESULTS[build]:-N/A} | ${DETAILS[build]:-} |
+| Types | ${RESULTS[types]:-N/A} | ${DETAILS[types]:-} |
+| Lint | ${RESULTS[lint]:-N/A} | ${DETAILS[lint]:-} |
+| Tests | ${RESULTS[tests]:-N/A} | ${DETAILS[tests]:-} |
+| Security | ${RESULTS[security]:-N/A} | ${DETAILS[security]:-} |
+| Diff | ${RESULTS[diff]:-N/A} | ${DETAILS[diff]:-} |
+
+## Overall
+
+**Status**: $overall
+
+EOF
+
+    echo ""
+    echo "╔════════════════════════════════════════════════════════════╗"
+    echo "║                   VERIFICATION REPORT                       ║"
+    echo "╠════════════════════════════════════════════════════════════╣"
+    echo "║                                                             ║"
+    printf "║  Build:     [%-4s] %-40s ║\n" "${RESULTS[build]}" ""
+    printf "║  Types:     [%-4s] %-40s ║\n" "${RESULTS[types]}" "(${DETAILS[types]:-})"
+    printf "║  Lint:      [%-4s] %-40s ║\n" "${RESULTS[lint]}" "(${DETAILS[lint]:-})"
+    printf "║  Tests:     [%-4s] %-40s ║\n" "${RESULTS[tests]}" "(${DETAILS[tests]:-})"
+    printf "║  Security:  [%-4s] %-40s ║\n" "${RESULTS[security]}" "(${DETAILS[security]:-})"
+    printf "║  Diff:      [%-4s] %-40s ║\n" "${RESULTS[diff]}" "(${DETAILS[diff]:-})"
+    echo "║                                                             ║"
+    echo "╠════════════════════════════════════════════════════════════╣"
+    printf "║  Overall:   [%-9s]  for PR                             ║\n" "$overall"
+    echo "╚════════════════════════════════════════════════════════════╝"
+    echo ""
+    echo "Report saved to: $REPORT_FILE"
+}
+
+# メイン処理
+main() {
+    echo "Starting verification ($MODE mode)..."
+    echo ""
+    
+    local failed=0
+    
+    # Phase 1: Build
+    phase_build || failed=1
+    
+    # ビルド失敗時は後続フェーズをスキップ
+    if [ "${RESULTS[build]}" = "FAIL" ]; then
+        RESULTS[types]="SKIP"
+        RESULTS[lint]="SKIP"
+        RESULTS[tests]="SKIP"
+        RESULTS[security]="SKIP"
+        RESULTS[diff]="SKIP"
+    else
+        # Phase 2: Type Check
+        phase_types || failed=1
+        
+        # 型エラー時は後続をスキップ
+        if [ "${RESULTS[types]}" = "FAIL" ]; then
+            RESULTS[lint]="SKIP"
+            RESULTS[tests]="SKIP"
+            RESULTS[security]="SKIP"
+        else
+            # Phase 3-5
+            phase_lint || failed=1
+            phase_tests || failed=1
+            phase_security || failed=1
+        fi
+        
+        # Phase 6: Diff (常に実行)
+        phase_diff
+    fi
+    
+    # レポート生成
+    generate_report
+    
+    exit $failed
+}
+
+main "$@"