openspec-stat 1.0.0

package/dist/esm/i18n/locales/en.json

@@ -0,0 +1,72 @@
+{
+  "cli.description": "Track team members' OpenSpec proposals and code changes in Git repositories",
+  "cli.option.repo": "Repository path",
+  "cli.option.branches": "Branch list, comma-separated",
+  "cli.option.noInteractive": "Disable interactive branch selection",
+  "cli.option.since": "Start time (default: yesterday 20:00)",
+  "cli.option.until": "End time (default: today 20:00)",
+  "cli.option.author": "Filter by specific author",
+  "cli.option.json": "Output in JSON format",
+  "cli.option.csv": "Output in CSV format",
+  "cli.option.markdown": "Output in Markdown format",
+  "cli.option.config": "Configuration file path",
+  "cli.option.verbose": "Verbose output mode",
+  "cli.option.lang": "Language for output (en, zh-CN)",
+  
+  "loading.config": "🔍 Loading configuration...",
+  "loading.activeUsers": "🔍 Fetching active users...",
+  "loading.analyzing": "🔍 Analyzing commit history...",
+  
+  "info.timeRange": "📅 Time Range: {{since}} ~ {{until}}",
+  "info.branches": "🌿 Branches: {{branches}}",
+  "info.allBranches": "All branches",
+  "info.activeUsers": "   Active users (within {{weeks}} weeks): {{users}}",
+  "info.foundCommits": "📝 Found {{count}} commits, analyzing...",
+  "info.analysisProgress": "   Analysis progress: {{current}}/{{total}}",
+  "info.qualifyingCommits": "✅ Found {{count}} qualifying commits (containing OpenSpec proposals and code changes)",
+  
+  "warning.noCommits": "⚠️  No commits found matching the criteria",
+  "warning.noQualifyingCommits": "⚠️  No commits found containing both OpenSpec proposals and code changes",
+  "warning.noBranches": "⚠️  No remote branches found",
+  
+  "error.prefix": "❌ Error:",
+  
+  "branch.fetching": "\n🔍 Fetching active branches...",
+  "branch.selectMode": "How would you like to select branches?",
+  "branch.mode.select": "Select from active branches",
+  "branch.mode.default": "Use default branches from config",
+  "branch.mode.custom": "Custom input",
+  "branch.selectPrompt": "Select branches to analyze:",
+  "branch.customInput": "Enter branch names (comma-separated):",
+  "branch.additionalInput": "Enter additional branch names (comma-separated):",
+  "branch.customSeparator": "--- Custom input ---",
+  "branch.selected": "\n✓ Selected branches:",
+  "branch.lastCommit": "last commit: {{date}}",
+  
+  "output.title": "\n📊 OpenSpec Statistics Report\n",
+  "output.timeRange": "Time Range: {{since}} ~ {{until}}\n",
+  "output.branches": "Branches: {{branches}}\n",
+  "output.totalCommits": "Total Commits: {{count}}\n\n",
+  "output.proposals": "  Proposals: {{proposals}}\n",
+  
+  "table.branch": "Branch",
+  "table.period": "Period",
+  "table.commits": "Commits",
+  "table.proposals": "Proposals",
+  "table.codeFiles": "Code Files",
+  "table.additions": "Additions",
+  "table.deletions": "Deletions",
+  "table.netChanges": "Net Changes",
+  "table.author": "Author",
+  "table.lastCommitDate": "Last Commit Date",
+  "table.proposalsList": "Proposals List",
+  "table.proposalsCount": "Proposals Count",
+  "table.totalDeduplicated": "TOTAL (Deduplicated)",
+  
+  "markdown.title": "# OpenSpec Statistics Report\n\n",
+  "markdown.timeRange": "**Time Range**: {{since}} ~ {{until}}\n\n",
+  "markdown.branches": "**Branches**: {{branches}}\n\n",
+  "markdown.totalCommits": "**Total Commits**: {{count}}\n\n",
+  "markdown.statistics": "## Statistics\n\n",
+  "markdown.proposalDetails": "\n## Proposal Details\n\n"
+}

package/dist/esm/i18n/locales/zh-CN.json

@@ -0,0 +1,72 @@
+{
+  "cli.description": "追踪团队成员的 OpenSpec 提案和代码变更",
+  "cli.option.repo": "仓库路径",
+  "cli.option.branches": "分支列表，逗号分隔",
+  "cli.option.noInteractive": "禁用交互式分支选择",
+  "cli.option.since": "开始时间（默认：昨天 20:00）",
+  "cli.option.until": "结束时间（默认：今天 20:00）",
+  "cli.option.author": "按特定作者筛选",
+  "cli.option.json": "以 JSON 格式输出",
+  "cli.option.csv": "以 CSV 格式输出",
+  "cli.option.markdown": "以 Markdown 格式输出",
+  "cli.option.config": "配置文件路径",
+  "cli.option.verbose": "详细输出模式",
+  "cli.option.lang": "输出语言（en, zh-CN）",
+  
+  "loading.config": "🔍 正在加载配置...",
+  "loading.activeUsers": "🔍 正在获取活跃用户...",
+  "loading.analyzing": "🔍 正在分析提交历史...",
+  
+  "info.timeRange": "📅 时间范围：{{since}} ~ {{until}}",
+  "info.branches": "🌿 分支：{{branches}}",
+  "info.allBranches": "所有分支",
+  "info.activeUsers": "   活跃用户（{{weeks}} 周内）：{{users}}",
+  "info.foundCommits": "📝 找到 {{count}} 个提交，正在分析...",
+  "info.analysisProgress": "   分析进度：{{current}}/{{total}}",
+  "info.qualifyingCommits": "✅ 找到 {{count}} 个符合条件的提交（包含 OpenSpec 提案和代码变更）",
+  
+  "warning.noCommits": "⚠️  未找到符合条件的提交",
+  "warning.noQualifyingCommits": "⚠️  未找到同时包含 OpenSpec 提案和代码变更的提交",
+  "warning.noBranches": "⚠️  未找到远程分支",
+  
+  "error.prefix": "❌ 错误：",
+  
+  "branch.fetching": "\n🔍 正在获取活跃分支...",
+  "branch.selectMode": "您想如何选择分支？",
+  "branch.mode.select": "从活跃分支中选择",
+  "branch.mode.default": "使用配置文件中的默认分支",
+  "branch.mode.custom": "自定义输入",
+  "branch.selectPrompt": "选择要分析的分支：",
+  "branch.customInput": "输入分支名称（逗号分隔）：",
+  "branch.additionalInput": "输入额外的分支名称（逗号分隔）：",
+  "branch.customSeparator": "--- 自定义输入 ---",
+  "branch.selected": "\n✓ 已选择的分支：",
+  "branch.lastCommit": "最后提交：{{date}}",
+  
+  "output.title": "\n📊 OpenSpec 统计报告\n",
+  "output.timeRange": "时间范围：{{since}} ~ {{until}}\n",
+  "output.branches": "分支：{{branches}}\n",
+  "output.totalCommits": "总提交数：{{count}}\n\n",
+  "output.proposals": "  提案：{{proposals}}\n",
+  
+  "table.branch": "分支",
+  "table.period": "周期",
+  "table.commits": "提交数",
+  "table.proposals": "提案数",
+  "table.codeFiles": "代码文件",
+  "table.additions": "新增行数",
+  "table.deletions": "删除行数",
+  "table.netChanges": "净变更",
+  "table.author": "作者",
+  "table.lastCommitDate": "最后提交日期",
+  "table.proposalsList": "提案列表",
+  "table.proposalsCount": "提案数量",
+  "table.totalDeduplicated": "总计（去重）",
+  
+  "markdown.title": "# OpenSpec 统计报告\n\n",
+  "markdown.timeRange": "**时间范围**：{{since}} ~ {{until}}\n\n",
+  "markdown.branches": "**分支**：{{branches}}\n\n",
+  "markdown.totalCommits": "**总提交数**：{{count}}\n\n",
+  "markdown.statistics": "## 统计数据\n\n",
+  "markdown.proposalDetails": "\n## 提案详情\n\n"
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+export { GitAnalyzer } from './git-analyzer.js';
+export { StatsAggregator } from './stats-aggregator.js';
+export { OutputFormatter } from './formatters.js';
+export { loadConfig, normalizeAuthor } from './config.js';
+export { getDefaultTimeRange, parseDateTime, parseBranches } from './time-utils.js';
+export * from './types.js';

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+export { GitAnalyzer } from "./git-analyzer.js";
+export { StatsAggregator } from "./stats-aggregator.js";
+export { OutputFormatter } from "./formatters.js";
+export { loadConfig, normalizeAuthor } from "./config.js";
+export { getDefaultTimeRange, parseDateTime, parseBranches } from "./time-utils.js";
+export * from "./types.js";

package/dist/esm/stats-aggregator.d.ts

@@ -0,0 +1,7 @@
+import { CommitAnalysis, StatsResult, Config } from './types.js';
+export declare class StatsAggregator {
+    private config;
+    private activeAuthors?;
+    constructor(config: Config, activeAuthors?: Set<string>);
+    aggregate(analyses: CommitAnalysis[], since: Date, until: Date, branches: string[], filterAuthor?: string): StatsResult;
+}

package/dist/esm/stats-aggregator.js

@@ -0,0 +1,149 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { normalizeAuthor } from "./config.js";
+export var StatsAggregator = /*#__PURE__*/function () {
+  function StatsAggregator(config, activeAuthors) {
+    _classCallCheck(this, StatsAggregator);
+    _defineProperty(this, "config", void 0);
+    _defineProperty(this, "activeAuthors", void 0);
+    this.config = config;
+    this.activeAuthors = activeAuthors;
+  }
+  _createClass(StatsAggregator, [{
+    key: "aggregate",
+    value: function aggregate(analyses, since, until, branches, filterAuthor) {
+      var authorStatsMap = new Map();
+      var _iterator = _createForOfIteratorHelper(analyses),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var analysis = _step.value;
+          var normalizedAuthor = normalizeAuthor(analysis.commit.author, this.config.authorMapping);
+          if (this.activeAuthors && !this.activeAuthors.has(normalizedAuthor)) {
+            continue;
+          }
+          if (filterAuthor && normalizedAuthor !== filterAuthor) {
+            continue;
+          }
+          var stats = authorStatsMap.get(normalizedAuthor);
+          if (!stats) {
+            stats = {
+              author: normalizedAuthor,
+              commits: 0,
+              openspecProposals: new Set(),
+              codeFilesChanged: 0,
+              additions: 0,
+              deletions: 0,
+              netChanges: 0,
+              branchStats: new Map()
+            };
+            authorStatsMap.set(normalizedAuthor, stats);
+          }
+          stats.commits++;
+          stats.additions += analysis.totalAdditions;
+          stats.deletions += analysis.totalDeletions;
+          stats.netChanges += analysis.netChanges;
+          stats.codeFilesChanged += analysis.codeFiles.length;
+          var _iterator3 = _createForOfIteratorHelper(analysis.openspecProposals),
+            _step3;
+          try {
+            for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+              var _proposal = _step3.value;
+              stats.openspecProposals.add(_proposal);
+            }
+          } catch (err) {
+            _iterator3.e(err);
+          } finally {
+            _iterator3.f();
+          }
+          if (!stats.lastCommitDate || analysis.commit.date > stats.lastCommitDate) {
+            stats.lastCommitDate = analysis.commit.date;
+          }
+          if (!stats.firstCommitDate || analysis.commit.date < stats.firstCommitDate) {
+            stats.firstCommitDate = analysis.commit.date;
+          }
+          if (analysis.commit.branches && stats.branchStats) {
+            var _iterator4 = _createForOfIteratorHelper(analysis.commit.branches),
+              _step4;
+            try {
+              for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+                var branch = _step4.value;
+                var branchStat = stats.branchStats.get(branch);
+                if (!branchStat) {
+                  branchStat = {
+                    branch: branch,
+                    commits: 0,
+                    openspecProposals: new Set(),
+                    codeFilesChanged: 0,
+                    additions: 0,
+                    deletions: 0,
+                    netChanges: 0
+                  };
+                  stats.branchStats.set(branch, branchStat);
+                }
+                branchStat.commits++;
+                branchStat.additions += analysis.totalAdditions;
+                branchStat.deletions += analysis.totalDeletions;
+                branchStat.netChanges += analysis.netChanges;
+                branchStat.codeFilesChanged += analysis.codeFiles.length;
+                var _iterator5 = _createForOfIteratorHelper(analysis.openspecProposals),
+                  _step5;
+                try {
+                  for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+                    var proposal = _step5.value;
+                    branchStat.openspecProposals.add(proposal);
+                  }
+                } catch (err) {
+                  _iterator5.e(err);
+                } finally {
+                  _iterator5.f();
+                }
+              }
+            } catch (err) {
+              _iterator4.e(err);
+            } finally {
+              _iterator4.f();
+            }
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      var _iterator2 = _createForOfIteratorHelper(authorStatsMap.values()),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var _stats = _step2.value;
+          if (_stats.firstCommitDate && _stats.lastCommitDate) {
+            var days = Math.ceil((_stats.lastCommitDate.getTime() - _stats.firstCommitDate.getTime()) / (1000 * 60 * 60 * 24));
+            _stats.statisticsPeriod = days === 0 ? '1 day' : "".concat(days + 1, " days");
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+      return {
+        timeRange: {
+          since: since,
+          until: until
+        },
+        branches: branches,
+        authors: authorStatsMap,
+        totalCommits: analyses.length
+      };
+    }
+  }]);
+  return StatsAggregator;
+}();

package/dist/esm/time-utils.d.ts

@@ -0,0 +1,6 @@
+export declare function getDefaultTimeRange(sinceHours?: number, untilHours?: number): {
+    since: Date;
+    until: Date;
+};
+export declare function parseDateTime(dateStr: string): Date;
+export declare function parseBranches(branchesStr?: string): string[];

package/dist/esm/time-utils.js

@@ -0,0 +1,31 @@
+export function getDefaultTimeRange() {
+  var sinceHours = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : -30;
+  var untilHours = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 20;
+  var now = new Date();
+  var today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+  var yesterday = new Date(today);
+  yesterday.setDate(yesterday.getDate() - 1);
+  var since = new Date(yesterday);
+  since.setHours(untilHours, 0, 0, 0);
+  var until = new Date(today);
+  until.setHours(untilHours, 0, 0, 0);
+  return {
+    since: since,
+    until: until
+  };
+}
+export function parseDateTime(dateStr) {
+  var date = new Date(dateStr);
+  if (isNaN(date.getTime())) {
+    throw new Error("Invalid date format: ".concat(dateStr));
+  }
+  return date;
+}
+export function parseBranches(branchesStr) {
+  if (!branchesStr) return [];
+  return branchesStr.split(',').map(function (b) {
+    return b.trim();
+  }).filter(function (b) {
+    return b;
+  });
+}

package/dist/esm/types.d.ts

@@ -0,0 +1,77 @@
+export interface Config {
+    defaultBranches?: string[];
+    defaultSinceHours?: number;
+    defaultUntilHours?: number;
+    authorMapping?: Record<string, string>;
+    openspecDir?: string;
+    codeFileExtensions?: string[];
+    excludeExtensions?: string[];
+    activeUserWeeks?: number;
+}
+export interface CliOptions {
+    repo: string;
+    branches?: string;
+    since?: string;
+    until?: string;
+    author?: string;
+    json?: boolean;
+    csv?: boolean;
+    markdown?: boolean;
+    config?: string;
+    verbose?: boolean;
+    interactive?: boolean;
+    lang?: string;
+}
+export interface CommitInfo {
+    hash: string;
+    author: string;
+    email: string;
+    date: Date;
+    message: string;
+    branches?: string[];
+}
+export interface FileChange {
+    path: string;
+    additions: number;
+    deletions: number;
+    status: string;
+}
+export interface CommitAnalysis {
+    commit: CommitInfo;
+    openspecProposals: Set<string>;
+    codeFiles: FileChange[];
+    totalAdditions: number;
+    totalDeletions: number;
+    netChanges: number;
+}
+export interface AuthorStats {
+    author: string;
+    commits: number;
+    openspecProposals: Set<string>;
+    codeFilesChanged: number;
+    additions: number;
+    deletions: number;
+    netChanges: number;
+    lastCommitDate?: Date;
+    firstCommitDate?: Date;
+    statisticsPeriod?: string;
+    branchStats?: Map<string, BranchStats>;
+}
+export interface BranchStats {
+    branch: string;
+    commits: number;
+    openspecProposals: Set<string>;
+    codeFilesChanged: number;
+    additions: number;
+    deletions: number;
+    netChanges: number;
+}
+export interface StatsResult {
+    timeRange: {
+        since: Date;
+        until: Date;
+    };
+    branches: string[];
+    authors: Map<string, AuthorStats>;
+    totalCommits: number;
+}

package/dist/esm/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "openspec-stat",
+  "version": "1.0.0",
+  "description": "Track team members' OpenSpec proposals and code changes in Git repositories",
+  "main": "dist/cjs/index.js",
+  "types": "dist/cjs/index.d.ts",
+  "type": "module",
+  "bin": {
+    "openspec-stat": "dist/esm/cli.js"
+  },
+  "scripts": {
+    "dev": "father dev",
+    "build": "father build",
+    "build:deps": "father prebundle",
+    "prepublishOnly": "father doctor && npm run build",
+    "test:cli": "node dist/esm/cli.js --help",
+    "link:global": "npm link"
+  },
+  "keywords": [
+    "openspec",
+    "git",
+    "statistics",
+    "cli",
+    "analytics"
+  ],
+  "authors": [
+    "Orchard <orchardyz@outlook.com>"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Orchardxyz/openspec-stat.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Orchardxyz/openspec-stat/issues"
+  },
+  "homepage": "https://github.com/Orchardxyz/openspec-stat#readme",
+  "files": [
+    "dist",
+    "compiled"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "father": "^4.6.13"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.1.0",
+    "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.2",
+    "date-fns": "^4.1.0",
+    "simple-git": "^3.30.0"
+  }
+}