release: prepare v0.7.3

Author: kevin

CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+## [0.7.3] — 2026-05-03
+
+### Changed
+
+- **umbrella summary fidelity**: `compute_summary(..., paths=...)` now preserves each umbrella candidate's `signal` (`name_token`, `description_token`, `downstream_share`, `execution_profile`) instead of returning only `token` and `skill_ids`. This removes ambiguity when the same token is surfaced by multiple signals.
+- **markdown report labels**: the `## Umbrella Candidates` section now prints the signal type in each cluster heading, matching JSON output and the standalone `helm skill-lifecycle umbrella --json` command.
+- **workspace hook validation**: verified the OpenClaw workspace runner path records `skill_used` and `skill_success` events against the same lifecycle sidecar files used by Helm.
+- **dedup gate noise reduction**: tightened the workspace briefing dedup checker so URL and filename-slug matches act as high-specificity Obsidian signals, reducing hub/index note noise while preserving the Gemini Embedding 2 duplicate catch.
+
+### Packaging
+
+- bumped package metadata to `0.7.3`.
+- smoke-tested the installed console script via `helm skill-lifecycle scan --path ~/.openclaw/workspace --dry-run --json`.
+
+### Tests
+
+- 60 lifecycle test cases passing.
+- Full suite: 369 tests passing.
+
 ## [0.7.2] — 2026-05-03
 
 ### Added

README.ko.md

@@ -8,7 +8,7 @@
 
 <p align="center">Helm은 AI agent workspace를 위한 로컬 운영 레이어입니다. 명령 전 profile, 위험 작업 전 checkpoint, chat이 사라진 뒤에도 남는 durable task history를 제공합니다.</p>
 
-<p align="center"><strong>현재 릴리즈: v0.7.2</strong></p>
+<p align="center"><strong>현재 릴리즈: v0.7.3</strong></p>
 
 <p align="center">
   <a href="https://v0-helm-agent-ops.vercel.app/">Landing page</a> ·
@@ -228,6 +228,7 @@ Helm은 전용 workspace에 두고, 기존 시스템은 먼저 read-only context
 - [`CHANGELOG.md`](CHANGELOG.md)
 - [`CONTRIBUTING.md`](CONTRIBUTING.md)
 - [`SECURITY.md`](SECURITY.md)
+- [`docs/releases/0.7.3.md`](docs/releases/0.7.3.md)
 - [`docs/releases/0.7.2.md`](docs/releases/0.7.2.md)
 - [`docs/releases/0.7.1.md`](docs/releases/0.7.1.md)
 - [`docs/releases/0.7.0.md`](docs/releases/0.7.0.md)
@@ -236,7 +237,7 @@ Helm은 전용 workspace에 두고, 기존 시스템은 먼저 read-only context
 
 ## 현재 상태
 
-Helm v0.7.2는 PRD의 남은 optional 항목을 채웁니다. `helm curator` alias, umbrella의 `execution_profile` 시그널, persisted negative claim에 대한 `revalidation-due`, archive dry-run의 파일 인벤토리 미리보기. 자세한 내용은 [`docs/skill-lifecycle.md`](docs/skill-lifecycle.md) 참고.
+Helm v0.7.3은 skill-lifecycle reporting 표면을 더 정확하게 다듬습니다. umbrella 후보 summary JSON과 report에 signal type을 보존하고, user install 후 packaged `helm` CLI smoke를 통과했으며, OpenClaw workspace hook 경로도 end-to-end로 검증했습니다. 자세한 내용은 [`docs/skill-lifecycle.md`](docs/skill-lifecycle.md) 참고.
 
 Helm에는 private memory, personal agent overlay, credential, private task history가 포함되지 않습니다.
 

README.md

@@ -8,7 +8,7 @@
 
 <p align="center">Helm is a local operations layer for AI agent workspaces: profiles before commands, checkpoints before risky work, durable task history after the chat is gone.</p>
 
-<p align="center"><strong>Current release: v0.7.2</strong></p>
+<p align="center"><strong>Current release: v0.7.3</strong></p>
 
 <p align="center">
   <a href="https://v0-helm-agent-ops.vercel.app/">Landing page</a> ·
@@ -228,6 +228,7 @@ Release details:
 - [`CHANGELOG.md`](CHANGELOG.md)
 - [`CONTRIBUTING.md`](CONTRIBUTING.md)
 - [`SECURITY.md`](SECURITY.md)
+- [`docs/releases/0.7.3.md`](docs/releases/0.7.3.md)
 - [`docs/releases/0.7.2.md`](docs/releases/0.7.2.md)
 - [`docs/releases/0.7.1.md`](docs/releases/0.7.1.md)
 - [`docs/releases/0.7.0.md`](docs/releases/0.7.0.md)
@@ -236,7 +237,7 @@ Release details:
 
 ## Status
 
-Helm v0.7.2 fills the remaining PRD optional items: `helm curator` alias, umbrella `execution_profile` signal, `revalidation-due` for persisted negative claims, and concrete file-inventory preview for archive dry-runs. See [`docs/skill-lifecycle.md`](docs/skill-lifecycle.md).
+Helm v0.7.3 tightens the skill-lifecycle reporting surface: umbrella candidates now preserve their signal type in summary JSON and reports, the packaged `helm` CLI was smoke-tested after user install, and the OpenClaw workspace hook path was verified end-to-end. See [`docs/skill-lifecycle.md`](docs/skill-lifecycle.md).
 
 Helm does not include private memory, personal agent overlays, credentials, or private task history.
 

docs/releases/0.7.3.md

@@ -0,0 +1,44 @@
+# Helm v0.7.3 — Lifecycle Reporting Tightening
+
+**Date:** 2026-05-03
+
+Helm 0.7.3 is a small correctness and packaging release for the
+skill-lifecycle work shipped in 0.7.0-0.7.2. It keeps the public CLI
+surface stable while making summary output less ambiguous and confirming
+that the packaged `helm` command works after user installation.
+
+## Changed
+
+- umbrella candidates in `helm skill-lifecycle status --json` and
+  `helm skill-lifecycle report --format json` now include the source
+  `signal` for each cluster. This matches the standalone
+  `helm skill-lifecycle umbrella --json` command and prevents duplicate
+  tokens such as `market` from looking like the same recommendation.
+- markdown lifecycle reports now label umbrella clusters as
+  `name_token`, `description_token`, `downstream_share`, or
+  `execution_profile` instead of using the generic `shared token`
+  heading for every cluster.
+- the OpenClaw workspace runner hook path was smoke-tested against the
+  same lifecycle sidecar metadata used by Helm. A local `inspect_local`
+  run with `--skill car` recorded both `skill_used` and
+  `skill_success` events.
+- the workspace briefing dedup gate was tightened so URL and filename
+  slug matches are treated as high-specificity Obsidian signals. In the
+  Gemini Embedding 2 regression case, Obsidian matches now narrow to the
+  relevant Gemini note instead of unrelated hub/index notes while still
+  returning `seen_before=true`.
+
+## Packaging
+
+- package metadata bumped to `0.7.3`.
+- installed package smoke passed using the console script:
+  `helm skill-lifecycle scan --path ~/.openclaw/workspace --dry-run --json`.
+
+## Tests
+
+- 60 lifecycle test cases passing.
+- full suite: 369 tests passing.
+
+## Migration
+
+No migration required. Existing 0.7.x lifecycle metadata is compatible.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "helm-agent-ops"
-version = "0.7.2"
+version = "0.7.3"
 description = "Stability-first operations CLI for long-lived agent workspaces."
 readme = "README.md"
 requires-python = ">=3.10"

scripts/skill_lifecycle_lib.py

@@ -446,7 +446,11 @@ def compute_summary(
 
     if paths is not None:
         summary["umbrella_candidates"] = [
-            {"token": cluster.token, "skill_ids": list(cluster.skill_ids)}
+            {
+                "signal": cluster.signal,
+                "token": cluster.token,
+                "skill_ids": list(cluster.skill_ids),
+            }
             for cluster in detect_umbrella_candidates(paths)
         ]
         summary["negative_claim_candidates"] = [
@@ -552,9 +556,10 @@ def _block(title: str, rows: Iterable[tuple[str, float | None]], unit: str) -> N
         lines.append("- (none)")
     else:
         for cluster in umbrella:
+            signal = cluster.get("signal", "name_token")
             token = cluster["token"]
             skills = cluster["skill_ids"]
-            lines.append(f"### shared token: `{token}` ({len(skills)} skills)")
+            lines.append(f"### {signal}: `{token}` ({len(skills)} skills)")
             for skill_id in skills:
                 lines.append(f"- {skill_id}")
             lines.append("")

setup.py

@@ -3,7 +3,7 @@
 
 setup(
     name="helm-agent-ops",
-    version="0.7.2",
+    version="0.7.3",
     description="Stability-first operations CLI for long-lived agent workspaces.",
     py_modules=["helm", "helm_workspace", "helm_context"],
     packages=["scripts", "commands", "references"],

tests/test_skill_lifecycle.py

@@ -637,6 +637,7 @@ def test_compute_summary_with_paths_includes_candidates(tmp_path: Path) -> None:
     usage = load_usage(paths)
     summary = compute_summary(usage, DEFAULT_CONFIG, paths=paths)
     assert summary["umbrella_candidates"]
+    assert summary["umbrella_candidates"][0]["signal"] == "name_token"
     assert summary["umbrella_candidates"][0]["token"] == "search"
     assert summary["negative_claim_candidates"]
     assert summary["negative_claim_candidates"][0]["keyword"] == "unavailable"
@@ -655,7 +656,7 @@ def test_render_report_includes_candidates(tmp_path: Path) -> None:
     usage = load_usage(paths)
     summary = compute_summary(usage, DEFAULT_CONFIG, paths=paths)
     md = render_report_markdown(usage, summary)
-    assert "shared token: `search`" in md
+    assert "name_token: `search`" in md
     assert "alpha-search" in md
     assert "[failed]" in md