Skip to content

WorkspaceBuilder: add an opt-in parallel builder #1062

Description

@tony

Summary

Add a separate opt-in builder that prioritizes faster workspace construction while keeping the classic builder as the compatibility default.

Related: #1053, #1054, #1056, #1058.

Proposed behavior

  • Implement a parallel builder selected explicitly through the builder mechanism introduced in the base work.
  • Keep the classic builder as the default for existing workspaces and dependency-sensitive configurations.
  • Allow the parallel builder to create pane/window structure and observe readiness with less serialized waiting where the builder contract allows it.
  • Document that pane commands are not guaranteed to prepare later pane split-time inputs such as start_directory, shell, window_shell, pane environment, or other split-time state.
  • Recommend classic builder behavior or earlier setup phases such as before_script / shell_command_before for configs that rely on strict side effects.
  • Keep this separate from the experimental chain-builder work while allowing the protocol to learn from Experimental: pure-chain ChainWorkspaceBuilder + --builder=chain #1054.

Acceptance criteria

  • The parallel builder is opt-in and not selected by existing workspace files.
  • Tests cover faster grouped creation behavior and the documented relaxed dependency guarantees.
  • Compatibility-sensitive ordering remains covered by classic-builder tests.
  • Documentation explains when to choose classic versus parallel behavior.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions