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,145 @@
|
|
|
1
|
+
"""Within-source near-duplicate detection."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import re
|
|
6
|
+
|
|
7
|
+
from . import cjk, schema
|
|
8
|
+
|
|
9
|
+
STOPWORDS = frozenset(
|
|
10
|
+
{
|
|
11
|
+
"the",
|
|
12
|
+
"a",
|
|
13
|
+
"an",
|
|
14
|
+
"to",
|
|
15
|
+
"for",
|
|
16
|
+
"how",
|
|
17
|
+
"is",
|
|
18
|
+
"in",
|
|
19
|
+
"of",
|
|
20
|
+
"on",
|
|
21
|
+
"and",
|
|
22
|
+
"with",
|
|
23
|
+
"from",
|
|
24
|
+
"by",
|
|
25
|
+
"at",
|
|
26
|
+
"this",
|
|
27
|
+
"that",
|
|
28
|
+
"it",
|
|
29
|
+
"what",
|
|
30
|
+
"are",
|
|
31
|
+
"do",
|
|
32
|
+
"can",
|
|
33
|
+
}
|
|
34
|
+
) | cjk.CHINESE_STOPWORDS
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def normalize_text(text: str) -> str:
|
|
38
|
+
text = re.sub(r"[^\w\s]", " ", text.lower())
|
|
39
|
+
return re.sub(r"\s+", " ", text).strip()
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
def _ngrams_of_normalized(norm: str, n: int = 3) -> set[str]:
|
|
43
|
+
if len(norm) < n:
|
|
44
|
+
return {norm} if norm else set()
|
|
45
|
+
return {norm[index:index + n] for index in range(len(norm) - n + 1)}
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def get_ngrams(text: str, n: int = 3) -> set[str]:
|
|
49
|
+
return _ngrams_of_normalized(normalize_text(text), n)
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def jaccard_similarity(left: set[str], right: set[str]) -> float:
|
|
53
|
+
if not left or not right:
|
|
54
|
+
return 0.0
|
|
55
|
+
union = left | right
|
|
56
|
+
if not union:
|
|
57
|
+
return 0.0
|
|
58
|
+
return len(left & right) / len(union)
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def token_jaccard(text_a: str, text_b: str) -> float:
|
|
62
|
+
tokens_a = {
|
|
63
|
+
token
|
|
64
|
+
for token in cjk.segment(normalize_text(text_a))
|
|
65
|
+
if len(token) > 1 and token not in STOPWORDS
|
|
66
|
+
}
|
|
67
|
+
tokens_b = {
|
|
68
|
+
token
|
|
69
|
+
for token in cjk.segment(normalize_text(text_b))
|
|
70
|
+
if len(token) > 1 and token not in STOPWORDS
|
|
71
|
+
}
|
|
72
|
+
return jaccard_similarity(tokens_a, tokens_b)
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
def hybrid_similarity(text_a: str, text_b: str) -> float:
|
|
76
|
+
return max(
|
|
77
|
+
jaccard_similarity(get_ngrams(text_a), get_ngrams(text_b)),
|
|
78
|
+
token_jaccard(text_a, text_b),
|
|
79
|
+
)
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
def _tokenize(normalized: str) -> frozenset[str]:
|
|
83
|
+
return frozenset(
|
|
84
|
+
tok for tok in cjk.segment(normalized)
|
|
85
|
+
if len(tok) > 1 and tok not in STOPWORDS
|
|
86
|
+
)
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
class _PreparedText:
|
|
90
|
+
"""Pre-computed text representations for fast repeated similarity checks."""
|
|
91
|
+
|
|
92
|
+
__slots__ = ("ngrams", "tokens")
|
|
93
|
+
|
|
94
|
+
def __init__(self, raw: str) -> None:
|
|
95
|
+
norm = normalize_text(raw)
|
|
96
|
+
self.ngrams = _ngrams_of_normalized(norm)
|
|
97
|
+
self.tokens = _tokenize(norm)
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
def prepared_similarity(a: _PreparedText, b: _PreparedText) -> float:
|
|
101
|
+
return max(
|
|
102
|
+
jaccard_similarity(a.ngrams, b.ngrams),
|
|
103
|
+
jaccard_similarity(a.tokens, b.tokens),
|
|
104
|
+
)
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
def item_text(item: schema.SourceItem) -> str:
|
|
108
|
+
parts = [item.title, item.body, item.author or "", item.container or ""]
|
|
109
|
+
return " ".join(part for part in parts if part).strip()
|
|
110
|
+
|
|
111
|
+
|
|
112
|
+
def dedupe_items(items: list[schema.SourceItem], threshold: float = 0.7) -> list[schema.SourceItem]:
|
|
113
|
+
"""Remove near-duplicates while keeping earlier, better-scored items.
|
|
114
|
+
|
|
115
|
+
Jobs are deduped by exact URL only: distinct postings on the same careers
|
|
116
|
+
board share heavy boilerplate (company intro, "TL;DR", benefits) that trips
|
|
117
|
+
fuzzy text similarity and collapses unrelated roles (a 26-role board fell to
|
|
118
|
+
7). A unique posting URL is an unambiguous identity, so use it instead.
|
|
119
|
+
"""
|
|
120
|
+
kept: list[schema.SourceItem] = []
|
|
121
|
+
kept_prepared: list[_PreparedText] = []
|
|
122
|
+
seen_job_urls: set[str] = set()
|
|
123
|
+
for item in items:
|
|
124
|
+
if item.source == "jobs":
|
|
125
|
+
url = (item.url or "").strip()
|
|
126
|
+
if url and url in seen_job_urls:
|
|
127
|
+
continue
|
|
128
|
+
if url:
|
|
129
|
+
seen_job_urls.add(url)
|
|
130
|
+
kept.append(item)
|
|
131
|
+
continue
|
|
132
|
+
text = item_text(item)
|
|
133
|
+
if not text:
|
|
134
|
+
kept.append(item)
|
|
135
|
+
continue
|
|
136
|
+
prep = _PreparedText(text)
|
|
137
|
+
is_duplicate = False
|
|
138
|
+
for existing_prep in kept_prepared:
|
|
139
|
+
if prepared_similarity(prep, existing_prep) >= threshold:
|
|
140
|
+
is_duplicate = True
|
|
141
|
+
break
|
|
142
|
+
if not is_duplicate:
|
|
143
|
+
kept.append(item)
|
|
144
|
+
kept_prepared.append(prep)
|
|
145
|
+
return kept
|
|
@@ -0,0 +1,440 @@
|
|
|
1
|
+
"""Digg AI 1000 source for last30days.
|
|
2
|
+
|
|
3
|
+
Shells out to ``digg-pp-cli`` (read-only, no auth required) to surface
|
|
4
|
+
clustered stories curated from ~1000 high-signal AI accounts on X. Each
|
|
5
|
+
cluster carries a published TLDR, a curatorial rank, and a list of X
|
|
6
|
+
posts that can be fetched as inline quotes.
|
|
7
|
+
|
|
8
|
+
Activation gate: this source is only available when ``digg-pp-cli`` is
|
|
9
|
+
on PATH. ``pipeline.available_sources`` checks ``shutil.which`` before
|
|
10
|
+
including ``digg`` in the source list. The functions below also detect
|
|
11
|
+
the missing-binary case as a defensive fallback.
|
|
12
|
+
|
|
13
|
+
Primary path: ``digg-pp-cli search <topic> --since 30d --agent --limit N``.
|
|
14
|
+
Optional enrichment: ``digg-pp-cli posts <clusterUrlId> --agent --by rank
|
|
15
|
+
--limit M`` for the top K clusters in default/deep depth, attaching the
|
|
16
|
+
top-ranked X posts to each cluster's ``posts`` field.
|
|
17
|
+
"""
|
|
18
|
+
|
|
19
|
+
from __future__ import annotations
|
|
20
|
+
|
|
21
|
+
import json
|
|
22
|
+
import shutil
|
|
23
|
+
from datetime import datetime, timedelta, timezone
|
|
24
|
+
from typing import Any, Dict, List, Optional
|
|
25
|
+
from urllib.parse import urlparse
|
|
26
|
+
|
|
27
|
+
from . import log, subproc
|
|
28
|
+
from .relevance import token_overlap_relevance
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
CLI_BIN = "digg-pp-cli"
|
|
32
|
+
|
|
33
|
+
# Per-depth knobs.
|
|
34
|
+
DEPTH_CONFIG = {
|
|
35
|
+
"quick": 8,
|
|
36
|
+
"default": 20,
|
|
37
|
+
"deep": 40,
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
# How many top-ranked clusters get post enrichment, per depth. Quick mode
|
|
41
|
+
# skips enrichment to keep latency low (clusters already carry a TLDR).
|
|
42
|
+
ENRICH_CONFIG = {
|
|
43
|
+
"quick": 0,
|
|
44
|
+
"default": 3,
|
|
45
|
+
"deep": 5,
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
# X posts pulled per enriched cluster. Matches the 5-comment cap used by
|
|
49
|
+
# Reddit/HN/YouTube/TikTok/GitHub enrichment.
|
|
50
|
+
POSTS_PER_CLUSTER = 5
|
|
51
|
+
|
|
52
|
+
SEARCH_TIMEOUT = 30
|
|
53
|
+
POSTS_TIMEOUT = 15
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
def _log(msg: str) -> None:
|
|
57
|
+
log.source_log("Digg", msg, tty_only=False)
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
def _is_available() -> bool:
|
|
61
|
+
"""True when the digg-pp-cli binary is on PATH."""
|
|
62
|
+
return shutil.which(CLI_BIN) is not None
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
def _today() -> datetime:
|
|
66
|
+
return datetime.now(timezone.utc)
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
def _parse_first_post_age(age: Optional[str], today: Optional[datetime] = None) -> Optional[str]:
|
|
70
|
+
"""Convert a digg firstPostAge token (e.g. '5d', '17d', '5h', '1w', '1m')
|
|
71
|
+
into a YYYY-MM-DD string. Returns None when the value is outside the
|
|
72
|
+
last-30-day window or cannot be parsed.
|
|
73
|
+
|
|
74
|
+
Digg uses minutes-symbol-collision for 'months' (per agent-context:
|
|
75
|
+
'Nh, Nd, Nw, Nm (e.g. 30d, 1w, 12h, 1m)'), so 'Nm' is months ~30 days.
|
|
76
|
+
"""
|
|
77
|
+
if not age or not isinstance(age, str):
|
|
78
|
+
return None
|
|
79
|
+
age = age.strip().lower()
|
|
80
|
+
if len(age) < 2:
|
|
81
|
+
return None
|
|
82
|
+
unit = age[-1]
|
|
83
|
+
try:
|
|
84
|
+
amount = int(age[:-1])
|
|
85
|
+
except (ValueError, TypeError):
|
|
86
|
+
return None
|
|
87
|
+
if amount < 0:
|
|
88
|
+
return None
|
|
89
|
+
|
|
90
|
+
base = today or _today()
|
|
91
|
+
|
|
92
|
+
if unit == "h":
|
|
93
|
+
delta = timedelta(hours=amount)
|
|
94
|
+
elif unit == "d":
|
|
95
|
+
delta = timedelta(days=amount)
|
|
96
|
+
elif unit == "w":
|
|
97
|
+
delta = timedelta(weeks=amount)
|
|
98
|
+
elif unit == "m":
|
|
99
|
+
delta = timedelta(days=amount * 30)
|
|
100
|
+
else:
|
|
101
|
+
return None
|
|
102
|
+
|
|
103
|
+
if delta > timedelta(days=30):
|
|
104
|
+
return None
|
|
105
|
+
|
|
106
|
+
point = base - delta
|
|
107
|
+
return point.date().isoformat()
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
def _build_search_args(query: str, limit: int) -> List[str]:
|
|
111
|
+
return [
|
|
112
|
+
CLI_BIN,
|
|
113
|
+
"search",
|
|
114
|
+
query,
|
|
115
|
+
"--since",
|
|
116
|
+
"30d",
|
|
117
|
+
"--agent",
|
|
118
|
+
"--limit",
|
|
119
|
+
str(limit),
|
|
120
|
+
]
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
def _build_posts_args(cluster_url_id: str, posts_per: int) -> List[str]:
|
|
124
|
+
return [
|
|
125
|
+
CLI_BIN,
|
|
126
|
+
"posts",
|
|
127
|
+
cluster_url_id,
|
|
128
|
+
"--agent",
|
|
129
|
+
"--by",
|
|
130
|
+
"rank",
|
|
131
|
+
"--limit",
|
|
132
|
+
str(posts_per),
|
|
133
|
+
]
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
def _run_cli(cmd: List[str], timeout: int) -> Dict[str, Any]:
|
|
137
|
+
"""Invoke digg-pp-cli and parse the JSON envelope.
|
|
138
|
+
|
|
139
|
+
Returns ``{"results": [...]}`` on success, ``{"results": [], "error": "..."}``
|
|
140
|
+
on failure. Never raises; the pipeline relies on shape consistency.
|
|
141
|
+
"""
|
|
142
|
+
if not _is_available():
|
|
143
|
+
return {"results": [], "error": f"{CLI_BIN} not on PATH"}
|
|
144
|
+
try:
|
|
145
|
+
result = subproc.run_with_timeout(cmd, timeout=timeout)
|
|
146
|
+
except subproc.SubprocTimeout as exc:
|
|
147
|
+
_log(f"Timeout: {exc}")
|
|
148
|
+
return {"results": [], "error": str(exc)}
|
|
149
|
+
except FileNotFoundError as exc:
|
|
150
|
+
_log(f"Binary missing: {exc}")
|
|
151
|
+
return {"results": [], "error": str(exc)}
|
|
152
|
+
except OSError as exc:
|
|
153
|
+
_log(f"Spawn failed: {exc}")
|
|
154
|
+
return {"results": [], "error": str(exc)}
|
|
155
|
+
|
|
156
|
+
if result.returncode != 0:
|
|
157
|
+
snippet = (result.stderr or "").strip().splitlines()[:1]
|
|
158
|
+
first = snippet[0] if snippet else f"exit {result.returncode}"
|
|
159
|
+
_log(f"CLI exit {result.returncode}: {first}")
|
|
160
|
+
return {"results": [], "error": first}
|
|
161
|
+
|
|
162
|
+
stdout = result.stdout or ""
|
|
163
|
+
if not stdout.strip():
|
|
164
|
+
return {"results": []}
|
|
165
|
+
try:
|
|
166
|
+
data = json.loads(stdout)
|
|
167
|
+
except json.JSONDecodeError as exc:
|
|
168
|
+
_log(f"JSON decode failed: {exc}")
|
|
169
|
+
return {"results": [], "error": f"json decode: {exc}"}
|
|
170
|
+
|
|
171
|
+
if not isinstance(data, dict):
|
|
172
|
+
return {"results": []}
|
|
173
|
+
results = data.get("results")
|
|
174
|
+
if not isinstance(results, list):
|
|
175
|
+
return {"results": []}
|
|
176
|
+
return data
|
|
177
|
+
|
|
178
|
+
|
|
179
|
+
def search_digg(
|
|
180
|
+
topic: str,
|
|
181
|
+
from_date: str,
|
|
182
|
+
to_date: str,
|
|
183
|
+
depth: str = "default",
|
|
184
|
+
) -> Dict[str, Any]:
|
|
185
|
+
"""Search Digg AI 1000 clusters via digg-pp-cli.
|
|
186
|
+
|
|
187
|
+
Args:
|
|
188
|
+
topic: search query.
|
|
189
|
+
from_date: YYYY-MM-DD start (advisory; --since 30d is the actual filter).
|
|
190
|
+
to_date: YYYY-MM-DD end (advisory; same).
|
|
191
|
+
depth: 'quick' | 'default' | 'deep'.
|
|
192
|
+
|
|
193
|
+
Returns:
|
|
194
|
+
Dict with ``results`` list. On failure, ``results`` is empty and an
|
|
195
|
+
``error`` key carries a one-line description.
|
|
196
|
+
"""
|
|
197
|
+
limit = DEPTH_CONFIG.get(depth, DEPTH_CONFIG["default"])
|
|
198
|
+
if not topic or not topic.strip():
|
|
199
|
+
return {"results": []}
|
|
200
|
+
cmd = _build_search_args(topic, limit)
|
|
201
|
+
_log(f"search '{topic}' (limit={limit}, since=30d)")
|
|
202
|
+
response = _run_cli(cmd, timeout=SEARCH_TIMEOUT)
|
|
203
|
+
n = len(response.get("results") or [])
|
|
204
|
+
_log(f"found {n} clusters")
|
|
205
|
+
return response
|
|
206
|
+
|
|
207
|
+
|
|
208
|
+
def _build_url(cluster_url_id: str) -> str:
|
|
209
|
+
return f"https://di.gg/ai/{cluster_url_id}"
|
|
210
|
+
|
|
211
|
+
|
|
212
|
+
def _rank_score(rank: Optional[int]) -> float:
|
|
213
|
+
"""Convert Digg rank (lower is better, top 50 are notable) into a
|
|
214
|
+
positive engagement-style signal in [0, 50]. Anything off the top-50
|
|
215
|
+
leaderboard contributes 0.
|
|
216
|
+
"""
|
|
217
|
+
if rank is None:
|
|
218
|
+
return 0.0
|
|
219
|
+
try:
|
|
220
|
+
r = int(rank)
|
|
221
|
+
except (TypeError, ValueError):
|
|
222
|
+
return 0.0
|
|
223
|
+
if r < 1 or r > 50:
|
|
224
|
+
return 0.0
|
|
225
|
+
return float(51 - r)
|
|
226
|
+
|
|
227
|
+
|
|
228
|
+
def parse_digg_response(
|
|
229
|
+
response: Dict[str, Any],
|
|
230
|
+
query: str = "",
|
|
231
|
+
) -> List[Dict[str, Any]]:
|
|
232
|
+
"""Parse a digg search envelope into normalized item dicts.
|
|
233
|
+
|
|
234
|
+
Args:
|
|
235
|
+
response: payload from ``search_digg``.
|
|
236
|
+
query: original search query, used for token-overlap relevance.
|
|
237
|
+
|
|
238
|
+
Returns:
|
|
239
|
+
List of dicts ready for ``normalize._normalize_digg``.
|
|
240
|
+
"""
|
|
241
|
+
raw = response.get("results") if isinstance(response, dict) else None
|
|
242
|
+
if not isinstance(raw, list):
|
|
243
|
+
return []
|
|
244
|
+
|
|
245
|
+
items: List[Dict[str, Any]] = []
|
|
246
|
+
for i, cluster in enumerate(raw):
|
|
247
|
+
if not isinstance(cluster, dict):
|
|
248
|
+
continue
|
|
249
|
+
cluster_url_id = cluster.get("clusterUrlId")
|
|
250
|
+
if not cluster_url_id:
|
|
251
|
+
continue
|
|
252
|
+
|
|
253
|
+
title = str(cluster.get("title") or "").strip()
|
|
254
|
+
tldr = str(cluster.get("tldr") or "").strip()
|
|
255
|
+
rank = cluster.get("rank")
|
|
256
|
+
post_count = cluster.get("postCount") or 0
|
|
257
|
+
unique_authors = cluster.get("uniqueAuthors") or 0
|
|
258
|
+
first_post_age = cluster.get("firstPostAge")
|
|
259
|
+
date_str = _parse_first_post_age(first_post_age)
|
|
260
|
+
if date_str is None and first_post_age:
|
|
261
|
+
# firstPostAge present but outside 30d -> drop; last30days contract.
|
|
262
|
+
continue
|
|
263
|
+
|
|
264
|
+
rank_decay = max(0.3, 1.0 - (i * 0.02))
|
|
265
|
+
if query:
|
|
266
|
+
content_score = token_overlap_relevance(query, f"{title} {tldr}".strip())
|
|
267
|
+
else:
|
|
268
|
+
content_score = 0.5
|
|
269
|
+
rank_boost = min(0.2, _rank_score(rank) / 250.0)
|
|
270
|
+
relevance = min(1.0, 0.55 * rank_decay + 0.35 * content_score + rank_boost)
|
|
271
|
+
|
|
272
|
+
items.append(
|
|
273
|
+
{
|
|
274
|
+
"id": str(cluster_url_id),
|
|
275
|
+
"title": title or f"Digg cluster {i + 1}",
|
|
276
|
+
"url": _build_url(str(cluster_url_id)),
|
|
277
|
+
"tldr": tldr,
|
|
278
|
+
"author": "",
|
|
279
|
+
"date": date_str,
|
|
280
|
+
"engagement": {
|
|
281
|
+
"postCount": int(post_count) if isinstance(post_count, (int, float)) else 0,
|
|
282
|
+
"uniqueAuthors": int(unique_authors) if isinstance(unique_authors, (int, float)) else 0,
|
|
283
|
+
"rank": int(rank) if isinstance(rank, (int, float)) else None,
|
|
284
|
+
"rank_score": _rank_score(rank),
|
|
285
|
+
},
|
|
286
|
+
"first_post_age": first_post_age,
|
|
287
|
+
"posts": [],
|
|
288
|
+
"relevance": round(relevance, 2),
|
|
289
|
+
"why_relevant": (
|
|
290
|
+
f"Digg cluster (rank {rank}, {post_count} posts, {unique_authors} authors)"
|
|
291
|
+
if rank is not None
|
|
292
|
+
else f"Digg cluster ({post_count} posts, {unique_authors} authors)"
|
|
293
|
+
),
|
|
294
|
+
}
|
|
295
|
+
)
|
|
296
|
+
|
|
297
|
+
return items
|
|
298
|
+
|
|
299
|
+
|
|
300
|
+
def _is_safe_http_url(url: str) -> bool:
|
|
301
|
+
"""True iff ``url`` parses with an http or https scheme.
|
|
302
|
+
|
|
303
|
+
Used to reject upstream-supplied post URLs whose scheme would be
|
|
304
|
+
dangerous in a rendered ``<a href>`` (``javascript:``, ``data:``,
|
|
305
|
+
``file:``, ``vbscript:``, ``about:``).
|
|
306
|
+
"""
|
|
307
|
+
try:
|
|
308
|
+
scheme = urlparse(url).scheme.lower()
|
|
309
|
+
except ValueError:
|
|
310
|
+
return False
|
|
311
|
+
return scheme in ("http", "https")
|
|
312
|
+
|
|
313
|
+
|
|
314
|
+
def _parse_post(raw_post: Dict[str, Any]) -> Optional[Dict[str, Any]]:
|
|
315
|
+
"""Reduce a digg post payload into the small dict render uses.
|
|
316
|
+
|
|
317
|
+
We deliberately keep this minimal: an inline quote needs the author
|
|
318
|
+
handle, the body, the post type, and the X URL.
|
|
319
|
+
"""
|
|
320
|
+
if not isinstance(raw_post, dict):
|
|
321
|
+
return None
|
|
322
|
+
body = str(raw_post.get("body") or "").strip()
|
|
323
|
+
if not body:
|
|
324
|
+
return None
|
|
325
|
+
author = raw_post.get("author") or {}
|
|
326
|
+
if not isinstance(author, dict):
|
|
327
|
+
author = {}
|
|
328
|
+
username = str(author.get("username") or "").strip()
|
|
329
|
+
if not username:
|
|
330
|
+
return None
|
|
331
|
+
x_url = str(raw_post.get("xUrl") or "").strip()
|
|
332
|
+
if not x_url:
|
|
333
|
+
return None
|
|
334
|
+
if not _is_safe_http_url(x_url):
|
|
335
|
+
# Security-class drop: an upstream-supplied URL with a dangerous
|
|
336
|
+
# scheme. Force tty_only=False so the rejection is visible in
|
|
337
|
+
# non-interactive runs (Claude Code), which is the actual attack
|
|
338
|
+
# surface — the default tty_only=True would suppress it there.
|
|
339
|
+
log.source_log(
|
|
340
|
+
"Digg",
|
|
341
|
+
f"dropped post with unsafe xUrl scheme: {x_url!r}",
|
|
342
|
+
tty_only=False,
|
|
343
|
+
)
|
|
344
|
+
return None
|
|
345
|
+
return {
|
|
346
|
+
"username": username,
|
|
347
|
+
"display_name": str(author.get("display_name") or "").strip() or username,
|
|
348
|
+
"category": str(author.get("category") or "").strip(),
|
|
349
|
+
"rank": author.get("rank"),
|
|
350
|
+
"body": body,
|
|
351
|
+
"post_type": str(raw_post.get("post_type") or "tweet").strip(),
|
|
352
|
+
"x_url": x_url,
|
|
353
|
+
"posted_at": raw_post.get("posted_at"),
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
|
|
357
|
+
def fetch_top_posts(cluster_url_id: str, posts_per: int = POSTS_PER_CLUSTER) -> List[Dict[str, Any]]:
|
|
358
|
+
"""Fetch top-ranked X posts attached to a cluster.
|
|
359
|
+
|
|
360
|
+
Returns an empty list on any failure (timeout, missing cluster, JSON
|
|
361
|
+
error). Never raises.
|
|
362
|
+
"""
|
|
363
|
+
if posts_per <= 0:
|
|
364
|
+
return []
|
|
365
|
+
cmd = _build_posts_args(cluster_url_id, posts_per)
|
|
366
|
+
response = _run_cli(cmd, timeout=POSTS_TIMEOUT)
|
|
367
|
+
raw = response.get("results") or []
|
|
368
|
+
out: List[Dict[str, Any]] = []
|
|
369
|
+
for entry in raw:
|
|
370
|
+
post = _parse_post(entry)
|
|
371
|
+
if post is not None:
|
|
372
|
+
out.append(post)
|
|
373
|
+
return out
|
|
374
|
+
|
|
375
|
+
|
|
376
|
+
def enrich_with_top_posts(
|
|
377
|
+
items: List[Dict[str, Any]],
|
|
378
|
+
top_k: int = 3,
|
|
379
|
+
posts_per: int = POSTS_PER_CLUSTER,
|
|
380
|
+
) -> List[Dict[str, Any]]:
|
|
381
|
+
"""Attach top X posts to the first ``top_k`` clusters by Digg rank order.
|
|
382
|
+
|
|
383
|
+
Mutates and returns the same list. Items that already have posts, or
|
|
384
|
+
whose ``postCount`` is 0, are skipped.
|
|
385
|
+
"""
|
|
386
|
+
if top_k <= 0 or posts_per <= 0:
|
|
387
|
+
return items
|
|
388
|
+
enriched = 0
|
|
389
|
+
for item in items:
|
|
390
|
+
if enriched >= top_k:
|
|
391
|
+
break
|
|
392
|
+
if item.get("posts"):
|
|
393
|
+
continue
|
|
394
|
+
engagement = item.get("engagement") or {}
|
|
395
|
+
if not engagement.get("postCount"):
|
|
396
|
+
continue
|
|
397
|
+
cluster_url_id = item.get("id")
|
|
398
|
+
if not cluster_url_id:
|
|
399
|
+
continue
|
|
400
|
+
posts = fetch_top_posts(str(cluster_url_id), posts_per=posts_per)
|
|
401
|
+
item["posts"] = posts
|
|
402
|
+
enriched += 1
|
|
403
|
+
if enriched:
|
|
404
|
+
_log(f"enriched {enriched} clusters with X posts")
|
|
405
|
+
return items
|
|
406
|
+
|
|
407
|
+
|
|
408
|
+
def enrich_source_items(items: list, top_k: int = 3, posts_per: int = POSTS_PER_CLUSTER) -> list:
|
|
409
|
+
"""Attach top X posts to the first ``top_k`` SourceItems that survived dedupe.
|
|
410
|
+
|
|
411
|
+
Reads ``metadata['clusterUrlId']`` and writes ``metadata['posts']`` in
|
|
412
|
+
place. Skips items that already carry a non-empty ``metadata['posts']``,
|
|
413
|
+
items whose engagement ``postCount`` is 0, and items whose source is not
|
|
414
|
+
'digg'. Designed to run from `_finalize_items_by_source` so enrichment
|
|
415
|
+
is spent on the items the brief actually shows.
|
|
416
|
+
"""
|
|
417
|
+
if top_k <= 0 or posts_per <= 0:
|
|
418
|
+
return items
|
|
419
|
+
enriched = 0
|
|
420
|
+
for item in items:
|
|
421
|
+
if enriched >= top_k:
|
|
422
|
+
break
|
|
423
|
+
if getattr(item, "source", None) != "digg":
|
|
424
|
+
continue
|
|
425
|
+
metadata = getattr(item, "metadata", None) or {}
|
|
426
|
+
if metadata.get("posts"):
|
|
427
|
+
continue
|
|
428
|
+
engagement = getattr(item, "engagement", None) or {}
|
|
429
|
+
if not engagement.get("postCount"):
|
|
430
|
+
continue
|
|
431
|
+
cluster_url_id = metadata.get("clusterUrlId") or item.item_id
|
|
432
|
+
if not cluster_url_id:
|
|
433
|
+
continue
|
|
434
|
+
posts = fetch_top_posts(str(cluster_url_id), posts_per=posts_per)
|
|
435
|
+
if posts:
|
|
436
|
+
metadata["posts"] = posts
|
|
437
|
+
enriched += 1
|
|
438
|
+
if enriched:
|
|
439
|
+
_log(f"post-dedupe enriched {enriched} clusters with X posts")
|
|
440
|
+
return items
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
"""Entity extraction from initial search results for supplemental searches."""
|
|
2
|
+
|
|
3
|
+
import re
|
|
4
|
+
from collections import Counter
|
|
5
|
+
from typing import Any, Dict, List
|
|
6
|
+
|
|
7
|
+
# Handles that appear too frequently to be useful for targeted search.
|
|
8
|
+
# These are generic/platform accounts, not topic-specific voices.
|
|
9
|
+
GENERIC_HANDLES = {
|
|
10
|
+
"elonmusk", "openai", "google", "microsoft", "apple", "meta",
|
|
11
|
+
"github", "youtube", "x", "twitter", "reddit", "wikipedia",
|
|
12
|
+
"nytimes", "washingtonpost", "cnn", "bbc", "reuters",
|
|
13
|
+
"verified", "jack", "sundarpichai",
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
def extract_entities(
|
|
18
|
+
reddit_items: List[Dict[str, Any]],
|
|
19
|
+
x_items: List[Dict[str, Any]],
|
|
20
|
+
max_handles: int = 5,
|
|
21
|
+
max_hashtags: int = 3,
|
|
22
|
+
max_subreddits: int = 5,
|
|
23
|
+
) -> Dict[str, List[str]]:
|
|
24
|
+
"""Extract key entities from Phase 1 results for supplemental searches.
|
|
25
|
+
|
|
26
|
+
Parses X results for @handles and #hashtags, Reddit results for subreddit
|
|
27
|
+
names and cross-referenced communities.
|
|
28
|
+
|
|
29
|
+
Args:
|
|
30
|
+
reddit_items: Raw Reddit item dicts from Phase 1
|
|
31
|
+
x_items: Raw X item dicts from Phase 1
|
|
32
|
+
max_handles: Maximum handles to return
|
|
33
|
+
max_hashtags: Maximum hashtags to return
|
|
34
|
+
max_subreddits: Maximum subreddits to return
|
|
35
|
+
|
|
36
|
+
Returns:
|
|
37
|
+
Dict with keys: x_handles, x_hashtags, reddit_subreddits
|
|
38
|
+
"""
|
|
39
|
+
handles = _extract_x_handles(x_items)
|
|
40
|
+
hashtags = _extract_x_hashtags(x_items)
|
|
41
|
+
subreddits = _extract_subreddits(reddit_items)
|
|
42
|
+
|
|
43
|
+
return {
|
|
44
|
+
"x_handles": handles[:max_handles],
|
|
45
|
+
"x_hashtags": hashtags[:max_hashtags],
|
|
46
|
+
"reddit_subreddits": subreddits[:max_subreddits],
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
def _extract_x_handles(x_items: List[Dict[str, Any]]) -> List[str]:
|
|
51
|
+
"""Extract and rank @handles from X results.
|
|
52
|
+
|
|
53
|
+
Sources handles from:
|
|
54
|
+
1. author_handle field (who posted)
|
|
55
|
+
2. @mentions in post text (who they're talking about/to)
|
|
56
|
+
|
|
57
|
+
Returns handles ranked by frequency, filtered for generic accounts.
|
|
58
|
+
"""
|
|
59
|
+
handle_counts = Counter()
|
|
60
|
+
|
|
61
|
+
for item in x_items:
|
|
62
|
+
# Author handle
|
|
63
|
+
author = item.get("author_handle", "").strip().lstrip("@").lower()
|
|
64
|
+
if author and author not in GENERIC_HANDLES:
|
|
65
|
+
handle_counts[author] += 1
|
|
66
|
+
|
|
67
|
+
# @mentions in text
|
|
68
|
+
text = item.get("text", "")
|
|
69
|
+
mentions = re.findall(r'@(\w{1,15})', text)
|
|
70
|
+
for mention in mentions:
|
|
71
|
+
mention_lower = mention.lower()
|
|
72
|
+
if mention_lower not in GENERIC_HANDLES:
|
|
73
|
+
handle_counts[mention_lower] += 1
|
|
74
|
+
|
|
75
|
+
# Return all handles ranked by frequency
|
|
76
|
+
return [h for h, _ in handle_counts.most_common()]
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def _extract_x_hashtags(x_items: List[Dict[str, Any]]) -> List[str]:
|
|
80
|
+
"""Extract and rank #hashtags from X results.
|
|
81
|
+
|
|
82
|
+
Returns hashtags ranked by frequency.
|
|
83
|
+
"""
|
|
84
|
+
hashtag_counts = Counter()
|
|
85
|
+
|
|
86
|
+
for item in x_items:
|
|
87
|
+
text = item.get("text", "")
|
|
88
|
+
tags = re.findall(r'#(\w{2,30})', text)
|
|
89
|
+
for tag in tags:
|
|
90
|
+
hashtag_counts[tag.lower()] += 1
|
|
91
|
+
|
|
92
|
+
# Return all hashtags ranked by frequency
|
|
93
|
+
return [f"#{t}" for t, _ in hashtag_counts.most_common()]
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
def _extract_subreddits(reddit_items: List[Dict[str, Any]]) -> List[str]:
|
|
97
|
+
"""Extract and rank subreddits from Reddit results.
|
|
98
|
+
|
|
99
|
+
Sources from:
|
|
100
|
+
1. subreddit field on each result
|
|
101
|
+
2. Cross-references in comment text (e.g., "check out r/localLLaMA")
|
|
102
|
+
|
|
103
|
+
Returns subreddits ranked by frequency.
|
|
104
|
+
"""
|
|
105
|
+
sub_counts = Counter()
|
|
106
|
+
|
|
107
|
+
for item in reddit_items:
|
|
108
|
+
# Primary subreddit
|
|
109
|
+
sub = item.get("subreddit", "").strip().removeprefix("r/")
|
|
110
|
+
if sub:
|
|
111
|
+
sub_counts[sub] += 1
|
|
112
|
+
|
|
113
|
+
# Cross-references in comment insights
|
|
114
|
+
for insight in item.get("comment_insights", []):
|
|
115
|
+
cross_refs = re.findall(r'r/(\w{2,30})', insight)
|
|
116
|
+
for ref in cross_refs:
|
|
117
|
+
sub_counts[ref] += 1
|
|
118
|
+
|
|
119
|
+
# Cross-references in top comments
|
|
120
|
+
for comment in item.get("top_comments", []):
|
|
121
|
+
excerpt = comment.get("excerpt", "")
|
|
122
|
+
cross_refs = re.findall(r'r/(\w{2,30})', excerpt)
|
|
123
|
+
for ref in cross_refs:
|
|
124
|
+
sub_counts[ref] += 1
|
|
125
|
+
|
|
126
|
+
# Return subreddits ranked by frequency
|
|
127
|
+
return [sub for sub, _ in sub_counts.most_common()]
|