kld-sdd 2.6.7 → 2.6.9

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

@@ -0,0 +1,297 @@
+'use strict';
+
+/**
+ * sdd.config.yaml —— spec 仓库根目录的活动变更登记表。
+ *
+ * 唯一职责：让所有已接入代码仓（经 sdd.specPath 读到同一份 spec clone）
+ * 拿到当前活动 change 的 key / 中文标题 / 摘要，供 AI 参考，
+ * 并供 commit-msg Hook 写入 Spec-Change Trailer（可多条）。
+ *
+ * 不承载：代码仓清单、路径 glob、CI 配置、本地绝对路径。
+ */
+
+const fs = require('fs');
+const path = require('path');
+const changeKey = require('./change-key.cjs');
+
+const FILE_NAME = 'sdd.config.yaml';
+
+const CODES = {
+  MISSING: 'SDD_CONFIG_MISSING',
+  FORMAT_INVALID: 'SDD_CONFIG_FORMAT_INVALID',
+  CHANGE_KEY_INVALID: 'SDD_CONFIG_CHANGE_KEY_INVALID',
+};
+
+const FIELD_ALIASES = {
+  'change-key': 'changeKey',
+  'change-id': 'changeId',
+  title: 'title',
+  module: 'module',
+  summary: 'summary',
+};
+
+function stripQuotes(value) {
+  const text = String(value == null ? '' : value).trim();
+  if (
+    (text.startsWith('"') && text.endsWith('"') && text.length >= 2) ||
+    (text.startsWith("'") && text.endsWith("'") && text.length >= 2)
+  ) {
+    return text.slice(1, -1);
+  }
+  return text;
+}
+
+function needsQuotes(value) {
+  return /^[\s]|[:#]|[\s]$/.test(value);
+}
+
+function quoteIfNeeded(value) {
+  const text = String(value == null ? '' : value);
+  if (!text) return '""';
+  if (needsQuotes(text)) return `"${text.replace(/"/g, '\\"')}"`;
+  return text;
+}
+
+/**
+ * Minimal parser for the constrained schema:
+ *
+ * version: 1
+ * active_changes:
+ *   - change-key: fi-260727-account-doc-head-create
+ *     change-id: CHG-FI-260727-ACCOUNT-DOC-HEAD-CREATE
+ *     title: 会计凭证头创建
+ *     module: fi
+ *     summary: 支持凭证头创建与校验
+ */
+function parseSddConfigYaml(text) {
+  const lines = String(text || '').split(/\r?\n/);
+  const activeChanges = [];
+  let version = null;
+  let inActive = false;
+  let current = 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]);
+      inActive = false;
+      current = null;
+      continue;
+    }
+
+    if (/^active_changes:\s*(\[\s*\])?\s*$/.test(line)) {
+      inActive = true;
+      current = null;
+      continue;
+    }
+
+    if (!inActive) {
+      return {
+        ok: false,
+        code: CODES.FORMAT_INVALID,
+        message: `${FILE_NAME} 第 ${index + 1} 行无法解析: ${raw}`,
+      };
+    }
+
+    const itemMatch = /^ {2}-\s+([a-z-]+):\s*(.*)$/.exec(line);
+    if (itemMatch) {
+      const field = FIELD_ALIASES[itemMatch[1]];
+      if (!field) {
+        return {
+          ok: false,
+          code: CODES.FORMAT_INVALID,
+          message: `${FILE_NAME} 第 ${index + 1} 行存在未知字段: ${itemMatch[1]}`,
+        };
+      }
+      current = {};
+      current[field] = stripQuotes(itemMatch[2]);
+      activeChanges.push(current);
+      continue;
+    }
+
+    const fieldMatch = /^ {4}([a-z-]+):\s*(.*)$/.exec(line);
+    if (fieldMatch && current) {
+      const field = FIELD_ALIASES[fieldMatch[1]];
+      if (!field) {
+        return {
+          ok: false,
+          code: CODES.FORMAT_INVALID,
+          message: `${FILE_NAME} 第 ${index + 1} 行存在未知字段: ${fieldMatch[1]}`,
+        };
+      }
+      current[field] = stripQuotes(fieldMatch[2]);
+      continue;
+    }
+
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `${FILE_NAME} 第 ${index + 1} 行无法解析: ${raw}`,
+    };
+  }
+
+  if (version == null) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `${FILE_NAME} 缺少 version`,
+    };
+  }
+  if (version !== 1) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `不支持的 ${FILE_NAME} version: ${version}`,
+    };
+  }
+
+  for (const entry of activeChanges) {
+    if (!entry.changeKey) {
+      return {
+        ok: false,
+        code: CODES.FORMAT_INVALID,
+        message: `${FILE_NAME} 存在缺少 change-key 的条目`,
+      };
+    }
+    const validated = changeKey.validate(entry.changeKey);
+    if (!validated.ok) {
+      return {
+        ok: false,
+        code: CODES.CHANGE_KEY_INVALID,
+        message: `${FILE_NAME} change-key 不合规: ${validated.message}`,
+      };
+    }
+    entry.changeKey = validated.normalized;
+  }
+
+  return { ok: true, version, activeChanges };
+}
+
+function configPath(specRoot) {
+  return path.join(specRoot, FILE_NAME);
+}
+
+function loadSddConfig(specRoot) {
+  const filePath = configPath(specRoot);
+  if (!fs.existsSync(filePath)) {
+    return {
+      ok: false,
+      code: CODES.MISSING,
+      message: `${FILE_NAME} 不存在: ${filePath}`,
+      path: filePath,
+      activeChanges: [],
+    };
+  }
+  const parsed = parseSddConfigYaml(fs.readFileSync(filePath, 'utf8'));
+  return { ...parsed, path: filePath, activeChanges: parsed.activeChanges || [] };
+}
+
+function serializeSddConfig(activeChanges) {
+  const header = [
+    '# 活动变更登记表（spec 仓库根目录）',
+    '# 由 opsx-propose 隐式写入、opsx-archive 隐式移除，供代码仓 AI 与 commit-msg Hook 读取。',
+    '# 不登记代码仓清单、路径 glob 或 CI 配置。',
+    'version: 1',
+    '',
+    'active_changes:',
+  ];
+  if (!activeChanges || activeChanges.length === 0) {
+    return `${header.join('\n')}\n`;
+  }
+  const body = [];
+  for (const entry of activeChanges) {
+    body.push(`  - change-key: ${entry.changeKey}`);
+    if (entry.changeId) body.push(`    change-id: ${entry.changeId}`);
+    if (entry.title) body.push(`    title: ${quoteIfNeeded(entry.title)}`);
+    if (entry.module) body.push(`    module: ${entry.module}`);
+    if (entry.summary) body.push(`    summary: ${quoteIfNeeded(entry.summary)}`);
+  }
+  return `${header.concat(body).join('\n')}\n`;
+}
+
+function writeSddConfig(specRoot, activeChanges) {
+  const filePath = configPath(specRoot);
+  fs.writeFileSync(filePath, serializeSddConfig(activeChanges), 'utf8');
+  return { ok: true, path: filePath, count: activeChanges.length };
+}
+
+/**
+ * Upsert one active change (idempotent by change-key).
+ */
+function registerActiveChange(specRoot, entry) {
+  const validated = changeKey.validate(entry && entry.changeKey);
+  if (!validated.ok) {
+    return { ok: false, code: CODES.CHANGE_KEY_INVALID, message: validated.message };
+  }
+  const key = validated.normalized;
+
+  const existing = loadSddConfig(specRoot);
+  if (!existing.ok && existing.code !== CODES.MISSING) {
+    return existing;
+  }
+
+  const next = {
+    changeKey: key,
+    changeId: entry.changeId || changeKey.toChangeId(key),
+    title: entry.title || '',
+    module: entry.module || changeKey.parse(key).module,
+    summary: entry.summary || '',
+  };
+
+  const list = existing.activeChanges.slice();
+  const at = list.findIndex((item) => item.changeKey === key);
+  if (at >= 0) {
+    list[at] = { ...list[at], ...next };
+  } else {
+    list.push(next);
+  }
+
+  const written = writeSddConfig(specRoot, list);
+  return {
+    ok: true,
+    path: written.path,
+    registered: next,
+    activeChanges: list,
+    updated: at >= 0,
+  };
+}
+
+function removeActiveChange(specRoot, keyInput) {
+  const key = String(keyInput || '').trim().toLowerCase();
+  const existing = loadSddConfig(specRoot);
+  if (!existing.ok && existing.code !== CODES.MISSING) {
+    return existing;
+  }
+  const list = existing.activeChanges.filter((item) => item.changeKey !== key);
+  const removed = list.length !== existing.activeChanges.length;
+  if (removed) {
+    writeSddConfig(specRoot, list);
+  }
+  return { ok: true, removed, activeChanges: list, path: configPath(specRoot) };
+}
+
+/**
+ * Ordered change-keys for Spec-Change trailers (may be multiple).
+ */
+function activeChangeKeys(specRoot) {
+  const config = loadSddConfig(specRoot);
+  if (!config.ok) return [];
+  return config.activeChanges.map((entry) => entry.changeKey);
+}
+
+module.exports = {
+  FILE_NAME,
+  CODES,
+  parseSddConfigYaml,
+  serializeSddConfig,
+  loadSddConfig,
+  writeSddConfig,
+  registerActiveChange,
+  removeActiveChange,
+  activeChangeKeys,
+  configPath,
+};

package/skywalk-sdd/ontology/change-key.cjs

@@ -0,0 +1,241 @@
+'use strict';
+
+/**
+ * Change Key grammar for multi-repo association.
+ * Authority: 本体架构设计方案/10-最小化多仓库关联与变更命名方案.md §2.1 / §2.2
+ */
+
+const CHANGE_KEY_REGEX = /^([a-z][a-z0-9]{1,7})-([0-9]{6})-([a-z0-9]+(?:-[a-z0-9]+)*)$/;
+const MODULE_CODE_REGEX = /^[a-z][a-z0-9]{1,7}$/;
+const SLUG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const SLUG_MAX_LEN = 48;
+const RESERVED_CROSS = 'cross';
+
+const CODES = {
+  FORMAT_INVALID: 'CHANGE_KEY_FORMAT_INVALID',
+  DATE_INVALID: 'CHANGE_KEY_DATE_INVALID',
+  MODULE_INVALID: 'CHANGE_KEY_MODULE_INVALID',
+  SLUG_INVALID: 'CHANGE_KEY_SLUG_INVALID',
+  CONFLICT: 'CHANGE_KEY_CONFLICT',
+};
+
+function pad2(value) {
+  return String(value).padStart(2, '0');
+}
+
+function formatYymmdd(date = new Date()) {
+  const year = date.getFullYear() % 100;
+  const month = date.getMonth() + 1;
+  const day = date.getDate();
+  return `${pad2(year)}${pad2(month)}${pad2(day)}`;
+}
+
+function isValidCalendarYymmdd(yymmdd) {
+  if (!/^[0-9]{6}$/.test(String(yymmdd || ''))) return false;
+  const year = 2000 + Number(yymmdd.slice(0, 2));
+  const month = Number(yymmdd.slice(2, 4));
+  const day = Number(yymmdd.slice(4, 6));
+  if (month < 1 || month > 12 || day < 1 || day > 31) return false;
+  const dt = new Date(year, month - 1, day);
+  return (
+    dt.getFullYear() === year &&
+    dt.getMonth() === month - 1 &&
+    dt.getDate() === day
+  );
+}
+
+function normalizeSlug(raw) {
+  if (raw == null) return '';
+  let slug = String(raw)
+    .trim()
+    .toLowerCase()
+    .replace(/[_\s.]+/g, '-')
+    .replace(/[^a-z0-9-]/g, '')
+    .replace(/-+/g, '-')
+    .replace(/^-+|-+$/g, '');
+  if (slug.length > SLUG_MAX_LEN) {
+    slug = slug.slice(0, SLUG_MAX_LEN).replace(/-+$/g, '');
+  }
+  return slug;
+}
+
+function normalizeModule(raw) {
+  if (raw == null) return '';
+  return String(raw).trim().toLowerCase();
+}
+
+function parse(changeKey) {
+  const key = String(changeKey || '').trim().toLowerCase();
+  const match = CHANGE_KEY_REGEX.exec(key);
+  if (!match) return null;
+  return {
+    changeKey: key,
+    module: match[1],
+    yymmdd: match[2],
+    slug: match[3],
+  };
+}
+
+function validate(changeKey, options = {}) {
+  const key = String(changeKey || '').trim();
+  if (!key) {
+    return { ok: false, code: CODES.FORMAT_INVALID, message: 'change-key 为空' };
+  }
+  if (key !== key.toLowerCase()) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `change-key 必须全小写: ${changeKey}`,
+    };
+  }
+  if (/[_\s.]/.test(key) || key.includes('--')) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `change-key 禁止下划线、空格、点号或连续连字符: ${changeKey}`,
+    };
+  }
+  if (!CHANGE_KEY_REGEX.test(key)) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `change-key 格式不合规: ${changeKey}`,
+    };
+  }
+  const parts = parse(key);
+  if (!parts) {
+    return {
+      ok: false,
+      code: CODES.FORMAT_INVALID,
+      message: `change-key 无法解析: ${changeKey}`,
+    };
+  }
+  if (!isValidCalendarYymmdd(parts.yymmdd)) {
+    return {
+      ok: false,
+      code: CODES.DATE_INVALID,
+      message: `change-key 日期不是真实日历日: ${parts.yymmdd}`,
+    };
+  }
+  if (parts.slug.length > SLUG_MAX_LEN) {
+    return {
+      ok: false,
+      code: CODES.SLUG_INVALID,
+      message: `slug 超过 ${SLUG_MAX_LEN} 字符: ${parts.slug}`,
+    };
+  }
+  const registeredModules = options.registeredModules;
+  if (registeredModules && typeof registeredModules.has === 'function') {
+    if (!registeredModules.has(parts.module)) {
+      return {
+        ok: false,
+        code: CODES.MODULE_INVALID,
+        message: `模块代号未注册: ${parts.module}`,
+      };
+    }
+  } else if (Array.isArray(registeredModules)) {
+    if (!registeredModules.includes(parts.module)) {
+      return {
+        ok: false,
+        code: CODES.MODULE_INVALID,
+        message: `模块代号未注册: ${parts.module}`,
+      };
+    }
+  }
+  return { ok: true, code: null, message: null, normalized: key, parts };
+}
+
+function toChangeId(changeKey) {
+  const result = validate(changeKey);
+  if (!result.ok) {
+    throw new Error(result.message);
+  }
+  return `CHG-${result.normalized.toUpperCase()}`;
+}
+
+function buildChangeKey(moduleCode, slug, options = {}) {
+  const module = normalizeModule(moduleCode);
+  const normalizedSlug = normalizeSlug(slug);
+  const yymmdd = options.yymmdd || formatYymmdd(options.date || new Date());
+
+  if (!MODULE_CODE_REGEX.test(module)) {
+    return {
+      ok: false,
+      code: CODES.MODULE_INVALID,
+      message: `模块代号不合规: ${moduleCode}`,
+    };
+  }
+  if (!SLUG_REGEX.test(normalizedSlug)) {
+    return {
+      ok: false,
+      code: CODES.SLUG_INVALID,
+      message: `slug 不合规: ${slug} → ${normalizedSlug}`,
+    };
+  }
+  if (!isValidCalendarYymmdd(yymmdd)) {
+    return {
+      ok: false,
+      code: CODES.DATE_INVALID,
+      message: `日期不是真实日历日: ${yymmdd}`,
+    };
+  }
+
+  let candidate = `${module}-${yymmdd}-${normalizedSlug}`;
+  const existing = options.existingKeys || new Set();
+  const existingSet = existing instanceof Set
+    ? existing
+    : new Set(Array.from(existing || []).map((item) => String(item).toLowerCase()));
+
+  if (!existingSet.has(candidate)) {
+    const checked = validate(candidate, options);
+    if (!checked.ok) return checked;
+    return {
+      ok: true,
+      changeKey: candidate,
+      changeId: toChangeId(candidate),
+      module,
+      yymmdd,
+      slug: normalizedSlug,
+    };
+  }
+
+  for (let suffix = 2; suffix <= 99; suffix += 1) {
+    candidate = `${module}-${yymmdd}-${normalizedSlug}-${suffix}`;
+    if (existingSet.has(candidate)) continue;
+    const checked = validate(candidate, options);
+    if (!checked.ok) return checked;
+    return {
+      ok: true,
+      changeKey: candidate,
+      changeId: toChangeId(candidate),
+      module,
+      yymmdd,
+      slug: `${normalizedSlug}-${suffix}`,
+      collided: true,
+      suffix,
+    };
+  }
+
+  return {
+    ok: false,
+    code: CODES.CONFLICT,
+    message: `无法为 ${module}-${yymmdd}-${normalizedSlug} 分配可用序号`,
+  };
+}
+
+module.exports = {
+  CHANGE_KEY_REGEX,
+  MODULE_CODE_REGEX,
+  SLUG_REGEX,
+  SLUG_MAX_LEN,
+  RESERVED_CROSS,
+  CODES,
+  formatYymmdd,
+  isValidCalendarYymmdd,
+  normalizeSlug,
+  normalizeModule,
+  parse,
+  validate,
+  toChangeId,
+  buildChangeKey,
+};

package/skywalk-sdd/ontology/cli.cjs

@@ -11,6 +11,12 @@ const {
 const { observeChangeArtifacts } = require('./artifact-observer.cjs');
 const { allocateIdentity } = require('./id.cjs');
 const externalKey = require('./external-key.cjs');
+const changeKey = require('./change-key.cjs');
+const modules = require('./modules.cjs');
+const namingDiagnose = require('./naming-diagnose.cjs');
+const listChanges = require('./list-changes.cjs');
+const sddConfig = require('./sdd-config.cjs');
+const activeChanges = require('./active-changes.cjs');
 
 function parseArgs(argv) {
   const result = { _: [] };
@@ -55,6 +61,15 @@ function showHelp() {
   node skywalk-sdd/ontology/cli.cjs identity  --delta-state=modified --entity-id=<uuid> --predecessor-version=<uuid>
   node skywalk-sdd/ontology/cli.cjs identity  --delta-state=unchanged --entity-id=<uuid> --version-id=<uuid>
   node skywalk-sdd/ontology/cli.cjs external-key --validate <id> --type <requirement|feature|scenario>
+  node skywalk-sdd/ontology/cli.cjs change-key --validate <key>
+  node skywalk-sdd/ontology/cli.cjs change-key --generate --module=<code> --slug=<slug> [--date=yymmdd]
+  node skywalk-sdd/ontology/cli.cjs modules --validate [--project=.]
+  node skywalk-sdd/ontology/cli.cjs diagnose-naming [--project=.] [--change=<key>] [--mode=spec-repo|code-repo]
+  node skywalk-sdd/ontology/cli.cjs list-changes [--project=.] [--json]
+  node skywalk-sdd/ontology/cli.cjs link-spec --path=<spec-clone> [--project=.]
+  node skywalk-sdd/ontology/cli.cjs active-change --register --change=<key> [--title=] [--summary=] [--module=]
+  node skywalk-sdd/ontology/cli.cjs active-change --remove --change=<key>
+  node skywalk-sdd/ontology/cli.cjs active-change --list [--json]
   node skywalk-sdd/ontology/cli.cjs reconcile --project=. --change=<name> [--profile=...]
   node skywalk-sdd/ontology/cli.cjs check     --project=. --change=<name> [--profile=...]
   node skywalk-sdd/ontology/cli.cjs status    --project=. --change=<name>
@@ -92,6 +107,126 @@ function main(argv = process.argv.slice(2)) {
     if (!result.ok) process.exitCode = 1;
     return;
   }
+  if (command === 'change-key') {
+    if (args.generate || args._[1] === 'generate') {
+      const projectRoot = path.resolve(args.project || '.');
+      const registry = modules.loadModulesYaml(projectRoot);
+      const existing = listChanges.listActiveChanges(projectRoot);
+      const built = changeKey.buildChangeKey(args.module, args.slug, {
+        yymmdd: args.date || args.yymmdd,
+        existingKeys: existing,
+        registeredModules: registry.ok ? registry.codes : null,
+      });
+      console.log(JSON.stringify(built, null, 2));
+      if (!built.ok) process.exitCode = 1;
+      return;
+    }
+    const key = args.validate || args._[1];
+    if (!key) throw new Error('用法: change-key --validate <key> | --generate --module= --slug=');
+    const projectRoot = path.resolve(args.project || '.');
+    const registry = modules.loadModulesYaml(projectRoot);
+    const result = changeKey.validate(key, {
+      registeredModules: registry.ok ? registry.codes : null,
+    });
+    console.log(JSON.stringify({
+      ok: result.ok,
+      code: result.code,
+      message: result.message,
+      normalized: result.normalized || null,
+      changeId: result.ok ? changeKey.toChangeId(result.normalized) : null,
+      parts: result.parts || null,
+    }, null, 2));
+    if (!result.ok) process.exitCode = 1;
+    return;
+  }
+  if (command === 'modules') {
+    const projectRoot = path.resolve(args.project || '.');
+    const result = modules.loadModulesYaml(projectRoot);
+    console.log(JSON.stringify({
+      ok: result.ok,
+      code: result.code || null,
+      message: result.message || null,
+      path: result.path,
+      version: result.version || null,
+      modules: result.modules || null,
+    }, null, 2));
+    if (!result.ok) process.exitCode = 1;
+    return;
+  }
+  if (command === 'diagnose-naming') {
+    const projectRoot = path.resolve(args.project || '.');
+    const result = namingDiagnose.diagnose(projectRoot, {
+      change: args.change,
+      mode: args.mode,
+    });
+    if (args.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(namingDiagnose.formatReport(result));
+      console.log('');
+      console.log(JSON.stringify(result.summary, null, 2));
+    }
+    if (result.summary.overall === 'FAIL') process.exitCode = 1;
+    return;
+  }
+  if (command === 'list-changes') {
+    const projectRoot = path.resolve(args.project || '.');
+    const result = listChanges.groupChanges(projectRoot);
+    if (args.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(listChanges.formatGroupedText(result) || '(无活动 change)');
+    }
+    return;
+  }
+  if (command === 'link-spec') {
+    const projectRoot = path.resolve(args.project || '.');
+    const specPath = args.path || args._[1];
+    if (!specPath) throw new Error('用法: link-spec --path=<spec-clone> [--project=.]');
+    const result = sddConfig.setSpecPath(projectRoot, specPath);
+    console.log(JSON.stringify(result, null, 2));
+    if (!result.ok) process.exitCode = 1;
+    return;
+  }
+  if (command === 'active-change') {
+    const specRoot = path.resolve(args.project || '.');
+    if (args.list || args._[1] === 'list') {
+      const config = activeChanges.loadSddConfig(specRoot);
+      if (args.json) {
+        console.log(JSON.stringify(config, null, 2));
+      } else if (!config.ok) {
+        console.log(config.message);
+      } else if (config.activeChanges.length === 0) {
+        console.log('(无活动 change)');
+      } else {
+        for (const entry of config.activeChanges) {
+          console.log(`● ${entry.title || '(无标题)'}`);
+          console.log(`  ${entry.changeKey}${entry.module ? `  [${entry.module}]` : ''}`);
+          if (entry.summary) console.log(`  ${entry.summary}`);
+        }
+      }
+      if (!config.ok && config.code !== activeChanges.CODES.MISSING) process.exitCode = 1;
+      return;
+    }
+    const key = args.change || args._[1];
+    if (!key) throw new Error('用法: active-change --register|--remove --change=<key> [--project=<spec>]');
+    if (args.remove) {
+      const result = activeChanges.removeActiveChange(specRoot, key);
+      console.log(JSON.stringify(result, null, 2));
+      if (!result.ok) process.exitCode = 1;
+      return;
+    }
+    const result = activeChanges.registerActiveChange(specRoot, {
+      changeKey: key,
+      changeId: args['change-id'] || args.changeId,
+      title: args.title,
+      module: args.module,
+      summary: args.summary,
+    });
+    console.log(JSON.stringify(result, null, 2));
+    if (!result.ok) process.exitCode = 1;
+    return;
+  }
   const projectRoot = path.resolve(args.project || '.');
   const changeName = args.change;
   if (!changeName) throw new Error('缺少 --change 参数');