adspecs 0.1.18 → 0.1.20

package/hooks/session-start.js

@@ -1,44 +1,44 @@
-#!/usr/bin/env node
-
-/**
- * SessionStart Hook — 注入 using-adspecs 技能引导内容
- *
- * 在每次会话启动时，读取 using-adspecs/SKILL.md 并输出为
- * Claude Code hook additionalContext，确保 Agent 在任何任务开始前
- * 都知道需要检查并使用 ADSpecs 技能。
- *
- * 机制参考：Superpowers hooks/session-start
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// ── 路径解析 ──────────────────────────────────────────
-// hooks/ 在项目根下，__dirname 总是指向 hooks/ 目录
-const PLUGIN_ROOT = path.join(__dirname, '..');
-const SKILL_PATH = path.join(PLUGIN_ROOT, 'skills', 'using-adspecs', 'SKILL.md');
-
-// ── 读取技能内容 ──────────────────────────────────────
-var skillContent;
-try {
-  skillContent = fs.readFileSync(SKILL_PATH, 'utf8');
-} catch (err) {
-  // 技能文件不存在，静默跳过
-  process.exit(0);
-}
-
-if (!skillContent || skillContent.trim() === '') {
-  process.exit(0);
-}
-
-// ── 输出 Hook Context ─────────────────────────────────
-// Claude Code hook command 输出 JSON 到 stdout，
-// hookSpecificOutput.additionalContext 会被注入到 Agent 上下文
-var output = {
-  hookSpecificOutput: {
-    hookEventName: 'SessionStart',
-    additionalContext: '<EXTREMELY-IMPORTANT>\n' + skillContent + '\n</EXTREMELY-IMPORTANT>'
-  }
-};
-
-process.stdout.write(JSON.stringify(output));
+#!/usr/bin/env node
+
+/**
+ * SessionStart Hook — 注入 using-adspecs 技能引导内容
+ *
+ * 在每次会话启动时，读取 using-adspecs/SKILL.md 并输出为
+ * Claude Code hook additionalContext，确保 Agent 在任何任务开始前
+ * 都知道需要检查并使用 ADSpecs 技能。
+ *
+ * 机制参考：Superpowers hooks/session-start
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ── 路径解析 ──────────────────────────────────────────
+// hooks/ 在项目根下，__dirname 总是指向 hooks/ 目录
+const PLUGIN_ROOT = path.join(__dirname, '..');
+const SKILL_PATH = path.join(PLUGIN_ROOT, 'skills', 'using-adspecs', 'SKILL.md');
+
+// ── 读取技能内容 ──────────────────────────────────────
+var skillContent;
+try {
+  skillContent = fs.readFileSync(SKILL_PATH, 'utf8');
+} catch (err) {
+  // 技能文件不存在，静默跳过
+  process.exit(0);
+}
+
+if (!skillContent || skillContent.trim() === '') {
+  process.exit(0);
+}
+
+// ── 输出 Hook Context ─────────────────────────────────
+// Claude Code hook command 输出 JSON 到 stdout，
+// hookSpecificOutput.additionalContext 会被注入到 Agent 上下文
+var output = {
+  hookSpecificOutput: {
+    hookEventName: 'SessionStart',
+    additionalContext: '<EXTREMELY-IMPORTANT>\n' + skillContent + '\n</EXTREMELY-IMPORTANT>'
+  }
+};
+
+process.stdout.write(JSON.stringify(output));

package/hooks/wiki-queue.js

@@ -1,127 +1,127 @@
-#!/usr/bin/env node
-
-/**
- * Wiki Update Queue — 跨平台 Hook 脚本
- *
- * 在 SessionStart / PostToolUse / Stop 三个 Hook 事件中管理 .wiki-update-queue 队列文件。
- * 使用 Node.js（而非平台特定 Shell）确保 Windows / macOS / Linux 三平台兼容。
- *
- * 用法:
- *   node hooks/wiki-queue.js init      — SessionStart: 创建队列文件
- *   node hooks/wiki-queue.js enqueue   — PostToolUse: 追加变更文件路径到队列
- *   node hooks/wiki-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, '.wiki-update-queue');
-
-// ── 工具函数 ──────────────────────────────────────────
-
-/** 确保 .claude 目录和队列文件存在 */
-function ensureQueueFile() {
-  fs.mkdirSync(QUEUE_DIR, { recursive: true });
-  if (!fs.existsSync(QUEUE_FILE)) {
-    fs.writeFileSync(QUEUE_FILE, '', 'utf8');
-  }
-}
-
-/** 追加文件路径到队列（去重、过滤空行） */
-function appendToQueue(files) {
-  if (!files || (typeof files === 'string' && files.trim() === '')) {
-    return;
-  }
-
-  fs.mkdirSync(QUEUE_DIR, { recursive: true });
-
-  // 标准化：按行拆分，过滤空行
-  const newFiles = files
-    .split(/\r?\n/)
-    .map(function (f) { return f.trim(); })
-    .filter(Boolean);
-
-  if (newFiles.length === 0) {
-    return;
-  }
-
-  // 读取已有队列，去重追加
-  /** @type {Set<string>} */
-  var seen = new Set();
-  if (fs.existsSync(QUEUE_FILE)) {
-    var existing = fs.readFileSync(QUEUE_FILE, 'utf8')
-      .split(/\r?\n/)
-      .map(function (f) { return f.trim(); })
-      .filter(Boolean);
-    existing.forEach(function (f) { seen.add(f); });
-  }
-
-  var appended = 0;
-  newFiles.forEach(function (f) {
-    if (!seen.has(f)) {
-      fs.appendFileSync(QUEUE_FILE, f + '\n', 'utf8');
-      seen.add(f);
-      appended++;
-    }
-  });
-
-  if (appended > 0) {
-    console.log('[wiki-update] ' + appended + ' file(s) added to sync queue.');
-  }
-}
-
-/** 检查队列并在有待处理项时输出提示 */
-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('[wiki-update] ' + count + ' file(s) queued for wiki sync.');
-    console.log('[wiki-update] Run: /wiki-update --mode=incremental --flush');
-  }
-}
-
-// ── 主入口 ────────────────────────────────────────────
-
-var action = process.argv[2];
-
-switch (action) {
-  case 'init':
-    ensureQueueFile();
-    break;
-
-  case 'enqueue':
-    // CLAUDE_TOOL_OUTPUT_FILES 由 Claude Code Hook 运行时注入为环境变量
-    appendToQueue(process.env.CLAUDE_TOOL_OUTPUT_FILES || '');
-    break;
-
-  case 'report':
-    checkAndReport();
-    break;
-
-  default:
-    console.error('[wiki-update] Unknown action: ' + (action || '(none)'));
-    console.error('[wiki-update] Usage: node hooks/wiki-queue.js init|enqueue|report');
-    process.exit(1);
-}
+#!/usr/bin/env node
+
+/**
+ * Wiki Update Queue — 跨平台 Hook 脚本
+ *
+ * 在 SessionStart / PostToolUse / Stop 三个 Hook 事件中管理 .wiki-update-queue 队列文件。
+ * 使用 Node.js（而非平台特定 Shell）确保 Windows / macOS / Linux 三平台兼容。
+ *
+ * 用法:
+ *   node hooks/wiki-queue.js init      — SessionStart: 创建队列文件
+ *   node hooks/wiki-queue.js enqueue   — PostToolUse: 追加变更文件路径到队列
+ *   node hooks/wiki-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, '.wiki-update-queue');
+
+// ── 工具函数 ──────────────────────────────────────────
+
+/** 确保 .claude 目录和队列文件存在 */
+function ensureQueueFile() {
+  fs.mkdirSync(QUEUE_DIR, { recursive: true });
+  if (!fs.existsSync(QUEUE_FILE)) {
+    fs.writeFileSync(QUEUE_FILE, '', 'utf8');
+  }
+}
+
+/** 追加文件路径到队列（去重、过滤空行） */
+function appendToQueue(files) {
+  if (!files || (typeof files === 'string' && files.trim() === '')) {
+    return;
+  }
+
+  fs.mkdirSync(QUEUE_DIR, { recursive: true });
+
+  // 标准化：按行拆分，过滤空行
+  const newFiles = files
+    .split(/\r?\n/)
+    .map(function (f) { return f.trim(); })
+    .filter(Boolean);
+
+  if (newFiles.length === 0) {
+    return;
+  }
+
+  // 读取已有队列，去重追加
+  /** @type {Set<string>} */
+  var seen = new Set();
+  if (fs.existsSync(QUEUE_FILE)) {
+    var existing = fs.readFileSync(QUEUE_FILE, 'utf8')
+      .split(/\r?\n/)
+      .map(function (f) { return f.trim(); })
+      .filter(Boolean);
+    existing.forEach(function (f) { seen.add(f); });
+  }
+
+  var appended = 0;
+  newFiles.forEach(function (f) {
+    if (!seen.has(f)) {
+      fs.appendFileSync(QUEUE_FILE, f + '\n', 'utf8');
+      seen.add(f);
+      appended++;
+    }
+  });
+
+  if (appended > 0) {
+    console.log('[wiki-update] ' + appended + ' file(s) added to sync queue.');
+  }
+}
+
+/** 检查队列并在有待处理项时输出提示 */
+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('[wiki-update] ' + count + ' file(s) queued for wiki sync.');
+    console.log('[wiki-update] Run: /wiki-update --mode=incremental --flush');
+  }
+}
+
+// ── 主入口 ────────────────────────────────────────────
+
+var action = process.argv[2];
+
+switch (action) {
+  case 'init':
+    ensureQueueFile();
+    break;
+
+  case 'enqueue':
+    // CLAUDE_TOOL_OUTPUT_FILES 由 Claude Code Hook 运行时注入为环境变量
+    appendToQueue(process.env.CLAUDE_TOOL_OUTPUT_FILES || '');
+    break;
+
+  case 'report':
+    checkAndReport();
+    break;
+
+  default:
+    console.error('[wiki-update] Unknown action: ' + (action || '(none)'));
+    console.error('[wiki-update] Usage: node hooks/wiki-queue.js init|enqueue|report');
+    process.exit(1);
+}

package/package.json

@@ -1,61 +1,61 @@
-{
-  "name": "adspecs",
-  "version": "0.1.18",
-  "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
-  "bin": {
-    "adspecs": "./bin/adspecs.js"
-  },
-  "main": "./src/utils.js",
-  "files": [
-    "bin/",
-    "src/",
-    ".claude-plugin/",
-    ".qoder-plugin/",
-    ".adspecs/",
-    "skills/",
-    "hooks/",
-    "references/",
-    "scripts/postinstall.js",
-    "scripts/sync-version.js",
-    "CLAUDE.md",
-    "README.md",
-    "INSTALL.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "test": "node --test src/**/*.test.js",
-    "postinstall": "node scripts/postinstall.js",
-    "prepublishOnly": "node scripts/prepublish-check.js",
-    "version": "node scripts/sync-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .qoder-plugin/plugin.json",
-    "sync-version": "node scripts/sync-version.js"
-  },
-  "dependencies": {
-    "commander": "^12.0.0",
-    "@inquirer/prompts": "^7.0.0",
-    "chalk": "^4.1.2"
-  },
-  "devDependencies": {},
-  "keywords": [
-    "adspecs",
-    "claude-code",
-    "plugin",
-    "scaffold",
-    "cli",
-    "project-init",
-    "ai-first"
-  ],
-  "author": "Qingwen Chen <cqinwn@qq.com>",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://gitee.com/yuebon/adspecs.git"
-  },
-  "homepage": "https://gitee.com/yuebon/adspecs#readme",
-  "bugs": {
-    "url": "https://gitee.com/yuebon/adspecs/issues"
-  }
-}
+{
+  "name": "adspecs",
+  "version": "0.1.20",
+  "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
+  "bin": {
+    "adspecs": "./bin/adspecs.js"
+  },
+  "main": "./src/utils.js",
+  "files": [
+    "bin/",
+    "src/",
+    ".claude-plugin/",
+    ".qoder-plugin/",
+    ".adspecs/",
+    "skills/",
+    "hooks/",
+    "references/",
+    "scripts/postinstall.js",
+    "scripts/sync-version.js",
+    "CLAUDE.md",
+    "README.md",
+    "INSTALL.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "node --test src/**/*.test.js",
+    "postinstall": "node scripts/postinstall.js",
+    "prepublishOnly": "node scripts/prepublish-check.js",
+    "version": "node scripts/sync-version.js && git add .claude-plugin/plugin.json .claude-plugin/marketplace.json .qoder-plugin/plugin.json",
+    "sync-version": "node scripts/sync-version.js"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^4.1.2"
+  },
+  "devDependencies": {},
+  "keywords": [
+    "adspecs",
+    "claude-code",
+    "plugin",
+    "scaffold",
+    "cli",
+    "project-init",
+    "ai-first"
+  ],
+  "author": "Qingwen Chen <cqinwn@qq.com>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/yuebon/adspecs.git"
+  },
+  "homepage": "https://gitee.com/yuebon/adspecs#readme",
+  "bugs": {
+    "url": "https://gitee.com/yuebon/adspecs/issues"
+  }
+}