Skip to content

feat(cli): close out cache pre-warming with tests, config, and docs - #570

Merged
d-oit merged 4 commits into
mainfrom
feat/cache-prewarm-hardening
Aug 11, 2026
Merged

feat(cli): close out cache pre-warming with tests, config, and docs#570
d-oit merged 4 commits into
mainfrom
feat/cache-prewarm-hardening

Conversation

@d-oit

@d-oit d-oit commented Aug 10, 2026

Copy link
Copy Markdown
Owner

Closes out Plan 11 (cache pre-warming): tests, config, and docs. The core (prewarm loop, web throttle) was already shipped; this lands the remaining offline-test, config, and documentation contracts.

Changes

  • cli/src/startup.rs — extract a testable core prewarm_domains(resolver: impl Fn(String) -> Fut) behind the unchanged public prewarm_cache(resolver, config) signature (per repo ADR-014 DI direction). Also fixes the join loop: after all tasks complete it now returns immediately instead of always sleeping the full 60s OVERALL_TIMEOUT (a tokio::select! else/deadline interaction that blocked every CLI resolve for ~60s).
  • cli/tests/startup_prewarm.rs — 2 offline tests: empty-domains skip guard (resolve fn never invoked), one resolve per domain.
  • cli/tests/startup_semaphore.rs — 2 offline tests: peak in-flight ≤ max_concurrency; no deadlock/timeout.
  • cli/tests/config_prewarm.rs — 2 tests: [routing.prewarm] TOML → PrewarmConfig round-trip; defaults match the committed block.
  • config.toml — add explicit [routing.prewarm] block (values match defaults.rs).
  • agents-docs/CONFIG.md — document [routing.prewarm].

Verification

  • cargo test: 138 passed / 15 suites (incl. new prewarm + config tests, now ~ms not 60s each)
  • cargo clippy --all-targets -- -D warnings: clean
  • cargo fmt --check: clean
  • scripts/validate_docs.py: 0 errors, 0 warnings; version sync + skill symlinks pass
  • Dropped Plan-11 T3's Python framing: grep prewarm scripts/ is empty — prewarm is Rust-CLI + Web only

@vercel

vercel Bot commented Aug 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
do-web-doc-resolover Ready Ready Preview Aug 11, 2026 7:53am

@deepsource-io

deepsource-io Bot commented Aug 10, 2026

Copy link
Copy Markdown

DeepSource Code Review

We reviewed changes in db195ae...8a9a3e5 on this pull request. Below is the summary for the review, and you can see the individual issues we found as inline review comments.

See full review on DeepSource ↗

PR Report Card

Overall Grade   Security  

Reliability  

Complexity  

Hygiene  

Code Review Summary

Analyzer Status Updated (UTC) Details
JavaScript Aug 11, 2026 7:53a.m. Review ↗
Python Aug 11, 2026 7:53a.m. Review ↗
Rust Aug 11, 2026 7:53a.m. Review ↗
Shell Aug 11, 2026 7:53a.m. Review ↗

Important

AI Review is run only on demand for your team. We're only showing results of static analysis review right now. To trigger AI Review, comment @deepsourcebot review on this thread.

@codacy-production

codacy-production Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Metrics 5 complexity · 4 duplication

Metric Results
Complexity 5
Duplication 4

View in Codacy

NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer
TIP This summary will be updated as you push new changes.

@d-oit
d-oit force-pushed the feat/cache-prewarm-hardening branch from 765d2cc to 8a9a3e5 Compare August 11, 2026 07:52
@d-oit
d-oit merged commit 62ea294 into main Aug 11, 2026
53 checks passed
@d-oit
d-oit deleted the feat/cache-prewarm-hardening branch August 11, 2026 07:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants