Skip to content

Improve UX when Taskplane is not configured in current workspace #523

@mwickens

Description

@mwickens

Summary

When using pi in a directory where Taskplane is not configured, startup is blocked with:

Error: ❌ Orchestrator startup blocked [WORKSPACE_SETUP_REQUIRED]

along with a long red error explanation.

This feels too heavy for users who do not want Taskplane enabled in every location.

Steps to reproduce

  1. Open pi in a location/workspace where Taskplane has not been set up.
  2. Start the orchestrator flow (or run a command that triggers Taskplane startup).
  3. Observe startup is blocked and a long red error message is shown.

Actual behavior

  • Hard-blocking startup in non-configured locations.
  • Verbose red error output that reads like a failure state.

Expected behavior

  • More graceful handling when Taskplane is not configured in the current workspace.
  • Prefer a non-blocking path, such as:
    • auto-fallback to normal (non-Taskplane) behavior, or
    • lightweight warning + optional "Set up Taskplane" action.
  • Keep messaging concise and calm (avoid alarm-style red wall of text unless truly fatal).

Why this matters

Many users only want Taskplane in specific projects. The current behavior makes that common workflow feel broken instead of optional.

Possible implementation ideas

  • Add a soft-fail mode for WORKSPACE_SETUP_REQUIRED.
  • Gate strict blocking behind an explicit "Taskplane required" setting.
  • Provide a one-line warning with a hint command (expandable details only on request).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions