@spaceflow/review-summary 0.1.0

package/README.md

@@ -0,0 +1,58 @@
+# @spaceflow/review-summary
+
+[![npm version](https://img.shields.io/npm/v/@spaceflow/review-summary?color=blue)](https://www.npmjs.com/package/@spaceflow/review-summary)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+> Spaceflow 审查统计扩展，根据时间范围统计 PR 贡献情况，按人员汇总并排序。支持输出到控制台、GitHub Issue 或 Markdown 文件。
+
+## 安装
+
+```bash
+pnpm spaceflow install @spaceflow/review-summary
+```
+
+## 功能特性
+
+- **时间范围统计** — 支持自定义日期范围或预设时间段
+- **多维度统计** — PR 数量、代码行数、变更文件数、问题数量
+- **综合评分** — 根据代码量和问题数量权衡计算分数
+- **按人员排序** — 按综合分数降序排列贡献者
+- **多种输出方式** — 控制台、GitHub Issue、Markdown 文件
+
+## 使用
+
+```bash
+# 使用时间预设 - 统计本周
+spaceflow review-summary -p this-week
+
+# 使用时间预设 - 统计上月
+spaceflow review-summary -p last-month
+
+# 自定义日期范围
+spaceflow review-summary -s 2026-01-01 -u 2026-01-18
+
+# 输出到 GitHub Issue
+spaceflow review-summary -p last-week -o issue -c
+```
+
+## 命令行参数
+
+| 参数                | 简写 | 说明                                                                |
+| ------------------- | ---- | ------------------------------------------------------------------- |
+| `--period <preset>` | `-p` | 时间预设（`this-week` / `last-week` / `this-month` / `last-month`） |
+| `--since <date>`    | `-s` | 起始日期（`YYYY-MM-DD` 格式）                                       |
+| `--until <date>`    | `-u` | 截止日期（`YYYY-MM-DD` 格式）                                       |
+| `--output <format>` | `-o` | 输出方式（`console` / `issue` / `markdown`）                        |
+| `--ci`              | `-c` | 在 CI 环境中运行                                                    |
+| `--dry-run`         | `-d` | 仅打印将要执行的操作                                                |
+
+## 环境变量
+
+| 变量                | 说明                          |
+| ------------------- | ----------------------------- |
+| `GITHUB_TOKEN`      | GitHub API Token              |
+| `GITHUB_REPOSITORY` | 仓库名称（`owner/repo` 格式） |
+
+## 许可证
+
+[MIT](../../LICENSE)

package/dist/index.js

@@ -0,0 +1,73 @@
+import { addLocaleResources, defineExtension, t } from "@spaceflow/core";
+// The require scope
+var __webpack_require__ = {};
+
+// webpack/runtime/define_property_getters
+(() => {
+__webpack_require__.d = (exports, definition) => {
+	for(var key in definition) {
+        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
+        }
+    }
+};
+})();
+// webpack/runtime/has_own_property
+(() => {
+__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
+})();
+var __webpack_exports__ = {};
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  A: () => (/* binding */ src),
+  c: () => (/* binding */ extension)
+});
+
+;// CONCATENATED MODULE: external "@spaceflow/core"
+
+;// CONCATENATED MODULE: ./src/locales/zh-cn/review-summary.json
+var review_summary_namespaceObject = JSON.parse('{"description":"周期统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序","options.preset":"时间预设: this-week(本周), last-week(上周), this-month(本月), last-month(上月), last-7-days, last-15-days, last-30-days","options.since":"开始日期 (YYYY-MM-DD 格式)，与 --preset 二选一","options.until":"结束日期 (YYYY-MM-DD 格式)，默认为今天","options.repository":"仓库路径 (owner/repo 格式)，默认从环境变量获取","options.format":"输出格式: table, json, markdown","options.output":"输出目标: console(控制台), issue(创建 GitHub Issue), file(Markdown 文件)","options.outputFile":"输出文件路径（当 --output 为 file 时使用）","options.verbose":"详细日志级别 (1: 过程日志, 2: 详细日志)","reportOutput":"✅ 报告已输出到: {{location}}","extensionDescription":"周期统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序"}')
+;// CONCATENATED MODULE: ./src/locales/en/review-summary.json
+var en_review_summary_namespaceObject = JSON.parse('{"description":"Period summary - aggregate PR contributions by time range, grouped by author","options.preset":"Time preset: this-week, last-week, this-month, last-month, last-7-days, last-15-days, last-30-days","options.since":"Start date (YYYY-MM-DD format), alternative to --preset","options.until":"End date (YYYY-MM-DD format), defaults to today","options.repository":"Repository path (owner/repo format), auto-detected from env by default","options.format":"Output format: table, json, markdown","options.output":"Output target: console, issue (create GitHub Issue), file (Markdown file)","options.outputFile":"Output file path (used when --output is file)","options.verbose":"Verbose log level (1: process logs, 2: detailed logs)","reportOutput":"✅ Report output to: {{location}}","extensionDescription":"Period summary - aggregate PR contributions by time range, grouped by author"}')
+;// CONCATENATED MODULE: ./src/locales/index.ts
+
+
+
+/** review-summary 命令 i18n 资源 */ const reviewSummaryLocales = {
+    "zh-CN": review_summary_namespaceObject,
+    en: en_review_summary_namespaceObject
+};
+addLocaleResources("review-summary", reviewSummaryLocales);
+
+;// CONCATENATED MODULE: ./src/index.ts
+
+
+
+const extension = defineExtension({
+    name: "review-summary",
+    version: "1.0.0",
+    description: t("review-summary:extensionDescription"),
+    configKey: "review-summary",
+    commands: [
+        {
+            name: "review-summary",
+            description: t("review-summary:description"),
+            options: [
+                {
+                    flags: "-d, --days",
+                    description: "天数"
+                }
+            ],
+            run: async (args, options, ctx)=>{
+                ctx.output.info("review-summary 命令暂未实现");
+            // TODO: 实现 review-summary 命令逻辑
+            }
+        }
+    ]
+});
+/* export default */ const src = (extension);
+
+var __webpack_exports__default = __webpack_exports__.A;
+var __webpack_exports__extension = __webpack_exports__.c;
+export { __webpack_exports__default as default, __webpack_exports__extension as extension };

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@spaceflow/review-summary",
+  "version": "0.1.0",
+  "description": "Spaceflow 审查统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序",
+  "license": "MIT",
+  "author": "Lydanne",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lydanne/spaceflow.git",
+    "directory": "extensions/review-summary"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@spaceflow/cli": "0.21.0"
+  },
+  "peerDependencies": {
+    "@spaceflow/core": "0.3.0"
+  },
+  "spaceflow": {
+    "type": "flow",
+    "entry": "."
+  },
+  "scripts": {
+    "build": "spaceflow build",
+    "dev": "spaceflow dev"
+  }
+}

package/src/index.ts

@@ -0,0 +1,28 @@
+import "./locales";
+import { defineExtension } from "@spaceflow/core";
+import { t } from "@spaceflow/core";
+
+export const extension = defineExtension({
+  name: "review-summary",
+  version: "1.0.0",
+  description: t("review-summary:extensionDescription"),
+  configKey: "review-summary",
+  commands: [
+    {
+      name: "review-summary",
+      description: t("review-summary:description"),
+      options: [
+        {
+          flags: "-d, --days",
+          description: "天数",
+        },
+      ],
+      run: async (args, options, ctx) => {
+        ctx.output.info("review-summary 命令暂未实现");
+        // TODO: 实现 review-summary 命令逻辑
+      },
+    },
+  ],
+});
+
+export default extension;

package/src/locales/en/review-summary.json

@@ -0,0 +1,13 @@
+{
+  "description": "Period summary - aggregate PR contributions by time range, grouped by author",
+  "options.preset": "Time preset: this-week, last-week, this-month, last-month, last-7-days, last-15-days, last-30-days",
+  "options.since": "Start date (YYYY-MM-DD format), alternative to --preset",
+  "options.until": "End date (YYYY-MM-DD format), defaults to today",
+  "options.repository": "Repository path (owner/repo format), auto-detected from env by default",
+  "options.format": "Output format: table, json, markdown",
+  "options.output": "Output target: console, issue (create GitHub Issue), file (Markdown file)",
+  "options.outputFile": "Output file path (used when --output is file)",
+  "options.verbose": "Verbose log level (1: process logs, 2: detailed logs)",
+  "reportOutput": "✅ Report output to: {{location}}",
+  "extensionDescription": "Period summary - aggregate PR contributions by time range, grouped by author"
+}

package/src/locales/index.ts

@@ -0,0 +1,11 @@
+import { addLocaleResources } from "@spaceflow/core";
+import zhCN from "./zh-cn/review-summary.json";
+import en from "./en/review-summary.json";
+
+/** review-summary 命令 i18n 资源 */
+export const reviewSummaryLocales: Record<string, Record<string, string>> = {
+  "zh-CN": zhCN,
+  en,
+};
+
+addLocaleResources("review-summary", reviewSummaryLocales);

package/src/locales/zh-cn/review-summary.json

@@ -0,0 +1,13 @@
+{
+  "description": "周期统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序",
+  "options.preset": "时间预设: this-week(本周), last-week(上周), this-month(本月), last-month(上月), last-7-days, last-15-days, last-30-days",
+  "options.since": "开始日期 (YYYY-MM-DD 格式)，与 --preset 二选一",
+  "options.until": "结束日期 (YYYY-MM-DD 格式)，默认为今天",
+  "options.repository": "仓库路径 (owner/repo 格式)，默认从环境变量获取",
+  "options.format": "输出格式: table, json, markdown",
+  "options.output": "输出目标: console(控制台), issue(创建 GitHub Issue), file(Markdown 文件)",
+  "options.outputFile": "输出文件路径（当 --output 为 file 时使用）",
+  "options.verbose": "详细日志级别 (1: 过程日志, 2: 详细日志)",
+  "reportOutput": "✅ 报告已输出到: {{location}}",
+  "extensionDescription": "周期统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序"
+}