Prompt Surface Optimization

1// Prompt Surface Optimization implementation
2 
3// 1. Query variation mapping
4const topicQueryMap = {
5  topic: "password-reset",
6  primaryQuery: "How do I reset my password?",
7  variations: {
8    // Direct questions
9    direct: [
10      "How do I reset my password?",
11      "How can I change my password?",
12      "What's the password reset process?",
13      "Where do I reset my password?"
14    ],
15    
16    // Problem descriptions
17    problems: [
18      "I forgot my password",
19      "I can't remember my password",
20      "I'm locked out of my account",
21      "My password isn't working"
22    ],
23    
24    // Scenario-based
25    scenarios: [
26      "I need to get into my account but don't know the password",
27      "Someone used my email and I need to secure my account",
28      "I want to change my password for security reasons"
29    ],
30    
31    // Casual/conversational
32    casual: [
33      "Can you help me with my password",
34      "Password help please",
35      "Account access issue",
36      "Fix my login"
37    ],
38    
39    // Technical variations
40    technical: [
41      "Password recovery procedure",
42      "Account authentication reset",
43      "Credential reset process"
44    ],
45    
46    // Command-style
47    commands: [
48      "Reset my password",
49      "Change password",
50      "Recover account access",
51      "Send password reset link"
52    ],
53    
54    // Follow-up context
55    followUps: [
56      "What if I don't have access to my email?",
57      "How long does the reset link last?",
58      "Can I use my old password again?",
59      "What if I still can't get in?"
60    ]
61  }
62};
63 
64// 2. Content optimized for prompt surface
65const optimizedContent = {
66  // Primary question + answer
67  headline: "How to Reset Your Password",
68  directAnswer: "To reset your password, click 'Forgot Password' on the login page, enter your email, and follow the link sent to your inbox.",
69  
70  // Problem-based framing
71  problemFraming: `
72    If you've forgotten your password, can't remember your login credentials, 
73    or need to change your password for any reason, you can easily reset it 
74    in just a few steps.
75  `,
76  
77  // Scenario coverage
78  scenarios: [
79    {
80      situation: "I forgot my password",
81      solution: "Click 'Forgot Password' and check your email for reset instructions."
82    },
83    {
84      situation: "I'm locked out after too many attempts",
85      solution: "Wait 15 minutes for the lockout to expire, then use password reset."
86    },
87    {
88      situation: "I don't have access to my email anymore",
89      solution: "Contact support with account verification to update your email first."
90    }
91  ],
92  
93  // FAQ covering follow-up queries
94  faq: [
95    {
96      q: "How long does the password reset link last?",
97      a: "Reset links expire after 24 hours. Request a new one if expired."
98    },
99    {
100      q: "Can I use my old password again?",
101      a: "No, you must choose a new password that differs from your last 5 passwords."
102    },
103    {
104      q: "What if the reset email doesn't arrive?",
105      a: "Check spam, verify email address, or try again. Contact support if issues persist."
106    }
107  ],
108  
109  // Terminology bridging
110  glossary: {
111    "password": ["password", "login", "credentials", "account access"],
112    "reset": ["reset", "change", "recover", "restore", "fix"],
113    "forgot": ["forgot", "lost", "don't remember", "can't recall"]
114  }
115};
116 
117// 3. Structured data with variant coverage
118const faqSchema = {
119  "@context": "https://schema.org",
120  "@type": "FAQPage",
121  "mainEntity": [
122    {
123      "@type": "Question",
124      "name": "How do I reset my password?",
125      "alternativeHeadline": [
126        "How can I change my password?",
127        "I forgot my password - what do I do?",
128        "Password recovery help"
129      ],
130      "acceptedAnswer": {
131        "@type": "Answer",
132        "text": "To reset your password, click 'Forgot Password' on the login page..."
133      }
134    }
135  ]
136};
137 
138// 4. Prompt surface coverage analyzer
139function analyzePromptSurface(content: Content, queryMap: QueryMap): Analysis {
140  const coverage = {
141    directQuestions: checkCoverage(content, queryMap.variations.direct),
142    problemDescriptions: checkCoverage(content, queryMap.variations.problems),
143    scenarioQueries: checkCoverage(content, queryMap.variations.scenarios),
144    casualPhrasing: checkCoverage(content, queryMap.variations.casual),
145    technicalTerms: checkCoverage(content, queryMap.variations.technical),
146    commandStyle: checkCoverage(content, queryMap.variations.commands),
147    followUpQueries: checkCoverage(content, queryMap.variations.followUps)
148  };
149  
150  const overallSurface = Object.values(coverage).reduce((a, b) => a + b, 0) / 
151                         Object.keys(coverage).length;
152  
153  const gaps = findCoverageGaps(coverage);
154  
155  return {
156    coverage,
157    overallSurface,
158    gaps,
159    recommendations: generateRecommendations(gaps)
160  };
161}
162 
163function checkCoverage(content: Content, queries: string[]): number {
164  let matched = 0;
165  for (const query of queries) {
166    // Check semantic similarity between query and content
167    const similarity = calculateSemanticSimilarity(query, content.text);
168    if (similarity > 0.75) matched++;
169  }
170  return matched / queries.length;
171}