Skip to content

docs(revamp): fix drift from this week's merges on eight kept pages (FIX-2696) - #5472

Draft
jhoffner wants to merge 2 commits into
mainfrom
docs/FIX-2696-drift
Draft

jhoffner wants to merge 2 commits into
mainfrom
docs/FIX-2696-drift

Conversation

@jhoffner

Copy link
Copy Markdown
Collaborator

Eight kept revamp pages said things this week's merges made untrue. Each fix was checked against the code on main before the edit.

  • serve() checks authentication now (FIX-2805). On Serving flows the sample binds 127.0.0.1, and the page says serve runs the same check as fsdev serve, with allowUnauthenticated: true as the override. The Railway and add-to-an-existing-app pages are corrected the same way.
  • /healthz during a cold start. On Railway and Docker, a network serve() opens its stores before it listens, so the port refuses connections until then. The 503 phase happens only with the override.
  • Schedules need no adapter (FIX-2753). The router serves the dispatch route under /api/flows. Serving flows and Background work say so; Background work no longer says a flow cannot start itself.
  • Harness runs. The harness kit now takes idleTimeoutMs, which stops a run after 20 minutes with no output. runTimeoutMs is an optional total cap, 4 hours by default, with 0 turning it off.
  • Workforce views. The roster flow also has inbox, workerMessages, workerSessions and sessionTurns, and a session-board flow declares delegates.
  • Shift Manager Inbox. It also lists asks from runs with no conversation, which are answered on the card alone.

Not in this PR:

  • The Next.js quick starts and the Vercel and Lambda recipes, which now get a 500 without a resolver. How those should teach it is the owner's call.
  • Railway's 500 health row, which also looks true only with the override. It needs a check first.

Each page's record has the "After the loop (review)" and "Re-run" lines. check-docs-page --record passes on all eight pages, and check-retired-terms and the brand lint pass too. No changeset, since these pages are contributor docs.


Generated by Claude Code

…d workforce views (FIX-2696)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011UNkLDgoASyf9UVtdTpqJw
@vercel

vercel Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
flow-state-dev-build-site Ready Ready Preview Nov 19, 2026 7:50pm UTC
flow-state-dev-docs Ready Ready Preview Nov 19, 2026 7:50pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
flow-state-dev-ui Ignored Ignored Preview Nov 19, 2026 7:50pm UTC

Request Review

@linear-code

linear-code Bot commented Nov 19, 2026

Copy link
Copy Markdown

FIX-2696

… limit (FIX-2696)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011UNkLDgoASyf9UVtdTpqJw
@gitar-bot

gitar-bot Bot commented Nov 19, 2026

Copy link
Copy Markdown

Note

Automatic reviews are paused because your team has used its included automatic processing for this billing period (headroom scales with your seat count). You can still comment "Gitar review" to run one anytime, and automatic reviews resume on their own by December 1. Add seats for more headroom.
Learn more

Code Review ✅ Approved 🟢 Low risk 1 closed / 1 findings

These edits correct contributor documentation and audit records; they change no executable behavior or operational authority, so their impact is limited.

Corrects eight revamp docs pages that drifted from this week's merges, covering serve() authentication, cold-start health checks, schedule dispatch routing, harness timeouts, workforce views and the Shift Manager Inbox. The harness figure and its description that still cited runTimeoutMs now name idleTimeoutMs instead. No open issues remain.

✅ 1 closed
✅ Quality: Harness figure still says a run is limited by runTimeoutMs (20 min)

📄 docs/contributing/docs-revamp/pages/catalog/harnesses/index.md:84 📄 docs/contributing/docs-revamp/pages/catalog/harnesses/index.md:193
This PR changes the harnesses page so idleTimeoutMs (20 minutes of silence) is the main stop and runTimeoutMs is only an optional 4-hour total cap. The OneRun figure on the same page was not updated. figures/one-run.svg line 26 still labels the run box limit: runTimeoutMs, and the figure description at index.md line 84 still says the run is "limited by runTimeoutMs". A reader sees the figure say runTimeoutMs is the run's limit, and the prose a few lines below say it is a 4-hour cap, so the two disagree. Update the SVG label and the description to name idleTimeoutMs, and re-run the page check.

Verification

Rules No rules evaluated

Functional validation Not enabled

Set up

Auto-approval Not enabled

Set up

Was this helpful? React with 👍 / 👎 | Gitar

This branch was successfully deployed

1 active deployment
Preview – flow-state-dev-docs — b190411c Deployed Nov 19, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants