fixes

apps/api/internal/aiprompts/kinds.go

@@ -1,5 +1,7 @@
 package aiprompts
 
+import "strings"
+
 // Prompt keys stored in ai_prompt_templates.prompt_key.
 const (
 	KeyProductEnhance = "product_enhance"
@@ -45,6 +47,32 @@ type DefaultTemplate struct {
 	UserTemplate   string `json:"user_template"`
 }
 
+// CategoryEnhanceUserTemplate is the shared per-category (and built-in) enhance USER
+// message. Includes {{name}} {{description}} {{attrs}} {{category}} {{language}}.
+// Compatible with the enhance system JSON schema {"name","description"} — not a
+// competing HTML marketing document. Title/description formulas stay in
+// title_template / description_template and are appended at render time as plain
+// text instructions (see processing.AppendFormulaConstraints).
+// Used by local A1/Demo prompt repair and seed-a1 overlays.
+const CategoryEnhanceUserTemplate = `Your reply is parsed as JSON {"name":"string","description":"string"} only (system schema). Write name and description in {{language}} (do not hardcode a language).
+- name: short retail title; follow any Title formula constraints that follow; use Attrs
+- description: prefer 1-3 factual paragraphs as ONE string; limited HTML (<h2><p><ul><li>) is allowed if needed — do NOT emit a competing full HTML document, <name>/<metaDescription> blocks, or separate schema
+
+Category: {{category}}
+Name: {{name}}
+Desc: {{description}}
+Attrs: {{attrs}}`
+
+// CategoryEnhancePromptNeedsRepair reports whether a stored categories.prompt value
+// should be replaced by CategoryEnhanceUserTemplate (idempotent equality check).
+func CategoryEnhancePromptNeedsRepair(prompt string) bool {
+	p := strings.TrimSpace(prompt)
+	if p == "" {
+		return false
+	}
+	return p != strings.TrimSpace(CategoryEnhanceUserTemplate)
+}
+
 // BuiltInDefaults match the previous hardcoded system prompts, with structured user templates.
 var BuiltInDefaults = []DefaultTemplate{
 	{
@@ -56,15 +84,13 @@ Rules:
 - Reply with ONLY JSON (no markdown)
 - Schema: {"name":"string","description":"string"}
 - name: short retail title
-- description: 1-2 factual sentences
+- description: 1-2 factual sentences; never copy name as description
+- When Desc is empty or the same as Name, write 1-2 factual sentences from Category and Attrs only (do not invent specs)
 - Write name and description in {{language}}
 Example:
 {"name":"Acme Widget Pro","description":"Durable widget for everyday use. Clear specs, ready to ship."}
 {{brand_voice}}`,
-		UserTemplate: `Category: {{category}}
-Name: {{name}}
-Desc: {{description}}
-Attrs: {{attrs}}`,
+		UserTemplate: CategoryEnhanceUserTemplate,
 	},
 	{
 		Key:         KeySEOMeta,