Skip to content

fix: deals --query searches deal name; document filter formats in skill - #14

Merged
jschfflr merged 1 commit into
mainfrom
fix/deal-query-and-skill-formats
Jul 10, 2026
Merged

fix: deals --query searches deal name; document filter formats in skill#14
jschfflr merged 1 commit into
mainfrom
fix/deal-query-and-skill-formats

Conversation

@jschfflr

Copy link
Copy Markdown
Contributor

Companion to apollo-api#21.

Fix

  • deals search --query now maps to q_opportunity_name (searches the deal name). Apollo silently ignores q_keywords on /opportunities/search, so this never actually filtered before. Verified e2e: --query NORRIQ → 1, nonsense → 0.

Skill (SKILL.md + references)

  • New "Search filter formats" section — the empirically-verified formats: person_seniorities lowercase enums, person_locations (country / 2-letter code / "City, State, Country"), organization_num_employees_ranges "min,max" (dash silently ignored), dict ranges, contact_email_status values, canonical linkedin_url, deal name search.
  • Staleness fixes found along the way: added missing deals create and people --keywords; removed the deleted news command; corrected jobs searchjobs list ACCOUNT_ID; clarified the deal --query example.

Testing

ruff ✅ · mypy ✅ · 81 tests ✅ · e2e verified against the fixed api.

Depends on apollo-api#21 (adds q_opportunity_name to the deal allowlist). No version bump.

🤖 Generated with Claude Code

- deals search --query now maps to q_opportunity_name (Apollo silently ignores
  q_keywords for /opportunities/search, so name search never worked).
- SKILL.md: add a 'Search filter formats' section (seniority enums, location
  formats, 'min,max' employee ranges, dict ranges, deal name search, canonical
  linkedin_url). Fix staleness: add 'deals create' and 'people --keywords',
  remove the deleted 'news' command, correct 'jobs' to 'jobs list ACCOUNT_ID'.
- deal-workflows.md: clarify --query matches the deal name.

e2e verified against the fixed api: deals search --query NORRIQ → 1, nonsense → 0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@peqy peqy Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Change looks correct: deals search --query now maps to q_opportunity_name and docs clarify filter formats.

Improvement

  • Consider bumping the minimum qodev-apollo-api version once apollo-api#21 is released, so older installs don’t silently ignore q_opportunity_name and return unfiltered results.

Found 1 issue (0 critical, 1 improvement).

filters["q_keywords"] = query
# Deal name search is q_opportunity_name — Apollo silently ignores
# q_keywords on /opportunities/search (it returns every deal).
filters["q_opportunity_name"] = query

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

q_opportunity_name support appears to depend on apollo-api#21 (deal allowlist). To avoid this silently regressing for users who install an older qodev-apollo-api (e.g. 0.4.0), it may be worth bumping the minimum required version (and updating uv.lock) once the apollo-api release containing #21 is cut.

@jschfflr
jschfflr merged commit 597500d into main Jul 10, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant