agkan 1.0.0

package/dist/services/AttachmentService.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachmentService = void 0;
+const connection_1 = require("../db/connection");
+/**
+ * Attachment Service
+ * Provides management of attachment records
+ *
+ * @remarks
+ * **Future Feature**: This service is fully implemented but CLI commands are not yet available.
+ * See docs/planned-features.md for implementation timeline and planned CLI interface.
+ *
+ * @example
+ * ```typescript
+ * const service = new AttachmentService();
+ * const attachment = service.createAttachment({
+ *   task_id: 1,
+ *   file_name: 'design.pdf',
+ *   file_path: '/path/to/design.pdf'
+ * });
+ * ```
+ */
+class AttachmentService {
+    constructor(db) {
+        this.db = db || (0, connection_1.getDatabase)();
+    }
+    /**
+     * Create a new attachment record
+     *
+     * @remarks
+     * **Future Feature**: CLI command not yet implemented.
+     * Planned command: `agkan task attach add <task-id> <file-path>`
+     *
+     * @param input - Attachment creation input
+     * @returns Created attachment record
+     * @throws Will throw if task_id does not exist (foreign key constraint)
+     */
+    createAttachment(input) {
+        const db = this.db;
+        const now = new Date().toISOString();
+        const stmt = db.prepare(`
+      INSERT INTO attachments (task_id, file_name, file_path, created_at)
+      VALUES (?, ?, ?, ?)
+    `);
+        const result = stmt.run(input.task_id, input.file_name, input.file_path, now);
+        return {
+            id: result.lastInsertRowid,
+            task_id: input.task_id,
+            file_name: input.file_name,
+            file_path: input.file_path,
+            created_at: now,
+        };
+    }
+    /**
+     * Get attachments for a specific task
+     *
+     * @remarks
+     * **Future Feature**: CLI command not yet implemented.
+     * Planned command: `agkan task attach list <task-id>`
+     *
+     * @param taskId - Task ID
+     * @returns Array of attachments ordered by creation date (newest first)
+     */
+    getAttachmentsByTaskId(taskId) {
+        const db = this.db;
+        const stmt = db.prepare('SELECT * FROM attachments WHERE task_id = ? ORDER BY created_at DESC');
+        return stmt.all(taskId);
+    }
+    /**
+     * Delete an attachment record
+     *
+     * @remarks
+     * **Future Feature**: CLI command not yet implemented.
+     * Planned command: `agkan task attach delete <attachment-id>`
+     *
+     * @param id - Attachment ID
+     * @returns True if deletion succeeded, false if not found
+     *
+     * @todo Implement file deletion from filesystem
+     * @todo Add --keep-file option to CLI command
+     */
+    deleteAttachment(id) {
+        const db = this.db;
+        const stmt = db.prepare('SELECT * FROM attachments WHERE id = ?');
+        const attachment = stmt.get(id);
+        if (!attachment) {
+            return false;
+        }
+        const deleteStmt = db.prepare('DELETE FROM attachments WHERE id = ?');
+        deleteStmt.run(id);
+        return true;
+    }
+}
+exports.AttachmentService = AttachmentService;
+//# sourceMappingURL=AttachmentService.js.map

package/dist/services/AttachmentService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentService.js","sourceRoot":"","sources":["../../src/services/AttachmentService.ts"],"names":[],"mappings":";;;AACA,iDAA+C;AAG/C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,iBAAiB;IAG5B,YAAY,EAAsB;QAChC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,IAAA,wBAAW,GAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,KAA4B;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;KAGvB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAE9E,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,eAAyB;YACpC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,UAAU,EAAE,GAAG;SAChB,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,sBAAsB,CAAC,MAAc;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAEnB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,sEAAsE,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAiB,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,EAAU;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAEnB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QACtE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEnB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAnFD,8CAmFC"}

package/dist/services/FileService.d.ts

@@ -0,0 +1,31 @@
+/**
+ * File Service
+ * Provides file system operations
+ */
+export declare class FileService {
+    /**
+     * Save file to attachments directory
+     * @param sourceFile - Source file path
+     * @param taskId - Related task ID
+     * @returns Saved file name and path
+     * @throws If file not found
+     */
+    saveFile(sourceFile: string, taskId: number): {
+        file_name: string;
+        file_path: string;
+    };
+    /**
+     * Read markdown file contents
+     * @param filePath - Path of file to read
+     * @returns File contents
+     * @throws If file not found or path is unsafe
+     */
+    readMarkdownFile(filePath: string): string;
+    /**
+     * Delete file
+     * @param filePath - Path of file to delete
+     * @returns Returns true if deletion succeeds, false if file does not exist
+     */
+    deleteFile(filePath: string): boolean;
+}
+//# sourceMappingURL=FileService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FileService.d.ts","sourceRoot":"","sources":["../../src/services/FileService.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,WAAW;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IA2BtF;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAY1C;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAYtC"}

package/dist/services/FileService.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileService = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const security_1 = require("../utils/security");
+/**
+ * File Service
+ * Provides file system operations
+ */
+class FileService {
+    /**
+     * Save file to attachments directory
+     * @param sourceFile - Source file path
+     * @param taskId - Related task ID
+     * @returns Saved file name and path
+     * @throws If file not found
+     */
+    saveFile(sourceFile, taskId) {
+        // Check if file exists
+        if (!fs_1.default.existsSync(sourceFile)) {
+            throw new Error(`File not found: ${sourceFile}`);
+        }
+        // Get file name
+        const fileName = path_1.default.basename(sourceFile);
+        // Create destination directory (attachments/<task_id>/)
+        const attachmentDir = path_1.default.join(process.cwd(), 'attachments', taskId.toString());
+        fs_1.default.mkdirSync(attachmentDir, { recursive: true });
+        // Generate filename with timestamp
+        const timestamp = Date.now();
+        const destFileName = `${timestamp}_${fileName}`;
+        const destPath = path_1.default.join(attachmentDir, destFileName);
+        // Copy file
+        fs_1.default.copyFileSync(sourceFile, destPath);
+        return {
+            file_name: fileName,
+            file_path: destPath,
+        };
+    }
+    /**
+     * Read markdown file contents
+     * @param filePath - Path of file to read
+     * @returns File contents
+     * @throws If file not found or path is unsafe
+     */
+    readMarkdownFile(filePath) {
+        if (!(0, security_1.isPathSafe)(filePath)) {
+            throw new Error(`Unsafe file path: ${filePath}`);
+        }
+        if (!fs_1.default.existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        return fs_1.default.readFileSync(filePath, 'utf-8');
+    }
+    /**
+     * Delete file
+     * @param filePath - Path of file to delete
+     * @returns Returns true if deletion succeeds, false if file does not exist
+     */
+    deleteFile(filePath) {
+        if (!fs_1.default.existsSync(filePath)) {
+            return false;
+        }
+        try {
+            fs_1.default.unlinkSync(filePath);
+            return true;
+        }
+        catch {
+            throw new Error(`Failed to delete file: ${filePath}`);
+        }
+    }
+}
+exports.FileService = FileService;
+//# sourceMappingURL=FileService.js.map

package/dist/services/FileService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileService.js","sourceRoot":"","sources":["../../src/services/FileService.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,gDAA+C;AAE/C;;;GAGG;AACH,MAAa,WAAW;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,UAAkB,EAAE,MAAc;QACzC,uBAAuB;QACvB,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,gBAAgB;QAChB,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE3C,wDAAwD;QACxD,MAAM,aAAa,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjF,YAAE,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,mCAAmC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QAExD,YAAY;QACZ,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEtC,OAAO;YACL,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,QAAQ;SACpB,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,QAAgB;QAC/B,IAAI,CAAC,IAAA,qBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,QAAgB;QACzB,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF;AAtED,kCAsEC"}

package/dist/services/MetadataService.d.ts

@@ -0,0 +1,49 @@
+import { TaskMetadata, CreateTaskMetadataInput } from '../models';
+import Database from 'better-sqlite3';
+/**
+ * Metadata Service
+ * Manages creation, retrieval, update, and deletion of task metadata
+ */
+export declare class MetadataService {
+    private db;
+    constructor(db?: Database.Database);
+    /**
+     * Set metadata for a task (create or update)
+     * @param input - Metadata creation input
+     * @returns Metadata object
+     */
+    setMetadata(input: CreateTaskMetadataInput): TaskMetadata;
+    /**
+     * Get metadata by task ID and key
+     * @param taskId - Task ID
+     * @param key - Metadata key
+     * @returns Metadata object or null if not found
+     */
+    getMetadataByKey(taskId: number, key: string): TaskMetadata | null;
+    /**
+     * List metadata for a task
+     * @param taskId - Task ID
+     * @returns Array of metadata objects
+     */
+    listMetadata(taskId: number): TaskMetadata[];
+    /**
+     * Delete metadata by task ID and key
+     * @param taskId - Task ID
+     * @param key - Metadata key
+     * @returns True if deletion succeeded, false if metadata not found
+     */
+    deleteMetadata(taskId: number, key: string): boolean;
+    /**
+     * Get all metadata for multiple tasks at once
+     * Avoids the N+1 problem by fetching all metadata in a single query
+     * @returns Map<task_id, TaskMetadata[]>
+     */
+    getAllTasksMetadata(): Map<number, TaskMetadata[]>;
+    /**
+     * Delete all metadata for a task
+     * @param taskId - Task ID
+     * @returns Number of deleted metadata entries
+     */
+    deleteAllMetadata(taskId: number): number;
+}
+//# sourceMappingURL=MetadataService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataService.d.ts","sourceRoot":"","sources":["../../src/services/MetadataService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ;IAIlC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,uBAAuB,GAAG,YAAY;IAgCzD;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAalE;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAc5C;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAapD;;;;OAIG;IACH,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;IAsBlD;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAY1C"}

package/dist/services/MetadataService.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataService = void 0;
+const connection_1 = require("../db/connection");
+/**
+ * Metadata Service
+ * Manages creation, retrieval, update, and deletion of task metadata
+ */
+class MetadataService {
+    constructor(db) {
+        this.db = db || (0, connection_1.getDatabase)();
+    }
+    /**
+     * Set metadata for a task (create or update)
+     * @param input - Metadata creation input
+     * @returns Metadata object
+     */
+    setMetadata(input) {
+        const db = this.db;
+        // Check if metadata already exists
+        const existing = this.getMetadataByKey(input.task_id, input.key);
+        const now = new Date().toISOString();
+        if (existing) {
+            // Update existing metadata
+            const stmt = db.prepare(`
+        UPDATE task_metadata
+        SET value = ?, updated_at = ?
+        WHERE task_id = ? AND key = ?
+      `);
+            stmt.run(input.value, now, input.task_id, input.key);
+            return this.getMetadataByKey(input.task_id, input.key);
+        }
+        else {
+            // Create new metadata
+            const stmt = db.prepare(`
+        INSERT INTO task_metadata (task_id, key, value, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?)
+      `);
+            stmt.run(input.task_id, input.key, input.value, now, now);
+            return this.getMetadataByKey(input.task_id, input.key);
+        }
+    }
+    /**
+     * Get metadata by task ID and key
+     * @param taskId - Task ID
+     * @param key - Metadata key
+     * @returns Metadata object or null if not found
+     */
+    getMetadataByKey(taskId, key) {
+        const db = this.db;
+        const stmt = db.prepare(`
+      SELECT * FROM task_metadata
+      WHERE task_id = ? AND key = ?
+    `);
+        const result = stmt.get(taskId, key);
+        return result ? result : null;
+    }
+    /**
+     * List metadata for a task
+     * @param taskId - Task ID
+     * @returns Array of metadata objects
+     */
+    listMetadata(taskId) {
+        const db = this.db;
+        const stmt = db.prepare(`
+      SELECT * FROM task_metadata
+      WHERE task_id = ?
+      ORDER BY created_at DESC
+    `);
+        const results = stmt.all(taskId);
+        return results;
+    }
+    /**
+     * Delete metadata by task ID and key
+     * @param taskId - Task ID
+     * @param key - Metadata key
+     * @returns True if deletion succeeded, false if metadata not found
+     */
+    deleteMetadata(taskId, key) {
+        const db = this.db;
+        const stmt = db.prepare(`
+      DELETE FROM task_metadata
+      WHERE task_id = ? AND key = ?
+    `);
+        const result = stmt.run(taskId, key);
+        return result.changes > 0;
+    }
+    /**
+     * Get all metadata for multiple tasks at once
+     * Avoids the N+1 problem by fetching all metadata in a single query
+     * @returns Map<task_id, TaskMetadata[]>
+     */
+    getAllTasksMetadata() {
+        const db = this.db;
+        const stmt = db.prepare(`
+      SELECT * FROM task_metadata
+      ORDER BY task_id, created_at DESC
+    `);
+        const results = stmt.all();
+        const metadataMap = new Map();
+        for (const row of results) {
+            const taskId = row.task_id;
+            if (!metadataMap.has(taskId)) {
+                metadataMap.set(taskId, []);
+            }
+            metadataMap.get(taskId).push(row);
+        }
+        return metadataMap;
+    }
+    /**
+     * Delete all metadata for a task
+     * @param taskId - Task ID
+     * @returns Number of deleted metadata entries
+     */
+    deleteAllMetadata(taskId) {
+        const db = this.db;
+        const stmt = db.prepare(`
+      DELETE FROM task_metadata
+      WHERE task_id = ?
+    `);
+        const result = stmt.run(taskId);
+        return result.changes;
+    }
+}
+exports.MetadataService = MetadataService;
+//# sourceMappingURL=MetadataService.js.map

package/dist/services/MetadataService.js.map

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

package/dist/services/TagService.d.ts

@@ -0,0 +1,49 @@
+import { Tag, CreateTagInput, UpdateTagInput } from '../models';
+import Database from 'better-sqlite3';
+/**
+ * Tag Service
+ * Manages creation, retrieval, update, and deletion of tags
+ */
+export declare class TagService {
+    private db;
+    constructor(db?: Database.Database);
+    /**
+     * Create a new tag
+     * @param input - Tag creation input
+     * @returns Newly created tag
+     * @throws Error if tag name already exists
+     */
+    createTag(input: CreateTagInput): Tag;
+    /**
+     * Get tag by ID
+     * @param id - Tag ID
+     * @returns Tag object or null if not found
+     */
+    getTag(id: number): Tag | null;
+    /**
+     * Get tag by name
+     * @param name - Tag name
+     * @returns Tag object or null if not found
+     */
+    getTagByName(name: string): Tag | null;
+    /**
+     * List all tags
+     * @returns Array of tags sorted by creation date in descending order
+     */
+    listTags(): Tag[];
+    /**
+     * Update tag
+     * @param id - Tag ID
+     * @param input - Tag update input
+     * @returns Updated tag object or null if not found
+     * @throws Error if tag name already exists
+     */
+    updateTag(id: number, input: UpdateTagInput): Tag | null;
+    /**
+     * Delete tag
+     * @param id - Tag ID
+     * @returns True if deletion succeeded, false if tag not found
+     */
+    deleteTag(id: number): boolean;
+}
+//# sourceMappingURL=TagService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TagService.d.ts","sourceRoot":"","sources":["../../src/services/TagService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhE,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ;IAGlC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,GAAG;IA4BrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAS9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAStC;;;OAGG;IACH,QAAQ,IAAI,GAAG,EAAE;IASjB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,GAAG,GAAG,IAAI;IAyCxD;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAQ/B"}

package/dist/services/TagService.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TagService = void 0;
+const connection_1 = require("../db/connection");
+const input_validators_1 = require("../utils/input-validators");
+/**
+ * Tag Service
+ * Manages creation, retrieval, update, and deletion of tags
+ */
+class TagService {
+    constructor(db) {
+        this.db = db || (0, connection_1.getDatabase)();
+    }
+    /**
+     * Create a new tag
+     * @param input - Tag creation input
+     * @returns Newly created tag
+     * @throws Error if tag name already exists
+     */
+    createTag(input) {
+        const db = this.db;
+        // Validate input fields
+        const validationErrors = (0, input_validators_1.validateTagInput)(input);
+        if (validationErrors.length > 0) {
+            throw new Error(validationErrors[0].message);
+        }
+        // Check for duplicate tag names
+        const existingTag = this.getTagByName(input.name);
+        if (existingTag) {
+            throw new Error(`Tag with name "${input.name}" already exists`);
+        }
+        const now = new Date().toISOString();
+        const stmt = db.prepare(`
+      INSERT INTO tags (name, created_at)
+      VALUES (?, ?)
+    `);
+        const result = stmt.run(input.name, now);
+        const getStmt = db.prepare('SELECT * FROM tags WHERE id = ?');
+        return getStmt.get(result.lastInsertRowid);
+    }
+    /**
+     * Get tag by ID
+     * @param id - Tag ID
+     * @returns Tag object or null if not found
+     */
+    getTag(id) {
+        const db = this.db;
+        const stmt = db.prepare('SELECT * FROM tags WHERE id = ?');
+        const result = stmt.get(id);
+        return result ? result : null;
+    }
+    /**
+     * Get tag by name
+     * @param name - Tag name
+     * @returns Tag object or null if not found
+     */
+    getTagByName(name) {
+        const db = this.db;
+        const stmt = db.prepare('SELECT * FROM tags WHERE name = ?');
+        const result = stmt.get(name);
+        return result ? result : null;
+    }
+    /**
+     * List all tags
+     * @returns Array of tags sorted by creation date in descending order
+     */
+    listTags() {
+        const db = this.db;
+        const stmt = db.prepare('SELECT * FROM tags ORDER BY created_at DESC');
+        const results = stmt.all();
+        return results;
+    }
+    /**
+     * Update tag
+     * @param id - Tag ID
+     * @param input - Tag update input
+     * @returns Updated tag object or null if not found
+     * @throws Error if tag name already exists
+     */
+    updateTag(id, input) {
+        const db = this.db;
+        // Verify that tag exists
+        const existingTag = this.getTag(id);
+        if (!existingTag) {
+            return null;
+        }
+        // Validate name if being updated
+        if (input.name !== undefined) {
+            if (!input.name || input.name.trim().length === 0) {
+                throw new Error('Name is required');
+            }
+            if (input.name.length > 50) {
+                throw new Error('Name must not exceed 50 characters');
+            }
+            if (/^\d+$/.test(input.name.trim())) {
+                throw new Error('Tag name cannot be purely numeric');
+            }
+        }
+        // Check for duplicate tag name if changing the name
+        if (input.name !== undefined && input.name !== existingTag.name) {
+            const duplicateTag = this.getTagByName(input.name);
+            if (duplicateTag) {
+                throw new Error(`Tag with name "${input.name}" already exists`);
+            }
+        }
+        const stmt = db.prepare(`
+      UPDATE tags
+      SET name = COALESCE(?, name)
+      WHERE id = ?
+    `);
+        stmt.run(input.name, id);
+        return this.getTag(id);
+    }
+    /**
+     * Delete tag
+     * @param id - Tag ID
+     * @returns True if deletion succeeded, false if tag not found
+     */
+    deleteTag(id) {
+        const db = this.db;
+        const stmt = db.prepare('DELETE FROM tags WHERE id = ?');
+        const result = stmt.run(id);
+        return result.changes > 0;
+    }
+}
+exports.TagService = TagService;
+//# sourceMappingURL=TagService.js.map

package/dist/services/TagService.js.map

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

package/dist/services/TaskBlockService.d.ts

@@ -0,0 +1,49 @@
+import { TaskBlock, CreateTaskBlockInput } from '../models';
+import { TaskService } from './TaskService';
+import Database from 'better-sqlite3';
+/**
+ * Task Block Service
+ * Manages blocking relationships between tasks
+ */
+export declare class TaskBlockService {
+    private db;
+    private taskService;
+    constructor(db?: Database.Database, taskService?: TaskService);
+    /**
+     * 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: CreateTaskBlockInput): TaskBlock;
+    /**
+     * 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: number, blockedId: number): boolean;
+    /**
+     * 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: number): number[];
+    /**
+     * 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: number): number[];
+    /**
+     * 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
+     */
+    private wouldCreateBlockCycle;
+}
+//# sourceMappingURL=TaskBlockService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TaskBlockService.d.ts","sourceRoot":"","sources":["../../src/services/TaskBlockService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,WAAW,CAAc;gBAErB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,WAAW;IAK7D;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS;IAuChD;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAa1D;;;;;OAKG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAY9C;;;;;OAKG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAY9C;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAiB9B"}