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,996 @@
1
+ """GitHub Issues/PRs search via the public GitHub Search API.
2
+
3
+ Uses api.github.com/search/issues for issue/PR discovery and
4
+ per-item comment enrichment. Auth via GITHUB_TOKEN env var or
5
+ `gh auth token` subprocess fallback.
6
+ """
7
+
8
+ import json
9
+ import math
10
+ import os
11
+ import re
12
+ import subprocess
13
+ import sys
14
+ import urllib.error
15
+ import urllib.parse
16
+ import urllib.request
17
+ from concurrent.futures import ThreadPoolExecutor, as_completed
18
+ from typing import Any, Dict, List, Optional
19
+
20
+ from . import dates, log
21
+ from .query import extract_core_subject
22
+ from .relevance import token_overlap_relevance
23
+
24
+ SEARCH_URL = "https://api.github.com/search/issues"
25
+
26
+ DEPTH_LIMITS = {
27
+ "quick": 15,
28
+ "default": 30,
29
+ "deep": 60,
30
+ }
31
+
32
+ ENRICH_LIMITS = {
33
+ "quick": 3,
34
+ "default": 5,
35
+ "deep": 8,
36
+ }
37
+
38
+ # Unauthenticated GitHub search allows ~10 requests/min, so cap result volume
39
+ # conservatively when running without a token to stay within the anon tier.
40
+ UNAUTH_COUNT_CAP = 10
41
+
42
+ USER_AGENT = "last30days/3.0 (research tool)"
43
+
44
+
45
+ def _log(msg: str):
46
+ log.source_log("GitHub", msg, tty_only=False)
47
+
48
+
49
+ def _resolve_token(token: Optional[str] = None) -> Optional[str]:
50
+ """Resolve GitHub auth token from argument, env, or gh CLI."""
51
+ if token:
52
+ return token
53
+ env_token = os.environ.get("GITHUB_TOKEN")
54
+ if env_token:
55
+ return env_token
56
+ # Fallback: try gh CLI
57
+ try:
58
+ result = subprocess.run(
59
+ ["gh", "auth", "token"],
60
+ capture_output=True, text=True, timeout=5,
61
+ )
62
+ if result.returncode == 0 and result.stdout.strip():
63
+ return result.stdout.strip()
64
+ except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
65
+ pass
66
+ return None
67
+
68
+
69
+ def resolve_token(token: Optional[str] = None) -> Optional[str]:
70
+ """Public alias for ``_resolve_token``.
71
+
72
+ The pipeline calls this once before ``search_github`` and
73
+ ``enrich_with_comments`` so the ``gh auth token`` subprocess fallback
74
+ only fires once per query when ``GITHUB_TOKEN`` is unset, instead of
75
+ twice (once per call site).
76
+ """
77
+ return _resolve_token(token)
78
+
79
+
80
+ def _fetch_json(
81
+ url: str,
82
+ token: Optional[str] = None,
83
+ timeout: int = 15,
84
+ ) -> Optional[Dict[str, Any]]:
85
+ """Fetch JSON from GitHub API. Returns None on failure."""
86
+ headers = {
87
+ "User-Agent": USER_AGENT,
88
+ "Accept": "application/vnd.github+json",
89
+ }
90
+ if token:
91
+ headers["Authorization"] = f"Bearer {token}"
92
+
93
+ req = urllib.request.Request(url, headers=headers)
94
+ try:
95
+ with urllib.request.urlopen(req, timeout=timeout) as resp:
96
+ body = resp.read().decode("utf-8")
97
+ return json.loads(body)
98
+ except urllib.error.HTTPError as e:
99
+ if e.code == 403:
100
+ _log(f"403 rate limited or forbidden: {url}")
101
+ return None
102
+ if e.code == 422:
103
+ _log(f"422 unprocessable: {url}")
104
+ return None
105
+ _log(f"HTTP {e.code}: {e.reason}")
106
+ return None
107
+ except (urllib.error.URLError, OSError, TimeoutError) as e:
108
+ _log(f"Network error: {e}")
109
+ return None
110
+ except json.JSONDecodeError as e:
111
+ _log(f"JSON decode error: {e}")
112
+ return None
113
+
114
+
115
+ def _parse_repo_from_url(html_url: str) -> str:
116
+ """Extract 'owner/repo' from a GitHub issue/PR URL."""
117
+ parts = html_url.replace("https://github.com/", "").split("/")
118
+ if len(parts) >= 2:
119
+ return f"{parts[0]}/{parts[1]}"
120
+ return ""
121
+
122
+
123
+ def _parse_date(iso_str: Optional[str]) -> Optional[str]:
124
+ """Parse a GitHub ISO 8601 datetime string and return YYYY-MM-DD.
125
+
126
+ Returns None for non-date input. GitHub's API always emits ISO 8601
127
+ (e.g. "2026-02-26T16:00:00Z"), but we defer to dates.parse_date() so
128
+ garbage input gets rejected instead of silently sliced.
129
+ """
130
+ dt = dates.parse_date(iso_str)
131
+ return dt.strftime("%Y-%m-%d") if dt else None
132
+
133
+
134
+ def _compute_relevance(
135
+ query: str,
136
+ title: str,
137
+ rank_index: int,
138
+ reactions: int,
139
+ comments: int,
140
+ ) -> float:
141
+ """Blend text relevance with engagement signals."""
142
+ rank_score = max(0.3, 1.0 - (rank_index * 0.02))
143
+ engagement_boost = min(0.2, math.log1p(reactions + comments) / 20)
144
+
145
+ if query:
146
+ content_score = token_overlap_relevance(query, title)
147
+ relevance = min(1.0, 0.6 * rank_score + 0.4 * content_score + engagement_boost)
148
+ else:
149
+ relevance = min(1.0, rank_score * 0.7 + engagement_boost + 0.1)
150
+
151
+ return round(relevance, 2)
152
+
153
+
154
+ def search_github(
155
+ topic: str,
156
+ from_date: str,
157
+ to_date: str,
158
+ depth: str = "default",
159
+ token: Optional[str] = None,
160
+ ) -> Dict[str, Any]:
161
+ """Search GitHub Issues and PRs (HTTP fetch only).
162
+
163
+ Returns a raw envelope shaped like every other adapter's ``search_X``:
164
+ ``{"items": [raw GitHub API items], "context": {core, from_date,
165
+ to_date, count}}``. Normalization, date filtering, and sorting move
166
+ to ``parse_github_response``; comment enrichment moves to
167
+ ``enrich_with_comments``.
168
+
169
+ Args:
170
+ topic: Search topic
171
+ from_date: Start date (YYYY-MM-DD)
172
+ to_date: End date (YYYY-MM-DD)
173
+ depth: 'quick', 'default', or 'deep'
174
+ token: Optional GitHub token (falls back to env/gh CLI)
175
+
176
+ Returns:
177
+ Dict envelope. Empty ``items`` list on any failure.
178
+ """
179
+ count = DEPTH_LIMITS.get(depth, DEPTH_LIMITS["default"])
180
+ core = extract_core_subject(topic)
181
+ resolved_token = _resolve_token(token)
182
+ authed = bool(resolved_token)
183
+ if not authed:
184
+ # Fall back to the unauthenticated REST tier instead of returning nothing.
185
+ # It is rate-limited, so cap the request volume.
186
+ count = min(count, UNAUTH_COUNT_CAP)
187
+ _log("No GitHub token; using the unauthenticated REST tier (low rate limit)")
188
+ _log(f"Searching for '{core}' (raw: '{topic}', since {from_date}, count={count})")
189
+
190
+ # Build search query with date filter
191
+ q = f"{core} created:>{from_date}"
192
+ params = {
193
+ "q": q,
194
+ "sort": "reactions",
195
+ "order": "desc",
196
+ "per_page": str(min(count, 100)),
197
+ }
198
+ url = f"{SEARCH_URL}?{urllib.parse.urlencode(params)}"
199
+
200
+ data = _fetch_json(url, token=resolved_token, timeout=30)
201
+ if not data:
202
+ envelope = {"items": [], "context": {"core": core, "from_date": from_date,
203
+ "to_date": to_date, "count": count}}
204
+ if not authed:
205
+ # Could be the anon rate limit (403) or an unprocessable query (422)
206
+ # -- _fetch_json maps both to None. Don't over-claim which; suggest a
207
+ # token since that fixes the common (rate-limit) case.
208
+ envelope["error"] = (
209
+ "GitHub unauthenticated request returned no data (anon rate limit "
210
+ "or unprocessable query; set GITHUB_TOKEN or run gh auth login)"
211
+ )
212
+ return envelope
213
+
214
+ raw_items = data.get("items", [])
215
+ _log(f"Found {len(raw_items)} issues/PRs")
216
+
217
+ return {
218
+ "items": raw_items,
219
+ "context": {
220
+ "core": core,
221
+ "from_date": from_date,
222
+ "to_date": to_date,
223
+ "count": count,
224
+ },
225
+ }
226
+
227
+
228
+ def parse_github_response(response: Dict[str, Any]) -> List[Dict[str, Any]]:
229
+ """Normalize a ``search_github`` envelope into the skill's item shape.
230
+
231
+ Pure function: no I/O, no token, no enrichment. Applies the date
232
+ filter using the search context and sorts by relevance.
233
+ """
234
+ if not isinstance(response, dict):
235
+ return []
236
+ raw_items = response.get("items") or []
237
+ if not isinstance(raw_items, list):
238
+ return []
239
+ context = response.get("context") or {}
240
+ core = context.get("core") or ""
241
+ from_date = context.get("from_date") or ""
242
+ to_date = context.get("to_date") or ""
243
+ count = context.get("count") or DEPTH_LIMITS["default"]
244
+
245
+ items: List[Dict[str, Any]] = []
246
+ for i, item in enumerate(raw_items[:count]):
247
+ html_url = item.get("html_url", "")
248
+ repo = _parse_repo_from_url(html_url)
249
+ title = item.get("title", "")
250
+ body_text = item.get("body") or ""
251
+ reactions_total = item.get("reactions", {}).get("total_count", 0) if isinstance(item.get("reactions"), dict) else 0
252
+ comment_count = item.get("comments", 0)
253
+ labels = [
254
+ lbl.get("name", "") for lbl in (item.get("labels") or [])
255
+ if isinstance(lbl, dict)
256
+ ]
257
+ state = item.get("state", "")
258
+ is_pr = "pull_request" in item
259
+ author = item.get("user", {}).get("login", "") if isinstance(item.get("user"), dict) else ""
260
+
261
+ relevance = _compute_relevance(core, title, i, reactions_total, comment_count)
262
+
263
+ items.append({
264
+ "id": f"GH{i + 1}",
265
+ "title": title,
266
+ "url": html_url,
267
+ "date": _parse_date(item.get("created_at")),
268
+ "author": author,
269
+ "source": "github",
270
+ "score": reactions_total,
271
+ "container": repo,
272
+ "snippet": body_text[:300] if body_text else "",
273
+ "relevance": relevance,
274
+ "why_relevant": f"GitHub {'PR' if is_pr else 'issue'}: {title[:60]}",
275
+ "engagement": {
276
+ "reactions": reactions_total,
277
+ "comments": comment_count,
278
+ },
279
+ "metadata": {
280
+ "labels": labels,
281
+ "state": state,
282
+ "comment_count": comment_count,
283
+ "reactions": reactions_total,
284
+ "is_pr": is_pr,
285
+ },
286
+ })
287
+
288
+ # Date filter
289
+ if from_date and to_date:
290
+ items = [
291
+ item for item in items
292
+ if item.get("date") is None or (from_date <= item["date"] <= to_date)
293
+ ]
294
+
295
+ items.sort(key=lambda x: x.get("relevance", 0), reverse=True)
296
+ return items
297
+
298
+
299
+ def enrich_with_comments(
300
+ items: List[Dict[str, Any]],
301
+ depth: str = "default",
302
+ token: Optional[str] = None,
303
+ ) -> List[Dict[str, Any]]:
304
+ """Fetch top comments for top-K items by reactions and attach to metadata.
305
+
306
+ Mutates and returns ``items``. Resolves ``token`` via env/gh CLI when
307
+ not supplied, matching ``search_github``'s fallback chain.
308
+ """
309
+ if not items:
310
+ return items
311
+ resolved_token = _resolve_token(token)
312
+ if not resolved_token:
313
+ _log("No GitHub token available for comment enrichment")
314
+ return items
315
+ return _enrich_top_items(items, depth, resolved_token)
316
+
317
+
318
+ def _enrich_top_items(
319
+ items: List[Dict[str, Any]],
320
+ depth: str,
321
+ token: str,
322
+ ) -> List[Dict[str, Any]]:
323
+ """Fetch comments for top N items by reactions."""
324
+ if not items:
325
+ return items
326
+
327
+ limit = ENRICH_LIMITS.get(depth, ENRICH_LIMITS["default"])
328
+
329
+ by_reactions = sorted(
330
+ range(len(items)),
331
+ key=lambda i: items[i].get("score", 0),
332
+ reverse=True,
333
+ )
334
+ to_enrich = by_reactions[:limit]
335
+
336
+ _log(f"Enriching top {len(to_enrich)} items with comments")
337
+
338
+ with ThreadPoolExecutor(max_workers=5) as executor:
339
+ futures = {
340
+ executor.submit(
341
+ _fetch_item_comments,
342
+ items[idx]["url"],
343
+ token,
344
+ ): idx
345
+ for idx in to_enrich
346
+ }
347
+
348
+ for future in as_completed(futures):
349
+ idx = futures[future]
350
+ try:
351
+ comments = future.result(timeout=15)
352
+ items[idx]["metadata"]["top_comments"] = comments
353
+ except (KeyError, TypeError, OSError) as exc:
354
+ _log(f"Comment enrichment failed for {items[idx].get('url', '?')}: {type(exc).__name__}: {exc}")
355
+ items[idx]["metadata"]["top_comments"] = []
356
+
357
+ return items
358
+
359
+
360
+ def _fetch_item_comments(
361
+ issue_url: str,
362
+ token: str,
363
+ max_comments: int = 5,
364
+ ) -> List[Dict[str, Any]]:
365
+ """Fetch comments for a GitHub issue/PR.
366
+
367
+ Args:
368
+ issue_url: HTML URL like https://github.com/owner/repo/issues/123
369
+ token: GitHub auth token
370
+ max_comments: Max comments to return
371
+
372
+ Returns:
373
+ List of comment dicts with score, excerpt, author.
374
+ """
375
+ path = issue_url.replace("https://github.com/", "")
376
+ path = path.replace("/pull/", "/issues/")
377
+ api_url = f"https://api.github.com/repos/{path}/comments?per_page={max_comments}&sort=reactions&direction=desc"
378
+
379
+ data = _fetch_json(api_url, token=token, timeout=15)
380
+ if not data or not isinstance(data, list):
381
+ return []
382
+
383
+ comments = []
384
+ for c in data[:max_comments]:
385
+ body = c.get("body") or ""
386
+ excerpt = body[:300] + "..." if len(body) > 300 else body
387
+ reactions = c.get("reactions", {})
388
+ reaction_count = reactions.get("total_count", 0) if isinstance(reactions, dict) else 0
389
+ author = c.get("user", {}).get("login", "") if isinstance(c.get("user"), dict) else ""
390
+
391
+ comments.append({
392
+ "score": reaction_count,
393
+ "excerpt": excerpt,
394
+ "author": author,
395
+ })
396
+
397
+ return comments
398
+
399
+
400
+ # ---------------------------------------------------------------------------
401
+ # Person-mode search: author-scoped queries, star enrichment, release notes
402
+ # ---------------------------------------------------------------------------
403
+
404
+ PERSON_DEPTH_LIMITS = {
405
+ "quick": {"pr_pages": 1, "own_repos": 3, "external_repos": 5},
406
+ "default": {"pr_pages": 1, "own_repos": 5, "external_repos": 10},
407
+ "deep": {"pr_pages": 2, "own_repos": 5, "external_repos": 15},
408
+ }
409
+
410
+
411
+ def _fetch_readme_snippet(repo: str, token: str, max_chars: int = 500) -> Optional[str]:
412
+ """Fetch README content for a repo, truncated to first ~max_chars."""
413
+ url = f"https://api.github.com/repos/{repo}/readme"
414
+ headers = {
415
+ "User-Agent": USER_AGENT,
416
+ "Accept": "application/vnd.github.raw+json",
417
+ }
418
+ if token:
419
+ headers["Authorization"] = f"Bearer {token}"
420
+
421
+ req = urllib.request.Request(url, headers=headers)
422
+ try:
423
+ with urllib.request.urlopen(req, timeout=10) as resp:
424
+ raw = resp.read().decode("utf-8", errors="replace")
425
+ except (urllib.error.HTTPError, urllib.error.URLError, OSError, TimeoutError):
426
+ return None
427
+
428
+ if not raw:
429
+ return None
430
+ # Try to break at a paragraph boundary
431
+ if len(raw) <= max_chars:
432
+ return raw
433
+ cut = raw[:max_chars]
434
+ last_double_newline = cut.rfind("\n\n")
435
+ if last_double_newline > max_chars // 3:
436
+ return cut[:last_double_newline].rstrip()
437
+ return cut.rstrip() + "..."
438
+
439
+
440
+ def _fetch_latest_releases(
441
+ repo: str, token: str, count: int = 3, max_body: int = 300,
442
+ ) -> List[Dict[str, str]]:
443
+ """Fetch latest releases for a repo."""
444
+ url = f"https://api.github.com/repos/{repo}/releases?per_page={count}"
445
+ data = _fetch_json(url, token=token, timeout=10)
446
+ if not data or not isinstance(data, list):
447
+ return []
448
+ releases = []
449
+ for r in data[:count]:
450
+ tag = r.get("tag_name", "")
451
+ date = _parse_date(r.get("published_at"))
452
+ body = (r.get("body") or "")[:max_body]
453
+ name = r.get("name") or tag
454
+ releases.append({"tag": tag, "name": name, "date": date, "body": body})
455
+ return releases
456
+
457
+
458
+ def _fetch_top_issues(repo: str, token: str) -> Dict[str, Any]:
459
+ """Fetch top feature request (by reactions) and top complaint (by comments)."""
460
+ result: Dict[str, Any] = {}
461
+
462
+ # Top feature request: issues with enhancement label, sorted by reactions
463
+ feat_q = urllib.parse.quote(f"repo:{repo} is:issue is:open label:enhancement")
464
+ feat_url = f"{SEARCH_URL}?q={feat_q}&sort=reactions&order=desc&per_page=1"
465
+ feat_data = _fetch_json(feat_url, token=token, timeout=10)
466
+ if feat_data and feat_data.get("items"):
467
+ item = feat_data["items"][0]
468
+ result["top_feature_request"] = {
469
+ "title": item.get("title", ""),
470
+ "reactions": item.get("reactions", {}).get("total_count", 0) if isinstance(item.get("reactions"), dict) else 0,
471
+ "comments": item.get("comments", 0),
472
+ "url": item.get("html_url", ""),
473
+ }
474
+ elif feat_data and feat_data.get("total_count", 0) == 0:
475
+ # No enhancement label; fall back to top issue by reactions
476
+ fallback_q = urllib.parse.quote(f"repo:{repo} is:issue is:open")
477
+ fallback_url = f"{SEARCH_URL}?q={fallback_q}&sort=reactions&order=desc&per_page=1"
478
+ fallback_data = _fetch_json(fallback_url, token=token, timeout=10)
479
+ if fallback_data and fallback_data.get("items"):
480
+ item = fallback_data["items"][0]
481
+ result["top_feature_request"] = {
482
+ "title": item.get("title", ""),
483
+ "reactions": item.get("reactions", {}).get("total_count", 0) if isinstance(item.get("reactions"), dict) else 0,
484
+ "comments": item.get("comments", 0),
485
+ "url": item.get("html_url", ""),
486
+ }
487
+
488
+ # Top complaint: most-discussed open issue (by comments)
489
+ bug_q = urllib.parse.quote(f"repo:{repo} is:issue is:open")
490
+ bug_url = f"{SEARCH_URL}?q={bug_q}&sort=comments&order=desc&per_page=1"
491
+ bug_data = _fetch_json(bug_url, token=token, timeout=10)
492
+ if bug_data and bug_data.get("items"):
493
+ item = bug_data["items"][0]
494
+ result["top_complaint"] = {
495
+ "title": item.get("title", ""),
496
+ "reactions": item.get("reactions", {}).get("total_count", 0) if isinstance(item.get("reactions"), dict) else 0,
497
+ "comments": item.get("comments", 0),
498
+ "url": item.get("html_url", ""),
499
+ }
500
+
501
+ return result
502
+
503
+
504
+ def _fetch_repo_info(repo: str, token: str) -> Optional[Dict[str, Any]]:
505
+ """Fetch repo metadata (stars, forks, description, language)."""
506
+ url = f"https://api.github.com/repos/{repo}"
507
+ data = _fetch_json(url, token=token, timeout=10)
508
+ if not data or not isinstance(data, dict):
509
+ return None
510
+ return {
511
+ "stars": data.get("stargazers_count", 0),
512
+ "forks": data.get("forks_count", 0),
513
+ "description": (data.get("description") or "")[:200],
514
+ "language": data.get("language") or "",
515
+ "open_issues": data.get("open_issues_count", 0),
516
+ }
517
+
518
+
519
+ def _format_stars(n: int) -> str:
520
+ """Format star count as human-readable (e.g., 349K, 2.9K, 42)."""
521
+ if n >= 1_000_000:
522
+ return f"{n / 1_000_000:.1f}M"
523
+ if n >= 1_000:
524
+ return f"{n / 1_000:.0f}K" if n >= 10_000 else f"{n / 1_000:.1f}K"
525
+ return str(n)
526
+
527
+
528
+ def search_github_person(
529
+ username: str,
530
+ from_date: str,
531
+ to_date: str,
532
+ depth: str = "default",
533
+ token: Optional[str] = None,
534
+ ) -> List[Dict[str, Any]]:
535
+ """Person-mode GitHub search: author-scoped queries with star enrichment.
536
+
537
+ Returns SourceItems for:
538
+ - 1 velocity summary item
539
+ - Per-repo items for top external repos (with stars + release notes)
540
+ - Per-repo items for own repos (with stars + README + top issues + releases)
541
+ """
542
+ resolved_token = _resolve_token(token)
543
+ if not resolved_token:
544
+ _log("No GitHub token available for person-mode search")
545
+ return []
546
+
547
+ limits = PERSON_DEPTH_LIMITS.get(depth, PERSON_DEPTH_LIMITS["default"])
548
+ _log(f"Person-mode search for @{username} (since {from_date})")
549
+
550
+ # Phase 1: PR velocity via search API
551
+ total_q = urllib.parse.quote(f"author:{username} type:pr created:>{from_date}")
552
+ merged_q = urllib.parse.quote(f"author:{username} type:pr is:merged created:>{from_date}")
553
+
554
+ total_url = f"{SEARCH_URL}?q={total_q}&per_page=1"
555
+ merged_url = f"{SEARCH_URL}?q={merged_q}&sort=reactions&order=desc&per_page=100"
556
+
557
+ total_data = _fetch_json(total_url, token=resolved_token, timeout=20)
558
+ merged_data = _fetch_json(merged_url, token=resolved_token, timeout=20)
559
+
560
+ total_prs = total_data.get("total_count", 0) if total_data else 0
561
+ merged_count = merged_data.get("total_count", 0) if merged_data else 0
562
+ merged_items = merged_data.get("items", []) if merged_data else []
563
+
564
+ _log(f"Found {total_prs} total PRs, {merged_count} merged")
565
+
566
+ if total_prs == 0 and merged_count == 0:
567
+ _log("No PRs found, falling back to keyword search")
568
+ return []
569
+
570
+ # Phase 2: Group merged PRs by repo
571
+ repo_pr_counts: Dict[str, int] = {}
572
+ for item in merged_items:
573
+ repo = _parse_repo_from_url(item.get("html_url", ""))
574
+ if repo:
575
+ repo_pr_counts[repo] = repo_pr_counts.get(repo, 0) + 1
576
+
577
+ # Sort repos by PR count (most active first)
578
+ sorted_repos = sorted(repo_pr_counts.items(), key=lambda x: x[1], reverse=True)
579
+
580
+ # Phase 3: Fetch own repos
581
+ own_repos_url = f"https://api.github.com/users/{username}/repos?sort=stars&per_page={limits['own_repos']}&direction=desc"
582
+ own_repos_data = _fetch_json(own_repos_url, token=resolved_token, timeout=15)
583
+ own_repo_names = set()
584
+ own_repos_info: List[Dict[str, Any]] = []
585
+ if own_repos_data and isinstance(own_repos_data, list):
586
+ for r in own_repos_data:
587
+ full_name = r.get("full_name", "")
588
+ if full_name and not r.get("fork"):
589
+ own_repo_names.add(full_name)
590
+ own_repos_info.append({
591
+ "full_name": full_name,
592
+ "stars": r.get("stargazers_count", 0),
593
+ "forks": r.get("forks_count", 0),
594
+ "description": (r.get("description") or "")[:200],
595
+ "language": r.get("language") or "",
596
+ "open_issues": r.get("open_issues_count", 0),
597
+ })
598
+
599
+ # Separate external repos from own repos
600
+ external_repos = [(repo, count) for repo, count in sorted_repos if repo not in own_repo_names]
601
+ external_repos = external_repos[:limits["external_repos"]]
602
+
603
+ # Phase 4: Parallel enrichment (star counts, releases, READMEs, top issues)
604
+ items: List[Dict[str, Any]] = []
605
+ idx = 0
606
+
607
+ # Build velocity summary
608
+ open_prs = total_prs - merged_count
609
+ merge_rate = round(100 * merged_count / total_prs) if total_prs > 0 else 0
610
+ num_repos = len(repo_pr_counts)
611
+ velocity_text = (
612
+ f"GitHub Person Profile: @{username}\n\n"
613
+ f"CONTRIBUTION VELOCITY (last {(to_date > from_date) and 30 or 30} days)\n"
614
+ f"- {merged_count} PRs merged across {num_repos} repos ({merge_rate}% merge rate)\n"
615
+ f"- {total_prs} total PRs submitted, {open_prs} still open\n"
616
+ )
617
+
618
+ idx += 1
619
+ items.append({
620
+ "id": f"GH{idx}",
621
+ "title": f"@{username}: {merged_count} PRs merged across {num_repos} repos ({merge_rate}% merge rate)",
622
+ "url": f"https://github.com/{username}",
623
+ "date": to_date,
624
+ "author": username,
625
+ "source": "github",
626
+ "score": merged_count,
627
+ "container": f"@{username}",
628
+ "snippet": velocity_text,
629
+ "relevance": 0.95,
630
+ "why_relevant": f"GitHub profile: @{username} - {merged_count} PRs merged across {num_repos} repos",
631
+ "engagement": {"merged_prs": merged_count, "comments": total_prs},
632
+ "metadata": {
633
+ "labels": ["person-profile", "velocity"],
634
+ "state": "open",
635
+ "comment_count": 0,
636
+ "reactions": merged_count,
637
+ "is_pr": False,
638
+ },
639
+ })
640
+
641
+ # Phase 5: Enrich external repos (parallel: star counts + releases)
642
+ _log(f"Enriching {len(external_repos)} external repos + {len(own_repos_info)} own repos")
643
+
644
+ with ThreadPoolExecutor(max_workers=8) as executor:
645
+ # External repo enrichment: stars + releases
646
+ ext_futures = {}
647
+ for repo, pr_count in external_repos:
648
+ ext_futures[executor.submit(_enrich_external_repo, repo, resolved_token)] = (repo, pr_count)
649
+
650
+ # Own repo enrichment: README + releases + top issues
651
+ own_futures = {}
652
+ for own_repo in own_repos_info:
653
+ own_futures[executor.submit(_enrich_own_repo, own_repo["full_name"], resolved_token)] = own_repo
654
+
655
+ # Collect external repo results
656
+ for future in as_completed(ext_futures):
657
+ repo, pr_count = ext_futures[future]
658
+ try:
659
+ enrichment = future.result(timeout=20)
660
+ except Exception as exc:
661
+ _log(f"External repo enrichment failed for {repo}: {exc}")
662
+ enrichment = {}
663
+
664
+ repo_info = enrichment.get("info")
665
+ releases = enrichment.get("releases", [])
666
+
667
+ stars = repo_info["stars"] if repo_info else 0
668
+ stars_str = _format_stars(stars)
669
+ desc = repo_info["description"] if repo_info else ""
670
+
671
+ snippet_parts = [f"Contributed {pr_count} merged PRs to {repo} ({stars_str} stars)"]
672
+ if desc:
673
+ snippet_parts.append(f" {desc}")
674
+ if releases:
675
+ for rel in releases[:2]:
676
+ body_preview = f" - {rel['body'][:150]}" if rel.get("body") else ""
677
+ snippet_parts.append(f" Latest release: {rel['name']} ({rel['date']}){body_preview}")
678
+
679
+ idx += 1
680
+ items.append({
681
+ "id": f"GH{idx}",
682
+ "title": f"{repo} ({stars_str} stars) - {pr_count} PRs merged",
683
+ "url": f"https://github.com/{repo}",
684
+ "date": releases[0]["date"] if releases and releases[0].get("date") else to_date,
685
+ "author": username,
686
+ "source": "github",
687
+ "score": stars,
688
+ "container": repo,
689
+ "snippet": "\n".join(snippet_parts),
690
+ "relevance": min(0.9, 0.6 + math.log1p(stars) / 30 + min(0.15, pr_count / 20)),
691
+ "why_relevant": f"GitHub contribution: {pr_count} PRs merged to {repo} ({stars_str} stars)",
692
+ "engagement": {"stars": stars, "comments": pr_count},
693
+ "metadata": {
694
+ "labels": ["person-profile", "external-repo"],
695
+ "state": "open",
696
+ "comment_count": pr_count,
697
+ "reactions": stars,
698
+ "is_pr": False,
699
+ },
700
+ })
701
+
702
+ # Collect own repo results
703
+ for future in as_completed(own_futures):
704
+ own_repo = own_futures[future]
705
+ try:
706
+ enrichment = future.result(timeout=25)
707
+ except Exception as exc:
708
+ _log(f"Own repo enrichment failed for {own_repo['full_name']}: {exc}")
709
+ enrichment = {}
710
+
711
+ repo_name = own_repo["full_name"]
712
+ stars = own_repo["stars"]
713
+ stars_str = _format_stars(stars)
714
+ open_issues = own_repo["open_issues"]
715
+ desc = own_repo["description"]
716
+
717
+ readme = enrichment.get("readme")
718
+ releases = enrichment.get("releases", [])
719
+ top_issues = enrichment.get("top_issues", {})
720
+
721
+ snippet_parts = [f"Own project: {repo_name} ({stars_str} stars, {open_issues} open issues)"]
722
+ if desc:
723
+ snippet_parts.append(f" {desc}")
724
+ if readme:
725
+ snippet_parts.append(f" README: {readme[:300]}")
726
+ if releases:
727
+ for rel in releases[:2]:
728
+ body_preview = f" - {rel['body'][:150]}" if rel.get("body") else ""
729
+ snippet_parts.append(f" Latest release: {rel['name']} ({rel['date']}){body_preview}")
730
+ feat = top_issues.get("top_feature_request")
731
+ if feat:
732
+ snippet_parts.append(f" Top feature request: \"{feat['title']}\" ({feat['reactions']} reactions, {feat['comments']} comments)")
733
+ complaint = top_issues.get("top_complaint")
734
+ if complaint:
735
+ snippet_parts.append(f" Top complaint: \"{complaint['title']}\" ({complaint['comments']} comments)")
736
+
737
+ idx += 1
738
+ items.append({
739
+ "id": f"GH{idx}",
740
+ "title": f"{repo_name} ({stars_str} stars) - own project, {open_issues} open issues",
741
+ "url": f"https://github.com/{repo_name}",
742
+ "date": releases[0]["date"] if releases and releases[0].get("date") else to_date,
743
+ "author": username,
744
+ "source": "github",
745
+ "score": stars,
746
+ "container": repo_name,
747
+ "snippet": "\n".join(snippet_parts),
748
+ "relevance": min(0.95, 0.7 + math.log1p(stars) / 25),
749
+ "why_relevant": f"GitHub own project: {repo_name} ({stars_str} stars)",
750
+ "engagement": {"stars": stars, "comments": open_issues},
751
+ "metadata": {
752
+ "labels": ["person-profile", "own-repo"],
753
+ "state": "open",
754
+ "comment_count": open_issues,
755
+ "reactions": stars,
756
+ "is_pr": False,
757
+ },
758
+ })
759
+
760
+ # Sort by relevance
761
+ items.sort(key=lambda x: x.get("relevance", 0), reverse=True)
762
+ _log(f"Person-mode returned {len(items)} items")
763
+ return items
764
+
765
+
766
+ def _enrich_external_repo(repo: str, token: str) -> Dict[str, Any]:
767
+ """Fetch star count + releases for an external repo."""
768
+ info = _fetch_repo_info(repo, token)
769
+ releases = _fetch_latest_releases(repo, token, count=3)
770
+ return {"info": info, "releases": releases}
771
+
772
+
773
+ def _enrich_own_repo(repo: str, token: str) -> Dict[str, Any]:
774
+ """Fetch README + releases + top issues for an own repo."""
775
+ readme = _fetch_readme_snippet(repo, token, max_chars=500)
776
+ releases = _fetch_latest_releases(repo, token, count=3)
777
+ top_issues = _fetch_top_issues(repo, token)
778
+ return {"readme": readme, "releases": releases, "top_issues": top_issues}
779
+
780
+
781
+ # ---------------------------------------------------------------------------
782
+ # Project-mode search: fetch comprehensive data for specific repos
783
+ # ---------------------------------------------------------------------------
784
+
785
+ def search_github_project(
786
+ repos: List[str],
787
+ from_date: str,
788
+ to_date: str,
789
+ depth: str = "default",
790
+ token: Optional[str] = None,
791
+ ) -> List[Dict[str, Any]]:
792
+ """Project-mode GitHub search: fetch stars, README, releases, top issues for repos.
793
+
794
+ Args:
795
+ repos: List of 'owner/repo' strings.
796
+ from_date: Start date (YYYY-MM-DD).
797
+ to_date: End date (YYYY-MM-DD).
798
+ depth: 'quick', 'default', or 'deep'.
799
+ token: Optional GitHub token.
800
+
801
+ Returns:
802
+ List of SourceItems, one per repo.
803
+ """
804
+ resolved_token = _resolve_token(token)
805
+ if not resolved_token:
806
+ _log("No GitHub token available for project-mode search")
807
+ return []
808
+
809
+ _log(f"Project-mode search for {len(repos)} repos: {', '.join(repos)}")
810
+
811
+ items: List[Dict[str, Any]] = []
812
+
813
+ with ThreadPoolExecutor(max_workers=min(8, len(repos))) as executor:
814
+ futures = {
815
+ executor.submit(_enrich_project_repo, repo, resolved_token): repo
816
+ for repo in repos
817
+ }
818
+
819
+ for idx, future in enumerate(as_completed(futures)):
820
+ repo = futures[future]
821
+ try:
822
+ enrichment = future.result(timeout=25)
823
+ except Exception as exc:
824
+ _log(f"Project enrichment failed for {repo}: {exc}")
825
+ continue
826
+
827
+ info = enrichment.get("info")
828
+ if not info:
829
+ _log(f"No repo info for {repo}, skipping")
830
+ continue
831
+
832
+ readme = enrichment.get("readme")
833
+ releases = enrichment.get("releases", [])
834
+ top_issues = enrichment.get("top_issues", {})
835
+
836
+ stars = info["stars"]
837
+ stars_str = _format_stars(stars)
838
+ open_issues = info["open_issues"]
839
+ desc = info["description"]
840
+ lang = info["language"]
841
+
842
+ snippet_parts = [f"Project: {repo} ({stars_str} stars, {open_issues} open issues, {lang})"]
843
+ if desc:
844
+ snippet_parts.append(f" {desc}")
845
+ if readme:
846
+ snippet_parts.append(f" README: {readme[:400]}")
847
+ if releases:
848
+ for rel in releases[:2]:
849
+ body_preview = f" - {rel['body'][:150]}" if rel.get("body") else ""
850
+ snippet_parts.append(f" Latest release: {rel['name']} ({rel['date']}){body_preview}")
851
+ feat = top_issues.get("top_feature_request")
852
+ if feat:
853
+ snippet_parts.append(f" Top feature request: \"{feat['title']}\" ({feat['reactions']} reactions, {feat['comments']} comments)")
854
+ complaint = top_issues.get("top_complaint")
855
+ if complaint:
856
+ snippet_parts.append(f" Top complaint: \"{complaint['title']}\" ({complaint['comments']} comments)")
857
+
858
+ items.append({
859
+ "id": f"GH{idx + 1}",
860
+ "title": f"{repo} ({stars_str} stars) - {open_issues} open issues",
861
+ "url": f"https://github.com/{repo}",
862
+ "date": releases[0]["date"] if releases and releases[0].get("date") else to_date,
863
+ "author": repo.split("/")[0],
864
+ "source": "github",
865
+ "score": stars,
866
+ "container": repo,
867
+ "snippet": "\n".join(snippet_parts),
868
+ "relevance": min(0.95, 0.7 + math.log1p(stars) / 25),
869
+ "why_relevant": f"GitHub project: {repo} ({stars_str} stars, live)",
870
+ "engagement": {"stars": stars, "comments": open_issues},
871
+ "metadata": {
872
+ "labels": ["project-mode"],
873
+ "state": "open",
874
+ "comment_count": open_issues,
875
+ "reactions": stars,
876
+ "is_pr": False,
877
+ "github_stars": {repo: stars},
878
+ },
879
+ })
880
+
881
+ items.sort(key=lambda x: x.get("relevance", 0), reverse=True)
882
+ _log(f"Project-mode returned {len(items)} items")
883
+ return items
884
+
885
+
886
+ def _enrich_project_repo(repo: str, token: str) -> Dict[str, Any]:
887
+ """Fetch all project data for a repo: info + README + releases + top issues."""
888
+ info = _fetch_repo_info(repo, token)
889
+ readme = _fetch_readme_snippet(repo, token, max_chars=500)
890
+ releases = _fetch_latest_releases(repo, token, count=3)
891
+ top_issues = _fetch_top_issues(repo, token)
892
+ return {"info": info, "readme": readme, "releases": releases, "top_issues": top_issues}
893
+
894
+
895
+ # ---------------------------------------------------------------------------
896
+ # Post-rerank star enrichment: annotate candidates with live star counts
897
+ # ---------------------------------------------------------------------------
898
+
899
+ _REPO_URL_PATTERN = re.compile(r"github\.com/([A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+)")
900
+ _SKIP_PATHS = {"topics", "search", "orgs", "settings", "features", "about", "pricing", "enterprise", "explore", "marketplace", "sponsors"}
901
+
902
+
903
+ def extract_repo_refs(candidates: List[Any]) -> List[str]:
904
+ """Extract unique owner/repo strings from candidate URLs, titles, and snippets."""
905
+ seen: set = set()
906
+ repos: List[str] = []
907
+ for c in candidates:
908
+ texts = [
909
+ getattr(c, "url", "") or "",
910
+ getattr(c, "title", "") or "",
911
+ ]
912
+ # Also check evidence snippets if available
913
+ evidence = getattr(c, "evidence", None)
914
+ if evidence:
915
+ texts.append(str(evidence))
916
+ for text in texts:
917
+ for match in _REPO_URL_PATTERN.findall(text):
918
+ # Normalize: strip trailing .git, lowercase
919
+ repo = match.rstrip(".git").lower()
920
+ owner = repo.split("/")[0]
921
+ if owner in _SKIP_PATHS:
922
+ continue
923
+ if repo not in seen:
924
+ seen.add(repo)
925
+ repos.append(match) # preserve original case
926
+ return repos
927
+
928
+
929
+ def enrich_candidates_with_stars(
930
+ candidates: List[Any],
931
+ token: Optional[str] = None,
932
+ already_enriched: Optional[set] = None,
933
+ max_repos: int = 10,
934
+ ) -> int:
935
+ """Annotate candidates with live GitHub star counts.
936
+
937
+ Returns the number of repos enriched.
938
+ """
939
+ resolved_token = _resolve_token(token)
940
+ if not resolved_token:
941
+ return 0
942
+
943
+ refs = extract_repo_refs(candidates)
944
+ if not refs:
945
+ return 0
946
+
947
+ skip = already_enriched or set()
948
+ to_fetch = [r for r in refs if r.lower() not in {s.lower() for s in skip}][:max_repos]
949
+ if not to_fetch:
950
+ return 0
951
+
952
+ _log(f"Star enrichment: fetching {len(to_fetch)} repos")
953
+
954
+ # Parallel fetch star counts
955
+ star_map: Dict[str, int] = {}
956
+ with ThreadPoolExecutor(max_workers=min(8, len(to_fetch))) as executor:
957
+ futures = {executor.submit(_fetch_repo_info, repo, resolved_token): repo for repo in to_fetch}
958
+ for future in as_completed(futures):
959
+ repo = futures[future]
960
+ try:
961
+ info = future.result(timeout=10)
962
+ if info:
963
+ star_map[repo.lower()] = info["stars"]
964
+ except Exception:
965
+ pass
966
+
967
+ if not star_map:
968
+ return 0
969
+
970
+ # Annotate candidates
971
+ enriched_count = 0
972
+ for c in candidates:
973
+ texts = [getattr(c, "url", "") or "", getattr(c, "title", "") or ""]
974
+ evidence = getattr(c, "evidence", None)
975
+ if evidence:
976
+ texts.append(str(evidence))
977
+ combined = " ".join(texts)
978
+ for match in _REPO_URL_PATTERN.findall(combined):
979
+ repo_lower = match.rstrip(".git").lower()
980
+ if repo_lower in star_map:
981
+ stars = star_map[repo_lower]
982
+ stars_str = _format_stars(stars)
983
+ # Add to metadata
984
+ if not hasattr(c, "metadata") or c.metadata is None:
985
+ continue
986
+ if "github_stars" not in c.metadata:
987
+ c.metadata["github_stars"] = {}
988
+ c.metadata["github_stars"][match] = stars
989
+ # Append to evidence if present
990
+ if hasattr(c, "evidence") and c.evidence and f"(live:" not in c.evidence:
991
+ c.evidence = c.evidence + f" (live: {stars_str} stars)"
992
+ enriched_count += 1
993
+ break # one annotation per candidate
994
+
995
+ _log(f"Star enrichment: annotated {enriched_count} candidates")
996
+ return enriched_count