@cyning/harness 0.3.0

package/wizard/harness-sync.sh

@@ -0,0 +1,237 @@
+#!/usr/bin/env bash
+# cyning-harness · 将产品包选定轨道同步到已接入业务仓（不覆盖业务 task / reviews / 自定义图谱正文）
+set -euo pipefail
+
+MODE="${1:-}"
+TARGET="${TARGET:-$(pwd)}"
+SYNC_FORCE=0
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/common.sh
+source "$SCRIPT_DIR/lib/common.sh"
+HARNESS_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+MARKER_BEGIN='<!-- cyning-harness:begin -->'
+MARKER_END='<!-- cyning-harness:end -->'
+
+usage() {
+  cat <<'EOF'
+用法（从业务仓根，或指定 TARGET）：
+
+  CYNING_HARNESS=/path/to/cyning-harness \
+  TARGET=/path/to/ios_buy \
+  "$CYNING_HARNESS/wizard/harness-sync.sh" plan
+
+  "$CYNING_HARNESS/wizard/harness-sync.sh" apply
+
+或：
+
+  "$CYNING_HARNESS/wizard/harness-sync.sh" plan --target /path/to/project
+  "$CYNING_HARNESS/wizard/harness-sync.sh" apply --target /path/to/project
+  "$CYNING_HARNESS/wizard/harness-sync.sh" apply --target /path/to/project --force   # 跳过 S5 git-clean
+
+依赖：业务仓已有 .cyning-harness/profile.json（由 install.sh 生成）
+
+plan  — 仅打印将复制的文件
+apply — 执行复制（S5：git 仓须工作区干净，或 --force）
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    plan|apply) MODE="$1"; shift ;;
+    --target) TARGET="$2"; shift 2 ;;
+    --force) SYNC_FORCE=1; shift ;;
+    -h|--help) usage; exit 0 ;;
+    *) echo "未知参数: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+[[ "$MODE" == "plan" || "$MODE" == "apply" ]] || { usage; exit 1; }
+
+CYNING_HARNESS="${CYNING_HARNESS:-$HARNESS_ROOT}"
+refuse_if_product_root "$TARGET" "$HARNESS_ROOT"
+PROFILE_FILE="$TARGET/.cyning-harness/profile.json"
+
+if [[ ! -f "$PROFILE_FILE" ]]; then
+  echo "错误: 未找到 $PROFILE_FILE" >&2
+  echo "请先运行: $CYNING_HARNESS/wizard/install.sh --target $TARGET --preset <name>" >&2
+  exit 1
+fi
+
+# 简易 JSON 布尔/字符串读取（无 jq 依赖）
+json_bool() { grep -q "\"$1\"[[:space:]]*:[[:space:]]*true" "$PROFILE_FILE"; }
+
+track_enabled() {
+  local k="$1" default="${2:-false}"
+  if ! grep -q "\"$k\"" "$PROFILE_FILE"; then
+    [[ "$default" == "true" ]]
+    return
+  fi
+  json_bool "$k"
+}
+
+json_str() {
+  local k="$1" def="$2"
+  local line
+  line="$(grep "\"$k\"" "$PROFILE_FILE" | head -1)"
+  if [[ -z "$line" ]]; then echo "$def"; return; fi
+  sed -E 's/.*:[[:space:]]*"([^"]*)".*/\1/' <<<"$line" | head -1
+}
+
+IDE_REL=""
+if grep -q '"paths"' "$PROFILE_FILE"; then
+  IDE_REL="$(sed -n '/"paths"/,/^  \}/p' "$PROFILE_FILE" | grep '"ide_cursor"' | head -1 | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/')"
+fi
+[[ -z "$IDE_REL" ]] && IDE_REL=".cursor/rules/06-harness-pointer.mdc"
+CI_TRACK="$(json_str ci none)"
+
+OPS=()
+
+add_cp() {
+  local src="$1" dst="$2" note="${3:-}"
+  OPS+=("cp|$src|$dst|$note")
+}
+
+merge_action_label() {
+  local dst="$1"
+  if [[ ! -f "$dst" ]]; then
+    echo "merge(create)"
+  elif grep -qF "$MARKER_BEGIN" "$dst"; then
+    echo "merge(replace marker)"
+  else
+    echo "merge(append marker)"
+  fi
+}
+
+add_merge() {
+  local src="$1" dst="$2" note="${3:-}"
+  local action
+  action="$(merge_action_label "$dst")"
+  OPS+=("merge|$src|$dst|$note|$action")
+}
+
+merge_fragment_apply() {
+  local src="$1" dst="$2"
+  local tmp_block tmp_out
+
+  tmp_block="$(mktemp)"
+  {
+    printf '%s\n' "$MARKER_BEGIN"
+    cat "$src"
+    printf '%s\n' "$MARKER_END"
+  } > "$tmp_block"
+
+  if [[ ! -f "$dst" ]]; then
+    cp "$tmp_block" "$dst"
+    rm -f "$tmp_block"
+    return
+  fi
+
+  if grep -qF "$MARKER_BEGIN" "$dst"; then
+    tmp_out="$(mktemp)"
+    awk -v begin="$MARKER_BEGIN" -v end="$MARKER_END" -v blockfile="$tmp_block" '
+      BEGIN {
+        while ((getline line < blockfile) > 0) block = block line "\n"
+        close(blockfile)
+        inblock = 0
+        replaced = 0
+      }
+      index($0, begin) && !replaced {
+        printf "%s", block
+        inblock = 1
+        replaced = 1
+        next
+      }
+      inblock {
+        if (index($0, end)) inblock = 0
+        next
+      }
+      { print }
+    ' "$dst" > "$tmp_out"
+    mv "$tmp_out" "$dst"
+  else
+    printf '\n' >> "$dst"
+    cat "$tmp_block" >> "$dst"
+  fi
+  rm -f "$tmp_block"
+}
+
+if track_enabled harness_prompts false; then
+  for f in "$CYNING_HARNESS/harness/prompts/"*.md; do
+    [[ -f "$f" ]] || continue
+    add_cp "$f" "$TARGET/docs/harness/prompts/$(basename "$f")" "harness prompts"
+  done
+fi
+
+if track_enabled harness_invoke_template false; then
+  add_cp "$CYNING_HARNESS/harness/invokes/TEMPLATE_invoke.md" \
+    "$TARGET/docs/harness/invokes/TEMPLATE_invoke.md" "invoke 模板"
+fi
+
+if track_enabled ide_cursor true; then
+  add_cp "$CYNING_HARNESS/ide/adapters/cursor-harness-starter.mdc.example" \
+    "$TARGET/$IDE_REL" "Cursor 规则"
+fi
+
+if track_enabled ide_claude false; then
+  add_merge "$CYNING_HARNESS/ide/adapters/CLAUDE.md.fragment.example" \
+    "$TARGET/CLAUDE.md" "Claude IDE"
+fi
+
+if track_enabled ide_agents false; then
+  add_merge "$CYNING_HARNESS/ide/adapters/AGENTS.md.fragment.example" \
+    "$TARGET/AGENTS.md" "Agents IDE"
+fi
+
+# 图谱/wiki/standards：默认 sync 不覆盖（避免洗掉 01_struct）；install 时写入
+FORCE_TRACKS="${FORCE_TRACKS:-0}"
+if [[ "$FORCE_TRACKS" == "1" ]]; then
+  if json_bool graph || grep -q '"graph"[[:space:]]*:[[:space:]]*true' "$PROFILE_FILE"; then
+    for f in "$CYNING_HARNESS/graph/templates/"*; do
+      [[ -f "$f" ]] || continue
+      add_cp "$f" "$TARGET/docs/_tech_graph/$(basename "$f")" "graph（force）"
+    done
+  fi
+  if json_bool wiki || grep -q '"wiki"[[:space:]]*:[[:space:]]*true' "$PROFILE_FILE"; then
+    for f in "$CYNING_HARNESS/coding_wiki/templates/"*; do
+      [[ -f "$f" ]] || continue
+      add_cp "$f" "$TARGET/docs/coding_wiki/$(basename "$f")" "wiki（force）"
+    done
+  fi
+fi
+
+if [[ ${#OPS[@]} -eq 0 ]]; then
+  echo "无同步项（检查 profile tracks）" >&2
+  exit 1
+fi
+
+if [[ "$MODE" == "apply" ]]; then
+  check_git_clean "$TARGET" "$SYNC_FORCE"
+fi
+
+echo "=== cyning-harness sync ($MODE) ==="
+echo "产品包: $CYNING_HARNESS"
+echo "目标仓: $TARGET"
+echo "profile: $PROFILE_FILE"
+echo ""
+
+for op in "${OPS[@]}"; do
+  IFS='|' read -r kind src dst note extra <<<"$op"
+  if [[ "$kind" == "merge" ]]; then
+    echo "[$note · $extra] $src -> $dst"
+    if [[ "$MODE" == "apply" ]]; then
+      merge_fragment_apply "$src" "$dst"
+    fi
+  else
+    echo "[$note] $src -> $dst"
+    if [[ "$MODE" == "apply" ]]; then
+      mkdir -p "$(dirname "$dst")"
+      cp "$src" "$dst"
+    fi
+  fi
+done
+
+if [[ "$MODE" == "apply" ]]; then
+  echo ""
+  echo "完成。建议: $CYNING_HARNESS/wizard/gate-check.sh --target $TARGET"
+fi

package/wizard/install.sh

@@ -0,0 +1,206 @@
+#!/usr/bin/env bash
+# cyning-harness · 首次接入业务仓（生成 profile + 按 preset 复制）
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/common.sh
+source "$SCRIPT_DIR/lib/common.sh"
+# shellcheck source=lib/manifest.sh
+source "$SCRIPT_DIR/lib/manifest.sh"
+HARNESS_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+TARGET=""
+PRESET="harness-only"
+DRY_RUN=0
+IDE_LIST=""
+TARGET_PROVIDED=0
+PRESET_PROVIDED=0
+IDE_PROVIDED=0
+
+usage() {
+  cat <<'EOF'
+用法:
+
+  # 在产品包目录 · 交互引导（推荐）
+  cd /path/to/cyning-harness
+  ./wizard/install.sh
+
+  # 在业务仓目录 · 默认 target 为当前目录
+  cd /path/to/your-project
+  /path/to/cyning-harness/wizard/install.sh --preset harness-only
+
+  # 全参数非交互
+  /path/to/cyning-harness/wizard/install.sh \
+    --target /path/to/project --preset harness-only --ide cursor,claude,agents
+
+preset（交互向导：1 或 2）:
+  harness-only       — 仅过程轨 + IDE（常用 · kimi-code-meta 等）
+  fullstack-node-py  — 全栈五轨 + quality + pytest（Ink 类）
+  其他 preset 仍可通过 --preset <name> 使用（如 ios-cursor、oss-fork-meta）
+
+选项:
+  --target PATH   业务仓根（未指定时进入引导；在业务仓内可默认当前目录）
+  --preset NAME   见 wizard/profiles/
+  --ide LIST      逗号分隔：cursor,claude,agents（写入 profile tracks）
+  --dry-run       只打印，不写入（profile 仍会写入供 sync plan）
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --target) TARGET="$2"; TARGET_PROVIDED=1; shift 2 ;;
+    --preset) PRESET="$2"; PRESET_PROVIDED=1; shift 2 ;;
+    --ide) IDE_LIST="$2"; IDE_PROVIDED=1; shift 2 ;;
+    --dry-run) DRY_RUN=1; shift ;;
+    -h|--help) usage; exit 0 ;;
+    *) echo "未知参数: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+CYNING_HARNESS="${CYNING_HARNESS:-$HARNESS_ROOT}"
+VERSION="${HARNESS_VERSION:-$(git -C "$HARNESS_ROOT" describe --tags --always 2>/dev/null || echo unknown)}"
+
+# --- 交互：仅补全命令行未提供的项 ---
+if [[ "$TARGET_PROVIDED" -eq 0 ]]; then
+  echo "=== cyning-harness 安装向导 ==="
+  echo "产品包: $HARNESS_ROOT"
+  echo "版本:   $VERSION"
+  echo ""
+  cwd="$(pwd)"
+  default_target=""
+  if ! is_product_root_path "$cwd" "$HARNESS_ROOT"; then
+    default_target="$cwd"
+  fi
+  if [[ -n "$default_target" ]]; then
+    read -r -p "业务仓路径 [$default_target]: " TARGET_INPUT
+    TARGET="${TARGET_INPUT:-$default_target}"
+  else
+    echo "请输入要接入 Harness 的业务仓路径"
+    read -r -p "业务仓路径: " TARGET_INPUT
+    [[ -n "$TARGET_INPUT" ]] || { echo "未输入路径，已取消。" >&2; exit 1; }
+    TARGET="$TARGET_INPUT"
+  fi
+fi
+
+if [[ "$PRESET_PROVIDED" -eq 0 ]]; then
+  if [[ "$TARGET_PROVIDED" -eq 1 ]]; then
+    echo "=== cyning-harness install（补全参数）==="
+  fi
+  print_preset_menu
+  read -r -p "preset [1]: " PRESET_INPUT
+  PRESET="$(resolve_preset_choice "$PRESET_INPUT" "$SCRIPT_DIR/profiles")"
+fi
+
+if [[ "$IDE_PROVIDED" -eq 0 ]]; then
+  if prompt_yes_no "是否配置 IDE 勾选？" "y"; then
+    print_ide_menu
+    read -r -p "IDE [1]: " IDE_INPUT
+    IDE_LIST="$(resolve_ide_choice "${IDE_INPUT:-1}")"
+  fi
+fi
+
+[[ -d "$TARGET" ]] || { echo "错误: 目录不存在: $TARGET" >&2; exit 1; }
+TARGET="$(abs_path "$TARGET")"
+refuse_if_product_root "$TARGET" "$HARNESS_ROOT"
+
+PRESET_FILE="$SCRIPT_DIR/profiles/${PRESET}.json"
+[[ -f "$PRESET_FILE" ]] || { echo "未知 preset: $PRESET" >&2; exit 1; }
+
+run() {
+  if [[ "$DRY_RUN" == "1" ]]; then echo "[dry-run] $*"; else eval "$@"; fi
+}
+
+echo ""
+echo "=== cyning-harness install ==="
+echo "目标: $TARGET"
+echo "preset: $PRESET"
+[[ -n "$IDE_LIST" ]] && echo "ide: $IDE_LIST"
+echo ""
+
+run mkdir -p "$TARGET/.cyning-harness"
+run mkdir -p "$TARGET/docs/tasks/active" "$TARGET/docs/tasks/done" \
+  "$TARGET/docs/tasks/_views" \
+  "$TARGET/docs/tasks/done/harness" "$TARGET/docs/tasks/done/cyning-harness" \
+  "$TARGET/docs/tasks/done/engineering" "$TARGET/docs/tasks/done/governance" \
+  "$TARGET/docs/tasks/done/chatbi" "$TARGET/docs/tasks/done/standards" \
+  "$TARGET/docs/tasks/done/epics"
+run mkdir -p "$TARGET/docs/harness/prompts" "$TARGET/docs/harness/reviews" "$TARGET/docs/harness/invokes/by-task"
+run mkdir -p "$TARGET/docs/_tech_graph" "$TARGET/docs/coding_wiki" "$TARGET/docs/standards"
+
+PROFILE_DST="$TARGET/.cyning-harness/profile.json"
+
+# profile 须真实写入，供 harness-sync plan/apply 读取（含 dry-run）
+mkdir -p "$TARGET/.cyning-harness"
+cp "$PRESET_FILE" "$PROFILE_DST"
+if [[ -n "$IDE_LIST" ]]; then
+  patch_profile_ide "$PROFILE_DST" "$IDE_LIST"
+fi
+
+if [[ "$DRY_RUN" == "1" ]]; then
+  echo "[dry-run] profile: $PROFILE_DST"
+else
+  printf '%s\n' "{\"cyning_harness_root\":\"$CYNING_HARNESS\"}" > "$TARGET/.cyning-harness/local.json"
+fi
+
+# 委托 sync（install 时 force 图谱/wiki）
+export CYNING_HARNESS TARGET FORCE_TRACKS=1
+if [[ "$DRY_RUN" == "1" ]]; then
+  "$SCRIPT_DIR/harness-sync.sh" plan --target "$TARGET"
+else
+  "$SCRIPT_DIR/harness-sync.sh" apply --target "$TARGET"
+  write_manifest_init "$TARGET" "$VERSION" "$PRESET" "$IDE_LIST" "$PROFILE_DST"
+fi
+
+# CI
+CI_MODE="$(grep '"ci"' "$PRESET_FILE" | sed -E 's/.*:[[:space:]]*"([^"]*)".*/\1/' | head -1)"
+if [[ "$CI_MODE" == "both" ]]; then
+  run mkdir -p "$TARGET/.github/workflows"
+  run cp "$CYNING_HARNESS/ci/samples/quality.yml.example" "$TARGET/.github/workflows/quality.yml"
+  run cp "$CYNING_HARNESS/ci/samples/pytest.yml.example" "$TARGET/.github/workflows/pytest.yml"
+fi
+
+# standards L1/L2
+if grep -q '"standards_l1"[[:space:]]*:[[:space:]]*true' "$PRESET_FILE"; then
+  for f in "$CYNING_HARNESS/standards/"TEMPLATE_CODING_BASELINE_L1*.md; do
+    [[ -f "$f" ]] || continue
+    run cp "$f" "$TARGET/docs/standards/"
+  done
+fi
+if grep -q '"standards_l2"[[:space:]]*:[[:space:]]*true' "$PRESET_FILE"; then
+  for f in "$CYNING_HARNESS/standards/"TEMPLATE_CODING_BASELINE_L2*.md; do
+    [[ -f "$f" ]] || continue
+    run cp "$f" "$TARGET/docs/standards/"
+  done
+  for f in "$CYNING_HARNESS/standards/"TEMPLATE_SOURCES*.md; do
+    [[ -f "$f" ]] || continue
+    run cp "$f" "$TARGET/docs/standards/"
+  done
+fi
+
+# done Hub + _views（仅不存在时）
+if [[ ! -f "$TARGET/docs/tasks/done/README.md" ]]; then
+  run cp "$CYNING_HARNESS/harness/templates/TASK_done_README.md" \
+    "$TARGET/docs/tasks/done/README.md"
+fi
+if [[ ! -f "$TARGET/docs/tasks/_views/done.md" ]]; then
+  run cp "$CYNING_HARNESS/harness/templates/VIEW_done_thin_pointer.md" \
+    "$TARGET/docs/tasks/_views/done.md"
+fi
+if [[ ! -f "$TARGET/docs/tasks/_views/done_by_domain.md" ]]; then
+  run cp "$CYNING_HARNESS/harness/templates/VIEW_done_by_domain.md" \
+    "$TARGET/docs/tasks/_views/done_by_domain.md"
+fi
+
+# bootstrap task（仅不存在时）
+if grep -q '"harness_task_bootstrap"[[:space:]]*:[[:space:]]*true' "$PRESET_FILE"; then
+  if [[ ! -f "$TARGET/docs/tasks/active/task_graph_bootstrap.md" ]] && [[ ! -f "$TARGET/docs/tasks/done/task_graph_bootstrap"*.md ]]; then
+    run cp "$CYNING_HARNESS/harness/templates/TASK_graph_bootstrap.md" \
+      "$TARGET/docs/tasks/active/task_graph_bootstrap.md"
+  fi
+fi
+
+echo ""
+echo "安装完成。profile: $PROFILE_DST"
+echo "manifest: $(manifest_file_path "$TARGET")"
+echo "日后升级: npx @cyning/harness upgrade --target $TARGET"
+echo "或维护者: cd $CYNING_HARNESS && ./wizard/upgrade.sh --target $TARGET"
+echo "清空重装: $CYNING_HARNESS/wizard/uninstall.sh --target $TARGET"

package/wizard/lib/common.sh

@@ -0,0 +1,247 @@
+# cyning-harness · wizard 脚本共享函数（source 用，勿直接执行）
+# shellcheck shell=bash
+
+MARKER_BEGIN='<!-- cyning-harness:begin -->'
+MARKER_END='<!-- cyning-harness:end -->'
+
+# 规范化绝对路径
+abs_path() {
+  cd "$1" && pwd
+}
+
+# 判断目标路径是否为产品包根目录
+is_product_root_path() {
+  local target="$1" harness_root="$2"
+  [[ "$(abs_path "$target")" == "$(abs_path "$harness_root")" ]]
+}
+
+# 禁止对产品包自身执行 install/sync（误在 cyning-harness 根目录 apply 时拦截）
+refuse_if_product_root() {
+  local target="$1" harness_root="$2"
+  local target_abs harness_abs
+  target_abs="$(abs_path "$target")"
+  harness_abs="$(abs_path "$harness_root")"
+  if is_product_root_path "$target" "$harness_root"; then
+    echo "错误: 目标路径不能是 cyning-harness 产品包自身: ${harness_abs}" >&2
+    echo "提示: 在业务仓升级；或在产品包目录运行 wizard/upgrade.sh 按提示输入业务仓路径。" >&2
+    exit 1
+  fi
+}
+
+# 更新 profile.json tracks 布尔（无 jq）
+set_json_track_bool() {
+  local file="$1" key="$2" val="$3"
+  local tmp
+  tmp="$(mktemp)"
+  if grep -q "\"$key\"" "$file"; then
+    sed -E "s/\"$key\"[[:space:]]*:[[:space:]]*(true|false)/\"$key\": $val/" "$file" > "$tmp"
+  else
+    sed "/\"ci\"/i\\
+    \"$key\": $val,
+" "$file" > "$tmp"
+  fi
+  mv "$tmp" "$file"
+}
+
+patch_profile_ide() {
+  local profile="$1" ide_list="$2"
+  local want_cursor=false want_claude=false want_agents=false
+
+  IFS=',' read -ra parts <<< "$ide_list"
+  for raw in "${parts[@]}"; do
+    local p="${raw// /}"
+    case "$p" in
+      cursor) want_cursor=true ;;
+      claude) want_claude=true ;;
+      agents) want_agents=true ;;
+      *) echo "未知 IDE: $p（允许: cursor, claude, agents）" >&2; exit 1 ;;
+    esac
+  done
+
+  set_json_track_bool "$profile" ide_cursor "$want_cursor"
+  set_json_track_bool "$profile" ide_claude "$want_claude"
+  set_json_track_bool "$profile" ide_agents "$want_agents"
+}
+
+# 从 profile 读取 preset 名（无 jq）
+profile_preset_name() {
+  local file="$1"
+  grep '"preset"' "$file" | head -1 | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/'
+}
+
+# 从 profile 拼 IDE 勾选展示
+profile_ide_summary() {
+  local file="$1"
+  local parts=()
+  if grep -q '"ide_cursor"[[:space:]]*:[[:space:]]*true' "$file"; then parts+=("cursor"); fi
+  if grep -q '"ide_claude"[[:space:]]*:[[:space:]]*true' "$file"; then parts+=("claude"); fi
+  if grep -q '"ide_agents"[[:space:]]*:[[:space:]]*true' "$file"; then parts+=("agents"); fi
+  if [[ ${#parts[@]} -eq 0 ]]; then
+    echo "（无 IDE 轨启用）"
+  else
+    local IFS=,
+    echo "${parts[*]}"
+  fi
+}
+
+prompt_yes_no() {
+  local prompt="$1" default="${2:-n}"
+  local hint="y/N"
+  if [[ "$default" == "y" ]]; then hint="Y/n"; fi
+  local ans=""
+  read -r -p "$prompt [$hint]: " ans
+  ans="${ans:-$default}"
+  [[ "$ans" =~ ^[yY] ]]
+}
+
+# 安装向导 · preset 代号菜单（交互仅 1/2；CLI --preset 仍可用 profiles 下任意 json）
+print_preset_menu() {
+  cat <<'EOF'
+preset 代号（回车=1）:
+
+  1  harness-only
+     · 仅 Harness 过程轨：prompts、invoke 模板、IDE 入口（Cursor / Claude / Agents）
+     · 不写入图谱 / wiki / standards / CI；不覆盖已有业务 task / reviews / by-task invoke
+     · 适合：kimi-code-meta、任意仓只要 SDD 帽子链与 invoke 纪律
+
+  2  fullstack-node-py
+     · Ink 类全栈五轨：图谱模板 + coding_wiki + L1/L2 规范 + Harness 过程轨 + Cursor
+     · 附带 .github/workflows/quality.yml + pytest.yml（Next 前端 + Python API 后端 CI 样例）
+     · 适合：ai-ink-brain + api-python 同类前后端分仓或 monorepo
+
+  亦可输入全称：harness-only / fullstack-node-py
+EOF
+}
+
+# 将代号或全称解析为 preset 文件名（不含 .json）
+resolve_preset_choice() {
+  local input="$1"
+  local profiles_dir="${2:-}"
+  case "${input:-1}" in
+    1|h|harness|harness-only) echo "harness-only"; return ;;
+    2|fs|full|fullstack|fullstack-node-py) echo "fullstack-node-py"; return ;;
+  esac
+  if [[ -n "$profiles_dir" && -f "$profiles_dir/${input}.json" ]]; then
+    echo "$input"
+    return
+  fi
+  echo "未知 preset 代号: $input（交互可用 1 或 2，或输入全称）" >&2
+  exit 1
+}
+
+# 安装向导 · IDE 代号菜单
+print_ide_menu() {
+  cat <<'EOF'
+IDE 代号（回车=1 全部）:
+  1  全部（cursor + claude + agents）
+  2  仅 cursor
+  3  仅 claude
+  4  仅 agents
+  可组合: 2,3 或 c,cl,a
+EOF
+}
+
+# 将代号解析为 install --ide 逗号列表
+resolve_ide_choice() {
+  local input="${1:-1}"
+  local want_cursor=false want_claude=false want_agents=false
+
+  if [[ -z "$input" || "$input" == "1" || "$input" == "all" ]]; then
+    echo "cursor,claude,agents"
+    return
+  fi
+
+  IFS=',' read -ra parts <<< "$input"
+  for raw in "${parts[@]}"; do
+    local p="${raw// /}"
+    case "$p" in
+      1|all) want_cursor=true; want_claude=true; want_agents=true ;;
+      2|c|cursor) want_cursor=true ;;
+      3|cl|claude) want_claude=true ;;
+      4|a|agents) want_agents=true ;;
+      *) echo "未知 IDE 代号: $p（可用 1–4 或 c/cl/a）" >&2; exit 1 ;;
+    esac
+  done
+
+  local out=()
+  [[ "$want_cursor" == true ]] && out+=("cursor")
+  [[ "$want_claude" == true ]] && out+=("claude")
+  [[ "$want_agents" == true ]] && out+=("agents")
+  if [[ ${#out[@]} -eq 0 ]]; then
+    echo "未选择任何 IDE" >&2
+    exit 1
+  fi
+  local IFS=,
+  echo "${out[*]}"
+}
+
+profile_json_bool() {
+  local file="$1" key="$2"
+  grep -q "\"$key\"[[:space:]]*:[[:space:]]*true" "$file"
+}
+
+profile_track_enabled() {
+  local file="$1" key="$2" default="${3:-false}"
+  if ! grep -q "\"$key\"" "$file"; then
+    [[ "$default" == "true" ]]
+    return
+  fi
+  profile_json_bool "$file" "$key"
+}
+
+profile_ide_cursor_rel() {
+  local file="$1" rel=""
+  if grep -q '"paths"' "$file"; then
+    rel="$(sed -n '/"paths"/,/^  \}/p' "$file" | grep '"ide_cursor"' | head -1 | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/')"
+  fi
+  [[ -z "$rel" ]] && rel=".cursor/rules/06-harness-pointer.mdc"
+  echo "$rel"
+}
+
+# 从 CLAUDE.md / AGENTS.md 剥离 Harness marker 块；若仅剩空文件则删除
+# S5 · sync/apply 前检测 Git 工作区干净（v0.3+）
+# 非 git 仓跳过；--force 或 HARNESS_SYNC_FORCE=1 跳过
+check_git_clean() {
+  local target="$1" force="${2:-0}"
+  if [[ "$force" == "1" || "${HARNESS_SYNC_FORCE:-0}" == "1" ]]; then
+    return 0
+  fi
+  if ! git -C "$target" rev-parse --git-dir >/dev/null 2>&1; then
+    return 0
+  fi
+  if git -C "$target" diff --quiet 2>/dev/null && git -C "$target" diff --cached --quiet 2>/dev/null; then
+    return 0
+  fi
+  echo "错误(S5): Git 工作区不干净，sync apply 已中止。" >&2
+  echo "请先 commit/stash，或使用 --force / HARNESS_SYNC_FORCE=1" >&2
+  git -C "$target" status --short >&2 || true
+  exit 1
+}
+
+remove_harness_marker_file() {
+  local dst="$1"
+  if [[ ! -f "$dst" ]]; then
+    return 0
+  fi
+  if ! grep -qF "$MARKER_BEGIN" "$dst"; then
+    return 0
+  fi
+  local tmp_out
+  tmp_out="$(mktemp)"
+  awk -v begin="$MARKER_BEGIN" -v end="$MARKER_END" '
+    BEGIN { inblock = 0 }
+    index($0, begin) { inblock = 1; next }
+    inblock {
+      if (index($0, end)) inblock = 0
+      next
+    }
+    { print }
+  ' "$dst" > "$tmp_out"
+  if [[ ! -s "$tmp_out" ]]; then
+    rm -f "$dst" "$tmp_out"
+    echo "  已删除（仅剩 Harness 内容）: $dst"
+  else
+    mv "$tmp_out" "$dst"
+    echo "  已剥离 marker 块: $dst"
+  fi
+}