@cyning/harness 0.4.0 → 1.0.0

package/wizard/gate-check.sh

@@ -4,6 +4,8 @@ set -euo pipefail
 
 TARGET="${TARGET:-$(pwd)}"
 TASK_FILE=""
+GRAPH_MODE=0
+JSON_MODE=0
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
 while [[ $# -gt 0 ]]; do
@@ -13,8 +15,10 @@ while [[ $# -gt 0 ]]; do
       TASK_FILE="$2"
       shift 2
       ;;
+    --graph) GRAPH_MODE=1; shift ;;
+    --json) JSON_MODE=1; shift ;;
     -h|--help)
-      echo "用法: gate-check.sh [--target /path/to/repo] [--task docs/tasks/active/task_*.md]"
+      echo "用法: gate-check.sh [--target /path/to/repo] [--task docs/tasks/active/task_*.md] [--graph] [--json]"
       exit 0
     ;;
     *) echo "未知参数: $1" >&2; exit 1 ;;
@@ -24,7 +28,7 @@ done
 gate_status() {
   local file="$1" gate="$2"
   awk -F'|' -v g="$gate" '
-    index($0, g) > 0 {
+    $0 ~ /^[[:space:]]*\|/ && index($0, g) > 0 {
       gsub(/^[[:space:]]+|[[:space:]]+$/, "", $3)
       gsub(/\*/, "", $3)
       print $3
@@ -36,7 +40,7 @@ gate_status() {
 gate_blocks() {
   local file="$1" gate="$2"
   awk -F'|' -v g="$gate" '
-    index($0, g) > 0 {
+    $0 ~ /^[[:space:]]*\|/ && index($0, g) > 0 {
       gsub(/^[[:space:]]+|[[:space:]]+$/, "", $4)
       gsub(/\*/, "", $4)
       print $4
@@ -82,28 +86,144 @@ check_one_task() {
   return "$blocked"
 }
 
-echo "=== Harness gate-check ==="
-echo "目标: $TARGET"
-
-MANIFEST_FILE="$TARGET/.cyning-harness/manifest.json"
-if [[ -f "$MANIFEST_FILE" ]]; then
-  mf_version="$(grep -o '"version"[[:space:]]*:[[:space:]]*"[^"]*"' "$MANIFEST_FILE" | head -1 | sed -E 's/.*"([^"]+)"$/\1/')"
-  mf_preset="$(grep -o '"preset"[[:space:]]*:[[:space:]]*"[^"]*"' "$MANIFEST_FILE" | head -1 | sed -E 's/.*"([^"]+)"$/\1/')"
-  echo "manifest.version: ${mf_version:-?}"
-  echo "manifest.preset: ${mf_preset:-?}"
-  if [[ -n "${CYNING_HARNESS:-}" && -f "$CYNING_HARNESS/package.json" ]]; then
-    pkg_version="$(grep '"version"' "$CYNING_HARNESS/package.json" | head -1 | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/')"
-    if [[ -n "$pkg_version" && -n "$mf_version" && "$mf_version" != "$pkg_version" ]]; then
-      echo "提示: manifest 版本 ($mf_version) 与产品包 ($pkg_version) 不一致 · 可运行 upgrade"
+# D3 · Inform 图谱闸：输出模块/流程文件 + 审核状态摘要
+graph_for_task() {
+  local tf="$1"
+  local graph_status
+  graph_status="$(gate_status "$tf" HG-GRAPH-MODULES)"
+  local tech_graph_dir="$TARGET/docs/_tech_graph"
+
+  local files=()
+  if [[ -d "$tech_graph_dir" ]]; then
+    while IFS= read -r -d '' f; do
+      files+=("$f")
+    done < <(find "$tech_graph_dir" -maxdepth 2 -type f -print0 2>/dev/null)
+  fi
+
+  if [[ "$JSON_MODE" == "1" ]]; then
+    printf '{"task":"%s","hg_graph_modules":"%s","tech_graph_dir":"%s","files":[' "$(basename "$tf")" "${graph_status:-unknown}" "$tech_graph_dir"
+    local first=1
+    if [[ ${#files[@]} -gt 0 ]]; then
+      for f in "${files[@]}"; do
+        [[ "$first" == "1" ]] || printf ','
+        first=0
+        local name status
+        name="$(basename "$f")"
+        status="$(file_audit_status "$f")"
+        printf '{"name":"%s","status":"%s"}' "$name" "$status"
+      done
     fi
+    printf ']}'
+    return 0
   fi
-else
-  echo "manifest: (未接入 · 无 $MANIFEST_FILE)"
+
+  echo "=== Harness gate-check --graph ==="
+  echo "task: $(basename "$tf")"
+  echo "HG-GRAPH-MODULES: ${graph_status:-未声明}"
+  echo ""
+
+  if [[ ${#files[@]} -eq 0 ]]; then
+    printf 'WARN: 未找到 %s（docs-only task 友好：warn 不 fail）\n' "$tech_graph_dir"
+    echo ""
+    return 0
+  fi
+
+  echo "| 模块/流程文件 | 审核状态 |"
+  echo "|-------------|----------|"
+  for f in "${files[@]}"; do
+    printf "| %s | %s |\n" "$(basename "$f")" "$(file_audit_status "$f")"
+  done
+  echo ""
+}
+
+file_audit_status() {
+  local f="$1"
+  local name
+  name="$(basename "$f")"
+  # 文件名或内容含 approved / rejected / pending 即视为状态摘要
+  if [[ "$name" == *approved* ]] || grep -iq 'status.*approved\|状态.*approved' "$f" 2>/dev/null; then
+    echo "approved"
+  elif [[ "$name" == *rejected* ]] || grep -iq 'status.*rejected\|状态.*rejected' "$f" 2>/dev/null; then
+    echo "rejected"
+  elif [[ "$name" == *pending* ]] || grep -iq 'status.*pending\|状态.*pending' "$f" 2>/dev/null; then
+    echo "pending"
+  else
+    echo "unknown"
+  fi
+}
+
+if [[ "$JSON_MODE" != "1" ]]; then
+  echo "=== Harness gate-check ==="
+  echo "目标: $TARGET"
+
+  MANIFEST_FILE="$TARGET/.cyning-harness/manifest.json"
+  if [[ -f "$MANIFEST_FILE" ]]; then
+    mf_version="$(grep -o '"version"[[:space:]]*:[[:space:]]*"[^"]*"' "$MANIFEST_FILE" | head -1 | sed -E 's/.*"([^"]+)"$/\1/')"
+    mf_preset="$(grep -o '"preset"[[:space:]]*:[[:space:]]*"[^"]*"' "$MANIFEST_FILE" | head -1 | sed -E 's/.*"([^"]+)"$/\1/')"
+    echo "manifest.version: ${mf_version:-?}"
+    echo "manifest.preset: ${mf_preset:-?}"
+    if [[ -n "${CYNING_HARNESS:-}" && -f "$CYNING_HARNESS/package.json" ]]; then
+      pkg_version="$(grep '"version"' "$CYNING_HARNESS/package.json" | head -1 | sed -E 's/.*:[[:space:]]*"([^"]+)".*/\1/')"
+      if [[ -n "$pkg_version" && -n "$mf_version" && "$mf_version" != "$pkg_version" ]]; then
+        echo "提示: manifest 版本 ($mf_version) 与产品包 ($pkg_version) 不一致 · 可运行 upgrade"
+      fi
+    fi
+  else
+    echo "manifest: (未接入 · 无 $MANIFEST_FILE)"
+  fi
+  echo ""
 fi
-echo ""
 
 BLOCKED=0
 
+if [[ "$GRAPH_MODE" == "1" ]]; then
+  if [[ "$JSON_MODE" == "1" ]]; then
+    printf '['
+  fi
+  local_first=1
+  if [[ -n "$TASK_FILE" ]]; then
+    if [[ "$TASK_FILE" != /* ]]; then
+      TASK_FILE="$TARGET/$TASK_FILE"
+    fi
+    if [[ ! -f "$TASK_FILE" ]]; then
+      echo "错误: 未找到 --task 文件 $TASK_FILE" >&2
+      exit 1
+    fi
+    graph_for_task "$TASK_FILE"
+  else
+    ACTIVE_DIR="$TARGET/docs/tasks/active"
+    if [[ ! -d "$ACTIVE_DIR" ]]; then
+      if [[ "$JSON_MODE" == "1" ]]; then
+        printf ']\n'
+      else
+        echo "⚠️  无 $ACTIVE_DIR" >&2
+      fi
+      exit 0
+    fi
+    TASK_FILES=("$ACTIVE_DIR"/task_*.md)
+    if [[ ! -e "${TASK_FILES[0]}" ]]; then
+      if [[ "$JSON_MODE" == "1" ]]; then
+        printf ']\n'
+      else
+        echo "无 active task_*.md"
+      fi
+      exit 0
+    fi
+    for tf in "$ACTIVE_DIR"/task_*.md; do
+      [[ -f "$tf" ]] || continue
+      if [[ "$JSON_MODE" == "1" ]]; then
+        [[ "$local_first" == "1" ]] || printf ','
+        local_first=0
+      fi
+      graph_for_task "$tf"
+    done
+  fi
+  if [[ "$JSON_MODE" == "1" ]]; then
+    printf ']\n'
+  fi
+  exit 0
+fi
+
 if [[ -n "$TASK_FILE" ]]; then
   if [[ "$TASK_FILE" != /* ]]; then
     TASK_FILE="$TARGET/$TASK_FILE"

package/wizard/harness-sync.sh

@@ -23,6 +23,8 @@ usage() {
 
   "$CYNING_HARNESS/wizard/harness-sync.sh" apply
 
+  "$CYNING_HARNESS/wizard/harness-sync.sh" --index --target /path/to/project
+
 或：
 
   "$CYNING_HARNESS/wizard/harness-sync.sh" plan --target /path/to/project
@@ -31,14 +33,16 @@ usage() {
 
 依赖：业务仓已有 .cyning-harness/profile.json（由 install.sh 生成）
 
-plan  — 仅打印将复制的文件
-apply — 执行复制（S5：git 仓须工作区干净，或 --force）
+plan   — 仅打印将复制的文件
+apply  — 执行复制（S5：git 仓须工作区干净，或 --force）
+--index — 生成 .cyning-harness/invoke_index.json（只读聚合 invokes/by-task，不覆盖 S2 域）
 EOF
 }
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
     plan|apply) MODE="$1"; shift ;;
+    --index) MODE="index"; shift ;;
     --target) TARGET="$2"; shift 2 ;;
     --force) SYNC_FORCE=1; shift ;;
     -h|--help) usage; exit 0 ;;
@@ -46,12 +50,21 @@ while [[ $# -gt 0 ]]; do
   esac
 done
 
-[[ "$MODE" == "plan" || "$MODE" == "apply" ]] || { usage; exit 1; }
+[[ "$MODE" == "plan" || "$MODE" == "apply" || "$MODE" == "index" ]] || { usage; exit 1; }
 
 CYNING_HARNESS="${CYNING_HARNESS:-$HARNESS_ROOT}"
 refuse_if_product_root "$TARGET" "$HARNESS_ROOT"
 PROFILE_FILE="$TARGET/.cyning-harness/profile.json"
 
+if [[ "$MODE" == "index" ]]; then
+  if [[ ! -d "$TARGET" ]]; then
+    echo "错误: 目标目录不存在 $TARGET" >&2
+    exit 1
+  fi
+  node "$SCRIPT_DIR/lib/generate-invoke-index.js" "$TARGET"
+  exit 0
+fi
+
 if [[ ! -f "$PROFILE_FILE" ]]; then
   echo "错误: 未找到 $PROFILE_FILE" >&2
   echo "请先运行: $CYNING_HARNESS/wizard/install.sh --target $TARGET --preset <name>" >&2

package/wizard/lib/generate-invoke-index.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+// 生成 .cyning-harness/invoke_index.json（harness-sync --index 的 JSON 引擎）
+import fs from 'node:fs';
+import path from 'node:path';
+
+const target = process.argv[2];
+if (!target) {
+  console.error('用法: node generate-invoke-index.js /path/to/target-repo');
+  process.exit(1);
+}
+
+const byTaskDir = path.join(target, 'docs/harness/invokes/by-task');
+const indexFile = path.join(target, '.cyning-harness/invoke_index.json');
+
+function extractHatId(filename) {
+  // invoke_YYYYMMDD_<hat_id>_*.md 或 invoke_YYYYMMDD_<hat_id>.md
+  const base = path.basename(filename, '.md');
+  const parts = base.split('_');
+  if (parts.length >= 3 && parts[0] === 'invoke') {
+    return parts[2];
+  }
+  return 'unknown';
+}
+
+const index = {
+  schema_version: '1',
+  generated_at: new Date().toISOString(),
+  index: {},
+};
+
+if (fs.existsSync(byTaskDir)) {
+  for (const entry of fs.readdirSync(byTaskDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const slug = entry.name;
+    const slugDir = path.join(byTaskDir, slug);
+    const invokes = [];
+
+    for (const file of fs.readdirSync(slugDir)) {
+      if (!file.startsWith('invoke_') || !file.endsWith('.md')) continue;
+      const full = path.join(slugDir, file);
+      const stat = fs.statSync(full);
+      invokes.push({
+        path: path.relative(target, full).replace(/\\/g, '/'),
+        mtime: Math.floor(stat.mtimeMs / 1000),
+        hat_id: extractHatId(file),
+      });
+    }
+
+    invokes.sort((a, b) => a.path.localeCompare(b.path));
+
+    index.index[slug] = {
+      task_slug: slug,
+      invokes,
+    };
+  }
+}
+
+fs.mkdirSync(path.dirname(indexFile), { recursive: true });
+fs.writeFileSync(indexFile, JSON.stringify(index, null, 2) + '\n');
+console.log(`invoke_index: ${indexFile}`);