Talent Scout

Create or update the tenant-scoped applicant profile once so Talent Scout can reuse resume, LinkedIn, proof-point, preference, and voice evidence across jobs.

Agent use
Call stackfast.talent_scout.applicant_profile_upsert before composing packets. The façade stores private applicant evidence for proof mapping and returns only redacted presence/count receipts; raw resume and LinkedIn text are never returned.

Read redacted readiness for the stored applicant profile without exposing raw resume, LinkedIn, or private profile text.

Agent use
Call stackfast.talent_scout.applicant_profile_status to verify profile presence, proof-point counts, resume/LinkedIn readiness, and compose reuse before drafting.

Persist the active Talent Scout search rails: target lanes, compensation floor, geography, negative filters, resume-variant priority, and voice/age strategy.

Agent use
Call stackfast.talent_scout.set_search_rails when Robert or an operator changes the active job-search strategy. Future search, review, score, compose, packet, and outreach calls load these rails by default and return rails receipts.

Describe the persistent Talent Scout job-search OS flow from profile setup through packet, human gate, lifecycle, and follow-up.

Agent use
Call stackfast.talent_scout.pipeline_describe when an agent needs the Talent Scout operating flow. It is read-only and self-documents profile -> search -> hydrate -> packet -> lifecycle.

Search for governed opportunity candidates and place reviewable matches in the Talent Scout queue.

Agent use
Call stackfast.talent_scout.search_opportunities. The façade composes team_hire.recruiter.run_scout_cycle with create_followups false and returns reviewable matches only.

Score a profile against an opportunity and return transparent fit regions.

Agent use
Call stackfast.talent_scout.score_fit. The façade composes team_hire.shared.score_fit in recruiter mode.

Create or update a configurable direct-company relationship campaign with target lanes, geography, company-size rules, and qualification criteria.

Agent use
Call stackfast.talent_scout.upsert_campaign_profile before company-first discovery. The façade stores campaign rails and returns a receipt without sending outreach.

Discover company leads that match an active campaign, using approved sources and explicit leads-not-truth receipts.

Agent use
Call stackfast.talent_scout.discover_companies_by_campaign after campaign setup. Results are company leads until careers-page verification confirms an exact role.

Scan a company careers page for exact matching roles or return a clear no-match or needs-verification receipt.

Agent use
Call stackfast.talent_scout.scan_company_for_roles with company homepage/careers evidence. It must separate direct apply URL, source URL, and company URL.

Find likely public business contacts for a verified company or role while keeping labels conservative.

Agent use
Call stackfast.talent_scout.find_company_contacts only after a company or role is qualified. It returns likely contact receipts, not permission to send.

Use Hunter to enrich a qualified business contact and return verification status, confidence, quota, and source receipts.

Agent use
Call stackfast.talent_scout.enrich_contact_email only after contact qualification. It executes Hunter lookup/verifier and must fail loudly on provider key issues.

Draft relationship outreach for a qualified company/contact without sending.

Agent use
Call stackfast.talent_scout.draft_direct_outreach after campaign, role, company, and contact evidence are ready. Output is draft-only and approval-gated.

Record a human decision on a direct-outreach draft without sending the message.

Agent use
Call stackfast.talent_scout.record_direct_outreach after a human approves, edits, rejects, copies, or manually reports sending a draft_direct_outreach artifact. This records the lifecycle receipt only; it never sends.

Create a draft-only application or opportunity packet from an existing queue item.

Agent use
Call stackfast.talent_scout.create_packet. The façade composes team_hire.application.compose_packet and returns draft_only output with approval_required_before_send.

Compose cover letters, form-paste answers, application Q&A, telephone scripts, and authority-analysis drafts from a queue item.

Agent use
Call stackfast.talent_scout.compose_application for job-seeker artifacts only. The façade uses the bounded JD-evidence public compose path, fails closed on generic fallback text, and rejects internal sales/BYOC/partnership output kinds.

Draft human-reviewed outreach from approved pains and voice evidence without sending.

Agent use
Call stackfast.talent_scout.draft_outreach. The façade composes team_hire.shared.draft_artifact and rejects send/apply/autonomous_outbound requests.

Read Talent Scout queue state for review, packet, and follow-up decisions.

Agent use
Call stackfast.talent_scout.review_queue. The façade reads the tenant-scoped real board, quarantines demo/stale non-job rows, hides archived/applied rows by default, and is read/review only.

Read the daily Talent Scout operating report: applied pipeline, mailbox reconciliation status, follow-up due, open unapplied roles, availability checks, preference filters, and today's slate.

Agent use
Call stackfast.talent_scout.daily_pipeline. The façade reads the shared tenant queue and returns a closed-loop control-tower report without sending, applying, or mutating decisions.

Read server-side recruiting mailbox signals and reconciliation state without using a client Gmail fallback.

Agent use
Call stackfast.talent_scout.mail_signals when the workflow needs recruiting reply/follow-up status. It reports mailbox availability and signals without sending email.

Build the recruiting-desk workup for one queue item: pain/proof map, resume angle, application strategy, packet checklist, submission receipt, follow-up plan, and interview prep.

Agent use
Call stackfast.talent_scout.application_workup. The façade reads one shared queue item and returns a draft-only application strategy workup without sending, applying, or mutating decisions.