kestrel-app 0.1.0__tar.gz

kestrel_app-0.1.0/.env.example

@@ -0,0 +1,53 @@
+# Kestrel Configuration
+# Copy to .env and customize: cp .env.example .env
+
+# -- AI Provider ----------------------------------------------------------
+# mock = fully offline, no API key needed (default)
+# openrouter = real AI via OpenRouter (requires API key below)
+AI_PROVIDER=mock
+
+# Required when AI_PROVIDER=openrouter
+# Sign up at https://openrouter.ai to get a key
+OPENROUTER_API_KEY=
+OPENROUTER_MODEL=anthropic/claude-sonnet-4
+
+# -- Database --------------------------------------------------------------
+DATABASE_URL=sqlite:///data/career_os.db
+
+# -- Server ----------------------------------------------------------------
+HOST=0.0.0.0
+PORT=8100
+FRONTEND_URL=http://localhost:8101
+DEBUG=false
+
+# -- Auth (optional) -------------------------------------------------------
+# Enable to protect your instance with an API key
+AUTH_ENABLED=false
+AUTH_API_KEY=
+
+# -- Anti-Captcha (optional) -----------------------------------------------
+# For automated form filling with captcha solving
+# Sign up at https://anti-captcha.com ($10 lasts a long time)
+ANTICAPTCHA_KEY=
+
+# -- Notifications (optional) ----------------------------------------------
+# Pushover: https://pushover.net
+PUSHOVER_USER_KEY=
+PUSHOVER_APP_TOKEN=
+
+# Mailgun: https://mailgun.com
+MAILGUN_API_KEY=
+MAILGUN_DOMAIN=
+NOTIFY_EMAIL=
+
+# -- Integrations (optional) -----------------------------------------------
+# TickTick task sync
+TICKTICK_API_TOKEN=
+
+# Google Sheets (for daily scan logging)
+GOOGLE_SERVICE_ACCOUNT_JSON=
+GOOGLE_SHEET_ID=
+
+# -- Pipeline (optional) ---------------------------------------------------
+# Default location for job search (used by daily scan CI)
+PIPELINE_LOCATION=Remote

kestrel_app-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kestrel Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kestrel_app-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include alembic.ini
+recursive-include alembic *.py *.mako
+recursive-include frontend/dist *
+include .env.example
+include config/personal.yaml.example

kestrel_app-0.1.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: kestrel-app
+Version: 0.1.0
+Summary: AI-powered job search platform. Self-hosted, open-source, privacy-first.
+Requires-Python: >=3.13
+License-File: LICENSE
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn[standard]>=0.34.0
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: alembic>=1.15.0
+Requires-Dist: typer>=0.15.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: pydantic-settings>=2.8.0
+Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: aiosqlite>=0.21.0
+Requires-Dist: rich>=13.9.0
+Requires-Dist: icalendar>=7.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.25.0; extra == "dev"
+Requires-Dist: pytest-cov>=6.1.0; extra == "dev"
+Requires-Dist: ruff>=0.11.0; extra == "dev"
+Requires-Dist: httpx>=0.28.0; extra == "dev"
+Requires-Dist: pandas>=2.2.0; extra == "dev"
+Requires-Dist: python-jobspy>=1.1.0; extra == "dev"
+Requires-Dist: fpdf2>=2.8.0; extra == "dev"
+Dynamic: license-file

kestrel_app-0.1.0/README.md

@@ -0,0 +1,108 @@
+<h1 align="center">Kestrel</h1>
+
+<p align="center">
+  <strong>A job search system that runs on your computer.</strong><br>
+  Finds jobs. Scores them. Tracks your pipeline. Your data stays yours.
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Docker-one--click_setup-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker">
+  <img src="https://img.shields.io/badge/AI-built--in_(free)-22c55e?style=flat-square" alt="AI included">
+  <img src="https://img.shields.io/badge/License-MIT-yellow?style=flat-square" alt="MIT License">
+  <img src="https://img.shields.io/badge/No_coding_required-blue?style=flat-square" alt="No coding required">
+</p>
+
+<p align="center">
+  <a href="https://codespaces.new/pleasedodisturb/kestrel"><img src="https://github.com/codespaces/badge.svg" alt="Open in GitHub Codespaces" height="32"></a>
+</p>
+
+---
+
+## Install
+
+Pick whichever feels right. All three give you the same app.
+
+### Option 1: pip install (no Docker needed)
+
+```bash
+pip install kestrel-app
+kestrel start
+```
+
+Opens your browser automatically. Data stored in `~/.kestrel/`. Requires Python 3.13+.
+
+### Option 2: Docker (isolated, one command)
+
+```bash
+git clone https://github.com/pleasedodisturb/kestrel.git && cd kestrel
+bash setup.sh
+```
+
+### Option 3: Try in your browser (zero install)
+
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/pleasedodisturb/kestrel)
+
+Free with a GitHub account. Your own instance in 2 minutes. No install, nothing on your computer.
+
+**Need more help?** [Step-by-step guide](docs/QUICKSTART.md) - no coding knowledge required.
+
+---
+
+## What it does
+
+- **Discovers jobs** from multiple boards automatically (Indeed, LinkedIn, Glassdoor, Arbeitsagentur)
+- **Scores them** against your profile with AI - stop guessing which jobs are worth applying to
+- **Tracks your pipeline** on a Kanban board - drag applications between stages
+- **Prepares you for interviews** - company research, mock questions, STAR story library
+- **Runs daily scans** via GitHub Actions - wake up to a scored digest of new matches
+- **Works offline** - Demo Mode included, zero cost to start. Add real AI when ready.
+
+Everything runs on your machine. No account needed. No data leaves your computer (unless you connect an AI provider).
+
+---
+
+## Docs
+
+| Guide | For |
+|-------|-----|
+| [Quickstart](docs/QUICKSTART.md) | First-time setup, step by step |
+| [FAQ](docs/FAQ.md) | Common questions answered |
+| [Help](docs/HELP.md) | Troubleshooting when something breaks |
+| [AI Provider Guide](docs/AI-PROVIDERS.md) | Choosing and configuring an AI provider |
+| [Comparison](docs/COMPARISON.md) | How Kestrel compares to other tools |
+| [Features & API Reference](docs/REFERENCE.md) | Full feature list, architecture, CLI, API endpoints |
+| [Deployment](DEPLOY.md) | Railway, Fly.io, VPS hosting |
+| [Contributing](CONTRIBUTING.md) | Development setup and pull request guidelines |
+
+---
+
+## Quick look
+
+**Web dashboard** with Kanban board, AI scoring, discovery, analytics, and more:
+
+```
+http://localhost:8101  - Dashboard (what you use)
+http://localhost:8100/docs  - API docs (if you're curious)
+```
+
+**Add real AI** (optional - works fine without it):
+
+1. Sign up at [openrouter.ai](https://openrouter.ai) and copy your API key
+2. Open the settings file in your Kestrel folder:
+   - **Mac:** Open Terminal, go to your Kestrel folder, type `open .env`
+   - **Windows:** Open the Kestrel folder, type `.env` in the address bar
+   - **Or any text editor:** the file is called `.env` (hidden file - [how to see it](docs/FAQ.md#hidden-files-on-mac))
+3. Change these two lines:
+   ```
+   AI_PROVIDER=openrouter
+   OPENROUTER_API_KEY=sk-or-paste-your-key-here
+   ```
+4. Save the file, then restart: `docker compose restart`
+
+Costs about $1-3/month. Full guide: [AI Provider Guide](docs/AI-PROVIDERS.md)
+
+---
+
+## License
+
+[MIT](LICENSE) - free forever, do whatever you want with it.

kestrel_app-0.1.0/alembic/env.py

@@ -0,0 +1,68 @@
+"""Alembic environment configuration."""
+
+import sys
+from logging.config import fileConfig
+from pathlib import Path
+
+from sqlalchemy import engine_from_config, pool
+
+from alembic import context
+
+# Ensure src/ is on sys.path so career_os is importable
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
+
+from career_os.database import Base  # noqa: E402
+from career_os.models import models as _models  # noqa: E402, F401
+from career_os.models import skills as _skills  # noqa: E402, F401
+from career_os.models import discovery as _discovery  # noqa: E402, F401
+
+# this is the Alembic Config object, which provides
+# access to the values within the .ini file in use.
+config = context.config
+
+# Interpret the config file for Python logging.
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+# Model metadata for autogenerate support
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+    """Run migrations in 'offline' mode."""
+    url = config.get_main_option("sqlalchemy.url")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+        render_as_batch=True,
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    """Run migrations in 'online' mode."""
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+
+    with connectable.connect() as connection:
+        context.configure(
+            connection=connection,
+            target_metadata=target_metadata,
+            render_as_batch=True,
+        )
+
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

kestrel_app-0.1.0/alembic/script.py.mako

@@ -0,0 +1,28 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, Sequence[str], None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    ${downgrades if downgrades else "pass"}

kestrel_app-0.1.0/alembic/versions/07cca291f71f_add_saved_searches_table.py

@@ -0,0 +1,47 @@
+"""add saved_searches table
+
+Revision ID: 07cca291f71f
+Revises: e8b54d7d5d6a
+Create Date: 2026-03-13 21:30:04.969376
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '07cca291f71f'
+down_revision: Union[str, Sequence[str], None] = 'e8b54d7d5d6a'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('saved_searches',
+    sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+    sa.Column('profile_id', sa.Integer(), nullable=False),
+    sa.Column('name', sa.String(length=255), nullable=False),
+    sa.Column('config', sa.Text(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), nullable=False),
+    sa.ForeignKeyConstraint(['profile_id'], ['profiles.id'], ),
+    sa.PrimaryKeyConstraint('id')
+    )
+    with op.batch_alter_table('saved_searches', schema=None) as batch_op:
+        batch_op.create_index(batch_op.f('ix_saved_searches_profile_id'), ['profile_id'], unique=False)
+
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    with op.batch_alter_table('saved_searches', schema=None) as batch_op:
+        batch_op.drop_index(batch_op.f('ix_saved_searches_profile_id'))
+
+    op.drop_table('saved_searches')
+    # ### end Alembic commands ###

kestrel_app-0.1.0/alembic/versions/775c5d68cc2d_add_discovery_models_discovered_jobs_.py

@@ -0,0 +1,114 @@
+"""add discovery models: discovered_jobs, search_profiles, discovery_runs
+
+Revision ID: 775c5d68cc2d
+Revises: b192ca99adc9
+Create Date: 2026-03-13 20:57:12.532122
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = '775c5d68cc2d'
+down_revision: Union[str, Sequence[str], None] = 'b192ca99adc9'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('search_profiles',
+    sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+    sa.Column('profile_id', sa.Integer(), nullable=False),
+    sa.Column('name', sa.String(length=255), nullable=False),
+    sa.Column('keywords', sa.Text(), nullable=True),
+    sa.Column('locations', sa.Text(), nullable=True),
+    sa.Column('remote_only', sa.Boolean(), nullable=False),
+    sa.Column('sources', sa.Text(), nullable=True),
+    sa.Column('filters', sa.Text(), nullable=True),
+    sa.Column('is_active', sa.Boolean(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), nullable=False),
+    sa.ForeignKeyConstraint(['profile_id'], ['profiles.id'], ),
+    sa.PrimaryKeyConstraint('id')
+    )
+    with op.batch_alter_table('search_profiles', schema=None) as batch_op:
+        batch_op.create_index(batch_op.f('ix_search_profiles_profile_id'), ['profile_id'], unique=False)
+
+    op.create_table('discovered_jobs',
+    sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+    sa.Column('profile_id', sa.Integer(), nullable=False),
+    sa.Column('title', sa.String(length=500), nullable=False),
+    sa.Column('company', sa.String(length=255), nullable=False),
+    sa.Column('location', sa.String(length=255), nullable=False),
+    sa.Column('url', sa.Text(), nullable=True),
+    sa.Column('description', sa.Text(), nullable=True),
+    sa.Column('salary_range', sa.String(length=255), nullable=True),
+    sa.Column('remote', sa.Boolean(), nullable=False),
+    sa.Column('posted_at', sa.DateTime(timezone=True), nullable=True),
+    sa.Column('title_normalized', sa.String(length=500), nullable=False),
+    sa.Column('company_normalized', sa.String(length=255), nullable=False),
+    sa.Column('location_normalized', sa.String(length=255), nullable=False),
+    sa.Column('sources', sa.Text(), nullable=False),
+    sa.Column('source_urls', sa.Text(), nullable=False),
+    sa.Column('fit_score', sa.Float(), nullable=True),
+    sa.Column('application_id', sa.Integer(), nullable=True),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+    sa.Column('updated_at', sa.DateTime(timezone=True), nullable=False),
+    sa.ForeignKeyConstraint(['application_id'], ['applications.id'], ),
+    sa.ForeignKeyConstraint(['profile_id'], ['profiles.id'], ),
+    sa.PrimaryKeyConstraint('id'),
+    sa.UniqueConstraint('title_normalized', 'company_normalized', 'location_normalized', name='uq_discovered_job_dedup')
+    )
+    with op.batch_alter_table('discovered_jobs', schema=None) as batch_op:
+        batch_op.create_index(batch_op.f('ix_discovered_jobs_company_normalized'), ['company_normalized'], unique=False)
+        batch_op.create_index(batch_op.f('ix_discovered_jobs_location_normalized'), ['location_normalized'], unique=False)
+        batch_op.create_index(batch_op.f('ix_discovered_jobs_profile_id'), ['profile_id'], unique=False)
+        batch_op.create_index(batch_op.f('ix_discovered_jobs_title_normalized'), ['title_normalized'], unique=False)
+
+    op.create_table('discovery_runs',
+    sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+    sa.Column('profile_id', sa.Integer(), nullable=False),
+    sa.Column('search_profile_id', sa.Integer(), nullable=True),
+    sa.Column('trigger', sa.String(length=50), nullable=False),
+    sa.Column('status', sa.String(length=50), nullable=False),
+    sa.Column('total_found', sa.Integer(), nullable=False),
+    sa.Column('new_jobs', sa.Integer(), nullable=False),
+    sa.Column('duplicates', sa.Integer(), nullable=False),
+    sa.Column('errors', sa.Integer(), nullable=False),
+    sa.Column('warnings', sa.Text(), nullable=True),
+    sa.Column('started_at', sa.DateTime(timezone=True), nullable=False),
+    sa.Column('completed_at', sa.DateTime(timezone=True), nullable=True),
+    sa.ForeignKeyConstraint(['profile_id'], ['profiles.id'], ),
+    sa.ForeignKeyConstraint(['search_profile_id'], ['search_profiles.id'], ),
+    sa.PrimaryKeyConstraint('id')
+    )
+    with op.batch_alter_table('discovery_runs', schema=None) as batch_op:
+        batch_op.create_index(batch_op.f('ix_discovery_runs_profile_id'), ['profile_id'], unique=False)
+
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    # ### commands auto generated by Alembic - please adjust! ###
+    with op.batch_alter_table('discovery_runs', schema=None) as batch_op:
+        batch_op.drop_index(batch_op.f('ix_discovery_runs_profile_id'))
+
+    op.drop_table('discovery_runs')
+    with op.batch_alter_table('discovered_jobs', schema=None) as batch_op:
+        batch_op.drop_index(batch_op.f('ix_discovered_jobs_title_normalized'))
+        batch_op.drop_index(batch_op.f('ix_discovered_jobs_profile_id'))
+        batch_op.drop_index(batch_op.f('ix_discovered_jobs_location_normalized'))
+        batch_op.drop_index(batch_op.f('ix_discovered_jobs_company_normalized'))
+
+    op.drop_table('discovered_jobs')
+    with op.batch_alter_table('search_profiles', schema=None) as batch_op:
+        batch_op.drop_index(batch_op.f('ix_search_profiles_profile_id'))
+
+    op.drop_table('search_profiles')
+    # ### end Alembic commands ###

kestrel_app-0.1.0/alembic/versions/a1b2c3d4e5f6_add_job_requirements_table.py

@@ -0,0 +1,44 @@
+"""add job_requirements table
+
+Revision ID: a1b2c3d4e5f6
+Revises: e730f1c7a51e
+Create Date: 2026-03-13 16:00:00.000000
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'a1b2c3d4e5f6'
+down_revision: Union[str, Sequence[str], None] = 'e730f1c7a51e'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    op.create_table(
+        'job_requirements',
+        sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+        sa.Column('application_id', sa.Integer(), nullable=False),
+        sa.Column('profile_id', sa.Integer(), nullable=False),
+        sa.Column('skill_name', sa.String(length=255), nullable=False),
+        sa.Column('required_level', sa.String(length=50), nullable=False),
+        sa.Column('severity', sa.String(length=50), nullable=False),
+        sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+        sa.ForeignKeyConstraint(['application_id'], ['applications.id'], ),
+        sa.ForeignKeyConstraint(['profile_id'], ['profiles.id'], ),
+        sa.PrimaryKeyConstraint('id'),
+    )
+    op.create_index(op.f('ix_job_requirements_application_id'), 'job_requirements', ['application_id'], unique=False)
+    op.create_index(op.f('ix_job_requirements_profile_id'), 'job_requirements', ['profile_id'], unique=False)
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    op.drop_index(op.f('ix_job_requirements_profile_id'), table_name='job_requirements')
+    op.drop_index(op.f('ix_job_requirements_application_id'), table_name='job_requirements')
+    op.drop_table('job_requirements')

kestrel_app-0.1.0/alembic/versions/a7b8c9d0e1f2_add_scoring_breakdown_market_schedule.py

@@ -0,0 +1,63 @@
+"""add score_breakdown, dream_companies, market_refresh, schedule columns
+
+Revision ID: a7b8c9d0e1f2
+Revises: f1a2b3c4d5e6
+Create Date: 2026-03-13 23:00:00.000000
+
+"""
+from typing import Sequence, Union
+
+import sqlalchemy as sa
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision: str = "a7b8c9d0e1f2"
+down_revision: Union[str, Sequence[str], None] = "f1a2b3c4d5e6"
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    # Fix 1: Add score_breakdown JSON column to scored_jobs
+    with op.batch_alter_table("scored_jobs") as batch_op:
+        batch_op.add_column(
+            sa.Column("score_breakdown", sa.Text(), nullable=True)
+        )
+
+    # Fix 4: Add dream_companies JSON column to profiles
+    with op.batch_alter_table("profiles") as batch_op:
+        batch_op.add_column(
+            sa.Column("dream_companies", sa.Text(), nullable=True)
+        )
+
+    # Fix 5: Add last_market_refreshed_at to profiles
+    with op.batch_alter_table("profiles") as batch_op:
+        batch_op.add_column(
+            sa.Column(
+                "last_market_refreshed_at",
+                sa.DateTime(timezone=True),
+                nullable=True,
+            )
+        )
+
+    # Fix 7: Add cadence and next_run columns to search_profiles
+    with op.batch_alter_table("search_profiles") as batch_op:
+        batch_op.add_column(
+            sa.Column("cadence", sa.String(50), nullable=True)
+        )
+        batch_op.add_column(
+            sa.Column("next_run", sa.DateTime(timezone=True), nullable=True)
+        )
+
+
+def downgrade() -> None:
+    with op.batch_alter_table("search_profiles") as batch_op:
+        batch_op.drop_column("next_run")
+        batch_op.drop_column("cadence")
+
+    with op.batch_alter_table("profiles") as batch_op:
+        batch_op.drop_column("last_market_refreshed_at")
+        batch_op.drop_column("dream_companies")
+
+    with op.batch_alter_table("scored_jobs") as batch_op:
+        batch_op.drop_column("score_breakdown")

kestrel_app-0.1.0/alembic/versions/b192ca99adc9_add_gap_id_and_started_at_to_learning_.py

@@ -0,0 +1,36 @@
+"""add gap_id and started_at to learning_resources
+
+Revision ID: b192ca99adc9
+Revises: a1b2c3d4e5f6
+Create Date: 2026-03-13 15:25:01.704693
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'b192ca99adc9'
+down_revision: Union[str, Sequence[str], None] = 'a1b2c3d4e5f6'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    with op.batch_alter_table('learning_resources', schema=None) as batch_op:
+        batch_op.add_column(sa.Column('gap_id', sa.Integer(), nullable=True))
+        batch_op.add_column(sa.Column('started_at', sa.DateTime(timezone=True), nullable=True))
+        batch_op.create_index(batch_op.f('ix_learning_resources_gap_id'), ['gap_id'], unique=False)
+        batch_op.create_foreign_key('fk_learning_resources_gap_id', 'job_requirements', ['gap_id'], ['id'])
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    with op.batch_alter_table('learning_resources', schema=None) as batch_op:
+        batch_op.drop_constraint('fk_learning_resources_gap_id', type_='foreignkey')
+        batch_op.drop_index(batch_op.f('ix_learning_resources_gap_id'))
+        batch_op.drop_column('started_at')
+        batch_op.drop_column('gap_id')