[binlecode]

Why this had to move into the build

docs/cover.html was hand-synced, and produced two bugs in a row:

1. It sat several versions behind (shipped vv1.8.0 while the repo was on 1.9.x).
2. Its hero image never resolved — it referenced actop-demo.gif relative to docs/, where no such file exists.

Neither was carelessness; the manual step cannot be done correctly. The version badge is injected at build time from pyproject.toml, so any hand-edited duplicate is stale the moment the version moves. And because the copy lands outside dist-cover/, every relative asset path in it dangles by construction.

What changed

New LOCAL_COPY phase (default docs/cover.html, "" to skip):

• Runs after the secret scan, so a snapshot is never written carrying a leak the scan would have rejected.
• Re-points asset references at COVER_SRC, computed relative to wherever the copy lands — docs/cover.html gets ../cover/actop-demo.gif.
• Leaves alone anchors (#features), absolute URLs, protocol-relative and already-relative refs, and anything that does not resolve to a real file in the source tree. It rewrites only what it can verify, rather than silently pointing something somewhere wrong.
• Mirrors index.html only — this is a browsable snapshot, not a second dist.

Verified

$ bash .agents/skills/publish-cover/scripts/build-cover-dist.sh
[build-cover] emitting local copy → docs/cover.html
  assets re-pointed at ../cover/

$ grep -oE 'class="badge">[^<]*|<img src="[^"]*"|href="[^"]*"' docs/cover.html | sort -u
<img src="../cover/actop-demo.gif"
class="badge">v1.9.5
href="#api"
href="#features"
href="https://github.com/binlecode/actop"
...

Asset resolves; anchors and external links untouched; badge matches the tag. bash -n clean.

Skill docs updated with the phase, the env var, and an explicit "never edit it by hand" note.

🤖 Generated with Claude Code