feat: add summary layer for tasks and note history (v1.15.0)

Tasks and archived notes now support a one-sentence `summary` field
that serves as a table-of-contents entry. Task lists show summaries
inline, note history displays summaries instead of truncated text.
Auto-migration via ALTER TABLE for existing databases.

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.11.0 | **Sprachen:** 11 | **Repo:** https://github.com/CSCSoftware/AiDex
+**Version:** 1.15.0 | **Sprachen:** 11 | **Repo:** https://github.com/CSCSoftware/AiDex
 
 ## Build & Run
 

CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to AiDex will be documented in this file.
 
 ## [Unreleased]
 
+## [1.15.0] - 2026-03-17
+
+### Added
+- **Task summaries**: Tasks now support a `summary` field — a one-sentence table-of-contents entry (~150 chars) that the AI writes on create/update. `aidex_tasks` shows summaries inline so you can scan the backlog without reading full details.
+- **Note history summaries**: Archived notes now get an optional `summary` field. When a note is overwritten or cleared, a summary can be provided for the archive. `aidex_note` with `history: true` shows summaries (with fallback to truncated preview for older notes). Search also matches summaries.
+- **Auto-migration**: Existing databases are automatically upgraded with `ALTER TABLE ADD COLUMN summary` — no manual migration needed.
+- **Viewer integration**: Task summaries shown in italic between title and description in the browser viewer.
+
 ## [1.14.0] - 2026-03-10
 
 ### Added

MCP-API-REFERENCE.md

@@ -578,6 +578,7 @@ Read or write session notes. Persists in the database between sessions.
 | `history` | boolean | - | Show archived note history, newest first (default: false) |
 | `search` | string | - | Search term to find in note history (case-insensitive) |
 | `limit` | number | - | Max history/search entries to return (default: 20) |
+| `summary` | string | - | One-sentence summary for the archived note (~150 chars). Provide when writing (old note gets archived with this summary) or clearing. |
 
 **Operations:**
 
@@ -595,8 +596,8 @@ Read or write session notes. Persists in the database between sessions.
 // Read note
 { "path": "." }
 
-// Write note (old note auto-archived)
-{ "path": ".", "note": "Test glob fix after restart" }
+// Write note with summary for archive (old note auto-archived with summary)
+{ "path": ".", "note": "Test glob fix after restart", "summary": "Previous: finished parser refactoring and tests" }
 
 // Append to note
 { "path": ".", "note": "Also check edge cases", "append": true }
@@ -669,6 +670,7 @@ Manage a single task in the project backlog. Tasks persist in the AiDex database
 | `id` | number | for read/update/delete/log | Task ID |
 | `title` | string | for create | Task title |
 | `description` | string | - | Task description (optional details) |
+| `summary` | string | - | One-sentence summary (~150 chars). Shown in task list as table-of-contents. Write on create, update on changes. |
 | `priority` | number | - | `1` = high, `2` = medium (default), `3` = low |
 | `status` | string | - | `backlog` (default), `active`, `done`, `cancelled` |
 | `tags` | string | - | Comma-separated tags (e.g., `"bug, viewer"`) |
@@ -690,10 +692,11 @@ Manage a single task in the project backlog. Tasks persist in the AiDex database
 
 **Examples:**
 ```json
-// Create a high-priority bug task
+// Create a high-priority bug task with summary
 {
   "path": ".", "action": "create",
   "title": "Fix memory leak in parser",
+  "summary": "Parser allocates unbounded buffers for nested generics",
   "priority": 1, "tags": "bug, parser"
 }
 
@@ -728,6 +731,7 @@ List and filter tasks in the project backlog. Returns tasks grouped by status an
 **Returns:**
 - Tasks grouped by status (Active → Backlog → Done → Cancelled)
 - Priority icons: 🔴 high, 🟡 medium, ⚪ low
+- Task summaries shown inline (one-sentence table-of-contents)
 - Tags displayed inline
 
 **Examples:**
@@ -1045,7 +1049,7 @@ SQLite database at `.aidex/index.db`:
 | `dependencies` | Linked projects |
 | `project_files` | All files with type classification |
 | `metadata` | Key-value store (session times, notes, etc.) |
-| `tasks` | Project backlog tasks (priority, status, tags, timestamps) |
+| `tasks` | Project backlog tasks (priority, status, tags, summary, timestamps) |
 | `task_log` | Task history log (auto-logged status changes + manual notes) |
 
 ---

README.md

@@ -458,11 +458,17 @@ aidex_note({ path: ".", clear: true })                                 # Clear
 **Note History** (v1.10): Old notes are automatically archived when overwritten or cleared. Browse and search past notes:
 
 ```
-aidex_note({ path: ".", history: true })                    # Browse archived notes
-aidex_note({ path: ".", search: "parser" })                 # Search note history
+aidex_note({ path: ".", history: true })                    # Browse archived notes (shows summaries)
+aidex_note({ path: ".", search: "parser" })                 # Search note history (searches summaries too)
 aidex_note({ path: ".", history: true, limit: 5 })          # Last 5 archived notes
 ```
 
+**Note Summaries** (v1.15): Provide a `summary` when writing/clearing a note — the archived note gets this one-sentence description. History then shows summaries instead of truncated text:
+
+```
+aidex_note({ path: ".", note: "New focus", summary: "Previous session: finished parser refactoring" })
+```
+
 **Use cases:**
 - Before ending a session: *"Remember to test X next time"*
 - AI auto-reminder: Save what to verify after a restart
@@ -476,13 +482,14 @@ Notes are stored in the SQLite database (`.aidex/index.db`) and persist indefini
 Keep your project tasks right next to your code index - no Jira, no Trello, no context switching:
 
 ```
-aidex_task({ path: ".", action: "create", title: "Fix parser bug", priority: 1, tags: "bug" })
+aidex_task({ path: ".", action: "create", title: "Fix parser bug", priority: 1, tags: "bug", summary: "Parser crashes on nested generics in C#" })
 aidex_task({ path: ".", action: "update", id: 1, status: "done" })
 aidex_task({ path: ".", action: "log", id: 1, note: "Root cause: unbounded buffer" })
 aidex_tasks({ path: ".", status: "active" })
 ```
 
 **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.)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidex-mcp",
-  "version": "1.14.1",
+  "version": "1.15.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/note.ts

@@ -26,11 +26,13 @@ export interface NoteParams {
     history?: boolean;  // If true, shows archived note history
     search?: string;    // If provided, searches note history for this term
     limit?: number;     // Max history entries to return (default 20)
+    summary?: string;   // One-sentence summary for the archived note (~150 chars)
 }
 
 export interface NoteHistoryEntry {
     id: number;
     note: string;
+    summary: string | null;
     created_at: number;
 }
 
@@ -80,10 +82,18 @@ export function note(params: NoteParams): NoteResult {
                 CREATE TABLE IF NOT EXISTS note_history (
                     id INTEGER PRIMARY KEY AUTOINCREMENT,
                     note TEXT NOT NULL,
+                    summary TEXT,
                     created_at INTEGER NOT NULL
                 );
                 CREATE INDEX IF NOT EXISTS idx_note_history_created ON note_history(created_at);
             `);
+            // Add summary column if missing (for existing DBs before v1.15)
+            const hasSummary = db.getDb().prepare(
+                "SELECT COUNT(*) as cnt FROM pragma_table_info('note_history') WHERE name = 'summary'"
+            ).get() as { cnt: number };
+            if (hasSummary.cnt === 0) {
+                db.getDb().exec('ALTER TABLE note_history ADD COLUMN summary TEXT');
+            }
         }
 
         // --- Search history ---
@@ -117,7 +127,7 @@ export function note(params: NoteParams): NoteResult {
             // Archive current note before clearing
             const existing = db.getMetadata(NOTE_KEY);
             if (existing) {
-                db.archiveNote(existing);
+                db.archiveNote(existing, params.summary);
             }
             db.deleteMetadata(NOTE_KEY);
             return {
@@ -140,7 +150,7 @@ export function note(params: NoteParams): NoteResult {
                 // Overwrite: archive the old note first
                 const existing = db.getMetadata(NOTE_KEY);
                 if (existing) {
-                    db.archiveNote(existing);
+                    db.archiveNote(existing, params.summary);
                 }
             }
 

src/commands/task.ts

@@ -23,6 +23,7 @@ export interface TaskParams {
     id?: number;
     title?: string;
     description?: string;
+    summary?: string;
     priority?: 1 | 2 | 3;
     status?: 'backlog' | 'active' | 'done' | 'cancelled';
     tags?: string;
@@ -62,6 +63,7 @@ CREATE TABLE IF NOT EXISTS tasks (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     title TEXT NOT NULL,
     description TEXT,
+    summary TEXT,
     priority INTEGER NOT NULL DEFAULT 2 CHECK(priority IN (1, 2, 3)),
     status TEXT NOT NULL DEFAULT 'backlog' CHECK(status IN ('backlog', 'active', 'done', 'cancelled')),
     tags TEXT,
@@ -90,6 +92,7 @@ CREATE TABLE IF NOT EXISTS tasks_new (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     title TEXT NOT NULL,
     description TEXT,
+    summary TEXT,
     priority INTEGER NOT NULL DEFAULT 2 CHECK(priority IN (1, 2, 3)),
     status TEXT NOT NULL DEFAULT 'backlog' CHECK(status IN ('backlog', 'active', 'done', 'cancelled')),
     tags TEXT,
@@ -99,7 +102,8 @@ CREATE TABLE IF NOT EXISTS tasks_new (
     updated_at INTEGER NOT NULL,
     completed_at INTEGER
 );
-INSERT INTO tasks_new SELECT * FROM tasks;
+INSERT INTO tasks_new (id, title, description, priority, status, tags, source, sort_order, created_at, updated_at, completed_at)
+    SELECT id, title, description, priority, status, tags, source, sort_order, created_at, updated_at, completed_at FROM tasks;
 DROP TABLE tasks;
 ALTER TABLE tasks_new RENAME TO tasks;
 CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
@@ -115,6 +119,14 @@ function ensureTaskTables(db: AiDexDatabase): void {
     if (tableInfo?.sql && !tableInfo.sql.includes('cancelled')) {
         sqlite.exec(TASKS_MIGRATE_CANCELLED);
     }
+
+    // Add summary column if missing (for existing DBs before v1.15)
+    const hasSummary = sqlite.prepare(
+        "SELECT COUNT(*) as cnt FROM pragma_table_info('tasks') WHERE name = 'summary'"
+    ).get() as { cnt: number };
+    if (hasSummary.cnt === 0) {
+        sqlite.exec('ALTER TABLE tasks ADD COLUMN summary TEXT');
+    }
 }
 
 // ============================================================
@@ -146,6 +158,7 @@ export function task(params: TaskParams): TaskResult {
                         const id = queries.insertTask(
                             params.title,
                             params.description ?? null,
+                            params.summary ?? null,
                             params.priority ?? 2,
                             params.status ?? 'backlog',
                             params.tags ?? null,
@@ -177,6 +190,7 @@ export function task(params: TaskParams): TaskResult {
                         const fields: Record<string, unknown> = {};
                         if (params.title !== undefined) fields.title = params.title;
                         if (params.description !== undefined) fields.description = params.description;
+                        if (params.summary !== undefined) fields.summary = params.summary;
                         if (params.priority !== undefined) fields.priority = params.priority;
                         if (params.status !== undefined) fields.status = params.status;
                         if (params.tags !== undefined) fields.tags = params.tags;

src/db/database.ts

@@ -79,28 +79,28 @@ export class AiDexDatabase {
     /**
      * Archive a note to the history table (called before overwriting)
      */
-    archiveNote(note: string): void {
+    archiveNote(note: string, summary?: string | null): void {
         this.db.prepare(
-            'INSERT INTO note_history (note, created_at) VALUES (?, ?)'
-        ).run(note, Date.now());
+            'INSERT INTO note_history (note, summary, created_at) VALUES (?, ?, ?)'
+        ).run(note, summary ?? null, Date.now());
     }
 
     /**
      * Get note history entries, newest first
      */
-    getNoteHistory(limit = 50): Array<{ id: number; note: string; created_at: number }> {
+    getNoteHistory(limit = 50): Array<{ id: number; note: string; summary: string | null; created_at: number }> {
         return this.db.prepare(
-            'SELECT id, note, created_at FROM note_history ORDER BY created_at DESC LIMIT ?'
-        ).all(limit) as Array<{ id: number; note: string; created_at: number }>;
+            'SELECT id, note, summary, created_at FROM note_history ORDER BY created_at DESC LIMIT ?'
+        ).all(limit) as Array<{ id: number; note: string; summary: string | null; created_at: number }>;
     }
 
     /**
      * Search note history by text (case-insensitive LIKE)
      */
-    searchNoteHistory(query: string, limit = 20): Array<{ id: number; note: string; created_at: number }> {
+    searchNoteHistory(query: string, limit = 20): Array<{ id: number; note: string; summary: string | null; created_at: number }> {
         return this.db.prepare(
-            'SELECT id, note, created_at FROM note_history WHERE note LIKE ? ORDER BY created_at DESC LIMIT ?'
-        ).all(`%${query}%`, limit) as Array<{ id: number; note: string; created_at: number }>;
+            'SELECT id, note, summary, created_at FROM note_history WHERE note LIKE ? OR summary LIKE ? ORDER BY created_at DESC LIMIT ?'
+        ).all(`%${query}%`, `%${query}%`, limit) as Array<{ id: number; note: string; summary: string | null; created_at: number }>;
     }
 
     /**

src/db/queries.ts

@@ -84,6 +84,7 @@ export interface TaskRow {
     id: number;
     title: string;
     description: string | null;
+    summary: string | null;
     priority: 1 | 2 | 3;
     status: 'backlog' | 'active' | 'done' | 'cancelled';
     tags: string | null;
@@ -546,22 +547,23 @@ export class Queries {
     insertTask(
         title: string,
         description: string | null,
+        summary: string | null,
         priority: 1 | 2 | 3,
         status: 'backlog' | 'active' | 'done' | 'cancelled',
         tags: string | null,
         source: string | null,
         sortOrder: number
     ): number {
         this._insertTask ??= this.db.prepare(
-            'INSERT INTO tasks (title, description, priority, status, tags, source, sort_order, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)'
+            'INSERT INTO tasks (title, description, summary, priority, status, tags, source, sort_order, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)'
         );
         const now = Date.now();
-        const result = this._insertTask.run(title, description, priority, status, tags, source, sortOrder, now, now);
+        const result = this._insertTask.run(title, description, summary, priority, status, tags, source, sortOrder, now, now);
         return result.lastInsertRowid as number;
     }
 
-    updateTask(id: number, fields: Partial<Pick<TaskRow, 'title' | 'description' | 'priority' | 'status' | 'tags' | 'source' | 'sort_order'>>): boolean {
-        const ALLOWED_FIELDS = new Set(['title', 'description', 'status', 'priority', 'tags', 'source', 'sort_order', 'completed_at']);
+    updateTask(id: number, fields: Partial<Pick<TaskRow, 'title' | 'description' | 'summary' | 'priority' | 'status' | 'tags' | 'source' | 'sort_order'>>): boolean {
+        const ALLOWED_FIELDS = new Set(['title', 'description', 'summary', 'status', 'priority', 'tags', 'source', 'sort_order', 'completed_at']);
         const sets: string[] = [];
         const values: unknown[] = [];
         for (const [key, value] of Object.entries(fields)) {

src/db/schema.sql

@@ -134,6 +134,7 @@ CREATE TABLE IF NOT EXISTS tasks (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     title TEXT NOT NULL,
     description TEXT,
+    summary TEXT,
     priority INTEGER NOT NULL DEFAULT 2 CHECK(priority IN (1, 2, 3)),
     status TEXT NOT NULL DEFAULT 'backlog' CHECK(status IN ('backlog', 'active', 'done', 'cancelled')),
     tags TEXT,
@@ -166,6 +167,7 @@ CREATE INDEX IF NOT EXISTS idx_task_log_task ON task_log(task_id);
 CREATE TABLE IF NOT EXISTS note_history (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     note TEXT NOT NULL,
+    summary TEXT,
     created_at INTEGER NOT NULL
 );