luckiest-co 1.0.0 → 1.0.3

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 (618) hide show
  1. package/.claude-plugin/marketplace.json +16 -0
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/LICENSE +24 -0
  4. package/bin/install.js +7 -5
  5. package/commands/{luckiest/finish.md → finish.md} +2 -0
  6. package/commands/go.md +53 -0
  7. package/commands/plan.md +66 -0
  8. package/package.json +16 -5
  9. package/skills/brainstorm/ATTRIBUTION.md +27 -0
  10. package/skills/brainstorm/SKILL.md +139 -0
  11. package/skills/luckiest-ab-testing/ATTRIBUTION.md +35 -0
  12. package/skills/luckiest-ab-testing/CHANGELOG.md +27 -0
  13. package/skills/luckiest-ab-testing/SKILL.md +379 -0
  14. package/skills/luckiest-ab-testing/evals/evals.json +118 -0
  15. package/skills/luckiest-ab-testing/references/sample-size-guide.md +290 -0
  16. package/skills/luckiest-ab-testing/references/test-templates.md +284 -0
  17. package/skills/luckiest-ad-creative/ATTRIBUTION.md +35 -0
  18. package/skills/luckiest-ad-creative/CHANGELOG.md +23 -0
  19. package/skills/luckiest-ad-creative/SKILL.md +393 -0
  20. package/skills/luckiest-ad-creative/evals/evals.json +90 -0
  21. package/skills/luckiest-ad-creative/references/generative-tools.md +637 -0
  22. package/skills/luckiest-ad-creative/references/platform-specs.md +213 -0
  23. package/skills/luckiest-ads/ATTRIBUTION.md +36 -0
  24. package/skills/luckiest-ads/CHANGELOG.md +24 -0
  25. package/skills/luckiest-ads/LICENSE +21 -0
  26. package/skills/luckiest-ads/SKILL.md +434 -0
  27. package/skills/luckiest-ads/evals/evals.json +90 -0
  28. package/skills/luckiest-ads/references/ad-copy-templates.md +207 -0
  29. package/skills/luckiest-ads/references/audience-targeting.md +243 -0
  30. package/skills/luckiest-ads/references/conversion-tracking.md +361 -0
  31. package/skills/luckiest-ads/references/platform-setup-checklists.md +277 -0
  32. package/skills/luckiest-advisors/ATTRIBUTION.md +16 -0
  33. package/skills/luckiest-advisors/CHANGELOG.md +99 -0
  34. package/skills/luckiest-advisors/SKILL.md +151 -0
  35. package/skills/luckiest-aeo-grader/ATTRIBUTION.md +19 -0
  36. package/skills/luckiest-aeo-grader/CHANGELOG.md +52 -0
  37. package/skills/luckiest-aeo-grader/SKILL.md +200 -0
  38. package/skills/luckiest-aeo-grader/evals/evals.json +19 -0
  39. package/skills/luckiest-aeo-grader/references/rubric.md +72 -0
  40. package/skills/luckiest-aeo-grader/scripts/scan.py +265 -0
  41. package/skills/luckiest-ai-seo/ATTRIBUTION.md +38 -0
  42. package/skills/luckiest-ai-seo/CHANGELOG.md +23 -0
  43. package/skills/luckiest-ai-seo/SKILL.md +510 -0
  44. package/skills/luckiest-ai-seo/evals/evals.json +90 -0
  45. package/skills/luckiest-ai-seo/references/content-patterns.md +285 -0
  46. package/skills/luckiest-ai-seo/references/content-types.md +71 -0
  47. package/skills/luckiest-ai-seo/references/okf.md +104 -0
  48. package/skills/luckiest-ai-seo/references/platform-ranking-factors.md +154 -0
  49. package/skills/luckiest-analytics/ATTRIBUTION.md +42 -0
  50. package/skills/luckiest-analytics/CHANGELOG.md +36 -0
  51. package/skills/luckiest-analytics/SKILL.md +380 -0
  52. package/skills/luckiest-analytics/evals/evals.json +90 -0
  53. package/skills/luckiest-analytics/references/event-library.md +260 -0
  54. package/skills/luckiest-analytics/references/ga4-implementation.md +300 -0
  55. package/skills/luckiest-analytics/references/gtm-implementation.md +390 -0
  56. package/skills/luckiest-aso/ATTRIBUTION.md +40 -0
  57. package/skills/luckiest-aso/CHANGELOG.md +33 -0
  58. package/skills/luckiest-aso/SKILL.md +327 -0
  59. package/skills/luckiest-aso/evals/evals.json +91 -0
  60. package/skills/luckiest-aso/references/apple-specs.md +107 -0
  61. package/skills/luckiest-aso/references/benchmarks.md +129 -0
  62. package/skills/luckiest-aso/references/google-play-specs.md +131 -0
  63. package/skills/luckiest-aso/references/report-template.md +213 -0
  64. package/skills/luckiest-aso/references/scoring-criteria.md +213 -0
  65. package/skills/luckiest-churn-prevention/ATTRIBUTION.md +41 -0
  66. package/skills/luckiest-churn-prevention/CHANGELOG.md +24 -0
  67. package/skills/luckiest-churn-prevention/SKILL.md +445 -0
  68. package/skills/luckiest-churn-prevention/evals/evals.json +93 -0
  69. package/skills/luckiest-churn-prevention/references/cancel-flow-patterns.md +316 -0
  70. package/skills/luckiest-churn-prevention/references/dunning-playbook.md +408 -0
  71. package/skills/luckiest-co-marketing/ATTRIBUTION.md +38 -0
  72. package/skills/luckiest-co-marketing/CHANGELOG.md +25 -0
  73. package/skills/luckiest-co-marketing/SKILL.md +331 -0
  74. package/skills/luckiest-co-marketing/evals/evals.json +84 -0
  75. package/skills/luckiest-coder/ATTRIBUTION.md +26 -0
  76. package/skills/luckiest-coder/CHANGELOG.md +30 -0
  77. package/skills/luckiest-coder/SKILL.md +77 -0
  78. package/skills/luckiest-coder/references/antigravity-tools.md +23 -0
  79. package/skills/luckiest-coder/references/codex-tools.md +39 -0
  80. package/skills/luckiest-coder/references/pi-tools.md +16 -0
  81. package/skills/luckiest-coder-brainstorming/ATTRIBUTION.md +26 -0
  82. package/skills/luckiest-coder-brainstorming/CHANGELOG.md +31 -0
  83. package/skills/luckiest-coder-brainstorming/SKILL.md +173 -0
  84. package/skills/luckiest-coder-brainstorming/scripts/frame-template.html +213 -0
  85. package/skills/luckiest-coder-brainstorming/scripts/helper.js +168 -0
  86. package/skills/luckiest-coder-brainstorming/scripts/server.cjs +721 -0
  87. package/skills/luckiest-coder-brainstorming/scripts/start-server.sh +209 -0
  88. package/skills/luckiest-coder-brainstorming/scripts/stop-server.sh +120 -0
  89. package/skills/luckiest-coder-brainstorming/spec-document-reviewer-prompt.md +49 -0
  90. package/skills/luckiest-coder-brainstorming/visual-companion.md +291 -0
  91. package/skills/luckiest-coder-consistency/ATTRIBUTION.md +30 -0
  92. package/skills/luckiest-coder-consistency/CHANGELOG.md +26 -0
  93. package/skills/luckiest-coder-consistency/SKILL.md +98 -0
  94. package/skills/luckiest-coder-constitution/ATTRIBUTION.md +28 -0
  95. package/skills/luckiest-coder-constitution/CHANGELOG.md +25 -0
  96. package/skills/luckiest-coder-constitution/SKILL.md +115 -0
  97. package/skills/luckiest-coder-debugging/ATTRIBUTION.md +26 -0
  98. package/skills/luckiest-coder-debugging/CHANGELOG.md +22 -0
  99. package/skills/luckiest-coder-debugging/CREATION-LOG.md +119 -0
  100. package/skills/luckiest-coder-debugging/SKILL.md +309 -0
  101. package/skills/luckiest-coder-debugging/condition-based-waiting-example.ts +158 -0
  102. package/skills/luckiest-coder-debugging/condition-based-waiting.md +115 -0
  103. package/skills/luckiest-coder-debugging/defense-in-depth.md +122 -0
  104. package/skills/luckiest-coder-debugging/find-polluter.sh +63 -0
  105. package/skills/luckiest-coder-debugging/root-cause-tracing.md +169 -0
  106. package/skills/luckiest-coder-debugging/test-academic.md +14 -0
  107. package/skills/luckiest-coder-debugging/test-pressure-1.md +58 -0
  108. package/skills/luckiest-coder-debugging/test-pressure-2.md +68 -0
  109. package/skills/luckiest-coder-debugging/test-pressure-3.md +69 -0
  110. package/skills/luckiest-coder-dispatching-parallel-agents/ATTRIBUTION.md +26 -0
  111. package/skills/luckiest-coder-dispatching-parallel-agents/CHANGELOG.md +23 -0
  112. package/skills/luckiest-coder-dispatching-parallel-agents/SKILL.md +198 -0
  113. package/skills/luckiest-coder-executing-plans/ATTRIBUTION.md +26 -0
  114. package/skills/luckiest-coder-executing-plans/CHANGELOG.md +22 -0
  115. package/skills/luckiest-coder-executing-plans/SKILL.md +83 -0
  116. package/skills/luckiest-coder-finishing-a-branch/ATTRIBUTION.md +26 -0
  117. package/skills/luckiest-coder-finishing-a-branch/CHANGELOG.md +22 -0
  118. package/skills/luckiest-coder-finishing-a-branch/SKILL.md +258 -0
  119. package/skills/luckiest-coder-git-worktrees/ATTRIBUTION.md +26 -0
  120. package/skills/luckiest-coder-git-worktrees/CHANGELOG.md +22 -0
  121. package/skills/luckiest-coder-git-worktrees/SKILL.md +215 -0
  122. package/skills/luckiest-coder-guard/ATTRIBUTION.md +29 -0
  123. package/skills/luckiest-coder-guard/CHANGELOG.md +48 -0
  124. package/skills/luckiest-coder-guard/LICENSE +21 -0
  125. package/skills/luckiest-coder-guard/SKILL.md +126 -0
  126. package/skills/luckiest-coder-guard/bin/check-careful.sh +65 -0
  127. package/skills/luckiest-coder-guard/bin/check-freeze.sh +48 -0
  128. package/skills/luckiest-coder-qa/ATTRIBUTION.md +28 -0
  129. package/skills/luckiest-coder-qa/CHANGELOG.md +49 -0
  130. package/skills/luckiest-coder-qa/LICENSE +21 -0
  131. package/skills/luckiest-coder-qa/SKILL.md +160 -0
  132. package/skills/luckiest-coder-qa/references/issue-taxonomy.md +85 -0
  133. package/skills/luckiest-coder-qa/references/qa-report-template.md +126 -0
  134. package/skills/luckiest-coder-receiving-code-review/ATTRIBUTION.md +26 -0
  135. package/skills/luckiest-coder-receiving-code-review/CHANGELOG.md +28 -0
  136. package/skills/luckiest-coder-receiving-code-review/SKILL.md +226 -0
  137. package/skills/luckiest-coder-requesting-code-review/ATTRIBUTION.md +26 -0
  138. package/skills/luckiest-coder-requesting-code-review/CHANGELOG.md +31 -0
  139. package/skills/luckiest-coder-requesting-code-review/SKILL.md +118 -0
  140. package/skills/luckiest-coder-requesting-code-review/code-reviewer.md +172 -0
  141. package/skills/luckiest-coder-shipping/ATTRIBUTION.md +26 -0
  142. package/skills/luckiest-coder-shipping/CHANGELOG.md +48 -0
  143. package/skills/luckiest-coder-shipping/LICENSE +21 -0
  144. package/skills/luckiest-coder-shipping/SKILL.md +148 -0
  145. package/skills/luckiest-coder-shipping/references/canary.md +44 -0
  146. package/skills/luckiest-coder-shipping/references/test-and-coverage.md +91 -0
  147. package/skills/luckiest-coder-subagent-driven-development/ATTRIBUTION.md +26 -0
  148. package/skills/luckiest-coder-subagent-driven-development/CHANGELOG.md +28 -0
  149. package/skills/luckiest-coder-subagent-driven-development/SKILL.md +439 -0
  150. package/skills/luckiest-coder-subagent-driven-development/implementer-prompt.md +139 -0
  151. package/skills/luckiest-coder-subagent-driven-development/scripts/review-package +44 -0
  152. package/skills/luckiest-coder-subagent-driven-development/scripts/sdd-workspace +22 -0
  153. package/skills/luckiest-coder-subagent-driven-development/scripts/task-brief +40 -0
  154. package/skills/luckiest-coder-subagent-driven-development/task-reviewer-prompt.md +188 -0
  155. package/skills/luckiest-coder-tdd/ATTRIBUTION.md +26 -0
  156. package/skills/luckiest-coder-tdd/CHANGELOG.md +26 -0
  157. package/skills/luckiest-coder-tdd/SKILL.md +384 -0
  158. package/skills/luckiest-coder-tdd/testing-anti-patterns.md +299 -0
  159. package/skills/luckiest-coder-verification/ATTRIBUTION.md +26 -0
  160. package/skills/luckiest-coder-verification/CHANGELOG.md +22 -0
  161. package/skills/luckiest-coder-verification/SKILL.md +152 -0
  162. package/skills/luckiest-coder-writing-plans/ATTRIBUTION.md +26 -0
  163. package/skills/luckiest-coder-writing-plans/CHANGELOG.md +22 -0
  164. package/skills/luckiest-coder-writing-plans/SKILL.md +191 -0
  165. package/skills/luckiest-coder-writing-plans/plan-document-reviewer-prompt.md +49 -0
  166. package/skills/luckiest-coder-writing-skills/ATTRIBUTION.md +26 -0
  167. package/skills/luckiest-coder-writing-skills/CHANGELOG.md +31 -0
  168. package/skills/luckiest-coder-writing-skills/SKILL.md +702 -0
  169. package/skills/luckiest-coder-writing-skills/anthropic-best-practices.md +1150 -0
  170. package/skills/luckiest-coder-writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  171. package/skills/luckiest-coder-writing-skills/graphviz-conventions.dot +172 -0
  172. package/skills/luckiest-coder-writing-skills/persuasion-principles.md +187 -0
  173. package/skills/luckiest-coder-writing-skills/render-graphs.js +168 -0
  174. package/skills/luckiest-coder-writing-skills/testing-skills-with-subagents.md +384 -0
  175. package/skills/luckiest-cold-email/ATTRIBUTION.md +36 -0
  176. package/skills/luckiest-cold-email/CHANGELOG.md +24 -0
  177. package/skills/luckiest-cold-email/SKILL.md +213 -0
  178. package/skills/luckiest-cold-email/evals/evals.json +94 -0
  179. package/skills/luckiest-cold-email/references/benchmarks.md +83 -0
  180. package/skills/luckiest-cold-email/references/follow-up-sequences.md +81 -0
  181. package/skills/luckiest-cold-email/references/frameworks.md +90 -0
  182. package/skills/luckiest-cold-email/references/personalization.md +79 -0
  183. package/skills/luckiest-cold-email/references/subject-lines.md +53 -0
  184. package/skills/luckiest-community-marketing/ATTRIBUTION.md +41 -0
  185. package/skills/luckiest-community-marketing/CHANGELOG.md +35 -0
  186. package/skills/luckiest-community-marketing/SKILL.md +200 -0
  187. package/skills/luckiest-community-marketing/evals/evals.json +89 -0
  188. package/skills/luckiest-competitor-profiling/ATTRIBUTION.md +36 -0
  189. package/skills/luckiest-competitor-profiling/CHANGELOG.md +24 -0
  190. package/skills/luckiest-competitor-profiling/SKILL.md +443 -0
  191. package/skills/luckiest-competitor-profiling/evals/evals.json +85 -0
  192. package/skills/luckiest-competitor-profiling/references/templates.md +167 -0
  193. package/skills/luckiest-competitor-profiling/references/tool-reference.md +179 -0
  194. package/skills/luckiest-competitors/ATTRIBUTION.md +36 -0
  195. package/skills/luckiest-competitors/CHANGELOG.md +25 -0
  196. package/skills/luckiest-competitors/SKILL.md +171 -0
  197. package/skills/luckiest-competitors/evals/evals.json +93 -0
  198. package/skills/luckiest-competitors/references/content-architecture.md +271 -0
  199. package/skills/luckiest-competitors/references/templates.md +223 -0
  200. package/skills/luckiest-content-strategy/ATTRIBUTION.md +39 -0
  201. package/skills/luckiest-content-strategy/CHANGELOG.md +23 -0
  202. package/skills/luckiest-content-strategy/SKILL.md +395 -0
  203. package/skills/luckiest-content-strategy/evals/evals.json +90 -0
  204. package/skills/luckiest-content-strategy/references/headless-cms.md +194 -0
  205. package/skills/luckiest-copy-editing/ATTRIBUTION.md +41 -0
  206. package/skills/luckiest-copy-editing/CHANGELOG.md +31 -0
  207. package/skills/luckiest-copy-editing/SKILL.md +491 -0
  208. package/skills/luckiest-copy-editing/evals/evals.json +89 -0
  209. package/skills/luckiest-copy-editing/references/checklist.md +66 -0
  210. package/skills/luckiest-copy-editing/references/content-refresh.md +38 -0
  211. package/skills/luckiest-copy-editing/references/plain-english-alternatives.md +394 -0
  212. package/skills/luckiest-copywriting/ATTRIBUTION.md +35 -0
  213. package/skills/luckiest-copywriting/CHANGELOG.md +23 -0
  214. package/skills/luckiest-copywriting/SKILL.md +296 -0
  215. package/skills/luckiest-copywriting/evals/evals.json +111 -0
  216. package/skills/luckiest-copywriting/references/copy-frameworks.md +344 -0
  217. package/skills/luckiest-copywriting/references/natural-transitions.md +272 -0
  218. package/skills/luckiest-cro/ATTRIBUTION.md +34 -0
  219. package/skills/luckiest-cro/CHANGELOG.md +23 -0
  220. package/skills/luckiest-cro/SKILL.md +215 -0
  221. package/skills/luckiest-cro/evals/evals.json +111 -0
  222. package/skills/luckiest-cro/references/experiments.md +248 -0
  223. package/skills/luckiest-cro/references/form.md +422 -0
  224. package/skills/luckiest-customer-research/ATTRIBUTION.md +40 -0
  225. package/skills/luckiest-customer-research/CHANGELOG.md +26 -0
  226. package/skills/luckiest-customer-research/SKILL.md +293 -0
  227. package/skills/luckiest-customer-research/evals/evals.json +162 -0
  228. package/skills/luckiest-customer-research/references/source-guides.md +401 -0
  229. package/skills/luckiest-directory-submissions/ATTRIBUTION.md +40 -0
  230. package/skills/luckiest-directory-submissions/CHANGELOG.md +33 -0
  231. package/skills/luckiest-directory-submissions/SKILL.md +419 -0
  232. package/skills/luckiest-directory-submissions/evals/evals.json +94 -0
  233. package/skills/luckiest-directory-submissions/references/directory-list.md +477 -0
  234. package/skills/luckiest-directory-submissions/references/positioning-variations.md +232 -0
  235. package/skills/luckiest-directory-submissions/references/submission-tracker-template.csv +266 -0
  236. package/skills/luckiest-emails/ATTRIBUTION.md +42 -0
  237. package/skills/luckiest-emails/CHANGELOG.md +33 -0
  238. package/skills/luckiest-emails/SKILL.md +220 -0
  239. package/skills/luckiest-emails/evals/evals.json +93 -0
  240. package/skills/luckiest-emails/references/copy-guidelines.md +120 -0
  241. package/skills/luckiest-emails/references/email-types.md +515 -0
  242. package/skills/luckiest-emails/references/sequence-templates.md +168 -0
  243. package/skills/luckiest-extract-design-system/ATTRIBUTION.md +8 -0
  244. package/skills/luckiest-extract-design-system/CHANGELOG.md +37 -0
  245. package/skills/luckiest-extract-design-system/SKILL.md +83 -0
  246. package/skills/luckiest-free-tools/ATTRIBUTION.md +43 -0
  247. package/skills/luckiest-free-tools/CHANGELOG.md +25 -0
  248. package/skills/luckiest-free-tools/SKILL.md +220 -0
  249. package/skills/luckiest-free-tools/evals/evals.json +90 -0
  250. package/skills/luckiest-free-tools/references/tool-types.md +217 -0
  251. package/skills/luckiest-image/ATTRIBUTION.md +43 -0
  252. package/skills/luckiest-image/CHANGELOG.md +23 -0
  253. package/skills/luckiest-image/SKILL.md +376 -0
  254. package/skills/luckiest-image/evals/evals.json +89 -0
  255. package/skills/luckiest-image/references/ai-image-prompting.md +229 -0
  256. package/skills/luckiest-launch/ATTRIBUTION.md +40 -0
  257. package/skills/luckiest-launch/CHANGELOG.md +43 -0
  258. package/skills/luckiest-launch/SKILL.md +385 -0
  259. package/skills/luckiest-launch/evals/evals.json +91 -0
  260. package/skills/luckiest-lead-magnets/ATTRIBUTION.md +35 -0
  261. package/skills/luckiest-lead-magnets/CHANGELOG.md +23 -0
  262. package/skills/luckiest-lead-magnets/SKILL.md +331 -0
  263. package/skills/luckiest-lead-magnets/evals/evals.json +87 -0
  264. package/skills/luckiest-lead-magnets/references/benchmarks.md +129 -0
  265. package/skills/luckiest-lead-magnets/references/format-guide.md +196 -0
  266. package/skills/luckiest-marketing-ideas/ATTRIBUTION.md +39 -0
  267. package/skills/luckiest-marketing-ideas/CHANGELOG.md +33 -0
  268. package/skills/luckiest-marketing-ideas/SKILL.md +191 -0
  269. package/skills/luckiest-marketing-ideas/evals/evals.json +90 -0
  270. package/skills/luckiest-marketing-ideas/references/ideas-by-category.md +366 -0
  271. package/skills/luckiest-marketing-plan/ATTRIBUTION.md +40 -0
  272. package/skills/luckiest-marketing-plan/CHANGELOG.md +23 -0
  273. package/skills/luckiest-marketing-plan/SKILL.md +285 -0
  274. package/skills/luckiest-marketing-plan/evals/evals.json +96 -0
  275. package/skills/luckiest-marketing-plan/references/aarrr-framework.md +180 -0
  276. package/skills/luckiest-marketing-plan/references/budget-planning.md +168 -0
  277. package/skills/luckiest-marketing-plan/references/client-types.md +373 -0
  278. package/skills/luckiest-marketing-plan/references/current-state-rubric.md +255 -0
  279. package/skills/luckiest-marketing-plan/references/example-quietude.md +972 -0
  280. package/skills/luckiest-marketing-plan/references/funding-stage-unlocks.md +230 -0
  281. package/skills/luckiest-marketing-plan/references/growth-patterns.md +148 -0
  282. package/skills/luckiest-marketing-plan/references/idea-cross-reference.md +265 -0
  283. package/skills/luckiest-marketing-plan/references/measurement-framework.md +213 -0
  284. package/skills/luckiest-marketing-plan/references/methodology.md +363 -0
  285. package/skills/luckiest-marketing-plan/references/ops-stack-mapping.md +197 -0
  286. package/skills/luckiest-marketing-plan/references/plan-template.md +494 -0
  287. package/skills/luckiest-marketing-plan/references/team-and-agency-model.md +278 -0
  288. package/skills/luckiest-marketing-psychology/ATTRIBUTION.md +31 -0
  289. package/skills/luckiest-marketing-psychology/CHANGELOG.md +32 -0
  290. package/skills/luckiest-marketing-psychology/SKILL.md +202 -0
  291. package/skills/luckiest-marketing-psychology/evals.json +88 -0
  292. package/skills/luckiest-model-router/ATTRIBUTION.md +11 -0
  293. package/skills/luckiest-model-router/CHANGELOG.md +45 -0
  294. package/skills/luckiest-model-router/SKILL.md +74 -0
  295. package/skills/luckiest-model-router/scripts/route.py +145 -0
  296. package/skills/luckiest-offers/ATTRIBUTION.md +39 -0
  297. package/skills/luckiest-offers/CHANGELOG.md +23 -0
  298. package/skills/luckiest-offers/SKILL.md +167 -0
  299. package/skills/luckiest-offers/references/bonus-stacking.md +150 -0
  300. package/skills/luckiest-offers/references/examples.md +215 -0
  301. package/skills/luckiest-offers/references/guarantee-design.md +172 -0
  302. package/skills/luckiest-offers/references/offer-anatomy.md +203 -0
  303. package/skills/luckiest-offers/references/offer-formats.md +240 -0
  304. package/skills/luckiest-offers/references/scarcity-urgency.md +175 -0
  305. package/skills/luckiest-offers/references/value-equation.md +134 -0
  306. package/skills/luckiest-onboarding/ATTRIBUTION.md +43 -0
  307. package/skills/luckiest-onboarding/CHANGELOG.md +31 -0
  308. package/skills/luckiest-onboarding/SKILL.md +243 -0
  309. package/skills/luckiest-onboarding/references/experiments.md +258 -0
  310. package/skills/luckiest-paywalls/ATTRIBUTION.md +39 -0
  311. package/skills/luckiest-paywalls/CHANGELOG.md +25 -0
  312. package/skills/luckiest-paywalls/SKILL.md +256 -0
  313. package/skills/luckiest-paywalls/evals/evals.json +93 -0
  314. package/skills/luckiest-paywalls/references/experiments.md +164 -0
  315. package/skills/luckiest-popups/ATTRIBUTION.md +35 -0
  316. package/skills/luckiest-popups/CHANGELOG.md +27 -0
  317. package/skills/luckiest-popups/SKILL.md +477 -0
  318. package/skills/luckiest-popups/evals/evals.json +107 -0
  319. package/skills/luckiest-pricing/ATTRIBUTION.md +35 -0
  320. package/skills/luckiest-pricing/CHANGELOG.md +31 -0
  321. package/skills/luckiest-pricing/SKILL.md +283 -0
  322. package/skills/luckiest-pricing/evals/evals.json +90 -0
  323. package/skills/luckiest-pricing/references/research-methods.md +152 -0
  324. package/skills/luckiest-pricing/references/tier-structure.md +232 -0
  325. package/skills/luckiest-product-marketing/ATTRIBUTION.md +38 -0
  326. package/skills/luckiest-product-marketing/CHANGELOG.md +23 -0
  327. package/skills/luckiest-product-marketing/SKILL.md +256 -0
  328. package/skills/luckiest-product-marketing/evals/evals.json +85 -0
  329. package/skills/luckiest-programmatic-seo/ATTRIBUTION.md +35 -0
  330. package/skills/luckiest-programmatic-seo/CHANGELOG.md +24 -0
  331. package/skills/luckiest-programmatic-seo/SKILL.md +286 -0
  332. package/skills/luckiest-programmatic-seo/evals/evals.json +95 -0
  333. package/skills/luckiest-programmatic-seo/references/playbooks.md +308 -0
  334. package/skills/luckiest-prompt-rewrite/ATTRIBUTION.md +39 -0
  335. package/skills/luckiest-prompt-rewrite/CHANGELOG.md +70 -0
  336. package/skills/luckiest-prompt-rewrite/LICENSE +21 -0
  337. package/skills/luckiest-prompt-rewrite/SKILL.md +494 -0
  338. package/skills/luckiest-prompt-rewrite/references/patterns.md +82 -0
  339. package/skills/luckiest-prompt-rewrite/references/templates.md +454 -0
  340. package/skills/luckiest-prospecting/ATTRIBUTION.md +29 -0
  341. package/skills/luckiest-prospecting/CHANGELOG.md +24 -0
  342. package/skills/luckiest-prospecting/SKILL.md +275 -0
  343. package/skills/luckiest-prospecting/evals/evals.json +107 -0
  344. package/skills/luckiest-prospecting/references/b2b-prospecting.md +106 -0
  345. package/skills/luckiest-prospecting/references/compliance.md +123 -0
  346. package/skills/luckiest-prospecting/references/data-sources.md +287 -0
  347. package/skills/luckiest-prospecting/references/local-prospecting.md +165 -0
  348. package/skills/luckiest-prospecting/references/saas-prospecting.md +123 -0
  349. package/skills/luckiest-public-relations/ATTRIBUTION.md +34 -0
  350. package/skills/luckiest-public-relations/CHANGELOG.md +23 -0
  351. package/skills/luckiest-public-relations/SKILL.md +154 -0
  352. package/skills/luckiest-public-relations/references/journalist-pitching.md +368 -0
  353. package/skills/luckiest-public-relations/references/media-outlets.md +207 -0
  354. package/skills/luckiest-public-relations/references/newsjacking.md +218 -0
  355. package/skills/luckiest-public-relations/references/press-platforms.md +188 -0
  356. package/skills/luckiest-referrals/ATTRIBUTION.md +41 -0
  357. package/skills/luckiest-referrals/CHANGELOG.md +23 -0
  358. package/skills/luckiest-referrals/SKILL.md +292 -0
  359. package/skills/luckiest-referrals/evals/evals.json +90 -0
  360. package/skills/luckiest-referrals/references/affiliate-programs.md +167 -0
  361. package/skills/luckiest-referrals/references/program-examples.md +143 -0
  362. package/skills/luckiest-revops/ATTRIBUTION.md +40 -0
  363. package/skills/luckiest-revops/CHANGELOG.md +24 -0
  364. package/skills/luckiest-revops/SKILL.md +362 -0
  365. package/skills/luckiest-revops/evals/evals.json +91 -0
  366. package/skills/luckiest-revops/references/automation-playbooks.md +290 -0
  367. package/skills/luckiest-revops/references/lifecycle-definitions.md +278 -0
  368. package/skills/luckiest-revops/references/routing-rules.md +203 -0
  369. package/skills/luckiest-revops/references/scoring-models.md +247 -0
  370. package/skills/luckiest-sales-enablement/ATTRIBUTION.md +39 -0
  371. package/skills/luckiest-sales-enablement/CHANGELOG.md +23 -0
  372. package/skills/luckiest-sales-enablement/SKILL.md +379 -0
  373. package/skills/luckiest-sales-enablement/evals/evals.json +91 -0
  374. package/skills/luckiest-sales-enablement/references/deck-frameworks.md +263 -0
  375. package/skills/luckiest-sales-enablement/references/demo-scripts.md +355 -0
  376. package/skills/luckiest-sales-enablement/references/objection-library.md +270 -0
  377. package/skills/luckiest-sales-enablement/references/one-pager-templates.md +208 -0
  378. package/skills/luckiest-schema/ATTRIBUTION.md +39 -0
  379. package/skills/luckiest-schema/CHANGELOG.md +25 -0
  380. package/skills/luckiest-schema/SKILL.md +209 -0
  381. package/skills/luckiest-schema/evals/evals.json +88 -0
  382. package/skills/luckiest-schema/references/schema-examples.md +398 -0
  383. package/skills/luckiest-seo-audit/ATTRIBUTION.md +39 -0
  384. package/skills/luckiest-seo-audit/CHANGELOG.md +23 -0
  385. package/skills/luckiest-seo-audit/SKILL.md +529 -0
  386. package/skills/luckiest-seo-audit/evals/evals.json +136 -0
  387. package/skills/luckiest-seo-audit/references/ai-writing-detection.md +200 -0
  388. package/skills/luckiest-seo-audit/references/international-seo.md +230 -0
  389. package/skills/luckiest-session-handoff/ATTRIBUTION.md +14 -0
  390. package/skills/luckiest-session-handoff/CHANGELOG.md +30 -0
  391. package/skills/luckiest-session-handoff/SKILL.md +96 -0
  392. package/skills/luckiest-signup/ATTRIBUTION.md +48 -0
  393. package/skills/luckiest-signup/CHANGELOG.md +24 -0
  394. package/skills/luckiest-signup/SKILL.md +382 -0
  395. package/skills/luckiest-signup/evals/evals.json +88 -0
  396. package/skills/luckiest-site-architecture/ATTRIBUTION.md +38 -0
  397. package/skills/luckiest-site-architecture/CHANGELOG.md +23 -0
  398. package/skills/luckiest-site-architecture/SKILL.md +383 -0
  399. package/skills/luckiest-site-architecture/evals/evals.json +88 -0
  400. package/skills/luckiest-site-architecture/references/mermaid-templates.md +216 -0
  401. package/skills/luckiest-site-architecture/references/navigation-patterns.md +305 -0
  402. package/skills/luckiest-site-architecture/references/site-type-templates.md +293 -0
  403. package/skills/luckiest-sms/ATTRIBUTION.md +27 -0
  404. package/skills/luckiest-sms/CHANGELOG.md +24 -0
  405. package/skills/luckiest-sms/SKILL.md +400 -0
  406. package/skills/luckiest-sms/evals/evals.json +100 -0
  407. package/skills/luckiest-sms/references/compliance.md +202 -0
  408. package/skills/luckiest-sms/references/platforms.md +318 -0
  409. package/skills/luckiest-sms/references/sequence-templates.md +282 -0
  410. package/skills/luckiest-social/ATTRIBUTION.md +27 -0
  411. package/skills/luckiest-social/CHANGELOG.md +24 -0
  412. package/skills/luckiest-social/SKILL.md +430 -0
  413. package/skills/luckiest-social/evals/evals.json +92 -0
  414. package/skills/luckiest-social/references/listening-sources-template.md +123 -0
  415. package/skills/luckiest-social/references/listening.md +283 -0
  416. package/skills/luckiest-social/references/platform-limits.md +110 -0
  417. package/skills/luckiest-social/references/platforms.md +170 -0
  418. package/skills/luckiest-social/references/post-templates.md +177 -0
  419. package/skills/luckiest-social/references/reverse-engineering.md +195 -0
  420. package/skills/luckiest-social/references/short-form-video.md +237 -0
  421. package/skills/luckiest-thinker/ATTRIBUTION.md +16 -0
  422. package/skills/luckiest-thinker/CHANGELOG.md +20 -0
  423. package/skills/luckiest-thinker/LICENSE +21 -0
  424. package/skills/luckiest-thinker/SKILL.md +92 -0
  425. package/skills/luckiest-thinker/references/distribution-calibration.md +106 -0
  426. package/skills/luckiest-thinker/references/research-foundations.md +214 -0
  427. package/skills/luckiest-thinker/references/thinking-patterns.md +138 -0
  428. package/skills/luckiest-trends/.skillignore +10 -0
  429. package/skills/luckiest-trends/ATTRIBUTION.md +43 -0
  430. package/skills/luckiest-trends/CHANGELOG.md +86 -0
  431. package/skills/luckiest-trends/LICENSE +21 -0
  432. package/skills/luckiest-trends/SKILL.md +194 -0
  433. package/skills/luckiest-trends/agents/openai.yaml +8 -0
  434. package/skills/luckiest-trends/references/engine-contract.md +2041 -0
  435. package/skills/luckiest-trends/references/save-html-brief.md +206 -0
  436. package/skills/luckiest-trends/scripts/briefing.py +272 -0
  437. package/skills/luckiest-trends/scripts/build-skill.sh +39 -0
  438. package/skills/luckiest-trends/scripts/compare.sh +61 -0
  439. package/skills/luckiest-trends/scripts/evaluate_search_quality.py +573 -0
  440. package/skills/luckiest-trends/scripts/last30days.py +1467 -0
  441. package/skills/luckiest-trends/scripts/lib/__init__.py +1 -0
  442. package/skills/luckiest-trends/scripts/lib/__pycache__/__init__.cpython-313.pyc +0 -0
  443. package/skills/luckiest-trends/scripts/lib/__pycache__/arxiv.cpython-313.pyc +0 -0
  444. package/skills/luckiest-trends/scripts/lib/__pycache__/bird_x.cpython-313.pyc +0 -0
  445. package/skills/luckiest-trends/scripts/lib/__pycache__/bluesky.cpython-313.pyc +0 -0
  446. package/skills/luckiest-trends/scripts/lib/__pycache__/categories.cpython-313.pyc +0 -0
  447. package/skills/luckiest-trends/scripts/lib/__pycache__/cjk.cpython-313.pyc +0 -0
  448. package/skills/luckiest-trends/scripts/lib/__pycache__/cluster.cpython-313.pyc +0 -0
  449. package/skills/luckiest-trends/scripts/lib/__pycache__/dates.cpython-313.pyc +0 -0
  450. package/skills/luckiest-trends/scripts/lib/__pycache__/dedupe.cpython-313.pyc +0 -0
  451. package/skills/luckiest-trends/scripts/lib/__pycache__/digg.cpython-313.pyc +0 -0
  452. package/skills/luckiest-trends/scripts/lib/__pycache__/entity_extract.cpython-313.pyc +0 -0
  453. package/skills/luckiest-trends/scripts/lib/__pycache__/env.cpython-313.pyc +0 -0
  454. package/skills/luckiest-trends/scripts/lib/__pycache__/fusion.cpython-313.pyc +0 -0
  455. package/skills/luckiest-trends/scripts/lib/__pycache__/github.cpython-313.pyc +0 -0
  456. package/skills/luckiest-trends/scripts/lib/__pycache__/grounding.cpython-313.pyc +0 -0
  457. package/skills/luckiest-trends/scripts/lib/__pycache__/hackernews.cpython-313.pyc +0 -0
  458. package/skills/luckiest-trends/scripts/lib/__pycache__/hiring_signals.cpython-313.pyc +0 -0
  459. package/skills/luckiest-trends/scripts/lib/__pycache__/html_render.cpython-313.pyc +0 -0
  460. package/skills/luckiest-trends/scripts/lib/__pycache__/http.cpython-313.pyc +0 -0
  461. package/skills/luckiest-trends/scripts/lib/__pycache__/instagram.cpython-313.pyc +0 -0
  462. package/skills/luckiest-trends/scripts/lib/__pycache__/jobs.cpython-313.pyc +0 -0
  463. package/skills/luckiest-trends/scripts/lib/__pycache__/linkedin.cpython-313.pyc +0 -0
  464. package/skills/luckiest-trends/scripts/lib/__pycache__/log.cpython-313.pyc +0 -0
  465. package/skills/luckiest-trends/scripts/lib/__pycache__/normalize.cpython-313.pyc +0 -0
  466. package/skills/luckiest-trends/scripts/lib/__pycache__/permission_preflight.cpython-313.pyc +0 -0
  467. package/skills/luckiest-trends/scripts/lib/__pycache__/perplexity.cpython-313.pyc +0 -0
  468. package/skills/luckiest-trends/scripts/lib/__pycache__/pinterest.cpython-313.pyc +0 -0
  469. package/skills/luckiest-trends/scripts/lib/__pycache__/pipeline.cpython-313.pyc +0 -0
  470. package/skills/luckiest-trends/scripts/lib/__pycache__/planner.cpython-313.pyc +0 -0
  471. package/skills/luckiest-trends/scripts/lib/__pycache__/polymarket.cpython-313.pyc +0 -0
  472. package/skills/luckiest-trends/scripts/lib/__pycache__/preflight.cpython-313.pyc +0 -0
  473. package/skills/luckiest-trends/scripts/lib/__pycache__/providers.cpython-313.pyc +0 -0
  474. package/skills/luckiest-trends/scripts/lib/__pycache__/quality_nudge.cpython-313.pyc +0 -0
  475. package/skills/luckiest-trends/scripts/lib/__pycache__/query.cpython-313.pyc +0 -0
  476. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit.cpython-313.pyc +0 -0
  477. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_arctic.cpython-313.pyc +0 -0
  478. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_enrich.cpython-313.pyc +0 -0
  479. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_keyless.cpython-313.pyc +0 -0
  480. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_listing.cpython-313.pyc +0 -0
  481. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_public.cpython-313.pyc +0 -0
  482. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_rss.cpython-313.pyc +0 -0
  483. package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_shreddit.cpython-313.pyc +0 -0
  484. package/skills/luckiest-trends/scripts/lib/__pycache__/relevance.cpython-313.pyc +0 -0
  485. package/skills/luckiest-trends/scripts/lib/__pycache__/render.cpython-313.pyc +0 -0
  486. package/skills/luckiest-trends/scripts/lib/__pycache__/rerank.cpython-313.pyc +0 -0
  487. package/skills/luckiest-trends/scripts/lib/__pycache__/resolve.cpython-313.pyc +0 -0
  488. package/skills/luckiest-trends/scripts/lib/__pycache__/schema.cpython-313.pyc +0 -0
  489. package/skills/luckiest-trends/scripts/lib/__pycache__/signals.cpython-313.pyc +0 -0
  490. package/skills/luckiest-trends/scripts/lib/__pycache__/skill_meta.cpython-313.pyc +0 -0
  491. package/skills/luckiest-trends/scripts/lib/__pycache__/snippet.cpython-313.pyc +0 -0
  492. package/skills/luckiest-trends/scripts/lib/__pycache__/subproc.cpython-313.pyc +0 -0
  493. package/skills/luckiest-trends/scripts/lib/__pycache__/techmeme.cpython-313.pyc +0 -0
  494. package/skills/luckiest-trends/scripts/lib/__pycache__/threads.cpython-313.pyc +0 -0
  495. package/skills/luckiest-trends/scripts/lib/__pycache__/tiktok.cpython-313.pyc +0 -0
  496. package/skills/luckiest-trends/scripts/lib/__pycache__/trustpilot.cpython-313.pyc +0 -0
  497. package/skills/luckiest-trends/scripts/lib/__pycache__/truthsocial.cpython-313.pyc +0 -0
  498. package/skills/luckiest-trends/scripts/lib/__pycache__/ui.cpython-313.pyc +0 -0
  499. package/skills/luckiest-trends/scripts/lib/__pycache__/web_search_keyless.cpython-313.pyc +0 -0
  500. package/skills/luckiest-trends/scripts/lib/__pycache__/xai_x.cpython-313.pyc +0 -0
  501. package/skills/luckiest-trends/scripts/lib/__pycache__/xiaohongshu_api.cpython-313.pyc +0 -0
  502. package/skills/luckiest-trends/scripts/lib/__pycache__/xquik.cpython-313.pyc +0 -0
  503. package/skills/luckiest-trends/scripts/lib/__pycache__/xurl_x.cpython-313.pyc +0 -0
  504. package/skills/luckiest-trends/scripts/lib/__pycache__/youtube_yt.cpython-313.pyc +0 -0
  505. package/skills/luckiest-trends/scripts/lib/arxiv.py +290 -0
  506. package/skills/luckiest-trends/scripts/lib/bird_x.py +639 -0
  507. package/skills/luckiest-trends/scripts/lib/bluesky.py +323 -0
  508. package/skills/luckiest-trends/scripts/lib/categories.py +283 -0
  509. package/skills/luckiest-trends/scripts/lib/chrome_cookies.py +414 -0
  510. package/skills/luckiest-trends/scripts/lib/cjk.py +107 -0
  511. package/skills/luckiest-trends/scripts/lib/cluster.py +271 -0
  512. package/skills/luckiest-trends/scripts/lib/competitors.py +198 -0
  513. package/skills/luckiest-trends/scripts/lib/cookie_extract.py +508 -0
  514. package/skills/luckiest-trends/scripts/lib/dates.py +169 -0
  515. package/skills/luckiest-trends/scripts/lib/dedupe.py +145 -0
  516. package/skills/luckiest-trends/scripts/lib/digg.py +440 -0
  517. package/skills/luckiest-trends/scripts/lib/entity_extract.py +127 -0
  518. package/skills/luckiest-trends/scripts/lib/env.py +1073 -0
  519. package/skills/luckiest-trends/scripts/lib/fanout.py +84 -0
  520. package/skills/luckiest-trends/scripts/lib/fusion.py +207 -0
  521. package/skills/luckiest-trends/scripts/lib/github.py +996 -0
  522. package/skills/luckiest-trends/scripts/lib/grounding.py +331 -0
  523. package/skills/luckiest-trends/scripts/lib/hackernews.py +357 -0
  524. package/skills/luckiest-trends/scripts/lib/health.py +92 -0
  525. package/skills/luckiest-trends/scripts/lib/hiring_signals.py +326 -0
  526. package/skills/luckiest-trends/scripts/lib/html_publish.py +73 -0
  527. package/skills/luckiest-trends/scripts/lib/html_render.py +738 -0
  528. package/skills/luckiest-trends/scripts/lib/http.py +372 -0
  529. package/skills/luckiest-trends/scripts/lib/instagram.py +521 -0
  530. package/skills/luckiest-trends/scripts/lib/jobs.py +708 -0
  531. package/skills/luckiest-trends/scripts/lib/linkedin.py +363 -0
  532. package/skills/luckiest-trends/scripts/lib/log.py +35 -0
  533. package/skills/luckiest-trends/scripts/lib/normalize.py +759 -0
  534. package/skills/luckiest-trends/scripts/lib/permission_preflight.py +242 -0
  535. package/skills/luckiest-trends/scripts/lib/perplexity.py +745 -0
  536. package/skills/luckiest-trends/scripts/lib/pinterest.py +154 -0
  537. package/skills/luckiest-trends/scripts/lib/pipeline.py +1720 -0
  538. package/skills/luckiest-trends/scripts/lib/planner.py +763 -0
  539. package/skills/luckiest-trends/scripts/lib/polymarket.py +794 -0
  540. package/skills/luckiest-trends/scripts/lib/preflight.py +119 -0
  541. package/skills/luckiest-trends/scripts/lib/providers.py +380 -0
  542. package/skills/luckiest-trends/scripts/lib/quality_nudge.py +383 -0
  543. package/skills/luckiest-trends/scripts/lib/query.py +202 -0
  544. package/skills/luckiest-trends/scripts/lib/reddit.py +731 -0
  545. package/skills/luckiest-trends/scripts/lib/reddit_arctic.py +92 -0
  546. package/skills/luckiest-trends/scripts/lib/reddit_enrich.py +322 -0
  547. package/skills/luckiest-trends/scripts/lib/reddit_keyless.py +329 -0
  548. package/skills/luckiest-trends/scripts/lib/reddit_listing.py +188 -0
  549. package/skills/luckiest-trends/scripts/lib/reddit_public.py +275 -0
  550. package/skills/luckiest-trends/scripts/lib/reddit_rss.py +224 -0
  551. package/skills/luckiest-trends/scripts/lib/reddit_shreddit.py +184 -0
  552. package/skills/luckiest-trends/scripts/lib/relevance.py +200 -0
  553. package/skills/luckiest-trends/scripts/lib/render.py +2130 -0
  554. package/skills/luckiest-trends/scripts/lib/rerank.py +708 -0
  555. package/skills/luckiest-trends/scripts/lib/resolve.py +345 -0
  556. package/skills/luckiest-trends/scripts/lib/safari_cookies.py +193 -0
  557. package/skills/luckiest-trends/scripts/lib/schema.py +319 -0
  558. package/skills/luckiest-trends/scripts/lib/setup_wizard.py +843 -0
  559. package/skills/luckiest-trends/scripts/lib/signals.py +334 -0
  560. package/skills/luckiest-trends/scripts/lib/skill_meta.py +33 -0
  561. package/skills/luckiest-trends/scripts/lib/snippet.py +51 -0
  562. package/skills/luckiest-trends/scripts/lib/subproc.py +116 -0
  563. package/skills/luckiest-trends/scripts/lib/techmeme.py +239 -0
  564. package/skills/luckiest-trends/scripts/lib/threads.py +207 -0
  565. package/skills/luckiest-trends/scripts/lib/tiktok.py +596 -0
  566. package/skills/luckiest-trends/scripts/lib/transcribe.py +235 -0
  567. package/skills/luckiest-trends/scripts/lib/trustpilot.py +277 -0
  568. package/skills/luckiest-trends/scripts/lib/truthsocial.py +162 -0
  569. package/skills/luckiest-trends/scripts/lib/ui.py +626 -0
  570. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/LICENSE +21 -0
  571. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/bird-search.mjs +147 -0
  572. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/cookies.js +220 -0
  573. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/features.json +17 -0
  574. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/paginate-cursor.js +37 -0
  575. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/query-ids.json +20 -0
  576. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/runtime-features.js +151 -0
  577. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/runtime-query-ids.js +264 -0
  578. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-base.js +129 -0
  579. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-constants.js +50 -0
  580. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-features.js +347 -0
  581. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-search.js +157 -0
  582. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-types.js +2 -0
  583. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-utils.js +511 -0
  584. package/skills/luckiest-trends/scripts/lib/vendor/bird-search/package.json +13 -0
  585. package/skills/luckiest-trends/scripts/lib/web_fetch_keyless.py +105 -0
  586. package/skills/luckiest-trends/scripts/lib/web_search_keyless.py +158 -0
  587. package/skills/luckiest-trends/scripts/lib/xai_x.py +236 -0
  588. package/skills/luckiest-trends/scripts/lib/xiaohongshu_api.py +162 -0
  589. package/skills/luckiest-trends/scripts/lib/xquik.py +404 -0
  590. package/skills/luckiest-trends/scripts/lib/xurl_x.py +171 -0
  591. package/skills/luckiest-trends/scripts/lib/youtube_yt.py +1365 -0
  592. package/skills/luckiest-trends/scripts/setup-keychain.sh +123 -0
  593. package/skills/luckiest-trends/scripts/setup-pass.sh +132 -0
  594. package/skills/luckiest-trends/scripts/store.py +1020 -0
  595. package/skills/luckiest-trends/scripts/test-v1-vs-v2.sh +220 -0
  596. package/skills/luckiest-trends/scripts/test_device_auth.py +128 -0
  597. package/skills/luckiest-trends/scripts/verify_v3.py +195 -0
  598. package/skills/luckiest-trends/scripts/watchlist.py +318 -0
  599. package/skills/luckiest-video/ATTRIBUTION.md +27 -0
  600. package/skills/luckiest-video/CHANGELOG.md +23 -0
  601. package/skills/luckiest-video/SKILL.md +371 -0
  602. package/skills/luckiest-video/evals/evals.json +88 -0
  603. package/skills/luckiest-video/references/ai-video-prompting.md +175 -0
  604. package/skills/remix/SKILL.md +32 -0
  605. package/commands/luckiest/go.md +0 -45
  606. package/commands/luckiest/plan.md +0 -55
  607. /package/commands/{luckiest/charms.md → charms.md} +0 -0
  608. /package/commands/{luckiest/helpers.md → helpers.md} +0 -0
  609. /package/commands/{luckiest/home.md → home.md} +0 -0
  610. /package/commands/{luckiest/leaderboard.md → leaderboard.md} +0 -0
  611. /package/commands/{luckiest/merge.md → merge.md} +0 -0
  612. /package/commands/{luckiest/overlaps.md → overlaps.md} +0 -0
  613. /package/commands/{luckiest/skills.md → skills.md} +0 -0
  614. /package/commands/{luckiest/start.md → start.md} +0 -0
  615. /package/commands/{luckiest/status.md → status.md} +0 -0
  616. /package/commands/{luckiest/updates.md → updates.md} +0 -0
  617. /package/commands/{luckiest/vouch.md → vouch.md} +0 -0
  618. /package/commands/{luckiest/wishes.md → wishes.md} +0 -0
@@ -0,0 +1,331 @@
1
+ """Web search retrieval via Brave Search, Exa, Serper, Parallel, or a keyless floor."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import sys
6
+ import urllib.parse
7
+ from datetime import datetime
8
+ from urllib.parse import urlparse
9
+
10
+ from . import dates, env, http, web_search_keyless
11
+
12
+
13
+ # ---------------------------------------------------------------------------
14
+ # Brave Search API
15
+ # ---------------------------------------------------------------------------
16
+
17
+ def brave_search(
18
+ query: str, date_range: tuple[str, str], api_key: str, count: int = 5,
19
+ ) -> tuple[list[dict], dict]:
20
+ url = (
21
+ "https://api.search.brave.com/res/v1/web/search?"
22
+ + urllib.parse.urlencode(
23
+ {
24
+ "q": query,
25
+ "count": count,
26
+ "freshness": f"{date_range[0]}to{date_range[1]}",
27
+ }
28
+ )
29
+ )
30
+ data = http.request("GET", url, headers={"X-Subscription-Token": api_key}, timeout=15)
31
+ items = []
32
+ for i, r in enumerate((data.get("web", {}).get("results", []))[:count]):
33
+ raw_date = r.get("page_age") or ""
34
+ pub_date = _normalize_date(raw_date[:10]) if raw_date else None
35
+ if not _in_date_range(pub_date, date_range):
36
+ continue
37
+ items.append({
38
+ "id": f"WB{i + 1}",
39
+ "title": r.get("title", ""),
40
+ "url": r.get("url", ""),
41
+ "source_domain": _domain(r.get("url", "")),
42
+ "snippet": r.get("description", ""),
43
+ "date": pub_date,
44
+ "relevance": 0.8,
45
+ "why_relevant": "Brave web search",
46
+ })
47
+ artifact = {"label": "brave", "webSearchQueries": [query], "resultCount": len(items)}
48
+ return items, artifact
49
+
50
+
51
+ # ---------------------------------------------------------------------------
52
+ # Exa AI Search
53
+ # ---------------------------------------------------------------------------
54
+
55
+ def exa_search(
56
+ query: str, date_range: tuple[str, str], api_key: str, count: int = 5,
57
+ ) -> tuple[list[dict], dict]:
58
+ data = http.request(
59
+ "POST", "https://api.exa.ai/search",
60
+ headers={"x-api-key": api_key},
61
+ json_data={
62
+ "query": query,
63
+ "type": "auto",
64
+ "numResults": count,
65
+ "startPublishedDate": f"{date_range[0]}T00:00:00.000Z",
66
+ "endPublishedDate": f"{date_range[1]}T23:59:59.999Z",
67
+ "contents": {"text": {"maxCharacters": 2000}},
68
+ },
69
+ timeout=15,
70
+ )
71
+ items = []
72
+ for i, r in enumerate((data.get("results", []))[:count]):
73
+ if not isinstance(r, dict):
74
+ continue
75
+ url = r.get("url", "")
76
+ if not url:
77
+ continue
78
+ raw_date = r.get("publishedDate") or ""
79
+ pub_date = _normalize_date(raw_date.split("T")[0] if "T" in raw_date else raw_date[:10]) if raw_date else None
80
+ if not _in_date_range(pub_date, date_range):
81
+ continue
82
+ items.append({
83
+ "id": f"WE{i + 1}",
84
+ "title": r.get("title", ""),
85
+ "url": url,
86
+ "source_domain": _domain(url),
87
+ "snippet": (r.get("text") or "")[:500],
88
+ "date": pub_date,
89
+ "relevance": 0.8,
90
+ "why_relevant": "Exa web search",
91
+ })
92
+ artifact = {"label": "exa", "webSearchQueries": [query], "resultCount": len(items)}
93
+ return items, artifact
94
+
95
+
96
+ # ---------------------------------------------------------------------------
97
+ # Serper (Google Search wrapper)
98
+ # ---------------------------------------------------------------------------
99
+
100
+ def serper_search(
101
+ query: str, date_range: tuple[str, str], api_key: str, count: int = 5,
102
+ ) -> tuple[list[dict], dict]:
103
+ data = http.request(
104
+ "POST", "https://google.serper.dev/search",
105
+ headers={"X-API-KEY": api_key},
106
+ json_data={
107
+ "q": query,
108
+ "num": count,
109
+ "tbs": f"cdr:1,cd_min:{_serper_date_param(date_range[0])},cd_max:{_serper_date_param(date_range[1])}",
110
+ },
111
+ timeout=15,
112
+ )
113
+ items = []
114
+ for i, r in enumerate((data.get("organic", []))[:count]):
115
+ raw_date = r.get("date") or ""
116
+ pub_date = _parse_serper_date(raw_date)
117
+ if not _in_date_range(pub_date, date_range):
118
+ continue
119
+ items.append({
120
+ "id": f"WS{i + 1}",
121
+ "title": r.get("title", ""),
122
+ "url": r.get("link", ""),
123
+ "source_domain": _domain(r.get("link", "")),
124
+ "snippet": r.get("snippet", ""),
125
+ "date": pub_date,
126
+ "relevance": 0.8,
127
+ "why_relevant": "Serper web search",
128
+ })
129
+ artifact = {"label": "serper", "webSearchQueries": [query], "resultCount": len(items)}
130
+ return items, artifact
131
+
132
+
133
+ # ---------------------------------------------------------------------------
134
+ # Parallel AI Search
135
+ # ---------------------------------------------------------------------------
136
+
137
+ def parallel_search(
138
+ query: str, date_range: tuple[str, str], api_key: str, count: int = 5,
139
+ ) -> tuple[list[dict], dict]:
140
+ data = http.request(
141
+ "POST", "https://api.parallel.ai/v1/search",
142
+ headers={"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"},
143
+ json_data={
144
+ "search_queries": [query],
145
+ "advanced_settings": {"max_results": count},
146
+ },
147
+ timeout=15,
148
+ )
149
+ items = []
150
+ for i, r in enumerate((data.get("results", []))[:count]):
151
+ if not isinstance(r, dict):
152
+ continue
153
+ url = r.get("url", "")
154
+ if not url:
155
+ continue
156
+ raw_date = r.get("publish_date") or ""
157
+ pub_date = _normalize_date(raw_date[:10]) if raw_date else None
158
+ if not _in_date_range(pub_date, date_range):
159
+ continue
160
+ items.append({
161
+ "id": f"WP{i + 1}",
162
+ "title": r.get("title", ""),
163
+ "url": url,
164
+ "source_domain": _domain(url),
165
+ "snippet": ((r.get("excerpts") or [""])[0] or "")[:500],
166
+ "date": pub_date,
167
+ "relevance": 0.8,
168
+ "why_relevant": "Parallel AI web search",
169
+ })
170
+ artifact = {"label": "parallel", "webSearchQueries": [query], "resultCount": len(items)}
171
+ return items, artifact
172
+
173
+
174
+ def _parse_serper_date(raw: str) -> str | None:
175
+ if not raw:
176
+ return None
177
+ normalized = _normalize_date(raw)
178
+ if normalized:
179
+ return normalized
180
+ for fmt in ("%b %d, %Y", "%B %d, %Y", "%Y-%m-%d"):
181
+ try:
182
+ return datetime.strptime(raw.strip(), fmt).date().isoformat()
183
+ except ValueError:
184
+ continue
185
+ return None
186
+
187
+
188
+
189
+
190
+ # ---------------------------------------------------------------------------
191
+ # Dispatcher
192
+ # ---------------------------------------------------------------------------
193
+
194
+ def web_search(
195
+ query: str,
196
+ date_range: tuple[str, str],
197
+ config: dict,
198
+ backend: str = "auto",
199
+ ) -> tuple[list[dict], dict]:
200
+ """Run web search with the specified or auto-detected backend."""
201
+ if backend == "auto":
202
+ if config.get("BRAVE_API_KEY"):
203
+ backend = "brave"
204
+ elif config.get("EXA_API_KEY"):
205
+ backend = "exa"
206
+ elif config.get("SERPER_API_KEY"):
207
+ backend = "serper"
208
+ elif config.get("PARALLEL_API_KEY"):
209
+ backend = "parallel"
210
+ elif env.keyless_web_allowed(config):
211
+ # No paid key and the host has no native search -> use the keyless
212
+ # floor. On a native-search host this branch is skipped (the model
213
+ # supplies web results itself), so the engine returns nothing here.
214
+ backend = "keyless"
215
+ else:
216
+ return [], {}
217
+ items: list[dict] = []
218
+ artifact: dict = {}
219
+ if backend == "brave":
220
+ key = config.get("BRAVE_API_KEY")
221
+ if not key:
222
+ raise RuntimeError("BRAVE_API_KEY is required when web_backend='brave'")
223
+ items, artifact = brave_search(query, date_range, key)
224
+ elif backend == "exa":
225
+ key = config.get("EXA_API_KEY")
226
+ if not key:
227
+ raise RuntimeError("EXA_API_KEY is required when web_backend='exa'")
228
+ items, artifact = exa_search(query, date_range, key)
229
+ elif backend == "serper":
230
+ key = config.get("SERPER_API_KEY")
231
+ if not key:
232
+ raise RuntimeError("SERPER_API_KEY is required when web_backend='serper'")
233
+ items, artifact = serper_search(query, date_range, key)
234
+ elif backend == "parallel":
235
+ key = config.get("PARALLEL_API_KEY")
236
+ if not key:
237
+ raise RuntimeError("PARALLEL_API_KEY is required when web_backend='parallel'")
238
+ items, artifact = parallel_search(query, date_range, key)
239
+ elif backend == "keyless":
240
+ items, artifact = web_search_keyless.keyless_search(query, date_range, config)
241
+ elif backend != "none":
242
+ raise ValueError(f"Unsupported web backend: {backend!r}")
243
+ else:
244
+ return [], {}
245
+ if items and not _reddit_excluded(config):
246
+ items = _enrich_reddit_items(items)
247
+ return items, artifact
248
+
249
+
250
+ def _reddit_excluded(config: dict) -> bool:
251
+ """Return True when EXCLUDE_SOURCES contains 'reddit'.
252
+
253
+ Respects the same suppression knob the pipeline uses for source gating,
254
+ so a user who set EXCLUDE_SOURCES=reddit doesn't get Reddit content
255
+ smuggled back in via web-search URLs.
256
+ """
257
+ raw = (config.get("EXCLUDE_SOURCES") or "").split(",")
258
+ return any(s.strip().lower() == "reddit" for s in raw)
259
+
260
+
261
+ def _enrich_reddit_items(items: list[dict]) -> list[dict]:
262
+ """Enrich web search results that are Reddit URLs with thread body and comments.
263
+
264
+ Claude Code's WebFetch blocks reddit.com, so the model can't retrieve
265
+ Reddit content from web search results. This fetches it via the public
266
+ JSON API (reddit.com/.../.json) which bypasses that restriction.
267
+
268
+ Callers should gate this with EXCLUDE_SOURCES=reddit handling (see
269
+ `_reddit_excluded`) so a user who explicitly excluded Reddit doesn't
270
+ get Reddit content via web-search URLs.
271
+ """
272
+ from . import reddit_enrich
273
+ from .reddit_enrich import RedditRateLimitError
274
+
275
+ for item in items:
276
+ url = item.get("url", "")
277
+ if "reddit.com" not in url or "/comments/" not in url:
278
+ continue
279
+ try:
280
+ thread_data = reddit_enrich.fetch_thread_data(url, timeout=8)
281
+ if not thread_data:
282
+ continue
283
+ parsed = reddit_enrich.parse_thread_data(thread_data)
284
+ # selftext lives under parsed["submission"], not at the top level
285
+ selftext = (parsed.get("submission") or {}).get("selftext", "")
286
+ if selftext:
287
+ item["snippet"] = selftext[:2000]
288
+ comments = parsed.get("comments", [])
289
+ top = reddit_enrich.get_top_comments(comments)
290
+ if top:
291
+ item["top_comments"] = [
292
+ {"score": c.get("score", 0), "excerpt": (c.get("body") or "")[:200]}
293
+ for c in top[:5]
294
+ ]
295
+ item["enriched_via"] = "reddit_json_api"
296
+ except RedditRateLimitError as exc:
297
+ # Stop iterating to avoid flooding more 429s
298
+ sys.stderr.write(f"[Web] Reddit rate-limited, halting enrichment: {exc}\n")
299
+ break
300
+ except Exception as exc:
301
+ sys.stderr.write(f"[Web] Reddit enrichment failed for {url}: {exc}\n")
302
+ return items
303
+
304
+
305
+ # ---------------------------------------------------------------------------
306
+ # Helpers
307
+ # ---------------------------------------------------------------------------
308
+
309
+ def _normalize_date(value: object) -> str | None:
310
+ if value is None:
311
+ return None
312
+ parsed = dates.parse_date(str(value).strip())
313
+ if not parsed:
314
+ return None
315
+ return parsed.date().isoformat()
316
+
317
+
318
+ def _serper_date_param(iso_date: str) -> str:
319
+ """Convert YYYY-MM-DD to MM/DD/YYYY for Serper tbs parameter."""
320
+ parts = iso_date.split("-")
321
+ return f"{parts[1]}/{parts[2]}/{parts[0]}"
322
+
323
+
324
+ def _in_date_range(pub_date: str | None, date_range: tuple[str, str]) -> bool:
325
+ if not pub_date:
326
+ return False
327
+ return date_range[0] <= pub_date <= date_range[1]
328
+
329
+
330
+ def _domain(url: str) -> str:
331
+ return urlparse(url).netloc.strip().lower()
@@ -0,0 +1,357 @@
1
+ """Hacker News search via Algolia API (free, no auth required).
2
+
3
+ Uses hn.algolia.com/api/v1 for story discovery and comment enrichment.
4
+ No API key needed - just HTTP calls via stdlib urllib.
5
+ """
6
+
7
+ import datetime
8
+ import html
9
+ import math
10
+ import sys
11
+ import time
12
+ from concurrent.futures import ThreadPoolExecutor, as_completed
13
+ from typing import Any, Dict, List, Optional
14
+
15
+ import re
16
+
17
+ from . import http, log
18
+ from .query import extract_core_subject
19
+ from .relevance import token_overlap_relevance
20
+
21
+ # Common HN prefixes that can cause false-positive keyword matches
22
+ _HN_PREFIXES = re.compile(r"^(Tell HN|Show HN|Ask HN|Launch HN)\s*:\s*", re.IGNORECASE)
23
+
24
+ ALGOLIA_SEARCH_URL = "https://hn.algolia.com/api/v1/search"
25
+ ALGOLIA_SEARCH_BY_DATE_URL = "https://hn.algolia.com/api/v1/search_by_date"
26
+ ALGOLIA_ITEM_URL = "https://hn.algolia.com/api/v1/items"
27
+
28
+ DEPTH_CONFIG = {
29
+ "quick": 15,
30
+ "default": 30,
31
+ "deep": 60,
32
+ }
33
+
34
+ MIN_STORY_POINTS = 2
35
+ HN_OVERFETCH_MULTIPLIER = 2
36
+
37
+ ENRICH_LIMITS = {
38
+ "quick": 3,
39
+ "default": 5,
40
+ "deep": 10,
41
+ }
42
+
43
+
44
+ def _log(msg: str):
45
+ log.source_log("HN", msg, tty_only=False)
46
+
47
+
48
+ def _date_to_unix(date_str: str) -> int:
49
+ """Convert YYYY-MM-DD to Unix timestamp (start of day UTC)."""
50
+ parts = date_str.split("-")
51
+ year, month, day = int(parts[0]), int(parts[1]), int(parts[2])
52
+ dt = datetime.datetime(year, month, day, tzinfo=datetime.timezone.utc)
53
+ return int(dt.timestamp())
54
+
55
+
56
+ def _unix_to_date(ts: int) -> str:
57
+ """Convert Unix timestamp to YYYY-MM-DD."""
58
+ dt = datetime.datetime.fromtimestamp(ts, tz=datetime.timezone.utc)
59
+ return dt.strftime("%Y-%m-%d")
60
+
61
+
62
+ def _strip_html(text: str) -> str:
63
+ """Strip HTML tags and decode entities from HN comment text."""
64
+ import re
65
+ text = html.unescape(text)
66
+ text = re.sub(r'<p>', '\n', text)
67
+ text = re.sub(r'<[^>]+>', '', text)
68
+ return text.strip()
69
+
70
+
71
+ def search_hackernews(
72
+ topic: str,
73
+ from_date: str,
74
+ to_date: str,
75
+ depth: str = "default",
76
+ ) -> Dict[str, Any]:
77
+ """Search Hacker News via Algolia API.
78
+
79
+ Args:
80
+ topic: Search topic
81
+ from_date: Start date (YYYY-MM-DD)
82
+ to_date: End date (YYYY-MM-DD)
83
+ depth: 'quick', 'default', or 'deep'
84
+
85
+ Returns:
86
+ Dict with Algolia response (contains 'hits' list).
87
+ """
88
+ count = DEPTH_CONFIG.get(depth, DEPTH_CONFIG["default"])
89
+ fetch_count = count * HN_OVERFETCH_MULTIPLIER
90
+ from_ts = _date_to_unix(from_date)
91
+ to_ts = _date_to_unix(to_date) + 86400 # Include the end date
92
+
93
+ # Use extracted core subject instead of raw topic for cleaner Algolia matching
94
+ core = extract_core_subject(topic)
95
+ # Hyphens and commas tokenize awkwardly in Algolia; flatten them so themed
96
+ # queries like "ts-bun-node" or "claude, personal agents" become plain words.
97
+ core_flat = _flatten_query_for_algolia(core)
98
+ _log(f"Searching for '{core_flat}' (raw: '{topic}', since {from_date}, count={count})")
99
+
100
+ # Use relevance-sorted search. The HN Algolia index only allows
101
+ # `created_at_i` in numericFilters; `points` is NOT in its
102
+ # `numericAttributesForFiltering`, so a `points>N` clause makes the API
103
+ # return HTTP 400 ("invalid numeric attribute(points)") and zero stories.
104
+ # Low-engagement stories are filtered client-side after overfetching so the
105
+ # invalid numeric filter is not reintroduced.
106
+ # NOTE: restrictSearchableAttributes=title omitted intentionally — it would
107
+ # miss Ask HN/Show HN threads where the topic appears in the body.
108
+ params = {
109
+ "query": core_flat,
110
+ "tags": "story",
111
+ "numericFilters": f"created_at_i>{from_ts},created_at_i<{to_ts}",
112
+ "hitsPerPage": str(fetch_count),
113
+ }
114
+ # Algolia defaults to AND across query tokens, so a 4-5 word theme query
115
+ # matches no stories. Mark all-but-the-first token as optional so Algolia
116
+ # ranks by how many tokens match instead of requiring every one.
117
+ tokens = core_flat.split()
118
+ if len(tokens) > 1:
119
+ params["optionalWords"] = " ".join(tokens[1:])
120
+
121
+ from urllib.parse import urlencode
122
+ url = f"{ALGOLIA_SEARCH_URL}?{urlencode(params)}"
123
+
124
+ try:
125
+ response = http.request("GET", url, timeout=30)
126
+ except http.HTTPError as e:
127
+ _log(f"Search failed: {e}")
128
+ return {"hits": [], "error": str(e)}
129
+ except Exception as e:
130
+ _log(f"Search failed: {e}")
131
+ return {"hits": [], "error": str(e)}
132
+
133
+ raw_hits = response.get("hits", [])
134
+ qualifying_hits = [
135
+ hit for hit in raw_hits
136
+ if (hit.get("points") or 0) > MIN_STORY_POINTS
137
+ ]
138
+ hits = qualifying_hits[:count]
139
+ dropped_low_engagement = len(raw_hits) - len(qualifying_hits)
140
+ if dropped_low_engagement:
141
+ _log(f"Filtered {dropped_low_engagement}/{len(raw_hits)} low-engagement stories")
142
+ if len(hits) != len(raw_hits):
143
+ response = {**response, "hits": hits}
144
+ _log(f"Found {len(hits)} stories")
145
+ return response
146
+
147
+
148
+ _WORD_BOUNDARY_RE_CACHE: Dict[str, "re.Pattern[str]"] = {}
149
+
150
+
151
+ def _flatten_query_for_algolia(text: str) -> str:
152
+ """Normalise query for Algolia + post-filter comparison.
153
+
154
+ Multi-keyword theme queries frequently contain commas (delimiters) or
155
+ hyphens (compound terms like ``ts-bun-node``); both tokenize awkwardly.
156
+ Flatten them to spaces and collapse runs of whitespace so the search
157
+ parameter and the post-filter operate on the same shape.
158
+ """
159
+ return " ".join(text.replace(",", " ").replace("-", " ").split())
160
+
161
+
162
+ def _title_matches_query(title: str, query: str, author: str = "") -> bool:
163
+ """Check if any query token appears as a whole word in the title.
164
+
165
+ Returns True when the query is empty (no filter), or when at least one
166
+ query token matches as a whole word in the title after stripping
167
+ "Tell HN:", "Show HN:", "Ask HN:", "Launch HN:" prefixes.
168
+
169
+ We previously required *every* token to appear (all-words), which killed
170
+ every Algolia hit on multi-keyword themes like "claude, personal agents,
171
+ agentic infra" because real HN titles never contain all five tokens
172
+ verbatim. Relaxing to any-word matches Algolia's `optionalWords` behaviour
173
+ in `search_hackernews`. Token-overlap relevance scoring at parse time
174
+ demotes hits where only one weak token matched, so the loosened gate
175
+ won't surface noise to the top of the ranking.
176
+
177
+ Word-boundary matching (rather than naive substring) prevents short
178
+ tokens like ``ai`` or ``ts`` from matching unrelated words like
179
+ ``email`` or ``artists``.
180
+ """
181
+ if not query:
182
+ return True
183
+ stripped = _HN_PREFIXES.sub("", title).strip()
184
+ check_text = stripped.lower()
185
+ # Normalise the query the same way search_hackernews does so post-filter
186
+ # tokens line up with what Algolia actually saw.
187
+ query_words = [w for w in _flatten_query_for_algolia(query.lower()).split() if w]
188
+ if not query_words:
189
+ return True
190
+ for word in query_words:
191
+ pattern = _WORD_BOUNDARY_RE_CACHE.get(word)
192
+ if pattern is None:
193
+ pattern = re.compile(rf"\b{re.escape(word)}\b")
194
+ _WORD_BOUNDARY_RE_CACHE[word] = pattern
195
+ if pattern.search(check_text):
196
+ return True
197
+ return False
198
+
199
+
200
+ def parse_hackernews_response(response: Dict[str, Any], query: str = "") -> List[Dict[str, Any]]:
201
+ """Parse Algolia response into normalized item dicts.
202
+
203
+ Args:
204
+ response: Algolia search response
205
+ query: Original search query for token-overlap relevance scoring
206
+
207
+ Returns:
208
+ List of item dicts ready for normalization.
209
+ """
210
+ hits = response.get("hits", [])
211
+ # Post-filter: remove items where query only matched an HN prefix like "Tell HN:"
212
+ if query:
213
+ before = len(hits)
214
+ hits = [
215
+ h for h in hits
216
+ if _title_matches_query(h.get("title", ""), query, h.get("author", ""))
217
+ ]
218
+ dropped = before - len(hits)
219
+ if dropped:
220
+ _log(f"Prefix filter removed {dropped}/{before} false-positive hits for '{query}'")
221
+ items = []
222
+
223
+ for i, hit in enumerate(hits):
224
+ object_id = hit.get("objectID", "")
225
+ points = hit.get("points") or 0
226
+ num_comments = hit.get("num_comments") or 0
227
+ created_at_i = hit.get("created_at_i")
228
+
229
+ date_str = None
230
+ if created_at_i:
231
+ date_str = _unix_to_date(created_at_i)
232
+
233
+ # Article URL vs HN discussion URL
234
+ article_url = hit.get("url") or ""
235
+ hn_url = f"https://news.ycombinator.com/item?id={object_id}"
236
+
237
+ # Relevance: blend Algolia rank with token-overlap content matching
238
+ rank_score = max(0.3, 1.0 - (i * 0.02)) # 1.0 -> 0.3 over 35 items
239
+ engagement_boost = min(0.2, math.log1p(points) / 40)
240
+ if query:
241
+ content_score = token_overlap_relevance(query, hit.get("title", ""))
242
+ relevance = min(1.0, 0.6 * rank_score + 0.4 * content_score + engagement_boost)
243
+ else:
244
+ relevance = min(1.0, rank_score * 0.7 + engagement_boost + 0.1)
245
+
246
+ items.append({
247
+ "id": object_id,
248
+ "title": hit.get("title", ""),
249
+ "url": article_url,
250
+ "hn_url": hn_url,
251
+ "author": hit.get("author", ""),
252
+ "date": date_str,
253
+ "engagement": {
254
+ "points": points,
255
+ "comments": num_comments,
256
+ },
257
+ "relevance": round(relevance, 2),
258
+ "why_relevant": f"HN story about {hit.get('title', 'topic')[:60]}",
259
+ })
260
+
261
+ return items
262
+
263
+
264
+ def _fetch_item_comments(object_id: str, max_comments: int = 5) -> Dict[str, Any]:
265
+ """Fetch top-level comments for a story from Algolia items endpoint.
266
+
267
+ Args:
268
+ object_id: HN story ID
269
+ max_comments: Max comments to return
270
+
271
+ Returns:
272
+ Dict with 'comments' list and 'comment_insights' list.
273
+ """
274
+ url = f"{ALGOLIA_ITEM_URL}/{object_id}"
275
+
276
+ try:
277
+ data = http.request("GET", url, timeout=15)
278
+ except Exception as e:
279
+ _log(f"Failed to fetch comments for {object_id}: {e}")
280
+ return {"comments": [], "comment_insights": []}
281
+
282
+ children = data.get("children", [])
283
+
284
+ # Sort by points (highest first), filter to actual comments
285
+ real_comments = [
286
+ c for c in children
287
+ if c.get("text") and c.get("author")
288
+ ]
289
+ real_comments.sort(key=lambda c: c.get("points") or 0, reverse=True)
290
+
291
+ comments = []
292
+ insights = []
293
+ for c in real_comments[:max_comments]:
294
+ text = _strip_html(c.get("text", ""))
295
+ excerpt = text[:300] + "..." if len(text) > 300 else text
296
+ comments.append({
297
+ "author": c.get("author", ""),
298
+ "text": excerpt,
299
+ "points": c.get("points") or 0,
300
+ })
301
+ # First sentence as insight
302
+ first_sentence = text.split(". ")[0].split("\n")[0][:200]
303
+ if first_sentence:
304
+ insights.append(first_sentence)
305
+
306
+ return {"comments": comments, "comment_insights": insights}
307
+
308
+
309
+ def enrich_top_stories(
310
+ items: List[Dict[str, Any]],
311
+ depth: str = "default",
312
+ ) -> List[Dict[str, Any]]:
313
+ """Fetch comments for top N stories by points.
314
+
315
+ Args:
316
+ items: Parsed HN items
317
+ depth: Research depth (controls how many to enrich)
318
+
319
+ Returns:
320
+ Items with top_comments and comment_insights added.
321
+ """
322
+ if not items:
323
+ return items
324
+
325
+ limit = ENRICH_LIMITS.get(depth, ENRICH_LIMITS["default"])
326
+
327
+ # Sort by points to enrich the most popular stories
328
+ by_points = sorted(
329
+ range(len(items)),
330
+ key=lambda i: items[i].get("engagement", {}).get("points", 0),
331
+ reverse=True,
332
+ )
333
+ to_enrich = by_points[:limit]
334
+
335
+ _log(f"Enriching top {len(to_enrich)} stories with comments")
336
+
337
+ with ThreadPoolExecutor(max_workers=5) as executor:
338
+ futures = {
339
+ executor.submit(
340
+ _fetch_item_comments,
341
+ items[idx]["id"],
342
+ ): idx
343
+ for idx in to_enrich
344
+ }
345
+
346
+ for future in as_completed(futures):
347
+ idx = futures[future]
348
+ try:
349
+ result = future.result(timeout=15)
350
+ items[idx]["top_comments"] = result["comments"]
351
+ items[idx]["comment_insights"] = result["comment_insights"]
352
+ except (KeyError, TypeError, OSError) as exc:
353
+ _log(f"Comment enrichment failed for story {items[idx].get('id', '?')}: {type(exc).__name__}: {exc}")
354
+ items[idx]["top_comments"] = []
355
+ items[idx]["comment_insights"] = []
356
+
357
+ return items