From 6f2933c70feacf4c1589b77bd3809c733eccfea3 Mon Sep 17 00:00:00 2001 From: Codex Date: Mon, 6 Jul 2026 03:34:05 +0000 Subject: [PATCH] docs: clarify hwlab env reuse evidence --- .agents/skills/unidesk-cicd/references/env-reuse.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.agents/skills/unidesk-cicd/references/env-reuse.md b/.agents/skills/unidesk-cicd/references/env-reuse.md index bdc9492d..e0ee67e2 100644 --- a/.agents/skills/unidesk-cicd/references/env-reuse.md +++ b/.agents/skills/unidesk-cicd/references/env-reuse.md @@ -71,6 +71,8 @@ Use these interpretations: - Sentinel `ENV_REUSE=hit`: node dependency directory was present and linked before verify/build. - Sentinel `cache=hit`: BuildKit cache evidence, separate from dependency reuse. - HWLAB v0.3 `skipped,skip=` in PaC history: service-level artifact planning skipped builds for already reusable services; inspect the detail id before interpreting it as AgentRun-style image reuse. +- HWLAB v0.3 `env-reuse-git-mirror-checkout`: a `codeIdentity` change with unchanged `envIdentity` should mark the service as affected/rolled out while still skipping image build. Evidence is in `plan-artifacts` and `collect-artifacts`: `affectedServices` includes the service, `buildServices=[]`, the artifact has `ciAffected=true`, `ciReason` such as `code-input-changed`, a new `componentCommitId`/`codeInputHash`, and `publishState=reused` / `buildBackend=reused-env-catalog`. This is correct env reuse consumption, not a missed rebuild. +- HWLAB v0.3 non-reuse image build is expected when `envIdentity` changes, such as shared dependency or env launcher inputs. Then `buildServices` should include services whose environment identity changed and build TaskRuns should be present. Do not use one consumer's evidence vocabulary to judge another consumer. In particular, do not expect every PaC consumer to expose an `ENV_ID`, and do not treat a blank `ENV_REUSE` cell as a failed env reuse without checking the consumer implementation.