[jdx]

Summary

• define experimental remote task-cache HTTP protocol version 1
• specify discovery, namespace isolation, immutable keys, and manifest/artifact media types
• define artifact-first atomic publication, streaming, cache-miss, corruption, and HTTP failure semantics
• link the protocol from task documentation and mark the tracker item complete

Validation

• mise run lint-fix
• mise run docs:build

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

---

Note

Low Risk
Documentation and navigation only; no runtime, config, or client/server implementation changes in this PR.

Overview
Adds the first public Remote Task Cache Protocol spec (version 1) as docs/tasks/remote-cache-protocol.md, describing an HTTPS content-addressed design separate from mise’s local cache layout.

The doc defines CAS (blobs and directory objects) vs action results (canonical task action digest → outputs, logs, metadata), with BLAKE3/SHA-256 digests, RFC 8785 canonical JSON, and versioned /v1 endpoints for capabilities, blob missing/read/upload (including resumable sessions), and atomic action-result commit. It also covers namespaces, auth, Ed25519 signatures, failure/retry semantics, self-hosted storage expectations, and points to the separate jdx/mise-cache reference server.

TASK_CACHE_PARITY.md marks “Define and document a versioned remote cache protocol” complete. The new page is linked from the Tasks sidebar and docs/public/llms.txt.

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

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

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

Review profile: CHILL

Plan: Pro Plus

Run ID: 8f98638e-e408-4c06-9b4d-2427fa943016

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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]

Greptile Summary

Adds the experimental version 1 remote task-cache protocol and exposes it through the documentation site.

• Defines discovery, canonical objects, CAS and action-result operations, namespace isolation, signatures, retries, and self-hosting requirements.
• Links the protocol from the task sidebar and LLM index.
• Marks the remote-protocol parity item complete.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename	Overview
docs/tasks/remote-cache-protocol.md	Defines the version 1 remote task-cache HTTP protocol, including integrity, authorization, transfer, publication, and failure semantics.
docs/.vitepress/sidebar.ts	Adds the remote cache protocol page to the Tasks documentation navigation.
docs/public/llms.txt	Adds the new protocol page to the public documentation index.
TASK_CACHE_PARITY.md	Marks documentation of the versioned remote cache protocol as complete.

_{Reviews (10): Last reviewed commit: "docs(task): define action result envelop..." | Re-trigger Greptile}

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

[github-actions]

Instruction counts

benchmark	trend	instructions	Δ	wall (min)	Δ
env	▃▄▂▁▁▂▄▃▄█	80,074,952 → 80,167,689	+0.12%	17.64 → 18.65ms	+5.69%
hook-env	▇▆▁▄▃▂▄▃▆█	82,190,914 → 82,258,361	+0.08%	18.34 → 18.90ms	+3.09%
ls	▅▄▁▁▁▇▆▇▆█	73,127,800 → 73,171,412	+0.06%	15.71 → 16.58ms	+5.51%
registry	▁▁▂▁▂▄▃▅▂█	49,102,713 → 49,284,557	+0.37%	11.64 → 12.26ms	+5.31%
startup	▃▃▁▃▂▁▂▂▃█	15,784,751 → 15,827,739	+0.27%	9.04 → 8.94ms	-1.10%

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.}

_{714401723f46 vs e5230aa14775 · measured on the runner, not pushed to the history.}

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 6237070. Configure here.}

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

Dismissed because a newer commit was pushed; Greptile will re-review the current head.