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