@rankcli/agent-runtime 0.0.15 → 0.0.17

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 (203) hide show
  1. package/README.md +5 -4
  2. package/dist/index.d.mts +44 -393
  3. package/dist/index.d.ts +44 -393
  4. package/dist/index.js +22098 -26131
  5. package/dist/index.mjs +11834 -15857
  6. package/package.json +10 -4
  7. package/scripts/build-deno.ts +0 -134
  8. package/src/analyzers/core-web-vitals-analyzer.test.ts +0 -236
  9. package/src/analyzers/core-web-vitals-analyzer.ts +0 -557
  10. package/src/analyzers/geo-analyzer.test.ts +0 -310
  11. package/src/analyzers/geo-analyzer.ts +0 -814
  12. package/src/analyzers/image-optimization-analyzer.test.ts +0 -145
  13. package/src/analyzers/image-optimization-analyzer.ts +0 -348
  14. package/src/analyzers/index.ts +0 -233
  15. package/src/analyzers/internal-linking-analyzer.test.ts +0 -141
  16. package/src/analyzers/internal-linking-analyzer.ts +0 -419
  17. package/src/analyzers/mobile-seo-analyzer.test.ts +0 -140
  18. package/src/analyzers/mobile-seo-analyzer.ts +0 -455
  19. package/src/analyzers/security-headers-analyzer.test.ts +0 -115
  20. package/src/analyzers/security-headers-analyzer.ts +0 -318
  21. package/src/analyzers/structured-data-analyzer.test.ts +0 -210
  22. package/src/analyzers/structured-data-analyzer.ts +0 -590
  23. package/src/audit/ai/analyzer.ts +0 -347
  24. package/src/audit/ai/index.ts +0 -29
  25. package/src/audit/ai/prompts/content-analysis.ts +0 -271
  26. package/src/audit/ai/types.ts +0 -179
  27. package/src/audit/checks/additional-checks.ts +0 -439
  28. package/src/audit/checks/agent-experience.ts +0 -108
  29. package/src/audit/checks/ai-citation-worthiness.ts +0 -399
  30. package/src/audit/checks/ai-content-structure.ts +0 -325
  31. package/src/audit/checks/ai-readiness.ts +0 -406
  32. package/src/audit/checks/anchor-text.ts +0 -179
  33. package/src/audit/checks/answer-conciseness.ts +0 -322
  34. package/src/audit/checks/asset-minification.ts +0 -270
  35. package/src/audit/checks/bing-optimization.ts +0 -206
  36. package/src/audit/checks/brand-mention-optimization.ts +0 -349
  37. package/src/audit/checks/caching-headers.ts +0 -305
  38. package/src/audit/checks/canonical-advanced.ts +0 -150
  39. package/src/audit/checks/canonical-domain.ts +0 -196
  40. package/src/audit/checks/citation-quality.ts +0 -358
  41. package/src/audit/checks/client-rendering.ts +0 -542
  42. package/src/audit/checks/color-contrast.ts +0 -342
  43. package/src/audit/checks/content-freshness.ts +0 -170
  44. package/src/audit/checks/content-science.ts +0 -589
  45. package/src/audit/checks/conversion-elements.ts +0 -526
  46. package/src/audit/checks/crawlability.ts +0 -220
  47. package/src/audit/checks/directory-listing.ts +0 -172
  48. package/src/audit/checks/dom-analysis.ts +0 -191
  49. package/src/audit/checks/dom-size.ts +0 -246
  50. package/src/audit/checks/duplicate-content.ts +0 -194
  51. package/src/audit/checks/eeat-signals.ts +0 -990
  52. package/src/audit/checks/entity-seo.ts +0 -396
  53. package/src/audit/checks/featured-snippet.ts +0 -473
  54. package/src/audit/checks/freshness-signals.ts +0 -443
  55. package/src/audit/checks/funnel-intent.ts +0 -463
  56. package/src/audit/checks/hreflang.ts +0 -174
  57. package/src/audit/checks/html-compliance.ts +0 -302
  58. package/src/audit/checks/image-dimensions.ts +0 -167
  59. package/src/audit/checks/images.ts +0 -160
  60. package/src/audit/checks/indexnow.ts +0 -275
  61. package/src/audit/checks/interactive-tools.ts +0 -475
  62. package/src/audit/checks/internal-link-graph.ts +0 -436
  63. package/src/audit/checks/keyword-analysis.ts +0 -239
  64. package/src/audit/checks/keyword-cannibalization.ts +0 -385
  65. package/src/audit/checks/keyword-placement.ts +0 -471
  66. package/src/audit/checks/links.ts +0 -273
  67. package/src/audit/checks/llms-txt.ts +0 -224
  68. package/src/audit/checks/local-seo.ts +0 -296
  69. package/src/audit/checks/mobile.ts +0 -167
  70. package/src/audit/checks/modern-images.ts +0 -226
  71. package/src/audit/checks/navboost-signals.ts +0 -395
  72. package/src/audit/checks/on-page.ts +0 -209
  73. package/src/audit/checks/page-resources.ts +0 -285
  74. package/src/audit/checks/pagination.ts +0 -180
  75. package/src/audit/checks/performance.ts +0 -153
  76. package/src/audit/checks/platform-presence.ts +0 -580
  77. package/src/audit/checks/rag-chunk-readiness.test.ts +0 -159
  78. package/src/audit/checks/rag-chunk-readiness.ts +0 -163
  79. package/src/audit/checks/redirect-analysis.ts +0 -153
  80. package/src/audit/checks/redirect-chain.ts +0 -389
  81. package/src/audit/checks/resource-hints.ts +0 -420
  82. package/src/audit/checks/responsive-css.ts +0 -247
  83. package/src/audit/checks/responsive-images.ts +0 -396
  84. package/src/audit/checks/review-ecosystem.ts +0 -415
  85. package/src/audit/checks/robots-validation.ts +0 -373
  86. package/src/audit/checks/security-headers.ts +0 -188
  87. package/src/audit/checks/security.ts +0 -144
  88. package/src/audit/checks/serp-preview.ts +0 -251
  89. package/src/audit/checks/site-maturity.ts +0 -453
  90. package/src/audit/checks/social-meta.test.ts +0 -275
  91. package/src/audit/checks/social-meta.ts +0 -134
  92. package/src/audit/checks/soft-404.ts +0 -151
  93. package/src/audit/checks/structured-data.ts +0 -238
  94. package/src/audit/checks/tech-detection.ts +0 -496
  95. package/src/audit/checks/topical-clusters.ts +0 -435
  96. package/src/audit/checks/tracker-bloat.ts +0 -462
  97. package/src/audit/checks/tracking-verification.test.ts +0 -371
  98. package/src/audit/checks/tracking-verification.ts +0 -636
  99. package/src/audit/checks/url-safety.ts +0 -682
  100. package/src/audit/deno-entry.ts +0 -66
  101. package/src/audit/discovery/index.ts +0 -15
  102. package/src/audit/discovery/link-crawler.ts +0 -233
  103. package/src/audit/discovery/repo-routes.ts +0 -347
  104. package/src/audit/engine.ts +0 -633
  105. package/src/audit/fixes/index.ts +0 -209
  106. package/src/audit/fixes/social-meta-fixes.test.ts +0 -329
  107. package/src/audit/fixes/social-meta-fixes.ts +0 -463
  108. package/src/audit/index.ts +0 -74
  109. package/src/audit/runner.test.ts +0 -299
  110. package/src/audit/runner.ts +0 -130
  111. package/src/audit/types.ts +0 -1987
  112. package/src/content/featured-snippet.ts +0 -367
  113. package/src/content/generator.test.ts +0 -534
  114. package/src/content/generator.ts +0 -501
  115. package/src/content/headline.ts +0 -317
  116. package/src/content/index.ts +0 -62
  117. package/src/content/intent.ts +0 -258
  118. package/src/content/keyword-density.ts +0 -349
  119. package/src/content/readability.ts +0 -262
  120. package/src/executor.ts +0 -336
  121. package/src/fixer/framework-fixes.test.ts +0 -489
  122. package/src/fixer/framework-fixes.ts +0 -5287
  123. package/src/fixer/index.ts +0 -6
  124. package/src/fixer/schemas.ts +0 -971
  125. package/src/fixer.ts +0 -642
  126. package/src/frameworks/detector.test.ts +0 -248
  127. package/src/frameworks/detector.ts +0 -899
  128. package/src/frameworks/index.ts +0 -68
  129. package/src/frameworks/recipes/angular.yaml +0 -171
  130. package/src/frameworks/recipes/astro.yaml +0 -206
  131. package/src/frameworks/recipes/django.yaml +0 -180
  132. package/src/frameworks/recipes/laravel.yaml +0 -137
  133. package/src/frameworks/recipes/nextjs.yaml +0 -268
  134. package/src/frameworks/recipes/nuxt.yaml +0 -175
  135. package/src/frameworks/recipes/rails.yaml +0 -188
  136. package/src/frameworks/recipes/react.yaml +0 -202
  137. package/src/frameworks/recipes/sveltekit.yaml +0 -154
  138. package/src/frameworks/recipes/vue.yaml +0 -137
  139. package/src/frameworks/recipes/wordpress.yaml +0 -209
  140. package/src/frameworks/suggestion-engine.ts +0 -357
  141. package/src/geo/geo-content.test.ts +0 -305
  142. package/src/geo/geo-content.ts +0 -266
  143. package/src/geo/geo-history.test.ts +0 -473
  144. package/src/geo/geo-history.ts +0 -433
  145. package/src/geo/geo-tracker.test.ts +0 -359
  146. package/src/geo/geo-tracker.ts +0 -411
  147. package/src/geo/index.ts +0 -11
  148. package/src/geo/llm-citation-checker.ts +0 -188
  149. package/src/git/commit-helper.test.ts +0 -261
  150. package/src/git/commit-helper.ts +0 -329
  151. package/src/git/index.ts +0 -12
  152. package/src/git/pr-helper.test.ts +0 -284
  153. package/src/git/pr-helper.ts +0 -307
  154. package/src/index.ts +0 -76
  155. package/src/keywords/ai-keyword-engine.ts +0 -1062
  156. package/src/keywords/ai-summarizer.ts +0 -387
  157. package/src/keywords/ci-mode.ts +0 -555
  158. package/src/keywords/engine.ts +0 -359
  159. package/src/keywords/index.ts +0 -151
  160. package/src/keywords/llm-judge.ts +0 -357
  161. package/src/keywords/nlp-analysis.ts +0 -706
  162. package/src/keywords/prioritizer.ts +0 -295
  163. package/src/keywords/site-crawler.ts +0 -342
  164. package/src/keywords/sources/autocomplete.ts +0 -139
  165. package/src/keywords/sources/competitive-search.ts +0 -450
  166. package/src/keywords/sources/competitor-analysis.ts +0 -374
  167. package/src/keywords/sources/dataforseo.ts +0 -206
  168. package/src/keywords/sources/free-sources.ts +0 -294
  169. package/src/keywords/sources/gsc.ts +0 -123
  170. package/src/keywords/topic-grouping.ts +0 -327
  171. package/src/keywords/types.ts +0 -144
  172. package/src/keywords/wizard.ts +0 -457
  173. package/src/loader.ts +0 -40
  174. package/src/ranking/index.ts +0 -5
  175. package/src/ranking/serp-client.ts +0 -348
  176. package/src/ranking/tracker.ts +0 -380
  177. package/src/ranking/types.ts +0 -123
  178. package/src/reports/index.ts +0 -7
  179. package/src/reports/report-generator.test.ts +0 -293
  180. package/src/reports/report-generator.ts +0 -713
  181. package/src/scheduler/alerts.test.ts +0 -458
  182. package/src/scheduler/alerts.ts +0 -328
  183. package/src/scheduler/index.ts +0 -8
  184. package/src/scheduler/scheduled-audit.test.ts +0 -377
  185. package/src/scheduler/scheduled-audit.ts +0 -149
  186. package/src/test/integration-test.ts +0 -325
  187. package/src/tools/analyzer.ts +0 -373
  188. package/src/tools/crawl.ts +0 -293
  189. package/src/tools/files.ts +0 -301
  190. package/src/tools/h1-fixer.ts +0 -249
  191. package/src/tools/index.ts +0 -67
  192. package/src/tracking/github-action.ts +0 -326
  193. package/src/tracking/google-analytics.ts +0 -265
  194. package/src/tracking/index.ts +0 -45
  195. package/src/tracking/report-generator.ts +0 -386
  196. package/src/tracking/search-console.ts +0 -335
  197. package/src/types.ts +0 -148
  198. package/src/utils/http.ts +0 -302
  199. package/src/wasm-adapter.ts +0 -297
  200. package/src/wasm-entry.ts +0 -14
  201. package/tsconfig.json +0 -17
  202. package/tsup.wasm.config.ts +0 -26
  203. 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
- });