@seed-fe/mfa-git 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Nicholas Hsiang
+
+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,107 @@
+# @seed-fe/mfa-git
+
+English | [简体中文](README.zh-CN.md)
+
+Git operations and release naming rules for [MFA](https://github.com/xianghongai/seed-fe-mfa) workspaces, used by the `mfa` CLI and the VS Code extension. Git runs on the `git` command line through [simple-git](https://github.com/steveukx/git-js). Authentication, SSH keys, credential helpers and proxies all stay with the developer's own Git setup; nothing here asks for or stores credentials, and no hosting service API is involved.
+
+- Pulls only fetch and fast-forward, and never switch branches. When git refuses to fast-forward, the result says so instead of throwing.
+- Pushes never force. A rejected push is a result, not an exception.
+- Remotes are resolved from the branch upstream, then the only remote of the repository. The name is never assumed to be `origin`.
+- ES modules only, for Node.js.
+
+## Install
+
+```sh
+npm install @seed-fe/mfa-git
+```
+
+## Usage
+
+Every function takes the directory to run in as `cwd`, plus optional `env`, `signal`, `onCommand` and `onOutput`:
+
+- `env` is merged over `process.env`, for example to add an outbound proxy. `GIT_TERMINAL_PROMPT=0` is always set, so git never waits for a password prompt.
+- `signal` cancels the running git process.
+- `onCommand` receives each command line before it runs; `onOutput` receives stdout and stderr as they arrive.
+
+```ts
+import { branchStatus, pullBranch, pushBranch } from '@seed-fe/mfa-git';
+
+const status = await branchStatus({ cwd: '/path/to/repo', branch: 'release/1.0.0' });
+// { branch, remote: 'upstream', state: 'ok', behind: 2, ahead: 1 }
+
+const pulled = await pullBranch({ cwd: '/path/to/repo', branch: 'release/1.0.0' });
+// outcome: 'updated' | 'upToDate' | 'fetchedOnly' | 'skipped'
+
+const pushed = await pushBranch({ cwd: '/path/to/repo', branch: 'release/1.0.0' });
+// outcome: 'pushed' | 'upToDate' | 'rejected' | 'skipped'
+```
+
+### Branches
+
+| Function                        | What it does                                                                                                            |
+| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `branchStatus({ cwd, branch })` | Fetches, then counts commits `behind` and `ahead` of the remote branch. Changes no local branch or file.                |
+| `pullBranch({ cwd, branch })`   | Fetches, then fast-forwards: `merge --ff-only` when the branch is checked out, otherwise only the branch pointer moves. |
+| `pushBranch({ cwd, branch })`   | Pushes the branch to the remote branch of the same name without checking it out, creating it when missing.              |
+
+`state` explains when a branch cannot be checked: `noRepository`, `noRemote`, `remoteBranchMissing` or `failed` (with `message`).
+
+### Tags
+
+```ts
+import { createTag } from '@seed-fe/mfa-git';
+
+await createTag({
+  cwd: '/path/to/repo',
+  name: '1.2.0',
+  commit: 'a1b2c3d',
+  message: 'Release notes\n\n#123 fixed paging', // optional: creates an annotated tag
+  force: true, // optional: overwrite an existing tag, on the remote too
+  push: { remote: 'upstream' }, // optional
+});
+```
+
+The message is kept as written, including lines starting with `#`. When the push fails, the local tag is removed, or restored when it was overwritten.
+
+### Sources
+
+| Function                                          | What it does                                                                                          |
+| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `clone({ url, directory, branch?, submodules? })` | Clones into `directory`, creating its parents. Submodules are included by default.                    |
+| `checkoutTag({ url, tag, directory })`            | Shallow-fetches one tag by URL and checks it out as a detached HEAD, with submodules. Adds no remote. |
+
+### Release versions
+
+Versions follow the MFA naming conventions: an optional `v` prefix (a Tag equals `release.version`), the base version, a patch level (`HP`, `CP` or `SP`, for projects), the maturity (`alpha`, `beta` or `rc`; none once released) and, always last, a customer edition `C<customer>` with its delivery batch `-U<n>`. For example `1.7.1-alpha.3`, `2.6.0.SP1-rc.1` and `1.7.1-rc.1.CICBC-U2`. Every version is a valid Docker image tag, so `+` is rejected.
+
+```ts
+import { releaseCandidates } from '@seed-fe/mfa-git';
+
+releaseCandidates('1.7.1-alpha.3.CICBC-U2');
+// { ok: true, candidates: { iterate: '1.7.1-alpha.4.CICBC-U2', advance: { stage: 'beta', version: '1.7.1-beta.1.CICBC-U2' } } }
+```
+
+Only the maturity moves; patch levels and customer editions are planned by the project and kept as written. A released version, a version with `+` and an invalid one give `released`, `plusNotAllowed` and `versionInvalid`. `parseReleaseVersion`, `formatReleaseVersion`, `releaseLine` and `compareReleaseVersions` read, write, group and order versions; only versions of the same line (base, patch level and customer edition) are compared.
+
+### Repository
+
+| Function                                                   | Returns                                                                               |
+| ---------------------------------------------------------- | ------------------------------------------------------------------------------------- |
+| `isRepositoryRoot({ cwd })`                                | Whether `cwd` is itself a repository root, not a directory inside an outer repository |
+| `currentBranch({ cwd })`                                   | The checked-out branch; `undefined` on a detached HEAD                                |
+| `resolveRemote({ cwd, branch? })`                          | The branch upstream remote, otherwise the only remote                                 |
+| `remoteUrl({ cwd, remote?, branch? })`                     | URL of the given or resolved remote                                                   |
+| `resolveCommit({ cwd, ref })` / `commitInfo({ cwd, ref })` | Commit SHA; or `{ sha, shortSha, subject }`                                           |
+| `mergedTags({ cwd, ref })` / `tagExists({ cwd, name })`    | Tags reachable from a ref; whether a tag exists                                       |
+| `sameTree({ cwd, a, b })`                                  | Whether two refs have the same content                                                |
+| `worktreeChanges({ cwd })`                                 | Number of tracked files with uncommitted changes                                      |
+
+`createGit(options)` gives the underlying runner (`run` and `probe`) for commands not covered here.
+
+## Environment
+
+simple-git rejects environment variables such as `GIT_SSH_COMMAND`, `GIT_ASKPASS`, `GIT_CONFIG_*` and even `PAGER` by default. This package runs fixed commands and uses the developer's own environment, so those checks are turned off for environment and configuration categories only.
+
+## License
+
+[MIT](LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,107 @@
+# @seed-fe/mfa-git
+
+[English](README.md) | 简体中文
+
+[MFA](https://github.com/xianghongai/seed-fe-mfa) 工作区的 Git 操作与发布命名规则，供 `mfa` 命令行和 VS Code 扩展使用。Git 通过 [simple-git](https://github.com/steveukx/git-js) 调用本机的 `git` 命令行。认证、SSH 密钥、凭据助手和代理全部沿用开发者自己的 Git 配置：本包不索取、不保存凭据，也不调用任何托管平台的 API。
+
+- 拉取只获取和快进，不切换分支。Git 拒绝快进时在结果中说明，不抛错。
+- 推送不强推，被远程拒绝时作为结果返回，不抛错。
+- 远程按分支的上游解析，其次是仓库唯一的远程，不假定叫 `origin`。
+- 只提供 ES 模块，用于 Node.js。
+
+## 安装
+
+```sh
+npm install @seed-fe/mfa-git
+```
+
+## 使用
+
+每个函数都用 `cwd` 指定运行目录，可选 `env`、`signal`、`onCommand`、`onOutput`：
+
+- `env` 合并到 `process.env` 之上，例如加入出站代理。始终设置 `GIT_TERMINAL_PROMPT=0`，Git 不会停下来等待输入密码。
+- `signal` 取消正在运行的 Git 进程。
+- `onCommand` 在每条命令运行前收到命令行；`onOutput` 实时收到标准输出和标准错误。
+
+```ts
+import { branchStatus, pullBranch, pushBranch } from '@seed-fe/mfa-git';
+
+const status = await branchStatus({ cwd: '/path/to/repo', branch: 'release/1.0.0' });
+// { branch, remote: 'upstream', state: 'ok', behind: 2, ahead: 1 }
+
+const pulled = await pullBranch({ cwd: '/path/to/repo', branch: 'release/1.0.0' });
+// outcome: 'updated' | 'upToDate' | 'fetchedOnly' | 'skipped'
+
+const pushed = await pushBranch({ cwd: '/path/to/repo', branch: 'release/1.0.0' });
+// outcome: 'pushed' | 'upToDate' | 'rejected' | 'skipped'
+```
+
+### 分支
+
+| 函数                            | 作用                                                                              |
+| ------------------------------- | --------------------------------------------------------------------------------- |
+| `branchStatus({ cwd, branch })` | 获取远程后，统计落后（`behind`）与领先（`ahead`）的提交数。不改动本地分支和文件。 |
+| `pullBranch({ cwd, branch })`   | 获取远程后快进：分支已检出时 `merge --ff-only`，否则只移动分支指针。              |
+| `pushBranch({ cwd, branch })`   | 不检出分支，把它推送到远程同名分支；远程没有时创建。                              |
+
+无法检查时，`state` 说明原因：`noRepository`、`noRemote`、`remoteBranchMissing`，或 `failed`（附 `message`）。
+
+### Tag
+
+```ts
+import { createTag } from '@seed-fe/mfa-git';
+
+await createTag({
+  cwd: '/path/to/repo',
+  name: '1.2.0',
+  commit: 'a1b2c3d',
+  message: 'Release notes\n\n#123 fixed paging', // 可选：创建附注 Tag
+  force: true, // 可选：覆盖已有的同名 Tag，远程同样覆盖
+  push: { remote: 'upstream' }, // 可选
+});
+```
+
+说明原样保留，包括以 `#` 开头的行。推送失败时，新建的本地 Tag 被删除；覆盖的则恢复原状。
+
+### 源码
+
+| 函数                                              | 作用                                                             |
+| ------------------------------------------------- | ---------------------------------------------------------------- |
+| `clone({ url, directory, branch?, submodules? })` | 克隆到 `directory`，自动创建上级目录；默认包含子模块。           |
+| `checkoutTag({ url, tag, directory })`            | 按地址浅获取单个 Tag，检出为分离 HEAD 并更新子模块；不添加远程。 |
+
+### 发布版本
+
+版本遵循 MFA 命名规范：可选的 `v` 前缀（Tag 与 `release.version` 完全一致）、基线版本、补丁（`HP`、`CP`、`SP`，仅项目）、成熟度（`alpha`、`beta`、`rc`，正式版没有），以及始终在最后的客户定制 `C<客户代号>` 与更新批次 `-U<n>`。例如 `1.7.1-alpha.3`、`2.6.0.SP1-rc.1`、`1.7.1-rc.1.CICBC-U2`。每个版本都是合法的 Docker 镜像 Tag，因此不允许 `+`。
+
+```ts
+import { releaseCandidates } from '@seed-fe/mfa-git';
+
+releaseCandidates('1.7.1-alpha.3.CICBC-U2');
+// { ok: true, candidates: { iterate: '1.7.1-alpha.4.CICBC-U2', advance: { stage: 'beta', version: '1.7.1-beta.1.CICBC-U2' } } }
+```
+
+只推进成熟度；补丁与客户定制由项目规划，原样保留。正式版、含 `+` 的版本和不合规的版本分别返回 `released`、`plusNotAllowed`、`versionInvalid`。`parseReleaseVersion`、`formatReleaseVersion`、`releaseLine`、`compareReleaseVersions` 用于解析、格式化、划分产品线与排序；只比较同一产品线（基线、补丁、客户定制）内的版本。
+
+### 仓库
+
+| 函数                                                       | 返回                                             |
+| ---------------------------------------------------------- | ------------------------------------------------ |
+| `isRepositoryRoot({ cwd })`                                | `cwd` 本身是否为仓库根，而不是外层仓库里的子目录 |
+| `currentBranch({ cwd })`                                   | 当前分支；分离 HEAD 时为 `undefined`             |
+| `resolveRemote({ cwd, branch? })`                          | 分支上游的远程，否则为唯一的远程                 |
+| `remoteUrl({ cwd, remote?, branch? })`                     | 指定或解析出的远程地址                           |
+| `resolveCommit({ cwd, ref })` / `commitInfo({ cwd, ref })` | 提交 SHA；或 `{ sha, shortSha, subject }`        |
+| `mergedTags({ cwd, ref })` / `tagExists({ cwd, name })`    | 从某个引用可达的 Tag；Tag 是否存在               |
+| `sameTree({ cwd, a, b })`                                  | 两个引用的内容是否相同                           |
+| `worktreeChanges({ cwd })`                                 | 有未提交改动的已跟踪文件数                       |
+
+其它命令可以用 `createGit(options)` 取得底层的执行器（`run` 与 `probe`）。
+
+## 环境变量
+
+simple-git 默认拒绝 `GIT_SSH_COMMAND`、`GIT_ASKPASS`、`GIT_CONFIG_*`，甚至普通的 `PAGER` 等环境变量。本包执行的命令都是固定的，使用的是开发者自己的环境，因此只对环境变量与配置相关的类别关闭了这些检查。
+
+## License
+
+[MIT](LICENSE)

package/dist/clone.d.ts

@@ -0,0 +1,22 @@
+import { type GitOptions } from './git.js';
+export interface CloneOptions extends Omit<GitOptions, 'cwd'> {
+    url: string;
+    directory: string;
+    /** Branch to check out; defaults to the remote's default branch. */
+    branch?: string | undefined;
+    /** Clones submodules too; defaults to `true`. */
+    submodules?: boolean | undefined;
+}
+/** Clones `url` into `directory`, creating its parent directories. */
+export declare const clone: ({ url, directory, branch, submodules, ...options }: CloneOptions) => Promise<void>;
+export interface CheckoutTagOptions extends Omit<GitOptions, 'cwd'> {
+    url: string;
+    tag: string;
+    directory: string;
+}
+/**
+ * Checks out exactly one tag of `url` into `directory` with a shallow fetch, as a detached HEAD, with submodules.
+ * The repository is fetched by URL, so no remote name is added or assumed.
+ */
+export declare const checkoutTag: ({ url, tag, directory, ...options }: CheckoutTagOptions) => Promise<void>;
+//# sourceMappingURL=clone.d.ts.map

package/dist/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAED,sEAAsE;AACtE,eAAO,MAAM,KAAK,uDAAqE,YAAY,KAAG,OAAO,CAAC,IAAI,CAWjH,CAAC;AAEF,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,wCAA+C,kBAAkB,KAAG,OAAO,CAAC,IAAI,CAQvG,CAAC"}

package/dist/clone.js

@@ -0,0 +1,33 @@
+/**
+ * Getting sources: cloning a repository, or checking out a single tag into an empty directory.
+ */
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { createGit } from './git.js';
+/** Clones `url` into `directory`, creating its parent directories. */
+export const clone = async ({ url, directory, branch, submodules = true, ...options }) => {
+    const parent = path.dirname(directory);
+    await mkdir(parent, { recursive: true });
+    await createGit({ ...options, cwd: parent }).run([
+        'clone',
+        ...(branch ? ['--branch', branch] : []),
+        ...(submodules ? ['--recurse-submodules'] : []),
+        '--',
+        url,
+        directory,
+    ]);
+};
+/**
+ * Checks out exactly one tag of `url` into `directory` with a shallow fetch, as a detached HEAD, with submodules.
+ * The repository is fetched by URL, so no remote name is added or assumed.
+ */
+export const checkoutTag = async ({ url, tag, directory, ...options }) => {
+    await mkdir(directory, { recursive: true });
+    const git = createGit({ ...options, cwd: directory });
+    const ref = `refs/tags/${tag}`;
+    await git.run(['init', '--quiet']);
+    await git.run(['fetch', '--depth=1', '--', url, `${ref}:${ref}`]);
+    await git.run(['checkout', '--detach', ref]);
+    await git.run(['submodule', 'update', '--init', '--recursive']);
+};
+//# sourceMappingURL=clone.js.map

package/dist/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAmB,MAAM,UAAU,CAAC;AAWtD,sEAAsE;AACtE,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,GAAG,OAAO,EAAgB,EAAiB,EAAE;IACpH,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC;QAC/C,OAAO;QACP,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,IAAI;QACJ,GAAG;QACH,SAAS;KACV,CAAC,CAAC;AACL,CAAC,CAAC;AAQF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,EAAsB,EAAiB,EAAE;IAC1G,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,aAAa,GAAG,EAAE,CAAC;IAC/B,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,22 @@
+export interface GitOptions {
+    /** Directory the commands run in. */
+    cwd: string;
+    /** Extra environment variables, e.g. an outbound proxy; merged over `process.env`. */
+    env?: Record<string, string | undefined> | undefined;
+    signal?: AbortSignal | undefined;
+    /** Called with each command line before it runs, e.g. `git fetch --tags -- origin`. */
+    onCommand?: ((command: string) => void) | undefined;
+    /** Called with stdout and stderr chunks as they arrive. */
+    onOutput?: ((text: string) => void) | undefined;
+}
+export interface Git {
+    /** Runs a command and returns its trimmed stdout; rejects when git exits with an error. */
+    run(args: string[]): Promise<string>;
+    /** Runs a command for probing: any failure other than cancellation resolves to `undefined`. */
+    probe(args: string[]): Promise<string | undefined>;
+}
+export declare const errorMessage: (error: unknown) => string;
+export declare const createGit: (options: GitOptions) => Git;
+/** simple-git requires an existing base directory; a missing one simply has no repository. */
+export declare const directoryExists: (directory: string) => boolean;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,uFAAuF;IACvF,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpD,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,WAAW,GAAG;IAClB,2FAA2F;IAC3F,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,+FAA+F;IAC/F,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,MAAkE,CAAC;AAQjH,eAAO,MAAM,SAAS,YAAa,UAAU,KAAG,GA2C/C,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,eAAe,cAAe,MAAM,KAAG,OAAgC,CAAC"}

package/dist/git.js

@@ -0,0 +1,59 @@
+/**
+ * Runs git through simple-git in a directory, with the developer's own environment and Git configuration.
+ */
+import { existsSync } from 'node:fs';
+import { simpleGit } from 'simple-git';
+export const errorMessage = (error) => (error instanceof Error ? error.message : String(error));
+const throwIfAborted = (signal) => {
+    if (signal?.aborted) {
+        throw signal.reason ?? new Error('Aborted');
+    }
+};
+export const createGit = (options) => {
+    // simple-git replaces the environment instead of merging it; never prompt for credentials interactively.
+    const env = { ...process.env, GIT_TERMINAL_PROMPT: '0', ...options.env };
+    const client = simpleGit({
+        baseDir: options.cwd,
+        trimmed: true,
+        ...(options.signal ? { abort: options.signal } : {}),
+        // Commands and their arguments are fixed by this package; the environment and configuration are the
+        // developer's own (SSH command, askpass, credential helper, proxy, even an ordinary PAGER or GIT_EDITOR).
+        // simple-git rejects them by default, and its environment guard would throw on the ones passed on and
+        // silently drop the inherited ones, so the whole environment handed to git is allowed.
+        allowEnvironment: Object.keys(env),
+        unsafe: {
+            allowUnsafeAskPass: true,
+            allowUnsafeConfigEnvCount: true,
+            allowUnsafeConfigPaths: true,
+            allowUnsafeCredentialHelper: true,
+            allowUnsafeEditor: true,
+            allowUnsafeGitProxy: true,
+            allowUnsafePager: true,
+            allowUnsafeSshCommand: true,
+        },
+    })
+        .env(env)
+        .outputHandler((_command, stdout, stderr, args) => {
+        options.onCommand?.(['git', ...args].join(' '));
+        if (options.onOutput) {
+            stdout.on('data', (chunk) => options.onOutput?.(chunk.toString()));
+            stderr.on('data', (chunk) => options.onOutput?.(chunk.toString()));
+        }
+    });
+    const run = (args) => client.raw(args);
+    return {
+        run,
+        probe: async (args) => {
+            try {
+                return await run(args);
+            }
+            catch {
+                throwIfAborted(options.signal);
+                return undefined;
+            }
+        },
+    };
+};
+/** simple-git requires an existing base directory; a missing one simply has no repository. */
+export const directoryExists = (directory) => existsSync(directory);
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createGit, type Git, type GitOptions } from './git.js';
+export { commitInfo, currentBranch, isRepositoryRoot, mergedTags, remoteUrl, resolveCommit, resolveRemote, sameTree, tagExists, worktreeChanges, type CommitInfo, } from './repository.js';
+export { branchStatus, pullBranch, pushBranch, type BranchOptions, type BranchPullOutcome, type BranchPullResult, type BranchPushOutcome, type BranchPushResult, type BranchState, type BranchStatus, } from './sync.js';
+export { createTag, type CreateTagOptions, type CreateTagResult } from './tag.js';
+export { checkoutTag, clone, type CheckoutTagOptions, type CloneOptions } from './clone.js';
+export { compareReleaseVersions, formatReleaseVersion, parseReleaseVersion, releaseCandidates, releaseLine, type Maturity, type PatchType, type ReleaseCandidates, type ReleaseCandidatesResult, type ReleaseStage, type ReleaseVersion, type ReleaseVersionIssue, } from './release-version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,QAAQ,EACR,SAAS,EACT,eAAe,EACf,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { createGit } from './git.js';
+export { commitInfo, currentBranch, isRepositoryRoot, mergedTags, remoteUrl, resolveCommit, resolveRemote, sameTree, tagExists, worktreeChanges, } from './repository.js';
+export { branchStatus, pullBranch, pushBranch, } from './sync.js';
+export { createTag } from './tag.js';
+export { checkoutTag, clone } from './clone.js';
+export { compareReleaseVersions, formatReleaseVersion, parseReleaseVersion, releaseCandidates, releaseLine, } from './release-version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA6B,MAAM,UAAU,CAAC;AAChE,OAAO,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,aAAa,EACb,aAAa,EACb,QAAQ,EACR,SAAS,EACT,eAAe,GAEhB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,GAQX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAA+C,MAAM,UAAU,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,KAAK,EAA8C,MAAM,YAAY,CAAC;AAC5F,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,GAQZ,MAAM,sBAAsB,CAAC"}

package/dist/release-version.d.ts

@@ -0,0 +1,75 @@
+/**
+ * MFA release versions, following "微前端 6 - 命名规范与仓库规划":
+ *
+ *   <release> ::= ["v"] <major> "." <minor> "." <patch>
+ *                 [ "." <patch-type> <patch-number> ]           ; HP, CP or SP, project versions only
+ *                 [ "-" <maturity> "." <iteration> ]            ; alpha, beta or rc; none means released
+ *                 [ "." "C" <customer> [ "-U" <delivery> ] ]    ; customer edition and its delivery
+ *
+ * The customer edition comes last, like a Docker image variant, so every version is also a valid image tag.
+ * `+` is never allowed: Docker image tags reject it.
+ *
+ * Only the maturity moves here (next iteration, next stage). Patch and customer segments are planned by the
+ * project and kept as written, and a released version needs a new release plan instead of a computed one.
+ */
+export type ReleaseStage = 'beta' | 'rc' | 'release';
+export type Maturity = 'alpha' | 'beta' | 'rc';
+export type PatchType = 'HP' | 'CP' | 'SP';
+export interface ReleaseVersion {
+    /** `v` when written with the Tag prefix. */
+    prefix: '' | 'v';
+    major: number;
+    minor: number;
+    patch: number;
+    /** Hot patch, cold patch or service pack, e.g. `SP1`. */
+    patchLevel?: {
+        type: PatchType;
+        number: number;
+    };
+    /** Absent for a released version. */
+    maturity?: {
+        stage: Maturity;
+        iteration: number;
+    };
+    /** Customer edition, e.g. `CICBC-U2`: code `ICBC` and delivery 2. */
+    customer?: {
+        code: string;
+        delivery?: number;
+    };
+}
+export interface ReleaseCandidates {
+    /** The next iteration of the same maturity, e.g. 1.1.0-alpha.83 → 1.1.0-alpha.84. */
+    iterate: string;
+    /** The next maturity stage, starting at iteration 1; after rc comes the release itself. */
+    advance: {
+        stage: ReleaseStage;
+        version: string;
+    };
+}
+/**
+ * `versionInvalid`: not an MFA release version; `plusNotAllowed`: uses `+`, which Docker image tags reject
+ * (customer editions are written `.C<customer>`); `released`: already released, a new version needs a new plan.
+ */
+export type ReleaseVersionIssue = 'versionInvalid' | 'plusNotAllowed' | 'released';
+export type ReleaseCandidatesResult = {
+    ok: true;
+    candidates: ReleaseCandidates;
+} | {
+    ok: false;
+    reason: ReleaseVersionIssue;
+};
+export declare const parseReleaseVersion: (version: string) => ReleaseVersion | undefined;
+export declare const formatReleaseVersion: (version: ReleaseVersion) => string;
+/**
+ * The product line a version belongs to: base version, patch level and customer edition, without the maturity
+ * or the `v` prefix. Only versions of the same line are compared, so a standard release never stands in for a
+ * customer edition, nor one customer for another.
+ */
+export declare const releaseLine: (version: ReleaseVersion) => string;
+/**
+ * Orders two versions of the same line by maturity and iteration; versions of different lines are ordered by
+ * their line so that sorting stays stable. Returns a negative number, zero or a positive number.
+ */
+export declare const compareReleaseVersions: (left: ReleaseVersion, right: ReleaseVersion) => number;
+export declare const releaseCandidates: (version: string) => ReleaseCandidatesResult;
+//# sourceMappingURL=release-version.d.ts.map

package/dist/release-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-version.d.ts","sourceRoot":"","sources":["../src/release-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AACrD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;AAC/C,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,MAAM,EAAE,EAAE,GAAG,GAAG,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,qCAAqC;IACrC,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,qEAAqE;IACrE,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,OAAO,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,UAAU,CAAC;AAEnF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,GAC3C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAK/C,eAAO,MAAM,mBAAmB,YAAa,MAAM,KAAG,cAAc,GAAG,SAetE,CAAC;AAKF,eAAO,MAAM,oBAAoB,YAAa,cAAc,KAAG,MAOnD,CAAC;AAEb;;;;GAIG;AACH,eAAO,MAAM,WAAW,YAAa,cAAc,KAAG,MACa,CAAC;AAMpE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,SAAU,cAAc,SAAS,cAAc,KAAG,MAOpF,CAAC;AAIF,eAAO,MAAM,iBAAiB,YAAa,MAAM,KAAG,uBAsBnD,CAAC"}

package/dist/release-version.js

@@ -0,0 +1,85 @@
+/**
+ * MFA release versions, following "微前端 6 - 命名规范与仓库规划":
+ *
+ *   <release> ::= ["v"] <major> "." <minor> "." <patch>
+ *                 [ "." <patch-type> <patch-number> ]           ; HP, CP or SP, project versions only
+ *                 [ "-" <maturity> "." <iteration> ]            ; alpha, beta or rc; none means released
+ *                 [ "." "C" <customer> [ "-U" <delivery> ] ]    ; customer edition and its delivery
+ *
+ * The customer edition comes last, like a Docker image variant, so every version is also a valid image tag.
+ * `+` is never allowed: Docker image tags reject it.
+ *
+ * Only the maturity moves here (next iteration, next stage). Patch and customer segments are planned by the
+ * project and kept as written, and a released version needs a new release plan instead of a computed one.
+ */
+const pattern = /^(v)?(\d+)\.(\d+)\.(\d+)(?:\.(HP|CP|SP)(\d+))?(?:-(alpha|beta|rc)\.(\d+))?(?:\.C([A-Z0-9]+)(?:-U(\d+))?)?$/u;
+export const parseReleaseVersion = (version) => {
+    const match = pattern.exec(version);
+    if (!match) {
+        return undefined;
+    }
+    const [, prefix, major, minor, patch, patchType, patchNumber, stage, iteration, customer, delivery] = match;
+    return {
+        prefix: prefix ? 'v' : '',
+        major: Number(major),
+        minor: Number(minor),
+        patch: Number(patch),
+        ...(patchType ? { patchLevel: { type: patchType, number: Number(patchNumber) } } : {}),
+        ...(stage ? { maturity: { stage: stage, iteration: Number(iteration) } } : {}),
+        ...(customer ? { customer: { code: customer, ...(delivery ? { delivery: Number(delivery) } : {}) } } : {}),
+    };
+};
+/** The same version without its maturity, i.e. its released form. */
+const withoutMaturity = ({ maturity: _maturity, ...version }) => version;
+export const formatReleaseVersion = (version) => [
+    `${version.prefix}${version.major}.${version.minor}.${version.patch}`,
+    version.patchLevel ? `.${version.patchLevel.type}${version.patchLevel.number}` : '',
+    version.maturity ? `-${version.maturity.stage}.${version.maturity.iteration}` : '',
+    version.customer ? `.C${version.customer.code}` : '',
+    version.customer?.delivery !== undefined ? `-U${version.customer.delivery}` : '',
+].join('');
+/**
+ * The product line a version belongs to: base version, patch level and customer edition, without the maturity
+ * or the `v` prefix. Only versions of the same line are compared, so a standard release never stands in for a
+ * customer edition, nor one customer for another.
+ */
+export const releaseLine = (version) => formatReleaseVersion({ ...withoutMaturity(version), prefix: '' });
+const maturityRank = { alpha: 0, beta: 1, rc: 2 };
+// A released version comes after every prerelease of the same line.
+const rank = (version) => (version.maturity ? maturityRank[version.maturity.stage] : 3);
+/**
+ * Orders two versions of the same line by maturity and iteration; versions of different lines are ordered by
+ * their line so that sorting stays stable. Returns a negative number, zero or a positive number.
+ */
+export const compareReleaseVersions = (left, right) => {
+    const leftLine = releaseLine(left);
+    const rightLine = releaseLine(right);
+    if (leftLine !== rightLine) {
+        return leftLine < rightLine ? -1 : 1;
+    }
+    return rank(left) - rank(right) || (left.maturity?.iteration ?? 0) - (right.maturity?.iteration ?? 0);
+};
+const nextStage = { alpha: 'beta', beta: 'rc', rc: 'release' };
+export const releaseCandidates = (version) => {
+    if (version.includes('+')) {
+        return { ok: false, reason: 'plusNotAllowed' };
+    }
+    const parsed = parseReleaseVersion(version);
+    if (!parsed) {
+        return { ok: false, reason: 'versionInvalid' };
+    }
+    const { maturity } = parsed;
+    if (!maturity) {
+        return { ok: false, reason: 'released' };
+    }
+    const stage = nextStage[maturity.stage];
+    const next = stage === 'release' ? withoutMaturity(parsed) : { ...parsed, maturity: { stage, iteration: 1 } };
+    return {
+        ok: true,
+        candidates: {
+            iterate: formatReleaseVersion({ ...parsed, maturity: { ...maturity, iteration: maturity.iteration + 1 } }),
+            advance: { stage, version: formatReleaseVersion(next) },
+        },
+    };
+};
+//# sourceMappingURL=release-version.js.map

package/dist/release-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-version.js","sourceRoot":"","sources":["../src/release-version.ts"],"names":[],"mappings":"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"}

package/dist/repository.d.ts

@@ -0,0 +1,46 @@
+import { type Git, type GitOptions } from './git.js';
+export interface CommitInfo {
+    sha: string;
+    shortSha: string;
+    subject: string;
+}
+export declare const lines: (value: string | undefined) => string[];
+/**
+ * Whether `cwd` is itself the root of a repository, not a directory inside an outer one
+ * (for example a workspace that is also under Git).
+ */
+export declare const isRepositoryRoot: (options: GitOptions) => Promise<boolean>;
+/** The checked-out branch; `undefined` on a detached HEAD or outside a repository. */
+export declare const currentBranch: (options: GitOptions) => Promise<string | undefined>;
+/** The remote of `branch`: its upstream, otherwise the only remote of the repository. */
+export declare const resolveRemote: (options: GitOptions & {
+    branch?: string | undefined;
+}) => Promise<string | undefined>;
+/** URL of `remote`, or of the remote that `resolveRemote` picks. */
+export declare const remoteUrl: (options: GitOptions & {
+    remote?: string | undefined;
+    branch?: string | undefined;
+}) => Promise<string | undefined>;
+export declare const resolveCommitWith: (git: Git, ref: string) => Promise<string | undefined>;
+/** Commit SHA of `ref`, or `undefined` when it does not exist. */
+export declare const resolveCommit: (options: GitOptions & {
+    ref: string;
+}) => Promise<string | undefined>;
+export declare const commitInfo: (options: GitOptions & {
+    ref: string;
+}) => Promise<CommitInfo | undefined>;
+/** Whether two refs point at the same content, regardless of history. */
+export declare const sameTree: (options: GitOptions & {
+    a: string;
+    b: string;
+}) => Promise<boolean>;
+/** Tags reachable from `ref`. */
+export declare const mergedTags: (options: GitOptions & {
+    ref: string;
+}) => Promise<string[]>;
+export declare const tagExists: (options: GitOptions & {
+    name: string;
+}) => Promise<boolean>;
+/** Number of tracked files with uncommitted changes. */
+export declare const worktreeChanges: (options: GitOptions) => Promise<number>;
+//# sourceMappingURL=repository.d.ts.map

package/dist/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAIA,OAAO,EAA8B,KAAK,GAAG,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,KAAK,UAAW,MAAM,GAAG,SAAS,KAAG,MAAM,EAIpC,CAAC;AAErB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,YAAmB,UAAU,KAAG,OAAO,CAAC,OAAO,CAM3E,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,aAAa,YAAmB,UAAU,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CACW,CAAC;AAchG,yFAAyF;AACzF,eAAO,MAAM,aAAa,YAAmB,UAAU,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,gCACzC,CAAC;AAEjD,oEAAoE;AACpE,eAAO,MAAM,SAAS,YACX,UAAU,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KACjF,OAAO,CAAC,MAAM,GAAG,SAAS,CAI5B,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAe,GAAG,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CACD,CAAC;AAE1F,kEAAkE;AAClE,eAAO,MAAM,aAAa,YAAa,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,gCACf,CAAC;AAErD,eAAO,MAAM,UAAU,YAAmB,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAQtG,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,QAAQ,YAAmB,UAAU,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,OAAO,CAO9F,CAAC;AAEF,iCAAiC;AACjC,eAAO,MAAM,UAAU,YAAmB,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,MAAM,EAAE,CAClB,CAAC;AAExE,eAAO,MAAM,SAAS,YAAmB,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,KAAG,OAAO,CAAC,OAAO,CACoB,CAAC;AAE7G,wDAAwD;AACxD,eAAO,MAAM,eAAe,YAAmB,UAAU,KAAG,OAAO,CAAC,MAAM,CACqB,CAAC"}

package/dist/repository.js

@@ -0,0 +1,68 @@
+/**
+ * Read-only questions about a repository: its root, branch, remote, commits and tags.
+ */
+import { realpath } from 'node:fs/promises';
+import { createGit, directoryExists } from './git.js';
+export const lines = (value) => (value ?? '')
+    .split('\n')
+    .map((line) => line.trim())
+    .filter(Boolean);
+/**
+ * Whether `cwd` is itself the root of a repository, not a directory inside an outer one
+ * (for example a workspace that is also under Git).
+ */
+export const isRepositoryRoot = async (options) => {
+    if (!directoryExists(options.cwd)) {
+        return false;
+    }
+    const topLevel = await createGit(options).probe(['rev-parse', '--show-toplevel']);
+    return Boolean(topLevel) && (await realpath(topLevel)) === (await realpath(options.cwd));
+};
+/** The checked-out branch; `undefined` on a detached HEAD or outside a repository. */
+export const currentBranch = async (options) => (await createGit(options).probe(['symbolic-ref', '--quiet', '--short', 'HEAD'])) || undefined;
+const findRemote = async (git, branch) => {
+    if (branch) {
+        const upstream = await git.probe(['for-each-ref', '--format=%(upstream:remotename)', `refs/heads/${branch}`]);
+        if (upstream) {
+            return upstream;
+        }
+    }
+    // Without an upstream, only a single remote is unambiguous; the name is never assumed to be origin.
+    const remotes = lines(await git.probe(['remote']));
+    return remotes.length === 1 ? remotes[0] : undefined;
+};
+/** The remote of `branch`: its upstream, otherwise the only remote of the repository. */
+export const resolveRemote = async (options) => findRemote(createGit(options), options.branch);
+/** URL of `remote`, or of the remote that `resolveRemote` picks. */
+export const remoteUrl = async (options) => {
+    const git = createGit(options);
+    const remote = options.remote ?? (await findRemote(git, options.branch));
+    return remote ? (await git.probe(['remote', 'get-url', '--', remote])) || undefined : undefined;
+};
+export const resolveCommitWith = async (git, ref) => (await git.probe(['rev-parse', '--verify', '--quiet', `${ref}^{commit}`])) || undefined;
+/** Commit SHA of `ref`, or `undefined` when it does not exist. */
+export const resolveCommit = (options) => resolveCommitWith(createGit(options), options.ref);
+export const commitInfo = async (options) => {
+    const git = createGit(options);
+    const sha = await resolveCommitWith(git, options.ref);
+    if (!sha) {
+        return undefined;
+    }
+    const [shortSha = '', subject = ''] = (await git.run(['log', '-1', '--format=%h%x00%s', sha])).split('\0');
+    return { sha, shortSha, subject };
+};
+/** Whether two refs point at the same content, regardless of history. */
+export const sameTree = async (options) => {
+    const git = createGit(options);
+    const [a, b] = await Promise.all([
+        git.probe(['rev-parse', `${options.a}^{tree}`]),
+        git.probe(['rev-parse', `${options.b}^{tree}`]),
+    ]);
+    return a !== undefined && a === b;
+};
+/** Tags reachable from `ref`. */
+export const mergedTags = async (options) => lines(await createGit(options).run(['tag', '--merged', options.ref]));
+export const tagExists = async (options) => Boolean(await createGit(options).probe(['rev-parse', '--verify', '--quiet', `refs/tags/${options.name}`]));
+/** Number of tracked files with uncommitted changes. */
+export const worktreeChanges = async (options) => lines(await createGit(options).run(['status', '--porcelain', '--untracked-files=no'])).length;
+//# sourceMappingURL=repository.js.map

package/dist/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"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"}

package/dist/sync.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Keeping a branch in step with its remote. Pulling only fetches and fast-forwards; pushing never forces.
+ *
+ * Checking only fetches: remote-tracking branches and tags move, the worktree and local branches do not.
+ * Pulling fast-forwards the branch after fetching: `merge --ff-only` when it is checked out, otherwise it only
+ * moves the branch pointer. Branches are never switched. When git refuses to fast-forward (diverged history, or
+ * local changes that would be overwritten), the result is `fetchedOnly`, not an error.
+ * Pushing sends the local branch to the remote branch of the same name without checking it out, creating it when
+ * missing; a non-fast-forward push is rejected by the remote and reported as `rejected`.
+ */
+import { type GitOptions } from './git.js';
+/** `ok` means `behind` and `ahead` are known; the other states explain why the branch could not be checked. */
+export type BranchState = 'ok' | 'noRepository' | 'noRemote' | 'remoteBranchMissing' | 'failed';
+export interface BranchStatus {
+    branch: string;
+    remote?: string;
+    state: BranchState;
+    /** Commits on the remote branch that the local branch lacks; all of them when there is no local branch yet. */
+    behind?: number;
+    /** Local commits not on the remote branch; all of them when the remote branch does not exist yet. */
+    ahead?: number;
+    /** Why the check failed. */
+    message?: string;
+}
+/**
+ * `updated`: fast-forwarded; `upToDate`: nothing to pull; `fetchedOnly`: git refused to fast-forward, so only the
+ * fetch happened; `skipped`: there is no remote branch to pull from.
+ */
+export type BranchPullOutcome = 'updated' | 'upToDate' | 'fetchedOnly' | 'skipped';
+export interface BranchPullResult extends BranchStatus {
+    outcome: BranchPullOutcome;
+    /** Commits fast-forwarded when `updated`. */
+    count?: number;
+}
+/** `pushed`; `upToDate`: nothing to push; `rejected` by the remote, usually pull first; `skipped`: nothing to push to. */
+export type BranchPushOutcome = 'pushed' | 'upToDate' | 'rejected' | 'skipped';
+export interface BranchPushResult extends BranchStatus {
+    outcome: BranchPushOutcome;
+    /** Commits pushed when `pushed`. */
+    count?: number;
+}
+export interface BranchOptions extends GitOptions {
+    branch: string;
+}
+/** Fetches and counts how far the branch is behind and ahead of its remote; changes no local branch or file. */
+export declare const branchStatus: (options: BranchOptions) => Promise<BranchStatus>;
+/** Fetches, then fast-forwards the branch to its remote; only fetches when a fast-forward is impossible. */
+export declare const pullBranch: (options: BranchOptions) => Promise<BranchPullResult>;
+/** Pushes the local branch to the remote branch of the same name, creating it when missing. Never forces. */
+export declare const pushBranch: (options: BranchOptions) => Promise<BranchPushResult>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAG9E,+GAA+G;AAC/G,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,cAAc,GAAG,UAAU,GAAG,qBAAqB,GAAG,QAAQ,CAAC;AAEhG,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,+GAA+G;IAC/G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAEnF,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0HAA0H;AAC1H,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/E,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AA6CD,gHAAgH;AAChH,eAAO,MAAM,YAAY,YAAmB,aAAa,KAAG,OAAO,CAAC,YAAY,CAAoC,CAAC;AAErH,4GAA4G;AAC5G,eAAO,MAAM,UAAU,YAAmB,aAAa,KAAG,OAAO,CAAC,gBAAgB,CAyBjF,CAAC;AAEF,6GAA6G;AAC7G,eAAO,MAAM,UAAU,YAAmB,aAAa,KAAG,OAAO,CAAC,gBAAgB,CAoBjF,CAAC"}

package/dist/sync.js

@@ -0,0 +1,103 @@
+/**
+ * Keeping a branch in step with its remote. Pulling only fetches and fast-forwards; pushing never forces.
+ *
+ * Checking only fetches: remote-tracking branches and tags move, the worktree and local branches do not.
+ * Pulling fast-forwards the branch after fetching: `merge --ff-only` when it is checked out, otherwise it only
+ * moves the branch pointer. Branches are never switched. When git refuses to fast-forward (diverged history, or
+ * local changes that would be overwritten), the result is `fetchedOnly`, not an error.
+ * Pushing sends the local branch to the remote branch of the same name without checking it out, creating it when
+ * missing; a non-fast-forward push is rejected by the remote and reported as `rejected`.
+ */
+import { createGit, errorMessage } from './git.js';
+import { isRepositoryRoot, resolveCommitWith, resolveRemote } from './repository.js';
+const inspect = async (options) => {
+    const { branch } = options;
+    const status = { branch, state: 'ok' };
+    try {
+        if (!(await isRepositoryRoot(options))) {
+            return { status: { ...status, state: 'noRepository' } };
+        }
+        const remote = await resolveRemote(options);
+        if (!remote) {
+            return { status: { ...status, state: 'noRemote' } };
+        }
+        status.remote = remote;
+        const git = createGit(options);
+        await git.run(['fetch', '--tags', '--', remote]);
+        const remoteRef = `refs/remotes/${remote}/${branch}`;
+        const localRef = `refs/heads/${branch}`;
+        const hasLocal = (await resolveCommitWith(git, localRef)) !== undefined;
+        const count = async (range) => Number(await git.run(['rev-list', '--count', range]));
+        if (!(await resolveCommitWith(git, remoteRef))) {
+            return {
+                status: { ...status, state: 'remoteBranchMissing', ...(hasLocal ? { ahead: await count(localRef) } : {}) },
+                git,
+                hasLocal,
+            };
+        }
+        status.behind = await count(hasLocal ? `${localRef}..${remoteRef}` : remoteRef);
+        status.ahead = hasLocal ? await count(`${remoteRef}..${localRef}`) : 0;
+        return { status, git, remoteRef, hasLocal };
+    }
+    catch (error) {
+        if (options.signal?.aborted) {
+            throw error;
+        }
+        return { status: { ...status, state: 'failed', message: errorMessage(error) } };
+    }
+};
+/** Fetches and counts how far the branch is behind and ahead of its remote; changes no local branch or file. */
+export const branchStatus = async (options) => (await inspect(options)).status;
+/** Fetches, then fast-forwards the branch to its remote; only fetches when a fast-forward is impossible. */
+export const pullBranch = async (options) => {
+    const { status, git, remoteRef } = await inspect(options);
+    if (status.state !== 'ok' || !git || !remoteRef) {
+        return { ...status, outcome: 'skipped' };
+    }
+    const count = status.behind ?? 0;
+    if (count === 0) {
+        return { ...status, outcome: 'upToDate' };
+    }
+    const current = await git.probe(['symbolic-ref', '--quiet', '--short', 'HEAD']);
+    try {
+        if (current === status.branch) {
+            // Updates the worktree; git refuses when uncommitted changes would be overwritten and keeps them.
+            await git.run(['merge', '--ff-only', remoteRef]);
+        }
+        else {
+            // Moves the branch pointer only, creating the branch when missing; without `+`, git refuses non-fast-forwards.
+            await git.run(['fetch', '.', `${remoteRef}:refs/heads/${status.branch}`]);
+        }
+    }
+    catch (error) {
+        if (options.signal?.aborted) {
+            throw error;
+        }
+        return { ...status, outcome: 'fetchedOnly', message: errorMessage(error) };
+    }
+    return { ...status, behind: 0, outcome: 'updated', count };
+};
+/** Pushes the local branch to the remote branch of the same name, creating it when missing. Never forces. */
+export const pushBranch = async (options) => {
+    const { status, git, hasLocal } = await inspect(options);
+    const canPush = status.state === 'ok' || status.state === 'remoteBranchMissing';
+    if (!canPush || !git || !hasLocal || !status.remote) {
+        return { ...status, outcome: 'skipped' };
+    }
+    const count = status.ahead ?? 0;
+    if (status.state === 'ok' && count === 0) {
+        return { ...status, outcome: 'upToDate' };
+    }
+    const ref = `refs/heads/${status.branch}`;
+    try {
+        await git.run(['push', '--', status.remote, `${ref}:${ref}`]);
+    }
+    catch (error) {
+        if (options.signal?.aborted) {
+            throw error;
+        }
+        return { ...status, outcome: 'rejected', message: errorMessage(error) };
+    }
+    return { ...status, state: 'ok', behind: status.behind ?? 0, ahead: 0, outcome: 'pushed', count };
+};
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"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"}

package/dist/tag.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Creating a tag, optionally annotated, overwriting and pushed; a failed push leaves the local tags as they were.
+ */
+import { type GitOptions } from './git.js';
+export interface CreateTagOptions extends GitOptions {
+    name: string;
+    /** Commit (or any ref) to tag. */
+    commit: string;
+    /** Creates an annotated tag when not blank; the message is kept as written, including lines starting with `#`. */
+    message?: string | undefined;
+    /** Overwrites an existing tag of the same name, locally and on the remote. */
+    force?: boolean | undefined;
+    /** Pushes the tag to this remote after creating it. */
+    push?: {
+        remote: string;
+    } | undefined;
+}
+export interface CreateTagResult {
+    name: string;
+    commit: string;
+    /** Whether an existing tag was overwritten. */
+    overwritten: boolean;
+    pushed: boolean;
+}
+export declare const createTag: (options: CreateTagOptions) => Promise<CreateTagResult>;
+//# sourceMappingURL=tag.d.ts.map

package/dist/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../src/tag.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,kHAAkH;IAClH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,uDAAuD;IACvD,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,SAAS,YAAmB,gBAAgB,KAAG,OAAO,CAAC,eAAe,CA0BlF,CAAC"}

package/dist/tag.js

@@ -0,0 +1,33 @@
+/**
+ * Creating a tag, optionally annotated, overwriting and pushed; a failed push leaves the local tags as they were.
+ */
+import { createGit } from './git.js';
+export const createTag = async (options) => {
+    const git = createGit(options);
+    const ref = `refs/tags/${options.name}`;
+    // The object the tag pointed at before, restored when the push fails.
+    const previous = (await git.probe(['rev-parse', '--verify', '--quiet', ref])) || undefined;
+    if (previous && !options.force) {
+        throw new Error(`Tag ${options.name} already exists; pass force to overwrite it`);
+    }
+    const message = options.message?.trim();
+    // The default `strip` cleanup would drop lines starting with `#`, such as issue references.
+    const annotation = message ? ['-a', '-m', message, '--cleanup=whitespace'] : [];
+    await git.run(['tag', ...(previous ? ['-f'] : []), ...annotation, '--', options.name, options.commit]);
+    if (options.push) {
+        try {
+            await git.run(['push', '--', options.push.remote, `${previous ? '+' : ''}${ref}`]);
+        }
+        catch (error) {
+            await git.run(previous ? ['update-ref', ref, previous] : ['tag', '-d', '--', options.name]);
+            throw error;
+        }
+    }
+    return {
+        name: options.name,
+        commit: await git.run(['rev-parse', `${ref}^{commit}`]),
+        overwritten: previous !== undefined,
+        pushed: options.push !== undefined,
+    };
+};
+//# sourceMappingURL=tag.js.map

package/dist/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../src/tag.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAmB,MAAM,UAAU,CAAC;AAsBtD,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,OAAyB,EAA4B,EAAE;IACrF,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,aAAa,OAAO,CAAC,IAAI,EAAE,CAAC;IACxC,sEAAsE;IACtE,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IAC3F,IAAI,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,OAAO,OAAO,CAAC,IAAI,6CAA6C,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACxC,4FAA4F;IAC5F,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5F,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,WAAW,CAAC,CAAC;QACvD,WAAW,EAAE,QAAQ,KAAK,SAAS;QACnC,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS;KACnC,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@seed-fe/mfa-git",
+  "version": "0.1.0",
+  "description": "Git operations and release naming rules for MFA (seed-fe-mfa) workspaces: branch status, fast-forward pull, push, tags with rollback, clone, tag checkout and release version calculation. Authentication stays with the developer's own Git setup.",
+  "keywords": [
+    "git",
+    "mfa",
+    "micro-frontend",
+    "release",
+    "seed-fe",
+    "semver",
+    "tag"
+  ],
+  "homepage": "https://github.com/xianghongai/seed-fe-mfa-git#readme",
+  "bugs": {
+    "url": "https://github.com/xianghongai/seed-fe-mfa-git/issues"
+  },
+  "license": "MIT",
+  "author": "Nicholas Hsiang",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xianghongai/seed-fe-mfa-git.git"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "simple-git": "^4.0.1"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^1.0.1",
+    "@changesets/cli": "^3.0.3",
+    "@types/node": "^26.6.2",
+    "oxfmt": "^0.65.0",
+    "oxlint": "^1.85.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "changeset": "changeset",
+    "check-types": "tsc --noEmit",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "lint": "oxlint src test",
+    "release": "changeset publish",
+    "test": "vitest run"
+  }
+}