feat: add Global Task Scheduler — due dates, recurring intervals, cross-project triggers

Tasks can now have due dates (relative like "3d" or ISO), repeat intervals,
actions, and auto-execute flags. Overdue tasks are reported at every
aidex_session call across ALL projects via a fast global mirror table.

- New task fields: due, interval, action, auto_go
- Global mirror: scheduled_tasks table in ~/.aidex/global.db
- Session hook: checkScheduledTasks() runs on every session start
- Auto-migration: existing project DBs get new columns automatically
- 26 tests covering scheduler logic, task CRUD, global sync
- Docs: README, CHANGELOG, MCP-API-REFERENCE, CLAUDE.md updated

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: CSCSoftware

.claude/CLAUDE.md

@@ -2,7 +2,7 @@
 
 MCP Server für persistentes Code-Indexing. Ermöglicht Claude Code schnelle, präzise Suchen statt Grep/Glob.
 
-**Version:** 1.16.3 | **Sprachen:** 11 | **Repo:** https://github.com/CSCSoftware/AiDex
+**Version:** 1.17.0 | **Sprachen:** 11 | **Repo:** https://github.com/CSCSoftware/AiDex
 
 ## Build & Run
 
@@ -77,8 +77,8 @@ Registriert als MCP Server `aidex` (Prefix: `mcp__aidex__aidex_*`).
 ### Task Backlog (v1.8+)
 | Tool | Beschreibung |
 |------|--------------|
-| `aidex_task` | Task CRUD + Log (create/read/update/delete/log) |
-| `aidex_tasks` | Tasks auflisten, filtern nach Status/Priority/Tag |
+| `aidex_task` | Task CRUD + Log + Scheduler (due/interval/action/auto_go) |
+| `aidex_tasks` | Tasks auflisten, filtern nach Status/Priority/Tag. Zeigt due-Daten + Intervalle |
 
 Status: `backlog → active → done | cancelled`
 
@@ -158,8 +158,9 @@ src/
 | `signatures` | Header-Kommentare |
 | `project_files` | Alle Dateien mit Typ |
 | `metadata` | Key-Value (Sessions, Notizen) |
-| `tasks` | Backlog-Tasks (Priority, Status, Tags) |
+| `tasks` | Backlog-Tasks (Priority, Status, Tags, Scheduling: due/interval/action/auto_go) |
 | `task_log` | Task-Historie (Auto-Log bei Änderungen) |
+| `scheduled_tasks` | Global Scheduler Mirror in ~/.aidex/global.db (project_path, task_id, due) |
 
 ## Wichtige Features
 
@@ -204,6 +205,17 @@ aidex_tasks({ path: ".", status: "active", tag: "bug" })    # Gefiltert
 - Auto-Log bei Status-Änderungen und Task-Erstellung
 - Viewer: Tasks-Tab mit Priority-Farben, Done-Toggle, Cancelled-Sektion (durchgestrichen)
 
+### Task Scheduler (v1.17)
+```
+aidex_task({ path: ".", action: "create", title: "Check PR", due: "3d", interval: "3d", task_action: "gh pr list" })
+aidex_task({ path: ".", action: "create", title: "One-shot", due: "1w" })
+```
+- Due: `"30m"`, `"2h"`, `"3d"`, `"1w"` oder ISO-Datum
+- Intervall: Automatisch weitergesetzt nach Trigger
+- One-Shot: `due` wird nach Trigger gelöscht
+- Cross-Project: Bei jedem `aidex_session` werden fällige Tasks aus ALLEN Projekten gemeldet
+- `auto_go: true`: Aktion wird automatisch ausgeführt
+
 ### Screenshots (v1.9, Optimierung v1.13)
 ```
 aidex_screenshot()                                             # Ganzer Bildschirm

CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to AiDex will be documented in this file.
 
 ## [Unreleased]
 
+## [1.17.0] - 2026-04-07
+
+### Added
+- **Task Scheduler**: Tasks can now have due dates (`due`), repeat intervals (`interval`), actions (`task_action`), and auto-execute flag (`auto_go`)
+  - **Due dates**: Relative (`"3d"`, `"1w"`) or ISO date (`"2026-04-10"`)
+  - **Recurring tasks**: Automatically advance due date by interval after each trigger
+  - **One-shot tasks**: Due date cleared after trigger
+  - **Cross-project**: Overdue tasks reported at every `aidex_session` call — even from other projects
+  - **Global mirror**: `scheduled_tasks` table in `~/.aidex/global.db` for fast cross-project lookups
+  - **Auto-migration**: Existing databases get new columns automatically
+- **Test suite**: First tests for AiDex — 26 tests covering scheduler logic, task CRUD, global sync
+
 ## [1.16.3] - 2026-03-26
 
 ### Fixed

MCP-API-REFERENCE.md

@@ -679,6 +679,10 @@ Manage a single task in the project backlog. Tasks persist in the AiDex database
 | `source` | string | - | Where the task came from (e.g., `"code review of parser.ts:142"`) |
 | `sort_order` | number | - | Sort order within same priority (lower = first, default: 0) |
 | `note` | string | for log | Log note text |
+| `due` | string | - | Due date: ISO date (`"2026-04-10"`) or relative from now (`"3d"`, `"1w"`, `"12h"`). Set to `""` to clear. |
+| `interval` | string | - | Repeat interval after trigger: `"30m"`, `"2h"`, `"3d"`, `"1w"`. Omit or `""` for one-shot. |
+| `task_action` | string | - | What to do when triggered (description of the action to perform) |
+| `auto_go` | boolean | - | If `true`, auto-execute the action on trigger. Default: `false`. |
 
 **Actions:**
 
@@ -692,6 +696,8 @@ Manage a single task in the project backlog. Tasks persist in the AiDex database
 
 **Auto-logging:** Status changes and task creation are automatically recorded in the task history.
 
+**Task Scheduler:** Tasks with `due` dates are tracked globally in `~/.aidex/global.db`. At every `aidex_session` call, overdue tasks from ALL projects are reported. Recurring tasks (`interval` set) automatically advance their due date. Setting a task to `done`/`cancelled` or clearing `due` removes it from the scheduler.
+
 **Examples:**
 ```json
 // Create a high-priority bug task with summary
@@ -713,6 +719,32 @@ Manage a single task in the project backlog. Tasks persist in the AiDex database
 
 // Add a log note
 { "path": ".", "action": "log", "id": 1, "note": "Root cause found: unbounded buffer" }
+
+// Create a recurring task — check every 3 days
+{
+  "path": ".", "action": "create",
+  "title": "Check PR status",
+  "due": "3d", "interval": "3d",
+  "task_action": "gh pr list --state open"
+}
+
+// One-shot reminder in 1 week
+{
+  "path": ".", "action": "create",
+  "title": "Follow up on review",
+  "due": "1w"
+}
+
+// Auto-execute task
+{
+  "path": ".", "action": "create",
+  "title": "Refresh project stats",
+  "due": "1d", "interval": "1d",
+  "auto_go": true
+}
+
+// Clear a task's schedule
+{ "path": ".", "action": "update", "id": 3, "due": "" }
 ```
 
 ---
@@ -735,6 +767,8 @@ List and filter tasks in the project backlog. Returns tasks grouped by status an
 - Priority icons: 🔴 high, 🟡 medium, ⚪ low
 - Task summaries shown inline (one-sentence table-of-contents)
 - Tags displayed inline
+- Due dates shown with ⏰ indicator (OVERDUE if past due)
+- Recurring intervals displayed inline
 
 **Examples:**
 ```json

README.md

@@ -30,7 +30,7 @@ AiDex is an MCP server that gives AI coding assistants instant access to your en
 | **Global Search** | `global_init`, `global_query`, `global_signatures`, `global_status`, `global_refresh` | Search across ALL your projects at once — "Have I ever written X?" |
 | **Guidelines** | `global_guideline` | Persistent AI instructions & coding conventions — shared across all projects |
 | **Sessions** | `session`, `note` | Track sessions, detect external changes, leave notes for next session (with searchable history) |
-| **Task Backlog** | `task`, `tasks` | Built-in task management with priorities, tags, and auto-logged history |
+| **Task Backlog** | `task`, `tasks` | Built-in task management with priorities, tags, auto-logged history, and **scheduled/recurring tasks** |
 | **Log Hub** | `log` | Universal log receiver — any program sends logs via HTTP, queryable by the AI, live in Viewer |
 | **Screenshots** | `screenshot`, `windows` | Cross-platform screen capture with LLM optimization — scale + color reduction saves up to 95% tokens |
 | **Viewer** | `viewer` | Interactive browser UI with file tree, signatures, tasks, logs, and live reload |
@@ -314,7 +314,7 @@ Do I want to search code?
 | Global Search | `aidex_global_init`, `aidex_global_query`, `aidex_global_signatures`, `aidex_global_status`, `aidex_global_refresh` | Search across ALL projects |
 | Guidelines | `aidex_global_guideline` | Persistent AI instructions & conventions (key-value, global) |
 | Sessions | `aidex_session`, `aidex_note` | Track sessions, leave notes (with searchable history) |
-| Tasks | `aidex_task`, `aidex_tasks` | Built-in backlog with priorities, tags, summaries, auto-logged history |
+| Tasks | `aidex_task`, `aidex_tasks` | Built-in backlog with priorities, tags, summaries, auto-logged history, scheduled/recurring tasks |
 | Log Hub | `aidex_log` | Universal log receiver — any program sends logs via HTTP, AI queries them, live in Viewer |
 | Screenshots | `aidex_screenshot`, `aidex_windows` | Screen capture with LLM optimization (scale + color reduction, no index needed) |
 | Viewer | `aidex_viewer` | Interactive browser UI with file tree, signatures, tasks, and live logs |
@@ -342,6 +342,9 @@ aidex_task({ path: ".", action: "create", title: "Fix bug", priority: 1, tags: "
 aidex_task({ path: ".", action: "update", id: 1, status: "done" })
 aidex_task({ path: ".", action: "log", id: 1, note: "Root cause found" })
 aidex_tasks({ path: ".", status: "active" })
+
+# Scheduled & recurring tasks
+aidex_task({ path: ".", action: "create", title: "Check PR status", due: "3d", interval: "3d", task_action: "gh pr list" })
 ```
 Priority: 1=high, 2=medium, 3=low | Status: `backlog → active → done | cancelled`
 
@@ -492,12 +495,32 @@ aidex_task({ path: ".", action: "log", id: 1, note: "Root cause: unbounded buffe
 aidex_tasks({ path: ".", status: "active" })
 ```
 
+### Scheduled & Recurring Tasks
+
+Tasks can have due dates and repeat intervals. Overdue tasks are reported at every session start across ALL projects:
+
+```
+# One-shot: remind in 3 days
+aidex_task({ path: ".", action: "create", title: "Review PR", due: "3d", task_action: "Check if PR was submitted" })
+
+# Recurring: check every week
+aidex_task({ path: ".", action: "create", title: "Check dependencies", due: "1w", interval: "1w", task_action: "npm outdated" })
+
+# Auto-execute: runs the action automatically when due
+aidex_task({ path: ".", action: "create", title: "Refresh stats", due: "1d", interval: "1d", auto_go: true })
+```
+
+**Due formats:** Relative (`"30m"`, `"2h"`, `"3d"`, `"1w"`) or ISO date (`"2026-04-10"`)
+
+At every `aidex_session` call, the **Task Scheduler** checks `~/.aidex/global.db` for due tasks across all projects — even if you're working on a different project. Recurring tasks automatically advance their due date after each trigger.
+
 **Features:**
 - **Summaries**: One-sentence table-of-contents per task — scan the backlog without reading full details
 - **Priorities**: 🔴 high, 🟡 medium, ⚪ low
 - **Statuses**: `backlog → active → done | cancelled`
 - **Tags**: Categorize tasks (`bug`, `feature`, `docs`, etc.)
 - **History log**: Every status change is auto-logged, plus manual notes
+- **Scheduling**: Due dates, recurring intervals, actions, auto-execute across all projects
 - **Viewer integration**: Tasks tab in the browser viewer with live updates
 - **Persistent**: Tasks survive between sessions, stored in `.aidex/index.db`
 

jest.config.js

@@ -0,0 +1,6 @@
+/** @type {import('jest').Config} */
+export default {
+    testMatch: ['**/tests/**/*.test.js'],
+    testEnvironment: 'node',
+    transform: {},
+};

package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidex-mcp",
-  "version": "1.16.3",
+  "version": "1.17.0",
   "mcpName": "io.github.CSCSoftware/aidex",
   "description": "MCP Server for persistent code indexing. Gives AI assistants (Claude, Gemini, Copilot, Cursor) instant access to your codebase. 50x less context than grep.",
   "main": "build/index.js",

src/commands/global/global-scheduler.ts

@@ -0,0 +1,138 @@
+/**
+ * Global Task Scheduler
+ *
+ * Checks for due tasks across all projects at session start.
+ * Processes due tasks: reports them, advances recurring intervals.
+ *
+ * Architecture:
+ * - Tasks with `due` dates are mirrored in global.db/scheduled_tasks
+ * - On every aidex_session call, this module scans for due tasks
+ * - Recurring tasks get their `due` advanced by `interval`
+ * - One-shot tasks get `due` cleared after trigger
+ */
+
+import { existsSync } from 'fs';
+import { join, resolve } from 'path';
+import { openDatabase, createQueries } from '../../db/index.js';
+import { GlobalDatabase, globalDbExists, type ScheduledTaskRow } from '../../db/global-database.js';
+import { INDEX_DIR } from '../../constants.js';
+import type { TaskRow } from '../../db/queries.js';
+import { parseIntervalToMs } from '../shared.js';
+import { ensureTaskTables } from '../task.js';
+
+// ============================================================
+// Types
+// ============================================================
+
+export interface DueTask {
+    projectPath: string;
+    projectName: string;
+    task: TaskRow;
+    autoGo: boolean;
+}
+
+export interface SchedulerResult {
+    active: boolean;
+    dueTasks: DueTask[];
+    processed: number;
+    errors: string[];
+}
+
+// ============================================================
+// Scheduler Check
+// ============================================================
+
+/**
+ * Check for due scheduled tasks across all projects.
+ * Called from session.ts at every session start/continue.
+ */
+export function checkScheduledTasks(): SchedulerResult {
+    if (!globalDbExists()) {
+        return { active: false, dueTasks: [], processed: 0, errors: [] };
+    }
+
+    let globalDb: GlobalDatabase | null = null;
+    try {
+        globalDb = new GlobalDatabase();
+        const now = Date.now();
+        const dueRows = globalDb.getDueScheduledTasks(now);
+
+        if (dueRows.length === 0) {
+            return { active: true, dueTasks: [], processed: 0, errors: [] };
+        }
+
+        const dueTasks: DueTask[] = [];
+        const errors: string[] = [];
+
+        for (const row of dueRows) {
+            try {
+                const projectPath = resolve(row.project_path);
+                const dbPath = join(projectPath, INDEX_DIR, 'index.db');
+
+                if (!existsSync(dbPath)) {
+                    // Project DB missing — remove stale entry
+                    globalDb.removeScheduledTask(row.project_path, row.task_id);
+                    errors.push(`Stale schedule removed: DB missing at ${row.project_path}`);
+                    continue;
+                }
+
+                const db = openDatabase(dbPath, false);
+                try {
+                    // Ensure scheduler columns exist (migration for older DBs)
+                    ensureTaskTables(db);
+                    const queries = createQueries(db);
+                    const task = queries.getTaskById(row.task_id);
+
+                    if (!task) {
+                        // Task deleted externally
+                        globalDb.removeScheduledTask(row.project_path, row.task_id);
+                        continue;
+                    }
+
+                    if (task.status === 'done' || task.status === 'cancelled') {
+                        // Task completed/cancelled externally
+                        globalDb.removeScheduledTask(row.project_path, row.task_id);
+                        continue;
+                    }
+
+                    // Get project name
+                    const projectName = row.project_path.split('/').pop() || row.project_path;
+
+                    dueTasks.push({
+                        projectPath: row.project_path,
+                        projectName,
+                        task,
+                        autoGo: row.auto_go === 1,
+                    });
+
+                    // Advance the schedule
+                    if (row.interval) {
+                        const intervalMs = parseIntervalToMs(row.interval);
+                        if (intervalMs) {
+                            const nextDue = now + intervalMs;
+                            // Update project DB
+                            queries.updateTask(row.task_id, { due: nextDue });
+                            // Update global mirror
+                            globalDb.updateScheduledTaskDue(row.project_path, row.task_id, nextDue);
+                        }
+                    } else {
+                        // One-shot: clear due in project DB, remove from global
+                        queries.updateTask(row.task_id, { due: null });
+                        globalDb.removeScheduledTask(row.project_path, row.task_id);
+                    }
+                } finally {
+                    db.close();
+                }
+            } catch (err) {
+                errors.push(`Error: task #${row.task_id} in ${row.project_path}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+
+        return { active: true, dueTasks, processed: dueTasks.length, errors };
+    } catch {
+        // Don't let scheduler errors break anything
+        return { active: false, dueTasks: [], processed: 0, errors: [] };
+    } finally {
+        globalDb?.close();
+    }
+}

src/commands/global/index.ts

@@ -8,3 +8,5 @@ export { globalQuery, invalidateGlobalCache, type GlobalQueryParams, type Global
 export { globalSignatures, type GlobalSignaturesParams, type GlobalSignaturesResult, type GlobalSignaturesProjectResult, type GlobalMethodMatch, type GlobalTypeMatch, type SignatureKind } from './global-signatures.js';
 export { globalRefresh, type GlobalRefreshParams, type GlobalRefreshResult } from './global-refresh.js';
 export { globalGuideline, type GlobalGuidelineParams, type GlobalGuidelineResult, type GuidelineAction } from './global-guideline.js';
+export { checkScheduledTasks, type SchedulerResult, type DueTask } from './global-scheduler.js';
+export { parseDueDate, parseIntervalToMs } from '../shared.js';