@unlaxer/dve-toolkit 4.1.0

package/scripts/audit-duplicates.sh

@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+# audit-duplicates.sh — Detect self-implemented features that DxE toolkit already provides
+#
+# Usage:
+#   bash dve/kit/scripts/audit-duplicates.sh [project-dir]
+#   dve scan [dir] --audit
+
+set -euo pipefail
+
+PROJECT_DIR="${1:-.}"
+PROJECT_DIR="$(cd "$PROJECT_DIR" 2>/dev/null && pwd)"
+PROJECT_NAME="$(basename "$PROJECT_DIR")"
+
+echo "🔍 Audit: ${PROJECT_NAME}"
+echo ""
+
+FINDINGS=0
+
+# ─── Known DxE capabilities vs self-implementations ───
+
+declare -A CAPABILITIES
+# pattern → DxE toolkit that provides it
+CAPABILITIES=(
+  ["*glossary*linker*|*GlossaryLinker*|*auto-link*"]="DDE dde-link (npx dde-link --fix)"
+  ["*state-machine*|*state_machine*|*workflow-engine*"]="DRE workflow engine (dre-engine init)"
+  ["*gap-extract*|*gap_extract*|*design-review*"]="DGE session (dge-session skill)"
+  ["*decision-vis*|*decision_vis*"]="DVE (dve build + dve serve)"
+)
+
+for patterns in "${!CAPABILITIES[@]}"; do
+  TOOLKIT="${CAPABILITIES[$patterns]}"
+  IFS='|' read -ra PATS <<< "$patterns"
+
+  for pat in "${PATS[@]}"; do
+    # Search for files matching the pattern (excluding node_modules, .git, dge/, dre/, dve/, dde/)
+    FOUND=$(find "$PROJECT_DIR" -path "*/node_modules" -prune -o -path "*/.git" -prune -o \
+      -path "*/dge" -prune -o -path "*/dre" -prune -o -path "*/dve" -prune -o -path "*/dde" -prune -o \
+      -name "$pat" -print 2>/dev/null | head -3)
+
+    if [ -n "$FOUND" ]; then
+      echo "  ⚠️  Self-implementation detected:"
+      echo "$FOUND" | while read -r f; do
+        echo "     ${f#$PROJECT_DIR/}"
+      done
+      echo "     → Already available: ${TOOLKIT}"
+      echo ""
+      FINDINGS=$((FINDINGS + 1))
+    fi
+  done
+done
+
+# ─── Check for outdated toolkit versions ───
+
+check_version() {
+  local TOOLKIT_NAME="$1"
+  local LOCAL_VERSION_FILE="$2"
+  local KIT_VERSION_FILE="$3"
+
+  if [ -f "$LOCAL_VERSION_FILE" ] && [ -f "$KIT_VERSION_FILE" ]; then
+    LOCAL_V=$(cat "$LOCAL_VERSION_FILE" 2>/dev/null | tr -d '[:space:]')
+    KIT_V=$(cat "$KIT_VERSION_FILE" 2>/dev/null | tr -d '[:space:]')
+    if [ "$LOCAL_V" != "$KIT_V" ] && [ -n "$LOCAL_V" ] && [ -n "$KIT_V" ]; then
+      echo "  📦 ${TOOLKIT_NAME}: ${LOCAL_V} → ${KIT_V} available"
+      echo "     Run: dxe update ${TOOLKIT_NAME,,}"
+      echo ""
+      FINDINGS=$((FINDINGS + 1))
+    fi
+  fi
+}
+
+# Check known toolkit locations
+DXE_HOME="${DXE_HOME:-$HOME/work/AskOS-workspace/DxE-suite}"
+check_version "DGE" "$PROJECT_DIR/dge/version.txt" "$DXE_HOME/dge/kit/version.txt"
+check_version "DRE" "$PROJECT_DIR/.claude/.dre-version" "$DXE_HOME/dre/kit/version.txt"
+
+# ─── Check for unused DxE features ───
+
+# DDE linker available but not used (no dde-link in recent git log)
+if [ -d "$PROJECT_DIR/docs/glossary" ]; then
+  DDE_INSTALLED=$(ls "$PROJECT_DIR/node_modules/@unlaxer/dde-toolkit" 2>/dev/null | head -1)
+  if [ -n "$DDE_INSTALLED" ]; then
+    RECENT_DDE_LINK=$(git -C "$PROJECT_DIR" log --oneline -20 2>/dev/null | grep -c "dde-link" || true)
+    if [ "$RECENT_DDE_LINK" -eq 0 ]; then
+      echo "  💡 DDE linker is installed but hasn't been used recently"
+      echo "     docs/glossary/ exists with $(ls "$PROJECT_DIR/docs/glossary/"*.md 2>/dev/null | wc -l) articles"
+      echo "     Run: npx dde-link --check README.md"
+      echo ""
+      FINDINGS=$((FINDINGS + 1))
+    fi
+  fi
+fi
+
+# ─── Summary ───
+
+if [ "$FINDINGS" -eq 0 ]; then
+  echo "  ✅ No duplicates or unused features found."
+else
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "  ${FINDINGS} finding(s)"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+fi

package/scripts/discover-decisions.sh

@@ -0,0 +1,129 @@
+#!/usr/bin/env bash
+# discover-decisions.sh — Scan Claude Code logs for implicit decisions
+# Detects: 1. Decision patterns in assistant text
+#          2. User approval patterns (よろしく/GO/OK/うん/やろう) after proposals
+#
+# Usage:
+#   bash dve/kit/scripts/discover-decisions.sh [project-dir]
+#   bash dve/kit/scripts/discover-decisions.sh [project-dir] --apply
+
+set -euo pipefail
+
+PROJECT_DIR="${1:-.}"
+PROJECT_DIR="$(cd "$PROJECT_DIR" 2>/dev/null && pwd)"
+PROJECT_NAME="$(basename "$PROJECT_DIR")"
+CLAUDE_LOGS_DIR="$HOME/.claude/projects"
+DRY_RUN=true
+
+for arg in "$@"; do [ "$arg" = "--apply" ] && DRY_RUN=false; done
+
+PATH_ENCODED=$(echo "$PROJECT_DIR" | sed 's|/|-|g')
+LOG_DIR=""
+for d in "$CLAUDE_LOGS_DIR"/*/; do
+  [ -d "$d" ] || continue
+  [ "$(basename "$d")" = "$PATH_ENCODED" ] && LOG_DIR="$d" && break
+done
+
+[ -z "$LOG_DIR" ] && echo "No logs for ${PROJECT_NAME}" && exit 0
+
+echo "🔍 Discovering decisions in: ${PROJECT_NAME}"
+echo "   Mode: $([ "$DRY_RUN" = true ] && echo "DRY RUN" || echo "APPLY")"
+echo ""
+
+TMPDIR=$(mktemp -d)
+trap "rm -rf $TMPDIR" EXIT
+
+touch "$TMPDIR/approvals.txt" "$TMPDIR/explicit.txt"
+
+for LOGFILE in "$LOG_DIR"/*.jsonl; do
+  [ -f "$LOGFILE" ] || continue
+
+  # Extract explicit decision patterns from assistant text
+  grep '"type":"assistant"' "$LOGFILE" 2>/dev/null | \
+    jq -r '.message.content[]? | select(.type=="text") | .text' 2>/dev/null | \
+    grep -iE "にしよう|に決定|で行く|を採用|を選択|で確定|却下|方針:|決定:|確定:|Direction:|Decision:|Decided:|settled on" 2>/dev/null | \
+    sed 's/^[[:space:]]*//' | \
+    awk 'length >= 15 && length <= 300 && !/^[{}\[\]<>]/ && !/^import / && !/→ Gap 発見/' \
+    >> "$TMPDIR/explicit.txt" 2>/dev/null || true
+
+  # Extract user approval → assistant proposal pairs
+  # User says: よろしく/GO/OK/うん/やろう etc. → previous assistant text is a decision
+  grep '"type":"user"' "$LOGFILE" 2>/dev/null | \
+    jq -r '.message.content[]? | select(.type=="text") | .text' 2>/dev/null | \
+    grep -iE "^よろしく|^よろ$|^GO$|^OK|^ok$|^うん|^いいね|^やろう|^いこう|^進めて|^頼む|^push|^deploy|^実装して|^やって|^やる$" \
+    >> "$TMPDIR/user_approvals.txt" 2>/dev/null || true
+
+done
+
+APPROVAL_COUNT=$(wc -l < "$TMPDIR/user_approvals.txt" 2>/dev/null || echo 0)
+
+# Deduplicate explicit decisions
+sort -u "$TMPDIR/explicit.txt" > "$TMPDIR/explicit_uniq.txt"
+EXPLICIT_COUNT=$(wc -l < "$TMPDIR/explicit_uniq.txt" 2>/dev/null || echo 0)
+
+TOTAL=$((EXPLICIT_COUNT + APPROVAL_COUNT))
+
+echo "  Explicit decision patterns: ${EXPLICIT_COUNT}"
+echo "  User approval patterns: ${APPROVAL_COUNT}"
+echo "  Total: ${TOTAL}"
+echo ""
+
+if [ "$TOTAL" -eq 0 ]; then
+  echo "  No decisions found."
+  exit 0
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Discovered Decisions"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+INDEX=0
+while IFS= read -r line; do
+  INDEX=$((INDEX + 1))
+  [ $INDEX -gt 30 ] && echo "  ... (${EXPLICIT_COUNT} total, showing first 30)" && break
+  echo "  📝 ${INDEX}. ${line}"
+done < "$TMPDIR/explicit_uniq.txt"
+
+if [ "$APPROVAL_COUNT" -gt 0 ]; then
+  echo ""
+  echo "  --- User Approvals (${APPROVAL_COUNT} times) ---"
+  sort "$TMPDIR/user_approvals.txt" | uniq -c | sort -rn | head -10 | while read -r count text; do
+    echo "  👍 ${text} (×${count})"
+  done
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+if [ "$DRY_RUN" = false ]; then
+  DD_DIR="${PROJECT_DIR}/dge/decisions"
+  mkdir -p "$DD_DIR"
+  LAST_DD=$(find "$DD_DIR" -name "DD-*.md" 2>/dev/null | grep -oP 'DD-\d+' | sort -t- -k2 -n | tail -1 | grep -oP '\d+' || echo 0)
+  NEXT_DD=$((LAST_DD + 1))
+  DD_NUM=$(printf "%03d" $NEXT_DD)
+  DD_FILE="${DD_DIR}/DD-${DD_NUM}-discovered.md"
+
+  {
+    echo "# DD-${DD_NUM}: Discovered Decisions"
+    echo ""
+    echo "- **Date**: $(date +%Y-%m-%d)"
+    echo "- **Status**: draft"
+    echo "- **Source**: discover-decisions.sh"
+    echo ""
+    echo "## Review each item: Keep / Merge / Reject"
+    echo ""
+    INDEX=0
+    while IFS= read -r line; do
+      INDEX=$((INDEX + 1))
+      [ $INDEX -gt 30 ] && break
+      echo "### ${INDEX}. ${line}"
+      echo "- Action: TODO"
+      echo ""
+    done < "$TMPDIR/explicit_uniq.txt"
+  } > "$DD_FILE"
+  echo "  Created: ${DD_FILE}"
+fi
+
+echo ""
+[ "$DRY_RUN" = true ] && echo "  Add --apply to create DD draft."

package/scripts/recover-all.sh

@@ -0,0 +1,150 @@
+#!/usr/bin/env bash
+# recover-all.sh — Recover ALL DxE artifacts from Claude Code logs
+# Extracts Write tool calls for: sessions, decisions, specs, annotations
+#
+# Usage:
+#   bash dve/kit/scripts/recover-all.sh [project-dir]        # dry run
+#   bash dve/kit/scripts/recover-all.sh [project-dir] --apply # write files
+#   bash dve/kit/scripts/recover-all.sh --scan-all            # all projects
+
+set -euo pipefail
+
+CLAUDE_LOGS_DIR="$HOME/.claude/projects"
+DRY_RUN=true
+SCAN_ALL=false
+
+for arg in "$@"; do
+  [ "$arg" = "--apply" ] && DRY_RUN=false
+  [ "$arg" = "--scan-all" ] && SCAN_ALL=true
+done
+
+PROJECT_DIR="${1:-.}"
+[ "$PROJECT_DIR" = "--scan-all" ] && PROJECT_DIR="."
+[ "$PROJECT_DIR" = "--apply" ] && PROJECT_DIR="."
+PROJECT_DIR="$(cd "$PROJECT_DIR" 2>/dev/null && pwd || echo "$PROJECT_DIR")"
+
+echo "🔧 DxE Artifact Recovery"
+echo "   Mode: $([ "$DRY_RUN" = true ] && echo "DRY RUN" || echo "APPLY")"
+echo ""
+
+recover_project() {
+  local PROJ_DIR="$1"
+  local PROJ_NAME="$(basename "$PROJ_DIR")"
+
+  local PATH_ENCODED=$(echo "$PROJ_DIR" | sed 's|/|-|g')
+  local LOG_DIR=""
+  for d in "$CLAUDE_LOGS_DIR"/*/; do
+    [ -d "$d" ] || continue
+    [ "$(basename "$d")" = "$PATH_ENCODED" ] && LOG_DIR="$d" && break
+  done
+  [ -z "$LOG_DIR" ] && return 0
+
+  local LOG_COUNT=$(find "$LOG_DIR" -maxdepth 1 -name "*.jsonl" 2>/dev/null | wc -l)
+  [ "$LOG_COUNT" -eq 0 ] && return 0
+
+  echo "┌─ ${PROJ_NAME} (${LOG_COUNT} logs)"
+
+  local TMPDIR=$(mktemp -d)
+
+  # Step 1: Extract all Write tool calls to temp files
+  for LOGFILE in "$LOG_DIR"/*.jsonl; do
+    [ -f "$LOGFILE" ] || continue
+    grep '"type":"assistant"' "$LOGFILE" 2>/dev/null | \
+      jq -c '.message.content[]? | select(.type=="tool_use" and .name=="Write") | {path: .input.file_path, content: .input.content}' 2>/dev/null \
+      >> "$TMPDIR/writes.jsonl" || true
+  done
+
+  [ ! -f "$TMPDIR/writes.jsonl" ] && echo "│  No Write calls found" && echo "└──────────────────────────────" && rm -rf "$TMPDIR" && return 0
+
+  local TOTAL=$(wc -l < "$TMPDIR/writes.jsonl")
+  local RECOVERED=0
+  local UPDATED=0
+  local SKIPPED=0
+
+  # Step 2: Process each write
+  while IFS= read -r line; do
+    local FILE_PATH=$(echo "$line" | jq -r '.path // empty' 2>/dev/null)
+    [ -z "$FILE_PATH" ] || [ "$FILE_PATH" = "null" ] && continue
+
+    # Only DxE files
+    case "$FILE_PATH" in
+      *dge/sessions/*|*dge/decisions/*|*dge/specs/*|*dve/annotations/*|*dve/contexts/*) ;;
+      *) continue ;;
+    esac
+
+    # Get relative path
+    local REL_PATH=""
+    if [[ "$FILE_PATH" == "$PROJ_DIR"* ]]; then
+      REL_PATH="${FILE_PATH#$PROJ_DIR/}"
+    else
+      REL_PATH=$(echo "$FILE_PATH" | grep -oP "(dge|dve)/.*" || true)
+      [ -z "$REL_PATH" ] && continue
+    fi
+
+    local TARGET="${PROJ_DIR}/${REL_PATH}"
+
+    # Extract content to temp file (avoid shell variable size limits)
+    echo "$line" | jq -r '.content // empty' 2>/dev/null > "$TMPDIR/content.tmp"
+    local LOG_LINES=$(wc -l < "$TMPDIR/content.tmp")
+    [ "$LOG_LINES" -lt 3 ] && continue
+
+    local LOG_HAS_DIALOGUE=$(grep -cE "Scene|先輩|ナレーション|☕|👤|🎩|😰|⚔|🎨|📊" "$TMPDIR/content.tmp" 2>/dev/null || true)
+
+    if [ ! -f "$TARGET" ]; then
+      echo "│  ✅ [NEW] ${REL_PATH} (${LOG_LINES} lines)"
+      if [ "$DRY_RUN" = false ]; then
+        mkdir -p "$(dirname "$TARGET")"
+        cp "$TMPDIR/content.tmp" "$TARGET"
+      fi
+      RECOVERED=$((RECOVERED + 1))
+    else
+      local EXISTING_LINES=$(wc -l < "$TARGET")
+      local HAS_DIALOGUE=$(grep -cE "Scene|先輩|ナレーション|☕|👤|🎩|😰|⚔|🎨|📊" "$TARGET" 2>/dev/null || true)
+
+      # Update if log version is significantly larger and has more dialogue
+      if [ "$LOG_LINES" -gt "$((EXISTING_LINES + 20))" ] && [ "$LOG_HAS_DIALOGUE" -gt "$HAS_DIALOGUE" ]; then
+        echo "│  🔄 [UPDATE] ${REL_PATH} (${EXISTING_LINES}→${LOG_LINES} lines, dialogue: ${HAS_DIALOGUE}→${LOG_HAS_DIALOGUE})"
+        if [ "$DRY_RUN" = false ]; then
+          cp "$TARGET" "${TARGET}.bak"
+          cp "$TMPDIR/content.tmp" "$TARGET"
+        fi
+        UPDATED=$((UPDATED + 1))
+      else
+        SKIPPED=$((SKIPPED + 1))
+      fi
+    fi
+  done < "$TMPDIR/writes.jsonl"
+
+  echo "│  Total writes: ${TOTAL} | Recovered: ${RECOVERED} | Updated: ${UPDATED} | Skipped: ${SKIPPED}"
+  echo "└──────────────────────────────"
+
+  rm -rf "$TMPDIR"
+}
+
+if [ "$SCAN_ALL" = true ]; then
+  # Discover project paths from Write tool calls in logs
+  DISCOVERED_PATHS=$(mktemp)
+  for LOG_DIR in "$CLAUDE_LOGS_DIR"/*/; do
+    [ -d "$LOG_DIR" ] || continue
+    for f in "$LOG_DIR"*.jsonl; do
+      [ -f "$f" ] || continue
+      grep '"type":"assistant"' "$f" 2>/dev/null | \
+        jq -r '.message.content[]? | select(.type=="tool_use" and .name=="Write") | .input.file_path // empty' 2>/dev/null | \
+        grep -E "dge/|dve/" | \
+        sed 's|/dge/.*||; s|/dve/.*||' | \
+        sort -u >> "$DISCOVERED_PATHS" 2>/dev/null || true
+    done
+  done
+  sort -u "$DISCOVERED_PATHS" | while IFS= read -r PROJ_PATH; do
+    [ -z "$PROJ_PATH" ] && continue
+    [ -d "$PROJ_PATH" ] && recover_project "$PROJ_PATH" || true
+  done
+  rm -f "$DISCOVERED_PATHS"
+else
+  recover_project "$PROJECT_DIR"
+fi
+
+echo ""
+if [ "$DRY_RUN" = true ]; then
+  echo "Dry run complete. Add --apply to write files."
+fi

package/scripts/recover-dialogues.sh

@@ -0,0 +1,190 @@
+#!/usr/bin/env bash
+# recover-dialogues.sh — Extract DGE dialogues from Claude Code logs
+# and merge them into existing session files that lack dialogue content.
+#
+# Usage:
+#   bash dve/kit/scripts/recover-dialogues.sh [project-dir]
+#   bash dve/kit/scripts/recover-dialogues.sh /path/to/volta-platform
+#
+# What it does:
+#   1. Find Claude Code logs for the project
+#   2. Extract assistant text blocks containing DGE dialogue markers
+#   3. Match with existing session files by theme/date
+#   4. Create enriched session files with dialogue included
+#
+# Dry run (default): shows what would be done. Add --apply to write files.
+
+set -euo pipefail
+
+PROJECT_DIR="${1:-.}"
+PROJECT_DIR="$(cd "$PROJECT_DIR" && pwd)"
+PROJECT_NAME="$(basename "$PROJECT_DIR")"
+DRY_RUN=true
+
+for arg in "$@"; do
+  [ "$arg" = "--apply" ] && DRY_RUN=false
+done
+
+SESSIONS_DIR="${PROJECT_DIR}/dge/sessions"
+CLAUDE_LOGS_DIR="$HOME/.claude/projects"
+
+if [ ! -d "$SESSIONS_DIR" ]; then
+  echo "Error: $SESSIONS_DIR not found."
+  exit 1
+fi
+
+echo "🔍 Recovering DGE dialogues for: ${PROJECT_NAME}"
+echo "   Sessions: ${SESSIONS_DIR}"
+echo "   Mode: $([ "$DRY_RUN" = true ] && echo "DRY RUN" || echo "APPLY")"
+echo ""
+
+# Find Claude Code log directory for this project
+# Claude Code uses the path with dashes, e.g. -home-opa-work-AskOS-workspace-volta-platform
+PROJECT_PATH_ENCODED=$(echo "$PROJECT_DIR" | sed 's|/|-|g')
+LOG_DIR=""
+for d in "$CLAUDE_LOGS_DIR"/*; do
+  [ -d "$d" ] || continue
+  DIRNAME="$(basename "$d")"
+  if [ "$DIRNAME" = "$PROJECT_PATH_ENCODED" ]; then
+    LOG_DIR="$d"
+    break
+  fi
+done
+
+if [ -z "$LOG_DIR" ]; then
+  echo "  No Claude Code logs found for ${PROJECT_NAME}"
+  echo "  Expected: ${CLAUDE_LOGS_DIR}/${PROJECT_PATH_ENCODED}"
+  exit 0
+fi
+
+LOG_COUNT=$(find "$LOG_DIR" -maxdepth 1 -name "*.jsonl" | wc -l)
+echo "  Found ${LOG_COUNT} log files in ${LOG_DIR}"
+echo ""
+
+# Extract all DGE dialogue blocks from logs
+TMPDIR=$(mktemp -d)
+trap "rm -rf $TMPDIR" EXIT
+
+echo "  Extracting DGE dialogues from logs..."
+
+for LOGFILE in "$LOG_DIR"/*.jsonl; do
+  [ -f "$LOGFILE" ] || continue
+  BASENAME=$(basename "$LOGFILE" .jsonl)
+
+  # Extract assistant text blocks that contain DGE markers
+  grep '"type":"assistant"' "$LOGFILE" 2>/dev/null | \
+    jq -r '.message.content[] | select(.type=="text") | .text' 2>/dev/null | \
+    awk '
+      /^#.*DGE Session|^##.*Scene [0-9]|^##.*Scene [０-９]/ { found=1 }
+      found { print }
+      /^---$/ && found && length > 100 { }
+    ' > "$TMPDIR/${BASENAME}.txt" 2>/dev/null || true
+
+  # Also try: look for blocks with Gap markers + character dialogue
+  grep '"type":"assistant"' "$LOGFILE" 2>/dev/null | \
+    jq -r '.message.content[] | select(.type=="text") | .text' 2>/dev/null | \
+    awk '
+      /→.*Gap 発見|Gap 発見:/ { gap++ }
+      /先輩.*ナレーション|☕|👤|🎩|😰|⚔|🎨|📊|🏥|😈/ { char++ }
+      { lines[NR] = $0 }
+      END {
+        if (gap > 0 && char > 0) {
+          for (i=1; i<=NR; i++) print lines[i]
+        }
+      }
+    ' >> "$TMPDIR/${BASENAME}.txt" 2>/dev/null || true
+done
+
+# Count extracted content
+EXTRACTED=$(find "$TMPDIR" -name "*.txt" -size +100c | wc -l)
+echo "  Extracted dialogue from ${EXTRACTED} log files"
+echo ""
+
+# Match with session files
+RECOVERED=0
+SKIPPED=0
+
+for SESSION_FILE in "$SESSIONS_DIR"/*.md; do
+  [ -f "$SESSION_FILE" ] || continue
+  FNAME="$(basename "$SESSION_FILE")"
+
+  # Check if session already has dialogue
+  HAS_DIALOGUE=$(grep -cE "Scene|先輩|ナレーション|☕|👤|🎩" "$SESSION_FILE" 2>/dev/null || true)
+  if [ "$HAS_DIALOGUE" -gt 2 ]; then
+    continue  # Already has dialogue
+  fi
+
+  # Extract theme from session file
+  THEME=$(grep -m1 "テーマ\|theme\|Theme" "$SESSION_FILE" 2>/dev/null | sed 's/.*[:：] *//' | head -1)
+  DATE=$(echo "$FNAME" | grep -oP '^\d{4}-\d{2}-\d{2}' || true)
+
+  if [ -z "$THEME" ] && [ -z "$DATE" ]; then
+    continue
+  fi
+
+  # Search extracted dialogues for matching content
+  BEST_MATCH=""
+  BEST_SCORE=0
+
+  for EXTRACTED_FILE in "$TMPDIR"/*.txt; do
+    [ -s "$EXTRACTED_FILE" ] || continue
+    SCORE=0
+
+    # Match by theme keywords
+    if [ -n "$THEME" ]; then
+      KEYWORDS=$(echo "$THEME" | tr ' 　/・' '\n' | head -5)
+      for KW in $KEYWORDS; do
+        [ ${#KW} -lt 2 ] && continue
+        KW_COUNT=$(grep -ci "$KW" "$EXTRACTED_FILE" 2>/dev/null || true)
+        SCORE=$((SCORE + KW_COUNT))
+      done
+    fi
+
+    # Match by date
+    if [ -n "$DATE" ] && grep -q "$DATE" "$EXTRACTED_FILE" 2>/dev/null; then
+      SCORE=$((SCORE + 10))
+    fi
+
+    if [ "$SCORE" -gt "$BEST_SCORE" ]; then
+      BEST_SCORE=$SCORE
+      BEST_MATCH="$EXTRACTED_FILE"
+    fi
+  done
+
+  if [ "$BEST_SCORE" -gt 3 ] && [ -n "$BEST_MATCH" ]; then
+    DIALOGUE_LINES=$(wc -l < "$BEST_MATCH")
+    echo "  ✅ ${FNAME}"
+    echo "     Theme: ${THEME:-N/A} | Score: ${BEST_SCORE} | Lines: ${DIALOGUE_LINES}"
+
+    if [ "$DRY_RUN" = false ]; then
+      # Backup original
+      cp "$SESSION_FILE" "${SESSION_FILE}.bak"
+
+      # Append dialogue section
+      {
+        echo ""
+        echo "---"
+        echo ""
+        echo "## 会話劇（ログから復元）"
+        echo ""
+        cat "$BEST_MATCH"
+      } >> "$SESSION_FILE"
+
+      echo "     → Appended to ${SESSION_FILE}"
+    fi
+    RECOVERED=$((RECOVERED + 1))
+  else
+    SKIPPED=$((SKIPPED + 1))
+  fi
+done
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Recovered: ${RECOVERED}"
+echo "  Skipped:   ${SKIPPED} (no matching dialogue found)"
+if [ "$DRY_RUN" = true ] && [ "$RECOVERED" -gt 0 ]; then
+  echo ""
+  echo "  Dry run complete. Add --apply to write files:"
+  echo "  bash dve/kit/scripts/recover-dialogues.sh ${PROJECT_DIR} --apply"
+fi
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"