Method executeWithOutcome

src/choiceExecutor.ts:193–244

* Executes a Template or Capture choice and returns a structured * ChoiceOutcome (used by the URI x-callback handler). Mirrors * execute's envelope (one-page preflight + prompt-draft scope) so behaviour * is identical to the legacy void path; the only addition is surfacing the

(
		choice: ITemplateChoice | ICaptureChoice,
	)

	 * which is reported as `error` — never silently as success.
	 */
	async executeWithOutcome(
		choice: ITemplateChoice | ICaptureChoice,
	): Promise<ChoiceOutcome> {
		this.pendingAbort = null;
		this.pendingResult = null;
		this.beginExecutionContext();
		const originLeaf = getOpenFileOriginLeaf(this.app);
		const promptDraftStore = InputPromptDraftStore.getInstance();
		promptDraftStore.beginExecutionScope();
		try {
			await this.runOnePagePreflightIfEnabled(choice);

			if (choice.type === "Template") {
				await this.onChooseTemplateType(choice as ITemplateChoice, originLeaf);
			} else {
				await this.onChooseCaptureType(choice as ICaptureChoice, originLeaf);
			}

			if (this.pendingAbort) {
				promptDraftStore.rollbackExecutionScope();
				const abort = this.consumeAbortSignal();
				const isUser = abort instanceof UserCancelError;
				return {
					status: "cancelled",
					cancelKind: isUser ? "user" : "aborted",
					// Only surface the message for an involuntary abort (e.g. the
					// non-interactive prompt guards). A user dismissal keeps its stable
					// "cancelled by user" text and leaks no internals.
					reason: isUser ? undefined : abort?.message,
				};
			}

			promptDraftStore.commitExecutionScope();
			const result = this.pendingResult;
			this.pendingResult = null;
			// No success recorded and no abort => the engine swallowed a failure.
			return result ?? { status: "error" };
		} catch (error) {
			promptDraftStore.rollbackExecutionScope();
			if (error instanceof UserCancelError) {
				// Stable user-facing text; no internal message surfaced.
				return { status: "cancelled", cancelKind: "user" };
			}
			if (error instanceof MacroAbortError) {
				return { status: "cancelled", cancelKind: "aborted", reason: error.message };
			}
			reportError(error, "Error executing choice from URI");
			return { status: "error" };
		} finally {
			this.endExecutionContext();
		}
	}

	private async runOnePagePreflightIfEnabled(choice: IChoice): Promise<void> {
		// One-page preflight honoring per-choice override.