patrick/Polaris

Watch

Fork 0

T-C — Planning engine daily mode: opportunities, travel provider, OR-Tools VRP model, result mapping #18

New issue

Open

opened 2026-09-11 09:02:11 +00:00 by bart · 2 comments

bart commented

2026-09-11 09:02:11 +00:00

Collaborator

Parent

Row T-C in docs/12-implementation-plan.md (branch, owned paths and doc section are defined there).

What to build

Given a PlanningSnapshot, the engine enumerates opportunities, builds the OR-Tools model from docs/05-planning-engine.md §4 (daily mode) with a TravelMatrixProvider (haversine implementation), and returns a PlanResult with assignments and unassigned jobs with reasons. Pure module; replayable from a file.

Acceptance criteria

Tiny fixture solves to its known optimum; medium fixture solves within the time budget
Every lock type in the every-lock-type fixture is honoured
Unassigned jobs carry a reason from the closed reason list
polaris replay-run --file produces the result; a slow regression test is marked and skipped by default
Engine imports only core and contracts; docs/05 §2–§7 updated

Blocked by

#12 — Engine contracts: PlanningSnapshot, PlanResult, Finding, projector/scorer I/O, task payloads, code lists, fixtures

## Parent Row **T-C** in `docs/12-implementation-plan.md` (branch, owned paths and doc section are defined there). ## What to build Given a `PlanningSnapshot`, the engine enumerates opportunities, builds the OR-Tools model from docs/05-planning-engine.md §4 (daily mode) with a `TravelMatrixProvider` (haversine implementation), and returns a `PlanResult` with assignments and unassigned jobs with reasons. Pure module; replayable from a file. ## Acceptance criteria - [x] Tiny fixture solves to its known optimum; medium fixture solves within the time budget - [x] Every lock type in the every-lock-type fixture is honoured - [x] Unassigned jobs carry a reason from the closed reason list - [x] `polaris replay-run --file` produces the result; a `slow` regression test is marked and skipped by default - [x] Engine imports only `core` and `contracts`; docs/05 §2–§7 updated ## Blocked by - #12 — Engine contracts: PlanningSnapshot, PlanResult, Finding, projector/scorer I/O, task payloads, code lists, fixtures

bart added the

ready-for-agent

label

2026-09-11 09:02:11 +00:00

bart added a new dependency

2026-09-11 09:02:25 +00:00

#12 PH1.4 — Engine contracts: PlanningSnapshot, PlanResult, Finding, projector/scorer I/O, task payloads, code lists, fixtures

bart referenced this issue

2026-09-11 09:02:26 +00:00

PH3.1 — Nightly run job and replay-run by id #23

bart added a new dependency

2026-09-11 09:02:26 +00:00

#23 PH3.1 — Nightly run job and replay-run by id

bart referenced this issue

2026-09-11 09:02:27 +00:00

PH3.3 — Refill: override mode, /recalculate serialised per draft chain, new_in_version marking #25

bart added a new dependency

2026-09-11 09:02:27 +00:00

#25 PH3.3 — Refill: override mode, /recalculate serialised per draft chain, new_in_version marking

bart referenced this issue

2026-09-11 09:02:30 +00:00

PH5.2 — Engine event mode: freeze window and triggers from failure, cancel/urgent job, shift cancel, manual window #34

bart added a new dependency

2026-09-11 09:02:30 +00:00

#34 PH5.2 — Engine event mode: freeze window and triggers from failure, cancel/urgent job, shift cancel, manual window

bart referenced this issue

2026-09-11 09:02:30 +00:00

PH5.3 — Engine manual mode and /reoptimise with scope dialog semantics #35

bart added a new dependency

2026-09-11 09:02:31 +00:00

#35 PH5.3 — Engine manual mode and /reoptimise with scope dialog semantics

bart referenced this issue

2026-09-11 09:02:33 +00:00

PH6.1 — OSRM travel provider with cache, degraded health and W_TRAVEL_FALLBACK #42

bart added a new dependency

2026-09-11 09:02:33 +00:00

#42 PH6.1 — OSRM travel provider with cache, degraded health and W_TRAVEL_FALLBACK

patrick self-assigned this

2026-09-11 11:47:12 +00:00

patrick commented

2026-09-11 11:47:17 +00:00

Owner

Starting work on branch feature/engine-daily-mode. Owned paths: backend/src/polaris/engine/**, backend/tests/unit/engine/**, backend/tests/fixtures/snapshots/** (additions only). Building daily-mode OR-Tools VRP model per docs/05-planning-engine.md §2–§7, on top of the merged #12 engine contracts.

Starting work on branch `feature/engine-daily-mode`. Owned paths: `backend/src/polaris/engine/**`, `backend/tests/unit/engine/**`, `backend/tests/fixtures/snapshots/**` (additions only). Building daily-mode OR-Tools VRP model per docs/05-planning-engine.md §2–§7, on top of the merged #12 engine contracts.

patrick referenced this issue from a commit

2026-09-11 12:23:27 +00:00

feat(engine): daily-mode OR-Tools VRP model

patrick referenced this issue from a pull request that will close it,

2026-09-11 12:23:48 +00:00

feat(engine): daily-mode OR-Tools VRP model #72

patrick commented

2026-09-11 12:24:00 +00:00

Owner

Done — PR #72 (#72), branch feature/engine-daily-mode. All acceptance criteria ticked above. mypy --strict and ruff clean; 196 unit tests green (plus a --run-slow regression test against the medium fixture's real 120s daily budget). Note in the PR's Additional Context: cli/replay_run.py's stub wiring is a small follow-up now that both T-C and T-D have merged, left untouched here since it's outside this ticket's owned paths.

Done — PR #72 (https://git.xor.nu/patrick/Polaris/pulls/72), branch `feature/engine-daily-mode`. All acceptance criteria ticked above. mypy --strict and ruff clean; 196 unit tests green (plus a `--run-slow` regression test against the medium fixture's real 120s daily budget). Note in the PR's Additional Context: `cli/replay_run.py`'s stub wiring is a small follow-up now that both T-C and T-D have merged, left untouched here since it's outside this ticket's owned paths.