xwang 0.0.7 → 0.0.8

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

@@ -77,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/package.json

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