xwang 0.0.6 → 0.0.8

package/assets/manifest.json

@@ -5,6 +5,7 @@
     "xwang/scripts/xwang-env.sh",
     "xwang/scripts/xwang-state.sh",
     "xwang/scripts/xwang-guard.sh",
+    "xwang/scripts/xwang-doc-lang-check.sh",
     "xwang-open/SKILL.md",
     "xwang-open/scripts/xwang-open-check.sh",
     "xwang-design/SKILL.md",

package/assets/skills/xwang/scripts/xwang-doc-lang-check.sh

@@ -0,0 +1,176 @@
+#!/bin/bash
+# xwang-doc-lang-check — validate language consistency across xwang-generated documents
+# Usage: xwang-doc-lang-check.sh [file-or-dir ...]
+# Exits 0 if all documents are consistent, 1 if any are mixed.
+# On mixed output, stdout contains a correction prompt in the primary language.
+
+set -euo pipefail
+
+# --- Language detection helpers ---
+
+# Count CJK unified ideographs in text
+count_cjk() {
+  local text="$1"
+  printf '%s' "$text" | perl -CS -ne 'BEGIN { $n=0 } while (/[\x{4e00}-\x{9fff}]/g) { $n++ } END { print $n }'
+}
+
+# Count alphabetic ASCII words
+count_words() {
+  local text="$1"
+  printf '%s' "$text" | grep -oE '[a-zA-Z]+' | wc -l | tr -d ' '
+}
+
+# Detect dominant language: "zh" or "en"
+detect_language() {
+  local text="$1"
+  local cjk words
+  cjk=$(count_cjk "$text")
+  words=$(count_words "$text")
+  if [ "$cjk" -gt "$words" ]; then
+    echo "zh"
+  else
+    echo "en"
+  fi
+}
+
+# --- Markdown helpers ---
+
+is_markdown() {
+  local file="$1"
+  case "$file" in
+    *.md|*.mdx) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+# Check a single markdown file for language consistency.
+# Outputs issues to stderr and a correction prompt to stdout when inconsistent.
+check_file() {
+  local file="$1"
+  local title=""
+  local lead=""
+  local primary=""
+  local section_name=""
+  local section_body=""
+  local issues=()
+
+  flush_section() {
+    if [ -z "$section_name" ]; then
+      return
+    fi
+    local full_section="${section_name}"$'\n'"${section_body}"
+    if [ -z "$primary" ]; then
+      lead="${lead}${full_section}"
+      primary=$(detect_language "$lead")
+    else
+      local section_lang
+      section_lang=$(detect_language "$full_section")
+      if [ "$section_lang" != "$primary" ]; then
+        issues+=("section \"$section_name\": $section_lang, expected $primary")
+      fi
+    fi
+    section_name=""
+    section_body=""
+  }
+
+  while IFS= read -r line || [ -n "$line" ]; do
+    if [[ "$line" =~ ^#[[:space:]] ]]; then
+      # Level-1 heading: treat as title / lead context
+      title="${line#*# }"
+      lead="${lead}${line}"$'\n'
+      continue
+    fi
+
+    if [[ "$line" =~ ^##[[:space:]] ]]; then
+      flush_section
+      section_name="${line##*## }"
+      section_body=""
+      continue
+    fi
+
+    if [ -n "$section_name" ]; then
+      section_body="${section_body}${line}"$'\n'
+    else
+      # Content before the first section contributes to the lead
+      lead="${lead}${line}"$'\n'
+    fi
+  done < "$file"
+
+  flush_section
+
+  # If no sections at all, treat the whole file as one document
+  if [ -z "$primary" ]; then
+    primary=$(detect_language "$lead")
+  fi
+
+  if [ ${#issues[@]} -eq 0 ]; then
+    echo "OK: $file language is consistent ($primary)"
+    return 0
+  fi
+
+  echo "MIXED-LANGUAGE: $file (${#issues[@]} issue(s))" >&2
+  for issue in "${issues[@]}"; do
+    echo "  - $issue" >&2
+  done
+
+  if [ "$primary" = "zh" ]; then
+    cat <<'EOF'
+上述文档存在中英文混用问题。项目上下文为中文，请将整份文档统一改写为中文，保持所有章节（包括但不限于标题、Problem Statement、Solution、User Stories、Implementation Decisions、Testing Decisions、Out of Scope、Further Notes、Why、What Changes、Capabilities、Impact 等）语言一致。
+EOF
+  else
+    cat <<'EOF'
+The document above has mixed languages. The project context is English. Please rewrite the entire document in English, keeping all sections (including but not limited to title, Problem Statement, Solution, User Stories, Implementation Decisions, Testing Decisions, Out of Scope, Further Notes, Why, What Changes, Capabilities, Impact, etc.) consistent in language.
+EOF
+  fi
+
+  return 1
+}
+
+# --- Argument collection ---
+
+declare -a FILES=()
+
+if [ $# -eq 0 ]; then
+  echo "Usage: $0 [file-or-dir ...]" >&2
+  exit 2
+fi
+
+for arg in "$@"; do
+  if [ -f "$arg" ]; then
+    FILES+=("$arg")
+  elif [ -d "$arg" ]; then
+    while IFS= read -r f; do
+      if is_markdown "$f"; then
+        FILES+=("$f")
+      fi
+    done < <(find "$arg" -type f \( -name '*.md' -o -name '*.mdx' \) \
+      ! -path '*/node_modules/*' \
+      ! -path '*/.git/*' \
+      ! -path '*/dist/*' \
+      ! -path '*/.claude/worktrees/*' \
+      2>/dev/null || true)
+  else
+    echo "WARNING: not found: $arg" >&2
+  fi
+done
+
+if [ ${#FILES[@]} -eq 0 ]; then
+  echo "No markdown documents found to check." >&2
+  exit 0
+fi
+
+mixed=0
+for file in "${FILES[@]}"; do
+  if ! check_file "$file"; then
+    mixed=$((mixed + 1))
+  fi
+done
+
+if [ "$mixed" -eq 0 ]; then
+  echo "OK: all ${#FILES[@]} document(s) have consistent language"
+  exit 0
+else
+  echo "" >&2
+  echo "Total: $mixed / ${#FILES[@]} document(s) have mixed languages." >&2
+  exit 1
+fi

package/assets/skills/xwang/scripts/xwang-env.sh

@@ -65,6 +65,17 @@ if [ -z "${XWANG_GUARD:-}" ]; then
 fi
 export XWANG_GUARD
 
+# Locate xwang-doc-lang-check.sh using the same approach.
+if [ -z "${XWANG_DOC_LANG_CHECK:-}" ]; then
+  XWANG_DOC_LANG_CHECK_SIBLING="${XWANG_SCRIPT_DIR}/xwang-doc-lang-check.sh"
+  if [ -f "$XWANG_DOC_LANG_CHECK_SIBLING" ]; then
+    XWANG_DOC_LANG_CHECK="$(cd "$(dirname "$XWANG_DOC_LANG_CHECK_SIBLING")" && pwd)/$(basename "$XWANG_DOC_LANG_CHECK_SIBLING")"
+  else
+    XWANG_DOC_LANG_CHECK="$(locate_by_glob '*/xwang/scripts/xwang-doc-lang-check.sh' "${SEARCH_DIRS[@]}" 2>/dev/null || true)"
+  fi
+fi
+export XWANG_DOC_LANG_CHECK
+
 if [ -z "$XWANG_OPEN_CHECK" ] || [ ! -f "$XWANG_OPEN_CHECK" ]; then
   echo "WARNING: xwang-open-check.sh not found" >&2
 fi
@@ -72,3 +83,7 @@ fi
 if [ -z "$XWANG_GUARD" ] || [ ! -f "$XWANG_GUARD" ]; then
   echo "WARNING: xwang-guard.sh not found" >&2
 fi
+
+if [ -z "$XWANG_DOC_LANG_CHECK" ] || [ ! -f "$XWANG_DOC_LANG_CHECK" ]; then
+  echo "WARNING: xwang-doc-lang-check.sh not found" >&2
+fi

package/assets/skills/xwang/scripts/xwang-guard.sh

@@ -13,6 +13,35 @@ red() { echo -e "\033[31m$1\033[0m" >&2; }
 green() { echo -e "\033[32m$1\033[0m" >&2; }
 warn() { echo -e "\033[33m$1\033[0m" >&2; }
 
+# --- Project root resolution ---
+
+find_project_root() {
+  if [ -n "${XWANG_PROJECT_ROOT:-}" ]; then
+    printf '%s' "$XWANG_PROJECT_ROOT"
+    return 0
+  fi
+
+  local git_root
+  git_root=$(git rev-parse --show-toplevel 2>/dev/null || true)
+  if [ -n "$git_root" ]; then
+    printf '%s' "$git_root"
+    return 0
+  fi
+
+  local dir="$PWD"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/openspec/changes" ]; then
+      printf '%s' "$dir"
+      return 0
+    fi
+    dir=$(dirname "$dir")
+  done
+
+  printf '%s' "$PWD"
+}
+
+PROJECT_ROOT=$(find_project_root)
+
 # --- Input validation ---
 
 validate_change_name() {
@@ -48,9 +77,16 @@ else
   if [[ "${3:-}" == "--apply" ]]; then
     APPLY=1
   fi
-  CHANGE_DIR="openspec/changes/$CHANGE"
-  if [ "$PHASE" = "archive" ] && [ ! -d "$CHANGE_DIR" ] && [ -d "openspec/changes/archive/$CHANGE" ]; then
-    CHANGE_DIR="openspec/changes/archive/$CHANGE"
+  CHANGE_DIR="$PROJECT_ROOT/openspec/changes/$CHANGE"
+  if [ "$PHASE" = "archive" ] && [ ! -d "$CHANGE_DIR" ]; then
+    if [ -d "$PROJECT_ROOT/openspec/changes/archive/$CHANGE" ]; then
+      CHANGE_DIR="$PROJECT_ROOT/openspec/changes/archive/$CHANGE"
+    elif [ -d "$PROJECT_ROOT/openspec/changes/archive" ]; then
+      archived=$(find "$PROJECT_ROOT/openspec/changes/archive" -maxdepth 1 -type d -name "*-$CHANGE" -print -quit 2>/dev/null || true)
+      if [ -n "$archived" ]; then
+        CHANGE_DIR="$archived"
+      fi
+    fi
   fi
 fi
 
@@ -306,7 +342,7 @@ branch_status_handled() {
 design_doc_recorded() {
   local design_doc
   design_doc=$(yaml_field_value "design_doc" 2>/dev/null || true)
-  if [ -n "$design_doc" ] && [ "$design_doc" != "null" ] && [ -f "$design_doc" ]; then
+  if [ -n "$design_doc" ] && [ "$design_doc" != "null" ] && { [ -f "$PROJECT_ROOT/$design_doc" ] || [ -f "$design_doc" ]; }; then
     return 0
   fi
   echo "design_doc must point to an existing PRD for full workflow before leaving design." >&2
@@ -410,6 +446,7 @@ guard_design() {
   check "design.md exists and non-empty" file_nonempty "$CHANGE_DIR/design.md"
   check "tasks.md exists and non-empty" file_nonempty "$CHANGE_DIR/tasks.md"
   check "tasks.md has at least one task" tasks_has_any
+  check "OpenSpec artifacts language consistency" openspec_artifacts_language_consistent
 
   if [ "$workflow" = "full" ]; then
     check "design_doc is recorded for full workflow" design_doc_recorded
@@ -418,7 +455,10 @@ guard_design() {
   local design_doc
   design_doc=$(yaml_field_value "design_doc" 2>/dev/null || true)
   if [ -n "$design_doc" ] && [ "$design_doc" != "null" ]; then
-    check "PRD file ($design_doc) exists" file_nonempty "$design_doc"
+    local doc_path="$design_doc"
+    [ -f "$PROJECT_ROOT/$design_doc" ] && doc_path="$PROJECT_ROOT/$design_doc"
+    check "PRD file ($design_doc) exists" file_nonempty "$doc_path"
+    check "PRD language consistency" design_doc_language_consistent
   elif [ "$workflow" != "full" ]; then
     warn "  [WARN] No design_doc recorded in .xwang.yaml (optional for quick/tweak)"
   fi
@@ -454,6 +494,13 @@ guard_archive() {
   check "proposal.md exists" file_nonempty "$CHANGE_DIR/proposal.md"
   check "design.md exists" file_nonempty "$CHANGE_DIR/design.md"
   check "tasks.md all tasks checked" tasks_all_done
+  check "OpenSpec artifacts language consistency" openspec_artifacts_language_consistent
+
+  local design_doc
+  design_doc=$(yaml_field_value "design_doc" 2>/dev/null || true)
+  if [ -n "$design_doc" ] && [ "$design_doc" != "null" ]; then
+    check "PRD language consistency" design_doc_language_consistent
+  fi
 }
 
 locate_state_script() {
@@ -470,6 +517,66 @@ locate_state_script() {
   return 1
 }
 
+locate_doc_lang_check() {
+  local check_sh="$SCRIPT_DIR/xwang-doc-lang-check.sh"
+  if [ -f "$check_sh" ]; then
+    echo "$check_sh"
+    return 0
+  fi
+  check_sh="$(find "$SCRIPT_DIR" "$SCRIPT_DIR/.." "$HOME" -path '*/xwang/scripts/xwang-doc-lang-check.sh' -type f -print -quit 2>/dev/null || true)"
+  if [ -n "$check_sh" ] && [ -f "$check_sh" ]; then
+    echo "$check_sh"
+    return 0
+  fi
+  return 1
+}
+
+design_doc_language_consistent() {
+  local design_doc
+  design_doc=$(yaml_field_value "design_doc" 2>/dev/null || true)
+  if [ -z "$design_doc" ] || [ "$design_doc" = "null" ]; then
+    return 0
+  fi
+
+  local target=""
+  if [ -f "$PROJECT_ROOT/$design_doc" ]; then
+    target="$PROJECT_ROOT/$design_doc"
+  elif [ -f "$design_doc" ]; then
+    target="$design_doc"
+  elif [ -f "$CHANGE_DIR/design.md" ]; then
+    # design_doc may be stale after archiving; fall back to design.md in the change dir
+    target="$CHANGE_DIR/design.md"
+  fi
+
+  if [ -z "$target" ]; then
+    echo "design_doc file not found: $design_doc" >&2
+    return 1
+  fi
+
+  local check_sh
+  if ! check_sh=$(locate_doc_lang_check); then
+    echo "xwang-doc-lang-check.sh not found; skipping language check" >&2
+    return 0
+  fi
+  "$XWANG_BASH" "$check_sh" "$target" >/dev/null 2>&1
+}
+
+openspec_artifacts_language_consistent() {
+  local check_sh
+  if ! check_sh=$(locate_doc_lang_check); then
+    echo "xwang-doc-lang-check.sh not found; skipping language check" >&2
+    return 0
+  fi
+  local files=()
+  for f in "$CHANGE_DIR/proposal.md" "$CHANGE_DIR/design.md" "$CHANGE_DIR/tasks.md"; do
+    [ -f "$f" ] && files+=("$f")
+  done
+  if [ ${#files[@]} -eq 0 ]; then
+    return 0
+  fi
+  "$XWANG_BASH" "$check_sh" "${files[@]}" >/dev/null 2>&1
+}
+
 apply_state_update() {
   local state_sh
   if ! state_sh=$(locate_state_script); then

package/assets/skills/xwang-archive/SKILL.md

@@ -58,10 +58,18 @@ fi
   - **暂不归档**：不执行归档，保留当前 `phase: archive` 状态，等待用户稍后再次调用 `/xwang-archive`
 - [ ] 只有用户选择「确认归档」后才继续 Step 3。
 
-### Step 3：标记归档状态并校验完整性
+### Step 3：标记归档状态、校验完整性与 PRD 语言一致性
 
 - [ ] 调用 `"$XWANG_STATE" set <name> archived true`，在 change 仍在 `openspec/changes/<name>/` 时把 `.xwang.yaml` 标记为已归档。
 - [ ] **归档完整性守护**：调用 `"$XWANG_GUARD" <name> archive` 校验归档退出条件（`archived: true`、必要文档存在且 tasks 已勾选）。
+- [ ] **PRD 语言一致性守护**：定位当前 change 对应的 PRD 文件（常见路径如 `docs/mattpocock/<name>-prd.md`、`docs/<name>-prd.md` 或 `<name>-prd.md`）。如存在，运行：
+
+  ```bash
+  "$XWANG_DOC_LANG_CHECK" <prd-file>
+  ```
+
+  若脚本报告 `MIXED-LANGUAGE`，将其 stdout 中的修正提示词展示给用户，**停止归档**，等待用户修正 PRD 后重新触发 `/xwang-archive`。只有脚本退出 `0` 才继续下一步。
+
 - [ ] 如需，在 PRD 和 plan 文件前置元数据中标注 `archived-with: <name>` 和 `status: archived`。
 
 ### Step 4：执行归档
@@ -69,6 +77,7 @@ fi
 - [ ] 调用 `/openspec-archive-change <name>`（或等价的 OpenSpec archive 命令）按 delta 语义合并主 spec 并移动 change 到归档目录。
 - [ ] 如归档命令返回非零退出码，报告错误并停止。
 - [ ] 归档成功后，确认 change 目录已移动到 `openspec/changes/archive/YYYY-MM-DD-<name>/`（或 OpenSpec 默认归档路径）。
+- [ ] **同步 `.xwang.yaml` 中的文件路径**：如果 `design_doc`、`plan`、`verification_report` 等字段指向的是 `openspec/changes/<name>/` 下的旧路径，更新为归档目录 `openspec/changes/archive/YYYY-MM-DD-<name>/` 下的相对路径，避免后续 guard 或读取时路径失效。
 - [ ] 向用户汇报归档完成、新目录路径与生命周期闭环状态。
 
 ## 退出条件

package/assets/skills/xwang-design/SKILL.md

@@ -105,8 +105,18 @@ grilling 确认完成后、生成 PRD 前，**必须**执行 PRD 拆分预检并
 
 ### Step 2：生成 PRD
 
-- [ ] 用户确认后，调用 `/to-prd` 生成**中文** PRD（遵循 to-prd 的 PRD 模板），无需额外用户确认。
+- [ ] 用户确认后，调用 `/to-prd` 生成 PRD（遵循 to-prd 的 PRD 模板），无需额外用户确认。
 - [ ] 将 PRD 写入 `docs/mattpocock/<name>-prd.md`；如果 grilling 过程中名称有调整，使用最终生成的名称。
+- [ ] **PRD 语言一致性守护**：写入后运行语言检测脚本：
+
+  ```bash
+  XWANG_ENV="${XWANG_ENV:-$(find . "$HOME"/.*/skills "$HOME/.config" -path '*/xwang/scripts/xwang-env.sh' -type f -print -quit 2>/dev/null)}"
+  . "$XWANG_ENV"
+  "$XWANG_DOC_LANG_CHECK" docs/mattpocock/<name>-prd.md
+  ```
+
+  若脚本报告 `MIXED-LANGUAGE`，将其 stdout 中的修正提示词追加到下一次 `/to-prd` 请求中，重新生成并写入 PRD，重复检测直到脚本退出 `0`。
+
 - [ ] **如果 Step 1a 结论为「保持为一个 change」，在 PRD 中显式写入“不拆分原因”章节。**
 
 ### Step 3：创建 OpenSpec change

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xwang",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "xwang CLI",
   "keywords": [
     "xwang",