Function runTemplateHandler

src/cli/registerQuickAddCliHandlers.ts:527–608

(
	plugin: QuickAdd,
	params: CliData,
)

}

async function runTemplateHandler(
	plugin: QuickAdd,
	params: CliData,
): Promise<string> {
	const command = CLI_COMMANDS.runTemplate;

	// Wrapped so malformed input (e.g. invalid vars= JSON parsed by the up-front
	// name check) returns the standard {ok:false,error} envelope instead of
	// rejecting the handler — matching quickadd:run and run-template's ui path.
	try {
		const path = typeof params.path === "string" ? params.path.trim() : "";
		if (!path) {
			return serialize({
				ok: false,
				command,
				error: "Missing template path. Provide path=<vault-path>.",
			});
		}

		// Honest envelope: confirm the template file exists up front rather than
		// letting the engine swallow a missing-file error and report ok:true. Use
		// the engine's own resolver (getTemplateFile) so the CLI accepts exactly the
		// paths the engine does — leading slash stripped, ".md" appended — instead of
		// a stricter raw lookup that rejects "Templates/Daily" or "/Templates/Daily.md".
		const file = getTemplateFile(plugin.app, path);
		if (!file) {
			return serialize({
				ok: false,
				command,
				error: `No template file found at '${path}'.`,
			});
		}

		// Build from the resolved path so the note-name prompt header (basename) and
		// the content read agree with what the engine will open.
		const choice = createFolderTemplateChoice(file.path);

		// Honest envelope for the note name. The name is {{value}}; when it's provided
		// but blank, the requirement collector consumes it (so the standard guard sees
		// nothing missing) and the engine then throws "File name is empty" and swallows
		// it — reporting a false ok:true with no note created. Reject a blank name up
		// front for non-interactive runs (ui mode can still prompt). Headless runs have
		// no editor selection, so {{value}} comes solely from this variable.
		if (!isTruthy(params.ui)) {
			const variables = extractVariables(params, RESERVED_RUN_TEMPLATE_PARAMS);
			const name = variables.value;
			if (name == null || String(name).trim().length === 0) {
				return serialize({
					ok: false,
					command,
					error: "Missing required inputs for non-interactive CLI run.",
					choice: describeChoice(choice),
					missing: [
						{
							id: "value",
							label: "New note name",
							type: "text",
							source: "collected",