agkan 2.14.3 → 2.15.0

package/dist/db/types/repository.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Repository Interface Definitions
+ *
+ * Defines entity-specific repository interfaces as part of the Repository pattern.
+ * Each repository encapsulates data access logic for a specific entity.
+ * StorageBackend is the collection of all repositories.
+ *
+ * ## Design Pattern: Repository Pattern
+ * - Thin repositories: data access / SQL only
+ * - Business logic remains in the service layer
+ * - Sync implementation (async can be reconsidered when non-SQL backends are added)
+ */
+import type { Task, CreateTaskInput, UpdateTaskInput, TaskStatus, Tag, CreateTagInput, UpdateTagInput, TaskBlock, CreateTaskBlockInput, TaskTag, CreateTaskTagInput, TaskMetadata, CreateTaskMetadataInput, TaskComment, CreateTaskCommentInput } from '../../models';
+import type { Priority } from '../../models/Priority';
+/** Filter options for task listing */
+export interface TaskFilter {
+    status?: TaskStatus | TaskStatus[];
+    author?: string;
+    assignees?: string;
+    tagIds?: number[];
+    priority?: Priority | Priority[];
+    search?: string;
+}
+/** Sort options for task listing */
+export interface TaskSortOptions {
+    field: 'id' | 'title' | 'status' | 'created_at' | 'updated_at' | 'priority';
+    order: 'asc' | 'desc';
+}
+/**
+ * Repository for Task entity data access
+ */
+export interface TaskRepository {
+    /** Find a task by its ID */
+    findById(id: number): Task | null;
+    /** Find all tasks matching the filter, with optional sort */
+    findAll(filter?: TaskFilter, sort?: TaskSortOptions): Task[];
+    /** Create a new task */
+    create(input: CreateTaskInput & {
+        status: TaskStatus;
+        created_at: string;
+        updated_at: string;
+    }): Task;
+    /** Update fields of an existing task */
+    update(id: number, input: Partial<UpdateTaskInput & {
+        updated_at: string;
+    }>): Task | null;
+    /** Delete a task by ID */
+    delete(id: number): boolean;
+    /** Find direct child tasks */
+    findChildren(parentId: number): Task[];
+    /** Count tasks grouped by status */
+    countByStatus(): Record<TaskStatus, number>;
+    /** Find tasks updated before a given date with specific statuses */
+    findForPurge(beforeDate: string, statuses: TaskStatus[]): Task[];
+    /** Delete multiple tasks by IDs */
+    deleteMany(ids: number[]): number;
+}
+/**
+ * Repository for Tag entity data access
+ */
+export interface TagRepository {
+    /** Find a tag by its ID */
+    findById(id: number): Tag | null;
+    /** Find a tag by its name */
+    findByName(name: string): Tag | null;
+    /** Find all tags */
+    findAll(): Tag[];
+    /** Create a new tag */
+    create(input: CreateTagInput & {
+        created_at: string;
+    }): Tag;
+    /** Update a tag */
+    update(id: number, input: UpdateTagInput): Tag | null;
+    /** Delete a tag by ID */
+    delete(id: number): boolean;
+}
+/**
+ * Repository for TaskBlock (blocking relationships) data access
+ */
+export interface TaskBlockRepository {
+    /** Create a new block relationship */
+    create(input: CreateTaskBlockInput & {
+        created_at: string;
+    }): TaskBlock;
+    /** Remove a block relationship */
+    delete(blockerId: number, blockedId: number): boolean;
+    /** Get all task IDs blocked by a given task */
+    findBlockedTaskIds(blockerId: number): number[];
+    /** Get all task IDs that block a given task */
+    findBlockerTaskIds(blockedId: number): number[];
+    /** Get all block relationships */
+    findAll(): Array<{
+        blocker_task_id: number;
+        blocked_task_id: number;
+    }>;
+}
+/**
+ * Repository for TaskTag (task-tag associations) data access
+ */
+export interface TaskTagRepository {
+    /** Create a task-tag association */
+    create(input: CreateTaskTagInput & {
+        created_at: string;
+    }): TaskTag;
+    /** Remove a task-tag association */
+    delete(taskId: number, tagId: number): boolean;
+    /** Check if a task has a specific tag */
+    exists(taskId: number, tagId: number): boolean;
+    /** Get tag IDs for a task */
+    findTagIdsByTaskId(taskId: number): number[];
+    /** Get tags for a task */
+    findTagsByTaskId(taskId: number): Tag[];
+    /** Get task IDs for a tag */
+    findTaskIdsByTagId(tagId: number): number[];
+    /** Get tasks for a tag */
+    findTasksByTagId(tagId: number): Task[];
+    /** Get all task tags as a map (task_id -> Tag[]) */
+    findAllGroupedByTaskId(): Map<number, Tag[]>;
+}
+/**
+ * Repository for TaskMetadata data access
+ */
+export interface MetadataRepository {
+    /** Set metadata for a task (create or update) */
+    set(input: CreateTaskMetadataInput & {
+        created_at: string;
+        updated_at: string;
+    }): TaskMetadata;
+    /** Get metadata by task ID and key */
+    findByKey(taskId: number, key: string): TaskMetadata | null;
+    /** List all metadata for a task */
+    findByTaskId(taskId: number): TaskMetadata[];
+    /** Delete metadata by task ID and key */
+    delete(taskId: number, key: string): boolean;
+    /** Delete all metadata for a task */
+    deleteAllForTask(taskId: number): number;
+    /** Get all metadata grouped by task ID */
+    findAllGroupedByTaskId(): Map<number, TaskMetadata[]>;
+    /** Update an existing metadata entry */
+    update(taskId: number, key: string, value: string, updatedAt: string): TaskMetadata | null;
+}
+/**
+ * Repository for TaskComment data access
+ */
+export interface CommentRepository {
+    /** Create a new comment */
+    create(input: CreateTaskCommentInput & {
+        created_at: string;
+        updated_at: string;
+    }): TaskComment;
+    /** Find a comment by ID */
+    findById(id: number): TaskComment | null;
+    /** List comments for a task */
+    findByTaskId(taskId: number): TaskComment[];
+    /** Delete a comment by ID */
+    delete(id: number): boolean;
+    /** Delete all comments for a task */
+    deleteAllForTask(taskId: number): number;
+    /** Update comment content */
+    update(id: number, content: string, updatedAt: string): TaskComment | null;
+    /** Get all comments for multiple tasks */
+    findByTaskIds(taskIds: number[]): Map<number, TaskComment[]>;
+    /** Update comment timestamps (used during import) */
+    updateTimestamps(id: number, createdAt: string, updatedAt: string): void;
+}
+/**
+ * StorageBackend - collection of all entity repositories
+ *
+ * This is the main interface that replaces StorageProvider for use in services.
+ * Each service receives the specific repository it needs via constructor injection.
+ */
+export interface StorageBackend {
+    tasks: TaskRepository;
+    tags: TagRepository;
+    blocks: TaskBlockRepository;
+    taskTags: TaskTagRepository;
+    metadata: MetadataRepository;
+    comments: CommentRepository;
+    /** Execute a function within a database transaction */
+    transaction<T>(fn: () => T): T;
+    /** Update task timestamps directly (used during import) */
+    updateTaskTimestamps(id: number, createdAt: string, updatedAt: string): void;
+    /**
+     * Get a signature representing the latest update across tasks, metadata, and task_tags.
+     * Used by the board to detect data changes for polling.
+     * Returns null if there is no data yet.
+     */
+    getBoardUpdatedAtSignature(): string | null;
+    /** Close the storage connection */
+    close(): void;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/db/types/repository.d.ts.map

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

package/dist/db/types/repository.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Repository Interface Definitions
+ *
+ * Defines entity-specific repository interfaces as part of the Repository pattern.
+ * Each repository encapsulates data access logic for a specific entity.
+ * StorageBackend is the collection of all repositories.
+ *
+ * ## Design Pattern: Repository Pattern
+ * - Thin repositories: data access / SQL only
+ * - Business logic remains in the service layer
+ * - Sync implementation (async can be reconsidered when non-SQL backends are added)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=repository.js.map

package/dist/db/types/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/db/types/repository.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/dist/models/Attachment.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Attachment model
+ * Type definitions for attachments
+ */
+/**
+ * Complete attachment type definition
+ * Represents an attachment retrieved from the database
+ */
+export interface Attachment {
+    id: number;
+    task_id: number;
+    file_name: string;
+    file_path: string;
+    created_at: string;
+}
+/**
+ * Attachment creation input type
+ * Excludes id and created_at as they are auto-generated
+ */
+export interface CreateAttachmentInput {
+    task_id: number;
+    file_name: string;
+    file_path: string;
+}
+//# sourceMappingURL=Attachment.d.ts.map

package/dist/models/Attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Attachment.d.ts","sourceRoot":"","sources":["../../src/models/Attachment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/models/Attachment.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Attachment model
+ * Type definitions for attachments
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Attachment.js.map

package/dist/models/Attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Attachment.js","sourceRoot":"","sources":["../../src/models/Attachment.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/services/AttachmentService.d.ts

@@ -0,0 +1,62 @@
+import { Attachment, CreateAttachmentInput } from '../models';
+import Database from 'better-sqlite3';
+/**
+ * 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'
+ * });
+ * ```
+ */
+export declare class AttachmentService {
+    private db;
+    constructor(db?: Database.Database);
+    /**
+     * 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: CreateAttachmentInput): Attachment;
+    /**
+     * 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: number): Attachment[];
+    /**
+     * 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: number): boolean;
+}
+//# sourceMappingURL=AttachmentService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentService.d.ts","sourceRoot":"","sources":["../../src/services/AttachmentService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ;IAIlC;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU;IAoB1D;;;;;;;;;OASG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAOpD;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAetC"}

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/ClaudeProcessService.d.ts

@@ -0,0 +1,100 @@
+import type { StorageBackend } from '../db/types/repository';
+export type ClaudeStreamEvent = {
+    type: 'system';
+    subtype: string;
+    session_id?: string;
+    [key: string]: unknown;
+} | {
+    type: 'assistant';
+    message: {
+        content: Array<{
+            type: 'text';
+            text: string;
+        } | {
+            type: 'tool_use';
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        }>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+} | {
+    type: 'result';
+    subtype: string;
+    result?: string;
+    duration_ms?: number;
+    [key: string]: unknown;
+} | {
+    type: string;
+    [key: string]: unknown;
+};
+export type OutputEvent = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'tool_use';
+    name: string;
+    input: Record<string, unknown>;
+} | {
+    kind: 'done';
+    exitCode: number;
+} | {
+    kind: 'error';
+    message: string;
+};
+export type SubscribeCallback = (event: OutputEvent) => void;
+export interface RunLog {
+    id: number;
+    task_id: number;
+    started_at: string;
+    finished_at: string | null;
+    exit_code: number | null;
+    session_id: string | null;
+    events: OutputEvent[];
+}
+/**
+ * ClaudeProcessService
+ * Manages claude CLI processes running in stream-json mode.
+ * Keyed by taskId, supports start/stop/subscribe/list operations.
+ */
+export declare class ClaudeProcessService {
+    private processes;
+    private db;
+    constructor(db?: StorageBackend | null);
+    /**
+     * Start a claude process for the given taskId and prompt.
+     * Prevents duplicate processes for the same taskId.
+     */
+    startProcess(taskId: number, prompt: string, command?: string): void;
+    /**
+     * Stop the process for the given taskId.
+     * Returns true if the process was found and signalled, false otherwise.
+     */
+    stopProcess(taskId: number): boolean;
+    /**
+     * List all currently running tasks with their command type.
+     */
+    listRunningTasks(): {
+        taskId: number;
+        command: string;
+    }[];
+    /**
+     * Subscribe to output events for a given taskId.
+     * If process is running: replay past events and subscribe to future events.
+     * If no process but DB available: replay last saved log from DB.
+     * Returns an unsubscribe function.
+     */
+    subscribeOutput(taskId: number, callback: SubscribeCallback): () => void;
+    /**
+     * Get the buffered output events for a taskId.
+     * Useful for late subscribers who missed earlier events.
+     */
+    getOutputBuffer(taskId: number): ClaudeStreamEvent[];
+    /**
+     * Get saved run logs for a task from DB (most recent first, up to 5).
+     */
+    getRunLogs(taskId: number): RunLog[];
+    private _notifySubscribers;
+}
+//# sourceMappingURL=ClaudeProcessService.d.ts.map

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

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