fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle - #26

Merged
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard
Jul 7, 2026
Merged

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle#26
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Two independent changes, bundled per request so the stranded Docs restyle rides an already-open PR to main.

1. Timeout-guard Workers AI so a hung summarize can't wedge Sync GitHub

Problem. The admin Sync GitHub button sticks forever on "Contacting GitHub — taking inventory of PRs and issues…". POST /admin/backfill calls Workers AI (@cf/google/gemma-4-26b-a4b-it, a slow 26B model) synchronously in the request the browser waits on. The await ai.run(...) in makeWorkersAiSummarizer is unbounded: when the daily Neuron budget is exhausted or the model is overloaded, the call can hang indefinitely (never resolves, never rejects). The surrounding try/catch only handles throws, so a hang wedges the whole request — observed as POST /admin/backfill never completing (>2 min) with 0 summary rows written.

Fix.

  • makeWorkersAiSummarizer races ai.run(...) against a timer (WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the samecatch, returns null, and the existing deterministic excerpt fallback fires — so the request always completes. Timeout is injectable (workersAiPrSummarizer(ai, timeoutMs?) / workersAiIssueSummarizer(ai, timeoutMs?)) for unit testing; clearTimeout in a finally leaves no pending timer on a healthy call.
  • SUMMARY_BATCH_LIMIT 20 → 5, so each /admin/backfill returns quickly and the frontend auto-loop shows progress instead of one long stall.
  • The catch's diagnostic console.error now also logs timeouts (visible in wrangler tail).

Test (TDD, failing-first). New workersAiSummarizer — timeout guard block: a fake ai whose run never resolves + a 50ms injected timeout must resolve to null / model='excerpt' within the timeout. Verified RED then GREEN.

2. Re-land the Docs reader restyle onto main

The Docs reader restyle + collapsible nav tree (originally PR #25) was accidentally merged into the already-merged feat/mywork-grid-seed-docs branch instead of main, so it never reached main. Its web-only commit (web/src/canopy.css, main.ts, markdown.ts, render.ts) is cherry-picked here. The stale backfill.ts on that branch — a pre-#23 revert — is deliberately not included.

Verification

  • npm run build:web → ok · npm run typecheck → clean (worker + web) · npx vitest run --exclude '**/.claude/**'422 passed
  • ⏳ Deployed-worker verification of the timeout path is pending (Workers AI can't run locally) — confirm on the deployed canopy worker via wrangler tail + a Sync click.

🤖 Generated with Claude Code

…'t wedge Sync
The Sync GitHub button stuck forever on "Contacting GitHub…" because
POST /admin/backfill awaits ai.run() unbounded: an exhausted Neuron budget
or overloaded 26B model can leave the call pending forever (never resolves,
never rejects), so the try/catch — which only handles throws — can't recover.
makeWorkersAiSummarizer now races ai.run against an injectable timer
(WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the same catch,
returns null, and the existing deterministic excerpt fallback fires — the
request always completes. Shrink SUMMARY_BATCH_LIMIT 20 -> 5 so each batch
returns quickly and the frontend's auto-loop shows progress instead of a stall.
Test (failing-first): a fake ai whose run never resolves + a short injected
timeout must resolve to null / model='excerpt' within the timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@AndresL230, you've reached your PR review limit, so we couldn't start this review.

Next review available in:49 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5da8b87-6b2c-410d-9c73-171dbac8cc09

📥 Commits

Reviewing files that changed from the base of the PR and between 1038be7 and b363101.

📒 Files selected for processing (6)
  • src/tools/summarize.ts
  • test/summarize.test.ts
  • web/src/canopy.css
  • web/src/main.ts
  • web/src/markdown.ts
  • web/src/render.ts
📝 Walkthrough

Walkthrough

Adds a bounded timeout (WORKERS_AI_TIMEOUT_MS) to Workers AI summarizer calls using Promise.race, falling back to null (and thus excerpt summarization) on timeout or failure. Both public summarizer wrappers gain an optional timeoutMs parameter. Backfill's SUMMARY_BATCH_LIMIT is lowered from 20 to 5. Tests added for timeout fallback behavior.

Changes

Workers AI timeout and backfill batching

Layer / File(s)Summary
Timeout constant and race-based execution guard
src/tools/summarize.ts
Adds WORKERS_AI_TIMEOUT_MS and races ai.run against a timeout, returning null on timeout/throw/malformed output, clearing the timer in finally.
Public wrapper signatures and batch limit reduction
src/tools/summarize.ts, src/tools/backfill.ts
Updates workersAiPrSummarizer/workersAiIssueSummarizer to accept optional timeoutMs; lowers SUMMARY_BATCH_LIMIT from 20 to 5 with updated comments.
Timeout fallback tests
test/summarize.test.ts
Adds tests simulating a hanging AI call, verifying summarizers return null and storage functions fall back to excerpt summaries within timeout.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
participant Caller
participant SharedSummarizer
participant AiRun
participant TimeoutTimer
Caller->>SharedSummarizer: workersAiPrSummarizer/IssueSummarizer(ai, timeoutMs)
SharedSummarizer->>AiRun: ai.run(...)
SharedSummarizer->>TimeoutTimer: start timer(timeoutMs)
alt AiRun resolves first
AiRun-->>SharedSummarizer: model output
SharedSummarizer-->>Caller: parsed summary
else Timer fires first
TimeoutTimer-->>SharedSummarizer: timeout rejection
SharedSummarizer-->>Caller: null (fallback to excerpt)
end
SharedSummarizer->>TimeoutTimer: clear timer (finally)
Loading

Possibly related PRs

  • SaplingLearn/canopy#11: Both PRs modify the workersAi*Summarizer/shared summarizer logic in src/tools/summarize.ts.
  • SaplingLearn/canopy#12: Both PRs modify the Workers AI summarizer to return null on unusable ai.run() results, with overlapping test changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title captures the main Workers-AI timeout/backfill fix, though the trailing docs restyle note appears unrelated.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/backfill-ai-timeout-guard

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

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

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
canopyb363101Commit Preview URL

Branch Preview URL
Jul 07 2026, 06:20 AM

Frontend-only design pass on the Docs page, styled entirely with the theme
CSS vars so it holds in all three themes (dark / light / midnight).
Reader (web/src/render.ts, canopy.css):
- Centered reading column (~730px measure) with a wrap-safe title (drops the
white-space:nowrap that could overflow long titles) and a mono
`SPACE / SECTION` eyebrow.
- Markdown: stronger reading ink (color-mix off --fg), real heading hierarchy
(h2 hairline rule, h3 distinct at 16px), language-tagged code panels,
callout blockquotes (accent-soft), crisp inline-code chips, accent-numbered
ordered lists, and editorial ledger-style tables (rule-only borders, mono
uppercase headers).
Nav tree (web/src/render.ts, main.ts, canopy.css):
- Sections are now collapsible: a header button (rotating chevron + mono
label + count) toggles each section; collapse state persists to
localStorage, keyed `${space}:${section}`.
- Active doc is a clean --accent-soft pill matching the sidebar's active
style; removes the inset accent line (.cnpy-selbar no longer used here —
left intact for review.ts).
markdown.ts:
- Post-sanitize DOM pass wraps code blocks in a `.cnpy-code` panel (tagged
with the fence language) and tables in a scroll wrapper. Browser-only;
render tests mock this module.
Verified across dark/light/midnight in both Sapling and Canopy spaces.
typecheck green; full suite 418/418.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230AndresL230 changed the title fix(backfill): timeout-guard Workers AI so a hung summarize can't wedge Sync GitHubfix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyleJul 7, 2026

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/tools/summarize.ts`:
- Around line 137-176: The current timeout logic in summarize() only stops
waiting because Promise.race does not cancel ai.run, so timed-out Workers AI
calls can keep consuming capacity. Update the workersAiSummarizer flow to create
an AbortController, pass its signal through the ai.run(AWORKERS_AI_MODEL, ...)
AiOptions, and abort it when the timeout promise wins; keep the existing
catch/fallback behavior and ensure the timer is still cleared in finally.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b368762-968f-4a7c-aed9-7c6168673869

📥 Commits

Reviewing files that changed from the base of the PR and between b28f5e5 and 1038be7.

📒 Files selected for processing (3)
  • src/tools/backfill.ts
  • src/tools/summarize.ts
  • test/summarize.test.ts

Comment threadsrc/tools/summarize.ts
Promise.race only stops WAITING for ai.run — the losing call keeps its
inference subrequest alive and keeps consuming capacity. Across a backfill
batch that piles up several abandoned calls against the very capacity that's
already exhausted. Thread an AbortSignal (AiOptions.signal, supported since
workerd early 2026) into ai.run and abort it when the timeout wins, so a
timed-out summary actually cancels. Timeout->null->excerpt fallback unchanged.
Addresses CodeRabbit review on PR #26.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230
AndresL230 merged commit d2e6287 into mainJul 7, 2026
2 checks passed
Sign up for freeto 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.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle - #26

Merged
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard
Jul 7, 2026
Merged

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle#26
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Two independent changes, bundled per request so the stranded Docs restyle rides an already-open PR to main.

1. Timeout-guard Workers AI so a hung summarize can't wedge Sync GitHub

Problem. The admin Sync GitHub button sticks forever on "Contacting GitHub — taking inventory of PRs and issues…". POST /admin/backfill calls Workers AI (@cf/google/gemma-4-26b-a4b-it, a slow 26B model) synchronously in the request the browser waits on. The await ai.run(...) in makeWorkersAiSummarizer is unbounded: when the daily Neuron budget is exhausted or the model is overloaded, the call can hang indefinitely (never resolves, never rejects). The surrounding try/catch only handles throws, so a hang wedges the whole request — observed as POST /admin/backfill never completing (>2 min) with 0 summary rows written.

Fix.

  • makeWorkersAiSummarizer races ai.run(...) against a timer (WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the samecatch, returns null, and the existing deterministic excerpt fallback fires — so the request always completes. Timeout is injectable (workersAiPrSummarizer(ai, timeoutMs?) / workersAiIssueSummarizer(ai, timeoutMs?)) for unit testing; clearTimeout in a finally leaves no pending timer on a healthy call.
  • SUMMARY_BATCH_LIMIT 20 → 5, so each /admin/backfill returns quickly and the frontend auto-loop shows progress instead of one long stall.
  • The catch's diagnostic console.error now also logs timeouts (visible in wrangler tail).

Test (TDD, failing-first). New workersAiSummarizer — timeout guard block: a fake ai whose run never resolves + a 50ms injected timeout must resolve to null / model='excerpt' within the timeout. Verified RED then GREEN.

2. Re-land the Docs reader restyle onto main

The Docs reader restyle + collapsible nav tree (originally PR #25) was accidentally merged into the already-merged feat/mywork-grid-seed-docs branch instead of main, so it never reached main. Its web-only commit (web/src/canopy.css, main.ts, markdown.ts, render.ts) is cherry-picked here. The stale backfill.ts on that branch — a pre-#23 revert — is deliberately not included.

Verification

  • npm run build:web → ok · npm run typecheck → clean (worker + web) · npx vitest run --exclude '**/.claude/**'422 passed
  • ⏳ Deployed-worker verification of the timeout path is pending (Workers AI can't run locally) — confirm on the deployed canopy worker via wrangler tail + a Sync click.

🤖 Generated with Claude Code

…'t wedge Sync
The Sync GitHub button stuck forever on "Contacting GitHub…" because
POST /admin/backfill awaits ai.run() unbounded: an exhausted Neuron budget
or overloaded 26B model can leave the call pending forever (never resolves,
never rejects), so the try/catch — which only handles throws — can't recover.
makeWorkersAiSummarizer now races ai.run against an injectable timer
(WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the same catch,
returns null, and the existing deterministic excerpt fallback fires — the
request always completes. Shrink SUMMARY_BATCH_LIMIT 20 -> 5 so each batch
returns quickly and the frontend's auto-loop shows progress instead of a stall.
Test (failing-first): a fake ai whose run never resolves + a short injected
timeout must resolve to null / model='excerpt' within the timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@AndresL230, you've reached your PR review limit, so we couldn't start this review.

Next review available in:49 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5da8b87-6b2c-410d-9c73-171dbac8cc09

📥 Commits

Reviewing files that changed from the base of the PR and between 1038be7 and b363101.

📒 Files selected for processing (6)
  • src/tools/summarize.ts
  • test/summarize.test.ts
  • web/src/canopy.css
  • web/src/main.ts
  • web/src/markdown.ts
  • web/src/render.ts
📝 Walkthrough

Walkthrough

Adds a bounded timeout (WORKERS_AI_TIMEOUT_MS) to Workers AI summarizer calls using Promise.race, falling back to null (and thus excerpt summarization) on timeout or failure. Both public summarizer wrappers gain an optional timeoutMs parameter. Backfill's SUMMARY_BATCH_LIMIT is lowered from 20 to 5. Tests added for timeout fallback behavior.

Changes

Workers AI timeout and backfill batching

Layer / File(s)Summary
Timeout constant and race-based execution guard
src/tools/summarize.ts
Adds WORKERS_AI_TIMEOUT_MS and races ai.run against a timeout, returning null on timeout/throw/malformed output, clearing the timer in finally.
Public wrapper signatures and batch limit reduction
src/tools/summarize.ts, src/tools/backfill.ts
Updates workersAiPrSummarizer/workersAiIssueSummarizer to accept optional timeoutMs; lowers SUMMARY_BATCH_LIMIT from 20 to 5 with updated comments.
Timeout fallback tests
test/summarize.test.ts
Adds tests simulating a hanging AI call, verifying summarizers return null and storage functions fall back to excerpt summaries within timeout.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
participant Caller
participant SharedSummarizer
participant AiRun
participant TimeoutTimer
Caller->>SharedSummarizer: workersAiPrSummarizer/IssueSummarizer(ai, timeoutMs)
SharedSummarizer->>AiRun: ai.run(...)
SharedSummarizer->>TimeoutTimer: start timer(timeoutMs)
alt AiRun resolves first
AiRun-->>SharedSummarizer: model output
SharedSummarizer-->>Caller: parsed summary
else Timer fires first
TimeoutTimer-->>SharedSummarizer: timeout rejection
SharedSummarizer-->>Caller: null (fallback to excerpt)
end
SharedSummarizer->>TimeoutTimer: clear timer (finally)
Loading

Possibly related PRs

  • SaplingLearn/canopy#11: Both PRs modify the workersAi*Summarizer/shared summarizer logic in src/tools/summarize.ts.
  • SaplingLearn/canopy#12: Both PRs modify the Workers AI summarizer to return null on unusable ai.run() results, with overlapping test changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title captures the main Workers-AI timeout/backfill fix, though the trailing docs restyle note appears unrelated.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/backfill-ai-timeout-guard

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

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

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
canopyb363101Commit Preview URL

Branch Preview URL
Jul 07 2026, 06:20 AM

Frontend-only design pass on the Docs page, styled entirely with the theme
CSS vars so it holds in all three themes (dark / light / midnight).
Reader (web/src/render.ts, canopy.css):
- Centered reading column (~730px measure) with a wrap-safe title (drops the
white-space:nowrap that could overflow long titles) and a mono
`SPACE / SECTION` eyebrow.
- Markdown: stronger reading ink (color-mix off --fg), real heading hierarchy
(h2 hairline rule, h3 distinct at 16px), language-tagged code panels,
callout blockquotes (accent-soft), crisp inline-code chips, accent-numbered
ordered lists, and editorial ledger-style tables (rule-only borders, mono
uppercase headers).
Nav tree (web/src/render.ts, main.ts, canopy.css):
- Sections are now collapsible: a header button (rotating chevron + mono
label + count) toggles each section; collapse state persists to
localStorage, keyed `${space}:${section}`.
- Active doc is a clean --accent-soft pill matching the sidebar's active
style; removes the inset accent line (.cnpy-selbar no longer used here —
left intact for review.ts).
markdown.ts:
- Post-sanitize DOM pass wraps code blocks in a `.cnpy-code` panel (tagged
with the fence language) and tables in a scroll wrapper. Browser-only;
render tests mock this module.
Verified across dark/light/midnight in both Sapling and Canopy spaces.
typecheck green; full suite 418/418.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230AndresL230 changed the title fix(backfill): timeout-guard Workers AI so a hung summarize can't wedge Sync GitHubfix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyleJul 7, 2026

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/tools/summarize.ts`:
- Around line 137-176: The current timeout logic in summarize() only stops
waiting because Promise.race does not cancel ai.run, so timed-out Workers AI
calls can keep consuming capacity. Update the workersAiSummarizer flow to create
an AbortController, pass its signal through the ai.run(AWORKERS_AI_MODEL, ...)
AiOptions, and abort it when the timeout promise wins; keep the existing
catch/fallback behavior and ensure the timer is still cleared in finally.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b368762-968f-4a7c-aed9-7c6168673869

📥 Commits

Reviewing files that changed from the base of the PR and between b28f5e5 and 1038be7.

📒 Files selected for processing (3)
  • src/tools/backfill.ts
  • src/tools/summarize.ts
  • test/summarize.test.ts

Comment threadsrc/tools/summarize.ts
Promise.race only stops WAITING for ai.run — the losing call keeps its
inference subrequest alive and keeps consuming capacity. Across a backfill
batch that piles up several abandoned calls against the very capacity that's
already exhausted. Thread an AbortSignal (AiOptions.signal, supported since
workerd early 2026) into ai.run and abort it when the timeout wins, so a
timed-out summary actually cancels. Timeout->null->excerpt fallback unchanged.
Addresses CodeRabbit review on PR #26.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230
AndresL230 merged commit d2e6287 into mainJul 7, 2026
2 checks passed
Sign up for freeto 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.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle - #26

Merged
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard
Jul 7, 2026
Merged

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle#26
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Two independent changes, bundled per request so the stranded Docs restyle rides an already-open PR to main.

1. Timeout-guard Workers AI so a hung summarize can't wedge Sync GitHub

Problem. The admin Sync GitHub button sticks forever on "Contacting GitHub — taking inventory of PRs and issues…". POST /admin/backfill calls Workers AI (@cf/google/gemma-4-26b-a4b-it, a slow 26B model) synchronously in the request the browser waits on. The await ai.run(...) in makeWorkersAiSummarizer is unbounded: when the daily Neuron budget is exhausted or the model is overloaded, the call can hang indefinitely (never resolves, never rejects). The surrounding try/catch only handles throws, so a hang wedges the whole request — observed as POST /admin/backfill never completing (>2 min) with 0 summary rows written.

Fix.

  • makeWorkersAiSummarizer races ai.run(...) against a timer (WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the samecatch, returns null, and the existing deterministic excerpt fallback fires — so the request always completes. Timeout is injectable (workersAiPrSummarizer(ai, timeoutMs?) / workersAiIssueSummarizer(ai, timeoutMs?)) for unit testing; clearTimeout in a finally leaves no pending timer on a healthy call.
  • SUMMARY_BATCH_LIMIT 20 → 5, so each /admin/backfill returns quickly and the frontend auto-loop shows progress instead of one long stall.
  • The catch's diagnostic console.error now also logs timeouts (visible in wrangler tail).

Test (TDD, failing-first). New workersAiSummarizer — timeout guard block: a fake ai whose run never resolves + a 50ms injected timeout must resolve to null / model='excerpt' within the timeout. Verified RED then GREEN.

2. Re-land the Docs reader restyle onto main

The Docs reader restyle + collapsible nav tree (originally PR #25) was accidentally merged into the already-merged feat/mywork-grid-seed-docs branch instead of main, so it never reached main. Its web-only commit (web/src/canopy.css, main.ts, markdown.ts, render.ts) is cherry-picked here. The stale backfill.ts on that branch — a pre-#23 revert — is deliberately not included.

Verification

  • npm run build:web → ok · npm run typecheck → clean (worker + web) · npx vitest run --exclude '**/.claude/**'422 passed
  • ⏳ Deployed-worker verification of the timeout path is pending (Workers AI can't run locally) — confirm on the deployed canopy worker via wrangler tail + a Sync click.

🤖 Generated with Claude Code

…'t wedge Sync
The Sync GitHub button stuck forever on "Contacting GitHub…" because
POST /admin/backfill awaits ai.run() unbounded: an exhausted Neuron budget
or overloaded 26B model can leave the call pending forever (never resolves,
never rejects), so the try/catch — which only handles throws — can't recover.
makeWorkersAiSummarizer now races ai.run against an injectable timer
(WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the same catch,
returns null, and the existing deterministic excerpt fallback fires — the
request always completes. Shrink SUMMARY_BATCH_LIMIT 20 -> 5 so each batch
returns quickly and the frontend's auto-loop shows progress instead of a stall.
Test (failing-first): a fake ai whose run never resolves + a short injected
timeout must resolve to null / model='excerpt' within the timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@AndresL230, you've reached your PR review limit, so we couldn't start this review.

Next review available in:49 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5da8b87-6b2c-410d-9c73-171dbac8cc09

📥 Commits

Reviewing files that changed from the base of the PR and between 1038be7 and b363101.

📒 Files selected for processing (6)
  • src/tools/summarize.ts
  • test/summarize.test.ts
  • web/src/canopy.css
  • web/src/main.ts
  • web/src/markdown.ts
  • web/src/render.ts
📝 Walkthrough

Walkthrough

Adds a bounded timeout (WORKERS_AI_TIMEOUT_MS) to Workers AI summarizer calls using Promise.race, falling back to null (and thus excerpt summarization) on timeout or failure. Both public summarizer wrappers gain an optional timeoutMs parameter. Backfill's SUMMARY_BATCH_LIMIT is lowered from 20 to 5. Tests added for timeout fallback behavior.

Changes

Workers AI timeout and backfill batching

Layer / File(s)Summary
Timeout constant and race-based execution guard
src/tools/summarize.ts
Adds WORKERS_AI_TIMEOUT_MS and races ai.run against a timeout, returning null on timeout/throw/malformed output, clearing the timer in finally.
Public wrapper signatures and batch limit reduction
src/tools/summarize.ts, src/tools/backfill.ts
Updates workersAiPrSummarizer/workersAiIssueSummarizer to accept optional timeoutMs; lowers SUMMARY_BATCH_LIMIT from 20 to 5 with updated comments.
Timeout fallback tests
test/summarize.test.ts
Adds tests simulating a hanging AI call, verifying summarizers return null and storage functions fall back to excerpt summaries within timeout.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
participant Caller
participant SharedSummarizer
participant AiRun
participant TimeoutTimer
Caller->>SharedSummarizer: workersAiPrSummarizer/IssueSummarizer(ai, timeoutMs)
SharedSummarizer->>AiRun: ai.run(...)
SharedSummarizer->>TimeoutTimer: start timer(timeoutMs)
alt AiRun resolves first
AiRun-->>SharedSummarizer: model output
SharedSummarizer-->>Caller: parsed summary
else Timer fires first
TimeoutTimer-->>SharedSummarizer: timeout rejection
SharedSummarizer-->>Caller: null (fallback to excerpt)
end
SharedSummarizer->>TimeoutTimer: clear timer (finally)
Loading

Possibly related PRs

  • SaplingLearn/canopy#11: Both PRs modify the workersAi*Summarizer/shared summarizer logic in src/tools/summarize.ts.
  • SaplingLearn/canopy#12: Both PRs modify the Workers AI summarizer to return null on unusable ai.run() results, with overlapping test changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title captures the main Workers-AI timeout/backfill fix, though the trailing docs restyle note appears unrelated.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/backfill-ai-timeout-guard

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

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

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
canopyb363101Commit Preview URL

Branch Preview URL
Jul 07 2026, 06:20 AM

Frontend-only design pass on the Docs page, styled entirely with the theme
CSS vars so it holds in all three themes (dark / light / midnight).
Reader (web/src/render.ts, canopy.css):
- Centered reading column (~730px measure) with a wrap-safe title (drops the
white-space:nowrap that could overflow long titles) and a mono
`SPACE / SECTION` eyebrow.
- Markdown: stronger reading ink (color-mix off --fg), real heading hierarchy
(h2 hairline rule, h3 distinct at 16px), language-tagged code panels,
callout blockquotes (accent-soft), crisp inline-code chips, accent-numbered
ordered lists, and editorial ledger-style tables (rule-only borders, mono
uppercase headers).
Nav tree (web/src/render.ts, main.ts, canopy.css):
- Sections are now collapsible: a header button (rotating chevron + mono
label + count) toggles each section; collapse state persists to
localStorage, keyed `${space}:${section}`.
- Active doc is a clean --accent-soft pill matching the sidebar's active
style; removes the inset accent line (.cnpy-selbar no longer used here —
left intact for review.ts).
markdown.ts:
- Post-sanitize DOM pass wraps code blocks in a `.cnpy-code` panel (tagged
with the fence language) and tables in a scroll wrapper. Browser-only;
render tests mock this module.
Verified across dark/light/midnight in both Sapling and Canopy spaces.
typecheck green; full suite 418/418.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230AndresL230 changed the title fix(backfill): timeout-guard Workers AI so a hung summarize can't wedge Sync GitHubfix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyleJul 7, 2026

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/tools/summarize.ts`:
- Around line 137-176: The current timeout logic in summarize() only stops
waiting because Promise.race does not cancel ai.run, so timed-out Workers AI
calls can keep consuming capacity. Update the workersAiSummarizer flow to create
an AbortController, pass its signal through the ai.run(AWORKERS_AI_MODEL, ...)
AiOptions, and abort it when the timeout promise wins; keep the existing
catch/fallback behavior and ensure the timer is still cleared in finally.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b368762-968f-4a7c-aed9-7c6168673869

📥 Commits

Reviewing files that changed from the base of the PR and between b28f5e5 and 1038be7.

📒 Files selected for processing (3)
  • src/tools/backfill.ts
  • src/tools/summarize.ts
  • test/summarize.test.ts

Comment threadsrc/tools/summarize.ts
Promise.race only stops WAITING for ai.run — the losing call keeps its
inference subrequest alive and keeps consuming capacity. Across a backfill
batch that piles up several abandoned calls against the very capacity that's
already exhausted. Thread an AbortSignal (AiOptions.signal, supported since
workerd early 2026) into ai.run and abort it when the timeout wins, so a
timed-out summary actually cancels. Timeout->null->excerpt fallback unchanged.
Addresses CodeRabbit review on PR #26.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230
AndresL230 merged commit d2e6287 into mainJul 7, 2026
2 checks passed
Sign up for freeto 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.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle - #26

Merged
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard
Jul 7, 2026
Merged

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle#26
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Two independent changes, bundled per request so the stranded Docs restyle rides an already-open PR to main.

1. Timeout-guard Workers AI so a hung summarize can't wedge Sync GitHub

Problem. The admin Sync GitHub button sticks forever on "Contacting GitHub — taking inventory of PRs and issues…". POST /admin/backfill calls Workers AI (@cf/google/gemma-4-26b-a4b-it, a slow 26B model) synchronously in the request the browser waits on. The await ai.run(...) in makeWorkersAiSummarizer is unbounded: when the daily Neuron budget is exhausted or the model is overloaded, the call can hang indefinitely (never resolves, never rejects). The surrounding try/catch only handles throws, so a hang wedges the whole request — observed as POST /admin/backfill never completing (>2 min) with 0 summary rows written.

Fix.

  • makeWorkersAiSummarizer races ai.run(...) against a timer (WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the samecatch, returns null, and the existing deterministic excerpt fallback fires — so the request always completes. Timeout is injectable (workersAiPrSummarizer(ai, timeoutMs?) / workersAiIssueSummarizer(ai, timeoutMs?)) for unit testing; clearTimeout in a finally leaves no pending timer on a healthy call.
  • SUMMARY_BATCH_LIMIT 20 → 5, so each /admin/backfill returns quickly and the frontend auto-loop shows progress instead of one long stall.
  • The catch's diagnostic console.error now also logs timeouts (visible in wrangler tail).

Test (TDD, failing-first). New workersAiSummarizer — timeout guard block: a fake ai whose run never resolves + a 50ms injected timeout must resolve to null / model='excerpt' within the timeout. Verified RED then GREEN.

2. Re-land the Docs reader restyle onto main

The Docs reader restyle + collapsible nav tree (originally PR #25) was accidentally merged into the already-merged feat/mywork-grid-seed-docs branch instead of main, so it never reached main. Its web-only commit (web/src/canopy.css, main.ts, markdown.ts, render.ts) is cherry-picked here. The stale backfill.ts on that branch — a pre-#23 revert — is deliberately not included.

Verification

  • npm run build:web → ok · npm run typecheck → clean (worker + web) · npx vitest run --exclude '**/.claude/**'422 passed
  • ⏳ Deployed-worker verification of the timeout path is pending (Workers AI can't run locally) — confirm on the deployed canopy worker via wrangler tail + a Sync click.

🤖 Generated with Claude Code

…'t wedge Sync
The Sync GitHub button stuck forever on "Contacting GitHub…" because
POST /admin/backfill awaits ai.run() unbounded: an exhausted Neuron budget
or overloaded 26B model can leave the call pending forever (never resolves,
never rejects), so the try/catch — which only handles throws — can't recover.
makeWorkersAiSummarizer now races ai.run against an injectable timer
(WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the same catch,
returns null, and the existing deterministic excerpt fallback fires — the
request always completes. Shrink SUMMARY_BATCH_LIMIT 20 -> 5 so each batch
returns quickly and the frontend's auto-loop shows progress instead of a stall.
Test (failing-first): a fake ai whose run never resolves + a short injected
timeout must resolve to null / model='excerpt' within the timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@AndresL230, you've reached your PR review limit, so we couldn't start this review.

Next review available in:49 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5da8b87-6b2c-410d-9c73-171dbac8cc09

📥 Commits

Reviewing files that changed from the base of the PR and between 1038be7 and b363101.

📒 Files selected for processing (6)
  • src/tools/summarize.ts
  • test/summarize.test.ts
  • web/src/canopy.css
  • web/src/main.ts
  • web/src/markdown.ts
  • web/src/render.ts
📝 Walkthrough

Walkthrough

Adds a bounded timeout (WORKERS_AI_TIMEOUT_MS) to Workers AI summarizer calls using Promise.race, falling back to null (and thus excerpt summarization) on timeout or failure. Both public summarizer wrappers gain an optional timeoutMs parameter. Backfill's SUMMARY_BATCH_LIMIT is lowered from 20 to 5. Tests added for timeout fallback behavior.

Changes

Workers AI timeout and backfill batching

Layer / File(s)Summary
Timeout constant and race-based execution guard
src/tools/summarize.ts
Adds WORKERS_AI_TIMEOUT_MS and races ai.run against a timeout, returning null on timeout/throw/malformed output, clearing the timer in finally.
Public wrapper signatures and batch limit reduction
src/tools/summarize.ts, src/tools/backfill.ts
Updates workersAiPrSummarizer/workersAiIssueSummarizer to accept optional timeoutMs; lowers SUMMARY_BATCH_LIMIT from 20 to 5 with updated comments.
Timeout fallback tests
test/summarize.test.ts
Adds tests simulating a hanging AI call, verifying summarizers return null and storage functions fall back to excerpt summaries within timeout.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
participant Caller
participant SharedSummarizer
participant AiRun
participant TimeoutTimer
Caller->>SharedSummarizer: workersAiPrSummarizer/IssueSummarizer(ai, timeoutMs)
SharedSummarizer->>AiRun: ai.run(...)
SharedSummarizer->>TimeoutTimer: start timer(timeoutMs)
alt AiRun resolves first
AiRun-->>SharedSummarizer: model output
SharedSummarizer-->>Caller: parsed summary
else Timer fires first
TimeoutTimer-->>SharedSummarizer: timeout rejection
SharedSummarizer-->>Caller: null (fallback to excerpt)
end
SharedSummarizer->>TimeoutTimer: clear timer (finally)
Loading

Possibly related PRs

  • SaplingLearn/canopy#11: Both PRs modify the workersAi*Summarizer/shared summarizer logic in src/tools/summarize.ts.
  • SaplingLearn/canopy#12: Both PRs modify the Workers AI summarizer to return null on unusable ai.run() results, with overlapping test changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title captures the main Workers-AI timeout/backfill fix, though the trailing docs restyle note appears unrelated.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/backfill-ai-timeout-guard

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

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

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
canopyb363101Commit Preview URL

Branch Preview URL
Jul 07 2026, 06:20 AM

Frontend-only design pass on the Docs page, styled entirely with the theme
CSS vars so it holds in all three themes (dark / light / midnight).
Reader (web/src/render.ts, canopy.css):
- Centered reading column (~730px measure) with a wrap-safe title (drops the
white-space:nowrap that could overflow long titles) and a mono
`SPACE / SECTION` eyebrow.
- Markdown: stronger reading ink (color-mix off --fg), real heading hierarchy
(h2 hairline rule, h3 distinct at 16px), language-tagged code panels,
callout blockquotes (accent-soft), crisp inline-code chips, accent-numbered
ordered lists, and editorial ledger-style tables (rule-only borders, mono
uppercase headers).
Nav tree (web/src/render.ts, main.ts, canopy.css):
- Sections are now collapsible: a header button (rotating chevron + mono
label + count) toggles each section; collapse state persists to
localStorage, keyed `${space}:${section}`.
- Active doc is a clean --accent-soft pill matching the sidebar's active
style; removes the inset accent line (.cnpy-selbar no longer used here —
left intact for review.ts).
markdown.ts:
- Post-sanitize DOM pass wraps code blocks in a `.cnpy-code` panel (tagged
with the fence language) and tables in a scroll wrapper. Browser-only;
render tests mock this module.
Verified across dark/light/midnight in both Sapling and Canopy spaces.
typecheck green; full suite 418/418.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230AndresL230 changed the title fix(backfill): timeout-guard Workers AI so a hung summarize can't wedge Sync GitHubfix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyleJul 7, 2026

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/tools/summarize.ts`:
- Around line 137-176: The current timeout logic in summarize() only stops
waiting because Promise.race does not cancel ai.run, so timed-out Workers AI
calls can keep consuming capacity. Update the workersAiSummarizer flow to create
an AbortController, pass its signal through the ai.run(AWORKERS_AI_MODEL, ...)
AiOptions, and abort it when the timeout promise wins; keep the existing
catch/fallback behavior and ensure the timer is still cleared in finally.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b368762-968f-4a7c-aed9-7c6168673869

📥 Commits

Reviewing files that changed from the base of the PR and between b28f5e5 and 1038be7.

📒 Files selected for processing (3)
  • src/tools/backfill.ts
  • src/tools/summarize.ts
  • test/summarize.test.ts

Comment threadsrc/tools/summarize.ts
Promise.race only stops WAITING for ai.run — the losing call keeps its
inference subrequest alive and keeps consuming capacity. Across a backfill
batch that piles up several abandoned calls against the very capacity that's
already exhausted. Thread an AbortSignal (AiOptions.signal, supported since
workerd early 2026) into ai.run and abort it when the timeout wins, so a
timed-out summary actually cancels. Timeout->null->excerpt fallback unchanged.
Addresses CodeRabbit review on PR #26.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230
AndresL230 merged commit d2e6287 into mainJul 7, 2026
2 checks passed
Sign up for freeto 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.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle - #26

Merged
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard
Jul 7, 2026
Merged

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle#26
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Two independent changes, bundled per request so the stranded Docs restyle rides an already-open PR to main.

1. Timeout-guard Workers AI so a hung summarize can't wedge Sync GitHub

Problem. The admin Sync GitHub button sticks forever on "Contacting GitHub — taking inventory of PRs and issues…". POST /admin/backfill calls Workers AI (@cf/google/gemma-4-26b-a4b-it, a slow 26B model) synchronously in the request the browser waits on. The await ai.run(...) in makeWorkersAiSummarizer is unbounded: when the daily Neuron budget is exhausted or the model is overloaded, the call can hang indefinitely (never resolves, never rejects). The surrounding try/catch only handles throws, so a hang wedges the whole request — observed as POST /admin/backfill never completing (>2 min) with 0 summary rows written.

Fix.

  • makeWorkersAiSummarizer races ai.run(...) against a timer (WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the samecatch, returns null, and the existing deterministic excerpt fallback fires — so the request always completes. Timeout is injectable (workersAiPrSummarizer(ai, timeoutMs?) / workersAiIssueSummarizer(ai, timeoutMs?)) for unit testing; clearTimeout in a finally leaves no pending timer on a healthy call.
  • SUMMARY_BATCH_LIMIT 20 → 5, so each /admin/backfill returns quickly and the frontend auto-loop shows progress instead of one long stall.
  • The catch's diagnostic console.error now also logs timeouts (visible in wrangler tail).

Test (TDD, failing-first). New workersAiSummarizer — timeout guard block: a fake ai whose run never resolves + a 50ms injected timeout must resolve to null / model='excerpt' within the timeout. Verified RED then GREEN.

2. Re-land the Docs reader restyle onto main

The Docs reader restyle + collapsible nav tree (originally PR #25) was accidentally merged into the already-merged feat/mywork-grid-seed-docs branch instead of main, so it never reached main. Its web-only commit (web/src/canopy.css, main.ts, markdown.ts, render.ts) is cherry-picked here. The stale backfill.ts on that branch — a pre-#23 revert — is deliberately not included.

Verification

  • npm run build:web → ok · npm run typecheck → clean (worker + web) · npx vitest run --exclude '**/.claude/**'422 passed
  • ⏳ Deployed-worker verification of the timeout path is pending (Workers AI can't run locally) — confirm on the deployed canopy worker via wrangler tail + a Sync click.

🤖 Generated with Claude Code

…'t wedge Sync
The Sync GitHub button stuck forever on "Contacting GitHub…" because
POST /admin/backfill awaits ai.run() unbounded: an exhausted Neuron budget
or overloaded 26B model can leave the call pending forever (never resolves,
never rejects), so the try/catch — which only handles throws — can't recover.
makeWorkersAiSummarizer now races ai.run against an injectable timer
(WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the same catch,
returns null, and the existing deterministic excerpt fallback fires — the
request always completes. Shrink SUMMARY_BATCH_LIMIT 20 -> 5 so each batch
returns quickly and the frontend's auto-loop shows progress instead of a stall.
Test (failing-first): a fake ai whose run never resolves + a short injected
timeout must resolve to null / model='excerpt' within the timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@AndresL230, you've reached your PR review limit, so we couldn't start this review.

Next review available in:49 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5da8b87-6b2c-410d-9c73-171dbac8cc09

📥 Commits

Reviewing files that changed from the base of the PR and between 1038be7 and b363101.

📒 Files selected for processing (6)
  • src/tools/summarize.ts
  • test/summarize.test.ts
  • web/src/canopy.css
  • web/src/main.ts
  • web/src/markdown.ts
  • web/src/render.ts
📝 Walkthrough

Walkthrough

Adds a bounded timeout (WORKERS_AI_TIMEOUT_MS) to Workers AI summarizer calls using Promise.race, falling back to null (and thus excerpt summarization) on timeout or failure. Both public summarizer wrappers gain an optional timeoutMs parameter. Backfill's SUMMARY_BATCH_LIMIT is lowered from 20 to 5. Tests added for timeout fallback behavior.

Changes

Workers AI timeout and backfill batching

Layer / File(s)Summary
Timeout constant and race-based execution guard
src/tools/summarize.ts
Adds WORKERS_AI_TIMEOUT_MS and races ai.run against a timeout, returning null on timeout/throw/malformed output, clearing the timer in finally.
Public wrapper signatures and batch limit reduction
src/tools/summarize.ts, src/tools/backfill.ts
Updates workersAiPrSummarizer/workersAiIssueSummarizer to accept optional timeoutMs; lowers SUMMARY_BATCH_LIMIT from 20 to 5 with updated comments.
Timeout fallback tests
test/summarize.test.ts
Adds tests simulating a hanging AI call, verifying summarizers return null and storage functions fall back to excerpt summaries within timeout.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
participant Caller
participant SharedSummarizer
participant AiRun
participant TimeoutTimer
Caller->>SharedSummarizer: workersAiPrSummarizer/IssueSummarizer(ai, timeoutMs)
SharedSummarizer->>AiRun: ai.run(...)
SharedSummarizer->>TimeoutTimer: start timer(timeoutMs)
alt AiRun resolves first
AiRun-->>SharedSummarizer: model output
SharedSummarizer-->>Caller: parsed summary
else Timer fires first
TimeoutTimer-->>SharedSummarizer: timeout rejection
SharedSummarizer-->>Caller: null (fallback to excerpt)
end
SharedSummarizer->>TimeoutTimer: clear timer (finally)
Loading

Possibly related PRs

  • SaplingLearn/canopy#11: Both PRs modify the workersAi*Summarizer/shared summarizer logic in src/tools/summarize.ts.
  • SaplingLearn/canopy#12: Both PRs modify the Workers AI summarizer to return null on unusable ai.run() results, with overlapping test changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title captures the main Workers-AI timeout/backfill fix, though the trailing docs restyle note appears unrelated.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/backfill-ai-timeout-guard

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

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

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
canopyb363101Commit Preview URL

Branch Preview URL
Jul 07 2026, 06:20 AM

Frontend-only design pass on the Docs page, styled entirely with the theme
CSS vars so it holds in all three themes (dark / light / midnight).
Reader (web/src/render.ts, canopy.css):
- Centered reading column (~730px measure) with a wrap-safe title (drops the
white-space:nowrap that could overflow long titles) and a mono
`SPACE / SECTION` eyebrow.
- Markdown: stronger reading ink (color-mix off --fg), real heading hierarchy
(h2 hairline rule, h3 distinct at 16px), language-tagged code panels,
callout blockquotes (accent-soft), crisp inline-code chips, accent-numbered
ordered lists, and editorial ledger-style tables (rule-only borders, mono
uppercase headers).
Nav tree (web/src/render.ts, main.ts, canopy.css):
- Sections are now collapsible: a header button (rotating chevron + mono
label + count) toggles each section; collapse state persists to
localStorage, keyed `${space}:${section}`.
- Active doc is a clean --accent-soft pill matching the sidebar's active
style; removes the inset accent line (.cnpy-selbar no longer used here —
left intact for review.ts).
markdown.ts:
- Post-sanitize DOM pass wraps code blocks in a `.cnpy-code` panel (tagged
with the fence language) and tables in a scroll wrapper. Browser-only;
render tests mock this module.
Verified across dark/light/midnight in both Sapling and Canopy spaces.
typecheck green; full suite 418/418.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230AndresL230 changed the title fix(backfill): timeout-guard Workers AI so a hung summarize can't wedge Sync GitHubfix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyleJul 7, 2026

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/tools/summarize.ts`:
- Around line 137-176: The current timeout logic in summarize() only stops
waiting because Promise.race does not cancel ai.run, so timed-out Workers AI
calls can keep consuming capacity. Update the workersAiSummarizer flow to create
an AbortController, pass its signal through the ai.run(AWORKERS_AI_MODEL, ...)
AiOptions, and abort it when the timeout promise wins; keep the existing
catch/fallback behavior and ensure the timer is still cleared in finally.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b368762-968f-4a7c-aed9-7c6168673869

📥 Commits

Reviewing files that changed from the base of the PR and between b28f5e5 and 1038be7.

📒 Files selected for processing (3)
  • src/tools/backfill.ts
  • src/tools/summarize.ts
  • test/summarize.test.ts

Comment threadsrc/tools/summarize.ts
Promise.race only stops WAITING for ai.run — the losing call keeps its
inference subrequest alive and keeps consuming capacity. Across a backfill
batch that piles up several abandoned calls against the very capacity that's
already exhausted. Thread an AbortSignal (AiOptions.signal, supported since
workerd early 2026) into ai.run and abort it when the timeout wins, so a
timed-out summary actually cancels. Timeout->null->excerpt fallback unchanged.
Addresses CodeRabbit review on PR #26.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230
AndresL230 merged commit d2e6287 into mainJul 7, 2026
2 checks passed
Sign up for freeto 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.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle - #26

Merged
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard
Jul 7, 2026
Merged

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle#26
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Two independent changes, bundled per request so the stranded Docs restyle rides an already-open PR to main.

1. Timeout-guard Workers AI so a hung summarize can't wedge Sync GitHub

Problem. The admin Sync GitHub button sticks forever on "Contacting GitHub — taking inventory of PRs and issues…". POST /admin/backfill calls Workers AI (@cf/google/gemma-4-26b-a4b-it, a slow 26B model) synchronously in the request the browser waits on. The await ai.run(...) in makeWorkersAiSummarizer is unbounded: when the daily Neuron budget is exhausted or the model is overloaded, the call can hang indefinitely (never resolves, never rejects). The surrounding try/catch only handles throws, so a hang wedges the whole request — observed as POST /admin/backfill never completing (>2 min) with 0 summary rows written.

Fix.

  • makeWorkersAiSummarizer races ai.run(...) against a timer (WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the samecatch, returns null, and the existing deterministic excerpt fallback fires — so the request always completes. Timeout is injectable (workersAiPrSummarizer(ai, timeoutMs?) / workersAiIssueSummarizer(ai, timeoutMs?)) for unit testing; clearTimeout in a finally leaves no pending timer on a healthy call.
  • SUMMARY_BATCH_LIMIT 20 → 5, so each /admin/backfill returns quickly and the frontend auto-loop shows progress instead of one long stall.
  • The catch's diagnostic console.error now also logs timeouts (visible in wrangler tail).

Test (TDD, failing-first). New workersAiSummarizer — timeout guard block: a fake ai whose run never resolves + a 50ms injected timeout must resolve to null / model='excerpt' within the timeout. Verified RED then GREEN.

2. Re-land the Docs reader restyle onto main

The Docs reader restyle + collapsible nav tree (originally PR #25) was accidentally merged into the already-merged feat/mywork-grid-seed-docs branch instead of main, so it never reached main. Its web-only commit (web/src/canopy.css, main.ts, markdown.ts, render.ts) is cherry-picked here. The stale backfill.ts on that branch — a pre-#23 revert — is deliberately not included.

Verification

  • npm run build:web → ok · npm run typecheck → clean (worker + web) · npx vitest run --exclude '**/.claude/**'422 passed
  • ⏳ Deployed-worker verification of the timeout path is pending (Workers AI can't run locally) — confirm on the deployed canopy worker via wrangler tail + a Sync click.

🤖 Generated with Claude Code

…'t wedge Sync
The Sync GitHub button stuck forever on "Contacting GitHub…" because
POST /admin/backfill awaits ai.run() unbounded: an exhausted Neuron budget
or overloaded 26B model can leave the call pending forever (never resolves,
never rejects), so the try/catch — which only handles throws — can't recover.
makeWorkersAiSummarizer now races ai.run against an injectable timer
(WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the same catch,
returns null, and the existing deterministic excerpt fallback fires — the
request always completes. Shrink SUMMARY_BATCH_LIMIT 20 -> 5 so each batch
returns quickly and the frontend's auto-loop shows progress instead of a stall.
Test (failing-first): a fake ai whose run never resolves + a short injected
timeout must resolve to null / model='excerpt' within the timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@AndresL230, you've reached your PR review limit, so we couldn't start this review.

Next review available in:49 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5da8b87-6b2c-410d-9c73-171dbac8cc09

📥 Commits

Reviewing files that changed from the base of the PR and between 1038be7 and b363101.

📒 Files selected for processing (6)
  • src/tools/summarize.ts
  • test/summarize.test.ts
  • web/src/canopy.css
  • web/src/main.ts
  • web/src/markdown.ts
  • web/src/render.ts
📝 Walkthrough

Walkthrough

Adds a bounded timeout (WORKERS_AI_TIMEOUT_MS) to Workers AI summarizer calls using Promise.race, falling back to null (and thus excerpt summarization) on timeout or failure. Both public summarizer wrappers gain an optional timeoutMs parameter. Backfill's SUMMARY_BATCH_LIMIT is lowered from 20 to 5. Tests added for timeout fallback behavior.

Changes

Workers AI timeout and backfill batching

Layer / File(s)Summary
Timeout constant and race-based execution guard
src/tools/summarize.ts
Adds WORKERS_AI_TIMEOUT_MS and races ai.run against a timeout, returning null on timeout/throw/malformed output, clearing the timer in finally.
Public wrapper signatures and batch limit reduction
src/tools/summarize.ts, src/tools/backfill.ts
Updates workersAiPrSummarizer/workersAiIssueSummarizer to accept optional timeoutMs; lowers SUMMARY_BATCH_LIMIT from 20 to 5 with updated comments.
Timeout fallback tests
test/summarize.test.ts
Adds tests simulating a hanging AI call, verifying summarizers return null and storage functions fall back to excerpt summaries within timeout.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
participant Caller
participant SharedSummarizer
participant AiRun
participant TimeoutTimer
Caller->>SharedSummarizer: workersAiPrSummarizer/IssueSummarizer(ai, timeoutMs)
SharedSummarizer->>AiRun: ai.run(...)
SharedSummarizer->>TimeoutTimer: start timer(timeoutMs)
alt AiRun resolves first
AiRun-->>SharedSummarizer: model output
SharedSummarizer-->>Caller: parsed summary
else Timer fires first
TimeoutTimer-->>SharedSummarizer: timeout rejection
SharedSummarizer-->>Caller: null (fallback to excerpt)
end
SharedSummarizer->>TimeoutTimer: clear timer (finally)
Loading

Possibly related PRs

  • SaplingLearn/canopy#11: Both PRs modify the workersAi*Summarizer/shared summarizer logic in src/tools/summarize.ts.
  • SaplingLearn/canopy#12: Both PRs modify the Workers AI summarizer to return null on unusable ai.run() results, with overlapping test changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title captures the main Workers-AI timeout/backfill fix, though the trailing docs restyle note appears unrelated.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/backfill-ai-timeout-guard

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

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

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
canopyb363101Commit Preview URL

Branch Preview URL
Jul 07 2026, 06:20 AM

Frontend-only design pass on the Docs page, styled entirely with the theme
CSS vars so it holds in all three themes (dark / light / midnight).
Reader (web/src/render.ts, canopy.css):
- Centered reading column (~730px measure) with a wrap-safe title (drops the
white-space:nowrap that could overflow long titles) and a mono
`SPACE / SECTION` eyebrow.
- Markdown: stronger reading ink (color-mix off --fg), real heading hierarchy
(h2 hairline rule, h3 distinct at 16px), language-tagged code panels,
callout blockquotes (accent-soft), crisp inline-code chips, accent-numbered
ordered lists, and editorial ledger-style tables (rule-only borders, mono
uppercase headers).
Nav tree (web/src/render.ts, main.ts, canopy.css):
- Sections are now collapsible: a header button (rotating chevron + mono
label + count) toggles each section; collapse state persists to
localStorage, keyed `${space}:${section}`.
- Active doc is a clean --accent-soft pill matching the sidebar's active
style; removes the inset accent line (.cnpy-selbar no longer used here —
left intact for review.ts).
markdown.ts:
- Post-sanitize DOM pass wraps code blocks in a `.cnpy-code` panel (tagged
with the fence language) and tables in a scroll wrapper. Browser-only;
render tests mock this module.
Verified across dark/light/midnight in both Sapling and Canopy spaces.
typecheck green; full suite 418/418.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230AndresL230 changed the title fix(backfill): timeout-guard Workers AI so a hung summarize can't wedge Sync GitHubfix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyleJul 7, 2026

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/tools/summarize.ts`:
- Around line 137-176: The current timeout logic in summarize() only stops
waiting because Promise.race does not cancel ai.run, so timed-out Workers AI
calls can keep consuming capacity. Update the workersAiSummarizer flow to create
an AbortController, pass its signal through the ai.run(AWORKERS_AI_MODEL, ...)
AiOptions, and abort it when the timeout promise wins; keep the existing
catch/fallback behavior and ensure the timer is still cleared in finally.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b368762-968f-4a7c-aed9-7c6168673869

📥 Commits

Reviewing files that changed from the base of the PR and between b28f5e5 and 1038be7.

📒 Files selected for processing (3)
  • src/tools/backfill.ts
  • src/tools/summarize.ts
  • test/summarize.test.ts

Comment threadsrc/tools/summarize.ts
Promise.race only stops WAITING for ai.run — the losing call keeps its
inference subrequest alive and keeps consuming capacity. Across a backfill
batch that piles up several abandoned calls against the very capacity that's
already exhausted. Thread an AbortSignal (AiOptions.signal, supported since
workerd early 2026) into ai.run and abort it when the timeout wins, so a
timed-out summary actually cancels. Timeout->null->excerpt fallback unchanged.
Addresses CodeRabbit review on PR #26.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230
AndresL230 merged commit d2e6287 into mainJul 7, 2026
2 checks passed
Sign up for freeto 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.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle - #26

Merged
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard
Jul 7, 2026
Merged

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle#26
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Two independent changes, bundled per request so the stranded Docs restyle rides an already-open PR to main.

1. Timeout-guard Workers AI so a hung summarize can't wedge Sync GitHub

Problem. The admin Sync GitHub button sticks forever on "Contacting GitHub — taking inventory of PRs and issues…". POST /admin/backfill calls Workers AI (@cf/google/gemma-4-26b-a4b-it, a slow 26B model) synchronously in the request the browser waits on. The await ai.run(...) in makeWorkersAiSummarizer is unbounded: when the daily Neuron budget is exhausted or the model is overloaded, the call can hang indefinitely (never resolves, never rejects). The surrounding try/catch only handles throws, so a hang wedges the whole request — observed as POST /admin/backfill never completing (>2 min) with 0 summary rows written.

Fix.

  • makeWorkersAiSummarizer races ai.run(...) against a timer (WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the samecatch, returns null, and the existing deterministic excerpt fallback fires — so the request always completes. Timeout is injectable (workersAiPrSummarizer(ai, timeoutMs?) / workersAiIssueSummarizer(ai, timeoutMs?)) for unit testing; clearTimeout in a finally leaves no pending timer on a healthy call.
  • SUMMARY_BATCH_LIMIT 20 → 5, so each /admin/backfill returns quickly and the frontend auto-loop shows progress instead of one long stall.
  • The catch's diagnostic console.error now also logs timeouts (visible in wrangler tail).

Test (TDD, failing-first). New workersAiSummarizer — timeout guard block: a fake ai whose run never resolves + a 50ms injected timeout must resolve to null / model='excerpt' within the timeout. Verified RED then GREEN.

2. Re-land the Docs reader restyle onto main

The Docs reader restyle + collapsible nav tree (originally PR #25) was accidentally merged into the already-merged feat/mywork-grid-seed-docs branch instead of main, so it never reached main. Its web-only commit (web/src/canopy.css, main.ts, markdown.ts, render.ts) is cherry-picked here. The stale backfill.ts on that branch — a pre-#23 revert — is deliberately not included.

Verification

  • npm run build:web → ok · npm run typecheck → clean (worker + web) · npx vitest run --exclude '**/.claude/**'422 passed
  • ⏳ Deployed-worker verification of the timeout path is pending (Workers AI can't run locally) — confirm on the deployed canopy worker via wrangler tail + a Sync click.

🤖 Generated with Claude Code

…'t wedge Sync
The Sync GitHub button stuck forever on "Contacting GitHub…" because
POST /admin/backfill awaits ai.run() unbounded: an exhausted Neuron budget
or overloaded 26B model can leave the call pending forever (never resolves,
never rejects), so the try/catch — which only handles throws — can't recover.
makeWorkersAiSummarizer now races ai.run against an injectable timer
(WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the same catch,
returns null, and the existing deterministic excerpt fallback fires — the
request always completes. Shrink SUMMARY_BATCH_LIMIT 20 -> 5 so each batch
returns quickly and the frontend's auto-loop shows progress instead of a stall.
Test (failing-first): a fake ai whose run never resolves + a short injected
timeout must resolve to null / model='excerpt' within the timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@AndresL230, you've reached your PR review limit, so we couldn't start this review.

Next review available in:49 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5da8b87-6b2c-410d-9c73-171dbac8cc09

📥 Commits

Reviewing files that changed from the base of the PR and between 1038be7 and b363101.

📒 Files selected for processing (6)
  • src/tools/summarize.ts
  • test/summarize.test.ts
  • web/src/canopy.css
  • web/src/main.ts
  • web/src/markdown.ts
  • web/src/render.ts
📝 Walkthrough

Walkthrough

Adds a bounded timeout (WORKERS_AI_TIMEOUT_MS) to Workers AI summarizer calls using Promise.race, falling back to null (and thus excerpt summarization) on timeout or failure. Both public summarizer wrappers gain an optional timeoutMs parameter. Backfill's SUMMARY_BATCH_LIMIT is lowered from 20 to 5. Tests added for timeout fallback behavior.

Changes

Workers AI timeout and backfill batching

Layer / File(s)Summary
Timeout constant and race-based execution guard
src/tools/summarize.ts
Adds WORKERS_AI_TIMEOUT_MS and races ai.run against a timeout, returning null on timeout/throw/malformed output, clearing the timer in finally.
Public wrapper signatures and batch limit reduction
src/tools/summarize.ts, src/tools/backfill.ts
Updates workersAiPrSummarizer/workersAiIssueSummarizer to accept optional timeoutMs; lowers SUMMARY_BATCH_LIMIT from 20 to 5 with updated comments.
Timeout fallback tests
test/summarize.test.ts
Adds tests simulating a hanging AI call, verifying summarizers return null and storage functions fall back to excerpt summaries within timeout.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
participant Caller
participant SharedSummarizer
participant AiRun
participant TimeoutTimer
Caller->>SharedSummarizer: workersAiPrSummarizer/IssueSummarizer(ai, timeoutMs)
SharedSummarizer->>AiRun: ai.run(...)
SharedSummarizer->>TimeoutTimer: start timer(timeoutMs)
alt AiRun resolves first
AiRun-->>SharedSummarizer: model output
SharedSummarizer-->>Caller: parsed summary
else Timer fires first
TimeoutTimer-->>SharedSummarizer: timeout rejection
SharedSummarizer-->>Caller: null (fallback to excerpt)
end
SharedSummarizer->>TimeoutTimer: clear timer (finally)
Loading

Possibly related PRs

  • SaplingLearn/canopy#11: Both PRs modify the workersAi*Summarizer/shared summarizer logic in src/tools/summarize.ts.
  • SaplingLearn/canopy#12: Both PRs modify the Workers AI summarizer to return null on unusable ai.run() results, with overlapping test changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title captures the main Workers-AI timeout/backfill fix, though the trailing docs restyle note appears unrelated.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/backfill-ai-timeout-guard

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

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

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
canopyb363101Commit Preview URL

Branch Preview URL
Jul 07 2026, 06:20 AM

Frontend-only design pass on the Docs page, styled entirely with the theme
CSS vars so it holds in all three themes (dark / light / midnight).
Reader (web/src/render.ts, canopy.css):
- Centered reading column (~730px measure) with a wrap-safe title (drops the
white-space:nowrap that could overflow long titles) and a mono
`SPACE / SECTION` eyebrow.
- Markdown: stronger reading ink (color-mix off --fg), real heading hierarchy
(h2 hairline rule, h3 distinct at 16px), language-tagged code panels,
callout blockquotes (accent-soft), crisp inline-code chips, accent-numbered
ordered lists, and editorial ledger-style tables (rule-only borders, mono
uppercase headers).
Nav tree (web/src/render.ts, main.ts, canopy.css):
- Sections are now collapsible: a header button (rotating chevron + mono
label + count) toggles each section; collapse state persists to
localStorage, keyed `${space}:${section}`.
- Active doc is a clean --accent-soft pill matching the sidebar's active
style; removes the inset accent line (.cnpy-selbar no longer used here —
left intact for review.ts).
markdown.ts:
- Post-sanitize DOM pass wraps code blocks in a `.cnpy-code` panel (tagged
with the fence language) and tables in a scroll wrapper. Browser-only;
render tests mock this module.
Verified across dark/light/midnight in both Sapling and Canopy spaces.
typecheck green; full suite 418/418.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230AndresL230 changed the title fix(backfill): timeout-guard Workers AI so a hung summarize can't wedge Sync GitHubfix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyleJul 7, 2026

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/tools/summarize.ts`:
- Around line 137-176: The current timeout logic in summarize() only stops
waiting because Promise.race does not cancel ai.run, so timed-out Workers AI
calls can keep consuming capacity. Update the workersAiSummarizer flow to create
an AbortController, pass its signal through the ai.run(AWORKERS_AI_MODEL, ...)
AiOptions, and abort it when the timeout promise wins; keep the existing
catch/fallback behavior and ensure the timer is still cleared in finally.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b368762-968f-4a7c-aed9-7c6168673869

📥 Commits

Reviewing files that changed from the base of the PR and between b28f5e5 and 1038be7.

📒 Files selected for processing (3)
  • src/tools/backfill.ts
  • src/tools/summarize.ts
  • test/summarize.test.ts

Comment threadsrc/tools/summarize.ts
Promise.race only stops WAITING for ai.run — the losing call keeps its
inference subrequest alive and keeps consuming capacity. Across a backfill
batch that piles up several abandoned calls against the very capacity that's
already exhausted. Thread an AbortSignal (AiOptions.signal, supported since
workerd early 2026) into ai.run and abort it when the timeout wins, so a
timed-out summary actually cancels. Timeout->null->excerpt fallback unchanged.
Addresses CodeRabbit review on PR #26.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230
AndresL230 merged commit d2e6287 into mainJul 7, 2026
2 checks passed
Sign up for freeto 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.

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle - #26

Merged
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard
Jul 7, 2026
Merged

fix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyle#26
AndresL230 merged 3 commits into
mainfrom
fix/backfill-ai-timeout-guard

Conversation

@AndresL230

@AndresL230AndresL230 commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Two independent changes, bundled per request so the stranded Docs restyle rides an already-open PR to main.

1. Timeout-guard Workers AI so a hung summarize can't wedge Sync GitHub

Problem. The admin Sync GitHub button sticks forever on "Contacting GitHub — taking inventory of PRs and issues…". POST /admin/backfill calls Workers AI (@cf/google/gemma-4-26b-a4b-it, a slow 26B model) synchronously in the request the browser waits on. The await ai.run(...) in makeWorkersAiSummarizer is unbounded: when the daily Neuron budget is exhausted or the model is overloaded, the call can hang indefinitely (never resolves, never rejects). The surrounding try/catch only handles throws, so a hang wedges the whole request — observed as POST /admin/backfill never completing (>2 min) with 0 summary rows written.

Fix.

  • makeWorkersAiSummarizer races ai.run(...) against a timer (WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the samecatch, returns null, and the existing deterministic excerpt fallback fires — so the request always completes. Timeout is injectable (workersAiPrSummarizer(ai, timeoutMs?) / workersAiIssueSummarizer(ai, timeoutMs?)) for unit testing; clearTimeout in a finally leaves no pending timer on a healthy call.
  • SUMMARY_BATCH_LIMIT 20 → 5, so each /admin/backfill returns quickly and the frontend auto-loop shows progress instead of one long stall.
  • The catch's diagnostic console.error now also logs timeouts (visible in wrangler tail).

Test (TDD, failing-first). New workersAiSummarizer — timeout guard block: a fake ai whose run never resolves + a 50ms injected timeout must resolve to null / model='excerpt' within the timeout. Verified RED then GREEN.

2. Re-land the Docs reader restyle onto main

The Docs reader restyle + collapsible nav tree (originally PR #25) was accidentally merged into the already-merged feat/mywork-grid-seed-docs branch instead of main, so it never reached main. Its web-only commit (web/src/canopy.css, main.ts, markdown.ts, render.ts) is cherry-picked here. The stale backfill.ts on that branch — a pre-#23 revert — is deliberately not included.

Verification

  • npm run build:web → ok · npm run typecheck → clean (worker + web) · npx vitest run --exclude '**/.claude/**'422 passed
  • ⏳ Deployed-worker verification of the timeout path is pending (Workers AI can't run locally) — confirm on the deployed canopy worker via wrangler tail + a Sync click.

🤖 Generated with Claude Code

…'t wedge Sync
The Sync GitHub button stuck forever on "Contacting GitHub…" because
POST /admin/backfill awaits ai.run() unbounded: an exhausted Neuron budget
or overloaded 26B model can leave the call pending forever (never resolves,
never rejects), so the try/catch — which only handles throws — can't recover.
makeWorkersAiSummarizer now races ai.run against an injectable timer
(WORKERS_AI_TIMEOUT_MS, default 15s). A timeout rejects into the same catch,
returns null, and the existing deterministic excerpt fallback fires — the
request always completes. Shrink SUMMARY_BATCH_LIMIT 20 -> 5 so each batch
returns quickly and the frontend's auto-loop shows progress instead of a stall.
Test (failing-first): a fake ai whose run never resolves + a short injected
timeout must resolve to null / model='excerpt' within the timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented Jul 7, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@AndresL230, you've reached your PR review limit, so we couldn't start this review.

Next review available in:49 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c5da8b87-6b2c-410d-9c73-171dbac8cc09

📥 Commits

Reviewing files that changed from the base of the PR and between 1038be7 and b363101.

📒 Files selected for processing (6)
  • src/tools/summarize.ts
  • test/summarize.test.ts
  • web/src/canopy.css
  • web/src/main.ts
  • web/src/markdown.ts
  • web/src/render.ts
📝 Walkthrough

Walkthrough

Adds a bounded timeout (WORKERS_AI_TIMEOUT_MS) to Workers AI summarizer calls using Promise.race, falling back to null (and thus excerpt summarization) on timeout or failure. Both public summarizer wrappers gain an optional timeoutMs parameter. Backfill's SUMMARY_BATCH_LIMIT is lowered from 20 to 5. Tests added for timeout fallback behavior.

Changes

Workers AI timeout and backfill batching

Layer / File(s)Summary
Timeout constant and race-based execution guard
src/tools/summarize.ts
Adds WORKERS_AI_TIMEOUT_MS and races ai.run against a timeout, returning null on timeout/throw/malformed output, clearing the timer in finally.
Public wrapper signatures and batch limit reduction
src/tools/summarize.ts, src/tools/backfill.ts
Updates workersAiPrSummarizer/workersAiIssueSummarizer to accept optional timeoutMs; lowers SUMMARY_BATCH_LIMIT from 20 to 5 with updated comments.
Timeout fallback tests
test/summarize.test.ts
Adds tests simulating a hanging AI call, verifying summarizers return null and storage functions fall back to excerpt summaries within timeout.

Estimated code review effort: 2 (Simple) | ~12 minutes

Sequence Diagram(s)

sequenceDiagram
participant Caller
participant SharedSummarizer
participant AiRun
participant TimeoutTimer
Caller->>SharedSummarizer: workersAiPrSummarizer/IssueSummarizer(ai, timeoutMs)
SharedSummarizer->>AiRun: ai.run(...)
SharedSummarizer->>TimeoutTimer: start timer(timeoutMs)
alt AiRun resolves first
AiRun-->>SharedSummarizer: model output
SharedSummarizer-->>Caller: parsed summary
else Timer fires first
TimeoutTimer-->>SharedSummarizer: timeout rejection
SharedSummarizer-->>Caller: null (fallback to excerpt)
end
SharedSummarizer->>TimeoutTimer: clear timer (finally)
Loading

Possibly related PRs

  • SaplingLearn/canopy#11: Both PRs modify the workersAi*Summarizer/shared summarizer logic in src/tools/summarize.ts.
  • SaplingLearn/canopy#12: Both PRs modify the Workers AI summarizer to return null on unusable ai.run() results, with overlapping test changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title captures the main Workers-AI timeout/backfill fix, though the trailing docs restyle note appears unrelated.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/backfill-ai-timeout-guard

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

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

@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
canopyb363101Commit Preview URL

Branch Preview URL
Jul 07 2026, 06:20 AM

Frontend-only design pass on the Docs page, styled entirely with the theme
CSS vars so it holds in all three themes (dark / light / midnight).
Reader (web/src/render.ts, canopy.css):
- Centered reading column (~730px measure) with a wrap-safe title (drops the
white-space:nowrap that could overflow long titles) and a mono
`SPACE / SECTION` eyebrow.
- Markdown: stronger reading ink (color-mix off --fg), real heading hierarchy
(h2 hairline rule, h3 distinct at 16px), language-tagged code panels,
callout blockquotes (accent-soft), crisp inline-code chips, accent-numbered
ordered lists, and editorial ledger-style tables (rule-only borders, mono
uppercase headers).
Nav tree (web/src/render.ts, main.ts, canopy.css):
- Sections are now collapsible: a header button (rotating chevron + mono
label + count) toggles each section; collapse state persists to
localStorage, keyed `${space}:${section}`.
- Active doc is a clean --accent-soft pill matching the sidebar's active
style; removes the inset accent line (.cnpy-selbar no longer used here —
left intact for review.ts).
markdown.ts:
- Post-sanitize DOM pass wraps code blocks in a `.cnpy-code` panel (tagged
with the fence language) and tables in a scroll wrapper. Browser-only;
render tests mock this module.
Verified across dark/light/midnight in both Sapling and Canopy spaces.
typecheck green; full suite 418/418.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230AndresL230 changed the title fix(backfill): timeout-guard Workers AI so a hung summarize can't wedge Sync GitHubfix(backfill): Workers-AI timeout guard for Sync + re-land Docs reader restyleJul 7, 2026

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@src/tools/summarize.ts`:
- Around line 137-176: The current timeout logic in summarize() only stops
waiting because Promise.race does not cancel ai.run, so timed-out Workers AI
calls can keep consuming capacity. Update the workersAiSummarizer flow to create
an AbortController, pass its signal through the ai.run(AWORKERS_AI_MODEL, ...)
AiOptions, and abort it when the timeout promise wins; keep the existing
catch/fallback behavior and ensure the timer is still cleared in finally.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9b368762-968f-4a7c-aed9-7c6168673869

📥 Commits

Reviewing files that changed from the base of the PR and between b28f5e5 and 1038be7.

📒 Files selected for processing (3)
  • src/tools/backfill.ts
  • src/tools/summarize.ts
  • test/summarize.test.ts

Comment threadsrc/tools/summarize.ts
Promise.race only stops WAITING for ai.run — the losing call keeps its
inference subrequest alive and keeps consuming capacity. Across a backfill
batch that piles up several abandoned calls against the very capacity that's
already exhausted. Thread an AbortSignal (AiOptions.signal, supported since
workerd early 2026) into ai.run and abort it when the timeout wins, so a
timed-out summary actually cancels. Timeout->null->excerpt fallback unchanged.
Addresses CodeRabbit review on PR #26.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AndresL230
AndresL230 merged commit d2e6287 into mainJul 7, 2026
2 checks passed
Sign up for freeto 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.

1 participant

@AndresL230