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.
- package/.claude-plugin/marketplace.json +16 -0
- package/.claude-plugin/plugin.json +1 -1
- package/LICENSE +24 -0
- package/bin/install.js +7 -5
- package/commands/{luckiest/finish.md → finish.md} +2 -0
- package/commands/go.md +53 -0
- package/commands/plan.md +66 -0
- package/package.json +16 -5
- package/skills/brainstorm/ATTRIBUTION.md +27 -0
- package/skills/brainstorm/SKILL.md +139 -0
- package/skills/luckiest-ab-testing/ATTRIBUTION.md +35 -0
- package/skills/luckiest-ab-testing/CHANGELOG.md +27 -0
- package/skills/luckiest-ab-testing/SKILL.md +379 -0
- package/skills/luckiest-ab-testing/evals/evals.json +118 -0
- package/skills/luckiest-ab-testing/references/sample-size-guide.md +290 -0
- package/skills/luckiest-ab-testing/references/test-templates.md +284 -0
- package/skills/luckiest-ad-creative/ATTRIBUTION.md +35 -0
- package/skills/luckiest-ad-creative/CHANGELOG.md +23 -0
- package/skills/luckiest-ad-creative/SKILL.md +393 -0
- package/skills/luckiest-ad-creative/evals/evals.json +90 -0
- package/skills/luckiest-ad-creative/references/generative-tools.md +637 -0
- package/skills/luckiest-ad-creative/references/platform-specs.md +213 -0
- package/skills/luckiest-ads/ATTRIBUTION.md +36 -0
- package/skills/luckiest-ads/CHANGELOG.md +24 -0
- package/skills/luckiest-ads/LICENSE +21 -0
- package/skills/luckiest-ads/SKILL.md +434 -0
- package/skills/luckiest-ads/evals/evals.json +90 -0
- package/skills/luckiest-ads/references/ad-copy-templates.md +207 -0
- package/skills/luckiest-ads/references/audience-targeting.md +243 -0
- package/skills/luckiest-ads/references/conversion-tracking.md +361 -0
- package/skills/luckiest-ads/references/platform-setup-checklists.md +277 -0
- package/skills/luckiest-advisors/ATTRIBUTION.md +16 -0
- package/skills/luckiest-advisors/CHANGELOG.md +99 -0
- package/skills/luckiest-advisors/SKILL.md +151 -0
- package/skills/luckiest-aeo-grader/ATTRIBUTION.md +19 -0
- package/skills/luckiest-aeo-grader/CHANGELOG.md +52 -0
- package/skills/luckiest-aeo-grader/SKILL.md +200 -0
- package/skills/luckiest-aeo-grader/evals/evals.json +19 -0
- package/skills/luckiest-aeo-grader/references/rubric.md +72 -0
- package/skills/luckiest-aeo-grader/scripts/scan.py +265 -0
- package/skills/luckiest-ai-seo/ATTRIBUTION.md +38 -0
- package/skills/luckiest-ai-seo/CHANGELOG.md +23 -0
- package/skills/luckiest-ai-seo/SKILL.md +510 -0
- package/skills/luckiest-ai-seo/evals/evals.json +90 -0
- package/skills/luckiest-ai-seo/references/content-patterns.md +285 -0
- package/skills/luckiest-ai-seo/references/content-types.md +71 -0
- package/skills/luckiest-ai-seo/references/okf.md +104 -0
- package/skills/luckiest-ai-seo/references/platform-ranking-factors.md +154 -0
- package/skills/luckiest-analytics/ATTRIBUTION.md +42 -0
- package/skills/luckiest-analytics/CHANGELOG.md +36 -0
- package/skills/luckiest-analytics/SKILL.md +380 -0
- package/skills/luckiest-analytics/evals/evals.json +90 -0
- package/skills/luckiest-analytics/references/event-library.md +260 -0
- package/skills/luckiest-analytics/references/ga4-implementation.md +300 -0
- package/skills/luckiest-analytics/references/gtm-implementation.md +390 -0
- package/skills/luckiest-aso/ATTRIBUTION.md +40 -0
- package/skills/luckiest-aso/CHANGELOG.md +33 -0
- package/skills/luckiest-aso/SKILL.md +327 -0
- package/skills/luckiest-aso/evals/evals.json +91 -0
- package/skills/luckiest-aso/references/apple-specs.md +107 -0
- package/skills/luckiest-aso/references/benchmarks.md +129 -0
- package/skills/luckiest-aso/references/google-play-specs.md +131 -0
- package/skills/luckiest-aso/references/report-template.md +213 -0
- package/skills/luckiest-aso/references/scoring-criteria.md +213 -0
- package/skills/luckiest-churn-prevention/ATTRIBUTION.md +41 -0
- package/skills/luckiest-churn-prevention/CHANGELOG.md +24 -0
- package/skills/luckiest-churn-prevention/SKILL.md +445 -0
- package/skills/luckiest-churn-prevention/evals/evals.json +93 -0
- package/skills/luckiest-churn-prevention/references/cancel-flow-patterns.md +316 -0
- package/skills/luckiest-churn-prevention/references/dunning-playbook.md +408 -0
- package/skills/luckiest-co-marketing/ATTRIBUTION.md +38 -0
- package/skills/luckiest-co-marketing/CHANGELOG.md +25 -0
- package/skills/luckiest-co-marketing/SKILL.md +331 -0
- package/skills/luckiest-co-marketing/evals/evals.json +84 -0
- package/skills/luckiest-coder/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder/CHANGELOG.md +30 -0
- package/skills/luckiest-coder/SKILL.md +77 -0
- package/skills/luckiest-coder/references/antigravity-tools.md +23 -0
- package/skills/luckiest-coder/references/codex-tools.md +39 -0
- package/skills/luckiest-coder/references/pi-tools.md +16 -0
- package/skills/luckiest-coder-brainstorming/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-brainstorming/CHANGELOG.md +31 -0
- package/skills/luckiest-coder-brainstorming/SKILL.md +173 -0
- package/skills/luckiest-coder-brainstorming/scripts/frame-template.html +213 -0
- package/skills/luckiest-coder-brainstorming/scripts/helper.js +168 -0
- package/skills/luckiest-coder-brainstorming/scripts/server.cjs +721 -0
- package/skills/luckiest-coder-brainstorming/scripts/start-server.sh +209 -0
- package/skills/luckiest-coder-brainstorming/scripts/stop-server.sh +120 -0
- package/skills/luckiest-coder-brainstorming/spec-document-reviewer-prompt.md +49 -0
- package/skills/luckiest-coder-brainstorming/visual-companion.md +291 -0
- package/skills/luckiest-coder-consistency/ATTRIBUTION.md +30 -0
- package/skills/luckiest-coder-consistency/CHANGELOG.md +26 -0
- package/skills/luckiest-coder-consistency/SKILL.md +98 -0
- package/skills/luckiest-coder-constitution/ATTRIBUTION.md +28 -0
- package/skills/luckiest-coder-constitution/CHANGELOG.md +25 -0
- package/skills/luckiest-coder-constitution/SKILL.md +115 -0
- package/skills/luckiest-coder-debugging/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-debugging/CHANGELOG.md +22 -0
- package/skills/luckiest-coder-debugging/CREATION-LOG.md +119 -0
- package/skills/luckiest-coder-debugging/SKILL.md +309 -0
- package/skills/luckiest-coder-debugging/condition-based-waiting-example.ts +158 -0
- package/skills/luckiest-coder-debugging/condition-based-waiting.md +115 -0
- package/skills/luckiest-coder-debugging/defense-in-depth.md +122 -0
- package/skills/luckiest-coder-debugging/find-polluter.sh +63 -0
- package/skills/luckiest-coder-debugging/root-cause-tracing.md +169 -0
- package/skills/luckiest-coder-debugging/test-academic.md +14 -0
- package/skills/luckiest-coder-debugging/test-pressure-1.md +58 -0
- package/skills/luckiest-coder-debugging/test-pressure-2.md +68 -0
- package/skills/luckiest-coder-debugging/test-pressure-3.md +69 -0
- package/skills/luckiest-coder-dispatching-parallel-agents/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-dispatching-parallel-agents/CHANGELOG.md +23 -0
- package/skills/luckiest-coder-dispatching-parallel-agents/SKILL.md +198 -0
- package/skills/luckiest-coder-executing-plans/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-executing-plans/CHANGELOG.md +22 -0
- package/skills/luckiest-coder-executing-plans/SKILL.md +83 -0
- package/skills/luckiest-coder-finishing-a-branch/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-finishing-a-branch/CHANGELOG.md +22 -0
- package/skills/luckiest-coder-finishing-a-branch/SKILL.md +258 -0
- package/skills/luckiest-coder-git-worktrees/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-git-worktrees/CHANGELOG.md +22 -0
- package/skills/luckiest-coder-git-worktrees/SKILL.md +215 -0
- package/skills/luckiest-coder-guard/ATTRIBUTION.md +29 -0
- package/skills/luckiest-coder-guard/CHANGELOG.md +48 -0
- package/skills/luckiest-coder-guard/LICENSE +21 -0
- package/skills/luckiest-coder-guard/SKILL.md +126 -0
- package/skills/luckiest-coder-guard/bin/check-careful.sh +65 -0
- package/skills/luckiest-coder-guard/bin/check-freeze.sh +48 -0
- package/skills/luckiest-coder-qa/ATTRIBUTION.md +28 -0
- package/skills/luckiest-coder-qa/CHANGELOG.md +49 -0
- package/skills/luckiest-coder-qa/LICENSE +21 -0
- package/skills/luckiest-coder-qa/SKILL.md +160 -0
- package/skills/luckiest-coder-qa/references/issue-taxonomy.md +85 -0
- package/skills/luckiest-coder-qa/references/qa-report-template.md +126 -0
- package/skills/luckiest-coder-receiving-code-review/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-receiving-code-review/CHANGELOG.md +28 -0
- package/skills/luckiest-coder-receiving-code-review/SKILL.md +226 -0
- package/skills/luckiest-coder-requesting-code-review/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-requesting-code-review/CHANGELOG.md +31 -0
- package/skills/luckiest-coder-requesting-code-review/SKILL.md +118 -0
- package/skills/luckiest-coder-requesting-code-review/code-reviewer.md +172 -0
- package/skills/luckiest-coder-shipping/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-shipping/CHANGELOG.md +48 -0
- package/skills/luckiest-coder-shipping/LICENSE +21 -0
- package/skills/luckiest-coder-shipping/SKILL.md +148 -0
- package/skills/luckiest-coder-shipping/references/canary.md +44 -0
- package/skills/luckiest-coder-shipping/references/test-and-coverage.md +91 -0
- package/skills/luckiest-coder-subagent-driven-development/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-subagent-driven-development/CHANGELOG.md +28 -0
- package/skills/luckiest-coder-subagent-driven-development/SKILL.md +439 -0
- package/skills/luckiest-coder-subagent-driven-development/implementer-prompt.md +139 -0
- package/skills/luckiest-coder-subagent-driven-development/scripts/review-package +44 -0
- package/skills/luckiest-coder-subagent-driven-development/scripts/sdd-workspace +22 -0
- package/skills/luckiest-coder-subagent-driven-development/scripts/task-brief +40 -0
- package/skills/luckiest-coder-subagent-driven-development/task-reviewer-prompt.md +188 -0
- package/skills/luckiest-coder-tdd/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-tdd/CHANGELOG.md +26 -0
- package/skills/luckiest-coder-tdd/SKILL.md +384 -0
- package/skills/luckiest-coder-tdd/testing-anti-patterns.md +299 -0
- package/skills/luckiest-coder-verification/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-verification/CHANGELOG.md +22 -0
- package/skills/luckiest-coder-verification/SKILL.md +152 -0
- package/skills/luckiest-coder-writing-plans/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-writing-plans/CHANGELOG.md +22 -0
- package/skills/luckiest-coder-writing-plans/SKILL.md +191 -0
- package/skills/luckiest-coder-writing-plans/plan-document-reviewer-prompt.md +49 -0
- package/skills/luckiest-coder-writing-skills/ATTRIBUTION.md +26 -0
- package/skills/luckiest-coder-writing-skills/CHANGELOG.md +31 -0
- package/skills/luckiest-coder-writing-skills/SKILL.md +702 -0
- package/skills/luckiest-coder-writing-skills/anthropic-best-practices.md +1150 -0
- package/skills/luckiest-coder-writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
- package/skills/luckiest-coder-writing-skills/graphviz-conventions.dot +172 -0
- package/skills/luckiest-coder-writing-skills/persuasion-principles.md +187 -0
- package/skills/luckiest-coder-writing-skills/render-graphs.js +168 -0
- package/skills/luckiest-coder-writing-skills/testing-skills-with-subagents.md +384 -0
- package/skills/luckiest-cold-email/ATTRIBUTION.md +36 -0
- package/skills/luckiest-cold-email/CHANGELOG.md +24 -0
- package/skills/luckiest-cold-email/SKILL.md +213 -0
- package/skills/luckiest-cold-email/evals/evals.json +94 -0
- package/skills/luckiest-cold-email/references/benchmarks.md +83 -0
- package/skills/luckiest-cold-email/references/follow-up-sequences.md +81 -0
- package/skills/luckiest-cold-email/references/frameworks.md +90 -0
- package/skills/luckiest-cold-email/references/personalization.md +79 -0
- package/skills/luckiest-cold-email/references/subject-lines.md +53 -0
- package/skills/luckiest-community-marketing/ATTRIBUTION.md +41 -0
- package/skills/luckiest-community-marketing/CHANGELOG.md +35 -0
- package/skills/luckiest-community-marketing/SKILL.md +200 -0
- package/skills/luckiest-community-marketing/evals/evals.json +89 -0
- package/skills/luckiest-competitor-profiling/ATTRIBUTION.md +36 -0
- package/skills/luckiest-competitor-profiling/CHANGELOG.md +24 -0
- package/skills/luckiest-competitor-profiling/SKILL.md +443 -0
- package/skills/luckiest-competitor-profiling/evals/evals.json +85 -0
- package/skills/luckiest-competitor-profiling/references/templates.md +167 -0
- package/skills/luckiest-competitor-profiling/references/tool-reference.md +179 -0
- package/skills/luckiest-competitors/ATTRIBUTION.md +36 -0
- package/skills/luckiest-competitors/CHANGELOG.md +25 -0
- package/skills/luckiest-competitors/SKILL.md +171 -0
- package/skills/luckiest-competitors/evals/evals.json +93 -0
- package/skills/luckiest-competitors/references/content-architecture.md +271 -0
- package/skills/luckiest-competitors/references/templates.md +223 -0
- package/skills/luckiest-content-strategy/ATTRIBUTION.md +39 -0
- package/skills/luckiest-content-strategy/CHANGELOG.md +23 -0
- package/skills/luckiest-content-strategy/SKILL.md +395 -0
- package/skills/luckiest-content-strategy/evals/evals.json +90 -0
- package/skills/luckiest-content-strategy/references/headless-cms.md +194 -0
- package/skills/luckiest-copy-editing/ATTRIBUTION.md +41 -0
- package/skills/luckiest-copy-editing/CHANGELOG.md +31 -0
- package/skills/luckiest-copy-editing/SKILL.md +491 -0
- package/skills/luckiest-copy-editing/evals/evals.json +89 -0
- package/skills/luckiest-copy-editing/references/checklist.md +66 -0
- package/skills/luckiest-copy-editing/references/content-refresh.md +38 -0
- package/skills/luckiest-copy-editing/references/plain-english-alternatives.md +394 -0
- package/skills/luckiest-copywriting/ATTRIBUTION.md +35 -0
- package/skills/luckiest-copywriting/CHANGELOG.md +23 -0
- package/skills/luckiest-copywriting/SKILL.md +296 -0
- package/skills/luckiest-copywriting/evals/evals.json +111 -0
- package/skills/luckiest-copywriting/references/copy-frameworks.md +344 -0
- package/skills/luckiest-copywriting/references/natural-transitions.md +272 -0
- package/skills/luckiest-cro/ATTRIBUTION.md +34 -0
- package/skills/luckiest-cro/CHANGELOG.md +23 -0
- package/skills/luckiest-cro/SKILL.md +215 -0
- package/skills/luckiest-cro/evals/evals.json +111 -0
- package/skills/luckiest-cro/references/experiments.md +248 -0
- package/skills/luckiest-cro/references/form.md +422 -0
- package/skills/luckiest-customer-research/ATTRIBUTION.md +40 -0
- package/skills/luckiest-customer-research/CHANGELOG.md +26 -0
- package/skills/luckiest-customer-research/SKILL.md +293 -0
- package/skills/luckiest-customer-research/evals/evals.json +162 -0
- package/skills/luckiest-customer-research/references/source-guides.md +401 -0
- package/skills/luckiest-directory-submissions/ATTRIBUTION.md +40 -0
- package/skills/luckiest-directory-submissions/CHANGELOG.md +33 -0
- package/skills/luckiest-directory-submissions/SKILL.md +419 -0
- package/skills/luckiest-directory-submissions/evals/evals.json +94 -0
- package/skills/luckiest-directory-submissions/references/directory-list.md +477 -0
- package/skills/luckiest-directory-submissions/references/positioning-variations.md +232 -0
- package/skills/luckiest-directory-submissions/references/submission-tracker-template.csv +266 -0
- package/skills/luckiest-emails/ATTRIBUTION.md +42 -0
- package/skills/luckiest-emails/CHANGELOG.md +33 -0
- package/skills/luckiest-emails/SKILL.md +220 -0
- package/skills/luckiest-emails/evals/evals.json +93 -0
- package/skills/luckiest-emails/references/copy-guidelines.md +120 -0
- package/skills/luckiest-emails/references/email-types.md +515 -0
- package/skills/luckiest-emails/references/sequence-templates.md +168 -0
- package/skills/luckiest-extract-design-system/ATTRIBUTION.md +8 -0
- package/skills/luckiest-extract-design-system/CHANGELOG.md +37 -0
- package/skills/luckiest-extract-design-system/SKILL.md +83 -0
- package/skills/luckiest-free-tools/ATTRIBUTION.md +43 -0
- package/skills/luckiest-free-tools/CHANGELOG.md +25 -0
- package/skills/luckiest-free-tools/SKILL.md +220 -0
- package/skills/luckiest-free-tools/evals/evals.json +90 -0
- package/skills/luckiest-free-tools/references/tool-types.md +217 -0
- package/skills/luckiest-image/ATTRIBUTION.md +43 -0
- package/skills/luckiest-image/CHANGELOG.md +23 -0
- package/skills/luckiest-image/SKILL.md +376 -0
- package/skills/luckiest-image/evals/evals.json +89 -0
- package/skills/luckiest-image/references/ai-image-prompting.md +229 -0
- package/skills/luckiest-launch/ATTRIBUTION.md +40 -0
- package/skills/luckiest-launch/CHANGELOG.md +43 -0
- package/skills/luckiest-launch/SKILL.md +385 -0
- package/skills/luckiest-launch/evals/evals.json +91 -0
- package/skills/luckiest-lead-magnets/ATTRIBUTION.md +35 -0
- package/skills/luckiest-lead-magnets/CHANGELOG.md +23 -0
- package/skills/luckiest-lead-magnets/SKILL.md +331 -0
- package/skills/luckiest-lead-magnets/evals/evals.json +87 -0
- package/skills/luckiest-lead-magnets/references/benchmarks.md +129 -0
- package/skills/luckiest-lead-magnets/references/format-guide.md +196 -0
- package/skills/luckiest-marketing-ideas/ATTRIBUTION.md +39 -0
- package/skills/luckiest-marketing-ideas/CHANGELOG.md +33 -0
- package/skills/luckiest-marketing-ideas/SKILL.md +191 -0
- package/skills/luckiest-marketing-ideas/evals/evals.json +90 -0
- package/skills/luckiest-marketing-ideas/references/ideas-by-category.md +366 -0
- package/skills/luckiest-marketing-plan/ATTRIBUTION.md +40 -0
- package/skills/luckiest-marketing-plan/CHANGELOG.md +23 -0
- package/skills/luckiest-marketing-plan/SKILL.md +285 -0
- package/skills/luckiest-marketing-plan/evals/evals.json +96 -0
- package/skills/luckiest-marketing-plan/references/aarrr-framework.md +180 -0
- package/skills/luckiest-marketing-plan/references/budget-planning.md +168 -0
- package/skills/luckiest-marketing-plan/references/client-types.md +373 -0
- package/skills/luckiest-marketing-plan/references/current-state-rubric.md +255 -0
- package/skills/luckiest-marketing-plan/references/example-quietude.md +972 -0
- package/skills/luckiest-marketing-plan/references/funding-stage-unlocks.md +230 -0
- package/skills/luckiest-marketing-plan/references/growth-patterns.md +148 -0
- package/skills/luckiest-marketing-plan/references/idea-cross-reference.md +265 -0
- package/skills/luckiest-marketing-plan/references/measurement-framework.md +213 -0
- package/skills/luckiest-marketing-plan/references/methodology.md +363 -0
- package/skills/luckiest-marketing-plan/references/ops-stack-mapping.md +197 -0
- package/skills/luckiest-marketing-plan/references/plan-template.md +494 -0
- package/skills/luckiest-marketing-plan/references/team-and-agency-model.md +278 -0
- package/skills/luckiest-marketing-psychology/ATTRIBUTION.md +31 -0
- package/skills/luckiest-marketing-psychology/CHANGELOG.md +32 -0
- package/skills/luckiest-marketing-psychology/SKILL.md +202 -0
- package/skills/luckiest-marketing-psychology/evals.json +88 -0
- package/skills/luckiest-model-router/ATTRIBUTION.md +11 -0
- package/skills/luckiest-model-router/CHANGELOG.md +45 -0
- package/skills/luckiest-model-router/SKILL.md +74 -0
- package/skills/luckiest-model-router/scripts/route.py +145 -0
- package/skills/luckiest-offers/ATTRIBUTION.md +39 -0
- package/skills/luckiest-offers/CHANGELOG.md +23 -0
- package/skills/luckiest-offers/SKILL.md +167 -0
- package/skills/luckiest-offers/references/bonus-stacking.md +150 -0
- package/skills/luckiest-offers/references/examples.md +215 -0
- package/skills/luckiest-offers/references/guarantee-design.md +172 -0
- package/skills/luckiest-offers/references/offer-anatomy.md +203 -0
- package/skills/luckiest-offers/references/offer-formats.md +240 -0
- package/skills/luckiest-offers/references/scarcity-urgency.md +175 -0
- package/skills/luckiest-offers/references/value-equation.md +134 -0
- package/skills/luckiest-onboarding/ATTRIBUTION.md +43 -0
- package/skills/luckiest-onboarding/CHANGELOG.md +31 -0
- package/skills/luckiest-onboarding/SKILL.md +243 -0
- package/skills/luckiest-onboarding/references/experiments.md +258 -0
- package/skills/luckiest-paywalls/ATTRIBUTION.md +39 -0
- package/skills/luckiest-paywalls/CHANGELOG.md +25 -0
- package/skills/luckiest-paywalls/SKILL.md +256 -0
- package/skills/luckiest-paywalls/evals/evals.json +93 -0
- package/skills/luckiest-paywalls/references/experiments.md +164 -0
- package/skills/luckiest-popups/ATTRIBUTION.md +35 -0
- package/skills/luckiest-popups/CHANGELOG.md +27 -0
- package/skills/luckiest-popups/SKILL.md +477 -0
- package/skills/luckiest-popups/evals/evals.json +107 -0
- package/skills/luckiest-pricing/ATTRIBUTION.md +35 -0
- package/skills/luckiest-pricing/CHANGELOG.md +31 -0
- package/skills/luckiest-pricing/SKILL.md +283 -0
- package/skills/luckiest-pricing/evals/evals.json +90 -0
- package/skills/luckiest-pricing/references/research-methods.md +152 -0
- package/skills/luckiest-pricing/references/tier-structure.md +232 -0
- package/skills/luckiest-product-marketing/ATTRIBUTION.md +38 -0
- package/skills/luckiest-product-marketing/CHANGELOG.md +23 -0
- package/skills/luckiest-product-marketing/SKILL.md +256 -0
- package/skills/luckiest-product-marketing/evals/evals.json +85 -0
- package/skills/luckiest-programmatic-seo/ATTRIBUTION.md +35 -0
- package/skills/luckiest-programmatic-seo/CHANGELOG.md +24 -0
- package/skills/luckiest-programmatic-seo/SKILL.md +286 -0
- package/skills/luckiest-programmatic-seo/evals/evals.json +95 -0
- package/skills/luckiest-programmatic-seo/references/playbooks.md +308 -0
- package/skills/luckiest-prompt-rewrite/ATTRIBUTION.md +39 -0
- package/skills/luckiest-prompt-rewrite/CHANGELOG.md +70 -0
- package/skills/luckiest-prompt-rewrite/LICENSE +21 -0
- package/skills/luckiest-prompt-rewrite/SKILL.md +494 -0
- package/skills/luckiest-prompt-rewrite/references/patterns.md +82 -0
- package/skills/luckiest-prompt-rewrite/references/templates.md +454 -0
- package/skills/luckiest-prospecting/ATTRIBUTION.md +29 -0
- package/skills/luckiest-prospecting/CHANGELOG.md +24 -0
- package/skills/luckiest-prospecting/SKILL.md +275 -0
- package/skills/luckiest-prospecting/evals/evals.json +107 -0
- package/skills/luckiest-prospecting/references/b2b-prospecting.md +106 -0
- package/skills/luckiest-prospecting/references/compliance.md +123 -0
- package/skills/luckiest-prospecting/references/data-sources.md +287 -0
- package/skills/luckiest-prospecting/references/local-prospecting.md +165 -0
- package/skills/luckiest-prospecting/references/saas-prospecting.md +123 -0
- package/skills/luckiest-public-relations/ATTRIBUTION.md +34 -0
- package/skills/luckiest-public-relations/CHANGELOG.md +23 -0
- package/skills/luckiest-public-relations/SKILL.md +154 -0
- package/skills/luckiest-public-relations/references/journalist-pitching.md +368 -0
- package/skills/luckiest-public-relations/references/media-outlets.md +207 -0
- package/skills/luckiest-public-relations/references/newsjacking.md +218 -0
- package/skills/luckiest-public-relations/references/press-platforms.md +188 -0
- package/skills/luckiest-referrals/ATTRIBUTION.md +41 -0
- package/skills/luckiest-referrals/CHANGELOG.md +23 -0
- package/skills/luckiest-referrals/SKILL.md +292 -0
- package/skills/luckiest-referrals/evals/evals.json +90 -0
- package/skills/luckiest-referrals/references/affiliate-programs.md +167 -0
- package/skills/luckiest-referrals/references/program-examples.md +143 -0
- package/skills/luckiest-revops/ATTRIBUTION.md +40 -0
- package/skills/luckiest-revops/CHANGELOG.md +24 -0
- package/skills/luckiest-revops/SKILL.md +362 -0
- package/skills/luckiest-revops/evals/evals.json +91 -0
- package/skills/luckiest-revops/references/automation-playbooks.md +290 -0
- package/skills/luckiest-revops/references/lifecycle-definitions.md +278 -0
- package/skills/luckiest-revops/references/routing-rules.md +203 -0
- package/skills/luckiest-revops/references/scoring-models.md +247 -0
- package/skills/luckiest-sales-enablement/ATTRIBUTION.md +39 -0
- package/skills/luckiest-sales-enablement/CHANGELOG.md +23 -0
- package/skills/luckiest-sales-enablement/SKILL.md +379 -0
- package/skills/luckiest-sales-enablement/evals/evals.json +91 -0
- package/skills/luckiest-sales-enablement/references/deck-frameworks.md +263 -0
- package/skills/luckiest-sales-enablement/references/demo-scripts.md +355 -0
- package/skills/luckiest-sales-enablement/references/objection-library.md +270 -0
- package/skills/luckiest-sales-enablement/references/one-pager-templates.md +208 -0
- package/skills/luckiest-schema/ATTRIBUTION.md +39 -0
- package/skills/luckiest-schema/CHANGELOG.md +25 -0
- package/skills/luckiest-schema/SKILL.md +209 -0
- package/skills/luckiest-schema/evals/evals.json +88 -0
- package/skills/luckiest-schema/references/schema-examples.md +398 -0
- package/skills/luckiest-seo-audit/ATTRIBUTION.md +39 -0
- package/skills/luckiest-seo-audit/CHANGELOG.md +23 -0
- package/skills/luckiest-seo-audit/SKILL.md +529 -0
- package/skills/luckiest-seo-audit/evals/evals.json +136 -0
- package/skills/luckiest-seo-audit/references/ai-writing-detection.md +200 -0
- package/skills/luckiest-seo-audit/references/international-seo.md +230 -0
- package/skills/luckiest-session-handoff/ATTRIBUTION.md +14 -0
- package/skills/luckiest-session-handoff/CHANGELOG.md +30 -0
- package/skills/luckiest-session-handoff/SKILL.md +96 -0
- package/skills/luckiest-signup/ATTRIBUTION.md +48 -0
- package/skills/luckiest-signup/CHANGELOG.md +24 -0
- package/skills/luckiest-signup/SKILL.md +382 -0
- package/skills/luckiest-signup/evals/evals.json +88 -0
- package/skills/luckiest-site-architecture/ATTRIBUTION.md +38 -0
- package/skills/luckiest-site-architecture/CHANGELOG.md +23 -0
- package/skills/luckiest-site-architecture/SKILL.md +383 -0
- package/skills/luckiest-site-architecture/evals/evals.json +88 -0
- package/skills/luckiest-site-architecture/references/mermaid-templates.md +216 -0
- package/skills/luckiest-site-architecture/references/navigation-patterns.md +305 -0
- package/skills/luckiest-site-architecture/references/site-type-templates.md +293 -0
- package/skills/luckiest-sms/ATTRIBUTION.md +27 -0
- package/skills/luckiest-sms/CHANGELOG.md +24 -0
- package/skills/luckiest-sms/SKILL.md +400 -0
- package/skills/luckiest-sms/evals/evals.json +100 -0
- package/skills/luckiest-sms/references/compliance.md +202 -0
- package/skills/luckiest-sms/references/platforms.md +318 -0
- package/skills/luckiest-sms/references/sequence-templates.md +282 -0
- package/skills/luckiest-social/ATTRIBUTION.md +27 -0
- package/skills/luckiest-social/CHANGELOG.md +24 -0
- package/skills/luckiest-social/SKILL.md +430 -0
- package/skills/luckiest-social/evals/evals.json +92 -0
- package/skills/luckiest-social/references/listening-sources-template.md +123 -0
- package/skills/luckiest-social/references/listening.md +283 -0
- package/skills/luckiest-social/references/platform-limits.md +110 -0
- package/skills/luckiest-social/references/platforms.md +170 -0
- package/skills/luckiest-social/references/post-templates.md +177 -0
- package/skills/luckiest-social/references/reverse-engineering.md +195 -0
- package/skills/luckiest-social/references/short-form-video.md +237 -0
- package/skills/luckiest-thinker/ATTRIBUTION.md +16 -0
- package/skills/luckiest-thinker/CHANGELOG.md +20 -0
- package/skills/luckiest-thinker/LICENSE +21 -0
- package/skills/luckiest-thinker/SKILL.md +92 -0
- package/skills/luckiest-thinker/references/distribution-calibration.md +106 -0
- package/skills/luckiest-thinker/references/research-foundations.md +214 -0
- package/skills/luckiest-thinker/references/thinking-patterns.md +138 -0
- package/skills/luckiest-trends/.skillignore +10 -0
- package/skills/luckiest-trends/ATTRIBUTION.md +43 -0
- package/skills/luckiest-trends/CHANGELOG.md +86 -0
- package/skills/luckiest-trends/LICENSE +21 -0
- package/skills/luckiest-trends/SKILL.md +194 -0
- package/skills/luckiest-trends/agents/openai.yaml +8 -0
- package/skills/luckiest-trends/references/engine-contract.md +2041 -0
- package/skills/luckiest-trends/references/save-html-brief.md +206 -0
- package/skills/luckiest-trends/scripts/briefing.py +272 -0
- package/skills/luckiest-trends/scripts/build-skill.sh +39 -0
- package/skills/luckiest-trends/scripts/compare.sh +61 -0
- package/skills/luckiest-trends/scripts/evaluate_search_quality.py +573 -0
- package/skills/luckiest-trends/scripts/last30days.py +1467 -0
- package/skills/luckiest-trends/scripts/lib/__init__.py +1 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/__init__.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/arxiv.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/bird_x.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/bluesky.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/categories.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/cjk.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/cluster.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/dates.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/dedupe.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/digg.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/entity_extract.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/env.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/fusion.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/github.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/grounding.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/hackernews.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/hiring_signals.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/html_render.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/http.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/instagram.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/jobs.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/linkedin.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/log.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/normalize.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/permission_preflight.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/perplexity.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/pinterest.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/pipeline.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/planner.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/polymarket.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/preflight.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/providers.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/quality_nudge.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/query.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/reddit.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_arctic.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_enrich.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_keyless.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_listing.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_public.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_rss.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/reddit_shreddit.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/relevance.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/render.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/rerank.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/resolve.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/schema.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/signals.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/skill_meta.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/snippet.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/subproc.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/techmeme.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/threads.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/tiktok.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/trustpilot.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/truthsocial.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/ui.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/web_search_keyless.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/xai_x.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/xiaohongshu_api.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/xquik.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/xurl_x.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/__pycache__/youtube_yt.cpython-313.pyc +0 -0
- package/skills/luckiest-trends/scripts/lib/arxiv.py +290 -0
- package/skills/luckiest-trends/scripts/lib/bird_x.py +639 -0
- package/skills/luckiest-trends/scripts/lib/bluesky.py +323 -0
- package/skills/luckiest-trends/scripts/lib/categories.py +283 -0
- package/skills/luckiest-trends/scripts/lib/chrome_cookies.py +414 -0
- package/skills/luckiest-trends/scripts/lib/cjk.py +107 -0
- package/skills/luckiest-trends/scripts/lib/cluster.py +271 -0
- package/skills/luckiest-trends/scripts/lib/competitors.py +198 -0
- package/skills/luckiest-trends/scripts/lib/cookie_extract.py +508 -0
- package/skills/luckiest-trends/scripts/lib/dates.py +169 -0
- package/skills/luckiest-trends/scripts/lib/dedupe.py +145 -0
- package/skills/luckiest-trends/scripts/lib/digg.py +440 -0
- package/skills/luckiest-trends/scripts/lib/entity_extract.py +127 -0
- package/skills/luckiest-trends/scripts/lib/env.py +1073 -0
- package/skills/luckiest-trends/scripts/lib/fanout.py +84 -0
- package/skills/luckiest-trends/scripts/lib/fusion.py +207 -0
- package/skills/luckiest-trends/scripts/lib/github.py +996 -0
- package/skills/luckiest-trends/scripts/lib/grounding.py +331 -0
- package/skills/luckiest-trends/scripts/lib/hackernews.py +357 -0
- package/skills/luckiest-trends/scripts/lib/health.py +92 -0
- package/skills/luckiest-trends/scripts/lib/hiring_signals.py +326 -0
- package/skills/luckiest-trends/scripts/lib/html_publish.py +73 -0
- package/skills/luckiest-trends/scripts/lib/html_render.py +738 -0
- package/skills/luckiest-trends/scripts/lib/http.py +372 -0
- package/skills/luckiest-trends/scripts/lib/instagram.py +521 -0
- package/skills/luckiest-trends/scripts/lib/jobs.py +708 -0
- package/skills/luckiest-trends/scripts/lib/linkedin.py +363 -0
- package/skills/luckiest-trends/scripts/lib/log.py +35 -0
- package/skills/luckiest-trends/scripts/lib/normalize.py +759 -0
- package/skills/luckiest-trends/scripts/lib/permission_preflight.py +242 -0
- package/skills/luckiest-trends/scripts/lib/perplexity.py +745 -0
- package/skills/luckiest-trends/scripts/lib/pinterest.py +154 -0
- package/skills/luckiest-trends/scripts/lib/pipeline.py +1720 -0
- package/skills/luckiest-trends/scripts/lib/planner.py +763 -0
- package/skills/luckiest-trends/scripts/lib/polymarket.py +794 -0
- package/skills/luckiest-trends/scripts/lib/preflight.py +119 -0
- package/skills/luckiest-trends/scripts/lib/providers.py +380 -0
- package/skills/luckiest-trends/scripts/lib/quality_nudge.py +383 -0
- package/skills/luckiest-trends/scripts/lib/query.py +202 -0
- package/skills/luckiest-trends/scripts/lib/reddit.py +731 -0
- package/skills/luckiest-trends/scripts/lib/reddit_arctic.py +92 -0
- package/skills/luckiest-trends/scripts/lib/reddit_enrich.py +322 -0
- package/skills/luckiest-trends/scripts/lib/reddit_keyless.py +329 -0
- package/skills/luckiest-trends/scripts/lib/reddit_listing.py +188 -0
- package/skills/luckiest-trends/scripts/lib/reddit_public.py +275 -0
- package/skills/luckiest-trends/scripts/lib/reddit_rss.py +224 -0
- package/skills/luckiest-trends/scripts/lib/reddit_shreddit.py +184 -0
- package/skills/luckiest-trends/scripts/lib/relevance.py +200 -0
- package/skills/luckiest-trends/scripts/lib/render.py +2130 -0
- package/skills/luckiest-trends/scripts/lib/rerank.py +708 -0
- package/skills/luckiest-trends/scripts/lib/resolve.py +345 -0
- package/skills/luckiest-trends/scripts/lib/safari_cookies.py +193 -0
- package/skills/luckiest-trends/scripts/lib/schema.py +319 -0
- package/skills/luckiest-trends/scripts/lib/setup_wizard.py +843 -0
- package/skills/luckiest-trends/scripts/lib/signals.py +334 -0
- package/skills/luckiest-trends/scripts/lib/skill_meta.py +33 -0
- package/skills/luckiest-trends/scripts/lib/snippet.py +51 -0
- package/skills/luckiest-trends/scripts/lib/subproc.py +116 -0
- package/skills/luckiest-trends/scripts/lib/techmeme.py +239 -0
- package/skills/luckiest-trends/scripts/lib/threads.py +207 -0
- package/skills/luckiest-trends/scripts/lib/tiktok.py +596 -0
- package/skills/luckiest-trends/scripts/lib/transcribe.py +235 -0
- package/skills/luckiest-trends/scripts/lib/trustpilot.py +277 -0
- package/skills/luckiest-trends/scripts/lib/truthsocial.py +162 -0
- package/skills/luckiest-trends/scripts/lib/ui.py +626 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/LICENSE +21 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/bird-search.mjs +147 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/cookies.js +220 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/features.json +17 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/paginate-cursor.js +37 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/query-ids.json +20 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/runtime-features.js +151 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/runtime-query-ids.js +264 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-base.js +129 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-constants.js +50 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-features.js +347 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-search.js +157 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-types.js +2 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/lib/twitter-client-utils.js +511 -0
- package/skills/luckiest-trends/scripts/lib/vendor/bird-search/package.json +13 -0
- package/skills/luckiest-trends/scripts/lib/web_fetch_keyless.py +105 -0
- package/skills/luckiest-trends/scripts/lib/web_search_keyless.py +158 -0
- package/skills/luckiest-trends/scripts/lib/xai_x.py +236 -0
- package/skills/luckiest-trends/scripts/lib/xiaohongshu_api.py +162 -0
- package/skills/luckiest-trends/scripts/lib/xquik.py +404 -0
- package/skills/luckiest-trends/scripts/lib/xurl_x.py +171 -0
- package/skills/luckiest-trends/scripts/lib/youtube_yt.py +1365 -0
- package/skills/luckiest-trends/scripts/setup-keychain.sh +123 -0
- package/skills/luckiest-trends/scripts/setup-pass.sh +132 -0
- package/skills/luckiest-trends/scripts/store.py +1020 -0
- package/skills/luckiest-trends/scripts/test-v1-vs-v2.sh +220 -0
- package/skills/luckiest-trends/scripts/test_device_auth.py +128 -0
- package/skills/luckiest-trends/scripts/verify_v3.py +195 -0
- package/skills/luckiest-trends/scripts/watchlist.py +318 -0
- package/skills/luckiest-video/ATTRIBUTION.md +27 -0
- package/skills/luckiest-video/CHANGELOG.md +23 -0
- package/skills/luckiest-video/SKILL.md +371 -0
- package/skills/luckiest-video/evals/evals.json +88 -0
- package/skills/luckiest-video/references/ai-video-prompting.md +175 -0
- package/skills/remix/SKILL.md +32 -0
- package/commands/luckiest/go.md +0 -45
- package/commands/luckiest/plan.md +0 -55
- /package/commands/{luckiest/charms.md → charms.md} +0 -0
- /package/commands/{luckiest/helpers.md → helpers.md} +0 -0
- /package/commands/{luckiest/home.md → home.md} +0 -0
- /package/commands/{luckiest/leaderboard.md → leaderboard.md} +0 -0
- /package/commands/{luckiest/merge.md → merge.md} +0 -0
- /package/commands/{luckiest/overlaps.md → overlaps.md} +0 -0
- /package/commands/{luckiest/skills.md → skills.md} +0 -0
- /package/commands/{luckiest/start.md → start.md} +0 -0
- /package/commands/{luckiest/status.md → status.md} +0 -0
- /package/commands/{luckiest/updates.md → updates.md} +0 -0
- /package/commands/{luckiest/vouch.md → vouch.md} +0 -0
- /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
|