Resume screener

nika: v1
workflow: resume-screener
description: "glob CVs → local-model rubric per candidate → deterministic shortlist"

model: ollama/llama3.1      # PII stays on the machine · the whole screen is offline

permits:                    # the file IS the blast radius · no net category at all —
  fs:                       # CVs cannot leave this machine even if a prompt is hijacked
    read: ["./hiring/inbox/**"]
    write: ["./hiring/out/**", "./hiring/shortlist-brief.md"]
  tools: ["nika:glob", "nika:read", "nika:jq", "nika:write"]

vars:
  role: "Senior Rust engineer"
  cv_glob: "./hiring/inbox/*.md"
  shortlist_size: 5

tasks:
  - id: pool
    invoke:
      tool: "nika:glob"
      args: { pattern: "${{ vars.cv_glob }}" }

  - id: cvs
    depends_on: [pool]
    for_each: ${{ tasks.pool.output }}
    max_parallel: 8
    fail_fast: false                   # one unreadable CV must not stop the batch
    on_error:
      recover: null                    # null keeps the zip aligned · filtered later
    invoke:
      tool: "nika:read"
      args: { path: "${{ item }}" }

  - id: pairs
    depends_on: [pool, cvs]
    invoke:                            # zip path + content · order survived the nulls
      tool: "nika:jq"
      args:
        input: ["${{ tasks.pool.output }}", "${{ tasks.cvs.output }}"]
        expression: "transpose | map(select(.[1] != null)) | map({path: .[0], text: .[1]})"

  - id: screened
    depends_on: [pairs]
    for_each: ${{ tasks.pairs.output }}
    max_parallel: 2                    # local model · don't thrash the GPU
    fail_fast: false
    on_error:
      recover: null
    with:
      cv_path: ${{ item.path }}
    infer:
      prompt: |
        Role · ${{ vars.role }}
        Candidate file · ${{ with.cv_path }}
        CV ·
        ${{ item.text }}
        Score this candidate against the role. Quote evidence from the
        CV for every rating — no rating without a quote.
      schema:
        type: object
        required: [file, fit, strengths, concerns]
        properties:
          file: { type: string }
          fit: { type: string, enum: [strong, possible, weak] }
          years_relevant: { type: integer }
          strengths: { type: array, items: { type: string } }
          concerns: { type: array, items: { type: string } }

  - id: ranked
    depends_on: [screened]
    invoke:
      tool: "nika:jq"
      args:
        input: "${{ tasks.screened.output }}"
        expression: 'map(select(. != null)) | map(select(.fit != "weak")) | sort_by(.fit != "strong", -(.years_relevant // 0))'

  - id: shortlist
    depends_on: [ranked]
    invoke:
      tool: "nika:jq"
      args:
        input: "${{ tasks.ranked.output }}"
        expression: ".[:${{ vars.shortlist_size }}]"

  - id: brief
    depends_on: [shortlist]
    when: ${{ size(tasks.shortlist.output) > 0 }}
    infer:
      prompt: |
        Write the screening brief for these shortlisted candidates ·
        ${{ tasks.shortlist.output }}
        One paragraph each · lead with the evidence quotes · end with
        the suggested interview focus.

  - id: save
    depends_on: [brief]
    when: ${{ tasks.brief.output != null }}    # skip cascades by VALUE · a skipped brief is null
    invoke:
      tool: "nika:write"
      args:
        path: "./hiring/shortlist-brief.md"
        content: "${{ tasks.brief.output }}"
        create_dirs: true

outputs:
  shortlist:
    value: ${{ tasks.shortlist.output }}
    type: array
    description: "Ranked candidates · strong first, then by relevant years"