Support live attribute restoration mechanics

src/lib/server/ai/mechanic-authoring-prompt.ts

@@ -1,7 +1,7 @@
 import type { AiMechanicAuthoringRequest } from '$lib/ai/mechanic-authoring';
 import type { AiMechanicAttribute } from './mechanic-authoring-context';
 
-export const AI_MECHANIC_PROMPT_VERSION = 2;
+export const AI_MECHANIC_PROMPT_VERSION = 3;
 
 const mechanicsGrammar = {
 	version: 1,
@@ -39,13 +39,14 @@ const mechanicsGrammar = {
 	],
 	mutationKinds: ['none', 'add', 'set', 'consume', 'derive', 'clear', 'transfer'],
 	entitySelectors: ['agent', 'event_actor', 'event_target', 'event_field'],
-	valueReferences: ['event', 'scenario', 'combat', 'equipment', 'reducer', 'pool'],
+	valueReferences: ['event', 'scenario', 'combat', 'equipment', 'attribute', 'reducer', 'pool'],
 	numericExpressionOperators: ['add', 'subtract', 'multiply', 'divide', 'min', 'max', 'clamp'],
 	referenceShapes: [
 		{ ref: { source: 'event', path: 'values.distanceMeters' } },
 		{ ref: { source: 'scenario', key: 'input-key' } },
 		{ ref: { source: 'combat', path: 'currentHealth', timing: 'current' } },
 		{ ref: { source: 'equipment', path: 'protocolTalentUpgrades' } },
+		{ ref: { source: 'attribute', attributeId: 'replace-with-an-exact-catalog-attribute-id' } },
 		{ ref: { source: 'reducer' } },
 		{ ref: { source: 'pool', pool: 'pool-key', entity: { kind: 'agent' } } }
 	],
@@ -230,6 +231,8 @@ export function buildAiMechanicAuthoringInput(input: {
 		},
 		examplesAndRules: [
 			'Percent values use the numeric percentage shown in game, such as 3 for +3%, rather than 0.03.',
+			'Live Attribute references must use {source:"attribute",attributeId:"<exact supplied catalog ID>"}. Never use an Attribute name or invent an ID.',
+			'An Attribute whose catalog unit is % resolves to its displayed percentage number, such as 20 for 20%. Divide that reference by 100 when wording applies it as a percentage multiplier, such as 240 × 20%.',
 			'OS Protocol upgrade scaling may use equipment.protocolTalentUpgrades only when allowProtocolUpgradeScaling is true.',
 			'Assigned-ability scope may be used only when allowAssignedAbility is true.',
 			'If cadence is not stated, ask rather than assuming a one-second interval.',