[jdx]

Add an artifact-cache flow diagram showing cache-key computation, restoring a hit, and executing and saving a successful miss. Explain how this differs from timestamp freshness checks and note empty outputs, failed runs, and cache bypasses.

Built with mise run docs:build; passed scoped hk checks. Checked Mermaid rendering and readable labels in light/dark mode at 1440px and 390px, with no horizontal page overflow or browser errors.

Preview

Dark mode and phone layout

AI-assisted — Tool: Codex; model: openai/unavailable; version: unavailable.

---

Note

Low Risk
Documentation-only change to docs/tasks/caching.md with no runtime or configuration behavior changes.

Overview
Adds an Artifact cache flow section to the task caching guide with a Mermaid flowchart for eligible tasks: declared inputs feed cache-key computation, a hit restores outputs and replays logs without running the command, and a miss runs the task and saves results on success.

The new prose clarifies that this path is separate from modification-time freshness checks, calls out outputs = [] behavior, notes that failed runs are not cached, and points readers to per-run cache access and storage/replay for bypass and edge cases.

^{Reviewed by Cursor Bugbot for commit d7ecee2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Summary by CodeRabbit

• Documentation
  • Added an “Artifact cache flow” section describing cache hits, misses, output restoration, log replay, and successful result storage.
  • Documented behavior for tasks with no outputs, failed runs, forced execution, disabled cache access, and ineligible tasks.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Central YAML (inherited), Organization UI (inherited)

Review profile: CHILL

Plan: Advanced

Run ID: ca57e836-beac-4242-b4a4-80e6daf50fb3

📥 Commits

Reviewing files that changed from the base of the PR and between e4b5f52 and d7ecee2.

📒 Files selected for processing (1)

• docs/tasks/caching.md

Included review availability: Your plan provides up to 10 included reviews per hour; 6 remain after this review.

---

📝 Walkthrough

Walkthrough

The caching documentation adds an “Artifact cache flow” section. It describes cache keys, cache hits, cache misses, successful result storage, log replay, output restoration, and bypass conditions.

Changes

Artifact cache documentation

Layer / File(s)	Summary
Document artifact cache flow docs/tasks/caching.md	Adds a Mermaid flowchart for cache lookup and execution. Documents outputs = [], failed runs, forced runs, disabled cache access, and ineligible tasks.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Merge Risk: ⚪ Minimal · up to d7ece

The cache-flow documentation is consistent with the described behavior and introduces no runtime changes.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the documentation change and the artifact-cache execution diagram, which matches the main pull request objective.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[greptile-apps]

Confidence Score: 5/5

The documentation-only change appears safe to merge.

Summary

• Distinguishes artifact reuse from modification-time freshness checks.
• Illustrates cache-key computation, hit restoration, miss execution, and successful-result storage.
• Documents empty-output behavior, failed runs, and common cache bypasses.

_{Reviews (1) · Last reviewed commit: "docs: diagram artifact cache execution"}

[github-actions]

Instruction counts

benchmark	trend	instructions	Δ	wall (min)	Δ
env	▁▂▃▂▅▅▄▅▅▆██	34,983,126 → 34,975,887	-0.02%	18.57 → 18.98ms	+2.19%
hook-env	▁▁▁▁██▇█▇██▆	36,438,681 → 36,324,834	-0.31%	19.66 → 19.11ms	-2.82%
ls	▁▂▁▁█▇█▇▇▆█▃	38,917,953 → 38,700,358	-0.56%	21.33 → 21.52ms	+0.87%
registry	▁▁▂▂▆▆▇▆▅▆█▄	37,904,470 → 37,780,768	-0.33%	16.04 → 16.40ms	+2.26%
startup	▁▁▁▁████████	9,493,961 → 9,480,710	-0.14%	10.99 → 10.90ms	-0.81%

No instruction-count regression above 1%.

_{Only instruction counts gate. Wall clock is shown for context — on identical hardware it moves 4-20% run to run.}

_{Measured by tak — instruction-counted CLI benchmarks, stored in this repository's git notes.}

_{d7ecee223904 vs e4b5f52c436c · measured on the runner, not pushed to the history.}