Skip to content

docs(design): async migration plan for transfer pipeline#3725

Merged
oferchen merged 1 commit into
masterfrom
docs/async-migration-plan-1594-v2
May 5, 2026
Merged

docs(design): async migration plan for transfer pipeline#3725
oferchen merged 1 commit into
masterfrom
docs/async-migration-plan-1594-v2

Conversation

@oferchen
Copy link
Copy Markdown
Owner

@oferchen oferchen commented May 5, 2026

Summary

This supersedes #3664 (the earlier 5-phase sketch) by aligning
the migration narrative with the post-audit reality. Branch
opened as -v2 because the original docs/async-migration-plan-1594
branch was consumed by the merged PR.

Test plan

  • Doc renders cleanly under existing markdown lint.
  • grep -ni -E 'claude|internal|internal docs\.md' docs/design/async-migration-plan.md empty.
  • grep -nE '—|–' docs/design/async-migration-plan.md empty.
  • All file:LINE citations resolve in the current tree.
  • No code changes; CI lint and clippy unchanged.

Refresh the async migration roadmap to reflect the seven-crate
tokio surface ratified by the boundary re-verification audit
(#3706). Replaces the earlier 5-phase sketch with a 6-phase plan
ordered around concrete code-grounded entry points.

Phase 0 wires a CI guardrail; Phase 1 ratifies the seven crates;
Phases 2-4 promote feature-gated async paths to default for the
daemon listener, SSH transport, and receiver pipeline; Phase 5
finalises the rayon-tokio composition. Each phase carries a
build-time feature flag and a runtime kill switch, with four
exit gates per rollout: wire compatibility, performance, line
coverage, and interop.

Cites the new tokio dependency boundary audit, the daemon
thread-per-connection scalability audit, and the related design
notes for channel abstraction, the daemon accept loop, and
io_uring-rayon composition.
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 5, 2026
@oferchen oferchen merged commit f083134 into master May 5, 2026
8 checks passed
@oferchen oferchen deleted the docs/async-migration-plan-1594-v2 branch May 6, 2026 18:57
oferchen added a commit that referenced this pull request May 18, 2026
Refresh the async migration roadmap to reflect the seven-crate
tokio surface ratified by the boundary re-verification audit
(#3706). Replaces the earlier 5-phase sketch with a 6-phase plan
ordered around concrete code-grounded entry points.

Phase 0 wires a CI guardrail; Phase 1 ratifies the seven crates;
Phases 2-4 promote feature-gated async paths to default for the
daemon listener, SSH transport, and receiver pipeline; Phase 5
finalises the rayon-tokio composition. Each phase carries a
build-time feature flag and a runtime kill switch, with four
exit gates per rollout: wire compatibility, performance, line
coverage, and interop.

Cites the new tokio dependency boundary audit, the daemon
thread-per-connection scalability audit, and the related design
notes for channel abstraction, the daemon accept loop, and
io_uring-rayon composition.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant