Automation Flow
===============

Helper scripts
--------------

The repository ships with two helper scripts in ``scripts/``:

* ``send_top_llm_match_email.sh``
* ``send_top_newest_email.sh``

Both scripts:

* run across all selectable sources
* use ``--debug-links``
* inspect ``10`` links per source by default
* write a detailed report to ``reports/``
* write a links-only ``_action`` report to ``reports/``
* attempt to email the top ``5`` links only when SMTP configuration is present

The LLM script ranks by profile match. The newest script ranks by the newest
available posting dates.

Local configuration
-------------------

The scripts assume these local-only files:

* ``data/profile.txt``
* ``data/email.env``

``data/email.env`` can define the SMTP settings used by the CLI:

* ``JOB_SEARCH_SMTP_HOST``
* ``JOB_SEARCH_SMTP_PORT``
* ``JOB_SEARCH_SMTP_USER``
* ``JOB_SEARCH_SMTP_PASSWORD``
* ``JOB_SEARCH_SMTP_TLS``
* ``JOB_SEARCH_EMAIL_FROM``
* ``EMAIL_TO``

Email fallback behavior
-----------------------

If ``data/email.env`` still contains placeholder values, the helper scripts skip
email delivery and continue.

If SMTP sending fails after the report is generated, the CLI keeps the run
successful and prints a warning while preserving the report output.

Generated files
---------------

Default report targets:

* ``reports/top-llm-match-email.md``
* ``reports/top-llm-match-email_action.md``
* ``reports/top-newest-email.md``
* ``reports/top-newest-email_action.md``