adspecs 0.1.19 → 0.1.21

package/src/lib/dir-utils.js

@@ -1,133 +1,161 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * 目录检测工具
- *
- * 提供目录存在性、内容状态检测能力，支撑冲突决策和模式升级检测。
- */
-
-/**
- * 检查目录是否包含任何实际文件（递归，遇到第一个文件即返回 true）
- *
- * @param {string} dirPath - 目录绝对路径
- * @returns {boolean} 目录存在且包含至少一个文件
- */
-function hasAnyFile(dirPath) {
-  if (!fs.existsSync(dirPath)) return false;
-
-  let stat;
-  try {
-    stat = fs.statSync(dirPath);
-  } catch {
-    return false;
-  }
-  if (!stat.isDirectory()) return false;
-
-  let entries;
-  try {
-    entries = fs.readdirSync(dirPath, { withFileTypes: true });
-  } catch {
-    return false;
-  }
-
-  for (const entry of entries) {
-    const fullPath = path.join(dirPath, entry.name);
-    if (entry.isFile()) {
-      return true;
-    }
-    if (entry.isDirectory() && hasAnyFile(fullPath)) {
-      return true;
-    }
-  }
-
-  return false;
-}
-
-/**
- * 检查目录是否"仅有空子目录"（没有任何文件）
- *
- * 用于检测简易模式产物特征：40-project_conventions/ 下仅有空子目录结构
- * （frontend-standard/、end-standard/），没有实际文件。
- *
- * @param {string} dirPath - 目录绝对路径
- * @returns {boolean} 目录存在且所有子项都是空目录（即无任何文件）
- */
-function isEmptyDirectoryTree(dirPath) {
-  if (!fs.existsSync(dirPath)) return false;
-
-  let stat;
-  try {
-    stat = fs.statSync(dirPath);
-  } catch {
-    return false;
-  }
-  if (!stat.isDirectory()) return false;
-
-  // 如果有任何文件 → 不是空目录树
-  return !hasAnyFile(dirPath);
-}
-
-/**
- * 统计目录下的实际文件数量
- *
- * @param {string} dirPath - 目录绝对路径
- * @returns {number} 文件总数
- */
-function countFiles(dirPath) {
-  if (!fs.existsSync(dirPath)) return 0;
-
-  let stat;
-  try {
-    stat = fs.statSync(dirPath);
-  } catch {
-    return 0;
-  }
-  if (!stat.isDirectory()) return 0;
-
-  let count = 0;
-  let entries;
-  try {
-    entries = fs.readdirSync(dirPath, { withFileTypes: true });
-  } catch {
-    return 0;
-  }
-
-  for (const entry of entries) {
-    const fullPath = path.join(dirPath, entry.name);
-    if (entry.isFile()) {
-      count++;
-    } else if (entry.isDirectory()) {
-      count += countFiles(fullPath);
-    }
-  }
-  return count;
-}
-
-/**
- * 列出目录下的所有子目录名（不递归）
- *
- * @param {string} dirPath - 目录绝对路径
- * @returns {string[]} 子目录名列表
- */
-function listSubdirs(dirPath) {
-  if (!fs.existsSync(dirPath)) return [];
-
-  let entries;
-  try {
-    entries = fs.readdirSync(dirPath, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-
-  return entries.filter((e) => e.isDirectory()).map((e) => e.name);
-}
-
-module.exports = {
-  hasAnyFile,
-  isEmptyDirectoryTree,
-  countFiles,
-  listSubdirs,
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 目录检测工具
+ *
+ * 提供目录存在性、内容状态检测能力，支撑冲突决策和模式升级检测。
+ */
+
+/**
+ * 检查目录是否包含任何实际文件（递归，遇到第一个文件即返回 true）
+ *
+ * @param {string} dirPath - 目录绝对路径
+ * @returns {boolean} 目录存在且包含至少一个文件
+ */
+function hasAnyFile(dirPath) {
+  if (!fs.existsSync(dirPath)) return false;
+
+  let stat;
+  try {
+    stat = fs.statSync(dirPath);
+  } catch {
+    return false;
+  }
+  if (!stat.isDirectory()) return false;
+
+  let entries;
+  try {
+    entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  } catch {
+    return false;
+  }
+
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    if (entry.isFile()) {
+      return true;
+    }
+    if (entry.isDirectory() && hasAnyFile(fullPath)) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+/**
+ * 检查目录是否"仅有空子目录"（没有任何文件）
+ *
+ * 用于检测简易模式产物特征：40-project_conventions/ 下仅有空子目录结构
+ * （frontend-standard/、end-standard/），没有实际文件。
+ *
+ * @param {string} dirPath - 目录绝对路径
+ * @returns {boolean} 目录存在且所有子项都是空目录（即无任何文件）
+ */
+function isEmptyDirectoryTree(dirPath) {
+  if (!fs.existsSync(dirPath)) return false;
+
+  let stat;
+  try {
+    stat = fs.statSync(dirPath);
+  } catch {
+    return false;
+  }
+  if (!stat.isDirectory()) return false;
+
+  // 如果有任何文件 → 不是空目录树
+  return !hasAnyFile(dirPath);
+}
+
+/**
+ * 统计目录下的实际文件数量
+ *
+ * @param {string} dirPath - 目录绝对路径
+ * @returns {number} 文件总数
+ */
+function countFiles(dirPath) {
+  if (!fs.existsSync(dirPath)) return 0;
+
+  let stat;
+  try {
+    stat = fs.statSync(dirPath);
+  } catch {
+    return 0;
+  }
+  if (!stat.isDirectory()) return 0;
+
+  let count = 0;
+  let entries;
+  try {
+    entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  } catch {
+    return 0;
+  }
+
+  for (const entry of entries) {
+    const fullPath = path.join(dirPath, entry.name);
+    if (entry.isFile()) {
+      count++;
+    } else if (entry.isDirectory()) {
+      count += countFiles(fullPath);
+    }
+  }
+  return count;
+}
+
+/**
+ * 列出目录下的所有子目录名（不递归）
+ *
+ * @param {string} dirPath - 目录绝对路径
+ * @returns {string[]} 子目录名列表
+ */
+function listSubdirs(dirPath) {
+  if (!fs.existsSync(dirPath)) return [];
+
+  let entries;
+  try {
+    entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+
+  return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+}
+
+/**
+ * 列出目录下的所有文件名（不递归）
+ *
+ * @param {string} dirPath - 目录绝对路径
+ * @returns {string[]} 文件名列表
+ */
+function listFiles(dirPath) {
+  if (!fs.existsSync(dirPath)) return [];
+
+  let stat;
+  try {
+    stat = fs.statSync(dirPath);
+  } catch {
+    return [];
+  }
+  if (!stat.isDirectory()) return [];
+
+  let entries;
+  try {
+    entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+
+  return entries.filter((e) => e.isFile()).map((e) => e.name);
+}
+
+module.exports = {
+  hasAnyFile,
+  isEmptyDirectoryTree,
+  countFiles,
+  listSubdirs,
+  listFiles,
+};

package/src/lib/json-merge.js

@@ -1,114 +1,114 @@
-'use strict';
-
-const fs = require('fs');
-
-/**
- * JSON 属性补全工具
- *
- * 用于 feature.json / project.json 等配置文件的合并：
- * - 已有文件中缺失的 key → 从 references 补充（使用 references 的默认值）
- * - 已有文件中已存在的 key → 保留已有值，不覆盖
- * - 已有文件中额外的自定义 key → 保留，不删除
- */
-
-/**
- * 合并两个 JSON 对象的顶层属性
- *
- * @param {object} existing - 目标项目中的已有内容
- * @param {object} reference - 插件 references 中的初始模板
- * @returns {{ merged: object, addedKeys: string[] }} 合并后的对象 + 被补全的 key 列表
- */
-function mergeProperties(existing, reference) {
-  const merged = { ...existing };
-  const addedKeys = [];
-
-  for (const key of Object.keys(reference)) {
-    if (!(key in merged)) {
-      merged[key] = reference[key];
-      addedKeys.push(key);
-    }
-  }
-
-  return { merged, addedKeys };
-}
-
-/**
- * 读取并合并 JSON 文件
- *
- * @param {string} targetPath - 目标项目中的 JSON 文件路径
- * @param {string} referencePath - 插件 references 中的 JSON 文件路径
- * @returns {{ merged: object, addedKeys: string[], created: boolean }} 合并结果
- */
-function mergeJsonFile(targetPath, referencePath) {
-  const reference = JSON.parse(fs.readFileSync(referencePath, 'utf8'));
-
-  if (!fs.existsSync(targetPath)) {
-    // 文件不存在，直接用 references 内容创建
-    fs.mkdirSync(require('path').dirname(targetPath), { recursive: true });
-    fs.writeFileSync(targetPath, JSON.stringify(reference, null, 2) + '\n', 'utf8');
-    return { merged: reference, addedKeys: Object.keys(reference), created: true };
-  }
-
-  const existing = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
-  const { merged, addedKeys } = mergeProperties(existing, reference);
-
-  if (addedKeys.length > 0) {
-    fs.writeFileSync(targetPath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
-  }
-
-  return { merged, addedKeys, created: false };
-}
-
-/**
- * 合并 project.json 字段（特殊处理：已有字段用新值更新，缺失字段补默认值）
- *
- * 与 feature.json 的合并规则不同：
- * - project.json 中 project_name / company_name 等字段 → 用本次收集的最新值更新
- * - 已有文件中额外的自定义属性 → 保留不删除
- * - references 中有但已有文件中缺失的属性 → 补充默认值
- *
- * @param {string} targetPath - .adspecs/project.json 路径
- * @param {object} newValues - 本次收集的项目信息
- * @param {string} referencePath - 插件 references 中的 project.json 路径
- */
-function mergeProjectJson(targetPath, newValues, referencePath) {
-  const reference = JSON.parse(fs.readFileSync(referencePath, 'utf8'));
-  let existing = {};
-
-  if (fs.existsSync(targetPath)) {
-    existing = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
-  }
-
-  // 1. 从 references 补充缺失的属性（使用默认值）
-  const merged = { ...reference };
-
-  // 2. 已有文件中额外的自定义属性 → 保留
-  for (const key of Object.keys(existing)) {
-    if (!(key in merged)) {
-      merged[key] = existing[key];
-    }
-  }
-
-  // 3. 本次收集的最新值覆盖（仅限已知字段）
-  for (const [key, value] of Object.entries(newValues)) {
-    if (value !== undefined && value !== null) {
-      merged[key] = value;
-    }
-  }
-
-  // 4. 添加创建时间
-  if (!merged.created_at) {
-    merged.created_at = new Date().toISOString().slice(0, 10);
-  }
-
-  fs.mkdirSync(require('path').dirname(targetPath), { recursive: true });
-  fs.writeFileSync(targetPath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
-
-  return merged;
-}
-
-module.exports = {
-  mergeProperties,
-  mergeJsonFile,
-  mergeProjectJson,
-};
+'use strict';
+
+const fs = require('fs');
+
+/**
+ * JSON 属性补全工具
+ *
+ * 用于 feature.json / project.json 等配置文件的合并：
+ * - 已有文件中缺失的 key → 从 references 补充（使用 references 的默认值）
+ * - 已有文件中已存在的 key → 保留已有值，不覆盖
+ * - 已有文件中额外的自定义 key → 保留，不删除
+ */
+
+/**
+ * 合并两个 JSON 对象的顶层属性
+ *
+ * @param {object} existing - 目标项目中的已有内容
+ * @param {object} reference - 插件 references 中的初始模板
+ * @returns {{ merged: object, addedKeys: string[] }} 合并后的对象 + 被补全的 key 列表
+ */
+function mergeProperties(existing, reference) {
+  const merged = { ...existing };
+  const addedKeys = [];
+
+  for (const key of Object.keys(reference)) {
+    if (!(key in merged)) {
+      merged[key] = reference[key];
+      addedKeys.push(key);
+    }
+  }
+
+  return { merged, addedKeys };
+}
+
+/**
+ * 读取并合并 JSON 文件
+ *
+ * @param {string} targetPath - 目标项目中的 JSON 文件路径
+ * @param {string} referencePath - 插件 references 中的 JSON 文件路径
+ * @returns {{ merged: object, addedKeys: string[], created: boolean }} 合并结果
+ */
+function mergeJsonFile(targetPath, referencePath) {
+  const reference = JSON.parse(fs.readFileSync(referencePath, 'utf8'));
+
+  if (!fs.existsSync(targetPath)) {
+    // 文件不存在，直接用 references 内容创建
+    fs.mkdirSync(require('path').dirname(targetPath), { recursive: true });
+    fs.writeFileSync(targetPath, JSON.stringify(reference, null, 2) + '\n', 'utf8');
+    return { merged: reference, addedKeys: Object.keys(reference), created: true };
+  }
+
+  const existing = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
+  const { merged, addedKeys } = mergeProperties(existing, reference);
+
+  if (addedKeys.length > 0) {
+    fs.writeFileSync(targetPath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+  }
+
+  return { merged, addedKeys, created: false };
+}
+
+/**
+ * 合并 project.json 字段（特殊处理：已有字段用新值更新，缺失字段补默认值）
+ *
+ * 与 feature.json 的合并规则不同：
+ * - project.json 中 project_name / company_name 等字段 → 用本次收集的最新值更新
+ * - 已有文件中额外的自定义属性 → 保留不删除
+ * - references 中有但已有文件中缺失的属性 → 补充默认值
+ *
+ * @param {string} targetPath - .adspecs/project.json 路径
+ * @param {object} newValues - 本次收集的项目信息
+ * @param {string} referencePath - 插件 references 中的 project.json 路径
+ */
+function mergeProjectJson(targetPath, newValues, referencePath) {
+  const reference = JSON.parse(fs.readFileSync(referencePath, 'utf8'));
+  let existing = {};
+
+  if (fs.existsSync(targetPath)) {
+    existing = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
+  }
+
+  // 1. 从 references 补充缺失的属性（使用默认值）
+  const merged = { ...reference };
+
+  // 2. 已有文件中额外的自定义属性 → 保留
+  for (const key of Object.keys(existing)) {
+    if (!(key in merged)) {
+      merged[key] = existing[key];
+    }
+  }
+
+  // 3. 本次收集的最新值覆盖（仅限已知字段）
+  for (const [key, value] of Object.entries(newValues)) {
+    if (value !== undefined && value !== null) {
+      merged[key] = value;
+    }
+  }
+
+  // 4. 添加创建时间
+  if (!merged.created_at) {
+    merged.created_at = new Date().toISOString().slice(0, 10);
+  }
+
+  fs.mkdirSync(require('path').dirname(targetPath), { recursive: true });
+  fs.writeFileSync(targetPath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+
+  return merged;
+}
+
+module.exports = {
+  mergeProperties,
+  mergeJsonFile,
+  mergeProjectJson,
+};

package/src/lib/paths-defaults.js

@@ -1,37 +1,37 @@
-'use strict';
-
-/**
- * .adspecs/paths.json 默认配置
- *
- * 各技能读取 paths.json 时，对缺失的 key 使用这些默认值。
- * 与各技能 SKILL.md 中的硬编码默认值保持一致。
- */
-
-const DEFAULT_PATHS = {
-  biz_analysis_dir: 'docs/00-customer-requirements',
-  architecture_dir: 'docs/10-architecture',
-  research_output_dir: 'docs/02-prd',
-  sow_dir: 'docs/05-sow',
-  prd_dir: 'docs/20-prd',
-  design_dir: 'docs/30-system-design',
-  test_report_dir: 'docs/80-development',
-  export_dir: 'docs/90-export',
-  wiki_dir: 'wiki',
-};
-
-/**
- * 生成 paths.json 内容
- * @returns {object} 完整的 paths.json 对象
- */
-function generatePathsConfig() {
-  return {
-    $schema: 'adspecs plugin path configuration',
-    version: 1,
-    paths: { ...DEFAULT_PATHS },
-  };
-}
-
-module.exports = {
-  DEFAULT_PATHS,
-  generatePathsConfig,
-};
+'use strict';
+
+/**
+ * .adspecs/paths.json 默认配置
+ *
+ * 各技能读取 paths.json 时，对缺失的 key 使用这些默认值。
+ * 与各技能 SKILL.md 中的硬编码默认值保持一致。
+ */
+
+const DEFAULT_PATHS = {
+  biz_analysis_dir: 'docs/00-customer-requirements',
+  architecture_dir: 'docs/10-architecture',
+  research_output_dir: 'docs/02-prd',
+  sow_dir: 'docs/05-sow',
+  prd_dir: 'docs/20-prd',
+  design_dir: 'docs/30-system-design',
+  test_report_dir: 'docs/80-development',
+  export_dir: 'docs/90-export',
+  wiki_dir: 'wiki',
+};
+
+/**
+ * 生成 paths.json 内容
+ * @returns {object} 完整的 paths.json 对象
+ */
+function generatePathsConfig() {
+  return {
+    $schema: 'adspecs plugin path configuration',
+    version: 1,
+    paths: { ...DEFAULT_PATHS },
+  };
+}
+
+module.exports = {
+  DEFAULT_PATHS,
+  generatePathsConfig,
+};