adspecs 0.1.30 → 0.1.31

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "adspecs",
       "description": "AI Coding研发协同开发插件",
-      "version": "0.1.30",
+      "version": "0.1.31",
       "source": "./",
       "author": {
         "name": "Qingwen Chen",

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "adspecs",
   "displayName": "adspecs AI Plugin",
   "description": "AI first工程规范驱动开发插件",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "author": {
     "name": "Qingwen Chen",
     "email": "cqinwn@qq.com",

package/.qoder-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "adspecs",
   "displayName": "adspecs AI 工程规范驱动开发插件",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
   "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
   "author": {

package/.workbuddy-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "adspecs",
   "displayName": "adspecs AI 工程规范驱动开发插件",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "AI-first specification-driven development plugin for ECP platform full-lifecycle development",
   "descriptionZh": "AI优先的工程规范驱动开发插件，覆盖需求分析、PRD、系统设计、任务拆解、TDD、代码评审、Wiki同步全流程",
   "author": {

package/bin/adspecs.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 'use strict';
 
 const { Command } = require('commander');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adspecs",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "AI first 工程规范驱动开发插件 — 支持 npm 安装和 CLI 初始化",
   "bin": {
     "adspecs": "bin/adspecs.js"

package/scripts/postinstall.js

@@ -137,6 +137,22 @@ try {
     } catch {
       // codebuddy plugin list 失败 → 静默跳过
     }
+  } else {
+    // 5. WorkBuddy — 无 codebuddy CLI 时的回退方案
+    // 手工注册：创建 marketplace 目录 → junction 链接 → known_marketplaces.json → enabledPlugins
+    try {
+      var wkHome = path.join(require('os').homedir(), '.workbuddy');
+      if (fs.existsSync(wkHome)) {
+        var utilsPath = path.join(installDir, 'src', 'utils');
+        var { registerWorkBuddyPlugin } = require(utilsPath);
+        var wbResult = registerWorkBuddyPlugin(installDir, 'adspecs');
+        if (wbResult.success) {
+          refreshedPlatforms.push('WorkBuddy');
+        }
+      }
+    } catch {
+      // 注册失败 → 静默跳过（非 WorkBuddy 用户无需处理）
+    }
   }
 
   // 输出一行提示（仅当有平台被刷新）

package/src/commands/plugin.js

@@ -147,34 +147,23 @@ async function installForWorkBuddy(pluginName, scope) {
       }
     }
   } else {
-    // 方式 B：回退为手工配置 enabledPlugins（无 CLI 时）
+    // 方式 B：回退为手工配置（无 CLI 时）
+    // 完整注册：创建 marketplace 目录 → junction 链接 → known_marketplaces.json → enabledPlugins
     console.log(chalk.yellow('   ⚠ 未检测到 codebuddy CLI，使用手工配置方式'));
-    const workbuddyHome = path.join(os.homedir(), '.workbuddy');
-    const settingsPath = path.join(workbuddyHome, 'settings.json');
-
-    // 确保 .workbuddy 目录存在
-    fs.mkdirSync(workbuddyHome, { recursive: true });
+    console.log('');
 
-    // 读取或创建 settings.json
-    let settings = {};
-    if (fs.existsSync(settingsPath)) {
-      try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (_e) { /* use default */ }
-    }
-    if (!settings.enabledPlugins) settings.enabledPlugins = {};
+    const { registerWorkBuddyPlugin } = require('../utils');
+    const result = registerWorkBuddyPlugin(PLUGIN_DIR, pluginName);
 
-    var registryKey;
-    if (scope === 'project') {
-      registryKey = `${pluginName}@${PLUGIN_DIR.replace(/\\/g, '/')}`;
+    if (result.success) {
+      console.log(chalk.green('   ✅ 已完成 WorkBuddy 插件注册'));
+      console.log(chalk.gray('   📁 插件目录:'));
+      console.log(chalk.gray(`      ${PLUGIN_DIR}`));
+      console.log(chalk.gray('   📁 marketplace:'));
+      console.log(chalk.gray(`      ~/.workbuddy/plugins/marketplaces/local/`));
     } else {
-      registryKey = `${pluginName}@local`;
+      throw new Error(`WorkBuddy 插件注册失败: ${result.reason}`);
     }
-
-    settings.enabledPlugins[registryKey] = true;
-
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
-    console.log(chalk.green(`   ✅ 已在 settings.json 中启用插件 (${registryKey})`));
-    console.log(chalk.gray('   📁 请确保 WorkBuddy 可访问以下目录:'));
-    console.log(chalk.gray(`      ${PLUGIN_DIR}`));
     console.log(chalk.gray('   请重启 WorkBuddy 使 skills 与 hooks 生效。'));
   }
 }
@@ -345,23 +334,7 @@ async function installQoderProject(pluginName, qoderManifest) {
   }
 }
 
-/**
- * 递归复制目录（排除指定目录名）
- */
-function copyDirRecursive(src, dest, excludeDirs) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    if (excludeDirs && excludeDirs.includes(entry.name)) continue;
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDirRecursive(srcPath, destPath, excludeDirs);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
+const { copyDirRecursive } = require('../utils');
 
 /**
  * Qoder 用户级卸载 — 移除链接 + 注册表条目 + 启用配置
@@ -530,13 +503,31 @@ async function uninstallWorkBuddy(pluginName, scope) {
       }
     }
   } else {
-    // 回退：手工清除 enabledPlugins 条目
-    const settingsPath = path.join(os.homedir(), '.workbuddy', 'settings.json');
+    // 回退：手工清除 marketplace 注册 + junction 链接 + enabledPlugins 条目
+    const workbuddyHome = path.join(os.homedir(), '.workbuddy');
+    const localMarketplaceDir = path.join(workbuddyHome, 'plugins', 'marketplaces', 'local');
+    const pluginLinkPath = path.join(localMarketplaceDir, pluginName);
+    const settingsPath = path.join(workbuddyHome, 'settings.json');
+    const knownMarketplacesPath = path.join(workbuddyHome, 'plugins', 'known_marketplaces.json');
+
+    let cleaned = false;
+
+    // 1. 移除 junction / 目录
+    if (fs.existsSync(pluginLinkPath)) {
+      try {
+        fs.rmSync(pluginLinkPath, { recursive: true, force: true });
+        console.log(chalk.green('   ✅ 已移除插件链接'));
+        cleaned = true;
+      } catch (err) {
+        console.log(chalk.yellow(`   ⚠ 移除插件链接失败: ${err.message}`));
+      }
+    }
+
+    // 2. 从 settings.json 移除
     if (fs.existsSync(settingsPath)) {
       let settings = {};
       try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (_e) { /* use default */ }
       if (settings.enabledPlugins) {
-        // 移除所有 adspecs 相关条目
         const keysBefore = Object.keys(settings.enabledPlugins).length;
         for (var key in settings.enabledPlugins) {
           if (key.startsWith(pluginName + '@')) {
@@ -546,12 +537,29 @@ async function uninstallWorkBuddy(pluginName, scope) {
         const keysAfter = Object.keys(settings.enabledPlugins).length;
         if (keysBefore > keysAfter) {
           fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
-          console.log(chalk.green(`   ✅ 已从 settings.json 移除插件配置`));
+          console.log(chalk.green('   ✅ 已从 settings.json 移除插件配置'));
+          cleaned = true;
         } else {
-          console.log(chalk.yellow(`   ⏭ 未在 settings.json 中找到插件配置`));
+          console.log(chalk.yellow('   ⏭ 未在 settings.json 中找到插件配置'));
         }
       }
     }
+
+    // 3. 从 known_marketplaces.json 移除 local marketplace
+    if (fs.existsSync(knownMarketplacesPath)) {
+      let knownMarketplaces = {};
+      try { knownMarketplaces = JSON.parse(fs.readFileSync(knownMarketplacesPath, 'utf8')); } catch (_e) { /* use default */ }
+      if (knownMarketplaces.local) {
+        delete knownMarketplaces.local;
+        fs.writeFileSync(knownMarketplacesPath, JSON.stringify(knownMarketplaces, null, 4) + '\n', 'utf8');
+        console.log(chalk.green('   ✅ 已从 known_marketplaces.json 移除 local marketplace'));
+        cleaned = true;
+      }
+    }
+
+    if (!cleaned) {
+      console.log(chalk.yellow('   ⏭ 未找到需要清理的插件配置'));
+    }
   }
   console.log(chalk.gray('   请重启 WorkBuddy 使变更生效。'));
 }

package/src/commands/update.js

@@ -83,8 +83,8 @@ module.exports = async function update(options) {
   console.log('');
   console.log('   🔄 插件注册刷新：');
   console.log('      Claude Code  — postinstall 钩子已自动刷新命令行插件注册');
-  console.log('      Qoder        — 通过 .qoder-plugin/ 清单自动发现，无需手动刷新');
-  console.log('      WorkBuddy    — 通过 .workbuddy-plugin/ 清单自动发现，无需手动刷新');
+  console.log('      Qoder / CodeBuddy / WorkBuddy — postinstall 钩子已自动刷新插件注册');
+  console.log('      如未自动刷新，请执行 adspecs plugin install --platform <platform>');
   console.log('');
   console.log(`   验证: ${chalk.gray('adspecs --version')}`);
   console.log('');

package/src/utils.js

@@ -9,6 +9,7 @@
 
 const path = require('path');
 const fs = require('fs');
+const os = require('os');
 
 /**
  * 获取插件根目录（即 adspecs/ 目录）
@@ -70,6 +71,119 @@ function safeWriteJson(filePath, data) {
   fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8');
 }
 
+/**
+ * 递归复制目录（排除指定目录名）
+ * @param {string} src
+ * @param {string} dest
+ * @param {string[]} excludeDirs
+ */
+function copyDirRecursive(src, dest, excludeDirs) {
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (excludeDirs && excludeDirs.includes(entry.name)) continue;
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath, excludeDirs);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * 注册 WorkBuddy 本地插件 marketplace
+ *
+ * 手工方式完成完整注册，无需 codebuddy CLI：
+ *   1. 创建 ~/.workbuddy/plugins/marketplaces/local/ 目录
+ *   2. 创建 junction 链接（或回退复制）指向插件目录
+ *   3. 在 known_marketplaces.json 中注册 local marketplace
+ *   4. 在 settings.json 的 enabledPlugins 中启用插件
+ *
+ * @param {string} pluginDir - adspecs 插件根目录
+ * @param {string} [pluginName='adspecs'] - 插件名称
+ * @returns {{success: boolean, reason?: string}}
+ */
+function registerWorkBuddyPlugin(pluginDir, pluginName) {
+  pluginName = pluginName || 'adspecs';
+
+  const workbuddyHome = path.join(os.homedir(), '.workbuddy');
+
+  // 检查 WorkBuddy 配置目录是否存在
+  if (!fs.existsSync(workbuddyHome)) {
+    return { success: false, reason: '未检测到 WorkBuddy 配置目录 (~/.workbuddy)' };
+  }
+
+  const localMarketplaceDir = path.join(workbuddyHome, 'plugins', 'marketplaces', 'local');
+  const pluginLinkPath = path.join(localMarketplaceDir, pluginName);
+  const settingsPath = path.join(workbuddyHome, 'settings.json');
+  const knownMarketplacesPath = path.join(workbuddyHome, 'plugins', 'known_marketplaces.json');
+
+  try {
+    // 1. 创建 local marketplace 目录
+    fs.mkdirSync(localMarketplaceDir, { recursive: true });
+
+    // 2. 创建 junction / symlink（已存在则先移除重建）
+    if (fs.existsSync(pluginLinkPath)) {
+      try { fs.rmSync(pluginLinkPath, { recursive: true, force: true }); } catch (_err) {
+        try { fs.unlinkSync(pluginLinkPath); } catch (_e) { /* ignore */ }
+      }
+    }
+    try {
+      fs.symlinkSync(pluginDir, pluginLinkPath, 'junction');
+    } catch (_symlinkErr) {
+      // junction 创建失败 → 回退为复制关键目录
+      fs.mkdirSync(pluginLinkPath, { recursive: true });
+      const entriesToCopy = ['.workbuddy-plugin', 'skills', 'hooks', 'references', 'commands'];
+      for (const entry of entriesToCopy) {
+        const srcPath = path.join(pluginDir, entry);
+        if (!fs.existsSync(srcPath)) continue;
+        const destPath = path.join(pluginLinkPath, entry);
+        if (fs.lstatSync(srcPath).isDirectory()) {
+          copyDirRecursive(srcPath, destPath, ['node_modules']);
+        } else {
+          fs.copyFileSync(srcPath, destPath);
+        }
+      }
+      // 同步复制根目录关键文件
+      for (const file of ['package.json', 'CLAUDE.md', 'README.md']) {
+        const srcFile = path.join(pluginDir, file);
+        if (fs.existsSync(srcFile)) {
+          fs.copyFileSync(srcFile, path.join(pluginLinkPath, file));
+        }
+      }
+    }
+
+    // 3. 注册 local marketplace
+    let knownMarketplaces = safeReadJson(knownMarketplacesPath, {});
+    const now = new Date().toISOString();
+
+    knownMarketplaces.local = {
+      type: 'directory',
+      source: {
+        source: 'directory',
+        path: localMarketplaceDir
+      },
+      installLocation: localMarketplaceDir,
+      autoUpdate: false,
+      description: 'Local plugins',
+      lastUpdated: now
+    };
+    safeWriteJson(knownMarketplacesPath, knownMarketplaces);
+
+    // 4. 启用插件
+    let settings = safeReadJson(settingsPath, {});
+    if (!settings.enabledPlugins) settings.enabledPlugins = {};
+    settings.enabledPlugins[`${pluginName}@local`] = true;
+    safeWriteJson(settingsPath, settings);
+
+    return { success: true };
+  } catch (err) {
+    return { success: false, reason: err.message };
+  }
+}
+
 module.exports = {
   getPluginDir,
   getPkg,
@@ -77,4 +191,6 @@ module.exports = {
   isInsidePlugin,
   safeReadJson,
   safeWriteJson,
+  copyDirRecursive,
+  registerWorkBuddyPlugin,
 };