Method run

src/command_system/effort_command.py:186–249

(self, args: str, context: CommandContext)

    """

    async def run(self, args: str, context: CommandContext) -> InteractiveOutcome:
        raw = (args or "").strip()
        a = raw.lower()

        # 1. help (headless — TS effort.tsx:178-180).
        if a in COMMON_HELP_ARGS:
            return InteractiveOutcome(message=_USAGE, display="user")

        # 2. current/status (headless — TS :182-183).
        if a in ("current", "status"):
            return InteractiveOutcome(message=_show_current(), display="user")

        # 3. no args ⇒ picker (TS :185-186). The only path that needs a UI surface;
        #    on NullUIHost the select below raises -> engine returns a clean error.
        if not a:
            current = _current_effort()
            picked = await context.ui.select(
                "Set reasoning effort:", _effort_options(current), current=current
            )
            if picked is None:  # TS handleCancel -> onDone('Cancelled') (no options -> user).
                return InteractiveOutcome(message="Cancelled", display="user")
            from src.workflow.ultracode import set_ultracode_session

            if picked == "ultracode":
                set_ultracode_session(True)
                return InteractiveOutcome(message=_ULTRACODE_ON_MSG, display="user")
            # Any real effort choice exits ultracode mode (spec: "reset with /effort high").
            set_ultracode_session(False)
            if picked == "auto":
                set_effort(None)
                # TS effort.tsx:213 (effort=undefined).
                return InteractiveOutcome(
                    message=f"Set effort level to auto: {_AUTO_PICKER_DESC}",
                    display="user",
                )
            set_effort(picked)
            return InteractiveOutcome(
                message=f"Set effort level to {picked}: {_DESCRIPTIONS[picked]}",
                display="user",
            )

        # 4. explicit arg (headless — TS executeEffort :108-123).
        from src.workflow.ultracode import set_ultracode_session

        if a == "ultracode":
            # workflow-engine §4.1 / §4.8: only valid when workflows are enabled.
            from src.workflow.gating import is_workflows_enabled

            if not is_workflows_enabled():
                return InteractiveOutcome(message=_invalid_msg(raw), display="user")
            set_ultracode_session(True)
            return InteractiveOutcome(message=_ULTRACODE_ON_MSG, display="user")
        if a in ("auto", "unset"):
            set_effort(None)  # TS unsetEffortLevel.
            set_ultracode_session(False)
            return InteractiveOutcome(message="Effort level set to auto", display="user")
        if a in _levels():
            set_effort(a)  # TS setEffortValue (env-override / session-only branches dropped).