agents-gitflow-guard 0.0.9 → 0.0.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -2
- package/README.zh.md +6 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -36,12 +36,16 @@ You define your own branches —
|
|
|
36
36
|
|
|
37
37
|
## Quick Start — 30 seconds to a guarded repo
|
|
38
38
|
|
|
39
|
-
**Step 1 — install**,
|
|
39
|
+
**Step 1 — install**, then restart DSH (plugins load at process startup):
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
+
# installs the latest release
|
|
42
43
|
dsh plugin --profile web add agents-gitflow-guard
|
|
44
|
+
# ...or pin an exact known-good version (recommended; also bypasses stale registry caches)
|
|
45
|
+
dsh plugin --profile web add agents-gitflow-guard@0.0.9
|
|
43
46
|
```
|
|
44
47
|
|
|
48
|
+
> **Version gotcha**: a bare `add` resolves whatever `latest` is at install time — on machines behind a stale npm/pnpm registry cache or mirror it may install an old version. If the installed version looks wrong, pin it explicitly. The peer-dependency *warning* pnpm may print is expected: DSH supplies `@deepseek-ai/cordis` / `@deepseek-ai/dsh-tools` through its shared profile module fallback at startup (the plugin works normally).
|
|
45
49
|
**Step 2 — configure**, create `gitflow-guard.config.json` in your **project root**:
|
|
46
50
|
|
|
47
51
|
```jsonc
|
|
@@ -295,7 +299,7 @@ The PR/MR target is resolved via `gh pr view` (GitHub) or `glab mr view` (GitLab
|
|
|
295
299
|
**From the npm registry** — the standard path, already covered in [Quick Start](#quick-start--30-seconds-to-a-guarded-repo):
|
|
296
300
|
|
|
297
301
|
```bash
|
|
298
|
-
dsh plugin --profile web add agents-gitflow-guard
|
|
302
|
+
dsh plugin --profile web add agents-gitflow-guard@0.0.9 # pin recommended, see note above
|
|
299
303
|
```
|
|
300
304
|
|
|
301
305
|
Then restart DSH. Upgrades are the same command, followed by another restart.
|
package/README.zh.md
CHANGED
|
@@ -35,12 +35,16 @@
|
|
|
35
35
|
|
|
36
36
|
## 快速开始——30 秒用上
|
|
37
37
|
|
|
38
|
-
**第 1
|
|
38
|
+
**第 1 步——安装**,然后重启 DSH(插件在进程启动时加载):
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
|
+
# 安装最新版
|
|
41
42
|
dsh plugin --profile web add agents-gitflow-guard
|
|
43
|
+
# ...或锁定已知良好版本(推荐; 同时绕开 registry 陈旧缓存)
|
|
44
|
+
dsh plugin --profile web add agents-gitflow-guard@0.0.9
|
|
42
45
|
```
|
|
43
46
|
|
|
47
|
+
> **版本坑**: 裸 `add` 装的是安装时刻的 `latest`——在 npm/pnpm 注册表缓存或镜像陈旧的机器上可能拿到旧版本。看到版本不对就锁版本。pnpm 打印的 peer 依赖 *警告* 属预期: DSH 启动时经共享模块回退提供 `@deepseek-ai/cordis` / `@deepseek-ai/dsh-tools`(插件正常工作)。
|
|
44
48
|
**第 2 步——配置**,在**项目根目录**创建 `gitflow-guard.config.json`:
|
|
45
49
|
|
|
46
50
|
```jsonc
|
|
@@ -292,7 +296,7 @@ PR/MR 目标通过 `gh pr view`(GitHub)或 `glab mr view`(GitLab)解析;没有
|
|
|
292
296
|
**从 npm registry**——标准路径,已在[快速开始](#快速开始30-秒用上)覆盖:
|
|
293
297
|
|
|
294
298
|
```bash
|
|
295
|
-
dsh plugin --profile web add agents-gitflow-guard
|
|
299
|
+
dsh plugin --profile web add agents-gitflow-guard@0.0.9 # 建议锁版本, 见上文提示
|
|
296
300
|
```
|
|
297
301
|
|
|
298
302
|
然后重启 DSH。升级用同一命令,再重启一次。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agents-gitflow-guard",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.10",
|
|
4
4
|
"description": "A configurable branch-role guard for AI coding agents (DSH / Claude Code / Codex / OpenCode / Antigravity) — integration/preview/production/archive, each with its own update rules",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|