Function assertAssignableVariableName

src/ai/tools/assignableVariable.ts:9–43

(name: string)

 * {{VALUE:name}} grammar.
 */
export function assertAssignableVariableName(name: string): void {
	const trimmed = name.trim();
	if (!trimmed) throw new Error("assignToVariable cannot be empty.");
	// `value` (the programmatic {{VALUE}} slot) and `title` (file-name title) are
	// formatter-reserved; assigning them would silently hijack those tokens.
	// Matched case-INSENSITIVELY because the formatter resolves {{VALUE:name}}
	// that way (resolveExistingVariableKey -> findCaseInsensitiveMatch), so a
	// `Value`/`TITLE` variant would otherwise slip the guard and still hijack the
	// built-in token - consistent with isReservedVariableKey below.
	if (new Set(["value", "title", "text", "meta"]).has(trimmed.toLowerCase())) {
		throw new Error(
			`assignToVariable "${trimmed}" is reserved (it would hijack a built-in formatter token).`,
		);
	}
	// Case-insensitive for the same reason as the reserved-name set above: the
	// formatter resolves {{VALUE:name}} case-insensitively, so `summary-Quoted`
	// would still collide with the auto-generated `${key}-quoted` companion.
	if (trimmed.toLowerCase().endsWith("-quoted")) {
		throw new Error(
			`assignToVariable "${trimmed}" cannot end with "-quoted" (collides with the quoted output variable).`,
		);
	}
	// Reserved internal namespace (shared with the URI/CLI boundaries) and the
	// pipe/comma characters the {{VALUE:name}} grammar cannot reference.
	if (isReservedVariableKey(trimmed)) {
		throw new Error(
			`assignToVariable "${trimmed}" uses the reserved "__qa." prefix for QuickAdd internal variables.`,
		);
	}
	if (/[|,]/.test(trimmed)) {
		throw new Error(
			`assignToVariable "${trimmed}" contains characters unreachable by {{VALUE:name}}.`,
		);
	}
}