@rankcli/agent-runtime 0.0.15 → 0.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (202) hide show
  1. package/dist/index.d.mts +43 -393
  2. package/dist/index.d.ts +43 -393
  3. package/dist/index.js +306 -6526
  4. package/dist/index.mjs +202 -6412
  5. package/package.json +6 -1
  6. package/scripts/build-deno.ts +0 -134
  7. package/src/analyzers/core-web-vitals-analyzer.test.ts +0 -236
  8. package/src/analyzers/core-web-vitals-analyzer.ts +0 -557
  9. package/src/analyzers/geo-analyzer.test.ts +0 -310
  10. package/src/analyzers/geo-analyzer.ts +0 -814
  11. package/src/analyzers/image-optimization-analyzer.test.ts +0 -145
  12. package/src/analyzers/image-optimization-analyzer.ts +0 -348
  13. package/src/analyzers/index.ts +0 -233
  14. package/src/analyzers/internal-linking-analyzer.test.ts +0 -141
  15. package/src/analyzers/internal-linking-analyzer.ts +0 -419
  16. package/src/analyzers/mobile-seo-analyzer.test.ts +0 -140
  17. package/src/analyzers/mobile-seo-analyzer.ts +0 -455
  18. package/src/analyzers/security-headers-analyzer.test.ts +0 -115
  19. package/src/analyzers/security-headers-analyzer.ts +0 -318
  20. package/src/analyzers/structured-data-analyzer.test.ts +0 -210
  21. package/src/analyzers/structured-data-analyzer.ts +0 -590
  22. package/src/audit/ai/analyzer.ts +0 -347
  23. package/src/audit/ai/index.ts +0 -29
  24. package/src/audit/ai/prompts/content-analysis.ts +0 -271
  25. package/src/audit/ai/types.ts +0 -179
  26. package/src/audit/checks/additional-checks.ts +0 -439
  27. package/src/audit/checks/agent-experience.ts +0 -108
  28. package/src/audit/checks/ai-citation-worthiness.ts +0 -399
  29. package/src/audit/checks/ai-content-structure.ts +0 -325
  30. package/src/audit/checks/ai-readiness.ts +0 -406
  31. package/src/audit/checks/anchor-text.ts +0 -179
  32. package/src/audit/checks/answer-conciseness.ts +0 -322
  33. package/src/audit/checks/asset-minification.ts +0 -270
  34. package/src/audit/checks/bing-optimization.ts +0 -206
  35. package/src/audit/checks/brand-mention-optimization.ts +0 -349
  36. package/src/audit/checks/caching-headers.ts +0 -305
  37. package/src/audit/checks/canonical-advanced.ts +0 -150
  38. package/src/audit/checks/canonical-domain.ts +0 -196
  39. package/src/audit/checks/citation-quality.ts +0 -358
  40. package/src/audit/checks/client-rendering.ts +0 -542
  41. package/src/audit/checks/color-contrast.ts +0 -342
  42. package/src/audit/checks/content-freshness.ts +0 -170
  43. package/src/audit/checks/content-science.ts +0 -589
  44. package/src/audit/checks/conversion-elements.ts +0 -526
  45. package/src/audit/checks/crawlability.ts +0 -220
  46. package/src/audit/checks/directory-listing.ts +0 -172
  47. package/src/audit/checks/dom-analysis.ts +0 -191
  48. package/src/audit/checks/dom-size.ts +0 -246
  49. package/src/audit/checks/duplicate-content.ts +0 -194
  50. package/src/audit/checks/eeat-signals.ts +0 -990
  51. package/src/audit/checks/entity-seo.ts +0 -396
  52. package/src/audit/checks/featured-snippet.ts +0 -473
  53. package/src/audit/checks/freshness-signals.ts +0 -443
  54. package/src/audit/checks/funnel-intent.ts +0 -463
  55. package/src/audit/checks/hreflang.ts +0 -174
  56. package/src/audit/checks/html-compliance.ts +0 -302
  57. package/src/audit/checks/image-dimensions.ts +0 -167
  58. package/src/audit/checks/images.ts +0 -160
  59. package/src/audit/checks/indexnow.ts +0 -275
  60. package/src/audit/checks/interactive-tools.ts +0 -475
  61. package/src/audit/checks/internal-link-graph.ts +0 -436
  62. package/src/audit/checks/keyword-analysis.ts +0 -239
  63. package/src/audit/checks/keyword-cannibalization.ts +0 -385
  64. package/src/audit/checks/keyword-placement.ts +0 -471
  65. package/src/audit/checks/links.ts +0 -273
  66. package/src/audit/checks/llms-txt.ts +0 -224
  67. package/src/audit/checks/local-seo.ts +0 -296
  68. package/src/audit/checks/mobile.ts +0 -167
  69. package/src/audit/checks/modern-images.ts +0 -226
  70. package/src/audit/checks/navboost-signals.ts +0 -395
  71. package/src/audit/checks/on-page.ts +0 -209
  72. package/src/audit/checks/page-resources.ts +0 -285
  73. package/src/audit/checks/pagination.ts +0 -180
  74. package/src/audit/checks/performance.ts +0 -153
  75. package/src/audit/checks/platform-presence.ts +0 -580
  76. package/src/audit/checks/rag-chunk-readiness.test.ts +0 -159
  77. package/src/audit/checks/rag-chunk-readiness.ts +0 -163
  78. package/src/audit/checks/redirect-analysis.ts +0 -153
  79. package/src/audit/checks/redirect-chain.ts +0 -389
  80. package/src/audit/checks/resource-hints.ts +0 -420
  81. package/src/audit/checks/responsive-css.ts +0 -247
  82. package/src/audit/checks/responsive-images.ts +0 -396
  83. package/src/audit/checks/review-ecosystem.ts +0 -415
  84. package/src/audit/checks/robots-validation.ts +0 -373
  85. package/src/audit/checks/security-headers.ts +0 -188
  86. package/src/audit/checks/security.ts +0 -144
  87. package/src/audit/checks/serp-preview.ts +0 -251
  88. package/src/audit/checks/site-maturity.ts +0 -453
  89. package/src/audit/checks/social-meta.test.ts +0 -275
  90. package/src/audit/checks/social-meta.ts +0 -134
  91. package/src/audit/checks/soft-404.ts +0 -151
  92. package/src/audit/checks/structured-data.ts +0 -238
  93. package/src/audit/checks/tech-detection.ts +0 -496
  94. package/src/audit/checks/topical-clusters.ts +0 -435
  95. package/src/audit/checks/tracker-bloat.ts +0 -462
  96. package/src/audit/checks/tracking-verification.test.ts +0 -371
  97. package/src/audit/checks/tracking-verification.ts +0 -636
  98. package/src/audit/checks/url-safety.ts +0 -682
  99. package/src/audit/deno-entry.ts +0 -66
  100. package/src/audit/discovery/index.ts +0 -15
  101. package/src/audit/discovery/link-crawler.ts +0 -233
  102. package/src/audit/discovery/repo-routes.ts +0 -347
  103. package/src/audit/engine.ts +0 -633
  104. package/src/audit/fixes/index.ts +0 -209
  105. package/src/audit/fixes/social-meta-fixes.test.ts +0 -329
  106. package/src/audit/fixes/social-meta-fixes.ts +0 -463
  107. package/src/audit/index.ts +0 -74
  108. package/src/audit/runner.test.ts +0 -299
  109. package/src/audit/runner.ts +0 -130
  110. package/src/audit/types.ts +0 -1987
  111. package/src/content/featured-snippet.ts +0 -367
  112. package/src/content/generator.test.ts +0 -534
  113. package/src/content/generator.ts +0 -501
  114. package/src/content/headline.ts +0 -317
  115. package/src/content/index.ts +0 -62
  116. package/src/content/intent.ts +0 -258
  117. package/src/content/keyword-density.ts +0 -349
  118. package/src/content/readability.ts +0 -262
  119. package/src/executor.ts +0 -336
  120. package/src/fixer/framework-fixes.test.ts +0 -489
  121. package/src/fixer/framework-fixes.ts +0 -5287
  122. package/src/fixer/index.ts +0 -6
  123. package/src/fixer/schemas.ts +0 -971
  124. package/src/fixer.ts +0 -642
  125. package/src/frameworks/detector.test.ts +0 -248
  126. package/src/frameworks/detector.ts +0 -899
  127. package/src/frameworks/index.ts +0 -68
  128. package/src/frameworks/recipes/angular.yaml +0 -171
  129. package/src/frameworks/recipes/astro.yaml +0 -206
  130. package/src/frameworks/recipes/django.yaml +0 -180
  131. package/src/frameworks/recipes/laravel.yaml +0 -137
  132. package/src/frameworks/recipes/nextjs.yaml +0 -268
  133. package/src/frameworks/recipes/nuxt.yaml +0 -175
  134. package/src/frameworks/recipes/rails.yaml +0 -188
  135. package/src/frameworks/recipes/react.yaml +0 -202
  136. package/src/frameworks/recipes/sveltekit.yaml +0 -154
  137. package/src/frameworks/recipes/vue.yaml +0 -137
  138. package/src/frameworks/recipes/wordpress.yaml +0 -209
  139. package/src/frameworks/suggestion-engine.ts +0 -357
  140. package/src/geo/geo-content.test.ts +0 -305
  141. package/src/geo/geo-content.ts +0 -266
  142. package/src/geo/geo-history.test.ts +0 -473
  143. package/src/geo/geo-history.ts +0 -433
  144. package/src/geo/geo-tracker.test.ts +0 -359
  145. package/src/geo/geo-tracker.ts +0 -411
  146. package/src/geo/index.ts +0 -11
  147. package/src/geo/llm-citation-checker.ts +0 -188
  148. package/src/git/commit-helper.test.ts +0 -261
  149. package/src/git/commit-helper.ts +0 -329
  150. package/src/git/index.ts +0 -12
  151. package/src/git/pr-helper.test.ts +0 -284
  152. package/src/git/pr-helper.ts +0 -307
  153. package/src/index.ts +0 -76
  154. package/src/keywords/ai-keyword-engine.ts +0 -1062
  155. package/src/keywords/ai-summarizer.ts +0 -387
  156. package/src/keywords/ci-mode.ts +0 -555
  157. package/src/keywords/engine.ts +0 -359
  158. package/src/keywords/index.ts +0 -151
  159. package/src/keywords/llm-judge.ts +0 -357
  160. package/src/keywords/nlp-analysis.ts +0 -706
  161. package/src/keywords/prioritizer.ts +0 -295
  162. package/src/keywords/site-crawler.ts +0 -342
  163. package/src/keywords/sources/autocomplete.ts +0 -139
  164. package/src/keywords/sources/competitive-search.ts +0 -450
  165. package/src/keywords/sources/competitor-analysis.ts +0 -374
  166. package/src/keywords/sources/dataforseo.ts +0 -206
  167. package/src/keywords/sources/free-sources.ts +0 -294
  168. package/src/keywords/sources/gsc.ts +0 -123
  169. package/src/keywords/topic-grouping.ts +0 -327
  170. package/src/keywords/types.ts +0 -144
  171. package/src/keywords/wizard.ts +0 -457
  172. package/src/loader.ts +0 -40
  173. package/src/ranking/index.ts +0 -5
  174. package/src/ranking/serp-client.ts +0 -348
  175. package/src/ranking/tracker.ts +0 -380
  176. package/src/ranking/types.ts +0 -123
  177. package/src/reports/index.ts +0 -7
  178. package/src/reports/report-generator.test.ts +0 -293
  179. package/src/reports/report-generator.ts +0 -713
  180. package/src/scheduler/alerts.test.ts +0 -458
  181. package/src/scheduler/alerts.ts +0 -328
  182. package/src/scheduler/index.ts +0 -8
  183. package/src/scheduler/scheduled-audit.test.ts +0 -377
  184. package/src/scheduler/scheduled-audit.ts +0 -149
  185. package/src/test/integration-test.ts +0 -325
  186. package/src/tools/analyzer.ts +0 -373
  187. package/src/tools/crawl.ts +0 -293
  188. package/src/tools/files.ts +0 -301
  189. package/src/tools/h1-fixer.ts +0 -249
  190. package/src/tools/index.ts +0 -67
  191. package/src/tracking/github-action.ts +0 -326
  192. package/src/tracking/google-analytics.ts +0 -265
  193. package/src/tracking/index.ts +0 -45
  194. package/src/tracking/report-generator.ts +0 -386
  195. package/src/tracking/search-console.ts +0 -335
  196. package/src/types.ts +0 -148
  197. package/src/utils/http.ts +0 -302
  198. package/src/wasm-adapter.ts +0 -297
  199. package/src/wasm-entry.ts +0 -14
  200. package/tsconfig.json +0 -17
  201. package/tsup.wasm.config.ts +0 -26
  202. package/vitest.config.ts +0 -15
@@ -1,534 +0,0 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import {
3
- generateBlogPost,
4
- generateChangelog,
5
- optimizeReadme,
6
- scoreContentSEO,
7
- ContentGeneratorOptions,
8
- BlogPostConfig,
9
- ChangelogConfig,
10
- ReadmeConfig,
11
- GeneratedContent,
12
- SEOScore,
13
- } from './generator.js';
14
-
15
- describe('content-generator', () => {
16
- beforeEach(() => {
17
- vi.clearAllMocks();
18
- });
19
-
20
- describe('generateBlogPost', () => {
21
- it('generates blog post with title', async () => {
22
- const mockLLM = vi.fn().mockResolvedValue({
23
- title: 'How to Use Our API: A Complete Guide',
24
- content: '# How to Use Our API\n\nThis guide covers...',
25
- metaDescription: 'Learn how to use our API with this step-by-step guide.',
26
- keywords: ['api', 'guide', 'tutorial'],
27
- });
28
-
29
- const config: BlogPostConfig = {
30
- topic: 'how to use our API',
31
- keywords: ['api', 'tutorial'],
32
- tone: 'technical',
33
- };
34
-
35
- const result = await generateBlogPost(config, { llm: mockLLM });
36
-
37
- expect(result.title).toBeDefined();
38
- expect(result.content).toBeDefined();
39
- expect(result.metaDescription).toBeDefined();
40
- });
41
-
42
- it('includes target keywords in content', async () => {
43
- const mockLLM = vi.fn().mockResolvedValue({
44
- title: 'REST API Tutorial',
45
- content: '# REST API Tutorial\n\nLearn how to build a REST API...',
46
- metaDescription: 'A complete REST API tutorial for beginners.',
47
- keywords: ['rest', 'api', 'tutorial'],
48
- });
49
-
50
- const config: BlogPostConfig = {
51
- topic: 'REST API tutorial',
52
- keywords: ['rest api', 'tutorial'],
53
- tone: 'educational',
54
- };
55
-
56
- const result = await generateBlogPost(config, { llm: mockLLM });
57
-
58
- expect(result.keywords).toContain('rest');
59
- });
60
-
61
- it('generates SEO-optimized meta description', async () => {
62
- const mockLLM = vi.fn().mockResolvedValue({
63
- title: 'Test Post',
64
- content: '# Test\n\nContent here...',
65
- metaDescription: 'A great meta description under 160 chars.',
66
- keywords: [],
67
- });
68
-
69
- const config: BlogPostConfig = {
70
- topic: 'test topic',
71
- };
72
-
73
- const result = await generateBlogPost(config, { llm: mockLLM });
74
-
75
- expect(result.metaDescription.length).toBeLessThanOrEqual(160);
76
- });
77
-
78
- it('respects word count limits', async () => {
79
- const mockLLM = vi.fn().mockResolvedValue({
80
- title: 'Short Post',
81
- content: '# Short\n\nThis is a short post with limited words.',
82
- metaDescription: 'A short post.',
83
- keywords: [],
84
- });
85
-
86
- const config: BlogPostConfig = {
87
- topic: 'short topic',
88
- wordCount: { min: 100, max: 500 },
89
- };
90
-
91
- const result = await generateBlogPost(config, { llm: mockLLM });
92
-
93
- expect(result.content).toBeDefined();
94
- });
95
-
96
- it('handles LLM errors gracefully', async () => {
97
- const mockLLM = vi.fn().mockRejectedValue(new Error('LLM unavailable'));
98
-
99
- const config: BlogPostConfig = {
100
- topic: 'test topic',
101
- };
102
-
103
- const result = await generateBlogPost(config, { llm: mockLLM });
104
-
105
- expect(result.error).toBeDefined();
106
- expect(result.content).toBe('');
107
- });
108
- });
109
-
110
- describe('generateChangelog', () => {
111
- it('generates changelog from git commits', async () => {
112
- const mockExec = vi.fn().mockResolvedValue({
113
- stdout: `feat: add user authentication
114
- fix: resolve login bug
115
- chore: update dependencies`,
116
- });
117
-
118
- const config: ChangelogConfig = {
119
- fromRef: 'v1.0.0',
120
- toRef: 'HEAD',
121
- };
122
-
123
- const result = await generateChangelog(config, { exec: mockExec });
124
-
125
- expect(result.content).toContain('feat');
126
- expect(result.sections).toBeDefined();
127
- });
128
-
129
- it('groups changes by type', async () => {
130
- const mockExec = vi.fn().mockResolvedValue({
131
- stdout: `feat: feature 1
132
- feat: feature 2
133
- fix: bug fix
134
- docs: update readme`,
135
- });
136
-
137
- const config: ChangelogConfig = {
138
- fromRef: 'v1.0.0',
139
- toRef: 'HEAD',
140
- groupByType: true,
141
- };
142
-
143
- const result = await generateChangelog(config, { exec: mockExec });
144
-
145
- expect(result.sections).toHaveProperty('features');
146
- expect(result.sections).toHaveProperty('fixes');
147
- });
148
-
149
- it('includes date range', async () => {
150
- const mockExec = vi.fn().mockResolvedValue({
151
- stdout: `feat: new feature`,
152
- });
153
-
154
- const config: ChangelogConfig = {
155
- fromRef: 'v1.0.0',
156
- toRef: 'v1.1.0',
157
- };
158
-
159
- const result = await generateChangelog(config, { exec: mockExec });
160
-
161
- expect(result.version).toBeDefined();
162
- });
163
-
164
- it('handles empty commit range', async () => {
165
- const mockExec = vi.fn().mockResolvedValue({
166
- stdout: '',
167
- });
168
-
169
- const config: ChangelogConfig = {
170
- fromRef: 'v1.0.0',
171
- toRef: 'v1.0.0',
172
- };
173
-
174
- const result = await generateChangelog(config, { exec: mockExec });
175
-
176
- expect(result.content).toBe('');
177
- expect(result.sections).toEqual({});
178
- });
179
-
180
- it('formats for SEO with keywords', async () => {
181
- const mockExec = vi.fn().mockResolvedValue({
182
- stdout: `feat: add new API endpoint`,
183
- });
184
-
185
- const config: ChangelogConfig = {
186
- fromRef: 'v1.0.0',
187
- toRef: 'HEAD',
188
- seoKeywords: ['api', 'update'],
189
- };
190
-
191
- const result = await generateChangelog(config, { exec: mockExec });
192
-
193
- expect(result.metaDescription).toBeDefined();
194
- });
195
- });
196
-
197
- describe('optimizeReadme', () => {
198
- it('adds missing sections', async () => {
199
- const mockLLM = vi.fn().mockResolvedValue({
200
- content: '# Project\n\n## Installation\n\n## Usage\n\n## License',
201
- suggestions: ['Add badges', 'Add examples'],
202
- });
203
-
204
- const config: ReadmeConfig = {
205
- currentContent: '# Project\n\nBasic readme content.',
206
- projectName: 'my-project',
207
- };
208
-
209
- const result = await optimizeReadme(config, { llm: mockLLM });
210
-
211
- expect(result.content).toContain('Installation');
212
- });
213
-
214
- it('adds SEO-friendly description', async () => {
215
- const mockLLM = vi.fn().mockResolvedValue({
216
- content: '# Project\n\nA powerful tool for developers.',
217
- suggestions: [],
218
- metaDescription: 'A powerful tool for developers.',
219
- });
220
-
221
- const config: ReadmeConfig = {
222
- currentContent: '# Project',
223
- projectName: 'my-project',
224
- keywords: ['developer tool'],
225
- };
226
-
227
- const result = await optimizeReadme(config, { llm: mockLLM });
228
-
229
- expect(result.metaDescription).toBeDefined();
230
- });
231
-
232
- it('suggests badge additions', async () => {
233
- const mockLLM = vi.fn().mockResolvedValue({
234
- content: '# Project',
235
- suggestions: ['Add npm version badge', 'Add license badge'],
236
- });
237
-
238
- const config: ReadmeConfig = {
239
- currentContent: '# Project',
240
- projectName: 'my-project',
241
- };
242
-
243
- const result = await optimizeReadme(config, { llm: mockLLM });
244
-
245
- expect(result.suggestions).toContain('Add npm version badge');
246
- });
247
-
248
- it('preserves existing content structure', async () => {
249
- const existingContent = `# My Project
250
-
251
- ## Custom Section
252
-
253
- My custom content here.`;
254
-
255
- const mockLLM = vi.fn().mockResolvedValue({
256
- content: `# My Project
257
-
258
- ## Custom Section
259
-
260
- My custom content here.
261
-
262
- ## Installation
263
-
264
- npm install my-project`,
265
- suggestions: [],
266
- });
267
-
268
- const config: ReadmeConfig = {
269
- currentContent: existingContent,
270
- projectName: 'my-project',
271
- preserveCustomSections: true,
272
- };
273
-
274
- const result = await optimizeReadme(config, { llm: mockLLM });
275
-
276
- expect(result.content).toContain('Custom Section');
277
- });
278
-
279
- it('handles empty readme', async () => {
280
- const mockLLM = vi.fn().mockResolvedValue({
281
- content: '# My Project\n\nA great project.',
282
- suggestions: ['Add all sections'],
283
- });
284
-
285
- const config: ReadmeConfig = {
286
- currentContent: '',
287
- projectName: 'my-project',
288
- };
289
-
290
- const result = await optimizeReadme(config, { llm: mockLLM });
291
-
292
- expect(result.content.length).toBeGreaterThan(0);
293
- });
294
- });
295
-
296
- describe('scoreContentSEO', () => {
297
- it('scores content based on SEO factors', () => {
298
- const content = `# Great Title
299
-
300
- This is a great article about SEO optimization.
301
-
302
- ## Introduction
303
-
304
- Learn about SEO best practices.
305
-
306
- ## Conclusion
307
-
308
- In summary, SEO is important.`;
309
-
310
- const score = scoreContentSEO(content, {
311
- targetKeywords: ['seo', 'optimization'],
312
- });
313
-
314
- expect(score.overall).toBeGreaterThan(0);
315
- expect(score.overall).toBeLessThanOrEqual(100);
316
- });
317
-
318
- it('checks for heading structure', () => {
319
- const goodContent = `# Main Title
320
-
321
- ## Section 1
322
-
323
- Content here.
324
-
325
- ## Section 2
326
-
327
- More content.`;
328
-
329
- const badContent = `Main Title
330
-
331
- No headings at all.`;
332
-
333
- const goodScore = scoreContentSEO(goodContent);
334
- const badScore = scoreContentSEO(badContent);
335
-
336
- expect(goodScore.headingScore).toBeGreaterThan(badScore.headingScore);
337
- });
338
-
339
- it('checks keyword density', () => {
340
- const contentWithKeywords = `# SEO Guide
341
-
342
- SEO is important for developers. This SEO guide covers SEO basics.`;
343
-
344
- const contentWithoutKeywords = `# Guide
345
-
346
- This guide covers various topics about web development.`;
347
-
348
- const withScore = scoreContentSEO(contentWithKeywords, {
349
- targetKeywords: ['seo'],
350
- });
351
- const withoutScore = scoreContentSEO(contentWithoutKeywords, {
352
- targetKeywords: ['seo'],
353
- });
354
-
355
- expect(withScore.keywordScore).toBeGreaterThan(withoutScore.keywordScore);
356
- });
357
-
358
- it('checks content length', () => {
359
- const shortContent = '# Title\n\nShort.';
360
- const longContent = `# Title
361
-
362
- ${'This is a paragraph of content. '.repeat(50)}`;
363
-
364
- const shortScore = scoreContentSEO(shortContent);
365
- const longScore = scoreContentSEO(longContent);
366
-
367
- expect(longScore.lengthScore).toBeGreaterThan(shortScore.lengthScore);
368
- });
369
-
370
- it('checks for internal links', () => {
371
- const contentWithLinks = `# Guide
372
-
373
- Check out [our API docs](/docs/api) and [tutorials](/tutorials).`;
374
-
375
- const contentWithoutLinks = `# Guide
376
-
377
- This is content without any links.`;
378
-
379
- const withLinksScore = scoreContentSEO(contentWithLinks);
380
- const withoutLinksScore = scoreContentSEO(contentWithoutLinks);
381
-
382
- expect(withLinksScore.linkScore).toBeGreaterThan(withoutLinksScore.linkScore);
383
- });
384
-
385
- it('checks for images with alt text', () => {
386
- const contentWithImages = `# Guide
387
-
388
- ![API diagram showing flow](./api-diagram.png)`;
389
-
390
- const contentWithoutImages = `# Guide
391
-
392
- Just text content.`;
393
-
394
- const withImagesScore = scoreContentSEO(contentWithImages);
395
- const withoutImagesScore = scoreContentSEO(contentWithoutImages);
396
-
397
- expect(withImagesScore.mediaScore).toBeGreaterThan(withoutImagesScore.mediaScore);
398
- });
399
-
400
- it('returns breakdown of score factors', () => {
401
- const content = '# Test\n\nContent here.';
402
-
403
- const score = scoreContentSEO(content);
404
-
405
- expect(score).toHaveProperty('overall');
406
- expect(score).toHaveProperty('headingScore');
407
- expect(score).toHaveProperty('keywordScore');
408
- expect(score).toHaveProperty('lengthScore');
409
- expect(score).toHaveProperty('linkScore');
410
- expect(score).toHaveProperty('mediaScore');
411
- });
412
- });
413
-
414
- describe('GEO optimization', () => {
415
- it('structures content for AI citation', async () => {
416
- const mockLLM = vi.fn().mockResolvedValue({
417
- title: 'SEO Autopilot: Best CLI Tool for Developers',
418
- content: `# SEO Autopilot: Best CLI Tool for Developers
419
-
420
- **Key Fact:** SEO Autopilot runs 200+ automated SEO checks directly from your terminal.
421
-
422
- ## Features
423
-
424
- - Command-line interface
425
- - GitHub integration
426
- - Auto-fix PRs`,
427
- metaDescription: 'SEO Autopilot is the best CLI tool for developers.',
428
- keywords: ['seo', 'cli', 'developers'],
429
- });
430
-
431
- const config: BlogPostConfig = {
432
- topic: 'SEO Autopilot CLI',
433
- geoOptimize: true,
434
- };
435
-
436
- const result = await generateBlogPost(config, { llm: mockLLM });
437
-
438
- // GEO-optimized content should have citable facts
439
- expect(result.content).toMatch(/\*\*.*\*\*/); // Bold facts
440
- });
441
-
442
- it('includes FAQ section for AI parsing', async () => {
443
- const mockLLM = vi.fn().mockResolvedValue({
444
- title: 'FAQ Post',
445
- content: `# FAQ
446
-
447
- ## What is SEO Autopilot?
448
-
449
- SEO Autopilot is a CLI-first SEO tool.
450
-
451
- ## How does it work?
452
-
453
- It runs 200+ checks on your website.`,
454
- metaDescription: 'FAQ about SEO Autopilot.',
455
- keywords: [],
456
- hasFAQ: true,
457
- });
458
-
459
- const config: BlogPostConfig = {
460
- topic: 'FAQ about SEO',
461
- includeFAQ: true,
462
- };
463
-
464
- const result = await generateBlogPost(config, { llm: mockLLM });
465
-
466
- expect(result.hasFAQ).toBe(true);
467
- });
468
- });
469
-
470
- describe('integration scenarios', () => {
471
- it('generates complete blog post with all SEO elements', async () => {
472
- const mockLLM = vi.fn().mockResolvedValue({
473
- title: 'Complete SEO Guide for Developers',
474
- content: `# Complete SEO Guide for Developers
475
-
476
- Learn everything about SEO optimization for your web applications.
477
-
478
- ## Introduction
479
-
480
- SEO is crucial for modern web development.
481
-
482
- ## Key Concepts
483
-
484
- Understanding these concepts will help you rank better.
485
-
486
- ## Conclusion
487
-
488
- Start optimizing your sites today!`,
489
- metaDescription: 'A complete guide to SEO for developers. Learn optimization techniques.',
490
- keywords: ['seo', 'developers', 'guide', 'optimization'],
491
- readingTime: '5 min',
492
- wordCount: 150,
493
- });
494
-
495
- const config: BlogPostConfig = {
496
- topic: 'SEO for developers',
497
- keywords: ['seo', 'developers'],
498
- tone: 'educational',
499
- wordCount: { min: 100, max: 500 },
500
- };
501
-
502
- const result = await generateBlogPost(config, { llm: mockLLM });
503
-
504
- expect(result.title).toBeDefined();
505
- expect(result.content).toBeDefined();
506
- expect(result.metaDescription).toBeDefined();
507
- expect(result.keywords).toBeDefined();
508
- expect(result.readingTime).toBeDefined();
509
- });
510
-
511
- it('generates release notes from conventional commits', async () => {
512
- const mockExec = vi.fn().mockResolvedValue({
513
- stdout: `feat(api): add new endpoint for user profiles
514
- fix(auth): resolve token refresh issue
515
- feat(cli): add --verbose flag
516
- fix(ui): correct button alignment
517
- docs: update API documentation
518
- chore: bump dependencies`,
519
- });
520
-
521
- const config: ChangelogConfig = {
522
- fromRef: 'v1.0.0',
523
- toRef: 'v1.1.0',
524
- groupByType: true,
525
- includeBreaking: true,
526
- };
527
-
528
- const result = await generateChangelog(config, { exec: mockExec });
529
-
530
- expect(result.sections.features).toHaveLength(2);
531
- expect(result.sections.fixes).toHaveLength(2);
532
- });
533
- });
534
- });