@hi-man/himan 0.3.3 → 0.3.4

package/CHANGELOG.md

@@ -6,10 +6,16 @@ The format is based on Keep a Changelog, and this project follows semver for the
 
 ## [Unreleased]
 
+## [0.3.4] - 2026-05-11
+
 ### Changed
 
 - Changed project guidance to require changelog updates for user-visible CLI behavior changes.
 
+### Fixed
+
+- Fixed `himan publish` so publishing stops with `E_PUBLISH_NO_CHANGES` when the resource content matches the latest published version.
+
 ## [0.3.3] - 2026-05-11
 
 ### Added

package/README.md

@@ -167,7 +167,7 @@ your-himan-source/
 说明：资源与项目相关命令统一使用 `--agent` 指定目标 Agent。
 若未显式传 `--agent`，`create` / `install` 会使用当前项目默认 agent、全局默认 agent、资源 metadata 或内置默认 `cursor` 中最合适的一项；`dev` 会优先使用 lock 中记录的 agent。`install --global` 会优先复用当前项目 lock 里该资源的 agent，未命中时再使用默认 install 解析顺序，但目标根目录是用户 home 下对应 agent 目录。
 
-`publish` 优先使用项目里 `.himan/dev` 对应目录，否则用源仓库里对应目录。若资源目录包含 `himan.yaml`，发布前会校验元数据与入口文件；若没有 `himan.yaml`，则按默认入口推断最小元数据并发布，不会强制创建 `himan.yaml`。发布需要可推送的 Git 权限。发布 commit 会包含资源目录以及自动维护的 source 根目录 `README.md` / `CHANGELOG.md`。发布成功后会从新版本 store 以 `copy` 模式重新安装到项目目标、更新 lock，并删除对应 `.himan/dev/<type>/<name>` 开发目录。
+`publish` 优先使用项目里 `.himan/dev` 对应目录，否则用源仓库里对应目录。若资源目录包含 `himan.yaml`，发布前会校验元数据与入口文件；若没有 `himan.yaml`，则按默认入口推断最小元数据并发布，不会强制创建 `himan.yaml`。若待发布资源内容与最新已发布版本一致，则以 `E_PUBLISH_NO_CHANGES` 终止发布。发布需要可推送的 Git 权限。发布 commit 会包含资源目录以及自动维护的 source 根目录 `README.md` / `CHANGELOG.md`。发布成功后会从新版本 store 以 `copy` 模式重新安装到项目目标、更新 lock，并删除对应 `.himan/dev/<type>/<name>` 开发目录。
 
 `--json` 模式下，失败时会输出机器可读错误 JSON（`stderr`）。错误码定义见 [docs/error-codes.md](./docs/error-codes.md)。
 

package/dist/adapters/source/git-source-adapter.js

@@ -4,6 +4,7 @@ import semver from "semver";
 import { HimanError, errorCodes } from "../../utils/errors.js";
 import { promises as fs } from "node:fs";
 import { createHash } from "node:crypto";
+import os from "node:os";
 import path from "node:path";
 import YAML from "yaml";
 import { IndexCacheStore } from "../../state/index-cache-store.js";
@@ -52,6 +53,7 @@ export class GitSourceAdapter {
         const repoDir = this.getRepoDir();
         const targetDir = path.join(repoDir, `${type}s`, name);
         const metadataResult = await this.validatePublishResource(type, name, sourceDir);
+        await this.ensurePublishHasContentChanges(type, name, sourceDir);
         const sameDir = await this.isSameDirectory(sourceDir, targetDir);
         if (!sameDir) {
             await fs.rm(targetDir, { recursive: true, force: true });
@@ -261,6 +263,76 @@ export class GitSourceAdapter {
             metadata.agents = agents;
         return metadata;
     }
+    async ensurePublishHasContentChanges(type, name, sourceDir) {
+        const latest = (await this.history(type, name))[0];
+        if (!latest)
+            return;
+        const previousDir = await fs.mkdtemp(path.join(os.tmpdir(), "himan-publish-"));
+        try {
+            await this.repoManager.archiveResource(this.getRepoDir(), latest.raw, `${type}s/${name}`, previousDir);
+            const [nextSnapshot, previousSnapshot] = await Promise.all([
+                this.readComparableResourceSnapshot(sourceDir),
+                this.readComparableResourceSnapshot(previousDir),
+            ]);
+            if (this.resourceSnapshotsEqual(nextSnapshot, previousSnapshot)) {
+                throw new HimanError(errorCodes.PUBLISH_NO_CHANGES, `No changes to publish for ${type}/${name}.`);
+            }
+        }
+        finally {
+            await fs.rm(previousDir, { recursive: true, force: true });
+        }
+    }
+    async readComparableResourceSnapshot(resourceDir) {
+        const files = await this.listResourceFiles(resourceDir);
+        const snapshot = new Map();
+        for (const file of files) {
+            const relative = this.toPosixPath(path.relative(resourceDir, file));
+            const content = await fs.readFile(file, "utf8");
+            snapshot.set(relative, relative === "himan.yaml"
+                ? this.normalizeComparableResourceMetadata(content)
+                : content);
+        }
+        return snapshot;
+    }
+    async listResourceFiles(resourceDir) {
+        const result = [];
+        const entries = await fs.readdir(resourceDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(resourceDir, entry.name);
+            if (entry.isDirectory()) {
+                result.push(...(await this.listResourceFiles(fullPath)));
+            }
+            else if (entry.isFile()) {
+                result.push(fullPath);
+            }
+        }
+        return result.sort((a, b) => a.localeCompare(b));
+    }
+    normalizeComparableResourceMetadata(content) {
+        try {
+            const parsed = YAML.parse(content);
+            if (!this.isRecord(parsed))
+                return content;
+            const normalized = { ...parsed };
+            delete normalized.version;
+            return YAML.stringify(normalized);
+        }
+        catch {
+            return content;
+        }
+    }
+    resourceSnapshotsEqual(a, b) {
+        if (a.size !== b.size)
+            return false;
+        for (const [file, content] of a) {
+            if (b.get(file) !== content)
+                return false;
+        }
+        return true;
+    }
+    toPosixPath(filePath) {
+        return filePath.split(path.sep).join("/");
+    }
     invalidResourceMetadata(type, name, message, details) {
         return new HimanError(errorCodes.INVALID_RESOURCE_METADATA, `Invalid metadata for ${type}/${name}: ${message}`, details);
     }

package/docs/error-codes.md

@@ -116,7 +116,7 @@
 ### `E_PUBLISH_NO_CHANGES`
 
 - **含义**：发布时没有可提交的资源变更。
-- **常见触发**：重复发布已写入相同内容和版本的资源目录。
+- **常见触发**：重复发布与最新已发布版本内容一致的资源目录；`himan.yaml` 中仅版本字段不同也会视为无内容变化。
 - **建议处理**：确认资源内容或元数据已经变更，再重新执行 `publish`。
 
 ### `E_UNSUPPORTED_RESOURCE_TYPE`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hi-man/himan",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Prompt and agent asset management CLI",
   "keywords": [
     "ai",