agkan 1.0.0

package/dist/services/TaskBlockService.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskBlockService = void 0;
+const connection_1 = require("../db/connection");
+const TaskService_1 = require("./TaskService");
+/**
+ * Task Block Service
+ * Manages blocking relationships between tasks
+ */
+class TaskBlockService {
+    constructor(db, taskService) {
+        this.db = db || (0, connection_1.getDatabase)();
+        this.taskService = taskService || new TaskService_1.TaskService(this.db);
+    }
+    /**
+     * Add a blocking relationship between tasks
+     * @param input - Creation input for the blocking relationship
+     * @returns Created blocking relationship
+     * @throws Error if tasks do not exist, self-reference is detected, or circular reference would be created
+     */
+    addBlock(input) {
+        const db = this.db;
+        // Check for self-reference: prevent a task from blocking itself
+        if (input.blocker_task_id === input.blocked_task_id) {
+            throw new Error('Task cannot block itself');
+        }
+        // Verify both tasks exist in the database
+        const blockerTask = this.taskService.getTask(input.blocker_task_id);
+        if (!blockerTask) {
+            throw new Error(`Blocker task with id ${input.blocker_task_id} does not exist`);
+        }
+        const blockedTask = this.taskService.getTask(input.blocked_task_id);
+        if (!blockedTask) {
+            throw new Error(`Blocked task with id ${input.blocked_task_id} does not exist`);
+        }
+        // Check for circular reference: ensure new blocking relationship doesn't create a cycle
+        if (this.wouldCreateBlockCycle(input.blocker_task_id, input.blocked_task_id)) {
+            throw new Error(`Cannot create block relationship: would create circular dependency between tasks ${input.blocker_task_id} and ${input.blocked_task_id}`);
+        }
+        const now = new Date().toISOString();
+        const stmt = db.prepare(`
+      INSERT INTO task_blocks (blocker_task_id, blocked_task_id, created_at)
+      VALUES (?, ?, ?)
+    `);
+        const result = stmt.run(input.blocker_task_id, input.blocked_task_id, now);
+        const getStmt = db.prepare('SELECT * FROM task_blocks WHERE id = ?');
+        return getStmt.get(result.lastInsertRowid);
+    }
+    /**
+     * Remove a blocking relationship between tasks
+     * @param blockerId - ID of the blocking task
+     * @param blockedId - ID of the blocked task
+     * @returns True if removal was successful, false if relationship was not found
+     */
+    removeBlock(blockerId, blockedId) {
+        const db = this.db;
+        const stmt = db.prepare(`
+      DELETE FROM task_blocks
+      WHERE blocker_task_id = ? AND blocked_task_id = ?
+    `);
+        const result = stmt.run(blockerId, blockedId);
+        return result.changes > 0;
+    }
+    /**
+     * Get IDs of tasks blocked by the specified task
+     * Returns a list of IDs for tasks that are blocked by the given blocker task
+     * @param blockerId - ID of the blocking task
+     * @returns Array of IDs for tasks blocked by this task
+     */
+    getBlockedTaskIds(blockerId) {
+        const db = this.db;
+        const stmt = db.prepare(`
+      SELECT blocked_task_id FROM task_blocks
+      WHERE blocker_task_id = ?
+    `);
+        const results = stmt.all(blockerId);
+        return results.map((row) => row.blocked_task_id);
+    }
+    /**
+     * Get IDs of tasks blocking the specified task
+     * Returns a list of IDs for tasks that block the given task
+     * @param blockedId - ID of the blocked task
+     * @returns Array of IDs for blocking tasks
+     */
+    getBlockerTaskIds(blockedId) {
+        const db = this.db;
+        const stmt = db.prepare(`
+      SELECT blocker_task_id FROM task_blocks
+      WHERE blocked_task_id = ?
+    `);
+        const results = stmt.all(blockedId);
+        return results.map((row) => row.blocker_task_id);
+    }
+    /**
+     * Check for circular references in blocking relationships (private method)
+     * Detects whether adding a new blocking relationship would create a cycle using BFS algorithm
+     * @param blockerId - ID of the blocking task
+     * @param blockedId - ID of the blocked task
+     * @returns True if a circular reference would be created, false otherwise
+     */
+    wouldCreateBlockCycle(blockerId, blockedId) {
+        const visited = new Set();
+        const queue = [blockedId];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (visited.has(current))
+                continue;
+            visited.add(current);
+            if (current === blockerId)
+                return true;
+            const blockedByCurrentIds = this.getBlockedTaskIds(current);
+            queue.push(...blockedByCurrentIds);
+        }
+        return false;
+    }
+}
+exports.TaskBlockService = TaskBlockService;
+//# sourceMappingURL=TaskBlockService.js.map

package/dist/services/TaskBlockService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskBlockService.js","sourceRoot":"","sources":["../../src/services/TaskBlockService.ts"],"names":[],"mappings":"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"}

package/dist/services/TaskService.d.ts

@@ -0,0 +1,89 @@
+import { Task, CreateTaskInput, UpdateTaskInput, TaskStatus } from '../models';
+import Database from 'better-sqlite3';
+/**
+ * Task Service
+ * Provides CRUD operations for tasks
+ */
+export declare class TaskService {
+    private db;
+    constructor(db?: Database.Database);
+    /**
+     * Create a new task
+     * @param input - Task creation input
+     * @returns Created task
+     */
+    createTask(input: CreateTaskInput): Task;
+    /**
+     * Get task by ID
+     * @param id - Task ID
+     * @returns Task, or null if not found
+     */
+    getTask(id: number): Task | null;
+    /**
+     * Get task list
+     * @param filters - Filter criteria (status, author, tagIds)
+     * @returns Array of tasks
+     */
+    listTasks(filters?: {
+        status?: TaskStatus;
+        author?: string;
+        tagIds?: number[];
+    }): Task[];
+    /**
+     * Build dynamic UPDATE query for task fields
+     * @param input - Update content
+     * @param id - Task ID (appended as last param for WHERE clause)
+     * @returns Object with sql string and params array
+     */
+    private buildUpdateQuery;
+    /**
+     * Update task
+     * @param id - Task ID
+     * @param input - Update content
+     * @returns Updated task, or null if not found
+     */
+    updateTask(id: number, input: UpdateTaskInput): Task | null;
+    /**
+     * Delete task
+     * @param id - Task ID
+     * @returns true if deletion succeeded, false if task not found
+     */
+    deleteTask(id: number): boolean;
+    /**
+     * Get task count by status
+     * @returns Map of task count for each status
+     */
+    getTaskCountByStatus(): Record<TaskStatus, number>;
+    /**
+     * Search tasks
+     * @param keyword - Search keyword (LIKE search on title and body)
+     * @param includeAll - If true, include done/closed tasks in search (default: false)
+     * @returns Array of matched tasks
+     */
+    searchTasks(keyword: string, includeAll?: boolean): Task[];
+    /**
+     * Get child tasks (direct children only)
+     * @param parentId - Parent task ID
+     * @returns Array of child tasks
+     */
+    getChildTasks(parentId: number): Task[];
+    /**
+     * Get parent task
+     * @param taskId - Task ID
+     * @returns Parent task, or null if no parent exists
+     */
+    getParentTask(taskId: number): Task | null;
+    /**
+     * Get descendant tasks iteratively (all descendants)
+     * @param parentId - Parent task ID
+     * @returns Array of all descendant tasks
+     */
+    getDescendantTasks(parentId: number): Task[];
+    /**
+     * Get root task (top-level parent)
+     * @param taskId - Task ID
+     * @returns Root task, or null if task not found
+     */
+    getRootTask(taskId: number): Task | null;
+}
+//# sourceMappingURL=TaskService.d.ts.map

package/dist/services/TaskService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskService.d.ts","sourceRoot":"","sources":["../../src/services/TaskService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAI/E,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ;IAIlC;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAqCxC;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAShC;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,UAAU,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,EAAE;IAkCxF;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IA8B3D;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAc/B;;;OAGG;IACH,oBAAoB,IAAI,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC;IA6BlD;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,IAAI,EAAE;IAiBjE;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IAMvC;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQ1C;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE;IAwB5C;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;CAuBzC"}

package/dist/services/TaskService.js

@@ -0,0 +1,285 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskService = void 0;
+const connection_1 = require("../db/connection");
+const input_validators_1 = require("../utils/input-validators");
+const cycle_detector_1 = require("../utils/cycle-detector");
+/**
+ * Task Service
+ * Provides CRUD operations for tasks
+ */
+class TaskService {
+    constructor(db) {
+        this.db = db || (0, connection_1.getDatabase)();
+    }
+    /**
+     * Create a new task
+     * @param input - Task creation input
+     * @returns Created task
+     */
+    createTask(input) {
+        const db = this.db;
+        const now = new Date().toISOString();
+        const status = input.status || 'backlog';
+        // Validate input fields
+        const validationErrors = (0, input_validators_1.validateTaskInput)(input);
+        if (validationErrors.length > 0) {
+            throw new Error(validationErrors[0].message);
+        }
+        // Validate parent_id: check if parent task exists
+        if (input.parent_id !== undefined && input.parent_id !== null) {
+            const parentTask = this.getTask(input.parent_id);
+            if (!parentTask) {
+                throw new Error(`Parent task with id ${input.parent_id} does not exist`);
+            }
+        }
+        const stmt = db.prepare(`
+      INSERT INTO tasks (title, body, author, status, parent_id, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `);
+        const result = stmt.run(input.title, input.body || null, input.author || null, status, input.parent_id !== undefined ? input.parent_id : null, now, now);
+        return this.getTask(result.lastInsertRowid);
+    }
+    /**
+     * Get task by ID
+     * @param id - Task ID
+     * @returns Task, or null if not found
+     */
+    getTask(id) {
+        const db = this.db;
+        const stmt = db.prepare('SELECT * FROM tasks WHERE id = ?');
+        const task = stmt.get(id);
+        return task || null;
+    }
+    /**
+     * Get task list
+     * @param filters - Filter criteria (status, author, tagIds)
+     * @returns Array of tasks
+     */
+    listTasks(filters) {
+        const db = this.db;
+        let query;
+        const params = [];
+        // Use JOIN when tag filter is specified
+        if (filters?.tagIds && filters.tagIds.length > 0) {
+            query = 'SELECT DISTINCT tasks.* FROM tasks INNER JOIN task_tags ON tasks.id = task_tags.task_id WHERE 1=1';
+            // Add IN clause for tag IDs
+            const placeholders = filters.tagIds.map(() => '?').join(', ');
+            query += ` AND task_tags.tag_id IN (${placeholders})`;
+            params.push(...filters.tagIds);
+        }
+        else {
+            query = 'SELECT * FROM tasks WHERE 1=1';
+        }
+        if (filters?.status) {
+            query += ' AND status = ?';
+            params.push(filters.status);
+        }
+        if (filters?.author) {
+            query += ' AND author = ?';
+            params.push(filters.author);
+        }
+        query += ' ORDER BY created_at DESC';
+        const stmt = db.prepare(query);
+        return stmt.all(...params);
+    }
+    /**
+     * Build dynamic UPDATE query for task fields
+     * @param input - Update content
+     * @param id - Task ID (appended as last param for WHERE clause)
+     * @returns Object with sql string and params array
+     */
+    buildUpdateQuery(input, id) {
+        const updates = [];
+        const params = [];
+        if (input.title !== undefined) {
+            updates.push('title = ?');
+            params.push(input.title);
+        }
+        if (input.body !== undefined) {
+            updates.push('body = ?');
+            params.push(input.body);
+        }
+        if (input.author !== undefined) {
+            updates.push('author = ?');
+            params.push(input.author);
+        }
+        if (input.status !== undefined) {
+            updates.push('status = ?');
+            params.push(input.status);
+        }
+        if (input.parent_id !== undefined) {
+            updates.push('parent_id = ?');
+            params.push(input.parent_id);
+        }
+        updates.push('updated_at = ?');
+        params.push(new Date().toISOString());
+        params.push(id);
+        const sql = `UPDATE tasks SET ${updates.join(', ')} WHERE id = ?`;
+        return { sql, params };
+    }
+    /**
+     * Update task
+     * @param id - Task ID
+     * @param input - Update content
+     * @returns Updated task, or null if not found
+     */
+    updateTask(id, input) {
+        const task = this.getTask(id);
+        if (!task) {
+            return null;
+        }
+        const validationErrors = (0, input_validators_1.validateTaskUpdateInput)(input);
+        if (validationErrors.length > 0) {
+            throw new Error(validationErrors[0].message);
+        }
+        if (input.parent_id !== undefined) {
+            if ((0, cycle_detector_1.wouldCreateCycle)(id, input.parent_id, (parentId) => this.getTask(parentId)?.parent_id ?? null)) {
+                throw new Error(`Cannot set parent_id to ${input.parent_id}: would create circular reference`);
+            }
+            if (input.parent_id !== null) {
+                const parentTask = this.getTask(input.parent_id);
+                if (!parentTask) {
+                    throw new Error(`Parent task with id ${input.parent_id} does not exist`);
+                }
+            }
+        }
+        const { sql, params } = this.buildUpdateQuery(input, id);
+        this.db.prepare(sql).run(...params);
+        return this.getTask(id);
+    }
+    /**
+     * Delete task
+     * @param id - Task ID
+     * @returns true if deletion succeeded, false if task not found
+     */
+    deleteTask(id) {
+        const db = this.db;
+        const task = this.getTask(id);
+        if (!task) {
+            return false;
+        }
+        const stmt = db.prepare('DELETE FROM tasks WHERE id = ?');
+        stmt.run(id);
+        return true;
+    }
+    /**
+     * Get task count by status
+     * @returns Map of task count for each status
+     */
+    getTaskCountByStatus() {
+        const db = this.db;
+        const stmt = db.prepare(`
+      SELECT status, COUNT(*) as count
+      FROM tasks
+      GROUP BY status
+    `);
+        const results = stmt.all();
+        // Initialize all statuses with 0
+        const countMap = {
+            backlog: 0,
+            ready: 0,
+            in_progress: 0,
+            review: 0,
+            done: 0,
+            closed: 0,
+        };
+        // Update map with query results
+        results.forEach((row) => {
+            countMap[row.status] = row.count;
+        });
+        return countMap;
+    }
+    /**
+     * Search tasks
+     * @param keyword - Search keyword (LIKE search on title and body)
+     * @param includeAll - If true, include done/closed tasks in search (default: false)
+     * @returns Array of matched tasks
+     */
+    searchTasks(keyword, includeAll = false) {
+        const db = this.db;
+        let query = 'SELECT * FROM tasks WHERE (title LIKE ? OR body LIKE ?)';
+        const params = [`%${keyword}%`, `%${keyword}%`];
+        if (!includeAll) {
+            query += ' AND status NOT IN (?, ?)';
+            params.push('done', 'closed');
+        }
+        query += ' ORDER BY created_at DESC';
+        const stmt = db.prepare(query);
+        return stmt.all(...params);
+    }
+    /**
+     * Get child tasks (direct children only)
+     * @param parentId - Parent task ID
+     * @returns Array of child tasks
+     */
+    getChildTasks(parentId) {
+        const db = this.db;
+        const stmt = db.prepare('SELECT * FROM tasks WHERE parent_id = ? ORDER BY created_at ASC');
+        return stmt.all(parentId);
+    }
+    /**
+     * Get parent task
+     * @param taskId - Task ID
+     * @returns Parent task, or null if no parent exists
+     */
+    getParentTask(taskId) {
+        const task = this.getTask(taskId);
+        if (!task || !task.parent_id) {
+            return null;
+        }
+        return this.getTask(task.parent_id);
+    }
+    /**
+     * Get descendant tasks iteratively (all descendants)
+     * @param parentId - Parent task ID
+     * @returns Array of all descendant tasks
+     */
+    getDescendantTasks(parentId) {
+        const descendants = [];
+        const visited = new Set();
+        const queue = [parentId];
+        while (queue.length > 0) {
+            const currentId = queue.shift();
+            if (visited.has(currentId)) {
+                continue;
+            }
+            visited.add(currentId);
+            const children = this.getChildTasks(currentId);
+            for (const child of children) {
+                if (!visited.has(child.id)) {
+                    descendants.push(child);
+                    queue.push(child.id);
+                }
+            }
+        }
+        return descendants;
+    }
+    /**
+     * Get root task (top-level parent)
+     * @param taskId - Task ID
+     * @returns Root task, or null if task not found
+     */
+    getRootTask(taskId) {
+        let currentTask = this.getTask(taskId);
+        if (!currentTask) {
+            return null;
+        }
+        const visited = new Set();
+        visited.add(currentTask.id);
+        while (currentTask.parent_id) {
+            if (visited.has(currentTask.parent_id)) {
+                break;
+            }
+            const parentTask = this.getTask(currentTask.parent_id);
+            if (!parentTask) {
+                break;
+            }
+            visited.add(parentTask.id);
+            currentTask = parentTask;
+        }
+        return currentTask;
+    }
+}
+exports.TaskService = TaskService;
+//# sourceMappingURL=TaskService.js.map

package/dist/services/TaskService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskService.js","sourceRoot":"","sources":["../../src/services/TaskService.ts"],"names":[],"mappings":"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"}

package/dist/services/TaskTagService.d.ts

@@ -0,0 +1,66 @@
+import { TaskTag, CreateTaskTagInput, Tag, Task } from '../models';
+import { TaskService } from './TaskService';
+import { TagService } from './TagService';
+import Database from 'better-sqlite3';
+/**
+ * Task Tag Service
+ * Manages associations between tasks and tags
+ */
+export declare class TaskTagService {
+    private db;
+    private taskService;
+    private tagService;
+    constructor(db?: Database.Database, taskService?: TaskService, tagService?: TagService);
+    /**
+     * Add tag to task
+     * @param input - Task tag creation input
+     * @returns Created task tag association
+     * @throws Error if task or tag does not exist, or if the association already exists
+     */
+    addTagToTask(input: CreateTaskTagInput): TaskTag;
+    /**
+     * Remove tag from task
+     * @param taskId - Task ID
+     * @param tagId - Tag ID
+     * @returns True if removal was successful, false if association not found
+     */
+    removeTagFromTask(taskId: number, tagId: number): boolean;
+    /**
+     * Check if task has a tag
+     * @param taskId - Task ID
+     * @param tagId - Tag ID
+     * @returns True if task has the tag, false otherwise
+     */
+    hasTag(taskId: number, tagId: number): boolean;
+    /**
+     * Get tag IDs for a task
+     * @param taskId - Task ID
+     * @returns Array of tag IDs in order of assignment
+     */
+    getTagIdsForTask(taskId: number): number[];
+    /**
+     * Get tag objects for a task
+     * @param taskId - Task ID
+     * @returns Array of tag objects in order of assignment
+     */
+    getTagsForTask(taskId: number): Tag[];
+    /**
+     * Get task IDs for a tag
+     * @param tagId - Tag ID
+     * @returns Array of task IDs
+     */
+    getTaskIdsForTag(tagId: number): number[];
+    /**
+     * Get task objects for a tag
+     * @param tagId - Tag ID
+     * @returns Array of task objects
+     */
+    getTasksForTag(tagId: number): Task[];
+    /**
+     * Get all task tags at once
+     * Avoids the N+1 problem by fetching all task tags in a single query
+     * @returns Map<task_id, Tag[]>
+     */
+    getAllTaskTags(): Map<number, Tag[]>;
+}
+//# sourceMappingURL=TaskTagService.d.ts.map

package/dist/services/TaskTagService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskTagService.d.ts","sourceRoot":"","sources":["../../src/services/TaskTagService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAa;gBAEnB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,UAAU;IAMtF;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO;IAiChD;;;;;OAKG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAazD;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAY9C;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAa1C;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE;IAcrC;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAazC;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE;IAcrC;;;;OAIG;IACH,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;CA8BrC"}