kld-sdd 2.6.7 → 2.6.8

package/skywalk-sdd/ontology/list-changes.cjs

@@ -0,0 +1,110 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const modules = require('./modules.cjs');
+const { readProposalFrontmatter } = require('./naming-diagnose.cjs');
+
+function listActiveChanges(projectRoot) {
+  const changesDir = path.join(projectRoot, 'openspec', 'changes');
+  if (!fs.existsSync(changesDir)) return [];
+
+  return fs.readdirSync(changesDir)
+    .filter((name) => {
+      if (name === 'archive' || name.startsWith('.')) return false;
+      const full = path.join(changesDir, name);
+      return fs.statSync(full).isDirectory();
+    })
+    .sort();
+}
+
+function describeChange(projectRoot, changeName, registry) {
+  const changeDir = path.join(projectRoot, 'openspec', 'changes', changeName);
+  const proposal = readProposalFrontmatter(changeDir);
+  const fm = proposal.ok ? proposal.frontmatter : {};
+  const moduleCode = (fm.module || '').toLowerCase();
+  const title = fm.title || '';
+  const changeKey = (fm['change-key'] || '').toLowerCase() || changeName;
+  const affected = Array.isArray(fm['affected-modules']) ? fm['affected-modules'] : [];
+  const legacy = !fm.module && !fm.title && !fm['change-key'];
+
+  let groupCode = 'uncategorized';
+  let groupName = '未分类';
+  if (!legacy && moduleCode) {
+    groupCode = moduleCode;
+    groupName = modules.getModuleName(registry, moduleCode) || moduleCode;
+  }
+
+  return {
+    changeKey,
+    directory: changeName,
+    title: title || changeName,
+    module: moduleCode || null,
+    affectedModules: affected,
+    changeId: fm['change-id'] || null,
+    legacy,
+    groupCode,
+    groupName,
+    hasProposal: proposal.ok,
+  };
+}
+
+function groupChanges(projectRoot) {
+  const registry = modules.loadModulesYaml(projectRoot);
+  const names = listActiveChanges(projectRoot);
+  const items = names.map((name) => describeChange(projectRoot, name, registry.ok ? registry : null));
+
+  const groups = new Map();
+  for (const item of items) {
+    if (!groups.has(item.groupCode)) {
+      groups.set(item.groupCode, {
+        code: item.groupCode,
+        name: item.groupName,
+        changes: [],
+      });
+    }
+    groups.get(item.groupCode).changes.push(item);
+  }
+
+  const ordered = [];
+  if (registry.ok) {
+    for (const code of Object.keys(registry.modules)) {
+      if (groups.has(code)) ordered.push(groups.get(code));
+    }
+  }
+  for (const [code, group] of groups.entries()) {
+    if (!ordered.find((item) => item.code === code)) {
+      ordered.push(group);
+    }
+  }
+
+  return {
+    registryOk: registry.ok,
+    modulesPath: registry.path || path.join(projectRoot, 'modules.yaml'),
+    groups: ordered,
+    changes: items,
+  };
+}
+
+function formatGroupedText(result) {
+  const lines = [];
+  for (const group of result.groups) {
+    lines.push(`${group.name} (${group.code})`);
+    for (const change of group.changes) {
+      lines.push(`  ● ${change.title}`);
+      lines.push(`    ${change.changeKey}`);
+      if (change.module === 'cross' && change.affectedModules.length) {
+        lines.push(`    affected: ${change.affectedModules.join(', ')}`);
+      }
+    }
+    lines.push('');
+  }
+  return lines.join('\n').trimEnd();
+}
+
+module.exports = {
+  listActiveChanges,
+  describeChange,
+  groupChanges,
+  formatGroupedText,
+};

package/skywalk-sdd/ontology/modules.cjs

@@ -0,0 +1,167 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { MODULE_CODE_REGEX, RESERVED_CROSS } = require('./change-key.cjs');
+
+const CODES = {
+  MISSING: 'MODULES_YAML_MISSING',
+  FORMAT_INVALID: 'MODULES_YAML_FORMAT_INVALID',
+  MODULE_INVALID: 'MODULES_CODE_INVALID',
+};
+
+/**
+ * Minimal parser for modules.yaml constrained schema:
+ *
+ * version: 1
+ * modules:
+ *   fi:
+ *     name: 财务核算
+ */
+function parseModulesYaml(text) {
+  const lines = String(text || '').split(/\r?\n/);
+  const modules = {};
+  let version = null;
+  let inModules = false;
+  let currentCode = null;
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const raw = lines[index];
+    const line = raw.replace(/#.*$/, '').replace(/\s+$/, '');
+    if (!line.trim()) continue;
+
+    const versionMatch = /^version:\s*(\d+)\s*$/.exec(line);
+    if (versionMatch) {
+      version = Number(versionMatch[1]);
+      inModules = false;
+      currentCode = null;
+      continue;
+    }
+
+    if (/^modules:\s*$/.test(line)) {
+      inModules = true;
+      currentCode = null;
+      continue;
+    }
+
+    if (!inModules) {
+      continue;
+    }
+
+    const moduleMatch = /^ {2}([a-z][a-z0-9]{0,7}):\s*$/.exec(line);
+    if (moduleMatch) {
+      currentCode = moduleMatch[1];
+      modules[currentCode] = { name: '' };
+      continue;
+    }
+
+    const nameMatch = /^ {4}name:\s*(.+?)\s*$/.exec(line);
+    if (nameMatch && currentCode) {
+      let name = nameMatch[1].trim();
+      if (
+        (name.startsWith('"') && name.endsWith('"')) ||
+        (name.startsWith("'") && name.endsWith("'"))
+      ) {
+        name = name.slice(1, -1);
+      }
+      modules[currentCode].name = name;
+      continue;
+    }
+
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `modules.yaml 第 ${index + 1} 行无法解析: ${raw}`,
+    };
+  }
+
+  if (version == null) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: 'modules.yaml 缺少 version',
+    };
+  }
+  if (version !== 1) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `不支持的 modules.yaml version: ${version}`,
+    };
+  }
+  if (Object.keys(modules).length === 0) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: 'modules.yaml 未声明任何模块',
+    };
+  }
+
+  for (const [code, meta] of Object.entries(modules)) {
+    if (!MODULE_CODE_REGEX.test(code)) {
+      return {
+        ok: false,
+        code: CODES.MODULE_INVALID,
+        message: `模块代号不合规: ${code}`,
+      };
+    }
+    if (!meta.name) {
+      return {
+        ok: false,
+        code: CODES.FORMAT_INVALID,
+        message: `模块 ${code} 缺少 name`,
+      };
+    }
+  }
+
+  if (!modules[RESERVED_CROSS]) {
+    modules[RESERVED_CROSS] = { name: '跨模块' };
+  }
+
+  return {
+    ok: true,
+    version,
+    modules,
+    codes: new Set(Object.keys(modules)),
+  };
+}
+
+function loadModulesYaml(projectRoot) {
+  const filePath = path.join(projectRoot, 'modules.yaml');
+  if (!fs.existsSync(filePath)) {
+    return {
+      ok: false,
+      code: CODES.MISSING,
+      message: `modules.yaml 不存在: ${filePath}`,
+      path: filePath,
+    };
+  }
+  const text = fs.readFileSync(filePath, 'utf8');
+  const parsed = parseModulesYaml(text);
+  if (!parsed.ok) {
+    return { ...parsed, path: filePath };
+  }
+  return {
+    ...parsed,
+    path: filePath,
+  };
+}
+
+function getModuleName(registry, code) {
+  if (!registry || !registry.modules) return null;
+  const meta = registry.modules[String(code || '').toLowerCase()];
+  return meta ? meta.name : null;
+}
+
+function hasModule(registry, code) {
+  if (!registry || !registry.codes) return false;
+  return registry.codes.has(String(code || '').toLowerCase());
+}
+
+module.exports = {
+  CODES,
+  parseModulesYaml,
+  loadModulesYaml,
+  getModuleName,
+  hasModule,
+};