docs: state that createCache.minimal disables graceful degradation (LAB-1770)

[27Bslash6]

Summary

• make the intent table state that minimal disables graceful degradation and propagates errors
• document the corresponding MinimalOptions behavior in editor-facing TSDoc
• reconcile the value-size guidance with the minimal example

Validation

• pnpm exec prettier --check packages/cachekit/README.md packages/cachekit/src/intents-core.ts
• pnpm exec eslint --max-warnings 0 packages/cachekit/src/intents-core.ts
• git diff --check

pnpm --filter @cachekit-io/cachekit test could not complete because this checkout lacks the optional Linux native binding. Its local rebuild is blocked because cargo is unavailable; no test failures are attributable to this documentation-only diff.

Summary by CodeRabbit

• Documentation
  • Clarified that the minimal intent disables circuit breaking, retries, and graceful degradation.
  • Documented that backend and decoding errors propagate when using minimal.
  • Updated value-size-limit guidance to distinguish silent failures from explicit ValueTooLargeError failures.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 305c9306-c81b-4534-b1d1-c0ac4658ba7d

📥 Commits

Reviewing files that changed from the base of the PR and between 13a3345 and fb2eac0.

📒 Files selected for processing (2)

• packages/cachekit/README.md
• packages/cachekit/src/intents-core.ts

---

Walkthrough

The pull request updates minimal intent documentation in the source and README. It documents error propagation when degradation is disabled and distinguishes value-size handling across intents.

Changes

Intent documentation

Layer / File(s)	Summary
Document intent behaviour packages/cachekit/src/intents-core.ts, packages/cachekit/README.md	The documentation states that minimal propagates backend, decode, and oversized-value errors. The intent table describes degradation behaviour for all supported intents.

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

Mergeability Score: ⚪ Minimal · up to fb2ea

This documentation-only change clarifies the behavior of createCache.minimal without changing runtime code, so no actionable merge-blocking risk remains after normal checks and review.

Possibly related PRs

• cachekit-io/cachekit-ts#42: Refines documentation for the minimal intent's degradation and error-propagation behaviour.
• cachekit-io/cachekit-ts#47: Contains related README formatting changes for the minimal intent.
• cachekit-io/cachekit-ts#98: Updates intents-core.ts documentation for createCache.minimal() error behaviour.

🚥 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 summarises the documentation change that createCache.minimal disables graceful degradation.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch lab-1770-minimal-degradation-docs

---

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

[kodus-27b]

Kody Review Complete

Great news! 🎉
No issues were found that match your current review configurations.

Keep up the excellent work! 🚀

Kody Guide: Usage and Configuration

Interacting with Kody

• Request a Review: Ask Kody to review your PR manually by adding a comment with the @kody start-review command at the root of your PR.

• Validate Business Logic: Ask Kody to validate your code against business rules by adding a comment with the @kody -v business-logic command.

• Provide Feedback: Help Kody learn and improve by reacting to its comments with a 👍 for helpful suggestions or a 👎 if improvements are needed.

Current Kody Configuration

Review Options

The following review options are enabled or disabled:

Options	Enabled
Bug	✅
Performance	✅
Security	✅
Business Logic	✅

Access your configuration settings here.

​