@riconext/hermes-repo 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rico
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,2 @@
+# hermes-repo
+Hermes-repo 是面向任意 Git 仓库的命令行工具，将 Hermes 式「经验 → 技能 → 自改进」学习闭环映射到文档与团队约定：通过 `init` 生成 `.evolve/captures` 与可选的 `docs/evolves` 树，用 Markdown 模板沉淀纠错、审查与根因；`validate` 检查元数据与引用路径，`doctor` 按 preset 对齐 AGENTS、OpenSpec、Cursor 规则等常见布局。无服务端、不自动改规范、不替代 IDE 里的 AI；升级经 Pull Request，由人审批。主打「Hermes 能力装进 repo」——可挂 CI、跨栈复用，适合希望统一「踩坑有记录、契约能升级、 对外能讲清 Hermes 式闭环」的研发与平台团队。

package/dist/cli.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+
+// src/index.ts
+var PACKAGE_NAME = "@riconext/hermes-repo";
+
+// src/cli.ts
+function readPkgVersion() {
+  const root = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+  const raw = readFileSync(root, "utf8");
+  const pkg = JSON.parse(raw);
+  return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+}
+var version = readPkgVersion();
+var argv = process.argv.slice(2);
+var cmd = argv[0];
+if (cmd === "-v" || cmd === "--version") {
+  process.stdout.write(`${version}
+`);
+  process.exit(0);
+}
+if (cmd === "-h" || cmd === "--help" || cmd === void 0) {
+  process.stdout.write(`${PACKAGE_NAME} v${version}
+
+\u7528\u6CD5:
+  hermes-repo              \u663E\u793A\u672C\u5E2E\u52A9
+  hermes-repo --version    \u663E\u793A\u7248\u672C
+
+\u540E\u7EED\u5C06\u63D0\u4F9B init / validate / doctor \u7B49\u5B50\u547D\u4EE4\uFF08\u89C1\u4ED3\u5E93 docs\uFF09\u3002
+`);
+  process.exit(cmd === void 0 ? 0 : 0);
+}
+process.stderr.write(`\u672A\u77E5\u547D\u4EE4: ${cmd}
+\u8BF7\u4F7F\u7528 hermes-repo --help
+`);
+process.exit(1);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/index.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { PACKAGE_NAME } from \"./index.js\";\n\nfunction readPkgVersion(): string {\n  const root = join(dirname(fileURLToPath(import.meta.url)), \"..\", \"package.json\");\n  const raw = readFileSync(root, \"utf8\");\n  const pkg = JSON.parse(raw) as { version?: string };\n  return typeof pkg.version === \"string\" ? pkg.version : \"0.0.0\";\n}\n\nconst version = readPkgVersion();\nconst argv = process.argv.slice(2);\nconst cmd = argv[0];\n\nif (cmd === \"-v\" || cmd === \"--version\") {\n  process.stdout.write(`${version}\\n`);\n  process.exit(0);\n}\n\nif (cmd === \"-h\" || cmd === \"--help\" || cmd === undefined) {\n  process.stdout.write(`${PACKAGE_NAME} v${version}\n\n用法:\n  hermes-repo              显示本帮助\n  hermes-repo --version    显示版本\n\n后续将提供 init / validate / doctor 等子命令（见仓库 docs）。\n`);\n  process.exit(cmd === undefined ? 0 : 0);\n}\n\nprocess.stderr.write(`未知命令: ${cmd}\\n请使用 hermes-repo --help\\n`);\nprocess.exit(1);\n","/**\n * @riconext/hermes-repo — 库入口（CLI 见 `hermes-repo` bin）。\n */\n\nexport const PACKAGE_NAME = \"@riconext/hermes-repo\" as const;\n"],"mappings":";;;AAAA,SAAS,oBAAoB;AAC7B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;;;ACEvB,IAAM,eAAe;;;ADE5B,SAAS,iBAAyB;AAChC,QAAM,OAAO,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC,GAAG,MAAM,cAAc;AAC/E,QAAM,MAAM,aAAa,MAAM,MAAM;AACrC,QAAM,MAAM,KAAK,MAAM,GAAG;AAC1B,SAAO,OAAO,IAAI,YAAY,WAAW,IAAI,UAAU;AACzD;AAEA,IAAM,UAAU,eAAe;AAC/B,IAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AACjC,IAAM,MAAM,KAAK,CAAC;AAElB,IAAI,QAAQ,QAAQ,QAAQ,aAAa;AACvC,UAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AACnC,UAAQ,KAAK,CAAC;AAChB;AAEA,IAAI,QAAQ,QAAQ,QAAQ,YAAY,QAAQ,QAAW;AACzD,UAAQ,OAAO,MAAM,GAAG,YAAY,KAAK,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAOjD;AACC,UAAQ,KAAK,QAAQ,SAAY,IAAI,CAAC;AACxC;AAEA,QAAQ,OAAO,MAAM,6BAAS,GAAG;AAAA;AAAA,CAA4B;AAC7D,QAAQ,KAAK,CAAC;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+// src/index.ts
+var PACKAGE_NAME = "@riconext/hermes-repo";
+
+exports.PACKAGE_NAME = PACKAGE_NAME;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAIO,IAAM,YAAA,GAAe","file":"index.cjs","sourcesContent":["/**\n * @riconext/hermes-repo — 库入口（CLI 见 `hermes-repo` bin）。\n */\n\nexport const PACKAGE_NAME = \"@riconext/hermes-repo\" as const;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+/**
+ * @riconext/hermes-repo — 库入口（CLI 见 `hermes-repo` bin）。
+ */
+declare const PACKAGE_NAME: "@riconext/hermes-repo";
+
+export { PACKAGE_NAME };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @riconext/hermes-repo — 库入口（CLI 见 `hermes-repo` bin）。
+ */
+declare const PACKAGE_NAME: "@riconext/hermes-repo";
+
+export { PACKAGE_NAME };

package/dist/index.js

@@ -0,0 +1,6 @@
+// src/index.ts
+var PACKAGE_NAME = "@riconext/hermes-repo";
+
+export { PACKAGE_NAME };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAIO,IAAM,YAAA,GAAe","file":"index.js","sourcesContent":["/**\n * @riconext/hermes-repo — 库入口（CLI 见 `hermes-repo` bin）。\n */\n\nexport const PACKAGE_NAME = \"@riconext/hermes-repo\" as const;\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@riconext/hermes-repo",
+  "version": "0.1.0",
+  "description": "Hermes-repo 是面向任意 Git 仓库的命令行工具，将 Hermes 式「经验 → 技能 → 自改进」学习闭环映射到文档与团队约定的工具，适合希望统一「踩坑有记录、契约能升级、 规范能进化」的研发与平台团队。",
+  "license": "MIT",
+  "author": {
+    "name": "Rico",
+    "url": "https://github.com/ricoNext"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ricoNext/hermes-repo.git"
+  },
+  "homepage": "https://github.com/ricoNext/hermes-repo#readme",
+  "bugs": {
+    "url": "https://github.com/ricoNext/hermes-repo/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "hermes-repo": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "hermes-repo",
+    "evolve",
+    "git",
+    "cli",
+    "documentation",
+    "captures"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.0"
+  }
+}