raulgupta 7c5a88dd3f Engine Phase 3: non-tech scoring (role-aware weights + curator) + vocab
- rank.py: get_weights(profile) — when the profile reads non-tech (sales/finance/HR/ops/support/…),
  tilt the weights to role(0.16)/industry(0.12)/semantic(0.12), drop skill(0.18). Tech weights
  unchanged. (The competency-skill-backfill was tried + REVERTED — uniform per-role competencies
  added no discrimination and Phase 2's real-cosine f_semantic already supplies the non-tech signal.)
- curate.py: non-tech instruction — role/responsibility fit is the spine; a missing skill list is NOT
  a negative; a strong role+industry+responsibility+seniority match is a genuine ~80, not ~65.
- test_contracts.py: allowlist the new keyword-handled non-tech vocab (active boards keyword-fold;
  numeric codes deferred since the active feed/recall paths don't use them).

Regression (120 pairs): MAE 18.4 → 16.1 (all from non-tech: sales 17.1→13.0, ops 16.3→11.7), recall
holds 0.92, tech unchanged. 31 tests pass.
2026-06-25 16:03:20 +05:30

matchmaking-v2 (Scout)

Fresh, on-demand matchmaking service replacing the dead nightly aggregator. Same agent-mesh mold as the other GrowQR services (FastAPI · a2a card · /a2a/tasks · orchestrator-routed). Not a drop-in — it keeps the existing 4 skills working and adds new actions from scratch.

Layout

app/
  main.py              FastAPI app (card + /a2a/tasks + /api/v1/health), lifespan worker
  config.py            lean settings (no corpus DB, no scrape schedule)
  a2a/                 card.py (discovery), auth.py (bearer), tasks.py (orchestrator entry)
  agent/session.py     Session: on_session_start / on_user_action dispatch  ← the brain
  adk/worker.py        Redis-Streams worker (graceful no-op without Redis)
  api/v1/health.py     /api/v1/health
  engine/
    board_adapters/    ScoutPrefs → Apify actor inputs (Naukri-first, verified maps)
    ...                the §3 cascade (normalize→filter→utility→fusion→rerank) lands here
  contracts/           Pydantic contracts (user_context, transport, …) — added per slice
research/              docs/ (ENGINE_DESIGN, SIGNAL_AUDIT_V2, ENGINE_INPUTS, …) + poc/ (auto-apply)

Contract (how it connects)

Frontend useAgentSession (page "job-matching") → orchestrator (routes by card name = matchmaking-service) → POST /a2a/tasks {action, params, user_context}Session pushes agent_data{action,data} → orchestrator → frontend latestData[action].

Skills: existing get_feed · sync_preferences · record_feedback · get_opportunity_detail; new run_search · tailor_resume · submit_application · get_apply_proof (stubbed). Each new action needs: card skill (here) + orchestrator action-map entry + frontend sendAction wiring.

Run (local)

pip install -r requirements.txt
uvicorn app.main:app --reload --port 8006
# card:    GET http://localhost:8006/.well-known/agent-card.json
# health:  GET http://localhost:8006/api/v1/health
# action:  POST http://localhost:8006/a2a/tasks  (Bearer dev-a2a-key)

Build order (full-stack slices)

  1. scaffold (this) — bootable skeleton, contract wired, handlers stubbed.
  2. on-demand run_search — board_adapters → Apify → engine cascade → ranked feed (+ frontend wire).
  3. feedback labels + record_feedback. 3. tailor_resume. 4. submit_application + get_apply_proof.
  4. cut over from old :8006, decommission corpus.
Description
GrowQR matchmaking v2 service synced from GitHub
Readme 9 MiB
Languages
Python 99.7%
Mako 0.2%
Dockerfile 0.1%