---
title: Tasks (markdown outliner, in development) (part 11)
---
# Tasks (markdown outliner, in development) (part 11)

## What it is

This is part 11 of the [Tasks (markdown outliner, in development)](tasks-v2.md) page. It carries the next stretch of the material on that page, moved here because a single page is capped at 40,000 characters.

## Where to find it

Reach this part through [Tasks (markdown outliner, in development)](tasks-v2.md) — it lists every part and explains where the feature lives in the product. Everything below is reached from the same place.

## How it behaves

Everything below is the behaviour, detail and edge cases that belong to this stretch of the Tasks (markdown outliner, in development) page.

### Key files

| What                                                    | Where                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Migration (`tasks_v2` DDL)                              | `src/main/db/migrations/20260601091339-tasks-v2-table.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Migration (lists table + `list_id` + Inbox backfill)    | `src/main/db/migrations/20260602002635-tasks-v2-lists.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Migration (`sessions.task_id` link + index)             | `src/main/db/migrations/20260604225436-add-sessions-task-id-column.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Migration (`task_context_items` table + index)          | `src/main/db/migrations/20260605235451-add-task-context-items.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Migration (`task_context_items.inherit` cascading flag) | `src/main/db/migrations/20260608052857-tasks-v2-context-inherit-flag.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Migration (rich fields: importance/urgency/start_at)    | `src/main/db/migrations/20260607220204-tasks-v2-rich-fields-importance-urgency-start-at.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Migration (`tasks_v2_checkins` daily check-in table)    | `src/main/db/migrations/20260608031242-tasks-v2-daily-checkins.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Prioritizer (M2): pure local scorer                     | `src/shared/tasks-v2-priority.ts` (`computeRightNow`, `rankTasksV2`, `eligibleSignature`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Prioritizer (M2): AI prompt / runtime / services        | `src/main/services/tasks/tasks-v2-ai-prompt.ts`, `tasks-v2-ai-runtime.ts` (cap + bounded call), `tasks-v2-rightnow-service.ts`, `tasks-v2-checkin-service.ts`, `tasks-v2-ai-wiring.ts` (scheduler) · handlers `src/main/ipc/tasks-v2-ai-handlers.ts` · check-in store `src/main/db/queries-tasks-v2-checkins.ts` · UI `TaskV2RightNow.tsx` + `TaskV2Checkin.tsx`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Query layer (sole table reader/writer)                  | `src/main/db/queries-tasks-v2.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| List query layer (sole `tasks_v2_lists` writer)         | `src/main/db/queries-tasks-v2-lists.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Context query layer (sole `task_context_items` writer)  | `src/main/db/queries-tasks-v2-context.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| IPC handlers                                            | `src/main/ipc/tasks-v2-handlers.ts`, `src/main/ipc/tasks-v2-lists-handlers.ts`, `src/main/ipc/tasks-v2-context-handlers.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| IPC request/response schemas                            | `src/shared/ipc-schemas/tasks-v2.ts`, `src/shared/ipc-schemas/tasks-v2-lists.ts`, `src/shared/ipc-schemas/tasks-v2-context.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Push event schema                                       | `src/shared/push-event-schemas/tasks-v2.ts`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

## Related

The overview, the other parts, and everything else worth reading next all sit on [Tasks (markdown outliner, in development)](tasks-v2.md).
