adspecs 0.1.19 → 0.1.21

package/hooks/commit-queue.js

@@ -1,245 +1,245 @@
-#!/usr/bin/env node
-
-/**
- * Commit Queue — 跨平台 Hook 脚本
- *
- * 在 SessionStart / PostToolUse / Stop 三个 Hook 事件中管理 .commit-candidates 队列文件。
- * 当检测到 pipeline-manifest.json 写入（且 status=completed + mvn_compile=pass），
- * 自动将 feature 信息加入提交候选队列，Stop 时提示用户执行提交。
- *
- * 用法:
- *   node hooks/commit-queue.js init      — SessionStart: 创建队列文件
- *   node hooks/commit-queue.js enqueue   — PostToolUse: 检测 manifest 写入并入队
- *   node hooks/commit-queue.js report    — Stop:        检查队列并输出提示
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ── 配置 ──────────────────────────────────────────────
-// 队列文件放在目标项目根目录的 .claude/ 下。
-// 使用 process.cwd() 获取目标项目根目录（Claude Code 运行 hook 时 CWD 即为目标项目）。
-// 注意：不能用 __dirname，因为 __dirname 指向的是插件安装目录，而非用户的目标项目。
-const PROJECT_ROOT = process.cwd();
-const QUEUE_DIR = path.join(PROJECT_ROOT, '.claude');
-const QUEUE_FILE = path.join(QUEUE_DIR, '.commit-candidates');
-
-// ── 工具函数 ──────────────────────────────────────────
-
-/** 确保 .claude 目录和队列文件存在 */
-function ensureQueueFile() {
-  fs.mkdirSync(QUEUE_DIR, { recursive: true });
-  if (!fs.existsSync(QUEUE_FILE)) {
-    fs.writeFileSync(QUEUE_FILE, '', 'utf8');
-  }
-}
-
-/**
- * 解析 pipeline-manifest.json 文件，提取提交候选信息。
- * 返回 null 表示不满足提交条件（未完成或编译未通过）。
- *
- * @param {string} filePath - pipeline-manifest.json 的绝对路径
- * @returns {object|null}
- */
-function parseManifest(filePath) {
-  if (!fs.existsSync(filePath)) {
-    return null;
-  }
-
-  var manifest;
-  try {
-    var raw = fs.readFileSync(filePath, 'utf8');
-    manifest = JSON.parse(raw);
-  } catch (_err) {
-    // JSON 解析失败（文件可能正在写入），跳过
-    return null;
-  }
-
-  // 检查基本完成状态
-  if (!manifest || manifest.status !== 'completed') {
-    return null;
-  }
-
-  // 检查 TDD 验证中编译是否通过
-  var tdd = manifest.tdd_verification;
-  if (!tdd) {
-    // 没有 tdd_verification 字段时，检查是否有其他编译通过标记
-    if (!manifest.mvn_compile || manifest.mvn_compile !== 'pass') {
-      return null;
-    }
-  } else {
-    if (tdd.mvn_compile !== 'pass' && tdd.compile !== 'pass') {
-      return null;
-    }
-  }
-
-  // 提取候选信息
-  var feature = manifest.feature || '';
-  var modulePath = manifest.module_path || '';
-  var specDir = manifest.spec_dir || '';
-
-  // 尝试从文件路径推导 feature 和模块路径
-  if (!feature || !modulePath) {
-    var dirParts = path.dirname(filePath).split(path.sep);
-    // 从 45-specs/{feature}/ 路径推导
-    for (var i = 0; i < dirParts.length; i++) {
-      if (dirParts[i] === '45-specs' && i + 1 < dirParts.length) {
-        feature = feature || dirParts[i + 1];
-        break;
-      }
-    }
-    // 从 {code}-{name}-model-app/ 路径推导模块路径
-    for (var j = 0; j < dirParts.length; j++) {
-      if (dirParts[j].endsWith('-model-app')) {
-        modulePath = modulePath || dirParts.slice(0, j + 1).join(path.sep);
-        break;
-      }
-    }
-  }
-
-  if (!feature) {
-    return null; // 无法推导 feature 名称，跳过
-  }
-
-  return {
-    feature: feature,
-    modulePath: modulePath,
-    specDir: specDir || path.dirname(filePath),
-    manifestPath: filePath,
-    enrolledAt: new Date().toISOString()
-  };
-}
-
-/**
- * 从 CLAUDE_TOOL_OUTPUT_FILES 环境变量中筛选 pipeline-manifest.json 文件，
- * 解析并加入提交候选队列。
- */
-function enqueueFromManifests(files) {
-  if (!files || (typeof files === 'string' && files.trim() === '')) {
-    return;
-  }
-
-  fs.mkdirSync(QUEUE_DIR, { recursive: true });
-
-  var candidatePaths = files
-    .split(/\r?\n/)
-    .map(function (f) { return f.trim(); })
-    .filter(function (f) { return f && f.endsWith('pipeline-manifest.json'); });
-
-  if (candidatePaths.length === 0) {
-    return;
-  }
-
-  // 读取已有队列，按 feature 名称去重
-  /** @type {Set<string>} */
-  var seen = new Set();
-  if (fs.existsSync(QUEUE_FILE)) {
-    var existingLines = fs.readFileSync(QUEUE_FILE, 'utf8')
-      .split(/\r?\n/)
-      .map(function (f) { return f.trim(); })
-      .filter(Boolean);
-    existingLines.forEach(function (f) {
-      try {
-        var entry = JSON.parse(f);
-        if (entry.feature) {
-          seen.add(entry.feature);
-        }
-      } catch (_err) {
-        // 兼容旧格式（非 JSON 行），按原值去重
-        seen.add(f);
-      }
-    });
-  }
-
-  var appended = 0;
-  candidatePaths.forEach(function (filePath) {
-    var candidate = parseManifest(filePath);
-    if (!candidate) {
-      return;
-    }
-
-    // 使用 feature 名称作为去重键
-    var key = candidate.feature;
-    if (seen.has(key)) {
-      return;
-    }
-
-    // 以 JSON 行格式写入队列
-    fs.appendFileSync(QUEUE_FILE, JSON.stringify(candidate) + '\n', 'utf8');
-    seen.add(key);
-    appended++;
-  });
-
-  if (appended > 0) {
-    console.log('[commit-queue] ' + appended + ' feature(s) ready for commit.');
-  }
-}
-
-/** 检查队列并在有待处理项时输出提示 */
-function checkAndReport() {
-  if (!fs.existsSync(QUEUE_FILE)) {
-    return;
-  }
-
-  var content;
-  try {
-    content = fs.readFileSync(QUEUE_FILE, 'utf8').trim();
-  } catch (_err) {
-    return;
-  }
-
-  if (!content) {
-    return;
-  }
-
-  var lines = content.split(/\r?\n/).filter(Boolean);
-  var count = lines.length;
-
-  if (count > 0) {
-    console.log('');
-    console.log('═══ [commit-queue] ═══════════════════════════════════');
-    console.log('[commit-queue] ' + count + ' feature(s) compiled and ready to commit:');
-    console.log('');
-
-    lines.forEach(function (line) {
-      try {
-        var candidate = JSON.parse(line);
-        console.log('  • ' + candidate.feature + (candidate.modulePath ? ' (' + candidate.modulePath + ')' : ''));
-      } catch (_err) {
-        console.log('  • ' + line);
-      }
-    });
-
-    console.log('');
-    console.log('[commit-queue] To commit with worktree isolation:');
-    console.log('[commit-queue]   /ai-softengineer:git-worktree-manager');
-    console.log('[commit-queue] To commit directly (no worktree):');
-    console.log('[commit-queue]   /ai-softengineer:git-commit');
-    console.log('══════════════════════════════════════════════════════');
-    console.log('');
-  }
-}
-
-// ── 主入口 ────────────────────────────────────────────
-
-var action = process.argv[2];
-
-switch (action) {
-  case 'init':
-    ensureQueueFile();
-    break;
-
-  case 'enqueue':
-    // CLAUDE_TOOL_OUTPUT_FILES 由 Claude Code Hook 运行时注入为环境变量
-    enqueueFromManifests(process.env.CLAUDE_TOOL_OUTPUT_FILES || '');
-    break;
-
-  case 'report':
-    checkAndReport();
-    break;
-
-  default:
-    console.error('[commit-queue] Unknown action: ' + (action || '(none)'));
-    console.error('[commit-queue] Usage: node hooks/commit-queue.js init|enqueue|report');
-    process.exit(1);
-}
+#!/usr/bin/env node
+
+/**
+ * Commit Queue — 跨平台 Hook 脚本
+ *
+ * 在 SessionStart / PostToolUse / Stop 三个 Hook 事件中管理 .commit-candidates 队列文件。
+ * 当检测到 pipeline-manifest.json 写入（且 status=completed + mvn_compile=pass），
+ * 自动将 feature 信息加入提交候选队列，Stop 时提示用户执行提交。
+ *
+ * 用法:
+ *   node hooks/commit-queue.js init      — SessionStart: 创建队列文件
+ *   node hooks/commit-queue.js enqueue   — PostToolUse: 检测 manifest 写入并入队
+ *   node hooks/commit-queue.js report    — Stop:        检查队列并输出提示
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ── 配置 ──────────────────────────────────────────────
+// 队列文件放在目标项目根目录的 .claude/ 下。
+// 使用 process.cwd() 获取目标项目根目录（Claude Code 运行 hook 时 CWD 即为目标项目）。
+// 注意：不能用 __dirname，因为 __dirname 指向的是插件安装目录，而非用户的目标项目。
+const PROJECT_ROOT = process.cwd();
+const QUEUE_DIR = path.join(PROJECT_ROOT, '.claude');
+const QUEUE_FILE = path.join(QUEUE_DIR, '.commit-candidates');
+
+// ── 工具函数 ──────────────────────────────────────────
+
+/** 确保 .claude 目录和队列文件存在 */
+function ensureQueueFile() {
+  fs.mkdirSync(QUEUE_DIR, { recursive: true });
+  if (!fs.existsSync(QUEUE_FILE)) {
+    fs.writeFileSync(QUEUE_FILE, '', 'utf8');
+  }
+}
+
+/**
+ * 解析 pipeline-manifest.json 文件，提取提交候选信息。
+ * 返回 null 表示不满足提交条件（未完成或编译未通过）。
+ *
+ * @param {string} filePath - pipeline-manifest.json 的绝对路径
+ * @returns {object|null}
+ */
+function parseManifest(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return null;
+  }
+
+  var manifest;
+  try {
+    var raw = fs.readFileSync(filePath, 'utf8');
+    manifest = JSON.parse(raw);
+  } catch (_err) {
+    // JSON 解析失败（文件可能正在写入），跳过
+    return null;
+  }
+
+  // 检查基本完成状态
+  if (!manifest || manifest.status !== 'completed') {
+    return null;
+  }
+
+  // 检查 TDD 验证中编译是否通过
+  var tdd = manifest.tdd_verification;
+  if (!tdd) {
+    // 没有 tdd_verification 字段时，检查是否有其他编译通过标记
+    if (!manifest.mvn_compile || manifest.mvn_compile !== 'pass') {
+      return null;
+    }
+  } else {
+    if (tdd.mvn_compile !== 'pass' && tdd.compile !== 'pass') {
+      return null;
+    }
+  }
+
+  // 提取候选信息
+  var feature = manifest.feature || '';
+  var modulePath = manifest.module_path || '';
+  var specDir = manifest.spec_dir || '';
+
+  // 尝试从文件路径推导 feature 和模块路径
+  if (!feature || !modulePath) {
+    var dirParts = path.dirname(filePath).split(path.sep);
+    // 从 45-specs/{feature}/ 路径推导
+    for (var i = 0; i < dirParts.length; i++) {
+      if (dirParts[i] === '45-specs' && i + 1 < dirParts.length) {
+        feature = feature || dirParts[i + 1];
+        break;
+      }
+    }
+    // 从 {code}-{name}-model-app/ 路径推导模块路径
+    for (var j = 0; j < dirParts.length; j++) {
+      if (dirParts[j].endsWith('-model-app')) {
+        modulePath = modulePath || dirParts.slice(0, j + 1).join(path.sep);
+        break;
+      }
+    }
+  }
+
+  if (!feature) {
+    return null; // 无法推导 feature 名称，跳过
+  }
+
+  return {
+    feature: feature,
+    modulePath: modulePath,
+    specDir: specDir || path.dirname(filePath),
+    manifestPath: filePath,
+    enrolledAt: new Date().toISOString()
+  };
+}
+
+/**
+ * 从 CLAUDE_TOOL_OUTPUT_FILES 环境变量中筛选 pipeline-manifest.json 文件，
+ * 解析并加入提交候选队列。
+ */
+function enqueueFromManifests(files) {
+  if (!files || (typeof files === 'string' && files.trim() === '')) {
+    return;
+  }
+
+  fs.mkdirSync(QUEUE_DIR, { recursive: true });
+
+  var candidatePaths = files
+    .split(/\r?\n/)
+    .map(function (f) { return f.trim(); })
+    .filter(function (f) { return f && f.endsWith('pipeline-manifest.json'); });
+
+  if (candidatePaths.length === 0) {
+    return;
+  }
+
+  // 读取已有队列，按 feature 名称去重
+  /** @type {Set<string>} */
+  var seen = new Set();
+  if (fs.existsSync(QUEUE_FILE)) {
+    var existingLines = fs.readFileSync(QUEUE_FILE, 'utf8')
+      .split(/\r?\n/)
+      .map(function (f) { return f.trim(); })
+      .filter(Boolean);
+    existingLines.forEach(function (f) {
+      try {
+        var entry = JSON.parse(f);
+        if (entry.feature) {
+          seen.add(entry.feature);
+        }
+      } catch (_err) {
+        // 兼容旧格式（非 JSON 行），按原值去重
+        seen.add(f);
+      }
+    });
+  }
+
+  var appended = 0;
+  candidatePaths.forEach(function (filePath) {
+    var candidate = parseManifest(filePath);
+    if (!candidate) {
+      return;
+    }
+
+    // 使用 feature 名称作为去重键
+    var key = candidate.feature;
+    if (seen.has(key)) {
+      return;
+    }
+
+    // 以 JSON 行格式写入队列
+    fs.appendFileSync(QUEUE_FILE, JSON.stringify(candidate) + '\n', 'utf8');
+    seen.add(key);
+    appended++;
+  });
+
+  if (appended > 0) {
+    console.log('[commit-queue] ' + appended + ' feature(s) ready for commit.');
+  }
+}
+
+/** 检查队列并在有待处理项时输出提示 */
+function checkAndReport() {
+  if (!fs.existsSync(QUEUE_FILE)) {
+    return;
+  }
+
+  var content;
+  try {
+    content = fs.readFileSync(QUEUE_FILE, 'utf8').trim();
+  } catch (_err) {
+    return;
+  }
+
+  if (!content) {
+    return;
+  }
+
+  var lines = content.split(/\r?\n/).filter(Boolean);
+  var count = lines.length;
+
+  if (count > 0) {
+    console.log('');
+    console.log('═══ [commit-queue] ═══════════════════════════════════');
+    console.log('[commit-queue] ' + count + ' feature(s) compiled and ready to commit:');
+    console.log('');
+
+    lines.forEach(function (line) {
+      try {
+        var candidate = JSON.parse(line);
+        console.log('  • ' + candidate.feature + (candidate.modulePath ? ' (' + candidate.modulePath + ')' : ''));
+      } catch (_err) {
+        console.log('  • ' + line);
+      }
+    });
+
+    console.log('');
+    console.log('[commit-queue] To commit with worktree isolation:');
+    console.log('[commit-queue]   /ai-softengineer:git-worktree-manager');
+    console.log('[commit-queue] To commit directly (no worktree):');
+    console.log('[commit-queue]   /ai-softengineer:git-commit');
+    console.log('══════════════════════════════════════════════════════');
+    console.log('');
+  }
+}
+
+// ── 主入口 ────────────────────────────────────────────
+
+var action = process.argv[2];
+
+switch (action) {
+  case 'init':
+    ensureQueueFile();
+    break;
+
+  case 'enqueue':
+    // CLAUDE_TOOL_OUTPUT_FILES 由 Claude Code Hook 运行时注入为环境变量
+    enqueueFromManifests(process.env.CLAUDE_TOOL_OUTPUT_FILES || '');
+    break;
+
+  case 'report':
+    checkAndReport();
+    break;
+
+  default:
+    console.error('[commit-queue] Unknown action: ' + (action || '(none)'));
+    console.error('[commit-queue] Usage: node hooks/commit-queue.js init|enqueue|report');
+    process.exit(1);
+}

package/hooks/hooks.json

@@ -1,63 +1,63 @@
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.js"
-          },
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js init"
-          },
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js init"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [],
-    "PostToolUse": [
-      {
-        "matcher": "Write|Edit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js enqueue"
-          }
-        ],
-        "conditions": {
-          "filePattern": "\\.(java|py|ts|js|go|rs|cs|md)$"
-        }
-      },
-      {
-        "matcher": "Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js enqueue"
-          }
-        ],
-        "conditions": {
-          "filePattern": "pipeline-manifest\\.json$"
-        }
-      }
-    ],
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js report"
-          },
-          {
-            "type": "command",
-            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js report"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.js"
+          },
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js init"
+          },
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js init"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js enqueue"
+          }
+        ],
+        "conditions": {
+          "filePattern": "\\.(java|py|ts|js|go|rs|cs|md)$"
+        }
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js enqueue"
+          }
+        ],
+        "conditions": {
+          "filePattern": "pipeline-manifest\\.json$"
+        }
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/wiki-queue.js report"
+          },
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/commit-queue.js report"
+          }
+        ]
+      }
+    ]
+  }
+}