What to build
Implement the on-demand refresh path for remote includes (using the command name settled in #20). The refresh/pull command re-fetches remote references, picking up the latest commit for a mutable ref (branch/tag); a SHA-pinned reference does not change (the SHA is immutable). hammerkit clean --cache also purges cached remote references so the next run re-fetches them. Together these are the only ways a cached mutable-ref include is updated (the cache is otherwise the stable pin). Builds on the git-source resolution + reference cache from #26.
References: specs/remote-includes/spec.md (US3, FR-004); docs/adr/0004.
Acceptance criteria
Blocked by
What to build
Implement the on-demand refresh path for remote includes (using the command name settled in #20). The refresh/pull command re-fetches remote references, picking up the latest commit for a mutable ref (branch/tag); a SHA-pinned reference does not change (the SHA is immutable).
hammerkit clean --cachealso purges cached remote references so the next run re-fetches them. Together these are the only ways a cached mutable-ref include is updated (the cache is otherwise the stable pin). Builds on the git-source resolution + reference cache from #26.References:
specs/remote-includes/spec.md(US3, FR-004);docs/adr/0004.Acceptance criteria
hammerkit clean --cachepurges cached remote references, forcing the next run to re-fetch (SC-003).Blocked by
references/includes(cache-as-pin, offline) #26 (git-source resolution + reference cache)