dw-kit 1.0.0 → 1.0.1

package/scripts/migrate-v03-to-v1.sh

@@ -1,243 +0,0 @@
-#!/bin/bash
-# scripts/migrate-v03-to-v1.sh
-# ⚠ DEPRECATED: Prefer `dw migrate` from npm CLI.
-# Migrate project từ dw-kit v0.3 sang v1
-# Usage: bash scripts/migrate-v03-to-v1.sh [--dry-run]
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-DRY_RUN=false
-[ "${1:-}" = "--dry-run" ] && DRY_RUN=true
-
-log()  { echo "  $*"; }
-info() { echo ""; echo "▶ $*"; }
-warn() { echo "  ⚠  $*"; }
-ok()   { echo "  ✓  $*"; }
-dry()  { [ "$DRY_RUN" = true ] && echo "  [dry] $*" || true; }
-do_action() {
-  if [ "$DRY_RUN" = true ]; then echo "  [dry] $*"; else eval "$*"; fi
-}
-
-OLD_CONFIG="$PROJECT_ROOT/.dw/config/dw.config.yml"
-NEW_CONFIG_DIR="$PROJECT_ROOT/config"
-NEW_CONFIG="$NEW_CONFIG_DIR/dw.config.yml"
-
-echo ""
-echo "══════════════════════════════════════════"
-echo "  dw-kit v0.3 → v1 Migration"
-[ "$DRY_RUN" = true ] && echo "  Mode: DRY RUN"
-echo "══════════════════════════════════════════"
-
-# ── Step 1: Validate v0.3 present ────────────────────────────────────────────
-info "Step 1: Validate source config"
-
-if [ ! -f "$OLD_CONFIG" ]; then
-  echo "  No config/dw.config.yml found. Already on v1 or fresh install."
-  exit 0
-fi
-
-if [ -L "$OLD_CONFIG" ]; then
-  warn "config/dw.config.yml is already a symlink → migration may have already run."
-  read -r -p "  Continue anyway? [y/N] " confirm
-  [[ "$confirm" =~ ^[Yy]$ ]] || exit 0
-fi
-
-ok "Found config/dw.config.yml"
-
-# ── Step 2: Detect customized skills ─────────────────────────────────────────
-info "Step 2: Detect customized skills"
-
-OVERRIDES_DIR="$PROJECT_ROOT/.dw/adapters/claude-cli/overrides/skills"
-SKILLS_DIR="$PROJECT_ROOT/.claude/skills"
-customized_count=0
-
-# Heuristic: compare với toolkit's own copy nếu có, hoặc check git
-if command -v git &>/dev/null && git -C "$PROJECT_ROOT" rev-parse --git-dir &>/dev/null; then
-  for skill_dir in "$SKILLS_DIR"/*/; do
-    [ -d "$skill_dir" ] || continue
-    skill_name=$(basename "$skill_dir")
-    skill_file="$skill_dir/SKILL.md"
-    [ -f "$skill_file" ] || continue
-
-    # Check if file was modified from its committed version
-    if ! git -C "$PROJECT_ROOT" diff --quiet HEAD -- ".claude/skills/$skill_name/SKILL.md" 2>/dev/null; then
-      warn "Skill '$skill_name' has uncommitted changes → preserving to overrides/"
-      do_action "mkdir -p '$OVERRIDES_DIR/$skill_name'"
-      do_action "cp '$skill_file' '$OVERRIDES_DIR/$skill_name/SKILL.md'"
-      customized_count=$((customized_count + 1))
-    fi
-  done
-else
-  warn "Not a git repo or git not available. Cannot auto-detect customizations."
-  warn "Manually copy customized skills to adapters/claude-cli/overrides/skills/ before upgrading."
-fi
-
-if [ $customized_count -gt 0 ]; then
-  ok "$customized_count customized skill(s) preserved to overrides/"
-else
-  ok "No customized skills detected"
-fi
-
-# ── Step 3: Migrate config ────────────────────────────────────────────────────
-info "Step 3: Migrate config (config/dw.config.yml → config/dw.config.yml)"
-
-if [ -f "$NEW_CONFIG" ]; then
-  warn "config/dw.config.yml already exists. Skipping config migration."
-  warn "Review manually: $NEW_CONFIG"
-else
-  if ! command -v python3 &>/dev/null; then
-    warn "python3 not found. Manual config migration needed."
-    warn "Map: level: 1 → default_depth: quick"
-    warn "     level: 2 → default_depth: standard"
-    warn "     level: 3 → default_depth: thorough"
-  else
-    if [ "$DRY_RUN" = false ]; then
-      mkdir -p "$NEW_CONFIG_DIR"
-      python3 - "$OLD_CONFIG" "$NEW_CONFIG" <<'PYEOF'
-import sys, re
-
-old_path = sys.argv[1]
-new_path = sys.argv[2]
-
-with open(old_path) as f:
-    old_content = f.read()
-
-# Extract values from old config
-def get_val(key, content, default=""):
-    m = re.search(rf'^\s*{re.escape(key)}:\s*([^\n#]+)', content, re.MULTILINE)
-    if m:
-        return m.group(1).strip().strip('"').strip("'")
-    return default
-
-project_name = get_val("name", old_content, "my-project")
-project_lang = get_val("language", old_content, "vi")
-level_str    = get_val("level", old_content, "2")
-
-depth_map = {"1": "quick", "2": "standard", "3": "thorough"}
-depth = depth_map.get(level_str, "standard")
-
-# Extract roles
-roles_match = re.findall(r'^\s+-\s+(dev|techlead|ba|qc|pm)\b', old_content, re.MULTILINE)
-roles = roles_match if roles_match else ["dev"]
-
-# Extract quality commands
-test_cmd = get_val("test_command", old_content, "")
-lint_cmd  = get_val("lint_command", old_content, "")
-
-# Extract paths
-tasks_path   = get_val("tasks", old_content, ".dw/tasks")
-docs_path    = get_val("docs", old_content, ".dw/docs")
-
-# Build new config
-roles_yaml = "\n".join(f"    - {r}" for r in roles)
-
-new_config = f"""# dw-kit Configuration
-# Generated by migrate-v03-to-v1.sh
-# Review and adjust as needed.
-
-project:
-  name: "{project_name}"
-  language: "{project_lang}"
-
-workflow:
-  default_depth: "{depth}"   # quick | standard | thorough
-  # AI assesses per-task and may recommend different depth
-
-team:
-  roles:
-{roles_yaml}
-
-quality:
-  test_command: "{test_cmd}"   # empty = skip
-  lint_command: "{lint_cmd}"   # empty = skip
-  block_on_fail: false
-
-tracking:
-  estimation: false
-  log_work: false
-  estimation_unit: "hours"
-
-paths:
-  tasks: "{tasks_path}"
-  docs: "{docs_path}"
-
-# Claude-specific capabilities (Layer 2)
-claude:
-  models:
-    plan: ""          # empty = inherit from Claude Code settings
-    execute: ""
-    review: ""
-  structured_output: true
-  worktree_execution: false
-  mcp: []
-
-# Toolkit version tracking (do not edit manually)
-_toolkit:
-  core_version: "1.0"
-  platform_version: "1.0"
-  capability_version: "1.0"
-  migrated_from: "v0.3"
-  last_upgrade: "{__import__('datetime').date.today().isoformat()}"
-"""
-
-with open(new_path, 'w') as f:
-    f.write(new_config)
-PYEOF
-      ok "config/dw.config.yml created (migrated from level: $level_str → depth: $(grep default_depth "$NEW_CONFIG" | head -1))"
-    else
-      dry "Would create config/dw.config.yml from config/dw.config.yml"
-    fi
-  fi
-fi
-
-# ── Step 4: Create backward-compat symlink ────────────────────────────────────
-info "Step 4: Create backward-compat symlink"
-
-if [ -f "$NEW_CONFIG" ] && [ ! -L "$OLD_CONFIG" ]; then
-  if [ "$DRY_RUN" = false ]; then
-    # Backup original
-    cp "$OLD_CONFIG" "${OLD_CONFIG}.bak"
-    ok "Backed up original to config/dw.config.yml.bak"
-    # Create symlink
-    rm "$OLD_CONFIG"
-    ln -s ".dw/.dw/config/dw.config.yml" "$OLD_CONFIG"
-    ok "Created symlink: config/dw.config.yml → config/dw.config.yml"
-  else
-    dry "Would create symlink: config/dw.config.yml → config/dw.config.yml"
-  fi
-fi
-
-# ── Step 5: Check CI/CD references ───────────────────────────────────────────
-info "Step 5: Check CI/CD references"
-
-found_refs=false
-for ci_file in ".github/workflows/"*.yml ".gitlab-ci.yml" "Makefile" ".circleci/config.yml" "package.json"; do
-  full_path="$PROJECT_ROOT/$ci_file"
-  if [ -f "$full_path" ]; then
-    if grep -qE "dv-workflow\.config\.yml|dv-workflow-kit" "$full_path" 2>/dev/null; then
-      warn "Found reference in: $ci_file — update to config/dw.config.yml"
-      found_refs=true
-    fi
-  fi
-done
-[ "$found_refs" = false ] && ok "No CI/CD references found"
-
-# ── Summary ───────────────────────────────────────────────────────────────────
-echo ""
-echo "══════════════════════════════════════════"
-if [ "$DRY_RUN" = true ]; then
-  echo "  DRY RUN complete. Review above, then run without --dry-run."
-else
-  echo "  Migration complete!"
-  echo ""
-  echo "  Next steps:"
-  echo "  1. Review config/dw.config.yml — adjust team.roles, quality commands"
-  echo "  2. Run: bash setup.sh to regenerate .claude/ from new config"
-  echo "  3. Check adapters/claude-cli/overrides/ for preserved customizations"
-  [ "$found_refs" = true ] && echo "  4. ⚠  Update CI/CD files (see warnings above)"
-fi
-echo "══════════════════════════════════════════"
-echo ""

package/scripts/upgrade.sh

@@ -1,246 +0,0 @@
-#!/bin/bash
-# scripts/upgrade.sh
-# ⚠ DEPRECATED: Prefer `dw upgrade` from npm CLI.
-# Upgrade dw-kit: update generated/ files, preserve overrides/ và extensions/
-# Usage: bash scripts/upgrade.sh [--dry-run] [--layer core|platform|all]
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-# ── Options ──────────────────────────────────────────────────────────────────
-DRY_RUN=false
-LAYER="all"
-
-for arg in "$@"; do
-  case "$arg" in
-    --dry-run) DRY_RUN=true ;;
-    --layer) shift; LAYER="${1:-all}" ;;
-    --layer=*) LAYER="${arg#*=}" ;;
-  esac
-done
-
-# ── Helpers ───────────────────────────────────────────────────────────────────
-log()  { echo "  $*"; }
-info() { echo ""; echo "▶ $*"; }
-warn() { echo "  ⚠  $*"; }
-ok()   { echo "  ✓  $*"; }
-dry()  { echo "  [dry-run] $*"; }
-
-do_copy() {
-  local src="$1" dst="$2"
-  if [ "$DRY_RUN" = true ]; then
-    dry "cp $src → $dst"
-  else
-    mkdir -p "$(dirname "$dst")"
-    cp "$src" "$dst"
-  fi
-}
-
-do_mkdir() {
-  if [ "$DRY_RUN" = true ]; then
-    dry "mkdir -p $1"
-  else
-    mkdir -p "$1"
-  fi
-}
-
-# ── Read current versions ─────────────────────────────────────────────────────
-CONFIG_FILE="$PROJECT_ROOT/.dw/config/dw.config.yml"
-CURRENT_CORE="unknown"
-CURRENT_PLATFORM="unknown"
-
-if [ -f "$CONFIG_FILE" ]; then
-  CURRENT_CORE=$(grep -m1 "core_version:" "$CONFIG_FILE" 2>/dev/null \
-    | sed 's/.*:[[:space:]]*//' | tr -d '"' | tr -d "'" | tr -d '[:space:]' || echo "unknown")
-  CURRENT_PLATFORM=$(grep -m1 "platform_version:" "$CONFIG_FILE" 2>/dev/null \
-    | sed 's/.*:[[:space:]]*//' | tr -d '"' | tr -d "'" | tr -d '[:space:]' || echo "unknown")
-fi
-
-TOOLKIT_CORE=$(grep -m1 "core-version:" "$PROJECT_ROOT/core/WORKFLOW.md" 2>/dev/null \
-  | sed 's/.*core-version:[[:space:]]*//' | tr -d ' -->' | head -1 || echo "1.0")
-
-echo ""
-echo "══════════════════════════════════════════"
-echo "  dw-kit Upgrade"
-echo "  Current: core=$CURRENT_CORE platform=$CURRENT_PLATFORM"
-echo "  Toolkit: core=$TOOLKIT_CORE"
-if [ "$DRY_RUN" = true ]; then
-  echo "  Mode: DRY RUN (no changes)"
-fi
-echo "══════════════════════════════════════════"
-
-# ── Phase 1: Update generated/ ───────────────────────────────────────────────
-info "Phase 1: Update generated files"
-
-GENERATED="$PROJECT_ROOT/.dw/adapters/claude-cli/generated"
-CLAUDE_DIR="$PROJECT_ROOT/.claude"
-
-if [ "$LAYER" = "all" ] || [ "$LAYER" = "platform" ]; then
-  # Copy generated skills → .claude/skills (skip if override exists)
-  if [ -d "$GENERATED/skills" ]; then
-    for skill_dir in "$GENERATED/skills"/*/; do
-      skill_name=$(basename "$skill_dir")
-      override="$PROJECT_ROOT/.dw/adapters/claude-cli/overrides/skills/$skill_name"
-
-      if [ -d "$override" ]; then
-        warn "Skill '$skill_name': override exists → keeping override"
-        # Copy override instead of generated
-        for f in "$override"/*; do
-          [ -f "$f" ] && do_copy "$f" "$CLAUDE_DIR/skills/$skill_name/$(basename "$f")"
-        done
-      else
-        for f in "$skill_dir"*; do
-          [ -f "$f" ] && do_copy "$f" "$CLAUDE_DIR/skills/$skill_name/$(basename "$f")"
-        done
-        ok "Skill '$skill_name': updated"
-      fi
-    done
-  fi
-
-  # Copy generated agents → .claude/agents (skip if override exists)
-  if [ -d "$GENERATED/agents" ]; then
-    for agent_file in "$GENERATED/agents"/*.md; do
-      [ -f "$agent_file" ] || continue
-      agent_name=$(basename "$agent_file")
-      override="$PROJECT_ROOT/.dw/adapters/claude-cli/overrides/agents/$agent_name"
-
-      if [ -f "$override" ]; then
-        warn "Agent '$agent_name': override exists → keeping override"
-        do_copy "$override" "$CLAUDE_DIR/agents/$agent_name"
-      else
-        do_copy "$agent_file" "$CLAUDE_DIR/agents/$agent_name"
-        ok "Agent '$agent_name': updated"
-      fi
-    done
-  fi
-fi
-
-# ── Phase 2: Copy extensions/ ────────────────────────────────────────────────
-info "Phase 2: Copy extensions (team-specific skills)"
-
-EXTENSIONS="$PROJECT_ROOT/.dw/adapters/claude-cli/extensions"
-if [ -d "$EXTENSIONS" ]; then
-  ext_count=0
-  for ext_dir in "$EXTENSIONS"/*/; do
-    [ -d "$ext_dir" ] || continue
-    ext_name=$(basename "$ext_dir")
-    [ "$ext_name" = ".gitkeep" ] && continue
-
-    do_mkdir "$CLAUDE_DIR/skills/$ext_name"
-    for f in "$ext_dir"*; do
-      [ -f "$f" ] && do_copy "$f" "$CLAUDE_DIR/skills/$ext_name/$(basename "$f")"
-    done
-    ok "Extension '$ext_name': installed"
-    ext_count=$((ext_count + 1))
-  done
-  [ $ext_count -eq 0 ] && log "No extensions found"
-fi
-
-# ── Phase 3: Merge settings.json ─────────────────────────────────────────────
-info "Phase 3: Merge settings.json"
-
-SETTINGS_TEMPLATE="$GENERATED/settings.json"
-SETTINGS_TARGET="$CLAUDE_DIR/settings.json"
-
-if [ -f "$SETTINGS_TEMPLATE" ] && [ -f "$SETTINGS_TARGET" ]; then
-  if command -v python3 &>/dev/null; then
-    if [ "$DRY_RUN" = true ]; then
-      dry "Merge settings.json (python3)"
-    else
-      python3 - "$SETTINGS_TEMPLATE" "$SETTINGS_TARGET" <<'PYEOF'
-import json, sys
-
-template_path = sys.argv[1]
-target_path   = sys.argv[2]
-
-with open(template_path) as f:
-    template = json.load(f)
-with open(target_path) as f:
-    target = json.load(f)
-
-def deep_merge(base, override):
-    """Override values from base with override, but preserve keys not in template."""
-    result = dict(base)
-    for k, v in override.items():
-        if k in result and isinstance(result[k], dict) and isinstance(v, dict):
-            result[k] = deep_merge(result[k], v)
-        else:
-            result[k] = v
-    return result
-
-merged = deep_merge(template, target)
-
-with open(target_path, 'w') as f:
-    json.dump(merged, f, indent=2, ensure_ascii=False)
-    f.write('\n')
-PYEOF
-      ok "settings.json: merged"
-    fi
-  else
-    warn "python3 not found — skipping settings.json merge. Manual merge may be needed."
-  fi
-elif [ -f "$SETTINGS_TEMPLATE" ] && [ ! -f "$SETTINGS_TARGET" ]; then
-  do_copy "$SETTINGS_TEMPLATE" "$SETTINGS_TARGET"
-  ok "settings.json: created from template"
-fi
-
-# ── Phase 4: Update version in config ────────────────────────────────────────
-info "Phase 4: Update version tracking"
-
-if [ "$DRY_RUN" = false ] && [ -f "$CONFIG_FILE" ]; then
-  TODAY=$(date +%Y-%m-%d)
-  if command -v python3 &>/dev/null; then
-    python3 - "$CONFIG_FILE" "$TOOLKIT_CORE" "$TODAY" <<'PYEOF'
-import sys, re
-
-config_path = sys.argv[1]
-new_core    = sys.argv[2]
-today       = sys.argv[3]
-
-with open(config_path) as f:
-    content = f.read()
-
-content = re.sub(r'(core_version:\s*)["\']?[\d.]+["\']?', f'\\g<1>"{new_core}"', content)
-content = re.sub(r'(last_upgrade:\s*)["\']?[\d-]+["\']?', f'\\g<1>"{today}"', content)
-
-with open(config_path, 'w') as f:
-    f.write(content)
-PYEOF
-    ok "Config version updated: core=$TOOLKIT_CORE, last_upgrade=$TODAY"
-  fi
-fi
-
-# ── Phase 5: Check for CI/CD references needing manual update ────────────────
-info "Phase 5: Check backward compatibility"
-
-OLD_CONFIG="$PROJECT_ROOT/.dw/config/dw.config.yml"
-if [ -f "$OLD_CONFIG" ]; then
-  if [ -L "$OLD_CONFIG" ]; then
-    ok "config/dw.config.yml: symlink intact (backward compat)"
-  else
-    warn "config/dw.config.yml exists as real file. Run scripts/migrate-v03-to-v1.sh first."
-  fi
-fi
-
-# Check for CI references
-for ci_file in ".github/workflows/"*.yml ".gitlab-ci.yml" "Makefile" ".circleci/config.yml"; do
-  full_path="$PROJECT_ROOT/$ci_file"
-  if [ -f "$full_path" ] && grep -q ".dw/.dw/config/dw.config.yml" "$full_path" 2>/dev/null; then
-    warn "CI file '$ci_file' references config/dw.config.yml — update manually"
-  fi
-done
-
-# ── Summary ───────────────────────────────────────────────────────────────────
-echo ""
-echo "══════════════════════════════════════════"
-if [ "$DRY_RUN" = true ]; then
-  echo "  DRY RUN complete. No changes made."
-  echo "  Run without --dry-run to apply."
-else
-  echo "  Upgrade complete!"
-  echo "  Core version: $TOOLKIT_CORE"
-fi
-echo "══════════════════════════════════════════"
-echo ""