@deepstorm/cli 0.9.1 → 0.9.3

package/dist/cli.js

@@ -6351,10 +6351,11 @@ async function promptContinueSetup(targetDir, projectName, registry2) {
 }
 function buildContext(opts) {
   const projectName = opts.projectName || "project";
+  const packageName = projectName.replace(/[_-]/g, "").toLowerCase();
   return {
     projectName,
-    packageName: projectName.replace(/[_-]/g, "").toLowerCase(),
-    groupId: "com.example",
+    packageName,
+    groupId: `com.${packageName}`,
     frontend: opts.frontend || false,
     backend: opts.backend || false,
     uiLib: opts.uiLib || false,
@@ -6822,7 +6823,7 @@ tasks.withType<Test> {
   useJUnitPlatform()
 }
 `);
-  const appPackage = `${ctx.groupId}.${ctx.packageName}`.replace(/[.-]/g, ".");
+  const appPackage = ctx.groupId.replace(/[.-]/g, ".");
   const appDir = `src/main/java/${appPackage.replace(/\./g, "/")}`;
   ensureDir2(path2.join(projectDir, appDir));
   writeTemplate(projectDir, `${appDir}/Application.java`, `package ${appPackage};
@@ -6917,6 +6918,8 @@ logging:
     ${ctx.packageName}: DEBUG
 `);
   if (hasLiquibase) {
+    const now = /* @__PURE__ */ new Date();
+    const ts = now.toISOString().replace(/\D/g, "").slice(0, 12);
     ensureDir2(path2.join(projectDir, "src/main/resources/db/changelog"));
     writeTemplate(projectDir, "src/main/resources/db/changelog/db.changelog-master.xml", `<?xml version="1.0" encoding="UTF-8"?>
 <databaseChangeLog
@@ -6925,7 +6928,7 @@ logging:
   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
     http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">
 
-  <changeSet id="001" author="deepstorm">
+  <changeSet id="${ts}-001" author="deepstorm">
     <createTable tableName="flyway_schema_history">
       <column name="version" type="VARCHAR(50)"/>
     </createTable>
@@ -9979,7 +9982,7 @@ function runDoctor(targetDir) {
   checks.push({
     name: "CLI \u7248\u672C",
     status: "pass",
-    message: `v${version}\uFF08\u8FD0\u884C deepstorm update --check \u68C0\u67E5\u6700\u65B0\u7248\u672C\uFF09`
+    message: `v${version}\uFF08\u8FD0\u884C deepstorm update \u68C0\u67E5\u6700\u65B0\u7248\u672C\uFF09`
   });
   let hasDeepStorm = false;
   if (!fs25.existsSync(settingsPath)) {

package/dist/skills/reef-commit/SKILL.md

@@ -41,75 +41,32 @@ git status --short
 
 ### 2. 分支名与任务相关性检查
 
-在审查待提交文件之前，先检查当前分支是否与待提交的任务相关。如果当前在 `main`/`master` 分支上则**必须**创建新分支；如果分支名与任务内容明显不匹配（如命名随意、与 OpenSpec 任务不符），建议创建新分支。
+通过 `branch-check.mjs` 检查当前分支是否合法：
 
 ```bash
-BRANCH=$(git branch --show-current)
-echo "当前分支: $BRANCH"
-
-# 检测是否需要创建新分支
-MUST_NEW_BRANCH=false
-
-# 条件一：在 main 或 master 上必须创建新分支
-if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
-  echo "⚠️ 当前在 $BRANCH 分支上，不允许直接提交，必须创建新分支"
-  MUST_NEW_BRANCH=true
-fi
-
-# 条件二：检查分支名是否包含 temp、wip、test、tmp、dev 等临时名称
-TEMP_PATTERN='^(temp|wip|test|tmp|dev)(/.*)?$'
-if echo "$BRANCH" | grep -qE "$TEMP_PATTERN"; then
-  echo "⚠️ 当前分支名 ($BRANCH) 看起来是临时分支，建议创建有意义的新分支"
-fi
-
-# 收集 OpenSpec 任务上下文
-for dir in openspec/changes/*/; do
-  if [ -f "$dir/proposal.md" ]; then
-    TASK_NAME=$(basename "$dir")
-    echo "发现 OpenSpec 任务: $TASK_NAME"
-  fi
-done
+node packages/reef/skills/reef-commit/scripts/branch-check.mjs
 ```
 
-**判断规则（LLM 自行推理执行）：**
+输出 JSON：
+```json
+{"isValid":true,"warning":false,"action":"continue"}
+```
 
-1. **如果 MUST_NEW_BRANCH=true**（当前在 main/master）：
-   - 直接进入步骤 3「创建新分支」，无需询问用户
-2. **如果分支名明显不相关**（如 `temp-xxx`、`test-foo`、或随意命名与当前变更毫无关联）：
-   - 向用户说明：「当前分支 $BRANCH 与待提交的变更内容似乎不匹配，是否创建一个新分支？」
-   - 用户同意 → 进入步骤 3「创建新分支」
-   - 用户不同意 → 继续当前分支
-3. **如果分支名合理**（如与 OpenSpec 任务同名，或包含功能描述的 kebab-case）：
-   - 直接继续
+**判断规则：**
+- `isValid: false, action: "create-branch"`（当前在 main/master）→ **直接进入步骤 3**
+- `warning: true, action: "suggest-rename"`（分支名像临时分支）→ 询问用户是否改名
+- `matchedTask` 有值 → 说明已匹配到 OpenSpec 任务
+- 其他 → 直接继续
 
 ### 3. 创建新分支
 
-当需要创建新分支时，按以下逻辑确定分支名：
-
-**分支名生成规则（优先级从高到低）：**
-1. **OpenSpec 任务名**：如果检测到 `openspec/changes/<task>/proposal.md`，使用 `<task>` 作为分支名
+按以下逻辑确定分支名（优先级从高到低）：
+1. **OpenSpec 任务名**：由 `branch-check.mjs` 输出的 `matchedTask` 确定
 2. **用户输入**：询问用户想要的分支名
-3. **AI 推导**：根据变更内容总结生成 kebab-case 分支名（例如 `feat/add-user-auth`、`fix/login-timeout`）
+3. **AI 推导**：根据变更内容总结生成 kebab-case 分支名
 
 ```bash
-# 暂存当前未提交变更
-STASHED=false
-if [ -n "$(git status --porcelain)" ]; then
-  git stash push -m "reef-commit-auto-stash"
-  STASHED=true
-fi
-
-# 创建并切换到新分支（基于 main）
-git checkout main
-git pull origin main 2>/dev/null || true
-git checkout -b <new-branch-name>
-
-# 恢复暂存的变更
-if [ "$STASHED" = true ]; then
-  git stash pop
-fi
-
-echo "✅ 已切换到新分支: <new-branch-name>"
+bash packages/reef/skills/reef-commit/scripts/stash-and-switch.sh <new-branch-name>
 ```
 
 > **注意**：创建新分支后，后续步骤（审查文件、范围检查、测试等）在新分支上继续执行。
@@ -129,9 +86,6 @@ git diff --stat
 检查当前分支是否涉及多个业务领域。如果跨领域，给出拆分建议并中止提交。
 
 ```bash
-BRANCH=$(git branch --show-current)
-FORK_POINT=$(git merge-base main HEAD 2>/dev/null || echo "")
-echo "检查分支范围（基准: main）..."
 SCOPE_HOOK="packages/reef/hooks/reef-scope-gate.sh"
 if [ -f "$SCOPE_HOOK" ]; then
   bash "$SCOPE_HOOK" || {
@@ -146,64 +100,37 @@ fi
 ### 6. 运行单元测试
 
 ```bash
-git status --short
-```
-
-如有变更则全量运行测试：
-
-```bash
-./gradlew test
-(cd src/main/web && pnpm test -- --run)
+bash packages/reef/skills/reef-commit/scripts/run-tests.sh --json
 ```
 
-- 测试全部通过 → 继续
-- 任一测试失败 → 提示用户修复后再提交
+- 全部通过（`allPassed: true`）→ 继续
+- 任一测试失败（`allPassed: false`）→ 提示用户修复后再提交
 
 ### 6.5 OpenSpec 验证与归档检查
 
 > 提交前检查关联的 OpenSpec change 是否已完成验证和归档。如果 `openspec/` 目录不存在或无活跃 change 则跳过本步骤。
 
-**判断流程（LLM 自行推理执行）：**
+**判断流程：**
 
 1. **查找关联的 OpenSpec change：**
    ```bash
-   BRANCH=$(git branch --show-current)
-   echo "当前分支: $BRANCH"
-
-   for dir in openspec/changes/*/; do
-     CHANGE_NAME=$(basename "$dir")
-     if [ -f "$dir/.openspec.yaml" ] && [ "$CHANGE_NAME" != "archive" ]; then
-       echo "发现活跃 OpenSpec change: $CHANGE_NAME"
-       cat "$dir/.openspec.yaml"
-     fi
-   done
+   node packages/reef/skills/reef-commit/scripts/check-openspec-status.mjs \
+     --branch "$(git branch --show-current)"
    ```
 
-2. **匹配规则：** 扫描 `openspec/changes/*/` 下活跃 change（不包含 `archive/`），与当前分支名比对；无匹配则跳过；多匹配则让用户选择。
-
-3. **检查归档状态：** 读取 `.openspec.yaml` 中 `status` 字段。`archived` → 跳过后续检查；否则继续。
-
-4. **运行验证：** 确认 `tasks.md` 全部 checkbox 已完成 → 通过 Skill 工具自动调用 `/opsx:verify`。有 CRITICAL 问题则中止；仅 WARNING/SUGGESTION 则通过。
-
+2. **匹配规则：** 脚本输出中 `name` 匹配当前分支名，`tasksAllDone` 检查任务完成状态。
+3. **检查归档状态：** 无输出（`noMatch: true`）→ 跳过。`hasTasksMd: true` + `tasksAllDone: true` → 已全部完成 → 调用 `/opsx:verify` 和 `/opsx:archive`。
+4. **运行验证：** 确认后通过 Skill 工具自动调用 `/opsx:verify`。有 CRITICAL 问题则中止；仅 WARNING/SUGGESTION 则通过。
 5. **运行归档：** 验证通过后 → 通过 Skill 工具自动调用 `/opsx:archive`。执行失败则提示用户手动处理。
 
-6. **确认已就绪：** 校验状态并向用户报告。
-
-> **提示：** verify/archive 执行后产生额外文件变更的，后续步骤会重新检测并纳入提交。
-
 ### 7. 收集上下文
 
 ```bash
-BRANCH=$(git branch --show-current)
-FORK_POINT=$(git merge-base main HEAD 2>/dev/null)
-echo "Branch: $BRANCH"; git diff "$FORK_POINT"..HEAD --stat
-ls -d openspec/changes/*/ 2>/dev/null | grep -v archive
-[ -f "openspec/changes/$BRANCH/proposal.md" ] && head -5 "openspec/changes/$BRANCH/proposal.md"
-# 从 proposal/commit 提取 Issue 引用
-grep -iE '(issue|jira|lc-|proj-)' "openspec/changes/$BRANCH/proposal.md" 2>/dev/null | head -3
-git log "$FORK_POINT"..HEAD --format="%B" 2>/dev/null | grep -ioP '[A-Z]+-\d+' | head -1
+node packages/reef/skills/reef-commit/scripts/collect-git-context.mjs
 ```
 
+输出 JSON 包含 `branch`、`diffStat`、`commitLog`、`openspecChanges` 等字段。提取 `openspecChanges` 中 `matched: true` 项的 `proposal.md` 标题作为提交信息素材。
+
 ### 8. 生成提交信息
 
 **标题：** 优先 OpenSpec proposal 标题 → 分支名（kebab-case 转中文）→ 变更总结。依赖更新用 `更新 {依赖} 至 {版本}`，问题修复用 `解决{问题描述}的问题`。

package/dist/skills/reef-commit/scripts/branch-check.mjs

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+
+/**
+ * branch-check.mjs
+ * 检查当前分支是否合法。
+ *
+ * 用法:
+ *   node branch-check.mjs
+ *   node branch-check.mjs --branch feat/add-auth
+ *   node branch-check.mjs --help
+ */
+
+import { execSync } from 'node:child_process';
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+// ── Exported constants (for test access) ──────────────────────────
+
+/** 临时分支名正则 */
+export const TEMP_PATTERN = /^(temp|wip|test|tmp|dev)(\/.*)?$/;
+
+// ── Pure functions ────────────────────────────────────────────────
+
+export function isMainOrMaster(branch) {
+  return branch === 'main' || branch === 'master';
+}
+
+/**
+ * 检查分支是否合法。
+ * @param {string} branch
+ * @param {Array<{name:string}>} openspecTasks
+ * @returns {{isValid:boolean, reason?:string, action:string,
+ *           warning:boolean, matchedTask?:string}}
+ */
+export function checkBranch(branch, openspecTasks = []) {
+  if (isMainOrMaster(branch)) {
+    return {
+      isValid: false,
+      reason: `不允许在 ${branch} 分支上直接提交`,
+      action: 'create-branch',
+      warning: false,
+    };
+  }
+
+  const isTemp = TEMP_PATTERN.test(branch);
+  const action = isTemp ? 'suggest-rename' : 'continue';
+  const matchedTask = openspecTasks.find(t =>
+    branch === t.name || branch.includes(t.name)
+  );
+
+  return {
+    isValid: true,
+    warning: isTemp,
+    action,
+    ...(isTemp ? { reason: '分支名像临时分支，建议改名' } : {}),
+    ...(matchedTask ? { matchedTask: matchedTask.name } : {}),
+  };
+}
+
+// ── Shell helpers ─────────────────────────────────────────────────
+
+function exec(command) {
+  try {
+    return execSync(command, { encoding: 'utf8', timeout: 5000 }).trim();
+  } catch {
+    return '';
+  }
+}
+
+function findOpenspecTasks() {
+  const root = exec(
+    'git rev-parse --show-toplevel 2>/dev/null || echo ""'
+  );
+  if (!root) return [];
+  const changesDir = join(root, 'openspec', 'changes');
+  if (!existsSync(changesDir)) return [];
+
+  const entries = readdirSync(changesDir, { withFileTypes: true });
+  return entries
+    .filter(e => e.isDirectory() && e.name !== 'archive')
+    .map(e => ({
+      name: e.name,
+      hasProposal: existsSync(join(changesDir, e.name, 'proposal.md')),
+    }));
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+branch-check.mjs — 检查分支合法性
+
+用法:
+  node branch-check.mjs                      自动检测
+  node branch-check.mjs --branch <name>      指定分支
+  node branch-check.mjs --help               显示帮助
+`);
+    process.exit(0);
+  }
+
+  const idx = process.argv.indexOf('--branch');
+  const branch = idx >= 0
+    ? process.argv[idx + 1]
+    : exec('git branch --show-current');
+  const tasks = findOpenspecTasks();
+  const result = checkBranch(branch, tasks);
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+}

package/dist/skills/reef-commit/scripts/check-openspec-status.mjs

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+/**
+ * check-openspec-status.mjs
+ * 扫描 OpenSpec change 的状态。
+ *
+ * 用法:
+ *   node check-openspec-status.mjs
+ *   node check-openspec-status.mjs --branch add-auth
+ *   node check-openspec-status.mjs --help
+ */
+
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+const TASKS_CHECKBOX_RE = /^- \[([ xX])\]/gm;
+
+// ── Pure functions ────────────────────────────────────────────────
+
+export function isArchived(changePath) {
+  return changePath.includes('/archive/');
+}
+
+export function parseTasksStatus(content) {
+  const matches = [...content.matchAll(TASKS_CHECKBOX_RE)];
+  const total = matches.length;
+  const complete = matches.filter(m => m[1] !== ' ').length;
+  return {
+    total,
+    complete,
+    allDone: total === 0 ? true : total === complete,
+  };
+}
+
+export function scanChanges(changesDir) {
+  if (!existsSync(changesDir)) return [];
+  const entries = readdirSync(changesDir, { withFileTypes: true });
+  return entries
+    .filter(e => e.isDirectory() && e.name !== 'archive')
+    .map(e => {
+      const dirPath = join(changesDir, e.name);
+      const tasksPath = join(dirPath, 'tasks.md');
+      const hasTasksMd = existsSync(tasksPath);
+      let tasksStatus = null;
+      if (hasTasksMd) {
+        tasksStatus = parseTasksStatus(
+          readFileSync(tasksPath, 'utf8')
+        );
+      }
+      return {
+        name: e.name,
+        archived: false,
+        hasTasksMd,
+        tasksAllDone: tasksStatus ? tasksStatus.allDone : null,
+        tasksTotal: tasksStatus ? tasksStatus.total : 0,
+        tasksComplete: tasksStatus ? tasksStatus.complete : 0,
+      };
+    });
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+check-openspec-status.mjs — 扫描 OpenSpec change 状态
+
+用法:
+  node check-openspec-status.mjs
+  node check-openspec-status.mjs --branch <name>
+  node check-openspec-status.mjs --help
+`);
+    process.exit(0);
+  }
+
+  const root = process.env.INIT_CWD || process.cwd();
+  const changesDir = join(root, 'openspec', 'changes');
+  const results = scanChanges(changesDir);
+
+  const branchIdx = process.argv.indexOf('--branch');
+  if (branchIdx >= 0) {
+    const branch = process.argv[branchIdx + 1];
+    const matched = results.filter(r =>
+      r.name === branch || branch.includes(r.name)
+    );
+    process.stdout.write(JSON.stringify(
+      matched.length > 0 ? matched : { noMatch: true, branch }, null, 2
+    ) + '\n');
+  } else {
+    process.stdout.write(JSON.stringify(results, null, 2) + '\n');
+  }
+}

package/dist/skills/reef-commit/scripts/collect-git-context.mjs

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+
+/**
+ * collect-git-context.mjs
+ * 收集 git 上下文，输出结构化 JSON。
+ *
+ * 用法:
+ *   node collect-git-context.mjs              # 输出 JSON
+ *   node collect-git-context.mjs --help       # 查看帮助
+ */
+
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+// ── Pure parse functions (testable) ──────────────────────────────────
+
+/**
+ * 解析 `git diff --stat` 输出
+ * @param {string} output
+ * @returns {{ files: number, insertions: number, deletions: number, changedFiles: string[] }}
+ */
+export function parseDiffStat(output) {
+  const lines = output.trim().split('\n').filter(Boolean);
+  const changedFiles = [];
+  let files = 0, insertions = 0, deletions = 0;
+
+  for (const line of lines) {
+    // 匹配汇总行: "2 files changed, 13 insertions(+), 2 deletions(-)"
+    const summaryMatch = line.match(/(\d+)\s+files?\s+changed/);
+    if (summaryMatch) {
+      files = parseInt(summaryMatch[1], 10);
+      const insMatch = line.match(/(\d+)\s+insertions?\(\+\)/);
+      if (insMatch) insertions = parseInt(insMatch[1], 10);
+      const delMatch = line.match(/(\d+)\s+deletions?\(-\)/);
+      if (delMatch) deletions = parseInt(delMatch[1], 10);
+      continue;
+    }
+    // 匹配文件行: "src/main.ts | 10 ++++++++--"
+    const fileMatch = line.match(/^\s*(.+?)\s+\|/);
+    if (fileMatch) {
+      changedFiles.push(fileMatch[1].trim());
+    }
+  }
+
+  return { files, insertions, deletions, changedFiles };
+}
+
+/**
+ * 解析 `git log --oneline` 输出
+ * @param {string} output
+ * @returns {Array<{ hash: string, message: string }>}
+ */
+export function parseCommitLog(output) {
+  const lines = output.trim().split('\n').filter(Boolean);
+  return lines.map(line => {
+    const match = line.match(/^(\S+)\s+(.*)/);
+    return match ? { hash: match[1], message: match[2] } : null;
+  }).filter(Boolean);
+}
+
+/**
+ * 从分支名或 commit 信息中提取 JIRA 引用编号
+ * @param {string} branchName
+ * @param {Array<{hash:string,message:string}>} [commitLog]
+ * @returns {string|null}
+ */
+export function extractJiraRef(branchName, commitLog) {
+  const JIRA_RE = /[A-Z]{2,}-\d+/;
+  const branchMatch = branchName.match(JIRA_RE);
+  if (branchMatch) return branchMatch[0];
+  if (commitLog) {
+    for (const commit of commitLog) {
+      const match = commit.message.match(JIRA_RE);
+      if (match) return match[0];
+    }
+  }
+  return null;
+}
+
+// ── Shell exec helpers ──────────────────────────────────────────────
+
+function exec(command) {
+  try {
+    return execSync(command, { encoding: 'utf8', timeout: 10000 }).trim();
+  } catch {
+    return '';
+  }
+}
+
+// ── Context collection ──────────────────────────────────────────────
+
+/**
+ * 收集完整的 git 上下文
+ * @returns {{ branch: string, forkPoint: string|null, diffStat: object|null, commitLog: Array, hasUncommitted: boolean, openspecChanges: Array|null }}
+ */
+export function collectContext() {
+  const branch = exec('git branch --show-current');
+  let forkPoint;
+  let error;
+  try {
+    forkPoint = execSync('git merge-base main HEAD', { encoding: 'utf8' }).trim();
+  } catch {
+    error = '无法找到基准点';
+  }
+  const diffStat = exec(`git diff "${forkPoint || 'main'}..HEAD" --stat`);
+  const commitLogRaw = forkPoint
+    ? exec(`git log "${forkPoint}"..HEAD --oneline`)
+    : '';
+  const statusShort = exec('git status --short');
+  const hasUncommitted = statusShort.length > 0;
+
+  // OpenSpec change 扫描
+  let openspecChanges = null;
+  const root = exec('git rev-parse --show-toplevel 2>/dev/null || echo ""');
+  if (root) {
+    const changesDir = join(root, 'openspec', 'changes');
+    if (existsSync(changesDir)) {
+      try {
+        const entries = readdirSync(changesDir, { withFileTypes: true });
+        const changeDirs = entries
+          .filter(e => e.isDirectory() && e.name !== 'archive')
+          .map(e => {
+            const proposalPath = join(changesDir, e.name, 'proposal.md');
+            const hasProposal = existsSync(proposalPath);
+            let title = e.name;
+            if (hasProposal) {
+              const firstLine = readFileSync(proposalPath, 'utf8').split('\n')[0] || '';
+              title = firstLine.replace(/^#\s*/, '').trim() || e.name;
+            }
+            return {
+              name: e.name,
+              hasProposal,
+              matched: branch === e.name,
+              title,
+            };
+          });
+        if (changeDirs.length > 0) openspecChanges = changeDirs;
+      } catch {
+        // ignore
+      }
+    }
+  }
+
+  const parsedCommitLog = commitLogRaw ? parseCommitLog(commitLogRaw) : [];
+
+  return {
+    branch,
+    forkPoint: forkPoint || null,
+    diffStat: diffStat ? parseDiffStat(diffStat) : null,
+    commitLog: parsedCommitLog,
+    hasUncommitted,
+    openspecChanges,
+    jiraRef: extractJiraRef(branch, parsedCommitLog),
+    ...(error ? { error } : {}),
+  };
+}
+
+// ── CLI entry ───────────────────────────────────────────────────────
+
+function printHelp() {
+  console.log(`
+collect-git-context.mjs — 收集 git 上下文
+
+用法:
+  node collect-git-context.mjs         输出 JSON 格式的 git 上下文
+  node collect-git-context.mjs --help  显示本帮助
+
+输出字段:
+  branch          当前分支名
+  forkPoint       main 的 merge-base
+  diffStat        { files, insertions, deletions, changedFiles }
+  commitLog       [{ hash, message }]
+  hasUncommitted  是否有未提交变更
+  openspecChanges [{ name, hasProposal, matched, title }] 或 null
+`);
+}
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    printHelp();
+    process.exit(0);
+  }
+  const context = collectContext();
+  process.stdout.write(JSON.stringify(context, null, 2) + '\n');
+}