Method _execute_interactive

src/command_system/engine.py:222–272

Execute an interactive command (port of TS ``local-jsx``). Runs the command body against ``ctx.ui`` and maps its :class:`InteractiveOutcome` onto a ``CommandResult``, propagating the ``display`` / ``should_query`` / ``meta_messages`` fields that the LOCAL arm hardcod

(
        self,
        command: InteractiveCommand,
        args: str,
    )

            )

    async def _execute_interactive(
        self,
        command: InteractiveCommand,
        args: str,
    ) -> CommandResult:
        """Execute an interactive command (port of TS ``local-jsx``).

        Runs the command body against ``ctx.ui`` and maps its
        :class:`InteractiveOutcome` onto a ``CommandResult``, propagating the
        ``display`` / ``should_query`` / ``meta_messages`` fields that the
        LOCAL arm hardcodes away (``_execute_local`` forces ``system`` /
        ``False`` / drops meta). A surface that wired no ``ui`` gets a
        ``NullUIHost`` so the body can always assume ``ctx.ui`` exists; that
        host raises :class:`InteractiveUnavailableError` for mutating prompts,
        which we surface as a clean error result.
        """
        # Substitute the null surface when none was wired (SDK /
        # non-interactive). Done here, once, so command bodies never see a
        # ``None`` ui. Idempotent: a real surface sets ``ui`` at startup.
        if self.context.ui is None:
            self.context.ui = NullUIHost()

        try:
            outcome = await command.run(args, self.context)
        except InteractiveUnavailableError as e:
            # Expected on the null surface — a clean, typed message rather
            # than a stack trace.
            return CommandResult.error(command.name, str(e))
        except Exception as e:
            return CommandResult.error(command.name, str(e))

        if not isinstance(outcome, InteractiveOutcome):
            return CommandResult.error(
                command.name,
                f"interactive command returned {type(outcome).__name__}, "
                "expected InteractiveOutcome",
            )

        # ``display == 'skip'`` (e.g. the cancelled path) → no output.
        if outcome.display == "skip":
            return CommandResult.skip(command.name)

        return CommandResult(
            success=True,
            command_name=command.name,
            result_type="text",
            text=outcome.message or "",
            should_query=outcome.should_query,
            display=outcome.display,
            meta_messages=list(outcome.meta_messages),
        )

    def add_command_hook(
        self,